Import translated manuals from JM CVS Repository.

[linuxjm/jm.git] / manual / nfs-utils / draft / man8 / statd.8

.\"
.\" statd(8)
.\"
.\" Copyright (C) 1999 Olaf Kirch <okir@monad.swb.de>
.\" Modified by Jeffrey A. Uphoff, 1999, 2002.
.\" Modified by Lon Hohberger, 2000.
.\" Modified by Paul Clements, 2004.
.\"
.\" Japanese Version Copyright (c) 2002 NAKANO Takeo all rights reserved.
.\" Translated Sun 29 Sep 2002 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
.\" Updated & Modified Wed 29 Mar 2006 by Yuichi SATO <ysato444@yahoo.co.jp>
.\"
.TH rpc.statd 8 "31 Aug 2004"
.\"O .SH NAME
.\"O rpc.statd \- NSM status monitor
.SH ̾Á°
rpc.statd \- NSM ¥¹¥Æ¡¼¥¿¥¹¥â¥Ë¥¿
.\"O .SH SYNOPSIS
.SH ½ñ¼°
.B "/sbin/rpc.statd [-F] [-d] [-?] [-n " name "] [-o " port "] [-p " port "] [-H " prog "] [-V]"
.\"O .SH DESCRIPTION
.SH ÀâÌÀ
.\"O The
.\"O .B rpc.statd
.\"O server implements the NSM (Network Status Monitor) RPC protocol.
.\"O This service is somewhat misnomed, since it doesn't actually provide
.\"O active monitoring as one might suspect; instead, NSM implements a
.\"O reboot notification service. It is used by the NFS file locking service,
.\"O .BR rpc.lockd ,
.\"O to implement lock recovery when the NFS server machine crashes and
.\"O reboots.
.\"nakano misnomed ¤Ï misnamed ¤«¤Ê
.B rpc.statd
¥µ¡¼¥Ð¤Ï NSM (Network Status Monitor) RPC ¥×¥í¥È¥³¥ë¤ò¼ÂÁõ¤·¤¿¤â¤Î¤Ç¤¢¤ë¡£
¤³¤Î¥µ¡¼¥Ó¥¹¤Ï¾¯¡¹Ì¾Á°¤¬Å¬ÀڤǤϤʤ¯¡¢
ͽÁÛ¤µ¤ì¤ë¤è¤¦¤Ê¥¢¥¯¥Æ¥£¥Ö¤Ê¥â¥Ë¥¿¥ê¥ó¥°¤ò¼ÂºÝ¤Ë¹Ô¤¦¤ï¤±¤Ç¤Ï¤Ê¤¤¡£
¼ÂºÝ¤Ë¤Ï NSM ¤Ï¥ê¥Ö¡¼¥ÈÄÌÃÎ¥µ¡¼¥Ó¥¹¤ò¼ÂÁõ¤·¤¿¤â¤Î¤Ê¤Î¤Ç¤¢¤ë¡£
.B rpc.statd
¤Ï NFS ¥Õ¥¡¥¤¥ë¥í¥Ã¥¯¥µ¡¼¥Ó¥¹
.BR rpc.lockd
¤¬ÍøÍѤ¹¤ë¤â¤Î¤Ç¡¢
NFS ¥µ¡¼¥Ð¥Þ¥·¥ó¤¬¥¯¥é¥Ã¥·¥å¤·¤ÆÉüµ¢¤·¤¿¤È¤­¤Ë¡¢
¥í¥Ã¥¯¤ò²óÉü¤¹¤ë¤¿¤á¤ËÍѤ¤¤é¤ì¤ë¡£
.\"O .SS Operation
.SS Æ°ºî
.\"O For each NFS client or server machine to be monitored,
.\"O .B rpc.statd
.\"O creates a file in
.\"O .BR /var/lib/nfs/sm .
.\"O When starting, it iterates through these files and notifies the
.\"O peer
.\"O .B rpc.statd
.\"O on those machines.
¥â¥Ë¥¿¤ÎÂоݤȤʤë
NFS ¤Î¥¯¥é¥¤¥¢¥ó¥È¤È¥µ¡¼¥Ð¤Î¥Þ¥·¥ó¤½¤ì¤¾¤ì¤ËÂФ·¡¢
.B rpc.statd
¤Ï
.B /var/lib/nfs/sm
¤Ë¥Õ¥¡¥¤¥ë¤òºî¤ë¡£
µ¯Æ°¤¹¤ë¤È¤­¡¢
.B rpc.statd
¤Ï¤³¤ì¤é¤Î¥Õ¥¡¥¤¥ë¤ò½ç¼¡Ä´¤Ù¡¢
¤½¤ì¤éÀܳÀè¤Î¥Þ¥·¥ó¤Î
.B rpc.statd
¤ËÄÌÃΤ¹¤ë¡£
.\"O .SH OPTIONS
.SH ¥ª¥×¥·¥ç¥ó
.TP
.B -F
.\"O By default,
.\"O .B rpc.statd
.\"O forks and puts itself in the background when started. The
.\"O .B -F
.\"O argument tells it to remain in the foreground. This option is
.\"O mainly for debugging purposes.
¥Ç¥Õ¥©¥ë¥È¤Ç¤Ï
.B rpc.statd
¤Ï¥Õ¥©¡¼¥¯¤·¤Æ¥Ð¥Ã¥¯¥°¥é¥¦¥ó¥É¤Ë°ÜÆ°¤·¤Æ¤«¤éÆ°ºî¤ò»Ï¤á¤ë¡£
.B -F
¥ª¥×¥·¥ç¥ó¤Ï¡¢
.B rpc.statd
¤Ë¥Õ¥©¥¢¥°¥é¥¦¥ó¥É¤Ëα¤Þ¤ë¤è¤¦ÅÁ¤¨¤ë¡£
¤³¤Î¥ª¥×¥·¥ç¥ó¤Ï¼ç¤Ë¥Ç¥Ð¥Ã¥°¤Î¤¿¤á¤Î¤â¤Î¤Ç¤¢¤ë¡£
.TP
.B -d
.\"O By default,
.\"O .B rpc.statd
.\"O sends logging messages via
.\"O .BR syslog (3)
.\"O to system log.  The
.\"O .B -d
.\"O argument forces it to log verbose output to
.\"O .B stderr
.\"O instead. This option is mainly for debugging purposes, and may only
.\"O be used in conjunction with the
.\"O .B -F
.\"O parameter.
¥Ç¥Õ¥©¥ë¥È¤Ç¤Ï
.B rpc.statd
¤Ï¥í¥°¥á¥Ã¥»¡¼¥¸¤ò
.BR syslog (3)
¤òÄ̤·¤Æ¥·¥¹¥Æ¥à¥í¥°¤ËÁ÷¤ë¡£
.B -d
¥ª¥×¥·¥ç¥ó¤Ï¡¢¤³¤Î¥í¥°½ÐÎϤò¾ÜºÙ¤Ë¤·¡¢
.B stderr
¤ËÁ÷¤ë¤è¤¦»Ø¼¨¤¹¤ë¡£
¤³¤Î¥ª¥×¥·¥ç¥ó¤Ï¼ç¤Ë¥Ç¥Ð¥Ã¥°¤Î¤¿¤á¤Î¤â¤Î¤Ç¤¢¤ê¡¢
¤ª¤½¤é¤¯
.B -F
¤ÈƱ»þ¤Ë¤Î¤ß»È¤¦¤³¤È¤Ë¤Ê¤ë¤À¤í¤¦¡£
.TP
.BI "\-n," "" " \-\-name " name 
.\"O specify a name for
.\"O .B rpc.statd
.\"O to use as the local hostname. By default,
.\"O .BR rpc.statd
.\"O will call
.\"O .BR gethostname (2)
.\"O to get the local hostname. Specifying
.\"O a local hostname may be useful for machines with more than one
.\"O interfaces.
.B rpc.statd
¤¬¥í¡¼¥«¥ë¤Î¥Û¥¹¥È̾¤È¤·¤ÆÍѤ¤¤ë̾Á°¤ò»ØÄꤹ¤ë¡£
¥Ç¥Õ¥©¥ë¥È¤Ç¤Ï
.B rpc.statd
¤Ï
.BR gethostname (2)
¤ò¸Æ¤ó¤Ç¥í¡¼¥«¥ë¤Î¥Û¥¹¥È̾¤ò¼èÆÀ¤¹¤ë¡£
¥¤¥ó¥¿¡¼¥Õ¥§¡¼¥¹¤¬ 2 ¤Ä°Ê¾å¤¢¤ë¥Þ¥·¥ó¤Ç¤Ï¡¢
¥í¡¼¥«¥ë¤Î¥Û¥¹¥È̾¤ò»ØÄꤹ¤ë¤ÈÊØÍø¤«¤â¤·¤ì¤Ê¤¤¡£
.TP
.BI "\-o," "" " \-\-outgoing\-port "  port
.\"O specify a port for
.\"O .B rpc.statd
.\"O to send outgoing status requests from.  By default,
.\"O .BR rpc.statd
.\"O will ask
.\"O .BR portmap (8)
.\"O to assign it a port number.  As of this writing, there is not
.\"O a standard port number that
.\"O .BR portmap
.\"O always or usually assigns.  Specifying
.\"O a port may be useful when implementing a firewall.
.B rpc.statd
¤¬³°¸þ¤­¤Î¥¹¥Æ¡¼¥¿¥¹¥ê¥¯¥¨¥¹¥È¤òÁ÷¿®¤¹¤ë¤È¤­¤Ë»È¤¦¥Ý¡¼¥È¤ò»ØÄꤹ¤ë¡£
¥Ç¥Õ¥©¥ë¥È¤Ç¤Ï
.B rpc.statd
¤Ï
.BR portmap (8)
¤Ë¥Ý¡¼¥ÈÈÖ¹æ¤ò³ä¤êÅö¤Æ¤Æ¤¯¤ì¤ë¤è¤¦Í׵᤹¤ë¡£
¤³¤Î¥Þ¥Ë¥å¥¢¥ë¤Î¼¹É®»þÅÀ¤Ç¤Ï¡¢
.B portmap
¤¬¾ï¤Ë³ä¤êÅö¤Æ¤ËÍѤ¤¤ë¤è¤¦¤Ê¡¢É¸½àŪ¤Ê¥Ý¡¼¥ÈÈÖ¹æ¤Ï¤Ê¤¤¡£
¥Ý¡¼¥È¤Î»ØÄê¤Ï¡¢¥Õ¥¡¥¤¥¢¥¦¥©¡¼¥ë¤ò¼ÂÁõ¤¹¤ë¤È¤­¤ËÊØÍø¤À¤í¤¦¡£
.TP
.BI "\-p," "" " \-\-port " port
.\"O specify a port for
.\"O .B rpc.statd
.\"O to listen on.  By default,
.\"O .BR rpc.statd
.\"O will ask
.\"O .BR portmap (8)
.\"O to assign it a port number.  As of this writing, there is not
.\"O a standard port number that
.\"O .BR portmap
.\"O always or usually assigns.  Specifying
.\"O a port may be useful when implementing a firewall.
.B rpc.statd
¤¬ listen ¤¹¤ë¥Ý¡¼¥È¤ò»ØÄꤹ¤ë¡£
¥Ç¥Õ¥©¥ë¥È¤Ç¤Ï
.B rpc.statd
¤Ï
.BR portmap (8)
¤Ë¥Ý¡¼¥ÈÈÖ¹æ¤ò³ä¤êÅö¤Æ¤Æ¤¯¤ì¤ë¤è¤¦Í׵᤹¤ë¡£
¤³¤Î¥Þ¥Ë¥å¥¢¥ë¤Î¼¹É®»þÅÀ¤Ç¤Ï¡¢
.B portmap
¤¬¾ï¤Ë³ä¤êÅö¤Æ¤ËÍѤ¤¤ë¤è¤¦¤Ê¡¢É¸½àŪ¤Ê¥Ý¡¼¥ÈÈÖ¹æ¤Ï¤Ê¤¤¡£
¥Ý¡¼¥È¤Î»ØÄê¤Ï¡¢¥Õ¥¡¥¤¥¢¥¦¥©¡¼¥ë¤ò¼ÂÁõ¤¹¤ë¤È¤­¤ËÊØÍø¤À¤í¤¦¡£
.TP
.BI "\-P," "" " \-\-state\-directory\-path "  directory
.\"O specify a directory in which to place statd state information.
.\"O If this option is not specified the default of 
.\"O .BR /var/lib/nfs
.\"O is used.
statd ¤Î¾õÂÖ¾ðÊó¤òÃÖ¤¯¥Ç¥£¥ì¥¯¥È¥ê¤ò»ØÄꤹ¤ë¡£
¤³¤Î¥ª¥×¥·¥ç¥ó¤¬»ØÄꤵ¤ì¤Ê¤¤¾ì¹ç¡¢¥Ç¥Õ¥©¥ë¥È¤Î
.B /var/lib/nfs
¤¬»ÈÍѤµ¤ì¤ë¡£
.TP
.B -N
.\"O Causes statd to run in the notify-only mode. When started in this mode, the
.\"O statd program will check its state directory, send notifications to any
.\"O monitored nodes, and exit once the notifications have been sent. This mode is
.\"O used to enable Highly Available NFS implementations (i.e. HA-NFS).
statd ¤òÄÌÃÎÀìÍѥ⡼¥É¤Ç¼Â¹Ô¤µ¤»¤ë¡£
¤³¤Î¥â¡¼¥É¤Çµ¯Æ°¤¹¤ë¤È¡¢
statd ¥×¥í¥°¥é¥à¤Ï¾õÂÖ¾ðÊó¤òÃÖ¤¯¥Ç¥£¥ì¥¯¥È¥ê¤ò¥Á¥§¥Ã¥¯¤·¤Æ¡¢
Á´¤Æ¤Î¥â¥Ë¥¿ÂоݥΡ¼¥É¤ËÄÌÃΤòÁ÷¿®¤·¡¢ÄÌÃΤÎÁ÷¿®¤¬´°Î»¤·¤¿¤é½ªÎ»¤¹¤ë¡£
¤³¤Î¥â¡¼¥É¤Ï¹â²ÄÍÑÀ­ (Highly Available) NFS ¼ÂÁõ (¤Ä¤Þ¤ê HA-NFS) ¤ò
Í­¸ú¤Ë¤¹¤ë¤¿¤á¤Ë»ÈÍѤµ¤ì¤ë¡£
.TP
.BI "\-H, " "" " \-\-ha-callout " prog
.\"O Specify a high availability callout program, which will receive callouts
.\"O for all client monitor and unmonitor requests. This allows
.\"O .B rpc.statd
.\"O to be used in a High Availability NFS (HA-NFS) environment. The
.\"O program will be run with 3 arguments:  The first is either
.\"O .B add-client
.\"O or
.\"O .B del-client
.\"O depending on the reason for the callout.
¹â²ÄÍÑÀ­¥³¡¼¥ë¥¢¥¦¥È¥×¥í¥°¥é¥à¤ò»ØÄꤹ¤ë¡£
¤³¤Î¥×¥í¥°¥é¥à¤ÏÁ´¤Æ¤Î¥¯¥é¥¤¥¢¥ó¥È¥â¥Ë¥¿¤È¥â¥Ë¥¿½ªÎ»¥ê¥¯¥¨¥¹¥È¤ËÂФ¹¤ë
¥³¡¼¥ë¥¢¥¦¥È¤ò¼õ¤±¼è¤ë¡£
¤³¤ì¤Ë¤è¤ê
.B rpc.statd
¤ò¹â²ÄÍÑÀ­ NFS (HA-NFS) ´Ä¶­¤Ç»ÈÍѤ¹¤ë¤³¤È¤¬¤Ç¤­¤ë¡£
¤³¤Î¥×¥í¥°¥é¥à¤Ï 3 ¤Ä¤Î°ú¤­¿ô¤òÉÕ¤±¤Æ¼Â¹Ô¤µ¤ì¤ë¡£
1 ¤ÄÌܤϡ¢
.B add-client
¤Þ¤¿¤Ï
.B del-client
¤Ç¤¢¤ê¡¢¥³¡¼¥ë¥¢¥¦¥È¤ÎÍýͳ¤Ë°Í¸¤¹¤ë¡£
.\"O The second will be the name of the client.
2 ¤ÄÌܤϥ¯¥é¥¤¥¢¥ó¥È¤Î̾Á°¤Ç¤¢¤ë¡£
.\"O The third will be the name of the server as known to the client.
3 ¤ÄÌܤϥ¯¥é¥¤¥¢¥ó¥È¤ËÃΤ餻¤ë¥µ¡¼¥Ð¤Î̾Á°¤Ç¤¢¤ë¡£
.TP
.B -?
.\"O Causes
.\"O .B rpc.statd
.\"O to print out command-line help and exit.
¥³¥Þ¥ó¥É¥é¥¤¥ó¥Ø¥ë¥×¤òɽ¼¨¤·¤Æ½ªÎ»¤¹¤ë¡£
.TP
.B -V
.\"O Causes
.\"O .B rpc.statd
.\"O to print out version information and exit.
¥Ð¡¼¥¸¥ç¥ó¾ðÊó¤òɽ¼¨¤·¤Æ½ªÎ»¤¹¤ë¡£
.\"O 
.\"O 
.\"O 
.\"O .SH TCP_WRAPPERS SUPPORT
.SH TCP_WRAPPERS ¤Î¥µ¥Ý¡¼¥È
.\"O This
.\"O .B rpc.statd
.\"O version is protected by the
.\"O .B tcp_wrapper
.\"O library. You have to give the clients access to
.\"O .B rpc.statd
.\"O if they should be allowed to use it. To allow connects from clients of
.\"O the .bar.com domain you could use the following line in /etc/hosts.allow:
¤³¤ÎÈǤÎ
.B rpc.statd
¤Ï
.B tcp_wrapper
¥é¥¤¥Ö¥é¥ê¤Ë¤è¤Ã¤ÆÊݸ¤ì¤Æ¤¤¤ë¡£
¥¯¥é¥¤¥¢¥ó¥È¤«¤é¤Î
.B rpc.statd
¤ËÂФ¹¤ë¥¢¥¯¥»¥¹¤¬É¬Íפʤ顢
µö²Ä¤¹¤ë¤è¤¦ÀßÄꤷ¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£.bar.com ¥É¥á¥¤¥ó¤Î
¥¯¥é¥¤¥¢¥ó¥È¤«¤é¤Î¥¢¥¯¥»¥¹¤òµö²Ä¤¹¤ë¤Ë¤Ï¡¢
/etc/hosts.allow ¤Ë¼¡¤Î¤è¤¦¤Ë½ñ¤±¤Ð¤è¤¤¡£
.\"O 
.sp
statd: .bar.com
.\"O 
.sp
.\"O You have to use the daemon name 
.\"O .B statd
.\"O for the daemon name (even if the binary has a different name).
¥Ç¡¼¥â¥ó¤Î̾Á°¤Ï (¥Ð¥¤¥Ê¥ê¤Î¥Õ¥¡¥¤¥ë̾¤¬°Û¤Ê¤Ã¤Æ¤¤¤Æ¤â)
.B statd
¤È¤·¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£

