force propagation of a changed NIS map
yppush [ -d domain ]
[ -v ] mapname
yppush copies a new version of a Network
Information Service (NIS) map from the master
NIS server to the slave NIS servers.
It is normally run only on the master NIS server
by make in /etc/yp after the master
databases are changed. It first constructs a list of
NIS server hosts by reading the NIS map
ypservers within the domain 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.
When the attempt has completed (successfully or not) and
the transfer agent has sent yppush a status
message, the results may 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.
for an overview of the Network Information Service.
specify a domain
verbose. This causes messages to be printed when each
server is called and for each response. If this flag is
omitted, only error messages are printed.
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
(by 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 is performed
for version 1 servers. yppush prints a message
saying that an ``old-style'' message has been sent.
The System Administrator should check later to see that the
transfer has actually taken place.
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003