System Administration Commands ypxfr(1M)
NAME
ypxfr, ypxfr1perday, ypxfr1perhour, ypxfr2perday -
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: ypxfr1perday, ypxfr2perday, and
ypxfr1perhour.
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/ypxfr1perday
Script to run one transfer per day, for use with
cron(1M)
/usr/lib/netsvc/yp/ypxfr2perday
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/ypxfr1perhour
Script for hourly transfers of volatile maps
/var/yp/ypdomain
NIS domain
/usr/spool/cron/crontabs/root
Privileged user's crontab file
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ypxfr Only
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWnisu
ypxfr1perday, ypxfr1perhour, and ypxfr2perday
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWypu
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
|
