yppush(8yp)yppush(8yp)Nameyppush - force propagation of a changed yellow pages (YP) map
Syntaxyppush [ -d domain ] [ -v ] mapname
Description
The command copies a new version of a yellow pages (YP) map from the
master YP server to the slave YP servers. It is normally run only on
the master YP server by the utility accessing the after the master YP
databases have been changed. When invoked, first constructs a list of
YP server hosts by reading the YP map ypservers within the domain.
Keys within the map ypservers are the ASCII names of the machines on
which the YP servers run.
A transfer map request is sent 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 the command. When the attempt has
completed (successfully or not), and the transfer agent has sent a sta‐
tus message, the results can be printed to stdout. Messages are also
printed when a transfer is not possible, for instance when the request
message is undeliverable, or when the timeout period on responses has
expired.
Refer to and for an overview of the yellow pages.
Options-d Specify a domain.
-v Verbose. This causes messages to be printed when each server is
called, and for each response. Without this flag, only error
messages are printed.
Restrictions
In the current implementation (version 2 YP protocol), the transfer
agent is which is started by the program. If detects that it is speak‐
ing to a version 1 YP protocol server, it uses the older protocol,
sending 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 was performed for version 1 servers. The command prints a
message saying that an old-style message has been sent. The system
administrator should later check to see that the transfer has actually
taken place.
Files
/etc/yp/domainname/ypservers.{dir, pag}
See Alsoypfiles(5yp), ypserv(8yp), ypxfr(8yp)yppush(8yp)