YPPUSH(8)		       Reference Manual			     YPPUSH(8)



NAME
       yppush - force propagation of changed NIS databases

SYNOPSIS
       /usr/sbin/yppush	 [  -d domain ] [ -t timeout ] [ --parallel # | --port
       port ] [ -h host ] [ -v ] mapname ...

DESCRIPTION
       yppush copies updated NIS databases  (or	 maps)	from  the  master  NIS
       server  to  the	slave  servers within a NIS domain. It is normally run
       only on the NIS master by /var/yp/Makefile after the  master  databases
       are  changed.   /var/yp/Makefile does not invoke yppush by default, the
       NOPUSH=true line must be commented out.
       yppush first constructs a list of NIS slave servers by reading the  NIS
       map  ypservers  within  the  domain.   A destination host (or a list of
       hosts with multiple -h commands) can also be specified on  the  command
       line.   A  "transfer  map"  request  is	sent to the NIS serger at each
       slave, along with the information needed by the transfer agent ypxfr(8)
       to  callback to yppush, which may be printed the result to stderr. Mes-
       sages are also printed when a transfer is not  possible;	 for  instance
       when the request message is undeliverable.

       To  specify  a  port  number or to use any other yppush options you can
       edit /var/yp/Makefile directly.


OPTIONS
       -d domain
	      Specify a particular domain. The NIS domain of  the  local  host
	      system  is  used	by default. If the local host's domain name is
	      not set, the domain name must be specified with this flag.

       -t timeout
	      The timeout flag is used to specify a timeout value in  seconds.
	      This  timeout  controls how long yppush will wait for a response
	      from a slave server before sending a map transfer request to the
	      next  slave server in the list.  By default, yppush will wait 90
	      seconds. For big maps, this is not long enough.

       --parallel #, -p #
	      yppush normally performs transfers  serially,  meaning  that  it
	      will  send  a  map transfer request to one slave server and then
	      wait for it to respond before  sending  the  next	 map  transfer
	      request  to  the	next  slave  server. In environments with many
	      slaves, it is more efficient to initiate several	map  transfers
	      at once so that the transfers can take place in parallel.	 It is
	      not possible to run in parallel and assign a fixed port with the
	      --port flag

       --port port
	      specify  a  port for yppush to  listen  on.   By default, yppush
	      will ask portmap(8) to assign it a random port  number.	It  is
	      not possible to assign a port with this option and run in paral-
	      lel with the --parallel or -p flag

       -h host
	      The host flag can be used to transfer a map to a	user-specified
	      machine or group of machines instead of the list of servers con-
	      tained in the ypservers map. A list of hosts can be specified by
	      using multiple instances of the -h flag.

       -v     Verbose  mode:  causes  yppush to print debugging messages as it
	      runs. Note specifying this flag twice  makes  yppush  even  more
	      verbose.

SEE ALSO
       domainname(1), ypserv(8), ypxfr(8)

BUGS
       The  mechanism  for  transferring  NIS maps in NIS v1 is different that
       that in NIS version 2. This version of yppush has support for transfer-
       ring maps to NIS v2 systems only.

AUTHOR
       Thorsten Kukuk <kukuk@suse.de>



YP Server			  August 2002			     YPPUSH(8)