yppush(1M)																yppush(1M)

NAME

       yppush - force propagation of Network Information Service database

SYNOPSIS

       domain] host] maxm] mint] mapname

   Remarks
       The  Network  Information  Service  (NIS) was formerly known as Yellow Pages (YP).  Although the name has changed, the functionality of the
       service remains the same.

DESCRIPTION

       copies a Network Information Service (NIS) map (database), mapname, from the map's master NIS server to each slave NIS server.  It is  usu-
       ally  executed  only on the master NIS server by shell script which is run either after changes are made to one or more of the master's NIS
       databases or when the NIS databases are first created.  See ypmake(1M) and ypinit(1M) for more information on these processes.

       constructs a list of NIS server host names by reading the NIS map within the domain.  Keys within  the  map  are  the  host  names  of  the
       machines  on  which  the  NIS  servers run.  then sends a "transfer map" request 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

       When the transfer attempt is complete, whether successful or not, and the transfer agent sends a status message, the results can be printed
       to  standard  output.   Messages are printed when a transfer is not possible, such as when the request message is undeliverable or when the
       timeout period on responses expires.

       Refer to ypfiles(4) and ypserv(1M) for an overview of Network Information Service.

   Options
       recognizes the following options:

	      Copy	  mapname to the NIS servers in domain rather than to the domain returned by (see domainname(1)).

	      Propagate the map(s) only to the specified host.

	      Attempt to run
			  maxm transfers in parallel to as many servers simultaneously.  Without the option, attempts to transfer a  map  to  each
			  server, one at a time.  When a network has many servers, such serial transfers can result in long delays to complete all
			  transfers.  A maxm value greater than 1 reduces total transfer time through better utilization of CPU time at  the  mas-
			  ter.	maxm can be any value from 1 through the number of NIS servers in the domain.

	      Set the minimum timeout value to
			  mint	seconds.   When  transferring  to  one slave at a time, waits up to 80 seconds for the transfer to complete, after
			  which it begins transferring to the next slave.  When multiple parallel transfers are attempted by use of the option, it
			  may  be  necessary  to  set the transfer timeout limit to a value larger than the default 80 seconds to prevent timeouts
			  caused by network delays related to parallel transfers.

	      Verbose mode:
			  messages are printed when each server is called and when each response is received.  If this	option	is  omitted,  only
			  error messages are printed.

WARNINGS

       In  the	current  implementation  (Version  2  NIS protocol), the transfer agent is ypxfr(1M) which is started by the ypserv(1M) program at
       yppush's request (see ypxfr(1M) and ypserv(1M)).

       Starting with ONCplus version B.11.31.02, the NIS Version 1 protocol is no longer available.

AUTHOR

       was developed by Sun Microsystems, Inc.

FILES

       SEE ALSO
	      domainname(1), ypserv(1M), ypxfr(1M), ypfiles(4).

																	yppush(1M)