yppush(8)yppush(8)NAMEyppush - force propagation of a changed Network Information Service
(NIS) map
SYNOPSISyppush [-d domain] [-v] mapname
OPTIONS
Specify a domain. Verbose. This causes messages to be printed when
each server is called, and for each response. Without this option, only
error messages are printed.
DESCRIPTION
The yppush command copies a new version of a Network Information Ser‐
vice (NIS) map from the master NIS server to the slave NIS servers. It
is normally run only on the master NIS server by the make utility
accessing the /var/yp/Makefile after the master NIS databases have been
changed. When invoked, yppush first constructs a list of NIS server
hosts by reading the NIS map ypservers within the domain. Keys within
the map ypservers are the ASCII names of the machines on which the NIS
servers run.
A transfer map request is sent to the NIS server at each host, along
with the information needed by the transfer agent (the program which
actually moves the map) to call back the yppush command. When the
attempt has completed (successfully or not), and the transfer agent has
sent yppush a status 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 ypfiles(4) and ypserv(8) for an overview of NIS.
RESTRICTIONS
In the current implementation (version 2 NIS protocol), the transfer
agent is ypxfr, which is started by the ypserv program. If yppush
detects that it is speaking to a version 1 NIS 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 yppush
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.
ERRORS
Map xxx no such map in server's domain -- using ypservers
Explanation:
This is an informational message that indicates that the yppush
command will push the maps to all servers listed in the
ypservers map.
FILESSEE ALSO
Commands: ypserv(8), ypxfr(8)
Files: ypfiles(4)yppush(8)