YPPUSH(8)               COMMAND REFERENCE               YPPUSH(8)



NAME
     yppush - force propagation of a changed YP map

SYNOPSIS
     /usr/etc/yp/yppush [ -d domain ] [ -v ] mapname

DESCRIPTION
     The command yppush copies a new version of a Yellow Pages
     (YP) map from the master YP server to the slave YP servers;
     yppush is normally run only on the master YP server by the
     Makefile in /etc/yp after the master data bases are changed.
     The command first constructs a list of YP server hosts by
     reading the YP map ypservers within the domain.  Keys within
     the map ypservers are the ASCII names of the machines on
     which the YP servers run.

     A transfer map  request is sent to the YP 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
     (successfully or not), and the transfer agent has sent
     yppush 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.

     Refer to ypfiles(5) and ypserv(8) for an overview of the
     Yellow Pages.

OPTIONS
     -d   Specify a domain.

     -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
     /etc/yp/domainname/ypservers.{dir, pag}
                                   where domainname is the name
                                   of your domain (host)

CAVEATS
     In the current implementation (version 2 YP protocol), the
     transfer agent is ypxfr, which is started by the ypserv
     program.  If yppush detects that it is speaking to a version
     1 YP protocol server instead of the version 2 YP protocol,
     it uses the older protocol, sending a

          version 1 YPPROC_GET





Printed 5/12/88                                                 1

YPPUSH(8)               COMMAND REFERENCE               YPPUSH(8)



     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.

SEE ALSO
     ypfiles(5), ypserv(8), ypxfr(8).

     Refer to the YP protocol specification.












































Printed 5/12/88                                                 2

%%index%%
na:288,98;
sy:386,389;
de:775,1587;
op:2362,330;
fi:2692,303;
ca:2995,492;3847,413;
se:4260,246;
%%index%%000000000130