~ubuntu-branches/ubuntu/oneiric/nis/oneiric-proposed

« back to all changes in this revision

Viewing changes to ypbind-mt-1.19.1/man/ypbind.8.in

  • Committer: Bazaar Package Importer
  • Author(s): Scott James Remnant
  • Date: 2005-11-16 23:42:06 UTC
  • mfrom: (1.1.4 upstream)
  • Revision ID: james.westby@ubuntu.com-20051116234206-p00omaw5ji5q0qhr
Tags: 3.15-3ubuntu1
Resynchronise with Debian.  (me)

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.\" -*- nroff -*-
 
2
.\" Copyright 1998, 1999, 2002, 2004 Thorsten Kukuk, Germany
 
3
.\"
 
4
.\" This file is part of ypbind-mt.
 
5
.\"
 
6
.\" Author: Thorsten Kukuk <kukuk@suse.de>
 
7
.\"
 
8
.\" ypbind-mt is free software; you can redistribute it and/or
 
9
.\" modify it under the terms of the GNU General Public License as
 
10
.\" published by the Free Software Foundation; either version 2 of the
 
11
.\" License, or (at your option) any later version.
 
12
.\"
 
13
.\" ypbind-mt is distributed in the hope that it will be useful,
 
14
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
 
15
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 
16
.\" General Public License for more details.
 
17
.\"
 
18
.\" You should have received a copy of the GNU General Public
 
19
.\" License along with ypbind-mt; see the file COPYING.  If not,
 
20
.\" write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 
21
.\" Boston, MA 02111-1307, USA.
 
22
.\"
 
23
.TH ypbind 8 "October 2004" "ypbind-mt Version @VERSION@"
 
24
.SH NAME
 
25
ypbind - NIS binding process
 
26
.SH SYNOPSIS
 
27
.B
 
28
ypbind
 
29
[
 
30
.BR \-c
 
31
] [
 
32
.BR \-d | \-debug
 
33
] [
 
34
.B \-broadcast
 
35
] [
 
36
.B \-broken-server
 
37
] [
 
38
.B \-ypset
 
39
] [
 
40
.B \-ypsetme
 
41
] [
 
42
.B \-no-ping
 
43
] [
 
44
.BR \-f " configfile"
 
45
] [
 
46
.B \-local-only
 
47
] [
 
48
.BR \-ping-interval " ping-interval"
 
49
]
 
50
.LP
 
51
.B
 
52
ypbind
 
53
.BR \--version
 
54
.SH DESCRIPTION
 
55
.B ypbind
 
56
finds the server for NIS domains and maintains the NIS binding
 
57
information. The client (normaly the NIS routines in the standard C library)
 
58
could get the information over RPC from
 
59
.B ypbind
 
60
or read the binding files. The binding files resides in the directory
 
61
.B /var/yp/binding
 
62
and are conventionally named
 
63
.BR [domainname].[version] .
 
64
The supported versions are 1 and 2.
 
65
There could be several such files since it is possible for an NIS client
 
66
to be bound to more then one domain.
 
67
.LP
 
68
After a binding has been established,
 
69
.B ypbind
 
70
will send YPPROC_DOMAIN requests to the current NIS server at 20 seconds
 
71
intervals. If it doesn't get an response or the NIS server reports that he
 
72
doesn't have this domain any longer,
 
73
.B ypbind
 
74
will search for a new NIS server. All 15 minutes
 
75
.B ypbind
 
76
will check to see if the current NIS server is the fastest. If it find
 
77
a server which answers faster, it will switch to this server.
 
78
You could tell
 
79
.B ypbind
 
80
to use network broadcasts to find a new server, what is insecure,
 
81
or you could give it a list of known secure servers.
 
82
In this case
 
83
.B ypbind
 
84
will send a ping to all servers and binds to first one which answers.
 
85
.LP
 
86
Unless the option
 
87
.B \-debug
 
88
is used, ypbind detaches itself from the controlling terminal and puts
 
89
itself into background.
 
90
.B ypbind
 
91
uses
 
92
.BR syslog (3)
 
93
for logging errors and warnings.
 
94
At startup or when receiving signal SIGHUP,
 
95
.B ypbind
 
96
parses the file
 
97
.B /etc/yp.conf
 
98
and tries to use the entries for its initial binding. Valid entries
 
99
are
 
100
 
 
101
.B domain
 
102
.I nisdomain
 
103
.B server
 
104
.I hostname
 
105
.RS
 
106
Use server
 
107
.I hostname
 
108
for the domain
 
109
.IR nisdomain .
 
110
You could have more then one entry of this type for a single domain.
 
111
.RE
 
112
 
 
113
.B domain
 
114
.I nisdomain
 
115
.B broadcast
 
116
.RS
 
117
Use broadcast on the local net for domain
 
118
.IR nisdomain .
 
119
.RE
 
120
 
 
121
.B ypserver
 
122
.I hostname
 
123
.RS
 
124
Use server
 
125
.I server
 
126
for the local domain.
 
127
.RE
 
128
 
 
129
A broadcast entry in the configuration file will overwrite a ypserver/server
 
