ypxfr(8yp)ypxfr(8yp)Nameypxfr - transfer a yellow pages (YP) map from a YP server to the local
host.
Syntaxypxfr [ -f ] [ -h host ] [ -d domain ] [ -c ] [ -C tid prog ipadd port
] mapname
Description
The command moves a YP map, specified by the mapname argument, to the
local host by making use of normal YP services. It creates a temporary
map in the directory (which must already exist), fills it by enumerat‐
ing the map's entries, obtains the map parameters (master and order
number) and loads them into the map. Once has accomplished these
tasks, it deletes any old versions of the map and moves the temporary
map to the real mapname.
If is run interactively, it writes its output to the terminal. How‐
ever, if it is invoked without a controlling terminal, and if the log
file exists, it will append all its output to that file. Since is most
often run from or by the log file can be used to retain a record of
what was attempted, and the results.
For consistency between servers, should be run periodically for every
map in the YP database. Different maps change at different rates: the
map may not change for months at a time, for instance, and may there‐
fore be checked only once a day. It is possible that or changes several
times per day. In such a case, it is appropriate to check hourly for
updates. A entry should be used to perform periodic updates automati‐
cally on YP server machines only. Rather than having a separate entry
for each map, commands can be grouped to update several maps in a shell
script. Examples (mnemonically named) are in and They can serve as
reasonable first cuts.
See and for an overview of the yellow pages.
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
process. This flag should be used if is not running locally
at the time when is running. Otherwise, will report that it
can not talk to the local and the transfer will fail.
-h host Get the map from host, regardless of which map is the master.
If host is not specified, will ask the YP service for the
name of the master, and try to get the map from there. The
host option can be a name or an internet address in the form
a.b.c.d .
-d domain Specify a domain other than the default domain.
-C tid prog ipadd port
This option is only for use by When invokes it specifies that
should call back a 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.
FilesSee Alsoypfiles(5yp), cron(8), yppush(8yp), ypserv(8yp), ypsetup(8yp)ypxfr(8yp)