.\"O For further information please have a look at the
.\"O .BR tcpd (8)
.\"O and
.\"O .BR hosts_access (5)
.\"O manual pages.
¾ÜºÙ¤Ï man ¥Ú¡¼¥¸
.BR tcpd (8)
¤È
.BR hosts_access (5)
¤ò¸«¤Æ¤Û¤·¤¤¡£
.\"O 
.\"O .SH SIGNALS
.SH ¥·¥°¥Ê¥ë
.\"O .BR SIGUSR1
.\"O causes
.\"O .B rpc.statd
.\"O to re-read the notify list from disk
.\"O and send notifications to clients. This can be used in High Availability NFS
.\"O (HA-NFS) environments to notify clients to reacquire file locks upon takeover
.\"O of an NFS export from another server.
.B SIGUSR1
¤òÁ÷¤ë¤È¡¢
.B rpc.statd
¤Ï¥Ç¥£¥¹¥¯¤«¤éÄÌÃΥꥹ¥È¤òÆɤßľ¤·¤Æ¡¢¥¯¥é¥¤¥¢¥ó¥È¤ËÄÌÃΤòÁ÷¤ë¡£
¤³¤Î¥·¥°¥Ê¥ë¤Ï¹â²ÄÍÑÀ­ NFS (HA-NFS) ´Ä¶­¤Ë¤ª¤¤¤Æ¡¢
¾¤Î¥µ¡¼¥Ð¤«¤é NFS ¥¨¥¯¥¹¥Ý¡¼¥È¤Î°ú¤­·Ñ¤®¤ò¹Ô¤¦¤È¤­¤Ë¡¢
¥¯¥é¥¤¥¢¥ó¥È¤ËÄÌÃΤò¹Ô¤Ã¤Æ¥Õ¥¡¥¤¥ë¥í¥Ã¥¯¤òºÆ¼èÆÀ¤¹¤ë¤¿¤á¤Ë»ÈÍѤµ¤ì¤ë¡£
.\"O 
.\"O .SH FILES
.SH ¥Õ¥¡¥¤¥ë
.BR /var/lib/nfs/state
.br
.BR /var/lib/nfs/sm/*
.br
.BR /var/lib/nfs/sm.bak/*
.\"O .SH SEE ALSO
.SH ´ØÏ¢¹àÌÜ
.BR rpc.nfsd(8),
.BR portmap(8)
.\"O .SH AUTHORS
.SH Ãø¼Ô
.br
Jeff Uphoff <juphoff@nrao.edu>
.br
Olaf Kirch <okir@monad.swb.de>
.br
H.J. Lu <hjl@gnu.org>
.br
Lon Hohberger <hohberger@missioncriticallinux.com>
.br
Paul Clements <paul.clements@steeleye.com>