Maintenance 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 a 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  termi-
     nal.  However, if it is started without a controlling termi-
     nal, 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 be used to retain a record of what
     was attempted, and what the results were.

     For consistency between servers, ypxfr should be run period-
     ically  for  every  map in the NIS data base. Different maps
     change at different rates: a map may not change  for  months
     at  a  time, for instance, and may therefore be checked only
     once a day. Some maps may change several times per  day.  In
     such  a  case,  you  may want to check hourly for updates. A
     crontab(1) entry can be used  to  perform  periodic  updates
     automatically.  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. They can serve as reasonable first cuts.

     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  talk  to 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.

SunOS 5.8           Last change: 11 Mar 1998                    1

Maintenance Commands                                    ypxfr(1M)

     -C tid prog server
           This option is only for use  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 what the map says
           the  master  is.  If host is not specified, ypxfr asks
           the NIS service for the name of the master, and try to
           get the map from there. host must be a 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  attri-
     butes:

  ypxfr Only
     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWnisu                    |
    |_____________________________|_____________________________|

SunOS 5.8           Last change: 11 Mar 1998                    2

Maintenance Commands                                    ypxfr(1M)

  ypxfr_1perday, ypxfr_1perhour, and ypxfr_2perday
     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWypu                     |
    |_____________________________|_____________________________|

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

SunOS 5.8           Last change: 11 Mar 1998                    3