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

« back to all changes in this revision

Viewing changes to ypbind-mt-1.19/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>.