YPXFR(8) UNIX Programmer's Manual YPXFR(8) NAME ypxfr - transfer a YP map from some YP server to here SYNOPSIS ypxfr [ -f ] [ -h _h_o_s_t ] [ -d _d_o_m_a_i_n ] [ -c ] [ -C _t_i_d _p_r_o_g _i_p_a_d_d _p_o_r_t ] _m_a_p_n_a_m_e DESCRIPTION _y_p_x_f_r moves a YP map to the local host by making use of nor- mal YP services. It creates a temporary map in the direc- tory /_e_t_c/_y_p/_d_o_m_a_i_n (which must already exist), fills it by enumerating the map's entries, fetches the map parameters (master and order number) and loads them. It then deletes any old versions of the map and moves the temporary map to the real mapname. If _y_p_x_f_r is run interactively, it writes its output to the terminal. However, if it's invoked without a controlling terminal, and if the log file /_e_t_c/_y_p/_y_p_x_f_r._l_o_g exists, it will append all its output to that file. Since _y_p_x_f_r is most often run from /_u_s_r/_l_i_b/_c_r_o_n_t_a_b , or by _y_p_s_e_r_v , you can use the log file to retain a record of what was attempted, and what the results were. For consistency between servers, _y_p_x_f_r should be run period- ically for every map in the YP data base. Different maps change at different rates: the _s_e_r_v_i_c_e_s._b_y_n_a_m_e map may not change for months at a time, for instance, and may therefore be checked only once a day in the wee hours. You may know that _m_a_i_l._a_l_i_a_s_e_s or _h_o_s_t_s._b_y_n_a_m_e changes several times per day. In such a case, you may want to check hourly for updates. A _c_r_o_n_t_a_b(5) entry can be used to perform periodic updates automatically. Rather than having a separate _c_r_o_n_t_a_b entry for each map, you can group comands to update several maps in a shell script. Examples (mnemon- ically named) are in /_e_t_c/_y_p: _y_p_x_f_r__1_p_e_r_d_a_y._s_h, _y_p_x_f_r__2_p_e_r_d_a_y._s_h, and _y_p_x_f_r__1_p_e_r_h_o_u_r._s_h. They can serve as reasonable first cuts. Refer to ypfiles(5) and ypserv(8) for an overview of the yellow pages. OPTIONS -f Force the transfer to occur even if the version at the master is not more recent than the local ver- sion. -c Don't send a "Clear current map" request to the local _y_p_s_e_r_v process. Use this flag if _y_p_s_e_r_v is not running locally at the time you are running _y_p_x_f_r. Otherwise, _y_p_x_f_r will complain that it can't talk to the local _y_p_s_e_r_v, and the transfer Printed 12/27/86 1 Aug 1985 1 YPXFR(8) UNIX Programmer's Manual YPXFR(8) will fail. -h _h_o_s_t Get the map from _h_o_s_t , regardless of what the map says the master is. If _h_o_s_t is not specified, _y_p_x_f_r will ask the YP service for the name of the master, and try to get the map from there. _h_o_s_t may be a name or an internet address in the form _a._b._c._d . -d _d_o_m_a_i_n Specify a domain other than the default domain. -C _t_i_d _p_r_o_g _i_p_a_d_d _p_o_r_t This option is only for use by _y_p_s_e_r_v. When _y_p_s_e_r_v invokes _y_p_x_f_r, it specifies that _y_p_x_f_r should call back a _y_p_p_u_s_h process at the host with IP address _i_p_a_d_d_r , registered as program number _p_r_o_g , listening on port _p_o_r_t , and waiting for a response to transaction _t_i_d . FILES /etc/yp/ypxfr.log, /etc/yp/ypxfr_1perday.sh, /etc/yp/ypxfr_2perday.sh, /etc/yp/ypxfr_1perhour.sh, /usr/lib/crontab SEE ALSO ypfiles(5), ypserv(8), yppush(8), YP protocol spec Printed 12/27/86 1 Aug 1985 2