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

   1 '\" te
   2 .\"  Copyright 1989 AT&T
   3 .\" Copyright (C) 2008, Sun Microsystems, Inc. All Rights Reserved
   4 .\" 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.
   5 .\" 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.
   6 .\" 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]
   7 .\" Copyright 2014 Nexenta Systems, Inc.  All rights reserved.
   8 .TH YPINIT 1M "Dec 15, 2014"
   9 .SH NAME
  10 ypinit \- set up NIS client
  11 .SH SYNOPSIS
  12 .LP
  13 .nf
  14 \fB/usr/sbin/ypinit\fR \fB-m\fR
  15 \fB/usr/sbin/ypinit\fR \fB-s\fR [\fImaster_server\fR]
  16 \fB/usr/sbin/ypinit\fR \fB-c\fR [\fIserver_name...\fR]
  17 .fi
  18
  19 .SH DESCRIPTION
  20 .LP
  21 \fBypinit\fR can be used to set up an \fBNIS\fR client system. You must be the
  22 superuser to run this command. This script need not be used at all if
  23 \fBypbind\fR(1M) is started with the \fB-broadcast\fR option (it is invoked
  24 with this option from the \fBsvc:/network/nis/client:default service\fR).
  25 .sp
  26 .LP
  27 Normally, \fBypinit\fR is run only once after installing the system. It may be
  28 run whenever a new \fBNIS\fR server is added to the network or an existing one
  29 is decommissioned.
  30 .sp
  31 .LP
  32 \fBypinit\fR prompts for a list of \fBNIS\fR servers to bind the client to;
  33 this list should be ordered from the closest to the furthest server. It is
  34 recommended that you list each of these NIS servers by name and numeric IP
  35 address in \fB/etc/hosts\fR. Though the practice is not recommended, NIS allows
  36 you to list servers by numeric address only, bypassing \fB/etc/hosts\fR. In
  37 such a configuration, \fBypwhich\fR(1) returns a numeric address instead of a
  38 name.
  39 .sp
  40 .LP
  41 \fBypinit\fR stores the list of servers to which a client can bind in the file
  42 \fB/var/yp/binding/\fIdomain\fR/ypservers\fR. This file is used by \fBypbind\fR
  43 when run without the \fB-broadcast\fR option.
  44 .SH OPTIONS
  45 .ne 2
  46 .na
  47 \fB\fB-c\fR\fR [\fIserver_name...\fR]
  48 .ad
  49 .sp .6
  50 .RS 4n
  51 Set up a \fBypclient\fR system. If \fIserver_name\fR is specified, it will
  52 replace currently configured list of servers. \fIserver_name\fR could be
  53 represented by IPv4/v6 address as well as by hostname.
  54 .RE
  55
  56 .sp
  57 .ne 2
  58 .na
  59 \fB\fB-m\fR\fR
  60 .ad
  61 .sp .6
  62 .RS 4n
  63 Build a master \fBypserver\fR data base.
  64 .RE
  65
  66 .sp
  67 .ne 2
  68 .na
  69 \fB\fB-s\fR \fImaster_server\fR\fR
  70 .ad
  71 .sp .6
  72 .RS 4n
  73 Slave data base. \fImaster_server\fR must be the same master configured in the
  74 \fBYP\fR maps and returned by the \fBypwhich\fR \fB-m\fR command.
  75 .RE
  76
  77 .SH FILES
  78 .ne 2
  79 .na
  80 \fB\fB/etc/hosts\fR\fR
  81 .ad
  82 .sp .6
  83 .RS 4n
  84 File in which it is recommended that NIS servers be listed.
  85 .RE
  86
  87 .sp
  88 .ne 2
  89 .na
  90 \fB\fB/var/yp/binding/\fIdomain\fR/ypservers\fR\fR
  91 .ad
  92 .sp .6
  93 .RS 4n
  94 Lists the servers to which the NIS client is allowed to bind.
  95 .RE
  96
  97 .SH SEE ALSO
  98 .LP
  99 \fBsvcs\fR(1), \fBypwhich\fR(1), \fBsvcadm\fR(1M), \fBypbind\fR(1M),
 100 \fBsysinfo\fR(2), \fBhosts\fR(4), \fBattributes\fR(5), \fBsmf\fR(5)
 101 .SH NOTES
 102 .LP
 103 The \fBNIS client\fR service is managed by the service management facility,
 104 \fBsmf\fR(5), under the service identifier:
 105 .sp
 106 .in +2
 107 .nf
 108 svc:/network/nis/client:default
 109 .fi
 110 .in -2
 111 .sp
 112
 113 .sp
 114 .LP
 115 Administrative actions on this service, such as enabling, disabling, or
 116 requesting restart, can be performed using \fBsvcadm\fR(1M). The service's
 117 status can be queried using the \fBsvcs\fR(1) command.
 118 .SH BUGS
 119 .LP
 120 \fBypinit\fR sets up the list of \fBNIS\fR servers only for the current domain
 121 on the system when it is run, that is, the domain returned by the
 122 \fBSI_SRPC_DOMAIN\fR command to \fBsysinfo\fR(2). Care should be taken to
 123 ensure that this is the same as the desired domain for \fBNIS\fR client
 124 processes.