.\" .\" Original manual page is a part of nfs-server package. .\" Following is a exerpt from README of version 2.2beta47. .\" .\" 7. Copyright .\" .\" Much of the code in this package was originally written by .\" Mark Shand, and is placed under the following copyright: .\" .\" This software may be used for any purpose provided .\" the above copyright notice is retained. It is .\" supplied as is, with no warranties expressed or .\" implied. .\" .\" Other code, especially that written by Rick Sladkey and some .\" replacement routines included from the GNU libc, are covered .\" by the GNU General Public License, version 2, or (at your .\" option) any later version. .\" .\" Japanese Version Copyright (c) 1998 NAKANO Takeo all rights reserved. .\" Translated Wed 11 Nov 1998 by NAKANO Takeo .\" Updated & Modified Sun Jan 27 17:30:35 JST 2002 .\" by Yuichi SATO .\" Modified Tue Feb 19 19:06:53 JST 2002 by Yuichi SATO .\" .TH NFSD 8 "11 August 1997" .SH 名前 nfsd \- NFS サービスデーモン .SH 書式 .ad l .B /usr/sbin/rpc.nfsd .B "[\ \-f\ exports-file\ ]" .B "[\ \-d\ facility\ ]" .B "[\ \-P\ port\ ]" .B "[\ \-R\ dirname\ ]" .B "[\ \-Fhlnprstv\ ]" .B "[\ \-\-debug\ facility\ ]" .B "[\ \-\-exports\-file=file\ ]" .B "[\ \-\-foreground\ ]" .B "[\ \-\-help\ ]" .B "[\ \-\-allow\-non\-root\ ]" .B "[\ \-\-re\-export\ ]" .B "[\ \-\-public\-root\ dirname\ ]" .\".B "[\ \-\-synchronous\-writes\ ]" .B "[\ \-\-no\-spoof\-trace\ ]" .B "[\ \-\-port\ port\ ]" .B "[\ \-\-log-transfers\ ]" .B "[\ \-\-version\ ]" .\" TN.B "[ numservers ]" .B "[ numcopies ]" .ad b .SH 説明 .I nfsd プログラムは NFS サービスデーモンであり、クライアントからの ファイルシステム要求を取り扱う。 他のシステムと異なり、この .I nfsd は普通のユーザーレベルプロセスとして動作する。 またこのサーバーは、ファイルシステムの物理的な境界に制限されず、 ファイル階層すべてをマウントさせる点でも、他のシステムとは異なっている。 この実装では、サーバーマシンのファイルシステム階層に対して、 クライアントによる read-only アクセス、read-write アクセスのいずれも 行えるようになっている。 .LP .I mountd プログラムは、補助的な役割をするユーザーレベルの mount デーモンを起動する。 .LP .SS "inetd からの起動" 通常 .I nfsd はシステムのブート時に起動されるが、 .I inetd から起動することもできる。 それには以下の 2 行を .I /etc/inetd.conf に追加する。 .PP .nf .ta +3i nfs/2 dgram rpc/udp wait root /usr/sbin/rpc.nfsd rpc.nfsd nfs/2 stream rpc/tcp wait root /usr/sbin/rpc.nfsd rpc.nfsd .fi .PP .I ientd から起動した場合には、適当な期間に動作要求がないと .I nfsd は終了する。 .SH オプション .TP .BR \-f " または " \-\-exports\-file このオプションはエクスポートファイルを指定する。 エクスポートファイルには、このサーバーがサービスを提供するクライアント と、それぞれのマウントに対して適用されるパラメータがリストされている (exports (5) を見よ)。 デフォルトのエクスポートファイルは .I /etc/exports である。 .TP .BR "\-d facility" " または " "\-\-debug facility" それぞれのトランザクションに対する詳細な内容を標準エラー出力にログ表示する。 \fIfacility\fP に指定できるのは、 .I call (すべてのコールを記録)、 .I auth (クライアントの認証)、 .I fhcache (ファイルハンドルのキャッシュ操作)、 .I rmtab .RI ( /etc/rmtab の操作) である。 デフォルトでは、デーモンがフォアグラウンドで実行されなければ、 ログ出力は syslogd に送られる。 .TP .BR \-F " または " \-\-foreground 通常 .I nfsd は端末から分離 (detach) するが、このオプションが与えられると分離しない。 このとき debug 情報は標準エラー出力に表示される。 .TP .BR \-h " または " \-\-help ヘルプの短い要約を表示する。 .TP .BR \-l " または " \-\-log-transfers NFS サーバーから取り出されたファイル、あるいはサーバへ書き込まれた ファイルをすべてログに書き込もうとする。 これは主として anonymous NFS エクスポートに有用で、 ある種の FTP デーモンによってサポートしている .B xferlog をまねするためのものである。 ファイルが書き込み・取り出しされるたび、 syslog デーモンに一行の情報が送られ、 そこにはクライアントの IP アドレスとファイル名が書き込まれる。 この転送記録のログレベルは .B daemon.info である。 .TP .BR \-n " または " \-\-allow\-non\-root IP の特権ポート以外から来たマウント要求も許可する。 NFS クライアントの古い実装では、この指定が必要な場合がある。 逆に新しい実装には、特権ポートのチェックを信頼しないものがある。 このチェックはホスト単位で外すこともできる。 .I /etc/exports のエクスポートオプションに .I insecure を指定すればよい。 .TP .BR "\-P portnum" " または " "\-\-port portnum" .B nfsd に .B portnum ポートを監視するようにさせる。 デフォルトでは、 .I mountd は .I /etc/services で指定されている nfs/udp ポートを監視する (あるいはこれが指定されていないと 2049 番のポートを監視する)。 .TP .BR \-p " または " \-\-promiscuous サーバを「無制限 (promiscuous)」モードにする。 ネットワーク上のすべてのホストに対してサービスを提供する。 .TP .BR \-r " または " \-\-re\-export インポートしたファイルシステムの再エクスポートを許す。 これにより、マシンは NFS や Novel サーバの中継器となる。 ループバックマウントを再エクスポートするときには特に注意すること。 マウントポイントに再入すると、クライアントファイルシステムのコードと サーバーはデッドロックしてしまう。 .IP (Linux では) 以下も注意しておきたい。 .I nfsd はファイルシステムのメジャーデバイス番号を見て、 それがリモートのボリュームであるかどうかを判別する。 もしメジャー番号が 0 でなければ、 .I nfsd はファイルシステムがローカルなものであると判断する。 しかし、リモートファイル以外にもメジャー番号 0 を利用するものがある。 procfs である。 NFS ファイルシステムを再エクスポートすることにした場合、 ファイルシステムの root をエクスポートした場合には .I /proc も含まれてしまうことに注意すること。 これはセキュリティ上の問題となることがある。 できればこのような状況は避けるべきである。 .\".TP .\".BR \-s " または " \-\-synchronous\-writes .\"NFS プロトコルの仕様では、サーバーに対する全ての書き込み操作は .\"呼び出しが返る前に完了しなければならない。 .\"デフォルトでは .\".I nfsd .\"はこのように動作しない。 .\"このオプションは同期書き込みを有効にする。 .\"-- なぜ、みんなが同期書き込みを無効にしたがるのだろう? .TP .BR \-t " または " \-\-no\-spoof\-trace デフォルトでは、 .I nfsd は権限のないクライアントからの全てのアクセスをログに記録する。 このオプションを使うと、 .I exports ファイルに明示的にリストされている全てのホストについて、 このような成りすまし行為をログに記録しない。 .TP .BR \-R " または " \-\-public\-root ディレクトリを public なファイルハンドルと関連づける。 以下の WebNFS のセクションを参照のこと。 .TP .BR \-v " または " \-\-version プログラムの現在のバージョン番号を表示する。 .TP .BR numcopies これは実験的な機能であり、 .I nfsd のいくつかのインスタンスを並行動作させるものである。 .B numcopies に 1 以上の値を与えると、 .I nfsd は指定した値の回数だけ fork する。 しかし、サーバーはファイルハンドルキャッシュを共有しないので、 ある種のファイル操作は不可能となる。 .IP このため、 .I nfsd はこのオプションと共に起動されると、すべての書き込み操作を拒否する。 この制限は大きなものではあるが、 それでも公開 FTP 領域や Usenet News のスプールをエクスポートする場合には、 この機能は依然有用であろう。 .SS "WebNFS のサポート" WebNFS は Sun によって開発された通常の NFS プロトコルを拡張したもので、 インターネットを通してのファイル取得に特に適している。 また、特に Web ブラウザを通しての利用を意図して作成された。 .P このコンセプトの中心にあるのは、 「public なファイルハンドル」と呼ばれるものである。 これは特殊な NFS ファイルハンドルで、 これを用いると NFS クライアント (つまりブラウザ) は MOUNT プロトコルを利用せずにファイルを取得できるようになる。 このファイルハンドルはサーバーマシンのディレクトリに 関連づけられていなければならず、 またこのファイルハンドルによるファイル名の評価は、 そのディレクトリからの相対パスとして行われることになる。 これが .I "public root ディレクトリ" であり、 .B \-\-public\-root オプションを用いて指定できる。 例えば Web サーバなら、ドキュメントの root (例えば \fB/home/httpd/\fP) を この public root にすると良いだろう。 URL .B nfs://foo.bar.edu/zappa.html を要求した Web ブラウザは、ファイル .B /home/httpd/zappa.html を与えられることになる。 メンテナンスを容易にするため、public root ディレクトリの指定は、 .I exports で特殊なエントリを用いることによっても可能になっている (詳細は .IR exports (5) を参照のこと)。 .P public root を指定しても、これが自動的にエクスポートされるわけでは\fIない\fP。 このディレクトリを実際にアクセス可能にするためには、依然 .B /etc/exports で明示する必要がある。 WebNFS クライアントにデータをエクスポートする際に有用なオプションのセットは、 .B ro,all_squash,insecure である。 これらのフラグの詳細については .BR exports (5) を参照してほしい。 .P WebNFS クライアントは、 public root ディレクトリ下に置かれていないファイルに関しても、 それが自分むけにエクスポートされていれば アクセスできてしまうことにも注意してほしい。 特に .B /home/ftp を Web サーバのホームディレクトリと共に外界にエクスポートしてしまうと、 Web クライアントは FTP ファイルに .B nfs://foo.bar.edu/../ftp/README のようにアクセスできてしまう。 もちろんエクスポートされていないクライアントに関しては、 これはあてはまらない。 .SH シグナル .I nfsd は以下のシグナルを認識する: .TP .I SIGHUP このシグナルを受けると、 .I nfsd は export ファイルを再読み込みし、 ファイルハンドルのキャッシュをフラッシュする。 public root が指定されていると、このシグナルによって public ディレクトリ名に関連づけられたファイルハンドルが再生成される (リムーバブルなファイルシステムをエクスポートする場合に便利)。 .TP .I SIGUSR1 デバッグオプションを指定して .I nfsd 起動した場合、このシグナルを与えると デバッグ情報の生成をオン・オフできる。 .TP .I SIGIOT \-DCALL_PROFILING オプションを指定してコンパイルした場合、 SIGIOT を .I nfsd に送ると一回の NFS 操作あたりの平均実行時間が .I /tmp/nfsd.profile にダンプされる。 .SH バグ .I nfsd は、ディレクトリのファイル名が問い合わされたときに .B index.html ファイルを提供する機能をサポートしていない。 これは RFC の要求にはないので、実際にはバグではなく機能の欠如である。 .P .B \-\-log\-transfers オプションは必ずしも正しいログを残さない。 なぜなら UNIX ファイルシステムの .BR open() " および " close() コールに対応するものが NFS プロトコルには存在しないからである。 代わりに .I nfsd は、READ または WRITE 要求のオフセット 0 に遭遇するたびに転送記録を書き出す。 .SH 関連項目 exports(5), mountd(8), ugidd(8C) .SH 著者 Mark Shand がオリジナルの unfsd を書いた。 Don Becker は unfsd を拡張し、認証機能と read-write 機能を サポートして、これを hnfs と名づけた。 Rick Sladkey はホストマッチ、showmount \-e のサポート、 mountd の認証、inetd のサポート、移植性の向上や設定に 必要なコードなどを追加した。 Olaf Kirch は一つ二つのセキュリティホールと、その他のバグを 修正し、uid マッピングとその他いくつかの機能を追加した。