manpages.info - online man pages   

SunOS man pages : yppush (1)

Maintenance Commands                                   yppush(1M)

NAME

yppush - force propagation of changed NIS map

SYNOPSIS

/usr/lib/netsvc/yp/yppush [ -v ] [ -h host ] [ -d domain ] [ -p #parallel-xfrs ] mapname

DESCRIPTION

yppush copies a new version of a Network Information Ser- vice (NIS) map from the master NIS server to the slave NIS servers. It is normally run only on the master NIS server by the Makefile in /var/yp after the master databases are changed. It first constructs a list of NIS server hosts by reading the NIS ypservers map within the domain. Keys within the ypservers map are the ASCII names of the machines on which the NIS servers run. A "transfer map" request is sent to the NIS server at each host, along with the information needed by the transfer agent (the program which actually moves the map) to call back the yppush. When the attempt has completed (success- fully or not), and the transfer agent has sent yppush a status message, the results may be printed to stdout. Mes- sages are also printed when a transfer is not possible; for instance when the request message is undeliverable, or when the timeout period on responses has expired. Refer to ypfiles(4) and ypserv(1M) for an overview of the NIS service.

OPTIONS

-d domain Specify a domain. -h host Propagate only to the named host. -p #parallel-xfrs Allow the specified number of map transfers to occur in parallel. -v Verbose. This prints messages when each server is called, and for each response. If this flag is omit- ted, only error messages are printed.

FILES

/var/yp Directory where NIS configuration files reside. /var/yp/domain/ypservers.{dir, pag} Map containing list of NIS servers to bind to when running in server mode. SunOS 5.8 Last change: 26 Aug 1999 1 Maintenance Commands yppush(1M)

ATTRIBUTES

See attributes(5) for descriptions of the following attri- butes: ________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_______________________|_______________________| | Availability | SUNWypu | |_______________________|_______________________|

SEE ALSO

ypserv(1M), ypxfr(1M), ypfiles(4), attributes(5)

NOTES

The Network Information Service (NIS) was formerly known as Sun Yellow Pages (YP). The functionality of the two remains the same; only the name has changed. The name Yellow Pages is a registered trademark in the United Kingdom of British Telecommunications plc, and may not be used without permis- sion.

BUGS

In the current implementation (version 2 NIS protocol), the transfer agent is ypxfr(1M), which is started by the ypserv program. If yppush detects that it is speaking to a version 1 NIS protocol server, it uses the older protocol, sending a version 1 YPPROC_GET request and issues a message to that effect. Unfortunately, there is no way of knowing if or when the map transfer is performed for version 1 servers. yppush prints a message saying that an "old-style" message has been sent. The system administrator should later check to see that the transfer has actually taken place. SunOS 5.8 Last change: 26 Aug 1999 2