Commands Reference, Volume 6

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

-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

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

/var/yp/DomainName/ypservers.{dir, pag}

Lists servers that the yppush command prompts to make copies of updated NIS maps.

Related Information

The yppoll command, ypxfr command.

The ypserv daemon.

System Management Interface Tool in AIX 5L Version 5.2 System Management Concepts: Operating System and Devices.

Network File System (NFS) Overview for System Management in AIX 5L Version 5.2 System Management Guide: Communications and Networks and NIS Maps in AIX 5L Version 5.2 Network Information Services (NIS and NIS+) Guide.

Network Information Services (NIS) Overview for System Management in AIX 5L Version 5.2 Network Information Services (NIS and NIS+) Guide.

NIS Reference.