YPPUSH(8) Maintenance Commands and Procedures YPPUSH(8)
NAME
yppush - force propagation of changed NIS map
SYNOPSIS
/usr/lib/netsvc/yp/yppush [
-v] [
-h host] [
-d domain]
[
-p #parallel-xfrs]
mapnameDESCRIPTION
yppush 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 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 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(5) and
ypserv(8) 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.
SEE ALSO
ypfiles(5),
attributes(7),
ypserv(8),
ypxfr(8)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(8), 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.
August 26, 1999 YPPUSH(8)
