1YPBIND(8) ypbind-mt YPBIND(8)
2
6 ypbind - NIS binding process
7
9 ypbind [-c] [-d | -debug] [-verbose] [-broadcast] [-broken-server]
10 [-ypset] [-ypsetme] [-no-ping] [-p port] [-f configfile]
11 [-local-only] [-ping-interval ping-interval]
12 [-rebind-interval rebind-interval] [-no-dbus]
13 ypbind --version
15
17 ypbind finds the server for NIS domains and maintains the NIS binding
18 information. The client (normaly the NIS routines in the standard C
19 library) could get the information over RPC from ypbind or read the
20 binding files. The binding files resides in the directory
21 /var/yp/binding and are conventionally named [domainname].[version].
22 The supported versions are 1 and 2. There could be several such files
23 since it is possible for an NIS client to be bound to more than one
24 domain.
25 After a binding has been established, ypbind will send YPPROC_DOMAIN
27 requests to the current NIS server at 20 seconds intervals. If it
28 doesn't get an response or the NIS server reports that he doesn't have
29 this domain any longer, ypbind will search for a new NIS server. All 15
30 minutes ypbind will check to see if the current NIS server is the
31 fastest. If it find a server which answers faster, it will switch to
32 this server. You could tell ypbind to use network broadcasts to find a
33 new server, what is insecure, or you could give it a list of known
34 secure servers. In this case ypbind will send a ping to all servers and
35 binds to first one which answers.
36 Unless the option -d, -debug is used, ypbind detaches itself from the
38 controlling terminal and puts itself into background. ypbind uses
39 syslog(3) for logging errors and warnings. At startup or when receiving
40 signal SIGHUP, ypbind parses the file /etc/yp.conf and tries to use the
41 entries for its initial binding.
42 A broadcast entry in the configuration file will overwrite a
44 ypserver/server entry and a ypserver/server entry broadcast. If all
45 given server are down, ypbind will not switch to use broadcast. ypbind
46 will try at first /etc/hosts and then DNS for resolving the hosts names
47 from /etc/yp.conf. If ypbind couldn't reconfigure the search order, it
48 will use only DNS. If DNS isn't available, you could only use
49 IP-addresses in /etc/hosts. ypbind could only reconfigure the search
50 order with glibc 2.x. If the -broadcast option is specified, ypbind
51 will ignore the configuration file. If the file does not exist or if
52 there are no valid entries, ypbind exit.
53 This ypbind version listens for DBUS messages from NetworkManager. If
55 no NetworkManager is running at startup, ypbind will behave as usual
56 and assumes there is a working network connection. If NetworkManager is
57 running on the system, ypbind will only search and providde NIS
58 informations, if NetworkManager tells that a network connection is
59 available. If NetworkManager establishes a connection, ypbind will
60 reread all configuration files, registers at the local portmapper and
61 try to search NIS servers. If NetworkManager drops a connection, ypbind
62 will unregister from portmapper.
63
65 -broadcast
66 Send a broadcast to request the information needed to bind to a
67 specific NIS server. With this option, /etc/yp.conf will be ignored.
68 -ypset
70 Allow root from any remote machine to change the binding for a
71 domain via the ypset(8) command. By default, no one can change the
72 binding. This option is really insecure. If you change a binding for
73 a domain, all the current known servers for this domain will be
74 forgotten. If the new server goes down, ypbind will use the old
75 searchlist.
76 -ypsetme
78 The same as -ypset, but only root on the local machine is allowed to
79 chang the binding. Such requests are only allowd from loopback.
80 -c ypbind only checks if the config file has syntax errors and exits.
82 -debug
84 starts ypbind in debug mode. ypbind will not put itself into
85 background, and error messages and debug output are written to
86 standard error.
87 -v, -verbose
89 Causes ypbind to syslog(2) any and all changes in the server its
90 bound to.
91 -broken-server, -broken_server
93 lets ypbind accept answers from servers running on an illegal port
94 number. This should usually be avoided, but is required by some
95 ypserv(8) versions.
96 -no-ping, -no_ping
98 ypbind will not check if the binding is alive. This option is for
99 use with dialup connections to prevent ypbind from keeping the
100 connection unnessecarily open or causing autodials.
101 -p port
103 ypbind will bind itself to this port. This makes it possible to
104 have a router filter packets to the NIS ports, so that access to
105 this service from hosts on the Internet can be restricted.
106 -f configfile
108 ypbind will use configfile and not /etc/yp.conf
109 -local-only, -local_only
111 ypbind will only bind to the loopback device and is not reacheable
112 from a remote network.
113 -ping-interval, -ping_interval ping-interval
115 The default value for ypbind to check, if a NIS server is still
116 reacheable, is 20 seconds. With this options another frequency in
117 seconds can be specified.
118 -rebind-interval rebind-interval
120 The default value for ypbind to search for the fastest NIS server is
121 900 seconds (15 minutes). With this options another frequency in
122 seconds can be specified.
123 -no-dbus
125 Disables DBUS support if compiled in.
126 --version
128 Prints the version number
129
131 /etc/yp.conf
132 configuration file.
133 /var/yp/binding/[domainname].[version]
135 binding file containing information about each NIS domain.
136 /var/run/ypbind.pid
138 contains the process id of the currently running ypbind master
139 process.
140
142 syslog(3), domainname(1), yp.conf(5), ypdomainname(8), ypwhich(1),
143 ypserv(8), ypset(8)
144
146 ypbind-mt was written by Thorsten Kukuk <kukuk@thkukuk.de>.
147ypbind-mt 10/04/2006 YPBIND(8)