Import translated manuals from JM CVS Repository.

[linuxjm/jm.git] / manual / ypserv / draft / man8 / rpc.ypxfrd.8

.\" -*- nroff -*-
.\" $Id: rpc.ypxfrd.8,v 1.4 2001/12/01 15:25:31 nakano Exp $
.\" 
.\" This manual page is a part of ypserv archive. 
.\" README states the following
.\"
.\" See the file COPYING for copying restrictions. It is available under
.\" the GNU General Public License.
.\"
.\" Japanese Version Copyright (c) 1998, 1999 NAKANO Takeo all rights reserved.
.\" Translated Mon 23 Nov 1998 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
.\" Updated Fri 22 Oct 1999 by NAKANO Takeo
.\" Updated Wed 11 Apr 2001 by Yuichi SATO <sato@complex.eng.hokudai.ac.jp>
.\"
.TH RPC.YPXFRD 8 "August 1996" "NYS YP Server" "Linux Reference Manual"
.\"O .SH NAME
.\"O rpc.ypxfrd \- NIS map transfer server
.SH ̾Á°
rpc.ypxfrd \- NIS ¥Þ¥Ã¥×žÁ÷¥µ¡¼¥Ð¡¼
.\"O .SH SYNOPSIS
.SH ½ñ¼°
.B /usr/sbin/rpc.ypxfrd
[
.B \-d path 
]
[
.B \-p port
]
[
.B \-\-debug
]
.B /usr/sbin/rpc.ypxfrd 
.B \-\-version
.LP
.\"O .SH DESCRIPTION
.SH ÀâÌÀ
.LP
.\"O .B rpc.ypxfrd
.\"O is used for speed up the transfer of very large NIS maps from a NIS
.\"O master to the NIS slave server. If a  NIS slave server receives a
.\"O message that there is a new map, it will start 
.\"O .B ypxfr
.\"O for transfering the new map.
.\"O .B ypxfr 
.\"O will read the contents of a map from the master server using the yp_all() 
.\"O function. This process can take several minutes when there are very large
.\"O maps which have to be stored by the database library.
.B rpc.ypxfrd
¤ÏÈó¾ï¤ËÂ礭¤Ê NIS ¥Þ¥Ã¥×¤ò NIS ¥Þ¥¹¥¿¡¼¤«¤é NIS ¥¹¥ì¡¼¥Ö¥µ¡¼¥Ð¡¼¤Ë
žÁ÷¤¹¤ëºÝ¤Ë¡¢Å¾Á÷¤ò¹â®²½¤¹¤ë¤¿¤á¤ËÍѤ¤¤é¤ì¤ë¡£
NIS ¥¹¥ì¡¼¥Ö¥µ¡¼¥Ð¡¼¤Ï¡¢¿·¤·¤¤¥Þ¥Ã¥×¤¬¤¢¤ë¤È¤¤¤¦¥á¥Ã¥»¡¼¥¸¤ò
¼õ¤±¼è¤ë¤È¡¢¤½¤Î¥Þ¥Ã¥×¤ò¼èÆÀ¤¹¤ë¤¿¤á¤Ë
.B ypxfr
¤òµ¯Æ°¤¹¤ë¡£
.B ypxfr
¤Ï yp_all() ´Ø¿ô¤òÍѤ¤¤Æ¥Þ¥Ã¥×¤ÎÆâÍƤò¥Þ¥¹¥¿¡¼¥µ¡¼¥Ð¡¼¤«¤é
Æɤ߹þ¤â¤¦¤È¤¹¤ë¡£¤³¤Î¾ðÊó¤Ï¥Ç¡¼¥¿¡¼¥Ù¡¼¥¹¥é¥¤¥Ö¥é¥ê¤ò
Ä̤·¤ÆÊݸ¤µ¤ì¤ë¤¿¤á¡¢¥Þ¥Ã¥×¤Î¥µ¥¤¥º¤¬Èó¾ï¤ËÂ礭¤¯¤Ê¤ë¤È¡¢
¤³¤Î¥×¥í¥»¥¹¤Ï¿ôʬ¤â¤«¤«¤Ã¤Æ¤·¤Þ¤¦¤³¤È¤¬¤¢¤ë¡£
.LP
.\"O The
.\"O .B rpc.ypxfrd
.\"O server speeds up the transfer process by allowing NIS slave servers to
.\"O simply copy the master server's map files rather than building their
.\"O own from scratch.
.\"O .B rpc.ypxfrd
.\"O uses an RPC-based file transfer protocol, so that there is no need
.\"O for building a new map.
.B rpc.ypxfrd
¥µ¡¼¥Ð¡¼¤Ï¡¢ NIS ¥¹¥ì¡¼¥Ö¥µ¡¼¥Ð¡¼¤Ë¥Þ¥¹¥¿¡¼¤Î¥Þ¥Ã¥×¥Õ¥¡¥¤¥ë¤ò
ñ½ã¤Ë¥³¥Ô¡¼¤µ¤»¡¢Å¾Á÷¥×¥í¥»¥¹¤ò¹â®²½¤¹¤ë¡£¥¹¥ì¡¼¥Ö¥µ¡¼¥Ð¡¼¤¬
¥¼¥í¤«¤é¥Þ¥Ã¥×¤òÀ¸À®¤¹¤ë¤Î¤ËÈæ¤Ù¡¢¤³¤ì¤Ï¤º¤Ã¤Èû»þ´Ö¤Ç¤¹¤à¡£
.B rpc.ypxfrd
¤Ï RPC ¥Ù¡¼¥¹¤ÎžÁ÷¥×¥í¥È¥³¥ë¤òÍѤ¤¤ë¤Î¤Ç¡¢¿·¤·¤¤¥Þ¥Ã¥×¤ò
À¸À®¤¹¤ëɬÍפϤʤ¯¤Ê¤ë¡£

