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] [-f configfile] [-local-only]
11 [-ping-interval ping-interval] [-no-dbus]
12 ypbind --version
14
16 ypbind finds the server for NIS domains and maintains the NIS binding
17 information. The client (normally the NIS routines in the standard C
18 library) could get the information over RPC from ypbind or read the
19 binding files. The binding files resides in the directory
20 /var/yp/binding and are conventionally named [domainname].[version].
21 The supported versions are 1 and 2. There could be several such files
22 since it is possible for an NIS client to be bound to more than one
23 domain.
24 After a binding has been established, ypbind will send YPPROC_DOMAIN
26 requests to the current NIS server at 20 seconds intervals. If it
27 doesn´t get an response or the NIS server reports that he doesn´t have
28 this domain any longer, ypbind will search for a new NIS server. All 15
29 minutes ypbind will check to see if the current NIS server is the
30 fastest. If it find a server which answers faster, it will switch to
31 this server. You could tell ypbind to use network broadcasts to find a
32 new server, what is insecure, or you could give it a list of known
33 secure servers. In this case ypbind will send a ping to all servers and
34 binds to first one which answers.
35 Unless the option -debug is used, ypbind detaches itself from the
37 controlling terminal and puts itself into background. ypbind uses
38 syslog(3) for logging errors and warnings. At startup or when receiving
39 signal SIGHUP, ypbind parses the file /etc/yp.conf and tries to use the
40 entries for its initial binding.
41 A broadcast entry in the configuration file will overwrite a
43 ypserver/server entry and a ypserver/server entry broadcast. If all
44 given server are down, ypbind will not switch to use broadcast. ypbind
45 will try at first /etc/hosts and then DNS for resolving the hosts names
46 from /etc/yp.conf. If ypbind couldn´t reconfigure the search order, it
47 will use only DNS. If DNS isn´t available, you could only use
48 IP-addresses in /etc/hosts. ypbind could only reconfigure the search
49 order with glibc 2.x. If the -broadcast option is specified, ypbind
50 will ignore the configuration file. If the file does not exist or if
51 there are no valid entries, ypbind exit.
52 This ypbind version listens for DBUS messages from NetworkManager. If
54 no NetworkManager is running at startup, ypbind will behave as usual
55 and assumes there is a working network connection. If NetworkManager is
56 running on the system, ypbind will only search and provide NIS
57 informations, if NetworkManager tells that a network connection is
58 available. If NetworkManager establishes a connection, ypbind will
59 reread all configuration files, registers at the local portmapper and
60 try to search NIS servers. If NetworkManager drops a connection, ypbind
61 will unregister from portmapper.
62
64 -broadcast
65 Send a broadcast to request the information needed to bind to a
66 specific NIS server. With this option, /etc/yp.conf will be
67 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
73 for 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
79 to change the binding. Such requests are only allowed from
80 loopback.
81 -c
83 ypbind only checks if the config file has syntax errors and exits.
84 -debug
86 starts ypbind in debug mode. ypbind will not put itself into
87 background, and error messages and debug output are written to
88 standard error.
89 -verbose
91 Causes ypbind to syslog(2) any and all changes in the server its
92 bound to.
93 -broken-server
95 lets ypbind accept answers from servers running on an illegal port
96 number. This should usually be avoided, but is required by some
97 ypserv(8) versions.
98 -no-ping
100 ypbind will not check if the binding is alive. This option is for
101 use with dialup connections to prevent ypbind from keeping the
102 connection unnecessarily open or causing autodials.
103 -f configfile
105 ypbind will use configfile and not /etc/yp.conf
106 -local-only
108 ypbind will only bind to the loopback device and is not reachable
109 from a remote network.
110 -ping-interval ping-interval
112 The default value for ypbind to check, if a NIS server is still
113 reacheable, is 20 seconds. With this options another frequency in
114 seconds can be specified.
115 -no-dbus
117 Disables DBUS support if compiled in.
118 --version
120 Prints the version number
121
123 /etc/yp.conf
124 configuration file.
125 /var/yp/binding/[domainname].[version]
127 binding file containing information about each NIS domain.
128 /var/run/ypbind.pid
130 contains the process id of the currently running ypbind master
131 process.
132
134 syslog(3), domainname(1), yp.conf(5), ypdomainname(8), ypwhich(1),
135 ypserv(8), ypset(8)
136
138 ypbind-mt was written by Thorsten Kukuk <kukuk@thkukuk.de>.
139ypbind-mt 07/07/2010 YPBIND(8)