4.3BSD-UWisc/man/cat8/yppush.8

Compare this file to the similar file:
Show the results in this format: 




YPPUSH(8)           UNIX Programmer's Manual            YPPUSH(8)



NAME
     yppush - force propagation of a changed YP map

SYNOPSIS
     yppush [ -d _d_o_m_a_i_n ] [ -v ] _m_a_p_n_a_m_e

DESCRIPTION
     _y_p_p_u_s_h copies a new version of a Yellow Pages (YP) map from
     the master YP server to the slave YP servers.  It is nor-
     mally run only on the master YP server by the _M_a_k_e_f_i_l_e in
     /_u_s_r/_e_t_c/_y_p/ after the master databases are changed.  It
     first constructs a list of YP server hosts by reading the YP
     map _y_p_s_e_r_v_e_r_s within the _d_o_m_a_i_n.  Keys within the map
     _y_p_s_e_r_v_e_r_s 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 _y_p_p_u_s_h . When the attempt has completed (success-
     fully or not), and the transfer agent has sent _y_p_p_u_s_h 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(5) and ypserv(8) for an overview of the
     yellow pages.

OPTIONS
     -d   Specify a _d_o_m_a_i_n.

     -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/yp/_d_o_m_a_i_n_n_a_m_e/ypservers.{dir, pag}

SEE ALSO
     ypserv(8), ypxfr(8), ypfiles(5), YP protocol specification

BUGS
     In the current implementation (version 2 YP protocol), the
     transfer agent is _y_p_x_f_r, which is started by the _y_p_s_e_r_v pro-
     gram.  If _y_p_p_u_s_h 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 when
     the map transfer is performed for version 1 servers.  _y_p_p_u_s_h
     prints a message saying that an "old-style" message has been
     sent.  The system administrator should later check to see



Printed 12/27/86           1 Aug 1985                           1






YPPUSH(8)           UNIX Programmer's Manual            YPPUSH(8)



     that the transfer has actually taken place.






















































Printed 12/27/86           1 Aug 1985                           2