.\"O .B rpc.ypxfrd
.\"O could be started by inetd. But since it starts very slowly,
.\"O it should be started after
.\"O .B ypserv
.\"O from /etc/init.d/ypxfrd.
.B rpc.ypxfrd
¤Ï inetd ¤«¤éµ¯Æ°¤¹¤ë¤³¤È¤â¤Ç¤­¤ë¤¬¡¢µ¯Æ°¤Ë¤Ï»þ´Ö¤¬¤«¤«¤ë¤Î¤Ç¡¢
.B ypserv
¤Î¸å¤Ë /etc/init.d/ypxfrd ¤«¤éµ¯Æ°¤¹¤ë¤Î¤¬Îɤ¤¡£
.\"O .SH OPTIONS
.TP
.B \-\-debug
.\"O Causes the server to run in debugging mode. In debug mode, the server 
.\"O does not background itself and prints extra status messages to stderr 
.\"O for each request that it revceives.
¥µ¡¼¥Ð¡¼¤ò¥Ç¥Ð¥Ã¥°¥â¡¼¥É¤Çµ¯Æ°¤¹¤ë¡£
¥Ç¥Ð¥Ã¥°¥â¡¼¥É¤Ç¤Ï¡¢¥µ¡¼¥Ð¡¼¤Ï¥Ð¥Ã¥¯¥°¥é¥¦¥ó¥É¤ØÂÔÈò¤»¤º¡¢
¥¢¥¯¥»¥¹Í×µá¤ò¼õ¤±¤ë¤¿¤Ó¤ËºÙ¤«¤Ê¥¹¥Æ¡¼¥¿¥¹¥á¥Ã¥»¡¼¥¸¤ò
ɸ½à¥¨¥é¡¼½ÐÎϤËɽ¼¨¤¹¤ë¡£
.TP
.BI \-d " directory"
.\"O .B rpc.ypxfrd
.\"O is using this directory instead of /var/yp
/var/yp ¤ÎÂå¤ï¤ê¤Ë
.B rpc.ypxfrd
¤¬ÍѤ¤¤ë¥Ç¥£¥ì¥¯¥È¥ê¤ò»ØÄꤹ¤ë¡£
.TP
.BI \-p " port"
.\"O .B rpc.ypxfrd
.\"O will bind itself to this port,
.\"O which makes it possible to have a router filter packets
.\"O to the NIS ports. This can restricted the access to the NIS server from
.\"O hosts on the Internet.
.B rpc.ypxfrd
¤¬¥Ð¥¤¥ó¥É¤¹¤ë¥Ý¡¼¥ÈÈÖ¹æ¤ò»ØÄꤹ¤ë¡£¤³¤Î¥ª¥×¥·¥ç¥ó¤òÍѤ¤¤ë¤È¡¢
¥ë¡¼¥¿¤Ë NIS ¥Ý¡¼¥È¤Ø¤Î¥Ñ¥±¥Ã¥È¤ò¥Õ¥£¥ë¥¿¥ê¥ó¥°¤µ¤»¡¢
¥¤¥ó¥¿¡¼¥Í¥Ã¥È¤«¤é¤Î NIS ¥µ¡¼¥Ð¡¼¤Ø¤Î¥¢¥¯¥»¥¹¤òÀ©¸Â¤Ç¤­¤ë¡£
.TP
.B \-\-version
.\"O Prints the version number
¥Ð¡¼¥¸¥ç¥óÈÖ¹æ¤òɽ¼¨¤¹¤ë¡£
.\"O .SH SECURITY
.SH ¥»¥­¥å¥ê¥Æ¥£
.\"O .B rpc.ypxfrd
.\"O uses the same functions for checking a host as
.\"O .B ypserv.
.\"O At first,
.\"O .B rpc.ypxfrd
.\"O will check a request from an address with 
.\"O .B /var/yp/securenets
.\"O or the tcp wrapper.
.\"O If the host is allowed to connect to the server, 
.\"O .B rpc.ypxfrd
.\"O will uses the rules from
.\"O .B /etc/ypserv.conf
.\"O to check the requested map. If a mapname doesn't match a rule, 
.\"O .B rpc.ypxfrd
.\"O will look for the YP_SECURE key in the map. If it exists,
.\"O .B rpc.ypxfrd
.\"O will only allow requests on a reserved port.
.B rpc.ypxfrd
¤Ï¥Û¥¹¥È¤Î¥Á¥§¥Ã¥¯¤Ë
.B ypserv
¤ÈƱ¤¸µ¡Ç½¤òÍѤ¤¤ë¡£¤Þ¤º
.B rpc.ypxfrd
¤ÏÍ׵ḵ¤Î¥¢¥É¥ì¥¹¤ò
.B /var/yp/securenets
¤Þ¤¿¤Ï tcp wrapper ¤Ç¥Á¥§¥Ã¥¯¤¹¤ë¡£¥Û¥¹¥È¤Î¥µ¡¼¥Ð¡¼¤Ø¤ÎÀܳ¤¬
µö¤µ¤ì¤Æ¤¤¤ë¾ì¹ç¤Ë¤Ï¡¢
.B rpc.ypxfrd
¤Ï
.B /etc/ypserv.conf
¤«¤éÍ׵ᤵ¤ì¤¿¥Þ¥Ã¥×¤Î¥ë¡¼¥ë¤ò¥Á¥§¥Ã¥¯¤¹¤ë¡£¥Þ¥Ã¥×¤Î̾Á°¤¬
¥ë¡¼¥ë¤Ë¥Þ¥Ã¥Á¤·¤Ê¤¤¾ì¹ç¤Ë¤Ï¡¢
.B rpc.ypxfrd
¤Ï¤½¤Î¥Þ¥Ã¥×¤Î YP_SECURE ¥­¡¼¤òÄ´¤Ù¤ë¡£¥­¡¼¤¬Â¸ºß¤·¤Æ¤¤¤ë¤È¡¢
.B rpc.ypxfrd
¤ÏÆø¢¥Ý¡¼¥È¤«¤é¤ÎÍ×µá¤À¤±¤òµö²Ä¤¹¤ë¡£
.\"O .SH FILES
.SH ¥Õ¥¡¥¤¥ë
/etc/ypserv.conf
/var/yp/securenets
.\"O .SH "SEE ALSO"
.SH ´ØÏ¢¹àÌÜ
.BR ypserv (8),
.BR makedbm (8),
.BR yppush (8),
.BR ypxfr (8)
.LP
.\"O .SH BUGS
.SH ¥Ð¥°
.\"O The FreeBSD
.\"O .B ypxfrd
.\"O protocol is not compatible with that used by SunOS. This is unfortunate
.\"O but unavoidable: Sun's protocol is not freely available, and even if it
.\"O were it would probably not be useful since the SunOS NIS v2 implimentation
.\"O uses the original ndbm package for its map databases whereas the other
.\"O implimentation uses GNU DBM or Berkeley DB. These packages uses vastly 
.\"O different file formats. Furthermore, ndbm and gdbm are byte-order sensitive 
.\"O and not very smart about it, meaning that a gdbm or ndbm database created on 
.\"O a big endian system can't be read on a little endian system. The FreeBSD
.\"O .B ypxfrd
.\"O protocol checks, if both, master and slave, uses the same database packages
.\"O and, if necessary, the byte order of the system.
FreeBSD ¤Î
.B ypxfrd
¥×¥í¥È¥³¥ë¤Ï SunOS ¤Î¤â¤Î¤È¤Ï¸ß´¹À­¤¬¤Ê¤¤¡£¤³¤ì¤Ï»ÄÇ°¤Ê¤³¤È¤Ç¤Ï¤¢¤ë¤¬¡¢
ÉÔ²ÄÈò¤Ê¤â¤Î¤Ç¤¢¤Ã¤¿¡£ Sun ¤Î¥×¥í¥È¥³¥ë¤Ï¥Õ¥ê¡¼¤ËÆþ¼ê¤Ç¤­¤ë¤â¤Î¤Ç¤Ï
¤Ê¤«¤Ã¤¿¤·¡¢²¾¤ËÆþ¼ê¤¬¤Ç¤­¤¿¤È¤·¤Æ¤âÍ­ÍѤʤâ¤Î¤Ë¤Ï¤Ê¤ê¤¨¤Ê¤«¤Ã¤¿¤í¤¦¡£
¸å¼Ô¤ÎÍýͳ¤Ï¡¢ SunOS NIS v2 ¤Î¼ÂÁõ¤¬¥Þ¥Ã¥×¤Î¥Ç¡¼¥¿¡¼¥Ù¡¼¥¹¤Ë¥ª¥ê¥¸¥Ê¥ë¤Î
ndbm ¥Ñ¥Ã¥±¡¼¥¸¤òÍѤ¤¤Æ¤¤¤ë¤Î¤ËÂФ·¡¢Â¾¤Î¼ÂÁõ¤Ç¤Ï GNU DBM ¤ä Berkeley DB
¤òÍѤ¤¤Æ¤¤¤ë¤«¤é¤Ç¤¢¤ë¡£¤³¤ì¤é¤Î¥Ñ¥Ã¥±¡¼¥¸¤Ï¤Þ¤Ã¤¿¤¯°Û¤Ê¤Ã¤¿¥Õ¥¡¥¤¥ë
¥Õ¥©¡¼¥Þ¥Ã¥È¤òÍѤ¤¤Æ¤¤¤ë¾å¡¢ ndbm ¤È gdbm ¤Ç¤Ï¥Ð¥¤¥È¥ª¡¼¥À¡¼¥ó¤Î°ã¤¤¤ò
¸­¤¯°·¤¦¤³¤È¤¬¤Ç¤­¤Ê¤¤¡£¤·¤¿¤¬¤Ã¤Æ big endian ¤Ê¥·¥¹¥Æ¥à¤ÇÀ¸À®¤µ¤ì¤¿
gdbm ¤ä ndbm ¤Î¥Ç¡¼¥¿¡¼¥Ù¡¼¥¹¤Ï¡¢ little endian ¤Ê¥·¥¹¥Æ¥à¤Ç¤ÏÆɤळ¤È¤¬
¤Ç¤­¤Ê¤¤¤Î¤Ç¤¢¤ë¡£ FreeBSD ¤Î
.B ypxfrd
¥×¥í¥È¥³¥ë¤Ï¡¢¥Þ¥¹¥¿¡¼¤È¥¹¥ì¡¼¥Ö¤ÎξÊý¤¬Æ±¤¸¥Ç¡¼¥¿¡¼¥Ù¡¼¥¹¥Ñ¥Ã¥±¡¼¥¸¤ò
»È¤Ã¤Æ¤¤¤ë¤«¤É¤¦¤«¤ò¡¢¤Þ¤¿É¬Íפ˱þ¤¸¤Æ¡¢Î¾¥·¥¹¥Æ¥à¤Ç¤Î¥Ð¥¤¥È¥ª¡¼¥À¡¼¤¬Åù¤·¤¤¤«
¤É¤¦¤«¤ò¥Á¥§¥Ã¥¯¤¹¤ë¡£
.LP
.\"O .SH AUTHOR
.SH Ãø¼Ô
.\"O ypxfrd protocol and FreeBSD Implementation: Bill Paul <wpaul@ctr.columbia.edu>
.\"O .br
.\"O Linux Implementation: Thorsten Kukuk <kukuk@suse.de>
ypxfrd ¥×¥í¥È¥³¥ë¤È FreeBSD ¤Ø¤Î¼ÂÁõ: Bill Paul <wpaul@ctr.columbia.edu>
.br
Linux ¤Ø¤Î¼ÂÁõ: Thorsten Kukuk <kukuk@suse.de>