ypxfr(8) — AIX PS/2 1.2.1



YPXFR(8,C)                  AIX Commands Reference                   YPXFR(8,C)



-------------------------------------------------------------------------------
ypxfr



PURPOSE

Transfers an NIS map from some NIS server.

SYNTAX


                 +-----------+   +-------------+   +--------+
/etc/yp/ypxfr ---|           |---|             |---| +----+ |--->
                 +- -h host -+   +- -d domain -+   +-| -f |-+
                                                    ^| -c ||
                                                    |+----+|
                                                    +------+

    +--------------------------+
>---|                          |--- map ---|
    +- -C tid prof ipadd part -+


Note:  This command does not have MBCS support.

DESCRIPTION

The ypxfr command moves an NIS map to the local host by making use of normal
network information service.  It creates a temporary map in the directory
/etc/yp/domain (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 the ypxfr command is run interactively, it writes its output to the
terminal.  However, if it is invoked without a controlling terminal, and if the
log file /etc/yp/ypxfr.log exists, it appends all its output to that file.
Since ypxfr is most often run from /usr/lib/crontab, or by ypserv, you can use
the log file to 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; the
services.byname 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
mail.aliases or hosts.byname changes several times per day.  In such a case,
you may want to check hourly for updates.  A crontab 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 /etc/yp:  ypxfr_1perday,
ypxfr_2perday, and ypxfr_1perhour.  They can serve as reasonable first cuts.



Processed November 8, 1990        YPXFR(8,C)                                  1



YPXFR(8,C)                  AIX Commands Reference                   YPXFR(8,C)




FLAGS

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

-c             Don't 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.

-h host        Get the map from host, regardless of what the map says the
               master is.  If host is not specified, ypxfr asks the network
               information service for the name of the master and tries to get
               the map from there.  host can be a name or an internet address
               in the form aa.bb.cc.dd.

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

-C tid prog ipadd port
               This option is only for use by ypserv.  When ypserv invokes
               ypxfr, it specifies that ypxfr should call back a yppush process
               at the host with IP address ipaddr, registered as program number
               prog, listening on port port, and waiting for a response to
               transaction tid.

FILES

/etc/yp/ypxf.log  Log file.
/etc/yp/ypxfr_1perday
                  Script to run one transfer per day, for use with cron.
/etc/yp/ypxfr_2perday
                  Script to run two transfers per day.
/etc/yp/ypxfr_1perhour
                  Script for hourly transfers of volatile maps.

RELATED INFORMATION

See the following commands:  "cron,"  "ypserv, ypbind," and  "yppush."
















Processed November 8, 1990        YPXFR(8,C)                                  2

Museum

Related Articles