yppush(8)						      System Manager's Manual							 yppush(8)

NAME

       yppush - force propagation of a changed Network Information Service (NIS) map

SYNOPSIS

       yppush [-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 Service (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.

FILES

SEE ALSO

       Commands: ypserv(8), ypxfr(8)

       Files: ypfiles(4)

																	 yppush(8)