Manual Pages for UNIX Operating System command usage for man ypxfr

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  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



SunOS 5.11          Last change: 11 Mar 1998                    1






System Administration Commands                          ypxfr(1M)



                           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)





SunOS 5.11          Last change: 11 Mar 1998                    2






System Administration Commands                          ypxfr(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                | system/network/nis          |
    |_____________________________|_____________________________|


  ypxfr_1perday, ypxfr_1perhour, and ypxfr_2perday
     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | service/network/nis         |
    |_____________________________|_____________________________|


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

















SunOS 5.11          Last change: 11 Mar 1998                    3