'\"macro stdmacro
.if n .pH g1a.ypinit @(#)ypinit	40.3 of 1/29/90
.\" Copyright 1989 AT&T
.\" @(#)ypinit.8 1.9 89/09/28 SMI;
.\" Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved.
.nr X
.if \nX=0 .ds x} ypinit 1M "" "\&"
.if \nX=1 .ds x} ypinit 1M ""
.if \nX=2 .ds x} ypinit 1M "" "\&"
.if \nX=3 .ds x} ypinit "" "" "\&"
.TH \*(x}
.SH NAME
\f4ypinit\fP \- build and install YP database
.SH SYNOPSIS
.P
\f4/usr/sbin/ypinit\fR
\f4\-c\fR
.br
\f4/usr/sbin/ypinit\fR
\f4\-m\fR
.br
\f4/usr/sbin/ypinit\fR
\f4\-s\fR
\f2master-name\fR
.SH DESCRIPTION
.P
\f4ypinit\fR
sets up a
\s-1YP\s0
name service database on a
\s-1YP\s0
server.
It can be used to set up a master or a slave server,
or a client system.
You must be the privileged user to run it.
It asks a few, self-explanatory  questions,
and reports success or failure to the terminal.
.P
It sets up a master server
using the simple model in which that server
is master to all maps in the data base.
This is the way to bootstrap the
\s-1YP\s0
system;
later if you want you can change the association of maps to masters.
.P
All databases are built from scratch,
either from information available to the program at runtime,
or from the
\s-1ASCII\s0
data base files in
\f4/etc\fR.
These files should be in their \(lqtraditional\(rq form,
rather than the abbreviated form used on client machines.
.P
A
\s-1YP\s0
database on a slave server is set up by copying
an existing database from a running server. 
The
\f2master-name\fR
argument should be the hostname of a
\s-1YP\s0
server (either the master server for all the maps,
or a server on which the data base is up-to-date and stable).
.P
To set up a client,
.B ypinit
prompts for a list of
\s-1YP\s0
servers to bind the client to,
this list should be ordered from closest to
farthest server.
.P
Read
\f4ypfiles\fR(4)
and
\f4ypserv\fR(1M)
for an overview of the 
\s-1YP\s0
name service.
.P
The following options are available:
.TP
\f4\-c\fR
Set up a client system.
.TP
\f4\-m\fR
Indicate that the local host is to be the
\s-1YP\s0
master.
.TP
\f4\-s \f2master-name\fR
Set up a slave database.
.SH "SEE ALSO"
\f4makedbm\fR(1M),
\f4ypmake\fR(1M),
\f4yppush\fR(1M),
\f4ypserv\fR(1M),
\f4ypxfr\fR(1M),
\f4ypfiles\fR(4)
.SH FILES
.PD 0
.TP 20
\f4/var/yp/binding/\f2domainname\f4/ypservers\fR
.PD
