usr.sbin/ypserv/ypinit.8

   1 .\" Copyright (c) 1997
   2 .\"     Bill Paul <wpaul@ctr.columbia.edu>.  All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\" 3. All advertising materials mentioning features or use of this software
  13 .\"    must display the following acknowledgement:
  14 .\"     This product includes software developed by Bill Paul.
  15 .\" 4. Neither the name of the author nor the names of any co-contributors
  16 .\"    may be used to endorse or promote products derived from this software
  17 .\"   without specific prior written permission.
  18 .\"
  19 .\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
  20 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  21 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  22 .\" ARE DISCLAIMED.  IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD
  23 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  24 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  25 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  26 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  27 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  28 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
  29 .\" THE POSSIBILITY OF SUCH DAMAGE.
  30 .\"
  31 .\"     $Id: ypinit.8,v 1.3 1998/03/23 08:31:04 charnier Exp $
  32 .\"
  33 .Dd November 10, 1997
  34 .Dt YPINIT 8
  35 .Os FreeBSD 3.0
  36 .Sh NAME
  37 .Nm ypinit
  38 .Nd build and install NIS databases
  39 .Sh SYNOPSIS
  40 .Nm ypinit
  41 .Fl m
  42 .Op Ar domainname
  43 .Nm ypinit
  44 .Fl s
  45 .Ar master_server
  46 .Op Ar domainname
  47 .Nm ypinit
  48 .Fl u
  49 .Op Ar domainname
  50 .Sh DESCRIPTION
  51 The
  52 .Nm
  53 script sets up databases on a Network Information Service (NIS)
  54 master or slave server.
  55 .Pp
  56 On a master server,
  57 .Nm
  58 creates the
  59 .Pa /var/yp/$DOMAINNAME
  60 directory, the
  61 .Pa /var/yp/ypservers
  62 file, and calls
  63 .Pa /var/yp/Makefile
  64 to create and populate an initial set of NIS maps. The maps are
  65 created from local source files using the
  66 .Xr yp_mkdb 8
  67 command. The script will prompt the user for a list of servers
  68 that support the specified domain; this list is used to populate
  69 the ypservers map.
  70 .Pp
  71 On a slave server,
  72 .Nm
  73 creates the
  74 .Pa /var/yp/$DOMAINNAME ,
  75 populates it with copies of the NIS maps from the master. The maps
  76 are obtained from the master using the
  77 .Xr ypxfr 8
  78 command. The
  79 .Nm
  80 script obtains the list of maps to transfer in one of two ways: if
  81 the system is configured as an NIS client and is bound to the master
  82 server,
  83 .Nm
  84 is able to use the
  85 .Xr ypwhich 1
  86 command to obtain a list of maps exported by the master server.
  87 If the system is not configured as a client of the NIS master,
  88 .Nm
  89 uses a hardcoded list of maps, some of which may or may not actually
  90 exist on the master. The system administrator can edit the script and
  91 modify the map list if necessary. Otherwise, indivudual maps can
  92 be transfered manually from the master using
  93 .Xr ypxfr 8 .
  94 .Sh OPTIONS
  95 .Nm Ypinit
  96 supports the following options:
  97 .Bl -tag -width indent
  98 .It Fl m Op Ar domainname
  99 Set up a master server. By default, the script sets up a server for
 100 the system default domain. The user can override this default by specifying
 101 .Ar domainname
 102 explicitly.
 103 Maps are constructed from scratch using local files as templates using
 104 the
 105 .Xr yp_mkdb 8
 106 command.
 107 .It Fl s Ar master_server Op Ar domainname
 108 Set up a slave server using
 109 .Ar master_name
 110 as the master. Maps are copied from
 111 .Ar master_server
 112 to the slave using
 113 .Xr ypxfr 8 .
 114 By default, the script sets up a server for
 115 the system default domain. The user can override this default by specifying
 116 .Ar domainname
 117 explicitly.
 118 .It Fl u Op Ar domainname
 119 Update the ypservers map on the master server. When a new slave
 120 server is added to a domain, its hostname must be added to the
 121 ypservers map so that
 122 .Xr yppush 8
 123 can propagate updates on the master to all of the slaves.
 124 .Sh FILES
 125 .Bl -tag -width /var/yp/master.passwd -compact
 126 .It Pa /etc/bootparams
 127 Bootparams source file
 128 .It Pa /etc/ethers
 129 Ethers data source file
 130 .It Pa /etc/group
 131 Group source file
 132 .It Pa /etc/hosts
 133 Hostname/IP address source file
 134 .It Pa /etc/netid
 135 RPC netid source file
 136 .It Pa /etc/networks
 137 Networks source file
 138 .It Pa /etc/protocols
 139 Protocols source file
 140 .It Pa /etc/publickey
 141 RPC public key/secret key source file
 142 .It Pa /etc/services
 143 Services data source file
 144 .It Pa /var/yp/master.passwd
 145 Passwd database source file
 146 .It Pa /var/yp/netgroup
 147 Netgroup data source file
 148 .It Pa /var/yp/ypservers
 149 Ypservers source file (generated by
 150 .Nm Ns )
 151 .El
 152 .Sh SEE ALSO
 153 .Xr yp 4 ,
 154 .Xr mknetid 8 ,
 155 .Xr revnetgroup 8 ,
 156 .Xr yp_mkdb 8 ,
 157 .Xr yppush 8 ,
 158 .Xr ypserv 8 ,
 159 .Xr ypxfr 8
 160 .Sh HISTORY
 161 This version of
 162 .Nm
 163 is based on the
 164 .Nm
 165 script in
 166 .Bx Open .
 167 It first appeared in
 168 .Bx Free
 169 in
 170 .Fx 3.0 .
 171 .Sh AUTHORS
 172 The original script was written by
 173 .An Mats O Jansson Aq moj@stacken.kth.se .
 174 It was modified for
 175 .Bx Free
 176 by
 177 .An Bill Paul Aq wpaul@ctr.columbia.edu .