130
entry and a ypserver/server entry broadcast. If all given server are down,
 
131
.B ypbind
 
132
will
 
133
.B not
 
134
switch to use broadcast.
 
135
.B ypbind
 
136
will try at first
 
137
.B /etc/hosts
 
138
and then
 
139
.B DNS
 
140
for resolving the hosts names from
 
141
.BR /etc/yp.conf .
 
142
If
 
143
.B ypbind
 
144
couldn't reconfigure the search order, it will use only
 
145
.BR DNS .
 
146
If
 
147
.B DNS
 
148
isn't available, you could only use IP-addresses in
 
149
.BR /etc/hosts .
 
150
.B ypbind
 
151
could only reconfigure the search order with glibc 2.x.
 
152
If the
 
153
.B \-broadcast
 
154
option is specified,
 
155
.B ypbind
 
156
will ignore the configuration file.
 
157
If the file does not exist or if there are no valid entries,
 
158
.B ypbind
 
159
exit.
 
160
.LP
 
161
This
 
162
.B ypbind
 
163
is a special version which uses
 
164
.BR pthreads .
 
165
It will start 2 more threads.  The master process services RPC requests
 
166
asking for binding info. The first thread initializes the binding and
 
167
checks it periodically. Upon failure, the binding is invalidated and
 
168
the process tries again to find a valid server. The second thread
 
169
will handle all the signals.
 
170
 
 
171
.SH OPTIONS
 
172
.TP
 
173
.B "\-broadcast"
 
174
Send a broadcast to request the information needed to bind to a
 
175
specific NIS server. With this option,
 
176
.B /etc/yp.conf
 
177
will be ignored.
 
178
.TP
 
179
.B "\-ypset"
 
180
Allow
 
181
.B root
 
182
from any remote machine to change the binding for a domain via the
 
183
.BR ypset (8)
 
184
command. By default, no one can change the binding. This option is really
 
185
insecure. If you change a binding for a domain, all the current known
 
186
servers for this domain will be forgotten. If the new server goes down,
 
187
.B ypbind
 
188
will use the old searchlist.
 
189
.TP
 
190
.B "\-ypsetme"
 
191
The same as
 
192
.BR \-ypset ,
 
193
but only
 
194
.B root
 
195
on the local machine is allowed to chang the binding. Such requests
 
196
are only allowd from
 
197
.BR loopback .
 
198
.TP
 
199
.B "\-c"
 
200
.B ypbind
 
201
only checks if the config file has syntax errors and exits.
 
202
.TP
 
203
.B "\-debug"
 
204
starts
 
205
.B ypbind
 
206
in debug mode.
 
207
.B ypbind
 
208
will not put itself into background, and error messages and debug
 
209
output are written to standard error.
 
210
.TP
 
211
.B "\-broken-server"
 
212
lets
 
213
.B ypbind
 
214
accept answers from servers running on an illegal port number. This should
 
215
usually be avoided, but is required by some
 
216
.BR ypserv (8)
 
217
versions.
 
218
.TP
 
219
.B "\-no-ping"
 
220
.B ypbind
 
221
will not check if the binding is alive. This option is for use with
 
222
dialup connections to prevent
 
223
.B ypbind
 
224
from keeping the connection unnessecarily open or causing autodials.
 
225
.TP
 
226
.BR "\-f" " configfile"
 
227
.B ypbind
 
228
will use
 
229
.B configfile
 
230
and not
 
231
.B /etc/yp.conf
 
232
.TP
 
233
.B "\-local-only"
 
234
.B ypbind
 
235
will only bind to the loopback device and is not reacheable from
 
236
a remote network.
 
237
.TP
 
238
.BR "\-ping-interval" " ping-interval"
 
239
The default value for
 
240
. B ypbind
 
241
to check, if a NIS server is still reacheable, is 20 seconds.
 
242
With this options another frequency in seconds can be specified.
 
243
.TP
 
244
.B "\--version"
 
245
Prints the version number
 
246
.LP
 
247
.SH NOTES
 
248
Binding to multiple domains is tested and works.
 
249
Load sharing between multiple servers for a single domain is
 
250
not supported.
 
251
.B ypbind
 
252
will always try to bind a domain to a server. If there is no valid
 
253
server in the list or answers to a broadcast, the domain is unbounded.
 
254
.LP
 
255
.SH FILES
 
256
.TP
 
257
.B /etc/yp.conf
 
258
configuration file.
 
259
.TP
 
260
.BI /var/yp/binding/[domainname].[version]
 
261
binding file containing information about each NIS domain.
 
262
.TP
 
263
.B /var/run/ypbind.pid
 
264
contains the process id of the currently running
 
265
.B ypbind
 
266
master process.
 
267
.LP
 
268
.SH "SEE ALSO"
 
269
.BR syslog (3),
 
270
.BR domainname (1),
 
271
.BR ypdomainname (8),
 
272
.BR ypwhich (1),
 
273
.BR ypserv (8),
 
274
.BR ypset (8)
 
275
 
 
276
.SH AUTHOR
 
277
.B ypbind-mt
 
278
was written by Thorsten Kukuk <kukuk@suse.de>.