diff options
| author | Jun Kuriyama <kuriyama@FreeBSD.org> | 1998-09-26 06:20:22 +0000 |
|---|---|---|
| committer | Jun Kuriyama <kuriyama@FreeBSD.org> | 1998-09-26 06:20:22 +0000 |
| commit | 88a4de0fb8b2f6a1345a29a10a324176728b7517 (patch) | |
| tree | fed6911082b427ce0a2c73c1ab16c30d1c2a57f8 /ja/man/man8 | |
| parent | 1fa6dd730fa26394321c52a534c2e0ceb2db3bae (diff) | |
Notes
Diffstat (limited to 'ja/man/man8')
163 files changed, 3935 insertions, 4158 deletions
diff --git a/ja/man/man8/MAKEDEV.8 b/ja/man/man8/MAKEDEV.8 index a56f4fc17e..ebdade0b5b 100644 --- a/ja/man/man8/MAKEDEV.8 +++ b/ja/man/man8/MAKEDEV.8 @@ -30,8 +30,8 @@ .\" SUCH DAMAGE. .\" .\" @(#)MAKEDEV.8 8.1 (Berkeley) 6/5/93 +.\" %Id: MAKEDEV.8,v 1.10 1997/08/11 01:25:06 steve Exp % .\" jpman %Id: MAKEDEV.8,v 1.3 1997/07/22 09:19:04 mutoh Stab % -.\" %Id: MAKEDEV.8,v 1.5.2.2 1998/03/07 10:04:22 jkh Exp % .\" .Dd June 5, 1993 .Dt MAKEDEV 8 i386 diff --git a/ja/man/man8/ac.8 b/ja/man/man8/ac.8 index ffbc2b4b67..413f5e1d76 100644 --- a/ja/man/man8/ac.8 +++ b/ja/man/man8/ac.8 @@ -28,7 +28,7 @@ .\" (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: ac.8,v 1.6.2.2 1997/09/02 06:28:56 charnier Exp % +.\" %Id: ac.8,v 1.10 1997/09/01 06:11:40 charnier Exp % .\" jpman %Id: ac.8,v 1.3 1997/07/22 16:35:12 horikawa Stab % .\" .Dd March 15, 1994 diff --git a/ja/man/man8/adding_user.8 b/ja/man/man8/adding_user.8 index f576d3b8b2..79c684d361 100644 --- a/ja/man/man8/adding_user.8 +++ b/ja/man/man8/adding_user.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)adduser.8 8.1 (Berkeley) 6/5/93 -.\" %Id: adding_user.8,v 1.1.6.1 1997/03/07 04:18:26 mpp Exp % +.\" %Id: adding_user.8,v 1.2 1997/03/07 03:28:19 jmg Exp % .\" jpman %Id: adding_user.8,v 1.3 1997/07/22 16:44:29 horikawa Stab % .\" .Dd June 5, 1993 diff --git a/ja/man/man8/adduser.8 b/ja/man/man8/adduser.8 index c58f38965d..ac78285d8c 100644 --- a/ja/man/man8/adduser.8 +++ b/ja/man/man8/adduser.8 @@ -22,7 +22,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: adduser.8,v 1.12.2.8 1998/03/18 16:14:48 hoek Exp % +.\" %Id: adduser.8,v 1.26 1998/08/17 18:50:29 wosch Exp % .\" jpman %Id: adduser.8,v 1.4 1997/08/07 17:53:51 ken Stab % .\" .Dd January 9, 1995 @@ -33,14 +33,6 @@ .Nd 新しいユーザを加えるためのコマンド .Sh 解説 .Nm adduser -.Oo -.Fl batch Ar username -.Op Ar group Ns , Ns Op Ar group,... -.Op Ar class -.Op Ar fullname -.Op Ar password -.Oc -.br .Op Fl check_only .br .Op Fl class Ar login_class @@ -78,7 +70,7 @@ passwd/group の登録を行い、 .Sh 制限事項 .Bl -tag -width Ds -compact .It Sy username -ログイン名は、小文字もしくは数字だけからなる最大 8 文字の文字列でな +ログイン名は、小文字もしくは数字だけからなる最大 16 文字の文字列でな ければなりません ( .Xr setlogin 2 のバグの章を参照してください)。この制限の理由は、 ``歴史的な'' 物で @@ -140,12 +132,6 @@ uid/gid を別に設けて、ユーザを個別にその新しいグループに入れることで、 .El .Sh オプション .Bl -tag -width Ds -.It Sy -batch username [group[,group]...] [class] [fullname] [password] -バッチモードです。 -列挙されるグループは、ユーザがメンバとなる二番目のグループであり、 -デフォルトのログイングループ以外のものを書きます。 -ヌル文字列の引数を埋め草として使用することができ、 -この場合デフォルト値の動作となります。 .It Sy -check_only /etc/passwd, /etc/group, /etc/shells をチェックし、終了します。 .It Sy -class Ar login_class @@ -223,35 +209,6 @@ partition) を指定します。 .Pa /etc/adduser.message を見てください。 .El -.Sh 使用例 -.Pp -$ adduser -.Pp -adduser を会話モードで動かします。 -.Pp -$ adduser -batch baerenkl guest,staff,baer '' 'Teddy II' qwerty7 -.Pp -ユーザ名 'baerenkl' ログイングループ名 'baerenkl' のユーザを作成 -します。このユーザは、 guest, staff, baer グループにも入っています。 -デフォルトのログインクラスを用います。 -このユーザーの本名 (氏名) は 'Teddy II' であり、パスワードは 'qwerty7' -です (が、こんなパスワードを使ってはいけません !)。 -.Ev HOME -ディレクトリは、 -.Pa /home/baerenkl -に作られ、全てのファイルやディレクトリが、 -.Pa /usr/share/skel -から、 -.Pa /home/baerenkl -にコピーされます。ユーザ 'baerenklau' に対して、歓迎メッセージが送ら -れます。 -.Pp -$ adduser -uid 5000 -group guest -message no -batch vehlefan -.Pp -ユーザ 'vehlefan' を作成します。ログイングループは guest で ユーザ -id は 5000 以上で利用可能な最小のもの (例えば、5007など) となります。 -他に入っているグループはなく、本名もパスワードもありません。歓迎 -メッセージも送られません。 .Sh 関連ファイル .Bl -tag -width /etc/master.passwdxx -compact .It Pa /etc/master.passwd @@ -283,6 +240,7 @@ adduser の ログ記録ファイル .Xr passwd 5 , .Xr shells 5 , .Xr addgroup 8 , +.Xr pw 8 , .Xr pwd_mkdb 8 , .Xr rmgroup 8 , .Xr rmuser 8 , diff --git a/ja/man/man8/adjkerntz.8 b/ja/man/man8/adjkerntz.8 index fb3644f3e7..57a13a6cbc 100644 --- a/ja/man/man8/adjkerntz.8 +++ b/ja/man/man8/adjkerntz.8 @@ -22,7 +22,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: adjkerntz.8,v 1.10.2.2 1998/07/17 20:12:55 jkh Exp % +.\" %Id: adjkerntz.8,v 1.16 1998/06/04 06:35:11 charnier Exp % .\" jpman %Id: adjkerntz.8,v 1.4 1997/07/26 21:28:35 horikawa Stab % .\" .Dd April 4, 1996 diff --git a/ja/man/man8/amd.8 b/ja/man/man8/amd.8 index 65e9c66d4f..9b28dd3f32 100644 --- a/ja/man/man8/amd.8 +++ b/ja/man/man8/amd.8 @@ -37,7 +37,7 @@ .\" .\" @(#)amd.8 5.10 (Berkeley) 4/19/94 .\" -.\" %Id: amd.8,v 1.2.2.3 1998/07/18 11:08:35 jkh Exp % +.\" %Id: amd.8,v 1.7 1998/03/23 08:19:30 charnier Exp % .\" .\" jpman %Id: amd.8,v 1.2 1997/04/15 00:24:08 mutoh Stab % .\" diff --git a/ja/man/man8/amq.8 b/ja/man/man8/amq.8 index 0a986da50d..cd05d08cd3 100644 --- a/ja/man/man8/amq.8 +++ b/ja/man/man8/amq.8 @@ -37,7 +37,7 @@ .\" .\" @(#)amq.8 8.3 (Berkeley) 4/18/94 .\" -.\" %Id: amq.8,v 1.3.2.1 1998/07/18 11:08:42 jkh Exp % +.\" %Id: amq.8,v 1.6 1998/03/23 08:19:53 charnier Exp % .\" .\" jpman %Id: amq.8,v 1.3 1997/08/11 14:26:54 horikawa Stab % .\" diff --git a/ja/man/man8/apm.8 b/ja/man/man8/apm.8 index c691043a89..b5278aea36 100644 --- a/ja/man/man8/apm.8 +++ b/ja/man/man8/apm.8 @@ -1,6 +1,6 @@ .\" LP (Laptop Package) .\" -.\" Copyright (c) 1994 by HOSOKAWA, Tatsumi <hosokawa@mt.cs.keio.ac.jp> +.\" Copyright (c) 1994 by Tatsumi Hosokawa <hosokawa@jp.FreeBSD.org> .\" .\" This software may be used, modified, copied, and distributed, in .\" both source and binary form provided that the above copyright and @@ -17,7 +17,7 @@ .Nd APM BIOS の制御を行い、その情報を表示する .Sh 書式 .Nm apm -.Op Fl ablsz +.Op Fl ablstz .Op Fl d Ar 1|0 .Pp .Nm zzz @@ -37,6 +37,8 @@ オプションが与えられなかった場合は、 .Nm apm は、現在の APM の状態や情報を冗長モードで表示します。 +複数の表示オプションが指定された場合、 +ここに示す順番で値を 1 行に 1 つずつ表示します。 .Bl -tag -width indent .It Fl a 現在の AC 電源の状態を整数値で表示します。 @@ -74,6 +76,9 @@ APM サポート状態を整数値で表示します。0, 1 という値はそれぞれ、 .Dq 利用可能 (enabled) 状態 をあらわします。 +.It Fl t +残りのバッテリ時間を予測して、秒単位で表示します。 +分からない場合には -1 を表示します。 .It Fl z システムをサスペンドします。これは、 .Nm zzz @@ -102,4 +107,4 @@ APM サポート状態を整数値で表示します。0, 1 という値はそれぞれ、 .Xr apm 4 , .Xr apmconf 8 .Sh 作者 -細川 達己<hosokawa@mt.cs.keio.ac.jp> ( 慶応大学, 日本 ) +.An Tatsumi Hosokawa Aq hosokawa@jp.FreeBSD.org diff --git a/ja/man/man8/atrun.8 b/ja/man/man8/atrun.8 index 5647647c4b..af13302756 100644 --- a/ja/man/man8/atrun.8 +++ b/ja/man/man8/atrun.8 @@ -1,4 +1,4 @@ -.\" %Id: atrun.man,v 1.1.6.2 1998/07/07 04:49:55 jkoshy Exp % +.\" %Id: atrun.man,v 1.5 1998/07/01 05:47:58 jkoshy Exp % .\" jpman %Id: atrun.8,v 1.2 1997/04/23 02:43:41 yugawa Stab % .Dd April 12, 1995 .Dt ATRUN 8 diff --git a/ja/man/man8/badsect.8 b/ja/man/man8/badsect.8 index c2e0619654..9f8f57acbd 100644 --- a/ja/man/man8/badsect.8 +++ b/ja/man/man8/badsect.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)badsect.8 8.1 (Berkeley) 6/5/93 -.\" %Id: badsect.8,v 1.1.1.1.8.4 1998/07/17 20:12:56 jkh Exp % +.\" %Id: badsect.8,v 1.7 1998/06/04 06:38:03 charnier Exp % .\" jpman %Id: badsect.8,v 1.2 1997/03/31 13:30:12 horikawa Stab % .\" .Dd June 5, 1993 diff --git a/ja/man/man8/boot_i386.8 b/ja/man/man8/boot_i386.8 index a41154b8b5..1bae2f79d8 100644 --- a/ja/man/man8/boot_i386.8 +++ b/ja/man/man8/boot_i386.8 @@ -35,7 +35,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)boot_i386.8 8.2 (Berkeley) 4/19/94 -.\" %Id: boot_i386.8,v 1.4.2.4 1998/03/23 08:14:06 danny Exp % +.\" %Id: boot_i386.8,v 1.13 1998/07/15 06:51:35 charnier Exp % .\" jpman %Id: boot_i386.8,v 1.5 1997/12/04 18:33:50 ken Exp % .\" .\" @@ -86,7 +86,7 @@ boot: .It \&? ブートファイルを探す際のヒントとして、デフォルトのブートデバイスの ルートディレクトリにあるファイルの名前を表示します。 -.It Op bios_drive:interface(unit,part) Op filename Op Fl aCcDdghPrsv +.It Op bios_drive:interface(unit,part) Op filename Op Fl abCcDdghPrsv ブートファイルとブートフラグを指定します。 .Bl -tag -width 10x -compact .It bios_drive @@ -126,12 +126,19 @@ WD100[2367] とその互換コントローラ上の ST506, IDE, ESDI, RLL ディスク .Pa /kernel となります。シンボリックリンクはサポートされていません (ハードリンク は使用できます)。 -.It Fl acCdDghPrsv +.It Fl abcCdDghPrsv ブートフラグです。 .Bl -tag -width "-CXX" -compact .It Fl a カーネル初期化中に、ルートファイルシステムとしてマウントされるデバイスを 尋ねて来るようにします。 +.It Fl b +スクリーンを 800x600x4 モード (Vesa モード 0x102) にします。 +XFree86 の XF86_VGA16 サーバでサポートされていないグラフィックスチップを +持つラップトップで有用です。 +スクリーンに表示させるためには、 +8x16 フォントを syscons に組み込むかブートストラップの一部にてロードする +必要があります。 .It Fl C CDROM からブートします。 .It Fl c @@ -169,6 +176,9 @@ GDB リモートデバッギングプロトコルを使用します。 オプションを使用できます。反対に、シリアルポートからブートした場合、 カーネルがコンソールとして代わりに内部ディスプレイを使用するようにす るため、このオプションを使用できます。 +カーネルを +.Em options COMCONSOLE +付きでコンパイルした場合には、このオプションは効果ありません。 .It Fl P キーボードを検出します。キーボードが発見できなかった場合には、 .Fl D @@ -194,9 +204,9 @@ GDB リモートデバッギングプロトコルを使用します。 .Pp デフォルトを設定するため、BIOS ドライブ番号, コントローラタイプ, ユニット番号, パーティション, カーネルファイル名と -.Fl D, -.Fl h -もしくは +.Fl b , +.Fl D , +.Fl h , .Fl P オプションを .Pa /boot.config @@ -234,6 +244,11 @@ GDB リモートデバッギングプロトコルを使用します。 で使用されているディスクラベルのフォーマットは、他のアーキテクチャで 使用されている物とは全く異なっています。 .Pp +フォントをカーネルに組み込まずに +.Fl b +を使用する場合、 +カーネルの出力は見えません (カーソル以外は見えません)。 +.Pp 一文字だけのブートフラグはあまり分かりやすい物とは言えず、有用と思わ れるオプションをすべて実現するには、アルファベットの文字数は少なすぎ ます。 diff --git a/ja/man/man8/bootpd.8 b/ja/man/man8/bootpd.8 index 3e487b55a2..20a639bd7b 100644 --- a/ja/man/man8/bootpd.8 +++ b/ja/man/man8/bootpd.8 @@ -1,313 +1,301 @@ .\" Copyright (c) 1988, 1989, 1991 Carnegie Mellon University .\" -.\" %Header: /home/ncvs/src/libexec/bootpd/bootpd.8,v 1.4.2.6 1998/06/03 04:35:16 jkoshy Exp % +.\" %Id: bootpd.8,v 1.9 1998/06/03 04:21:33 jkoshy Exp % .\" jpman %Id: bootpd.8,v 1.4 1997/10/11 07:39:12 horikawa Stab % .\" -.TH BOOTPD 8 "November 06, 1993" "Carnegie Mellon University" -.SH 名称 -bootpd, bootpgw \- インターネットブートプロトコルサーバ/ゲートウェイ -.SH 書式 -.B bootpd -[ -.B \-i -.B \-s -.B \-t -timeout -.B \-d -level -.B \-c -chdir\-path -] -[ -.I bootptab -[ -.I dumpfile -] ] -.br -.B bootpgw -[ -.B \-i -.B \-s -.B \-t -timeout -.B \-d -level -] server -.SH 解説 -.I bootpd +.Dd November 06, 1993 +.Dt BOOTPD 8 +.Os "Carnegie Mellon University" +.Sh 名称 +.Nm bootpd , bootpgw +.Nd インターネットブートプロトコルサーバ/ゲートウェイ +.Sh 書式 +.Nm bootpd +.Op Fl i +.Op Fl s +.Op Fl t Ar timeout +.Op Fl d Ar level +.Op Fl c Ar chdir-path +.Oo +.Ar bootptab +.Op Ar dumpfile +.Oc +.Nm bootpgw +.Op Fl i +.Op Fl s +.Op Fl t Ar timeout +.Op Fl d Ar level +.Ar server +.Sh 解説 +.Nm は RFC951, RFC1532, RFC1533 で定義された インターネットブートプロトコル (BOOTP) サーバを実装したものです。 -.I bootpgw +.Nm bootpgw は、要求と応答を、あるサブネット上のクライアントと、 別のサブネット上の BOOTP サーバ (すなわち -.IR bootpd +.Nm ) との間で転送するのに使われる、単純な BOOTP ゲートウェイを実装しています。 -.I bootpd +.Nm または -.I bootpgw +.Nm bootpgw は BOOTREPLY パケットを転送しますが、 -.I bootpgw +.Nm bootpgw だけが BOOTREQUEST パケットを転送します。 -.PP +.Pp 各々のネットワークセグメントにつき、通常一つのホストで、 以下の行のどれかをファイル -.IR /etc/inetd.conf +.Pa /etc/inetd.conf に含めることにより、 -.I bootpd +.Nm あるいは -.I bootpgw +.Nm bootpgw が -.I inetd +.Xr inetd 8 から起動されるように設定されます: -.IP -bootps dgram udp wait root /usr/libexec/bootpd bootpd /etc/bootptab -.br -bootps dgram udp wait root /usr/libexec/bootpgw bootpgw server -.PP +.Pp +.Dl bootps dgram udp wait root /usr/libexec/bootpd bootpd /etc/bootptab +.Dl bootps dgram udp wait root /usr/libexec/bootpgw bootpgw server +.Pp この動作モードは「inetd モード」と呼ばれ、 ブート要求が到着した時にだけ -.I bootpd +.Nm (あるいは -.IR bootpgw +.Nm bootpgw ) を開始します。 もし最後にパケットを受信してから 15 分以内に別のパケットを受信しないのなら、 システムの資源を浪費しないように終了します。 -.B \-t +.Fl t オプションがこのタイムアウト時間を制御します (オプション参照)。 -.PP +.Pp 他の通常のコマンドのように単にシェルから起動することで、 -.I bootpd +.Nm (あるいは -.IR bootpgw +.Nm bootpgw ) を「スタンドアローンモード」( -.IR inetd +.Xr inetd 8 なし) で実行することも可能です。 -.I bootpd +.Nm が大きなコンフィギュレーションデータベースのもとで使われる時には、 inetd モードでの起動時の遅延が クライアントの要求に対する素早い応答を妨げるので、 スタンドアローンモードは特に役に立ちます。 (例えば -.IR /etc/rc.local +.Pa /etc/rc.local から -.I bootpd +.Nm を呼びだすことによって、 スタンドアローンモードで自動的に起動することができます) -.I bootpgw +.Nm bootpgw は設定ファイルを読まないので、 起動時の遅延はかなり小さく、 スタンドアローンモードはあまり役に立ちません。 -.PP +.Pp どちらのプログラムも、inetd から呼び出されたかシェルから呼び出されたかを 自動的に検出し、自動的に適当なモードを選択します。 -.B \-s +.Fl s と -.B \-i +.Fl i オプションは各々、スタンドアローンモードと inetd モードを強制するのに 使います (オプション参照) -.SH オプション -.TP -.BI \-t \ timeout -.I bootpd +.Sh オプション +以下のオプションを使用可能です: +.Bl -tag -width indent +.It Fl t Ar timeout +.Nm あるいは -.I bootpgw +.Nm bootpgw プロセスが終了する前に BOOTP パケットを待つ -.I timeout +.Ar timeout 値 (分単位) を指定します。 もし -.I timeout +.Ar timeout 分内にパケットを受信しなければ、プログラムは終了します。 timeout の値が 0 の場合は「永遠に実行する」という意味です。 スタンドアローンモードでは、このオプションは 0 に強制されます。 -.TP -.BI \-d \ debug\-level +.It Fl d Ar debug-level 生成されるデバッグメッセージの量を制御する変数 -.I debug\-level +.Ar debug-level を設定します。 -例えば、-d4 あるいは -d 4 では、デバッグレベルが 4 に設定されます。 +例えば、 +.Fl d Ns 4 +.Fl d +4 では、デバッグレベルが 4 に設定されます。 古いバージョンの -.IR bootpd -との互換性のため、数字のパラメータを省略 (つまり、-d だけ) すると +.Nm +との互換性のため、数字のパラメータを省略 (つまり、 +.Fl d +だけ) すると 単にデバッグレベルを一つだけ増加させます。 -.TP -.BI \-c \ chdir\-path +.It Fl c chdir-path クライアントのブートファイルの存在とサイズを検査する間に -.I bootpd +.Nm で使われるカレントディレクトリを設定します。 クライアントのブートファイルが相対パス名で指定されていて、 -.I bootpd -が TFTP サーバと同じカレントディレクトリ (典型的には /tftpboot) -を必要とするときに有用です。 +.Nm +が TFTP サーバと同じカレントディレクトリ (典型的には +.Pa /tftpboot +) を必要とするときに有用です。 このオプションは -.IR bootpgw +.Nm bootpgw によっては認識されません。 -.TP -.B \-i +.It Fl i 強制的に inetd モードにします。 このオプションは時代遅れですが、古いバージョンの -.IR bootpd +.Nm との互換性のために残してあります。 -.TP +.It Fl s .B \-s 強制的にスタンドアローンモードにします。 このオプションは時代遅れですが、 古いバージョンの -.IR bootpd +.Nm との互換性のために残してあります。 -.TP -.I bootptab -.I bootpd +.It Ar bootptab +.Nm がロードする 設定ファイルの名前を指定します ( -.RI bootpd +.Nm のみ)。 これはあらかじめ知っているクライアントと そのクライアントのオプションに関するデータベースです。 -.TP -.I dumpfile -.I bootpd +.It Ar dumpfile +.Nm が、SIGUSR1 シグナルを受信したときに 内部データベースをダンプするファイルの名前を指定します ( -.RI bootpd +.Nm のみ)。 このオプションは -.I bootpd +.Nm が -DDEBUG フラグ付きでコンパイルされたときだけ認識されます。 -.TP -.I server -.I bootpgw +.It Ar server +.Nm bootpgw が受信した全ての BOOTREQUEST パケットを転送する、 BOOTP サーバの名前を指定します ( -.RI bootpgw +.Nm bootpgw のみ)。 -.SH 操作 -.PP -.I bootps +.El +.Sh 操作 +.Em bootps ポートに送られたどんなパケットも取り込んで どんな BOOTREPLY パケットも単純に転送するという点で -.I bootpd +.Nm と -.I bootpgw +.Nm bootpgw の双方が似た動きをします。 BOOTREQUEST の扱いは違います。 -.PP -.I bootpgw +.Pp +.Nm bootpgw は動作開始時に、コマンド行パラメタとして名前を与えられた BOOTP サーバのアドレスを決めます。 -.I bootpgw +.Nm bootpgw が BOOTREQUEST パケットを受信したとき、 パケットの「ゲートウェイアドレス」と「ホップ数」フィールドを設定し、 パケットを前に決めたアドレスの BOOT サーバへ転送します。 要求パケットは、 クライアントが少くとも 3 秒は待っているとパケットが示している時にだけ 転送されます。 -.PP -.I bootpd +.Pp +.Nm は動作開始時に設定ファイル (通常 -.IR /etc/bootptab +.Pa /etc/bootptab ) を読みこみます。 これで、あらかじめ知っているクライアントと クライアントのオプションに関する内部データベースを初期化します。 この内部データベースは、 -.I bootpd +.Nm が回線切断シグナル (SIGHUP) を受信したとき、 または設定ファイルが変更されたことを 発見したときに、再読み込みが行なわれます。 -.PP -.I bootpd +.Pp +.Nm が BOOTREQUEST パケットを受信したとき、 クライアントの要求に一致するデータベースエントリを探します。 もしそのクライアントをあらかじめ知っていれば -.I bootpd +.Nm は前に見付けたデータベースエントリを使って BOOTREPLY パケットを構成し、 (ひょっとしたらゲートウェイを使って) クライアントに返答を送ります。 もしクライアントが未知ならば、(debug > 0 のときは注意を出して) 要求は捨てられます。 -.PP -.I bootpd +.Pp +.Nm が -DDEBUG オプションでコンパイルされていれば、 SIGUSR1 シグナルを送ると内部データベースをファイル -.I /tmp/bootpd.dump +.Pa /tmp/bootpd.dump か、コマンド行パラメータで指定されたダンプファイルに にダンプします。 -.PP +.Pp 初期化の時どちらのプログラムも、 (普通は -.IR /etc/services +.Pa /etc/services を使う) -.I getservbyname +.Xr getservbyname 3 を呼ぶことで UDP ポート番号を決定します。 二つのサービス名 (とポート番号) が使われます: -.IP -bootps \- BOOTP サーバ待機ポート -.br -bootpc \- BOOTP クライアント届け先ポート -.LP +.Pp +.Dl bootps \- BOOTP サーバ待機ポート +.Dl bootpc \- BOOTP クライアント届け先ポート +.Pp もしポート番号が -.I getservbyname +.Xr getservbyname 3 を使って決定できないときには、 デフォルト値は bootps=67 と bootpc=68 です。 -.SH 関連ファイル -.TP 20 -/etc/bootptab -.IR bootpd +.Sh 関連ファイル +.Bl -tag -width /tmp/bootpd.dump -compact +.It Pa /etc/bootptab +.Nm によって読み込まれるデータベースファイル。 -.TP -/tmp/bootpd.dump -.IR bootpd +.It Pa /tmp/bootpd.dump +.Nm によって生成されるデバッグダンプファイル。 -.TP -/etc/services +.It Pa /etc/services インターネットサービス番号。 -.TP -/tftpboot +.It Pa /tftpboot TFTP サーバと -.IR bootpd +.Nm で使われる典型的カレントディレクトリ。 - -.SH バグ +.El +.Sh バグ 各々のホストエントリは 1024 文字を越えてはいけません。 - -.SH 功労者 -.PP -この配布版は現在、 Walter L. Wimer <walt+@cmu.edu> によって +.Sh 功労者 +この配布版は現在、 +.An Walter L. Wimer Aq walt+@cmu.edu +によって 保守されています。 -.PP +.Pp オリジナルの BOOTP サーバは -スタンフォード大学の Bill Croft によって 1986 年 1 月に作成されました。 -.PP +スタンフォード大学の +.An Bill Croft +によって 1986 年 1 月に作成されました。 +.Pp 現在のバージョンの -.I bootpd -は第一に、Carnegie Mellon University の David Kovar, -Drew D. Perkins, Walter L. Wimer の仕事にるものです。 -.TP +.Nm +は第一に、Carnegie Mellon University の +.An David Kovar , +.An Drew D. Perkins , +.An Walter L. Wimer +の仕事にるものです。 +.Pp 機能拡張とバグフィクスは以下の方の貢献によります: (アルファベット順) -.br -Danny Backx <db@sunbim.be> -.br -John Brezak <brezak@ch.hp.com> -.br -Frank da Cruz <fdc@cc.columbia.edu> -.br -David R. Linn <drl@vuse.vanderbilt.edu> -.br -Jim McKim <mckim@lerc.nasa.gov> -.br -Gordon W. Ross <gwr@mc.com> -.br -Jason Zions <jazz@hal.com> -.SH 関連項目 -.LP -bootptab(5), inetd(8), tftpd(8) -.LP +.Pp +.An Danny Backx Aq db@sunbim.be , +.An John Brezak Aq brezak@ch.hp.com , +.An Frank da Cruz Aq fdc@cc.columbia.edu , +.An David R. Linn Aq drl@vuse.vanderbilt.edu , +.An Jim McKim Aq mckim@lerc.nasa.gov , +.An Gordon W. Ross Aq gwr@mc.com , +.An Jason Zions Aq jazz@hal.com . +.Sh 関連項目 +.Xr bootptab 5 , +.Xr inetd 8 , +.Xr tftpd 8 +.Pp DARPA Internet Request For Comments: -.TP 10 -RFC951 +.Bl -tag -width RFC1533 -compact +.It RFC951 Bootstrap Protocol -.TP 10 -RFC1532 +.It RFC1532 Clarifications and Extensions for the Bootstrap Protocol -.TP 10 -RFC1533 +.It RFC1533 DHCP Options and BOOTP Vendor Extensions +.El diff --git a/ja/man/man8/ccdconfig.8 b/ja/man/man8/ccdconfig.8 index dae26c476d..8db895c1d8 100644 --- a/ja/man/man8/ccdconfig.8 +++ b/ja/man/man8/ccdconfig.8 @@ -31,7 +31,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: ccdconfig.8,v 1.4.2.1 1998/07/17 20:12:57 jkh Exp % +.\" %Id: ccdconfig.8,v 1.5 1998/06/04 06:41:26 charnier Exp % .\" .\" jpman %Id: ccdconfig.8,v 1.3 1997/07/28 10:00:39 konuma Stab % .Dd July 17, 1995 diff --git a/ja/man/man8/chat.8 b/ja/man/man8/chat.8 index b37e4c67df..5ba8d3255e 100644 --- a/ja/man/man8/chat.8 +++ b/ja/man/man8/chat.8 @@ -1,6 +1,6 @@ .\" -*- nroff -*- .\" manual page [] for chat 1.8 -.\" %Id: chat.8,v 1.4.2.4 1998/06/23 22:12:41 peter Exp % +.\" %Id: chat.8,v 1.12 1998/06/23 21:58:41 peter Exp % .\" jpman %Id: chat.8,v 1.3 1997/08/31 14:02:42 horikawa Stab % .\" SH section heading .\" SS subsection heading diff --git a/ja/man/man8/chown.8 b/ja/man/man8/chown.8 index 46570a50de..3356bfbf45 100644 --- a/ja/man/man8/chown.8 +++ b/ja/man/man8/chown.8 @@ -30,6 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)chown.8 8.3 (Berkeley) 3/31/94 +.\" %Id: chown.8,v 1.6 1997/09/04 11:55:42 charnier Exp % .\" %Id: chown.8,v 1.2.2.2 1997/09/15 06:29:30 charnier Exp % .\" jpman %Id: chown.8,v 1.3 1997/05/19 16:59:53 horikawa Stab % .\" @@ -145,4 +146,4 @@ .Nm コマンドは .At v1 -から導入されました。
\ No newline at end of file +から導入されました。 diff --git a/ja/man/man8/clri.8 b/ja/man/man8/clri.8 index 7bee759a8f..98071dbc35 100644 --- a/ja/man/man8/clri.8 +++ b/ja/man/man8/clri.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)clri.8 8.2 (Berkeley) 4/19/94 -.\" %Id: clri.8,v 1.2.2.2 1998/07/17 20:12:58 jkh Exp % +.\" %Id: clri.8,v 1.6 1998/06/04 06:44:16 charnier Exp % .\" jpman %Id: clri.8,v 1.2 1997/05/17 16:57:59 horikawa Stab % .\" .Dd April 19, 1994 diff --git a/ja/man/man8/comcontrol.8 b/ja/man/man8/comcontrol.8 index ac677e6066..7c4c5daa3b 100644 --- a/ja/man/man8/comcontrol.8 +++ b/ja/man/man8/comcontrol.8 @@ -1,4 +1,4 @@ -.\" %Id: comcontrol.8,v 1.8.2.3 1998/07/17 20:13:12 jkh Exp % +.\" %Id: comcontrol.8,v 1.14 1998/06/30 06:09:37 charnier Exp % .\" jpman %Id: comcontrol.8,v 1.3 1997/08/16 13:09:13 horikawa Stab % .Dd May 15, 1994 .Dt COMCONTROL 8 diff --git a/ja/man/man8/comsat.8 b/ja/man/man8/comsat.8 index d41e25d30f..cb770707af 100644 --- a/ja/man/man8/comsat.8 +++ b/ja/man/man8/comsat.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)comsat.8 8.1 (Berkeley) 6/4/93 -.\" %Id: comsat.8,v 1.3 1996/09/22 21:53:05 wosch Exp % +.\" %Id: comsat.8,v 1.5 1997/02/22 14:21:23 peter Exp % .\" jpman %Id: comsat.8,v 1.2 1997/03/31 13:32:20 horikawa Stab % .\" .Dd June 4, 1993 diff --git a/ja/man/man8/config.8 b/ja/man/man8/config.8 index ee8f75f91b..cdd6515b7d 100644 --- a/ja/man/man8/config.8 +++ b/ja/man/man8/config.8 @@ -40,7 +40,7 @@ .Nd システムを構築するために必要なファイルの作成 .Sh 書式 .Nm config -.Op Fl gpn +.Op Fl gpr .Ar SYSTEM_NAME .Sh 解説 これは古いバージョンの @@ -82,8 +82,8 @@ オプションを 2 度以上指定すると、 .Nm より詳細なプロファイリングを行うシステムを構築します。 -.It Fl n -以前のコンパイル用ディレクトリを削除しません(以降参照)。 +.It Fl r +以前のコンパイル用ディレクトリを削除します(以降参照)。 .It Ar SYSTEM_NAME .Ar SYSTEM_NAME はシステム設定ファイルの名前であり、システム設定ファイル @@ -100,26 +100,26 @@ は必要により .Pa ../../compile/SYSTEM_NAME ディレクトリを作成し、そこにすべての出力ファイルを置きます。 -.Fl n -オプションが指定されているか、環境変数 -.Ev NO_CONFIG_CLOBBER -が設定されていないと、ディレクトリが既に存在する場合にはあらかじめ -削除されます。 +ディレクトリが既に存在し、 +.Fl r +オプションが指定されている場合、 +ディレクトリがまず削除されます。 .Nm の出力は多くのファイルです; .Tn i386 の場合は次のようなファイルになります: -.Pa ioconf.c , -システムに接続された I/O デバイスの記述; -.Pa vector.h , -割り込み計測関連のマクロ定義; -.Pa Makefile , +.Pa ioconf.c +はシステムに接続された I/O デバイスの記述です; +.Pa vector.h +は割り込み計測関連のマクロ定義です; +.Pa Makefile +は .Xr make 1 -がシステム構築に使用する; -ヘッダファイル, システムに組み込まれる多くのデバイスに関する定義; -スワップ設定ファイル, -スワップ、ルートファイルシステム、引数処理、システムダンプに使用する -ディスク領域に関する定義。 +がシステム構築に使用するファイルです; +ヘッダファイルはシステムに組み込まれる多くのデバイスに関する定義です; +いわゆるスワップ設定ファイルは +ルートファイルシステムとシステムダンプに使用する +ディスク領域に関する定義です。 .Pp .Nm の実行後は、 diff --git a/ja/man/man8/crash.8 b/ja/man/man8/crash.8 index 20fb70b329..c7ba62edc2 100644 --- a/ja/man/man8/crash.8 +++ b/ja/man/man8/crash.8 @@ -34,7 +34,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: crash.8,v 1.3.2.2 1998/03/07 10:04:24 jkh Exp % +.\" %Id: crash.8,v 1.7 1997/03/21 20:14:12 mpp Exp % .\" jpman %Id: crash.8,v 1.3 1997/08/16 13:10:53 horikawa Stab % .\" .Dd February 2, 1996 diff --git a/ja/man/man8/cron.8 b/ja/man/man8/cron.8 index 64055879cf..63792a7e29 100644 --- a/ja/man/man8/cron.8 +++ b/ja/man/man8/cron.8 @@ -15,7 +15,7 @@ .\" * Paul Vixie <paul@vix.com> uunet!decwrl!vixie!paul .\" */ .\" -.\" %Id: cron.8,v 1.2.2.2 1998/07/18 11:09:07 jkh Exp % +.\" %Id: cron.8,v 1.6 1998/03/23 08:21:07 charnier Exp % .\" jpman %Id: cron.8,v 1.2 1997/04/18 06:33:14 yugawa Stab % .\" .Dd December 20, 1993 diff --git a/ja/man/man8/disklabel.8 b/ja/man/man8/disklabel.8 index 45f3fec3a4..ffecc4ad6a 100644 --- a/ja/man/man8/disklabel.8 +++ b/ja/man/man8/disklabel.8 @@ -33,7 +33,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)disklabel.8 8.2 (Berkeley) 4/19/94 -.\" %Id: disklabel.8,v 1.3.2.3 1998/07/17 20:12:59 jkh Exp % +.\" %Id: disklabel.8,v 1.8 1998/06/04 06:49:13 charnier Exp % .\" jpman %Id: disklabel.8,v 1.2 1997/03/31 14:09:16 horikawa Stab % .\" .Dd April 19, 1994 diff --git a/ja/man/man8/dmesg.8 b/ja/man/man8/dmesg.8 index 91d44697e9..c22a33f9d1 100644 --- a/ja/man/man8/dmesg.8 +++ b/ja/man/man8/dmesg.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)dmesg.8 8.1 (Berkeley) 6/5/93 -.\" %Id: dmesg.8,v 1.3.2.1 1998/07/17 20:13:02 jkh Exp % +.\" %Id: dmesg.8,v 1.4 1998/06/04 06:51:13 charnier Exp % .\" jpman %Id: dmesg.8,v 1.2 1997/04/25 00:26:27 mutoh Stab % .\" .Dd June 5, 1993 diff --git a/ja/man/man8/dset.8 b/ja/man/man8/dset.8 index 95d7642bc8..78e4c3eff3 100644 --- a/ja/man/man8/dset.8 +++ b/ja/man/man8/dset.8 @@ -23,7 +23,7 @@ .\" (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: dset.8,v 1.4.2.1 1998/06/03 04:35:19 jkoshy Exp % +.\" %Id: dset.8,v 1.7 1998/06/03 04:21:39 jkoshy Exp % .\" jpman %Id: dset.8,v 1.3 1997/09/04 16:35:08 horikawa Stab % .\" " .Dd May 2, 1996 diff --git a/ja/man/man8/dump.8 b/ja/man/man8/dump.8 index a04a63485b..acf6a25300 100644 --- a/ja/man/man8/dump.8 +++ b/ja/man/man8/dump.8 @@ -30,11 +30,11 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" @(#)dump.8 8.1 (Berkeley) 6/16/93 -.\" %Id: dump.8,v 1.5.2.9 1998/07/17 20:13:04 jkh Exp % +.\" @(#)dump.8 8.3 (Berkeley) 5/1/95 +.\" %Id: dump.8,v 1.21 1998/06/15 06:58:09 charnier Exp % .\" jpman %Id: dump.8,v 1.2 1997/06/12 05:57:09 yugawa Stab % .\" -.Dd June 16, 1993 +.Dd May 1, 1995 .Dt DUMP 8 .Os BSD 4 .Sh 名称 diff --git a/ja/man/man8/dumpfs.8 b/ja/man/man8/dumpfs.8 index aeebf725a0..2a4a9dd68b 100644 --- a/ja/man/man8/dumpfs.8 +++ b/ja/man/man8/dumpfs.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)dumpfs.8 8.1 (Berkeley) 6/5/93 -.\" %Id: dumpfs.8,v 1.1.1.1.8.1 1997/03/03 07:01:21 mpp Exp % +.\" %Id: dumpfs.8,v 1.4 1997/02/22 14:32:17 peter Exp % .\" jpman %Id: dumpfs.8,v 1.2 1997/05/03 11:26:10 horikawa Stab % .\" .Dd June 5, 1993 diff --git a/ja/man/man8/dumpon.8 b/ja/man/man8/dumpon.8 index ef60a1cfbd..f4749d856a 100644 --- a/ja/man/man8/dumpon.8 +++ b/ja/man/man8/dumpon.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" From: @(#)swapon.8 8.1 (Berkeley) 6/5/93 -.\" %Id: dumpon.8,v 1.3.2.3 1998/07/17 20:13:09 jkh Exp % +.\" %Id: dumpon.8,v 1.8 1998/06/15 07:03:46 charnier Exp % .\" jpman %Id: dumpon.8,v 1.3 1997/08/16 13:12:52 horikawa Stab % .\" .Dd May 12, 1995 diff --git a/ja/man/man8/fsck.8 b/ja/man/man8/fsck.8 index 1e253e7398..0c459fac1b 100644 --- a/ja/man/man8/fsck.8 +++ b/ja/man/man8/fsck.8 @@ -10,7 +10,7 @@ .\" 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: +.\" must display the following acknowledgment: .\" 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 @@ -29,11 +29,11 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" @(#)fsck.8 8.2 (Berkeley) 12/11/93 -.\" %Id: fsck.8,v 1.5.2.1 1997/03/03 07:01:23 mpp Exp % +.\" @(#)fsck.8 8.4 (Berkeley) 5/9/95 +.\" %Id: fsck.8,v 1.11 1998/06/15 07:07:12 charnier Exp % .\" jpman %Id: fsck.8,v 1.2 1997/04/24 00:30:54 mutoh Stab % .\" -.Dd December 11, 1993 +.Dd May 9, 1995 .Dt FSCK 8 .Os BSD 4 .Sh 名称 @@ -54,14 +54,14 @@ .Op Ar filesystem .Ar ... .Sh 解説 -.Nm fsck +.Nm の最初の書式は、標準のファイルシステムのセットや指定された ファイルシステムの状態を整えるのに使われます。 通常は、自動リブートの間に .Pa /etc/rc スクリプトの中で使用されます。 この時 -.Nm fsck +.Nm は .Pa /etc/fstab を読んで、チェックするファイルシステムを決定します。 @@ -79,6 +79,10 @@ fstab 内の ``rw,'' ``rq,'' ``ro'' のいずれかのオプションで .Pp 各ファイルシステムのスーパーブロックのクリーン (clean) フラグを調べ、 クリーンでないファイルシステムのみをチェックします。 +ファイルシステムがクリーンとマークされるのは、 +アンマウントされた時、読み取り専用でマウントされた時、 ++.Nm +成功裏に実行された時です。 .Fl f オプションを指定した場合、クリーンフラグの状態にかかわらず ファイルシステムをチェックします。 @@ -102,21 +106,21 @@ inode のリンクカウントが多すぎる .Pp .Fl p オプション付の -.Nm fsck +.Nm では、上記の不整合のみを修正します。その他の不整合を発見すると、 -.Nm fsck +.Nm は異常終了のステータスを返して終了し、自動リブートは失敗します。 不整合を修正するたびに、ファイルシステムと修正内容が表示されます。 ファイルシステムの修正に成功した後で、 -.Nm fsck +.Nm はファイルシステム中のファイル数、使用中ブロックとフリーブロックの数、 フラグメントの割合を表示します。 .Pp -.Nm fsck +.Nm がファイルシステムをチェックしている間に .Dv QUIT シグナルを送ると、 -.Nm fsck +.Nm はチェックを続けますが、終了時に異常終了のステータスを返し、 自動リブートを失敗させます。 これは、自動リブートによるファイルシステムチェックは行いたいが、 @@ -124,7 +128,7 @@ inode のリンクカウントが多すぎる .Pp .Fl p オプションなしでは、 -.Nm fsck +.Nm はファイルシステムの状態の検査をおこない、それを対話的に修正します。 ファイルシステムに不整合がある場合、修正を実施する前にオペレータへ 確認を求めます。 @@ -138,18 +142,18 @@ inode のリンクカウントが多すぎる .Li no と応答するまで待ちます。 オペレータにファイルシステムの書き込み権限がない場合、 -.Nm fsck +.Nm は、 .Fl n オプションの動作をデフォルトにします。 .Pp -.Nm fsck +.Nm は、以前使われていた .Em check , dcheck , fcheck , .Em icheck の組合せよりもより詳しい不整合チェックを行ないます。 .Pp -.Nm fsck +.Nm は以下のフラグを解釈します。 .Bl -tag -width indent .It Fl b @@ -170,7 +174,7 @@ inode のリンクカウントが多すぎる 失われたファイルをすべてのユーザには見せたくないシステムでは、 より制限の厳しい 700 を使うべきです。 .It Fl y -.Nm fsck +.Nm からのすべての質問に yes と答えます。 このオプションは、 修正によって新たな不整合を生むような誤った修正に対しても無制限な @@ -180,7 +184,7 @@ inode のリンクカウントが多すぎる .\"(訳注)とくに問題がないと判断したので,この意訳をそのままとしました。 .\" 2.2.1R 対象(1997/04/23) Takeshi MUTOH <mutoh@info.nara-k.ac.jp> .It Fl n -.Nm fsck +.Nm からの .Ql CONTINUE? を除くすべての問い合わせに no と答えます。 @@ -189,7 +193,7 @@ inode のリンクカウントが多すぎる ファイルシステムを指定したレベルへ変換します。 ファイルシステムのレベルは、上げることのみが可能です。 .Bl -tag -width indent -以下の 3 レベルが定義されています。 +以下の 4 レベルが定義されています。 .It 0 ファイルシステムは、旧フォーマットです (静的テーブル)。 .It 1 @@ -198,10 +202,14 @@ inode のリンクカウントが多すぎる ファイルシステムは 32 ビットの UID と GID を用い、 短いシンボリックリンクは inode 内へ格納し、 ディレクトリはファイルタイプを示す追加フィールドを持ちます。 +.It 3 +maxcontig が 1 より大きい場合、 +連続ブロックをみつけるためのフリーセグメントマップを作成します。 +maxcontig が 1 の場合、既存のセグメントマップを削除します。 .El .Pp 対話モードでは、 -.Nm fsck +.Nm は、変換の内容を表示して、実際に変換するかどうかを問い合わせます。 no と答えると、ファイルシステムへのそれ以上の操作は行われません。 preen モード ( @@ -216,7 +224,7 @@ preen モードでの変換は、すべてのファイルシステムを一度に .El .Pp ファイルシステムを指定せずに -.Nm fsck +.Nm を実行すると .Pa /etc/fstab ファイルから読み込まれたファイルシステムのリストが対象になります。 @@ -284,7 +292,7 @@ preen モードでの変換は、すべてのファイルシステムを一度に チェックを行なうファイルシステムのデフォルトリストを含む .El .Sh 診断 -.Nm fsck +.Nm の出す診断メッセージは、 .Rs .%T "Fsck \- The UNIX File System Check Program" @@ -293,5 +301,6 @@ preen モードでの変換は、すべてのファイルシステムを一度に .Sh 関連項目 .Xr fs 5 , .Xr fstab 5 , +.Xr fsdb 8 , .Xr newfs 8 , .Xr reboot 8 diff --git a/ja/man/man8/fsdb.8 b/ja/man/man8/fsdb.8 index ac0d71858d..f00ce01a7b 100644 --- a/ja/man/man8/fsdb.8 +++ b/ja/man/man8/fsdb.8 @@ -26,7 +26,7 @@ .\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\" -.\" %Id: fsdb.8,v 1.3.2.2 1998/08/12 06:15:16 charnier Exp % +.\" %Id: fsdb.8,v 1.8 1998/06/15 07:12:18 charnier Exp % .\" jpman %Id: fsdb.8,v 1.3 1997/06/23 15:01:41 horikawa Stab % .\" .Dd September 14, 1995 @@ -36,9 +36,10 @@ .Nm fsdb .Nd FFS デバッグ/編集ツール .Sh 書式 -.Nm +.Nm fsdb .Op Fl d .Op Fl f +.Op Fl r .Ar fsname .Sh 解説 .Nm @@ -59,13 +60,18 @@ inode データを操作するためのコマンドを受け付けます。コマンドは が dirty とマークされ、バッファリングされているブロックがあれば ファイルシステムに書き込まれます。 .Pp -.Fl d -オプションを指定すると、デバッグ情報 (元は +以下のオプションを使用可能です: +.Bl -tag -width indent +.It Fl d +デバッグ情報 (元は .Xr fsck 8 のコードに由来するもの) を出力します。 -.Pp -.Fl f -オプションは歴史的な理由により残されているもので、特に意味は持ちません。 +.It Fl f +歴史的な理由により残されているもので、特に意味は持ちません。 +.It Fl r +ファイルシステムを読み取り専用でオープンし、 +書き込みを行うコマンドを抑止します。 +.El .Sh コマンド 組み込みの .Xr libedit 3 diff --git a/ja/man/man8/fsirand.8 b/ja/man/man8/fsirand.8 index 75b1f99b69..f1894c0e18 100644 --- a/ja/man/man8/fsirand.8 +++ b/ja/man/man8/fsirand.8 @@ -27,7 +27,7 @@ .\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" .\" $OpenBSD: fsirand.8,v 1.6 1997/02/23 03:58:26 millert Exp $ -.\" %Id: fsirand.8,v 1.3.2.4 1998/07/17 20:13:11 jkh Exp % +.\" %Id: fsirand.8,v 1.8 1998/06/30 06:18:43 charnier Exp % .\" jpman %Id: fsirand.8,v 1.3 1997/09/08 07:26:22 kuma Stab % .\" .Dd January 25, 1997 diff --git a/ja/man/man8/ft.8 b/ja/man/man8/ft.8 index 90f8906be2..f7a22a3190 100644 --- a/ja/man/man8/ft.8 +++ b/ja/man/man8/ft.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)ft.8 -.\" %Id: ft.8,v 1.2.6.2 1998/07/17 20:13:18 jkh Exp % +.\" %Id: ft.8,v 1.5 1998/06/30 06:22:05 charnier Exp % .\" jpman %Id: ft.8,v 1.3 1997/08/20 11:58:37 horikawa Stab % .\" .Dd February 7, 1994 diff --git a/ja/man/man8/ftpd.8 b/ja/man/man8/ftpd.8 index fe4f46726b..785e79624c 100644 --- a/ja/man/man8/ftpd.8 +++ b/ja/man/man8/ftpd.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)ftpd.8 8.2 (Berkeley) 4/19/94 -.\" %Id: ftpd.8,v 1.9.2.14 1998/07/17 04:00:02 jkoshy Exp % +.\" %Id: ftpd.8,v 1.22 1998/07/09 11:38:21 jkoshy Exp % .\" jpman %Id: ftpd.8,v 1.3 1997/09/08 07:23:46 kuma Stab % .\" .Dd April 19, 1994 @@ -401,8 +401,9 @@ list コマンドのサポートのため、ここに .Pp プライマリ IP アドレスあるいはホスト名に対する仮想ホストを定義すると、 そのアドレスへの ftp ログインのデフォルト値が変更されます。 -'user', 'statfile', 'welcome', 'motd' の各フィールドは -デフォルト値を用いる場合、ブランクのままもしくはハイフン一つ '-' と +\&'user', 'statfile', 'welcome', 'motd' の各フィールドは +デフォルト値を用いる場合、ブランクのままもしくはハイフン一つ +\&'-' と しても構いません。 .Pp いかなる匿名ログインの設定についても言えることですが、 diff --git a/ja/man/man8/getty.8 b/ja/man/man8/getty.8 index 3226a8087d..bdc5de8229 100644 --- a/ja/man/man8/getty.8 +++ b/ja/man/man8/getty.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)getty.8 8.1 (Berkeley) 6/4/93 -.\" %Id: getty.8,v 1.4.2.3 1997/12/15 07:10:52 charnier Exp % +.\" %Id: getty.8,v 1.9 1997/11/21 07:43:42 charnier Exp % .\" jpman %Id: getty.8,v 1.3 1997/05/19 17:00:46 horikawa Stab % .\" " .Dd April 25, 1991 diff --git a/ja/man/man8/ibcs2.8 b/ja/man/man8/ibcs2.8 index 2d1ac841d1..868f3985b7 100644 --- a/ja/man/man8/ibcs2.8 +++ b/ja/man/man8/ibcs2.8 @@ -25,7 +25,7 @@ .\" (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: ibcs2.8,v 1.2.2.1 1998/05/22 10:29:39 jkoshy Exp % +.\" %Id: ibcs2.8,v 1.5 1998/05/19 03:31:34 jkoshy Exp % .\" jpman %Id: ibcs2.8,v 1.3 1997/09/08 08:46:54 kuma Stab % .\" .Dd November 27, 1995 diff --git a/ja/man/man8/ifconfig.8 b/ja/man/man8/ifconfig.8 index d5a4e28ec8..6ffb533843 100644 --- a/ja/man/man8/ifconfig.8 +++ b/ja/man/man8/ifconfig.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" From: @(#)ifconfig.8 8.3 (Berkeley) 1/5/94 -.\" %Id: ifconfig.8,v 1.9.2.5 1998/07/17 20:13:20 jkh Exp % +.\" %Id: ifconfig.8,v 1.18 1998/07/06 06:53:42 charnier Exp % .\" jpman %Id: ifconfig.8,v 1.2 1997/03/31 14:09:47 horikawa Stab % .\" .Dd February 13, 1996 diff --git a/ja/man/man8/inetd.8 b/ja/man/man8/inetd.8 index 326fce6042..3a90e6c3f6 100644 --- a/ja/man/man8/inetd.8 +++ b/ja/man/man8/inetd.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)inetd.8 8.3 (Berkeley) 4/13/94 -.\" %Id: inetd.8,v 1.9.2.6 1998/07/18 11:10:23 jkh Exp % +.\" %Id: inetd.8,v 1.22 1998/06/10 12:34:25 phk Exp % .\" jpman %Id: inetd.8,v 1.2 1997/05/16 07:22:24 yugawa Stab % .\" .Dd February 7, 1996 diff --git a/ja/man/man8/init.8 b/ja/man/man8/init.8 index da9d3f11e8..0fbb00d6cd 100644 --- a/ja/man/man8/init.8 +++ b/ja/man/man8/init.8 @@ -33,7 +33,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)init.8 8.3 (Berkeley) 4/18/94 -.\" %Id: init.8,v 1.4.2.5 1998/07/17 20:13:23 jkh Exp % +.\" %Id: init.8,v 1.12 1998/07/06 06:56:07 charnier Exp % .\" jpman %Id: init.8,v 1.2 1997/05/27 08:12:44 yugawa Stab % .\" .Dd April 18, 1994 diff --git a/ja/man/man8/intro.8 b/ja/man/man8/intro.8 index c32033fab8..940626668b 100644 --- a/ja/man/man8/intro.8 +++ b/ja/man/man8/intro.8 @@ -30,8 +30,8 @@ .\" SUCH DAMAGE. .\" .\" @(#)intro.8 8.2 (Berkeley) 12/11/93 +.\" %Id: intro.8,v 1.2 1997/03/07 03:28:20 jmg Exp % .\" jpman %Id: intro.8,v 1.3 1997/08/20 12:01:36 horikawa Stab % -.\" %Id: intro.8,v 1.1.1.1.8.1 1997/03/07 04:18:27 mpp Exp % .\" .Dd December 11, 1993 .Dt INTRO 8 diff --git a/ja/man/man8/ipfw.8 b/ja/man/man8/ipfw.8 index fcb4c37871..c5c067a527 100644 --- a/ja/man/man8/ipfw.8 +++ b/ja/man/man8/ipfw.8 @@ -10,7 +10,7 @@ .Oo .Fl q .Oc -.Ar file +file .Nm ipfw .Oo .Fl f @@ -70,7 +70,7 @@ to .Pp 番号を指定せずにルールを追加した場合は、直前のルールの番号に 100 を加えたものと なります。 -ルールの番号が 65434 より大きい場合は、新しいルールは最後のルールに追加されます +ルールの番号が 65534 より大きい場合は、新しいルールは最後のルールに追加されます 。 .Pp delete 操作は @@ -97,6 +97,19 @@ flush 操作は全ルールを削除します。 全パケットを拒否するのがデフォルトのポリシーです。 これを修正し、必要なルールを設定して下さい。 .Pp +しかしながら、カーネルオプション +.Dq IPFIREWALL_DEFAULT_TO_ACCEPT +が有効な場合、ルールは次のようになります: +.Bd -literal -offset center +65535 allow all from any to any +.Ed +.Pp +このバリエーションでは全てが通過可能です。 +このオプションを有効にしてよいのは特定の状況だけであり、 +例えば通常は解放しており、 +必要に応じてサービス拒否 (denial-of-service) フィルタとなる +ファイアウォールシステムを使用する場合がこれに該当します。 +.Pp オプションは以下のものが利用可能です。 .Bl -tag -width flag .It Fl a @@ -118,7 +131,8 @@ flush 操作も無条件に実行されます。 実行する場合や、 多数の ipfw ルールを記述したファイルを用いる場合に 便利です。 -flush 操作が通常の(冗舌な)状態で実行されると、メッセージが出力されます。 +flush 操作が通常の(冗舌な)状態(デフォルトのカーネルの設定) +で実行されると、メッセージが出力されます。 ここで、すべてのルールは削除されるので、メッセージをログインセッションに 送ることができず、ログインセッションがクローズされてしまうので、 残りのルールセットは実行されません。 @@ -186,6 +200,33 @@ TCP パケットのみに対応。 で指定されたポートにバインドされている .Xr divert 4 ソケットに送り、引続きマッチングを行ないます。 +この機能は未実装です。 +.It Ar fwd ipaddr Op ,port +マッチしたパケットの次のホップを +.Ar ipaddr +に変更します。これはドット付き 4 つ組の IP アドレスでもホスト名でもよいです。 +.Ar ipaddr +が直接到達可能なアドレスではない場合、その IP に対して +ローカルルーティングテーブルでみつかる経路を使用します。 +.Ar ipaddr +がローカルアドレスの場合、 +リモートホストからこのシステムにパケットが到着すると、 +そのパケットをローカルマシンの +.Ar port +に転換します。 +その際、 +ソケットのローカルアドレスは、 +パケットの元々の宛先の IP アドレスのままとします。 +これは透過的プロキシサーバのためにあります。 +IP が ローカルアドレスではない場合、ポート番号は (指定されていても) 無視され、 +ルールはシステムから出て行くパケットに対してのみ適用されます。 +また、」 +パケットローカルに生成された時にもアドレスをローカルポートにマップします。 +検索はルールがマッチしたときに終了します。 +ポート番号が与えられなかった場合、パケット中のポート番号が使用され、 +外部マシンのポート Y へのパケットは ローカルポート Y へ転送されます。 +カーネルは、 +オプション IPFIREWALL_FORWARD 付きでコンパイルされている必要があります。 .It Ar skipto number .Ar number より小さな番号のルールを飛び越して、 @@ -449,12 +490,12 @@ ipfw flush 。 .Sh 使用例 次のコマンドは -.Em hacker.evil.org +.Em cracker.evil.org から .Em wolf.tambov.su の telnet ポートへ送られる全ての TCP パケットを拒否するルールを追加します。 .Pp -.Dl ipfw add deny tcp from hacker.evil.org to wolf.tambov.su 23 +.Dl ipfw add deny tcp from cracker.evil.org to wolf.tambov.su 23 .Pp 次のコマンドはネットワーク hackers からホスト my への全てのコネクションを 拒否します。 @@ -474,14 +515,14 @@ ipfw flush .Pp .Dl ipfw divert 5000 all from 192.168.2.0/24 to any in .Sh 関連項目 +.Xr divert 4 , .Xr ip 4 , .Xr ipfirewall 4 , -.Xr divert 4 , .Xr protocols 5 , .Xr services 5 , .Xr reboot 8 , -.Xr syslogd 8 , -.Xr sysctl 8 +.Xr sysctl 8 , +.Xr syslogd 8 .Sh バグ .Pp .Em WARNING!!WARNING!!WARNING!!WARNING!!WARNING!!WARNING!!WARNING!! diff --git a/ja/man/man8/ispcvt.8 b/ja/man/man8/ispcvt.8 index 798ef08c45..95e4afcdd2 100644 --- a/ja/man/man8/ispcvt.8 +++ b/ja/man/man8/ispcvt.8 @@ -31,7 +31,7 @@ .\" jpman %Id: ispcvt.8,v 1.3 1997/09/09 04:05:01 yugawa Stab % .\" .Dd April 4, 1995 -.Dt ISPCVT 1 +.Dt ISPCVT 8 .Sh 名称 .Nm ispcvt .Nd 現在のビデオドライバが pcvt ドライバか否かを確認する diff --git a/ja/man/man8/joy.8 b/ja/man/man8/joy.8 index c383c27221..98c9f804cc 100644 --- a/ja/man/man8/joy.8 +++ b/ja/man/man8/joy.8 @@ -22,7 +22,7 @@ .\" (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: joy.8,v 1.1.2.1 1998/03/06 05:27:01 jkh Exp % +.\" %Id: joy.8,v 1.4 1997/02/22 12:48:18 peter Exp % .\" jpman %Id: joy.8,v 1.3 1997/07/22 16:48:04 horikawa Stab % .\" .Dd March 16, 1996 diff --git a/ja/man/man8/kernbb.8 b/ja/man/man8/kernbb.8 index 780fd37e46..bcccbb4c04 100644 --- a/ja/man/man8/kernbb.8 +++ b/ja/man/man8/kernbb.8 @@ -29,7 +29,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: kernbb.8,v 1.1.6.4 1998/07/18 11:10:34 jkh Exp % +.\" %Id: kernbb.8,v 1.7 1997/10/12 11:51:25 max Exp % .\" jpman %Id: kernbb.8,v 1.3 1997/08/16 13:16:53 horikawa Stab % .\" .Dd May 22, 1995 diff --git a/ja/man/man8/kzip.8 b/ja/man/man8/kzip.8 index a523065b8a..8a0ea405b4 100644 --- a/ja/man/man8/kzip.8 +++ b/ja/man/man8/kzip.8 @@ -23,7 +23,7 @@ .\" (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: kzip.8,v 1.1.2.2 1998/07/17 04:18:41 jkh Exp % +.\" %Id: kzip.8,v 1.5 1998/03/23 07:44:18 charnier Exp % .\" jpman %Id: kzip.8,v 1.3 1997/08/16 13:18:54 horikawa Stab % .\" .Dd August 15, 1996 diff --git a/ja/man/man8/ldconfig.8 b/ja/man/man8/ldconfig.8 index 92d4c443f9..af03280fb3 100644 --- a/ja/man/man8/ldconfig.8 +++ b/ja/man/man8/ldconfig.8 @@ -27,7 +27,7 @@ .\" (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: ldconfig.8,v 1.9.2.4 1998/03/03 07:00:19 jkh Exp % +.\" %Id: ldconfig.8,v 1.15 1998/01/01 02:31:47 alex Exp % .\" jpman %Id: ldconfig.8,v 1.3 1997/07/22 16:49:42 horikawa Stab % .\" .Dd October 3, 1993 diff --git a/ja/man/man8/linux.8 b/ja/man/man8/linux.8 index ad111cd5e3..0341effbf7 100644 --- a/ja/man/man8/linux.8 +++ b/ja/man/man8/linux.8 @@ -22,7 +22,7 @@ .\" (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: linux.8,v 1.1 1997/01/10 05:48:50 mpp Exp % +.\" %Id: linux.8,v 1.3 1997/02/22 12:48:26 peter Exp % .\" jpman %Id: linux.8,v 1.3 1997/07/22 16:50:43 horikawa Stab % .\" .Dd January 9, 1997 diff --git a/ja/man/man8/lptcontrol.8 b/ja/man/man8/lptcontrol.8 index c37381da4f..fbeb91dae1 100644 --- a/ja/man/man8/lptcontrol.8 +++ b/ja/man/man8/lptcontrol.8 @@ -11,7 +11,7 @@ .\" documentation and/or other materials provided with the distribution. .\" .\" -.\" %Id: lptcontrol.8,v 1.3.2.3 1998/07/18 11:10:46 jkh Exp % +.\" %Id: lptcontrol.8,v 1.7 1998/03/23 08:23:49 charnier Exp % .\" jpman %Id: lptcontrol.8,v 1.3 1997/08/16 13:20:55 horikawa Stab % .Dd September 3, 1994 .Dt LPTCONTROL 8 diff --git a/ja/man/man8/mail.local.8 b/ja/man/man8/mail.local.8 index 684a2a216b..b9c11db8cc 100644 --- a/ja/man/man8/mail.local.8 +++ b/ja/man/man8/mail.local.8 @@ -1,39 +1,16 @@ +.\" Copyright (c) 1998 Sendmail, Inc. All rights reserved. .\" Copyright (c) 1990, 1993 .\" 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. +.\" By using this file, you agree to the terms and conditions set +.\" forth in the LICENSE file which can be found at the top level of +.\" the sendmail distribution. .\" -.\" 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. .\" -.\" @(#)mail.local.8 8.2 (Berkeley) 12/11/93 -.\" %Id: mail.local.8,v 1.4.2.1 1998/02/20 17:32:25 jkh Exp % +.\" @(#)mail.local.8 8.7 (Berkeley) 5/19/98 .\" jpman %Id: mail.local.8,v 1.2 1997/03/31 13:35:26 horikawa Stab % .\" -.Dd December 11, 1993 +.Dd May 19, 1998 .Dt MAIL.LOCAL 8 .Os .Sh 名称 @@ -43,6 +20,7 @@ .Nm mail.local .Op Fl f Ar from .Op Fl b +.Op Fl s .Ar user ... .Sh 解説 .Nm mail.local @@ -62,6 +40,11 @@ .It Fl b .Dq biff サービスに通知する事をやめます。 +.It Fl s +.Dq success +状態を返す前にメールボックスをディスクにコミットするために使用する、 +.Xr fsync 2 +呼び出しを無効にします。 .El .Pp メールボックスのなかの個々のメッセージは、 @@ -74,11 +57,15 @@ 空行がそれぞれのメッセージに追加されます。 大なり記号 (``>'') は ``From '' によって誤って別のメッセージとして処理 -される可能性のある行の行頭に付加されます。 +される可能性のある行の行頭に付加されます +(それは、空白行に続く行で ``From '' という 5 文字で始まる行です)。 .Pp メールファイルはメールが追加されている間は .Xr flock 2 によって排他的にロックされます。 +メールボックスがロックされている間、 +.Pa user.lock +が作成されますが、これは古い MUA との互換性のためです。 .Pp .Xr getservbyname 3 が ``biff'' を返すと、 @@ -92,11 +79,13 @@ biff サーバにメールの配送が伝えられます。 タイムスタンプを記録する際に適切なタイムゾーンを設定します。 .El .Sh 関連ファイル -.Bl -tag -width /var/tmp/local.XXXXXX -compact -.It Pa /var/tmp/local.XXXXXX +.Bl -tag -width /tmp/local.XXXXXX -compact +.It Pa /tmp/local.XXXXXX テンポラリファイル .It Pa /var/mail/user ユーザのメールボックスディレクトリ +.It Pa /var/mail/user.lock +ユーザメールボックスのロックファイル .El .Sh 関連項目 .Xr mail 1 , diff --git a/ja/man/man8/mailstats.8 b/ja/man/man8/mailstats.8 index 92733aec08..c218986b34 100644 --- a/ja/man/man8/mailstats.8 +++ b/ja/man/man8/mailstats.8 @@ -1,82 +1,88 @@ -.\"/* -.\" * Copyright (c) 1996 John M. Vinopal -.\" * 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 for the NetBSD Project -.\" * by John M. Vinopal. -.\" * 4. The name of the author may not be used to endorse or promote products -.\" * derived from this software without specific prior written permission. -.\" * -.\" * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 AUTHOR 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: mailstats.8,v 1.2.2.4 1997/11/10 03:00:05 peter Exp % +.\" Copyright (c) 1998 Sendmail, Inc. All rights reserved. +.\" +.\" By using this file, you agree to the terms and conditions set +.\" forth in the LICENSE file which can be found at the top level of +.\" the sendmail distribution. +.\" +.\" +.\" @(#)mailstats.8 8.5 (Berkeley) 5/19/98 +.\" +.Dd April 25, 1996 +.Dt MAILSTATS 1 +.Os BSD 3 .\" jpman %Id: mailstats.8,v 1.2 1997/05/21 07:42:38 yugawa Stab % .Dd August 13, 1996 .Dt MAILSTATS 8 .Os .Sh 名称 .Nm mailstats -.Nd sendmail の利用統計を表示する +.Nd メールの統計情報を表示する .Sh 書式 .Nm mailstats .Op Fl o -.Op Fl C Ar sendmail.cf -.Op Fl f Ar sendmail.st +.Op Fl C Ar cffile +.Op Fl f Ar stfile .Sh 解説 .Nm mailstats -は、sendmail を利用したメッセージのサイズなどの -統計情報をメーラ毎に表示します。 -出力の各行は、 -.Fl o -フラグが指定された場合を除き、 -メーラ番号、受け取ったメール数、受け取ったバイト数、 -送ったメール数、送ったバイト数、メーラの種類から構成されています。 -メーラの一般的な物には smtp や local (例えば、 -.Nm mail.local -等のローカルに配送されるメールを処理するプログラム) があります。 +は、現在のメールの統計情報を表示します。 .Pp -統計情報は +まず、統計が開始された時刻が +.Xr ctime 3 +で指定されるフォーマットで表示されます。 +次に、各メーラの状態が 1 行で表示されます。 +それぞれ空白で区切られた次のフィールドからなります: +.Pp +.Bl -tag -width 10n -offset indent -compact +.It Sy M +メーラ番号。 +.It Sy msgsfr +メーラからのメッセージ数。 +.It Sy bytes_from +メーラからのキロバイト数。 +.It Sy msgsto +メーラへのメッセージ数。 +.It Sy bytes_to +メーラへのキロバイト数。 +.It Sy Mailer +メーラ名。 +.El +.Pp +この表示の後、 +すべてのメーラの総計行が表示されますが、 +等号 +.Pq Dq \&= +文字のみからなる行によりその前の情報と分けられます。 +.Pp +オプションは以下の通りです: +.Bl -tag -width Ds +.It Fl C +デフォルトの +.Nm sendmail +.Dq cf +ファイルの代りに指定されたファイルを読みます。 +.It Fl f .Nm sendmail -統計ファイル -.Ar sendmail.st -から読み込まれます。 -.Ar sendmail.st -の場所は -.Ar sendmail.cf -で定義されていますが、 -.Fl f -フラグで指定することもできます。 -同様に、メーラの種類も -.Ar sendmail.cf -で定義されています。統計情報は、累積されていきます。情報をリセットするには -統計ファイルの内容を消す必要があります。 +.Dq cf +ファイルで指定されている統計情報ファイルの代りに、 +指定された統計情報ファイルを読みます。 +.It Fl o +出力においてメーラ名を表示しません。 +.El +.Pp +.Nm mailstats +は成功時には 0 で、エラー時には >0 で終了します。 .Sh 関連ファイル .Bl -tag -width /var/log/sendmail.st -compact .It Pa /etc/sendmail.cf -sendmail 設定ファイル +デフォルトの +.Nm sendmail +.Dq cf +ファイル .It Pa /var/log/sendmail.st -メール統計情報データベース +デフォルトの +.Nm sendmail +統計情報ファイル .El .Sh 関連項目 -.Xr mail.local 8 , +.Xr mailq.1 , .Xr sendmail 8 diff --git a/ja/man/man8/makekey.8 b/ja/man/man8/makekey.8 index bc4ac02327..4f87fc1da4 100644 --- a/ja/man/man8/makekey.8 +++ b/ja/man/man8/makekey.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)makekey.8 8.2 (Berkeley) 12/11/93 -.\" %Id: makekey.8,v 1.5.2.1 1997/12/15 07:13:45 charnier Exp % +.\" %Id: makekey.8,v 1.8 1997/11/24 07:29:12 charnier Exp % .\" jpman %Id: makekey.8,v 1.2 1997/05/21 07:56:47 yugawa Stab % .\" .Dd December 11, 1993 diff --git a/ja/man/man8/makemap.8 b/ja/man/man8/makemap.8 index d809083fd2..daee6c1071 100644 --- a/ja/man/man8/makemap.8 +++ b/ja/man/man8/makemap.8 @@ -1,35 +1,13 @@ +.\" Copyright (c) 1998 Sendmail, Inc. All rights reserved. .\" Copyright (c) 1988, 1991, 1993 .\" 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. +.\" By using this file, you agree to the terms and conditions set +.\" forth in the LICENSE file which can be found at the top level of +.\" the sendmail distribution. .\" -.\" 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. .\" -.\" @(#)makemap.8 8.4 (Berkeley) 7/23/97 +.\" @(#)makemap.8 8.10 (Berkeley) 5/19/98 .\" jpman %Id: makemap.8,v 1.3 1997/07/26 21:58:03 horikawa Stab % .\" .Dd November 16, 1992 @@ -45,6 +23,7 @@ .Op Fl f .Op Fl o .Op Fl r +.Op Fl s .Op Fl v .Ar maptype .Ar mapname @@ -74,13 +53,12 @@ ライブラリが必要です。 .It Li btree B-Treeフォーマットマップ。 -新しい Berkeley -.Xr db 3 +新しい Berkeley DB ライブラリが必要です。 .It Li hash ハッシュフォーマットマップ。 同じく -.Xr db 3 +Berkeley DB ライブラリが必要です。 .El .Pp @@ -122,93 +100,14 @@ B-Treeフォーマットマップでのみ可能です。 通常はすでに入力したキーをさらに繰り返して入力しても、 .Nm は警告を出力し、データベースには取り込みません。 +.It Fl s +生成されるマップの安全チェックを無視します。 +これには、 +だれでも書き込めるディレクトリへのハードリンクおよびシンボリックのチェックも +含まれます。 .It Fl v 処理の内容を詳細に表示します。 .El -.\" この部分の動作確認を FreeBSD2.1.0R にて行なっています。 -.\" Noritaka Ishizumi <graphite@jp.freebsd.org> -このプログラムは、 -.Pa sendmail.cf -を作成する際に、キー付きマップを使用する -場合に役に立ちます。 -.Pp -FreeBSD で使われている -.Xr sendmail 8 -はV8ですから、 -.Pa sendmail.cf -を作成 -するには、 -.Nm cf -(日本では CF と表記されるバージョンがある(CF-3.4W2.tar.gz))を使います。 -.Ss 使用例 -.Pa /usr/src/usr.sbin/sendmail/cf/cf -に -.Pa .mc -(マスターコンフィギュレーションファイル)があります。このディレクトリで、 -各自のマシンにあわせた設定を -.Pa yourhost.mc -に行い、``make yourhost.cf'' -とすることで -.Pa yourhost.cf -が作成されます。これを -.Pa /etc/sendmail.cf -などにコピーして使用します(実際に使用する前に、 -.Dq sendmail -bt -C./yourhoust.cf -などを実行して -.Pa yourhost.cf -が正しく作成されているかどうかをチェックしてください)。 -.Pp -ホスト名だけの名前から、ドメイン名付きの名前へマッピングを -.Nm sendmail -に提供する -方法の記述例を示します。 -.Pa yourhost.mc -に以下の記述を含めてください。 -.Pp -.Bd -literal -offset indent -LOCAL_RULE_3 -R$* < @ $+ > $* $: $1 < @ $(hostmap $2 $) > $3 -.Ed -.Pp -ここで、ローカルルールを定義しています。この内容はヘッダにも反映されます。 -さらに、 -.Pp -.Bd -literal -offset indent -LOCAL_CONFIG -Khostmap hash /etc/hostmap.db -Kyplocal nis -m hosts.byname -.Ed -.Pp -という記述を加えてください。1行目は、以下の設定がローカルな設定であることを -示しています。2行目が -.Nm makemap -を必要とする例です。3行目は、ホスト名の -マッピングを -.Tn NIS -からとってきます。 -.Pp -この設定を利用した -.Pa sendmail.cf -を実際に使うには、 -.Pa /etc/hostmap.db -を作成する必要があります。 -.Pp -.Bd -literal -offset indent -mercury% cd /etc -mercury% makemap hash hostmap -moon moon.silver-castle.millennium <- もちろん架空のドメインです -^D <- コントロール D(EOF文字) -.Ed -.Pp -これによって、たとえば、 -.Dq tsukino@moon -は -.Dq tsukino@moon.silver-castle.millennium -に変換されます。実際の使い方は、 -.Pa .mc -ファイルの設定によって変化します。 -.Pa sendmail/cf/README -などを参照してください。 .Sh 関連項目 .Xr sendmail 8 .Sh 歴史 diff --git a/ja/man/man8/makewhatis.local.8 b/ja/man/man8/makewhatis.local.8 index 74809c5ef6..6153590a6f 100644 --- a/ja/man/man8/makewhatis.local.8 +++ b/ja/man/man8/makewhatis.local.8 @@ -22,9 +22,9 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: makewhatis.local.8,v 1.2.2.1 1996/12/10 17:23:18 joerg Exp % +.\" %Id: makewhatis.local.8,v 1.6 1997/06/23 04:51:30 steve Exp % .\" jpman %Id: makewhatis.local.8,v 1.3 1997/09/09 03:59:22 yugawa Stab % -.Dd April, 26, 1996 +.Dd April 26, 1996 .Dt MAKEWHATIS.LOCAL 8 .Os FreeBSD 2.2 .Sh 名称 diff --git a/ja/man/man8/manctl.8 b/ja/man/man8/manctl.8 index d79479bf09..896018e459 100644 --- a/ja/man/man8/manctl.8 +++ b/ja/man/man8/manctl.8 @@ -22,17 +22,14 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: manctl.8,v 1.3.2.3 1998/03/09 13:51:08 jkh Exp % +.\" %Id: manctl.8,v 1.7 1997/09/25 06:38:17 charnier Exp % .\" jpman %Id: manctl.8,v 1.3 1997/08/16 13:22:57 horikawa Stab % - .Dd January 1, 1996 .Dt MANCTL 8 .Os FreeBSD - .Sh 名称 .Nm manctl .Nd マニュアルページの取り扱い - .Sh 書式 .Nm manctl .Op Fl compress diff --git a/ja/man/man8/map-mbone.8 b/ja/man/man8/map-mbone.8 index 7c801e96cc..e7ffb8a71a 100644 --- a/ja/man/man8/map-mbone.8 +++ b/ja/man/man8/map-mbone.8 @@ -1,98 +1,87 @@ -.TH MAP-MBONE 8 +.Dd May 8, 1995 +.Dt MAP-MBONE 8 .\" jpman %Id: map-mbone.8,v 1.2 1997/06/06 10:31:25 bobson Stab % -.UC 5 -.SH 名称 -map-mbone \- マルチキャストコネクションマップを表示する -.SH 書式 -.B /usr/sbin/map-mbone -[ -.B \-d -.I debug_level -] [ -.B \-f -] [ -.B \-g -] [ -.B \-n -] [ -.B \-r -.I retry_count -] [ -.B \-t -.I timeout_count -] [ -.B starting_router -] -.SH 解説 -.I map-mbone +.Sh 名称 +.Nm map-mbone +.Nd マルチキャストコネクションマッパ +.Sh 書式 +.Nm map-mbone +.Op Fl d Ar debug_level +.Op Fl f +.Op Fl g +.Op Fl n +.Op Fl r Ar retry_count +.Op Fl t Ar timeout_count +.Op Ar starting_router +.Sh 解説 +.Nm は、 -.I starting_router +.Ar starting_router で指定したマルチキャストルータから到達可能なすべてのマルチキャストルータに ついて表示します。 コマンドラインに何の指定もない場合、デフォルトのマルチキャストルータ -.I starting_router +.Ar starting_router は、ローカルホスト(localhost)になります。 -.PP -.I map-mbone +.Pp +.Nm は、ASK_NEIGHBORS IGMP メッセージを送信することで、 隣接するマルチキャストルータのデータ取得を行ないます。 指定したマルチキャストルータからの応答があった場合には、 その応答の中にあるバージョン番号と隣接するマルチキャストルータのアドレス一覧が 出力されます。応答したルータが、 最新のマルチキャストバージョン番号を持つ場合には、 -.I map-mbone +.Nm は、そのルータに対してメトリック、スレッショルド、フラグのような追加情報を 要求します。 隣接するマルチキャストルータに新たな事象が発生し、フルーディングオプションが 使用可能な場合、 -.I map-mbone +.Nm は、隣接するそれらのマルチキャストルータそれぞれに対して新たな情報を求めます。 また、マルチキャストルータの検索は、マルチキャストルータが それ以上みつからないという状態になるまで継続します。 -.br -.ne 5 -.SH オプション -.PP -"\-d" オプションは、デバッグレベルを設定します。デバッグレベルが +以下のオプションを使用可能です。 +.Bl -tag -width indent +.It Fl d +デバッグレベルを設定します。デバッグレベルが デフォルトレベルである 0 よりも大きい場合、追加デバッグメッセージが画面に 出力されます。デバッグレベルにかかわらず、エラーについてはエラーメッセージが 出力され、 -.I map-mbone +.Nm は終了します。 デバッグレベルが 0 でない場合、以下の効果があります。 -.IP "level 1" +.Bl -tag -width indent +.It "level 1" パケットの警告が標準エラー出力に対して出力されます。 -.IP "level 2" +.It "level 2" すべてのレベル 1 のメッセージに加えて、ネットワークダウンの情報が 標準エラー出力に対して出力されます。 -.IP "level 3" +.It "level 3" すべてのレベル 2 のメッセージに加えて、すべてのパケットタイムアウトの情報が 標準エラー出力に対して出力されます。 -.PP -"\-f" オプションは、フルーディングオプションを設定します。フルーディング +.El +.It Fl f +フルーディングオプションを設定します。フルーディング オプションを有効にすることで、再帰的に隣接するマルチキャストルータを検索 することを許可します。そして、starting_router が指定されない場合には、 このオプションはデフォルトでは有効になっています。 -.PP -"\-g" オプションは、GraphEdフォーマットにしたがったグラフ出力を有効にします。 -.PP -"\-n" オプションは、マルチキャストルータの名前の検索に DNS を使わないように +.It Fl g +GraphEdフォーマットにしたがったグラフ出力を有効にします。 +.It Fl n +マルチキャストルータの名前の検索に DNS を使わないように 設定します。 -.PP -"\-r retry_count" オプションは、隣接ルータに対するリトライ制限を設定します。 +.It Fl r Ar retry_count +隣接ルータに対するリトライ制限を設定します。 デフォルトではリトライ回数は 1 です。 -.PP -"\-t timeout_count" オプションは、リトライ間隔を秒単位で設定します。 +.It Fl t Ar timeout_count +リトライ間隔を秒単位で設定します。 デフォルトのリトライ間隔は 2 秒です。 -.PP -.SH 注意 -.I map-mbone +.El +.Sh 注意 +.Nm は root のみ実行可能です。 -.PP -.SH 関連項目 -.BR mrouted (8) , -.BR mrinfo (8) , -.BR mtrace (8) -.PP -.SH 作者 -Pavel Curtis +.Sh SEE ALSO +.Xr mrouted 8 , +.Xr mrinfo 8 , +.Xr mtrace 8 +.Sh 作者 +.An Pavel Curtis diff --git a/ja/man/man8/mknetid.8 b/ja/man/man8/mknetid.8 index fc936a7ce8..6bbbf411e4 100644 --- a/ja/man/man8/mknetid.8 +++ b/ja/man/man8/mknetid.8 @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: mknetid.8,v 1.1.1.1.2.2 1998/07/19 06:53:02 jkh Exp % +.\" %Id: mknetid.8,v 1.6 1998/05/05 00:12:01 rnordier Exp % .\" jpman %Id: mknetid.8,v 1.3 1997/08/16 13:26:57 horikawa Stab % .\" .Dd June 23, 1996 diff --git a/ja/man/man8/mknod.8 b/ja/man/man8/mknod.8 index 7d4887a501..43e61235f6 100644 --- a/ja/man/man8/mknod.8 +++ b/ja/man/man8/mknod.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)mknod.8 8.2 (Berkeley) 12/11/93 -.\" %Id: mknod.8,v 1.5.2.2 1998/07/17 20:13:27 jkh Exp % +.\" %Id: mknod.8,v 1.7 1998/07/06 07:06:15 charnier Exp % .\" jpman %Id: mknod.8,v 1.2 1997/03/31 13:37:12 horikawa Stab % .\" .Dd December 11, 1993 diff --git a/ja/man/man8/modload.8 b/ja/man/man8/modload.8 index 00dbce7c91..6ca9310a12 100644 --- a/ja/man/man8/modload.8 +++ b/ja/man/man8/modload.8 @@ -23,7 +23,7 @@ .\" (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: modload.8,v 1.7.2.2 1998/07/17 20:13:28 jkh Exp % +.\" %Id: modload.8,v 1.11 1998/03/19 07:45:37 charnier Exp % .\" jpman %Id: modload.8,v 1.2 1997/04/25 00:25:43 mutoh Stab % .\" .Dd September 22, 1994 diff --git a/ja/man/man8/modstat.8 b/ja/man/man8/modstat.8 index c28de3cdf2..b02faa2721 100644 --- a/ja/man/man8/modstat.8 +++ b/ja/man/man8/modstat.8 @@ -23,7 +23,7 @@ .\" (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: modstat.8,v 1.2.8.3 1998/07/17 04:19:33 jkh Exp % +.\" %Id: modstat.8,v 1.7 1998/03/23 07:44:51 charnier Exp % .\" jpman %Id: modstat.8,v 1.3 1997/09/08 07:02:33 seki Stab % .\" .Dd June 7, 1993 diff --git a/ja/man/man8/modunload.8 b/ja/man/man8/modunload.8 index 794bc787fa..dde9cea663 100644 --- a/ja/man/man8/modunload.8 +++ b/ja/man/man8/modunload.8 @@ -23,7 +23,7 @@ .\" (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: modunload.8,v 1.4.2.2 1998/07/17 20:13:28 jkh Exp % +.\" %Id: modunload.8,v 1.8 1998/03/19 07:45:43 charnier Exp % .\" jpman %Id: modunload.8,v 1.2 1997/04/30 00:37:42 mutoh Stab % .\" .Dd June 7, 1993 diff --git a/ja/man/man8/mount.8 b/ja/man/man8/mount.8 index 16800429b4..560241616f 100644 --- a/ja/man/man8/mount.8 +++ b/ja/man/man8/mount.8 @@ -29,12 +29,12 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" @(#)mount.8 8.7 (Berkeley) 3/27/94 -.\" %Id: mount.8,v 1.11.2.5 1998/08/12 06:19:35 charnier Exp % +.\" @(#)mount.8 8.8 (Berkeley) 6/16/94 +.\" %Id: mount.8,v 1.23 1998/07/09 05:49:58 jkoshy Exp % .\" .\" jpman %Id: mount.8,v 1.2 1997/05/03 11:26:50 horikawa Stab % .\" -.Dd March 27, 1994 +.Dd June 16, 1994 .Dt MOUNT 8 .Os BSD 4 .Sh 名称 @@ -77,10 +77,15 @@ オプションとしては以下のものがあります: .Bl -tag -width indent .It Fl a -.Pa /etc/fstab +.Xr fstab 5 に記述されているファイルシステムを -(``noauto'' が指定されているものは除いて) すべてマウントします。 +例外は、``noauto'' が指定されているもの、 +.Fl t +フラグにて除外されているもの(後述)、 +既にマウントされているもの +(ルートファイルシステムは伝統的なシングルユーザモードの動作を保つ +ために除外されます)です。 通常、これはシステムの起動時に実行されます。 .It Fl d システムコールの実行以外のすべてのことを行ないます。 @@ -124,6 +129,14 @@ 多くのファイルを持ち、(ほとんどの場合重要ではない)ファイルアクセス時刻 を更新するよりも性能が重要であるファイルシステムです。 このオプションは現在ローカルファイルシステムでのみサポートされています。 +.It noauto +mount が +.Fl a +フラグ付きで動作しているときに、このファイルシステムをスキップします。 +.It noclusterr +リード時のクラスタリングを無効にします。 +.It noclusterw +ライト時のクラスタリングを無効にします。 .It nodev ファイルシステム上のキャラクタスペシャルデバイスや ブロックスペシャルデバイスを解釈しません。 @@ -142,6 +155,8 @@ .Xr suidperl 1 のような suid/sgid ラッパが 誰でも使えるようにシステムにインストールされている場合には、価値がありません。 +.It nosymfollow +マウントされたファイルシステムにおいては、シンボリックリンクを追跡しません。 .It rdonly .Fl r と同じく、マウントするファイルシステムを読み込み専用とします @@ -150,6 +165,22 @@ ファイルシステムのすべての .Tn I/O を同期的に行います。 +.It suiddir +マウントされたファイルシステムにおけるディレクトリに +SUID ビットがセットされると、 +新規ファイルの所有者をディレクトリの所有者に設定します。 +新規ディレクトリは親ディレクトリのビットを継承します。 +実行ビットはファイルから取り除かれ、root には与えられません。 +.Pp +この機能は PC ユーザに対して ftp, SAMBA, netatalk のサービスを行う +ファイルサーバのためにデザインされました。 +これはシェルユーザに対してセキュリティホールとなりますので、 +特にホームディレクトリを持つシェルマシンでは使用すべきではありません。 +このオプションが動作するためには、カーネルの SUIDDIR オプションが必要です。 +UFS ファイルシステムのみがこのオプションをサポートします。 +詳細は +.Xr chmod 2 +を参照してください。 .It update .Fl u と同じく、すでにマウントされているファイルシステムの状態を変化させることを diff --git a/ja/man/man8/mount_ext2fs.8 b/ja/man/man8/mount_ext2fs.8 index 07347b755c..2637a7e714 100644 --- a/ja/man/man8/mount_ext2fs.8 +++ b/ja/man/man8/mount_ext2fs.8 @@ -29,6 +29,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" +.\" %Id: mount_ext2fs.8,v 1.5 1998/07/06 07:13:31 charnier Exp % .\" jpman %Id: mount_ext2fs.8,v 1.3 1997/09/09 04:07:26 yugawa Stab % .\" .Dd January 31, 1996 diff --git a/ja/man/man8/mount_msdos.8 b/ja/man/man8/mount_msdos.8 index 35fb78fd0c..a068107662 100644 --- a/ja/man/man8/mount_msdos.8 +++ b/ja/man/man8/mount_msdos.8 @@ -28,7 +28,7 @@ .\" (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: mount_msdos.8,v 1.3.2.1 1998/07/16 02:02:02 jkh Exp % +.\" %Id: mount_msdos.8,v 1.14 1998/06/30 06:23:41 charnier Exp % .\" jpman %Id: mount_msdos.8,v 1.3 1997/09/08 01:55:26 seki Stab % .\" .Dd April 7, 1994 diff --git a/ja/man/man8/mount_nfs.8 b/ja/man/man8/mount_nfs.8 index 2e3bc6ee33..339af14918 100644 --- a/ja/man/man8/mount_nfs.8 +++ b/ja/man/man8/mount_nfs.8 @@ -1,4 +1,4 @@ -.\" Copyright (c) 1992, 1993, 1994 +.\" Copyright (c) 1992, 1993, 1994, 1995 .\" The Regents of the University of California. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without @@ -29,12 +29,12 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" @(#)mount_nfs.8 8.2 (Berkeley) 3/27/94 +.\" @(#)mount_nfs.8 8.3 (Berkeley) 3/29/95 .\" -.\" %Id: mount_nfs.8,v 1.5.2.2 1998/07/07 04:52:54 jkoshy Exp % +.\" %Id: mount_nfs.8,v 1.14 1998/07/06 07:15:53 charnier Exp % .\" jpman %Id: mount_nfs.8,v 1.3 1997/05/19 17:04:14 horikawa Stab % .\"" -.Dd March 27, 1994 +.Dd March 29, 1995 .Dt MOUNT_NFS 8 .Os BSD 4.4 .Sh 名称 @@ -43,7 +43,7 @@ .Pp .Sh 書式 .Nm mount_nfs -.Op Fl 23KPTUbcdilqs +.Op Fl 23KNPTUbcdilqs .Op Fl D Ar deadthresh .Op Fl I Ar readdirsize .Op Fl L Ar leaseterm @@ -58,7 +58,7 @@ .Op Fl x Ar retrans .Ar rhost:path node .Sh 解説 -.Nm mount_nfs +.Nm は、ファイルシステムツリー上の指定された .Ar node にリモートの NFS ファイルシステム (rhost:path) をマウントするために、 @@ -75,6 +75,8 @@ Appendix I. .It Fl 2 NFS バージョン 2 プロトコルを使用します (デフォルトはバージョン 3 をまず試した後にバージョン 2 を用います)。 +NFS バージョン 2 では、 +ファイルサイズは 2 ギガバイトに制限されることに注意してください。 .It Fl 3 NFS バージョン 3 プロトコルを使用します。 .It Fl D @@ -102,8 +104,14 @@ readdir での読み取りサイズを指定した値にします。 NQNFS において、リース期間を指定した秒数にします。 応答遅延 (round trip delay) が大きな場合だけ使って下さい。 値は通常、10 秒から 30 秒の間です。 +.It Fl N +予約されたソケットポート番号を使用し +.Em ません +(後述)。 .It Fl P 予約されたソケットポート番号を使います。 +このフラグは廃れたものであり、互換性のためだけにあります。 +現在、予約されたソケットポート番号をデフォルトで使用します。 NFS がより安全になるとの考え方 (これは誤りです) に基づいて クライアントが予約ポートを使用しないとマウントさせないサーバ をマウントするのに役立ちます。 @@ -177,6 +185,20 @@ Kerberos の管理領域を文字列で指定します。 .It port=<port_number> 指定したポート番号を NFS 要求に使用します。 デフォルトでは portmapper に問い合わせます。 +.It acregmin=<seconds> +.It acregmax=<seconds> +.It acdirmin=<seconds> +.It acdirmax=<seconds> +ファイル属性がキャッシュされたときに、 +キャッシュエントリをエクスパイアするためにタイムアウトを計算します。 +これらの 4 つの値は、``ディレクトリ'' および ``通常'' (ディレクトリ以外) の +上限および下限を決定します。 +デフォルトでは、 +通常ファイルは 3 から 60 秒、 +ディレクトリは 30 から 60 秒です。 +タイムアウトの算出アルゴリズムはファイルの古さを元にするものです。 +ファイルが古くなると、キャッシュが有効であると見倣す期間も長くなり、 +上記限界に近付きます。 .El .Pp .Bl -tag -width "dumbtimerXX" @@ -184,7 +206,7 @@ Kerberos の管理領域を文字列で指定します。 .Pp これらのオプションを使用する事は勧められません。 歴史的な -.Nm mount_nfs +.Nm との互換性のためにここに記述してあります。 .It bg .Fl b diff --git a/ja/man/man8/mount_null.8 b/ja/man/man8/mount_null.8 index 214f7b0e4a..5136298d3b 100644 --- a/ja/man/man8/mount_null.8 +++ b/ja/man/man8/mount_null.8 @@ -34,16 +34,17 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" from: @(#)mount_null.8 8.4 (Berkeley) 4/19/94 -.\" %Id: mount_null.8,v 1.5.2.2 1998/08/12 06:28:38 charnier Exp % +.\" @(#)mount_null.8 8.6 (Berkeley) 5/1/95 +.\" %Id: mount_null.8,v 1.9 1998/07/06 07:17:26 charnier Exp % .\" jpman %Id: mount_null.8,v 1.2 1997/03/31 13:38:01 horikawa Stab % .\" -.Dd April 19, 1994 +.Dd May 1, 1995 .Dt MOUNT_NULL 8 .Os BSD 4.4 .Sh 名称 .Nm mount_null -.Nd 何もしない(null)ファイルシステム層の利用のデモ +.Nd ループバックファイルシステムサブツリーをマウントする; +何もしない(null)ファイルシステム層の利用のデモ .Sh 書式 .Nm mount_null .Op Fl o Ar options @@ -51,10 +52,22 @@ .Ar mount_point .Pp .Sh 解説 -.Nm mount_null +.Nm は、null 層を作ります。これは、 ファイルシステムの名前空間の部分木を、グローバルなファイルシステムの名前空間 の別の場所にエイリアスします。 +これにより、既存のファイルとディレクトリが別のパス名にてアクセス可能 +となります。 +.Pp +ファイルシステムの仮想的コピーとシンボリックリンクとの第 1 の違いは、 +.Xr getcwd 3 +関数が仮想コピーでは正しく動作する点と、 +別のファイルシステムを仮想コピー上にマウントしてもオリジナルには影響がない点 +です。 +.Xr stat 2 +は、仮想コピーに対して別のデバイス番号が返しますが、 +別の側面においてはオリジナルとの区別はつきません。 +.Pp 歴史的な ループバックファイルシステムと異なるのは、次の2つの点です: 1つは、ファイル システムのスタック化可能層(stackable layers)という技術を使って @@ -204,7 +217,7 @@ vnode 引数を下位層にマッピングします。 UCLA Technical Report CSD-910056, .Em "Stackable Layers: an Architecture for File System Development" . .Sh 歴史 -.Nm mount_null +.Nm は、 .Bx 4.4 から登場しました。 diff --git a/ja/man/man8/mount_portal.8 b/ja/man/man8/mount_portal.8 index b69734ad4e..b7a1d3107d 100644 --- a/ja/man/man8/mount_portal.8 +++ b/ja/man/man8/mount_portal.8 @@ -35,7 +35,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)mount_portal.8 8.3 (Berkeley) 3/27/94 -.\" %Id: mount_portal.8,v 1.2.2.1 1998/07/17 20:13:33 jkh Exp % +.\" %Id: mount_portal.8,v 1.3 1998/07/06 07:19:25 charnier Exp % .\" jpman %Id: mount_portal.8,v 1.2 1997/03/31 13:38:30 horikawa Stab % .\" .\" diff --git a/ja/man/man8/mount_std.8 b/ja/man/man8/mount_std.8 index 15976a3059..317a733429 100644 --- a/ja/man/man8/mount_std.8 +++ b/ja/man/man8/mount_std.8 @@ -34,7 +34,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: mount_std.8,v 1.3.2.3 1998/07/17 20:13:34 jkh Exp % +.\" %Id: mount_std.8,v 1.8 1998/07/15 06:08:46 charnier Exp % .\" jpman %Id: mount_std.8,v 1.3 1997/09/23 16:40:39 horikawa Stab % .\" .Dd May 13, 1996 diff --git a/ja/man/man8/mount_umap.8 b/ja/man/man8/mount_umap.8 index 54a4d49ff5..57adcb2775 100644 --- a/ja/man/man8/mount_umap.8 +++ b/ja/man/man8/mount_umap.8 @@ -33,10 +33,11 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" @(#)mount_umap.8 8.3 (Berkeley) 3/27/94 +.\" @(#)mount_umap.8 8.4 (Berkeley) 5/1/95 +.\" %Id: mount_umap.8,v 1.8 1998/07/15 06:12:31 charnier Exp % .\" jpman %Id: mount_umap.8,v 1.2 1997/04/12 15:56:14 horikawa Stab % .\" -.Dd "March 27, 1994" +.Dd May 1, 1995 .Dt MOUNT_UMAP 8 .Os BSD 4.4 .Sh 名称 @@ -46,71 +47,69 @@ .Sh 書式 .Nm mount_umap .Op Fl o Ar options +.Fl u Ar uid-mapfile +.Fl g Ar gid-mapfile .Ar target .Ar mount-point -.Ar uid-mapfile -.Ar gid-mapfile .Sh 解説 -.Nm mount_umap +.Nm は、ローカルシステムとは異なる uid, gid を使用するファイルシステムの サブトリーをマウントするために使用します。 そのようなファイルシステムには、別のサイトの NFS や 別のパスワードを使用する場所から持って来たリムーバブルメディア上の ファイルシステムです。 .Pp -以下のオプションを使用可能です: -.Bl -tag -width indent -.It Fl o -.Fl o -のあとに、コンマで区切ってオプション文字列を指定することができます。 -可能なオプションとその意味は -.Xr mount 8 -を参照してください。 -.El -.Pp -.Nm mount_umap +.Nm はユーザが提供するファイルのセットを使用し、 サブトリーの元の環境とローカルの環境との uid, gid の対応を取ります。 元の環境では smith は uid 1000 を持ち、ローカル環境では uid 2000 を持ちます。 -.Nm mount_umap +.Nm は、smith のオリジナルの環境で持っているファイルを次のようにマップさせます: uid 1000 が所有するファイルを、実際には uid 2000 が所有者である かのように見せます。 .Pp -.Em target -は、ローカルファイルシステム中での現在の位置を記述します。 -.Em mount_point -はマップされたサブトリーが置かれるディレクトリです。 -.Em uid-mapfile -と -.Em gid-mapfile -には、識別子の対応が記述されます。 +以下のオプションを使用可能です: +.Bl -tag -width indent +.It Fl o +.Fl o +のあとに、コンマで区切ってオプション文字列を指定することができます。 +可能なオプションとその意味は +.Xr mount 8 +を参照してください。 +.It Ar target +ローカルシステムの名前空間において、サブツリーの現在位置。 +.It Ar mount-point +マップされたサブツリーが置かれるディレクトリ。 +.It Fl u Ar uid-mapfile +.It Fl g Ar gid-mapfile +識別子の対応が記述されます。 それぞれのファイルの1行目には、そのファイルがいくつの対応を持っている かを記述します。 2行目からは、各行に対応を記述します。 -最初の項目はオリジナル環境での id で、次の項目がローカルな環境での idで、 +最初の項目はローカル環境での id で、次の項目がオリジナル環境での idで、 項目は空白で区切ります。 -.Em uid-mapfile +.Ar uid-mapfile にはすべての uid の対応を、 -.Em gid-mapfile +.Ar gid-mapfile にはすべての gid の対応を記述するべきです。 -.Em uid-mapfile +.Ar uid-mapfile に記載されない uid は NOBODY と、 -.Em gid-mapfile +.Ar gid-mapfile に記載されない gid は NULLGROUP と扱われます。 uid の対応は64個まで、gid の対応は16個まで記述することができます。 +.El .Pp マップファイルはファイル階層のどこにでも置くことができますが、 ファイルの所有者はrootで、rootのみが書き込めるようにしておかなければ なりません。 -.Nm mount_umap +.Nm は、もしこれらのファイルの所有者や権限が 不適切な場合はサブトリーをマップしません。 もしマップファイルの1行目の対応数と実際の対応数が異なる場合も、 実行を停止します。 .Pp -.Nm mount_umap +.Nm コマンドで作られるファイルシステム層は、簡単なファイルシステム層の 例となっています。商品としての利用は考えられていません。 そのため、あまり洗練された実装ではありません。 @@ -118,7 +117,7 @@ uid の対応は64個まで、gid の対応は16個まで記述することができます。 .Xr mount 8 , .Xr mount_null 8 .Sh 歴史 -.Nm mount_umap +.Nm は .Bx 4.4 から実装されました。 diff --git a/ja/man/man8/mount_union.8 b/ja/man/man8/mount_union.8 index 0031d5c023..bbce452ca0 100644 --- a/ja/man/man8/mount_union.8 +++ b/ja/man/man8/mount_union.8 @@ -33,6 +33,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)mount_union.8 8.6 (Berkeley) 3/27/94 +.\" %Id: mount_union.8,v 1.4 1998/07/15 06:13:45 charnier Exp % .\" jpman %Id: mount_union.8,v 1.3 1997/08/31 14:06:42 horikawa Stab % .\" .Dd March 27, 1994 @@ -48,7 +49,7 @@ .Ar directory .Ar uniondir .Sh 解説 -.Nm mount_union +.Nm コマンドは .Ar directory を @@ -140,7 +141,7 @@ union オプションでは、ユニオン効果はマウントポイントだけに働き、 コマンド .Bd -literal -offset indent mount -t cd9660 -o ro /dev/cd0a /usr/src -mount -t union -o /var/obj /usr/src +mount -t union /var/obj /usr/src .Ed .Pp は、CD-ROM ドライブ @@ -188,7 +189,7 @@ mount -t union -o -b /sys $HOME/sys を実行すると、上の層にシャドウディレクトリのツリーが 作成されてしまうという副作用があります。 .Sh 歴史 -.Nm mount_union +.Nm コマンドは .Bx 4.4 で初めて登場しました。 diff --git a/ja/man/man8/mountd.8 b/ja/man/man8/mountd.8 index acd10cb1df..4c56fa99ee 100644 --- a/ja/man/man8/mountd.8 +++ b/ja/man/man8/mountd.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)mountd.8 8.4 (Berkeley) 4/28/95 -.\" %Id: mountd.8,v 1.5.2.5 1998/07/30 02:11:58 alex Exp % +.\" %Id: mountd.8,v 1.13 1998/07/15 06:21:39 charnier Exp % .\" .\" jpman %Id: mountd.8,v 1.3 1997/05/19 17:06:05 horikawa Stab % .\" @@ -44,7 +44,7 @@ マウント要求に対するサービスを行うデーモン .Sh 書式 .Nm mountd -.Op Fl 2dnr +.Op Fl 2dlnr .Op Ar exportsfile .Sh 解説 .Nm @@ -71,6 +71,10 @@ プロトコルのみの使用を強制できます。 .It Fl d デバッグ情報を出力します。 +.It Fl l +成功した +.Nm +要求を記録します。 .It Fl n 非ルートからのマウント要求を許可します。 このオプションは、 diff --git a/ja/man/man8/moused.8 b/ja/man/man8/moused.8 index 5bf272b533..2150d6bda5 100644 --- a/ja/man/man8/moused.8 +++ b/ja/man/man8/moused.8 @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: moused.8,v 1.1.2.5 1998/03/13 11:21:15 yokota Exp % +.\" %Id: moused.8,v 1.15 1998/06/14 20:05:26 ahasty Exp % .\" .\" jpman %Id: moused.8,v 1.3 1997/07/22 16:52:17 horikawa Stab % .Dd December 3, 1997 @@ -263,6 +263,8 @@ ALPS GlidePoint プロトコル。 Kensington ThinkingMouse プロトコル。 .It Ar mmhittab Hitachi タブレットプロトコル。 +.It Ar x10mouseremote +X10 MouseRemote。 .El .Pp バスおよび InPort マウス: @@ -452,6 +454,8 @@ PS/2 マウスドライバ 現在実行中の .Nm デーモンのプロセス ID +.It Pa /var/run/MouseRemote +X10 MouseRemote のイベントのための UNIX ドメインストリームソケット .El .Sh 使用例 .Pp @@ -546,13 +550,13 @@ Z 軸における正の移動をボタン 5 が押されたものとします。 .Sh 作者 .Nm コマンドは、 -.An Michael Smith +.An Michael Smith Aq msmith@FreeBSD.org によって書かれました。 このマニュアルは、 .An Mike Pritchard .Aq mpp@FreeBSD.org によって書かれました。 コマンドとマニュアルページを、 -.An Kazutaka YOKOTA Aq yokota@FreeBSD.org +.An Kazutaka Yokota Aq yokota@FreeBSD.org が更新しました。 .Sh 歴史 .Nm diff --git a/ja/man/man8/mrinfo.8 b/ja/man/man8/mrinfo.8 index b52d6c5ded..1b990e94ca 100644 --- a/ja/man/man8/mrinfo.8 +++ b/ja/man/man8/mrinfo.8 @@ -1,29 +1,22 @@ .\" jpman %Id: mrinfo.8,v 1.2 1997/05/25 15:18:08 horikawa Stab % -.TH MRINFO 8 -.UC 5 -.SH 名称 -mrinfo \- マルチキャストルータの設定情報を表示する -.SH 書式 -.B /usr/sbin/mrinfo -[ -.B \-d -.I debug_level -] [ -.B \-r -.I retry_count -] [ -.B \-t -.I timeout_count -] -.B multicast_router - -.SH 解説 -.I mrinfo +.Dd May 8, 1995 +.Dt MRINFO 8 +.Sh 名称 +.Nm mrinfo +.Nd マルチキャストルータの設定情報を表示する +.Sh SYNOPSIS +.Nm mrinfo +.Op Fl d Ar debug_level +.Op Fl r Ar retry_count +.Op Fl t Ar timeout_count +.Ar multicast_router +.Sh 解説 +.Nm は、 -.I multicast_router +.Ar multicast_router で指定したマルチキャストルータの設定情報を表示します。 -.PP -.I mrinfo +.Pp +.Nm は、ASK_NEIGHBORS IGMP メッセージを送信することで隣接するマルチキャスト ルータのデータ取得を行ないます。指定したマルチキャストルータからの応答が あった場合には、バージョン番号と隣接するマルチキャストルータのアドレス一 @@ -33,43 +26,44 @@ mrinfo \- マルチキャストルータの設定情報を表示する はメトリック、スレッシュホールド、フラグのような追加情報を要求します。指 定したマルチキャストルータからの返答があると、当該ルータから取得した設定 情報が標準出力に表示されます。 -.br -.ne 5 -.SH 起動 -.PP -"\-d" オプションはデバッグレベルを設定します。デバッグレベルがデフォルト +.Pp +以下のオプションを使用可能です: +.Bl -tag -width indent +.It Fl d +デバッグレベルを設定します。デバッグレベルがデフォルト レベルであるところの 0 よりも大きい場合、追加デバッグメッセージが画面に出力 されます。デバッグレベルにかかわらず、エラーについてはエラーメッセージ が出力され、 -.I mrinfo +.Nm は終了します。 デバッグレベルが 0 でない場合、以下の効果が期待できます: -.IP "level 1" +.Bl -tag -width indent +.It "level 1" パケットウォーニングが標準エラー出力に対して出力されます。 -.IP "level 2" +.It "level 2" レベル 1 のすべてのメッセージに加えて、ネットワークダウンについて標準エラー 出力に対して出力されます。 -.IP "level 3" +.It "level 3" レベル 2 のすべてのメッセージに加えて、パケットタイムアウトのすべての情報が 標準エラー出力に対して出力されます。 -.PP -"\-r retry_count" オプションは隣接ルータに対するリトライ制限を設定します。 +.El +.It Fl r Ar retry_count +隣接ルータに対するリトライ制限を設定します。 デフォルトではリトライ回数は 3 です。 -.PP -"\-t timeout_count" -オプションは隣接ルータからの返答を待つ時間(タイムアウト)を秒単位で設定 +.It Fl t Ar timeout_count +隣接ルータからの返答を待つ時間(タイムアウト)を秒単位で設定 します。デフォルトのタイムアウトは 4 秒です。 -.PP -.SH 出力例 +.El +.Sh 出力例 .nf -.I mrinfo mbone.phony.dom.net +.Nm mrinfo mbone.phony.dom.net 127.148.176.10 (mbone.phony.dom.net) [version 3.3]: 127.148.176.10 -> 0.0.0.0 (?) [1/1/querier] 127.148.176.10 -> 127.0.8.4 (mbone2.phony.dom.net) [1/45/tunnel] 127.148.176.10 -> 105.1.41.9 (momoney.com) [1/32/tunnel/down] 127.148.176.10 -> 143.192.152.119 (mbone.dipu.edu) [1/32/tunnel] .fi -.PP +.Pp 指定したマルチキャストルータに隣接する個々のルータの IP アドレスが 表示されます。 指定したルータの IP アドレスに続き、隣接するルータの IP アドレスと名前 @@ -77,15 +71,12 @@ mrinfo \- マルチキャストルータの設定情報を表示する ホールド(マルチキャストパケット生存時間)が表示されます。問い合わせを受けた マルチキャストルータが新しいバージョンの場合には、接続タイプ(tunnel, srcrt) および接続状態(disabled, down)が表示されます。 -.PP -.SH 注意 -.I mrinfo +.Sh 注意 +.Nm は、root で実行して下さい。 -.PP -.SH 関連項目 -.BR mrouted (8) , -.BR map-mbone (8) , -.BR mtrace (8) -.PP -.SH 作者 -Van Jacobson +.Sh 関連項目 +.Xr mrouted 8 , +.Xr map-mbone 8 , +.Xr mtrace 8 +.Sh 作者 +.An Van Jacobson diff --git a/ja/man/man8/mrouted.8 b/ja/man/man8/mrouted.8 index 6e15548622..99b0e26471 100644 --- a/ja/man/man8/mrouted.8 +++ b/ja/man/man8/mrouted.8 @@ -1,32 +1,25 @@ -'\"COPYRIGHT 1989 by The Board of Trustees of Leland Stanford Junior University. -'\"%Id: mrouted.8,v 1.5.2.2 1997/02/02 01:01:50 mpp Exp % +.\"%Id: mrouted.8,v 1.10 1997/09/30 06:15:10 charnier Exp % .\" jpman %Id: mrouted.8,v 1.3 1997/07/26 22:00:11 horikawa Stab % -.TH MROUTED 8 -.UC 5 -.SH 名称 -mrouted \- IP マルチキャストルーティングデーモン -.SH 書式 -.B mrouted -[ -.B \-p -] [ -.B \-c -.I config_file -] [ -.B \-d -[ -.I debug_level -]] -.SH 解説 -.I mrouted +.Dd May 8, 1995 +.Dt MROUTED 8 +.Sh 名称 +.Nm mrouted +.Nd IP マルチキャストルーティングデーモン +.Sh 書式 +.Nm mrouted +.Op Fl c Ar config_file +.Op Fl d Op Ar debug_level +.Op Fl p +.Sh 解説 +.Nm は、RFC1075 にて規定されている Distance-Vector Multicast Routing Protocol (DVMRP) の実装です。本コマンドは distance-vector routing protocol (RIP に似たプロトコルであり、RFC1058 に記述されています) を使うことで、ネットワークトポロジに関する情報を管理し、 そのプロトコルの上で、Reverse Path Multicasting と呼ばれる マルチキャストデータグラムフォワーディングアルゴリズムを実装しています。 -.PP -.I mrouted +.Pp +.Nm は、マルチキャストデータグラムを、データグラムが生成されたサブネットを幹と して樹状に構成されるパス上に、パスの最短距離を通過するようにして送出します。 マルチキャストツリーは目的のグループを含むサブネットを越えないブロード @@ -35,13 +28,13 @@ mrouted \- IP マルチキャストルーティングデーモン ません。 さらに、マルチキャストデータグラムパケットの生存時間によっては、到達で きる範囲が限定される場合もあります。 -.PP +.Pp IP マルチキャストをサポートしない (ユニキャスト) ルータを介したサブネット間で、 マルチキャストを実現する場合、 -.I mrouted +.Nm の実装にはトンネリングのサポートも含まれます。トンネリングとは、 インターネットのあらゆるところにて稼働している -.I mrouted +.Nm の組の間で仮想的なポイントツーポイントリンクを確立する技術です。 IP マルチキャストパケットは、トンネルを通過するところでカプセル化されます。 カプセル化されたパケットは、 @@ -52,15 +45,15 @@ IP マルチキャストパケットは、トンネルを通過するところでカプセル化されます。 を用いることでカプセル化を 行ないます。 古いバージョンの -.I mrouted +.Nm のトンネリングは、 IP ソースルーティングを用いたものですが、 本手法はルータによっては大きな負荷をかけることになります。 本バージョンでは、IP ソースルーティングを用いたトンネリングは サポートしません。 -.PP +.Pp トンネリング機構の実装により、 -.I mrouted +.Nm は、 実際のインターネットとは独立の、 マルチキャストパケットのみを扱う広範囲の自立システムに跨る @@ -69,55 +62,71 @@ IP ソースルーティングを用いたものですが、 実験的ではあるが、インターネットマルチキャストをサポートし、 (ユニキャスト)ルータによるマルチキャストルーティング を可能にします。 -.I mrouted +.Nm は deistance vector ルーティングプロトコルが持つ よく知られたスケーリングの問題の影響を被りますし、 階層的なマルチキャストルーティングを (まだ) サポートしていません。 -.PP -.I mrouted +.Pp +.Nm はマルチキャストルーティングのみを扱いますので、同じ機械の上でユニキャ ストルーティングソフトが走っていてもいなくても構いません。 トンネリングを利用すれば、 -.I mrouted +.Nm はマルチキャストフォーワーディングのためにひとつより多くの 物理的なサブネットにアクセスする必要がありません。 -.br -.ne 5 -.SH 起動オプション -.PP -"\-d" オプションが与えられないか、もしくは debug level として 0 が指定された +.Pp +以下のオプションを使用可能です: +.Bl -tag -width indent +.It Fl c Ar config_file +別の設定コマンドファイルを指定します。 +デフォルトは +.Pa /etc/mrouted.conf +です。 +.Fl d +オプションが与えられないか、もしくは debug level として 0 が指定された 場合、 -.I mrouted +.Nm は起動された端末から切り離されます。それ以外の場合は、 -.I mrouted +.Nm は、起動された端末に残り、起動された端末からの割り込みを受け付けます。 -"\-d" が引数なしで指定された場合の debug level はデフォルトの 2 です。 +.Fl d +が引数なしで指定された場合の debug level はデフォルトの 2 です。 debug level の指定の有無にかかわらず、 -.I mrouted +.Nm は常に警告メッセージやエラーメッセージを syslogd に対して送ります。 0 以外の debug level が指定された場合、以下の挙動を示します: -.IP "level 1" +.Bl -tag -width indent +.It "level 1" すべての syslog へ出力されるメッセージは、stderr へも出力されます。 -.IP "level 2" +.It "level 2" debug level 1での挙動に加え、重要と思われる挙動通知を stderr に出力します。 -.IP "level 3" +.It "level 3" debug level 2 での挙動に加え、すべてのパケット送出/到着について stderr に出力します。 -.PP -起動にともない、mrouted はその pid を /var/run/mrouted.pid ファイルに +.El +.It Fl p +枝苅りを抑止します。 +.El +起動にともない、 +.Nm +はその pid を +.Pa /var/run/mrouted.pid +ファイルに 書き出します。 -.SH 初期設定 -.PP -.I mrouted +.Sh 初期設定 +.Nm は、自動的にすべてのマルチキャスト可能なインタフェース、 つまり、IFF_MULTICAST フラグがセットされたインタフェース (ループバックインタフェースは除きます) に対して初期化を行い、別の -.IR mrouted +.Nm に直接接続可能なインタフェースを探索します。 デフォルトの設定を上書きする、あるいは別の -.IR mrouted +.Nm に対するトンネルリンクを付加するには、 -/etc/mrouted.conf (もしくは "\-c" オプションによって指定されるファイル) +.Pa /etc/mrouted.conf +(もしくは +.Fl c +オプションによって指定されるファイル) を編集します。 コンフィグレーションのためには以下の 4 種類のコマンドがあります。 .nf @@ -136,14 +145,14 @@ debug level 2 での挙動に加え、すべてのパケット送出/到着について stderr name <boundary-name> <scoped-addr>/<mask-len> .fi -.PP +.Pp ファイルの形式は自由です。すなわち、空白文字 (改行も含みます) は意味を 持ちません。 -.I boundary +.Em boundary と -.I altnet +.Em altnet オプションは必要な数だけ指定して下さい。 -.PP +.Pp phyint コマンドはローカル IP アドレス <local-addr> によって認識される 物理インタフェース上のマルチキャストルーティングを無効にするか、 デフォルトでない metric あるいは threshold を @@ -153,7 +162,7 @@ phyint コマンドはローカル IP アドレス <local-addr> によって認識される phyint が複数の IP からなるサブネットに向けられる場合、 altnet キーワードを使用してそれぞれのサブネットについて記述して下さい。 phyint コマンドは tunnel コマンドより前に書く必要が有ります。 -.PP +.Pp tunnel コマンドはローカル IP アドレス <local-addr> と リモート IP アドレス <remote-addr> とを結ぶトンネルリンクを作り、 デフォルトでない metric あるいは threshold をそのトンネルに結びつけます。 @@ -162,30 +171,33 @@ tunnel コマンドはローカル IP アドレス <local-addr> と リモート IP アドレス <remote-addr> は、 ホスト名に結びつけられた IP アドレスが 1 つである場合に限り、 ホスト名で置き換えても構いません。 -双方のルータの mrouted.conf ファイルにおいて、 +双方のルータの +.Pa mrouted.conf +ファイルにおいて、 そのトンネルが使用される前に記述されている必要があります。 -.PP +.Pp cache_lifetime はキャッシュされたマルチキャスト経路がタイムアウトまで に kernel 内にどれだけ保持されるかを定めます。この変数は 300 (5 分) か ら 86400 (1 日) の間がいいでしょう。デフォルトは 300 です。 -.PP +.Pp 設定をキーワードを用いて簡単に行うために、境界に名前をつけることもでき ます。phyint あるいは tunnel コマンドの boundary オプションは 名前もしくは boundary のいずれかを受け付けます。 -.PP +.Pp metric は与えられたインタフェースかトンネルへデータグラムを送るため -の "コスト" です; 経路の選択に影響を与えます。 +の +\&"コスト" です; 経路の選択に影響を与えます。 デフォルト値は 1 です。metric は可能なかぎり小さくすべきです。 なぜなら、 -.I mrouted +.Nm は metric の合計が 31 を越える経路を通ることができないからです。 -.PP +.Pp advert_metric は、与えられたインタフェースもしくは tunnel に関連する -"コスト" です; +\&"コスト" です; これは経路選択に影響します。 advert_metric のデフォルト値は 0 です。 リンクの実際の metric は一端の metric ともう一端の advert_metric との和です。 -.LP +.Pp threshold は最小の IP の生存時間であり、 この要件を満たすマルチキャストデータグラムは 指定されるインタフェースもしくはトンネルを転送されます。 @@ -194,30 +206,29 @@ threshold は最小の IP の生存時間であり、 threshold だけ TTL を減らしたりはしません。 すべてのマルチキャストルータは TTL を 1 づつ減らします。) デフォルト値は 1 です。 -.LP +.Pp 特定のサブネットやトンネルへ接続する -.IR mrouted +.Nm は、一般的にはすべて同じ metric と threshold を持ちます。 -.PP +.Pp rate_limit オプションによって、ネットワークの管理者はマルチキャスト トラフィックのために何キロビット毎秒のバンド幅をわりあてればよいかを指定 できます。デフォルト値は、トンネルは 500Kbps、 物理インタフェースは 0 (無制限) です。 -.PP +.Pp boundary オプションは、ある範囲のアドレスに対して、管理可能な境界を設 定します。この範囲のアドレスに属するパケットは範囲内のインタフェース には転送されません。boundary オプションは名前もしくは境界にて指定します。 -.PP -.I mrouted +.Pp +.Nm は 2 つ以上の有効な vif (仮想インタフェース) が無いときには実行を開始しません。 vif はマルチキャスト可能な物理インタフェースもしくはトンネルです。 全ての仮想インタフェースがトンネルの場合は警告が記録されます; そのような -.I mrouted +.Nm の設定は、より多くの直接トンネルを指定した方が良いかもしれません (中間管理者を削除するという意味です)。 -.SH 設定例 -.PP +.Sh 設定例 以下は大きな学校にある架空のマルチキャストルータでの例です。 .sp .nf @@ -254,37 +265,40 @@ tunnel 192.168.5.4 192.168.55.101 metric 1 threshold 1 tunnel 192.168.5.4 10.11.12.13 metric 1 threshold 32 boundary LOCAL boundary EE .fi -.SH シグナル -.PP -.I mrouted +.Sh シグナル +.Nm は以下のシグナルに反応します。 -.IP HUP -.I mrouted +.Bl -tag -width indent +.It HUP +.Nm を再スタートします。 設定ファイルは再度読み込まれます。 -.IP INT +.It INT 後かたづけをしてから実行終了します (たとえば、隣接するルータすべてにさよならのメッセージを送ります)。 -.IP TERM +.It TERM INT と同じです。 -.IP USR1 -内部ルーティングテーブルを /var/tmp/mrouted.dump にダンプし -ます。 -.IP USR2 -内部キャッシュテーブルを /var/tmp/mrouted.cache にダンプしま -す。 -.IP QUIT +.It USR1 +内部ルーティングテーブルを +.Pa /var/tmp/mrouted.dump +にダンプします。 +.It USR2 +内部キャッシュテーブルを +.Pa /var/tmp/mrouted.cache +にダンプします。 +.It QUIT 内部ルーティングテーブルを stderr にダンプします。 ただし、 -.I mrouted +.Nm が 0 以外の debug level の時のみです。 -.PP +.El +.Pp シグナルを送る際の便宜のために、 -.I mrouted -は開始時に自身の pid を /var/run/mrouted.pid に書き出します。 -.bp +.Nm +は開始時に自身の pid を +.Pa /var/run/mrouted.pid +に書き出します。 .SH 使用例 -.PP ルーティングテーブルは以下のようになります: .nf @@ -330,13 +344,14 @@ vif 0 と vif 1 がつながったサブネットには いくつかのグループが有ります; トンネルにはグループは有りません。 この例の -.I mrouted -は、"querier" フラグが示すように、 +.Nm +は、 +\&"querier" フラグが示すように、 定期的なグループメンバシップクエリを vif 0 および vif 1 サブネットにて 送出する責任が有ります。 境界のリストは当該インタフェースのアドレス範囲が示されます。 入力及び出力パケット数が各インタフェースに対して示されます。 -.PP +.Pp マルチキャストデータグラムの起源となりうるサブネットに関連して 表示される情報は、 直前のホップのルータのアドレス(サブネットが直接接続されていない場合)、 @@ -344,19 +359,18 @@ vif 0 と vif 1 がつながったサブネットには 当該サブネットから最後に更新を受信してから経過した時間、 当該起源からのマルチキャストが入力される vif、 出力 vif 一覧です。 -"*" は、 +\&"*" は、 起源を根とするブロードキャストツリーの葉に、 当該出力 vif が接続していることを意味します。 宛先グループのメンバが当該葉にいる時のみ、 当該起源からのマルチキャストデータグラムを当該出力 vif からフォワードします。 -.bp -.PP -.I mrouted +.Pp +.Nm はカーネル内のフォワーディングキャッシュテーブルも管理します。 エントリの生成及び削除は -.I mrouted +.Nm が行います。 -.PP +.Pp キャッシュテーブルは以下のようなものです: .nf @@ -375,25 +389,31 @@ Multicast Routing Cache Table (147 entries) .fi 各エントリは起源のサブネット番号、マスク、宛先マルチキャストグループにて 区別します。 -'CTmr' フィールドは当該エントリの生存時間を表します。 +.Pp +\&'CTmr' フィールドは当該エントリの生存時間を表します。 このタイマ値が 0 まで減算されたエントリはキャッシュテーブルから削除されます。 -'Age' フィールドはこのエントリが最初に生成されてから経過した時間を表します。 +.Pp +\&'Age' フィールドはこのエントリが最初に生成されてから経過した時間を表します。 キャッシュエントリはリフレッシュされるため、 当該エントリに関するトラフィックが続く限りルーティングエントリは生き残ります。 -'Ptmr' フィールドは、上流に枝刈が送出されていなければ単に -、 +.Pp +\&'Ptmr' フィールドは、上流に枝刈が送出されていなければ単に -、 そうでないばあいには上流の枝刈がタイムアウトするまでの時間を表します。 -'Ivif' フィールドは起源からのマルチキャストパケットが入力される vif +.Pp +\&'Ivif' フィールドは起源からのマルチキャストパケットが入力される vif を表します。 各ルータは特定のソース及びグループに関し、 隣接するルータより受信する枝刈数の記録も管理します。 あるサブネットに関してマルチキャストツリーの下流の枝において マルチキャストグループのメンバが存在しない場合、 上流のルータに対して枝刈メッセージが送信されます。 -この場合、vif 番号の後に "P" が付けられます。 -'Forwvifs' フィールドは +この場合、vif 番号の後に +\&"P" が付けられます。 +.Pp +\&'Forwvifs' フィールドは ソースグループに属するデータグラムがフォワードされる インタフェースを表します。 -"p" は、このインタフェースを介してフォワードされるデータグラムが存在しない +\&"p" は、このインタフェースを介してフォワードされるデータグラムが存在しない ことを表します。 リストされないインタフェースは葉のサブネットであり、 特定のグループのメンバを当該サブネットに持ちません。 @@ -401,9 +421,22 @@ Multicast Routing Cache Table (147 entries) 当該インタフェースが境界インタフェースであることを表します。 すなわち、範囲内のアドレスのトラフィックは 当該インタフェースを介してフォワードされないことを意味します。 -">" を最初の文字として表示する追加の行は、当該サブネット上のソースと表します。 +.Pp +\&">" を最初の文字として表示する追加の行は、 +当該サブネット上のソースと表します。 一つのサブネット上に複数のソースが存在可能であることに注意して下さい。 -.SH 関連ファイル +.Sh 関連ファイル +.Bl -tag -width /var/tmp/mrouted.cache -compact +.It Pa /etc/mrouted.conf +.It Pa /var/run/mrouted.pid +.It Pa /var/tmp/mrouted.dump +.It Pa /var/tmp/mrouted.cache +.El +.Sh 関連項目 +.Xr mrinfo 8 , +.Xr mtrace 8 , +.Xr map-mbone 8 +.Pp /etc/mrouted.conf .br /var/run/mrouted.pid @@ -411,16 +444,17 @@ Multicast Routing Cache Table (147 entries) /var/tmp/mrouted.dump .br /var/tmp/mrouted.cache -.SH 関連項目 .BR mrinfo (8) , .BR mtrace (8) , .BR map-mbone (8) -.sp +.Pp DVMRP は、 他のマルチキャスト経路制御アルゴリズムと共に、 ACM SIGCOMM '88 コンファレンスのプロシーディングに、 S. Deering が -"Multicast Routing in Internetworks and Extended LANs" +\&"Multicast Routing in Internetworks and Extended LANs" として記述しています。 .SH 作者 -Steve Deering, Ajit Thyagarajan, Bill Fenner +.An Steve Deering , +.An Ajit Thyagarajan , +.An Bill Fenner diff --git a/ja/man/man8/mtrace.8 b/ja/man/man8/mtrace.8 index 31507cbc7f..b694347df1 100644 --- a/ja/man/man8/mtrace.8 +++ b/ja/man/man8/mtrace.8 @@ -32,322 +32,275 @@ .\" mtrace.8,v 5.1 1996/12/19 21:31:26 fenner Exp .\" .\" jpman %Id: mtrace.8,v 1.3 1997/08/20 12:03:14 horikawa Stab % -.TH MTRACE 8 "May 8, 1995" +.Dd May 8, 1995 +.Dt MTRACE 8 .UC 6 -.SH 名称 -mtrace \- 発信元から受信側へのマルチキャストのパスを表示する -.SH 形式 -.B mtrace -[ -.B \-e -.I extrahops -] [ -.B \-g -.I gateway -] [ -.B \-i -.I if_addr -] [ -.B \-l -] [ -.B \-M -] [ -.B \-m -.I max_hops -] [ -.B \-n -] [ -.B \-O -] [ -.B \-p -] [ -.B \-P -] [ -.B \-q -.I nqueries -] [ -.B \-r -.I resp_dest -] [ -.B \-s -] [ -.B \-S -.I stat_int -] [ -.B \-t -.I ttl -] [ -.B \-T -] [ -.B \-U -] [ -.B \-v -] [ -.B \-w -.I waittime -] -.I source -[ -.I receiver -] [ -.I group -] -.SH 解説 -IP マルチキャストのトラフィックの配送における問題点を突き止めるのは困 -難な作業です。 -.B mtrace -は IGMP プロトコルの拡張機能によってアクセスされる、マルチキャストルー -タに実装されたトレース機能を利用します。 -.I receiver +.Sh 名称 +.Nm mtrace +.Nd 発信元から受信側へのマルチキャストの経路を表示する +.Sh 書式 +.Nm mtrace +.Op Fl e Ar extrahops +.Op Fl g Ar gateway +.Op Fl i Ar if_addr +.Op Fl l +.Op Fl M +.Op Fl m Ar max_hops +.Op Fl n +.Op Fl O +.Op Fl p +.Op Fl P +.Op Fl q Ar nqueries +.Op Fl r Ar resp_dest +.Op Fl s +.Op Fl S Ar stat_int +.Op Fl t Ar ttl +.Op Fl T +.Op Fl U +.Op Fl v +.Op Fl w Ar waittime +.Ar source +.Op Ar receiver +.Op Ar group +.Sh 解説 +IP マルチキャストのトラフィックの配送における問題点を突き止めるのは困難な +作業です。 +.Nm mtrace +は IGMP プロトコルの拡張機能によってアクセスされる、 +マルチキャストルータに実装されたトレース機能を利用します。 +.Ar receiver から -.I source -への逆のパスに沿ったホップごとにトレースの問い合わせを行ない、パス上の +.Ar source +への逆経路に沿ったホップごとにトレースの問い合わせを行ない、経路上の ホップのアドレス、パケット数、ルーティングのエラー状況の情報を収集し、 要求者へ応答を返します。 -.PP -唯一必須であるパラメータは -.I source +.Pp +唯一必須である引数は +.Ar source のホスト名もしくはアドレスです。デフォルトの -.I receiver +.Ar receiver は mtrace を実行しているホストとなり、デフォルトの -.I group +.Ar group は "MBone Audio" (224.2.0.1) となります。特定のマルチキャストグループ でのパケット消失の統計が必要でなければ、これで十分です。以下に解説され ているいくつかの制約を条件として、特定の group でのいくつかの他の -receiver をテストするために、これらの 2 つのオプションのパラメータを指 -定することができます。 -.I receiver +receiver をテストするために、これらの 2 つのオプションの引数を +指定することができます。 +.Ar receiver はユニキャストアドレスであり、 -.I group -はマルチキャストアドレスであることより、これらの 2 つのパラメータは区 -別することができます。 -.B \-g -フラグが指定されると、source アドレスには mtrace が実行されているホス -トがデフォルトとして使われ、 receiver には -.B \-g +.Ar group +はマルチキャストアドレスであることより、これらの 2 つの引数を +区別することができます。 +.Fl g +フラグが指定されると、source アドレスには +.Nm mtrace +が実行されているホストがデフォルトとして使われ、 receiver には +.Fl g フラグで指定されるルータがデフォルトとして使われます。この場合、必須の -パラメータはありません。 -.PP +引数はありません。 +.Pp 注釈: Solaris 2.4/2.5 ではマルチキャストインタフェースがデフォルトの -インタフェースでなければ、 -i オプションによってローカルアドレスをセット -しなければなりません。 -.SH オプション -.TP 8 8 -.BI \-e\ extrahops +インタフェースでなければ、 +.Fl i +オプションによってローカルアドレスをセットしなければなりません。 +.Pp +以下のオプションが使用できます: +.Bl -tag -width indent +.It Fl e Ar extrahops 応答がないルータを越えて、 -.I extrahops +.Ar extrahops だけのホップ数のトレースを試みます。 -.TP 8 8 -.BI \-g\ gwy -トレースの問い合わせを、マルチキャストではなく、ユニキャストによって直 -接マルチキャストルータ -.I gwy +.It Fl g Ar gwy +トレースの問い合わせを、マルチキャストではなく、ユニキャストによって +直接マルチキャストルータ +.Ar gwy へ送ります。 このマルチキャストルータは意図する -.I source +.Ar source から -.I receiver -へのパス上の最後のホップのルータでなければなりません。 -.RS 8 -.TP 12 12 -.I 注意!! +.Ar receiver +への経路上の最後のホップのルータでなければなりません。 +.Pp +.Em 注意!! バージョン 3.3 と 3.5 の -.B mrouted +.Nm mrouted は、トレースの問い合わせがユニキャストパケットによって受信されかつ、 -.B mrouted +.Nm mrouted に -.I source +.Ar source への経路がないと、クラッシュします。そのためターゲットの -.B mrouted +.Nm mrouted が 3.4 であるか、3.5 より新しいことが分かっていなければ、 -.B \-g +.Fl g オプションを使わないでください。 -.RE -.TP 8 8 -.BI \-i\ addr -.I addr -をトレースの問い合わせを送る (マルチホームホスト上の) ローカルインタ -フェイスアドレス、および -.I receiver +.It Fl i Ar addr +.Ar addr +をトレースの問い合わせを送る (マルチホームホスト上の) +ローカルインタフェースアドレス、および +.Ar receiver と応答先のデフォルトアドレスとして使用します。 -.TP 8 8 -.B \-l -10 秒ごとにマルチキャストパスのパケットレートと消失の統計を表示して、 +.It Fl l +10 秒ごとにマルチキャスト経路のパケットレートと消失の統計を表示して、 無限ループします。 ( -.B \-S -.I stat_int +.Fl S Ar stat_int 参照) -.TP 8 8 -.B \-M -試みの後半は、ユニキャストではなく、常にマルチキャストを使って応答を要 -求します。 -.TP 8 8 -.BI \-m\ n -.I receiver +.It Fl M +試みの後半は、ユニキャストではなく、常にマルチキャストを使って応答を +要求します。 +.It Fl m Ar n +.Ar receiver から -.I source +.Ar source へ遡ってトレースされる最大ホップ数を -.I n +.Ar n にセットします。 -デフォルトは 32 ホップ (DVMRP ルーティングプロトコルについては無限) で -す。 -.TP 8 8 -.B \-n -ホップアドレスをシンボル名および数字ではなく数字で表示します。(パス上に発見された -各ルータに対するネームサーバでのアドレス-名前検索を省くことができます。) -.TP 8 8 -.BI \-q\ n +デフォルトは 32 ホップ (DVMRP ルーティングプロトコルについては無限) +です。 +.It Fl n +ホップアドレスをシンボル名および数字ではなく数字で表示します。 +(経路上に発見された各ルータに対する +ネームサーバでのアドレス-名前検索を省くことができます。) +.It Fl q Ar n すべてのホップに対して試みる問い合わせの最大の回数を -.I n +.Ar n にセットします。デフォルトは 3 です。 -.TP 8 8 -.B \-O +.It Fl O router-alert IP オプションを、これが必要な要求においても使用しません。 -Cisco の IOSのいくつかのバージョンでは IP オプションつきのマルチキャス -トトレースルートが扱えないため、最後のホップのルータが Cisco のもので -ある時は、-O フラグが必要となることがあります。 -.TP 8 8 -.B \-p +Cisco の IOS のいくつかのバージョンでは IP オプションつきのマルチキャスト +トレースルートが扱えないため、最後のホップのルータが Cisco のものである時は、 +.Fl O +フラグが必要となることがあります。 +.It Fl p 他から起動されたトレースによるマルチキャストの応答を受動的に聴取します。 これはマルチキャストルータ上で動作している場合に最も良く動作します。 -.TP 8 8 -.B \-P -10 秒おきにパス情報を収集しながら無限ループし +.It Fl P +10 秒おきに経路情報を収集しながら無限ループし ( -.B \-S -.I stat_int +.Fl S Ar stat_int 参照)、 -パス情報が変化するとそれを表示します。統計情報は表示しません。 -.TP 8 8 -.BI \-r\ host +経路情報が変化するとそれを表示します。統計情報は表示しません。 +.It Fl r Ar host トレースの応答を、 -.B mtrace +.Nm が実行されているホストや この目的で登録されている他のマルチキャストアドレス (224.0.1.32) ではなく、 -.I host +.Ar host へ送ります。 -.TP 8 8 -.B \-s -マルチキャストパスのみを含む短い形式の表示を行ない、パケットレートと +.It Fl s +マルチキャスト経路のみを含む短い形式の表示を行ない、パケットレートと 消失統計は表示しません。 -.TP 8 8 -.BI \-S\ n +.It Fl S Ar n 統計情報を収集する間隔を -.I n +.Ar n 秒 (デフォルトは 10 秒) に変更します。 -.TP 8 8 -.BI \-t\ ttl +.It Fl t Ar ttl マルチキャストトレースの問い合わせと応答の -.I ttl -(time-to-live もしくはホップ数) をセットします。ttl に 1 を使用する "全 -てのルータ" へのローカルな問い合わせの場合を除き、デフォルトは 127 で -す。 -.TP 8 8 -.B \-T -"トンネル統計" モードです。全てのトラフィックでのロスレートを表示しま -す。これらの統計は非常に誤解を招くおそれのあるものです。 -.TP 8 8 -.B \-U -マルチキャストから試みるのではなく、常にユニキャストによる応答を要求し -ます。 -.TP 8 8 -.B \-v +.Ar ttl +(time-to-live もしくはホップ数) をセットします。ttl に 1 を +使用する "全てのルータ" へのローカルな問い合わせの場合を除き、 +デフォルトは 127 です。 +.It Fl T +"トンネル統計" モードです。全てのトラフィックでのロスレートを表示します。 +これらの統計は非常に誤解を招くおそれのあるものです。 +.It Fl U +マルチキャストから試みるのではなく、常にユニキャストによる応答を要求します。 +.It Fl v 冗長モードです。最初のトレースのホップ時間と統計情報を表示します。最初 のトレースを転送するのに使用した経路も表示します。 -.TP 8 8 -.BI \-w\ n +.It Fl w Ar n トレースの応答の待ち時間を -.I n +.Ar n 秒 (デフォルトは 3 秒) にセットします。 -.SH 使用方法 -.SS どのように動作するか ? -.B traceroute +.El +.Sh 使用方法 +.Ss どのように動作するか ? +.Nm traceroute ツールでユニキャストのネットワーク経路をトレースするために使用している 技法は IP マルチキャストでは動作しません。それは、ICMP 応答が マルチキャストトラフィックでは禁止されているためです。そのかわりに、 トレースの機能はマルチキャストルータにおいて実装されています。 この技法は送出するパケット数を最小にしながら、 パケットレートやロスを計測できる点で優れています。 -.PP +.Pp マルチキャストでは逆経路転送が使われているため、トレースは -.I receiver +.Ar receiver から -.I source +.Ar source へ逆方向に実行されます。 トレースの問い合わせパケットは最終ホップのマルチキャストルータ ( -.I receiver +.Ar receiver アドレスでの末端ルータ) へ送られます。最終ホップのルータではトレースの 応答パケットを生成し、それにそのホップでのレポートを詰め込み、 ユニキャストを使って、指定された -.I source +.Ar source から送られてくるパケットにおける、そのルータの前段のホップであると思わ れるルータへ、生成したパケットを転送します。 経路上の各ルータはそのパケットにレポートを追加して転送します。 トレースの応答パケットが最初のホップのルータ ( source のネットワークに 直結されているルータ) に到達すると、そのルータはトレースの問い合わせに 指定されている応答の送り先アドレスへ最終的な形の応答を送ります。 -.PP +.Pp 経路上のいくつかのマルチキャストルータにマルチキャストのトレースルート 機能が実装されていなかったり、停止しているものがあると、応答は返されま せん。この問題を解決するには、応答が返されるまでにトレースされるホップ 数を制限するための最大ホップ数フィールドを、トレースの問い合わせに 含ませます。これによって、部分的な経路のトレースが可能となります。 -.PP -各ルータによって挿入されるレポートには、ホップのアドレスだけでなく、転 -送のために必要な ttl とルーティングのエラーを示すいくつかのフラグ、そ -れに受信と送信インタフェース上および指定された -.I group +.Pp +各ルータによって挿入されるレポートには、ホップのアドレスだけでなく、 +転送のために必要な ttl とルーティングのエラーを示すいくつかのフラグ、 +それに受信と送信インタフェース上および指定された +.Ar group へ転送されたパケット数の合計が含まれます。時間をあけて 2 回トレースを 行なってこれらのパケット数の差分をとり、あるホップからの送信パケット 数とその次のホップでの受信パケット数を比較することにより、パケットレートと パケット消失の統計が計算でき、ネットワークへの過負荷による問題を切 り離すことができます。 -.SS 最終ホップルータを見つける +.Ss 最終ホップルータを見つける トレースの問い合わせは -.I source +.Ar source から -.I receiver +.Ar receiver へ到る経路上の最後のホップであるマルチキャストルータへ送られなければな りません。もし、receiver がローカルサブネット上にあれば (これはサブネットマスク によって決定されます)、デフォルトの方法ではトレースの問い合わせ を ttl を 1 にして all-routers.mcast.net (224.0.0.2) へマルチキャスト します。receiver がサブネット上になければ、 -.I group +.Ar group へトレースの問い合わせをマルチキャストします。それは receiver がその グループのメンバであれば、最後のホップルータもグループのメンバであるため -です。そのため、意図している receiver が属しているグループを指定する必 -要があります。このマルチキャストは ttl をデフォルトの 127 にして送られ +です。そのため、意図している receiver が属しているグループを指定する +必要があります。このマルチキャストは ttl をデフォルトの 127 にして送られ ます。この ttl は全ての場合では十分でないかもしれません。( -.B \-t +.Fl t オプションで変更可能です。) もし最後のホップルータが分かっていれば、 -.B \-g +.Fl g オプションを使用して直接指定することもできます。また、最後のホップのルータが 別のグループのメンバであるということが分かっており、receiver が属 していないグループのトレースを行ないたい場合、 -.B \-g +.Fl g オプションを使用してトレースの問い合わせに別のマルチキャストアドレスを 指定することもできます。 -.PP +.Pp マルチホームであるホストやルータからのトレースを行なう場合は、デフォルトの receiver のアドレスは source からの経路での意図したインタフェース でないかも知れません。インタフェースを指定したい場合は、 -.I receiver +.Ar receiver によって明示的に指定しなければなりません。 -.SS 応答の誘導 -.B \-m +.Ss 応答の誘導 +.Fl m オプションによってトレースするホップ数が明示的に指定されている場合を除 き、 -.B mtrace +.Nm はデフォルトではまず逆経路全てに渡ったトレースを試みます。もしタイムアウト 時間である 3 秒 (これは -.B \-w +.Fl w オプションで変更できます) 以内に応答がなければ、"*" が表示され、プローブ方式を hop-by-hop モードに切り替えます。 トレースの問い合わせは最大ホップ数を 1 から開始し、応答を受信しなくなる か全ての経路を網羅するまでホップ数を 1 づつ増やして行きます。 各ホップでは、複数のプローブ (デフォルトでは 3、 -.B \-q +.Fl q オプションで変更可) が送られます。トレースの試みの前半 (デフォルトでは 2 回) では、応答 アドレスを標準のマルチキャストアドレス mtrace.mcast.net (224.0.1.32) に @@ -356,41 +309,40 @@ hop-by-hop モードに切り替えます。 ttl は最大 192 まで 32 づつ増やされます。 目的のルータはマルチキャスト応答を送ることができないかもしれないので、 残りの試みでは -.B mtrace +.Nm が動作しているホストへユニキャストを使って応答することを要求します。 また、マルチキャストの ttl は -.B \-t -オプションを使って明示的に指定することができ、最初のマルチキャストの試 -みは -.B \-U +.Fl t +オプションを使って明示的に指定することができ、最初のマルチキャストの試みは +.Fl U オプションを使ってユニキャストに強制的に変更することができ、最後の マルチキャストの試みは -.B \-M +.Fl M オプションを使って強制的にマルチキャストにすることができ、また -.B \-UM +.Fl UM を指定することにより、 -.B mtrace +.Nm は最初はユニキャストで試み、次にマルチキャストを試みます。各々の試みで -はタイムアウトとなるまで応答が受信できなければ "*" が表示されます。指 -定された回数の試みが失敗すると、 -.B mtrace +はタイムアウトとなるまで応答が受信できなければ "*" が表示されます。指定された +回数の試みが失敗すると、 +.Nm は次のホップのルータへ ( -.B mrinfo +.Nm mrinfo プログラムで使われているように) DVMRP_ASK_NEIGHBORS2 要求で問い合わせ を試み、そのルータの種類を調べます。 -.B mtrace +.Nm mtrace は応答がないルータを越えて 3 ホップ (これは -.B \-e +.Fl e オプションで変更可能) へ、応答を返す能力がないとしてもその要求の転送は できるであろうと想定して、問い合わせを試みます。 -.SH 使用例 -.B mtrace +.Sh 使用例 +.Nm の出力は 2つのセクションからなります。最初のセクションではホップが問い 合わされた順、すなわち -.I source +.Ar source から -.I receiver -への逆順で簡潔にリストされます。各々のホップについて、ホップ番号 (逆パス +.Ar receiver +への逆順で簡潔にリストされます。各々のホップについて、ホップ番号 (逆経路 であることを示すように負の数でカウントされる)、マルチキャスト ルーティングプロトコル (DVMRP、MOSPF、PIM など)、データの転送 (上向きの矢印で 示されたリストでの前のホップへの転送) 要求のスレッショルド、問い合わせ @@ -399,7 +351,7 @@ ttl は最大 192 まで 32 づつ増やされます。 れてから応答を受信するまでの間隔をローカルのシステムクロックで計測した ラウンドトリップ時間と、パケットがこの経路を通って行き来するのに必要な ttl の合計が表示されます。以下に使い方とその出力の例を示します。 -.PP +.Pp .nf .ft C oak.isi.edu 80# mtrace -l caraway.lcs.mit.edu 224.2.0.3 @@ -414,22 +366,22 @@ Querying full reverse path... -6 caraway.lcs.mit.edu (18.26.0.170) Round trip time 124 ms; total ttl of 6 required. .fi -.PP +.Pp あるホップがパケットを転送するのにデフォルトの経路を使っていることを報 告すれば、 -.B [default] +.Em [default] がそのホップの後に表示されます。 -.B \-v +.Fl v フラグが指定されていれば、そのパケットを転送するのに使われた経路が -.B [18.26.0/24] +.Em [18.26.0/24] の形式で表示されます。 -.PP -2 番目のセクションでは転送のパスが図によって表示されます。データの流れ -は下向きの矢印で表され、問い合わせのパスは上向きの矢印で表されます。各 +.Pp +2 番目のセクションでは転送の経路が図によって表示されます。データの流れ +は下向きの矢印で表され、問い合わせの経路は上向きの矢印で表されます。各 ホップでは、ルータの入力アドレスと出力アドレスが違っていれば、それらの -アドレスが、そのホップパケットを転送するのに必要な ttl の初期値と、両 -端のルータのクロックが同期していると想定した場合のホップにまたがった伝 -搬遅れとともに表示されます。このセクションの右半分は 2 組の統計情報か +アドレスが、そのホップパケットを転送するのに必要な ttl の初期値と、 +両端のルータのクロックが同期していると想定した場合のホップにまたがった +伝搬遅れとともに表示されます。このセクションの右半分は 2 組の統計情報か ら構成されます。最初のカラムには各ホップでの全てのトラフィックについて の平均のパケットレートが表示されます。残りのカラムでは消失したパケット の数、送信したパケットの数、消失したパーセンテージ、それに平均パケット @@ -437,26 +389,26 @@ Round trip time 124 ms; total ttl of 6 required. うにトレース間の差とホップ間の差から計算されます。最初のグループでは、 あるホップでのインタフェースにおける全流出トラフィックと次のホップでの全流入 トラフィックの統計情報が表示されます。2 番目のグループでは、指定された -.I source +.Ar source から指定された -.I group +.Ar group への転送トラフィックのみについての統計情報が表示されます。統計の最初の グループは -.B \-T +.Fl T オプションを使って消失レートを含ませることもできます。しかし、これらの 数字は大幅な誤差を含む可能性があり、これらを適切に解釈するためには ルータについての詳細な知識が要求されるでしょう。 -.PP +.Pp これらの統計情報は各々のホップにつき 1 行か 2 行で表示されます。 オプションが何も指定されていないと、この出力中の 2 番目のセクションは最初 のトレースからおよそ 10 秒後に 1 度のみ表示されます。各ホップにつき 1 行にその 10 秒間での統計情報を表示します。もし -.B \-l +.Fl l オプションが指定されていると、2 番目のセクションは 10 秒ごとに繰り返さ れ、各ホップにつき 2 行が表示されます。最初の行ではそれまでの 10 秒間 における統計が表示され、2 番目の行で最初のトレースからの累積の統計情報 が表示されます。下の例ではこれは 101 秒間での統計となっています。 -.B \-s +.Fl s オプションが指定されるか、マルチキャストグループが指定されていると、こ の出力での 2 番目のセクションは省略されます。 .ie t \{\ @@ -467,7 +419,7 @@ Round trip time 124 ms; total ttl of 6 required. and try again.) . \} .\} -.PP +.Pp .ft C .nf Waiting to accumulate statistics... Results after 101 seconds: @@ -499,56 +451,48 @@ Waiting to accumulate statistics... Results after 101 seconds: 128.9.160.100 128.9.160.100 Receiver Query Source .fi -.PP +.Pp パケットのカウント数はトレースの問い合わせが伝搬するとともに変化するた め、統計情報中には小さな誤差 (1 か 2 のずれ) が含まれることがあります。 しかし、これらの誤差は累積されるべきではないため、累積統計行ではあらた なトレースが 10 秒ごとに実行されるたびに精度が増さなければなりません。 -大きな誤差の要因としては 2 つあり、このいずれもマイナスのロスとして現 -われます。 -.LP -.RS -.PD 0 -.TP 3 -\(bu +大きな誤差の要因としては 2 つあり、このいずれもマイナスのロスとして現われます。 +.Pp あるノードへの入力カウントが他のノードがアタッチされているマルチアクセス ネットワークからのものであれば、入力カウントはアタッチされている全てのノード からの出力カウントの総和となります (もしくは近くなります) が、トレースし -ているパス上のその前のホップからの出力カウントはその単なる一部分となり +ている経路上のその前のホップからの出力カウントはその単なる一部分となり ます。そのため、出力カウントから入力カウントを引いたものはマイナスの値 になります。 -.TP 3 -\(bu +.Pp SunOS およびその他のシステムにおける DVMRP マルチキャスト転送ソフトウェアの リリース 3.3 では、ルータにおいて生成されたマルチキャストパケット はインタフェースに入力されていない場合においても、入力されたものとし てカウントされます。これは上の例において見ることのできるマイナスのロス となります。 -.PD -.RE -.LP +.Pp これらのマイナスのロスはプラスのロスを隠してしまうことが あることに注意してください。 -.PP +.Pp この例ではまた、1 つマイナスのホップの時間が表示されています。これは 単にそのホップ間でのシステムクロックが同期していないことを示しています。 -この例ではまた、送られたパケットの数が 10 より少ない時には、パーセンテー -ジの値は統計的に有効ではないため、ロスのパーセンテージが 2 つのダッシュ +この例ではまた、送られたパケットの数が 10 より少ない時には、パーセンテージの +値は統計的に有効ではないため、ロスのパーセンテージが 2 つのダッシュ として表示されることも示しています。 -.PP +.Pp 2 番目の例では ローカルでない receiver へのトレースを示します。問い合 わせは -.B \-g -オプションによって最終ホップのルータに送られます。この例では、全逆パス -のトレースが、マルチキャストトレースルート機能が実装されていない古いバー -ジョンの -.B mrouted +.Fl g +オプションによって最終ホップのルータに送られます。この例では、全逆経路 +のトレースが、マルチキャストトレースルート機能が実装されていない +古いバージョンの +.Nm mrouted が動作しているノードがあるために応答なしの結果となっており、そのため -.B mtrace +.Nm は hop-by-hop モードに切り替わっています。\*(lqOutput pruned\*(rq の エラーコードはグループ 224.2.143.24 へのトラフィックが転送されていないこ とを示しています。 -.PP +.Pp .nf .ft C oak.isi.edu 108# mtrace -g 140.173.48.2 204.62.246.73 \\ @@ -563,24 +507,37 @@ Querying full reverse path... * switching to hop-by-hop: -5 * * * noc.hpc.org (192.187.8.2) [mrouted 2.2] didn't respond Round trip time 95 ms .fi -.SH 作者 -Ajit Thyagarajan によって書かれた最初のプロトタイプをベースにして、 -Steve Casner によって実装されました。マルチキャストトレースルートの -メカニズムは Steve Casner、Steve Deering、Dino Farinacci、Deb Agrawal の -助けを得て、Van Jacobson によって設計され、Ajit Thyagarajan と Bill -Fennerによって -.B mrouted -に実装されました。オプションのシンタックスと -.B mtrace -の出力フォーマットは、Van Jacobson によって書かれたユニキャストの -.B traceroute +.Sh 作者 +.An Ajit Thyagarajan +によって書かれた最初のプロトタイプをベースにして、 +.An Steve Casner +によって実装されました。マルチキャストトレースルートの +メカニズムは +.An Steve Casner , +.An Steve Deering , +.An Dino Farinacci , +.An Deb Agrawal +の助けを得て、 +.An Van Jacobson +によって設計され、 +.An Ajit Thyagarajan +と +.An Bill Fenner +によって +.Nm mrouted +に実装されました。オプションの構文と +.Nm +の出力形式は、 +.An Van Jacobson +によって書かれたユニキャストの +.Nm traceroute をモデルにしています。 -.SH 関連項目 -.BR mrouted (8) , -.BR mrinfo (8) , -.BR map-mbone (8) , -.BR traceroute (8) -.SH バグ -.PP -パッシブモードでの統計収集は、活発にデータを収集しているときと常に同じ +.Sh 関連項目 +.Xr mrouted 8 , +.Xr mrinfo 8 , +.Xr map-mbone 8 , +.Xr traceroute 8 +.Sh バグ +.Pp +受動モードでの統計収集は、能動的にデータを収集しているときと常に同じ 出力とはなりません。 diff --git a/ja/man/man8/mtree.8 b/ja/man/man8/mtree.8 index 46928663c6..ed6ede1aef 100644 --- a/ja/man/man8/mtree.8 +++ b/ja/man/man8/mtree.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" From: @(#)mtree.8 8.2 (Berkeley) 12/11/93 -.\" %Id: mtree.8,v 1.7.2.3 1998/07/18 11:11:06 jkh Exp % +.\" %Id: mtree.8,v 1.13 1998/06/10 06:45:08 peter Exp % .\" jpman %Id: mtree.8,v 1.3 1997/08/16 13:31:00 horikawa Stab % .\" .Dd February 9, 1995 diff --git a/ja/man/man8/named-xfer.8 b/ja/man/man8/named-xfer.8 index 26c08a17e2..283452469c 100644 --- a/ja/man/man8/named-xfer.8 +++ b/ja/man/man8/named-xfer.8 @@ -53,103 +53,99 @@ .\" .\" from named.8 6.6 (Berkeley) 2/14/89 .\" -.TH NAMED-XFER 8 "June 26, 1993" .\" jpman %Id: named-xfer.8,v 1.2 1997/06/06 11:08:51 bobson Stab % -.UC 4 -.SH 名称 -named-xfer \- ゾーン転送のための補助エージェント -.SH 書式 -.B named-xfer -.B \-z -.I zone_to_transfer -.B \-f -.I db_file -.B \-s -.I serial_no -[ -.B \-d -.I debuglevel -] [ -.B \-l -.I debug_log_file -] [ -.B \-t -.I trace_file -] [ -.B \-p -.I port# -] [ -.B \-S -] -.I nameserver -... -.SH 解説 -インターネットネームサーバの補助プログラムです。 -.I named-xfer +.Dd June 26, 1993 +.Dt NAMED-XFER 8 +.Os BSD 4 +.Sh 名称 +.Nm named-xfer +.Nd ゾーン転送のための補助エージェント +.Sh 書式.Nm named-xfer +.Fl z Ar zone_to_transfer +.Fl f Ar db_file +.Fl s Ar serial_no +.Op Fl d Ar debuglevel +.Op Fl l Ar debug_log_file +.Op Fl t Ar trace_file +.Op Fl p Ar port# +.Op Fl S +.Ar nameserver ... +.Sh 解説 +.Nm は、 -.IR named (8) +.Xr named 8 によって実行される補助プログラムです。 インターネットネームサーバから呼び出されて、ゾーン情報を受け取ります。 直接実行されることはまれであり、ゾーン転送の問題を解決するために システム管理者にいよってのみ実行されることがある程度です。 インターネットネームドメインシステムについての詳細は、 RFC 1033 、1034 、1035 を参照してください。 -.PP +.Pp オプションとしては、以下のものがあります: -.TP -.B \-z +.Bl -tag -width Fl +.It Fl z Ar zone_to_transfer 転送されるゾーン名を指定します。 -.TP -.B \-f +.It Fl f Ar db_file プライマリサーバーからゾーンが転送された際に、ゾーンの情報をダンプ (格納) する -ファイル名を指定します。 -.TP -.B \-s +.Ar db_file +のファイル名を指定します。 +.It Fl s Ar serial_no 転送されるゾーンの情報のシリアル番号を指定します。プライマリサーバーから -得た \s-1SOA RR\s+1 が、このシリアル番号よりも高いシリアル番号を持たない +得た +.Sy SOA RR +が、このシリアル番号よりも高いシリアル番号を持たない 場合は、転送は中止されます。 -.TP -.B \-d -デバッグ情報を出力します。``d'' のあとの数字は出力されるメッセージのレベルを -決定します。 -.TP -.B \-l +.It Fl d Ar debuglevel +デバッグ情報を出力します。 +.Ar debuglevel +出力されるメッセージのレベルを決定します。 +.It Fl l Ar debug_log_file デバッグメッセージのログファイルを指定します。デフォルトでは システムに依存しますが、通常は -.I /var/tmp +.Pa /var/tmp または -.IR /usr/tmp +.Pa /usr/tmp です。このオプションは -.I \-d +.Fl d と同時に指定されたときのみ適用されますので注意してください。 -.TP -.B \-t -ゾーン情報転送のプロトコルトレースを格納するトレースファイルを指定します。 +.It Fl t Ar trace_file +ゾーン情報転送のプロトコルトレースを格納するトレースファイル +.Ar trace_file +を指定します。 このオプションはネームサーバーそのものをデバッグする人にとってのみ 有益なのかもしれません。 -.TP -.B \-p +.It Fl p Ar port# デフォルト以外のポート番号を使用するときに指定します。 デフォルトの標準ポートナンバーは -``domain'' サービスの getservbyname(3) の返す値になります。 -.TP -.B \-S +``domain'' サービスの +.Xr getservbyname 3 +の返す値になります。 +.It Fl S SOA レコードと NS レコードの転送のみを許可し、 ゾーンに対して A レコードを結合します。 -SOA レコードは named によって読み込まれませんが、 +SOA レコードは +.Xr named 8 +によって読み込まれませんが、 NS レコードをいつ検証するのかを決定するのに使用されます。 詳しくは -.IR named (8) -の ``stubs''を参照してください。 -.TP -.PP -付加的な引数としてネームサーバーのアドレスを、いわゆる ``dotted-quad'' -構文でのみ、とります。ネームサーバのアドレスの省略は許されません。 +.Xr named 8 +の +.Dq Li stubs +を参照してください。 +.El +.Pp +付加的な引数としてネームサーバーのアドレスを、いわゆる +.Dq dotted-quad +構文で +.Em のみ +、とります。ネームサーバのアドレスの省略は許されません。 少なくとも一つのアドレスを指定しなくてはなりません。 ネームサーバーのアドレスが複数指定されると、最初のサーバーが転送を失敗すると、 順番にサーバーを切替えて転送を試みます。 - -.SH 関連項目 -named(8), resolver(3), resolver(5), hostname(7), +.Sh 関連項目 +.Xr hostname 7, +.Xr named 8 , +.Xr resolver 3 , +.Xr resolver 5 , RFC 882, RFC 883, RFC 973, RFC 974, RFC 1033, RFC 1034, RFC 1035, RFC 1123, -\fIName Server Operations Guide for \s-1BIND\s+1\fR +.Dq Name Server Operations Guide for Sy BIND . diff --git a/ja/man/man8/named.8 b/ja/man/man8/named.8 index 0cfbdf770d..e737151c18 100644 --- a/ja/man/man8/named.8 +++ b/ja/man/man8/named.8 @@ -1,6 +1,6 @@ -.\" ++Copyright++ 1985 +.\" ++Copyright++ 1985, 1996 .\" - -.\" Copyright (c) 1985 +.\" Copyright (c) 1985, 1996 .\" The Regents of the University of California. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without @@ -54,375 +54,306 @@ .\" @(#)named.8 6.6 (Berkeley) 2/14/89 .\" jpman %Id: named.8,v 1.4 1997/11/11 13:59:51 horikawa Stab % .\" -.TH NAMED 8 "June 20, 1995" -.UC 4 -.SH 名称 -named \- インターネットドメインネームサーバ -.SH 書式 -.B named -[ -.B \-d -.I debuglevel -] [ -.B \-p -.IR port# [\fB/\fP\fIlocalport#\fP] -] [{\-b} -.I bootfile -] [ -.B \-q -] [ -.B \-r -] -.SH 解説 -.I Named +.Dd February 1, 1996 +.Dt NAMED 8 +.Os BSD 4 +.Sh 名称 +.Nm named +.Nd インターネットドメインネームサーバ (DNS) +.Sh 書式 +.Nm NAMED +.Op Fl d Ar debuglevel +.Op Fl p Ar port# +.Oo Fl Po +.Cm b Ns \&| Ns Cm c +.Pc +.Ar config_file +.Oc +.Op Fl f q r +.Op Fl u Ar user_name +.Op Fl g Ar group_name +.Op Fl t Ar directory +.Op Fl w Ar directory +.Op Ar config_file +.Sh 解説 +.Ic named はインターネットドメインネームサーバです。 インターネットドメインネームシステムの詳細な情報については RFC 1033, 1034, 1035 を参照してください。 パラメータがない場合は -.I named -はデフォルトのブートファイルである -.IR /etc/named.boot +.Ic named +はデフォルトの設定ファイルである +.Pa /etc/namedb/named.conf の初期化データを読み込み、問い合わせに対し待機します。 -.PP +コマンド行の最後に与えられた +.Ar config_file +引き数は +.Dq Fl b +または +.Dq Fl c +フラグを使用して指定された +.Ar config_file +を無効にします。 +.Pp +.Sy 注釈: +.Nm named +のいくつかのオプションと多くの動作は、設定ファイルの中で +制御できます。更なる情報はこの +.Sy BIND +配布物に含まれる設定ファイルガイドを参照してください。 +.Pp 指定できるオプションは以下の通りです。 -.TP -.B \-d +.Bl -tag -width Fl +.It Fl d Ar debuglevel デバッグ情報を出力します。 -``d''に続く数字には出力するメッセージのレベルを指定します。 -.TP -.B \-p -標準でないポート番号を指定します。 -デフォルトは getservbyname(3) によって、 -サービス ``domain'' に対して返される標準のポート番号となります。 -このオプションでは2つのポートをスラッシュ(``\fB/\fP'')で続けて -指定することができます。 -この場合は最初のポートがリモートサーバに接続する際に使用され、 -後のポートはローカルで実行されている -.IR named -のサービスポートとなります。 -これはおもにデバッグのために使用されます。 -.TP -.B \-b -ブートファイルを指定します。 -この指定はオプションであり、 -ダッシュで始まるファイルを指定することが可能となります。 -.TP -.B \-q -\fInamed\fP が \fIQRYLOG\fP を定義してコンパイルされている場合に、 -全ての問い合わせのトレースを行ないます。 -\fI注釈:\fP このオプションはブートファイル中の ``options query-log'' -の指定と同等です。 -.TP -.B \-r +.Ar debuglevel +は表示するメッセージのレベルを決定する数字です。もし負の値の場合、 +.Ar debuglevel +は +.Dq 1 +に設定されます。 +.Pp +.Sy 注釈: +新しいデバッグの枠組は古いバージョンの +.Nm NAMED +よりもかなり洗練されています。 +設定ファイルの +.Dq Li logging +宣言は(問い合わせや内/外への転送などの)多くの種類にわたるイベント +それぞれに対して、複数の別々なデバッグレベルを設定することができます。 +これらの広範囲にわたる新しい機能に関する更なる情報は、この +.Sy BIND +配布物に含まれる設定ファイルガイドを参照してください。 +.It Fl p Ar port# +指定されたリモートポート番号を使用します。このポート番号は +.Nm NAMED +が問い合わせを送る番号です。デフォルトの値は標準のポート番号、つまり +.Xr getservbyname 3 +が +.Dq Li domain +に対して返すポート番号です。 +.Pp +.Sy 注釈: +以前は、 +.Dq Fl p Ar port# Ns Op Ar \&/localport# +という文法が使用でき、1 つ目のポートが +.Em remote +サーバへの接続に使用され、2 つ目のポートが +.Nm NAMED +の +.Em local +サーバに対するポート番号として使用されました。 +現在の使用法は古い使用法から +.Ar localport# +の指定を除いたものと同等です。この機能は +設定ファイルの +.Dq Li options +宣言にある +.Dq Li listen-on +節で指定できます。 +.It Xo Fl Po +.Cm b Ns \&| Ns Cm c +.Pc Ar config_file +.Xc +代わりの +.Ar config_file +を使用します。 +この引き数はコマンド行の最後に指定された +.Ar config_file +によって上書きされます。 +デフォルトの値は +.Pa /etc/namedb/named.conf +です。 +.It Fl f +このプロセスを表で動かし、 +.Xr fork 2 +やデーモン化をしません(デフォルトではデーモン化をします)。 +.It Fl q +.Nm NAMED +が +.Li QRYLOG +を定義してコンパイルされている場合に、 +すべての問い合わせのトレースを行ないます。 +.Pp +.Sy 注釈: +設定ファイルの +.Dq Li logging +宣言で +.Dq Li queries +.Em logging category +する方が賛成され、このオプションは反対されています。 +更なる情報は、この +.Sy BIND +配布物に含まれる設定ファイルガイドを参照してください。 +.It Fl r 再帰的なネームサーバの問い合わせを抑止します。 問い合わせに対してはローカルゾーン(プライマリもしくはセカンダリ)からのみ 回答されます。 この指定はルートサーバにて使用することができます。 -\fI注釈:\fP このオプションはブートファイル中の ``options no-recursion'' -の指定と同等です。 -.PP -その他の引数はブートファイル名として扱われます。 -複数のブートファイルが指定された場合は、最後の指定が有効となります。 -.PP -ブートファイルにはネームサーバが得るべき初期データの所在の情報が含まれます。 -ブートファイル中の各行を次の行に引き続いて書くことはできません。 -以下に簡単な例を示します。 -.in +2m -.nf - -; -; boot file for name server -; -directory /usr/local/adm/named - -.ta \w'check-names\ 'u +\w'6.32.128.IN-ADDR.ARPA\ 'u +\w'128.32.137.8 128.32.137.3\ 'u -; type domain source host/file backup file - -cache . root.cache -primary Berkeley.EDU berkeley.edu.zone -primary 32.128.IN-ADDR.ARPA ucbhosts.rev -secondary CC.Berkeley.EDU 128.32.137.8 128.32.137.3 cc.zone.bak -secondary 6.32.128.IN-ADDR.ARPA 128.32.137.8 128.32.137.3 cc.rev.bak -primary 0.0.127.IN-ADDR.ARPA localhost.rev -forwarders 10.0.0.78 10.2.0.78 -limit transfers-in 10 -limit datasize 64M -limit files 256 -options forward-only query-log fake-iquery -check-names primary fail -check-names secondary warn -check-names response ignore - -.DT -.fi -.in -``directory'' 行はサーバのワーキングディレクトリを指定します。 -この指定はプライマリゾーンファイル中にて \s-1$INCLUDE\s+1 が、 -正しく機能する為に重要となります。 -.LP -``cache'' 行は ``root.cache'' におけるデータがバックアップキャッシュに -置かれることを指定します。 -これはおもにルートドメインサーバの位置のようなデータを指定するために -使われます。 -このキャッシュは通常は使われませんが、現在のルートサーバをみつけるための -「ヒント」として使われます。 -``root.cache'' ファイルは ``berkeley.edu.zone'' と同じフォーマットです。 -複数の ``cache'' ファイルを指定することもできます。 -``root.cache'' ファイルは \s-1FTP.RS.INTERNIC.NET\s+1 から -定期的に取得するべきです。 -なぜならば、それにはルートサーバのリストが含まれており、 -リストは定期的に変更されているためです。 -.LP -例における最初の ``primary'' 行ではファイル ``berkeley.edu.zone'' が -``Berkeley.EDU'' ゾーンにおける信頼すべきデータを含んでいることを -宣言しています。 -``berkeley.edu.zone'' ファイルは RFC 883 に記述されている -マスタファイルフォーマットのデータが含まれています。 -全てのドメイン名は起点 (ここの例では ``Berkeley.EDU'') に対し -相対的に指定されます (詳細は後述)。 -2番目の ``primary'' 行ではファイル ``ucbhosts.rev'' が -ドメイン ``32.128.IN-ADDR.ARPA'' の信頼すべきデータを含んでいることを -宣言しています。 -これはネットワーク 128.32 におけるアドレスをホスト名に変換するために -使われます。 -それぞれのマスタファイルは -そのゾーンの SOA レコードで始めなければなりません。(下記参照) -.LP -例における最初の ``secondary'' 行では -``CC.Berkeley.EDU'' 以下の全ての信頼すべきデータは -128.32.137.8 にあるネームサーバから転送されることを指定しています。 -データの転送に失敗したら 128.32.137.3 と、 -この行で指定された他のアドレス (10 個まで) を順に試みます。 -セカンダリコピーもここで指定されているドメインについての -信頼すべきデータとなります。 -この行における最初の 4 つ組ドットアドレス表記でないものは、 -転送されたゾーンのバックアップをとるファイル名として扱われます。 -ネームサーバはこのバックアップファイルがブート時に存在すれば、 -ゾーン情報を読み込み、マスタサーバに接続できない場合でも -完全なコピーとしてゾーン情報を供給します。 -ドメインの新しいコピーがマスタサーバのいずれかから自動ゾーン転送されれば、 -このファイルは更新されます。 -ファイル名が指定されなければ、 -一時ファイルが使用されゾーン転送が成功した後に削除されます。 -これは不要なトラフィックを発生するため、おすすめできません。 -2番目の ``secondary'' 行では、サブネット 128.32.136 におけるアドレスから -ホスト名へのマッピングは、その前のゾーンと同じマスタサーバから得ることを -宣言しています。 -.LP -``forwarders'' 行では、他のサーバからの再帰的な問い合わせを -サイト単位で受け持つサーバのアドレスを指定しています。 -ブートファイルに 1 つか複数のフォーワーダが指定してあると、 -サーバはキャッシュに含まれていない全てのデータの問い合わせを -先ずフォーワーダに送ります。 -応答が返ってくるか、 -指定されている全てのフォーワーダに問い合わせが終るまで、 -各々のフォーワーダに順に問い合わせます。 -フォーワーダから応答が返って来ない場合、 -サーバは、``forward-only'' モードでなければ、 -forwarder 行が指定されていない場合と同様に処理を続けます。 -この問い合わせの転送機能はマスタサーバにサイト単位の大きなキャッシュを -生成し、 -外部のサーバとのリンクのためのトラフィックを軽減するのに役立ちます。 -また、インターネットへの直接アクセスはできないが、 -外部のアドレスを検索できるようなサーバを運用することが可能となります。 -.LP -``slave'' 行は古いソフトウェアとの互換性のために設けられています。 -これは ``options forward-only'' と同一です。 -.LP -``sortlist'' 行は、他のネットワークより優先するネットワークを指定するのに -使われます。 -サーバと同じネットワーク上のホストからのアドレスの問い合わせには、 -先ずローカルネットワークアドレスにリストされているもの、 -次にソートされたリストから、そして最後にその他のアドレスから応答が返されます。 -.LP -``xfrnets'' の指定 (例では使われていない) は単純なアクセス制御を行なうために -使われます。 -この指定があれば、ネームサーバは ``xfrnets'' にて指定されたネットワーク上の -ホストからのゾーン情報の転送の要求にのみ応答を返します。 -これは古い中間的なサーバとの互換性を取るために ``tcplist'' として -指定することもできます。 -.LP -``include'' の指定 (例では使われていない) は、他のファイルの内容があたかも -``include'' の指定がある場所におかれているように扱うために使われます。 -この指定はゾーンが多数あるか、ゾーンを論理的にグループ化し多数の人によって -メンテナンスしている場合に有用です。 -``include'' の指定は引数をひとつ取り、そこでインクルードするファイル名を -指定します。 -ファイル名の前後に引用符は必要ありません。 -.LP -``bogusns'' の指定 (例では使われていない) は、 -指定されているネームサーバアドレス -(これはドメイン名ではなく 4 つ組ドット表記にて指定される) -には問い合わせをしないことを \s-1BIND\s+1 に指示します。 -この指定は、ある特定のサーバのゾーンやキャッシュのデータが不正であることが -あらかじめ分かっていて、 -問題が修正されるまでデータの汚染を防止したい場合に有用です。 -.LP -``limit'' の指定は \s-1BIND\s+1 の内部の制限を変更する場合に使用します。 -制限にはシステムによるもの (例えば \fBdatasize\fP) と -\s-1BIND\s+1 自身によるもの (例えば \fBtransfers-in\fP) があります。 -limit の名称に続く数字はその後に続く ``k'', ``m'', ``g'' のいずれかによって -各々キロバイト、メガバイト、ギガバイトの単位となります。 -\fBdatasize\fP の引数はカーネルによって設定されるプロセスのデータサイズです。 -\fI注釈:\fP これを実現する関数が提供されていないシステムもあります。 -そのようなシステムで ``limit'' に \fBdatasize\fP のパラメータを使用すると -警告メッセージが出力されます。 -\fBtransfers-in\fP の引数は \s-1BIND\s+1 が一度に生成する \fInamed-xfer\fP -サブプロセスの数を指定します。 -\fBtransfers-per-ns\fP の引数はいくつかのリモートネームサーバに対し、 -同時にゾーン転送を開始する最大の数となります。 -\fBfiles\fP の引数はプロセスが使えるファイル記述子の数を設定します。 -\fI注釈:\fP これを実現する関数が提供されていないシステムもあります。 -そのようなシステムで ``limit'' に \fBfiles\fP のパラメータを使用すると -警告メッセージが出力されます。 -.LP -``options'' の指定は \s-1BIND\s+1 の動作を変更するブール値の設定を行ないます。 -ひとつの指定中に複数のオプションを指定することが可能です。 -現在定義されているオプションには次のものがあります。 -\fBno-recursion\fP これは \s-1BIND\s+1 に対し、 -信頼できない名前に対する問い合わせを受け取った場合に実際のデータではなく、 -照会先を返すよう指示します。 -そのサーバが他のホストの \fIresolv.conf\fP ファイル中に記述されている場合は、 -このオプションは指定しないでください。 -\fBno-fetch-glue\fP これは応答中の「付属データ(additional data)」セクションを -生成する時に、 -\s-1BIND\s+1 が存在しないつなぎ (missing glue) をフェッチしないようにします。 -これは、\fBno-recursion\fP と共に用いられ、 -\s-1BIND\s+1 のキャッシュサイズが大きくなったり、壊れたりするのを防ぐのに -使われます。 -\fBquery-log\fP 全ての問い合わせのログを syslog(8) 経由で採取します。 -これを指定すると大量のデータを生成しますので、無闇には指定しないで下さい。 -\fBforward-only\fP フォーワーダにのみ問い合わせます。 -通常、この指定はサーバを運用したいが、 -サーバが物理的もしくは管理上の理由によりインターネットに -アクセスできない場合に使われます。 -\fBfake-iquery\fP 「逆引き (inverse queries)」に対してエラーではなく、 -にせの応答を返すことを \s-1BIND\s+1 に指示します。 -これはクライアントにマイクロコンピュータやSunOSのホストが沢山ある場合に -役に立ちます。 -.LP -``check-names'' では、 -その引数として ``primary'', ``secondary'', ``response'' を指定することにより、 -\s-1BIND\s+1 に対してそれぞれ、 -プライマリゾーンファイル、 -セカンダリゾーンファイル、 -再帰問い合わせに対する応答 -(例えば、ファイアウォール中から問い合わせ転送に対する応答) -の中の名称をチェックすることを指示します。 -また、それぞれ名称の各タイプについて、 -ゾーン情報が読み込まれていなかったり、 -応答がキャッシュや転送されない場合の \s-1BIND\s+1 の振舞を、 -引数に ``fail'', ``warn'', ``ignore''を指定することによってそれぞれ、 -失敗する、 -システムのログにメッセージを残す、 -不正な名称を無視し従来の方法で処理する、というように指定することができます。 -名称は、それがホスト名の場合は RFC 952 に準拠していれば正しいものと判断され、 -ホスト名以外の場合は表示可能な \s-1ASCII\s+1 文字でのみ構成されていれば -正しいものと判断されます。 -.LP -``max-fetch'' の指定 (例では使われていない) は -古いソフトウェアとの互換性を取るためのもので、 -``limit transfers-in'' と同一です。 -.PP +デフォルトでは再帰的な問い合わせを行ないます。 +.Pp +.Sy 注釈: +このオプションは設定ファイルの +.Dq Li options +宣言の +.Dq Li recursion +節によって上書きされ、またそちらのほうが推奨されています。 +.It Fl u Ar user_name +ユーザを指定すると、初期化後のサーバがこのユーザで動作します。 +値はユーザ名または数字のユーザ ID どちらでも構いません。 +.Dq Fl g +フラグが指定されていなかった場合、 +指定されたユーザのプライマリグループがグループ ID として使用されます +(initgroups() が呼ばれるため、ユーザの所属するすべてのグループがサーバに +渡されます)。 +.Pp +.It Fl g Ar group_name +グループを指定すると、初期化後のサーバがこのグループで動作します。 +値はグループ名または数字のグループ ID どちらでも構いません。 +.Pp +.It Fl t Ar directory +サーバがコマンド行引き数を処理したらすぐに chroot() するべき +ディレクトリを指定します。 +.Pp +.It Fl w Ar directory +サーバの作業ディレクトリを設定します。設定ファイルの +.Dq Li options +宣言の +.Dq Li directory +節はコマンド行で指定したあらゆる値を上書きします。 +デフォルトの作業ディレクトリはカレンドディレクトリ +.Pq Dq \&. +です。 +.El +.Pp +それ以外の引き数は上で述べたとおり、 +古い実装との互換性のために、設定ファイルの名前として扱われます。この引き数は +.Dq Fl b +または +.Dq Fl c +フラグを使用して指定される +.Ar config_file +を無効にします。 +特に引き数が与えられなければ、デフォルトの設定ファイルが使用されます +.Pq Pa /etc/namedb/named.conf +。 +.Ss マスタファイル形式 マスタファイルは制御情報とゾーン中のオブジェクトの 資源レコードのリストからなり、次の形式を取ります。 -.RS -.nf - +.Bd -literal -offset indent $INCLUDE <filename> <opt_domain> $ORIGIN <domain> <domain> <opt_ttl> <opt_class> <type> <resource_record_data> - -.fi -.RE +.Ed +.Pp ここで、 -.I domain -にはルートの場合は "." を、現在の起点の場合は "@" を、 -それら以外では通常のドメイン名を指定します。 -.I domain -が ``.'' で終っていない通常のドメイン名である場合は、 +.Bl -tag -width "opt_domain " +.It Ar domain +ルートの場合は +.Dq Li \&. +を、現在の起点の場合は +.Dq Li @ +を、それら以外では通常のドメイン名を指定します。 +.Ar domain +が +.Dq Li \&. +で終って +.Em いない +通常のドメイン名である場合は、 現在の起点がドメインに追加されます。 -``.'' で終るドメイン名は変更されません。 -.I opt_domain -フィールドにはインクルードファイル中のデータの起点を定義します。 -これはインクルードファイルの最初の行の前に -$ORIGIN 宣言を置くことと等価です。 +ドメイン名が +.Dq Li \&. +で終っている場合は変更されません。 +.It Ar opt_domain +このフィールドにはインクルードファイル中のデータの起点を定義します。 +これはインクルードファイルの最初の行の前に +.Li $ORIGIN +宣言を置くことと等価です。 このフィールドはオプショナルです。 -.I opt_domain -や、インクルードファイル中の $ORIGIN 宣言は -そのファイル自身の現在の起点を変更することはありません。 -.I opt_ttl -フィールドはオプションであり、 -time-to-live フィールドを指定する整数値となります。 -このデフォルト値はゼロであり、 +.Ar opt_domain +フィールドやインクルードファイル中の +.Li $ORIGIN +宣言はそのファイル自身の現在の起点を変更することはありません。 +.It Ar opt_ttl +このフィールドはオプションであり、 +time-to-live を整数値で指定します。 +このデフォルト値は 0 であり、 そのゾーンの SOA レコードに指定された最小値を意味します。 -.I opt_class -フィールドはオブジェクトのアドレスの型を指定します。 +.It opt_class +オブジェクトのアドレスの型を指定します。 現在はDARPAインターネットに接続するオブジェクトである -.BR IN +.Dv IN のみがサポートされています。 -.I type -フィールドには以下のトークンのうちひとつが含まれます。 +.It Ar type +このフィールドには以下のトークンのうちひとつが含まれます。 括弧中におのおの -.I resource_record_data +.Ar resource_record_data フィールドに指定すべきデータを示しています。 -.TP "\w'MINFO 'u" -A -ホストアドレス (4つ組ドット) -.IP NS -信頼できるネームサーバ (ドメイン) -.IP MX +.Bl -tag -width "HINFO " -offset indent +.It Dv A +ホストアドレス (4つ組ドット IP アドレス) +.It Dv NS +権威があるネームサーバ (ドメイン) +.It Dv MX メールエクスチェンジャ (ドメイン) 優先順位 (0..32767) に引続き指定します。 優先順位は小さい値が優先順位の高いことを示します。 -.IP CNAME +.It Dv CNAME 別名に対応した正式名 (ドメイン) -.IP SOA +.It Dv SOA オーソリティゾーンデータの開始を示します。 (ホストの属するドメイン、メンテナのドメインアドレス、 シリアル番号、その後にリフレッシュ、リトライ、有効期限、最小 TTL (RFC 883を参照) の各値を秒で指定したパラメータが続く)。 -.IP NULL +.It Dv NULL ヌルリソースレコード (形式やデータはありません) -.IP RP +.It Dv RP いくつかのドメイン名の責任者 (メールアドレスか参照できるテキスト) -.IP PTR +.It Dv PTR ドメイン名のポインタ (ドメイン) -.IP HINFO +.It Dv HINFO ホスト情報 (CPUタイプ、OSタイプ) -.PP +.El +.El +.Pp 通常は行末でリソースレコードは終了しますが、 左括弧と右括弧で囲まれた場合は複数行にまたがることが可能となります。 セミコロンから行末まではコメントとして扱われます。 -.PP +.Pp +.Sy 注釈: ここには示されていませんが、このほかのタイプのリソースレコードも存在します。 リソースレコードのすべてのタイプを知るには -\s-1BIND\s+1 Operations Guide (``\s-1BOG\s+1'') を参照する必要があるでしょう。 +.Sy BIND +Operations Guide +.Pq Dq BOG +を参照する必要があるでしょう。 新しい RFC にていくつかのリソースタイプが標準化されていますが、 -このバージョンの \s-1BIND\s+1 ではまだ実装されていません。 -.PP +このバージョンの +.Sy BIND +ではまだ実装されていません。 +.Ss SOA レコード形式 各マスタゾーンファイルはそのゾーンの SOA レコードで始まらなければなりません。 以下に SOA レコードの例を示します。 -.LP -.nf -@ IN SOA ucbvax.Berkeley.EDU. rwh.ucbvax.Berkeley.EDU. ( -.ta \w'x\ IN\ SOA\ 'u +\w'1989020501\ 'u - 1989020501 ; serial - 10800 ; refresh - 3600 ; retry - 3600000 ; expire - 86400 ) ; minimum -.fi -.LP -SOA ではシリアル番号を指定します。 +.Bd -literal +@ IN SOA ucbvax.Berkeley.EDU. rwh.ucbvax.Berkeley.EDU. ( + 1989020501 ; serial + 10800 ; refresh + 3600 ; retry + 3600000 ; expire + 86400 ) ; minimum +.Ed +.Pp +SOA ではシリアル番号 (serial) を指定します。 シリアル番号はマスタファイルを更新するたびに変更する必要があります。 -シリアル番号 (serial) は少数点つきの数字を指定することもできますが、 +シリアル番号は小数点つきの数字を指定することもできますが、 整数への変換は乗算や加算ではなく文字列としてつなげて行っているため、 -あまり賢い方法とはいえません。 +.Em あまり +賢い方法とはいえません。 年月日と 0〜99 のシリアル番号を使用することで、 このフィールドのサイズである符号なしの 32 ビット以内に収まります。 -このやり方はグレゴリ暦の 4294 年には考え直す必要があることは確かですが、 -それについては心配する必要はないでしょう。 +(このやり方は 4294 年には考え直す必要があることは確かですが、 +それについては心配する必要はないでしょう)。 +.Pp セカンダリサーバは秒で指定されたリフレッシュ時間 (refresh) の間隔で シリアル番号をチェックします。 シリアル番号に変更があれば、新しいデータを読み込むために @@ -430,64 +361,102 @@ SOA ではシリアル番号を指定します。 リフレッシュ時間が過ぎてもマスタサーバに接続できない場合は、 リトライ時間 (retry) の間隔でリフレッシュが試みられます。 期限切れ時間 (expire) が過ぎてマスタサーバに接続できない場合は、 -セカンダリサーバはそのゾーンの全てのデータを破棄します。 -最小値 (minimum) はファイル中の生存時間 (``\s-1TTL\s+1'') が -明示的に指定されていないレコードの生存時間となります。 -.SH 注釈 -ブートファイルでの ``domain'' と ``suffixes'' の指定は廃止され、 +セカンダリサーバはそのゾーンのすべてのデータを破棄します。 +最小値 (minimum) はファイル中の生存時間 +.Pq Dq TTL +が明示的に指定されていないレコードの生存時間となります。 +.Sh 注釈 +ブートファイルでの +.Dq Li domain +と +.Dq Li suffixes +の指定は廃止され、 もっと便利なリゾルバベースの実装、すなわち部分的な形のドメイン名 -(partially qualified domain names) の接尾辞に置き変えられました。 +(partially-qualified domain names) の接尾辞に置き変えられました。 以前のメカニズムでは多くの状況下で失敗することがあり、 特にローカルネームサーバが完全な情報を持っていない場合に失敗しました。 -.sp +.Pp 以下に各シグナルを -.IR kill (1) +.Xr kill 1 コマンドによってサーバに送った場合の効果を示します。 -.IP SIGHUP -サーバは named.boot を読み、データベースをロードし直します。 -サーバがコンパイルオプションの FOCED_RELOAD を定義されて -コンパイルされている場合は、 -SIGHUPを送るとサーバは全てのセカンダリゾーンのシリアル番号もチェックします。 +.Pp +.Bl -tag -width "SIGWINCH" +.It Dv SIGHUP +サーバは +.Pa named.conf +を読み、データベースをロードし直します。 +サーバがコンパイルオプションの +.Li FOCED_RELOAD +を定義されてコンパイルされている場合は、 +.Dv SIGHUP +を送るとサーバはすべてのセカンダリゾーンのシリアル番号もチェックします。 通常、シリアル番号は SOA 中に指定された間隔でのみチェックされます。 -.IP SIGINT -現在のデータベースとキャッシュの内容を /var/tmp/named_dump.db にダンプします。 -.IP SIGIOT +.It Dv SIGINT +現在のデータベースとキャッシュの内容を +.Dq Pa /var/tmp/named_dump.db +または +.Dv _PATH_DUMPFILE +の値にダンプします。 +.It Dv SIGILL サーバが -DSTATS 付きでコンパイルされていれば、 -統計データを /var/tmp/named.stats にダンプします。 +統計データを +.Pa named.stats +にダンプします。 統計データはこのファイルの末尾に追加されます。 -いくつかのシステムでは SIGIOT ではなく SIGABRT で統計データのダンプを行います。 -.IP SIGSYS +.It Dv SIGSYS サーバがプロファイリング (サーバの fork, chdir と exit) を 有効にされてコンパイルされていれば、 -プロファイリングデータを /var/tmp にダンプします。 -.IP SIGTERM +プロファイリングデータを +.Pa /var/tmp +にダンプします。 +.It Dv SIGTERM プライマリおよびセカンダリのデータベースファイルをダンプします。 サーバが動的更新を有効にしてコンパイルされていれば、 シャットダウン時に更新されたデータをセーブするために使用されます。 -.IP SIGUSR1 +.It Dv SIGUSR1 デバッグ機能を有効にします。 -SIGUSR1が送られるたびにデバッグレベルが上がります。 -(SIGUSR1がない古いシステムではSIGEMTが使われます。) -.IP SIGUSR2 +.Dv SIGUSR1 +が送られるたびにデバッグレベルが上がります。 +.Po Dv SIGUSR1 +がない古いシステムでは +.Dv SIGEMT +が使われます。 +.Pc +.It Dv SIGUSR2 デバッグ機能を完全に無効にします。 -(SIGUSR2がない古いシステムではSIGFPEが使われます。) -.IP SIGWINCH -全てのサーバに入力される問い合わせの syslog(8) による +.Po Dv SIGUSR2 +がない古いシステムでは +.Dv SIGFPE +が使われます。 +.Pc +.It Dv SIGWINCH +すべてのサーバに入力される問い合わせの +.Xr syslog 8 +による ログ採取の有無を切り替えます。 -(ログ採取はサーバが QRYLOG オプションを指定されて +(ログ採取はサーバが +.Li QRYLOG +オプションを指定されて コンパイルされている必要があります。) -.SH 関連ファイル -.nf -.ta \w'/var/tmp/named_dump.db 'u -/etc/named.boot ネームサーバの設定ブートファイル -/etc/named.pid プロセス ID (旧システム) -/var/run/named.pid プロセス ID (新システム) -/var/tmp/named_dump.db ネームサーバデータベースのダンプ -/var/tmp/named.run デバッグ出力 -/var/tmp/named.stats ネームサーバの統計データ -.fi -.SH 関連項目 -kill(1), gethostbyname(3), signal(2), -resolver(3), resolver(5), hostname(7), +.Sh 関連ファイル +.Bl -tag -width "/var/tmp/named_dump.db (_PATH_DUMPFILE) " -compact +.It Pa /etc/namedb/named.conf +デフォルトのネームサーバの設定ファイル +.It Pa /var/run/named.pid Pq Dv _PATH_PIDFILE +プロセス ID +.It Pa /var/tmp/named_dump.db Pq Dv _PATH_DUMPFILE +ネームサーバデータベースのダンプ +.It Pa /var/tmp/named.run Pq file: Dv _PATH_DEBUG +デバッグ出力 +.It Pa /var/tmp/named.stats Pq file: Dv _PATH_STATS +ネームサーバの統計データ +.El +.Sh 関連項目 +.Xr gethostbyname 3 , +.Xr hostname 7 , +.Xr kill 1 , +.Xr resolver 3 , +.Xr resolver 5 , +.Xr signal 2 , RFC 882, RFC 883, RFC 973, RFC 974, RFC 1033, RFC 1034, RFC 1035, RFC 1123, -\fIName Server Operations Guide for \s-1BIND\s+1\fR +.Dq Name Server Operations Guide for Sy BIND diff --git a/ja/man/man8/natd.8 b/ja/man/man8/natd.8 index 020648a7c7..14a907cd66 100644 --- a/ja/man/man8/natd.8 +++ b/ja/man/man8/natd.8 @@ -1,5 +1,5 @@ .\" manual page [] for natd 1.4 -.\" %Id: natd.8,v 1.4.2.11 1998/07/18 11:11:23 jkh Exp % +.\" %Id: natd.8,v 1.15 1998/07/15 03:32:45 jkoshy Exp $% .\" jpman %Id% .Dd 15 April 1997 .Os FreeBSD diff --git a/ja/man/man8/ncrcontrol.8 b/ja/man/man8/ncrcontrol.8 index 1150b71200..0c43a9bd3c 100644 --- a/ja/man/man8/ncrcontrol.8 +++ b/ja/man/man8/ncrcontrol.8 @@ -22,7 +22,7 @@ .\" (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: ncrcontrol.8,v 1.4.2.1 1997/10/06 07:36:16 charnier Exp % +.\" %Id: ncrcontrol.8,v 1.7 1997/10/02 11:46:50 charnier Exp % .\" jpman %Id: ncrcontrol.8,v 1.3 1997/06/20 00:23:48 yugawa Stab % .\" .Dd September 16, 1994 diff --git a/ja/man/man8/ndc.8 b/ja/man/man8/ndc.8 index cbf9ce551f..0f82332ca9 100644 --- a/ja/man/man8/ndc.8 +++ b/ja/man/man8/ndc.8 @@ -30,99 +30,114 @@ .\" SUCH DAMAGE. .\" .\" jpman %Id: ndc.8,v 1.3 1997/09/07 14:10:53 horikawa Stab % -.TH NDC 8 "November 27, 1994" -.UC 5 -.SH 名称 -ndc \- ネームサーバデーモン制御インタフェース -.SH 書式 -.B ndc -.I directive -[ ... ] -.SH 解説 +.Dd November 27, 1994 +.Dt NDC 8 +.Os BSD 4 +.Sh 名称 +.Nm ndc +.Nd ネームサーバデーモン制御インタフェース +.Sh 書式 +.Nm ndc +.Ar directive +.Op Ar ... +.Sh 解説 このコマンドを使用する事により、ネームサーバの管理者はネームサーバに 各種シグナルを送ったり、ネームサーバをリスタートする事ができます。 以下のリストの 0 個以上の命令を指定する事ができます。 -.TP -.B status -.BR ps (1) +.Bl -tag -width "querylog" +.It Ic status +.Xr ps 1 で得られる -.B named +.Xr named 8 の現在の状態を表示します。 -.TP -.B dumpdb -.B named +.It Ic dumpdb +.Ic named のデータベースおよびキャッシュを -.B /var/tmp/named_dump.db +.Pa /var/tmp/named_dump.db に出力します。 -(INT シグナルを用います。) -.TP -.B reload -.B named +( +.Dv INT +シグナルを用います。) +.It Ic reload +.Ic named の全てのプライマリおよびセカンダリゾーンのシリアル番号を調べ、 変更のあったものをリロードします。 -(HUP シグナルを用います。) -.TP -.B stats -.B named +( +.Dv HUP +シグナルを用います。) +.It Ic stats +.Ic named の現在の統計的な状況を -.B /var/tmp/named.stats +.Pa /var/tmp/named.stats に出力します。 -(IOT ないし ABRT シグナルを用います。) -.TP -.B trace -.B named -の ``tracing level'' を 1 だけ増加させます。``tracing level'' が 0 以上の時、 +( +.Dv IOT +ないし +.Dv ABRT +シグナルを用います。) +.It Ic trace +.Ic named +の +.Dq トレースレベル +を 1 だけ増加させます。トレースレベルが 0 以上の時、 トレース情報は -.BR /var/tmp/named.run -に出力します。``tracing level'' が高い程、詳細な情報が得られます。 -(USR1 シグナルを用います。) -.TP -.B notrace -.B named -の ``tracing level'' を 0 にし、 -.B /var/tmp/named.run +.Pa /var/tmp/named.run +に出力します。トレースレベルが高い程、詳細な情報が得られます。 +( +.Dv USR1 +シグナルを用います。) +.It Ic notrace +.Ic named +の +.Dq トレースレベル +を 0 にし、 +.Pa /var/tmp/named.run がオープンされていればクローズします。 -(USR2 シグナルを用います。) -.TP -.B querylog -.B named -の ``query logging'' を、現在有効になっていれば無効へ、 +( +.Dv USR2 +シグナルを用います。) +.It Ic querylog +.Ic named +の +.Dq 問い合わせ記録 +を、現在有効になっていれば無効へ、 現在無効になっていれば有効へ変更します。 -(WINCH シグナルを用います。) -``query logging'' が有効になっている場合、 +( +.Dv WINCH +シグナルを用います。) +問い合わせ記録が有効になっている場合、 ネームサーバへの問い合わせ情報を -.BR syslog (3) -に記録します。 -``query logging'' を有効にすると非常に多くの情報がログファイルに +.Xr syslog 2 +で記録します。 +問い合わせ記録を有効にすると非常に多くの情報がログファイルに 記録されることに注意して下さい。この命令は -.BR qrylog +.Ic qrylog と指定することも可能です。 -.TP -.B start -.B named +.It Ic start +.Ic named が実行中でなければ、実行を開始します。 -.TP -.B stop -.B named +.It Ic stop +.Ic named が実行中であれば、停止します。 -.TP -.B restart -.B named +.It Ic restart +.Ic named を停止させた後、再度実行します。 -.SH バグ -.B named +.El +.Sh バグ +.Ic named への引数は、 -.BR restart +.Ic restart では保存されず、 -.BR start +.Ic start では指定できません。 +.Pp パラメータや環境を制御する何らかの方法が必要でしょう。 -.PP -.BR sh (1) +.Pp +.Xr sh 1 スクリプトにより作成されています。 -.SH 作者 +.Sh 作者 Paul Vixie (Internet Software Consortium) .SH 関連項目 -named(8), -named.reload(8), -named.restart(8) +.Xr named 8 , +.Xr named.reload 8 , +.Xr named.restart 8 . diff --git a/ja/man/man8/netboot.8 b/ja/man/man8/netboot.8 index 6b115f46b8..3b9c03c9e6 100644 --- a/ja/man/man8/netboot.8 +++ b/ja/man/man8/netboot.8 @@ -1,4 +1,4 @@ -.\" %Id: netboot.8,v 1.3.6.1 1997/08/15 13:46:28 tegge Exp % +.\" %Id: netboot.8,v 1.4 1997/09/29 19:11:29 wosch Exp % .\" jpman %Id% .\" .\" Japanese Translation made by Norihiro Kumagai, 12/5/97. @@ -101,8 +101,8 @@ NE1000/NE2000 カード用の DOS 実行形式ファイル。 3C509 カード用の DOS 実行形式ファイル。 .Sh 関連項目 -.Xr bootpd 8 , -.Xr bootptab 5 +.Xr bootptab 5 , +.Xr bootpd 8 .Sh バグ netboot を Western Digital/SMC や 3C503 カードで使用する場合、Makefile diff --git a/ja/man/man8/newfs.8 b/ja/man/man8/newfs.8 index 170931e237..29b679735e 100644 --- a/ja/man/man8/newfs.8 +++ b/ja/man/man8/newfs.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)newfs.8 8.6 (Berkeley) 5/3/95 -.\" %Id: newfs.8,v 1.7.2.4 1998/07/17 20:13:38 jkh Exp % +.\" %Id: newfs.8,v 1.15 1998/07/15 06:28:04 charnier Exp % .\" jpman %Id: newfs.8,v 1.3 1997/07/26 22:02:06 horikawa Stab % .\" .Dd May 3, 1995 diff --git a/ja/man/man8/newsyslog.8 b/ja/man/man8/newsyslog.8 index d1b693d54a..d2844ab6f9 100644 --- a/ja/man/man8/newsyslog.8 +++ b/ja/man/man8/newsyslog.8 @@ -1,7 +1,7 @@ .\" This file contains changes from the Open Software Foundation. .\" .\" from: @(#)newsyslog.8 -.\" %Id: newsyslog.8,v 1.1.1.1.2.8 1998/07/18 11:11:30 jkh Exp % +.\" %Id: newsyslog.8,v 1.14 1998/06/09 18:24:04 ache Exp % .\" jpman %Id: newsyslog.8,v 1.3 1997/08/16 13:33:00 horikawa Stab % .\" .\" Copyright 1988, 1989 by the Massachusetts Institute of Technology diff --git a/ja/man/man8/nextboot.8 b/ja/man/man8/nextboot.8 index 219cd5c946..00b0ddb3d8 100644 --- a/ja/man/man8/nextboot.8 +++ b/ja/man/man8/nextboot.8 @@ -1,4 +1,4 @@ -.\" %Id: nextboot.8,v 1.3.2.2 1998/07/17 20:13:19 jkh Exp % +.\" %Id: nextboot.8,v 1.8 1998/06/30 06:28:17 charnier Exp % .\" jpman %Id: nextboot.8,v 1.3 1997/08/16 13:35:00 horikawa Stab % .Dd July 9, 1996 .Dt NEXTBOOT 8 diff --git a/ja/man/man8/nfsiod.8 b/ja/man/man8/nfsiod.8 index 54e3040877..9fe33703e0 100644 --- a/ja/man/man8/nfsiod.8 +++ b/ja/man/man8/nfsiod.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" From: @(#)nfsiod.8 8.2 (Berkeley) 2/22/94 -.\" %Id: nfsiod.8,v 1.3.2.1 1998/07/17 20:13:42 jkh Exp % +.\" %Id: nfsiod.8,v 1.6 1998/07/15 06:35:20 charnier Exp % .\" jpman %Id: nfsiod.8,v 1.3 1997/08/10 18:33:51 horikawa Stab % .\" .Dd September 22, 1994 diff --git a/ja/man/man8/nologin.8 b/ja/man/man8/nologin.8 index d383a49d7e..f7f50635fa 100644 --- a/ja/man/man8/nologin.8 +++ b/ja/man/man8/nologin.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)nologin.8 8.1 (Berkeley) 6/19/93 -.\" %Id: nologin.8,v 1.1.1.1.8.1 1998/07/17 20:13:42 jkh Exp % +.\" %Id: nologin.8,v 1.2 1998/07/15 06:37:07 charnier Exp % .\" jpman %Id: nologin.8,v 1.2 1997/03/31 14:54:31 horikawa Stab % .\" .Dd June 19, 1993 diff --git a/ja/man/man8/nslookup.8 b/ja/man/man8/nslookup.8 index b467f23d53..7cd5969894 100644 --- a/ja/man/man8/nslookup.8 +++ b/ja/man/man8/nslookup.8 @@ -55,337 +55,497 @@ .\" @(#)nslookup.8 5.3 (Berkeley) 6/24/90 .\" jpman %Id: nslookup.8,v 1.2 1997/04/30 00:39:04 mutoh Stab % .\" -.TH NSLOOKUP 8 "June 24, 1990" -.UC 6 -.SH 名称 -nslookup \- インターネットネームサーバに対話的に問い合わせる -.SH 書式 -.B nslookup -[ -.I \-option ... -] -[ -.I host-to-find -| \- [ -.I server -]] -.SH 解説 -.I nslookup +.Dd June 24, 1990 +.Dt NSLOOKUP 8 +.Os BSD 4 +.Sh 名称 +.Nm nslookup +.Nd インターネットネームサーバに対話的に問い合わせる +.Sh 書式 +.Nm nslookup +.Op Fl option Ar ... +.Op Ar host-to-find | Fl Op Ar server +.Sh 解説 +.Ic nslookup はインターネットネームサーバに問い合わせを行います。 -.I nslookup -には対話モードと非対話モードの二つのモードがあります。 +.Ic nslookup +には対話モードと非対話モードの 2 つのモードがあります。 対話モードでは、 様々なホストやドメインの情報をネームサーバに対して問い合わせたり、 あるドメイン内のホスト一覧を表示することができます。 非対話モードでは、あるホストもしくはドメインの名前および 要求した情報のみが表示されます。 -.sp 1 -.SH 引数 +.Sh 引数 次の場合は対話モードに入ります。 -.IP a) 4 +.Bl -tag -width "a) " +.It a) 引数が与えられなかったとき(デフォルトのネームサーバを利用します)。 -.IP b) 4 -最初の引数がハイフン (\-) であり、二番目の引数がネームサーバの +.It b) +最初の引数がハイフン (-) であり、2 番目の引数がネームサーバの ホスト名もしくは IP アドレスであるとき。 -.LP +.El +.Pp 検索したいホストの名前もしくは IP アドレスが最初の引数として与えられた場合は、 非対話モードになります。 -二番目の引数はオプションで、ネームサーバのホスト名もしくは IP アドレスを +2 番目の引数はオプションで、ネームサーバのホスト名もしくは IP アドレスを 指定します。 -.LP -``set'' コマンドを使うオプションは、ホームディレクトリの .nslookuprc -ファイルに一行に一つずつ書くことでも指定できます。 +.Pp +.Dq Li set +コマンドを使うオプションは、ホームディレクトリの +.Pa .nslookuprc +ファイルに 1 行に 1 つずつ書くことでも指定できます。 オプションはコマンドラインで指定することも可能です。その場合、 前にハイフンをつけ、引数より先に書きます。たとえば、デフォルトの問い合わせを ホスト情報に変更し、初期タイムアウトを 10 秒とするには、 -.sp .5v - nslookup \-query=hinfo \-timeout=10 -.sp .5v +.Bd -literal -offset indent + nslookup -query=hinfo -timeout=10 +.Ed とします。 -.SH "対話 コマンド" +.Sh 対話コマンド コマンドは control-C を入力することでいつでも中断できます。 -終了するには、 control-D (EOF) もしくは exit を入力します。 +終了するには、 control-D +.Pq Dv EOF +もしくは +.Li exit +を入力します。 コマンドラインの長さは 256 文字以下でなければなりません。 内部コマンドをホスト名として扱うには、 -エスケープ文字 (\e) を頭につけます。 -\fB注意:\fP 解釈できないコマンドはホスト名として扱われます。 -.sp .5v -.IP "\fIhost\fP [\fIserver\fP]" -\fIhost\fP についての情報を現在のデフォルトサーバ、もしくは -\fIserver\fPが指定されている場合はそのサーバに問い合わせます。 -\fIhost\fP が IP アドレスであり、問い合わせタイプが A もしくは PTR +エスケープ文字 +.Pq \e +を頭につけます。 +.Sy 注意: 解釈できないコマンドはホスト名として扱われます。 +.Bl -tag -width "lserver" +.It Ar host Op Ar server +.Ar host +についての情報を現在のデフォルトサーバ、もしくは +.Ar server +が指定されている場合はそのサーバに問い合わせます。 +.Ar host +が IP アドレスであり、問い合わせタイプが +.Dv A +もしくは +.Dv PTR であるときは、ホスト名が返されます。 -\fIhost\fP が 名前であり、最後にピリオドがないときには、 +.Ar host が 名前であり、最後にピリオドがないときには、 その後ろにデフォルトのドメイン名が付加されます(この動作は、 -\fBset\fP オプションの \fBdomain\fP, \fBsrchlist\fP, -\fBdefname\fP, \fBsearch\fP に依存します)。 +.Ic set +オプションの +.Ic domain , srchlist , defname , search +に依存します)。 +.Pp 現在のドメインにないホストについて調べるときには、 名前の末尾にピリオドを付加します。 -.sp 1 -.IP "\fBserver\fP \fIdomain\fP" -.ns -.IP "\fBlserver\fP \fIdomain\fP" -デフォルトサーバを \fIdomain\fP に変更します。 -\fBlserver\fP は \fIdomain\fP に -ついての情報を探すのに初期サーバを使い、\fBserver\fPは -現在のデフォルトサーバを使います。 +.It Ic server Ar domain +.It Ic lserver Ar domain +デフォルトサーバを +.Ar domain +に変更します。 +.Ic lserver +は +.Ar domain +についての情報を探すのに初期サーバを使い、 +.Ic server +は現在のデフォルトサーバを使います。 公式の答えが見つからないときには、答えを持つ可能性のある サーバ名が返されます。 -.sp 1 -.IP \fBroot\fP +.It Ic root デフォルトサーバをドメイン名空間のルートサーバに変更します。 -現在のところホスト ns.internic.net が使われます -(このコマンドは \fBlserver ns.internic.net\fP に同義です)。 -ルートサーバ名は \fBset root\fP コマンドで変更できます。 -.sp 1 -.IP "\fBfinger\fP [\fIname\fP] [\fB>\fP \fIfilename\fP]" -.ns -.IP "\fBfinger\fP [\fIname\fP] [\fB>>\fP \fIfilename\fP]" +現在のところホスト +.Li ns.internic.net +が使われます +(このコマンドは +.Dq Ic lserver ns.internic.net +に同義です)。 +ルートサーバ名は +.Dq Ic set root +コマンドで変更できます。 +.It Xo Ic finger Op Ar name +.Op Ic > Ar filename +.Xc +.It Xo Ic finger Op Ar name +.Op Ic >> Ar filename +.Xc 現在のホストにあるフィンガーサーバと接続します。 現在のホストは、以前の問い合わせが成功し、アドレス情報が -返されたときに定義されます(\fBset querytype=A\fP 参照)。 -\fIname\fP はオプションです。 -\fB>\fP と \fB>>\fP は普通に出力をリダイレクトするのに使えます。 -.sp 1 -.IP "\fBls\fR [\fIoption\fR] \fIdomain\fR [\fB>\fR \fIfilename\fR]" -.ns -.IP "\fBls\fR [\fIoption\fR] \fIdomain\fR [\fB>>\fR \fIfilename\fR]" -\fIdomain\fP について入手できる情報の一覧を出します。 -オプションでファイル \fIfilename\fP を作成あるいは -\fIfilename\fP に追加できます。 +返されたときに定義されます( +.Dq Ic set querytype=A +参照)。 +.Ar name はオプションです。 +.Ic > +と +.Ic >> +は普通に出力をリダイレクトするのに使えます。 +.It Xo Ic ls Op Ar option +.Ar domain Op Ic > Ar filename +.Xc +.It Xo Ic ls Op Ar option +.Ar domain Op Ic >> Ar filename +.Xc +.Ar domain +について入手できる情報の一覧を出します。 +オプションでファイル +.Ar filename +を作成あるいは +.Ar filename +に追加できます。 デフォルトの出力にはホスト名とその IP アドレスが含まれます。 -.I オプション +.Ar option は下記のいずれかです。 .RS -.IP "\fB\-t \fIquerytype\fP" 4 -指定したタイプの全レコードの一覧を出力します(下記の \fIquerytype\fP 参照)。 -.IP \fB\-a\fP 4 +.Bl -tag -width "-a " +.It Fl t Ar querytype +指定したタイプの全レコードの一覧を出力します(下記の +.Ar querytype +参照)。 +.It Fl a そのドメイン内での、各ホストのエイリアス一覧を出力します。 -\fB\-t\ \ CNAME\fP と同義です。 -.IP \fB\-d\fP 4 +.Dq Fl t Dv CNAME +と同義です。 +.It Fl d そのドメインの全レコードの一覧を出力します。 -\fB\-t\ \ ANY\fP と同義です。 -.IP \fB\-h\fP 4 +.Dq Fl t Dv ANY +と同義です。 +.It Fl h そのドメインの CPU 及び OS 情報を出力します。 -\fB\-t\ \ HINFO\fP と同義です。 -.IP \fB\-s\fP 4 -そのドメイン内のホストの well-known サービスの一覧を出力します。 -\fB\-t\ \ WKS\fP と同義です。 -.P +.Dq Fl t Dv HINFO +と同義です。 +.It Fl s +そのドメイン内のホストの良く知られた (well-known) サービスの一覧を出力します。 +.Dq Fl t Dv WKS +と同義です。 +.El +.Pp 出力がファイルにリダイレクトされるときには、サーバから 50 レコードを -受け取るたびに区切りが入れられます。 -.RE -.sp 1 -.IP "\fBview\fP \fIfilename\fP" -直前の \fBls\fP コマンドの出力を並べ変え、 -\fImore\fP(1) +受け取るたびにハッシュマークが表示されます。 +.It Ic view Ar filename +直前の +.Ic ls +コマンドの出力を並べ変え、 +.Xr more 1 で出力します。 -.sp 1 -.ne 4 -.IP "\fBhelp\fP" -.ns -.IP "\fB?\fP" +.It Ic help +.It Ic ? コマンドの簡単な要約を表示します。 -.sp 1 -.IP "\fBexit\fP" +.It Ic exit プログラムを終了します。 -.sp 1 -.IP "\fBset\fP \fIkeyword\fP[=\fIvalue\fP]" +.It Xo Ic set Ar keyword +.Ns Op = Ns Ar value +.Xc このコマンドは探索に影響するオプションを変更するのに使われます。 有効な keyword は以下の通りです。 -.RS -.IP "\fBall\fP" -よく使われる \fBset\fP のオプションの現在の値を表示します。 +.Bl -tag -width "class=v" +.It Ic all +よく使われる +.Ic set +のオプションの現在の値を表示します。 現在のデフォルトサーバとホストに関する情報も表示されます。 -.IP "\fBclass=\fIvalue\fR" +.It Ic class= Ns Ar value 問い合わせのクラスを次のいずれかに変更します。 -.RS -.IP IN 10 -internet クラス。 -.IP CHAOS 10 +.Bl -tag -width "HESIOD " +.It Dv IN +インターネットクラス。 +.It Dv CHAOS chaos クラス。 -.IP HESIOD 10 +.It Dv HESIOD MIT Athena Hesiod クラス。 -.IP ANY 10 +.It Dv ANY 上記すべて。 -.P +.El +.Pp クラスは情報のプロトコルグループを特定します。 -.br -(デフォルト = IN, 略記 = cl) -.RE -.IP "\fB[no]debug\fP" +.Pp +(デフォルト = +.Dv IN; +略記 = +.Ic cl ) +.It Xo Op Ic no +.Ns Ic debug +.Xc デバッグモードにします。サーバに送られるパケットとそれに 対する返答について、より多くの情報が表示されます。 -.br -(デフォルト = nodebug, 略記 = [no]deb) -.IP "\fB[no]d2\fP" +.Pp +(デフォルト = +.Ic nodebug ; +略記 = +.Xo Op Ic no +.Ns Ic deb ) +.Xc +.It Xo Op Ic no +.Ns Ic d2 +.Xc 詳細なデバッグモードにします。 -パケットごとに重要な全てのフィールドが表示されます。 -.br -(デフォルト = nod2) -.IP "\fBdomain=\fIname\fR" -デフォルトドメイン名を \fIname\fP に変更します。 -\fBdefname\fP , \fBsearch\fP オプションの設定に応じて、 +パケットごとに重要なすべてのフィールドが表示されます。 +.Pp +(デフォルト = +.Ic nod2 ) +.It Ic domain= Ns Ar name +デフォルトドメイン名を +.Ar name に変更します。 +.Ic defname +と +.Ic search +オプションの設定に応じて、 探索要求されるホスト名にデフォルトドメイン名が付加されます。 -デフォルトドメイン名が二つ以上の要素から +デフォルトドメイン名が 2 つ以上の要素から なるとき、ドメインサーチリストにはデフォルトドメインの親が含まれます。 たとえば、デフォルトドメイン名が CC.Berkeley.EDU であるとき、サーチリストは CC.Berkeley.EDU 及び Berkeley.EDU です。 -異なるリストを指定するには、 \fBset srchlist\fP コマンドを使います。 -このリストを表示するには、 \fBset all\fP コマンドを使います。 -.br -(デフォルト = ホスト名から得た値, /etc/resolv.conf あるいは LOCALDOMAIN, -略記 = do) -.IP "\fBsrchlist=\fIname1/name2/...\fR" -デフォルトドメイン名を \fIname1\fP にし、ドメインサーチリストを -\fIname1\fP, \fIname2\fP, ...に変更します。スラッシュ (/) で区切って +異なるリストを指定するには、 +.Dq Ic set srchlist +コマンドを使います。 +このリストを表示するには、 +.Dq Ic set all +コマンドを使います。 +.Pp +(デフォルト = +.Xr hostname 1 +から得た値, +.Pa /etc/resolv.conf +あるいは +.Pa LOCALDOMAIN; +略記 = +.Ic do ) +.It Ic srchlist= Ns Ar name1/name2/... +デフォルトドメイン名を +.Ar name1 +にし、ドメインサーチリストを +.Ar name1 , name2 , etc. +に変更します。スラッシュ (/) で区切って 最大 6 つまで指定可能です。 たとえば -.sp .5v - set\ srchlist=lcs.MIT.EDU/ai.MIT.EDU/MIT.EDU -.sp .5v +.Bd -literal -offset indent +set srchlist=lcs.MIT.EDU/ai.MIT.EDU/MIT.EDU +.Ed +.Pp の場合、ドメインを lcs.MIT.EDU にし、サーチリストを上の 3 つの名前に 設定します。 -このコマンドは、\fBset domain\fP コマンドによるデフォルトドメイン名と +このコマンドは、 +.Dq Ic set domain +コマンドによるデフォルトドメイン名と サーチリストを上書きします。 -リストを表示するには、 \fBset all\fP コマンドを使います。 -.br -(デフォルト = ホスト名に基づく値, /etc/resolv.conf あるいは LOCALDOMAIN, -略記 = srchl) -.IP "\fB[no]defname\fP" +リストを表示するには、 +.Dq Ic set all +コマンドを使います。 +.Pp +(デフォルト = +.Xr hostname 1 +に基づく値, +.Pa /etc/resolv.conf +あるいは +.Ev LOCALDOMAIN ; +略記 = +.Ic srchl ) +.It Xo Op Ic no +.Ns Ic defname +.Xc これが設定されると、単一要素からなる問い合わせ(すなわちピリオドのないもの) に対して、 指定したデフォルトドメイン名が付加されます。 -.br -(デフォルト = defname, 略記 = [no]def) -.IP "\fB[no]search\fP" -問い合わせ要求にピリオドが少なくとも一つ含まれているが -ピリオドで終ってはいない場合、 +.Pp +(デフォルト = +.Ic defname ; +略記 = +.Xo Op Ic no +.Ns Ic defname ) +.Xc +.It Xo Op Ic no +.Ns Ic search +.Xc +問い合わせ要求にピリオドが少なくとも 1 つ含まれているが +ピリオドで終っては +.Em いない +場合、 答えが受け取れるまで、ドメインサーチリスト内のドメイン名を 付加します。 -.br -(デフォルト = search, 略記 = [no]sea) -.IP "\fBport=\fIvalue\fR" -デフォルトのネームサーバの TCP/UDP ポートを \fIvalue\fP に変更します。 -.br -(デフォルト = 53, 略記 = po) -.IP "\fBquerytype=\fIvalue\fR" -.ns -.IP "\fBtype=\fIvalue\fR" -.ns +.Pp +(デフォルト = +.Ic search ; +略記 = +.Xo Op Ic no +.Ns Ic sea ) +.Xc +.It Ic port= Ns Ar value +デフォルトのネームサーバの TCP/UDP ポートを +.Ar value +に変更します。 +.Pp +(デフォルト = 53; +略記 = +.Ic \&po ) +.It Ic querytype= Ns Ar value +.It Ic type= Ns Ar value 問い合わせる情報の種類を変更します。情報は次のうちのいずれかです。 -.RS -.IP A 10 +.Bl -tag -width "HINFO " +.It Dv A ホストの IP アドレス。 -.IP CNAME 10 +.It Dv CNAME 別名に対する正式名。 -.IP HINFO 10 +.It Dv HINFO ホストの CPU と OS の種類。 -.IP MINFO 10 +.It Dv MINFO メールボックスもしくは、メールリストに関する情報。 -.IP MX 10 +.It Dv MX メール交換ホスト。 -.IP NS 10 +.It Dv NS その名前空間内のネームサーバ。 -.IP PTR 10 +.It Dv PTR 問い合わせが IP アドレスであればホスト名、そうでなければ それ以外の情報へのポインタ。 -.IP SOA 10 -ドメインの ``start-of-authority'' 情報。 -.IP TXT 10 +.It Dv SOA +ドメインの +.Dq 権威開始 (start-of-authority) +情報。 +.It Dv TXT テキスト情報。 -.IP UINFO 10 +.It Dv UINFO ユーザ情報。 -.IP WKS 10 -サポートする well-known サービス。 -.P -他のタイプ (ANY, AXFR, MB, MD, MF, NULL) については、ドキュメント +.It Dv WKS +サポートする、よく知られたサービス。 +.El +.Pp +他のタイプ +.Pq Dv ANY, AXFR, MB, MD, MF, NULL +については、ドキュメント RFC-1035 に書かれています。 -.br -(デフォルト = A, 略記 = q, ty) -.RE -.IP "\fB[no]recurse\fP" +.Pp +(デフォルト = +.Dv A ; +略記 = +.Ic q, ty ) +.It Xo Op Ic no +.Ns Ic recurse +.Xc サーバが情報を持っていないときに、他のサーバに問い合わせるよう 指示します。 -.br -(デフォルト = recurse, 略記 = [no]rec) -.IP \fBretry=\fInumber\fR -リトライ回数を \fInumber\fP 回とします。 -要求に対する返答をある時間内 (\fBset timeout\fP で変更できる) に +.Pp +(デフォルト = +.Ic recurse ; +略記 = +.Xo Op Ic no +.Ns Ic rec ) +.Xc +.It Ic retry= Ns Ar number +リトライ回数を +.Ar number +回とします。 +要求に対する返答をある時間内 ( +.Dq Ic set timeout +で変更できる) に 受け取らなかったとき、タイムアウト期間は 2 倍にされ、 要求が再送されます。 retry の値は、あきらめるまでに要求を何回再送するかを決めます。 -.br -(デフォルト = 4, 略記 = ret) -.IP \fBroot=\fIhost\fR -ルートネームサーバ名を \fIhost\fP に変更します。 -これは \fBroot\fP コマンドに影響します。 -.br -(デフォルト = ns.internic.net., 略記 = ro) -.IP \fBtimeout=\fInumber\fR -返答を待つ初期タイムアウト間隔を \fInumber\fP 秒に変更します。 +.Pp +(デフォルト = 4, 略記 = +.Ic ret ) +.It Ic root= Ns Ar host +ルートネームサーバ名を +.Ar host +に変更します。 +これは +.Dq Ic root +コマンドに影響します。 +.Pp +(デフォルト = +.Ic ns.internic.net ; +略記 = +.Ic ro ) +.It Ic timeout= Ns Ar number +返答を待つ初期タイムアウト間隔を +.Ar number +秒に変更します。 リトライのたびにタイムアウト間隔は倍になります。 -.br -(デフォルト = 5 seconds, 略記 = ti) -.IP "\fB[no]vc\fP" -サーバに 要求を出すときに常に 仮想回路 +.Pp +(デフォルト = 5 seconds; 略記 = +.Ic ti ) +.It Xo Op Ic no +.Ns Ic vc +.Xc +サーバに要求を出すときに、常に仮想回路 (virtual circuit) を使います。 -.br -(デフォルト = novc, 略記 = [no]v) -.IP "\fB[no]ignoretc\fP" +.Pp +(デフォルト = +.Ic novc ; +略記 = +.Xo Op Ic no +.Ns Ic v ) +.Xc +.It Xo Op Ic no +.Ns Ic ignoretc +.Xc パケットトランケーションエラーを無視します。 -.br -(デフォルト = noignoretc, 略記 = [no]ig) -.RE -.SH 診断 +.Pp +(デフォルト = +.Ic noignoretc ; +略記 = +.Xo Op Ic no +.Ns Ic ig ) +.Xc +.El +.El +.Sh 診断 問い合わせが失敗した場合、エラーメッセージが表示されます。 エラーには次のようなものがあります。 -.IP "Timed out" 5 -サーバに対する要求を、(\fBset timeout=\fIvalue\fR で変更できる)ある時間 -の間に(\fBset retry=\fIvalue\fR で変更できる)ある回数だけ +.Bl -tag -width "Timed" +.It Li Timed out +サーバに対する要求を、( +.Dq Ic set timeout= Ns Ar value +で変更できる)ある時間 +の間に( +.Dq Ic set retry= Ns Ar value +で変更できる)ある回数だけ リトライしましたが、応答しませんでした。 -.IP "No response from server" 5 +.It Li \&No response from server サーバマシンでネームサーバが動いていません。 -.IP "No records" 5 +.It Li \&No records ホスト名は正しいのですが、そのホストについて現在の問い合わせに 関する情報をサーバが持っていません。 -問い合わせる情報は \fBset querytype\fP コマンドで指定できます。 -.IP "Non-existent domain" 5 +問い合わせる情報は +.Dq Ic set querytype +コマンドで指定できます。 +.It Li Non-existent domain そのホスト名もしくはドメイン名が存在しません。 -.IP "Connection refused" 5 -.ns -.IP "Network is unreachable" 5 +.It Li Connection refused +.It Li Network is unreachable 現在のところネームサーバもしくはフィンガーサーバに対して 接続できません。 -このエラーは一般に \fBls\fP \fBfinger\fP 要求に対して起こります。 -.IP "Server failure" 5 +このエラーは一般に +.Ic ls +と +.Ic finger +要求に対して起こります。 +.It Li Server failure ネームサーバが内部でデータベースの矛盾を発見したため 正しい答えが返せませんでした。 -.IP "Refused" 5 +.It Li Refused ネームサーバが要求に対するサービスを拒否しました。 -.IP "Format error" 5 +.It Li Format error ネームサーバは要求パケットが適切なフォーマットになっていないと 判断しました。 -\fInslookup\fP 内にエラーがあるのかもしれません。 -.sp 1 -.SH 関連ファイル -.ta \w'/usr/share/misc/nslookup.helpXXX'u -/etc/resolv.conf ドメイン名の初期値とネームサーバのアドレスを記述するファイルです。 -.br -$HOME/.nslookuprc ユーザ用の初期化オプションを記述するファイルです。 -.br -/usr/share/misc/nslookup.help コマンドの要約です。 -.SH 環境変数 -.ta \w'HOSTALIASESXXXX'u -HOSTALIASES ホスト名のエイリアスを記述したファイル。 -.br -LOCALDOMAIN デフォルトドメインを上書きします。 -.SH 関連項目 -resolver(3), resolver(5), named(8), -.br -RFC-1034 ``Domain Names \- Concepts and Facilities'' -.br -RFC-1035 ``Domain Names \- Implementation and Specification'' -.SH 作者 +.Nm nslookup +内にエラーがあるのかもしれません。 +.El +.Sh 関連ファイル +.Bl -tag -width "/usr/share/misc/nslookup.helpXXX" -compact +.It Pa /etc/resolv.conf +ドメイン名の初期値とネームサーバのアドレスを記述するファイルです。 +.It Pa $HOME/.nslookuprc +ユーザ用の初期化オプションを記述するファイルです。 +.It Pa /usr/share/misc/nslookup.help +コマンドの要約です。 +.Sh 環境変数 +.Bl -tag -width "HOSTALIASESXXXX" -compact +.It Ev HOSTALIASES +ホスト名のエイリアスを記述したファイル。 +.It Ev LOCALDOMAIN +デフォルトドメインを上書きします。 +.Sh 関連項目 +.Xr named 8 , +.Xr resolver 3 , +.Xr resolver 5 ; +RFC-1034, +.Dq Domain Names - Concepts and Facilities ; +RFC-1035, +.Dq Domain Names - Implementation and Specification +.Sh 作者 Andrew Cherenson diff --git a/ja/man/man8/ntpdate.8 b/ja/man/man8/ntpdate.8 index 8df89e0651..aaa16c1966 100644 --- a/ja/man/man8/ntpdate.8 +++ b/ja/man/man8/ntpdate.8 @@ -1,75 +1,25 @@ -''' $Header -''' +.\" +.\" %Id: ntpdate.8,v 1.4 1998/02/19 08:05:35 charnier Exp % .\" jpman %Id: ntpdate.8,v 1.3 1997/09/12 02:30:46 seki Stab % -.de Sh -.br -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp -.if t .sp .5v -.if n .sp -.. -.de Ip -.br -.ie \\n.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -''' -''' Set up \*(-- to give an unbreakable dash; -''' string Tr holds user defined translation string. -''' Greek uppercase omega is used as a dummy character. -''' -.tr \(*W-|\(bv\*(Tr -.ie n \{\ -.ds -- \(*W- -.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -.ds L" "" -.ds R" "" -.ds L' ' -.ds R' ' -'br\} -.el\{\ -.ds -- \(em\| -.tr \*(Tr -.ds L" `` -.ds R" '' -.ds L' ` -.ds R' ' -'br\} -.TH NTPDATE 8 LOCAL -.SH 名称 -ntpdate - NTP を介して日付と時刻を設定する -.SH 書式 -.B ntpdate -[ -.B -bds -] [ -.B -o -.I version -] [ -.B -a -.I key# -] [ -.B -e -.I authdelay -] [ -.B -k -.I keyfile -] [ -.B -p -.I samples -] [ -.B -t -.I timeout -] -server ... -.SH 解説 -.I ntpdate +.\" +.Dd December 21, 1993 +.Dt NTPDATE 8 +.Os +.Sh 名称 +.Nm ntpdate +.Nd NTP を介して日付と時刻を設定する +.Sh 書式 +.Nm +.Op Fl bds +.Op Fl o Ar version +.Op Fl a Ar key# +.Op Fl e Ar authdelay +.Op Fl k Ar keyfile +.Op Fl p Ar samples +.Op Fl t Ar timeout +.Ar server ... +.Sh 解説 +.Nm は、正確な時刻を決めるために引数に与えられたホスト (複数可) の ネットワークタイムプロトコル (Network Time Protocol) サーバを調べることによって、 @@ -79,126 +29,131 @@ server ... 標準の NTP 時計フィルタと選択アルゴリズムを適用し、 その中から最良のものを選択します。 通常 -.I ntpdate +.Nm コマンドは、ブート時の時刻を設定するために起動時スクリプト -.I /etc/rc.local +.Pa /etc/rc.local の中に挿入したり、 -.IR cron (8) +.Xr cron 8 を介して時間毎に間欠的に走らせたりすることができます。 -.I ntpdate +.Nm の信頼性と正確さは、 -サーバ数が増えると劇的に改善することを覚えておいて下さい。 +サーバ数が増えると劇的に改善することを覚えておいてください。 単一のサーバを使っても構いませんが、 あまり多くないにしても、 -少なくとも三つないし四つのサーバを用意すると、 +少なくとも 3 つないし 4 つのサーバを用意すると、 より良い性能と、 どれかのサーバの部分的な狂いに対するより大きな抵抗性が得られます。 -.PP -.I ntpdate -は二つの方法のうちの一つで時刻の調整を行います。 -.I ntpdate +.Pp +.Nm +は 2 つの方法のうちの 1 つで時刻の調整を行います。 +.Nm は、時計が 0.5 秒以上ずれていると判断すると、 -.IR settimeofday (2) +.Xr settimeofday 2 を呼ぶことで単に時刻を合わせ直します。 しかし、 誤差が 0.5 秒以内のときは、デフォルトでは、そのずれを指定して -.IR adjtime (2) +.Xr adjtime 2 を呼ぶことで、時計の時刻を微調整します。 後者のテクニックは、ずれが小さいときには、より滑らかな上に正確であり、 -.I ntpdate +.Nm を -.I cron (8) +.Xr cron 8 で 1 〜 2 時間に一回走らせるときには、かなりうまく働きます。 後者の方法で行う調整は、実際には、計測されたずれよりも 50% 大きくなります。 -これは、ひどくフラフラする時計をより正確に保持するのに役立つからです。 -(安定性は少し犠牲になりますが、この取り引きは大抵は有効です。) +これは、ひどくフラフラする時計をより正確に保持するのに役立つからです +(安定性は少し犠牲になりますが、この取り引きは大抵は有効です)。 しかしブート時には、大抵の場合、必ず合わせ直す方がいいでしょう。 コマンドラインに -.B -b +.Fl b スイッチを指定することにより、すべての場合にこれを強制することができます。 -.B -s +.Fl s スイッチは、 -.I ntpdate +.Nm の動作を標準出力ではなく、 -.IR syslog (3) -ファシリティでログを取るようにします。 +.Xr syslog 3 +機能でログを取るようにします。 これはプログラムを -.IR cron (8) +.Xr cron 8 から走らせる際に便利なオプションです。 -.PP -.B -d +.Pp +.Fl d フラグは -.I ntpdate +.Nm が何を行うのかを、 実際に実行させずに知るために使われます。 一般のデバッグに便利な情報も出力されます。 デフォルトでは、 -.I ntpdate +.Nm は、パケットを出力するときに NTPバージョン 3 の実装であると自称します。 古いソフトウェアのいくつかはバージョン 3 の問い合わせへの返答を拒否するため、 代わりに -.B -o -.I version +.Fl o Ar version スイッチにより、 バージョン 2 または 1 の実装として調べるように強制できます。 -.PP -.I ntpdate +.Pp +.Nm が各サーバから得るサンプルの数は、 -.B -p +.Fl p スイッチを使って、 1 から 8 までを設定することができます。 デフォルトは 4 です。 応答待ちに使われる時間は -.B -t +.Fl t スイッチで設定でき、 0.2 秒の倍数に丸められます。 デフォルトは 1 秒で、これは LAN を通じて調べるのに適当な値です。 -.PP +.Pp 必要なら -.I ntpdate +.Nm ntpdate は、その処理を認証します。 -.B -a +.Fl a スイッチは、すべてのパケットは指定されたキー番号を使って 認証されなければならないという指定です。 -.B -k +.Fl k スイッチにより、デフォルトで -.I /etc/ntp.keys +.Pa /etc/ntp.keys となっている、キーを読み込むファイルの名前を変更できます。 このファイルは -.IR xntpd (8) +.Xr xntpd 8 に記載されているフォーマットで記述されなければなりません。 -.B -e -オプションは、認証処理による遅れを秒単位で指定できます。 +.Fl e +オプションは、認証処理による遅れを秒単位で指定できます (詳細は -.IR xntpd (8) -を参照して下さい。) +.Xr xntpd 8 +を参照してください)。 この値は、通常は -.I ntpdate +.Nm の用途では無視し得るほどわずかですが、 非常に遅い CPU ではこの数を指定することで、 -時間の正確さが改善するかも知れません。 -.PP -.I ntpdate +時間の正確さが改善するかもしれません。 +.Pp +.Nm は、同一ホスト上に NTP サーバデーモン (例えば -.IR xntpd (8) +.Xr xntpd 8 ) が走っているときには、時刻の設定を拒否します。 デーモンを走らせる代わりに -.I ntpdate +.Nm を -.IR cron (8) +.Xr cron 8 から定期的に走らせるときは、 -1 時間か 2 時間に一回動かせば、 +1 時間か 2 時間に 1 回動かせば、 時計の合わせ直しを避けて十分正確に時刻を刻むことになるでしょう。 -.SH 関連ファイル -.nf -/etc/ntp.keys\0\0 は、 \fIntpdate\fP で使われる暗号キーを含みます。 -.fi -.SH 関連項目 -xntpd(8) -.SH 歴史 -Toronto 大学の Dennis Ferguson によって書かれました。 -.SH バグ +.Sh 関連ファイル +.Bl -tag -width /etc/ntp.keys -compact +.It Pa /etc/ntp.keys +は +.Nm +で使われる暗号キーを含みます。 +.El +.Sh 関連項目 +.Xr xntpd 8 +.Sh 歴史 +Toronto 大学の +.An Dennis Ferguson +によって書かれました。 +.Sh バグ 時計の発振子の誤差を補正して精度を高めるために用いたテクニックは あまり出来がよくありませんが、 もっとうまくやるためには、 このプログラムが前回実行した時の状態を保存しておくことが必要となるでしょう。 + diff --git a/ja/man/man8/ntpq.8 b/ja/man/man8/ntpq.8 index c18eec4bce..0314b745d0 100644 --- a/ja/man/man8/ntpq.8 +++ b/ja/man/man8/ntpq.8 @@ -1,5 +1,6 @@ -''' $Header -''' +.\" +.\" %Id: ntpq.8,v 1.5 1998/02/19 08:05:38 charnier Exp % +.\" .\" jpman %Id: ntpq.8,v 1.3 1997/09/21 12:35:15 seki Stab % .\" .\" 対訳覚え書き (seki@sysrap.cs.fujitsu.co.jp 作成) @@ -17,63 +18,19 @@ .\" request 要求 .\" status word 状態ワード .\" time out (名詞) 制限時間 -.de Sh -.br -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp -.if t .sp .5v -.if n .sp -.. -.de Ip -.br -.ie \\n.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -''' -''' Set up \*(-- to give an unbreakable dash; -''' string Tr holds user defined translation string. -''' Greek uppercase omega is used as a dummy character. -''' -.tr \(*W-|\(bv\*(Tr -.ie n \{\ -.ds -- \(*W- -.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -.ds L" "" -.ds R" "" -.ds L' ' -.ds R' ' -'br\} -.el\{\ -.ds -- \(em\| -.tr \*(Tr -.ds L" `` -.ds R" '' -.ds L' ` -.ds R' ' -'br\} -.TH NTPQ 8 LOCAL -.SH 名称 -ntpq - ネットワークタイムプロトコルの標準問い合わせプログラム -.SH 書式 -.B ntpq -[ -.B -inp -] [ -.B -c -.I command -] [ -.I host -] [ -.I ... -] -.SH 解説 -.I ntpq +.Dd December 21, 1993 +.Dt NTPQ 8 +.Os +.Sh 名称 +.Nm ntpq +.Nd ネットワークタイムプロトコルの標準問い合わせプログラム +.Sh 書式 +.Nm +.Op Fl inp +.Op Fl c Ar command +.Op Ar host ... +.Sh 解説 +.Nm ntpq は、 推奨されている NTP モード 6 制御メッセージフォーマットを実装する NTP サーバに、 現在の状態について問い合わせを行なったり、 @@ -81,247 +38,233 @@ ntpq - ネットワークタイムプロトコルの標準問い合わせプログラム このプログラムは対話的モードでも、 コマンドラインの引数を使っても走らせることができます。 任意の変数を読み書きする要求を組み立てることができ、 -生のまま、または綺麗に整形する出力オプションがあります。 -.I ntpq +生のまま、または綺麗に整形して出力するオプションがあります。 +.Nm ntpq は、サーバに複数の問い合わせを送ることで、共通フォーマットにした peer のリストを得て、出力することができます。 -.PP -.I ntpq +.Pp +.Nm ntpq を実行するときに一つ以上の要求オプションがコマンドラインに含まれていれば、 それぞれの要求は、 コマンドラインで指定された各ホストで走っている NTP サーバ、 またはデフォルトでは -.I localhost +.Ar localhost で走っている NTP サーバに送られます。 要求オプションが与えられなかった場合、 -.I ntpq +.Nm ntpq は、コマンドを標準入力から読み込み、 コマンドラインで指定された最初のホストで走っている NTP サーバに対して実行しようとします。 このときも、 ホストが指定されていないときは、デフォルトで -.I localhost +.Ar localhost になります。 標準入力が端末装置である場合は、 -.I ntpq +.Nm ntpq はコマンドを求めるプロンプトを出します。 -.PP -.I ntpq -は NTP サーバと通信するために、 NTP モード 6 パケットを使います。 +.Pp +NTP サーバと通信するために、 +.Nm ntpq +は NTP モード 6 パケットを使います。 それゆえ、許可されていれば、 互換のあるどんなネットワーク上のサーバにでも問い合わせることができます。 NTP は UDP のプロトコルなので、特にネットワークトポロジ的に 遠くにある場合は、この伝達はやや信頼性に欠けるということを覚えておいて 下さい。 -.I ntpq +.Nm ntpq は、要求を再送する試みを一度行ない、 適当な制限時間の範囲内でリモートホストから返事がなかったときは、 その要求は時間切れとなります。 -.PP +.Pp コマンドラインオプションは以下の通りです。 -.B -i +.Fl i または -.B -n +.Fl n 以外のコマンドラインオプションを指定すると、指定したホスト (群) に、 指定した問い合わせ (または複数の問い合わせ) を直ちに送ることになります。 そうでなければ -.I ntpq +.Nm ntpq は、標準入力から対話形式のコマンドを読み込もうとします。 -.Ip -c 8 -後に続く引数は、対話形式のコマンドとして解釈され、 +以下のオプションが利用可能です。 +.Bl -tag -width indent +.It Fl c Ar command +後に続く引数は、対話形式の +.Ar コマンド +として解釈され、 指定されたホスト (群) に対して実行すべきコマンドのリストに 付け加えられます。 複数の -.B -c +.Fl c オプションも与えることができます。 -.Ip -i 8 -.I ntpq +.It Fl i +.Nm ntpq の操作を強制的に対話モードにします。標準出力にプロンプトが書き出され、 標準入力からコマンドが読み込まれます。 -.Ip -n 8 +.It Fl n すべてのホストアドレスを数字四つを点で区切った形式で出力し、 正規のホスト名に変換しません。 -.Ip -p 8 +.It Fl p そのサーバに知られている peer の一覧を、その状態の概要と共に出力します。 -これは、対話コマンド \*(L"peers\*(R" と同等です。 -.SH 内部コマンド -.PP +これは、対話コマンド +.Em peers +と同等です。 +.El +.Sh 内部コマンド +.Pp 対話形式コマンドは、キーワードとそれに続く 0 個から 4 個の 引数からなります。 キーワードの単語のうち、他に同じものがないとわかる数の文字がタイプされ ていれば大丈夫です。コマンドの出力は、通常標準出力に出力されますが、 -コマンドラインの後に \*(L">\*(R" とファイル名をつけると、 +コマンドラインの後に +.Qq > +とファイル名をつけると、 個々のコマンドの出力をファイルに出力することもできます。 -.PP +.Pp 多くの対話形式コマンドは、 -.I ntpq +.Nm ntpq プログラム自身の中で実行されてしまい、 サーバへ送られる NTP モード 6 リクエストとはなりません。 この種のコマンドを以下に挙げます。 -.PP -.B ? -[ -.I command_keyword -] -.PP -単独の \*(L"?\*(R" は、 -現在の -.I ntpq +.Pp +.Bl -tag -width indent +.It ? Op Ar command_keyword +単独の +.Qq ? +は、現在の +.Nm ntpq のすべてのコマンドキーワードの一覧を出力します。 -\*(L"?\*(R" の後にコマンドキーワードが続くときは、関数とコマンドの使いかた +.Qq ? +の後にコマンドキーワードが続くときは、関数とコマンドの使いかた を出力します。このコマンドは、 -.I ntpq +.Nm ntpq について、多分このマニュアルよりも良い情報源になります。 -.PP -.B timeout -.I millseconds -.PP +.Pp +.It timeout Ar millseconds サーバへの問い合わせに対する応答の、制限時間の長さを指定します。 -デフォルトは、約 5000 ミリ秒です。 -.I ntpq +デフォルトは約 5000 ミリ秒です。 +.Nm ntpq は制限時間が過ぎるとそれぞれの問い合わせを一回リトライするので、 合計の待ち時間は設定された制限時間の値の 2 倍になることを覚えておいて下さい。 -.PP -.B delay -.I milliseconds -.PP +.It delay Ar milliseconds 認証を必要とする要求に含めるタイムスタンプに追加すべき時間間隔を指定します。 これは、長い遅延のあるネットワーク経路や時計が同期していない マシン間での (信頼性の低い) サーバの再設定を可能にするために 使われます。 実際には、サーバは、今では認証される要求のタイムスタンプを必要としません。 そのため、このコマンドは、すたれているかもしれません。 -.PP -.B host -.I hostname -.PP +.It host Ar hostname 問い合わせを送るホストをセットします。 -.I hostname +.Ar hostname はホスト名でも数値アドレスでもかまいません。 -.PP -.B poll -[ -.I # -] [ -.B verbose -] -.PP +.It Xo poll +.Op Ar # +.Op Ar verbose +.Xc クライアントモードで現在のサーバをポーリングします。最初の引数はポーリングする 回数 (デフォルトは 1) であり、 2 番目の引数は結果の出力をより詳しく 得るために与えることができます。 このコマンドは、今のところ希望的観測でしかありません。 -.PP -.B keyid -.I # -.PP +.It keyid Ar # このコマンドは、設定要求を認証するために用いるキー番号を指定します。 これは、この目的で使うためにサーバに設定されているキー番号に 対応していなければなりません。 -.PP -.B passwd -.PP +.It passwd このコマンドは、設定要求を認証するために使われるパスワード (画面に表示されません) の入力を求めるプロンプトを出します。 その要求を成功させるためには、 このパスワードが、 NTP サーバがこの目的で使うように設定されたキーに 対応していなければなりません。 -.PP -.B "hostnames yes|no" -.PP -\*(L"yes\*(R" が指定されると、情報を表示するときにホスト名が出力されます。 -\*(L"no\*(R" が与えられると、代わりに数値アドレスが表示されます。 +.It hostnames Ar yes | no +.Ar yes +が指定されると、情報を表示するときにホスト名が出力されます。 +.Ar no +が与えられると、代わりに数値アドレスが表示されます。 コマンドラインの -.B -n -スイッチが使われなければ、 -デフォルトは \*(L"yes\*(R" になります。 -.PP -.B raw -.PP +.Fl n +スイッチが使われなければ、デフォルトは +.Ar yes +になります。 +.It raw 問い合わせコマンドに対するすべての出力を、リモートサーバから受け取った 通りに出力します。 データに対して行なわれる唯一の整形/解釈は、印字できる (しかしめったに理解できない) 形になるように、アスキー文字でないデータを 変換することです。 -.PP -.B cooked -.PP -問い合わせコマンドからの出力を、 \*(L"加工済み (cooked)\*(R" 形にします。 +.It cooked +問い合わせコマンドからの出力を、 +.Qq 加工済み (cooked) +形にします。 サーバに認識された変数は、人間に使える形に再整形された値に なります。 -.I ntpq +.Nm ntpq が、その変数は本来デコードできる値を持っていると判断したのに、 -デコードされていないものには、後に \*(L"?\*(R" が付けられます。 -.PP -.B ntpversion -.B 1|2|3 -.PP -.I ntpq +デコードされていないものには、その後に +.Qq ? +が付けられます。 +.It ntpversion Ar 1 | Ar 2 | Ar 3 +.Nm ntpq がパケットの中で自称する NTP のバージョン番号をセットします。 デフォルトでは 3 です。 モード 6 制御メッセージ (詳しく言うとモードも) は、 NTP バージョン 1 には存在しなかったことに注意して下さい。 バージョン 1 を必要とするサーバは残っていないようですが。 -.PP -.B authenticate -.B yes|no -.PP +.It authenticate Ar yes | Ar no 通常、 -.I ntpq +.Nm ntpq は、 書き込み要求でない限り要求を認証しません。 コマンド -.B authenticate yes +.Em authenticate yes は、 -.I ntpq +.Nm ntpq が生成するすべての要求に認証をつけて送るようにします。 認証された要求は、サーバによっては少し異なって扱われます。 もしも peer 表示を行う前に認証をオンにすると、 時々 fuzzball の CPU を溶かしてしまうかもしれません。 -.PP -.B addvars -.IR <variable_name>[=<value>] [,...] -.B rmvars -.IR <variable_name> [,...] -.B clearvars -.PP +.It Xo addvars +.Aq variable_name Ns +.Op = Ns Aq value> Ns +.Op ,... +.Xc +.It Xo rmvars +.Aq variable_name Ns +.Op ,... +.Xc +.It clearvars NTP モード 6 メッセージが運ぶデータは、次の形の 項目のリストから成ります。 -.IP "" 8 -<variable_name>=<value> -.PP -ここで、サーバの変数を読み取る要求では、この \*(L"=<value>\*(R" は -無視されるので、省略することができます。 -.I ntpq +.Xo Aq variable_name Ns +.Pf = Aq value +.Xc +ここで、サーバの変数を読み取る要求では、この +.Qq = Ns Aq value +は無視されるので、省略することができます。 +.Nm ntpq は、制御メッセージに含まれるデータを組み立てるための内部リストを保持しており、 以下に述べる -.B readlist +.Em readlist や -.B writelist +.Em writelist コマンドを使って送ります。 -.B addvars +.Em addvars コマンドで、このリストに、変数と省略可能な値を追加することができます。 一つ以上の変数を追加するときには、リストはコンマで区切り、 空白を含んではいけません。 -.B rmvars +.Em rmvars コマンドは、個々の変数をリストから削除するために用い、 -.B clearlist +.Em clearlist コマンドは、リストからすべての変数を削除します。 -.PP -.B debug -.I more|less|off -.PP +.It debug Ar more | Ar less | Ar off 問い合わせプログラムの内部のデバッグをオンまたはオフにします。 -.PP -.B quit -.PP -.I ntpq +.It quit +.Nm ntpq を終了します。 -.SH 制御メッセージコマンド -.PP +.El +.Sh 制御メッセージコマンド ある NTP サーバが知っている各 peer には、 -.I アソシエーション番号 -.I (association identifier) +.Em アソシエーション番号 +.Em (association identifier) という 16 ビット整数が割り当てられています。 peer 変数を使う NTP 制御メッセージは、 アソシエーション番号を含めることによって、 @@ -329,7 +272,7 @@ peer 変数を使う NTP 制御メッセージは、 0 というアソシエーション番号は特別で、 その変数がシステム変数であることを表します。 システム変数の名前は、独立した名前空間から取りだされます。 -.PP +.Pp 制御メッセージコマンドは、 サーバに一つ以上の NTP モード 6 メッセージを送り、 戻ってきたデータを何らかの書式で出力します。 @@ -337,16 +280,15 @@ peer 変数を使う NTP 制御メッセージは、 一つのメッセージを送って、一つの応答を受け取ります。 今のところ例外は、必要なデータを得るためにあらかじめプログラムされた一連の メッセージを送る -.B peers +.Em peers コマンドと、 アソシエーションをある範囲で変えながら繰り返す -.B mreadlist +.Em mreadlist と -.B mreadvar +.Em mreadvar コマンドです。 -.PP -.B associations -.PP +.Bl -tag -width indent +.It associations 問い合わせ対象のサーバの規格内 (in\-spec) の peer についての、 アソシエーション番号と peer の状態の一覧を得て出力します。 一覧は複数の欄から成っています。 @@ -354,8 +296,8 @@ peer 変数を使う NTP 制御メッセージは、 2 番目はサーバから返って来た実際のアソシエーション番号、 3 番目は peer の状態ワードです。 その後に、状態ワードをデコードしたデータを含む欄がいくつか続きます。 -\*(L"associations\*(R" コマンドによって返ったデータは -.I ntpq +\*(L"associations\*(R" コマンドによって返されたデータは +.Nm ntpq の内部でキャッシュされるということを覚えておいて下さい。 このため、索引番号は、 人間にはほとんど打ち込むることができないアソシエーション番号を使う @@ -363,52 +305,49 @@ peer 変数を使う NTP 制御メッセージは、 すなわち、 それ以降の任意のコマンドが引き数としてアソシエーション番号を必要とするときに、 代わりに -.I &index +.Em &index という形を使うことができます。 -.PP -.B lassocations -.PP +.It lassocations +.Pp サーバが状態を保持しているすべてのアソシエーションについて アソシエーション番号と peer の状態の一覧を得て、出力します。 -このコマンドと \*(L"associations\*(R" コマンドは、 +このコマンドと +.Em associations +コマンドは、 規格外 (out\-of\-spec) のクライアントのアソシエーション の状態を保持するサーバ (つまり fuzzball) の場合にだけ異なります。 -\*(L"associations\*(R" コマンドが使われたとき、通常そういう関係は -表示から省略されますが、 \*(L"lassociations\*(R" の出力には含まれます。 -.PP -.B passociations -.PP +.Em associations +コマンドが使われたとき、通常そういう関係は +表示から省略されますが、 +.Em lassociations +の出力には含まれます。 +.It passociations 内部でキャッシュされたアソシエーションの一覧から、 規格内 (in\-spec) の peer に関する アソシエーションのデータを出力します。 このコマンドは、新しい問い合わせをするのではなく 内部に蓄えられたデータを表示するということを除けば、 -\*(L"associations\*(R" と同じに働きます。 -.PP -.B lpassociations -.PP +.Em associations +と同じに働きます。 +.It lpassociations 規格外 (out\-of\-spec) のクライアントとのアソシエーションを含む 全てのアソシエーションに関するデータを、 内部にキャッシュされたアソシエーションの一覧から出力します。 -このコマンドは、fuzzball を扱う場合だけ、 \*(L"passociations\*(R" と -異なります。 -.PP -.B pstatus -.I assocID -.PP +このコマンドは、fuzzball を扱う場合だけ、 +.Em passociations +と異なります。 +.It pstatus Ar assocID 与えられたアソシエーションに対応するサーバに対し、 状態読み取り要求を送ります。 返された peer 変数の名前と値を出力します。 変数の前に、ヘッダから得た状態ワードが 16 進数と下手な英語で 表示されることに注意して下さい。 -.PP -.B readvar -[ -.I assocID -] [ -.IR <variable_name>[=<value>] [,...] -] -.PP +.It Xo readvar +.Op Ar assocID Ns +.Pf [ Aq variable_name Ns +.Op = Ns Aq value Ns +.Op ,...] +.Xc 変数読み取り要求を送ることで、指定した変数の値を返すようにサーバに要求します。 アソシエーション番号 (assocID) を省略するか 0 を指定したならば、 変数はシステム変数です。 @@ -416,30 +355,24 @@ peer 変数を使う NTP 制御メッセージは、 返される値は対応する peer のものとなります。 変数のリストを省略すると、データ無しの要求を送ります。 これは、サーバにデフォルトのディスプレイを返させます。 -.PP -.B rv -[ -.I assocID -] [ -.IR <variable_name>[=<value>] [,...] -] -.PP -.B readvar +.It Xo rv +.Op Ar assocID Ns +.Pf [ Aq variable_name Ns +.Op = Ns Aq value Ns +.Op ,...] +.Xc +.Em readvar コマンドの打ちやすい短縮形です。 -.PP -.B writevar -.I assocID -.IR <variable_name>=<value> [,...] -.PP -.B readvar +.It Xo writevar +.Ar assocID +.Aq variable_name Ns +.Pf = Ns Aq value Ns +.Op ,... +.Xc +.Em readvar リクエストと似ていますが、 指定した変数を読み取る代わりに書き込みます。 -.PP -.B readlist -[ -.I assocID -] -.PP +.It readlist Op Ar assocID 内部の変数リストの中の変数の値を返すようにサーバに要求します。 アソシエーション番号が省略されるか 0 の場合、 変数はシステム変数であるとみなされます。 @@ -447,80 +380,57 @@ peer 変数を使う NTP 制御メッセージは、 内部の変数リストが空の場合は、 要求はデータ無しで送られます。 これは、リモートサーバにデフォルトのディスプレイを返させます。 -.PP -.B rl -[ -.I assocID -] -.PP -.B readlist +.It rl Op Ar assocID +.Em readlist コマンドの打ちやすい短縮形です。 -.PP -.B writelist -[ -.I assocID -] -.PP -.B readlist +.It writelist Op Ar assocID +.Em readlist リクエストと似ていますが、 内部のリストの変数を読み取る代わりに書き込みます。 -.PP -.B mreadvar -.I assocID -.I assocID -[ -.IR <variable_name>[=<value>] [,...] -] -.PP -.B readvar +.It Xo mreadvar +.Ar assocID assocID [ +.Aq variable_name Ns +.Op = Ns Aq value Ns +.Op ,...] +.Xc +.Em readvar コマンドと似ていますが、 問い合わせを (0でない) アソシエーション番号の範囲のそれぞれに 行ないます。 ここで言う範囲は、直前に実行された -.B associations +.Em associations コマンドでキャッシュされたアソシエーションの一覧から決めます。 -.PP -.B mrv -.I assocID -.I assocID -[ -.IR <variable_name>[=<value>] [,...] -] -.PP -.B mreadvar +.It Xo mrv +.Ar assocID assocID [ +.Aq variable_name Ns +.Op = Ns Aq value Ns +.Op ,...] +.Xc +.Em mreadvar コマンドの打ちやすい短縮形です。 -.PP -.B mreadlist -.I assocID -.I assocID -.PP -.B readlist +.It mreadlist Ar assocID assocID +.Em readlist コマンドと似ていますが、 (0 でない) アソシエーション番号の範囲のそれぞれに問い合わせを行います。 ここで言う範囲は、直前に実行された -.B associations +.Em associations コマンドでキャッシュされたアソシエーションの一覧から決めます。 -.PP -.B mrl -.I assocID -.I assocID -.PP -.B mreadlist +.It mrl Ar assocID assocID +.Em mreadlist コマンドの打ちやすい短縮形です。 -.PP -.B clockvar -[ -.I assocID -] -[ -.IR <variable_name>[=<value>] [,...] -] -.PP +.It Xo clockvar +.Op Ar assocID Ns +.Pf [ Aq variable_name Ns +.Op = Ns Aq value Ns +.Op ,...] +.Xc サーバの時計変数 (clock variable) の一覧を送るように要求します。 ラジオ時計や他の外部同期機構を持っているサーバは、 このコマンドに肯定的に応答します。 アソシエーション番号が省略されるか 0 だと、 -要求は \*(L"システム時計\*(R" の変数に対するものとなり、 +要求は +.Qq システム時計 +の変数に対するものとなり、 一般に、時計を持つすべてのサーバから肯定的な応答が得られるでしょう。 サーバが時計を擬似的な peer として扱い、 結果として一度に二つ以上の時計を接続することができるようになっていれば、 @@ -528,20 +438,15 @@ peer 変数を使う NTP 制御メッセージは、 特定の時計の変数が表示されます。 変数のリストを省略すると、サーバはデフォルトの変数のディスプレイを 返すことになります。 -.PP -.B cv -[ -.I assocID -] -[ -.IR <variable_name>[=<value>] [,...] -] -.PP -.B clockvar +.It Xo cv +.Op Ar assocID Ns +.Pf [ Aq variable_name Ns +.Op = Ns Aq value Ns +.Op ,...] +.Xc +.Em clockvar コマンドの打ちやすい短縮形です。 -.PP -.B peers -.PP +.It peers サーバの規格内の peer の一覧を、各 peer の状態の概要と共に得ます。 概要の情報には、リモート peer のアドレス、 参照 ID (参照 IDが不明のときは 0.0.0.0)、 @@ -554,52 +459,56 @@ peer の種類 そして、その peer に関する (全て秒単位で) 現在の遅延の推定値、ずれ (offset)、ばらつき (dispersion) を含んでいます。 -.PP +.Pp 左端の文字は、時計選択処理におけるこの peer の運命を示します。 コードの意味は以下です: <sp> 階層が高いか、または妥当性のチェックにより捨てられたもの; -\*(L"x\*(R" 交差アルゴリスムにより指示された誤りのチェッカ (falsticker); -\*(L".\*(R" 候補リストの最後から間引かれたもの; -\*(L"-\*(R" クラスタリングアルゴリスムにより捨てられたもの; -\*(L"+\*(R" 最終の選択セットに含まれたもの; -\*(L"#\*(R" 同期用に選択されたが隔たりが最大値を越えるもの; -\*(L"*\*(R" 同期用に選択されたもの; -\*(L"o\*(R" 同期用に選択され pps シグナル使用中のもの。 -.PP -.B peers +.Qq x +交差アルゴリスムにより指示された誤りのチェッカ (falsticker); +.Qq . +候補リストの最後から間引かれたもの; +.Qq - +クラスタリングアルゴリスムにより捨てられたもの; +.Qq + +最終の選択セットに含まれたもの; +.Qq # +同期用に選択されたが隔たりが最大値を越えるもの; +.Qq * +同期用に選択されたもの; +.Qq o +同期用に選択され pps シグナル使用中のもの。 +.Em peers コマンドは、得られた応答の中の値を解析できるかどうかに依るため、 データ形式の制御が貧弱なサーバでは、時々動作に失敗するかも しれません。 -.PP +.Pp ホストフィールドの内容は、次の四つの型のうちの一つになります。 ホスト名、 IP アドレス、 参照時計 (reference clock) の実装名とパラメタ、 -\*(L"REFCLK(<実装番号>, <パラメータ>)\*(R" のいずれかです。 -\*(L"hostnames no\*(R" が設定されているときには、 -IP アドレスだけが表示されます。 -.PP -.B lpeers -.PP -.B peers +.Qq REFCLK(<実装番号>, <パラメータ>) +のいずれかです。 +.Qq hostnames no +が設定されているときには、IP アドレスだけが表示されます。 +.It lpeers +.Em peers と似ていますが、 サーバが状態を保持しているすべてのアソシエーションの概要を出力します。 これは fuzzball サーバの、より長い peer のリストを生成することがあります。 -.PP -.B opeers -.PP -古い型の \*(L"peers\*(R" コマンドで、 +.It opeers +古い型の +.Em peers +コマンドで、 参照 ID がローカルのインタフェースアドレスになります。 -.SH 歴史 -.PP +.El +.Sh 歴史 Toronto 大学の Dennis Ferguson によって書かれました。 -.SH バグ -.PP -.B peers +.Sh バグ +.Em peers コマンドは不可分 (atomic) ではないため、 不正なアソシエーションという誤ったエラーメッセージが発生し コマンドが終了することがあります。 -.PP +.Pp 時間切れまでの時間は固定された定数です。 これは、ある種の最悪の場合を考えてあるため、 時間切れになるまで長時間待たされることになります。 diff --git a/ja/man/man8/ntptrace.8 b/ja/man/man8/ntptrace.8 index 3c373f727e..ad642bc9c5 100644 --- a/ja/man/man8/ntptrace.8 +++ b/ja/man/man8/ntptrace.8 @@ -1,108 +1,71 @@ -''' $Header -''' +.\" +.\" %Id: ntptrace.8,v 1.2 1998/02/19 08:05:40 charnier Exp % .\" jpman %Id: ntptrace.8,v 1.3 1997/09/12 02:34:26 seki Stab % -.de Sh -.br -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp -.if t .sp .5v -.if n .sp -.. -.de Ip -.br -.ie \\n.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -''' -''' Set up \*(-- to give an unbreakable dash; -''' string Tr holds user defined translation string. -''' Greek uppercase omega is used as a dummy character. -''' -.tr \(*W-|\(bv\*(Tr -.ie n \{\ -.ds -- \(*W- -.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -.ds L" "" -.ds R" "" -.ds L' ' -.ds R' ' -'br\} -.el\{\ -.ds -- \(em\| -.tr \*(Tr -.ds L" `` -.ds R" '' -.ds L' ` -.ds R' ' -'br\} -.TH NTPTRACE 8 LOCAL -.SH 名称 -ntptrace - NTP ホスト連鎖をたどりマスタ時刻ソースまで追跡する -.SH 書式 -.B ntptrace -[ -.B -vdn -] [ -.B -r -.I retries -] [ -.B -t -.I timeout -] [ -.I server -] -.SH 解説 -.I ntptrace +.\" +.Dd December 21, 1993 +.Dt NTPTRACE 8 +.Os +.Sh 名称 +.Nm ntptrace +.Nd "NTP ホスト連鎖をたどりマスタ時刻ソースまで追跡する" +.Sh 書式 +.Nm ntptrace +.Op Fl vdn +.Op Fl r Ar retries +.Op Fl t Ar timeout +.Op Ar server +.Sh 解説 +.Nm ntptrace は、与えられた ネットワークタイムプロトコル (NTP) サーバが どこから時刻を取得するのかを決定し、 NTP サーバの連鎖をたどってマスタ時刻ソースまで戻ります。 -引数が与えられなかったときは、 ``localhost'' から始めます。 -.PP +引数が与えられなかったときは、 +.Dq localhost +から始めます。 +.Pp 以下は、 -.I ntptrace +.Nm の出力の例です。 -.RS 2 -.nf - +.Bd -literal % ntptrace localhost: stratum 4, offset 0.0019529, synch distance 0.144135 server2.bozo.com: stratum 2, offset 0.0124263, synch distance 0.115784 -usndh.edu: stratum 1, offset 0.0019298, synch distance 0.011993, refid 'WWVB' - -.fi -.RE -各行のフィールドは (左から右へ): +h.edu: stratum 1, offset 0.0019298, synch distance 0.011993, refid 'WWVB' +.Ed +.Pp +各行のフィールドは (左から右へ) 次のようになります: ホスト名、ホストの階層 (stratum)、 そのホストとローカルホストの間の時刻のずれ (offset) ( -.I ntptrace -によって測定されたもの; これが ``localhost'' に対して -いつも 0 になるとは限らない理由です) 、 -ホストの ``同期距離'' (synch distance)、 -そして、(階層が 1 のサーバのみですが) 参照時計 ID。 +.Nm +によって測定されたもの; +これが +.Dq localhost +に対していつも 0 になるとは限らない理由です )、 +ホストの +.Dq 同期距離 +(synchronization distance)、 +そして (階層が 1 のサーバのみですが)、参照時計 ID 。 すべての時間は秒単位です。 -(同期距離というのは、時計の時刻の良さの測度です。) -.SH オプション -.IP "\-d" 5 +(同期距離とは、時計の時刻の精度を測ったものです。) +.Sh オプション +以下のオプションが使えます。 +.Bl -tag -width indent +.It Fl d デバッグ出力をオンにします。 -.IP "\-n" 5 -ホスト名の印刷をオフにします; 代わりに、ホストの IP アドレスが -使われます。これは、ネームサーバが落ちているときに必要になるかも -しれません。 -.IP "\-r retries" 5 -各ホストに対する再送信の回数をセットします。デフォルト = 5。 -.IP "\-t timeout" 5 -再送信の制限時間 (秒単位) をセットします。デフォルト = 2。 -.IP "\-v" 5 -NTP サーバについての詳細な情報を出力します。 -.SH 関連項目 -xntpd(8), xntpdc(8) -.SH バグ -このプログラムは、複数の標本を取って正確さを増すような試みをしません。 +.It Fl n +ホスト名の表示をオフにします; 代わりに、ホストの IP アドレスが +表示されます。これは、ネームサーバが落ちているときに必要になるでしょう。 +.It Fl r Ar retries +ホスト毎の再送信の回数をセットします。デフォルトは 5 です。 +.It Fl t Ar timeout +再送信のタイムアウト (秒単位) をセットします。デフォルト は 2 です。 +.It Fl v +NTP サーバに関する詳細な情報を出力します。 +.El +.Sh 関連項目 +.Xr xntpd 8 , +.Xr xntpdc 8 +.Sh バグ +このプログラムは、複数の標本を取って精度を高めるような試みをしません。 diff --git a/ja/man/man8/pccardd.8 b/ja/man/man8/pccardd.8 index e3fc8ee954..e4f6ebd273 100644 --- a/ja/man/man8/pccardd.8 +++ b/ja/man/man8/pccardd.8 @@ -23,7 +23,7 @@ .\" (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: pccardd.8,v 1.4.2.4 1998/04/18 23:28:50 nate Exp % +.\" %Id: pccardd.8,v 1.10 1998/03/23 08:25:40 charnier Exp % .\" jpman %Id: pccardd.8,v 1.4 1997/07/26 22:04:06 horikawa Stab % .\" .Dd November 1, 1994 diff --git a/ja/man/man8/pciconf.8 b/ja/man/man8/pciconf.8 index a19c2a0779..449a6e9e3a 100644 --- a/ja/man/man8/pciconf.8 +++ b/ja/man/man8/pciconf.8 @@ -1,4 +1,4 @@ -.\" %Id: pciconf.8,v 1.3.2.2 1998/03/07 11:35:48 se Exp % +.\" %Id: pciconf.8,v 1.3 1997/10/06 11:38:29 charnier Exp % .\" Copyright (c) 1997 .\" Stefan Esser <se@freebsd.org>. All rights reserved. .\" diff --git a/ja/man/man8/ping.8 b/ja/man/man8/ping.8 index 68f446751a..41d9f1f939 100644 --- a/ja/man/man8/ping.8 +++ b/ja/man/man8/ping.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)ping.8 8.2 (Berkeley) 12/11/93 -.\" %Id: ping.8,v 1.3.2.7 1998/07/17 20:13:44 jkh Exp % +.\" %Id: ping.8,v 1.16 1998/08/26 01:58:39 dillon Exp % .\" jpman %Id: ping.8,v 1.3 1997/10/11 08:00:36 horikawa Stab % .\" .Dd March 1, 1997 @@ -90,6 +90,9 @@ 回送出 .Pq そして受信 してから終了します。 +非 root ユーザは 100 パケットを越えて送出できませんし、 +デフォルト値が 16 となっています。 +root のデフォルトは無限です。 .It Fl d 使用する socket に .Dv SO_DEBUG @@ -105,6 +108,7 @@ ping を垂れ流します。 が表示され、 .Tn ECHO_REPLY パケットを受信するたびにバックスペースが表示されます。 +root のみこのオプションを指定できます。 これによりどれだけのパケットが欠落したのかをすばやく表示することができます。 スーパユーザのみ使用可能です .Bf -emphasis @@ -114,7 +118,9 @@ ping を垂れ流します。 .It Fl i Ar wait .Ar wait で指定した秒数だけパケットの送出間隔を空けます。 -デフォルトでは送出間隔は 1 秒です。このオプションは +デフォルトでは送出間隔は 1 秒です。 +より小さい値を指定できますが、1 より小さい値を指定できるのは root だけです。 +このオプションは .Fl f オプションとは同時に指定できません。 .It Fl I Ar interface @@ -198,6 +204,7 @@ ping は経路リストを表示し、正しい位置にまで縮めます。 ヘッダデータの 8 バイトと合せて 64 .Tn ICMP バイトになります。 +root のみこのオプションを指定できます。 .It Fl T Ar ttl マルチキャストパケットの IP 寿命時間 (Time To Live) を設定します。 このオプションは、宛先アドレスがマルチキャストアドレスの場合だけ diff --git a/ja/man/man8/pppctl.8 b/ja/man/man8/pppctl.8 index a587f43d24..95f90c73f1 100644 --- a/ja/man/man8/pppctl.8 +++ b/ja/man/man8/pppctl.8 @@ -1,4 +1,4 @@ -.\" %Id: pppctl.8,v 1.1.2.5 1998/07/18 11:11:56 jkh Exp % +.\" %Id: pppctl.8,v 1.10 1998/05/13 07:57:44 phk Exp % .Dd 26 June 1997 .Os FreeBSD .Dt PPPCTL 8 diff --git a/ja/man/man8/pppd.8 b/ja/man/man8/pppd.8 index 6042934a08..353e8d1e42 100644 --- a/ja/man/man8/pppd.8 +++ b/ja/man/man8/pppd.8 @@ -1,5 +1,5 @@ .\" manual page [] for pppd 2.3 -.\" %Id: pppd.8,v 1.7.2.3 1998/06/23 21:41:46 peter Exp % +.\" %Id: pppd.8,v 1.18 1998/06/20 18:02:14 peter Exp % .\" jpman %Id: pppd.8,v 1.2 1997/05/27 00:43:48 mutoh Stab % .\" SH section heading .\" SS subsection heading diff --git a/ja/man/man8/pppstats.8 b/ja/man/man8/pppstats.8 index 18e4774cc0..ba4c69fb28 100644 --- a/ja/man/man8/pppstats.8 +++ b/ja/man/man8/pppstats.8 @@ -1,4 +1,4 @@ -.\" @(#) %Id: pppstats.8,v 1.3.2.4 1998/07/18 11:12:09 jkh Exp % +.\" @(#) %Id: pppstats.8,v 1.8 1998/07/09 04:53:11 jkoshy Exp % .\" jpman %Id: pppstats.8,v 1.2 1997/05/23 09:03:43 mitchy Stab % .\" .TH PPPSTATS 8 "26 June 1995" diff --git a/ja/man/man8/praliases.8 b/ja/man/man8/praliases.8 index 376193473f..5a7d55466e 100644 --- a/ja/man/man8/praliases.8 +++ b/ja/man/man8/praliases.8 @@ -1,4 +1,12 @@ -.\" @(#)praliases.8 8.1 (Berkeley) 9/21/96 +.\" Copyright (c) 1998 Sendmail, Inc. All rights reserved. +.\" +.\" By using this file, you agree to the terms and conditions set +.\" forth in the LICENSE file which can be found at the top level of +.\" the sendmail distribution. +.\" +.\" +.\" @(#)praliases.8 8.5 (Berkeley) 5/19/98 +.\" .\" jpman %Id: praliases.8,v 1.3 1997/08/30 16:46:16 take-i Stab % .Dd April 25, 1996 .Dt PRALIASES 1 diff --git a/ja/man/man8/pstat.8 b/ja/man/man8/pstat.8 index 12d76d7eec..5c75750683 100644 --- a/ja/man/man8/pstat.8 +++ b/ja/man/man8/pstat.8 @@ -1,7 +1,6 @@ .\" Copyright (c) 1980, 1991, 1993, 1994 .\" The Regents of the University of California. All rights reserved. .\" -.\" @(#)pstat.8 8.4 (Berkeley) 4/19/94 .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: @@ -30,8 +29,8 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" From: @(#)pstat.8 8.4 (Berkeley) 4/19/94 -.\" %Id: pstat.8,v 1.10.2.1 1997/10/10 06:18:42 charnier Exp % +.\" @(#)pstat.8 8.5 (Berkeley) 5/13/94 +.\" %Id: pstat.8,v 1.16 1998/01/17 16:58:55 bde Exp % .\" jpman %Id: pstat.8,v 1.2 1997/03/31 14:56:46 horikawa Stab % .\" .Dd October 7, 1995 @@ -273,20 +272,26 @@ vnodeのフラグを表す文字のリスト: \- VROOT .It T \- VTEXT +.It S +\- VSYSTEM +.It t +\- VISTTY .It L \- VXLOCK .It W \- VXWANT -.It E -\- VEXLOCK -.It S -\- VSHLOCK -.It T -\- VLWAIT -.It A -\- VALIASED .It B \- VBWAIT +.It A +\- VALIASED +.It V +\- VOBJBUF +.It a +\- VAGE +.It l +\- VOLOCK +.It w +\- VOWANT .El .Pp .It USE diff --git a/ja/man/man8/pw.8 b/ja/man/man8/pw.8 index 322a99d280..f8c181a094 100644 --- a/ja/man/man8/pw.8 +++ b/ja/man/man8/pw.8 @@ -22,9 +22,11 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: pw.8,v 1.1.1.1.2.5 1997/11/04 07:16:14 charnier Exp % +.\" %Id: pw.8,v 1.13 1998/03/23 08:28:12 charnier Exp % .\" jpman %Id: pw.8,v 1.3 1997/10/28 15:30:48 kuriyama Stab % .\" +.\" WORD: primary group プライマリグループ(/etc/passwd のグループIDで決まるグループ) +.\" .Dd December 9, 1996 .Dt PW 8 .Os @@ -53,10 +55,12 @@ .Op Fl h Ar fd .Op Fl N .Op Fl P +.Op Fl Y .Nm pw .Ar useradd .Op name|uid -.Op Fl D +.\" -D オプションは省略可能の通常のオプションではないのでこれでよい +.Fl D .Op Fl C Ar config .Op Fl q .Op Fl b Ar dir @@ -69,12 +73,14 @@ .Op Fl i Ar min,max .Op Fl w Ar method .Op Fl s Ar shell +.Op Fl y Ar path .Nm pw .Ar userdel .Op name|uid .Op Fl n Ar name .Op Fl u Ar uid .Op Fl r +.Op Fl Y .Nm pw .Ar usermod .Op name|uid @@ -97,6 +103,7 @@ .Op Fl h Ar fd .Op Fl N .Op Fl P +.Op Fl Y .Nm pw .Ar usershow .Op name|uid @@ -121,10 +128,12 @@ .Op Fl h Ar fd .Op Fl N .Op Fl P +.Op Fl Y .Nm pw .Ar groupdel .Op Fl n Ar name .Op Fl g Ar gid +.Op Fl Y .Nm pw .Ar groupmod .Op Fl C Ar config @@ -138,6 +147,7 @@ .Op Fl h Ar fd .Op Fl N .Op Fl P +.Op Fl Y .Nm pw .Ar groupshow .Op Fl n Ar name @@ -162,16 +172,16 @@ けだということに注意して下さい。 NIS のユーザ、グループは NIS サーバ上 で管理しなければなりません。 .Nm -は root で実行されなければならず、 +は .Pa passwd , .Pa master.passwd , .Pa group ファイルや、安全なまたは安全でないパスワードデータベースファイル -の更新作業を行います。 +の更新作業を行いますので、 root で実行されなければなりません。 .Pp -.Xr pw 8 +.Nm のコマンドラインにかかれている最初の一つか二つのキーワードは、引数の残り -に対する文脈を規定します。 +を解釈する際の文脈を指定します。 .Ar user と .Ar group @@ -181,12 +191,15 @@ .Ar mod , .Ar show , .Ar next -と組み合わせるか、分離して用いることができ、どちらの順序 (例えば -showuser, usershow, show user, user show はすべて同じことと -みなされます) で指定してもかまいません。 -この柔軟性は、実際のユーザ、グループデータベース操作のために +と組み合わせて用いることができ、どのような順序 (例えば +.Ar showuser , +.Ar usershow , +.Ar show user , +.Ar user show +はすべて同じこととみなされます) で指定してもかまいません。 +この柔軟性は、ユーザ、グループデータベース操作のために .Nm -を呼ぶ対話的なスクリプトには便利です。 +を呼び出す対話的なスクリプトには便利です。 .Fl n Ar name , .Fl u Ar uid , .Fl g Ar gid @@ -194,7 +207,7 @@ showuser, usershow, show user, user show はすべて同じことと これらのキーワードに続けてユーザ名、グループ名、数字の ID のうち一つ を指定することができます。 .Pp -以下のフラグは操作のすべてのモードで共通です: +以下のフラグは操作のほとんどのモードで共通です。 .Pp .Bl -tag -width "-G grouplist" .It Fl C Ar config @@ -202,28 +215,48 @@ showuser, usershow, show user, user show はすべて同じことと は新しいユーザアカウントとグループはどのように作られるべきかという 方針の情報を得るために、デフォルトではファイル .Pa /etc/pw.conf -を読み込みますが、 +を読み込みます。 .Fl C オプションで異なる設定ファイルを指定できます。 設定ファイルのほとんどの内容は、コマンドライン オプションにより上書きされますが、新しいアカウントを追加するための標準 -的な情報を設定ファイルに設定しておくと -より便利かもしれません。 +的な情報を設定ファイルに設定しておいた方が +便利かもしれません。 .It Fl q このオプションを使うと .Nm -はエラーメッセージを抑制します。これは、注意深くフォーマットされたディスプレイへのメッセージ表示よりも、 +はエラーメッセージを抑制します。 +これは、注意深くフォーマットされたディスプレイへのメッセージ表示よりも、 .Nm から返された戻り値を解釈する方が好まれるような対話的な環境では 便利かもしれません。 .It Fl N -このオプションは add と modify 操作で使います。 +このオプションは +.Ar add +と +.Ar modify +操作で使います。 .Nm -は、ユーザ/グループデータベースの更新をスキップして、操作を実際には -実行せずに、代わりに結果だけを出力します。 +は、ユーザ/グループデータベースを更新せずに、操作の結果だけを出力します。 .Fl P -オプションを使うと、標準 passwd と可読なフォーマットの切り替えが -できます。 +オプションを使うと、標準 passwd フォーマットと可読なフォーマットの +切り替えができます。 +.It Fl Y +更新モードのいずれかと、このオプションとをいっしょに使うことで、 +.Nm +は、 +.Pa /var/yp +にカレントディレクトリを移動させてから +.Xr make 1 +を実行します。これは、NIS データベースファイルの自動更新を可能とする +ためのものです。NIS が別のパスワードファイル、グループファイルを +使っている場合、 +.Fl y Ar path +オプションを使い、NIS パスワードデータベースの位置を指定すると +よいでしょう。これにより、 +.Nm +は、システムパスワードデータベースと並行してこれらのデータベースも +同時に更新します。 .El .Pp .Sh ユーザオプション @@ -241,18 +274,8 @@ showuser, usershow, show user, user show はすべて同じことと .Pp アカウント名は uid を含み、逆も同様であるため、通常これらのオプション のどちらか片方しか必要ではありません。 -また -.Ql Fl n -や -.Ql Fl u -を使わなくても、コマンドライン上で -.Ar useradd , -.Ar userdel , -.Ar usermod , -.Ar usershow -キーワードの直後にアカウントとユーザIDのどちらでも続けることができます。 しかし、両方を指定しなければならないこともしばしばあります。 -例えば、存在するユーザの uid を +例えば、すでに存在するユーザの uid を .Ar usermod で変えたり、新しいアカウントを作るときにデフォルトの uid を上書きした りするときです。 @@ -264,36 +287,44 @@ showuser, usershow, show user, user show はすべて同じことと オプションを使っては .Em いけません 。 +コマンドライン上で +.Ar useradd , +.Ar userdel , +.Ar usermod , +.Ar usershow +キーワードの直後なら、アカウントとユーザIDのどちらかを +.Ql Fl n +や +.Ql Fl u +を使わずにそのまま続けて書くことができます。 .El .Pp -.Ar useradd -と -.Ar usermod -の両方で使えるオプション: .Bl -tag -width "-G grouplist" .It Fl c Ar comment このオプションは passwd の GECOS フィールドの内容をセットします。 -このフィールドは、コンマで区切られた四つのサブフィールドで、一般的には +このフィールドは、コンマで区切られた 4 つのサブフィールドで、一般的には ユーザの姓名、勤務先または地区、職場と自宅の電話番号を含みます。 これらのサブフィールドは慣習的に使われるだけであり、省略可能です。 このフィールドが空白を含む場合、コメント自身をダブルクォート .Ql \&" でくくらなければなりません。 -サブフィールドの区切りで使われたような、フィールド内のコンマの使用は +コンマはサブフィールドの区切りとして使われるので、フィールド内での使用は 避けて下さい。そして、コロン .Ql \&: キャラクタも passwd ファイルのフィールド区切りであるため使えません。 .It Fl d Ar dir このオプションは、アカウントのホームディレクトリを設定します。 -通常、これはホームディレクトリがデフォルト (基本のホームディレクトリ -- 普通 +通常、これはホームディレクトリが +.Pa /etc/pw.conf +から決まるデフォルト +(ふつうは .Pa /home -と サブディレクトリとしてのアカウント名 - を指定する -pw.conf で決定されます) と異なる場合にだけ使うことになるでしょう。 +の下でアカウント名をサブディレクトリとしたもの) +と異なる場合にだけ使うことになるでしょう。 .It Fl e Ar date アカウントが破棄される日付をセットします。 この日付のフォーマットは、 10 進の UNIX 時間か -.Ql \& dd-mmm-yy[yy] +.Ql dd-mmm-yy[yy] フォーマットの日付のどちらかになり、後者は dd が日、mmmが月で、数字と アルファベット('Jan', 'Feb' 等)のどちらでもよく、年は 2 または 4 桁の 数字からなります。 @@ -306,32 +337,30 @@ pw.conf で決定されます) と異なる場合にだけ使うことになるでしょう。 曜日(w)、月(o)、年(y)の数がセットされます。 .It Fl p Ar date アカウントのパスワードが破棄される日付をセットします。 -このフィールドは、強制的なパスワードの変更を適用することを除けば、 -アカウントを破棄するオプションと同等です。 -アカウントを破棄するオプションと同じフォーマットを受け付けます。 +このフィールドは、パスワードの強制的な変更に対して適用されることを除けば、 +アカウント破棄日付指定オプションと似ています。 +これは、 +.Ql Fl e +オプションと同様にしてセットされます。 .It Fl g Ar group -与えられた group をアカウントの初期グループにセットします。 +与えられた group をアカウントのプライマリグループにセットします。 .Ar group -は、グループ名または対応するグループ ID 番号が使えます。 +は、グループ名またはグループ ID 番号で定義されます。 .It Fl G Ar grouplist -アカウントが属する別のグループをセットします。 +そのアカウントの追加グループをセットします。 .Ar grouplist -は、コンマ区切りのリスト、またはグループ名、またはグループ IDです。 -ユーザを加える場合、 +は、コンマで区切られた、グループ名またはグループ ID 番号のリストです。 .Pa /etc/group -の各グループにユーザ名が追加されます。 -ユーザを編集する場合、 -.Ar grouplist -に指定されたグループにユーザ名が加えられ、 -指定されなかったグループからは除かれます。 +の、グループリストで指定されたグループにそのユーザ名が追加され、 +グループリストで指定されないグループからそのユーザ名が削除されます。 注意: ユーザは .Pa /etc/group -の初期グループには加えられるべきではありません。 +のプライマリグループには加えられるべきではありません。 また、グループのメンバの変更は現在のログインにはすぐには影響されず、変 更後のログインにだけ影響します。 .It Fl L Ar class このオプションは生成されたユーザのログインクラスをセットします。 -ユーザクラスに関する情報は +ユーザログインクラスに関する情報は .Xr login.conf 5 を参照して下さい。 .It Fl m @@ -341,21 +370,22 @@ pw.conf で決定されます) と異なる場合にだけ使うことになるでしょう。 もちろんこれは .Ar useradd で新しいアカウントを加えるときにも役に立ちますが、 -存在するユーザのホームディレクトリをファイルシステムの別の場所に -移動する、という使い方もできます。 -新しいホームディレクトリは、一般にユーザが個人的に使う -シェルの設定ファイル一式を含む、 -.Ar 雛型 -ディレクトリの内容と共に移されます。 +すでに存在するユーザのホームディレクトリを、ファイルシステムの別の場所に +移動するという使い方もできます。 +新しいホームディレクトリには、 +.Ar 雛型(skeleton) +ディレクトリの内容が置かれます。 +ここには、普通、ユーザが個人的に使うシェルの設定ファイル一式 +が含まれています。 .Ar usermod にアカウントを指定して .Ql Fl m -が用いられると、そのユーザのホームディレクトリにある -設定ファイルはプロトタイプのファイルで +を用いる際には、そのユーザのホームディレクトリにある +設定ファイルは、雛型ディレクトリのファイルで .Em 上書きされません 。 .Pp -ユーザのホームディレクトリが作成されるとき、デフォルトで +ユーザのホームディレクトリが作成されるとき、デフォルトでは、 .Ql Fl b Ar dir オプション (下記参照) で指定された .Ar basehome @@ -363,18 +393,18 @@ pw.conf で決定されます) と異なる場合にだけ使うことになるでしょう。 けられます。 コマンドラインに .Ql Fl d Ar dir -オプションを付けると、上書きするようにもできます。 +オプションを付けると、上書きするようにすることもできます。 .It Fl k Ar dir このオプションは、 .Ar 雛型 -のサブディレクトリをセットします。ユーザのホームディレクトリが作成 +ディレクトリをセットします。ユーザのホームディレクトリが作成 されるとき、そこから基本の起動時ファイル、設定ファイル がコピーされます。 このオプションは、 -.Ql Fl D +.Ql Fl d (下記参照) や .Ql Fl m -と共に使ったときにのみ意味があります。 +とともに使ったときにのみ意味があります。 .It Fl s Ar shell ユーザのログインシェルを .Ar shell @@ -408,7 +438,7 @@ pw.conf で決定されます) と異なる場合にだけ使うことになるでしょう。 .It Fl h Ar fd このオプションは、 .Nm -を使ってアカウントパスワードを設定することができる対話的なスクリプトを +が対話的なスクリプトを使ってアカウントパスワードを 設定できるような特別のインタフェースを用意します。 コマンドラインと環境は、プログラムが情報を受け取るしくみとしては 基本的に安全ではないため、 @@ -423,15 +453,15 @@ pw.conf で決定されます) と異なる場合にだけ使うことになるでしょう。 .Ql Fl h Ar 0 が指定されると、代わりに .Nm -はユーザのパスワードを求めるプロンプトを出し、 +はユーザのパスワード入力を求めるプロンプトを出し、 .Em stdin をパスワードを読み込むファイル記述子とします。 -このパスワードは一度しか読み込まれず、対話的な使用よりも +パスワードは一度しか入力されません。対話的な使用よりも スクリプト向きにできていることに注意して下さい。 .Xr passwd 1 -の行に合わせて新しいパスワードの確認をしたい場合、これは +の行に合わせて新しいパスワードの確認をしたい場合、この機能は、 .Nm -を呼び出す対話的なスクリプトの一部として実装されるべきです。 +を呼び出す対話的なスクリプトの一部として実装する必要があります。 .Pp 引数 .Ar fd @@ -439,20 +469,21 @@ pw.conf で決定されます) と異なる場合にだけ使うことになるでしょう。 .Ql \&- が与えられると、パスワードとして .Ql \&* -がセットされ、そのアカウントにはパスワードでログインすることが +がセットされ、そのアカウントにはパスワードを使ってログインすることが できないようになります。 .El .Pp .Ar useradd を使うことで、存在するユーザ ID と重複する新しいアカウントを作成するこ とができるようになります。 -これは普通エラーになって拒否されるはずですが、 +これは普通エラーになって拒否されますが、 .Ql Fl o -オプションが重複チェックを上書きし、ユーザ ID の重複を +オプションにより、重複チェックを上書きしユーザ ID の重複を 許すことになります。 これは、同一のユーザが異なるコンテキスト(異なるグループ割り当てや 異なるホームディレクトリ、異なるシェル)でログインするのを許可する -場合に、各アカウントに基本的に同一のアクセス権を与える場合に便利です。 +場合に、各アカウントに基本的に同一のアクセス権を与える場合に +使用できます。 .Pp .Ar useradd コマンドは @@ -492,30 +523,30 @@ pw.conf で決定されます) と異なる場合にだけ使うことになるでしょう。 .Ql Fl D を付けずに使われる場合と異なり、引数はアカウントが作成されてから無効に なるまでの日数を指定する数字でなければなりません。 - 0 という値は、破棄する日付の自動算出を抑制します。 +0 という値は、破棄する日付の自動算出を抑制します。 .It Fl p Ar days デフォルトのパスワードの有効期間を日数でセットします。 .It Fl g Ar group 新しいユーザのデフォルトのグループをセットします。 .Ql Fl g Ar \&"" -を使って空のグループを指定すると、新しいユーザは自分自身の私的な初期 +を使って空のグループを指定すると、新しいユーザは自分自身の私的なプライマリ グループ (ログイン名と同じ名前の新しいグループが作成されます) に 割り当てられます。 グループの指定には、名前または uid を引数として与えることができます。 .It Fl G Ar grouplist 新しいユーザが所属するデフォルトのグループ群を指定します。 -これは初期グループとは区別されたグループのセットで、一つの同じグルー -プを初期グループとこの別グループ群の両方に指定することは +これはプライマリグループとは別のグループの集合で、一つの +グループをプライマリグループとこの別グループ群の両方に指定することは 避けなければなりません。 -言い替えると、これらの別グループ群では初期グループ +言い替えると、これらの別グループ群ではプライマリグループ .Em 以外の グループの構成メンバが決められます。 .Ar grouplist -はコンマ区切りのグループ名もしくは ID 、もしくはそれらの混在で、 +はコンマ区切りのグループ名もしくは ID で、 .Pa /etc/pw.conf -の中にシンボリック名で保存されます。 +の中にシンボル名で保存されます。 .It Fl L Ar class -このオプションは、新しいユーザのデフォルトのログインクラスを +このオプションは、新しいユーザのためのデフォルトのログインクラスを セットします。 .It Fl k Ar dir デフォルトの @@ -556,7 +587,6 @@ pw.conf で決定されます) と異なる場合にだけ使うことになるでしょう。 ランダムパスワードを生成します。 .El .Pp -The .Ql \&random や .Ql \&no @@ -571,15 +601,20 @@ method にした場合、パスワードでアクセスできるアカウントを与えるために スーパユーザが .Xr passwd 1 を使わなければなりません。 +.It Fl y Ar path +.Pa /etc/master.passwd +からの情報を直接 NIS と共有しない場合、 +このオプションは、NIS が使うデータベースのパス名を設定します。 +NIS サーバに対してのみこのオプションを指定するべきでしょう。 .El .Pp .Ar userdel -コマンドには三つしか正しいオプションがありません。 +コマンドには指定可能なオプションは 3 つしかありません。 .Ql Fl n Ar name と .Ql Fl u Ar uid -オプションには、既に前述の説明があります。 -追加オプション: +オプションは、既に説明したとおりです。 +追加のオプションは以下のものです。 .Bl -tag -width "-G grouplist" .It Fl r このオプションで、 @@ -599,11 +634,11 @@ method にした場合、パスワードでアクセスできるアカウントを与えるために 更に別の一掃が必要なときは、管理者に任されます。 .El .Pp -メールスプールファイルと crontab はユーザ名に無条件に付属しているもの +メールスプールファイルと crontab は、ユーザ名に無条件に付属しているもの なので、アカウントが削除されたとき常に削除されます。 .Ar at コマンドによって処理待ちのキューに入っているジョブも、ユーザの uid -がユニークである (そのシステムの別のアカウントに使われていない) 場合は +がユニークであり、かつ、そのシステムの別のアカウントに使われていない場合は 削除されます。 .Pp .Ar usershow @@ -629,7 +664,7 @@ method にした場合、パスワードでアクセスできるアカウントを与えるために .Pp .Sh グループオプション グループを操作するコマンドには、 -.Ql Fl C Ar config +.Ql Fl と .Ql Fl q オプション (前セクションの始めに説明があります) が使えます。 @@ -651,13 +686,13 @@ method にした場合、パスワードでアクセスできるアカウントを与えるために .Ar memberlist は正当で、存在するユーザ名または uid のコンマ区切りのリストです。 .It Fl m Ar newmembers -.Op M +.Ql Fl M オプションと同様、このオプションは最初に存在するメンバのリストを 入れ換えることなく、グループに存在するユーザを .Em 追加 します。 ログイン名またはユーザ ID を使うことができ、重複するユーザは警告無く -自動的に削除されます。 +削除されます。 .El .Pp .Ar groupadd @@ -765,6 +800,27 @@ root アカウントの名前や uid の変更、削除をしようとした。 が使えます。例えば、 .Dl pw useradd help は useradd 操作に使用できるすべてのオプションをリストします。 +.Pp +.Nm Pw +は、passwd ファイルの GECOS フィールド(ユーザの姓名、オフィス、業務用 +電話番号、自宅電話番号のサブフィールドがあります)に 8 ビット文字を +使うことができます。しかし、8 ビット文字をユーザログイン名やグループ +名に使うことはできません。8 ビット文字の使用に際して、以下の点に注意して +ください。 +インターネットとの接続に際しては、メール配送プログラムが 8BITMIME を +サポートしていることが要求されており、8 ビット文字を含むヘッダは +7 ビットの quoted-printable フォーマットに変換されてしまいます。 +.Xr sendmail 8 +はこの機能をサポートしています。 GECOS フィールドに 8 ビット文字を +置く際は、ユーザのデフォルトロケールとデフォルト文字集合といっしょに +使用するべきで、これらを使用せずに実装してはいけません。 +8 ビット文字の使用は、 +.Xr fingerd 8 +のように、インターネット経由で GECOS フィールドの内容を +やりとりする他のプログラムにも影響を及ぼす可能性があります。 +TCP/IP クライアントの中には、IRC のように、少数ながらもパスワード +ファイルに指定されたフルネームをデフォルトで使用するものも +あります。 .Sh 関連ファイル .Bl -tag -width /etc/master.passwd.new -compact .It Pa /etc/master.passwd diff --git a/ja/man/man8/pwd_mkdb.8 b/ja/man/man8/pwd_mkdb.8 index bdb84a1f9f..3438563017 100644 --- a/ja/man/man8/pwd_mkdb.8 +++ b/ja/man/man8/pwd_mkdb.8 @@ -40,9 +40,10 @@ .Nd パスワードデータベースを構築する .Sh 書式 .Nm pwd_mkdb -.Op Fl c +.Op Fl C .Op Fl p .Op Fl d Ar directory +.Op Fl s Ar cachesize .Op Fl u Ar username .Ar file .Sh 解説 @@ -66,7 +67,7 @@ .Pp オプションは以下の通りです。 .Bl -tag -width flag -.It Fl c +.It Fl C パスワードファイルが正しいフォーマットかどうかをチェックします。 どのファイルも変更、追加、削除を行ないません。 .It Fl p @@ -80,6 +81,15 @@ 指定したユーザのレコードだけ更新します。 単一ユーザに対してのみ作用するユーティリティは、このオプションを使用し、 データベース全体を再構築するオーバヘッドを避けることが出来ます。 +.It Fl s Ar cachesize +ハッシングライブラリが使用するメモリキャッシュの大きさを、 +メガバイト単位で指定します。 +ユーザ数が多いシステムでキャッシュを小さくすると、 +データベースファイルの再構築に耐えがたいほどの長時間を要します、 +おおざっぱな目安では、 +.Nm pwd_mkdb +の使用メモリ量はここで指定した大きさの 2 倍をちょっと越えたものになります。 +デフォルト値は 2 メガバイトです。 .El .Pp 2 つのデータベースの違いは、安全なバージョンでは、ユーザのパスワードが diff --git a/ja/man/man8/quot.8 b/ja/man/man8/quot.8 index 04c3c5836e..3f39bb17f3 100644 --- a/ja/man/man8/quot.8 +++ b/ja/man/man8/quot.8 @@ -27,7 +27,7 @@ .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF .\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" %Id: quot.8,v 1.3.4.4 1998/07/18 11:12:14 jkh Exp % +.\" %Id: quot.8,v 1.9 1998/05/13 07:57:49 phk Exp % .\" jpman %Id: quot.8,v 1.3 1997/07/22 16:55:54 horikawa Stab % .\" .Dd February 8, 1994 diff --git a/ja/man/man8/quotacheck.8 b/ja/man/man8/quotacheck.8 index 482191e2ce..72dfb30d14 100644 --- a/ja/man/man8/quotacheck.8 +++ b/ja/man/man8/quotacheck.8 @@ -33,7 +33,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)quotacheck.8 8.1 (Berkeley) 6/5/93 -.\" %Id: quotacheck.8,v 1.2.2.1 1998/07/17 20:13:47 jkh Exp % +.\" %Id: quotacheck.8,v 1.3 1998/07/15 06:48:50 charnier Exp % .\" jpman %Id: quotacheck.8,v 1.2 1997/05/19 05:05:46 mitchy Stab % .\" .Dd June 5, 1993 diff --git a/ja/man/man8/rarpd.8 b/ja/man/man8/rarpd.8 index a18c85a7dc..c749819a20 100644 --- a/ja/man/man8/rarpd.8 +++ b/ja/man/man8/rarpd.8 @@ -1,4 +1,4 @@ -.\" @(#) %Id: rarpd.8,v 1.3.2.3 1997/10/14 06:39:27 charnier Exp % (LBL) +.\" @(#) %Id: rarpd.8,v 1.7 1997/10/13 11:03:34 charnier Exp % (LBL) .\" .\" Copyright (c) 1990, 1991, 1993 The Regents of the University of .\" California. All rights reserved. diff --git a/ja/man/man8/rbootd.8 b/ja/man/man8/rbootd.8 index 0cd1d37c9c..df8b949daf 100644 --- a/ja/man/man8/rbootd.8 +++ b/ja/man/man8/rbootd.8 @@ -37,8 +37,8 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" @(#)rbootd.8 8.2 (Berkeley) 12/11/93 -.\" %Id: rbootd.8,v 1.3.2.1 1997/12/16 07:17:43 charnier Exp % +.\" from: @(#)rbootd.8 8.2 (Berkeley) 12/11/93 +.\" %Id: rbootd.8,v 1.8 1997/11/24 07:33:41 charnier Exp % .\" .\" Utah $Hdr: rbootd.man 3.1 92/07/06$ .\" Author: Jeff Forys, University of Utah CSS diff --git a/ja/man/man8/rc.8 b/ja/man/man8/rc.8 index 970d67d576..c5d977ea15 100644 --- a/ja/man/man8/rc.8 +++ b/ja/man/man8/rc.8 @@ -30,8 +30,8 @@ .\" SUCH DAMAGE. .\" .\" @(#)rc.8 8.2 (Berkeley) 12/11/93 +.\" %Id: rc.8,v 1.4 1998/02/26 02:44:17 jkh Exp % .\" jpman %Id: rc.8,v 1.3 1997/08/16 13:37:00 horikawa Stab % -.\" %Id: rc.8,v 1.2.2.2 1998/02/26 02:45:22 jkh Exp % .\" .Dd December 11, 1993 .Dt RC 8 @@ -49,6 +49,7 @@ .Nm rc.firewall .Nm rc.<arch> .Nm rc.local +.Nm rc.shutdown .Sh 解説 .Nm rc は自動リブート処理 (他のスクリプトを呼びます) を制御するコマンドスクリプトで、 @@ -59,6 +60,9 @@ .Nm rc.conf.local はローカルなシステム構成情報を持ちます。 .Pp +.Nm Rc.shutdown +は、システムシャットダウンにおいて実行されることが必要なコマンドを持つ +コマンドスクリプトです。 .Pp 自動リブート処理の進行中、 .Nm rc diff --git a/ja/man/man8/reboot.8 b/ja/man/man8/reboot.8 index ea42843078..fb75a5487f 100644 --- a/ja/man/man8/reboot.8 +++ b/ja/man/man8/reboot.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)reboot.8 8.1 (Berkeley) 6/9/93 -.\" %Id: reboot.8,v 1.4.2.1 1998/07/17 20:13:47 jkh Exp % +.\" %Id: reboot.8,v 1.5 1998/07/15 06:51:37 charnier Exp % .\" jpman %Id: reboot.8,v 1.3 1997/06/06 11:35:27 bobson Stab % .\" .Dd June 9, 1993 diff --git a/ja/man/man8/restore.8 b/ja/man/man8/restore.8 index 3f8273fb7c..69299ba39b 100644 --- a/ja/man/man8/restore.8 +++ b/ja/man/man8/restore.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)restore.8 8.4 (Berkeley) 5/1/95 -.\" %Id: restore.8,v 1.5.2.5 1998/08/12 06:51:28 charnier Exp % +.\" %Id: restore.8,v 1.13 1998/07/28 06:20:11 charnier Exp % .\" .\" jpman %Id: restore.8,v 1.2 1997/03/31 14:58:10 horikawa Stab % .Dd May 1, 1995 diff --git a/ja/man/man8/revnetgroup.8 b/ja/man/man8/revnetgroup.8 index 069f559a00..c5837bb8b9 100644 --- a/ja/man/man8/revnetgroup.8 +++ b/ja/man/man8/revnetgroup.8 @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: revnetgroup.8,v 1.1.1.1.2.1 1997/12/16 07:20:16 charnier Exp % +.\" %Id: revnetgroup.8,v 1.6 1998/03/19 07:37:22 charnier Exp % .\" jpman %Id: revnetgroup.8,v 1.2 1997/06/14 16:12:45 horikawa Stab % .\" .Dd October 24, 1995 @@ -145,9 +145,9 @@ マスタサーバにだけ有ります。 .El .Sh 関連項目 +.Xr getnetgrent 3 , .Xr yp 4 , .Xr netgroup 5 , -.Xr yp_mkdb 8 , -.Xr getnetgrent 3 +.Xr yp_mkdb 8 .Sh 作者 .An Bill Paul Aq wpaul@ctr.columbia.edu diff --git a/ja/man/man8/rexecd.8 b/ja/man/man8/rexecd.8 index 7aaf912cf2..5b393f8dde 100644 --- a/ja/man/man8/rexecd.8 +++ b/ja/man/man8/rexecd.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)rexecd.8 8.2 (Berkeley) 12/11/93 -.\" %Id: rexecd.8,v 1.3.2.3 1997/12/16 07:22:06 charnier Exp % +.\" %Id: rexecd.8,v 1.8 1997/11/26 07:29:02 charnier Exp % .\" jpman %Id: rexecd.8,v 1.2 1997/05/28 07:05:49 yugawa Stab % .\" .Dd September 23, 1994 diff --git a/ja/man/man8/rlogind.8 b/ja/man/man8/rlogind.8 index 9fc865253a..13d5de53a2 100644 --- a/ja/man/man8/rlogind.8 +++ b/ja/man/man8/rlogind.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)rlogind.8 8.1 (Berkeley) 6/4/93 -.\" %Id: rlogind.8,v 1.4.2.3 1998/02/18 11:48:06 markm Exp % +.\" %Id: rlogind.8,v 1.9 1997/11/25 07:17:13 charnier Exp % .\" jpman %Id: rlogind.8,v 1.2 1997/05/23 00:50:03 mutoh Stab % .\" .Dd June 4, 1993 diff --git a/ja/man/man8/rmail.8 b/ja/man/man8/rmail.8 index c1bdf85294..d25c6b1a1c 100644 --- a/ja/man/man8/rmail.8 +++ b/ja/man/man8/rmail.8 @@ -1,39 +1,16 @@ -.\" Copyright (c) 1983, 1990 The Regents of the University of California. -.\" All rights reserved. +.\" Copyright (c) 1998 Sendmail, Inc. All rights reserved. +.\" Copyright (c) 1983, 1990 +.\" 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. +.\" By using this file, you agree to the terms and conditions set +.\" forth in the LICENSE file which can be found at the top level of +.\" the sendmail distribution. .\" -.\" 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. .\" -.\" @(#)rmail.8 6.10 (Berkeley) 4/29/93 -.\" %Id: rmail.8,v 1.2.8.3 1998/07/16 09:35:47 jkh Exp % +.\" @(#)rmail.8 6.14 (Berkeley) 5/19/98 .\" jpman %Id: rmail.8,v 1.2 1997/05/16 07:57:46 yugawa Stab % .\" -.Dd April 29, 1993 +.Dd May 19, 1998 .Dt RMAIL 8 .Os BSD 4.2 .Sh 名称 diff --git a/ja/man/man8/rmuser.8 b/ja/man/man8/rmuser.8 index 7b4dc7b180..3c656c321d 100644 --- a/ja/man/man8/rmuser.8 +++ b/ja/man/man8/rmuser.8 @@ -24,7 +24,7 @@ .\" (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: rmuser.8,v 1.1.2.4 1998/03/08 14:59:56 jkh Exp % +.\" %Id: rmuser.8,v 1.8 1997/11/02 00:58:39 jraynard Exp % .\" jpman %Id: rmuser.8,v 1.3 1997/07/22 16:58:06 horikawa Stab % .\" .Dd February 23, 1997 diff --git a/ja/man/man8/rndcontrol.8 b/ja/man/man8/rndcontrol.8 index 3e3e024c61..06682235ac 100644 --- a/ja/man/man8/rndcontrol.8 +++ b/ja/man/man8/rndcontrol.8 @@ -30,7 +30,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: rndcontrol.8,v 1.4.2.2 1998/07/18 11:12:20 jkh Exp % +.\" %Id: rndcontrol.8,v 1.8 1998/03/23 08:28:31 charnier Exp % .\" jpman %Id: rndcontrol.8,v 1.3 1997/08/16 13:39:03 horikawa Stab % .\" .Dd October 20, 1995 diff --git a/ja/man/man8/route.8 b/ja/man/man8/route.8 index 63decfa368..0601f0d2cf 100644 --- a/ja/man/man8/route.8 +++ b/ja/man/man8/route.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)route.8 8.3 (Berkeley) 3/19/94 -.\" %Id: route.8,v 1.7.2.4 1998/08/12 06:48:51 charnier Exp % +.\" %Id: route.8,v 1.12 1998/07/28 06:25:33 charnier Exp % .\" .\" jpman %Id: route.8,v 1.3 1997/07/28 05:33:13 konuma Stab % .\" @@ -64,7 +64,8 @@ において解説されているプログラム可能なインタフェイスを通して、 任意の要求を指定することができます。 .Pp -.Bl -tag -width Ds +以下のオプションを使用可能です: +.Bl -tag -width indnent .It Fl n レポートの出力において、ホスト名とネットワーク名のシンボル名での表示を 抑止します。 diff --git a/ja/man/man8/routed.8 b/ja/man/man8/routed.8 index d0446f3d93..a3729e6162 100644 --- a/ja/man/man8/routed.8 +++ b/ja/man/man8/routed.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)routed.8 8.2 (Berkeley) 12/11/93 -.\" %Id: routed.8,v 1.2.2.5 1998/08/12 06:54:16 charnier Exp % +.\" %Id: routed.8,v 1.11 1998/07/28 06:36:14 charnier Exp % .\" .\" jpman %Id: routed.8,v 1.2 1997/03/31 14:11:11 horikawa Stab % .\" @@ -50,7 +50,7 @@ .Oc .OP Fl P Ar parms .Sh 解説 -.Nm routed +.Nm はネットワークのルーティングテーブルを管理するデーモンで、 システムのブート時に起動されます。 これは、カーネルのルーティングテーブルを管理するために、 @@ -59,7 +59,7 @@ RIPv1 (RFC\ 1058)、RIPv2 (RFC\ 1723)、および Internet Router Discovery Protocol (RFC 1256) を用います。 RIPv1 プロトコルは 4.3BSD のデーモンのものをベースとしています。 .Pp -.Nm routed +.Nm は、ルーティング情報プロトコルのパケットを待つために、 .Xr route 8 サービス @@ -69,21 +69,21 @@ RIPv1 プロトコルは 4.3BSD のデーモンのものをベースとしています。 ソケットを listen() します。また、マルチキャストによる Router Discovery の ICMP メッセージの送受信も行います。 ホストがルータだった場合、 -.Nm routed +.Nm は直接接続されている全てのホストやネットワークに、 ルーティングテーブルの複製を定期的に提供します。 また、Router Discovery の ICMP メッセージを用いてデフォルトルートを広告したり 要求したりします。 .Pp -.Nm routed +.Nm が走行し始めると (または、ネットワークインタフェースがオンになると)、 -.Nm routed +.Nm は AF_ROUTE アドレスファミリを用いて、システムに直結されていて コンフィギュレーションされているインタフェースのうちで "up" とマークされて いるものを探します。そしてそのインタフェースに必要な経路をカーネルの ルーティングテーブルに追加します。スタート直後で、RIP が無効になっていない インタフェースが少なくとも 1 つある場合は、 -.Nm routed +.Nm はカーネルのテーブル内に既に存在する静的でない経路を全て削除します。 カーネルのテーブル内にある静的な経路は保存され、有効な RIP metric を 持っているものは RIP レスポンスに含められます @@ -98,7 +98,7 @@ ICMP メッセージの送受信も行います。 listen します。 .Pp リクエストパケットを受信すると、 -.Nm routed +.Nm は内部テーブルに持っている情報からリプライを作成します。 生成された .Em レスポンス @@ -152,7 +152,7 @@ listen します。 .Em black-holes を最小にするために、しばらく経ってから削除されます。 TCP コネクションのタイムアウトが起こると、カーネルは -.Nm routed +.Nm に対し、そのゲートウェイを通る全てのリダイレクトされた経路を削除し、 そのゲートウェイを通る全ての RIP の経路の年齢を増やすことで他のゲートウェイが 選択されるようにし、関連する全ての Router Discovery Protocol の @@ -219,14 +219,12 @@ RIPv2 と Router Discovery のどちらも扱うことができない "遺物の" システムを point-to-point リンク (SLIP や PPP などのような、IFF_POINTOPOINT フラグ のついたもの) のネットマスクは、 RIPv1 利用時にはそのネットマスクがリモートシステムで利用されると -.Nm routed +.Nm は推測します。 .Pp -.Nm routed -がサポートしているオプションは以下の通りです: -.Bl -tag -width Ds +以下のオプションを使用可能です: +.Bl -tag -width indent .It Fl s -このオプションを指定すると、 .Nm は強制的にルーティング情報を提供します。 これは、RIP や Router Discovery を無効にしていない状態で複数の @@ -240,7 +238,7 @@ RIPv1 利用時にはそのネットマスクがリモートシステムで利用されると バックグラウンドでは動作しません。このオプションは対話的に使用するための ものです。 .It Fl g -このフラグは、ネットワーク間ルータにおいて "default" の到達先への経路を設ける +ネットワーク間ルータにおいて "default" の到達先への経路を設ける ために使われます。これは .Fl F .Cm 0/0,1 @@ -287,7 +285,7 @@ RIP を使う場合の妨げとなります。 .It Fl T Ar tracefile デバッグレベルを最低でも 1 まで上げ、デバッグ情報をトレースファイルに 書き加えるようにします。セキュリティ上の都合により、 -.Nm routed +.Nm がファイルへのトレースを日常的に行うようにはしないのが賢明です。 .It Fl t デバッグレベルを増やします。 @@ -328,14 +326,14 @@ RIP を使う場合の妨げとなります。 .El .Pp 提供された他の引数は、 -.Nm routed +.Nm の動作を記録するファイルの名前として解釈されます。 トレースファイルの名前をコマンドに追加するよりは、 .Fl T を使った方がよいでしょう。 .Pp 上記の機能に加えて、 -.Nm routed +.Nm は "遠隔にある" .Em パッシブ もしくは @@ -376,7 +374,7 @@ ATM ネットワーク上にある到達可能な全ての RIP ルータを ルーティングの更新時にその情報が含められることもありません。 external エントリの機能は、他のルーティングプロセスがそのような経路を 必要時に追加する可能性があることを知らせるためにあり、その到達先への別の経路は -.Nm routed +.Nm で設定されるべきではありません。 external エントリは、両方のルータが同じ到達先への経路を覚えてもよい場合にのみ 必要です。 @@ -423,7 +421,7 @@ external エントリは、両方のルータが同じ到達先への経路を覚えてもよい場合にのみ または .Pa /etc/hosts で定義されているか、 -.Nm routed +.Nm の動作開始前に .Xr named 8 が起動されていなければなりません。) @@ -530,7 +528,7 @@ RIP パケットを処理するインタフェースがない場合は、 .Fl s で明示的に Router Discovery の広告を行うように指示せずに RIP を 行わないようにすると、 -.Nm routed +.Nm は広告を行わない Router Discovery デーモンとして働くことに注意して下さい。 .It Cm no_ripv1_in 受信した RIPv1 レスポンスが無視されるようになります。 diff --git a/ja/man/man8/rpc.rquotad.8 b/ja/man/man8/rpc.rquotad.8 index dce03b7195..4951c9b9b0 100644 --- a/ja/man/man8/rpc.rquotad.8 +++ b/ja/man/man8/rpc.rquotad.8 @@ -27,7 +27,7 @@ .\" (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.rquotad.8,v 1.1.1.1.2.2 1997/12/17 07:31:27 charnier Exp % +.\" %Id: rpc.rquotad.8,v 1.5 1997/11/26 07:31:14 charnier Exp % .\" jpman %Id: rpc.rquotad.8,v 1.3 1997/09/04 17:40:03 horikawa Stab % .\" .Dd June 22, 1994 diff --git a/ja/man/man8/rpc.rstatd.8 b/ja/man/man8/rpc.rstatd.8 index e34c1dd854..f102159dc2 100644 --- a/ja/man/man8/rpc.rstatd.8 +++ b/ja/man/man8/rpc.rstatd.8 @@ -31,7 +31,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: rpc.rstatd.8,v 1.1.1.1.8.1 1997/12/17 07:33:09 charnier Exp % +.\" %Id: rpc.rstatd.8,v 1.4 1997/11/26 07:34:54 charnier Exp % .\" .\" jpman %Id: rpc.rstatd.8,v 1.2 1997/05/22 08:05:12 mitchy Stab % .Dd June 7, 1993 diff --git a/ja/man/man8/rpc.rusersd.8 b/ja/man/man8/rpc.rusersd.8 index 0421c53187..873447e281 100644 --- a/ja/man/man8/rpc.rusersd.8 +++ b/ja/man/man8/rpc.rusersd.8 @@ -31,7 +31,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: rpc.rusersd.8,v 1.1.1.1.8.1 1997/12/17 07:34:41 charnier Exp % +.\" %Id: rpc.rusersd.8,v 1.5 1997/11/26 07:36:50 charnier Exp % .\" jpman %Id: rpc.rusersd.8,v 1.2 1997/05/22 08:10:18 mitchy Stab % .\" .Dd June 7, 1993 @@ -63,6 +63,6 @@ プロトコルを使用します。 .Sh 関連項目 .Xr rusers 1 , -.Xr who 1 , .Xr w 1 , +.Xr who 1 , .Xr inetd 8 diff --git a/ja/man/man8/rpc.rwalld.8 b/ja/man/man8/rpc.rwalld.8 index 26d348165d..f3df438317 100644 --- a/ja/man/man8/rpc.rwalld.8 +++ b/ja/man/man8/rpc.rwalld.8 @@ -31,7 +31,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: rpc.rwalld.8,v 1.1.1.1.8.1 1997/12/17 07:36:28 charnier Exp % +.\" %Id: rpc.rwalld.8,v 1.4 1997/12/02 12:20:10 charnier Exp % .\" jpman %Id: rpc.rwalld.8,v 1.2 1997/05/22 08:15:10 mitchy Stab % .\" .Dd June 7, 1993 diff --git a/ja/man/man8/rpc.sprayd.8 b/ja/man/man8/rpc.sprayd.8 index f55f880378..526d29527b 100644 --- a/ja/man/man8/rpc.sprayd.8 +++ b/ja/man/man8/rpc.sprayd.8 @@ -27,7 +27,7 @@ .\" (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.sprayd.8,v 1.2.2.1 1997/12/17 07:38:17 charnier Exp % +.\" %Id: rpc.sprayd.8,v 1.5 1997/12/02 12:25:31 charnier Exp % .\" jpman %Id: rpc.sprayd.8,v 1.3 1997/09/04 17:42:05 horikawa Stab % .\" .Dd June 22, 1994 diff --git a/ja/man/man8/rpc.yppasswdd.8 b/ja/man/man8/rpc.yppasswdd.8 index 6e83ed91f9..117e6c4075 100644 --- a/ja/man/man8/rpc.yppasswdd.8 +++ b/ja/man/man8/rpc.yppasswdd.8 @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: rpc.yppasswdd.8,v 1.4.2.2 1997/11/05 07:37:00 charnier Exp % +.\" %Id: rpc.yppasswdd.8,v 1.9 1998/03/23 08:28:39 charnier Exp % .\" jpman %Id: rpc.yppasswdd.8,v 1.3 1997/08/31 14:17:34 horikawa Stab % .\" .Dd February 8, 1996 diff --git a/ja/man/man8/rpc.ypxfrd.8 b/ja/man/man8/rpc.ypxfrd.8 index bad7b885c0..8dac7ce484 100644 --- a/ja/man/man8/rpc.ypxfrd.8 +++ b/ja/man/man8/rpc.ypxfrd.8 @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: rpc.ypxfrd.8,v 1.1.1.1.2.2 1997/10/14 06:40:05 charnier Exp % +.\" %Id: rpc.ypxfrd.8,v 1.7 1998/03/23 08:28:49 charnier Exp % .\" jpman %Id: rpc.ypxfrd.8,v 1.3 1997/09/04 17:48:28 horikawa Stab % .\" .Dd June 2, 1996 diff --git a/ja/man/man8/rpcinfo.8 b/ja/man/man8/rpcinfo.8 index 9eb2750dfd..3fa69ec970 100644 --- a/ja/man/man8/rpcinfo.8 +++ b/ja/man/man8/rpcinfo.8 @@ -1,6 +1,6 @@ .\" from: @(#)rpcinfo.8c 2.2 88/08/03 4.0 RPCSRC; from 1.24 88/02/25 SMI +.\" %Id: rpcinfo.8,v 1.4 1997/08/06 06:49:06 charnier Exp % .\" jpman %Id: rpcinfo.8,v 1.2 1997/05/20 01:33:31 mutoh Stab % -.\" %Id: rpcinfo.8,v 1.1.8.1 1997/08/07 06:40:10 charnier Exp % .\" .Dd December 17, 1987 .Dt RPCINFO 8 diff --git a/ja/man/man8/rshd.8 b/ja/man/man8/rshd.8 index bd52178f20..4c05a8c951 100644 --- a/ja/man/man8/rshd.8 +++ b/ja/man/man8/rshd.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)rshd.8 8.1 (Berkeley) 6/4/93 -.\" %Id: rshd.8,v 1.4.2.3 1998/02/18 11:52:19 markm Exp % +.\" %Id: rshd.8,v 1.11 1997/12/18 07:39:27 charnier Exp % .\" jpman %Id: rshd.8,v 1.4 1997/08/10 18:35:56 horikawa Stab % .\" .Dd June 4, 1993 diff --git a/ja/man/man8/rtquery.8 b/ja/man/man8/rtquery.8 index 7199b8cd3c..8fa0fd5037 100644 --- a/ja/man/man8/rtquery.8 +++ b/ja/man/man8/rtquery.8 @@ -1,4 +1,4 @@ -.\" %Id: rtquery.8,v 1.1.1.1.2.5 1998/08/12 06:54:23 charnier Exp % +.\" %Id: rtquery.8,v 1.8 1998/07/28 06:36:30 charnier Exp % .\" jpman %Id: rtquery.8,v 1.2 1997/06/12 07:55:04 yugawa Stab % .Dd June 1, 1996 .Dt RTQUERY 8 @@ -7,16 +7,17 @@ .Nm rtquery .Nd ルーティングデーモンが持つルーティングテーブルの問い合わせ .Sh 書式 -.Nm +.Nm rtquery .Op Fl np1 .Op Fl w Ar timeout .Op Fl r Ar addr .Op Fl a Ar secret -.Ar host ... - -.Nm +.Ar host +.Ar +.Nm rtquery .Op Fl t Ar op -.Ar host ... +.Ar host +.Ar .Sh 解説 .Nm は、RIP ネットワークルーティングデーモン、すなわち、 @@ -71,9 +72,8 @@ Poisoned Reverse の影響を受けることがなく、また、ある種のバージョンの .Nm routed のトレース機能を有効にしたり無効にしたりする場合にも用いられます。 .Pp -.Nm -には以下のオプションがあります。 -.Bl -tag -width Ds +以下のオプションを使用可能です: +.Bl -tag -width indent .It Fl n 通常、ネットワークおよびホスト番号はシンボル名および数値の両方で表示されます。 .Fl n diff --git a/ja/man/man8/sa.8 b/ja/man/man8/sa.8 index 1a98b5bc98..83e7a56c80 100644 --- a/ja/man/man8/sa.8 +++ b/ja/man/man8/sa.8 @@ -27,7 +27,7 @@ .\" (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: sa.8,v 1.4.2.3 1998/07/18 11:12:27 jkh Exp % +.\" %Id: sa.8,v 1.9 1998/03/23 08:29:09 charnier Exp % .\" jpman %Id: sa.8,v 1.2 1997/03/31 15:00:26 horikawa Stab % .\" .Dd February 25, 1994 diff --git a/ja/man/man8/savecore.8 b/ja/man/man8/savecore.8 index 85c3127a6e..2d87abfd15 100644 --- a/ja/man/man8/savecore.8 +++ b/ja/man/man8/savecore.8 @@ -30,8 +30,8 @@ .\" SUCH DAMAGE. .\" .\" From: @(#)savecore.8 8.1 (Berkeley) 6/5/93 +.\" %Id: savecore.8,v 1.7 1998/07/28 06:38:57 charnier Exp % .\" jpman %Id: savecore.8,v 1.3 1997/08/16 13:41:03 horikawa Stab % -.\" %Id: savecore.8,v 1.4 1996/10/13 18:12:20 fenner Exp % .\" .Dd September 23, 1994 .Dt SAVECORE 8 @@ -47,17 +47,17 @@ .Op Fl N Ar system .Ar directory .Sh 解説 -.Nm savecore +.Nm は現在動作中のカーネルおよびそのコアダンプをディレクトリ .Fa directory 内にコピーし、 リブートメッセージとコアダンプ情報をシステムログに書き出します。 .Pp オプションは以下の通りです: -.Bl -tag -width directory +.Bl -tag -width indent .It Fl c ダンプをクリアし、これ以降起動される -.Nm savecore +.Nm でそれが用いられないようにします。 .It Fl f ダンプが正しくないと思われる場合や、ディスク容量が不足している場合でも、 @@ -77,7 +77,7 @@ 参照)。 .El .Pp -.Nm savecore +.Nm は様々な方法を用いてコアダンプが最新であること、 およびそのコアダンプが現在動作しているシステムに対応するものであることを 確認します。 @@ -91,10 +91,10 @@ ``#'' はファイル .Ar directory Ns Pa /bounds 先頭からの行数で、 -.Nm savecore +.Nm が正常に実行されるたびにインクリメントされてファイルに書き戻されます。 .Pp -.Nm savecore +.Nm はまた、コピーを作る前にディスク容量が足りているかどうかチェックします。 .Ar directory を含むファイルシステムのディスク容量が不足している場合、 @@ -105,13 +105,13 @@ このファイル先頭行の数値より小さい場合、 コピー作成は試みられません。 .Pp -.Nm savecore +.Nm がカーネルとコアダンプのコピーに成功すると、 コアダンプはクリアされ、その後の -.Nm savecore +.Nm では用いられないようになります。 .Pp -.Nm savecore +.Nm は初期化ファイル .Pa /etc/rc の最終段階付近で呼び出されることを想定しています( diff --git a/ja/man/man8/scsi.8 b/ja/man/man8/scsi.8 index ba99796e6d..e328cde2e9 100644 --- a/ja/man/man8/scsi.8 +++ b/ja/man/man8/scsi.8 @@ -4,8 +4,8 @@ .\" Permission is granted to use or redistribute this file in any way as long .\" as this notice remains. Julian Elischer does not guarantee that this file .\" is totally correct for any given task and users of this file must -.\" accept responsibility for any damage that occurs from the application of this -.\" file. +.\" accept responsibility for any damage that occurs from the application +.\" of this file. .\" .\" (julian@tfs.com julian@dialix.oz.au) .\" User SCSI hooks added by Peter Dufault: @@ -39,7 +39,7 @@ .\" SUCH DAMAGE. .\" .\" -.\" %Id: scsi.8,v 1.6.2.8 1998/08/12 06:32:47 charnier Exp % +.\" %Id: scsi.8,v 1.18 1998/07/28 06:42:37 charnier Exp % .\" .\" jpman %Id: scsi.8,v 1.3 1997/07/22 16:40:11 horikawa Stab % .\" diff --git a/ja/man/man8/scsiformat.8 b/ja/man/man8/scsiformat.8 index c1a814f171..e657b88319 100644 --- a/ja/man/man8/scsiformat.8 +++ b/ja/man/man8/scsiformat.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)scsiformat.8 5.1 (Berkeley) 6/5/93 -.\" %Id: scsiformat.8,v 1.4.2.3 1998/08/12 06:34:18 charnier Exp % +.\" %Id: scsiformat.8,v 1.9 1998/08/03 06:19:47 charnier Exp % .\" .\" jpman %Id: scsiformat.8,v 1.4 1997/07/26 22:08:08 horikawa Stab % .\" @@ -46,7 +46,7 @@ .Op Fl p Ar page-control .Ar device-name .Sh 解説 -.Nm scsiformat +.Nm ユーティリティは接続時の SCSI フォーマットをサポートした、 固定 SCSI ディスクをフォーマットするのに使われます。 また、SCSI コントローラに設定されたいくつかのパラメータを表示することも @@ -65,7 +65,7 @@ .It Fl p SCSI のモードセンスページの問合せの方法を変更します。 デフォルトでは、 -.Nm scsiformat +.Nm は現在の設定をもとにします。 ページ制御フラグは次のうちのどれかです: .sp @@ -86,7 +86,7 @@ inquiry 文字列だけが出力されるので、 .It Fl y 肯定 (Yes); 質問を行なうことなしにフォーマットします。 もしこのオプションが与えられなかった場合、 -.Nm scsiformat +.Nm は、実際に装置のフォーマットを始める前によいかどうか尋ねます。 ここで、割り込みキー (通常 Control-C) を打つことでプログラムを中断できます。 .It Fl w @@ -100,7 +100,7 @@ inquiry 文字列だけが出力されるので、 .Sh 関連項目 .Xr scsi 8 .Sh 歴史 -.Nm scsiformat +.Nm ユーティリティは .Bx 4.4 から登場しました。 diff --git a/ja/man/man8/sendmail.8 b/ja/man/man8/sendmail.8 index 46c875a8dc..3b4761e31d 100644 --- a/ja/man/man8/sendmail.8 +++ b/ja/man/man8/sendmail.8 @@ -1,39 +1,17 @@ -.\" Copyright (c) 1983, 1997 Eric P. Allman +.\" Copyright (c) 1998 Sendmail, Inc. All rights reserved. +.\" Copyright (c) 1983, 1997 Eric P. Allman. All rights reserved. .\" Copyright (c) 1988, 1991, 1993 .\" 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. +.\" By using this file, you agree to the terms and conditions set +.\" forth in the LICENSE file which can be found at the top level of +.\" the sendmail distribution. .\" -.\" 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. .\" -.\" @(#)sendmail.8 8.12 (Berkeley) 2/1/97 +.\" @(#)sendmail.8 8.19 (Berkeley) 5/19/98 .\" jpman %Id: sendmail.8,v 1.2 1997/06/05 01:31:44 yugawa Stab % .\" -.Dd February 1, 1997 +.Dd May 19, 1998 .Dt SENDMAIL 8 .Os BSD 4 .Sh 名称 @@ -265,9 +243,7 @@ .It Fl t 受信者をメッセージから読み取ります。To:, Cc:, Bcc: フィールドが受信者 のアドレスとして読み込まれます。Bcc: フィールドはメッセージの転送前に -削除されます。引数で指定されたアドレスは全て無視されますので、メッセー -ジのヘッダに名前が並べてあっても、引数に指定してあるとメッセージは転送 -されません。 +削除されます。 .It Fl U 最初の(ユーザからの)発送である事を示します。 このフラグは、 @@ -537,7 +513,7 @@ poets: ":include:/usr/local/lib/poets.list" はメールキューの内容を表示します。 .Sh 関連ファイル .Pa /etc/sendmail.cf -を除き、以下のファイルのパスはすべて +とデーモンプロセス ID ファイルを除き、以下のファイルのパスはすべて .Pa /etc/sendmail.cf 内部で決められています。以下は一例に過ぎません。 .Pp @@ -554,8 +530,6 @@ poets: ":include:/usr/local/lib/poets.list" 統計情報ファイル .It Pa /var/spool/mqueue/* テンポラリファイル -.It Pa /var/run/sendmail.pid -デーモンのプロセス ID を格納しているファイル .El .Sh 関連項目 .Xr mail 1 , diff --git a/ja/man/man8/shutdown.8 b/ja/man/man8/shutdown.8 index d5afea9f91..5259949e2e 100644 --- a/ja/man/man8/shutdown.8 +++ b/ja/man/man8/shutdown.8 @@ -30,6 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)shutdown.8 8.1 (Berkeley) 6/5/93 +.\" %Id: shutdown.8,v 1.4 1998/08/03 06:22:43 charnier Exp % .\" jpman %Id: shutdown.8,v 1.2 1997/05/13 00:55:09 mutoh Stab % .\" .Dd June 5, 1993 @@ -51,8 +52,8 @@ こういったお知せを面倒がって行なわない システム管理者やハッカーやグルといった人々から、ユーザを救います。 .Pp -以下の親切なオプションがあります: -.Bl -tag -width time +以下のオプションを使用可能です: +.Bl -tag -width indent .It Fl h .Ar time で指定された時間に @@ -72,7 +73,7 @@ .Xr reboot 8 を実行し、システムを再起動します。 .It Ar time -.Nm shutdown +.Nm がシステムを停止させる時間を指定します。 .Ar now を指定すると即時にシステムを停止します。 @@ -101,12 +102,12 @@ ユーザがログインしようとした際にこのファイルが存在する場合には、 .Xr login 1 はその内容を表示し終了します。このファイルは -.Nm shutdown +.Nm が終了する際に削除されます。 .Pp システム停止時には、システムを停止した時間、実行者、理由が システムログに記録されます。その後、terminate シグナルが -.Xr init +.Xr init 8 に送られ、システムをシングルユーザ状態にします(この動作は上記の オプションに依存します)。 システムを停止する時間と警告メッセージは diff --git a/ja/man/man8/sicontrol.8 b/ja/man/man8/sicontrol.8 index aa3bc19bad..c1768891c3 100644 --- a/ja/man/man8/sicontrol.8 +++ b/ja/man/man8/sicontrol.8 @@ -1,4 +1,4 @@ -.\" %Id: sicontrol.8,v 1.3.2.3 1998/07/18 11:12:36 jkh Exp % +.\" %Id: sicontrol.8,v 1.8 1998/03/23 08:29:31 charnier Exp % .\" jpman %Id: sicontrol.8,v 1.2 1997/06/17 17:49:35 saeki Stab % .\" The following requests are required for all man pages. .Dd September 26,1995 diff --git a/ja/man/man8/slattach.8 b/ja/man/man8/slattach.8 index 1a836883dd..525cc83248 100644 --- a/ja/man/man8/slattach.8 +++ b/ja/man/man8/slattach.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)slattach.8 6.4 (Berkeley) 3/16/91 -.\" %Header: /home/ncvs/src/sbin/slattach/slattach.8,v 1.11.2.3 1998/08/12 06:57:33 charnier Exp % +.\" %Header: /home/ncvs/src/sbin/slattach/slattach.8,v 1.13 1997/04/16 09:56:30 danny Exp % .\" .\" jpman %Id: slattach.8,v 1.2 1997/05/19 05:35:41 mitchy Stab % .\" @@ -101,19 +101,19 @@ ICMP パケットを無視します。 .Ql sh \-c Ar redial-command のように呼び出されるコマンドを指定します。 .Ar redial-command -として空白を指定 (すなわち +として空白を指定、すなわち .Fl r Qq "" -) することで、専用線で外部コマンドを実行せずに再接続を試みます。 +とすることで、専用線で外部コマンドを実行せずに再接続を試みます。 .It Fl s Ar baudrate 接続速度を指定します。このオプションが指定されない場合には、 9600 bps になります。 .It Fl u Ar unit-command シリアルラインが slip に切り替わった時、 -.Ql Nm "sh -c" Ar unit-command old new +.Ql Nm "sh -c" Ar unit-command <old> <new> が実行されます。 -.Ar old +.Ar <old> と -.Ar new +.Ar <new> はそれぞれ slip の最後にオープンされた時のユニット番号と現在のコネクションの ユニット番号です。 このユニット番号は 2 つ以上の slip ラインを使用すればリダイアル後に diff --git a/ja/man/man8/slstat.8 b/ja/man/man8/slstat.8 index 625fec7294..1b1a54270b 100644 --- a/ja/man/man8/slstat.8 +++ b/ja/man/man8/slstat.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" From: @(#)slstat.8 6.8 (Berkeley) 6/20/91 -.\" %Id: slstat.8,v 1.6.2.3 1997/11/06 07:40:40 charnier Exp % +.\" %Id: slstat.8,v 1.11 1997/10/20 12:41:40 charnier Exp % .\" jpman %Id: slstat.8,v 1.2 1997/05/24 05:28:27 mitchy Stab % .\" .Dd October 11, 1996 diff --git a/ja/man/man8/smrsh.8 b/ja/man/man8/smrsh.8 index 1096da301c..62d88f88a5 100644 --- a/ja/man/man8/smrsh.8 +++ b/ja/man/man8/smrsh.8 @@ -1,36 +1,14 @@ -.\" Copyright (c) 1993 Eric P. Allman +.\" Copyright (c) 1998 Sendmail, Inc. All rights reserved. +.\" Copyright (c) 1993 Eric P. Allman. All rights reserved. .\" Copyright (c) 1993 .\" 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. +.\" By using this file, you agree to the terms and conditions set +.\" forth in the LICENSE file which can be found at the top level of +.\" the sendmail distribution. .\" -.\" 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. .\" -.\" @(#)smrsh.8 8.2 (Berkeley) 1/9/96 +.\" @(#)smrsh.8 8.7 (Berkeley) 5/19/98 .\" jpman %Id: smrsh.8,v 1.3 1997/09/04 18:05:48 horikawa Stab % .\" .TH SMRSH 8 11/02/93 diff --git a/ja/man/man8/spkrtest.8 b/ja/man/man8/spkrtest.8 index 6cbc483bd7..c6ba1acced 100644 --- a/ja/man/man8/spkrtest.8 +++ b/ja/man/man8/spkrtest.8 @@ -22,7 +22,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: spkrtest.8,v 1.2.2.3 1998/03/09 14:45:56 jkh Exp % +.\" %Id: spkrtest.8,v 1.7 1997/10/20 12:43:03 charnier Exp % .\" jpman %Id: spkrtest.8,v 1.3 1997/08/16 13:43:02 horikawa Stab % .Dd July 23, 1995 diff --git a/ja/man/man8/sticky.8 b/ja/man/man8/sticky.8 index 01077cd71f..429ad23997 100644 --- a/ja/man/man8/sticky.8 +++ b/ja/man/man8/sticky.8 @@ -30,8 +30,8 @@ .\" SUCH DAMAGE. .\" .\" @(#)sticky.8 8.1 (Berkeley) 6/5/93 +.\" %Id: sticky.8,v 1.4 1997/12/26 12:26:43 helbig Exp % .\" jpman %Id: sticky.8,v 1.3 1997/07/19 12:27:09 konuma Stab % -.\" %Id: sticky.8,v 1.1.1.1.8.2 1998/03/07 12:17:29 jkh Exp % .\" .Dd June 5, 1993 .Dt STICKY 8 diff --git a/ja/man/man8/swapon.8 b/ja/man/man8/swapon.8 index 34bd231162..357e0e84ec 100644 --- a/ja/man/man8/swapon.8 +++ b/ja/man/man8/swapon.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)swapon.8 8.1 (Berkeley) 6/5/93 -.\" %Id: swapon.8,v 1.4.2.2 1998/07/17 20:13:53 jkh Exp % +.\" %Id: swapon.8,v 1.10 1998/08/03 06:35:01 charnier Exp % .\" jpman %Id: swapon.8,v 1.2 1997/05/03 13:45:14 horikawa Stab % .\" .Dd June 5, 1993 @@ -45,19 +45,19 @@ .Nm swapon .Ar special_file ... .Sh 解説 -.Nm swapon +.Nm は、ページングやスワッピングを行うための追加デバイス指定にて使用します。 システムは、ただ一つのデバイス上にページングやスワッピングして立ち上がるので、 起動時にはただ一つのディスクを要求します。 通常 -.Nm swapon +.Nm は、システムのマルチユーザモードの初期化ファイル .Pa /etc/rc から起動され、全てのスワップデバイスを有効にし、 ページングとスワッピング動作を複数デバイスにインタリーブします。 .Pp 通常は、最初の書式を使用します: -.Bl -tag -width Ds +.Bl -tag -width indent .It Fl a .Pa /etc/fstab で、``noauto'' オプションが設定されていない、 diff --git a/ja/man/man8/sync.8 b/ja/man/man8/sync.8 index b7c6c53621..3d77730c8f 100644 --- a/ja/man/man8/sync.8 +++ b/ja/man/man8/sync.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)sync.8 8.1 (Berkeley) 5/31/93 -.\" %Id: sync.8,v 1.3.2.3 1998/07/16 09:35:52 jkh Exp % +.\" %Id: sync.8,v 1.7 1998/05/18 06:50:15 charnier Exp % .\" jpman %Id: sync.8,v 1.2 1997/04/10 05:32:43 mutoh Stab % .\" .Dd May 31, 1993 diff --git a/ja/man/man8/sysctl.8 b/ja/man/man8/sysctl.8 index 976a549cdc..b0eead9203 100644 --- a/ja/man/man8/sysctl.8 +++ b/ja/man/man8/sysctl.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" From: @(#)sysctl.8 8.1 (Berkeley) 6/6/93 -.\" %Id: sysctl.8,v 1.10.2.2 1997/11/07 07:27:11 charnier Exp % +.\" %Id: sysctl.8,v 1.16 1998/07/29 08:30:37 joerg Exp % .\" jpman %Id: sysctl.8,v 1.2 1997/05/30 00:57:58 yugawa Stab % .\" .Dd September 23, 1994 @@ -142,6 +142,8 @@ changeable の列は、適切な権限を持つプロセスがその値を変更 .It kern.update integer yes .It kern.osreldate string no .It kern.bootfile string yes +.It kern.corefile string yes +.It kern.logsigexit integer yes .It vm.loadavg struct no .It hw.machine string no .It hw.model string no diff --git a/ja/man/man8/syslogd.8 b/ja/man/man8/syslogd.8 index d948919a5a..ce320f085f 100644 --- a/ja/man/man8/syslogd.8 +++ b/ja/man/man8/syslogd.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)syslogd.8 8.1 (Berkeley) 6/6/93 -.\" %Id: syslogd.8,v 1.6.2.8 1998/08/06 01:43:45 jkoshy Exp % +.\" %Id: syslogd.8,v 1.16 1998/07/22 06:15:18 phk Exp % .\" .\" jpman %Id: syslogd.8,v 1.3 1997/05/19 17:08:30 horikawa Stab % .\" diff --git a/ja/man/man8/telnetd.8 b/ja/man/man8/telnetd.8 index 5b1307f0b3..3204619bc6 100644 --- a/ja/man/man8/telnetd.8 +++ b/ja/man/man8/telnetd.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)telnetd.8 8.3 (Berkeley) 3/1/94 -.\" %Id: telnetd.8,v 1.5.2.4 1998/05/04 02:41:38 steve Exp % +.\" %Id: telnetd.8,v 1.12 1998/05/04 02:37:29 steve Exp % .\" jpman %Id: telnetd.8,v 1.2 1997/05/12 08:14:57 yugawa Stab % .\" .Dd March 1, 1994 diff --git a/ja/man/man8/tickadj.8 b/ja/man/man8/tickadj.8 index a213fdbda7..339bca1c0e 100644 --- a/ja/man/man8/tickadj.8 +++ b/ja/man/man8/tickadj.8 @@ -1,152 +1,123 @@ -''' %Id: tickadj.8,v 1.2 1996/10/05 22:27:28 wosch Exp % .\" jpman %Id: tickadj.8,v 1.4 1997/07/26 22:12:09 horikawa Stab % -''' -.de Sh -.br -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp -.if t .sp .5v -.if n .sp -.. -.de Ip -.br -.ie \\n.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -''' -''' Set up \*(-- to give an unbreakable dash; -''' string Tr holds user defined translation string. -''' Greek uppercase omega is used as a dummy character. -''' -.tr \(*W-|\(bv\*(Tr -.ie n \{\ -.ds -- \(*W- -.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -.ds L" "" -.ds R" "" -.ds L' ' -.ds R' ' -'br\} -.el\{\ -.ds -- \(em\| -.tr \*(Tr -.ds L" `` -.ds R" '' -.ds L' ` -.ds R' ' -'br\} -.TH TICKADJ 8 LOCAL -.SH 名称 -tickadj - カーネル内の時間に関連した変数をだます -.SH 書式 -.B tickadj -[ -.B -Aqs -] [ -.B -a -.I new_tickadj -] [ -.B -t -.I new_tick -] -.SH 解説 -.I tickadj +.\" %Id: tickadj.8,v 1.5 1998/01/22 07:26:08 charnier Exp % +.\" +.Dd December 21, 1993 +.Dt TICKADJ 8 +.Os +.Sh 名称 +.Nm tickadj +.Nd カーネル内の時間に関連した変数をだます +.Sh 書式 +.Nm tickadj +.Op Fl Adkpqs +.Op Fl a Ar new_tickadj +.Op Fl t Ar new_tick +.Sh 解説 +.Nm プログラムは、動いているカーネル内のいくつかの時間を守ることに関係する 変数を -.IR /dev/kmem +.Pa /dev/kmem を通して読み込んだり、変更したりします。 これらの変数は以下の通りです。 -.IR tick +.Em tick は、クロック割り込みによってシステム時間に加えられる時間を マイクロ秒で表現しています。 -.IR tickadj +.Em tickadj は、 -.IR adjtime (2) +.Xr adjtime 2 システムコールによって使われる時間を遅らせる率と時間の解像度を 設定しています。 -.IR dosynctodr +.Em dosynctodr は、あるマシン上で、 内部的にシステム時計をタイムオブデイ (time of day) クロックと合わせる必要が有るか否かを カーネルに示します。 -.PP +.Pp デフォルトでは、オプションの無い -.I tickadj +.Nm は、カーネル内の興味のある変数を読み込み、それを出力します。 同時に、目的が -.IR xntpd (8) +.Xr xntpd 8 (ネットワークタイムプロトコルデーモン) を実行することならば、 -.I tickadj -変数をそのための \*(L"最適な\*(R" 値に決定し、表示します。 +.Em tickadj +変数をそのための +.Qq 最適な +値に決定し、表示します。 カーネルを読み込む時の -.I tickadj +.Nm の操作は、 -.IR xntpd (8) +.Xr xntpd 8 プログラムの操作と非常に似ているため、 -.IR xntpd (8) -の問題のデバグを行うために有用です。 -.PP +.Xr xntpd 8 +の問題のデバッグを行うために有用です。 +.Pp 実行中のカーネル内の興味ある変数を変更するためにさまざまなフラグが 指定できます。 -.B -a -フラグは、 -.I tickadj +.Bl -tag -width indent +.It Fl a Ar new_tickadj +.Em tickadj の引数で与えられた変数を設定します。 -.B -A -は、同様に -.I tickadj -を変更しますが、内部的に計算された \*(L"最適な\*(R" 値に設定することが -異ります。 -.B -t -フラグは、カーネルの -.IR tick +.It Fl A +同様に +.Em tickadj +を変更しますが、内部的に計算された +.Qq 最適な +値に設定することが異ります。 +.It Fl d +デバッグ情報を付加します。 +.It Fl k +.Pa /kernel +の代りに +.Pa /dev/kmem +を使用します。これがデフォルトです。 +.It Fl p +.Nm +に +.Em noprintf +変数の値を 1 に設定させます。 +.It Fl q +.Nm +に対し、エラー以外の報告は行わないようにさせます。 +通常 +.Nm +は何を行っているかについて非常に冗長な報告を行います。 +.It Fl s +.Nm +に対し、 +.Em dosynctodr +変数の値を 0 に設定させます。 +.Xr xntpd 8 +デーモンを SunOS 4.0 で実行する時の前提条件です。 +.It Fl t Ar new_tick +カーネルの +.Em tick 値をリセットするために使われます。この機能はとても変な時計を持った 機械では有効です。 -.B -s -フラグは、プログラムに -.I dosynctodr -変数の値をゼロに設定するように伝えます。これは、 -.IR xntpd (8) -デーモンを SunOS 4.0 で実行する時の前提条件です。一般に、 -.I tickadj -は、自分が行ったことを非常に冗長に報告します。 -.B -q -フラグは、エラー以外はなにも報告しないようにします。 -.PP -異ったタイプの機械上で始めに使う時には、 -.I tickadj +.El +.Pp +異なったタイプの機械上で始めに使う時には、 +.Nm は、注意して動かさなければならないことに気を付けてください。 -.I tickadj +.Nm が行おうとする操作は、全ての UNIX マシンで動くことが保証されているわけ ではありません。 -.SH 関連ファイル -.nf -/vmunix -/unix -(訳注: FreeBSD では /kernel です) -.\"(訳注)原文には上記2つが記述されていたが、FreeBSDでは/kernel -.\" であるので、変更した。 -.\" 2.2.1R 対象(1997/04/23) Takeshi MUTOH <mutoh@info.nara-k.ac.jp> -.\" 原文の記述に戻し、訳注を追加 -.\" 2.2.2R 対象(1997/07/27) Kazuo Horikawa <horikawa@jp.freebsd.org> -/dev/kmem -.fi -.SH 関連項目 -xntpd(8) -.SH 歴史 -トロント大学の Dennis Ferguson によって書かれました。 -.SH バグ +.Sh 関連ファイル +.Bl -tag -width /dev/kmem -compact +.It Pa /kernel +.It Pa /dev/kmem +.El +.Sh 関連項目 +.Xr xntpd 8 +.Sh 歴史 +University of Toronto の +.An Dennis Ferguson +によって書かれました。 +.Sh バグ 実行時に普通の操作の一部としてカーネル変数をだますことは恐ろしい習慣です。 この恐ろしい習慣の理由は、多くのカーネルで -.IR adjtime (8) +.Xr adjtime 8 の実装が無いことおよび/もしくはベンダによってはカーネル内の システム時計が壊れていることのみです。 カーネルを修正して -.I tickadj +.Nm を捨てるならば、その方が良いです。 diff --git a/ja/man/man8/traceroute.8 b/ja/man/man8/traceroute.8 index 2f3feee717..42f7bdcb0b 100644 --- a/ja/man/man8/traceroute.8 +++ b/ja/man/man8/traceroute.8 @@ -13,7 +13,7 @@ .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED .\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. .\" -.\" %Header: /home/ncvs/src/contrib/traceroute/traceroute.8,v 1.2.2.1 1998/01/09 18:51:35 steve Exp % +.\" %Header: /home/ncvs/src/contrib/traceroute/traceroute.8,v 1.3 1998/01/09 18:46:53 steve Exp % .\" .\" jpman %Id: traceroute.8,v 1.2 1997/05/13 00:58:05 mutoh Stab % .\" diff --git a/ja/man/man8/tunefs.8 b/ja/man/man8/tunefs.8 index 150e5503aa..1d99b2b058 100644 --- a/ja/man/man8/tunefs.8 +++ b/ja/man/man8/tunefs.8 @@ -30,6 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)tunefs.8 8.2 (Berkeley) 12/11/93 +.\" %Id: tunefs.8,v 1.7 1998/08/03 06:41:20 charnier Exp % .\" jpman %Id: tunefs.8,v 1.3 1997/07/26 22:16:10 horikawa Stab % .\" .Dd December 11, 1993 @@ -47,14 +48,15 @@ .Op Fl m Ar minfree .Op Fl p .Bk -words +.Op Fl n Ar enable | disable .Op Fl o Ar optimize_preference .Ek -.Op Ar special | Ar filesys +.Op Ar special | Ar filesystem .Sh 解説 .Nm tunefs は、ファイルシステムのレイアウト方針に影響する動的なパラメータを 変更するために使います。変更するパラメータは以下のフラグで指定します: -.Bl -tag -width Ds +.Bl -tag -width indent .It Fl A ファイルシステムはスーパブロックのバックアップをいくつか持っています。 このオプションを指定すると、全てのバックアップの内容は @@ -95,6 +97,9 @@ もしこの値を現在の空き領域より大きな値に引き上げると、 ファイルを削除してその値を満たすだけの空き領域を用意するまで、 ユーザはファイルを作成することができなくなります。 +.It Fl n Ar enable | disable +ソフトアップデートをオン/オフします。 +ファイルシステムのアンマウントが必要です。 .It Fl o Ar optimize_preference ファイルシステムの最適化において、 ブロック割り当てにかかる時間を最小化するか、 diff --git a/ja/man/man8/tzsetup.8 b/ja/man/man8/tzsetup.8 index 9b922bc6bf..ff6a0bbadb 100644 --- a/ja/man/man8/tzsetup.8 +++ b/ja/man/man8/tzsetup.8 @@ -22,7 +22,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: tzsetup.8,v 1.3.2.3 1998/03/09 14:46:17 jkh Exp % +.\" %Id: tzsetup.8,v 1.8 1997/10/27 07:49:45 charnier Exp % .\" jpman %Id: tzsetup.8,v 1.3 1997/07/22 17:04:38 horikawa Stab % .Dd January 1996 diff --git a/ja/man/man8/umount.8 b/ja/man/man8/umount.8 index c83adfdf47..6468245af4 100644 --- a/ja/man/man8/umount.8 +++ b/ja/man/man8/umount.8 @@ -29,7 +29,8 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" @(#)umount.8 8.1 (Berkeley) 2/20/94 +.\" @(#)umount.8 8.2 (Berkeley) 5/8/95 +.\" %Id: umount.8,v 1.5 1998/08/03 06:44:46 charnier Exp % .\" jpman %Id: umount.8,v 1.3 1997/07/22 17:06:06 horikawa Stab % .\" .Dd February 20, 1994 @@ -41,14 +42,14 @@ .Sh 書式 .Nm umount .Op Fl fv -.Ar special | node +.Ar special \&| node .Nm umount -.Fl a +.Fl a | A .Op Fl fv .Op Fl h Ar host -.Op Fl t Ar ufs | lfs | external_type +.Op Fl t Ar type .Sh 解説 -.Nm umount +.Nm コマンドは、 .Ar "スペシャルデバイス (special device)" もしくはリモートのノード (rhost:path) をファイルシステムツリーの @@ -68,6 +69,9 @@ .It Fl a .Xr fstab 5 に記述されている全てのファイルシステムをアンマウントします。 +.It Fl A +ルート以外で現在マウントされているファイルシステムをすべて +アンマウントします。 .It Fl f ファイルシステムを強制的にアンマウントします。 利用されているスペシャルデバイスは使い続けようとしますが、 @@ -77,12 +81,14 @@ 指定されたホストからマウントしているファイルシステムだけをアンマウント します。 このオプションは -.Fl a +.Fl A オプションを暗黙に指定し、 .Fl t -オプションで他のものを指定しなければ、NFS ファイルシステムだけを +オプションで他のものを指定しなければ、 +.Tn NFS +ファイルシステムだけを アンマウントします。 -.It Fl t Ar "ufs \\*(Ba lfs \\*(Ba external type" +.It Fl t Ar type 指定されたタイプのファイルシステムだけを扱うように指示します。 1 つ以上のタイプは、コンマ (``,'') で分けたリストで指定します。 ファイルシステム形式のリストは、 @@ -91,7 +97,7 @@ を付けることで、その動作をそのファイルシステムに付いては行わない様に 指定することもできます。 例えば、 -.Nm umount +.Nm コマンド .Bd -literal -offset indent umount -a -t nfs,mfs @@ -139,7 +145,7 @@ umount '<above>/tmpdir' .Ar /cdrom からアンマウントされます。 .Sh 歴史 -.Nm umount +.Nm コマンドは .At v6 から導入されました。 diff --git a/ja/man/man8/uuchk.8 b/ja/man/man8/uuchk.8 index 86f24d1934..4dd88374c3 100644 --- a/ja/man/man8/uuchk.8 +++ b/ja/man/man8/uuchk.8 @@ -1,4 +1,4 @@ -''' %Id: uuchk.8,v 1.1.2.1 1998/03/09 11:13:33 jkh Exp % +''' %Id: uuchk.8,v 1.2 1998/03/09 11:13:17 jkh Exp % .TH uuchk 1 "Taylor UUCP 1.06" .SH 名称 uuchk \- UUCP の設定から得た情報を表示する diff --git a/ja/man/man8/uucico.8 b/ja/man/man8/uucico.8 index af53f98902..fa4fdaf5e4 100644 --- a/ja/man/man8/uucico.8 +++ b/ja/man/man8/uucico.8 @@ -1,4 +1,4 @@ -''' %Id: uucico.8,v 1.5 1995/08/19 21:29:57 ache Exp % +''' %Id: uucico.8,v 1.7 1997/02/22 15:28:33 peter Exp % .\" jpman %Id: uucico.8,v 1.3 1997/09/07 14:14:55 horikawa Stab % .TH uucico 8 "Taylor UUCP 1.06" .SH 名称 diff --git a/ja/man/man8/uucpd.8 b/ja/man/man8/uucpd.8 index f3df3ad855..ef1a2f24d3 100644 --- a/ja/man/man8/uucpd.8 +++ b/ja/man/man8/uucpd.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)rshd.8 8.1 (Berkeley) 6/4/93 -.\" %Id: uucpd.8,v 1.2.2.2 1998/03/06 01:48:36 jkh Exp % +.\" %Id: uucpd.8,v 1.6 1997/12/04 07:20:42 charnier Exp % .\" .\" jpman %Id: uucpd.8,v 1.3 1997/09/04 16:43:12 horikawa Stab % .Dd Feb 18, 1996 diff --git a/ja/man/man8/uuxqt.8 b/ja/man/man8/uuxqt.8 index 4711998b7a..5e11a1ff04 100644 --- a/ja/man/man8/uuxqt.8 +++ b/ja/man/man8/uuxqt.8 @@ -1,4 +1,4 @@ -''' %Id: uuxqt.8,v 1.4 1995/08/19 21:30:28 ache Exp % +''' %Id: uuxqt.8,v 1.6 1997/02/22 15:28:58 peter Exp % .\" jpman %Id: uuxqt.8,v 1.2 1997/03/31 15:01:29 horikawa Stab % .TH uuxqt 8 "Taylor UUCP 1.05" .SH 名称 diff --git a/ja/man/man8/vmstat.8 b/ja/man/man8/vmstat.8 index ec0381e9c8..b124a09b98 100644 --- a/ja/man/man8/vmstat.8 +++ b/ja/man/man8/vmstat.8 @@ -30,6 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)vmstat.8 8.1 (Berkeley) 6/6/93 +.\" %Id: vmstat.8,v 1.9 1997/08/25 06:40:05 charnier Exp % .\" jpman %Id: vmstat.8,v 1.2 1997/05/29 07:57:00 yugawa Stab % .\" .Dd June 6, 1996 @@ -186,10 +187,11 @@ CPU アイドル時間 .Sh 使用例 コマンド: .Dl vmstat -w 5 -は、5 秒おきにシステムの統計を表示します。これは、システム内の統計を取るのに -ちょうどよい間隔です。 -他の値では秒単位の値にバラツキがあり、しばらく出力を継続すると -1 秒毎に計算しなおしていることがわかるでしょう。 +は、システムがどのように動作しているかを 5 秒おきに表示します。 +5 秒おきにサンプリングされている統計情報があるため、 +この間隔で表示するのがちょうどよいです。 +その他の統計情報は 1 秒毎に変化します。 +しばらく出力を続ければ、どれが毎秒計算し直されているかがわかるでしょう。 .Sh 関連ファイル .Bl -tag -width /dev/kmemxxx -compact .It Pa /kernel diff --git a/ja/man/man8/vnconfig.8 b/ja/man/man8/vnconfig.8 index b2b1b244bc..f7b1990967 100644 --- a/ja/man/man8/vnconfig.8 +++ b/ja/man/man8/vnconfig.8 @@ -99,14 +99,33 @@ を設定ファイルの代りに使用します。 .It Fl g global オプションを制御します。 -.It Fl r Ar option -.Ar option +.It Fl r Ar flag +.Ar flag をリセットします。 -.Ar option -は labels, follow, debug, io, all, none のいずれかです。 -.It Fl s Ar option -.Ar option +利用可能なフラグと意味は以下の通りです: +.Bl -tag -width "follow" +.It Ar labels +ディスク/スライスラベルを使用する。 +.It Ar follow +.Xr vn 4 +ドライバのフローをデバッグする。 +.It Ar debug +.Xr vn 4 +ドライバのデータをデバッグする。 +.It Ar io +.Xr vn 4 +ドライバの I/O をデバッグする。 +.It Ar all +すべてのフラグをオンにする。 +.It Ar none +すべてのフラグをオフにする。 +.El +.It Fl s Ar flag +.Ar flag をセットします。 +利用可能なフラグと意味は +.Fl r +と同じです。 .It Fl u デバイスを無効にし、``無構築状態'' にします。 .It Fl v diff --git a/ja/man/man8/wormcontrol.8 b/ja/man/man8/wormcontrol.8 index 1b1010bf90..f319eabcc9 100644 --- a/ja/man/man8/wormcontrol.8 +++ b/ja/man/man8/wormcontrol.8 @@ -32,7 +32,7 @@ .\" USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH .\" DAMAGE. .\" -.\" %Id: wormcontrol.8,v 1.3.2.3 1997/11/18 07:28:14 charnier Exp % +.\" %Id: wormcontrol.8,v 1.11 1998/03/23 08:30:03 charnier Exp % .\" jpman %Id: wormcontrol.8,v 1.3 1997/08/16 13:45:04 horikawa Stab % .\" .\" arrgh, hilit19 needs this" :-( @@ -70,10 +70,6 @@ CD-R デバイスは大変厳密な処理手順を要求します。 データトラックになるのかをドライブに教えてやる必要があります。 音声トラックはブロックサイズ 2352 バイトで書き込まれますが、 データトラックはブロックあたり 2048 バイトです。 -実際に利用できるデータフォーマットは他にもありますが、 -このドライバが現在のところサポートしているのは、この -.Em Yellow Book -モード 1 フォーマットだけです。 音声トラックについては、ドライバは更に、 データをプリエンファシス付きで書き込むかどうかについても 知る必要があります。 @@ -92,39 +88,6 @@ CD-R デバイスは大変厳密な処理手順を要求します。 ではなく .Ar device を使用します。 -.It select Ar vendor-id model-id -残念なことに、各 CD-R ドライブベンダは独自の SCSI コマンドセットを -実装することになってしまいました。従って -.Xr worm 4 -ドライバは、ある特定のデバイスのためにどの -.Ql quirk -ファンクションを使うのか知る必要があります。 -現在のところ、ドライバ内に quirk 情報がスタティックにコンパイルされている -デバイスのみ動作します。 -しかし将来的には、これらをローダブル・モジュールとして -利用できるようにする予定です。 -.Em select -コマンドは、適切な quirk を見つけるようドライバに指示します。 -ドライバは指定された -.Ar vendor-id -および -.Ar model-id -を既知の quirk リストと照合します。 -一致するものがなければエラーが返され、 -そのデバイスは quirk レコードが正しく選択されるまで -他の処理に利用できなくなります。 -.Pp -現在までに、ベンダ/モデル名として -.Dq PLASMON -\&/ -.Dq RF4100 , -.Dq PHILIPS -\&/ -.Dq CDD2000 , -.Dq HP -\&/ -.Dq 4020i -が知られています。 .It prepdisk Ar single \&| double Op Ar dummy ディスクの書き込み準備を行います。 この処理はトラック準備の前に行い、 @@ -187,7 +150,6 @@ CD-R デバイスは大変厳密な処理手順を要求します。 .Sh 使用例 データ CD-R を焼く典型的な手順はこのようになります: .Bd -literal -# wormcontrol select PLASMON RF4100 # wormcontrol prepdisk double # wormcontrol track data # rtprio 5 team -v 1m 5 < cdrom.image | rtprio 5 dd of=/dev/rworm0 obs=20k diff --git a/ja/man/man8/xntpd.8 b/ja/man/man8/xntpd.8 index f418f96152..b0d4bdd3bb 100644 --- a/ja/man/man8/xntpd.8 +++ b/ja/man/man8/xntpd.8 @@ -1,759 +1,690 @@ -.\" jpman %Id: xntpd.8,v 1.2 1997/09/16 18:16:37 ken Stab % -''' $Header -''' -.de Sh -.br -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp -.if t .sp .5v -.if n .sp -.. -.de Ip -.br -.ie \\n.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -''' -''' Set up \*(-- to give an unbreakable dash; -''' string Tr holds user defined translation string. -''' Greek uppercase omega is used as a dummy character. -''' -.tr \(*W-|\(bv\*(Tr -.ie n \{\ -.ds -- \(*W- -.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -.ds L" "" -.ds R" "" -.ds L' ' -.ds R' ' -'br\} -.el\{\ -.ds -- \(em\| -.tr \*(Tr -.ds L" `` -.ds R" '' -.ds L' ` -.ds R' ' -'br\} -.TH XNTPD 8 LOCAL -.SH 名称 -xntpd - Network Time Protocol デーモン -.SH 書式 -.B xntpd -[ -.B -abdm -] [ -.B -c -.I conffile -] [ -.B -e -.I authdelay -] [ -.B -f -.I driftfile -] [ -.B -k -.I keyfile -] [ -.B -p -.I pidfile -] [ -.B -r -.I broadcastdelay -] [ -.B -s -.I statsdir -] [ -.B -t -.I trustedkey -] [ -.B -v -.I variable -] [ -.B -V -.I variable -] -.SH 解説 -.I xntpd +.\" +.\" %Id: xntpd.8,v 1.5 1998/02/19 08:05:43 charnier Exp % +.\" +.Dd December 21, 1993 +.Dt XNTPD 8 +.Os +.Sh 名称 +.Nm xntpd +.Nd Network Time Protocol デーモン +.Sh 書式 +.Nm xntpd +.Op Fl abdm +.Op Fl c Ar conffile +.Op Fl e Ar authdelay +.Op Fl f Ar driftfile +.Op Fl k Ar keyfile +.Op Fl p Ar pidfile +.Op Fl r Ar broadcastdelay +.Op Fl s Ar statsdir +.Op Fl t Ar trustedkey +.Op Fl v Ar variable +.Op Fl V Ar variable +.Sh 解説 +.Nm は、インターネットの標準時間サーバに合わせて、 Unix のシステム時刻 (time\-of\-day) を設定し維持するデーモンです。 -.I xntpd +.Nm は、RFC 1305 で定義されている Network Time Protocol (NTP) バージョン 3 標準の完全な実装となっていますが、各々 RFC 1059 と RFC 1119 で定義 されているバージョン 1 とバージョン 2 に対する互換性も保っています。 -.I xntpd -は全ての計算を固定少数点演算により行うので、浮動少数点を扱うコードは -必要としません。プロトコルおよび時間調整のコードで行われる計算は、高 -精度で実行されます。また、最も正確な外部時計の供給源に対しても同期で -きるだけの精度の維持を計るべく、計算に規則だった補正値を導入するといっ -たように、細部まで注意が払われています。 -.PP +.Nm +は全ての計算を固定小数点演算により行うので、浮動小数点を扱うコードは +必要としません。プロトコルおよび時間調整のコードで行われる計算は、 +高精度で実行されます。また、最も正確な外部時計の供給源に対しても同期 +できるだけの精度の維持を計るべく、計算に規則だった補正値を導入すると +いったように、細部まで注意が払われています。 +.Pp 通常、 -.I xntpd +.Nm は、起動時に設定ファイルから設定を読込みます。 デフォルトの設定ファイル名は、 -.IR /etc/ntp.conf +.Pa /etc/ntp.conf ですが、コマンドラインの指定の方が優先します。また、もっぱらコマンド ラインだけで、その局面に役立つ -.I xntpd -の設定を与え、設定ファイルを不要にすることもで -きます。これは、 -.I xntpd +.Nm +の設定を与え、設定ファイルを不要にすることもできます。これは、 +.Nm が、実行時にブロードキャストを待受ける (listen) ことで決定される全て -の通信相手 (peer) に対して、ブロードキャストもしくはマルチキャスト・ +の通信相手 (peer) に対して、ブロードキャストもしくはマルチキャスト クライアントとして設定されるべき時には、特に適しています。 -.I xntpd +.Nm デーモンの実行中は、 -.IR ntpq (8) +.Xr ntpq 8 および -.IR xntpdc (8) +.Xr xntpdc 8 を使用することで、デーモンのさまざまな内部変数を表示したり 設定オプションを変更できます。 -.PP -デーモンはアクティブ/パッシブ, クライアント/サーバ, ブロードキャスト +.Pp +デーモンは対称アクティブ/パッシブ、クライアント/サーバ、ブロードキャスト /マルチキャスト等の対称的なモードを含むいずれかのモードで働くことが -できます。ブロードキャストもしくはマルチキャスト・クライアントは、 +できます。ブロードキャストもしくはマルチキャストクライアントは、 自動的にリモートサーバを探し出し、片道の遅延補正因子を計算して、自動的 に自身に対する設定を行います。これにより、その環境に固有の詳細な設定 や設定ファイルなしに、一群のワークステーションを 配置することが可能になります。 -.PP +.Pp 以下にあげるコマンドライン引数が -.I xntpd +.Nm により理解されます。(より完全な機能の説明については、 設定ファイルの説明を参照のこと): - -.Ip -a 8 -「認証」 (\*(L"authenticate\*(R") モードで実行します。 -.Ip -b 8 +.Bl -tag -width indent +.It Fl a +.Qq 認証 (authenticate) +モードで実行します。 +.It Fl b NTP のブロードキャストを待受けて、可能ならそれに同期します。 -.Ip -c 8 +.It Fl c デフォルトの代わりの設定ファイルを指定します。 -.Ip -d 8 +.It Fl d デバッグモードを指定します。このフラグは何回指定してもかまいませんが、 回数が多いほど表示がより詳細になります。 -.Ip -e 8 +.It Fl e このコンピュータ上で、NTP の暗号化 (encryption) フィールドを計算する のに必要な時間を (秒で) 指定します。 -.Ip "-f driftfile" 8 +.It Fl f Ar driftfile driftfile のある場所を指定します。 -.Ip -k 8 +.It Fl k NTP の認証キーを含むファイルのある場所を指定します。 -.Ip -m 8 +.It Fl m マルチキャストメッセージを待受けて、可能ならそれらに同期します ( マルチキャストカーネルが必要になります)。 -.Ip -p 8 +.It Fl p デーモンのプロセス ID を記録するためのファイル名を指定します。 -.Ip -r 8 +.It Fl r 通常、デーモンは、ブロードキャストもしくはマルチキャストのサーバと クライアントとの間のネットワーク遅延を自動的に補正します。 遅延の測定作業が失敗した場合には、ここで指定した (秒の) デフォルトの 遅延を使用するようになります。 -.Ip -s 8 +.It Fl s 統計ファイルを作成するためのディレクトリを指定します。 -.Ip "-t trustedkey" 8 +.It Fl t Ar trustedkey キー番号を信頼できるキー (trusted key) のリストに付け加えます。 -.Ip -v 8 +.It Fl v システム変数を追加します。 -.Ip -V 8 +.It Fl V デフォルトでリストされるシステム変数を追加します。 - -.SH "コンフィギュレーションオプション" -.I xntpd +.El +.Sh "コンフィギュレーションオプション" +.Nm の設定ファイルのフォーマットは、 他の Unix 設定ファイルのものに似ています。 -コメントは文字 \*(L"#\*(R" で始まり、行末まで続きます。空行は無視されます。 -設定コマンドは、行頭のキーワードとそれに続く空白で区切られた -引数のリストからなります。引数の内いくつかは、省略可能な場合があります。 +コメントは文字 +.Qq # +で始まり、行末まで続きます。空行は無視されます。 +設定コマンドは、行頭のキーワードとそれに続く引数のリストからなります。 +引数の内いくつかは、省略可能な場合があります。 +また、引数は空白で区切ります。 これらのコマンドは複数行にわたってはなりません。 -引数は、ホスト名, ドットで区切られた 4 つ組の数からなる (dotted-quad) 形式の -ホストアドレス, 整数, 浮動少数点数 (秒で時間を指定する際用います), +引数は、ホスト名、ドットで区切られた 4 つ組の数からなる (dotted-quad) 形式の +ホストアドレス、整数、浮動小数点数 (秒で時間を指定する際用います)、 テキスト文字列などです。 -以下の説明では、省略可能な引数は、\*(L"[]\*(R" で囲み、 -複数択一の引数は、互いに \*(L"|\*(R" で区切って表します。 -.PP -.B peer -.I host_address -[ -.B key -.I # -] [ -.B version -.I # -] [ -.B prefer -] -.br -.B server -.I host_address -[ -.B key -.I # -] [ -.B version -.I # -] [ -.B prefer -] -.br -.B broadcast -.I host_address -[ -.B key -.I # -] [ -.B version -.I # -] [ -.B ttl -.I # -] -.PP -これらの 3つのコマンドは、利用されるべき時間サーバや与えられるべき +以下の説明では、省略可能な引数は、 +.Qq [] +で囲み、複数択一の引数は、互いに +.Qq | +区切って表します。 +.Pp +.Bl -tag -width indent +.It Xo peer +.Ar host_address +.Op key Ar # +.Op version Ar # +.Op prefer +.Xc +.It Xo server +.Ar host_address +.Op key Ar # +.Op version Ar # +.Op prefer +.Xc +.It Xo broadcast +.Ar host_address +.Op key Ar # +.Op version Ar # +.Op ttl Ar # +.Xc +.Pp +これらの 3 つのコマンドは、利用されるべき時間サーバや与えられるべき 時間サービスを指定します。 -.B peer +.Em peer コマンドは、ローカルサーバが、コマンド中の -.I host_address -で示されるリモートサーバに対し、「対称的アクティブ」 (\*(L"symmetric -active\*(R") モードで動作するよう指示します。このモードでは、 +.Ar host_address +で示されるリモートサーバに対し、 +.Qq 対称的アクティブ (symmetric active) +モードで動作するよう指示します。このモードでは、 ローカルサーバをリモートサーバに同期させるのと同時に、リモートサーバ をローカルサーバに同期させることができます。これは、サーバの ネットワークにおいて、さまざまな悪い状況により、 ローカルサーバとリモートサーバのどちらかがより良い時刻供給源と なり得るような場合に役立ちます。 -.B server -コマンドは、ローカルサーバが、指定したリモートサーバに -対して \*(L"クライアント\*(R" モードで動作するよう指示します。 +.Em server +コマンドは、ローカルサーバが、指定したリモートサーバに対して +.Qq クライアント +モードで動作するよう指示します。 このモードでは、ローカルサーバはリモートサーバに同期しますが、 リモートサーバがローカルサーバに同期することは決してありません。 -.B broadcast -コマンドは、ローカルサーバが、\*(L"ブロードキャスト\*(R" モードで -動作するよう指示します。ローカルサーバは、コマンド中で指定される -ブロードキャスト/マルチキャスト/アドレスを持つクライアント集団に、 +.Em broadcast +コマンドは、ローカルサーバが、 +.Qq ブロードキャスト +モードで動作するよう指示します。ローカルサーバは、コマンド中で指定される +ブロードキャスト/マルチキャストアドレスを持つクライアント集団に、 定期的にブロードキャストメッセージを送ります。通常、この指示は、 送信側 (transmitter) として動作しているローカルサーバにのみ適用されます。 ブロードキャストクライアントに対する動作については、以下に説明する -.B broadcastclient +.Em broadcastclient もしくは -.B multicastclient +.Em multicastclient コマンドの項を参照して下さい。このモードでは、 -.I host_address +.Ar host_address は、通常、そのローカルネットワーク (もしくは複数の ローカルネットワークの内のひとつ)の上でのブロードキャストアドレスであるか、 -NTP に割当てられたマルチキャストアドレスです。NTPには、アドレス 224.0.1.1 が -割当てられてきました。現在のところは、このアドレスのみを使用すべきです。 +NTP に割り当てられたマルチキャストアドレスです。NTPには、アドレス 224.0.1.1 が +割り当てられてきました。現在のところは、このアドレスのみを使用すべきです。 マルチキャスト機能はマルチキャストカーネルを必要としますが、これは、 まだ、どのベンダの製品にでも存在するものではないということに注意し て下さい。 -.PP -.B key +.Pp +.Ar key オプションが含まれていると、そのアドレスに送られる全てのパケットが、 -指定したキー (32 ビット符号無し整数の範囲の数) を用いて暗号化された +指定したキー番号 (32 ビット符号無し整数の範囲の数) を用いて暗号化された 認証フィールドを含むようになります。 -.B version +.Ar version オプションにより、送出される NTP パケットに使用されるべきバージョン 番号を指定することができます。バージョン 1, 2, 3 のいずれかが選択で きますが、バージョン 3 がデフォルトになっています。 -.B prefer +.Ar prefer オプションは、そのホストを優先的ホストとします。このホストは、その他 全ての点では同等ですが、正常に動作している一群のホストの中から同期を 取る対象として選ばれます。 -.B ttl +.Ar ttl オプションは、ブロードキャストモードでのみ使用され、マルチキャスト パケットで用いられる生存時間 (TTL) を指定します。デフォルトは 127 ですが、 適切な値を選択することは、黒魔術の一種であり、ネットワーク管理者 との調整を必要とします。 -.PP -.B broadcastclient -.PP +.It broadcastclient ローカルサーバに対し、同じサブネット上の他のサーバを見付けるために、 ローカルネットワーク上のブロードキャストメッセージを待受けるよう指示 します。ローカルサーバは、最初のブロードキャストメッセージを受取る際、 リモートサーバとクライアント/サーバ間の短いやりとりを用いて、名目上 の (nominal) ネットワーク遅延を測定してから、後続のブロードキャスト -メッセージを待ち受けて、それに同期する\*(L"ブロードキャストクライアント\*(R" +メッセージを待ち受けて、それに同期する +.Qq ブロードキャストクライアント モードに入ります。このモードでの偶然もしくは故意の分裂状態 を避けるため、ローカルとリモートのサーバの両方は認証に同一の信頼でき るキーとキー識別子を使用して動作しなくてはならないことに注意して下さい。 -.PP -.B multicastclient -[ -.I IP address ... -] -.PP +.It multicastclient Op Ar IP address ... このコマンドは、 -.IR broadcastclient +.Em broadcastclient コマンドと同じように用いられますが、IP マルチキャストを使用して動作 します。この機能をサポートするには、マルチキャストカーネルと認証の使用が 必要です。1 つ以上の IP アドレスが与えられると、サーバはそれぞれ のマルチキャストグループに加わります。1 つも与えられなければ、NTP に -は IP アドレス (224.0.1.1) が割当てられていると想定されます。 -.PP -.B driftfile -.I filename -.PP +割り当てられている IP アドレス (224.0.1.1) が想定されます。 +.It driftfile Ar filename このコマンドは、ローカルの時計発振子の周波数オフセットを記録するため のファイル名を指定します。このファイルが存在すると、起動時に初期周波数 -オフセットを指定するのに使用され、その後デーモンにより計算される -カレント周波数オフセットで、 1 時間に 1 度更新されます。ファイルが存在 +オフセットを指定するのに使用され、その後 1 時間に 1 度 +その時点での周波数オフセットがデーモンにより計算されて更新されます。 +ファイルが存在 しないか、このコマンドが与えられていない場合、初期周波数オフセットは -ゼロと仮定されます。この場合、周波数が安定し、残った時間誤差が収まる -のに数時間かかります。このファイルが、最初にカレント変動値を一時 -ファイルに書込み、 -.IR rename (3) +0 と仮定されます。この場合、周波数が安定し、残った時間誤差が収まる +のに数時間かかります。 +ファイルには、 +100 万分の 1 (ppm) 単位でのオフセット値を表す浮動小数点数が 1 つ含まれます。 +このファイルが、最初にカレント変動値を一時ファイルに書込み、 +.Xr rename 3 により古いファイルと置換えることで更新されることに注意して下さい。これは、 -.I xntpd -が、 ドリフトファイルのあるディレクトリに対し書込み権を持っていなけ -ればならず、ファイルは、シンボリックであろうとなかろうと、 +.Nm +が、ドリフトファイルのあるディレクトリに対し書き込み権を持っている必要があり、 +ファイルは、シンボリックであろうとなかろうと、 ファイルシステムリンクであるべきではないだろうことを意味しています。 -.PP -.B enable auth|bclient|pll|monitor|stats -[ -.I ... -] -.PP +.It enable Ar auth|bclient|pll|monitor|stats Op Ar ... さまざまなサーバオプションを有効にします。指定されていないフラグは -影響を受けません。\*(L"auth\*(R" フラグは、その通信相手 (peer) が信頼 +影響を受けません。 +.Ar auth +フラグは、その通信相手 (peer) が信頼 できるキーとキー識別子を使用して正しく認証されている場合に限って、サーバが -指定されていない相手に同期するようにします。このフラグのデフォルトは -無効 (オフ) です。 \*(L"bclient\*(R" フラグは、サーバがブロード -キャストもしくはマルチキャストサーバからのメッセージを待受けるように -します。これにより、そのサーバに対する連携 (association) が自動的に -成立します。このフラグのデフォルトは無効 (オフ) です。 \*(L"pll\*(R" +未設定の相手に同期するようにします。このフラグのデフォルトは +無効 (オフ) です。 +.Ar bclient +フラグは、サーバがブロードキャストもしくはマルチキャストサーバからの +メッセージを待ち受けるようにします。これにより、 +そのサーバに対する連携 (association) が自動的に成立します。 +このフラグのデフォルトは無効 (オフ) です。 +.Ar pll フラグは、サーバのローカル時計を調整するようにします。デフォルトでは -有効 (オン) です。無効にした場合、ローカル時計は固有の時間と周波数の +有効 (オン) です。無効にした場合、ローカル時計は固有の時間と周波数オプセットの まま動きます。このフラグは、ローカル時計が他の何らかのデバイスや プロトコルにより制御されており、NTPは他のクライアントと同期をとるためだ -けに使用されている場合に、役立ちます。\*(L"monitor\*(R" フラグは、 -モニタファシリティ (facility) を有効にします(下記参照のこと)。デフォルトでは -有効 (オン) です。\*(L"stats\*(R" フラグは、統計のファシリティ +けに使用されている場合に、役立ちます。 +.Ar monitor +フラグは、モニタファシリティ (facility) を有効にします(下記参照のこと)。 +デフォルトでは有効 (オン) です。 +.Ar stats +フラグは、統計のファシリティ の filegen (下記説明を参照のこと) を有効にします。デフォルトでは有効 (オン) です。 -.PP -.B disable auth|bclient|pll|monitor|stats -[ -.I ... -] -.PP +.It disable Ar auth|bclient|pll|monitor|stats Op Ar ... さまざまなサーバオプションを無効にします。指定されていないフラグは影響を 受けません。現在使用可能なオプションは、enable コマンドの項で説明 しています。 - -.SH "認証オプション" -.PP -.B keys -.I filename -.PP +.El +.Sh "認証オプション" +.Bl -tag -width indent +.It keys Ar filename このコマンドは、認証モードでの操作の際、 -.I xntpd +.Nm により使用される暗号化キーとキー識別子を含むファイルの名前を指定します。 このファイルのフォーマットは以降で説明します。 -.PP -.B trustedkey -.I # -[ -.I "# ..." -] -.PP -このコマンドは、同期するのにふさわしい通信相手を認証する目的にとって -信用できる暗号化キー識別子を指定するのに使用されます。異なるサーバは -異なるキーを使用できますが、認証手続きにはローカルとリモート両方の -サーバがこの目的のため同一のキーとキー識別子を共有することが必要です。 +.It trustedkey Ar # Op Ar # ... +このコマンドは、同期するのにふさわしい通信相手を認証する目的において、 +信用できる暗号化キー識別子を指定するのに使用されます。 +この目的で、ローカルとリモート両方の +サーバが同一のキーとキー識別子を共有することを、認証手続きは求めます。 +異なるサーバ間では異なるキーを使用できます。 引数は、32 ビット符合なし整数ですが、 NTP キー 0 は固定されており周知の ものであることに注意してください。意味のある認証が行われるべきならば、 キー 0 は信用すべきではありません。 -.PP -.B requestkey -.I # -.PP +.It requestkey Ar # このコマンドは、 -.IR xntpd (8) +.Nm の動作に影響を与える問題の診断と修復に役立つ -.IR xntpdc (8) +.Xr xntpdc 8 プログラムにより使用されるキー識別子を指定します。 -.I xntpdc -プログラムの動作は、 xntpd のこの固有の実装に特定されており、これ +.Nm xntpdc +プログラムの動作は、 +.Nm +のこの固有の実装に特定されており、このバージョン および以前のバージョンのデーモンとのみ動作すると見込まれます。ローカル サーバの状態に影響を与えるリモートの -.I xntpdc +.Nm xntpdc プログラムからの要求は、 認証されねばなりません。そのためには、リモートプログラムとローカル サーバが共通のキーとキー識別子を共有することが必要です。このコマンドの引数は、 32 ビット符合なし整数です。設定ファイルに -.B controlkey +.Em controlkey コマンドが含まれていないか、キーがマッチしないと、この要求は無視され ます。 -.PP -.B controlkey -.I # -.PP +.It controlkey Ar # このコマンドは、 -.IR xntpd (8) +.Nm の動作に影響を与える問題の診断と修復に役立つ -.IR ntpq (8) +.Xr ntpq 8 プログラムにより使用されるキー識別子を指定します。 -.IR ntpq +.Nm xntpq プログラムと -.I xntpd +.Nm の動作は RFC 1305 の定義を満たしています。ローカルサーバの状態に影響 を与えるリモートの -.I ntpq +.Nm ntpq プログラムからの要求は、認証されねばなりません。そのためには、リモート プログラムとローカルサーバが共通のキーとキー識別子を共有することが 必要です。このコマンドの引数は、32 ビット符合なし整数です。 設定ファイルに -.B requestkey +.Em requestkey コマンドが含まれていないか、キーがマッチしないと、この要求は無視され ます。 -.PP -.B authdelay -.I seconds -.PP +.It authdelay Ar seconds ローカル計算機上で NTP 認証フィールドを暗号化するのに要する時間の 総計を示します。この値は、送出パケットに認証が用いられる際、送信タイム スタンプを修正するのに使用されます。通常、この値は 0.0001 秒から -0.003 秒あたりになりますが、これはホスト計算機の CPU 速度に依存して +0.003 秒あたりになりますが、これはまさにホスト計算機の CPU 速度に依存して います。通常、この値は、ディストリビューションに含まれている -.I authspeed +.Em authspeed プログラムを用いて計算されます。 -.SH "アクセス制御オプション" -.B restrict -.I address -[ -.B mask -.I numeric_mask -] [ -.I flag -] [ -.I ... -] -.PP -.I xntpd +.El +.Sh "アクセス制御オプション" +.Bl -tag -width indent +.It Xo restrict +.Ar address +.Op mask Ar numeric_mask +.Op Ar flag +.Op Ar ... +.Xc +.Nm は、汎用のアドレスとマスクに基づく制限リストを実装しています。リスト はアドレスにより、そしてマスクによりソートされ、その順番でマッチして いるかどうか調べられます。ここで、最後にマッチしたものが受信パケット に関する制限フラグを定義します。受信パケットのソースアドレスは、制限 -リストのエントリに関するマスクでアンドをとられた 32 ビットアドレスと +リストエントリのマスクでアンドをとられた 32 ビットアドレスと マッチするか調べられ、それからエントリアドレス (これもまたマスクと アンドをとられます) と比較され、マッチするものを探します。引数 -\*(L"mask\*(R" のデフォルトは 255.255.255.255 で、\*(L"address\*(R" +.Em mask +のデフォルトは 255.255.255.255 で、 +.Em address が個別のホストのアドレスとして扱われることを意味します。デフォルト エントリ (address 0.0.0.0, mask 0.0.0.0) は常にリストに含まれ、既定の ソートアルゴリズムでは、リストの先頭のエントリとなります。 -\*(L"address\*(R" は、通常、 dotted\-quad 形式で与えられ、 mask -オプションを伴わないテキスト文字列 \*(L"default\*(R" は、デフォルト -エントリを示すために使用できることに、注意して下さい。 -.PP +.Em address +は、通常ドット付き 4 つ組形式で与えられますが、mask +オプションを伴わないテキスト文字列 +.Em default +は、デフォルトエントリを示すために使用できることに、注意して下さい。 +.Pp 現在の実装では、フラグは常にアクセスを制限します。すなわち、フラグを 持たないエントリは、サーバへの自由なアクセスが与えられることを示す ことになります。フラグは直交的ではなく、より制限の強いフラグは、より 制限の弱いフラグを冗長にします。フラグは、一般に 2 つのカテゴリに分類 されます。時間サービスを制限するものと、情報問い合わせやサーバの -実行時再設定の試みを制限するものです。次のフラグの内1つ以上を指定する +実行時再設定の試みを制限するものです。次のフラグの内、1 つ以上を指定する ことができます: -.Ip ignore 10 +.Bl -tag -width indent +.It ignore このエントリにマッチするホストからのすべてのパケットを無視します。 このフラグが指定されると、問い合わせも時間サーバへのポーリングも応答さ れなくなります。 -.Ip noquery 10 -NTP の モード 6 と 7のすべてのパケット (つまり情報問い合わせと設定要求) +.It noquery +NTP の モード 6 と 7 のすべてのパケット (つまり情報問い合わせと設定要求) を無視します。時間サービスは影響を受けません。 -.Ip nomodify 10 -サーバの状態を変えようとするモード 6 と 7のすべてのパケット (つまり +.It nomodify +サーバの状態を変えようとするモード 6 と 7 のすべてのパケット (つまり 実行時再設定) を無視します。情報を返す問い合わせは許されます。 -.Ip notrap 10 +.It notrap マッチしたホストにモード 6 の制御メッセージのトラップサービスを提供 することを拒否します。トラップサービスは、モード 6 の制御メッセージ プロトコルのサブシステムで、リモートのイベントロギングプログラムによ る使用が意図されています。 -.Ip lowpriotrap 10 +.It lowpriotrap マッチしたホストによるトラップセットを低い優先度として宣言します。1 つのサーバが保持し得るトラップの数は制限されています(現在の制限値は 3 です)。トラップは通常、先入れ先処理ベースで割当てられ、後から来た -トラップ要求はサービスを拒否されます。このフラグは、通常優先度の -トラップに対する後からの要求が、低い優先度のトラップより優先されることを -許すことで、通常の割当てアルゴリズムを変更します。 -.Ip noserve 10 +トラップ要求はサービスを拒否されます。 +このフラグは割り当てアルゴリズムを変更し、 +後から到着する要求のための通常優先度のトラップを +低い優先度のトラップより優先させます。 +.It noserve モード 6 と 7 以外のすべての NTP パケットを無視します。基本的には、 時間サービスは拒否されますが、それでも問い合わせは許されています。 -.Ip nopeer 10 +.It nopeer ポーリングしているホストに、状態を持たない (stateless) 時間サービス を与えますが、そうしなければ将来的に同期の相手として有用であるかもし -れない場合にさえ、それらに peer メモリ資源を割当てません。 -.Ip notrust 10 +れない場合にさえ、それらに更新相手 (peer) 用のメモリ資源を割当てません。 +.It notrust これらのホストは同期源としては決して使用されませんが、その他の点では 普通に扱われます。 -.Ip limited 10 +.It limited これらのホストは、同一のネットからのクライアント数の制限の対象となり ます。ここで言うネットとは、 (class A, class B, class C 等の) ネット -の IP 表記のことです。サーバで見えており、過去 -\*(L"client_limit_period\*(R" 秒の間アクティブであった、最初の -\*(L"client_limit\*(R" 個のホストのみが、受付けられます。同一の +の IP 表記のことです。 サーバに見えるホストで、過去 +.Qq client_limit_period +秒の間アクティブであった、最初の +.Qq client_limit +個のホストのみが、受け付けられます。同一の ネットの他のクライアントからの要求は拒否されます。時間要求パケットのみが、 -考慮されます。\*(L"プライベート\*(R"", \*(L"制御\*(R"", \*(L"ブロー -ドキャスト\*(R" 等のパケットは、クライアント制限の対象にはならず、 +考慮されます。 +.Qq プライベート +、 +.Qq 制御 +、 +.Qq ブロードキャスト +等のパケットは、クライアント制限の対象にはならず、 クライアントの数の内には入れられません。クライアントの履歴は、 -.I xntpd +.Nm のモニタリング機能を使用して維持されます。それゆえ、モニタリングは、 -\*(L"limited\*(R" フラグに制限エントリがある限り、アクティブです。 -\*(L"client_limit\*(R" のデフォルト値は 3 です。 -\*(L"client_limit_period\*(R" デフォルト値は 3600 秒です。 -.Ip ntpport 10 +.Qq limited +フラグに制限エントリがある限り、アクティブです。 +.Qq client_limit +のデフォルト値は 3 です。 +.Qq client_limit_period +のデフォルト値は 3600 秒です。 +.It ntpport 実質的には、制限フラグと言うより、マッチのアルゴリズムを変更するもの です。このフラグが存在すると、パケットのソースポートが標準の NTP の UDP ポート (123) である場合にのみ、制限エントリにマッチします。 -\*(L"ntpport\*(R" と non\-\*(L"ntpport\*(R" の両方が指定できます。 -\*(L"ntpport\*(R" はより限定的であると考えられ、リストの後方にソート -されます。 -.PP -デフォルトの制限リストエントリは、フラグ \*(L"ignore, ntpport\*(R" -を持ち、ローカルホストのインタフェースアドレスの各々に対し、 +.Qq ntpport +と +.Pf non\- Qq ntpport +の両方が指定できます。 +.Qq ntpport +はより限定的であると考えられ、リストの後方にソートされます。 +.El +.Pp +デフォルトの制限リストエントリは、フラグ +.Qq ignore , +.Qq ntpport +を持ち、ローカルホストのインタフェースアドレスの各々に対し スタートアップ時にテーブルに挿入され、サーバがそれ自身の時間に同期しようと しないようにします。また、デフォルトエントリは常に存在しますが、他で は設定されない場合は、どのフラグもデフォルトエントリに関連づけられま せん (すなわち、あなた自身の NTP サーバ以外のすべてが無制限になります) 。 -.PP -制限ファシリティは、NSFnet の幹線上で動いている時間サーバの現在の -アクセスポリシが、 -.I xntpd -と同様に実装され得るように、付け加えられたものです。このファシリティ -は、あなたのサーバが、望まないか故障したリモート時間サーバの影響を受 -けないようにするのに、ことのほか有用ですが、これが 標準の NTP 認証 -ファシリティの代わりになると考えるべきではありません。ソースアドレスに +.Pp +制限機能は、NSFnet の幹線上で動いている時間サーバの現在のアクセスポリシが、 +.Nm +と同様に実装され得るように、付け加えられたものです。 +望まないまたは故障したリモート時間サーバからのあなたのサーバへの影響を +避けるために、この機能がことのほか有用である一方、これが 標準の NTP 認証 +機能の代わりになると考えるべきではありません。ソースアドレスに 基づく制限は、確信犯的クラッカーにたやすく裏をかかれます。 -.PP -.B clientlimit -.I limit -.PP -\*(L"client_limit\*(R" を \*(L"limit\*(R" にセットし、クライアント -制限ポリシの設定を可能にします。この変数は、そのサーバの使用を許される +.It clientlimit Ar limit +.Qq client_limit +を +.Ar limit +にセットし、クライアント制限ポリシの設定を可能にします。 +この変数は、そのサーバの使用を許される 同一ネットワークからのクライアント数を定義します。 -.PP -.B clientperiod -.I period -.PP -\*(L"client_limit_period\*(R" をセットし、クライアント制限ポリシの設 -定を可能にします。この変数は、その時間後にクライアントがインアクティブに -なると考えられ、従って制限されるクライアント数にもはや数えられな -くなるような秒数を指定します。 -.SH "モニタリングオプション" -.PP -.B statsdir -.I /directory path/ -.PP +.It clientperiod Ar period +.Qq client_limit_period +をセットし、クライアント制限ポリシの設定を可能にします。 +この変数は、その時間後にクライアントがインアクティブであるとみなし、 +従って制限されるクライアント数にもはや数えられなくなるような秒数を指定します。 +.El +.Sh "モニタリングオプション" +.Bl -tag -width indent +.It statsdir Ar /directory path/ 統計ファイルが作られるべきディレクトリのフルパスを指定します(下記参照)。 このキーワードにより (そうでなければ定数である) filegen ファイル名の プレフィックスを統計ログ処理に対して用いられるファイル生成セットに対して 修正することが可能となります (下記 -.B filegen +.Em filegen 文を参照)。 -.PP -.B statistics -.IR name \.\.\. -.PP +.It statistics Ar name Ns ... 統計レコードの書込みを有効にします。現在のところ、3 種類の統計がサポート されています。 -.Ip loopstats 10 -ループフィルタの統計情報の記録を有効にします。ローカル時計の更新を -行う度に、\*(L"loopstats\*(R" と名付けられたファイル生成セットに次の -形式の行を出力します: -.PP -.RS 5 -48773 10847.650 0.0001307 17.3478 2 -.RE - -.RS 10 +.Bl -tag -width indent +.It loopstats +ループフィルタの統計情報の記録を有効にします。ローカル時計の更新を行う度に、 +.Qq loopstats +と名付けられたファイル生成セットに次の形式の行を出力します: +.Dl 48773 10847.650 0.0001307 17.3478 2 最初の 2 つのフィールドは、日付 (ユリウス歴に修正済) と時刻 (UTC 午前 0 時からの秒数)です。次の 3 つのフィールドは、時計の更新時の、 秒での時間オフセット, 100 万分の 1 単位の周波数オフセット, clock-discipline アルゴリズムの時定数です。 -.RE -.Ip peerstats 10 -通信相手に関する統計情報の記録を有効にします。これには、存在し初期化 -された NTP サーバと 1-pps シグナルのすべての通信相手に関する統計レコードが -含まれます。有効な更新が行われる度に、 \*(L"peerstats\*(R" と -名付けられたファイル生成セットの現在の要素に次の形式の行を出力します: -.PP -.RS 5 -48773 10847.650 127.127.4.1 9714 -0.001605 0.00000 0.00142 -.RE - -.RS 10 +.It peerstats +通信相手に関する統計情報の記録を有効にします。これには、存在し設定済みの +NTP サーバと 1-pps シグナルのすべての通信相手に関する統計レコードが +含まれます。有効な更新が行われる度に、 +.Qq peerstats +と名付けられたファイル生成セットの現在の要素に次の形式の行を出力します: +.Dl 48773 10847.650 127.127.4.1 9714 -0.001605 0.00000 0.00142 最初の 2 つのフィールドは、日付 (ユリウス歴に修正済) と時刻 (UTC 午前 0 時からの秒数)です。次の 2 つのフィールドは、それぞれ -dotted-quad 記法で表された通信相手のアドレスとステータスです。 +ドット付き 4 つ組記法で表された通信相手のアドレスとステータスです。 ステータスフィールドは、 NTP の仕様である RFC 1305 の Appendix A で記述さ れたフォーマットに従い 16 進数にエンコードされています。最後の 3 つ のフィールドは、オフセット, 遅延, ばらつきで、すべて秒単位です。 -.RE -.Ip clockstats 10 +.It clockstats 時計ドライバの統計情報の記録を有効にします。時計ドライバからの更新を -受ける度に、 \*(L"clockstats\*(R" と名付けられたファイル生成セット次 -の形式の行を出力します: -.PP -.RS 5 -49213 525.624 127.127.4.1 93 226 00:08:29.606 D -.RE - -.RS 10 +受ける度に、 +.Qq clockstats +と名付けられたファイル生成セット次の形式の行を出力します: +.Dl 49213 525.624 127.127.4.1 93 226 00:08:29.606 D 最初の 2 つのフィールドは、日付 (ユリウス歴に修正済) と時刻 (UTC -午前 0 時からの秒数)です。次のフィールドは、dotted-quad 記法で表された +午前 0 時からの秒数)です。次のフィールドは、ドット付き 4 つ組記法で表された 時計のアドレスです。最後のフィールドは、時計から受け取った最後のタイム -コードで、ここでは意味のある ASCII 形式になっています。いくつかの +コードで、ここでは意味のある +.Tn ASCII +形式にデコードされています。いくつかの 時計ドライバでは、たくさんの付加的情報が集められ、同様に表示されます。 より詳しくは、それぞれの時計の仕様情報を参照してください。 -.RE -.PP +.El +.Pp 統計ファイルは、ファイル生成セット(下記 -.B filegen +.Em filegen を参照)を用いて管理されます。統計を記録することで得られる情報は、 -.I xntpd +.Nm サーバの一時的なプロパティ (properties) の解析を可能にします。通常は -主要な (primary) サーバで役立つだけで、あるいはキャンパスのメイン +主要な (primary) サーバで役立つだけですが、あるいはキャンパスのメイン サーバでも役立つかもしれません。 -.PP -.B filegen -.I name -[ -.B file -.I filename -] [ -.B type -.I typename -] [ -.B flag -.I flagval -] [ -.BR link | nolink -] [ -.BR enable | disable -] -.PP +.It Xo filegen +.Ar name +.Op file Ar filename +.Op type Ar typename +.Op flag Ar flagval +.Op link | nolink +.Op enable | disable +.Xc ファイル生成セット (file generation set) -.IR name +.Ar name の設定を行います。ファイル生成セットは、サーバの活動期間を通じて 継続的に大きくなっていくファイルを扱う手段を提供します。サーバ統計は このようなファイルの典型例です。ファイル生成セットにより、現状のデータ を格納するのに用いられるファイル集合にアクセスできます。任意の時点で、 集合の高々 1 つの要素への書き込みが行われます。 -.I type +.Em type は、その集合の新たな要素に、データが、いつ、どのように出力されるのか の仕様を与えます。この方法で、 -.I xntpd +.Nm の動作を妨げる危険なしに、管理的な操作 (administrational operations) から、現在使用されていないファイル集合の要素に格納されている情報が、 利用できるようになります。(最重要: それらは、新たな出力データのため 空きを作るのに削除される可能性があります。)要素のファイル名は 3 つの 部分から作られます。 -.Ip prefix 10 +.Bl -tag -width indent +.It prefix 不変なファイル名のパスです。 -.B filegen +.Em filegen 文による修正の対象にはなりません。サーバによって定義され、通常コンパイル時の 定数として指定されます。しかし、他のコマンドにより、個別のファイル生成 -セットに対して設定は可能です。たとえば、"loopstats" と -"peerstats" という filegen で用いられるプレフィックスは、すでに説明した -.B statsdir +セットに対して設定は可能です。たとえば、 +.Qq loopstats +と +.Qq peerstats +という filegen で用いられるプレフィックスは、すでに説明した +.Em statsdir 文を使用して設定できます。 -.Ip filename 10 +.It filename この文字列は、上で述べた -.I prefix -に、( \*(L'/\*(R' (スラッシュ) を入れずに ) 直接連結されます。 -\*(L"filegen\*(R" 文の \*(L"file\*(R" 引数を使って修正できます。 -\*(L"prefix\*(R" により示されるファイル名が、ファイルシステム階層の -外側を参照しないように、この部分は \*(L"..\*(R" を含んではいけないよ -うになっています。 -.Ip suffix 10 +.Em prefix +に、( +.Sq / +(スラッシュ) を入れずに ) 直接連結されます。 +.Em filegen +文の +.Ar file +引数を使って修正できます。 +.Em prefix +により示されるファイル名が、ファイルシステム階層の +外側を参照しないように、この部分は +.Qq .. +を含んではいけないようになっています。 +.It suffix この部分はファイル集合の各要素を反映します。後述のように、ファイル集合の -.I type +.Em type に従って生成されます。 -.PP +.El +.Pp ファイル生成セットは、その型 (type) により特徴づけられます。次の型が サポートされています: -.Ip none 10 +.Bl -tag -width indent +.It none ファイル集合は実際には、単一のプレーンファイルです。 -.Ip pid 10 -.I xntpd +.It pid +.Nm サーバの起動ごとに、ファイル集合の 1 つの要素が使われます。この型は、 実行中にファイル集合の要素への変更を一切行いませんが、異なる -.I xntpd +.Nm サーバの起動ごとに別々のファイルをつくる簡単な方法になります。要素の -ファイル名は、 \*(L"prefix\*(R" と \*(L"filename\*(R" をドット -(\*(L'.\*(R') でつなげた上、 -.I xntpd -サーバプロセスのプロセス ID の10進表現をつなげで作られます。 -.Ip day 10 +ファイル名は、 +.Em prefix +と +.Em filename +をドット +.Pf ( Sq \&. Ns ) +でつなげた上、 +.Nm +サーバプロセスのプロセス ID の10進表現をつなげて作られます。 +.It day 1 日に 1 つのファイル生成セットの要素が作成されます。ここで、 -.I 日 +.Em 日 という用語は、 .IR UTC -に基づきます。1 日は、 UTC の 00:00 と 24:00 の間の期間として定義さ -れます。要素のサフィックスは、ドット \*(L".\*(R" と -.RI < YYYYMMDD > +に基づきます。1 日は、 UTC の 00:00 と 24:00 の間の期間として定義されます。 +要素のサフィックスは、ドット +.Pf ( Qq \&. Ns ) +と +.Aq < YYYYMMDD > の形式の日付指定からなります。 -.I YYYY +.Em YYYY は 4 桁の西暦年 (たとえば 1992)で、 -.I MM +.Em MM は、2 桁の月です。 -.I DD -は、2 桁の日となります。したがって、1992 年 12 月 10 日に情報はすべ -て、 \*(L"<prefix><filename>.19921210\*(R" という名前のファイルに書 -かれます。 -.Ip week 10 +.Em DD +は、2 桁の日となります。したがって、1992 年 12 月 10 日に情報はすべて、 +.Qq <prefix><filename>.19921210 +という名前のファイルに書かれます。 +.It week どの要素も 1 年の内のある週に関連するデータを含みます。ここで、 -.I 週 -という用語は、年の始まりからの日数の 7 の商により定義されます。この +.Em 週 +という用語は、 +.Qq 年の始まりからの日数 +の 7 の商により定義されます。この ようなファイル生成セットの要素は、ファイル集合のファイル名のベースに 次のようなサフィックスをつけることで区別されます。サフィックスは、 -ドット, 4 桁の西暦年, 文字 \*(L"W\*(R", 2 桁の週番号です。例えば、 1992 -年 1 月 10 日からの情報は、サフィックス \*(L".1992W1\*(R" を持つ -ファイルに出力されます。 -.Ip month 10 +ドット、4 桁の西暦年、文字 +.Qq W +、2 桁の週番号です。例えば、1992 年 1 月 10 日からの情報は、サフィックス +.Qq .1992W1 +を持つファイルに出力されます。 +.It month 1 月に 1 つのファイル生成セットの要素が作成されます。ファイル名の -サフィックスは、ドット, 4 桁の西暦年, 2 桁の月からなります。 -.Ip year 10 +サフィックスは、ドット、4 桁の西暦年、2 桁の月からなります。 +.It year 1 年に 1 つのファイル生成セットの要素が作成されます。ファイル名の サフィックスは、ドットと 4 桁の西暦年からなります。 -.Ip age 10 +.It age この型のファイル生成セットは、サーバが 24 時間活動するごとに新たな要素に -変わります。ファイル名のサフィックスは、ドット, 文字 -\*(L"a\*(R", 8 桁の数からなります。この数は、対応する 24 時間の始め +変わります。ファイル名のサフィックスは、ドット、文字 +.Qq a +、8 桁の数からなります。この数は、対応する 24 時間の始め からサーバが実行されている秒数であるようになります。 -.PP -情報は、ファイル生成セットが \*(L"enabled\*(R"のときのみ、そのセット -に書込まれます。出力は \*(L"disabled\*(R"を指定することで抑止されます。 -.PP +.El +.Pp +情報は、ファイル生成セットが +.Qq enabled +のときのみ、そのセットに書込まれます。出力は +.Qq disabled +を指定することで抑止されます。 +.Pp ファイル生成セットの -.I 現在の +.Em 現在の 要素に決まった名前でアクセスできると便利です。この機能は、 -\*(L"link\*(R" を指定することで有効になり、 \*(L"nolink\*(R" を使っ -て無効になります。 \*(L"link\*(R" が指定されると、 現在の要素から -サフイックスを持たないファイルへのハードリンクが作成されます。その名前 +.Qq link +を指定することで有効になり、 +.Qq nolink +を使って無効になります。 +.Qq link +が指定されると、 現在の要素から +サフィックスを持たないファイルへのハードリンクが作成されます。その名前 を持つファイルが既に存在し、そのファイルのリンク数が 1 の場合、その -ファイル名に、ドット, 文字 \*(L"C\*(R", -.I xntpd +ファイル名に、ドット、文字 +.Qq C +、 +.Nm サーバプロセスの pid をつなげて、名前変更を行います。リンク数が 1 以上の場合、ファイルはアンリンクされます。これにより現在のファイルを 定数名でアクセスすることができます。 -.SH "その他のオプション" -.PP -.B precision -.I # -.PP +.El +.Sh "その他のオプション" +.Bl -tag -width indent +.It precision Ar # このコマンドは、ローカル時計の名目上の (nominal) 精度を指定します。 この値は、秒単位のローカルの時間管理精度の底を 2 とする対数に近似的 -に等しい整数です。ふつう、デーモンは起動時に自動的に精度を決定するの +に等しい整数です。通常、デーモンは起動時に自動的に精度を決定するの で、このコマンドは、精度を自動的に決定できない特殊な場合にのみ必要に なります。 -.PP -.B broadcastdelay -.I seconds -.PP +.It broadcastdelay Ar seconds ブロードキャストおよびマルチキャストモードは、ローカルとリモートサーバ間の ネットワーク遅延を決定するため、特別の修正を必要とします。通常、 この修正は、ローカルとリモートサーバ間の最初のプロトコル交換により、 @@ -761,18 +692,12 @@ dotted-quad 記法で表された通信相手のアドレスとステータスです。 のアクセス制御のために失敗する可能性があります。このコマンドは、これ らの状況下で使用されるデフォルトの遅延を指定します。(イーサネットに 対する)典型としては、0.003 から 0.007 秒が適切です。このコマンドが使 -用されない場合のデフォルトは、 0.004 秒です。 -.PP -.B trap -.I host_address -[ -.B port -.I port_number -] [ -.B interface -.I interface_addess -] -.PP +用されない場合のデフォルトは、0.004 秒です。 +.It Xo trap +.Ar host_address +.Op port Ar port_number +.Op interface Ar interface_addess +.Xc このコマンドは、指定されたローカルインタフェースに送られる メッセージに対する、所与のホストアドレスとポート番号でのトラップレシーバを 設定します。ポート番号が指定されない場合、 18447 が使用されます。 @@ -780,308 +705,323 @@ dotted-quad 記法で表された通信相手のアドレスとステータスです。 ローカルインタフェースのアドレスをソースアドレスとしてメッセージが 送られます。マルチホームのホストでは、使用されるインタフェースが、 ルーティングの変更にともない変化し得ることに注意してください。 -.PP +.Pp トラップレシーバは、一般には、イベントメッセージやサーバからのその他 の情報をログファイル中に記録するものです。このようなモニタプログラム はまた、それら自身のトラップをダイナミックに要求するかもしれませんが、 トラップレシーバの設定は、サーバのスタート時にメッセージが失われない ことを保証することになっています。 -.PP -.B setvar -.I variable -.I [default] -.PP +.It Xo setvar +.Ar variable +.Op Ar default +.Xc このコマンドは、付加的なシステム変数を追加します。これらの変数は、 アクセスポリシなどの付加的な情報を配布するために使用できます。 <name>=<value> の形式の変数に、キーワード -.I default +.Em default が続いた場合、変数はデフォルトのシステム変数の一部としてリストされる ようになります ( -.I ntpq rv +.Pf ( Nm ntpq コマンド) 。これら付加的な変数は、情報を与える目的だけを果たします。 リストされ得ると言うこと以外に、プロトコルに関係しません。 既知のプロトコル変数は常に、 -.I setvar +.Em setvar の機構により定義されたいかなる変数よりも優先されます。 -.PP +.Pp 同一グループのすべての変数の名前を含む 3 つの特別な変数があります。 -.I sys_var_list +.Em sys_var_list は、すべてのシステム変数の名前を保持しています。 -.I peer_var_list -は、すべての peer (交信相手) 変数の名前を保持しています。 -.I clock_var_list +.Em peer_var_list +は、すべての更新相手 (peer) 変数の名前を保持しています。 +.Em clock_var_list は、参照時計変数の名前を保持しています。 -.PP -.B monitor yes|no -.B authenticate yes|no -.PP +.It monitor Ar yes|no +.It authenticate Ar yes|no これらのコマンドは、 -.B enable +.Em enable と -.B disable +.Em disable コマンドに置き換えられました。ここにあげたのは歴史を述べるためです。 -.SH "認証キーファイルのフォーマット" -.PP -NTP 標準は、受信した NTP パケットの認証の確認を可能とし、送信パケット内の +.El +.Sh "認証キーファイルのフォーマット" +.Tn NTP +標準は、受信した NTP パケットの認証の確認を可能とし、送信パケット内の 認証の指示を与えるための拡張を定めています。これは、 -.I xntpd +.Nm においては、デジタル署名, あるいは message-digest を計算するため、 DES もしくは MD5 アルゴリズムを使用して実装されています。この仕様は、 -32 ビットのキー識別子により、ほぼ 40 億分の 1 が、連携 (association) +32 ビットのキー識別子により、約 40 億個のうちの 1 つが、連携 (association) の認証に使用できるようにしています。連携に含まれるサーバは、各々独立 にキーとキー識別子を学習せねばならないにも関わらず、データを認証する のに使用されるキーとキー識別子に合意せねばなりません。 DES の場合、 キーは 56 ビット長で、型によっては各バイトにパリティがつきます。MD5 の場合、キーは 64 ビット (8 バイト) です。 -.I xntpd +.Nm は、 コマンドラインオプション -.B -k +.Fl k もしくは設定ファイル中の -.B keys +.Em keys 文を使用して指定されるファイルからキーを読み込みます。キー番号 0 は、 -NTP 標準によって (56 ビットの 0 として) 決定されており、変更できませ -んが、一方、1 から 15 のキー番号の内の 1 つ以上がキーファイル中で任意に +.Tn NTP +標準によって (56 ビットの 0 として) 決定されており、変更できませんが、 +一方、1 から 15 のキー番号の内の 1 つ以上がキーファイル中で任意に セットできます。 -.PP +.Pp キーファイルは、設定ファイルと同様のコメント記述法 を使用しています。キーエントリはの形式の固定されたフォーマットを -使用します。 -.Ip "" 5 -.I "keyno type key" -.PP -の形式の固定されたフォーマットを使用します。ここで、 \*(L"keyno\*(R" -は正の数、 \*(L"type\*(R" はキーが与えられる形式を定義する単一文字、 -\*(L"key\*(R" はキーそれ自身です。 -.PP -キーは、 \*(L"type\*(R" 文字による制御で、3 つの異なるフォーマットの +使用します: +.Pp +.Dl keyno type key +.Pp +の形式の固定されたフォーマットを使用します。ここで、 +.Em keyno +は正の数、 +.Em type +はキーが与えられる形式を定義する単一文字、 +.Em key +はキーそれ自身です。 +.Pp +キーは、 +.Em type +文字による制御で、3 つの異なるフォーマットの 内の 1つで与えられます。3 つのキーの型とそれに対応するフォーマットは、 -次にあげるとおりです。 -.Ip "S" 5 -\*(L"key\*(R" は、 DES のドキュメントに定められたフォーマットの 64 +次にあげるとおりです: +.Bl -tag -width indent +.It S +.Em key +は、 DES のドキュメントに定められたフォーマットの 64 ビットの 16進数で、各オクテットの上位 7 ビットが使用された 56 ビット キーです。各オクテットの下位 1 ビットは、オクテットを奇数パリティに 保つように与えられます。先頭の 0 は省略できません (すなわち、キーは 正確に 16 桁の 16 進数である必要があります) 。また、奇数パリティが保 たれねばなりません。それゆえ、ゼロキーは、標準フォーマットで、 -.I 0101010101010101 +.Em 0101010101010101 として与えられます。 -.Ip "N" 5 -\*(L"key\*(R" は、 NTP 標準で定められたフォーマットの 64 ビットの 16 -進数です。これは、各オクテットを 1 ビット右 rotate して、パリティビッ -トがオクテットの上位ビットになったことを除いては、 DES フォーマット -と同じです。先頭の 0 は省略できず、奇数パリティが保たれねばなりませ -ん。ゼロキーは、 NTP フォーマットで、 -.I 8080808080808080 +.It N +.Em key +は、 +.Tn NTP +標準で定められたフォーマットの 64 ビットの 16 +進数です。これは、各オクテットを 1 ビット右 rotate して、パリティビットが +オクテットの上位ビットになったことを除いては、DES フォーマット +と同じです。先頭の 0 は省略できず、奇数パリティが保たれねばなりません。 +0 キーは、 NTP フォーマットで、 +.Em 8080808080808080 のように指定されます。 -.Ip "A" 5 -\*(L"key\*(R" は 1 文字から 8 文字の ASCII 文字列です。キーは、文字 -列中の各文字の ASCII 表現の下位 7 ビットを使用して構成されます。56 +.It A +.Em key +は 1 文字から 8 文字の ASCII 文字列です。キーは、文字列中の各文字の +.Tn ASCII +表現の下位 7 ビットを使用して構成されます。56 ビット幅のキーを作るために、 Unix パスワードから暗号化キーを作るのと 同じ方法で、必要なら 0 が右端に付加されます。 -.Ip "M" 5 -\*(L"key\*(R" は 1 文字から 8 文字の ASCII 文字列で、 MD5 の認証方式 +.It M +.Em key +は 1 文字から 8 文字の +.Tn ASCII +文字列で、 MD5 の認証方式 を使用しています。キーと認証方式 (DES または MD5) の両方が、同じキー 番号を共有する一組の交信相手の間で一意であることが、必要であることに 注意してください。 -.PP +.El +.Pp 設定ファイルの -.B requestkey +.Em requestkey 文の方法で、 -.IR xntpdc (8) +.Xr xntpdc 8 プログラムを用いてなされる実行時の設定要求を認証するために、キーの内 1 つが選択できます。後者のプログラムは、パスワードとして端末からキー -を得ます。ですから、一般に、この目的のために使用されるキーを ASCII +を得ます。ですから、一般に、この目的のために使用されるキーを +.Tn ASCII 表現で指定するのは、適切なことです。 -.SH 主要な時計サポート (PRIMARY CLOCK SUPPORT) -.I xntpd +.Sh 主要な時計サポート (PRIMARY CLOCK SUPPORT) +.Nm は、オプションで、いくつかの型の参照時計に対するサポートを含むように コンパイルできます。参照時計は、一般に (常にではなく)、カナダの NRC やアメリカの NIST により提供されるサービスと同様の標準時刻の供給源に 同期している無線時刻コード受信機です。コンピュータと時刻コード受信機 の間のインタフェースはデバイス依存で多種にわたりますが、多くは シリアルポートです。 -.PP +.Pp 多種類の参照時計ドライバに対するサポートは、他の場所で記述された コンパイラ定義のコードを使用して、条件コンパイルされます。参照時計を設定 しようとする試みは、特定のサポートが得られないか、ハードウェアポート が適切に設定されていないとき、システムログファイルに警告を残しますが、 そのほかでは障害となりません。 -.PP +.Pp 設定のために、 -.I xntpd -は、参照時計を、できるかぎり普通の NTP の交信相手にするのと同じよう +.Nm +は、参照時計を、できるかぎり普通の +.Tn NTP +の交信相手にするのと同じよう な方法で扱います。参照時計は、普通の交信相手と同様にアドレスで参照さ れますが、普通の交信相手と区別するため、無効なアドレスが使用されます。 参照時計のアドレスは、 -.I 127.127.t.u +.Em 127.127.t.u の形式となります。ここで、 -.I t +.Em t は、時計の型を示す整数で、 -.I u +.Em u は、型で特定されるユニット番号を示します。参照時計は、設定ファイル中の -.B server +.Em server 文を使用して設定されます。このときの -.I host_address +.Em host_address は、時計のアドレスです。 -.I key -と -.I version -と -.I ttl +.Em key , +.Em version , +.Em ttl オプションは、参照時計サポートのためには使用されませんが、 -.I prefer +.Em prefer オプションは、ある参照時計を、それが望ましい場合には、他の参照時計や 交信相手より少し熱心に大事に扱わせるよう、サーバに促すのにうまく使え ます。時計のアドレスは、一般に設定ファイル中で普通 の IP アドレスが使用できるところならどこでも使用できます。例えば、 -.B restrict +.Em restrict 文中などですが、このような使用法は普通は奇妙に思えるでしょう。 -.PP +.Pp 参照時計サポートは、特別の方法で参照時計を設定するのに使用できる -.B fudge +.Em fudge コマンドを与えます。 以下は、このコマンドに適用される一般的なフォーマットです。 -.PP -.B fudge -.I 127.127.t.u -[ -.B time1 -.I secs -] [ -.B time2 -.I secs -] [ -.B stratum -.I int -] [ -.B refid -.I int -] [ -.B flag1 -.I 0|1 -] [ -.B flag2 -.I 0|1 -] [ -.B flag3 -.I 0|1 -] [ -.B flag4 -.I 0|1 -] -.PP -.I time1 +.Pp +fudge +.Ar 127.127.t.u +.Op time1 Ar secs +.Op time2 Ar secs +.Op stratum Ar int +.Op refid Ar int +.Op flag1 Ar 0|1 +.Op flag2 Ar 0|1 +.Op flag3 Ar 0|1 +.Op flag4 Ar 0|1 +.Pp +.Em time1 と -.B time2 +.Em time2 オプションは、秒単位の固定小数点で指定され、いくつかの時計ドライバで は、補正定数として使用されます。慣習により、別のやり方で示されない限り、 -.B time1 +.Em time1 は、特定の時計の名目上の時間オフセットを、高精度の PPS 信号のような、 外部の標準に一致させるように調整するための補正定数として使用されます。 指定されたオフセットは、内部の DIP スイッチのような他の手段により与えられた 伝搬遅延に付加されます。 -.B stratum +.Em stratum オプションは 0 から 15 までの数で、時計に対し非標準の operating stratum を割当てるのに使用します。 -.B refid -オプションは、 1 から 4 文字までの ASCII 文字列で、時計に対し非標準 +.Em refid +オプションは、 1 から 4 文字までの +.Tn ASCII +文字列で、時計に対し非標準 の参照識別子を割当てるのに使用します。最後に、4つの 2 値フラグ -.B flag1, -.B flag2, -.B flag3, -.B flag4 +.Em flag1 , +.Em flag2 , +.Em flag3 , +.Em flag4 は、時計ドライバをカスタマイズするのに使用されます。これらの値の解釈 や、ともかくそれらが用いられるのかどうかは、特定の時計ドライバが必要 とするかに関わっています。しかし、慣習により、別のやり方で示されない 限り、 -.B flag3 +.Em flag3 は、 ppsclock ストリームモジュールを設定されるドライバにアタッチする のに使用され、一方、 -.B flag4 +.Em flag4 は、 -.I filegen +.Em filegen コマンドで設定される時計統計 (clockstats) ファイルへの詳細なモニタリング データの記録を有効にするために使用されます。 ppsclock ストリーム モジュールについてのさらなる情報は、現在の xntp3 プログラムの -ディストリビューション中の ./kernel ディレクトリの README ファイル内にあり -ます。この機能についてのさらなる情報は、 -同じディストリビューション中の ./scripts/stats ディレクトリにあります。 -.PP +ディストリビューション中の +.Pa ./kernel +ディレクトリの +.Pa README +ファイル内にあります。この機能についてのさらなる情報は、 +同じディストリビューション中の +.Pa ./scripts/stats +ディレクトリにあります。 +.Pp 通常、参照時計の stratum は、デフォルトで 0 です。 -.I xntpd +.Nm デーモンは、各交信相手の stratum に 1 を加算するので、主要 (primary) サーバは、通常 stratum 1 を示します。巧みに運用されたバックアップを 与えるために、参照時計の stratum を 0 以上に指定することは、役に立つ ことが多いです。 -.B stratum +.Em stratum オプションは、この目的のために使用されます。また、参照時計と 1-pps discipline 信号の両方を含む場合、ドライバによっては、参照時計識別子 をデフォルト以外に指定することは有用です。 -.I refid +.Em refid オプションは、この目的のために使用されます。そう記されていない限り、 これらのオプションは、すべての時計ドライバに適用されます。 -.PP +.Pp 現在、Unix マシン上の -.I xntpd +.Nm は、バックアップとして用いられる、あるいは他の時計供給源が与えられな いとき使用される特殊な仮想時計に加えて、いくつかの異なる型の時計 ハードウェアをサポートしています。たいていの時計ドライバの場合、xntp3 -プログラムのディストリビューション中の ./doc ディレクトリの README +プログラムのディストリビューション中の +.Pa ./doc +ディレクトリの +.Pa README ファイル内で述べられているように 1-pps 精度のタイミング信号に対する サポートが利用可能です。時計ドライバ、およびそれらを設定するのに使用される -アドレスは、現在の xntp3 プログラムのディストリビューション中の doc -ディレクトリの README.refclocks で記述されています。 -.PP -.SH 変数 -NTP protocol により用いられるたいていの変数は、 -.I xntpdc +アドレスは、現在の xntp3 プログラムのディストリビューション中の +.Pa doc +ディレクトリの +.Pa README.refclocks +で記述されています。 +.Sh 変数 +.Tn NTP +プロトコルにより用いられるたいていの変数は、 +.Nm xntpdc (モード 7 メッセージ) と -.I ntpq +.Nm ntpq (モード 6 メッセージ) で、調べることができます。 現在は、ごくわずかの変数が、モード 6 メッセージを通して変更可能です。 - これらの変数は、 -.I setvar +.Em setvar の指示で作られたか、リープ警告 (leap warning) 変数かのどちらかです。 リープ警告ビットは、 -.B leapwarning +.Em leapwarning 変数で (1 ヶ月前までに) セットされます。 -.B leapwarning +.Em leapwarning と -.B leapindication +.Em leapindication 変数内の両方が通常の -.B leap +.Em leap ビット解釈と少し違ったエンコーディングを持っています: -.P -.Ip 00 8 +.Bl -tag -width indent +.It 00 デーモンは、同期源のリープビットを渡します (通常モードの動作) 。 -.Ip 01/10 8 -リープ秒が、付加/削除されます (オペレータによるリープ秒の強制)。 -.Ip 11 8 +.It 01/10 +うるう秒 (leap second) が、付加/削除されます (オペレータによるうるう秒の強制)。 +.It 11 同期源からのリープ情報は、無視されます (それゆえ LEAP_NOWARNING が 与えられます) 。 -.PP -.SH 関連ファイル -.Ip /etc/ntp.conf 20 +.El +.Sh 関連ファイル +.Bl -tag -width /etc/ntp.drift -compact +.It /etc/ntp.conf デフォルトの設定ファイル名 -.Ip /etc/ntp.drift 20 +.It /etc/ntp.drift ドリフトファイルの慣習上の名前 -.Ip /etc/ntp.keys 20 +.It /etc/ntp.keys キーファイルの慣習上の名前 -.SH 関連項目 -.PP -.IR xntpdc (8), -.IR ntpq (8), -.IR ntpdate (8) -.SH 歴史 -.PP +.El +.Sh 関連項目 +.Xr ntpdate 8 , +.Xr ntpq 8 , +.Xr xntpdc 8 +.Sh 歴史 +コマンドは +University of Toronto の +.An Dennis Ferguson +によって書かれました。 +テキストは University of Delaware の +.An David Mills +により修正されました。 +.Sh バグ .Nm -コマンドはトロント大学の Dennis Ferguson によって書かれました。 -テキストはデラウェア大学の David Mills により修正されました。 -.SH バグ -.PP -.I xntpd はかなり大きくなってしまいました。巨大とは言いませんが、ワークステーションで 実行される可変プライオリティのデーモンとして望ましい大きさを 超えてしまいました。それは特に、かさばる凝った特徴の多くが、高い diff --git a/ja/man/man8/xntpdc.8 b/ja/man/man8/xntpdc.8 index f9679f4d8d..1b907015f6 100644 --- a/ja/man/man8/xntpdc.8 +++ b/ja/man/man8/xntpdc.8 @@ -1,233 +1,192 @@ -''' $Header -''' -.de Sh -.\" jpman %Id: xntpdc.8,v 1.3 1997/09/10 04:36:59 yugawa Stab % -.br -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp -.if t .sp .5v -.if n .sp -.. -.de Ip -.br -.ie \\n.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -''' -''' Set up \*(-- to give an unbreakable dash; -''' string Tr holds user defined translation string. -''' Greek uppercase omega is used as a dummy character. -''' -.tr \(*W-|\(bv\*(Tr -.ie n \{\ -.ds -- \(*W- -.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -.ds L" "" -.ds R" "" -.ds L' ' -.ds R' ' -'br\} -.el\{\ -.ds -- \(em\| -.tr \*(Tr -.ds L" `` -.ds R" '' -.ds L' ` -.ds R' ' -'br\} -.TH XNTPDC 8 LOCAL -.SH 名称 -xntpdc - Network Time Protocol デーモンのための問い合わせ、制御プログラム -.SH 書式 -.B xntpdc -[ -.B -ilnps -] [ -.B -c -.I command -] [ -.I host -] [ -.I ... -] -.SH 解説 -.I xntpdc -は、 -.IR xntpd (8) +.\" +.\" %Id: xntpdc.8,v 1.3 1998/02/19 08:05:46 charnier Exp % +.\" +.Dd December 21, 1993 +.Dt XNTPDC 8 +.Os +.Sh 名称 +.Nm xntpdc +.Nd Network Time Protocol デーモンのための問い合わせ、制御プログラム +.Sh 書式 +.Nm xntpdc +.Op Fl ilnps +.Op Fl c Ar command +.Op Ar host ... +.Sh 解説 +.Nm +は +.Xr xntpd 8 デーモンの現在の状態についての問い合わせや、状態の変更を要求する際に使 われます。このプログラムは、対話的なモードでもコマンドライン引数を 使った制御でも動作させることができます。 広範囲にわたる状態や統計の情報が、 -.I xntpdc +.Nm のインタフェースを通じて提供されています。 それに加えて、 -.I xntpd +.Nm xntpd の設定ファイルを使って起動時に指定できるほとんどすべて のオプションが、 -.I xntpdc +.Nm を使って、実行時にも指定できます。 -.PP -.I xntpdc -が実行されたとき、一つまたは複数のリクエストオプションが、 +.Pp +.Nm +が実行されたとき、1 つまたは複数のリクエストオプションが、 コマンドラインに含まれる場合は、それぞれのリクエストは、コマンドライン 引数で与えられるホスト、またはデフォルトである -.I localhost -の NTP サーバに送られます。 +.Ar localhost +の +.Tn NTP +サーバに送られます。 リクエストオプションが付けられなかったとき、 -.I xntpdc +.Nm はコマンドを標準入力から読み込もうとし、コマンドラインで与えられた -最初のホストで走っている NTP サーバに対してそのコマンドを実行します。 +最初のホストで走っている +.Tn NTP +サーバに対してそのコマンドを実行します。 ホストが指定されなかったときは、 デフォルトである -.I localhost +.Ar localhost のサーバに対して実行します。 -.I xntpdc +.Nm は、標準入力が端末である場合だけ、プロンプトを出します。 -.PP -.I xntpdc -は、 NTP サーバとの通信に NTP mode 7 パケットを使うため、 +.Pp +.Nm +は、 +.Tn NTP +サーバとの通信に +.Tn NTP +モード 7 パケットを使うため、 ネットワーク上でそれを許すような互換サーバへの問い合わせに使えます。 -NTP は UDP プロトコルなので、特にネットワークトポロジー的に遠くに +.Tn NTP +は UDP プロトコルなので、特にネットワークトポロジー的に遠くに ある場合は、この通信はやや信頼性に欠けるということを覚えておいて下さい。 -.I xntpdc +.Nm は、リクエストを再送する試みを行ないません。適当なタイムアウト時間の 範囲内でリモートホストから返答がなかったときは、時間切れとなります。 -.PP +.Pp コマンドラインオプションは以下の通りです。 -.B -i +.Fl i または -.B -n +.Fl n 以外のコマンドラインオプションを指定すると、指定したホスト (群) に、 指定した問い合わせ (または複数の問い合わせ) を直ちに送ることになります。 指定しなかった場合、 -.I xntpdc +.Nm は標準入力から対話的なフォーマットのコマンドを読み込もうとします。 -.Ip -c 8 +.Bl -tag -width indent +.It Fl c 次の引数が対話的なフォーマットのコマンドとして解釈され、指定したホストで 実行されるようにコマンドのリストに加えられます。 複数の -.B -c +.Fl c オプションを与えることができます。 -.Ip -i 8 -.I xntpdc +.It Fl i +.Nm を強制的に対話的モードで動作させます。標準出力にプロンプトが 表示され、標準入力からコマンドが読み込まれます。 -.Ip -l 8 +.It Fl l サーバに既知の peer のリストを取得します。このスイッチは、 -\*(L"-c listpeers\*(R" と同等です。 -.Ip -n 8 +.Qq -c listpeers +と同等です。 +.It Fl n すべてのホストアドレスを、標準的なホスト名でなく、ドット区切りの 4 個 の数値で出力します。 -.Ip -p 8 +.It Fl p サーバに既知の peer のリストと、それらの状況の要約を出力します。 -これは、 \*(L"-c peers\*(R" と同等です。 -.Ip -s 8 +これは、 +.Qq -c peers +と同等です。 +.It Fl s サーバに既知の peer のリストと、それらの状況の要約を、 -.B -p +.Fl p スイッチとは少し異なるフォーマットで出力します。 -これは \*(L"-c dmpeers\*(R" と同等です。 -.SH 内部コマンド -.PP +これは +.Qq -c dmpeers +と同等です。 +.El +.Sh 内部コマンド 対話的なフォーマットのコマンドは、キーワードとそれに続く 0 から 4 個の 引数から構成されます。キーワード全長のうち、他と区別できる文字数が タイプされれば、有効になります。 コマンドの出力は通常標準出力に送られますが、コマンドライン上で -\*(L">\*(R" に続けてファイル名を指定することで、個々のコマンドの出力を +.Qq > +に続けてファイル名を指定することで、個々のコマンドの出力を ファイルに送ることができます。 -.PP +.Pp いくつかの対話的フォーマットのコマンドは、 .I xntpdc -プログラム自身の中で全体が実行され、サーバへの NTP mode 7 リクエストは +プログラム自身の中で全体が実行され、サーバへの +.Tn NTP +モード 7 リクエストは 送られません。この種類のコマンドには以下の物があります。 -.PP -.B ? -[ -.I command_keyword -] -.PP -\*(L"?\*(R" のみのコマンドは、 -.I xntpdc +.Pp +.Bl -tag -width indent +.It Xo ? +.Op Ar command_keyword +.Xc +.Em ? +のみのコマンドは、 +.Nm が知っているすべてのコマンドキーワードのリストを出力します。 -\*(L"?\*(R" とそれに続くコマンドキーワードは、コマンドの機能と用法を +.Em ? +とそれに続くコマンドキーワードは、コマンドの機能と用法を 出力します。このコマンドは、 -.I xntpdc +.Nm に関して、このマニュアルよりも多分良い情報源となるでしょう。 -.PP -.B help -[ -.I command_keyword -] -.PP -.B ? +.It help Ar command_keyword +.Em ? コマンドと同義です。 -.PP -.B timeout -.I millseconds -.PP +.It timeout Ar millseconds サーバ問い合わせに対する応答のタイムアウト時間を指定します。デフォルト は、約 8000 ミリ秒です。 -.PP -.B delay -.I milliseconds -.PP +.It delay Ar milliseconds 認証を求めるリクエストに含まれるタイムスタンプに加えられる時間を 指定します。これは、長い遅延のあるネットワーク経路や時刻の同期していない マシン間で (信頼できない) サーバの再設定ができるようにするために 使われます。 -.PP -.B host -.I hostname -.PP +.It host Ar hostname 問い合わせを送るホストを指定します。 -.I hostname +.Ar hostname は、ホスト名でも数値アドレス (ドット区切りの数値 4 つ) でもかまいません。 -.PP -.B keyid -.I # -.PP +.It keyid Ar # このコマンドで、認証設定リクエストに使われるキー番号を指定できます。 この番号は、この目的で使うためにサーバが設定したキー番号に一致して いなければなりません。 -.PP -.B passwd -.PP +.It passwd このコマンドは、認証設定リクエストに使われるパスワードの入力 (エコーされません) を求めるプロンプトを出します。 -このリクエストが成功するためには、NTP サーバが認証のために使うよう +このリクエストが成功するためには、 +.Tn NTP +サーバが認証のために使うよう 設定したキーに、パスワードが一致していなければなりません。 -.PP -.B "hostnames yes|no" -.PP -\*(L"yes\*(R" が指定されると、情報の表示の際、ホスト名が使用されます。 -\*(L"no\*(R" が与えられると、代わりに数値アドレスが使用されます。 +.It hostnames Ar yes|no +.Ar yes +が指定されると、情報の表示の際、ホスト名が使用されます。 +.Ar no +が与えられると、代わりに数値アドレスが使用されます。 コマンドラインの -.B -n +.Fl n スイッチが使われなければ、 -デフォルトは \*(L"yes\*(R" になります。 -.PP -.B quit -.PP -.I xntpdc +デフォルトは +.Ar yes +になります。 +.It quit +.Nm を終了します。 -.SH 問い合わせコマンド -.PP -問い合わせコマンドは、情報を要求する NTP mode 7 パケットをサーバに送ります。 -これらは、サーバの設定状態を変更できない \*(L"読み込み専用\*(R" コマンドです。 -.PP -.B listpeers -.PP +.El +.Sh 問い合わせコマンド +問い合わせコマンドは、情報を要求する +.Tn NTP +モード 7 パケットをサーバに送ります。 +これらは、サーバの設定状態を変更できない +.Qq 読み込み専用 +コマンドです。 +.Bl -tag -width indent +.It listpeers サーバが状態を管理する peer の簡略なリストを得て、出力します。 これには、サーバが同期する予定の候補であるとみなす階層の peer を含めた、 すべての設定された隣接 peer を含んでいるはずです。 -.PP -.B peers -.PP +.It peers サーバが状態を管理する peer と、その状態の要約を出力します。 状態の要約は、以下のものを含みます。すなわち、リモート peer のアドレス、 ローカルインタフェースアドレス (ローカルアドレスが決まっていないなら @@ -235,182 +194,169 @@ NTP は UDP プロトコルなので、特にネットワークトポロジー的に遠くに 事を示します)、秒で表すポーリング間隔、8 進で表す到達可能性レジスタ、 peer の現在の遅れ、オフセット、バラツキの秒で表した推定値です。 更に、左端の文字は、この peer エントリが操作しているモードを -示します。 \*(L"+\*(R" は symmetric active を、 \*(L"-\*(R" は、 -symmetric passive を表し、 \*(L"=\*(R" は、リモートサーバが -クライアントモードでポーリングされていることを意味し、 \*(L"^\*(R" は、 -サーバがこのアドレスに broadcast していることを示し、 \*(L"~\*(R" は、 -リモート peer が broadcast を送っていることを示し、 \*(L"*\*(R" は、 -サーバが現在同期している peer であることを示します。 -.PP -ホストフィールドの内容は、ホスト名、IP アドレス、パラメータと -参照時刻実装名、 \*(L"REFCLK(<implementation number>, -<parameter>)\*(R" の -4 つの形のうち一つです。 \*(L"hostnames no\*(R" の状態では、 -IP アドレスだけが表示されます。 -.PP -.B dmpeers -.PP +示します。 +.Qq + +は symmetric active を、 +.Qq - +は symmetric passive を表し、 +.Qq = +は、リモートサーバがクライアントモードでポーリングされていることを意味し、 +.Qq ^ +は、サーバがこのアドレスにブロードキャストブロードキャストしていることを示し、 +.Qq ~ +は、リモート peer がブロードキャストを送っていることを示し、 +.Qq * +は、サーバが現在同期している peer であることを示します。 +.Pp +ホストフィールドの内容は、ホスト名、IP アドレス、パラメータと参照時刻実装名、 +.Qq REFCLK(<implementation number>, <parameter>) +の 4 つの形のうち 1 つです。 +.Qq hostnames no +の状態では、IP アドレスだけが表示されます。 +.It dmpeers 少々異なる peer 要約リストです。 行の左端の文字以外は -.B peers +.Em peers と同じ出力になります。 文字は、時刻選択アルゴリズムの最後のステージに含まれる peer の隣にだけ -現れます。 \*(L".\*(R" は、誤りチェッカの検出でその peer が捨てられた -ことを、 \*(L"+\*(R" はチェッカにより同期対象として適切であると判断された -ことを示します。 -\*(L"*\*(R" は、サーバが現在同期している peer であることを -示しています。 -.PP -.B showpeer -.I peer_address -[ -.I addr2 -] [ -.I addr3 -] [ -.I addr4 -] -.PP -一つ以上の peer の、現在の詳細な内容を表示します。 -値については、 NTP バージョン 2 仕様に詳しく述べられています。 -.PP -.B pstats -.I peer_address -[ -.I addr2 -] [ -.I addr3 -] [ -.I addr4 -] -.PP +現れます。 +.Qq \&. +は、誤りチェッカの検出でその peer が捨てられたことを、 +.Qq + +はチェッカにより同期対象として適切であると判断されたことを示します。 +.Qq * +は、サーバが現在同期している peer であることを示しています。 +.It Xo showpeer +.Ar peer_address +.Op Ar addr2 +.Op Ar addr3 +.Op Ar addr4 +.Xc +1 つ以上の peer の、現在の詳細な内容を表示します。 +値については、 +.Tn NTP +バージョン 2 仕様に詳しく述べられています。 +.It Xo pstats +.Ar peer_address +.Op Ar addr2 +.Op Ar addr3 +.Op Ar addr4 +.Xc 指定した peer に関連する統計カウンタを peer 毎に表示します。 -.PP -.B clockinfo -.I clock_peer_address -[ -.I addr2 -] [ -.I addr3 -] [ -.I addr4 -] -.PP +.It Xo clockinfo +.Ar clock_peer_address +.Op Ar addr2 +.Op Ar addr3 +.Op Ar addr4 +.Xc peer クロックに関する情報を得て、それを表示します。得られた値は、 設定上のあいまいな要因の情報と他のクロックの性能の情報を 提供してくれます。 -.PP -.B kerninfo -.PP -カーネルの phase-lock ループ操作パラメータを得て、それを表示します。 +.It kerninfo +カーネルのフェーズロックループ操作パラメータを得て、それを表示します。 この情報は、精度の高い時刻保持機能のために、カーネルが特に 修正されている場合にだけ得られます。 -.PP -.B loopinfo -[ -.B oneline|multiline -] -.PP +.It loopinfo Op Ar oneline|multiline 選択されたループフィルタ変数の値を表示します。ループフィルタとは、 -ローカルシステムクロックの調節を行なう NTP の一部です。 -\*(L"offset\*(R" は、パケット処理コードによってループフィルタに -与えられる最後のオフセットです。 \*(L"frequency\*(R" は、 +ローカルシステムクロックの調節を行なう +.Tn NTP +の一部です。 +.Qq offset +は、パケット処理コードによってループフィルタに与えられる最後のオフセットです。 +.Qq frequency +は、 parts-per-million (ppm) で表わされるローカルクロックの周波数誤差です。 -\*(L"time_const\*(R" は、 phase-lock ループの"堅固さ"を制御し、 -その速度で発振器のゆらぎを調節します。 \*(L"watchdog timer\*(R" の値は、 -ループフィルタに最後のサンプルのオフセットが与えられてから経過した秒数です。 -\*(L"oneline\*(R" と \*(L"multiline\*(R" オプションはこの情報が -出力されるフォーマットの指定で、 \*(L"multiline\*(R" がデフォルトです。 -.PP -.B sysinfo -.PP -システム状態変数、すなわち、ローカルサーバに関する状態の変化を -表示します。 -最後の 4 行以外は、皆 NTP バージョン 3 仕様である RFC 1305 で -述べられています。 \*(L"system flags\*(R" は、いろいろなシステムフラグ -を表示し、一部は \*(L"enable\*(R" 及び \*(L"disable\*(R" 設定コマンド -で、それぞれの設定やクリアができます。 \*(L"stability\*(R" は、 -システム周波数の修正がされた後に残る残留周波数誤差で、 +.Qq time_const +は、フェーズロックループの +.Qq 堅固さ +を制御し、その速度で発振器のゆらぎを調節します。 +.Qq watchdog timer +の値は、ループフィルタに最後のサンプルのオフセットが与えられてから経過した秒数です。 +.Ar oneline +と +.Ar multiline +オプションはこの情報が +出力されるフォーマットの指定で、 +.Ar multiline + がデフォルトです。 +.It sysinfo +システム状態変数、すなわち、ローカルサーバに関する状態の変化を表示します。 +最後の 4 行以外は、皆 +.Tn NTP +バージョン 3 仕様である RFC 1305 で述べられています。 +.Qq system flags +は、いろいろなシステムフラグを表示し、一部は +.Qq enable +及び +.Qq disable +設定コマンドで、それぞれの設定やクリアができます。 +.Qq stability +は、システム周波数の修正がされた後に残る残留周波数誤差で、 保守やデバッグに使われます。 多くのアーキテクチャでは、この値は初期の 500 ppm 程度から、.01 から 0.1 ppm という低い範囲にまで減少します。 もしデーモンが起動されてからも、この値が高いままである場合は、 -ローカルな時計がどこかおかしいか、カーネル変数 \*(L"tick\*(R" が -間違っているかもしれません。 \*(L"broadcastdelay\*(R" は、 -\*(L"broadcastdelay\*(R" 変更コマンドで設定されるデフォルトの -ブロードキャスト遅延時間を表示し、 \*(L"authdelay\*(R" は、 -\*(L"authdelay\*(R"変更コマンドで設定されるデフォルトの認証遅延時間を -表示します。 -.PP -.B sysstats -.PP +ローカルな時計がどこかおかしいか、カーネル変数 +.Qq tick +が間違っているかもしれません。 +.Qq broadcastdelay +は、 +.Qq broadcastdelay +変更コマンドで設定されるデフォルトのブロードキャスト遅延時間を表示し、 +.Qq authdelay +は、 +.Qq authdelay +変更コマンドで設定されるデフォルトの認証遅延時間を表示します。 +.It sysstats プロトコルモジュールで管理される統計カウンタを表示します。 -.PP -.B memstats -.PP +.It memstats メモリ割り当てコードに関する統計カウンタを表示します。 -.PP -.B iostats -.PP +.It iostats 入力\-出力モジュールで管理される統計カウンタを表示します。 -.PP -.B timerstats -.PP -timer/event キューをサポートするコードで管理される統計カウンタを -表示します。 -.PP -.B reslist -.PP +.It timerstats +タイマ/イベントキューをサポートするコードで管理される統計カウンタを表示します。 +.It reslist サーバの制限リストを得て、表示します。このリストは、 (通常) ソートされた順で出力され、制限がどのように適用されるかを 理解する助けになるかもしれません。 -.PP -.B monlist -[ -.I version -] -.PP +.It monlist Op Ar version モニタ機能により収集、管理されるトラフィックカウントの値を得て、表示します。 通常、バージョン番号は指定する必要がありません。 -.PP -.B clkbug -.I clock_peer_address -[ -.I addr2 -] [ -.I addr3 -] [ -.I addr4 -] -.PP +.It Xo clkbug +.Ar clock_peer_address +.Op Ar addr2 +.Op Ar addr3 +.Op Ar addr4 +.Xc 時刻参照ドライバのデバッグ情報を得ます。この情報は、 一部のクロックドライバでだけ提供され、 ドライバのソースのコピーが手元に無い場合、ほとんどデコードできません。 -.SH 実行時設定リクエスト -.PP -サーバ内で状態を変更するようなリクエストは、すべてサーバが設定した NTP +.El +.Sh 実行時設定リクエスト +サーバ内で状態を変更するようなリクエストは、すべてサーバが設定した +.Tn NTP キーを使って認証されます (この機能はキーを設定しないことで、無効にもできます) 。 キー番号とそれに対応するキーも、 -.I xtnpdc +.Nm が知っていなければなりません。 これは、 -.B keyid +.Em keyid と -.B passwd +.Em passwd コマンドを使えば可能で、後者では、暗号化されたキーを使うために パスワードを求めるプロンプトを端末に出します。 サーバへの認証リクエストを必要とするコマンドが最初に実行された場合でも、 自動的にキー番号とパスワードの入力を要求します。 認証は、そのような変更をする権限を持っているリクエストであるかを 検証するだけでなく、送信エラーに対するより一層の保護を行う事になります。 -.PP +.Pp 認証リクエストは、常にパケットデータの中に、認証コードの計算に 含まれているタイムスタンプを含んでいます。 このタイムスタンプは、サーバによって受信時刻と比較されます。この差がある小さな 値より大きければ、リクエストは拒否されます。これには二つの理由があります。 -一つは、あなたの LAN のトラフィックを盗み聞きできる誰かによるサーバへの -単純かつ繰り返しによる攻撃を困難にします。二つ目は、ネットワーク的に +1 つは、あなたの LAN のトラフィックを盗み聞きできる誰かによるサーバへの +単純かつ繰り返しによる攻撃を困難にします。2 つ目は、ネットワーク的に 離れたホストから、あなたのサーバへ設定変更リクエストを行なうことを 困難にします。 再設定は、ローカルホストのサーバに対しては簡単で、時刻同期した @@ -419,318 +365,277 @@ timer/event キューをサポートするコードで管理される統計カウンタを したがって、適当なパスワードを選択し、キーの配布と防護に注意を払い、 適切なソースアドレス制限が施されれば、実行時再設定の機能については 適切なセキュリティレベルにあることになります。 -.PP +.Pp 以下のコマンドは皆、認証リクエストです。 -.PP -.B addpeer -.I peer_address -[ -.I keyid -] [ -.I version# -] [ -.B prefer -] -.PP +.Bl -tag -width indent +.It Xo addpeer +.Ar peer_address +.Op Ar keyid +.Op Ar version# +.Op Ar prefer +.Xc 与えられたアドレスを設定された隣接 peer として追加し、symmetric active モードで動作します。 既に隣接 peer として設定されている peer を指定した場合、その peer は このコマンドが実行されたときに削除 されるか、単に新しい設定に従うよう適当に変更されます。 -オプションの \*(L"keyid\*(R" が 0 でない整数の場合、リモートサーバに +オプションの +.Ar keyid +が 0 でない整数の場合、リモートサーバに 出ていくすべてのパケットは、このキーにより暗号化された 認証フィールドを持つことになります。値が 0 の場合 (または指定されなかった場合)、認証は行なわれません。 -\*(L"version#\*(R" は、1, 2, 3 のどれか -となり、デフォルトは 3 です。 \*(L"prefer\*(R" キーワードは、 -優先する peer を示します(その結果、可能であれば時刻同期の主要元として -使用されます)。 +.Ar version# +は、1, 2, 3 のどれかとなり、デフォルトは 3 です。 +.Ar prefer +キーワードは、優先する peer を示します +(その結果、可能であれば時刻同期の主要元として使用されます)。 優先する peer は、 PPS 信号の信頼性も決めます。優先する peer が同期に 適している場合、PPS 信号も信頼できると判断されます。 -.PP -.B addserver -.I peer_address -[ -.I keyid -] [ -.I version# -] [ -.B prefer -] -.PP +.It Xo addserver +.Ar peer_address +.Op Ar keyid +.Op Ar version# +.Op Ar prefer +.Xc 操作モードがクライアントであること以外は、 -.B addpeer +.Em addpeer コマンドと同等です。 -.PP -.B broadcast -.I peer_address -[ -.I keyid -] [ -.I version# -] -.PP -操作モードが broadcast であること以外は、 -.B addpeer -コマンドと同等です。この場合、正当なキー識別子とキーが -必要になります。 \*(L"peer_address\*(R" パラメータは、 -ローカルネットワークのブロードキャストアドレスか、または NTP に -割り当てられたマルチキャストグループアドレス にできます。 +.It Xo broadcast +.Ar peer_address +.Op Ar keyid +.Op Ar version# +.Xc +操作モードがブロードキャストであること以外は、 +.Em addpeer +コマンドと同等です。この場合、正当なキー識別子とキーが必要になります。 +.Ar peer_address +パラメータは、ローカルネットワークのブロードキャストアドレスか、または +.Tn NTP + に割り当てられたマルチキャストグループアドレスにできます。 マルチキャストアドレスの場合、マルチキャストに対応したカーネルが 必要になります。 -.PP -.B unconfig -.I peer_address -[ -.I addr2 -] [ -.I addr3 -] [ -.I addr4 -] -.PP -このコマンドは、指定した peer (群) から設定されている bit を除きます。 +.It Xo unconfig +.Ar peer_address +.Op Ar addr2 +.Op Ar addr3 +.Op Ar addr4 +.Xc +このコマンドは、指定した peer (群) から設定済みを表すビットを除去します。 多くの場合、これによって隣接 peer の設定が削除されることになります。 -しかしながら、リモートの peer が設定されていない状態のまま継続しようとし、 -それが適切である場合は、隣接関係は、設定されていないモードのまま残る場合も -あります。 -.PP -.B fudge -.I peer_address -[ -.I time1 -] [ -.I time2 -] [ -.I stratum -] [ -.I refid -] -.PP +しかしながら、リモートの peer が未設定状態の継続を希望し、 +それが適切である場合は、隣接関係は未設定モードのまま残る場合もあります。 +.It Xo fudge +.Ar peer_address +.Op Ar time1 +.Op Ar time2 +.Op Ar stratum +.Op Ar refid +.Xc このコマンドは、あるデータを参照時刻としてセットすることができます。 詳しい情報は、ソースリストを見て下さい。 -.PP -.B enable auth|bclient|pll|monitor|stats -[ -.I ... -] -.PP -各種サーバオプションを有効にします。言及されていないフラグ -は影響を受けません。 \*(L"auth\*(R" フラグは、 peer が信頼できるキーと -キー識別子を使って正しく認証されたときだけ、設定されていない -peer にサーバを同期させます。 -デフォルトは無効 (オフ) です。 \*(L"bclient\*(R" フラグは、サーバが +.It Xo enable +.Ar auth|bclient|pll|monitor|stats +.Op Ar ... +.Xc +各種サーバオプションを有効にします。言及されていないフラグは影響を受けません。 +.Ar auth +フラグは、 peer が信頼できるキーと +キー識別子を使って正しく認証されたときだけ、未設定の +peer にサーバを同期させます。デフォルトは無効 (オフ) です。 +.Ar bclient +フラグは、サーバが ブロードキャストサーバやマルチキャストサーバからのメッセージを 聞く (listen) ようにして、 自動的にそのサーバと隣接関係を設定します。 -デフォルトは無効 (オフ) です。 \*(L"pll\*(R" フラグは、 -サーバがローカルクロックを修正するようにします。 +デフォルトは無効 (オフ) です。 +.Ar pll +フラグは、サーバがローカルクロックを修正するようにします。 デフォルトは有効 (オン) です。これが設定されていないと、ローカルクロック は内部の時間および周波数オフセットによって勝手に動作することになります。 -このフラグは、ローカルクロックが他のデバイスやプロトコルにより -制御されていて、 NTP は他のクライアントが同期するためだけに使われるような -場合に便利です。 \*(L"monitor\*(R" フラグは、 -モニタ機能 (他を参照のこと) を可能にするもので、 -デフォルトは無効 (オフ) です。 \*(L"stats\*(R" フラグは、統計機能 -ファイル出力 (他の説明を参照のこと) を可能にします。 -デフォルトは、有効 (オン) です。 -.PP -.B disable auth|bclient|pll|monitor|stats -[ -.I ... -] -.PP +このフラグは、ローカルクロックが他のデバイスやプロトコルにより制御されていて、 +.Tn NTP +は他のクライアントが同期するためだけに使われるような場合に便利です。 +.Ar monitor +フラグは、モニタ機能 (他を参照のこと) を可能にするもので、 +デフォルトは無効 (オフ) です。 +.Ar stats +フラグは、統計機能ファイル出力 (他の説明を参照のこと) を可能にします。 +デフォルトは有効 (オン) です。 +.It Xo disable +.Ar auth|bclient|pll|monitor|stats +.Op Ar ... +.Xc 各種サーバオプションを無効 (オフ) にします。言及されていない フラグは影響を受けません。現在有効なフラグは、 enable コマンドのところで 述べられています。 -.PP -.B restrict -.I address -.I mask -.I flag -[ -.I flag -] -.PP +.It Xo restrict +.Ar address +.Ar mask +.Ar flag +.Op Ar flag +.Xc フラグ (群) を存在する制限リストエントリに加えるか、または指定した フラグ (群) で新しいエントリをリストにつけ加えます。 可能なフラグ引数の選択は、以下の通りとなります: -.Ip ignore 10 +.Bl -tag -width indent +.It ignore このエントリにマッチするホストからのすべてのパケットを無視します。 このフラグが指定されると、どんな問い合わせやタイムサーバの ポーリングにも反応しなくなります。 -.Ip noquery 10 -ソースからの NTP mode 7 のパケット +.It noquery +ソースからの +.Tn NTP +モード 7 のパケット (すなわち、情報問い合わせと設定リクエスト) をすべて無視します。 時刻サービスは影響されません。 -.Ip nomodify 10 -サーバの状態を変更しようとする NTP mode 7 のパケット (すなわち、 -実行時再設定) をすべて無視します。 +.It nomodify +サーバの状態を変更しようとする +.Tn NTP +モード 7 のパケット (すなわち、実行時再設定) をすべて無視します。 情報を返すような問い合わせは許されます。 -.Ip notrap 10 +.It notrap 一致するホストへの、モード 6 制御メッセージのトラップサービスを 提供しません。このトラップサービスはモード 6 制御メッセージプロトコルの サブシステムで、リモートイベントの記録を行うようなプログラムで使用される 事を意図しています。 -.Ip lowpriotrap 10 +.It lowpriotrap 一致するホストによるトラップの優先度を低くします。 サーバが管理できるトラップの数は制限されています (現在の制限は 3)。 -トラップは、通常早い物勝ちベースで割り当てられ、制限に達すると以降の +トラップは、通常早い者勝ちベースで割り当てられ、制限に達すると以降の トラップ要求は拒否されます。このフラグは割り当てアルゴリズムを変更し、 優先度の低いトラップは後から発生した通常の優先度のトラップ要求により 無効にされるようになります。 -.Ip noserve 10 -モードが 7 以外の NTP パケットを無視します。要するに、問い合わせは受け +.It noserve +モードが 7 以外の +.Tn NTP +パケットを無視します。要するに、問い合わせは受け 付けるが、時刻サービスは拒否することになります。 -.Ip nopeer 10 +.It nopeer 問い合わせて来たホストに、状態を保存しない時刻サービスを行ないます。 しかし、たとえ将来同期先の相手として便利だとしても、 これらのホストには peer メモリのリソースを割り当てません。 -.Ip notrust 10 +.It notrust これらのホストを同期する元としては決して使用しませんが、その他の 部分では通常に扱います。 -.Ip limited 10 +.It limited これらのホストは同一のネットからのクライアントの数の制限を受けます。 この文脈でいう ネットとは、ネットの IP の概念 (クラス A 、クラス B 、クラス C 等) を 指します。 -サーバが認識している \*(L"client_limit\*(R" 以下のホスト数で、 -過去 \*(L"client_limit_period\*(R" 秒間アクティブ +サーバが認識している +.Qq client_limit +以下のホスト数で、過去 +.Qq client_limit_period +秒間アクティブ だったホストは受け入れられます。同じネットの他のクライアントからの リクエストは、拒否されます。時刻リクエストパケットだけが考慮されます。 -\*(L"private\*(R" と \*(L"control\*(R" と -\*(L"broadcast\*(R" のパケットは、クライアントの制限を受けず、 +.Qq Private , +.Qq control , +.Qq broadcast +のパケットは、クライアントの制限を受けず、 したがってクライアント数にも数えられません。 クライアントの履歴は、 -.I xntpd +.Xr xntpd 8 のモニタ機能により保存されます。 -したがって、モニタ機能は、 \*(L"limited\*(R" フラグで制限されたエントリが -ある限り機能します。 -デフォルトの \*(L"client_limit\*(R" 値は 3 です。 -デフォルトの \*(L"client_limit_period\*(R" 値は 3600 秒です。 -現在、どちらの変数も実行時には変更できません。 -.Ip ntpport 10 +したがって、モニタ機能は、 +.Ar limited +フラグで制限されたエントリがある限り機能します。 +デフォルトの +.Qq client_limit +値は 3 です。デフォルトの +.Qq client_limit_period +値は 3600 秒です。現在、どちらの変数も実行時には変更できません。 +.It ntpport これは制限フラグというより、実際にはマッチアルゴリズム修飾子です。 -これがあると、パケットのソースポートが標準 NTP UDP ポート (123) である -場合だけ、制限エントリがマッチします。 -\*(L"ntpport\*(R" と non\-\*(L"ntpport\*(R" の両方が指定できます。 -\*(L"ntpport\*(R" の方がより特別に扱われ、リスト中で -後ろの方にソートされます。 -.PP -.B unrestrict -.I address -.I mask -.I flag -[ -.I flag -] -.PP -.I address +これがあると、パケットのソースポートが標準 +.Tn NTP +UDP ポート (123) である場合だけ、制限エントリがマッチします。 +.Em ntpport +と +.Pf non\- Em ntpport +の両方が指定できます。 +.Em ntpport +の方がより特別に扱われ、リスト中で後ろの方にソートされます。 +.El +.It Xo unrestrict +.Ar address +.Ar mask +.Ar flag +.Op Ar flag +.Xc +.Ar address や -.I mask +.Ar mask の引数で指定された制限リストエントリから、指定されたフラグを除きます。 -.PP -.B delrestrict -.I address -.I mask -[ -.B ntpport -] -.PP +.It Xo delrestrict +.Ar address +.Ar mask +.Op Ar ntpport +.Xc 制限リストから一致するエントリを削除します。 -.PP -.B "monitor yes|no" -.PP +.It monitor Ar yes|no モニタ機能を有効または無効にします。 -.B "monitor no" +.Em monitor Ar no に続けて -.B "monitor yes" +.Em monitor Ar yes コマンドを送るのは、パケット数をリセットする良い方法です。 -.PP -.B readkeys -.PP +.It readkeys 現在の認証キーのセットを一掃し、キーファイル (これは -.I xntpd +.Nm xntpd 設定ファイルの中で指定されていなければなりません) の 再読み込みを行なって新しいセットにします。 こうすることで、サーバを再スタートさせずに暗号化キーの変更ができます。 -.PP -.B trustkey -.I keyid -[ -.I keyid -] [ -.I keyid -] [ -.I keyid -] -.PP -一つないしそれ以上のキーを、信頼キーリストに加えます。 +.It Xo trustkey +.Ar keyid +.Op Ar keyid +.Op Ar keyid +.Op Ar keyid +.Xc +1 つないしそれ以上のキーを、信頼キーリストに加えます。 認証が有効になっているとき、信頼性のある時刻を持つ peer は、 信頼キーを使って認証されなければなりません。 -.PP -.B untrustkey -.I keyid -[ -.I keyid -] [ -.I keyid -] [ -.I keyid -] -.PP -一つないしそれ以上のキーを、信頼キーリストから削除します。 -.PP -.B authinfo -.PP +.It Xo untrustkey +.Ar keyid +.Op Ar keyid +.Op Ar keyid +.Op Ar keyid +.Xc +1 つないしそれ以上のキーを、信頼キーリストから削除します。 +.It authinfo 既知のキーや実行された暗号化、復号化の数を含む、認証モジュールに関する 情報を返します。 -.PP -.B setprecision -.I precision_value -.PP -サーバが通知する精度の値を設定します。 +.It setprecision Ar precision_value +サーバが通知する精度を指定した値に設定します。 値は、 -4 から -20 の範囲の負の整数でなければなりません。 -.PP -.B traps -.PP +.It traps サーバに設定されているトラップを表示します。 詳しくはソースリストを参照して下さい。 -.PP -.B addtrap -.I address -[ -.I port -] [ -.I interface -] -.PP +.It Xo addtrap +.Ar address +.Op Ar port +.Op Ar interface +.Xc 非同期メッセージのトラップをセットします。 詳しくはソースリストを参照して下さい。 -.PP -.B clrtrap -.I address -[ -.I port -] [ -.I interface -] -.PP +.It Xo clrtrap +.Ar address +.Op Ar port +.Op Ar interface +.Xc 非同期メッセージのトラップを解除します。 詳しくはソースリストを参照して下さい。 -.PP -.B reset ... -.PP +.It reset Ar ... サーバのいろいろなモジュールのなかの統計カウンタをクリアします。 詳しくはソースリストを参照して下さい。 -.SH 関連項目 -.PP -.IR xntpd (8) -.SH 歴史 -.PP -Toronto 大学の Dennis Ferguson によって書かれました。 -.SH バグ -.PP -.I xntpdc +.El +.Sh 関連項目 +.Xr xntpd 8 +.Sh 歴史 +University of Toronto の +.An Dennis Ferguson +が作成しました。 +.Sh バグ +.Nm は、未完成のハックです。表示される情報の多くは死ぬほど退屈で、実装した 人間だけに気に入られるものです。このプログラムは、新しい (一時的な) 仕様を追加し易いようデザインされており、使いやすくするには手間が diff --git a/ja/man/man8/xtend.8 b/ja/man/man8/xtend.8 index 3a88892e27..f4ba50ee58 100644 --- a/ja/man/man8/xtend.8 +++ b/ja/man/man8/xtend.8 @@ -27,7 +27,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: xtend.8,v 1.4.2.3 1998/07/19 06:53:05 jkh Exp % +.\" %Id: xtend.8,v 1.9 1998/03/19 07:37:36 charnier Exp % .\" jpman %Id: xtend.8,v 1.2 1997/06/16 08:01:33 yugawa Stab % .\" .Th XTEND 8 "30 Oct 1993" diff --git a/ja/man/man8/yp_mkdb.8 b/ja/man/man8/yp_mkdb.8 index 26d0f8cb56..9c3f75eecb 100644 --- a/ja/man/man8/yp_mkdb.8 +++ b/ja/man/man8/yp_mkdb.8 @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: yp_mkdb.8,v 1.2.2.4 1998/07/18 11:38:12 jkh Exp % +.\" %Id: yp_mkdb.8,v 1.8 1998/03/23 08:30:19 charnier Exp % .\" jpman %Id: yp_mkdb.8,v 1.3 1997/05/19 17:09:21 horikawa Stab % .\" .Dd March 12, 1996 diff --git a/ja/man/man8/ypbind.8 b/ja/man/man8/ypbind.8 index 52fdda8fd2..db74f85b71 100644 --- a/ja/man/man8/ypbind.8 +++ b/ja/man/man8/ypbind.8 @@ -29,7 +29,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: ypbind.8,v 1.5.2.3 1997/11/18 07:37:39 charnier Exp % +.\" %Id: ypbind.8,v 1.12 1998/03/23 08:30:31 charnier Exp % .\" jpman %Id: ypbind.8,v 1.4 1997/06/18 16:55:44 horikawa Stab % .\" .Dd April 9, 1995 @@ -43,6 +43,7 @@ .Op Fl ypset .Op Fl ypsetme .Op Fl s +.Op Fl m .Op Fl S Ar domainname,server1,server2,... .Sh 解説 .Nm @@ -134,6 +135,23 @@ domain/server 指定においては、コンマの間には空白を入れてはなりません。 .Fl S フラグにより指定されるドメイン名を、システムデフォルトドメインと解釈 することに注意して下さい。 +.It Fl m +制限されたモードのサーバリストからのサーバ選択において、 +.Nm +にブロードキャストではなく、 +「メニーキャスト(many-cast)」を使用させます。 +メニーキャストモードでは、制限されたリストで指定されるサーバの +YPPROC_DOMAIN_NONACK プロシジャに対して直接通信し、 +最も速く返答したサーバに対してバインドします。 +NIS サーバがローカルにない NIS クライアントにおいて、 +このモードが有用です。 +.Fl m +フラグは上述の +.Fl S +フラグと組み合わせてのみ使用可能です ( +.Fl S +フラグと組み合わせない場合には効果がありません)。 +.El .Sh 注釈 .Nm は 2 番目のドメインのバインドを連続して保持しようとはしません。 diff --git a/ja/man/man8/yppush.8 b/ja/man/man8/yppush.8 index 40cc97e6aa..115e271cb3 100644 --- a/ja/man/man8/yppush.8 +++ b/ja/man/man8/yppush.8 @@ -29,7 +29,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: yppush.8,v 1.4.2.1 1997/11/18 07:45:16 charnier Exp % +.\" %Id: yppush.8,v 1.8 1998/03/23 08:30:51 charnier Exp % .\" jpman %Id: yppush.8,v 1.3 1997/09/09 04:08:40 yugawa Stab % .\" .Dd February 5, 1995 diff --git a/ja/man/man8/ypserv.8 b/ja/man/man8/ypserv.8 index 468bb7e702..7f63013630 100644 --- a/ja/man/man8/ypserv.8 +++ b/ja/man/man8/ypserv.8 @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: ypserv.8,v 1.8.2.3 1997/11/18 07:52:07 charnier Exp % +.\" %Id: ypserv.8,v 1.15 1998/03/23 08:31:07 charnier Exp % .\" jpman %Id: ypserv.8,v 1.3 1997/05/19 17:11:16 horikawa Stab % .\" .Dd February 4, 1995 diff --git a/ja/man/man8/ypset.8 b/ja/man/man8/ypset.8 index 25be2a654e..29eb480d0a 100644 --- a/ja/man/man8/ypset.8 +++ b/ja/man/man8/ypset.8 @@ -29,7 +29,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: ypset.8,v 1.1.2.2 1997/11/18 07:54:08 charnier Exp % +.\" %Id: ypset.8,v 1.6 1998/03/23 08:31:20 charnier Exp % .\" jpman %Id: ypset.8,v 1.2 1997/04/06 14:59:23 horikawa Stab % .\" .Dd October 25, 1994 diff --git a/ja/man/man8/ypxfr.8 b/ja/man/man8/ypxfr.8 index 6850761ecb..8fdd3d13d3 100644 --- a/ja/man/man8/ypxfr.8 +++ b/ja/man/man8/ypxfr.8 @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: ypxfr.8,v 1.3.2.2 1998/07/19 06:53:05 jkh Exp % +.\" %Id: ypxfr.8,v 1.8 1998/03/19 07:37:43 charnier Exp % .\" jpman %Id: ypxfr.8,v 1.3 1997/09/09 04:09:30 yugawa Stab % .\" .Dd February 5, 1995 diff --git a/ja/man/man8/zdump.8 b/ja/man/man8/zdump.8 index e6de1b3291..144770eb77 100644 --- a/ja/man/man8/zdump.8 +++ b/ja/man/man8/zdump.8 @@ -1,6 +1,6 @@ .\" .\" @(#)zdump.8 7.3 -.\" %Id: zdump.8,v 1.4.2.1 1998/03/09 14:14:30 jkh Exp % +.\" %Id: zdump.8,v 1.5 1998/02/04 07:30:11 charnier Exp % .\" jpman %Id: zdump.8,v 1.3 1997/08/30 18:39:05 take-i Stab % .\" .Dd September 13, 1994 diff --git a/ja/man/man8/zic.8 b/ja/man/man8/zic.8 index 6649a8cbfe..2a87a10c4d 100644 --- a/ja/man/man8/zic.8 +++ b/ja/man/man8/zic.8 @@ -176,7 +176,7 @@ Sun<=25 25 日以前の最後の日曜日 これらの形式の最後に .Em w をつけると、指定した時刻がローカルの -.Sq "ウォールクロック" +.Dq "ウォールクロック" (夏時間の適用される地域で、ローカルの標準時に、 夏時間の期間であればその修正を加えた時刻) .\" 上記の()内の記述は、wall clock では、特に日本人には @@ -186,7 +186,7 @@ Sun<=25 25 日以前の最後の日曜日 であり、 .Em s をつけると、指定した時刻がローカルの -.Sq 標準時 +.Dq 標準時 であり、 .Em u (あるいは @@ -207,15 +207,15 @@ Sun<=25 25 日以前の最後の日曜日 を指定する事はできません)。 .It LETTER/S ルールが有効な場合にタイムゾーンの短縮形に用いられる -.Sq "変化部分" +.Dq "変化部分" (例えば、 -.Sq EST +.Dq EST や -.Sq EDT +.Dq EDT の -.Sq S +.Dq S や -.Sq D +.Dq D ) を指定します。 このフィールドが @@ -260,7 +260,7 @@ GMT から時刻を引く場合は、フィールドの最初にマイナスをつけます。 文字列 .Em %s は、タイムゾーンの短縮形で用いられる -.Sq "変化部分" +.Dq "変化部分" を示します。 一方、 スラッシュ (/) @@ -272,9 +272,9 @@ GMT から時刻を引く場合は、フィールドの最初にマイナスをつけます。 およびルールからタイムゾーンの情報が生成されます。 .Pp この次の行は -.Sq 継続 +.Dq 継続 行でなくてはなりません。この行は最初の -.Sq Zone +.Dq Zone と NAME フィールドがない点を除いてはゾーン行と同一の形式で、その前の行の .Em UNTIL フィールドで指定した時刻以降の情報を指定します。 @@ -329,9 +329,9 @@ Leap 1974 Dec 31 23:59:60 + S .Em CORR フィールドは、 秒が加えられる場合は -.Sq + +.Dq + で、秒がスキップされる場合は -.Sq - +.Dq - となります。 .\" There's no need to document the following, since it's impossible for more .\" than one leap second to be inserted or deleted at a time. @@ -347,11 +347,11 @@ Leap 1974 Dec 31 23:59:60 + S .Em R/S フィールドは 他のフィールドで与えられるうるう秒の時刻が GMT である場合は、 -.Sq Stationary +.Dq Stationary (またはその短縮形)で、 他のフィールドで与えられるうるう秒の時刻がローカルのウォールクロックである 場合は、 -.Sq Rolling +.Dq Rolling (またはその短縮形)となります。 .Sh 注釈 ローカル時刻が複数のタイプとなる地域では、 |
