boot - Switch boot2 loader path around
[dragonfly.git] / usr.sbin / ypserv / ypinit.8
blob19a6cf863b96c7a54864f80f9a92b97f006c122a
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 .\" $FreeBSD: src/usr.sbin/ypserv/ypinit.8,v 1.17 2006/06/08 14:49:38 maxim Exp $
32 .\" $DragonFly: src/usr.sbin/ypserv/ypinit.8,v 1.3 2007/05/13 22:25:42 swildner Exp $
33 .\"
34 .Dd November 10, 1997
35 .Dt YPINIT 8
36 .Os
37 .Sh NAME
38 .Nm ypinit
39 .Nd build and install NIS databases
40 .Sh SYNOPSIS
41 .Nm
42 .Fl m
43 .Op Ar domainname
44 .Nm
45 .Fl s
46 .Ar master_server
47 .Op Ar domainname
48 .Nm
49 .Fl u
50 .Op Ar domainname
51 .Sh DESCRIPTION
52 The
53 .Nm
54 utility is a script which sets up databases on a Network Information Service
55 (NIS)
56 master or slave server.
57 .Pp
58 On a master server,
59 .Nm
60 creates the
61 .Pa /var/yp/$DOMAINNAME
62 directory, the
63 .Pa /var/yp/ypservers
64 file, and calls
65 .Pa /var/yp/Makefile
66 to create and populate an initial set of NIS maps.
67 The maps are
68 created from local source files using the
69 .Xr yp_mkdb 8
70 utility.
71 The utility will prompt the user for a list of servers
72 that support the specified domain; this list is used to populate
73 the ypservers map.
74 .Pp
75 On a slave server,
76 .Nm
77 creates the
78 .Pa /var/yp/$DOMAINNAME ,
79 populates it with copies of the NIS maps from the master.
80 The maps
81 are obtained from the master using the
82 .Xr ypxfr 8
83 utility.
84 The
85 .Nm
86 utility obtains the list of maps to transfer in one of two ways: if
87 the system is configured as an NIS client and is bound to the master
88 server,
89 .Nm
90 is able to use the
91 .Xr ypwhich 1
92 utility to obtain a list of maps exported by the master server.
93 If the system is not configured as a client of the NIS master,
94 .Nm
95 uses a hardcoded list of maps, some of which may or may not actually
96 exist on the master.
97 The system administrator can edit the
98 .Nm
99 script and
100 modify the map list if necessary.
101 Otherwise, individual maps can
102 be transferred manually from the master using
103 .Xr ypxfr 8 .
104 .Sh OPTIONS
107 utility supports the following options:
108 .Bl -tag -width indent
109 .It Fl m Op Ar domainname
110 Set up a master server.
111 By default,
113 sets up a server for
114 the system default domain.
115 The user can override this default by specifying
116 .Ar domainname
117 explicitly.
118 Maps are constructed from scratch using local files as templates using
120 .Xr yp_mkdb 8
121 utility.
122 .It Fl s Ar master_server Op Ar domainname
123 Set up a slave server using
124 .Ar master_name
125 as the master.
126 Maps are copied from
127 .Ar master_server
128 to the slave using
129 .Xr ypxfr 8 .
130 By default,
132 sets up a server for
133 the system default domain.
134 The user can override this default by specifying
135 .Ar domainname
136 explicitly.
137 .It Fl u Op Ar domainname
138 Update the ypservers map on the master server.
139 When a new slave
140 server is added to a domain, its hostname must be added to the
141 ypservers map so that
142 .Xr yppush 8
143 can propagate updates on the master to all of the slaves.
145 .Sh FILES
146 .Bl -tag -width /var/yp/master.passwd -compact
147 .It Pa /etc/bootparams
148 Bootparams source file
149 .It Pa /etc/ethers
150 Ethers data source file
151 .It Pa /etc/group
152 Group source file
153 .It Pa /etc/hosts
154 Hostname/IP address source file
155 .It Pa /etc/netid
156 RPC netid source file
157 .It Pa /etc/networks
158 Networks source file
159 .It Pa /etc/protocols
160 Protocols source file
161 .It Pa /etc/publickey
162 RPC public key/secret key source file
163 .It Pa /etc/services
164 Services data source file
165 .It Pa /etc/shells
166 Shells source file
167 .It Pa /var/yp/master.passwd
168 Passwd database source file
169 .It Pa /var/yp/netgroup
170 Netgroup data source file
171 .It Pa /var/yp/ypservers
172 Ypservers source file (generated by
173 .Nm )
175 .Sh SEE ALSO
176 .Xr mknetid 8 ,
177 .Xr revnetgroup 8 ,
178 .Xr yp 8 ,
179 .Xr yp_mkdb 8 ,
180 .Xr yppush 8 ,
181 .Xr ypserv 8 ,
182 .Xr ypxfr 8
183 .Sh HISTORY
184 This version of
186 is based on the
188 script in
189 .Ox .
190 It first appeared in
191 .Fx 3.0 .
192 .Sh AUTHORS
193 .An -nosplit
194 The original script was written by
195 .An Mats O Jansson Aq moj@stacken.kth.se .
196 It was modified for
199 .An Bill Paul Aq wpaul@ctr.columbia.edu .