Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

yppush(8yp) [ultrix man page]

yppush(8yp)															       yppush(8yp)

Name
       yppush - force propagation of a changed yellow pages (YP) map

Syntax
       yppush [ -d domain ] [ -v ] mapname

Description
       The  command copies a new version of a yellow pages (YP) map from the master YP server to the slave YP servers.	It is normally run only on
       the master YP server by the utility accessing the after the master YP databases have been changed.  When invoked, first constructs  a  list
       of YP server hosts by reading the YP map ypservers within the domain.  Keys within the map ypservers are the ASCII names of the machines on
       which the YP servers run.

       A transfer map request is sent to the YP server at each host, along with the information needed by the transfer agent  (the  program  which
       actually  moves the map) to call back the command.  When the attempt has completed (successfully or not), and the transfer agent has sent a
       status message, the results can be printed to stdout.  Messages are also printed when a transfer is not possible,  for  instance  when  the
       request message is undeliverable, or when the timeout period on responses has expired.

       Refer to and for an overview of the yellow pages.

Options
       -d     Specify a domain.

       -v     Verbose.	 This causes messages to be printed when each server is called, and for each response.	Without this flag, only error mes-
	      sages are printed.

Restrictions
       In the current implementation (version 2 YP protocol), the transfer agent is which is started by the program.  If detects that it is speak-
       ing  to	a  version  1  YP protocol server, it uses the older protocol, sending a version 1 YPPROC_GET request and issues a message to that
       effect.	Unfortunately, there is no way of knowing if or when the map transfer was performed for version 1 servers.  The command  prints  a
       message	saying that an old-style message has been sent.  The system administrator should later check to see that the transfer has actually
       taken place.

Files
       /etc/yp/domainname/ypservers.{dir, pag}

See Also
       ypfiles(5yp), ypserv(8yp), ypxfr(8yp)

																       yppush(8yp)

Check Out this Related Man Page

yppush(1M)						  System Administration Commands						yppush(1M)

NAME
yppush - force propagation of changed NIS map SYNOPSIS
/usr/lib/netsvc/yp/yppush [-v] [-h host] [-d domain] [-p #parallel-xfrs] mapname DESCRIPTION
yppush copies a new version of a Network Information Service (NIS) map from the master NIS server to the slave NIS servers. It is normally run only on the master NIS server by the Makefile in /var/yp after the master databases are changed. It first constructs a list of NIS server hosts by reading the NIS ypservers map within the domain. Keys within the ypservers map are the ASCII names of the machines on which the NIS servers run. A "transfer map" request is sent to the NIS server at each host, along with the information needed by the transfer agent (the program that actually moves the map) to call back the yppush. When the attempt has completed (successfully or not), and the transfer agent has sent yppush a status message, the results can be printed to stdout. Messages are also printed when a transfer is not possible, for instance, when the request message is undeliverable, or when the timeout period on responses has expired. Refer to ypfiles(4) and ypserv(1M) for an overview of the NIS service. OPTIONS
The following options are supported: -d domain Specifies a domain. -h host Propagates only to the named host. -p #parallel-xfrs Allows the specified number of map transfers to occur in parallel. -v Verbose. This prints messages when each server is called, and for each response. If this flag is omitted, only error messages are printed. FILES
/var/yp Directory where NIS configuration files reside. /var/yp/domain/ypservers.{dir, pag} Map containing list of NIS servers to bind to when running in server mode. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ |ATTRIBUTE TYPE |ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWypu | +-----------------------------+-----------------------------+ SEE ALSO
ypserv(1M), ypxfr(1M), ypfiles(4), attributes(5) NOTES
The Network Information Service (NIS) was formerly known as Sun Yellow Pages (YP). The functionality of the two remains the same; only the name has changed. The name Yellow Pages is a registered trademark in the United Kingdom of British Telecommunications PLC, and must not be used without permission. BUGS
In the current implementation (version 2 NIS protocol), the transfer agent is ypxfr(1M), which is started by the ypserv program. If yppush detects that it is speaking to a version 1 NIS protocol server, it uses the older protocol, sending a version 1 YPPROC_GET request and issues a message to that effect. Unfortunately, there is no way of knowing if or when the map transfer is performed for version 1 servers. yppush prints a message saying that an "old-style" message has been sent. The system administrator should later check to see that the transfer has actually taken place. SunOS 5.10 26 Aug 1999 yppush(1M)
Man Page