HP-UX Reference (11i v1 00/12) - 1M System Administration Commands N-Z (vol 4)
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man1m/naaagt.1m
________________________________________________________________
___ ___
y
yppush(1M) yppush(1M)
NAME
yppush - force propagation of Network Information Service database
SYNOPSIS
/usr/sbin/yppush [-d domain][-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)).
-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)). If yppush detects it is
interacting with a Version 1 NIS protocol server, it uses the older protocol to send 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 comment saying that a Ver-
sion 1 message was sent. The system administrator should then verify by other means that the transfer
actually occurred.
AUTHOR
yppush was developed by Sun Microsystems, Inc.
Section 1M−−1082 − 1 − HP-UX Release 11i: December 2000
___
___