yppush(1M) System Administration Commands yppush(1M)NAMEyppush - force propagation of changed NIS map
SYNOPSIS
/usr/lib/netsvc/yp/yppush [-v] [-h host] [-d domain]
[-p #parallel-xfrs] mapname
DESCRIPTIONyppush copies a new version of a Network Information Service (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 mas‐
ter 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 that
actually moves the map) to call back the yppush. When the attempt has
completed (successfully or not), and the transfer agent has sent yppush
a status message, the results can be printed to stdout. Messages 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
The following options are supported:
-d domain Specifies a domain.
-h host Propagates only to the named host.
-p #parallel-xfrs Allows 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
omitted, 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.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │service/network/nis │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOypserv(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 must not be
used without permission.
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.11 26 Aug 1999 yppush(1M)
