usr/src/man/man1m/yppush.1m

   1 '\" te
   2 .\"  Copyright (c) 2000, Sun Microsystems, Inc.  All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH YPPUSH 1M "Aug 26, 1999"
   7 .SH NAME
   8 yppush \- force propagation of changed NIS map
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/lib/netsvc/yp/yppush\fR [\fB-v\fR] [\fB-h\fR \fIhost\fR] [\fB-d\fR \fIdomain\fR]
  13      [\fB-p\fR \fI#parallel-xfrs\fR] \fImapname\fR
  14 .fi
  15
  16 .SH DESCRIPTION
  17 .sp
  18 .LP
  19 \fByppush\fR copies a new version of a  Network Information Service (\fBNIS\fR)
  20 map from the master \fBNIS\fR server to the slave \fBNIS\fR servers. It is
  21 normally run only on the master \fBNIS\fR server by the \fBMakefile\fR in
  22 \fB/var/yp\fR after the master databases are changed. It first constructs a
  23 list of \fBNIS\fR server hosts by reading the \fBNIS\fR \fBypservers\fR map
  24 within the \fIdomain\fR. Keys within the \fBypservers\fR map are the
  25 \fBASCII\fR names of the machines on which the \fBNIS\fR servers run.
  26 .sp
  27 .LP
  28 A "transfer map" request is sent to the \fBNIS\fR server at each host, along
  29 with the information needed by the transfer agent (the program that actually
  30 moves the map) to call back the \fByppush\fR. When the attempt has completed
  31 (successfully or not), and the transfer agent has sent \fByppush\fR a status
  32 message, the results can be printed to \fBstdout\fR. Messages are also printed
  33 when a transfer is not possible, for instance, when the request message is
  34 undeliverable, or when the timeout period on responses has expired.
  35 .sp
  36 .LP
  37 Refer to \fBypfiles\fR(4) and \fBypserv\fR(1M) for an overview of the \fBNIS\fR
  38 service.
  39 .SH OPTIONS
  40 .sp
  41 .LP
  42 The following options are supported:
  43 .sp
  44 .ne 2
  45 .na
  46 \fB\fB-d\fR \fIdomain\fR\fR
  47 .ad
  48 .RS 21n
  49 Specifies a \fIdomain\fR.
  50 .RE
  51
  52 .sp
  53 .ne 2
  54 .na
  55 \fB\fB-h\fR \fIhost\fR\fR
  56 .ad
  57 .RS 21n
  58 Propagates only to the named \fIhost\fR.
  59 .RE
  60
  61 .sp
  62 .ne 2
  63 .na
  64 \fB\fB-p\fR \fI#parallel-xfrs\fR\fR
  65 .ad
  66 .RS 21n
  67 Allows the specified number of map transfers to occur in parallel.
  68 .RE
  69
  70 .sp
  71 .ne 2
  72 .na
  73 \fB\fB-v\fR\fR
  74 .ad
  75 .RS 21n
  76 Verbose.  This prints messages when each server is called, and for each
  77 response. If this flag is omitted, only error messages are printed.
  78 .RE
  79
  80 .SH FILES
  81 .sp
  82 .ne 2
  83 .na
  84 \fB\fB/var/yp\fR\fR
  85 .ad
  86 .sp .6
  87 .RS 4n
  88 Directory where \fBNIS\fR configuration files reside.
  89 .RE
  90
  91 .sp
  92 .ne 2
  93 .na
  94 \fB\fB/var/yp/\fIdomain\fR/ypservers.\|{\fIdir\fR,\fI pag\|\fR}\fR\fR
  95 .ad
  96 .sp .6
  97 .RS 4n
  98 Map containing list of  \fBNIS\fR servers to bind to when running in server
  99 mode.
 100 .RE
 101
 102 .SH SEE ALSO
 103 .sp
 104 .LP
 105 \fBypserv\fR(1M), \fBypxfr\fR(1M), \fBypfiles\fR(4), \fBattributes\fR(5)
 106 .SH NOTES
 107 .sp
 108 .LP
 109 The Network Information Service (\fBNIS\fR) was formerly known as Sun Yellow
 110 Pages (\fBYP\fR). The functionality of the two remains the same; only the name
 111 has changed. The name Yellow Pages is a registered trademark in the United
 112 Kingdom of British Telecommunications PLC, and must not be used without
 113 permission.
 114 .SH BUGS
 115 .sp
 116 .LP
 117 In the current implementation (version 2 \fBNIS\fR protocol), the transfer
 118 agent is \fBypxfr\fR(1M), which is started by the \fBypserv\fR program. If
 119 \fByppush\fR detects that it is speaking to a version 1 \fBNIS\fR protocol
 120 server, it uses the older protocol, sending a version 1 \fBYPPROC_GET\fR
 121 request and issues a message to that effect. Unfortunately, there is no way of
 122 knowing if or when the map transfer is performed for version 1 servers.
 123 \fByppush\fR prints a message saying that an "old-style" message has been sent.
 124 The system administrator should later check to see that the transfer has
 125 actually taken place.