ypxfr(8yp)																ypxfr(8yp)

Name
       ypxfr - transfer a yellow pages (YP) map from a YP server to the local host.

Syntax
       ypxfr [ -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 tempo-
       rary map in the directory (which must already exist), fills it by enumerating 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 tempo-
       rary map to the real mapname.

       If is run interactively, it writes its output to the terminal.  However, 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 therefore 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
       automatically 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, reg-
		 istered as program number prog, listening on port port, and waiting for a response to transaction tid.

Files
See Also
       ypfiles(5yp), cron(8), yppush(8yp), ypserv(8yp), ypsetup(8yp)

																	ypxfr(8yp)