YPPUSH(1M-SysV) RISC/os Reference Manual YPPUSH(1M-SysV)
NAME
yppush - force propagation of a changed NIS map
SYNOPSIS
/usr/etc/yp/yppush [ -v ] [ -d domain ] mapname
DESCRIPTION
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 /etc/yp after the master databases are
changed. It first constructs a list of NIS server hosts by
reading the NIS map ypservers within the domain. Keys
within the map ypservers 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 which actually moves the map) to call
back the yppush. When the attempt has completed (success-
fully or not), and the transfer agent has sent yppush a
status message, the results may be printed to stdout. Mes-
sages 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
Network Information Service.
OPTIONS
-d Specify a domain.
-v Verbose. This causes messages to be printed when each
server is called, and for each response. If this flag
is omitted, only error messages are printed.
FILES
ypserv(1M), ypxfr(1M).
ypfiles(4) in the Programmer's Reference Manual.
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.
Printed 1/15/91 Page 1
YPPUSH(1M-SysV) RISC/os Reference Manual YPPUSH(1M-SysV)
ORIGIN
Sun Microsystems
Page 2 Printed 1/15/91