ypxfr(1M)						  System Administration Commands						 ypxfr(1M)

NAME

       ypxfr, ypxfr_1perday, ypxfr_1perhour, ypxfr_2perday - transfer NIS map from a NIS server to host

SYNOPSIS

       /usr/lib/netsvc/yp/ypxfr [-c] [-f] [ -C tid prog server] [-d ypdomain] [-h host] [-s ypdomain] mapname

DESCRIPTION

       The  ypxfr  command  moves  an NIS map in the default domain for the local host to the local host by making use of normal NIS services.	It
       creates a temporary map in the directory /var/yp/ypdomain (this directory must already exist; ypdomain is the default domain for the  local
       host), 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 name.

       If run interactively, ypxfr writes its output to the terminal. However, if it is started without a controlling terminal,  and  if  the  log
       file  /var/yp/ypxfr.log	exists,  it  appends all its output to that file. Since ypxfr is most often run from the privileged user's crontab
       file, or by ypserv, the log file can retain a record of what was attempted, and what the results were.

       For consistency between servers, ypxfr should be run periodically for every map in the NIS data base. Different maps  change  at  different
       rates: a map might not change for months at a time, for instance, and can therefore be checked only once a day. Some maps might change sev-
       eral times per day. In such a case, you might want to check hourly for updates. A crontab(1) entry can be  used	to  automatically  perform
       periodic  updates.  Rather  than  having  a  separate  crontab entry for each map, you can group commands to update several maps in a shell
       script. Examples (mnemonically named) are in /usr/sbin/yp: ypxfr_1perday, ypxfr_2perday, and ypxfr_1perhour.

       Refer to ypfiles(4) for an overview of the NIS name service.

OPTIONS

       -c		       Do not send a "Clear current map" request to the local ypserv process. Use this	flag  if  ypserv  is  not  running
			       locally	at  the  time  you are running ypxfr. Otherwise, ypxfr complains that it cannot communicate with the local
			       ypserv, and the transfer fails.

       -f		       Force the transfer to occur even if the version at the master is not more recent than the local version.

       -C tid prog server      This option is for use only by ypserv. When ypserv starts ypxfr, it specifies that ypxfr should call back a  yppush
			       process at the host server, registered as program number prog, and waiting for a response to transaction tid.

       -d ypdomain	       Specify a domain other than the default domain.

       -h host		       Get  the map from host, regardless of the master. If host is not specified, ypxfr asks the NIS service for the name
			       of the master, and tries to get the map from there. host must be a valid host name.

       -s ypdomain	       Specify a source domain from which to transfer a map that should be the same across domains.

FILES

       /var/yp/ypxfr.log		       Log file

       /usr/lib/netsvc/yp/ypxfr_1perday        Script to run one transfer per day, for use with cron(1M)

       /usr/lib/netsvc/yp/ypxfr_2perday        Script to run two transfer per day, for use with cron(1M)

       /usr/lib/netsvc/yp/ypxfr_1perhour       Script for hourly transfers of volatile maps

       /var/yp/ypdomain 		       NIS domain

       /usr/spool/cron/crontabs/root	       Privileged user's crontab file

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

   ypxfr Only
       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWnisu			   |
       +-----------------------------+-----------------------------+

   ypxfr_1perday, ypxfr_1perhour, and ypxfr_2perday
       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWypu			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       crontab(1), cron(1M), ypinit(1M), yppush(1M), ypserv(1M), ypfiles(4), attributes(5)

SunOS 5.10							    11 Mar 1998 							 ypxfr(1M)