ypxfr(1M) ONC 5.4.2 ypxfr(1M)
NAME
ypxfr - transfer NIS map from an NIS server to here
SYNOPSIS
/usr/etc/yp/ypxfr [ -f ] [ -c ] [ -d domain ] [ -h host ] [ -s domain
] [ -C tid prog ipaddr port ] [ -S ] mapname
DESCRIPTION
ypxfr 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 /etc/yp/domain (this directory must
already exist; domain 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 mapname.
Note that you must be root to execute this command.
If run interactively, ypxfr 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 will append all its output to
that file. Since ypxfr is most often run from the crontab file, 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(4) 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/etc/yp:
ypxfr_1perday, ypxfr_2perday, and ypxfr_1perhour. They can serve as
reasonable first cuts.
Refer to ypfiles(4) and ypserv(1M) for an overview of the Network
Information Service.
OPTIONS
-f Force the transfer to occur even if the version at the master
is not more recent than the local version.
-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
will complain that it can't talk to the local ypserv, and the
transfer will fail.
-ddomain
Specify a domain other than the default domain.
-hhost Get the map from host, regardless of what the map says the
Licensed material--property of copyright holder(s) 1
ypxfr(1M) ONC 5.4.2 ypxfr(1M)
master is. If host is not specified, ypxfr will ask the NIS
service for the name of the master, and try to get the map
from there. host may be a name or an internet address in the
form a.b.c.d.
-sdomain
Specify a source domain from which to transfer a map that
should be the same across domains (such as the services.byname
map).
-Ctid prog ipaddr 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.
-S This option causes ypxfr to require that the ypserv server,
from which it will obtain the maps to be transferred, is using
``privileged'' IP ports. Since only super-user processes are
typically allowed to use privileged ports, this feature adds
an extra measure of security to the transfer. If the map
being transferred is a secure map, ypxfr sets the permissions
on the map to 0600.
FILES
/etc/yp/ypxfr.log log file
/usr/etc/yp/ypxfr_1perday
script to run one transfer per day, for use with
cron(1M)
/usr/etc/yp/ypxfr_2perday
script to run two transfers per day
/usr/etc/yp/ypxfr_1perhour
script for hourly transfers of volatile maps
/etc/yp/domain NIS domain
SEE ALSO
cron(1M), yppush(1M), ypserv(1M), crontab(4), ypfiles(4).
Licensed material--property of copyright holder(s) 2