1RPC.YPXFRD(8) Reference Manual RPC.YPXFRD(8)
2
6 rpc.ypxfrd - NIS map transfer server
7
9 /usr/sbin/rpc.ypxfrd [ -d path ] [ -p port ] [ --debug ]
10 /usr/sbin/rpc.ypxfrd --version
11
13 rpc.ypxfrd is used for speed up the transfer of very large NIS maps
14 from a NIS master to the NIS slave server. If a NIS slave server
15 receives a message that there is a new map, it will start ypxfr for
16 transfering the new map. ypxfr will read the contents of a map from
17 the master server using the yp_all() function. This process can take
18 several minutes when there are very large maps which have to be stored
19 by the database library.
20 The rpc.ypxfrd server speeds up the transfer process by allowing NIS
22 slave servers to simply copy the master server's map files rather than
23 building their own from scratch. rpc.ypxfrd uses an RPC-based file
24 transfer protocol, so that there is no need for building a new map.
25 rpc.ypxfrd could be started by inetd. But since it starts very slowly,
27 it should be started after ypserv from /etc/init.d/ypxfrd.
28
30 --debug
31 Causes the server to run in debugging mode. In debug mode, the
32 server does not background itself and prints extra status mes‐
33 sages to stderr for each request that it revceives.
34 -d directory
36 rpc.ypxfrd is using this directory instead of /var/yp
37 -p port
39 rpc.ypxfrd will bind itself to this port, which makes it possi‐
40 ble to have a router filter packets to the NIS ports. This can
41 restricted the access to the NIS server from hosts on the Inter‐
42 net.
43 --version
45 Prints the version number
46
48 rpc.ypxfrd uses the same functions for checking a host as ypserv. At
49 first, rpc.ypxfrd will check a request from an address with
50 /var/yp/securenets or the tcp wrapper. If the host is allowed to con‐
51 nect to the server, rpc.ypxfrd will uses the rules from
52 /etc/ypserv.conf to check the requested map. If a mapname doesn't match
53 a rule, rpc.ypxfrd will look for the YP_SECURE key in the map. If it
54 exists, rpc.ypxfrd will only allow requests on a reserved port.
55
57 /etc/ypserv.conf /var/yp/securenets
58
60 ypserv(8), makedbm(8), yppush(8), ypxfr(8)
61
63 The FreeBSD ypxfrd protocol is not compatible with that used by SunOS.
64 This is unfortunate but unavoidable: Sun's protocol is not freely
65 available, and even if it were it would probably not be useful since
66 the SunOS NIS v2 implimentation uses the original ndbm package for its
67 map databases whereas the other implimentation uses GNU DBM or Berkeley
68 DB. These packages uses vastly different file formats. Furthermore,
69 ndbm and gdbm are byte-order sensitive and not very smart about it,
70 meaning that a gdbm or ndbm database created on a big endian system
71 can't be read on a little endian system. The FreeBSD ypxfrd protocol
72 checks, if both, master and slave, uses the same database packages and,
73 if necessary, the byte order of the system.
74
76 ypxfrd protocol and FreeBSD Implementation: Bill Paul <wpaul@ctr.colum‐
77 bia.edu>
78 Linux Implementation: Thorsten Kukuk <kukuk@suse.de>
79YP Server August 2001 RPC.YPXFRD(8)