'\"macro stdmacro
.if n .pH g1a.yppush @(#)yppush	40.3 of 1/29/90
.\" Copyright 1989 AT&T
.\" @(#)yppush.8 1.9 89/09/28 SMI;
.\" Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved.
.nr X
.if \nX=0 .ds x} yppush 1M "" "\&"
.if \nX=1 .ds x} yppush 1M ""
.if \nX=2 .ds x} yppush 1M "" "\&"
.if \nX=3 .ds x} yppush "" "" "\&"
.TH \*(x}
.SH NAME
\f4yppush\fP \- force propagation of a changed YP map
.SH SYNOPSIS
\f4/usr/sbin/yppush\fR
[
\f4\-v\fR
] [
\f4\-d\fR
\f2ypdomain\fR
]
\f2mapname\fR
.SH DESCRIPTION
.P
\f4yppush\fR
copies a new version of a YP
name service map from the master
\s-1YP\s0
server to the slave
\s-1YP\s0
servers.
It is normally run only on the master
\s-1YP\s0
server by the
\f4Makefile\fR
in
\f4/var/yp\fR
after the master databases are changed.
It first constructs a list of
\s-1YP\s0
server hosts by reading the
\s-1YP\s0
map
\f4ypservers\fR
within the
\f2ypdomain\fR,
or if the map is not set up,
the local file is used.
Keys within the map
\f4ypservers\fR
are the
\s-1ASCII\s0
names of the machines on which the
\s-1YP\s0
servers run.
.P
A \(lqtransfer map\(rq request is sent to the
\s-1YP\s0
server at each host,
along with the information needed by the transfer agent (the program
which actually moves the map) to call back the
\f4yppush .\fR
When the attempt has completed (successfully
or not), and the transfer agent has sent
\f4yppush\fR
a status message, the results may 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.
.P
Refer to
\f4ypfiles\fR(4)
and
\f4ypserv\fR(1M)
for an overview of the YP name service.
.P
The following optionas are available:
.TP
\f4\-v\fR
Verbose.
Print messages when each server is called,
and for each response.
If this flag is omitted, only error messages are printed.
.TP
\f4\-d \f2ypdomain\fR
Specify a
\f2ypdomain \fR
other than the default domain.
.SH FILES
.PD 0
.TP 2.75i
\f4/var/yp/\f2ypdomain\f4/ypservers.{\f2dir\f4,\f2pag\f4}\f1
local file
.TP
\f4/var/yp\fR
.PD
.SH SEE ALSO
\f4ypserv\fR(1M),
\f4ypxfr\fR(1M),
\f4ypfiles\fR(4)
