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

   1 '\" te
   2 .\"  Copyright 1989 AT&T
   3 .\" Copyright (C) 2004, 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 .TH YPBIND 1M "Dec 20, 2007"
   8 .SH NAME
   9 ypbind \- NIS binder process
  10 .SH SYNOPSIS
  11 .LP
  12 .nf
  13 \fB/usr/lib/netsvc/yp/ypbind\fR [\fB-broadcast\fR | \fB-ypset\fR | \fB-ypsetme\fR]
  14 .fi
  15
  16 .SH DESCRIPTION
  17 .sp
  18 .LP
  19 NIS provides a simple network lookup service consisting of databases and
  20 processes. The databases are stored at the machine that runs an NIS server
  21 process. The programmatic interface to NIS is described in \fBypclnt\fR(3NSL).
  22 Administrative tools are described in \fBypinit\fR(1M), \fBypwhich\fR(1), and
  23 \fBypset\fR(1M). Tools to see the contents of NIS maps are described in
  24 \fBypcat\fR(1), and \fBypmatch\fR(1).
  25 .sp
  26 .LP
  27 \fBypbind\fR is a daemon process that is activated at system startup time from
  28 the \fBsvc:/network/nis/client:default\fR service. By default, it is invoked as
  29 \fBypbind\fR \fB-broadcast\fR. \fBypbind\fR runs on all client machines that
  30 are set up to use \fBNIS\fR. See \fBsysidtool\fR(1M). The function of
  31 \fBypbind\fR is to remember information that lets all \fBNIS\fR client
  32 processes on a node communicate with some \fBNIS\fR server process.
  33 \fBypbind\fR must run on every machine which has \fBNIS\fR client processes.
  34 The \fBNIS\fR server may or may not be running on the same node, but must be
  35 running somewhere on the network. If the \fBNIS\fR server is a \fBNIS+\fR
  36 server in \fBNIS\fR (YP) compatibility mode, see the \fBNOTES\fR section of the
  37 \fBypfiles\fR(4)man page for more information.
  38 .sp
  39 .LP
  40 The information \fBypbind\fR remembers is called a \fIbinding\fR \(em the
  41 association of a domain name with a \fBNIS\fR server. The process of binding is
  42 driven by client requests.  As a request for  an unbound domain comes in, if
  43 started with the \fB-broadcast\fR option, the \fBypbind\fR process  broadcasts
  44 on the net trying to find an \fBNIS\fR server, either a \fBypserv\fR process
  45 serving the domain or an \fBrpc.nisd\fR process in "YP-compatibility mode"
  46 serving \fBNIS+\fR directory with name the same as (case sensitive) the domain
  47 in the client request. Since the binding is established by broadcasting,  there
  48 must be at least one \fBNIS\fR server on the net. If started without the
  49 \fB-broadcast\fR option, \fBypbind\fR process steps through the list of
  50 \fBNIS\fR servers that was created by \fBypinit\fR \fB-c\fR for the requested
  51 domain. There must be an \fBNIS\fR server process on at least one of the hosts
  52 in the \fBNIS\fR servers file. It is recommended that you list each of these
  53 NIS servers by name and numeric IP address in \fB/etc/hosts\fR. Though the
  54 practice is not recommended, NIS allows you to list servers by numeric address
  55 only, bypassing \fB/etc/hosts\fR. In such a configuration, \fBypwhich\fR(1)
  56 returns a numeric address instead of a name.
  57 .sp
  58 .LP
  59 Once a domain is bound by \fBypbind\fR, that same binding is given to every
  60 client process on the node. The \fBypbind\fR process on the local node or a
  61 remote node may be queried for the binding of a particular domain by using the
  62 \fBypwhich\fR(1) command.
  63 .sp
  64 .LP
  65 If \fBypbind\fR is unable to speak to the \fBNIS\fR server process it is bound
  66 to, it marks the domain as unbound, tells the client process that the domain is
  67 unbound, and tries to bind the domain once again. Requests received for an
  68 unbound domain will wait until the requested domain is bound. In general, a
  69 bound domain is marked as unbound when the node running the \fBNIS\fR server
  70 crashes or gets overloaded. In such a case, \fBypbind\fR will try to bind to
  71 another \fBNIS\fR server using the process described above.\fBypbind\fR also
  72 accepts requests to set its binding for a particular domain.  The request is
  73 usually generated by the \fBypset\fR(1M) command. In order for \fBypset\fR to
  74 work, \fBypbind\fR must have been invoked with flags \fB-ypset\fR or
  75 \fB-ypsetme\fR.
  76 .SH OPTIONS
  77 .sp
  78 .ne 2
  79 .na
  80 \fB\fB-broadcast\fR\fR
  81 .ad
  82 .sp .6
  83 .RS 4n
  84 Send a broadcast datagram using \fBUDP/IP\fR  that requests the information
  85 needed to bind to a specific \fBNIS\fR server. This option is analogous to
  86 \fBypbind\fR with no options in earlier Sun releases and is recommended for
  87 ease of use.
  88 .RE
  89
  90 .sp
  91 .ne 2
  92 .na
  93 \fB\fB-ypset\fR\fR
  94 .ad
  95 .sp .6
  96 .RS 4n
  97 Allow users from any remote machine to change the binding by means of the
  98 \fBypset\fR command. By default, no one can change the binding. This option is
  99 insecure.
 100 .RE
 101
 102 .sp
 103 .ne 2
 104 .na
 105 \fB\fB-ypsetme\fR\fR
 106 .ad
 107 .sp .6
 108 .RS 4n
 109 Only allow \fBroot\fR on the local machine to change the binding to a desired
 110 server by means of the \fBypset\fR command.  \fBypbind\fR can verify the caller
 111 is indeed a \fBroot\fR user by accepting such requests only on the loopback
 112 transport. By default, no external process can change the binding.
 113 .RE
 114
 115 .SH FILES
 116 .sp
 117 .ne 2
 118 .na
 119 \fB\fB/var/yp/binding/\fIypdomain\fR/ypservers\fR\fR
 120 .ad
 121 .sp .6
 122 .RS 4n
 123 Lists the servers to which the NIS client is allowed to bind.
 124 .RE
 125
 126 .sp
 127 .ne 2
 128 .na
 129 \fB\fB/etc/inet/hosts\fR\fR
 130 .ad
 131 .sp .6
 132 .RS 4n
 133 File in which it is recommended that NIS servers be listed.
 134 .RE
 135
 136 .SH SEE ALSO
 137 .sp
 138 .LP
 139 \fBsvcs\fR(1), \fBypcat\fR(1), \fBypmatch\fR(1), \fBypwhich\fR(1),
 140 \fBifconfig\fR(1M), \fBrpc.nisd\fR(1M), \fBsvcadm\fR(1M), \fBypinit\fR(1M),
 141 \fBypset\fR(1M), \fBypclnt\fR(3NSL), \fBhosts\fR(4), \fBypfiles\fR(4),
 142 \fBattributes\fR(5), \fBsmf\fR(5)
 143 .SH NOTES
 144 .sp
 145 .LP
 146 \fBypbind\fR supports multiple domains. The  \fBypbind\fR process can maintain
 147 bindings to several domains and their servers, the default domain is the one
 148 specified by the  \fBdomainname\fR(1M) command at startup time.
 149 .sp
 150 .LP
 151 The \fB-broadcast\fR option works only on the \fBUDP\fR transport. It is
 152 insecure since it trusts "any" machine on the net that responds to the
 153 broadcast request and poses itself as an \fBNIS\fR server.
 154 .sp
 155 .LP
 156 The \fBypbind\fR service is managed by the service management facility,
 157 \fBsmf\fR(5), under the service identifier:
 158 .sp
 159 .in +2
 160 .nf
 161 svc:/network/nis/client:default
 162 .fi
 163 .in -2
 164 .sp
 165
 166 .sp
 167 .LP
 168 Administrative actions on this service, such as enabling, disabling, or
 169 requesting restart, can be performed using \fBsvcadm\fR(1M). The service's
 170 status can be queried using the \fBsvcs\fR(1) command.