manual/ypserv/original/man8/yppush.8

   1 .TH YPPUSH 8 "August 2002" "YP Server" "Reference Manual"
   2 .SH NAME
   3 yppush \- force propagation of changed NIS databases
   4 .SH SYNOPSIS
   5 .B /usr/sbin/yppush
   6 [
   7 .B \-d
   8 .I domain
   9 ]
  10 [
  11 .B \-t
  12 .I timeout
  13 ]
  14 [
  15 .B --parallel
  16 .I #
  17 |
  18 .B --port
  19 .I port
  20 ]
  21 [
  22 .B -h
  23 .I host
  24 ]
  25 [
  26 .B \-v
  27 ]
  28 mapname ...
  29 .LP
  30 .SH DESCRIPTION
  31 .LP
  32 .B yppush
  33 copies updated NIS databases (or maps) from the master NIS server to
  34 the slave servers within a NIS domain. It is normally run only on
  35 the NIS master by
  36 .I /var/yp/Makefile
  37 after the master databases are changed.
  38 .I /var/yp/Makefile
  39 does not invoke
  40 .B yppush
  41 by default, the
  42 .B NOPUSH=true
  43 line must be commented out.
  44 .br
  45 .B yppush
  46 first constructs a list of NIS slave servers by reading the NIS map
  47 .B ypservers
  48 within the
  49 .I domain.
  50 A destination host (or a list of hosts with multiple \-h commands)
  51 can also be specified on the command line.
  52 A "transfer map" request is sent to the NIS serger at each slave, along
  53 with the information needed by the transfer agent ypxfr(8) to callback
  54 to yppush, which may be printed the result to stderr. Messages are
  55 also printed when a transfer is not possible; for instance when the request
  56 message is undeliverable.
  57 .SH OPTIONS
  58 .TP
  59 .BI "\-d " domain
  60 Specify a particular domain. The NIS domain of the local host system is
  61 used by default. If the local host's domain name is not set, the domain
  62 name must be specified with this flag.
  63 .TP
  64 .BI "\-t " timeout
  65 The timeout flag is used to specify a timeout value in seconds. This timeout
  66 controls how long
  67 .B yppush
  68 will wait for a response from a slave server before sending a
  69 map transfer request to the next slave server in the list.
  70 By default,
  71 .B yppush
  72 will wait 90 seconds. For big maps, this is not long enough.
  73 .TP
  74 .BI \-\^\-parallel " #" "\fR,\fP \-p " #
  75 .B yppush
  76 normally performs transfers serially, meaning that it will
  77 send a map transfer request to one slave server and then wait for
  78 it to respond before sending the next map transfer request to the
  79 next slave server. In environments with many slaves, it is more
  80 efficient to initiate several map transfers at once so that the
  81 transfers can take place in parallel.
  82 It is not possible to run in parallel and assign a fixed port with
  83 the
  84 .B \--port
  85 flag
  86 .TP
  87 .BI "\--port " port
  88 specify a port for
  89 .B yppush
  90 to  listen  on.   By default,
  91 .B yppush
  92 will ask
  93 .B portmap(8)
  94 to assign it a random port number.
  95 It is not possible to assign a port with this option and run in parallel with
  96 the
  97 .B \--parallel
  98 or
  99 .B \-p
 100 flag
 101 .TP
 102 .BI "\-h " host
 103 The host flag can be used to transfer a map to a user-specified machine or
 104 group of machines instead of the list of servers contained in
 105 the
 106 .B ypservers
 107 map. A list of hosts can be specified by using multiple
 108 instances of the
 109 .B "\-h"
 110 flag.
 111 .TP
 112 .B \-v
 113 Verbose mode: causes
 114 .B yppush
 115 to print debugging messages as it runs. Note specifying this flag twice
 116 makes
 117 .B yppush
 118 even more verbose.
 119 .LP
 120 .SH "SEE ALSO"
 121 .BR domainname (1),
 122 .BR ypserv (8),
 123 .BR ypxfr (8)
 124 .LP
 125 .SH BUGS
 126 The mechanism for transferring NIS maps in NIS v1 is different
 127 that that in NIS version 2. This version of
 128 .B yppush
 129 has support for transferring maps to NIS v2 systems only.
 130 .LP
 131 .SH AUTHOR
 132 Thorsten Kukuk <kukuk@suse.de>