yppush Command

Edit online

Purpose

Prompts the Network Information Services (NIS) worker 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) worker servers to make copies of updated NIS maps. The MapName variable specifies that map to be transferred to the worker 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 worker 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

Table 1. 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 worker 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 worker 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 worker servers.

Files

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