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 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 mes-
sage, 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 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.
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 must 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.
Man(1) output converted with
man2html