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


yppush [-d adNisDomain] [-q] [-t timeout] [-h host[...]] mapname


The yppush(1w) Windows command-line utility sends a request to subordinate (slave) NIS servers to transfer a new version of the NIS map specified by mapname from the master NIS server. It is run only on the master NIS server after the NIS map has been changed. If the -h option is specified, the transfer request is sent only to the specified server. Otherwise, yppush first constructs a list of NIS server hosts by reading the ypservers NIS map within the domain. For more information about the correct format of the ypservers map, see "Notes" later in this topic.

A transfer map request is sent to the NIS server at each host to the transfer agent at that host (the program that actually moves the map) to call back the master server. When the attempt has completed (successfully or not), and the transfer agent has sent yppush a status message, the results can be printed to standard output. Messages are also printed when a transfer is not possible, for instance when the request message is undeliverable, or when the time-out period on responses has expired.

The yppush command accepts the following options and arguments:

-d adNisDomain
Specifies the NIS domain. If this option is not used, the NIS domain is assumed to be the domain named in the DEFAULT_NIS_DOMAIN environment variable.
Quiet mode. Does not wait for a response from subordinate servers, and does not report errors.
-t timeout
Specifies a time-out value, in seconds, that yppush will wait for a response from the subordinate server. This value must be greater than zero. The default value is 30 seconds.
-h host[...]
The name of the host to notify of the map change. You can specify multiple host names, separated by spaces. If you do not specify this option, the notification is sent to all subordinate servers in the domain.


Keys within the ypservers map are the ASCII names of the computers on which the NIS servers run. That is, the ypservers map should contain a list of NIS servers, each one listed on a separate line. If your ypservers map contains aliases, edit the ypservers map to contain only the host names of the servers, one per line. The following list is an example of a valid ypservers map:



Server for NIS