yppush Command

Purpose

Prompts the Network Information Services (NIS) slave servers to copy updated NIS maps.

Syntax

/usr/sbin/yppush [ -v ] [ -d Domain ] MapName

Description

The yppush command, which is issued from the /usr/etc/yp directory, prompts the Network Information Services (NIS) slave servers to make copies of updated NIS maps. The MapName variable specifies that map to be transferred to the slave servers of the master servers. To get a list of the servers it needs to prompt, the yppush command reads the ypservers map, specified by the Domain parameter or the current default domain. When prompted, each slave server uses the ypxfr command to copy and transfer the map back to its own database.

You can use the System management interface tool (SMIT) to run this command. To use SMIT, type:

smit yppush
Note: If your system uses version 1 of the NIS protocol, the ypxfr command is not the transfer agent.

Flags

Item Description
-d Domain Specifies a domain other than the default domain. The maps for the specified domain must exist.
-v Displays messages as each server is called and then displays one message for each server's response, if you are using the version 2 protocol. If this flag is omitted, the command displays error messages only.
Note: Version 1 of the NIS protocol does not display messages. If your system uses version 1, use the yppoll command to verify that the transfer took place.

Examples

  1. To copy a map from another domain to the slave servers, type: 
    /usr/sbin/yppush -d atlantis netgroup
    In this example, the yppush command copies the netgroup map from the atlantis domain.
  2. To display the in-progress status of the yppush command as it calls each slave server, type: 
    /usr/sbin/yppush -v -d atlantis netgroup
    In this example, the yppush command displays in-progress messages as it copies the netgroup map from the atlantis domain onto each of the network's slave servers.

Files

Item Description
/var/yp/DomainName/ypservers.{dir, pag} Lists servers that the yppush command prompts to make copies of updated NIS maps.