share/man/man8/ypbind.8

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