Wrote manual page for ypxfr, modified Makefile to install it.
This commit is contained in:
Bill Paul
parent
91857942bb
commit
5920e7589e
@ -1,11 +1,8 @@
|
||||
# $Id$
|
||||
# $Id: Makefile,v 1.1 1995/01/31 09:28:38 wpaul Exp $
|
||||
|
||||
PROG= ypxfr
|
||||
MAN8=
|
||||
MAN8= ypxfr.8
|
||||
|
||||
SRCS= ypxfr.c ypclnt.c yp_clnt.c yp_xdr.c
|
||||
|
||||
BINOWN= bin
|
||||
BINMODE=555
|
||||
|
||||
.include <bsd.prog.mk>
|
||||
|
||||
196
gnu/libexec/ypxfr/ypxfr.8
Normal file
196
gnu/libexec/ypxfr/ypxfr.8
Normal file
@ -0,0 +1,196 @@
|
||||
.\" Copyright (c) 1991, 1993, 1995
|
||||
.\" The Regents of the University of California. All rights reserved.
|
||||
.\"
|
||||
.\" Redistribution and use in source and binary forms, with or without
|
||||
.\" modification, are permitted provided that the following conditions
|
||||
.\" are met:
|
||||
.\" 1. Redistributions of source code must retain the above copyright
|
||||
.\" notice, this list of conditions and the following disclaimer.
|
||||
.\" 2. Redistributions in binary form must reproduce the above copyright
|
||||
.\" notice, this list of conditions and the following disclaimer in the
|
||||
.\" documentation and/or other materials provided with the distribution.
|
||||
.\" 3. All advertising materials mentioning features or use of this software
|
||||
.\" must display the following acknowledgement:
|
||||
.\" This product includes software developed by the University of
|
||||
.\" California, Berkeley and its contributors.
|
||||
.\" 4. Neither the name of the University nor the names of its contributors
|
||||
.\" may be used to endorse or promote products derived from this software
|
||||
.\" without specific prior written permission.
|
||||
.\"
|
||||
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
||||
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
||||
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||||
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
||||
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
||||
.\" SUCH DAMAGE.
|
||||
.\"
|
||||
.\" $Id$
|
||||
.\"
|
||||
.Dd February 5, 1995
|
||||
.Dt YPXFR 8
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm ypxfr
|
||||
.Nd "transfer NIS database from remote server to local host"
|
||||
.Sh SYNOPSIS
|
||||
.Nm ypxfr
|
||||
.Op Fl f
|
||||
.Op Fl c
|
||||
.Op Fl d Ar target domain
|
||||
.Op Fl h Ar source host
|
||||
.Op Fl s Ar source domain
|
||||
.Op Fl C Ar taskid program-number ipaddr port
|
||||
.Ar mapname
|
||||
.Sh DESCRIPTION
|
||||
.Nm ypxfr
|
||||
copies an NIS database (or
|
||||
.Pa map )
|
||||
from one NIS server to another using NIS services. In FreeBSD,
|
||||
.Nm ypxfr
|
||||
is generally invoked by
|
||||
.Xr ypserv 8
|
||||
when it receives a map transfer request from
|
||||
.Xr yppush 8 .
|
||||
.Nm ypxfr
|
||||
is used primarily in environments where several NIS servers
|
||||
are in use in a single domain. One server, the NIS master, maintains
|
||||
the canonical copies of all NIS maps, and all the other servers,
|
||||
the NIS slaves, copy new versions of the maps from the master whenever
|
||||
any updates are made (i.e. when a user updates their password via
|
||||
.Xr yppasswd 1
|
||||
).
|
||||
.Pp
|
||||
When run,
|
||||
.Nm ypxfr
|
||||
creates a temporary database file in
|
||||
.Pa /var/yp/[domainmame] ,
|
||||
and fills it with the contents of
|
||||
.Ar mapname
|
||||
as supplied by the specified
|
||||
.Ar source host .
|
||||
When the entire map has been transfered,
|
||||
.Nm ypxfr
|
||||
deletes the original copy of
|
||||
.Ar mapname
|
||||
and moves the temporary copy into its place. When the transfer is
|
||||
complete,
|
||||
.Nm ypxfr
|
||||
will attempt to send a 'clear current map' request to the local
|
||||
.Xr ypserv 8
|
||||
process to clear any possible references it may still have to the
|
||||
stale map.
|
||||
.Pp
|
||||
Note that all files created by
|
||||
.Nm ypxfr
|
||||
are owner readable and writable only for security reasons. Since the
|
||||
NIS maps and the directory in which they reside are normally owned by
|
||||
root, this prevents non-privleged users from making unauthorized
|
||||
modifications.
|
||||
.Pp
|
||||
In order to maintain consistency across all NIS servers,
|
||||
.Nm ypxfr
|
||||
can be run periodically in a
|
||||
.Xr cron 8
|
||||
job. Maps which change infrequently
|
||||
need only be updated once a day (preferably late at night when system
|
||||
usage is lowest), whereas those that are subject to frequent changes
|
||||
(such a
|
||||
.Pa passwd.byname
|
||||
and
|
||||
.Pa passwd.byuid )
|
||||
should be updated perhaps once every hour. Using
|
||||
.Xr cron 8
|
||||
to automatically
|
||||
update the NIS maps is not strictly mandatory since all updates should
|
||||
be propagated by
|
||||
.Xr yppush 8
|
||||
when
|
||||
.Pa /var/yp/Makefile
|
||||
is run on the NIS master server, however it is good practice
|
||||
on large networks where possible outages could cause NIS servers to
|
||||
fall out of sync with each other.
|
||||
.Sh OPTIONS
|
||||
The following options are supported by
|
||||
.Nm yppxfr :
|
||||
.Bl -tag -width flag
|
||||
.It Fl f
|
||||
Force a map transfer. Normally,
|
||||
.Nm ypxfr
|
||||
will not transfer a map if it determines that the NIS master's copy
|
||||
is not newer than the existing copy already on the local host: the
|
||||
.Fl f
|
||||
flag forces a transfer regardless of which server's version is more recent.
|
||||
.It Fl c
|
||||
Do not send a 'clear current map' request to the
|
||||
.Xr ypserv 8
|
||||
process running on the local host. This flag is normally used when
|
||||
invoking
|
||||
.Nm ypxfr
|
||||
manually on a machine that is not yet running
|
||||
.Xr ypserv 8 .
|
||||
Without this flag, failure to contact the local NIS server will cause
|
||||
.Nm ypxfr
|
||||
to abort the transfer.
|
||||
.It Fl d Ar target domain
|
||||
Specify a target domain other than the current NIS domain.
|
||||
.It Fl h Ar source host
|
||||
Specify the name of the host from which to copy the NIS maps. This option
|
||||
is used to insure that
|
||||
.Nm ypxfr
|
||||
only copies maps from the NIS master server.
|
||||
.It Fl s Ar source domain
|
||||
Specify the domain from which to transfer a map, in the event that
|
||||
the transfer is being done across two different NIS domains.
|
||||
.It Fl C Ar taskid program-number ipaddr port
|
||||
These options are used only when
|
||||
.Nm ypxfr
|
||||
is invoked by
|
||||
.Xr ypserv 8
|
||||
in response to a map transfer request initiated by
|
||||
.Xr yppush 8 .
|
||||
In this instance,
|
||||
.Nm ypxfr
|
||||
needs to 'callback' to the
|
||||
.Xr yppush 8
|
||||
process and interact with it, so
|
||||
.Xr yppush 8
|
||||
passes to it an IP address
|
||||
.Ar ipaddr ,
|
||||
port number
|
||||
.Ar port ,
|
||||
registered program number
|
||||
.Ar program-number
|
||||
and a transaction ID
|
||||
.Ar taskid
|
||||
that it can use to contact the waiting
|
||||
.Xr yppush 8
|
||||
process on the master server.
|
||||
.It Ar mapname
|
||||
The name of the map to transfer.
|
||||
.El
|
||||
.Sh FILES
|
||||
.Bl -tag -width Pa -compact
|
||||
.It Pa /var/yp/[domainname]/[maps]
|
||||
The NIS maps for a particular NIS domain.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr ypserv 8 ,
|
||||
.Xr ypxfr 8 ,
|
||||
.Xr yp 8
|
||||
.Sh BUGS
|
||||
.Nm ypxfr
|
||||
should log its output to /var/yp/ypxfr.log when it is started without
|
||||
a controlling terminal. Hopefully this feature will be added in the
|
||||
next release of FreeBSD.
|
||||
.Sh LICENSE
|
||||
This program is covered by the GNU Public License version 2.
|
||||
.Sh AUTHOR
|
||||
Tobias Reber (original Linux version)
|
||||
.br
|
||||
Bill Paul <wpaul@ctr.columbia.edu> (port to FreeBSD and various
|
||||
changes)
|
||||
Loading…
x
Reference in New Issue
Block a user