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 UNIX-based subordinate (also known as 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 the note in this topic.

The yppush command sends a transfer map request from the NIS server to the transfer agent on each subordinate host computer. A host's transfer agent is the utility that copies map data from the master server. When the transfer has completed, whether the transfer operation succeeded or failed, the transfer agent returns a status message, the contents of which can be printed to standard output. Transfer agents also return messages when a transfer is not possible; for example, when the yppush request is undeliverable to one or more host computers, or when the time-out period on responses from host computers has expired.

The yppush command accepts the following options and arguments:

Term Definition

-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:


See Also