xref: /titanic_52/usr/src/man/man1m/ypxfr.1m (revision 25c28e83beb90e7c80452a7c818c5e6f73a07dc8)
te
Copyright (c) 2000 Sun Microsystems, Inc. All Rights Reserved.
Copyright 1989 AT&T
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
YPXFR 1M "Mar 11, 1998"
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 terminal. However, if it is started without a controlling terminal, 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 periodically 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

"ypxfr_1perday, ypxfr_1perhour, and ypxfr_2perday"
SEE ALSO

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