yppush(1M)                                             yppush(1M)



     NAME
          yppush - force propagation of a changed YP map

     SYNOPSIS
          yppush [-d domain] [-v] mapname

     DESCRIPTION
          yppush copies a new version of a Yellow Pages (YP) map from
          the master YP server to the slave YP servers.  It is normal-
          ly run only on the master YP server by the Makefile in
          /etc/yp after the master databases are changed.  It first
          constructs a list of YP server hosts by reading the YP map
          ypsrvs within the domain.  Keys within the map ypsrvs 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 (success-
          fully or not), and the transfer agent has sent yppush a
          status message, the results may be printed to standard
          ouput.  Messages are also printed when a transfer is not
          possible; for instance when the request message is un-
          deliverable, or when the timeout period on responses has ex-
          pired.

          Refer to ypfiles(4) and ypserv(1M) for an overview of the
          yellow pages.

     FLAG 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
          /etc/yppush
          /etc/yp/domainname/ypsrvrs.dir
          /etc/yp/domainname/ypsrvrs.pag

     SEE ALSO
          ypserv(1M), ypxfr(1M), ypfiles(4).
          A/UX Network Applications Programming.

     BUGS
          In the current implementation (version 2 YP protocol), the
          transfer agent is ypxfr, which is started by the ypserv pro-
          gram.  If yppush detects that it is speaking to a version 1
          YP 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



     April, 1990                                                     1

     yppush(1M)                                             yppush(1M)



          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.



















































     2                                                     April, 1990