1
.\" Copyright (c) 1996, 1997, 1999, 2001 Thorsten Kukuk <kukuk@suse.de>
2
.TH YPSERV 8 "August 2001" "YP Server" ""
4
ypxfr - transfer NIS database from remote server to local host
42
copies an NIS database from one NIS server to the local host by
43
using the NIS service.
45
is generally invoked by
51
receives a map transfer request from
53
It creates a temporary map in the directory
55
(this directory must already exist;
57
is the default domainname for the local host), fills it by getting
58
the map's entries and fetches the map parameters (master and order number).
59
If the transfer was successful, the old version of the map will be
60
deleted and the temporary copy will be moved into its place.
63
will attempt to send a "clear current map" request to the local
68
writes its output to stderr.
69
However, if it is invoked without a controlling terminal, it will
70
log the output to syslog.
73
is used primarily in environments where several NIS servers are in use.
74
For all maps, you have a NIS master server, which maintains a canonical
75
copy of the NIS map, and all the other servers, the NIS slaves, copy
76
the new version of the map from the master whenever a update was made.
77
Normally, you have one NIS master for all maps.
79
In order to maintain consistency across all NIS servers,
81
can be run periodically in a
83
job. Maps which change infrequently need only be updated once a day
84
(preferably late at night when system usage is lowest), where those
85
with frequent changes (such as
89
should be updated perhaps once every hour.
91
.B @YPBINDIR@: ypxfr_1perday, ypxfr_2perday,
94
They can serve as reasonable first cuts.
96
Normally all updates should be propagated by
99
.B @YPMAPDIR@/Makefile
100
is run on the NIS master server, however it is a good practice
101
on large networks where possible outages could cause NIS slaves to
102
fall out of sync with the master.
106
The following options are supported:
109
Force a map transfer. Normally,
111
will not transfer a map if it determines that the NIS master's copy
112
is not newer than the existing copy already on the local host. This
113
flag forces a transfer regardless of which server's version is more
117
Do not send a "clear current map" request to the
119
process running on the local host. This flag is normally used when
126
is not running locally at the time you are running
130
will complain that it cannot talk to the local
132
and the transfer will fail.
135
Specify a domain other than the default NIS domain.
137
.BI \-h " source host"
140
regardless of what the map says the master is. If
146
service for the name of the master, and tries to get the
147
map from there. This option is used to insure that ypxfr only copies
148
maps from the NIS master server.
150
.BI \-s " source domain"
151
Specify a source domain from which to transfer a map that should be the same
154
.BI \-C " taskid progam-number ipaddr port"
167
process at the host with
171
registered as program number
175
and waiting for a response to transaction
179
Change the directory for the maps to
180
\fIyp_path/[domainname]/\fP, the default
181
is \fI@YPMAPDIR@/[domainname]\fP.
184
One or more names of the map to transfer.
186
@YPMAPDIR@/[domainname]/[maps]
194
Thorsten Kukuk <kukuk@suse.de>