YPMAKE(1M) — Series 300 Only

NAME

ypmake − create or rebuild Yellow Pages databases

SYNOPSIS

/usr/etc/yp/ypmake   [ DIR=source_directory ] \
                     [ DOM=domain ] [ NOPUSH=1 ] \
                     [ PWFILE=passwd_file ] [ map ... ]
cd /usr/etc/yp; make [ DIR=source_directory ] \
                     [ DOM=domain ] [ NOPUSH=1 ] \
                     [ PWFILE=passwd_file ] [ map ... ]

DESCRIPTION

The ypmake shell script in /usr/etc/yp builds one or more Yellow Pages (YP) maps (databases) on a master YP server. With no arguments, ypmake either creates maps if they do not already exist or rebuilds maps that are not current. These maps are constructed from ASCII files. The yppush(1M) command is then executed to notify slave YP servers of the change and to make the slave servers copy the updated maps to their machines.

If any maps are supplied on the command line, ypmake creates or updates those maps only. Permissible names for maps are the filenames in /etc listed in the following FILES section. In addition, specific maps may be named, like "netgroup.byuser" or "rpc.bynumber."

The make(1M) command can be used instead of ypmake. The Makefile in /usr/etc/yp calls the ypmake script to actually construct the maps. Better performance is achieved if ypmake is called directly, instead of via make(1M).

Both the Makefile and ypmake script use four variables.

DIR=source_directory
The directory containing the ASCII source files from which maps are constructed. DIR defaults to /etc.

DOM=domain
Causes ypmake to construct maps for a domain other than the host’s YP domain (see domainname(1)).

NOPUSH=1
When non-null (null by default), NOPUSH inhibits copying the new or updated databases to the slave YP servers. Only slave YP servers in the specified domain receive yppush(1M) notification when NOPUSH is null.

PWFILE=passwd_file
Specifies the full pathname of the ASCII file that ypmake should use when building the YP passwd maps. PWFILE defaults to $DIR/passwd.

The order of the arguments passed to ypmake is unimportant, but the maps are built or updated in the left-to-right order provided.

Refer to ypfiles(4) and ypserv(1M) for an overview of the YP.

DIAGNOSTICS

The exit code returned by ypmake can have one of the following values.

0 Normal termination; no problems.

1 One or more unrecognized arguments were passed.

2 The YP domain name is not set.

3 The subdirectory used to contain maps for a specific YP domain, /usr/etc/yp/domain_name, does not exist or is not writable.

4 An error was encountered when building at least one of the maps.

5 One or more maps’ ASCII files do not exist or are unreadable.

EXAMPLES

ypmake passwd.byname creates or rebuilds the password databases (both the passwd.byname and passwd.byuid maps) from /etc/passwd and uses yppush(1M) to copy the databases to any slave YP servers in the default YP domain.

ypmake hosts NOPUSH=1 creates or rebuilds the hosts databases from /etc/hosts but does not copy the databases to any slave YP servers.

ypmake DOM=DAE_YP networks DIR=/yp/sourcefiles creates or rebuilds the networks maps from /yp/sourcefiles/networks and copies the maps to any slave YP servers in the YP domain DAE_YP.

AUTHOR

Sun Microsystems, Inc.

FILES

/etc/group
/etc/hosts
/etc/netgroup
/etc/networks
/etc/passwd
/etc/protocols
/etc/rpc
/etc/services

Museum

Related Articles