ypmake(8)

NAME
ypmake - create NIS maps

SYNOPSIS
ypmake [-fnvxMAS] [-d domain] [-m master] maps...

DESCRIPTION
The ypmake utility helps create and maintain the maps of your NIS server. It is written as a set of perl modules in order to speed up the process of map generation.

When called without any arguments, ypmake checks whether all maps are up to date relative to their source, and rebuilds them if needed. See section MAPS below for what all means in this context.

Alternatively, you may specify a list of map names to be rebuilt. Valid targets include both specific maps such as passwd.byname, as well as groups of maps (called map aliases in this document), such as passwd or hosts.

The source files from which maps are built default to the normal system files such as /etc/passwd etc. However, you can override these by specifying alternative source files in the ypmake.conf file in your /var/yp directory. This file can also be used to specify additional maps, and procedures how to build them. See ypmake.conf(5) for details.

OPTIONS
ypmake takes the following options:

-d domain
    Override the NIS domain. By default, ypmake uses the system-wide NIS domain name returned by domainname(8).

-m master
    By default, ypmake will enter the local hostname (from hostname(1)) as the maps' NIS master. This option is intended for emergencies only, in case you have to rebuild the maps on a slave server.

-f  Force the regeneration of all maps, regardless of whether they are newer than their source files or not.

-n  Don't change any maps, just tell the user which would be rebuilt

-c confname
    Use the specified file as the configuaration file rather than /var/yp/ypmake.conf.

-v  Print the version string and exit.

-x  Debug mode. Instead of generating the map, dump its contents to stdout.

-M  Print a list of all map targets for the specified NIS domain.

-A  Print a list of all map aliases for the specified NIS domain.

-S  Print a list of source files user for all built-in maps.

MAPS
Currently, ypmake supports a fairly standard set of NIS maps. The list below shows the maps used most commonly, along with their map alias. To obtain the full list of supported maps and map aliases, invoke ypmake -A.

hosts
    hosts.byname, hosts.byaddr.

networks
    networks.byname, networks.byaddr.

passwd
    passwd.byname, passwd.byuid.

group
    group.byname, group.bygid.

services
    services.byname.

protocols
    protocols.byname, protocols.bynumber.

rpc rpc.byname, rpc.bynumber.

netgroup
    netgroup.byuser, netgroup.byhost.

netid
    netid.byname

publickey
    publickey.byname.

The special map alias default refers to all maps given above, except the publickey and netid maps.

All maps are generated from the corresponding system configuration file in the /etc directory, except for netid.byname, which is generated by combining data from /etc/passwd, /etc/group, and /etc/hosts, and ypservers, which is generated from /var/yp/ypservers.

SEE ALSO
ypmake.conf(5).

FILES

/var/yp/ypmake.conf
    The configuration file which lets you override some rules when building NIS maps.

/var/yp/domain
    Directory containing the maps for domain.

/usr/sbin/ypmake
    Location of the ypmake script.

/usr/lib/yp/ypmake
    Location of the perl include files that generate the individual maps.

AUTHOR
Olaf Kirch, <okir@monad.swb.de>