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  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  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 might not change for months
     at  a  time, for instance, and can therefore be checked only
     once a day. Some maps might change several 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  attri-
     butes:

  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)