yppush.1m (2010 09)

y
yppush(1M) yppush(1M)
NAME
yppush - force propagation of Network Information Service database
SYNOPSIS
/usr/sbin/yppush
[-d domain ][-h host ][
-m maxm ][-t mint ][-v] mapname
Remarks
The Network Information Service (NIS) was formerly known as Yellow Pages (YP). Although the name
has changed, the functionality of the service remains the same.
DESCRIPTION
yppush copies a Network Information Service (NIS) map (database), mapname, from the map’s master
NIS server to each slave NIS server. It is usually executed only on the master NIS server by shell script
ypmake which is run either after changes are made to one or more of the master’s NIS databases or
when the NIS databases are first created. See ypmake (1M) and ypinit (1M) for more information on these
processes.
yppush constructs a list of NIS server host names by reading the NIS map
ypservers within the
domain. Keys within the
ypservers map are the host names of the machines on which the NIS servers
run. yppush then sends a "transfer map" request to the NIS server at each host, along with the informa-
tion needed by the transfer agent (the program that actually moves the map) to call back yppush
.
When the transfer attempt is complete, whether successful or not, and the transfer agent sends
yppush
a status message, the results can be printed to standard output. Messages are printed when a transfer is
not possible, such as when the request message is undeliverable or when the timeout period on responses
expires.
Refer to ypfiles (4) and ypserv (1M) for an overview of Network Information Service.
Options
yppush recognizes the following options:
-d domain Copy mapname to the NIS servers in domain rather than to the domain returned by
domainname (see domainname (1)).
-h host Propagate the map(s) only to the specified host.
-m maxm Attempt to run maxm transfers in parallel to as many servers simultaneously. Without
the -m option, yppush attempts to transfer a map to each server, one at a time. When
a network has many servers, such serial transfers can result in long delays to complete
all transfers. A maxm value greater than 1 reduces total transfer time through better
utilization of CPU time at the master. maxm can be any value from 1 through the
number of NIS servers in the domain.
-t mint Set the minimum timeout value to mint seconds. When transferring to one slave at a
time, yppush waits up to 80 seconds for the transfer to complete, after which it begins
transferring to the next slave. When multiple parallel transfers are attempted by use
of the -m option, it may be necessary to set the transfer timeout limit to a value larger
than the default 80 seconds to prevent timeouts caused by network delays related to
parallel transfers.
-v Verbose mode: messages are printed when each server is called and when each
response is received. If this option is omitted, only error messages are printed.
WARNINGS
In the current implementation (Version 2 NIS protocol), the transfer agent is ypxfr (1M) which is started
by the ypserv (1M) program at yppush ’s request (see ypxfr (1M) and ypserv (1M)).
Starting with ONCplus version B.11.31.02, the NIS Version 1 protocol is no longer available.
AUTHOR
yppush was developed by Sun Microsystems, Inc.
FILES
/usr/sbin/domain/ypservers.{dir, pag}
/usr/sbin/domain/mapname.{dir, pag}
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1