1ypbind(1M)              System Administration Commands              ypbind(1M)
2
3
4

NAME

6       ypbind - NIS binder process
7

SYNOPSIS

9       /usr/lib/netsvc/yp/ypbind [-broadcast | -ypset | -ypsetme]
10
11

DESCRIPTION

13       NIS  provides  a  simple network lookup service consisting of databases
14       and processes. The databases are stored at the machine that runs an NIS
15       server  process.  The  programmatic  interface  to  NIS is described in
16       ypclnt(3NSL).  Administrative  tools  are  described   in   ypinit(1M),
17       ypwhich(1),  and  ypset(1M).  Tools to see the contents of NIS maps are
18       described in ypcat(1), and ypmatch(1).
19
20
21       ypbind is a daemon process that is activated  at  system  startup  time
22       from  the  svc:/network/nis/client:default  service.  By default, it is
23       invoked as ypbind -broadcast. ypbind runs on all client  machines  that
24       are  set up to use NIS. See sysidtool(1M). The function of ypbind is to
25       remember information that lets all NIS client processes on a node  com‐
26       municate with some NIS server process. ypbind must run on every machine
27       which has NIS client processes. The NIS server may or may not  be  run‐
28       ning on the same node, but must be running somewhere on the network. If
29       the NIS server is a NIS+ server in NIS (YP) compatibility mode, see the
30       NOTES section of the ypfiles(4)man page for more information.
31
32
33       The  information ypbind remembers is called a binding — the association
34       of a domain name with a NIS server. The process of binding is driven by
35       client  requests.   As  a  request  for  an unbound domain comes in, if
36       started with the -broadcast option, the ypbind process   broadcasts  on
37       the  net  trying to find an NIS server, either a ypserv process serving
38       the domain or an rpc.nisd process in  "YP-compatibility  mode"  serving
39       NIS+ directory with name the same as (case sensitive) the domain in the
40       client request. Since  the  binding  is  established  by  broadcasting,
41       there  must  be  at least one NIS server on the net. If started without
42       the -broadcast option, ypbind process steps through  the  list  of  NIS
43       servers  that  was created by ypinit -c for the requested domain. There
44       must be an NIS server process on at least one of the hosts in  the  NIS
45       servers file. It is recommended that you list each of these NIS servers
46       by name and numeric IP address in /etc/hosts. Though  the  practice  is
47       not  recommended,  NIS  allows  you  to list servers by numeric address
48       only, bypassing /etc/hosts. In such a configuration, ypwhich(1) returns
49       a numeric address instead of a name.
50
51
52       Once  a  domain is bound by ypbind, that same binding is given to every
53       client process on the node. The ypbind process on the local node  or  a
54       remote  node  may  be queried for the binding of a particular domain by
55       using the ypwhich(1) command.
56
57
58       If ypbind is unable to speak to the NIS server process it is bound  to,
59       it  marks  the  domain  as  unbound,  tells the client process that the
60       domain is unbound, and tries to bind the domain  once  again.  Requests
61       received  for an unbound domain will wait until the requested domain is
62       bound. In general, a bound domain is marked as unbound  when  the  node
63       running  the  NIS  server  crashes  or gets overloaded. In such a case,
64       ypbind will try to  bind  to  another  NIS  server  using  the  process
65       described  above.ypbind  also accepts requests to set its binding for a
66       particular domain.  The request is usually generated by  the  ypset(1M)
67       command. In order for ypset to work, ypbind must have been invoked with
68       flags -ypset or  -ypsetme.
69

OPTIONS

71       -broadcast
72
73           Send a broadcast datagram using UDP/IP  that requests the  informa‐
74           tion needed to bind to a specific NIS server. This option is analo‐
75           gous to ypbind with no options in earlier Sun releases and is  rec‐
76           ommended for ease of use.
77
78
79       -ypset
80
81           Allow  users from any remote machine to change the binding by means
82           of the ypset command. By default, no one can  change  the  binding.
83           This option is insecure.
84
85
86       -ypsetme
87
88           Only  allow  root  on  the local machine to change the binding to a
89           desired server by means of the ypset command.   ypbind  can  verify
90           the caller is indeed a root user by accepting such requests only on
91           the loopback transport. By default, no external process can  change
92           the binding.
93
94

FILES

96       /var/yp/binding/ypdomain/ypservers
97
98           Lists the servers to which the NIS client is allowed to bind.
99
100
101       /etc/inet/hosts
102
103           File in which it is recommended that NIS servers be listed.
104
105

ATTRIBUTES

107       See attributes(5) for descriptions of the following attributes:
108
109
110
111
112       ┌─────────────────────────────┬─────────────────────────────┐
113       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
114       ├─────────────────────────────┼─────────────────────────────┤
115       │Availability                 │SUNWnisu                     │
116       └─────────────────────────────┴─────────────────────────────┘
117

SEE ALSO

119       svcs(1),  ypcat(1), ypmatch(1), ypwhich(1), ifconfig(1M), rpc.nisd(1M),
120       svcadm(1M), ypinit(1M), ypset(1M), ypclnt(3NSL), hosts(4),  ypfiles(4),
121       attributes(5), smf(5)
122

NOTES

124       ypbind  supports  multiple  domains.  The   ypbind process can maintain
125       bindings to several domains and their servers, the  default  domain  is
126       the one specified by the  domainname(1M) command at startup time.
127
128
129       The  -broadcast  option works only on the UDP transport. It is insecure
130       since it trusts "any" machine on the net that responds to the broadcast
131       request and poses itself as an NIS server.
132
133
134       The  ypbind  service  is  managed  by  the service management facility,
135       smf(5), under the service identifier:
136
137         svc:/network/nis/client:default
138
139
140
141
142       Administrative actions on this service, such as enabling, disabling, or
143       requesting  restart,  can  be performed using svcadm(1M). The service's
144       status can be queried using the svcs(1) command.
145
146
147
148SunOS 5.11                        20 Dec 2007                       ypbind(1M)
Impressum