diff options
author | wpaul <wpaul@FreeBSD.org> | 1996-06-05 04:36:55 +0000 |
---|---|---|
committer | wpaul <wpaul@FreeBSD.org> | 1996-06-05 04:36:55 +0000 |
commit | a32aea0154c407e8ffd8ad1867e028b42ceced4a (patch) | |
tree | 478102e02b168020eb0b2231ee28c8d5964c1d08 /usr.sbin/rpc.ypxfrd/rpc.ypxfrd.8 | |
parent | 1ef72ddf2b713ea7b576e8cadc4fef53c7aff1aa (diff) | |
parent | d6af1e17162d34157b22057bc35ddbbd7d2a347b (diff) | |
download | FreeBSD-src-a32aea0154c407e8ffd8ad1867e028b42ceced4a.zip FreeBSD-src-a32aea0154c407e8ffd8ad1867e028b42ceced4a.tar.gz |
This commit was generated by cvs2svn to compensate for changes in r16125,
which included commits to RCS files with non-trunk default branches.
Diffstat (limited to 'usr.sbin/rpc.ypxfrd/rpc.ypxfrd.8')
-rw-r--r-- | usr.sbin/rpc.ypxfrd/rpc.ypxfrd.8 | 139 |
1 files changed, 139 insertions, 0 deletions
diff --git a/usr.sbin/rpc.ypxfrd/rpc.ypxfrd.8 b/usr.sbin/rpc.ypxfrd/rpc.ypxfrd.8 new file mode 100644 index 0000000..3ca4d31 --- /dev/null +++ b/usr.sbin/rpc.ypxfrd/rpc.ypxfrd.8 @@ -0,0 +1,139 @@ +.\" Copyright (c) 1995, 1996 +.\" Bill Paul <wpaul@ctr.columbia.edu>. 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 Bill Paul. +.\" 4. Neither the name of the author nor the names of contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY Bill Paul 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 Bill Paul 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: rpc.ypxfrd.8,v 1.2 1996/06/03 20:17:16 wpaul Exp $ +.\" +.Dd June 2, 1996 +.Dt RPC.YPXFRD 8 +.Os +.Sh NAME +.Nm rpc.ypxfrd +.Nd "NIS map transfer server" +.Sh SYNOPSIS +.Nm rpc.ypxfrd +.Op Fl p Ar path +.Sh DESCRIPTION +The +.Nm rpc.ypxfrd +daemon is used to speed up the distribtion of very large NIS maps +from NIS master to NIS slave servers. The normal method for transfering +maps involves several steps: +.Bl -bullet -offset indent +.It +The master server calls +.Xr yppush 8 +to inform the slave servers to start a transfer. +.It +The slave servers invoke +.Xr ypxfr 8 , +which reads the entire contents of a map from the master server +using the yp_all() function. +.It +The +.Xr ypxfr 8 +program then creates a new map database file by using the +.Xr db 3 +library hash method to store the data that it receives from the server. +.It +When all the data has been retrieved, +.Xr ypxfr 8 +moves the new file into place and sends +.Xr ypserv 8 +on the local machine a YPPROC_CLEAR to tell it to refresh its +database handles. +.El +.Pp +This process can take several minutes when there are very large +maps involved. For example: a passwd database with several tens of +thousands of entries can consume several megabytes of disk space, +and it can take the +.Xr db 3 +library package a long time to sort and store all the records +in a hash database. Consider also that there are two sets of map +files: +.Pa master.passwd.by{name,uid} +and +.Pa passwd.by{name,uid} . +.Pp +The +.Nm rpc.ypxfrd +server speeds up the transfer process by allowing NIS slave servers to +simply copy the master server's map files rather than building their +own from scratch. Simply put, +.Nm rpc.ypxfrd +impliments an RPC-based file transfer protocol. Transfering even +a multi-megabyte file in this fashion takes only a few seconds compared +to the several minutes it would take even a reasonably fast slave server +to build a new map from scratch. +.Pp +The +.Nm rpc.ypxfrd +server uses the same access restriction mechanism as +.Xr ypserv 8 . +This means that slave servers will only be permitted to transfer +files if the rules in the +.Xr securenets 5 +database permit it. Furthermore, only slave servers using reserved +ports will be allowed to transfer the +.Pa master.passwd +maps. +.Sh OPTIONS +The following options and flags are supported by +.Nm rpc.ypxfrd : +.Bl -tag -width flag +.It Fl p Ar path +This option can be used to override the default path to +the location of the NIS +map databases. The compiled-in default path is +.Pa /var/yp . +.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 yppush 8 , +.Xr ypxfr 8 , +.Xr yp 4 +.Sh BUGS +The FreeBSD +.Nm ypxfrd +protocol is not compatible with that used by SunOS. This is unfortunate +but unavoidable: Sun's protocol is not freely available, and even if it +were it would probably not be useful since the SunOS NIS v2 implimentation +uses the original ndbm package for its map databases whereas the FreeBSD +implimentation uses Berkeley DB. These two packages use vastly different +file formats. Furthermore, ndbm is byte-order sensitive and not very +smart about it, meaning that am ndbm database created on a big endian +system can't be read on a little endian system. +.Sh AUTHOR +Bill Paul <wpaul@ctr.columbia.edu> |