NAME

yppush - force propagation of a Yellow Pages database

SYNOPSIS

/usr/etc/yp/yppush [ −d domain ] [ −v ] mapname

DESCRIPTION

The yppush command copies a Yellow Pages (YP) map (database), mapname, from the map’s master YP server to each slave YP server. It is usually executed only on the master YP server by the shell script ypmake(1M). The ypmake(1M) script is run either after changes are made to one or more of the master’s YP databases or when the YP databases are first created. See ypmake(1M) and ypinit(1M) for more information on these processes. 

The yppush command constructs a list of YP server host names by reading the YP map ypservers within the domain. Keys within the ypservers map are the host names of the machines on which the YP servers run.  The yppush then sends a "transfer map" request to the YP server at each host, along with the information needed by the transfer agent (the program which actually moves the map) to call back yppush.

When the transfer attempt is complete, whether successfully or not, and the transfer agent sends yppush a status message, the results may be printed to the standard output.  Messages print when a transfer is not possible, for instance when the request message is undeliverable or when the timeout period on responses expires. 

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

Options

-d domain
Copy mapname to the YP servers in domain rather than to the domain returned by domainname(1).

−v Verbose mode: messages print when each server is called and when each response is received.  If this option is omitted, only error messages print. 

WARNINGS

In the current implementation (Version 2 YP protocol), the transfer agent is ypxfr(1M) which is started by the ypserv(1M) program at yppush’s request.  If yppush detects it is speaking to a Version 1 YP protocol server, it uses the older protocol to send a Version 1 YPPROC_GET request and issues a message to that effect.  Unfortunately, there is no way of knowing if or when the map transfer is performed for Version 1 servers.  The yppush prints a comment saying that a Version 1 message was sent.  The system administrator should check later to ensure the transfer actually occurred. 

AUTHOR

Sun Microsystems, Inc. 

FILES

/usr/etc/yp/domain/ypservers.{dir, pag}
/usr/etc/yp/domain/mapname.{dir, pag}

SEE ALSO

domainname(1), ypserv(1M), ypxfr(1M), ypfiles(4). 

INTERNATIONAL SUPPORT

8-bit data, messages

Hewlett-Packard Company  —  May 11, 2021