diff options
| author | Hiroyuki Hanai <hanai@FreeBSD.org> | 1998-02-25 04:54:20 +0000 |
|---|---|---|
| committer | Hiroyuki Hanai <hanai@FreeBSD.org> | 1998-02-25 04:54:20 +0000 |
| commit | 8384f4bcfce51214ce5b2fa99a60d7db4e02363f (patch) | |
| tree | 9a912a1c634d7df0309fe385710d13ec918f04cd /ja_JP.eucJP/man/man8 | |
| parent | ab973c72d17604d5e87846977f5228b5a042e631 (diff) | |
Notes
Diffstat (limited to 'ja_JP.eucJP/man/man8')
212 files changed, 41178 insertions, 0 deletions
diff --git a/ja_JP.eucJP/man/man8/IPXrouted.8 b/ja_JP.eucJP/man/man8/IPXrouted.8 new file mode 100644 index 0000000000..a87c8fe8ca --- /dev/null +++ b/ja_JP.eucJP/man/man8/IPXrouted.8 @@ -0,0 +1,177 @@ +.\" Copyright (c) 1986, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Copyright (c) 1995 John Hay. 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. +.\" +.\" 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. +.\" jpman %Id: IPXrouted.8,v 1.3 1997/07/27 13:00:54 horikawa Stab % +.\" +.Dd Oct 11, 1995 +.Dt IPXROUTED 8 +.Os FreeBSD +.Sh 名称 +.Nm IPXrouted +.Nd IPX Routing Information Protocol デーモン +.Sh 書式 +.Nm IPXrouted +.Op Fl q +.Op Fl s +.Op Fl S +.Op Fl t +.Op Ar logfile +.Sh 解説 +.Nm +は IPX 経路テーブルを扱うために、ブート時に起動されます。 +IPX 経路デーモンは、カーネルの経路テーブルエントリを最新に +保つために Novell の IPX Routing Information Protocol を用います。 +.Pp +使用可能なオプション: +.Bl -tag -width logfile +.It Fl q +(下記の +.Fl s +オプションとは反対に) 経路情報を提供しません。 +.It Fl s +ネットワークをつなぐルータであるないにかかわらず、 +.Nm +が強制的に経路情報を提供するようにします。 +.It Fl S +Service Advertizing Protocol +.Nm (SAP) +情報を提供しません。デフォルトでは +.Nm SAP +情報を提供します。 +.It Fl t +送信・受信されたすべてのパケットを標準出力に表示します。 +加えて、 +.Nm +はコントロールターミナルから切り離されないので、キーボードからの +割り込みはプロセスを kill することになります。 +.It Ar logfile +.Nm IPXrouted +の +行動が記録されるファイル名を指定します。 +このログには、経路テーブルのすべての変更についての情報や、 +経路の変更に関わる最近の送受信メッセージの履歴が記録されます。 +.El +.Pp +通常、 +.Nm +は経路情報パケットを listen します。 +ホストが複数の IPX ネットワークに接続されている場合には、 +直接接続されているホストやネットワークすべてに経路テーブルの +コピーを定期的に提供します。 +.Pp +.Nm +が起動されると、 +.Dv SIOCGIFCONF +.Xr ioctl 2 +を用いて、システムに組み込まれ、 +.Dq up +となっているインタフェースを探します +(ソフトウェアループバックインタフェースは無視されます)。 +インタフェースが複数ある場合には、そのホストがネットワーク間で +パケットを転送するとみなします。 +そして +.Nm +は各インタフェースに +.Em リクエスト +パケットを送信し(インタフェースがサポートしていれば +ブロードキャストパケットを用います)、他のホストから +.Em リクエスト +と +.Em レスポンス +のパケットが来るのを listen し続けます。 +.Pp +.Em リクエスト +パケットを受け取ると、内部のテーブルに基づく情報から返答パケットを +作成します。 +作成された +.Em レスポンス +パケットは既知の経路の一覧を含み、各々は +.Dq hop count +metric を持っています(16 以上の count は +.Dq 無限大 +(到達不可能) +を示します)。 +返答された各々の経路に関する metric は、送信元からの +.Em "相対的な" +metric を提供します。 +.Pp +以下の条件を一つでも満たす場合、 +.Nm +が受け取った +.Em レスポンス +パケットは経路テーブルの更新に使われます: +.Bl -bullet +.It +宛先となるネットワークやホストへの経路テーブルエントリが +存在せず、 metric が宛先が到達可能であるとしている +(hop count が無限大でない)とき。 +.It +パケットの送信元ホストが、保持している経路テーブルエントリ内の +ルータと同じであるとき。 +すなわち更新された情報が、 +宛先へのパケットが経由するネットワーク間ルータからもたらされたとき。 +.It +経路テーブル内に存在するエントリがしばらくの間(定義では 90 秒) +更新されず、その経路が現在の経路と少なくとも同じ程度効率的であるとき。 +.It +現在経路テーブル内に保持しているものよりも、新しい経路のほうが短いとき。 +この判断にはテーブル内の経路の metric と新しい経路の metric が +比較されます。 +.El +.Pp +更新が受け入れられた場合、 +.Nm +は変更を内部テーブルに記録し、 +.Em レスポンス +パケットをすべての直接つながったホストとネットワークに流します。 +.Xr routed 8 +は、カーネルの経路テーブルを更新する前に、不安定な状態から +抜け出せるようにするために、しばらくの間(30 秒以内)待ちます。 +.Pp +.Nm +は入ってくるパケットを処理するだけではなく、経路テーブル +エントリを定期的にチェックします。 +エントリが 3 分間更新されなかった場合、エントリの metric は +無限大に設定され、削除予定の印がつけられます。 +実際の削除は、エントリの無効化が他のルータに伝わるのを確実に +するために、さらに 60 秒後に行われます。 +.Pp +ネットワークをつなぐルータとなっているホストは、 30 秒ごとに +直接つながったすべてのホストとネットワークに自分の +経路テーブルを提供します。 +.Pp +.Nm +が SIGINFO シグナルを受け取った場合、RIP と SAP テーブルの +現在の内容がファイル /tmp/ipxrouted.dmp に追加されます。 +.Sh 関連項目 +.Xr ipx 3 +.Sh 歴史 diff --git a/ja_JP.eucJP/man/man8/MAKEDEV.8 b/ja_JP.eucJP/man/man8/MAKEDEV.8 new file mode 100644 index 0000000000..f9a593e489 --- /dev/null +++ b/ja_JP.eucJP/man/man8/MAKEDEV.8 @@ -0,0 +1,93 @@ +.\" Copyright (c) 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. +.\" +.\" 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. +.\" +.\" @(#)MAKEDEV.8 8.1 (Berkeley) 6/5/93 +.\" jpman %Id: MAKEDEV.8,v 1.3 1997/07/22 09:19:04 mutoh Stab % +.\" %Id: MAKEDEV.8,v 1.5.2.1 1996/12/31 22:57:58 mpp Exp % +.\" +.Dd June 5, 1993 +.Dt MAKEDEV 8 i386 +.Os +.Sh 名称 +.Nm MAKEDEV +.Nd システムとデバイススペシャルファイルの作成 +.Sh 書式 +.Nm +name ... +.Sh 解説 +このシェルスクリプト +.Nm +は、 ``/dev'' ディレクトリにあり、通常のスペシャルファイルを作成するのに +使われます。 +スペシャルファイルに関するより徹底した議論が必要ならば、 +.Xr intro 4 +をご覧ください。 +.Pp +.Nm +は、何個かのデバイス名を引数に取ります。 +ここでのデバイス名は、デバイスに対する、よくある省略形です。 +``std'' と ``local'' という、二つのスペシャルデバイスがあります。 +前者はそのアーキテクチャの標準デバイスを作成します。 +後者はローカルサイトの固有のデバイスの為のもので、 +シェルファイル ``MAKEDEV.local'' を実行します。 +.Pp +i386 アーキテクチャでは次のデバイスをサポートします。 +ここで、ハッシュ記号(``#'')を伴ったデバイス名は、 +ハッシュ記号をユニット番号で置き換えます。 +.Bl -tag -width indent +.It std +標準デバイス (console, drum, fd/*, klog, kmem, mem, null, +stderr, stdin, stdout, tty) です。 +.It local +コンフィギュレーション固有のデバイスです。 +.It tty# +標準 PC COM ポートです。 +.It fd# +``フロッピ'' ディスクドライブ (3 1/2, 5 1/4) です。 +.It pty# +16対の仮想端末マスタとスレーブです。 +.It sd# +SCSI ディスクドライブです。 +.It st# +SCSI テープドライブです。 +.It wd# +``ウィンチェスタ'' ディスクドライブ (ST506, IDE, ESDI, RLL など) です。 +.It wt# +QIC-インタフェースの (つまり、SCSI ではない) 3M カートリッジテープです。 +.El +.Sh 関連ファイル +.Bl -tag -width /dev/xxxx -compact +.It Pa /dev +スペシャルファイルのディレクトリ +.Sh 関連項目 +.Xr intro 4 , +.Xr config 8 , +.Xr mknod 8 diff --git a/ja_JP.eucJP/man/man8/ac.8 b/ja_JP.eucJP/man/man8/ac.8 new file mode 100644 index 0000000000..ffbc2b4b67 --- /dev/null +++ b/ja_JP.eucJP/man/man8/ac.8 @@ -0,0 +1,161 @@ +.\" +.\" Copyright (c) 1994 Simon J. Gerraty +.\" Copyright (c) 1994 Christopher G. Demetriou +.\" 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 Christopher G. Demetriou. +.\" 3. 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: ac.8,v 1.6.2.2 1997/09/02 06:28:56 charnier Exp % +.\" jpman %Id: ac.8,v 1.3 1997/07/22 16:35:12 horikawa Stab % +.\" +.Dd March 15, 1994 +.Dt AC 8 +.Os +.Sh 名称 +.Nm ac +.Nd 接続時間の計測 +.Sh 書式 +.Nm +.Op Fl dp +.\".Op Fl c Ar console +.Op Fl t Ar tty +.Op Fl w Ar wtmp +.Op Ar users ... +.Sh 解説 +.\" Nm ac から ac 削除。 +.\" オリジナルで Ac が \&Ac となっていたのは Ac が mdoc コマンド +.\" Angle close quote(see mdoc(7)) であるため +.\" horikawa@jp.freebsd.org 1997/11/03 +もしファイル +.Pa /var/log/wtmp +が存在すれば、個々のログイン時刻とログアウト時刻の記録が、各々 +.Xr login 1 +と +.Xr init 8 +によって書き込まれます。 +.Nm +はこれらの記録を検査し、ログイン全ての累積接続時間 (時間単位) を +標準出力に書き出します。 +.Pp +オプションは次の通りです。 +.Bl -tag -width indentXXX +.It Fl d +接続時間を 24 時間単位で表示します。 +.\" .It Fl c Ar console +.\" .Ar console +.\" を、ローカル X セッション (ut_host が ":0.0" の場合) +.\" を始めるデバイス名として使います。 +.\" .Ar console +.\" 上に記録されたログインはどれも、コンパイル時に COMPAT_SUNOS が +.\" 定義されていない限り、これらの X セッションは無視されます。 +.It Fl p +各々のユーザの合計を表示します。 +.It Fl t Ar tty +特定の tty からのログインだけを計測します。 +.Ar tty +が '!' で始まっている場合はそれ以外の tty +を示し、'*' で終っている場合は、同様な全ての tty を示します。 +複数の +.Fl t +フラグを指定しても構いません。 +.It Fl w Ar wtmp +接続時間のデータを、デフォルトファイル +.Pa /var/log/wtmp +の代りに +.Ar wtmp +から読み込みます。 +.It Ar users ... +与えられたユーザの合計だけを表示します。 +.El +.Pp +もし、引数が与えられなければ、 +.Nm +はログインセッションが +.Pa wtmp +に記録された全てのアカウントの合計接続時間を表示します。 +.Pp +デフォルトの +.Pa wtmp +ファイルは、切り捨て (truncate) をしない限り、際限なく増加します。 +これは通常、 +.Xr cron 8 +によって起動されるデイリースクリプトによって切り捨てが行なわれます。 +デイリースクリプトは +.Pa wtmp +ファイルの改名と巡回 (rotate) を行ない、 +一週間分のデータを手元に保持します。 +ログインや接続時間のアカウントは、もし +.Pa /var/log/wtmp +が存在しなければ、行なわれません。 +.Pp +例えば +.Bd -literal -offset +ac -p -t "ttyd*" > modems +ac -p -t "!ttyd*" > other +.Ed +.Pp +とすると、 +.Pa modems +に記録された時間と、 +.Pa other +のそれで、別の料金を請求することもできます。 +.Pp +.Nm +ユーティリティは、 +実行に成功したときには 0 で終了し、 +致命的エラーが発生したときには >0 で終了します。 +.Sh 関連ファイル +.Bl -tag -width /var/log/wtmp.[0-7] -compact +.It Pa /var/log/wtmp +接続時間アカウントファイル +.It Pa /var/log/wtmp.[0-7] +巡回されたファイル +.El +.Sh 関連項目 +.Xr login 1 , +.Xr utmp 5 , +.Xr init 8 , +.Xr sa 8 +.\" .Sh 注釈 +.\" もし COMPAT_SUNOS が定義されていると +.\" .Nm ac +.\" は ut_host が ":0.0" のエントリが本当のログインセッションではない +.\" という事実を無視します。 +.\" 通常はこのようなエントリは、 +.\" .Pa wtmp +.\" ファイルが巡回されたときにログインしているユーザの場合を除いて +.\" 無視されます。 +.\" この場合、ut_host が ":0.0" のログインが、 +.\" それ以前にコンソールへのログインがないのに現われるかもしれません。 +.\" もし誰もコンソールにログインしていなければ、そのユーザは +.\" .Pa wtmp +.\" のもっとも早いタイムスタンプの時に既にログインしていたと思われます。 +.\" .Pa console +.\" を使うことで、 +.\" .Nm ac +.\" はユーザのログアウトを識別し、正しく処理できるようになります。 +.\" .Pa console +.\" のデフォルト値はコンパイル時の正しい値です。 diff --git a/ja_JP.eucJP/man/man8/accton.8 b/ja_JP.eucJP/man/man8/accton.8 new file mode 100644 index 0000000000..4aa33af201 --- /dev/null +++ b/ja_JP.eucJP/man/man8/accton.8 @@ -0,0 +1,34 @@ +.Dd "May 21, 1993" +.\" jpman %Id: accton.8,v 1.3 1997/07/27 12:02:03 horikawa Stab % +.Dt ACCTON 8 +.Os +.Sh 名称 +.Nm accton +.Nd システムのアカウンティングの許可/禁止 +.Sh 書式 +.Nm accton +.Op Ar acctfile +.Sh 解説 +.Nm +コマンドはシステムのアカウンティングのオン/オフを切り換えます。 +もし +.Ar acctfile +引数を付けて呼び出された場合、 +システムのアカウンティングが許可されます。 +.Xr execve 2 +システムコールで開始され、その後システムを終了した +全てのプロセスの記録が +.Ar acctfile +ファイルに格納されます。 +.Xr sa 8 +コマンドがアカウンティング記録の検査に使われるかもしれません。 +もし引数が与えられなかった場合、システムアカウンティングは禁止されます。 +.Sh 関連ファイル +.Bl -tag -width /var/account/acct +.It Pa /var/account/acct +デフォルトのアカウンティングファイル +.El +.Sh 関連項目 +.Xr lastcomm 1 , +.Xr acct 2 , +.Xr sa 8 diff --git a/ja_JP.eucJP/man/man8/adding_user.8 b/ja_JP.eucJP/man/man8/adding_user.8 new file mode 100644 index 0000000000..f576d3b8b2 --- /dev/null +++ b/ja_JP.eucJP/man/man8/adding_user.8 @@ -0,0 +1,125 @@ +.\" Copyright (c) 1980, 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. +.\" +.\" 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. +.\" +.\" @(#)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 % +.\" jpman %Id: adding_user.8,v 1.3 1997/07/22 16:44:29 horikawa Stab % +.\" +.Dd June 5, 1993 +.Dt ADDING_USER 8 +.Os BSD 4 +.Sh 名称 +.Nm adding_user +.Nd 新規ユーザ登録のためのプロシージャ +.Sh 解説 +新規ユーザはログイン名を選ばなければなりません。 +ここで、ログイン名は既に +.Pa /etc/passwd +や +.Pa /etc/aliases +に登録されているものであってはいけません。 +また、ハイフン +.Ql Fl +文字で始まるものも使えません。 +メーラを混乱させないためにも、全ての文字は英小文字でドット +.Ql \&. +文字を含まないことが、強く推奨されています。 +アカウントは、パスワードファイルを一行編集することで加えることが +できます。これを行う時は、パスワードファイルはロックされていなければ +なりません。このロックは、 +.Xr chpass 1 +や +.Xr vipw 8 +を使うことで可能です。 +.Pp +新規ユーザには、グループとユーザ id を与えます。 +ログイン名とユーザ id は、システム全体やしばしばシステムグループで +一意でなければなりません。これは、ファイルのアクセスを制御するために +使われるからです。 +典型的には、似たようなプロジェクトで働いているユーザは同じグループに +入ります。カルフォルニア大学バークレイ分校では、システムスタッフ・ +学部・大学院・大きなプロジェクトのための特別なプロジェクトのグループが +あります。 +.Pp +新規ユーザ +\*(lqernie\*(rq +のための骨格となるアカウントは、以下のようになります。 +.Bd -literal +ernie::25:30::0:0:Ernie Kovacs,508 Evans Hall,x7925, + 642-8202:/a/users/ernie:/bin/csh +.Ed +.Pp +個々のフィールドの解説は、 +.Xr passwd 5 +を参照してください。 +.Pp +新規ユーザに始めるにあたっていくつかの助けを与えることは良いことです。 +このために、いくつかの骨格となるファイルを与えてあげれます。 +.Pa /bin/sh +ユーザには、 +.Pa \&.profile +を、 +.Pa /bin/csh +ユーザには、 +.Pa \&.cshrc +や +.Pa \&.login +を与えれば良いでしょう。 +.Pa /usr/share/skel +ディレクトリに、そのようなファイルの骨格の定義を置いておけます。 +新規ユーザは、これらのファイルの複製を与えられます。 +ここで、例えば +.Xr tset 1 +をログインする度に自動的に実行するように設定できます。 +.Sh 関連ファイル +.Bl -tag -width /etc/master.passwdxx -compact +.It Pa /etc/master.passwd +ユーザデータベース +.It Pa /usr/share/skel +ログインディレクトリのための骨格データ +.El +.Sh 関連項目 +.Xr chpass 1 , +.Xr finger 1 , +.Xr passwd 1 , +.Xr aliases 5 , +.Xr passwd 5 , +.Xr adduser 8 , +.Xr pwd_mkdb 8 , +.Xr vipw 8 +.Sh バグ +ユーザ情報は (段々とそうなってきていますが)、別のところに +記憶するべきです。 +.Sh 歴史 +.Nm +プロシージャは +.Bx 3.0 +から導入されました. diff --git a/ja_JP.eucJP/man/man8/adduser.8 b/ja_JP.eucJP/man/man8/adduser.8 new file mode 100644 index 0000000000..7c18dd79b5 --- /dev/null +++ b/ja_JP.eucJP/man/man8/adduser.8 @@ -0,0 +1,291 @@ +.\" Copyright (c) 1995-1996 Wolfram Schneider <wosch@FreeBSD.org>. Berlin. +.\" 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. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: adduser.8,v 1.12.2.5 1997/10/14 17:34:01 wosch Exp % +.\" jpman %Id: adduser.8,v 1.4 1997/08/07 17:53:51 ken Stab % +.\" +.Dd January 9, 1995 +.Dt ADDUSER 8 +.Os FreeBSD 2.1 +.Sh 名称 +.Nm adduser +.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 +.br +.Op Fl config_create +.br +.Op Fl dotdir Ar dotdir +.br +.Op Fl group Ar login_group +.br +.Op Fl h | help +.br +.Op Fl home Ar home +.br +.Op Fl message Ar message_file +.br +.Op Fl noconfig +.br +.Op Fl shell Ar shell +.br +.Op Fl s | silent | q | quiet +.br +.Op Fl uid Ar uid_start +.br +.Op Fl v | verbose +.Sh 解説 +.Nm +は新しいユーザを加えるための簡単なプログラムです。 +.Nm +はパスワード, グループ, シェル等のデータベースをチェックし、 +passwd/group の登録を行い、 +.Ev HOME +ディレクトリとドットファイルを作成し、 +新しいユーザに歓迎メッセージを送ります。 +.Sh 制限事項 +.Bl -tag -width Ds -compact +.It Sy username +ログイン名は、小文字もしくは数字だけからなる最大 8 文字の文字列でな +ければなりません ( +.Xr setlogin 2 +のバグの章を参照してください)。この制限の理由は、 ``歴史的な'' 物で +す。美的な理由からこの制限を破りたいとする人々はいつもいましたが、 +UNIX における基本的なパラメータを変更するほどの重要な理由ではありま +せんでした。 +.Pa /usr/include/utmp.h +ファイル内の +.Dv UT_NAMESIZE +パラメータを変更し、全てを再コンパイルすることで、変更できますが、コ +ンパイル済みのプログラムや名前の8文字制限を前提としたソースコード、 +そして NIS については、問題が起こるでしょう。 NIS のプロトコルは、ユー +ザ名を 8 文字と定めています。電子メールアドレスとして、もっと長いロ +グイン名を必要とする場合には、別名を +.Pa /etc/aliases +ファイルに定義することができます。 +.It Sy fullname +姓と名です。 +.Ql Pa \: +(コロン) は、使えません。 +.It Sy shell +シェルデータベースに定義されている有効なシェル、もしくは、 sliplogin +と pppd だけが有効です。 +.It Sy uid +自動生成されますが、自分で指定することもできます。ただし、 32000 よ +りも小さい数字でなければなりません。 +.It Sy gid/login group +あなたが指定したものです。さもなければ、自動的に生成されます。 +.It Sy password +定義した時には、パスワードは +.Xr crypt 3 +を利用して暗号化されます。 +.El +.Sh 一意なグループ +ひょっとして、あなたは、この方法ではできても他のほとんどの方法ではう +まく行かないことがあるのを見逃しているかもしれません。個々のユーザを +そのユーザ独自のグループに入れることで、 umask を 002 としておいても +安全になり、ホームディレクトリにファイルを作っても、他の人にファイル +を読まれる心配がなくなります。 +.Pp +共有場所を作るためには、 (freefall における cvs や ncvs のように) +uid/gid を別に設けて、ユーザを個別にその新しいグループに入れることで、 +その場所へのアクセスを可能とすべきです。 +.Pp +この uid/gid の管理モデルは、たくさんのユーザをグループにまとめるよ +り柔軟性があり、共有場所で仕事をする時に umask をいじり回さずにすみ +ます。 +.Pp +この方法をほぼ 10 年間使っていますが、ほとんどの場合に使えることがわ +かり、じゃまになったことはありませんでした。 (Rod Grimes) +.Sh 設定 +.Bl -enum +.It +内部変数を読込みます。 +.It +設定ファイル (/etc/adduser.conf) を読込みます。 +.It +コマンドラインオプションを解析します。 +.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 +デフォルトのログインクラスを設定します。 +.It Sy -create_config +新しい設定を設定ファイルに書込み、メッセージファイルを作成して、 +終了します。 +.It Sy -dotdir Ar directory +ファイルを +.Ar directory +から、新しいユーザの +.Ev HOME +ディレクトリへコピーします。 +.Ql Pa dot.foo +というファイルは、 +.Ql Pa .foo +という名前に変更されます。 +.Ar directory +として +.Ar no +が指定された場合には、コピーを行いません。セキュリティ的な理由から全 +てのファイルはオーナに対して読み書き可能となり、グループや他の人達に +対しては書込み可能にはなりません。また、以下のファイルは、オーナに +対してのみ読み書き実行可能となります。 +.Pa .rhost , +.Pa .Xauthority , +.Pa .kermrc , +.Pa .netrc , +.Pa Mail , +.Pa prv , +.Pa iscreen , +.Pa term +.It Sy -group Ar login_group +ログイングループの指定です。 +.Ar USER +はユーザ名がログイングループとして使用されることを意味します。 +.It Sy -help,-h,-? +オプションの要約を表示して、終了します。 +.It Sy -home Ar partition +全てのユーザがホームディレクトリを持つデフォルトのディレクトリ (home +partition) を指定します。 +.It Sy -message Ar file +新しいユーザに +.Ar file +の歓迎メッセージを送ります。 +.Ar file +が +.Ar no +であった時にはメッセージは送りません。 +.It Sy -noconfig +デフォルトの設定ファイルを読みません。 +.It Sy -shell Ar shell +新しいユーザに対するデフォルトのシェルを指定します。 +.It Sy -silent,-s,-quiet,-q +警告や質問、バグの報告を少ししか行いません。 +.It Sy -uid Ar uid +ユーザ id を +.Ar uid +かそれ以上にします。 +.It Sy -verbose,-v +警告と質問をたくさん行います。初心者ユーザにはおすすめです。 +.Sh フォーマット +.Bl -tag -width Ds -compact +.Ql Pa # +はコメントです。 +.It Sy 設定ファイル +.Nm +はこのファイルを読み書きします。 +より詳しくは、 +.Pa /etc/adduser.conf +を見てください。 +.It Sy メッセージファイル +このファイル内では変数は評価されます。 +より詳しくは、 +.Pa /etc/adduser.message +を見てください。 +.El +.Sh 使用例 +.Pp +$ adduser +.Pp +adduser を会話モードで動かします。 +.Pp +$ adduser -batch baerenklau guest,staff,baer '' 'Teddy II' qwerty7 +.Pp +ユーザ名 'baerenklau' ログイングループ名 'baerenklau' のユーザを作成 +します。このユーザは、 guest, staff, baer グループにも入っています。 +デフォルトのログインクラスを用います。 +このユーザーの本名 (氏名) は 'Teddy II' であり、パスワードは 'qwerty7' +です (が、こんなパスワードを使ってはいけません !)。 +.Ev HOME +ディレクトリは、 +.Pa /home/baerenklau +に作られ、全てのファイルやディレクトリが、 +.Pa /usr/share/skel +から、 +.Pa /home/baerenklau +にコピーされます。ユーザ 'baerenklau' に対して、歓迎メッセージが送ら +れます。 +.Pp +$ adduser -uid 5000 -group guest -message no -batch vehlefanz +.Pp +ユーザ 'vehlefanz' を作成します。ログイングループは guest で ユーザ +idは 5000 以上で利用可能な最小のもの (例えば、5007など) となります。 +他に入っているグループはなく、本名もパスワードもありません。歓迎メッ +セージも送られません。 +.Sh 関連ファイル +.Bl -tag -width /etc/master.passwdxx -compact +.It Pa /etc/master.passwd +ユーザのデータベース +.It Pa /etc/group +グループのデータベース +.It Pa /etc/shells +シェルデータベース +.It Pa /etc/login.conf +ログインクラスデータベース +.It Pa /etc/adduser.conf +adduser 用の設定ファイル +.It Pa /etc/adduser.message +adduser 用のメッセージファイル +.It Pa /usr/share/skel +ログインディレクトリの雛型 +.It Pa /var/log/adduser +adduser の ログ記録ファイル +.El +.Sh 関連項目 +.Xr chpass 1 , +.Xr finger 1 , +.Xr passwd 1 , +.Xr setlogin 2 , +.Xr yp 4 , +.Xr aliases 5 , +.Xr group 5 , +.Xr login.conf 5 , +.Xr passwd 5 , +.Xr shells 5 , +.Xr addgroup 8 , +.Xr pwd_mkdb 8 , +.Xr rmgroup 8 , +.Xr rmuser 8 , +.Xr vipw 8 +.\" .Sh バグ +.Sh 歴史 +.Nm +コマンドは +.Fx 2.1 +から導入されました. diff --git a/ja_JP.eucJP/man/man8/adjkerntz.8 b/ja_JP.eucJP/man/man8/adjkerntz.8 new file mode 100644 index 0000000000..6101a0ea07 --- /dev/null +++ b/ja_JP.eucJP/man/man8/adjkerntz.8 @@ -0,0 +1,181 @@ +.\" Copyright (C) 1993-1996 by Andrey A. Chernov, Moscow, Russia. +.\" 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. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``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. +.\" +.\" %Id: adjkerntz.8,v 1.10.2.1 1997/03/03 07:01:06 mpp Exp % +.\" jpman %Id: adjkerntz.8,v 1.4 1997/07/26 21:28:35 horikawa Stab % +.\" +.Dd April 4, 1996 +.Dt ADJKERNTZ 8 +.Os FreeBSD +.Sh 名称 +.Nm adjkerntz +.Nd "ローカル時間 CMOS クロックをタイムゾーンの変更を反映するように調整し、現在のタイムゾーンオフセットをカーネル用に保持する" +.Sh 書式 +.Nm adjkerntz +.Fl i +.Nm adjkerntz +.Fl a Op Fl s +.Sh 解説 +.Nm adjkerntz +は、 UTC がいつも設定されているカーネルクロックと、 +ローカル時間が設定されているかもしれない CMOS クロックとの間の適切な関係を扱います。 +.Nm adjkerntz +は、また MS-DOS ファイルシステムのようなローカル時間ファイルシステム +のための適切なタイムスタンプを扱うために、カーネルに機械のタイムゾーン +のシフトを教えます。この主要な目的は、最初から壊れている MS-DOS +ファイルタイムスタンプの考え方を一般に固定するためではなく、 +同じタイムスタンプを同じ機械上の FreeBSD の MS-DOS ファイルシステムと +MS-DOS オペレーティングシステムで保つためのものです。 +ファイル +.Pa /etc/wall_cmos_clock +がある場合、 CMOS クロックは (MS-DOS や MS-Windows 互換モードの) +ローカル時間を保持していることを意味します。 +このファイルが無い場合、 CMOS クロックは UTC 時間を +保持していることになります。 +.Nm adjkerntz +は、この状態をカーネル変数の +.Pa machdep.wall_cmos_clock +に通知します。 +.Pp +時間調整はシステムの立ち上げとシャットダウン時、そしてタイムゾーンの +変更が起きた時はいつでも必要になります。 +これらのことなった状況を扱うために、 +.Nm adjkerntz +は二つの方法で立ち上げられます。 +.Bl -tag -width 4n +.It Cm Fl i +この形式は、システムの立ち上げとシャットダウンを取り扱います。 +マルチユーザモードの先頭で、 +.Nm adjkerntz +は +.Pa /etc/rc +からこのオプションをつけて呼び出されます。 +これは他のデーモンが実行される前に行われます。 +.Nm adjkerntz +は自分自身をバックグラウンドで実行します。 +その後、ローカル時間 CMOS クロックのために、 +.Nm adjkerntz +は、ローカル時間をそこから読み込み、カーネル時間を正しい UTC 時間に +設定します。 +.Nm adjkerntz +は、これ以降での +.Nm "'adjkerntz -a'" +呼び出しでの利用のためや、ローカルファイルシステムでの利用のために、 +ローカルタイムゾーンオフセットを +.Pa machdep.adjkerntz +カーネル変数に設定します。 +.Pp +ローカル時間 CMOS クロックのために、 +.Nm "'adjkerntz -i'" +は、一時停止し、バックグランドのデーモンとして活動を停止します。 +このデーモンは、 SIGTERM シグナルを受け取るまでそのままです。 +SIGTERM はふつう、システムがマルチユーザモードを終了する時に +.Xr init 8 +によって送られます (普通、システムがシャットダウンされる時です)。 +SIGTERM を受け取った後で +.Nm adjkerntz +は、 UTC カーネル時間クロックを読み込み、必要であれば現在の +ローカルタイムゾーンを反映するように CMOS クロックを更新します。 +その後、 +.Nm adjkerntz +は終了します。 +.It Cm Fl a Op Fl s +この形式は、タイムゾーンの変更が起こった時に、ローカル時間 CMOS +クロックとカーネル +.Pa machdep.adjkerntz +変数を更新するために使われます。例えば、夏時間に入ったり、 +終了したりした時に使われます。 +.Nm adjkerntz +は、カーネルクロックの UTC 時間・以前に保存したタイムゾーンオフセット・ +新しいタイムゾーンを計算するためのタイムゾーン変更規則を使います。 +これは、新しいオフセットを +.Pa machdep.adjkerntz +カーネル変数に保存し、 CMOS クロックを新しいローカル時間に更新します。 +.Nm "'adjkerntz -a'" +が、(タイムゾーン変更中に) 存在しない時間で実行された場合、 +.Fl s +オプションが使われていない場合は警告診断を出し、終了します。 +.Fl s +オプションが使われている場合は、 30 秒間スリープしてもう一度試します。 +.Pp +この形式は、大多数の現代のタイムゾーンの変更が起こる、 +真夜中から 4:00 までの間に 30 分毎に、root の +.Xr crontab 5 +から呼び出されるべきです。 +警告: +.Fl s +オプションを +.Xr crontab 5 +のコマンドライン中で使ってはいけません。使ってしまうと、複数の +.Nm "'adjkerntz -a'" +がお互いに衝突してしまうでしょう。 +.El +.Pp +.Nm adjkerntz +は、カーネルタイムゾーン構造を消去し、カーネルクロックを +UTC タイムゾーンで走らせます。 +スーパユーザの権限が、全ての操作のために必要とされます。 +.Sh 環境変数 +.Bl -tag -width Fl +.It Ev TZ +タイムゾーンの変更規則。 +.Xr tzset 3 +を見てください。 +.Xr tzsetup 8 +もしくは +.Xr zic 8 +を使っている場合は、必要ありません。 +.Sh 関連ファイル +.Bl -tag -width /etc/wall_cmos_clock -compact +.It Pa /etc/localtime +現在のゾーン情報ファイルです。 +.Xr tzsetup 8 +と +.Xr zic 8 +を見てください。 +.It Pa /etc/wall_cmos_clock +空のファイルです。 +これは、機械の CMOS クロックがローカル時間に設定されていることを +示しています。反対にこれが存在しないと、 UTC の CMOS クロックに +設定されています。 +.Sh 関連項目 +.Xr tzset 3 , +.Xr crontab 5 , +.Xr mount_msdos 8 , +.Xr rc 8 , +.Xr sysctl 8 , +.Xr tzsetup 8 , +.Xr zic 8 . +.Sh 診断 +診断はありません。 +エラーが起こった場合は、 +.Nm adjkerntz +はエラーメッセージを +.Xr syslog 3 +を使って記録し、ゼロでない値を返して終了します。 +.Sh 作者 +Andrey A. Chernov <ache@astral.msk.su> +.Sh 歴史 +.Nm adjkerntz +コマンドは、 FreeBSD 1.0.1 から導入されました。 diff --git a/ja_JP.eucJP/man/man8/amd.8 b/ja_JP.eucJP/man/man8/amd.8 new file mode 100644 index 0000000000..b1288ef367 --- /dev/null +++ b/ja_JP.eucJP/man/man8/amd.8 @@ -0,0 +1,286 @@ +.\" +.\" Copyright (c) 1989 Jan-Simon Pendry +.\" Copyright (c) 1989 Imperial College of Science, Technology & Medicine +.\" Copyright (c) 1989, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" This code is derived from software contributed to Berkeley by +.\" Jan-Simon Pendry at Imperial College, London. +.\" +.\" 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. +.\" +.\" 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. +.\" +.\" @(#)amd.8 5.10 (Berkeley) 4/19/94 +.\" jpman %Id: amd.8,v 1.2 1997/04/15 00:24:08 mutoh Stab % +.\" +.\" %Id: amd.8,v 1.2.2.1 1997/03/06 07:59:18 mpp Exp % +.\" +.Dd "April 19, 1994" +.Dt AMD 8 +.Os +.Sh 名称 +.Nm amd +.Nd 自動マウントファイルシステム +.Sh 書式 +.Nm amd +.Op Fl nprv +.Op Fl a Ar mount_point +.Op Fl c Ar duration +.Op Fl d Ar domain +.Bk -words +.Op Fl k Ar kernel-arch +.Ek +.Op Fl l Ar logfile +.Op Fl t Ar interval.interval +.Bk -words +.Op Fl w Ar interval +.Ek +.Op Fl x Ar log-option +.Op Fl y Ar YP-domain +.Bk -words +.Op Fl C Ar cluster-name +.Ek +.Op Fl D Ar option +.Oo +.Ar directory mapname +.Op Fl map-options +.Oc +.Ar ... +.Sh 解説 +.Nm amd +は、ファイルシステムがアクセスされたときに自動的にそのファイルシステムを +マウントするデーモンです。マウントされたファイルシステムは、アクセスがな +ければ自動的にアンマウントされます。 +.Pp +.Nm amd +は、自分自身をNFSサーバとして、指定された +.Ar directory +に結び付けます。 +その指定ディレクトリ内でのファイルアクセスは +.Nm amd +によって処理されます。 +.Nm amd +は、 +.Ar mapname +で定義されたマップを使って、あるディレクトリ +にどのファイルシステムを割り当てるかを決定します。 +一般に +.Ar mapname +は、ホスト名やファイルシステムの情報、 +マウントオプションから構成されます。 +.Sh オプション +.Bl -tag -width Ds +.It Fl a Ar temporary-directory +実際にファイルシステムをマウントする位置を指定します。 +デフォルトは +.Pa /a +です。 +.It Fl c Ar duration +ディレクトリが使われないときに、探索に使われた名前をキャッシュ +して保持する秒数を指定します。デフォルトは5分です。 +.It Fl d Ar domain +ローカルドメイン名を指定します。もしこのオプションが与 +えられなければ、ドメイン名はホスト名から決定されます。 +.It Fl k Ar kernel-arch +カーネルアーキテクチャを指定します。これは単に ${karch} セレクタ +を指定するだけです。 +.It Fl l Ar logfile +マウントおよびアンマウントのイベントを記録するログファイル +を指定します。 +もし、 +.Ar logfile +が ``syslog'' という文字列なら、ログメッセージは +.Xr syslog 3 +によってシステムログデーモンに送られます。 +.It Fl n +ホスト名を正規化します。${rhost}で参照される名前は、使わ +れる前にホストデータベースに関連づけて正規化されます。 +これは、エイリアスを `` 公式 (official)'' ホスト名に変換する効果があります。 +.It Fl p +プロセスIDを表示します。 +.Nm amd +のプロセス ID を標準出力に出力して、ファイルに保存することができます。 +.It Fl r +存在するマウントをリスタートします。 +.Nm amd +はマウントファイルテーブルをスキャンして、 +現在マウントされているファイルシステムを判断します。 +ファイルシステムが自動マウントされたものであれば、 +.Nm amd +は、その情報を継承します。 +.It Fl t Ar interval.interval +NFS/RPC/UDPのリトライの間隔を、10分の1秒単位で指定します。 +デフォルト値は0.8秒です。2番目の値は再送カウンタを変更します。 +どちらか一方か、両方の値が設定されていなければ、 +適当なデフォルト値が設定されます。 +.It Fl v +バージョンを表示します。標準エラー出力に設定情報を表示します。 +.It Fl w Ar interval +キャッシュする時間を超えたファイルシステムのマウントを解除する時間を +秒単位で指定します。デフォルト値は2分です。 +.It Fl y Ar domain +NISマップをとってくる際に用いるNISドメインを指定します。 +デフォルトはシステムのドメイン名です。このオプションは、NIS +を動かしていないときには無視されます。 +.It Fl x Ar options +実行時に何をログに記録するかを指定します。 +.Ar options +には以下のものをカンマで区切って使用できます: +fatal, error, user, warn, info, map, stats, all +.\" 次の文は原文に表記無し (Feb 1997 jpman J.Sakai) +.\" .Ar options +.\" の最初に``no''をつけたもの(たとえば``noinfo'')は、記録されません。 +.It Fl D Ar option +デバッグオプションの種類を選択することができます。 +.Ar option +の頭に +.Ar no +をつけると、そのオプションの逆の影響を与えます。 +オプションは並べて指定することができます。もっとも役に立つのは +.Ar all +です。 +.El +.Pp +.Fl D +はデバッグのときにだけ使うものであるため、ここでは他のオプションに +ついては説明しません。サポートされているオプションは +.Fl v +オプションで表示されますが、詳細はソースコードに記述されています。 +.\" 以下の使用例は FreeBSD の英語マニュアルには載ってない。 +.\" 内容の正しさを完全には吟味できないので、ここではコメントアウトした。 +.\" (Feb 1997 jpman J.Sakai) +.\" .Pp +.\" .Ss 使用例 +.\" .Pp +.\" .Pa /etc/netstart +.\" で以下の部分を記述します。 +.\" テンプレートがすでに用意されています。 +.\" .Pp +.\" .Bd -literal -offset indent +.\" amd=YES +.\" amd_dir=/am # AMD's mount directory +.\" amd_master=/etc/amd/master # AMD 'master' map +.\" .Ed +.\" .Pp +.\" .Pa /etc/amd +.\" というディレクトリを作成します。 +.\" .Pp +.\" .Pa /etc/amd/master +.\" ファイルを作成します。 +.\" .Pa /etc/amd/master +.\" の内容: +.\" .Pp +.\" .Bd -literal -offset indent +.\" /home /etc/amd/am-home -cache:=inc +.\" .Ed +.\" .Pp +.\" amdマップとして、am-homeを指定しています。 +.\" .Pp +.\" .Pa /etc/amd/am-home +.\" を作成します。 +.\" .Pa /etc/amd/am-home +.\" の内容: +.\" .Pp +.\" .Bd -literal -offset indent +.\" /default opts:=rw,intr,soft,bg,grpid,timeo=30;\\ +.\" type:=nfs;fs:=${autodir}/home/${key};rfs:=/home +.\" .Ed +.\" .Pp +.\" .Bd -literal -offset indent +.\" mizuno host==mercury;type:=ufs;dev:=/dev/sd0a +.\" * type:=error +.\" .Ed +.\" .Pp +.\" このような設定を行い、リブートしてください。 +.\" .Pa /home/mizuno +.\" をアクセスすると、 +.\" .Pa /dev/sd0a +.\" が +.\" .Pa /am/mercury/home/mizuno +.\" としてマウントされ、 +.\" .Pa /home/mizuno +.\" が +.\" .Pa /am/mercury/home/mizuno +.\" へのシンボリックリンクとなります。 +.\" .Pa /home/mizuno +.\" 以外がアクセスされるとエラーとなります。 +.\" .Pp +.\" .Pp +.Sh 関連ファイル +.Bl -tag -width /axx +.It Pa /a +動的にファイルシステムがマウントされるディレクトリ +.El +.Pp +.Sh 注意 +マウントマップを作成する場合には注意が必要です。 +.Pp +.Tn NFS +ファイルシステム上のシンボリックリンクは、信じられないほど +非効率的です。 +.Tn NFS +を実装した多くのシステムでは、 +シンボリックリンクの展開結果はカーネルがキャッシュせずに、 +.Em lookuppn +(パス名変換)時にシンボリックリンクに出会うたびに +NFSサーバに対してRPCコールを行うようになっています。 +キャッシュをどこかに加えることによって、かなり大きな性能の向上が +得られるはずです。 +上手に実現したオートマウントシステムで +.Xr symlink 2 +を置き換えれば大きくスピードアップすることができますが、 +同時に多くのコンテキストスイッチも起こします。 +.Pp +.Nm amd +のすべての機能を駆使できれば非常に便利ですが、 +それにはかなりの想像力が必要になります。 +.Pp +.Sh 関連項目 +.Xr hostname 1 , +.Xr amq 8 , +.Xr mount 8 , +.Xr umount 8 +.Rs +.%T Amd \- The 4.4 BSD Automounter. +.\" 以下の参考文献の節も原文にはない。 +.\" しかし参考にはなるだろうから この節は残すことにした。(Feb 1997 jpman Sakai) +.Sh 参考文献 +.Bl -bullet -offset indent -compact +.It +アスキー UNIX MAGAZINE 1991 4, 5月号: UNIX Communication Notes --- amd +.It +アスキー NUTSHELL HANDBOOKS: Managing NFS \& NIS --- 自動マウンタ +.El +.Pp +.Re +.Sh 作者 +.An Jan-Simon Pendry +<jsp@doc.ic.ac.uk>, Department of Computing, Imperial College, London, UK. +.Sh 歴史 +.Nm amd +は 4.4BSD にはじめて導入されました。 diff --git a/ja_JP.eucJP/man/man8/amq.8 b/ja_JP.eucJP/man/man8/amq.8 new file mode 100644 index 0000000000..42cbaa86d2 --- /dev/null +++ b/ja_JP.eucJP/man/man8/amq.8 @@ -0,0 +1,141 @@ +.\" +.\" Copyright (c) 1990 Jan-Simon Pendry +.\" Copyright (c) 1990 Imperial College of Science, Technology & Medicine +.\" Copyright (c) 1990, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" This code is derived from software contributed to Berkeley by +.\" Jan-Simon Pendry at Imperial College, London. +.\" +.\" 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. +.\" +.\" 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. +.\" +.\" @(#)amq.8 8.3 (Berkeley) 4/18/94 +.\" jpman %Id: amq.8,v 1.3 1997/08/11 14:26:54 horikawa Stab % +.\" +.\" %Id: amq.8,v 1.3 1996/04/08 04:17:22 mpp Exp % +.\" +.Dd March 16, 1991 +.Dt AMQ 8 +.Os +.Sh 名称 +.Nm amq +.Nd 自動マウントシステムへの問い合わせツール +.Sh 書式 +.Nm amq +.Op Fl f +.Op Fl h Ar hostname +.Op Fl M Ar mountmap_entry +.Op Fl m +.Op Fl s +.Op Fl u +.Op Fl v +.Op Ar directory ... +.Pp +.Sh 解説 +.Nm amq +は、現在の +.Xr amd 8 +の動作状況を知るための簡単な手段を提供します。 +.Nm amd +との通信は +.Tn RPC +によって行われます。現在のプロトコルでは、 3 つのモード +がサポートされています。デフォルトでは、マウントポイントと自動 +マウントされたファイルシステムのリストが出力されます。別 +のホストの状態を知るときは、 +.Fl h +オプションで +.Ar hostname +を指定します。 +.Pp +ディレクトリ名が与えられると、デフォルトの出力ではファイルシステム +ごとの情報が表示されます。 +.Sh オプション +.Bl -tag -width flag +.It Fl f +自動マウントシステムに内部キャッシュを破棄するように要 +求します。 +.It Fl h Ar hostname +.Ar hostname +で指定されたホストに問い合わせを行います。デ +フォルトでは、ローカルホストが使われます。 +.Tn HP-UX +クラスタでは、デフォルトでルートサーバに問い合わせが行わ +れます。これは通常、自動マウントシステムがルートサーバで動 +いているからです。 +.It Fl m +マウントされたファイルシステムのリストを、 +各ファイルシステムへの参照回数と +マウント時に起きたエラーを含めて表示するように、自動マウント +システムに要求します。 +.It Fl s +自動マウントシステムに、システムの統計情報を表示するよ +うに要求します。 +.It Fl u +自動マウントシステムに、 +情報を表示するのではなく、 +指定したファイルシステムをアンマウント +するように要求します。アンマウントは要求であって、 +必ず行われるとはかぎりません。まれにマウントしているファ +イルシステムがタイムアウトを起こす場合があります。 +これは、この要求が通常のタイムアウトを引き起こすくらい頻繁に +.Nm amd +のメインスケジューラに取り上げられるからです。 +.It Fl v +自動マウントシステムに、バージョン情報を提供するように要 +求します。これは、 +.Nm amd +の +.Fl v +オプションで得られる情報の一部です。 +.It Fl M Ar mountmap_entry +自動マウントシステムに、指定したマップエントリをルート +マップに追加しマウントするように要求します。 +.El +.Sh 関連ファイル +.Bl -tag -width amq.x +.It Pa amq.x +RPCのプロトコル記述 +.El +.Sh 警告 +.Nm amq +は、Sunが登録しているRPCプログラム番号(十進数で300019)を使っ +ています。これは通常、 +.Pa /etc/rpc +には含まれていません。 +.Pp +.Sh 関連項目 +.Xr amd 8 +.Sh 作者 +.An Jan-Simon Pendry +<jsp@doc.ic.ac.uk>, Department of Computing, Imperial College, London, UK. +.Sh 歴史 +.Nm amq +は、はじめに 4.4BSD で導入されました。 +.At diff --git a/ja_JP.eucJP/man/man8/apm.8 b/ja_JP.eucJP/man/man8/apm.8 new file mode 100644 index 0000000000..6a9dfebc69 --- /dev/null +++ b/ja_JP.eucJP/man/man8/apm.8 @@ -0,0 +1,104 @@ +.\" LP (Laptop Package) +.\" +.\" Copyright (c) 1994 by HOSOKAWA, Tatsumi <hosokawa@mt.cs.keio.ac.jp> +.\" +.\" This software may be used, modified, copied, and distributed, in +.\" both source and binary form provided that the above copyright and +.\" these terms are retained. Under no circumstances is the author +.\" responsible for the proper functioning of this software, nor does +.\" the author assume any responsibility for damages incurred with its +.\" use. +.\" jpman %Id: apm.8,v 1.4 1997/07/26 21:52:01 horikawa Stab % +.Dd November 1, 1994 +.Dt APM 8 +.Os +.Sh 名称 +.Nm apm, zzz +.Nd APM BIOS の制御を行い、その情報を表示する +.Sh 書式 +.Nm apm +.Op Fl z +.Op Fl b +.Op Fl a +.Op Fl l +.Op Fl s +.Pp +.Nm zzz +.Sh 解説 +.Nm apm +は、 Intel / Microsoft APM (Advanced Power Management) BIOS を制御し、 +ラップトップ PC 上の APM の現在の状態を表示します。 +.Nm zzz +は、 APM 制御によって、システムをサスペンドします。 +.Pp +以下のオプションが +.Nm apm +で利用可能です +( +.Nm zzz +には、オプションはありません)。 +オプションが与えられなかった場合は、 +.Nm apm +は、現在の APM の状態や情報を冗長モードで表示します。 +.Bl -tag -width indent +.It Fl z +システムをサスペンドします。これは、 +.Nm zzz +と等価です。 +.Pp +.It Fl b +整数値で、現在のバッテリ状態を表示します。 +0, 1, 2, 3という値はそれぞれ、 +.Dq 良好 (high) +状態、 +.Dq 低バッテリ (low) +状態、 +.Dq 危険 (critical) +状態、 +.Dq 充電 (charging) +状態をあらわします。 +.Pp +.It Fl a +現在の AC 電源の状態を整数値で表示します。 +0, 1がそれぞれ +.Dq 外れている (off-line) +状態と +.Dq つながっている (on-line) +状態をあらわします。 +.Pp +.It Fl l +現在のバッテリの残り割合を表示します。 +もし、あなたのラップトップがこの機能を提供していない時には、 +255 が表示されます。 +.Pp +.It Fl s +APM サポート状態を整数値で表示します。0, 1 という値はそれぞれ、 +.Dq 利用不可 (disabled) +状態 +.Dq 利用可能 (enabled) +状態 +をあらわします。 +.Sh バグ +いくつかの APM 実装では、 +.Nm apm +が必要とするパラメータが提供されていません。 +そのようなシステムに於いては、 +.Nm apm +は、それらを知らないと表示します。 +.Pp +いくつかの APM 実装では、電源スイッチを押したことやカバーが +閉められたことなどのイベントを扱うことができません。 +そのような実装に於いては、 +システムは +.Nm apm +か +.Nm zzz +.Ar だけを +つかってサスペンドする +.Ar べき +です。 +.Sh 関連項目 +.Xr apm 4 , +.Xr apmconf 8 +.Sh 作者 +細川 達己<hosokawa@mt.cs.keio.ac.jp> ( 慶応大学, 日本 ) diff --git a/ja_JP.eucJP/man/man8/apmconf.8 b/ja_JP.eucJP/man/man8/apmconf.8 new file mode 100644 index 0000000000..7651ff6b2a --- /dev/null +++ b/ja_JP.eucJP/man/man8/apmconf.8 @@ -0,0 +1,64 @@ +.\" LP (Laptop Package) +.\" +.\" Copyright (c) 1994 by HOSOKAWA, Tatsumi <hosokawa@mt.cs.keio.ac.jp> +.\" +.\" This software may be used, modified, copied, and distributed, in +.\" both source and binary form provided that the above copyright and +.\" these terms are retained. Under no circumstances is the author +.\" responsible for the proper functioning of this software, nor does +.\" the author assume any responsibility for damages incurred with its +.\" use. +.\" jpman %Id: apmconf.8,v 1.3 1997/06/28 09:27:16 jsakai Stab % +.Dd November 1, 1994 +.Dt APMCONF 8 +.Os +.Sh 名称 +.Nm apmconf +.Nd APM BIOS ドライバの設定を行う +.Sh 書式 +.Nm apmconf +.Op Fl e +.Op Fl d +.Op Fl h +.Op Fl t +.Sh 解説 +.Nm apmconf +は、ラップトップ PC 上の APM (Advanced Power Management) BIOS ドライバ +.Xr apm 4 +の設定のために使われます。 +.Pp +以下のオプションが利用可能です。 +.Bl -tag -width indent +.It Fl e +パワー管理を有効にします。 +.It Fl d +パワー管理を無効にします。 +.El +.Pp +これらのオプションは、 +.Xr apm 4 +によって提供されるパワー管理機能を有効もしくは無効とします。 +.Bl -tag -width indent +.It Fl h +カーネルのコンテクストスイッチルーチン内の HLT 命令を有効とします。 +.It Fl t +カーネルのコンテクストスイッチルーチン内の HLT 命令を無効とします。 +.El +.Pp +これらのオプションは、ほとんど全ての APM の実装においては必要では +ありませんが、 +.Dq Pa Idle CPU +呼び出しが CPU クロックの減速と HLT 命令を同時に実行する場合は、 +そのピーク性能の減少からシステムをまもるために +.Fl t +オプションが必要です。 +詳細については、 +.Xr apm 4 +を参照してください。 +.Sh 関連項目 +.Xr apm 4 , +.Xr apm 8 , +.Xr zzz 8 +.Sh 作者 +細川 達己<hosokawa@mt.cs.keio.ac.jp> ( 慶応大学, 日本 ) + diff --git a/ja_JP.eucJP/man/man8/arp.8 b/ja_JP.eucJP/man/man8/arp.8 new file mode 100644 index 0000000000..d8b88690cb --- /dev/null +++ b/ja_JP.eucJP/man/man8/arp.8 @@ -0,0 +1,142 @@ +.\" Copyright (c) 1985, 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. +.\" +.\" 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. +.\" +.\" @(#)arp.8 8.1 (Berkeley) 6/6/93 +.\" jpman %Id: arp.8,v 1.3 1997/07/22 16:36:26 horikawa Stab % +.\" +.Dd June 6, 1993 +.Dt ARP 8 +.Os BSD 4.3 +.Sh 名称 +.Nm arp +.Nd アドレス解決の表示と制御 +.Sh 書式 +.Nm arp +.Op Fl n +.Ar hostname +.Nm arp +.Op Fl n +.Fl a +.Nm arp +.Fl d Ar hostname +.Nm arp +.Fl s Ar hostname ether_addr +.Op Ar temp +.Op Ar pub +.Nm arp +.Fl S Ar hostname ether_addr +.Op Ar temp +.Op Ar pub +.Nm arp +.Fl f Ar filename +.Sh 解説 +.Nm +プログラムは +アドレス解決プロトコル +.Pq Xr arp 4 +で使われる、インターネットからイーサネットへのアドレス変換テーブルの +表示と変更をします。 +フラグなしの場合、プログラムは +.Ar hostname +の現在の +.Tn ARP +エントリを表示します。 +ホストは名前か、インターネットドット表記の数字で指定します。 +.Pp +有効なオプション: +.Bl -tag -width Ds +.It Fl a +プログラムは現在の +.Tn ARP +エントリを全て表示します。 +.It Fl d +スーパユーザならば +.Ar hostname +というホストのエントリを消去することができます。 +.It Fl n +ネットワークアドレスを数値で表示します (通常 +.Nm +はアドレスをシンボルで表示しようとします)。 +.It Fl s Ar hostname ether_addr +ホスト +.Ar hostname +イーサネットアドレス +.Ar ether_addr +の +.Tn ARP +エントリを作成します。 +イーサネットアドレスはコロンで区切った六つの 16 進バイトで表現します。 +エントリは、語 +.Ar temp +がコマンド中にない限り永久的なものです。 +語 +.Ar pub +があれば、エントリは「公表」されます; すなわち、システムは +.Tn ARP +サーバとして動作し、 +.Ar hostname +に対する要求に、たとえホストアドレスが自分自身ではないとしても、 +返答します。 +この場合、ether_addr は ``auto'' と指定可能です。 +この様に指定した場合、 +自ホストのインタフェースを検査し、 +インタフェースのどれか一つが +指定したホストアドレスと同じサブネットに属す場合、 +そのインタフェースの ether_addr を使います。 +.It Fl S Ar hostname ether_addr +このホストに関する、すでにある arp エントリが最初に削除されることを除いて、 +.Fl s +と同様です。 +.It Fl f +ファイル +.Ar filename +を読み込んで、複数のエントリを +.Tn ARP +テーブルに設定します。 +ファイル中のエントリは +.Pp +.Bd -filled -offset indent -compact +.Ar hostname ether_addr +.Op Ar temp +.Op Ar pub +.Ed +.Pp +の形にするべきです。ここで引数の意味は上で与えられた通りです。 +.El +.Sh 関連項目 +.Xr inet 3 , +.Xr arp 4 , +.Xr ifconfig 8 +.Sh 歴史 +.Nm +コマンドは +.Bx 4.3 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/atrun.8 b/ja_JP.eucJP/man/man8/atrun.8 new file mode 100644 index 0000000000..74025e990a --- /dev/null +++ b/ja_JP.eucJP/man/man8/atrun.8 @@ -0,0 +1,75 @@ +.\" %Id: atrun.man,v 1.1 1995/04/12 02:52:21 ache Exp % +.\" jpman %Id: atrun.8,v 1.2 1997/04/23 02:43:41 yugawa Stab % +.Dd April 12, 1995 +.Dt ATRUN 8 +.Os "FreeBSD 2.1" +.Sh 名称 +.Nm atrun +.Nd ジョブキューのなかから予定時刻になったものを実行 +.Sh 書式 +.Nm atrun +.Op Fl l Ar load_avg +.Op Fl d +.Sh 解説 +.Nm atrun +コマンドは +.Xr at 1 +でキューに入れたジョブを実行するコマンドです。 +ルートの +.Xr crontab 5 +ファイル +.Pa /etc/crontab +に、 +.nf +*/5 * * * * root /usr/libexec/atrun +.fi +という設定が含まれていたならば、5分毎に起動される事になります。 +.Pp +.Nm atrun +が起動する度に、小文字のキューの中の実行時間が来た各ジョブがスタートします。 +.Nm atrun +が起動する度に、(大文字のキューで表される)バッチジョブのうち +優先順位が最も高い物からひとつずつスタートします。 +.\" 上記の記述はオリジナルの英語版では、"A maximum of one batch jobs (denoted +.\" by uppercase queues) are started each time atrun is invoded." となっている。 +.\" この記述だけでは非常にわかりにくいが、at(1) を見ると、バッチジョブには +.\" A 〜 Z のキューがあり、A 〜 Z の順番で nice 値が高くなる(優先度が低くなる) +.\" と書かれている。そこで、実際に試して見ると、同一のキューに登録されたジョブ +.\" は登録された順番に実行されるが、異なるキューに登録されたジョブは登録された +.\" 順番とは関係なく、より nice 値が低い(優先度の高い)ジョブから実行される +.\" ので、上記の記述とした。 +.\" 2.2.1-RELEASE 対象 +.\" By yugawa@orleans.rim.or.jp (Apr 23 1997) +.Sh オプション +.Bl -tag -width indent +.It Fl l Ar load_avg +負荷の上限を指定する。負荷がこの上限を越えている場合、バッチジョブは実行さ +れない。デフォルトの値は 1.5。 +.It Fl d +デバッグ用。 +.Xr syslog 3 +を使う代わりに標準エラー出力にエラーメッセージを吐き出す。 +.El +.Sh 警告 +.Nm atrun +を動かすためには +.Xr cron 8 +デーモンを起動しておかねばなりません。 +.Sh 関連ファイル +.Bl -tag -width /var/at/spool -compact +.It Pa /var/at/spool +出力ファイルを保管しておくディレクトリ +.It Pa /var/at/jobs +ジョブファイルを保管しておくディレクトリ +.El +.Sh 関連項目 +.Xr cron 8 , +.Xr crontab 1 , +.Xr crontab 5 , +.Xr at 1 , +.Xr syslog 3 +.Sh バグ +.Nm atrun +の機能は +.Xr cron 8 +に統合されるべきです。 diff --git a/ja_JP.eucJP/man/man8/bad144.8 b/ja_JP.eucJP/man/man8/bad144.8 new file mode 100644 index 0000000000..86c4dac166 --- /dev/null +++ b/ja_JP.eucJP/man/man8/bad144.8 @@ -0,0 +1,184 @@ +.\" Copyright (c) 1980, 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. +.\" +.\" 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. +.\" +.\" @(#)bad144.8 8.1 (Berkeley) 6/6/93 +.\" jpman %Id: bad144.8,v 1.4 1997/08/28 12:10:14 horikawa Stab % +.\" +.Dd May 13, 1995 +.Dt BAD144 8 +.Os BSD 4 +.Sh 名称 +.Nm bad144 +.Nd DEC スタンダード 144 形式のバッドセクタ情報を読み書きする +.Sh 書式 +.Nm bad144 +.Op Fl c +.Op Fl f +.Op Fl v +.Ar disk +.Oo +.Ar sno +.Op Ar bad ... +.Oc +.Nm bad144 +.Fl a +.Op Fl c +.Op Fl f +.Op Fl v +.Ar disk +.Op Ar bad ... +.Nm bad144 +.Op Fl s +.Op Fl v +.Ar disk +.Sh 解説 +.Nm Bad144 +は、バッドセクタの置きかえを実現するためにディスクドライバが使用する、 +ディスク上の情報を調べるのに使えます。 +.Pp +使用可能なオプション: +.Pp +.Bl -tag -width Ds +.It Fl a +既存のリストに追加したい、新しいバッドセクタからなる引数リスト。 +ディスク上のリストは昇順にソートされている必要があるため、 +新しいセクタは既存のリストとともにソートされます。 +追加に対応するため、代替セクタの移動がおこなわれます。 +新しい代替セクタはクリアされます。 +.It Fl c +古いセクタから代替セクタへのコピーを試みます。 +不安定なセクタを置きかえるために使えるでしょう。 +.It Fl f +.Fl f +オプションは RP06, RM03, RM05, 富士通の Eagle, または Massbus 上の +.Tn SMD +ディスクにおいて、新しいバッドセクタを使用不可セクタとして +再フォーマットすることで「バッド」セクタとしてマークするために使えます。 +このオプションは、そのセクタがまだバッドセクタとしてマークされていないか、 +あるいはシステムが代替セクタを使うように指示されていない場合に必要です。 +このオプションはマルチユーザモードでの動作中にも使うことができます。 +フォーマット操作をおこなうためにシングルユーザモードに +移行する必要はなくなりました。 +.It Fl s +ディスク全体をスキャンしてバッドブロックを探します。 +.It Fl v +.Fl v +(verbose) が指定されると、処理過程の全体を詳細に表示します。 +.El +.Pp +この情報のフォーマットは、 +.Tn DEC +スタンダード 144 で以下のように定義されています。 +バッドセクタ情報は、ディスクパックの最終トラックの最初の +偶数番号のセクタ五つに置かれます。 +.Ar dkbad +構造体で記述される情報の、同一のコピーが五つあります。 +.Pp +代替セクタはバッドセクタ情報の直前のセクタから始まり、 +ディスクの先頭に向かって逆向きに割り当てられます。 +最大で 126 個のバッドセクタがサポートされます。 +対応する代替セクタは、バッドセクタテーブル中での +バッドセクタの位置から計算されます。 +バッドセクタは昇順に並んでいなければなりません。 +.Pp +バッドセクタ情報と代替セクタは、伝統的に +ディスクの ``c'' ファイルシステムパーティションを通してのみアクセス可能です。 +もしも このパーティションをファイルシステムとして使用している場合、 +それがバッドセクタ情報や代替セクタとオーバーラップしないことを +保証するのはユーザの責任です。 +したがって、バッドセクタ代替機能を完全に使用するためには、 +1 トラックと 126 セクタを予約しておかなければなりません。 +.Pp +バッドセクタ構造体は以下のようになっています。 +.Bd -literal +struct dkbad { + long bt_csn; /* カートリッジのシリアルナンバ */ + u_short bt_mbz; /* 未使用; 0 であるべき */ + u_short bt_flag; /* -1 => アラインメント カートリッジ */ + struct bt_bad { + u_short bt_cyl; /* バッドセクタのシリンダ番号 */ + u_short bt_trksec; /* トラック番号とセクタ番号 */ + } bt_bad[126]; +}; +.Ed +.Pp +配列 +.Ar bt_bad +中の未使用のスロットは全ビットがセットされ、 +不正な値として未使用であることを示しています。 +.Pp +.Nm Bad144 +はデバイス名 (例えば hk0, hp1, 等) を指定して実行します。 +オプションの引数が指定されていない場合、指定されたディスクの最終トラックの +最初のセクタを読んで、バッドセクタ情報を出力します。 +もしもバッドセクタ情報が破壊されていると、警告が表示されます。 +ディスクパックのシリアル番号とバッドセクタのリストを与えて +.Nm Bad144 +を呼び出すこともできます。 +これは既存の情報にかわり、与えられた情報を +バッドセクタファイルのすべてのコピーに書き込みます。 +しかし、この場合には +.Nm bad144 +は指定されたセクタを bad としてマークしないことに注意してください。 +この手続きは、破壊された既知のバッドセクタ情報を復旧するためだけに +使用するべきです。 +.Pp +カーネルにドライブからバッドセクタを読み直させるために +リブートする必要はなくなりました。 +.Sh 関連項目 +.Xr badsect 8 +.Sh バグ +.Tn UNIX +の動作中に、オンラインでディスクをフォーマットできるようにするべきです。 +.Pp +すべてのタイプのドライブのバッドセクタをマークできるようにするべきです。 +.Pp +11/750 (訳注: VAX のモデル名) では、システムのブートに使われる +標準のブートストラップドライバはバッドセクタ情報を理解しませんし、 +.Tn ECC +エラーや RM80 タイプのディスクの特殊な +.Tn SSE +(スキップセクタ) エラーを処理しません。 +これはブートのためにファイル +.Pa /kernel +を読んでいる時には、これらのエラーが起きてはならないということです。 +また、ディスクドライブのセクタ 0-15 には、これらのいかなる障害も +存在してはいけません。 +.Pp +クラッシュ後にディスクにシステムコアイメージを書くドライバは、 +これらのエラーを処理しません。 +したがって、クラッシュダンプエリアは これらのエラーもバッドセクタもない +状態でなければなりません。 +.Sh 歴史 +.Nm +コマンドは +.Bx 4.1 +から現われました。 diff --git a/ja_JP.eucJP/man/man8/badsect.8 b/ja_JP.eucJP/man/man8/badsect.8 new file mode 100644 index 0000000000..7570f77099 --- /dev/null +++ b/ja_JP.eucJP/man/man8/badsect.8 @@ -0,0 +1,135 @@ +.\" Copyright (c) 1985, 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. +.\" +.\" 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. +.\" +.\" from: @(#)badsect.8 8.1 (Berkeley) 6/5/93 +.\" %Id: badsect.8,v 1.1.1.1.8.3 1997/10/15 17:36:09 max Exp % +.\" jpman %Id: badsect.8,v 1.2 1997/03/31 13:30:12 horikawa Stab % +.\" +.Dd June 5, 1993 +.Dt BADSECT 8 +.Os BSD 4 +.Sh 名称 +.Nm badsect +.Nd バッドセクタ上にファイルを作る +.Sh 書式 +.Nm /sbin/badsect +.Ar bbdir sector ... +.Sh 解説 +.Nm badsect +はバッドセクタを含むファイルを作成します。 +通常のフォーマッタは、バッドセクタをアクセスできないようにします。 +このとき、フォーマッタはドライバ用にバッドセクタのフォワーディングテーブルを +作ります。 +詳しくは +.Xr bad144 8 +を参照してください。 +もしドライバが標準でバッドブロックをサポートしているならば、 +バッドブロックを孤立させるためにはその方法を使用すべきです。 +なぜならばバッドブロックフォワーディングはパックを完全に見せ、 +そのようなパックは +.Xr dd 1 +でコピー可能だからです。 +本プログラムで採用している方法はバッドブロックフォワーディングよりは +一般的ではありません。 +なぜならば +.Nm badsect +はファイルシステムの i-list のバッドブロックを回復することができませんし、 +スワップ領域のバッドブロックも回復することができないからです。 +.Pp +突然バッドとなったセクタをバッドセクタテーブルに追加するためには、 +ディスクによっては現在のところ、 +標準の +.Tn DEC +フォーマッタを実行する必要があります。 +このため、新たに生じたバッドブロックを扱う場合、 +およびドライバがバッドブロッキング標準をサポートしていない場合には、 +.Nm badsect +は有効かも知れません。 +.Pp +.Nm badsect +は現在アクセスされていないファイルシステムに対して次のように使用します。 +.Nm badsect +を使うには、まず、ファイルシステムをマウントし、そのルート +ディレクトリに移動します。ここに +.Li BAD +という名前のディレクトリを作ります。 +.Nm badsect +コマンドに、引数として、このディレクトリと追加したいすべて +のバッドセクタを指定して実行します +(セクタ番号はファイルシステムの先頭からの相対で指定しなければなりませんが、 +システムがコンソールエラーメッセージに表示するのは相対セクタ番号であるため +難しくはありません)。 +その後、ルートディレクトリに移動し、 +そのファイルシステムをアンマウントしてから +.Xr fsck 8 +を実行します。 +fsck はバッドセクタを含むファイルを削除しますが、 +.Pa BAD/ Ns Em nnnnn +は削除 +.Em しないように +してください。 +以上の操作によりバッドセクタは +.Li BAD +ファイルにのみにあることになります。 +.Pp +.Nm badsect +は +.Xr mknod 2 +の引数にセクタ番号を指定してコールすることで、 +最初のブロックが指定したバッドセクタを含んだ特別なファイルを作ります。 +このファイルの名前はバッドセクタの番号です。 +.Xr fsck +は、このファイルを発見すると +.Dq Li "HOLD BAD BLOCK ?" +と聞いてきます。 +これに対して y と答えると、 +.Xr fsck +はその inode を、バッドブロックを含む +通常ファイルにコンバートします。 +.Sh 関連項目 +.Xr bad144 8 , +.Xr fsck 8 +.Sh 診断 +.Nm badsect +は、危険な領域のブロックやファイルシステム外のブロックを追加しません。 +また、ブロックが既に使用されている場合には警告を表示します。 +.Sh バグ +あるファイルシステムフラグメント中の複数のセクタがバッドとなった場合、 +そのうちの 1 つだけを +.Nm badsect +に指定しなければなりません。 +バッドセクタファイル中のブロックは、 +ファイルシステムフラグメント中の全てのセクタをカバーするからです。 +.Sh 歴史 +.Nm +コマンドは +.Bx 4.1 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/boot_i386.8 b/ja_JP.eucJP/man/man8/boot_i386.8 new file mode 100644 index 0000000000..6453f92cbb --- /dev/null +++ b/ja_JP.eucJP/man/man8/boot_i386.8 @@ -0,0 +1,235 @@ +.\" Copyright (c) 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" This code is derived from software written and contributed +.\" to Berkeley by William Jolitz. +.\" +.\" Almost completely rewritten for FreeBSD 2.1 by Joerg Wunsch. +.\" +.\" 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. +.\" +.\" 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. +.\" +.\" @(#)boot_i386.8 8.2 (Berkeley) 4/19/94 +.\" %Id: boot_i386.8,v 1.4.2.2 1997/07/05 02:04:31 bde Exp % +.\" jpman %Id: boot_i386.8,v 1.5 1997/12/04 18:33:50 ken Exp % +.\" +.\" +.Dd April 19, 1994 +.Dt BOOT 8 i386 +.Os +.Sh 名称 +.Nm boot +.Nd +システム立上げ時の手続き +.Sh 解説 +.Sy 電源断とクラッシュからの回復。 +通常、電源復旧時とクラッシュ発生後には、システムは自動的にリブートし +ます。ファイルシステムの整合性チェックが自動実行され、途中で失敗しな +ければ、システムはマルチユーザ・モードに移行します。 +.Pp +.Sy コールドスタート。 +大多数の 386 +.Tn "PC AT" +互換機は、まずフロッピードライブ 0 (ドライブ A: ともいう) からの +ブートを試み、それに失敗すると、ハードディスクドライブ 0 (ドライブ C: も +しくは (紛らわしいが) ハードディスクドライブ 1 とも BIOS のドライブ +0x80 ともいう) からブートしようとします。いくつかの BIOS では、この +デフォルトの順序を変えたり、 CD-ROM デバイスをブートデバイスとして含 +めることができます。 +ブートブロックがロードされたあとで、次のようなプロンプトが現れます。 +.Bd -literal +>> FreeBSD BOOT @ 0x10000: 640/7168 k of memory, internal console +Boot default: 0:wd(0,a)kernel + +boot: +.Ed +.Pp +(スクリーン上にはいくつかの情報も出力されているかもしれません) +.Pp +自動ブートにおいては、フロッピー +もしくはハードディスクのパーティション +.Ql a +から +.Pa /kernel +をロードしようとします。 +この動作は +.Ql boot: +というプロンプトが出ている間なら、キーボードから適当な文字を入力する +ことで中断できます。以下にあげるような入力はブート動作に対する指示と +して受付けられます。 +.Bl -tag -width 10x +.It \&? +ブートファイルを探す際のヒントとして、デフォルトのブートデバイスの +ルートディレクトリにあるファイルの名前を表示します。 +.It Op bios_drive:interface(unit,part) Op filename Op Fl aCcDdghPrsv +ブートファイルとブートフラグを指定します。 +.Bl -tag -width 10x -compact +.It bios_drive +BIOS によって認識されるドライブ番号です。 1 つ目のドライブに対しては +0 、 2 つ目のドライブに対しては 1 、などです。 +.It interface +そこからブートするコントローラのタイプです。ブートファイルのイメージ +をロードするのには BIOS の機能を使用するので、そのコントローラに対す +る BIOS サポートが必要となることに注意して下さい。 +.Pp +サポートされているインターフェイスを以下にあげます。 +.Bl -tag -width "wdXX" -compact +.It wd +WD100[2367] とその互換コントローラ上の ST506, IDE, ESDI, RLL ディスク +.It fd +5 1/4" または 3 1/2" 高密度 フロッピ +.It sd +サポートされている SCSI コントローラ上の SCSI ディスク +.\".It cd +.\"CDROM からのブート +.El +.It unit +使用されているインターフェイス上のドライブのユニット番号です。 1 つ +目のドライブに対しては 0 、 2 つ目のドライブに対しては 1 、などです。 +.It part +ディスク上の BSD 部分内のパーティション文字です。詳しくは +.Xr disklabel 8 +を参照して下さい。慣例として、パーティション +.Ql a +のみが ブート可能なイメージを含んでいます。ディスクにスライス +.Pq Dq fdisk パーティション +が設けられていた場合、最初の BSD スライスからのみブートが可能です。 +また、パーティション文字は常に最初のスライスについてのものとなります。 +.It /filename +ブートファイルの (指定されたパーティションのルートディレクトリからの +相対) パス名です。デフォルトでは +.Pa /kernel +となります。シンボリックリンクはサポートされていません (ハードリンク +は使用できます)。 +.It Fl acCdDghPrsv +ブートフラグです。 +.Bl -tag -width "-CXX" -compact +.It Fl a +カーネル初期化中に、ルートファイルシステムとしてマウントされるデバイスを +尋ねて来るようにします。 +.It Fl C +CDROM からブートします。 +.It Fl c +ロードしたカーネルに対し、ハードウェアのパラメータを変更するため、 +UserConfig を実行します。 +.It Fl D +シングルとデュアルのコンソール設定を切り替えます。シングル設定では、 +下記の +.Fl h +オプションの状態によって、コンソールは内部ディスプレイかシリアルポートの +いずれかになります。デュアルコンソール設定では、内部ディスプレイ +とシリアルポートの両方が、 +.Fl h +オプションの状態によらず、同時にコンソールになります。しかし、 +デュアルコンソール設定は、ブートプロンプトの間だけでしか効果を持ちません。 +一旦カーネルがロードされると、 +.Fl h +オプションによって指定されたコンソールが唯一のコンソールになります。 +.It Fl d +カーネルの初期化のできる限り早い段階で DDB カーネルデバッガ +.Pq Xr ddb 4 を参照 +に入ります。 +.It Fl g +GDB リモートデバッギングプロトコルを使用します。 +.It Fl h +内部コンソールとシリアルコンソールの切替えを行います。これを使用して +コンソールデバイスを変更できます。例えば、内部コンソールからブートし +た場合、カーネルがコンソールデバイスとしてシリアルポートを使用するよ +うにするため、 +.Fl h +オプションを使用できます。反対に、シリアルポートからブートした場合、 +カーネルがコンソールとして代わりに内部ディスプレイを使用するようにす +るため、このオプションを使用できます。 +.It Fl P +キーボードを検出します。キーボードが発見できなかった場合には、 +.Fl D +と +.Fl h +オプションが自動的にセットされます。 +.It Fl r +ルートファイルシステムを含むデバイスとしてスタティックに config され +たデフォルトを使用します +.Pq Xr config 8 を参照 +。 +.It Fl s +シングルユーザ・モードで立上がるようになります。コンソールが +.Dq insecure +.Pq Xr ttys 5 を参照 +に設定されていた場合には、root のパスワードを入力しなければなり +ません。 +.It Fl v +デバイス検出の際 (そしてその後も) 、詳細を出力します。 +.El +.El +.El +.Pp +デフォルトを設定するため、BIOS ドライブ番号, コントローラタイプ, +ユニット番号, パーティション, カーネルファイル名と +.Fl D, +.Fl h +もしくは +.Fl P +オプションを +.Pa /boot.config +に書くこともできます。 +.Ql boot: +プロンプトでタイプするように、 1 行で書いてください。 +.Sh 関連ファイル +.Bl -tag -width /kernel.old.config -compact +.It Pa /boot.config +ブートローダに対するパラメータ (必須ではない) +.It Pa /boot.help +ヘルプメッセージ +.It Pa /kernel +デフォルトカーネル +.It Pa /kernel.config +デフォルトカーネルに対するパラメータ (必須ではない) +.It Pa /kernel.old +ふつうは非デフォルトカーネル (必須ではない) +.It Pa /kernel.old.config +非デフォルトカーネルに対するパラメータ (必須ではない) +.\" .It Pa /boot +.\" system bootstrap +.El +.Sh 関連項目 +.Xr ddb 4 , +.Xr ttys 5 , +.Xr config 8 , +.Xr disklabel 8 , +.Xr halt 8 , +.Xr reboot 8 , +.Xr shutdown 8 +.Sh バグ +このバージョンの +.Bx +で使用されているディスクラベルのフォーマットは、他のアーキテクチャで +使用されている物とは全く異なっています。 +.Pp +一文字だけのブートフラグはあまり分かりやすい物とは言えず、有用と思わ +れるオプションをすべて実現するには、アルファベットの文字数は少なすぎ +ます。 diff --git a/ja_JP.eucJP/man/man8/bootparamd.8 b/ja_JP.eucJP/man/man8/bootparamd.8 new file mode 100644 index 0000000000..08a45493e7 --- /dev/null +++ b/ja_JP.eucJP/man/man8/bootparamd.8 @@ -0,0 +1,49 @@ +.\" @(#)bootparamd.8 +.\" jpman %Id: bootparamd.8,v 1.3 1997/07/26 21:54:02 horikawa Stab % +.Dd "November 8, 1989" +.Dt BOOTPARAMD 8 +.Os +.Sh 名称 +.Nm bootparamd +.Nd ブートパラメータサーバ +.Sh 書式 +.Nm +.Op Fl ds +.Op Fl r Ar router +.Op Fl f Ar file +.Sh 解説 +.Nm bootparamd +は、ディスクレスクライアントの起動時に必要な情報を提供するサーバプロセスです。 +.Pa /etc/bootparams +ファイルの内容を参照します。 +.Pp +このバージョンでは +.Pa /etc/bootparams +ファイルにおいてホストの別名を使う事ができます。 +起動中のクライアントが発行した whoami リクエストに対し返されるホスト名は +.Pa /etc/bootparams +中の名前であり、正式名ではありません。 +この方法により、長いホスト名を扱う事のできないマシンに対しても、 +起動に失敗する事の無い短い名前を答える事ができます。 +.Sh オプション +.Bl -tag -width Fl +.It Fl d +デバッグ情報を出力します。 +.It Fl s +デバッグ情報を syslog にて記録します。 +.It Fl r Ar router +デフォルトルータを、ホスト名もしくは IP-アドレスで指定します。 +無指定時のデフォルトルータはサーバが動作しているマシンになります。 +.It Fl f Ar file +.Pa /etc/bootparams +の代わりに使用するブートパラメータファイル名を指定します。 +.El +.Sh 関連ファイル +.Bl -tag -width /etc/bootparams -compact +.It /etc/bootparams +.El +.Sh バグ +syslog への出力情報が多少冗長すぎるかもしれません。 +.Sh 作者 +.An Klas Heggemann Aq klas@nada.kth.se +作成。 diff --git a/ja_JP.eucJP/man/man8/bootpd.8 b/ja_JP.eucJP/man/man8/bootpd.8 new file mode 100644 index 0000000000..924c413969 --- /dev/null +++ b/ja_JP.eucJP/man/man8/bootpd.8 @@ -0,0 +1,315 @@ +.\" Copyright (c) 1988, 1989, 1991 Carnegie Mellon University +.\" +.\" %Header: /home/ncvs/src/libexec/bootpd/bootpd.8,v 1.4.2.2 1997/08/24 18:22:28 joerg 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 +は RFC951, RFC1532, RFC1533 で定義された +インタネットブートプロトコル (BOOTP) サーバを実装したものです。 +.I bootpgw +は、要求と応答を、あるサブネット上のクライアントと、 +別のサブネット上の BOOTP サーバ (すなわち +.IR bootpd +) との間で転送するのに使われる、単純な BOOTP ゲートウェイを実装しています。 +.I bootpd +または +.I bootpgw +は BOOTREPLY パケットを転送しますが、 +.I bootpgw +だけが BOOTREQUEST パケットを転送します。 +.PP +各々のネットワークセグメントにつき、通常一つのホストで、 +以下の行のどれかをファイル +.IR /etc/inetd.conf +に含めることにより、 +.I bootpd +あるいは +.I bootpgw +が +.I inetd +から起動されるように設定されます: +.IP +bootps dgram udp wait root /usr/libexec/bootpd bootpd /etc/bootptab +.br +bootps dgram udp wait root /usr/libexec/bootpgw bootpgw server +.PP +この動作モードは「inetd モード」と呼ばれ、 +ブート要求が到着した時にだけ +.I bootpd +(あるいは +.IR bootpgw +) を開始します。 +もし最後にパケットを受信してから 15 分以内に別のパケットを受信しないのなら、 +システムの資源を浪費しないように終了します。 +.B \-t +オプションがこのタイムアウト時間を制御します (オプション参照)。 +.PP +他の通常のコマンドのように単にシェルから起動することで、 +.I bootpd +(あるいは +.IR bootpgw +) を「スタンドアローンモード」( +.IR inetd +なし) で実行することも可能です。 +.I bootpd +が大きなコンフィギュレーションデータベースのもとで使われる時には、 +inetd モードでの起動時の遅延が +クライアントの要求に対する素早い応答を妨げるので、 +スタンドアローンモードは特に役に立ちます。 +(例えば +.IR /etc/rc.local +から +.I bootpd +を呼びだすことによって、 +スタンドアローンモードで自動的に起動することができます) +.I bootgw +はコンフィギュレーションファイルを読まないので、 +起動時の遅延はかなり小さく、 +スタンドアローンモードはあまり役に立ちません。 +.PP +どちらのプログラムも、inetd から呼び出されたかシェルから呼び出されたかを +自動的に検出し、自動的に適当なモードを選択します。 +.B \-s +と +.B \-i +オプションは各々、スタンドアローンモードと inetd モードを強制するのに +使います (オプション参照) +.SH オプション +.TP +.BI \-t \ timeout +.I bootpd +あるいは +.I bootpgw +プロセスが終了する前に BOOTP パケットを待つ +.I timeout +値 (分単位) を指定します。 +もし +.I timeout +分内にパケットを受信しなければ、プログラムは終了します。 +timeout の値が 0 の場合は「永遠に実行する」という意味です。 +スタンドアローンモードでは、このオプションは 0 に強制されます。 +.TP +.BI \-d \ debug\-level +生成されるデバッグメッセージの量を制御する変数 +.I debug\-level +を設定します。 +例えば、-d4 あるいは -d 4 では、デバッグレベルが 4 に設定されます。 +古いバージョンの +.IR bootpd +との互換性のため、数字のパラメータを省略 (つまり、-d だけ) すると +単にデバッグレベルを一つだけ増加させます。 +.TP +.BI \-c \ chdir\-path +クライアントのブートファイルの存在とサイズを検査する間に +.I bootpd +で使われるカレントディレクトリを設定します。 +クライアントのブートファイルが相対パス名で指定されていて、 +.I bootpd +が TFTP サーバと同じカレントディレクトリ (典型的には /tftpboot) +を必要とするときに有用です。 +このオプションは +.IR bootpgw +によっては認識されません。 +.TP +.B \-i +強制的に inetd モードにします。 +このオプションは時代遅れですが、古いバージョンの +.IR bootpd +との互換性のために残してあります。 +.TP +.B \-s +強制的にスタンドアローンモードにします。 +このオプションは時代遅れですが、 +古いバージョンの +.IR bootpd +との互換性のために残してあります。 +.TP +.I bootptab +.I bootpd +がロードする +コンフィギュレーションファイルの名前を指定します ( +.RI bootpd +のみ)。 +これはあらかじめ知っているクライアントと +そのクライアントのオプションに関するデータベースです。 +.TP +.I dumpfile +.I bootpd +が、SIGUSR1 シグナルを受信したときに +内部データベースをダンプするファイルの名前を指定します ( +.RI bootpd +のみ)。 +このオプションは +.I bootpd +が -DDEBUG フラグ付きでコンパイルされたときだけ認識されます。 +.TP +.I server +.I bootpgw +が受信した全ての BOOTREQUEST パケットを転送する、 +BOOTP サーバの名前を指定します ( +.RI bootpgw +のみ)。 +.SH 操作 +.PP +.I bootps +ポートに送られたどんなパケットも取り込んで +どんな BOOTREPLY パケットも単純に転送するという点で +.I bootpd +と +.I bootpgw +の双方が似た動きをします。 +BOOTREQUEST の扱いは違います。 +.PP +.I bootpgw +は動作開始時に、コマンド行パラメタとして名前を与えられた +BOOTP サーバのアドレスを決めます。 +.I bootpgw +が BOOTREQUEST パケットを受信したとき、 +パケットの「ゲートウェイアドレス」と「ホップ数」フィールドを設定し、 +パケットを前に決めたアドレスの BOOT サーバへ転送します。 +要求パケットは、 +クライアントが少くとも 3 秒は待っているとパケットが示している時にだけ +転送されます。 +.PP +.I bootpd +は動作開始時にコンフィギュレーションファイル (通常 +.IR /etc/bootptab +) を読みこみます。 +これで、あらかじめ知っているクライアントと +クライアントのオプションに関する内部データベースを初期化します。 +この内部データベースは、 +.I bootpd +がハングアップシグナル (SIGHUP) を受信したとき、 +またはコンフィギュレーションファイルが変更されたことを +発見したときに、再読み込みが行なわれます。 +.PP +.I bootpd +が BOOTREQUEST パケットを受信したとき、 +.\" コンフィギュレーションファイルの変更時刻を検査し、 +.\" 必要ならデータベースの再読み込みをします。それから、 +クライアントの要求に一致するデータベースエントリを探します。 +もしそのクライアントをあらかじめ知っていれば +.I bootpd +は前に見付けたデータベースエントリを使って BOOTREPLY パケットを構成し、 +(ひょっとしたらゲートウェイを使って) クライアントに返答を送ります。 +もしクライアントが未知ならば、(debug > 0 のときは注意を出して) +要求は捨てられます。 +.PP +.I bootpd +が -DDEBUG オプションでコンパイルされていれば、 +SIGUSR1 シグナルを送ると内部データベースをファイル +.I /tmp/bootpd.dump +か、コマンド行パラメータで指定されたダンプファイルに +にダンプします。 +.PP +初期化の時どちらのプログラムも、 +(普通は +.IR /etc/services +を使う) +.I getservbyname +を呼ぶことで UDP ポート番号を決定します。 +二つのサービス名 (とポート番号) が使われます: +.IP +bootps \- BOOTP サーバ待機ポート +.br +bootpc \- BOOTP クライアント届け先ポート +.LP +もしポート番号が +.I getservbyname +を使って決定できないときには、 +デフォルト値は bootps=67 と bootpc=68 です。 +.SH 関連ファイル +.TP 20 +/etc/bootptab +.IR bootpd +によって読み込まれるデータベースファイル。 +.TP +/tmp/bootpd.dump +.IR bootpd +によって生成されるデバッグダンプファイル。 +.TP +/etc/services +インタネットサービス番号。 +.TP +/tftpboot +TFTP サーバと +.IR bootpd +で使われる典型的カレントディレクトリ。 + +.SH バグ +各々のホストエントリは 1024 文字を越えてはいけません。 + +.SH 功労者 +.PP +この配布版は現在、 Walter L. Wimer <walt+@cmu.edu> によって +保守されています。 +.PP +オリジナルの BOOTP サーバは +スタンフォード大学の Bill Croft によって 1986 年 1 月に作成されました。 +.PP +現在のバージョンの +.I bootpd +は第一に、Carnegie Mellon University の David Kovar, +Drew D. Perkins, Walter L. Wimer の仕事にるものです。 +.TP +機能拡張とバグフィクスは以下の方の貢献によります: +(アルファベット順) +.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 +DARPA Internet Request For Comments: +.TP 10 +RFC951 +Bootstrap Protocol +.TP 10 +RFC1532 +Clarifications and Extensions for the Bootstrap Protocol +.TP 10 +RFC1533 +DHCP Options and BOOTP Vendor Extensions diff --git a/ja_JP.eucJP/man/man8/bootpef.8 b/ja_JP.eucJP/man/man8/bootpef.8 new file mode 100644 index 0000000000..d2653697b0 --- /dev/null +++ b/ja_JP.eucJP/man/man8/bootpef.8 @@ -0,0 +1,49 @@ +.\" bootpef.8 +.\" jpman %Id: bootpef.8,v 1.2 1997/05/17 16:59:57 horikawa Stab % +.TH BOOTPEF 8 "4 Dec 1993" "MAINTENANCE COMMANDS" +.SH 名称 +bootpef \- BOOTP エクステンションファイルコンパイラ +.SH 書式 +.LP +.B bootpef +.RI [ "-c chdir" ] +.RI [ "-d debug-level" ] +.RI [ "-f config-file" ] +.RI [ client-name " [...]]" +.SH 解説 +.B bootpef +は、RFC 1497 (tag 18) で示されている +.I エクステンションパス +ファイルを作成します。 +.I client-name +が指定されていれば、 +.I bootpef +はそれらのクライアントのためだけのエクステンションファイルを +コンパイルします。 +.SH オプション +.TP +.BI \-c \ chdir\-path +.I bootpef +がエクステンションファイルを作るカレントディレクトリを指定します。 +これは、エクステンションファイル名が相対パスで指定され、 +.I bootpef +が TFTP サーバと同じカレントディレクトリ (一般には /tftpboot) を使う +必要がある場合に有効です。 +.TP +.BI \-d \ debug\-level +生成されるデバッグメッセージの量を制御する変数 +.I debug\-level +を設定します。たとえば、-d4 や -d 4 はデバッグレベルを 4 にセットします。 +.TP +.BI \-f \ config\-file +各クライアントに送られるオプションデータを指示する +コンフィギュレーションファイルの名前を設定します。 +.SH 関連項目 +bootpd(8), tftpd(8) +.SH リファレンス +.TP +RFC951 +BOOTSTRAP PROTOCOL (BOOTP) +.TP +RFC1497 +BOOTP Vendor Information Extensions diff --git a/ja_JP.eucJP/man/man8/bootptest.8 b/ja_JP.eucJP/man/man8/bootptest.8 new file mode 100644 index 0000000000..8b7b223ea3 --- /dev/null +++ b/ja_JP.eucJP/man/man8/bootptest.8 @@ -0,0 +1,77 @@ +.\" bootptest.8 +.\" jpman %Id: bootptest.8,v 1.3 1997/10/11 07:41:11 horikawa Stab % +.TH BOOTPTEST 8 "10 June 1993" "MAINTENANCE COMMANDS" +.SH 名称 +bootptest \- BOOTP に質問を送り、応答を出力する +.SH 書式 +.LP +.B bootptest +[ +.B \-f +.I bootfile +] +[ +.B \-h +] +[ +.B \-m +.I magic_number +] +.I server\-name +.RI [ template-file ] +.SH 解説 +.B bootptest +は、BOOTP リクエストを +.I server\-name +で指定されたホストに送ります。このとき、応答が得られるか、10 個の +リクエストが無応答に終わるまで 1 秒間隔で連続してリクエストを送信します。 +応答を受けとると、 +.B bootptest +は追加の応答を得るためにもう 1 秒待ちます。 +.SH オプション +.TP +.B \-f +.I bootfile +リクエストのブートファイルフィールドを +.IR bootfile +で埋めます。 +.TP +.B \-h +クライアントの識別にハードウェア (Ethernet) アドレスを用います。 +デフォルトでは、クライアントがすでにその IP アドレスを知っていると +いうことを示すようにリクエスト内に IP アドレスがコピーされます。 +.TP +.B \-m +.I magic-number +ベンダオプションフィールドの第 1 ワードを +.IR magic-number +で初期化します。 +.LP +.I template-file +が指定されると、 +.B bootptest +はリクエストパケットのオプションエリアを初期化するために +このファイルの内容(バイナリデータ)を使用します。 +.SH クレジット +.LP +bootptest プログラムは独自の創作物と創作派生物の組合せです。 +メインプログラムモジュール (bootptest.c) は +Gordon W. Ross <gwr@mc.com> 独自の創作物です。 +パケット表示モジュール (print-bootp.c) は BSD の tcpdump プログラム +から持ってきたファイルを一部変更したものです。 +.LP +このプログラムは +University of California、 +Lawrence Berkeley Laboratory と +その貢献者により開発されたソフトウェアを含んでいます。 +(print-bootp.c の著作権表示を参照のこと) +.SH 関連項目 +.LP +bootpd(8) +.SH リファレンス +.TP +RFC951 +BOOTSTRAP PROTOCOL (BOOTP) +.TP +RFC1048 +BOOTP Vendor Information Extensions diff --git a/ja_JP.eucJP/man/man8/ccdconfig.8 b/ja_JP.eucJP/man/man8/ccdconfig.8 new file mode 100644 index 0000000000..6990061523 --- /dev/null +++ b/ja_JP.eucJP/man/man8/ccdconfig.8 @@ -0,0 +1,174 @@ +.\" $NetBSD: ccdconfig.8,v 1.1.2.1 1995/11/11 02:43:33 thorpej Exp % +.\" +.\" Copyright (c) 1995 Jason R. Thorpe. +.\" 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 Jason R. Thorpe. +.\" 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. +.\" +.Dd July 17, 1995 +.\" jpman %Id: ccdconfig.8,v 1.3 1997/07/28 10:00:39 konuma Stab % +.Dt CCDCONFIG 8 +.Os FreeBSD +.Sh 名称 +.Nm ccdconfig +.Nd 結合ディスクドライバ用設定ユーティリティ +.Sh 書式 +.Nm ccdconfig +.Op Fl cv +.Ar ccd +.Ar ileave +.Op Ar flags +.Ar dev +.Op Ar ... +.Nm ccdconfig +.Fl C +.Op Fl v +.Op Fl f Ar config_file +.Nm ccdconfig +.Fl u +.Op Fl v +.Ar ccd +.Op Ar ... +.Nm ccdconfig +.Fl U +.Op Fl v +.Op Fl f Ar config_file +.Nm ccdconfig +.Fl g +.Op Fl M Ar core +.Op Fl N Ar system +.Oo +.Ar ccd Oo ... +.Oc +.Oc +.Sh 解説 +.Nm ccdconfig +は結合ディスクデバイス (concatenated disk device, ccd) の動的な設定および +解除を行う場合に使用します。ccd の詳細については、 +.Xr ccd 4 +を参照して下さい。 +.Pp +以下のオプションが使用できます。 +.Bl -tag -width indent +.It Fl c +ccd の設定を行います。 +.Nm ccdconfig +のデフォルトの動作です。 +.It Fl C +設定ファイルに書かれている全てのデバイスの設定を行います。 +.It Fl f Ar config_file +全てのデバイスの設定あるいは解除を行う時に、デフォルトの +.Pa /etc/ccd.conf +ではなく、 +.Pa config_file +から設定情報を読み込みます。 +.It Fl g +ccd の設定ファイルとして使用できる形式で、現在の ccd の設定を出力します。 +引数が指定されていなければ、設定されている全ての ccd について出力します。 +引数が指定されていれば、指定された ccd についてのみ出力します。 +.It Fl M Ar core +名前リストに対応する値の展開に、デフォルトの +.Pa /dev/mem +ではなく、 +.Pa core +を使用します。 +.It Fl N Ar system +( +.Xr getbootfile 3 +により判断される) +現在稼働中のカーネルの代わりに +.Ar system +をカーネルとして使用します。 +.It Fl u +ccd の設定を解除します。 +.It Fl U +ccd 設定ファイルに書かれている全ての ccd デバイスの設定を解除します。 +.It Fl v +より冗長な出力を行います。 +.El +.Pp +ccd は、コマンド行ないし ccd 設定ファイルにて、ccd の名前、インタリーブ +ファクタ、ccd 設定フラグ、ひとつ以上のデバイスのリストの情報により +定義されます。フラグは、十進数、十六進数、コンマで区切られた名前のリスト、 +.Dq none +のいずれかで表すことができます。 +フラグには以下の物があります。 +.\" 以下の表の部分のマクロはオリジナルの英語版とは異なるが、こちらの方が +.\" きれいに(見やすい形で)フォーマットされるので、変更した。 +.\" マクロ自体は NetBSD の ccdconfig.8 の日本語版を参考にした。 +.\" 2.2.2-RELEASE 対象 +.\" By yugawa@orleans.rim.or.jp (May 20 1997) +.\" +.\" "-offset indent" 追加。 +.\" 2.2.2-RELEASE 対象 +.\" By konuma@de.mtex.co.jp (Jul 28 1997) +.Pp +.Bl -tag -width "CCDF_UNIFORM 0x02" -ffset intent -compact -offset indent +.It "CCDF_SWAP 0x01" +dmmax (swap の単位ブロックの最大値) 単位でインタリーブします +.It "CCDF_UNIFORM 0x02" +ディスク間で均一なインタリーブ動作になります +.It "CCDF_MIRROR 0x04" +データのミラーリングを行います +.It "CCDF_PARITY 0x08" +パリティ検査を行います (現状では使用できません) +.El +.Pp +設定ファイルのフォーマットは、コマンド行から指定する場合と +同一の形式になります。コマンド行から指定する場合も、 +設定ファイルから指定する場合も、 +.Pa flags +引数はオプションです。 +.Bd -unfilled -offset indent +# +# /etc/ccd.conf +# Configuration file for concatenated disk devices +# +.Pp +# ccd ileave flags component devices +ccd0 16 none /dev/sd2e /dev/sd3e +.Ed +.Pp +.Sh 使用例 +コマンド行から以下のコマンドを実行した場合、ccd0 を +(/dev/sd2e, /dev/sd3e, /dev/sd4e, /dev/sd5e の) 四つの要素から +構成され、32 ブロックごとにインタリーブする ccd として設定します。 +.Bd -unfilled -offset indent +# ccdconfig ccd0 32 0 /dev/sd2e /dev/sd3e /dev/sd4e /dev/sd5e +.Ed +.Pp +.Sh 関連ファイル +/etc/ccd.conf - デフォルトの ccd 設定ファイル +.Sh 関連項目 +.Xr ccd 4 , +.Xr rc 8 +.Sh 歴史 +.Nm ccdconfig +コマンドは +.Nx 1.0a +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/chat.8 b/ja_JP.eucJP/man/man8/chat.8 new file mode 100644 index 0000000000..4edcb84467 --- /dev/null +++ b/ja_JP.eucJP/man/man8/chat.8 @@ -0,0 +1,502 @@ +.\" -*- nroff -*- +.\" manual page [] for chat 1.8 +.\" %Id: chat.8,v 1.4.2.2 1997/09/14 20:39:29 jkh Exp % +.\" jpman %Id: chat.8,v 1.3 1997/08/31 14:02:42 horikawa Stab % +.\" SH section heading +.\" SS subsection heading +.\" LP paragraph +.\" IP indented paragraph +.\" TP hanging label +.TH CHAT 8 "5 May 1995" "Chat Version 1.9" +.SH 名称 +chat \- モデム接続の確立を自動化するスクリプト言語 +.SH 書式 +.B chat +[ +.I options +] +.I script +.SH 解説 +.LP +\fIchat\fR プログラムはコンピュータとモデムの間のメッセージ交換を制御します。 +このコマンドの主な目的は、Point-to-Point Protocol デーモン (\fIpppd\fR) と +リモートの \fIpppd\fR プロセスの間の接続を確立することです。 +.SH オプション +.TP +.B -f \fI<chat file> +チャットスクリプトを \fIchat file\fR から読み込みます。このオプションと +script パラメータとは、互いに排他の関係にあります。 +chat コマンドを実行するユーザは、このファイルのリードアクセス権を +持っていなければなりません。このファイルの中では、文字列の区切りとして +スペースとタブを使うことができます。 +.TP +.B -t \fI<timeout> +文字列の受信待ちのタイムアウトを指定します。もし、タイムリミットまでに +指定された文字列を受信できなかった場合には、応答文字列の送信をおこないません。 +この時、かわりの応答文字列が指定されていれば それが送信され、 +指定されていなければ スクリプトの実行が失敗します。 +スクリプトの実行が失敗すると、\fIchat\fR プログラムは +0 以外のエラーコードを返して終了します。 +.TP +.B -r \fI<report file> +レポート文字列を出力するファイルを指定します。 +キーワード \fIREPORT\fR を用いると、結果の文字列がこのファイルに +出力されます。このオプションを指定せずに \fIREPORT\fR キーワードを +使用すると、レポート文字列は \fIstderr\fR に出力されます。 +.TP +.B -e +エコーオプションを有効にして開始します。 +\fIchat\fR スクリプトの特定の場所において +\fIECHO\fR キーワードにて +エコーの有効および無効を切り替えることができます。 +エコーが有効にされると、モデムからの出力は全て \fIstderr\fR へエコーされます。 +.TP +.B -v +\fIchat\fR スクリプトを冗長モードで実行します。 +これを指定すると、\fIchat\fR プログラムはモデムから受信したすべてのテキストと +.IR syslogd (8) +に送られる出力のログをとります。 +冗長トレースのログとりは \fIlocal2\fR ファシリティのレベル \fIinfo\fR +でおこなわれ、エラーについてはレベル \fIerr\fR が使われます。 +.TP +.B -V +\fIchat\fR スクリプトを stderr 冗長モードにて実行するように要求します。 +\fIchat\fR プログラムは、 +モデムから受信する全てのテキストおよび +stderr デバイスへ送出する出力文字列をログします。 +chat もしくは pppd プログラムを動作させている場所では、 +このデバイスは通常ローカルのコンソールです。 +stderr が /dev/null にリダイレクトされている場合には、 +このオプションはうまく働きません。 +pppd が `デタッチ' モードで動作している時がその場合です。 +この場合、`-v' オプションを使用して、 +セッションを SYSLOG デバイスへ記録してください。 +.TP +.B script +\fI-f\fR オプションのファイルでスクリプトが指定されていなければ、 +\fIchat\fR プログラムに対するパラメータ文字列が +スクリプトとして読み込まれます。 +.SH チャットスクリプト +.LP +\fIchat\fR スクリプトには通信の手順を定義します。 +.LP +スクリプトは一つまたはそれ以上の「受信待ち-送信」文字列の組からなり、 +それぞれは空白で区切られています。 +オプションとして「副受信待ち-副送信」文字列の組を追加することもでき、 +その場合には以下の例のようにダッシュで区切ります: +.IP +ogin:-BREAK-ogin: ppp ssword: hello2u2 +.LP +これにより、\fIchat\fR プログラムは文字列 "ogin:" の受信待ちをおこないます。 +もしもタイムアウトする前にログインプロンプトを受信できなければ、 +リモートホストにブレーク信号を送信し、それから文字列 "ogin:" を受信待ちします。 +もしも最初の "ogin:" が受信できていれば、ブレーク信号は送信されません。 +.LP +一旦ログインプロンプトを受信すると、\fIchat\fR プログラムは文字列 ppp を +送信して、プロンプト "ssword:" の受信を待ちます。 パスワードプロンプトを +受信すると、chat プログラムはパスワード hello2u2 を送信します。 +.LP +応答文字列に続いて、通常はキャリッジリターン文字が送られます。 +「受信待ち」文字列中では、\\r 文字シーケンスで明示的に指定しないかぎり、 +キャリッジリターンは文字列に含まれません。 +.LP +目的の文字列を識別するのに必要な部分だけを受信待ち文字列に +指定するようにするべきです。 +なぜなら、受信待ち文字列は通常ディスクファイルに記録されるため、 +動的に変化する情報を含むことができないからです。 +一般には、時刻を表す文字列やネットワーク ID 文字列その他の +変化するデータの塊を受信待ちさせることはできません。 +.LP +通信の初期段階では、文字が化けて受信される場合があります。 +この場合にも正しく認識ができるように、 +文字列 "login:" ではなく "ogin:" を待つようにします。 +仮に最初の "l" という文字が化けて受信されたとしますと、 +リモートシステムが "login:" を送信したとしても、 +その文字列は認識されないことになります。 +このため、スクリプトでは "login:" ではなく "ogin:" を、 +"password:" ではなく "ssword:" を待つようにします。 +.LP +非常に単純なスクリプトは、以下のようになるでしょう: +.IP +ogin: ppp ssword: hello2u2 +.LP +言いかえると、....ogin: を受信待ちして ppp を送信し、...ssword: を +受信待ちして hello2u2 を送信するということになります。 +.LP +現実問題としては、単純なスクリプトが使われることはほとんどないでしょう。 +少なくとも、最初の受信待ち文字列が受信できなかった場合に、 +副受信待ち文字列を実行するようにするべきでしょう。 +たとえば、以下のスクリプトを考えてみます: +.IP +ogin:--ogin: ppp ssword: hello2u2 +.LP +これは以前に使った単純なものよりも良いスクリプトでしょう。 +以前のものと同様に login: プロンプトを待ちますが、もし受信できなかった場合には +リターンを一つ送ってから再び login: が送られてくるのを待ちます。 +最初のログインプロンプトがラインノイズによって化けたとしても、 +空行が送られることで、通常はもう一度ログインプロンプトが送信されます。 +.SH コメント +コメントを chat スクリプト中に埋め込むことが可能です。 +コメントは \fB#\fR (ハッシュ) 文字をカラム 1 から開始する行です。 +このようなコメント行は chat プログラムは単に無視します。 +「受信待ち」文字列の最初の文字が `#' 文字の場合、 +「受信待ち」文字列をクォートする必要があります。 +文字 # (ハッシュ)から始まるプロンプトを待ちたい場合には、 +以下のように書かねばならないでしょう: +.IP +# Now wait for the prompt and send logout string +.br +\'# ' logout +.LP + +.SH 中断文字列 +多くのモデムはダイアルの結果を文字列としてレポートします。 +これらの文字列は \fBCONNECTED\fR だったり、\fBNO CARRIER\fR や \fBBUSY\fR +だったりするでしょう。 +モデムが相手との接続に失敗した場合には、スクリプトを終了させたいと +思うことがよくあるでしょう。 +問題は、どの文字列を次に受信するかということを、 +スクリプトが正確に知ることはできないということです。 +ある時には \fBBUSY\fR を受信するかもしれませんが、 +次には \fBNO CARRIER\fR を受信するかもしれません。 +.LP +これらの「中断」文字列は、\fIABORT\fR シーケンスにより +スクリプト中に指定することができます。 +それは、以下の例のようにスクリプトに指定します: +.IP +ABORT BUSY ABORT 'NO CARRIER' '' ATZ OK ATDT5551212 CONNECT +.LP +このシーケンスは受信待ちをおこないません。それから文字列 ATZ を送信します。 +受信待ち文字列は \fIOK\fR です。 +\fIOK\fR を受信すると、電話をかけるために文字列 ATDT5551212 を送信します。 +受信待ち文字列は \fICONNECT\fR です。 +文字列 \fICONNECT\fR を受信すると、スクリプトの残りが実行されます。 +一方、モデムが話中を検出すると、文字列 \fIBUSY\fR が送られて +中断文字列への一致が起こります。 +この一致が起きたことにより、スクリプトは失敗します。 +もしも文字列 \fINO CARRIER\fR を受信すると、それは同じ理由で中断されます。 +どちらの文字列が受信されても、\fIchat\fR スクリプトは終了します。 +.SH CLR_ABORT 文字列 +このシーケンスは以前に設定した \fBABORT\fR 文字列をクリアします。 +\fBABORT\fR 文字列は規定サイズ(コンパイル時に決定)の配列に保持されます; +\fBCLR_ABORT\fR はクリアされたエントリの領域を再要求し、 +新たな文字列をそこに格納できるようにします。 +.SH SAY 文字列 +\fBSAY\fR ディレクティブにて、 +script が標準エラー出力を介してユーザ端末ヘ文字列を送ることができます。 +\fBchat\fR が pppd から起動される場合、 +pppd はデーモンとして実行され(制御端末から切離され)、 +標準エラー出力は通常 +/etc/ppp/connect-errors +へとリダイレクトされます。 +.LP +\fBSAY\fR 文字列は、シングルクォートもしくはダブルクォートにて +括る必要があります。 +出力中にキャリッジリターンおよびラインフィードが必要な場合、 +明示的に文字列中に含める必要があります。 +.LP +SAY 文字列を使用して script の進捗状況メッセージを表示することで、'ECHO +OFF' +しつつもユーザになにが起っているのか示すことが可能です。 +例を示します: +.IP +ABORT BUSY +.br +ECHO OFF +.br +SAY "Dialling your ISP...\\n" +.br +\'' ATDT5551212 +.br +TIMEOUT 120 +.br +SAY "Waiting up to 2 minutes for connection ... " +.br +CONNECT '' +.br +SAY "Connected, now logging in ...\n" +.br +ogin: account +.br +ssword: pass +.br +$ \c +SAY "Logged in OK ...\n" +\fIetc ...\fR +.LP +このシーケンスは SAY 文字列のみユーザに示し、script の詳細は隠します。 +例えば、上記 script を実行した場合、ユーザが見るのは以下です: +.IP +Dialling your ISP... +.br +Waiting up to 2 minutes for connection ... Connected, now logging in ... +.br +Logged in OK ... +.LP + +.SH レポート文字列 +\fBレポート\fR 文字列は ABORT 文字列に似ています。 +違うのは、その文字列自身とキャリッジリターン等の +次の制御文字までの +すべての文字がレポートファイルに書かれるということです。 +.LP +レポート文字列はモデムのコネクト文字列の転送レートと +chat ユーザへのリターン値を切りわけるために使えます。 +レポート文字列ロジックの分析は、受信待ち文字列の検索などの +他の文字列処理と同時におこなわれます。 +レポート文字列と中断文字列に同じ文字列を使用することも可能ですが、 +おそらくあまり使い道がないでしょう。 +.LP +レポート文字列はプログラムの終了コードに影響を及ぼしません。 +.LP +これらの「レポート」文字列は、\fIREPORT\fR シーケンスにより +スクリプト中に指定することができます。 +それは、以下の例のようにスクリプトに指定します: +.IP +REPORT CONNECT ABORT BUSY '' ATDT5551212 CONNECT '' ogin: account +.LP +このシーケンスは受信待ちをおこなわず、文字列 ATDT5551212 を送信して +電話をかけます。受信待ち文字列は \fICONNECT\fR です。 +文字列 \fICONNECT\fR を受信すると、スクリプトの残りが実行されます。 +さらに、文字列 "CONNECT" と、それに続く接続レートなどの +任意の文字がレポートファイルに記録されます。 +.\" 原文では expect-file となっているが、report-file の間違いと思われる。 +.\" send-pr する予定。 +.\" 2.2.2R 対象(1997/06/04) Saeki Takashi <saeki@ba2.so-net.or.jp> +.SH CLR_REPORT 文字列 +このシーケンスを使用して、以前に設定した \fBREPORT\fR 文字列をクリア +できます。 +\fBREPORT\fR 文字列は規定サイズ(コンパイル時に決定)の配列に保持されます; +\fBCLR_REPORT\fR はクリアされたエントリの領域を再要求し、 +新たな文字列をそこに格納できるようにします。 +.SH エコー +エコーオプションはモデムからの出力を \fIstderr\fR へエコーするか否か +を制御します。 +このオプションを \fI-e\fR オプションにて設定することができますし、 +\fIECHO\fR キーワードにて制御することもできます。 +「受信待ち-送信」文字列の組 \fIECHO\fR \fION\fR はエコーを有効にし、 +\fIECHO\fR \fIOFF\fR は無効にします。 +このキーワードを使用してどの会話を見せるかを選択可能です。 +例えば以下の script では: +.IP +ABORT 'BUSY' +.br +ABORT 'NO CARRIER' +.br +'' ATZ +.br +OK\\r\\n ATD1234567 +.br +\\r\\n \\c +.br +ECHO ON +.br +CONNECT \\c +.br +ogin: account +.LP +モデム設定結果およびダイヤル結果は見せませんが、 +\fICONNECT\fR (もしくは \fIBUSY\fR) メッセージ語は全てをエコーします。 +.SH ハングアップ +HANGUP オプションはモデムハングアップをエラーと扱うか否かを制御します。 +このオプションは、 +システムにダイヤル後にハングアップしコールバックする script 中で有効です。 +HANGUP オプションは \fBON\fR もしくは \fBOFF\fR にできます。 +.br +HANGUP を OFF に設定しモデムをハングアップ +(つまりコールバックシステムへの最初のログイン)すると、\fBchat\fR は +script の実行を続けます +(つまり呼び出しと二度目のログインプロンプトを待ちます)。 +呼び出しにて接続後すぐに、\fBHANGUP ON\fR ディレクティブを使用して +通常のハングアップシグナルの動作を戻す必要があります。 +(簡単な) script 例を示します: +.IP +ABORT 'BUSY' +.br +'' ATZ +.br +OK\\r\\n ATD1234567 +.br +\\r\\n \\c +.br +CONNECT \\c +.br +\'Callback login:' call_back_ID +.br +HANGUP OFF +.br +ABORT "Bad Login" +.br +\'Callback Password:' Call_back_password +.br +TIMEOUT 120 +.br +CONNECT \\c +.br +HANGUP ON +.br +ABORT "NO CARRIER" +.br +ogin:--BREAK--ogin: real_account +.br +\fIetc ...\fR +.LP +.SH タイムアウト +タイムアウトの初期値は 45 秒です。これは \fB-t\fR パラメータにより +変更することができます。 +.LP +次に受信待ちする文字列のタイムアウト値を変更するには、以下のようにします: +.IP +ATZ OK ATDT5551212 CONNECT TIMEOUT 10 ogin:--ogin: TIMEOUT 5 assword: hello2u2 +.LP +これは login: プロンプトを受信待ちする際のタイムアウトを 10 秒に変更します。 +さらに password プロンプトを受信待ちする際にはタイムアウトを 5 秒に変更します。 +.LP +一旦タイムアウト値が変更されると、次に変更されるまでは +そのままになります。 +.SH EOT の送信 +チャットプログラムは特殊な応答文字列 \fIEOT\fR により、 +リモート側へ EOT 文字を送信します。 +通常、これはファイル終了を表す文字です。 +EOT に続けてリターン文字が送られることはありません。 +.PR +\fI^D\fR シーケンスを使って EOT を送信文字列に埋め込むことができます。 +.SH ブレークの生成 +特殊な応答文字列 \fIBREAK\fR により、ブレーク信号が送られます。 +ブレークは送信側では特殊な信号として扱われます。 +受信側では通常、転送レートの変更要求として処理されます。 +これにより、正常に login プロンプトを受信できるまで +ブレーク信号を送ることで、リモート側がサポートしている転送レートを +順次切替えさせることができます。 +.PR +\fI\\K\fR シーケンスを使ってブレーク信号を送信文字列に埋め込むことができます。 +.SH エスケープシーケンス +受信待ち文字列と応答文字列には、エスケープシーケンスを指定することができます。 +応答文字列では、すべてのエスケープシーケンスが使えます。 +受信待ち文字列では、ほとんどのエスケープシーケンスが使えます。 +受信待ち文字列では使えないエスケープシーケンスについては、 +説明文中にそのことが書かれています。 +.TP +.B '' +空文字列を受信待ちしたり、送信したりします。 +もし、空文字列を送信しようとすると、それはリターン文字を送ることになります。 +このシーケンスはアポストロフィ文字またはクォート文字のペアの +どちらでもかまいません。 +.TP +.B \\\\b +バックスペース文字を表します。 +.TP +.B \\\\c +応答文字列の末尾の改行を抑制します。 +これは末尾に改行文字のつかない文字列を送る唯一の方法です。 +これは送信文字列の最後に置かれなければいけません。 +たとえば、文字列 hello\\c は単に h, e, l, l, o という文字だけを送ります。 +.I (受信待ち文字列では使えません) +.TP +.B \\\\d +1 秒のディレイです。プログラムは 1 秒のディレイのために sleep(1) を使います。 +.I (受信待ち文字列では使えません) +.TP +.B \\\\K +ブレーク信号を挿入します。 +.I (受信待ち文字列では使えません) +.TP +.B \\\\n +改行文字を送信します。 +.TP +.B \\\\N +空 (null) 文字を送信します。\\0 でも同じシーケンスを表すことができます。 +.I (受信待ち文字列では使えません) +.TP +.B \\\\p +1 秒以下のポーズです。ディレイ時間は 1/10 秒です。 +.I (受信待ち文字列では使えません) +.TP +.B \\\\q +.IR syslogd (8) +への文字列出力を抑止します。 +かわりに文字列 ?????? がログに出力されます。 +.I (受信待ち文字列では使えません) +.TP +.B \\\\r +キャリッジリターン文字を送信または受信待ちします。 +.TP +.B \\\\s +文字列中のスペース文字を表します。 +これはスペースを含む文字列をクォートしたくない場合に使います。 +シーケンス 'HI TIM' と HI\\sTIM は等価です。 +.TP +.B \\\\t +タブ文字を送信または受信待ちします。 +.TP +.B \\\\\\\\ +バックスラッシュ文字を送信または受信待ちします。 +.TP +.B \\\\ddd +8 進数 (ddd) を一つの ASCII 文字に変換し、その文字を送信します。 +.I (受信待ち文字列では使えない文字がいくつかあります) +.TP +.B \^^C +C で表現される制御文字に置きかえられます。 +例えば、文字 DC1 (17) は \^^Q で表されます。 +.I (受信待ち文字列では使えない文字がいくつかあります) +.SH 終了コード +\fIchat\fR プログラムは以下の終了コードを返します。 +.TP +.B 0 +プログラムは正常終了しました。これは、スクリプトがエラーを起こさずに +実行されて、正常に終了したことを示します。 +.TP +.B 1 +一つまたはそれ以上のパラメータが不正であるか、受信待ち文字列が +内部バッファよりも大きすぎます。これはプログラムが正しく +実行されなかったことを示します。 +.TP +.B 2 +プログラムの実行中にエラーが発生しました。これは、何らかの理由で +リードまたはライトの操作が失敗したか、chat が SIGINT のような +シグナルを受信したためでしょう。 +.TP +.B 3 +「-副送信」文字列のない\fI受信待ち\fR文字列があり、タイムアウトイベントが +発生しました。これは、スクリプトが正しくプログラムされていないか、 +予期しないイベントが発生して受信待ち文字列を見つけられなかったためでしょう。 +.TP +.B 4 +\fIABORT\fR 条件としてマークされた 1 番目の文字列を検出しました。 +.TP +.B 5 +\fIABORT\fR 条件としてマークされた 2 番目の文字列を検出しました。 +.TP +.B 6 +\fIABORT\fR 条件としてマークされた 3 番目の文字列を検出しました。 +.TP +.B 7 +\fIABORT\fR 条件としてマークされた 4 番目の文字列を検出しました。 +.TP +.B ... +その他の終了コードも、\fIABORT\fR 条件としてマークされた文字列を +検出したことを示します。 +.LP +終了コードを使うと、どのイベントによりスクリプトが終了したのかを +判断することができます。 +つまり、"NO DIAL TONE" を受信したのか "BUSY" を受信したのかを +識別することができるということです。 +最初のイベント (BUSY) ならばリトライする価値がありますが、 +二つ目のイベント (NO DIAL TONE) だと、 +おそらくリトライしてもそれがうまくいく可能性は低いでしょう。 +.SH 関連項目 +UUCP のドキュメントからも、\fIchat\fR スクリプトに関する +追加情報が得られるでしょう。 +\fIchat\fR スクリプトは \fIuucico\fR プログラムで使われる +スクリプトによって提示されたアイデアを基にしています。 +.LP +uucico(1), uucp(1) +.SH 著作権 +\fIchat\fR プログラムは、パブリックドメインのソフトウェアです。 +これは GNU のパブリックライセンス(一般公有使用許諾)とは ことなります。 +このプログラムを分割する場合には、その両方を管理するようにしてください。 +.\" 原文は The \fIchat\fR program is in public domain. This is not +.\" the GNU public license. If it breaks then you get to keep both pieces. +.\" 最後の文章にはあまり自信がありません。(^_^;; +.\" 2.2.2R 対象(1997/06/26) Saeki Takashi <saeki@ba2.so-net.or.jp> diff --git a/ja_JP.eucJP/man/man8/chown.8 b/ja_JP.eucJP/man/man8/chown.8 new file mode 100644 index 0000000000..46570a50de --- /dev/null +++ b/ja_JP.eucJP/man/man8/chown.8 @@ -0,0 +1,148 @@ +.\" Copyright (c) 1990, 1991, 1993, 1994 +.\" 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. +.\" +.\" 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. +.\" +.\" @(#)chown.8 8.3 (Berkeley) 3/31/94 +.\" %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 % +.\" +.Dd March 31, 1994 +.Dt CHOWN 8 +.Os BSD 4 +.Sh 名称 +.Nm chown +.Nd 指定したファイルの所有者およびグループを変更する +.Sh 書式 +.Nm chown +.Oo +.Fl R +.Op Fl H | Fl L | Fl P +.Oc +.Op Fl f +.Op Fl h +.Ar owner Op Ar :group +.Ar +.Nm chown +.Oo +.Fl R +.Op Fl H | Fl L | Fl P +.Oc +.Op Fl f +.Op Fl h +.Ar :group +.Ar +.Sh 解説 +.Nm +は指定したファイルのユーザ ID や グループ ID を設定します。 +.Pp +オプションは以下のものがあります: +.Bl -tag -width Ds +.It Fl H +.Fl R +オプションが指定されている場合に、コマンドライン上の +シンボリックリンクをたどるようになります。 +( ツリー内をたどっている際中に見つけたシンボリックリンクの先は +調べません。) +.It Fl L +.Fl R +オプションが指定された場合に、全てのシンボリックリンクを +たどるようになります。 +.It Fl P +.Fl R +オプションが指定された場合に、シンボリックリンクの先を +たどらないようになります。 +.It Fl R +指定したファイル自身だけでなくその代わりに、 +そのファイルをルートとする階層のファイルのユーザ ID やグループ ID を +変更します。 +.It Fl f +所有者やグループの変更が失敗しても報告を行ないません。 +変更の失敗は戻り値にも影響しません。 +.It Fl h +ファイルがシンボリックリンクの場合、 +リンクが指すファイルではなくリンク自身のユーザ ID および/またはグループ ID +を変更します。 +.El +.Pp +.Fl H , +.Fl L , +.Fl P +のオプションは +.Fl R +が指定されない限り無視されます。 +加えて、これらのオプションはお互いの効果を上書きするため、 +コマンドの動作は一番最後に指定されたもので決まります。 +.Pp +.Ar owner +と +.Ar group +のオペランドはどちらも無くてもよいもの (optional) ですが、 +少なくともどちらかを指定しなければなりません。 +.Ar group +オペランドを指定した場合は +先頭にコロン (``:'') をつけて下さい。 +.Pp +.Ar owner +は ユーザ ID の数値かユーザ名のどちらかです。ユーザ名がユーザ ID +の数値でもある場合、このオペランドはユーザ名とみなされます。 +.Ar group +は +グループ ID の数値かグループ名のどちらかです。グループ名がグループ ID +の数値でもある場合、このオペランドはグループ名とみなされます。 +.Pp +セキュリティの関係上明らかなことですが、ファイルの所有者の変更はスーパユーザ +にしか行なうことができません。 +.Pp +.Nm +は成功時に 0 を、エラーが起こった時に 0 より大きい値を戻り値とし +て返します。 +.Sh 互換性 +.Nm +の以前のバージョンは、グループ名を指定するのにドット (``.'') を +用いていました。 +この文字はコロン (``:'') に変更されたため、 +ユーザ名やグループ名にドットを含んでも構いません。 +.Pp +.Sh 関連項目 +.Xr chgrp 1 , +.Xr find 1 , +.Xr chown 2 , +.Xr fts 3 , +.Xr symlink 7 +.Sh 規格 +.Nm +コマンドは +.St -p1003.2 +互換であると考えられています。 +.Sh 歴史 +.Nm +コマンドは +.At v1 +から導入されました。
\ No newline at end of file diff --git a/ja_JP.eucJP/man/man8/chroot.8 b/ja_JP.eucJP/man/man8/chroot.8 new file mode 100644 index 0000000000..5150f8ab01 --- /dev/null +++ b/ja_JP.eucJP/man/man8/chroot.8 @@ -0,0 +1,77 @@ +.\" 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. +.\" +.\" 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. +.\" +.\" @(#)chroot.8 8.1 (Berkeley) 6/9/93 +.\" jpman %Id: chroot.8,v 1.2 1997/03/31 13:31:37 horikawa Stab % +.\" +.Dd June 9, 1993 +.Dt CHROOT 8 +.Os BSD 4.3 +.Sh 名称 +.Nm chroot +.Nd 指定したディレクトリをルートディレクトリとみなして、コマンドを実行する +.Sh 書式 +.Nm chroot +.Ar newroot +.Op Ar command +.Sh 解説 +.Nm +コマンドは、ルートディレクトリを +.Ar newroot +に変更して +.Ar command +を実行 (exec) します。 +.Ar command +が指定されなかった場合は、自分のシェルのコピーが用いられます。 +.Pp +コマンドやシェルは自分の実ユーザ ID で実行されることに注意してください +.Sh 環境変数 +以下の環境変数が +.Nm +から参照されます: +.Bl -tag -width SHELL +.It Ev SHELL +もしこの変数がセットされていれば、実行 (exec) するシェルの名前として +この文字列が用いられます。もし +.Ev SHELL +がセットされていない場合は +.Pa /bin/sh +が用いられます。 +.El +.Sh 関連項目 +.Xr chdir 2 , +.Xr chroot 2 , +.Xr environ 7 +.Sh 歴史 +.Nm +ユーティリティは +.Bx 4.4 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/clri.8 b/ja_JP.eucJP/man/man8/clri.8 new file mode 100644 index 0000000000..26e3928f80 --- /dev/null +++ b/ja_JP.eucJP/man/man8/clri.8 @@ -0,0 +1,82 @@ +.\" Copyright (c) 1980, 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. +.\" +.\" 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. +.\" +.\" @(#)clri.8 8.2 (Berkeley) 4/19/94 +.\" %Id: clri.8,v 1.2.2.1 1997/03/03 07:01:14 mpp Exp % +.\" jpman %Id: clri.8,v 1.2 1997/05/17 16:57:59 horikawa Stab % +.\" +.Dd April 19, 1994 +.Dt CLRI 8 +.Os BSD 4 +.Sh 名称 +.Nm clri +.Nd i ノードをクリアする +.Sh 書式 +.Nm clri +.Ar special_device inode_number ... +.Sh 解説 +.Bf -symbolic +通常は +.Xr fsck 8 +でファイルシステムの修復を行なうので、 +.Nm clri +は古いもの(obsolete) +となっています。 +.Ef +.Pp +.Nm clri +は、指定した特殊ファイル +.Ar special_device +上にあるファイルシステムの、指定された +i ノード番号の i ノードを 0 でクリアします。 +クリアされた inode や、以前その inode によって +使用されていたブロックを再使用できるようにするために、普通は +.Nm clri +を実行したあとで +.Xr fsck 8 +をそのファイルシステムに対して実行します。 +.Pp +このコマンドは主に、なんらかの原因によって +.Xr fsck 8 +が適切に処理することのできなくなったファイルを削除するためにあります。 +一度削除されれば、 +そのあとのファイルシステム上のつじつま合わせは +.Xr fsck 8 +が行ってくれることが期待できます。 +.Sh 関連項目 +.Xr fsck 8 , +.Xr fsdb 8 +.Sh バグ +オープンされているファイルに対して +.Nm clri +を実行しても、 +そのファイルをクローズする際にキャッシュからディスクに +i ノードが書き戻されるために、その効果が失われてしまいます。 diff --git a/ja_JP.eucJP/man/man8/comcontrol.8 b/ja_JP.eucJP/man/man8/comcontrol.8 new file mode 100644 index 0000000000..d543d1bd43 --- /dev/null +++ b/ja_JP.eucJP/man/man8/comcontrol.8 @@ -0,0 +1,68 @@ +.\" %Id: comcontrol.8,v 1.8.2.2 1997/03/03 07:01:28 mpp Exp % +.\" jpman %Id: comcontrol.8,v 1.3 1997/08/16 13:09:13 horikawa Stab % +.Dd May 15, 1994 +.Dt COMCONTROL 8 +.Os FreeBSD +.Sh 名称 +.Nm comcontrol +.Nd シリアルデバイス(sio) の制御 +.Sh 書式 +.Nm comcontrol +.Ar sio_special_device +.Op options +.Sh 解説 +.Nm comcontrol +は、指定したシリアルデバイス (sio) の特別な設定内容を表示/変更するのに +用いられます。 +デバイス名以外の引数が指定されない場合、 +制御可能な全ての項目が表示されます。 +.Nm comcontrol +をこのように利用する際には、 +当該デバイスの読み取り許可だけが必要になります。 +設定を変更できるのはスーパユーザだけです。 +.Pp +以下のオプションが利用可能です: +.Bl -tag -width Fl +.It Cm dtrwait Ar number +DTR が落ちたあと待機する時間を設定します。 +単位は 100 分の 1 秒です。 +デフォルトは 300 すなわち 3 秒です。 +このオプションは主として、モデムをリセットした後に +適切な復帰時間を置くのに用いられます。 +.El +.Bl -tag -width Fl +.It Cm drainwait Ar number +出力が出てくるまでの待機時間を設定します。 +単位は秒です。 +デフォルトは 0 つまり無限に待ち続けます。 +このオプションは主に、 +待ち時間上限値を指定してモデムのハングを回避するのに用いられます。 +.El +.Pp +.Nm comcontrol +の標準的な使い方は、スタートアップスクリプト +.Ar /etc/rc.serial +の中に +.Nm comcontrol +の起動を含めておくことです。 +.Sh 関連項目 +.Xr stty 1 , +.Xr sio 4 +.Sh 関連ファイル +.Bl -tag -width Pa +.It Pa /dev/ttyd? +ダイアルインデバイス。結線した端末(hardwired terminals)。 +.It Pa /dev/cuaa? +ダイアルアウトデバイス。 +.Sh 作者 +Christopher G. Demetriou +.Sh バグ +.Nm comcontrol +は +.Nm siocontrol +という名前にすべきです。 +.Sh 歴史 +オリジナルは 386BSD 0.1 に対する cgd の com パッケージパッチの +バージョン 0.2.1 です。 +かつては双方向制御機能を持っていましたが、 +現在ではこれらは標準機能となり、制御できるものはほとんどありません。 diff --git a/ja_JP.eucJP/man/man8/comsat.8 b/ja_JP.eucJP/man/man8/comsat.8 new file mode 100644 index 0000000000..78f17e6c7c --- /dev/null +++ b/ja_JP.eucJP/man/man8/comsat.8 @@ -0,0 +1,99 @@ +.\" Copyright (c) 1983, 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. +.\" +.\" 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. +.\" +.\" @(#)comsat.8 8.1 (Berkeley) 6/4/93 +.\" %Id: comsat.8,v 1.3 1996/09/22 21:53:05 wosch Exp % +.\" jpman %Id: comsat.8,v 1.2 1997/03/31 13:32:20 horikawa Stab % +.\" +.Dd June 4, 1993 +.Dt COMSAT 8 +.Os BSD 4.2 +.Sh 名称 +.Nm comsat +.Nd biff サーバ +.Sh 書式 +.Nm comsat +.Sh 解説 +.Nm comsat +は受信メールのレポートを受け取り、 +サービスを要求しているユーザに対して通知を行なうサーバプロセスです。 +.Nm comsat +は、 +.Dq biff +サービス仕様 ( +.Xr services 5 +および +.Xr inetd 8 +を参照) に関連するデータグラムポートのメッセージを受信します。 +1 行メッセージは次の形式です: +.Pp +.Dl user@mailbox-offset[:mailbox-name] +.Pp +もし、この +.Em user +がシステムにログインしていて、割り当てられた端末のオーナー実行ビットが ( +.Dq Li biff y +によって) ON になっていれば、 +.Em offset +はメールボックスのシークオフセットとして使用され、 +メッセージの先頭 7 行か、もしくは 560 文字がユーザの端末に表示されます。 +.Dq From , +.Dq \&To , +.Dq Date , +.Dq Subject +以外のメッセージヘッダの一部とみなされる行は、 +表示されるメッセージに含まれません。 +.Pp +mailbox-name を省略した場合, システム標準のメールボックスを監視します。 +.Sh 関連ファイル +.Bl -tag -width /var/mail/user -compact +.It Pa /var/run/utmp +誰がどの端末でログオンしたかを識別します。 +.It Pa /var/mail/user +システム標準のメールボックスです。 +.El +.Sh 関連項目 +.Xr biff 1 , +.Xr inetd 8 +.Sh バグ +メッセージヘッダのフィルタリングは誤りがちです。 +表示される情報は、最低限のものです。 +.Pp +現在ログインしているマシン以外のマシンへのメールの到着は、 +ユーザに通知されるべきです。 +.Pp +スクリーン表示を分かりやすくするために、通知は別のウィンドウに +表示されるべきです。 +.Sh 歴史 +.Nm +コマンドは +.Bx 4.2 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/config.8 b/ja_JP.eucJP/man/man8/config.8 new file mode 100644 index 0000000000..41fd444ed1 --- /dev/null +++ b/ja_JP.eucJP/man/man8/config.8 @@ -0,0 +1,175 @@ +.\" Copyright (c) 1980, 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. +.\" +.\" 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. +.\" +.\" @(#)config.8 8.2 (Berkeley) 4/19/94 +.\" jpman %Id: config.8,v 1.2 1997/03/31 13:33:05 horikawa Stab % +.\" +.Dd April 19, 1994 +.Dt CONFIG 8 +.Os BSD 4 +.Sh 名称 +.Nm config +.Nd システムを構築するために必要なファイルの作成 +.Sh 書式 +.Nm config +.Op Fl gpn +.Ar SYSTEM_NAME +.Sh 解説 +これは古いバージョンの +.Nm +プログラムです。 +このプログラムは、古いオートコンフィギュレーションスキームを理解します。 +このスキームは HP300, i386, DECstation やその派生プラットフォームにて +使用されます。 +新しいバージョンの config は SPARC プラットフォームで使用されます。 +あなたが使用しているアーキテクチャに適合したバージョンの +.Nm +のみがあなたのマシンにインストールされているでしょう。 +.Pp +.Nm +は、システムの構成を記述したコンフィギュレーションファイル +.Ar SYSTEM_NAME +にもとづいてシステムを構築するために必要なファイルを作成します。 +別のファイルが、 +.Nm +に対し、 +システム生成に必要なファイルと、 +構成依存ファイルセットにより追加されるファイルとを指示します。 +構成依存ファイルセットは、固有マシン用代替ファイルを指定します +(以降に示す +.Sx 関連ファイル +を参照)。 +.Pp +オプションとオペランドしては以下のものがあります: +.Pp +.Bl -tag -width SYSTEM_NAME +.It Fl g +システムのデバッグのための設定をします。 +.It Fl p +プロファイリングを行うシステムを構築します。プロファイルを行うものは例えば +.Xr kgmon 8 +や +.Xr gprof 1 などです。 +.Fl p +オプションを 2 度以上指定すると、 +.Nm +より詳細なプロファイリングを行うシステムを構築します。 +.It Fl n +以前のコンパイル用ディレクトリを削除しません(以降参照)。 +.It Ar SYSTEM_NAME +.Ar SYSTEM_NAME +はシステムコンフィギュレーションファイルの名前であり、システムコンフィギュレーションファイル +にはデバイスの仕様、構築するシステムのオプション、その他のシステムパラメータの記述をします。 +.El +.Pp +.Nm +はシステムソースの +.Pa conf +サブディレクトリで起動します(通常 +.Pa /sys/ARCH/conf +)。 +.Nm +は必要により +.Pa ../../compile/SYSTEM_NAME +ディレクトリを作成し、そこにすべての出力ファイルを置きます。 +.Fl n +オプションが指定されているか、環境変数 +.Ev NO_CONFIG_CLOBBER +が設定されていないと、ディレクトリが既に存在する場合にはあらかじめ +削除されます。 +.Nm +の出力は多くのファイルです; +.Tn i386 +の場合は次のようなファイルになります: +.Pa ioconf.c , +システムに接続された I/O デバイスの記述; +.Pa vector.h , +割り込み計測関連のマクロ定義; +.Pa Makefile , +.Xr make 1 +がシステム構築に使用する; +ヘッダファイル, システムに組み込まれる多くのデバイスに関する定義; +スワップ構成ファイル, +スワップ、ルートファイルシステム、引数処理、システムダンプに使用する +ディスク領域に関する定義。 +.Pp +.Nm +の実行後は、 +.Dq Li make depend +を Makefile が作成されたディレクトリで実行する必要があります。 +.Nm +は正常終了すると、これを促すメッセージ表示を行います。 +.Pp +.Nm +が、これとは異なるエラーメッセージ表示を行った場合には、 +コンフィギュレーションファイルの記述の誤りを修正し、再度 +.Nm +を実行する必要があります。 +コンフィギュレーションでエラーとなったシステムをコンパイルしようとしても、 +おそらく失敗するでしょう。 +.Pp +コンフィギュレーションファイル中に +オプション "INCLUDE_CONFIG_FILE" を指定した場合、 +該ファイル全体が作成されるカーネルに埋め込まれます。 +これは、 +.Xr strings 1 +によって該ファイルをカーネルから引き出す事が出来ることを意味します。 +.Pp +strings | grep ___ によって構成情報を表示できます。 +.Sh 関連ファイル +.Bl -tag -width /sys/i386/conf/Makefile.i386 -compact +.It Pa /sys/conf/files +システム生成に必要な共通のファイルのリスト +.It Pa /sys/i386/conf/Makefile.i386 +.Tn i386 +用の一般的な makefile +.It Pa /sys/i386/conf/files.i386 +.Tn i386 +特有のファイルのリスト +.It Pa /sys/i386/conf/devices.i386 +.Tn i386 +特有の、名前からメジャーデバイスへのマップ +.It Pa /sys/i386/conf/files. Ns Em ERNIE +.Em ERNIE +システム特有のファイルのリスト +.El +.Sh 関連項目 +セクション 4 にある、デバイスのマニュアルの書式の部分。 +.Rs +.%T "Building 4.3 BSD UNIX System with Config" +.Re +.Sh バグ +エラーメッセージにおいて報告される行番号は1行ずれます。 +.Sh 歴史 +.Nm +コマンドは +.Bx 4.1 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/crash.8 b/ja_JP.eucJP/man/man8/crash.8 new file mode 100644 index 0000000000..a7f77bdb71 --- /dev/null +++ b/ja_JP.eucJP/man/man8/crash.8 @@ -0,0 +1,224 @@ +.\" FreeBSD version Copyright (c) 1996 +.\" Mike Pritchard <mpp@FreeBSD.org>. All rights reserved. +.\" +.\" Adapted from share/man/man8/man8.hp300/crash.8 +.\" +.\" Copyright (c) 1990, 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. +.\" +.\" 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. +.\" +.\" %Id: crash.8,v 1.3.2.1 1996/12/31 22:57:59 mpp Exp % +.\" jpman %Id: crash.8,v 1.3 1997/08/16 13:10:53 horikawa Stab % +.\" +.Dd February 2, 1996 +.Dt CRASH 8 i386 +.Os FreeBSD +.Sh 名称 +.Nm crash +.Nd FreeBSD システム障害 +.Sh 解説 +このセクションではシステムクラッシュについて少し説明し、 +クラッシュダンプの解析方法についても(かなり簡潔ですが)述べます。 +.Pp +システムが自らクラッシュする際には、 +.Bd -ragged -offset indent +panic: なぜ死んだのか +.Ed +.Pp +という形式でコンソールにメッセージを表示し、 +もしダンプが有効になっていれば( +.Xr dumpon 8 +参照)大容量記憶装置にダンプをとり、 +そして +.Xr reboot 8 +に述べられているように自動リブート手順を開始します。 +ハードウェアあるいはソフトウェアの障害によって +ファイルシステムの状態に予期せぬ矛盾点が見つかった場合を除き、 +システムはマルチユーザモードでのオペレーションを再開します。 +.Pp +システムは数多くの内部一貫性チェックを行っています。 +それらのチェックのうちひとつに引っかかると、 +どのチェックに引っかかったかを示す簡潔なメッセージを表示して +パニックします。 +多くの場合、このメッセージはエラーを検知したルーチン名、 +あるいは見つかった一貫性エラーを記述する 2 語のフレーズです。 +ほとんどのパニックメッセージを完全に理解するには、 +システムのソースコードを熟読する必要があります。 +.Pp +システム障害に共通するほとんどの原因はハードウェア障害であり、 +それは様々なところに現れます。 +ここでは発生する可能性の高いメッセージと、 +原因に関する手掛かりを示します。 +ハードウェアあるいはソフトウェアが予期せぬかたちで +そのようなメッセージを出力する可能性については、全く述べていません。 +.Pp +.Bl -tag -width Ds -compact +.It Sy "cannot mount root" +このパニックメッセージは、ブートストラップ処理中に +ルートファイルシステムをマウントできなかった場合に表示されます。 +ルートファイルシステムが壊れているか、 +システムが誤ったデバイスをルートファイルシステムとして使おうとしています。 +通常、システムバイナリの別のコピーか +別のルートファイルシステムを用いてシステムを立ち上げ、調査します。 +よく行われるのは、システムをインストールしたブートフロッピでブートし、 +次に "fixit" フロッピを使用することです。 +.Pp +.It Sy "init: not found" +これはパニックメッセージではなく、リブートしても無駄でしょう。 +ブートストラップ処理の最後の段階で、 +システムが初期化プロセス +.Xr init 8 +の場所を探してそれを実行するのに失敗したのです。 +ルートファイルシステムが不正あるいは壊れている、 +.Pa /sbin/init +が実行不能モードあるいはタイプになっている、 +もしくは +.Pa /sbin/init +自体がなくなっています。 +.Pp +.Pp +.It Sy "ffs_realloccg: bad optim" +.It Sy "ffs_valloc: dup alloc" +.It Sy "ffs_alloccgblk: cyl groups corrupted" +.It Sy "ffs_alloccg: map corrupted" +.It Sy "blkfree: freeing free block" +.It Sy "blkfree: freeing free frag" +.It Sy "ifree: freeing free inode" +これらのパニックメッセージはファイルシステム内に矛盾点が見つかったときに +出力されるものです。 +通常、この問題の原因は、 +クラッシュ後の破損したファイルシステムの修復失敗、 +ハードウェア障害、 +あるいは通常発生しない他の条件にあります。 +ファイルシステムのチェックを行えば、通常、問題は解決します。 +.Pp +.It Sy "timeout table full" +実はこれはパニックではありませんが、 +関係するデータ構造の拡張を行う前に、 +エントリが不足するためにクラッシュしたのです。 +この現象が発生したら、timeout table を大きくして下さい。 +.Pp +.\" .It Sy "trap type %d, code = %x, v = %x" +.\" An unexpected trap has occurred within the system; the trap types are: +.\" .Bl -column xxxx -offset indent +.\" 0 bus error +.\" 1 address error +.\" 2 illegal instruction +.\" 3 divide by zero +.\" .No 4\t Em chk No instruction +.\" .No 5\t Em trapv No instruction +.\" 6 privileged instruction +.\" 7 trace trap +.\" 8 MMU fault +.\" 9 simulated software interrupt +.\" 10 format error +.\" 11 FP coprocessor fault +.\" 12 coprocessor fault +.\" 13 simulated AST +.\" .El +.\" .Pp +.\" The favorite trap type in system crashes is trap type 8, +.\" indicating a wild reference. +.\" ``code'' (hex) is the concatenation of the +.\" MMU +.\" status register +.\" (see <hp300/cpu.h>) +.\" in the high 16 bits and the 68020 special status word +.\" (see the 68020 manual, page 6-17) +.\" in the low 16. +.\" ``v'' (hex) is the virtual address which caused the fault. +.\" Additionally, the kernel will dump about a screenful of semi-useful +.\" information. +.\" ``pid'' (decimal) is the process id of the process running at the +.\" time of the exception. +.\" Note that if we panic in an interrupt routine, +.\" this process may not be related to the panic. +.\" ``ps'' (hex) is the 68020 processor status register ``ps''. +.\" ``pc'' (hex) is the value of the program counter saved +.\" on the hardware exception frame. +.\" It may +.\" .Em not +.\" be the PC of the instruction causing the fault. +.\" ``sfc'' and ``dfc'' (hex) are the 68020 source/destination function codes. +.\" They should always be one. +.\" ``p0'' and ``p1'' are the +.\" VAX-like +.\" region registers. +.\" They are of the form: +.\" .Pp +.\" .Bd -ragged -offset indent +.\" <length> '@' <kernel VA> +.\" .Ed +.\" .Pp +.\" where both are in hex. +.\" Following these values are a dump of the processor registers (hex). +.\" Finally, is a dump of the stack (user/kernel) at the time of the offense. +.\" .Pp +.It Sy "init died (signal #, exit #)" +システム初期化プロセスが、示されたとおりのシグナルおよび終了コードで +終了してしまいました。 +これは良くない知らせです。もう誰もログインできません。 +リブートするしか手はなく、従ってシステムはただちにリブートします。 +.Pp +以上が遭遇する可能性のあるパニックの種類一覧です。 +.Pp +クラッシュダンプを取るようにシステムが設定されている場合( +.Xr dumpon 8 +参照)、 +システムがクラッシュすると +ダンプデバイス(通常は一つめのスワップ領域と同じ)の終わりに +メモリイメージを書き込みます(少なくとも書き込もうとします)。 +システムがリブートした後、プログラム +.Xr savecore 8 +が起動し、後の解析のために、 +このコアイメージと現在のシステムのコピーを特定ディレクトリに保存します。 +詳細は +.Xr savecore 8 +を参照して下さい。 +.Pp +ダンプを解析するには、システムのロードイメージとコアダンプに対して +.Xr gdb 1 +を +.Fl k +オプション付きで起動します。 +コアイメージがパニックによって生成されたものならば、 +そのパニックメッセージが表示されます。 +より詳しい情報は、FreeBSD ハンドブック (http://www.freebsd.org) の +カーネルデバッギングの章を参照して下さい。 +.Sh 関連項目 +.Xr gdb 1 , +.Xr dumpon 8 , +.Xr reboot 8 , +.Xr savecore 8 +.Sh 歴史 +.Nm crash +マニュアルページは +.Fx 2.2 +で登場しました。 diff --git a/ja_JP.eucJP/man/man8/cron.8 b/ja_JP.eucJP/man/man8/cron.8 new file mode 100644 index 0000000000..88da9d859c --- /dev/null +++ b/ja_JP.eucJP/man/man8/cron.8 @@ -0,0 +1,77 @@ +.\"/* Copyright 1988,1990,1993 by Paul Vixie +.\" * All rights reserved +.\" * +.\" * Distribute freely, except: don't remove my name from the source or +.\" * documentation (don't take credit for my work), mark your changes (don't +.\" * get me blamed for your possible bugs), don't alter or remove this +.\" * notice. May be sold if buildable source is provided to buyer. No +.\" * warrantee of any kind, express or implied, is included with this +.\" * software; use at your own risk, responsibility for damages (if any) to +.\" * anyone resulting from the use of this software rests entirely with the +.\" * user. +.\" * +.\" * Send bug reports, bug fixes, enhancements, requests, flames, etc., and +.\" * I'll try to keep a version up to date. I can be reached as follows: +.\" * Paul Vixie <paul@vix.com> uunet!decwrl!vixie!paul +.\" */ +.\" +.\" %Id: cron.8,v 1.2 1996/06/30 22:11:50 wosch Exp % +.\" jpman %Id: cron.8,v 1.2 1997/04/18 06:33:14 yugawa Stab % +.\" +.Dd December 20, 1993 +.Dt CRON 8 +.Os +.Sh 名称 +.Nm cron +.Nd 定期的にコマンドを実行するデーモン (Vixie Cron) +.Sh 書式 +.Nm cron +.Op Fl x Ar debugflag Ns Op ,... +.Sh 解説 +.Nm +は、通常は +.Pa /etc/rc +もしくは +.Pa /etc/rc.local +から起動されます。このコマンドは実行するとすぐに返ってくるので、起動時に +`&' をつける必要はありません。 +.Pp +.Nm +は、 +.Pa /var/cron/tabs +ディレクトリの下から +.Pa /etc/passwd +内のアカウント名と同じ名前の crontab ファイルを探し、見つかったファイルを +メモリに読み込みます。 +.Nm +は、別のフォーマットの +.Pa /etc/crontab ( +.Xr crontab 5 +を参照してください) +も調べます。このあと、 +.Nm +は 1 分おきに目覚めて +読み込んでいるすべての crontab ファイルを調べ、各コマンドをその時刻に +実行させるべきかどうかを調べます。コマンドを実行する場合には、出力がメールで +crontab ファイルの所有者 (もしくは crontab ファイル内の環境変数 +.Ev MAILTO +で指定されたユーザ) に送られます。 +.Pp +さらに、 +.Nm +は 1 分おきにスプールディレクトリの最終更新時刻 ( +.Pa /etc/crontab +の最終更新時刻も ) が変わっているかどうかを調べます。もし +変化があれば、すべての crontab ファイルの最終更新時刻を調べ、変更のあった +ものを読み直します。このため、crontab ファイルを変更したときに +.Nm +をリスタートさせる必要はありません。 +.Xr crontab 1 +コマンドが crontab +ファイルを変更したときにスプールディレクトリの最終更新時刻も更新されることに +注意して下さい。 +.Sh 関連項目 +.Xr crontab 1 , +.Xr crontab 5 +.Sh 作者 +.An Paul Vixie Aq paul@vix.com diff --git a/ja_JP.eucJP/man/man8/cvsbug.8 b/ja_JP.eucJP/man/man8/cvsbug.8 new file mode 100644 index 0000000000..de4fc86824 --- /dev/null +++ b/ja_JP.eucJP/man/man8/cvsbug.8 @@ -0,0 +1,250 @@ +.\" -*- nroff -*- +.\" --------------------------------------------------------------------------- +.\" man page for send-pr (by Heinz G. Seidl, hgs@cygnus.com) +.\" updated Feb 1993 for GNATS 3.00 by Jeffrey Osier, jeffrey@cygnus.com +.\" +.\" This file is part of the Problem Report Management System (GNATS) +.\" Copyright 1992 Cygnus Support +.\" +.\" This program is free software; you can redistribute it and/or +.\" modify it under the terms of the GNU General Public +.\" License as published by the Free Software Foundation; either +.\" version 2 of the License, or (at your option) any later version. +.\" +.\" This program is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +.\" General Public License for more details. +.\" +.\" --------------------------------------------------------------------------- +.\" jpman %Id: cvsbug.8,v 1.2 1997/06/16 09:32:04 jsakai Stab % +.nh +.TH CVSBUG 8 xVERSIONx "February 1993" +.\" ここが↑ +.\" 英語版では 1 となっていたが、cvsbug は 8 章のはず。 +.\" この nroff ソースの 3 行目が send-pr となっていることからしても、 +.\" send-pr.1 のマニュアルからコピーして修正し忘れ?? +.\" sakai@jp.freebsd.org 1997.6.16 +.SH 名称 +cvsbug \- CVS に関する Problem Report (PR) をサポートサイトに送る +.SH 書式 +.B cvsbug +[ +.I site +] +[ +.B \-f +.I problem-report +] +[ +.B \-t +.I mail-address +] +.br +.in +0.8i +[ +.B \-P +] +[ +.B \-L +] +[ +.B \-\-request-id +] +[ +.B \-v +] +.SH 解説 +.\" +.\" 以下の日本語訳は、同じく FreeBSD jpman にて既に訳されていた +.\" send-pr.1 から かなりの部分を流用している。sakai@jp.freebsd.org 1997.6.16 +.\" +.B cvsbug +は、サポートサイトに対して +.I problem reports +.\" SITE ADMINISTRATORS - change this if you use a local default +(PR) を送るために使うツールです。大抵の場合は正しい +.I site +がデフォルトとなっているはずです。この引き数は、問題を引き起こした事象 +のカテゴリに対して責任をもつサポートサイトを指し示します。いくつかの +サイトはデフォルトとしてローカルアドレスを使っていることでしょう。 +.I site +は、 +.BR aliases (5) +を使って定義されます。 +.LP +.B cvsbug +を実行すると、エディタが起動されて用意されているテンプレートを (いくつ +かのフィールドにもっともらしいデフォルトの値をあてはめてから) 読み込ま +れます。エディタを終了すると、 +.B cvsbug +はサポートサイトの +.I Problem Report Management System +(\fBGNATS\fR) に完了した形式のレポートをメールで送ります。サポートサイトで +は、PR は問題のカテゴリと \fIsubmitter-id\fR とに従って唯一の番号が +割り当てられ、\fBGNATS\fR データベースに保存されています。 +\fBGNATS\fR はメールを受け取ったことを知らせるために、 +問題のカテゴリの引用と PR 番号とを自動的に返送します。 +.LP +PR が速やかに処理されるようにするためには、 +あなた(独自)の \fIsubmitter-id\fR と、 +問題分野を識別する有効なカテゴリを記入する必要があります。(カテゴリは +.B `cvsbug -L' +で見ることができます。) +.LP +あなたのサイトにある +.B cvsbug +テンプレートは、あらかじめ submitter-id をカスタマイズしておく +必要があります (そのために `\|\fBinstall-sid\fP \fIsubmitter-id\fP\|' を +実行することは +.B cvsbug +のインストール手順の一部になっています )。 +もしこれがまだ設定されていなければ、 +あなたのシステム管理者に submitter-id 設定をお願いするか、次のコマンド +.B `cvsbug \-\-request\-id' +を実行してあたなのサポートサイトに submitter-id を要求して下さい。 +あなたのサイトがユーザサイト間で区別できない、あるいは +あなたがサポートサイトと結び付きを持っていない場合は、このフィールドに +.B `net' +と指定して下さい。 +.LP +より正確な問題の記述やより完全な情報があればあるほど、 +サポートチームは問題をより早く解決することができます。 +.SH オプション +.TP +.BI \-f " problem-report" +すでに記入した PR ファイルを \fIproblem-report\fR に指定できます。 +.B cvsbug +はエディタを起動せずにファイルを送ります。 +.I problem-report +が +.BR `\|\-\|' +のときは +.B cvsbug +は、標準入力から読み込みます。 +.TP +.BI \-t " mail-address" +PR を送るサイトのメールアドレスを変更します。 +デフォルトのメールアドレスは、 +デフォルトサイトのものが使われます。特殊な状況を除き、このオプションではなく、 +.I site +を使って下さい。 +.TP +.B \-P +環境変数 +.B PR_FORM +で指定されたテンプレートを標準出力に出力します。 +.B PR_FORM +が定義されていないときは、標準のブランク PR テンプレートが使われます。 +メールは送られません。 +.TP +.B -L +使用できるカテゴリが表示されます。メールは送られません。 +.TP +.B \-\-request\-id +デフォルトサイトか、 +.I site +が指定されればそのサイトに +.IR submitter-id +を要求します。もしユーザがそのサイトと関係なければ、 +.I submitter-id +として +.BR net +を使って下さい。 +.TP +.B \-v +.B cvsbug +のバージョンを表示します。 +.LP +注釈: +PR を提出するためには、PR を直接メールするのではなく、 +.B cvsbug +を使いましょう。テンプレートと +.B cvsbug +の両方を使うことによって、すべての必要な情報がサポートサイトに確実に届きます。 +.SH 環境変数 +.B EDITOR +テンプレートに対して起動するエディタ +.br +デフォルト: +.B vi +.sp +もし +.B PR_FORM +が設定されていれば、編集する PR のテンプレートのファイル名として +使われます。 +部分的に完成したテンプレートから始めるために +これを使うことができます (たとえば、すでに identification フィールドを +埋めてあるテンプレートなどです)。 +.SH PR の記入方法 +PR が形式に従っていれば、 +プログラムは簡単に PR を扱うことができます。 +以下のガイドラインを覚えておきましょう: +.IP \(bu 3m +それぞれの PR には +.B 一つの問題 +だけを記述しましょう。 +.IP \(bu 3m +フォローアップメールには、 +自動返送されて来るメールと同じサブジェクトを使いましょう。サブジェクトは、 +カテゴリ、PR 番号、元の概要の行から構成されています。 +これによってサポートサイト +は、特定の PR を複数のメールメッセージと結びつけ、またそれらを自動的に +記録することができます。 +.IP \(bu 3m +サブジェクトや、概要の行はできるだけ正確するようにしましょう。 +.IP \(bu 3m +サブジェクトや概要の行は機密扱いではありません。 +公開されるバグリストはサブジェクトと概要の行から編集するので、 +機密情報はここに書かないでください。 +.LP +詳しくは、GNU +.B Info +ファイルの +.B cvsbug.info +か、RP について詳しく書かれている +\fIReporting Problems With cvsbug\fR\ +のドキュメントなどを参照してください。 +.SH テストケース、コード、その他の記入方法 +小さなサンプルコードを送りましょう。 +大きなテストケースや問題となっているソースコードを送りたい場合にには、 +サポートサイトに連絡を取り、指示を受けて下さい。 +.SH 関連ファイル +.ta \w'/tmp/pbad$$ 'u +/tmp/p$$ 編集しているときに使う PR のコピー +.br +/tmp/pf$$ テスト目的で使う、空の PR テンプレートコピー +.br +/tmp/pbad$$ 捨てられた PR のファイル +.SH インストールとコンフィギュレーション +.B INSTALL +インストールガイドを参照してください。 +.SH 関連項目 +.BR gnats (l), +.BR query-pr (1), +.BR edit-pr (1), +.BR gnats (8), +.BR queue-pr (8), +.BR at-pr (8), +.BR mkcat (8), +.BR mkdist (8). +.SH 作者 +Jeffrey Osier, Brendan Kehoe, Jason Merrill, Heinz G. Seidl (Cygnus +Support) +.SH COPYING +Copyright (c) 1992, 1993 Free Software Foundation, Inc. +.PP +Permission is granted to make and distribute verbatim copies of +this manual provided the copyright notice and this permission notice +are preserved on all copies. +.PP +Permission is granted to copy and distribute modified versions of this +manual under the conditions for verbatim copying, provided that the +entire resulting derived work is distributed under the terms of a +permission notice identical to this one. +.PP +Permission is granted to copy and distribute translations of this +manual into another language, under the above conditions for modified +versions, except that this permission notice may be included in +translations approved by the Free Software Foundation instead of in +the original English. diff --git a/ja_JP.eucJP/man/man8/dev_mkdb.8 b/ja_JP.eucJP/man/man8/dev_mkdb.8 new file mode 100644 index 0000000000..cc7f854016 --- /dev/null +++ b/ja_JP.eucJP/man/man8/dev_mkdb.8 @@ -0,0 +1,84 @@ +.\" 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. +.\" +.\" 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. +.\" +.\" @(#)dev_mkdb.8 8.1 (Berkeley) 6/6/93 +.\" jpman %Id: dev_mkdb.8,v 1.2 1997/05/23 07:36:35 mitchy Stab % +.\" +.Dd June 6, 1993 +.Os +.Dt DEV_MKDB 8 +.Sh 名称 +.Nm dev_mkdb +.Nd +.Pa /dev +のデータベースを作成する +.Sh 書式 +.Nm dev_mkdb +.Sh 解説 +.Nm +コマンドは、 +.Pa /var/run/dev.db +に +.Xr db 3 +のハッシュデータベースを +作成します。このデータベースには、 +.Pa /dev +ディレクトリ内のすべてのキャラクタスペシャルファイルと +ブロックスペシャルファイルの名前が含まれており、 +キーとしてファイルタイプと +.Fa st_rdev +フィールドが使われています。 +.Pp +キーの構造体は mode_t, dev_t の順であり、0 で +パディングされています。 +mode_t はファイルタイプ (st_mode & S_IMFT) であり、 +dev_t はst_rdev フィールドそのものです。 +.Pp +.Sh 関連ファイル +.Bl -tag -width /var/run/dev.db -compact +.It Pa /dev +デバイスのディレクトリ +.It Pa /var/run/dev.db +データベースファイル +.El +.Sh 関連項目 +.Xr ps 1 , +.Xr stat 2 , +.Xr db 3 , +.Xr devname 3 , +.Xr kvm_nlist 3 , +.Xr ttyname 3 , +.Xr kvm_mkdb 8 +.Sh 歴史 +.Nm +コマンドは +.Bx 4.4 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/disklabel.8 b/ja_JP.eucJP/man/man8/disklabel.8 new file mode 100644 index 0000000000..0ceda3da90 --- /dev/null +++ b/ja_JP.eucJP/man/man8/disklabel.8 @@ -0,0 +1,406 @@ +.\" Copyright (c) 1987, 1988, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" This code is derived from software contributed to Berkeley by +.\" Symmetric Computer Systems. +.\" +.\" 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. +.\" +.\" 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. +.\" +.\" @(#)disklabel.8 8.2 (Berkeley) 4/19/94 +.\" %Id: disklabel.8,v 1.3.2.2 1997/08/25 21:28:37 jkh Exp % +.\" jpman %Id: disklabel.8,v 1.2 1997/03/31 14:09:16 horikawa Stab % +.\" +.Dd April 19, 1994 +.Dt DISKLABEL 8 +.Os BSD 4.2 +.Sh 名称 +.Nm disklabel +.Nd ディスクラベルの読み書きを行う +.Sh 書式 +.Nm disklabel +.Op Fl r +.Ar disk +.br +.Nm disklabel +.Fl w +.Op Fl r +.Ar disk Ar disktype +.Oo Ar packid Oc +.br +.Nm disklabel +.Fl e +.Op Fl r +.Ar disk +.br +.Nm disklabel +.Fl R +.Op Fl r +.Ar disk Ar protofile +.br +.Nm disklabel +.Op Fl NW +.Ar disk +.sp +.br +.Nm disklabel +.Fl B +.Oo +.Fl b Ar boot1 +.Op Fl s Ar boot2 +.Oc +.Ar disk +.Oo Ar disktype Oc +.br +.Nm disklabel +.Fl w +.Fl B +.Oo +.Fl b Ar boot1 +.Op Fl s Ar boot2 +.Oc +.Ar disk Ar disktype +.Oo Ar packid Oc +.br +.Nm disklabel +.Fl R +.Fl B +.Oo +.Fl b Ar boot1 +.Op Fl s Ar boot2 +.Oc +.Ar disk Ar protofile +.Oo Ar disktype Oc +.\" 注: 上記 .br は改行動作のために挿入 +.\" By horikawa@jp.freebsd.org (30 Mar 1997) +.Sh 解説 +.Nm disklabel +はディスクドライブやディスクパックにラベルを書き込んだり、 +確認したり、修正したりするために使われます。 +ラベルを書き込む際には、ドライブの識別子を変更したり、 +ディスクのパーティションを変更したり、 +異常のあるラベルを置き換えたりすることができます。 +システムによっては、 +.Nm disklabel +は同時にブートストラップコードを +インストールするためにも使われます。 +コマンドには、ディスク上のラベルを読んだり (表示したり)、書き込んだり、 +編集したりするいくつかの形式があります。 +それぞれの形式に +.Fl r +オプションをつけると、ラベルの読み書きをシステムの +メモリ内のコピーに対して行うかわりに、ディスクに対して直接行います。 +このオプションをつけると、システムに最初にラベルを書き込むときのように、 +カーネルがそのラベルを保持していないような場合にもディスクへラベルを +書き込むことができるようになります。つまり、最初にディスクへラベルを +書き込むときには必ずこのオプションが必要になるということです。 +.Fl r +スイッチの特別な機能については、それぞれのコマンドで解説しています。 +ラベルの読み込みや書き込みの形式に対しては、ブートストラップコードを +インストールするために +.Fl B +スイッチを指定することができます。 +これらの違いについてもあとで解説します。 +.Pp +コマンドの最初の形式 (read) は、 +指定したディスクドライブ (例: sd0 や /dev/rsd0c) のラベルを確認するため +に使用されます。 +これによってドライブに関するすべてのパラメータとパーティションのレイアウトを +表示します。 +.Fl r +フラグを指定しない場合には、カーネルのメモリ内にあるラベルのコピーが +表示されます。 +もしディスクにラベルが書き込まれていなかったり、ディスクのパーティション形式が +正しくない場合には、カーネルが作り直したり、修正したりしたラベルが +表示されるかもしれません。 +.Fl r +フラグが与えられると、メモリ内のラベルを表示するかわりにディスク上の実際の +ラベルが表示されます。 +.Pp +2 番目の形式は、 +.Fl w +フラグ付きの形式で、指定したドライブへ標準のラベルを書き込む +ために使用されます。 +コマンドには引数として、ラベルを書き込むドライブ名 (例: sd0)、および +.Xr disktab 5 +に書かれているドライブタイプが必要です。 +ドライブのパラメータとパーティション情報は、このファイルから得られたもの +が使われます。 +もし、同じ型のディスクに異なるパーティション情報を持たせたい場合には、 +disktab にそれぞれ別々のエントリを書いておくか、ラベルを書き込んだあとで +後述する方法でそれを編集する必要があります。 +オプションの引数として、16 文字までのパック識別用文字列を指定します。 +パック名に空白を含める場合にはそれをクォートする必要があります。 +.Fl r +フラグが与えられると、ディスクのラベルとブートストラップが +直接書き換えられます。 +この副作用として、すでにあるブートストラップ用コードが上書きされてしまうため、 +ディスクがブート不能にされてしまいます。 +.Fl r +が指定されない場合には、ラベルはメモリ内のコピーを通して書き換えられる +ため、ブートストラップコードは影響されません。 +もしまだディスクがラベル付けされていなければ、 +.Fl r +フラグをつけなければなりません。 +どちらの方法でも、カーネルのメモリ内コピーは変更されます。 +.Pp +.Xr disktab 5 +に記載されていない未使用のディスクに対しては、 +.Ar disktype +として +.Dq auto +を指定できます。 +この場合、ディスクの最初のラベルを生成するようにドライバに要求します。 +これは成功するかも知れないし成功しないかも知れません。 +これはディスクドライバがディスクを全く読む事無く +必要なデータを取得できるか否かに依存します。 +全ての SCSI ディスクとほとんどの IDE ディスクと vnode デバイスにおいて +成功するでしょう。 +ディスクに対するラベルの書き込みは唯一サポートされた操作であり、 +.Ar disk +自身は標準の名前(フルパス名であってはなりません)で提供される必要があります。 +.Pp +.Fl e +フラグによって、すでに存在するディスクラベルを編集することができます。 +ラベルはカーネルのメモリ内コピーから、または +.Fl r +フラグが与えられた場合には直接ディスクから読み込まれます。 +ラベルは整形され、編集するためのエディタへ渡されます。 +.Ev EDITOR +環境変数によるエディタの指定がない場合には、このエディタには +.Xr vi 1 +が使用されます。 +エディタを終了すると、整形されたラベルが再読み込まれて、 +ディスクラベルに再び書き込まれます。 +.Fl r +フラグの指定の有無にかかわらず、 +すでにあるブートストラップコードは変更されません。 +.Pp +.Fl R +フラグを指定すると、 +.Nm disklabel +は以前の操作により整形済でアスキーファイルとして保存されているディスクラベル +をディスクへ書き戻します。 +ラベルを作成するときに使われるプロトタイプファイルは、ラベルを読み込んだり +編集したりするときのものと同じフォーマットである必要があります。 +コメントは +.Ar \&# +と改行で区切られます。 +.Fl w +のように、 +.Fl r +が指定されているとブートストラップコードは使えなくなってしまいます。 +.Pp +.Nm disklabel +コマンドの +.Fl NW +フラグはそれぞれ、指定したディスクのパックラベルエリアへの書き込みを +明示的に禁止したり、許可したりします。 +.Pp +.Nm disklabel +の最後の 3 つの形式は、ブートストラップコードがラベルの一部である +ようなマシンで、ブートストラップコードをインストールするために使われます。 +ブートストラップコードには、 +マシンに依存する 1 つまたは 2 つのプログラムが含まれます。 +.Fl B +フラグは、ブートストラップコードをインストールすることを示すために +使われます。 +.Fl r +フラグの機能は +.Fl B +フラグに含まれているので、同時に指定しないようにしてください。 +インストールされるブートストラップコードの名前は、 +いくつかの方法で選択することができます。 +第1に、 +.Fl b +や +.Fl s +フラグによって明示的に名前を指定することができます。 +1 段階のブートプログラムのみが必要なマシンでは、 +.Fl b +によって指定するものがそのプログラムです。 +2 段階のブートストラップを行うマシンでは、 +.Fl b +で指定するのが最初のブートプログラムで、 +.Fl s +で指定するのが 2 段階目のプログラムになります。 +プログラム名が明示的に与えられなければ、標準ブートプログラムが使われます。 +ブートプログラムは、 +.Pa /usr/mdec +に置かれます。 +もし、 +.Ar disktype +が与えられ、それに対応する +.Xr disktab 5 +のエントリが存在し、 +なおかつ ``b0'' , ``b1'' の 2 つのパラメータがある場合には、 +ブートプログラムはこれらのパラメータから得られます。 +さもなければ、ブートプログラム名はディスク名から得られます。 +この名前は、1段階目のブートストラップに対しては +.Pa basename Ns boot +、2 段階目のブートストラップに対しては +.Pf boot Pa basename +になります。 +たとえば、ディスクデバイスが +.Em sd0 +である場合には、これらの名前は +.Pa /usr/mdec/sdboot +や +.Pa /usr/mdec/bootsd +になります。 +.Pp +3 つのブートプログラムインストールの形式のなかで最初のものは、 +すでに存在するディスクラベルを変更せずにブートストラップコードを +インストールするために使われます。 +これは、ディスクラベル自身に対しては本質的には読み込みコマンドで、 +すべてのオプションはすでに記したように +ブートプログラムを特定するのに関するものです。 +あとの 2 つの形式は同様に、ディスクラベルを書き込んだり復元したりするのと同時に +ブートストラップコードをインストールするものです。 +.Sh 関連ファイル +.Bl -tag -width Pa -compact +.It Pa /etc/disktab +.It Pa /usr/mdec/ Ns Em xx Ns boot +.It Pa /usr/mdec/boot Ns Em xx +.El +.Sh 使用例 +.Dl disklabel sd0 +.Pp +sd0 のラベルとしてカーネル内のコピーを +.Pa /dev/rsd0c +から得られたものとして表示します。 +.Pp +.Dl disklabel -w -r /dev/rsd0c sd2212 foo +.Pp +.Pa /etc/disktab +に書かれている ``sd2212'' の情報を +sd0 のラベルとして書き込みます。 +存在したブートストラップコードは使えなくなります。 +.Pp +.Dl disklabel -e -r sd0 +.Pp +sd0 のディスク上のラベルを読み込み、編集し、再び書き込みます。 +ディスク上のラベルとともにカーネル内コピーも書き換えられます。 +存在したブートストラップコードは影響を受けません。 +.Pp +.Dl disklabel -r -w sd0 auto +.Pp +sd0 から必要な情報を自動検出し、新しいラベルをディスクに書こうとします。 +パーティションおよびファイルシステム情報を編集するために、 +この後で disklabel -e コマンドを使って下さい。 +.Pp +.Dl disklabel -R sd0 mylabel +.Pp +.Pa mylabel +に書かれている情報を +sd0 のラベルとして書き込みます。 +ディスク上のラベルとともにカーネル内コピーも書き換えられます。 +存在したブートストラップコードは影響を受けません。 +.Pp +.Dl disklabel -B sd0 +.Pp +sd0 に新たにブートストラップコードを書き込みます. +ブートストラップコードは +.Pa /usr/mdec/sdboot +、およびもし必要ならば +.Pa /usr/mdec/bootsd +です。 +ディスク上のラベルおよびカーネル内コピーは影響を受けません。 +.Pp +.Dl disklabel -w -B /dev/rsd0c -b newboot sd2212 +.Pp +新たなラベルとブートストラップコードを書き込みます。 +ラベルは disktab の ``sd2212'' の情報を使用し、 +ディスク上のラベルとともにカーネル内コピーも書き換えられます。 +ブートストラップコードは +.Pa /usr/mdec/newboot +です。 +.Sh 関連項目 +.Xr disklabel 5 , +.Xr disktab 5 +.Sh 診断 +デバイスドライバは、 +オープンされているパーティションに関して、 +サイズが小さくなることおよびオフセットが変化することを許しません。 +デバイスドライバの中には、 +ラベルを持たないディスクに対して 1 パーティションのみからなる +ラベルを作成するものがあります。 +そのため、 +オープンされているディスクのラベルは ``a'' パーティションに書く必要があります。 +このような理由で、 +次の 2 ステップにより、 +所望のラベルを作成する必要がある場合があります。 +第 1 ステップは少なくとももう 1 つのパーティションを作成することであり、 +第 2 ステップは ``a'' パーティションを小さくしながら +新たなパーティションのラベルを設定することです。 +.Pp +ファイルシステムによっては、 +用意された領域にブートストラップコードが収まり切らないような +マシンがあるかも知れません +その結果として、``ブート可能な'' ディスクのパーティションに +ファイルシステムを作成できない場合があります。 +ブートストラップコードを書き込む時に、 +.Nm disklabel +はこのようなケースをチェックします。 +FS_UNUSED タイプのパーティションに重なるように +ブートストラップコードが書き込まれる場合には、 +そのパーティションは FS_BOOT とマークされます。 +.Xr newfs 8 +ユーティリティは、 +FS_BOOT パーティションにファイルシステムを作成することを禁止します。 +また逆に、 +パーティションのタイプが FS_UNUSED もしくは FS_BOOT では無い場合、 +.Nm disklabel +はそのパーティションに重なるようなブートストラップコードを書き込みません。 +.Sh バグ +ディスク名がフルパスで指定されない場合には、 +デバイス名は tahoe の場合 ``a'' パーティションになり、 +その他の場合は ``c'' パーティションになります。 +.Pp +i386 アーキテクチャでは、プライマリブートストラップセクタに、 +組み込みの +.Em fdisk +テーブルを持ちます。 +.Nm disklabel +は、 +ブートストラップのみをインストールする時 +.Pq Fl B +もしくはラベルを編集する時 +.Pq Fl e +にこれを壊さないように気を付けます。 +しかし、 +.Fl w +や +.Fl R +を指定した時には、 +無条件でプライマリブートストラッププログラムをディスクに書き込みますので、 +.Em fdisk +テーブルをブートストラッププログラム内のダミーに置き換えます。 +これはディスク全体を専用に使う場合、 +すなわち BSD ディスクラベルがディスクの絶対ブロック 0 から始まる場合 +のみ関係あります。 diff --git a/ja_JP.eucJP/man/man8/diskpart.8 b/ja_JP.eucJP/man/man8/diskpart.8 new file mode 100644 index 0000000000..d748e0cdef --- /dev/null +++ b/ja_JP.eucJP/man/man8/diskpart.8 @@ -0,0 +1,135 @@ +.\" Copyright (c) 1983, 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. +.\" +.\" 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. +.\" +.\" @(#)diskpart.8 8.1 (Berkeley) 6/6/93 +.\" jpman %Id: diskpart.8,v 1.3 1997/10/11 07:43:12 horikawa Stab % +.\" +.Dd June 6, 1993 +.Dt DISKPART 8 +.Os BSD 4 +.Sh 名称 +.Nm diskpart +.Nd デフォルトのディスクパーティションサイズを求める +.Sh 書式 +.Nm +.Op Fl p +.Op Fl d +.Op Fl s Ar size +.Ar disk-type +.Sh 解説 +.Nm +は、Berkeley で適用されたデフォルト規則に従い、 +ディスクパーティションサイズを計算するのに使用されます。 +.Pp +使用可能なオプションとオペランド: +.Bl -tag -width Fl +.It Fl p +デバイスドライバへ取り込み可能な形式のテーブルが作成されます。 +.It Fl d +ディスク情報記述ファイル +.Pa /etc/disktab +への取り込みが可能な形式のエントリが作成されます。例については +.Xr disktab 5 +を参照してください。 +.It Fl s Ar size +.Fl s +オプションで指定された +.Ar size +にディスクサイズを制限することを指示します。 +.El +.Pp +.Xr bad144 8 +タイプの不良セクタフォワーディングを行うディスクでは、 +このための領域は通常ディスクの最後のパーティションに確保されますが、 +この領域は作成されるテーブルには影響を与えません。 +不良セクタフォワーディングのためには、テーブルの複製コピーのための +1トラックと、不良セクタをマップするための 126 セクタのプールを確保す +るのに十分なトラック数が予約されます。 +詳しくは +.Xr bad144 8 +を参照してください。 +シリンダ数の倍数でないとしても、ディスクの最後に不良 +セクタ置換やその他の制御エリアのための領域を確保する目的で、 +.Fl s +オプションを使うことも出来ます。 +.Pp +ディスクのパーティションサイズは、ディスク全体のサイズに基づいて、下 +のテーブルのように決定されます (値はすべてセクタ単位です)。 +.Ql c +パーティションは、慣例として物理ディスク全体をアクセスするために使われます。 +デバイスドライバのテーブルは、 +.Ql c +パーティション中に不良セクタフォワーディングテーブルに予約された +領域を含めますが、disktab ファイルやデフォルトフォーマットで +用いられる `c'パーティションからは、予約領域が除外されます。 +普通は、 +.Ql g +パーティションが使われるか、もしくは +.Ql d , +.Ql e , +.Ql f +パーティションが使われるかのどちらかになります。 +.Ql g +と +.Ql f +パーティションは可変サイズで、固定サイズパーティションが配置された +残りの領域全体を占めることになります。 +20M バイト以下のディスクに対しては、 +.Nm +は +.Dq Li disk too small, calculate by hand +のメッセージを出して終了します。 +.Bl -column Partition 20-60\ MB 61-205\ MB 206-355\ MB 356+\ MB +Partition 20-60 MB 61-205 MB 206-355 MB 356+ MB +a 15884 15884 15884 15884 +b 10032 33440 33440 66880 +d 15884 15884 15884 15884 +e unused 55936 55936 307200 +h unused unused 291346 291346 +.El +.Pp +不明なディスクタイプが指定されたとき、 +.Nm +はジオメトリ情報を求めるプロンプトを出します。 +.Sh 関連項目 +.Xr disktab 5 , +.Xr bad144 8 +.Sh バグ +デフォルトのパーティションサイズのほとんどは(RP06 のような)過去の遺 +物に基づいているので、満足のいかない配置になるかもしれません。 +.Pp +.Fl d +フラグを使用すると、代替ディスク名は出力されません。 +.Sh 歴史 +.Nm +は +.Bx 4.2 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/dm.8 b/ja_JP.eucJP/man/man8/dm.8 new file mode 100644 index 0000000000..376ec8adbb --- /dev/null +++ b/ja_JP.eucJP/man/man8/dm.8 @@ -0,0 +1,111 @@ +.\" Copyright (c) 1987, 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. +.\" +.\" 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. +.\" +.\" @(#)dm.8 8.1 (Berkeley) 5/31/93 +.\" jpman %Id: dm.8,v 1.3 1997/09/05 16:44:02 taku Stab % +.\" +.Dd May 31, 1993 +.Dt DM 8 +.Os +.Sh 名称 +.Nm dm +.Nd ダンジョンマスタ +.Sh 書式 +.Nm ln +.Fl s Cm dm Ar game +.Sh 解説 +.Nm dm +はゲームプレイを統制するプログラムです。 +ユーザは、プレイしたいゲームの名前で +.Nm dm +を起動することになります。それには、 +.Pa /usr/games +中の統制対象となるゲームの名前すべてで +.Nm dm +へのシンボリックリンクをつくります。 +これらのゲームのバイナリ本体は、 +.Dq 隠された +ディレクトリ +.Pa /usr/games/hide +に置かなくてはなりません。 +このディレクトリは +.Nm dm +プログラムのみアクセス可能となっているでしょう。 +.Nm dm +は要求されたゲームを使用可能か判定し、もし使用可能ならば実行します。 +ファイル +.Pa /etc/dm.conf +がどのゲームを実行可能かどうかを制御します。 +.Pp +ファイル +.Pa /etc/nogames +を使用すると、ゲームプレイを +.Dq 禁止 +します。 +このファイルが存在すると、ゲームプレイを許しません; +ゲームをしようとしたユーザに対して、このファイルの内容を表示します。 +.Sh 関連ファイル +.Bl -tag -width /var/log/games.log -compact +.It Pa /etc/dm.conf +構成ファイル +.It Pa /etc/nogames +ゲームプレイを禁止 +.It Pa /usr/games/hide +``実際の'' バイナリを保持するディレクトリ +.It Pa /var/log/games.log +ゲームをログするファイル +.El +.Sh 関連項目 +.Xr dm.conf 5 +.Sh バグ +.Nm dm +が +.Dq games +に setuid されたゲームを走らせることで、問題が 2 つ出てきます。 +第 1 に、 +.Tn UNIX +コマンドの実行をユーザに許すゲームは、 +コマンド実行前に実/実効ユーザ ID 両方を適切に設定しなければならないことです。 +おそらくより重要なことは、 +.Nm dm +を +.Dq games +以外に setuid してはならないことです。 +これを守っておけば、ゲームとの妥協は、 +自己の意志でゲームをプレイする能力のみに帰します。 +第 2 は、それまで setuid させて走らせずに済んでいたゲームで、 +ユーザファイルにアクセスするものは、 +修正しなければならないかもしれないことです。 +.Sh 歴史 +.Nm dm +コマンドは +.Bx 4.3 tahoe +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/dmesg.8 b/ja_JP.eucJP/man/man8/dmesg.8 new file mode 100644 index 0000000000..25780e7e0f --- /dev/null +++ b/ja_JP.eucJP/man/man8/dmesg.8 @@ -0,0 +1,70 @@ +.\" Copyright (c) 1980, 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. +.\" +.\" 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. +.\" +.\" @(#)dmesg.8 8.1 (Berkeley) 6/5/93 +.\" jpman %Id: dmesg.8,v 1.2 1997/04/25 00:26:27 mutoh Stab % +.\" +.Dd June 5, 1993 +.Dt DMESG 8 +.Os BSD 4 +.Sh 名称 +.Nm dmesg +.Nd システムメッセージバッファの表示 +.Sh 書式 +.Nm dmesg +.Op Fl M Ar core +.Op Fl N Ar system +.Sh 解説 +.Nm dmesg +はシステムメッセージバッファの内容を表示します。 +.Pp +オプションとしては、以下のものがあります: +.Bl -tag -width Ds +.It Fl M +表示されるシステムメッセージバッファが含まれるファイルを指定します。 +デフォルトは ``/dev/kmem'' です。 +.It Fl N +ネームリストが含まれるファイルを指定します。 +デフォルトは ``/kernel'' です。 +.El +.Sh 関連項目 +.Xr syslogd 8 +.Sh 関連ファイル +/dev/mem +/dev/kmem +/dev/drum +/kernel +.Sh 歴史 +.Nm +コマンドは +.Bx 4.0 +から登場しました。 + diff --git a/ja_JP.eucJP/man/man8/dump.8 b/ja_JP.eucJP/man/man8/dump.8 new file mode 100644 index 0000000000..bb84e62935 --- /dev/null +++ b/ja_JP.eucJP/man/man8/dump.8 @@ -0,0 +1,374 @@ +.\" Copyright (c) 1980, 1991, 1993 +.\" 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. +.\" +.\" 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. +.\" +.\" @(#)dump.8 8.1 (Berkeley) 6/16/93 +.\" jpman %Id: dump.8,v 1.2 1997/06/12 05:57:09 yugawa Stab % +.\" %Id: dump.8,v 1.5.2.3 1997/03/03 07:01:19 mpp Exp % +.\" +.Dd June 16, 1993 +.Dt DUMP 8 +.Os BSD 4 +.Sh 名称 +.Nm dump +.Nd ファイルシステムのバックアップ +.Sh 書式 +.Nm dump +.Op Fl 0123456789acknu +.Op Fl B Ar records +.Op Fl b Ar blocksize +.Op Fl d Ar density +.Op Fl f Ar file +.Op Fl h Ar level +.Op Fl s Ar feet +.Op Fl T Ar date +.Ar filesystem +.Nm dump +.Op Fl W Li \&| Fl w +.Pp +.in -\\n(iSu +( +.Bx 4.3 +形式のオプションは後方互換性のために実装されていますが、 +ここでは説明していません。) +.Sh 解説 +.Nm dump +は、ファイルシステムを調べて +バックアップする必要のあるファイルを決定します。 +これらのファイルは、指定されたディスク、テープや、 +その他の記憶メディアへ保存のためコピーされます +(リモートバックアップについては、 +.Fl f +オプションを参照)。 +ダンプの大きさが記録メディアの容量より大きい場合は、 +複数ボリュームに分割します。 +たいていのメディアの容量は、メディアの終りを通知されるまで +書き込んでみることで決定します。 +この方法は、 +.Fl a +オプションにより強制的に使用することもできます。 +.Pp +メディアの終りを正しく通知できないメディア (一部の +カートリッジ・テープドライブ等) の容量は、 +テープ長と記録密度やブロック数のオプションから求め、 +各ボリュームはすべて同じ容量を持つものとします。 +デフォルトでは、 +オペレータにメディア交換を要求した後の各ボリュームにも +同じ出力ファイル名を使用します。 +.Pp +.Nm dump +は、次のオプションをサポートしています。 +.Bl -tag -width Ds +.It Fl 0\-9 +ダンプレベル。 +レベル 0 はフルバックアップを意味し、ファイルシステム全体をコピー +することを保証します (ただし以下の +.Fl h +オプションにも注意して下さい)。 +0 より大きなレベル番号はインクリメンタルバックアップを意味し、 +前回のダンプ (今回指定したものより低いレベルのダンプ) +以降に作られたか修正されたすべてのファイルをコピーします。 +デフォルトのレベルは 0 です。 +.It Fl B Ar records +ボリュームあたりの 1 KB ブロック数です。 +このオプションは、テープ長と記録密度を基にしたテープ容量より +優先されます。 +.It Fl a +.Dq オートサイズ +全てのテープ長の考慮をせず、メディアの終了を通知されるまで、強制的に +書き込みを続けます。現在のほとんどのテープドライブでは、この方法により +もっとも良い結果が得られます。特に、使いかけのテープに追加したり、 +ハードウェア圧縮機能のあるテープドライブ(圧縮率がどの程度になるか不確かな +もの)を使用したりする場合にこのオプションを使用することをお薦めします。 +.It Fl b Ar blocksize +ダンプレコードあたりのブロックサイズを K バイト単位で指定します。 +.It Fl c +カートリッジテープドライブ用に、記録密度とテープ長のデフォルトをそれぞれ +8000 bpi、1700 feet に変更します。 +.It Fl h Ar level +ダンプレベルが +.Ar level +以上の時に、ユーザが指定した +.Dq nodump +フラグ +.Dp Dv UF_NODUMP +に従います (h: honor the flag)。 +デフォルトの honor レベルは 1 ですから、 +そのようなファイルは、インクリメンタルダンプからは省かれますが、 +フルバックアップには含まれます。 +.It Fl d Ar density +テープの記録密度を +.Ar density +に設定します。デフォルトは 1600BPI です。 +.It Fl f Ar file +バックアップの出力先ファイルを指定します。 +出力先ファイルとしては、 +.Pa /dev/rst0 +(テープドライブ)や +.Pa /dev/rfd1 +(フロッピーディスクドライブ)のようなデバイスファイル、 +通常ファイル、 +.Ql Fl +(標準出力)を指定することができます。 +複数のファイル名を、カンマで区切って一つの引数として指定する +ことができます。 +各ファイルは、リストされた順に一つのダンプボリュームに使用されます。 +指定した名前の数より多くのボリュームが必要な場合、 +メディアの交換を要求した後、最後のファイル名を残りのすべての +ボリュームに使用します。 +ファイル名が、 +.Dq host:file +または、 +.Dq user@host:file +の形式である場合、 +.Nm dump +は、 +.Xr rmt 8 +を使用してリモートホスト上の指定されたファイルに書き込みます。 +リモートの +.Xr rmt 8 +のデフォルトのパス名は +.Pa /etc/rmt +ですが、環境変数 +.Ev RMT +の値が優先されます。 +.It Fl k +リモートのテープサーバとの通信でケルベロス認証を使います。 +(このオプションが有効な状態で +.Nm dump +がコンパイルされた場合にのみ利用できます。) +.It Fl n +.Nm dump +がオペレータに注意を促す時に、 +.Xr wall 1 +に似た方法で +.Dq operator +グループに属するすべてのユーザにメッセージを送ります。 +.It Fl s Ar feet +テープの容量を計算する時に記録密度とともに使います。 +この容量を超えた場合に、 +.Nm dump +は新しいテープを要求します。 +このオプションはやや控え目に指定することをお勧めします。 +デフォルトのテープの長さは、2300 フィートです。 +.ne 1i +.It Fl T Ar date +.Pa /etc/dumpdates +から得られた日時の代わりに、指定された date をダンプの起点として +使います。date の形式は +.Xr ctime 3 +のそれと同じです。このオプションは期間を指定してバックアップを +取るダンプスクリプトで有用です。 +.Fl T +オプションは +.Fl u +オプションと同時には指定できません。 +.It Fl u +ダンプが成功した後で、 +.Pa /etc/dumpdates +ファイルを更新します。 +.Pa /etc/dumpdates +は人が読めるファイルであり、各行に以下のレコードが +フリーフォーマットで記録されています : +ファイルシステム名、インクリメントレベル、 +.Xr ctime 3 +形式のダンプ日付。 +各レベルとファイルシステムごとにエントリが一つだけ存在します。 +必要なら、 +.Pa /etc/dumpdates +の各フィールドを編集しても構いません。 +.It Fl W +.Nm dump +は、ダンプの必要があるファイルシステムをオペレータに表示します。 +この情報は +.Pa /etc/dumpdates +と +.Pa /etc/fstab +ファイルから集められます。 +.Nm dump +は、 +.Pa /etc/dumpdates +の中の各ファイルシステム毎に最新のダンプ日付とレベルを示し、 +ダンプするべきファイルシステムを明らかにします。 +.Fl W +オプションが指定された場合、その他のすべてのオプションは無視され、 +.Nm dump +は直ちに終了します。 +.It Fl w +W と同様ですが、ダンプの必要のあるファイルシステムのみを表示します。 +.El +.Pp +.Nm dump +は、以下に示す場合にオペレータの介入を要求します : +テープの終了、 +ダンプの終了、 +テープ書き込みエラー、 +テープオープンエラー、 +ディスク読み込みエラー (32 回を越えた場合)。 +処理を続けられない時や何か大変まずい事態になった場合には、 +.Nm dump +は、 +.Fl n +オプションがあればすべてのオペレータへ警告したうえで、 +.Em dump +の制御端末上でオペレータとやりとりします。 +.Nm dump +コマンドからのすべての質問には、 +.Dq yes +または +.Dq no +で適切に答えなければなりません。 +.Pp +フルダンプの実施には多くの時間と労力がかかるので、 +.Nm dump +は各テープボリュームの先頭にチェックポイントを設定します。 +何らかの理由により、あるボリュームの書き込みを失敗した場合には、 +テープの巻き戻し、排出、新しいテープのマウントの後で、 +.Nm dump +はオペレータの許可の下でチェックポイントから実行を再開します。 +.Pp +.Nm dump +は処理の進行を定期的にオペレータに報告します。 +報告には、少なめに推定される書き込みブロック数、 +必要なテープ数、完了までの時間、テープ交換までの時間、 +を含みます。 +.Nm dump +に使っている端末が使用中であることが他人にも分かるように、 +このメッセージは冗長になっています。 +.Pp +ディスクに壊滅的なトラブルが起きた時に、 +バックアップテープやファイルからディスクを復元するために +必要な時間は、 +インクリメンタルダンプを適当なシーケンスで実行する事によって +最小にする事ができます。 +最小のテープ数でこれを行なう効果的な方法を示します。 +.\" staggering +.Bl -bullet -offset indent +.It +常にレベル 0 のバックアップから開始します。例えば以下の通りです。 +.Bd -literal -offset indent +/sbin/dump -0u -f /dev/nrst0 /usr/src +.Ed +.Pp +これを一ヵ月か二ヵ月毎に新しいテープに対して実施し、 +ずっと保存します。 +.It +0 レベルのダンプの後は、アクティブなファイルシステムのダンプを、 +修正ハノイの塔アルゴリズムによる +次の様なダンプレベルシーケンスによって、毎日行います。 +.Bd -literal -offset indent +3 2 5 4 7 6 9 8 9 9 ... +.Ed +.Pp +毎日のダンプには、一週間毎に繰り返し使われる事になる +一定の数のテープを使う事ができます。 +週毎にレベル 1 ダンプを行ない、毎日のハノイ・シーケンスは +レベル 3 から開始します。 +週毎のダンプには、ダンプするファイルシステム毎に、これも繰り返し +使われる事になる一定数のテープを使います。 +.El +.Pp +何ヵ月かの後、毎日と毎週のテープはダンプサイクルから順に外し、 +新品のテープを導入すべきです。 +.Sh 環境変数 +環境変数 +.Ev RMT +は、リモートの +.Xr rmt 8 +プログラムのパス名を決定するのに用いられます。 +.Sh 関連ファイル +.Bl -tag -width /etc/dumpdates -compact +.It Pa /dev/rst0 +デフォルトのダンプテープユニット +.It Pa /etc/dumpdates +ダンプの日付を記録するファイル +.It Pa /etc/fstab +ダンプテーブル : ファイルシステムと頻度を決めるファイル +.It Pa /etc/group +.Em operator +グループを検索する +.El +.Sh 関連項目 +.Xr fstab 5 , +.Xr ft 8 , +.Xr restore 8 , +.Xr rmt 8 +.Sh 診断 +詳しいメッセージがたくさん出ます。 +.Pp +正常時は終了コード 0 で終了します。 +開始時のエラーは終了コード 1 で、 +異常終了は終了コード 3 で表されます。 +.Sh バグ +32 個未満のファイルシステムからの読み取りエラーは無視されます。 +.Pp +各リール (ボリューム) ごとに新たなプロセスが作られ、 +リールを書き終った親プロセスは +テープ全体の書き込みが終るまで待っています。 +.Pp +現状では、 +.Xr physio 9 +スライスのリクエストは 64 KB の塊になります。したがって、それより大きな +テープのブロックサイズを使用することはできず、 +.Nm dump +はこれが発生するのを防ぎます。 +.Pp +.Nm dump +の +.Fl W +や +.Fl w +オプションは、 +.Pa /etc/fstab +にリストされていても、 +.Pa /etc/dumpdates +に記録のないファイルシステムについては報告しません。 +.Pp +.Nm dump +コマンドが、 +ダンプシーケンスについて知っていて、 +使い散らかしたテープの使用履歴を管理でき、 +どのテープをマウントすれば良いかオペレータに教えてくれ、 +.Xr restore +を実行するオペレータをもっと助けてくれたら、 +もっと使いやすいでしょうね。 +.Pp +セキュリティ的な歴史により、 +.Nm dump +は、root 以外のユーザでリモートバックアップを行うことはできません。 +これは、FreeBSD の今後のバージョンでは修正されるでしょう。 +現状では、(従来通り) setuid されていれば正常に動作しますが、 +セキュリティ的なリスクを伴います。 +.Sh 歴史 +.Nm dump +コマンドは、 +.At v6 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/dumpfs.8 b/ja_JP.eucJP/man/man8/dumpfs.8 new file mode 100644 index 0000000000..aeebf725a0 --- /dev/null +++ b/ja_JP.eucJP/man/man8/dumpfs.8 @@ -0,0 +1,63 @@ +.\" Copyright (c) 1983, 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. +.\" +.\" 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. +.\" +.\" @(#)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 % +.\" jpman %Id: dumpfs.8,v 1.2 1997/05/03 11:26:10 horikawa Stab % +.\" +.Dd June 5, 1993 +.Dt DUMPFS 8 +.Os BSD 4.2 +.Sh 名称 +.Nm dumpfs +.Nd ファイルシステムの情報のダンプ +.Sh 書式 +.Nm dumpfs +.Op Ar filesys No \&| Ar device +.Sh 解説 +.Nm dumpfs +は、指定したファイルシステムまたはスペシャルデバイスの、 +スーパブロックやシリンダグループの情報を表示します。 +表示は非常に長く、詳細なものです。 +このコマンドは、ファイルシステムのブロックサイズや最小空き容量などの +ファイルシステムに関する情報を調べるのにもっともよく使われます。 +.Sh 関連項目 +.Xr disktab 5 , +.Xr fs 5 , +.Xr disklabel 8 , +.Xr fsck 8 , +.Xr newfs 8 , +.Xr tunefs 8 +.Sh 歴史 +.Nm +コマンドは +.Bx 4.2 +から登場しています。 diff --git a/ja_JP.eucJP/man/man8/dumpon.8 b/ja_JP.eucJP/man/man8/dumpon.8 new file mode 100644 index 0000000000..3c1b445371 --- /dev/null +++ b/ja_JP.eucJP/man/man8/dumpon.8 @@ -0,0 +1,105 @@ +.\" Copyright (c) 1980, 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. +.\" +.\" 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. +.\" +.\" From: @(#)swapon.8 8.1 (Berkeley) 6/5/93 +.\" jpman %Id: dumpon.8,v 1.3 1997/08/16 13:12:52 horikawa Stab % +.\" %Id: dumpon.8,v 1.3 1996/08/23 00:55:54 mpp Exp % +.\" +.Dd May 12, 1995 +.Dt DUMPON 8 +.Os FreeBSD 2.1 +.Sh 名称 +.Nm dumpon +.Nd クラッシュダンプ用デバイスの指定 +.Sh 書式 +.Nm dumpon +.Op Fl v +.Ar special_file +.Sh 解説 +.Nm dumpon +は、パニック時にカーネルがクラッシュダンプをセーブするデバイスを +指定するのに用いられます。 +安全のため、 +.Xr config 8 +への入力において +.Dq dumps on +記述がされていない限り、 +システムはダンプエリアなしで開始します。 +ダンプデバイスは、コンフィギュレーションファイル中で指定された +スワップエリアのひとつでなければならず、 +また、少なくとも物理メモリ分のサイズがなければなりません。 +普通、 +.Nm dumpon +は、システムのマルチユーザ初期化ファイル +.Pa /etc/rc +の中で +.Xr savecore 8 +の実行前に呼び出されます。 +.Fl v +オプションを指定すると、 +.Nm +はその処理に関する詳細情報を出力します。 +.Pp +.Nm +プログラムの動作は、 +.Xr sysctl 3 +の MIB 変数 +.Dq kern.dumpdev +に指定された +.Ar special_file +のデバイス番号を設定するか、 +あるいは +.Ar special_file +が文字列 +.Dq Li off +の場合は +.Dv NODEV +(ダンプはとらないことを意味します) +を設定する、というものです。 +.Sh 関連項目 +.Xr sysctl 3 , +.Xr init 8 , +.Xr rc 8 , +.Xr savecore 8 +.Sh 関連ファイル +.Bl -tag -width /dev/[ws]d?b -compact +.It Pa /dev/[ws]d?b +標準のページングデバイス +.El +.Sh バグ +クラッシュダンプをとるときには +既にファイルシステムレイヤは動作していないので、 +クラッシュダンプを直接ファイルに落すことはできません。 +.Sh 歴史 +.Nm +コマンドは +.Fx 2.1 +で登場しました。 diff --git a/ja_JP.eucJP/man/man8/edquota.8 b/ja_JP.eucJP/man/man8/edquota.8 new file mode 100644 index 0000000000..11cd567775 --- /dev/null +++ b/ja_JP.eucJP/man/man8/edquota.8 @@ -0,0 +1,183 @@ +.\" Copyright (c) 1983, 1990, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" This code is derived from software contributed to Berkeley by +.\" Robert Elz at The University of Melbourne. +.\" +.\" 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. +.\" +.\" 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. +.\" +.\" @(#)edquota.8 8.1 (Berkeley) 6/6/93 +.\" jpman %Id: edquota.8,v 1.2 1997/05/15 08:54:02 mitchy Stab % +.\" +.Dd "June 6, 1993" +.Dt EDQUOTA 8 +.Os +.Sh 名称 +.Nm edquota +.Nd ユーザの割り当て制限を変更する +.Sh 書式 +.Nm edquota +.Op Fl u +.Op Fl p Ar proto-username +.Ar username ... +.Nm edquota +.Fl g +.Op Fl p Ar proto-groupname +.Ar groupname ... +.Nm edquota +.Fl t +.Op Fl u +.Nm edquota +.Fl t +.Fl g +.br +.Sh 解説 +.Nm edquota +は割り当て制限を変更するエディタです。 +デフォルトで(または +.Fl u +オプションが指定された場合)は、 +コマンドラインから 1 人以上のユーザを指定できます。 +それぞれのユーザの現在の割り当て制限を、 +.Tn ASCII +テキストで記述した一時ファイルが作成されます。 +ユーザ割り当て制限が設定されているファイルシステムは +.Pa /etc/fstab +の記述から検索します。 +次に、 +作成された +.Tn ASCII +ファァイルを編集できるようにエディタが起動されます。 +環境変数 +.Ev EDITOR +で指定されていなければ、 +.Xr vi 1 +が起動されます。 +.Pp +このエディタ上で、 +割り当て制限を変更したり、 +追加したりできます。 +割り当て制限値を 0 に設定することは、 +割り当て制限を行わないことを示します。 +ハードリミット値を 1 に設定することは、 +ファイルを作成できないようにすることを意味します。 +ソフトリミット値を 1 に設定し、 +ハードリミットを 0 に設定することは、 +一時的な用途にのみ割り当てを許可することを意味します ( +.Fl t +の項を参照)。 +現在使用量は参考のためにのみ出力され、 +変更しても意味はありません。 +.Pp +エディタを終了すると、 +.Nm +は一時ファイルを読み込み、 +変更を反映するよう割り当て制限用バイナリファイルを書き換えます。 +.Pp +.Fl p +オプションが指定された場合、 +.Nm +は、指定されたユーザに proto-username に対する設定をコピーします。 +これは、 +複数のユーザに割り当て制限を設定する一般的な方法です。 +制限を設定するユーザとして数字で uid の範囲 (例えば、1000-2000) が +指定されたとき、 +.Nm +は、指定された範囲の uid のユーザについて設定をコピーします。 +これにより、まとめてユーザにデフォルトの制限を設定することが出来ます。 +制限を設定する uid は、 +.Pa /etc/passwd +に書かれていない値でも構いません。 +.Pp +.Fl g +オプションが指定された場合、 +.Nm +はコマンドラインで指定された 1 つ以上のグループに +対する割り当て制限を変更します。 +.Fl p +オプションを +.Fl g +オプションと +いっしょに使用することにより、 +.Fl p +オプションで指定したグループの設定を +他のグループにコピーすることができます。 +.Pp +ユーザはある一定の猶予期間だけ、 +ソフトリミットを超えてファイルシステムを利用することができます。 +猶予期間を過ぎるとソフトリミットは +ハードリミットと同じ意味を持つようになり、 +それ以上のファイルの割り当てができなくなります。 +デフォルトの猶予期間は +.Pa /usr/include/ufs/ufs/quota.h +で定義されています。 +.Fl t +オプションにより猶予期間を変更することができます。 +デフォルトで、 +あるいは +.Fl u +オプションを +指定して起動した場合は、 +.Pa /etc/fstab +に指定してあるすべてのユーザ割り当て制限に対して猶予期間が設定されます。 +.Fl g +オプションを指定して +起動した場合は、 +.Pa /etc/fstab +に指定してあるすべてのグループ割り当て制限に対して猶予期間が設定されます。 +猶予期間は、 +日、 +時、 +分、 +秒を指定して設定することができます。 +猶予期間を 0 に設定することは、 +デフォルトの猶予期間を指定したものとみなされます。 +また、 +猶予期間を 1 秒に設定することは、 +猶予期間なしとみなされます。 +.Pp +スーパユーザのみが割り当て制限を変更することができます。 +.Sh 関連ファイル +.Bl -tag -width quota.group -compact +.It Pa quota.user +ファイルシステムのルートにあるユーザ割り当て制限に関するデータ +.It Pa quota.group +ファイルシステムのルートにあるグループ割り当て制限に関するデータ +.It Pa /etc/fstab +ファイルシステムの名前と位置を読み取る +.El +.Sh 関連項目 +.Xr quota 1 , +.Xr fstab 2 , +.Xr quotactl 2 , +.Xr quotacheck 8 , +.Xr quotaon 8 , +.Xr repquota 8 +.Sh 診断 +アクセス不可能なファイルに対して、様々なメッセージを出力します。 diff --git a/ja_JP.eucJP/man/man8/fdcontrol.8 b/ja_JP.eucJP/man/man8/fdcontrol.8 new file mode 100644 index 0000000000..4358eefa79 --- /dev/null +++ b/ja_JP.eucJP/man/man8/fdcontrol.8 @@ -0,0 +1,104 @@ +.\" +.\" Copyright (C) 1994 by Joerg Wunsch, Dresden +.\" 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. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR(S) ``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(S) 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. +.\" +.\" jpman %Id: fdcontrol.8,v 1.3 1997/08/16 13:14:53 horikawa Stab % +.Dd May 22, 1994 +.Os +.Dt FDCONTROL 8 +.Sh 名称 +.Nm fdcontrol +.Nd フロッピディスクパラメータの変更 +.Sh 書式 +.Nm fdcontrol +.Op Fl d Ar 0|1 +.Ar device +.Nm fdcontrol +.Op Fl s +.Ar device +.Sh 解説 +.Nm fdcontrol +は +.Ar device +で指定したフロッピディスクデバイスの実行時の振る舞いを変更します。 +.Ar device +はキャラクタデバイスでなければなりません。 +.Pp +現在のところ +.Nm fdcontrol +では、 +フロッピディスクドライブのデバイスパラメータの指定 +.Po +.Fl s , +これがデフォルトモードでもあります +.Pc +や、フロッピドライバが +.Em DEBUG +オプション付きでカーネルに組み込まれている場合には +ドライバのデバッグレベルの変更 +.Pq Fl d +を行なうことができます。 +.Pp +これらの操作は他に悪影響を及ぼす可能性があるため、 +この中で行なわれる +.Xr ioctl 2 +コマンドの実行はスーパユーザに限定されています。 +.Pp +新しいパラメータ指定を要求すると、 +.Nm +は調整可能な各パラメータをユーザに問い合わせてきます。 +これらは現在使われている値がデフォルト値となっています。 +.Sh 診断 +内部で呼び出される +.Xr ioctl 2 +のエラーコードが +.Xr perror 3 +によって表示されます。 +.Sh バグ +.Nm +コマンドは現在開発途上です。 +ユーザインタフェースはややお粗末で、将来は変更される可能性があります。 +コマンドラインから何でも変更できるようなオプション整備も必要でしょう。 +.Pp +現実のドライバはデバッグレベルとして +.Pq 0 and 1 +しかサポートしていません。 +デバッグレベル 1 にすると非常に多量の出力を生成するので、 +よく注意して使わないと syslog をオーバフローさせかねません。 +.Sh 関連項目 +.Xr ioctl 2 , +.Xr perror 3 , +.Xr fdc 4 +.Sh 歴史 +.Nm fdcontrol +は現在開発途上です。 +そのユーザインタフェースと全体機能は、 +将来改良あるいは変更される可能性があります。 +.Sh 作者 +本プログラムは +.if n Joerg Wunsch, +.if t J\(:org Wunsch, +Dresden +から寄贈されました。 diff --git a/ja_JP.eucJP/man/man8/fdisk.8 b/ja_JP.eucJP/man/man8/fdisk.8 new file mode 100644 index 0000000000..00c158a08f --- /dev/null +++ b/ja_JP.eucJP/man/man8/fdisk.8 @@ -0,0 +1,435 @@ +.Dd October 4, 1996 +.\" jpman %Id: fdisk.8,v 1.4 1997/07/26 21:56:04 horikawa Stab % +.Dt FDISK 8 +.\".Os BSD 4 +.Sh 名称 +.Nm fdisk +.Nd DOS パーティションのメンテナンスプログラム +.Sh 書式 +.Nm fdisk +.Op Fl i +.Op Fl u +.Op Fl a +.Op Fl 1234 +.Op Ar disk +.Bl -tag -width time +.Nm fdisk +.Op Fl f Ar configfile +.Op Fl i +.Op Fl v +.Op Fl t +.Op Ar disk +.Sh 前置き +BIOS がカーネルをブートするために、 +一定の約束をちゃんと守らねばなりません。 +ディスクのセクタ 0 はブートコード、パーティションテーブル、 +マジックナンバを含んでいなければならないのです。 +BIOS パーティションはディスクをいくつかの部分に分けるのにも使われます。 +BIOS はセクタ 0 を読み込んできて、(本当にそのコードを使うか?) +マジックナンバを確かめます。 +それから、 +セクタ 0 に書き込まれた 4 つの BIOS パーティションを探して、 +それらのどれが +.Em アクティブ +かを決定します。 +それから、二次ブートブロックを +.Em アクティブ +パーティションから読み込み、それを実行します。 +DOS では一つの以上のパーティションと一つの +.Em アクティブ +を持てます。 +DOS の +.Nm +プログラムは、 +ディスク空間を一つ以上のパーティションに分割して、一つの +.Em アクティブ +を設定することができます。 +.Sh 解説 +.Pp +FreeBSD のプログラム +.Nm +は、DOS のそれと似た目的に役立ちます。 +第一の形は、パーティション情報の表示や、 +パーティションテーブルの対話的な編集に使われます。 +第二の形は、 +.Ar configfile +を使ってパーティションテーブルを書き込むという使い方であり、 +他のスクリプト/プログラムから利用するよう設計されています。 +.Pp +オプション: +.It Fl u +ディスクのセクタ 0 を更新 (編集) するのに使われます。 +.Fl f +があるときには無視されます。 +.It Fl i +ディスクのセクタ 0 を初期化します。 +もし +.Fl f +がなければ、 +.Fl u +の意味も含みます。 +.It Fl a +アクティブパーティションの変更のみを行ないます。 +.Fl f +があるときには無視されます。 +.It Fl 1234 +一つの fdisk エントリの操作だけを行ないます。 +.Fl f +があるときには無視されます。 +.It Fl f Ar configfile +パーティションの値をファイル +.Ar configfile +を使って設定します。 +.Fl i +もあるときには、 +.Ar configfile +が読み込まれるに先立って、 +存在するパーティションは全部消され(つまり「未使用」の印をつけられる) +ますが、この場合を除いて、 +.Ar configfile +はいつも存在するパーティションの変更を行ないます。 +.Ar configfile +は "-" であってもよく、この場合 +.Ar 標準入力 +が読まれます。 +ファイルの構文は、以降の +.Em コンフィギュレーションファイル +の節をご覧下さい。 +.Pp +.Em 警告: +.Fl f +が使われたときには、 +(対話モードで尋ねられるように) +本当にパーティションテーブルを書き込むのかどうかを尋ねられません。 +用心して使うこと! +.It Fl t +テストモード; パーティションテーブル値を書き込みません。一般に +.Fl f +オプションを付けて、パーティションテーブルに書き込まれるはずのものを +見るのに使われます。 +.Fl v +の意味を含みます。 +.It Fl v +冗長になります。 +.Fl f +が使われたときには、 +.Nm +はディスクに書き込まれるパーティションテーブルを表示します。 +.El +.Pp +最後のディスク名 +.Ar disk +は、 +.Sq 裸の +ディスク名だけ、 +つまり +.Ql sd0 +か、あるいは +.Pa /dev +の下に完全に限定されたデバイスノードで与えることができます。 +もし省略された場合、ディスク +.Ql wd0 , +.Ql sd0 , +と +.Ql od0 +が、一つが応答して見付かるまで +この順序で検索されます。 +.Pp +引数なしで呼び出されたときには、 +セクタ 0 パーティションテーブルを表示します。 +例えば: + +.Bd -literal + ******* Working on device /dev/rwd0 ******* + parameters extracted from in-core disklabel are: + cylinders=769 heads=15 sectors/track=33 (495 blks/cyl) + + parameters to be used for BIOS calculations are: + cylinders=769 heads=15 sectors/track=33 (495 blks/cyl) + + Warning: BIOS sector numbering starts with sector 1 + Information from DOS bootblock is: + The data for partition 1 is: + sysid 165,(FreeBSD/NetBSD/386BSD) + start 495, size 380160 (185 Meg), flag 0 + beg: cyl 1/ sector 1/ head 0; + end: cyl 768/ sector 33/ head 14 + The data for partition 2 is: + sysid 164,(unknown) + start 378180, size 2475 (1 Meg), flag 0 + beg: cyl 764/ sector 1/ head 0; + end: cyl 768/ sector 33/ head 14 + The data for partition 3 is: + <UNUSED> + The data for partition 4 is: + sysid 99,(ISC UNIX, other System V/386, GNU HURD or Mach) + start 380656, size 224234 (109 Meg), flag 80 + beg: cyl 769/ sector 2/ head 0; + end: cyl 197/ sector 33/ head 14 +.Ed +.Pp +このディスクは、たまたまディスク全体を満す +3 つのパーティションに分割されています。 +二つ目のパーティションは最初のパーティションの最後に重なっています。 +(デバッグ目的に使われます) +.Bl -tag -width "cyl, sector と head" +.It Em "sysid" +パーティションのラベル付に使われます。 +FreeBSD ではマジックナンバ 165 (10進) A5 (16進)を予約しています。 +.It Em "start と size" +パーティションのセクタ単位での +開始アドレスとサイズです。 +.It Em "flag 80" +これがアクティブパーティションであることを指定します。 +.It Em "cyl, sector と head" +パーティションの +開始アドレスと終了アドレスを指定するのに使われます。 +.It Em "注釈:" +これらの数字は、 +BIOS の理解するディスクジオメトリを使って計算され、 +ブートブロックに保存されます。 +.El +.Pp +フラグ +.Fl i +または +.Fl u +は、 +もし +.Fl f +オプションが使われていない限り、 +パーティションデータを更新すべきであることを指示します。 +もし +.Fl f +がなければ、 +.Nm +プログラムは対話モードに入ります。 +このモードでは明示的に指示しない限り、どんなデータも変更しないように +設計されています。 +.Nm +はこのような振舞いを保証するよう、質問のデフォルトを選択しています。 +.Pp +.Nm +は各々のパーティションを表示し、 +それを編集したいかどうかを尋ねます。 +yes と答えたら、 +古い値を表示し、新しい値を尋ねて +各々のフィールドを進みます。 +一つのパーティションが終了したら、 +.Nm +はそれを表示して、それで正しいかどうかを尋ねます。 +そして +.Nm +は次のエントリに進みます。 +.Pp +.Em cyl, sector, +と +.Em head +のフィールドを正しく得るにはちょっとした芸当が要ります。 +そのためデフォルトでは、 +.Nm +が代わって計算しますが、選択してそれらの値を指定することもできます。 +.Pp +全てのパーティションが進行した後、 +.Em アクティブ +パーティション変更をすることができます。 +最後に、 +最初のセクタのデータが全部集めれらたときに、 +本当にセクタ 0 を書換えても良いか尋ねられます。 +yes と答えた場合だけ、データはディスクに書き込まれます。 +.Pp +.Fl u +フラグと +.Fl i +の間の違いは、 +.Fl u +フラグはディスク上にあるフィールドの値を編集するだけですが、 +一方 +.Fl i +フラグはセクタ 0 を "初期化" するのに使われます; +ディスク全体を FreeBSD 用に使えるように、 +最後の BIOS パーティションをセットアップして、それをアクティブにします。 +.Sh 注釈 +.Pp +開始シリンダ等の自動計算は、 +BIOS がそのドライブのジオメトリであると思っている数字をもとに行なわれます。 +これらの数字はデフォルトでは、メモリ上のディスクラベルから取りますが、 +プログラムの起動時にそれらを変更する機会が与えられます。 +このおかげでユーザは、 +BIOS がジオメトリ変換を行なうドライブでも動作できるブートブロックを +作ることができます。 +.Pp +もしディスクのレイアウトを手作業で変更するのなら、 +どうか FreeBSD パーティションがシリンダ境界から開始することを確認してください。 +その後のたくさんの決定がこのことを仮定しています。 +(これは必要ではなかったのかもしれませんが) +.Pp +すでにあるパーティションを編集すると、 +たぶんそのパーティションのデータを失うことになるでしょう。 +.Pp +このプログラムがどう働くかを調べるために、 +一度か二度は対話的に実行するべきです。 +これは、最後の質問に否定で答える限り完全に安全です。 +このマニュアルでは完全に説明されていませんが、 +プログラムが検出する微妙な点があります。 +.Sh コンフィギュレーションファイル +.Pp +.Fl f +オプションが与えられたとき、 +.Ar configfile +の値を使ってディスクのパーティションテーブルを書換えることができます。 +このファイルの構文はたいへん単純です。 +各行はコメントか仕様のどちらかで、空白 (改行を除く) は無視されます。 +.Bl -tag -width Ds +.It Xo +.Ic # +.No Ar comment ... +.Xc +"#" で開始している行はコメントで無視されます。 +.It Xo +.Ic g +.No Ar spec1 +.No Ar spec2 +.No Ar spec3 +.Xc +パーティション計算で使う BIOS ジオメトリを設定します。 +前に文字を伴った数字で、三つの値を指定しなければいけません。 +.Bl -tag -width Ds +.Sm off +.It Cm c No Ar num +.Sm on +シリンダの数を +.Ar num +に設定します。 +.Sm off +.It Cm h No Ar num +.Sm on +ヘッドの数を +.Ar num +に指定します。 +.Sm off +.It Cm s No Ar num +.Sm on +トラックあたりのセクタの数を +.Ar num +に設定します。 +.El +.Pp +これらの指定はどんな順序でもよく、先頭の文字がどの値かを決定します; +しかし、三つ全てを指定しなければなりません。 +.Pp +この行はパーティション情報を指定するどんな行よりも前に現れなくてはなりません。 +.Pp +次の条件が真でなければ、エラーです: +.Pp +.nf + 1 <= シリンダの数 + 1 <= ヘッドの数 <= 256 + 1 <= トラックあたりのセクタの数 < 64 +.fi +.Pp +シリンダの数は 1024 以下でなければなりませんが、 +しかしこれは強制されるものではなく、警告が出力されるでしょう。 +ブート可能な FreeBSD パーティション ("/" ファイルシステム) は +最初の 1024 シリンダ以内に収まっていなといけません; +もしそうでなければ、ブートに失敗するかもしれません。 +ブートしないパーティションには、この制限はありません。 +.Pp +1019 シリンダ、39 ヘッド、63 セクタのディスクの例 (これらの全てはみな等価): +.Pp +.nf + g c1019 h39 s63 + g h39 c1019 s63 + g s63 h39 c1019 +.fi +.It Xo +.Ic p +.No Ar partition +.No Ar type +.No Ar start +.No Ar length +.Xc +.Ar partition +(1-4) で与えられたパーティションに、タイプ +.Ar type +、開始セクタ +.Ar start +、長さ (セクタ数) +.Ar length +を設定します。 +.Pp +これらの行で明示的に言及されたパーティションだけが変更されます; +"p" 行で参照されていないパーティションは変更されません。 +しかし、無効なパーティションテーブルがあるか、 +.Fl i +オプションが指定されているなら、 +存在するパーティションエントリは全て取り除かれ (未使用の印がつけられ)、 +パーティション情報を明示的に設定するのに、 +"p" 行が使われなければなりません。 +もし複数のパーティションを設定する必要があるなら、 +複数の "p" 行が指定されなければなりません; +一つの行で一つのパーティションを設定します。 +.Pp +これらのパーティション行は、もしあればジオメトリ指定行の後に現れなければ +なりません。 +.Pp +FreeBSD パーティションの +.Ar type +は 165 です。0 のパーティションタイプを指定すると、 +パーティションを取り除き未使用の印をつけたのと同じことになります; +しかし、("0" とかの) ダミーの値が +.Ar start +と +.Ar length +に指定されなければなりません。 +.Pp +注: パーティションの開始オフセットはヘッド境界まで必要なら繰り上げられ、 +終了オフセットはシリンダ境界まで必要なら繰り下げられます。 +.Pp +例: パーティション 4 を取り除いて、未使用の印をつける: +.Pp +.nf + p 4 0 0 0 +.fi +.Pp +例: パーティション 1 を FreeBSD パーティションであって、 +セクタ 1 から始まって 2503871 セクタの長さに設定する +(注: これらの値は、 +対応するヘッドとシリンダ境界に繰り上げ/繰り下げられます): +.Pp +.nf + p 1 165 1 2503871 +.fi +.It Xo +.Ic a +.No Ar partition +.Xc +.Ar partition +パーティションをアクティブにします。 +コンフィギュレーションファイルのどこに現われても構いませんが、 +一つだけしか現われてはいけません。 +.Pp +例: パーティション 1 をアクティブパーティションにします: +.Pp +.nf + a 1 +.fi + +.El +.Pp +.Sh 関連項目 +.Xr disklabel 8 +.Sh バグ +プログラム全体をよりユーザフレンドリにするべきです。 +.Pp +このマニュアルを通して使われている術語 +.Sq パーティション +は、他で使われる術語に一致させるため、 +本当は +.Sq スライス +であるべきです。 +.Pp +ディスク全体を FreeBSD に捧げるためには、このコマンドは使えません。 +これには +.Xr disklabel 8 +コマンドを使わなればなりません。 diff --git a/ja_JP.eucJP/man/man8/fingerd.8 b/ja_JP.eucJP/man/man8/fingerd.8 new file mode 100644 index 0000000000..9858655dae --- /dev/null +++ b/ja_JP.eucJP/man/man8/fingerd.8 @@ -0,0 +1,135 @@ +.\" Copyright (c) 1980, 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. +.\" +.\" 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. +.\" +.\" @(#)fingerd.8 8.1 (Berkeley) 6/4/93 +.\" jpman %Id: fingerd.8,v 1.2 1997/05/21 00:55:57 mitchy Stab % +.\" +.Dd June 4, 1993 +.Dt FINGERD 8 +.Os BSD 4.3 +.Sh 名称 +.Nm fingerd +.Nd 他のホストからの finger 要求に応えるサーバプログラム +.Sh 書式 +.Nm fingerd +.Op Fl s +.Op Fl l +.Op Fl p Ar filename +.Sh 解説 +.Nm fingerd +は、ネットワークの各サイト上の name と finger プログラムとの +インターフェースを提供する、 +.%T RFC1196 +で規定されるプロトコルを実現するデーモンプログラムです。 +このプログラムはシステムあるいは特定の人について +人間的で親しみやすい状況報告をするものです。 +特別なフォーマットは規定されておらず、プロトコルは 1 行ずつ +コマンドラインのような形式でやりとりされます。 +.Pp +.Nm fingerd +は、 +.Tn TCP +の 79 番ポートを見張っている +.Xr inetd 8 +から開始されます。接続されると、 +.Aq Tn CRLF +で区切られたコマンドライン 1 行を受け取ります。これは +.Nm finger 1 +に送られ、処理されます。 +.Nm fingerd +は、出力が終わるとすぐに接続を切ります。 +.Pp +もし、そのコマンドラインがヌルの (つまり +.Aq Tn CRLF +だけが送られた) 場合、 +.Xr finger +は +.Dq デフォルト +の出力を行ないます。デフォルトは、その時にシステムにログインしている全ての +人のリストです。 +.Pp +もし、ユーザ名が指定されると (たとえば +.Pf eric Aq Tn CRLF +) 出力は、その人に関する詳細な情報だけとなります。これには、 +ログインしている/いないの情報も含まれます。 +コマンドラインの +.Dq names +は、 +.Dq ログイン名 +と +.Dq ユーザ名 +のどちらでもかまいません。 +名前が曖昧な場合は、マッチするものすべてについて表示されます。 +.Pp +.Nm fingerd +に渡す引数として、 +.Pa /etc/inetd.conf +の中で指定できるオプションは以下のとおりです: +.Bl -tag -width Ds +.It Fl s +secureモードを有効にします。ユーザ名なしの問い合わせと、他の +リモートホストへの問い合わせの転送は拒否されます。 +.It Fl l +ログをとります。問い合わせをしたホストの名前を +.Xr syslog 3 +を通して LOG_NOTICE の優先度で報告します。 +.It Fl p +ローカルの情報提供元としてデフォルト以外のプログラムを使います。 +.Nm fingerd +によって起動されるデフォルトのローカルプログラムは、 +.Xr finger 1 +です。カスタマイズされたローカルサーバを指定することにより、 +システム管理者はリモートサイトに提供する情報を +さらにコトロールできます。 +.El +.Sh 関連項目 +.Xr finger 1 , +.Xr inetd 8 +.Sh バグ +サーバに +.Tn TIP +や、同じくらい見識の狭い +.Tn TELNET Ns \-protocol +ユーザプログラムで直接コネクトすると、 +サーバに意味の無いネゴシエーションオプションを送ることになり +不正なコマンドライン解釈を行う可能性があります。 +.Nm fingerd +は、 +.Tn IAC +のものをフィルタリングして除くべきであり、おそらく +受け取った全てのオプションコマンドを否定するよう +.Pq Tn IAC 拒否 +をするべきです。 +.Sh 歴史 +.Nm +コマンドは +.Bx 4.3 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/fsck.8 b/ja_JP.eucJP/man/man8/fsck.8 new file mode 100644 index 0000000000..1e253e7398 --- /dev/null +++ b/ja_JP.eucJP/man/man8/fsck.8 @@ -0,0 +1,297 @@ +.\" Copyright (c) 1980, 1989, 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. +.\" +.\" 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. +.\" +.\" @(#)fsck.8 8.2 (Berkeley) 12/11/93 +.\" %Id: fsck.8,v 1.5.2.1 1997/03/03 07:01:23 mpp Exp % +.\" jpman %Id: fsck.8,v 1.2 1997/04/24 00:30:54 mutoh Stab % +.\" +.Dd December 11, 1993 +.Dt FSCK 8 +.Os BSD 4 +.Sh 名称 +.Nm fsck +.Nd ファイルシステムの整合性チェックと対話的修正 +.Sh 書式 +.Nm fsck +.Fl p +.Op Fl f +.Op Fl m Ar mode +.Nm fsck +.Op Fl b Ar block# +.Op Fl c Ar level +.Op Fl l Ar maxparallel +.Op Fl y +.Op Fl n +.Op Fl m Ar mode +.Op Ar filesystem +.Ar ... +.Sh 解説 +.Nm fsck +の最初の書式は、標準のファイルシステムのセットや指定された +ファイルシステムの状態を整えるのに使われます。 +通常は、自動リブートの間に +.Pa /etc/rc +スクリプトの中で使用されます。 +この時 +.Nm fsck +は +.Pa /etc/fstab +を読んで、チェックするファイルシステムを決定します。 +fstab 内の ``rw,'' ``rq,'' ``ro'' のいずれかのオプションで +マウントされる、 0 以外のパス番号をもつパーティションのみが +チェックの対象です。 +パス番号 1 を持つファイルシステム +(通常はルートファイルシステムだけです) は、 +一つずつ順番にチェックされます。 +パス 1 が完了すると、残りのすべてのファイルシステムは、 +ディスクドライブごとに一つのプロセスを使ってチェックされます。 +ファイルシステムが含まれるディスクドライブは、 +デバイス名のうち最後が数字である最も長い文字列として認識されます。 +残りの文字列はパーティションを示すと解釈されます。 +.Pp +各ファイルシステムのスーパーブロックのクリーン (clean) フラグを調べ、 +クリーンでないファイルシステムのみをチェックします。 +.Fl f +オプションを指定した場合、クリーンフラグの状態にかかわらず +ファイルシステムをチェックします。 +.Pp +カーネルは、ハードウェアやソフトウェアに障害が起きない限り、 +ファイルシステムには限定された無害な不整合しか起こさない様に +動作します。 +それらの不整合には以下の物があります。 +.Bl -item -compact +.It +参照されない inode +.It +inode のリンクカウントが多すぎる +.It +フリーマップ中にないフリー (空き) ブロック +.It +フリーマップとファイルの両方にあるブロック +.It +スーパーブロック内の数値の異常 +.El +.Pp +.Fl p +オプション付の +.Nm fsck +では、上記の不整合のみを修正します。その他の不整合を発見すると、 +.Nm fsck +は異常終了のステータスを返して終了し、自動リブートは失敗します。 +不整合を修正するたびに、ファイルシステムと修正内容が表示されます。 +ファイルシステムの修正に成功した後で、 +.Nm fsck +はファイルシステム中のファイル数、使用中ブロックとフリーブロックの数、 +フラグメントの割合を表示します。 +.Pp +.Nm fsck +がファイルシステムをチェックしている間に +.Dv QUIT +シグナルを送ると、 +.Nm fsck +はチェックを続けますが、終了時に異常終了のステータスを返し、 +自動リブートを失敗させます。 +これは、自動リブートによるファイルシステムチェックは行いたいが、 +チェック完了後にマルチユーザモードに移行したくない場合に有用です。 +.Pp +.Fl p +オプションなしでは、 +.Nm fsck +はファイルシステムの状態の検査をおこない、それを対話的に修正します。 +ファイルシステムに不整合がある場合、修正を実施する前にオペレータへ +確認を求めます。 +.Fl p +オプションでは直せない修正では、データが失われる可能性があることに +注意すべきです。 +失われるデータの量とその致命度は、診断メッセージから判断して下さい。 +デフォルト動作では、修正を実行する前に、オペレータが +.Li yes +か +.Li no +と応答するまで待ちます。 +オペレータにファイルシステムの書き込み権限がない場合、 +.Nm fsck +は、 +.Fl n +オプションの動作をデフォルトにします。 +.Pp +.Nm fsck +は、以前使われていた +.Em check , dcheck , fcheck , +.Em icheck +の組合せよりもより詳しい不整合チェックを行ないます。 +.Pp +.Nm fsck +は以下のフラグを解釈します。 +.Bl -tag -width indent +.It Fl b +指定した番号のブロックをファイルシステムの +スーパーブロックとして使用します。 +ブロック番号 32 は普通、代替スーパーブロックになっています。 +.It Fl l +同時チェックの並列度を、指定した数に制限します。 +デフォルト値はディスク数であり、 +ディスク毎に一つのプロセスが実行されます。 +これより小さい値を指定すると、 +各ディスクを、ファイルシステムを一つずつ +ラウンドロビン方式でチェックします。 +.It Fl m +.Pa lost+found +ディレクトリを作る時のモードとして、デフォルトの 1777 の代わりの +値を 8 進数で指定します。 +失われたファイルをすべてのユーザには見せたくないシステムでは、 +より制限の厳しい 700 を使うべきです。 +.It Fl y +.Nm fsck +からのすべての質問に yes と答えます。 +このオプションは、 +修正によって新たな不整合を生むような誤った修正に対しても無制限な +許可を与えてしまうものですから、 +十分に用心して使用すべきです。 +.\" お手上げにつき、意訳しました by TM +.\"(訳注)とくに問題がないと判断したので,この意訳をそのままとしました。 +.\" 2.2.1R 対象(1997/04/23) Takeshi MUTOH <mutoh@info.nara-k.ac.jp> +.It Fl n +.Nm fsck +からの +.Ql CONTINUE? +を除くすべての問い合わせに no と答えます。 +このオプションは、ファイルシステムへの書き込みオープンを行いません。 +.It Fl c +ファイルシステムを指定したレベルへ変換します。 +ファイルシステムのレベルは、上げることのみが可能です。 +.Bl -tag -width indent +以下の 3 レベルが定義されています。 +.It 0 +ファイルシステムは、旧フォーマットです (静的テーブル)。 +.It 1 +ファイルシステムは、新フォーマットです (動的テーブル)。 +.It 2 +ファイルシステムは 32 ビットの UID と GID を用い、 +短いシンボリックリンクは inode 内へ格納し、 +ディレクトリはファイルタイプを示す追加フィールドを持ちます。 +.El +.Pp +対話モードでは、 +.Nm fsck +は、変換の内容を表示して、実際に変換するかどうかを問い合わせます。 +no と答えると、ファイルシステムへのそれ以上の操作は行われません。 +preen モード ( +.Fl p +オプション) では、変換内容を表示しますが、変換が可能なら +ユーザへの問い合わせなしに実行します。 +preen モードでの変換は、すべてのファイルシステムを一度に +変換してしまう場合に便利です。 +ファイルシステムのフォーマットは、 +.Xr dumpfs 8 +の出力の最初の行から決定することができます。 +.El +.Pp +ファイルシステムを指定せずに +.Nm fsck +を実行すると +.Pa /etc/fstab +ファイルから読み込まれたファイルシステムのリストが対象になります。 +.Pp +.Bl -enum -indent indent -compact +ファイルシステムは、以下の点について検査されます。 +.It +二つ以上の inode やフリーマップにより使用されているブロック +.It +ファイルシステム領域外の inode により使用されているブロック +.It +不正なリンクカウント +.It +サイズのチェック: +.Bl -item -indent indent -compact +.It +サイズが DIRBLKSIZ の倍数でないディレクトリ +.It +切り詰め (truncate) が部分的に行われているファイル +.El +.It +不正な inode フォーマット +.It +どこにも登録されていないブロック +.It +ディレクトリのチェック: +.Bl -item -indent indent -compact +.It +割り当てされていない inode を指すファイル +.It +範囲外の inode 番号 +.It +ディレクトリ内の穴 +.It +最初の 2 つのエントリが `.' と `..' でないか、 +不正な inode 番号を持つディレクトリ +.El +.It +スーパーブロックのチェック: +.Bl -item -indent indent -compact +.It +ファイルシステムにあるよりも多い inode ブロック数 +.It +不正なフリーブロックマップフォーマット +.It +フリーブロックやフリー inode の総数の誤り +.El +.El +.Pp +親ディレクトリの無いファイルやディレクトリ (割り当て +られているが参照されていない) は、 +オペレータへの問い合わせのあとで +.Pa lost+found +ディレクトリへ配置されます。 +その際のファイル名は inode 番号になります。 +.Pa lost+found +ディレクトリが存在しない場合、新たに作成されます。 +スペースが不足している場合は、そのサイズが拡張されます。 +.Pp +ブロックデバイスとバッファキャッシュの内容は一致しないかもしれないので、 +必ずロー (raw) デバイスを指定してください。 +.Sh 関連ファイル +.Bl -tag -width /etc/fstab -compact +.It Pa /etc/fstab +チェックを行なうファイルシステムのデフォルトリストを含む +.El +.Sh 診断 +.Nm fsck +の出す診断メッセージは、 +.Rs +.%T "Fsck \- The UNIX File System Check Program" +.Re +の Appendix A にすべて列挙され説明されています。 +.Sh 関連項目 +.Xr fs 5 , +.Xr fstab 5 , +.Xr newfs 8 , +.Xr reboot 8 diff --git a/ja_JP.eucJP/man/man8/fsdb.8 b/ja_JP.eucJP/man/man8/fsdb.8 new file mode 100644 index 0000000000..42b9bf2c41 --- /dev/null +++ b/ja_JP.eucJP/man/man8/fsdb.8 @@ -0,0 +1,248 @@ +.\" %NetBSD: fsdb.8,v 1.2 1995/10/08 23:18:08 thorpej Exp % +.\" +.\" Copyright (c) 1995 John T. Kohl +.\" 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. 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: fsdb.8,v 1.3.2.1 1997/03/03 07:01:25 mpp Exp % +.\" jpman %Id: fsdb.8,v 1.3 1997/06/23 15:01:41 horikawa Stab % +.\" +.Dd September 14, 1995 +.Dt FSDB 8 +.Os FreeBSD +.Sh 名称 +.Nm fsdb +.Nd FFS デバッグ/編集ツール +.Sh 書式 +.Nm +.Op Fl d +.Op Fl f +.Ar fsname +.Sh 解説 +.Nm +は +.Ar fsname +(通常は raw ディスクパーティション) を open し、そのファイルシステムの +inode データを操作するためのコマンドを受け付けます。コマンドは +.Ic "fsdb (inum X)>" +のプロンプトに対して入力します。ここでの +.Va X +は現在選択されている i-number となります。最初に選択されている inode +はファイルシステムのルート (i-number 2) となります。 +コマンドプロセッサには +.Xr libedit 3 +ライブラリを使用しており、コマンド行を編集することによってタイピングの +量を減らすことができます。 +コマンドループから抜けて終了する時には、ファイルシステムのスーパブロック +が dirty とマークされ、バッファリングされているブロックがあれば +ファイルシステムに書き込まれます。 +.Pp +.Fl d +オプションを指定すると、デバッグ情報 (元は +.Xr fsck 8 +のコードに由来するもの) を出力します。 +.Pp +.Fl f +オプションは歴史的な理由により残されているもので、特に意味は持ちません。 +.Sh コマンド +組み込みの +.Xr libedit 3 +のコマンドの他に +.Nm +は以下のコマンドをサポートしています: +.Pp +.Bl -tag -width indent -compact +.It Cm help +入力できるコマンドのリストを表示します。 +.Pp +.It Cm inode Ar i-number +新しい現在の inode として +inode +.Ar i-number +を選択します。 +.Pp +.It Cm back +以前の inode に戻ります。 +.Pp +.It Cm clri +現在の inode をクリアします。 +.Pp +.It Cm lookup Ar name +.It Cm cd Ar name +.Ar name +を現在のディレクトリの中で探し、その inode を現在の inode に設定します。 +.Ar name +はマルチコンポーネントの名前か、スラッシュで始めて検索をルートの inode +から始めることを指定できます。パス名の中のコンポーネントが見 +つからない場合、最後に有効であったディレクトリがアクティブな inode と +して使われます。 +.br +このコマンドは開始する inode がディレクトリの場合のみ有効です。 +.Pp +.It Cm active +.It Cm print +アクティブな inode を表示します。 +.Pp +.It Cm uplink +アクティブな inode のリンク数をインクリメントします。 +.Pp +.It Cm downlink +アクティブな inode のリンク数をデクリメントします。 +.Pp +.It Cm linkcount Ar number +アクティブな inode のリンク数を +.Ar number +に設定します。 +.Pp +.It Cm ls +現在の inode のディレクトリエントリをリストします。このコマンドは現在 +の inode がディレクトリである場合のみ有効です。 +.Pp +.It Cm rm Ar name +.It Cm del Ar name +現在のディレクトリ inode からエントリ +.Ar name +を取り除きます。このコマンドは現在の inode がディレクトリで +ある場合のみ有効です。 +.Pp +.It Cm ln Ar ino Ar name +現在のディレクトリ inode に +inode +.Ar ino +へのリンクを +.Ar name +の名前で作成します。このコマンドは現在の inode がディレクトリである場 +合のみ有効です。 +.Pp +.It Cm chinum Ar dirslot Ar inum +ディレクトリエントリ +.Ar dirslot +中の i-number を +.Ar inum +に変更します。 +.Pp +.It Cm chname Ar dirslot Ar name +ディレクトリエントリ +.Ar dirslot +中の名前を +.Ar name +に変更します。 +このコマンドではディレクトリエントリを拡張することはできません。名前が +現在存在するディレクトリスロットに収まる場合にのみ、エントリの名前の変 +更が可能です。 +.Pp +.It Cm chtype Ar type +現在の inode のタイプを +.Ar type +に変更します。 +.Ar type +には +.Em file , +.Em dir , +.Em socket , +.Em fifo +のいずれかが指定できます。 +.Pp +.It Cm chmod Ar mode +現在の inode のモードビットを +.Ar mode +に変更します。 +このサブコマンドではファイルのタイプを変更することはできません。その場 +合は +.Ic chtype +を使ってください。 +.Pp +.It Cm chflags Ar flags +現在の inode のファイルフラグを +.Ar flags +に変更します。 +.Pp +.It Cm chown Ar uid +現在の inode のオーナを +.Ar uid +に変更します。 +.Pp +.It Cm chgrp Ar gid +現在の inode のグループを +.Ar gid +に変更します。 +.Pp +.It Cm chgen Ar gen +現在の inode の世代番号 (generation number) を +.Ar gen +に変更します。 +.Pp +.It Cm mtime Ar time +.It Cm ctime Ar time +.It Cm atime Ar time +それぞれ、現在の inode の修正時間、変更時間、アクセス時間を +.Ar time +に変更します。 +.Ar time +は +.Em YYYYMMDDHHMMSS[.nsec] +の形式でなければなりません。ここで、 +.Em nsec +はオプションで指定できるナノ秒の値となります。もし、ナノ秒が指定されて +いないと、 +.Va mtimensec , +.Va ctimensec , +.Va atimensec +のそれぞれのフィールドにはゼロがセットされます。 +.Pp +.It Cm quit, Cm q, Cm exit, Em <EOF> +プログラムを終了します。 +.El +.Sh 関連項目 +.Xr libedit 3 , +.Xr fs 5 , +.Xr clri 8 , +.Xr fsck 8 +.Sh バグ +``short'' のシンボリックリンクの操作は動作しません。(特に、 +シンボリックリンクのタイプは変更しないでください。) +.br +モードはシンボル名ではなく数字で指定してください。 +.br +多分 +.Nm +に実装されていないことで、もっとやりたいことが沢山あるでしょう。 +.br +.Xr libedit 3 +のリファレンスページはまだ書かれていません。 +.Sh 歴史 +.Nm +は +.Xr fsck 8 +のソースコードを使ってファイルシステムの操作のコードのほとんどを実装し +ています。 +.Nm +の残りの部分は NetBSD において John T. Kohl によって最初に書かれました。 +.br +FreeBSD へは Peter Wemm によって移植されました。 +.Sh 警告 +このツールは最大限に注意を払って使って下さい。 +.Xr fsck 8 +を使っても修復できないほど FFS ファイルシステムを壊す恐れがあります。 diff --git a/ja_JP.eucJP/man/man8/fsinfo.8 b/ja_JP.eucJP/man/man8/fsinfo.8 new file mode 100644 index 0000000000..4d44c9ff3a --- /dev/null +++ b/ja_JP.eucJP/man/man8/fsinfo.8 @@ -0,0 +1,77 @@ +.\" Copyright (c) 1993 Jan-Simon Pendry. +.\" 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. +.\" +.\" 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. +.\" +.\" @(#)fsinfo.8 8.1 (Berkeley) 6/28/93 +.\" jpman %Id: fsinfo.8,v 1.2 1997/06/06 10:17:38 bobson Stab % +.\" +.Dd June 28, 1993 +.Dt FSINFO 8 +.Os +.Sh 名称 +.Nm fsinfo +.Nd サイト規模 (サイト単位) のファイルシステム情報の管理 +.Pp +.Sh 書式 +.Nm \&fsinfo +.Op Fl v +.Op Fl a Ar autodir +.Op Fl b Ar bootparams +.Op Fl d Ar dumpsets +.Op Fl e Ar exports +.Op Fl f Ar fstabs +.Op Fl h Ar hostname +.Op Fl m Ar automounts +.Op Fl I Ar dir +.Op Fl D Ar string[=string]] +.Op Fl U Ar string[=string]] +.Ar config ... +.Sh 解説 +.Nm fsinfo +は、システム設定ファイルを読み込んで、 +.Nm amd +、 +.Nm mount +、 +.Nm mountd +の管理情報 (設定ファイル) を生成します。 +.Pp +.Nm fsinfo +コマンドの詳細は、Amd --- The 4.4BSD Automounter に記述されています。 +.Pp +.Sh 関連項目 +.Xr amd 8 , +.Xr mount 8 , +.Xr mountd 8 +.Pp +.Sh 歴史 +.Nm +は 4.4BSD で追加されました。 diff --git a/ja_JP.eucJP/man/man8/fsirand.8 b/ja_JP.eucJP/man/man8/fsirand.8 new file mode 100644 index 0000000000..9d46eae9ee --- /dev/null +++ b/ja_JP.eucJP/man/man8/fsirand.8 @@ -0,0 +1,114 @@ +.\" Copyright (c) 1997 Todd C. Miller <Todd.Miller@courtesan.com> +.\" 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 Todd C. Miller. +.\" 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 ``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. +.\" +.\" $OpenBSD: fsirand.8,v 1.6 1997/02/23 03:58:26 millert Exp $ +.\" %Id: fsirand.8,v 1.3.2.3 1997/06/16 06:57:42 max Exp % +.\" jpman %Id: fsirand.8,v 1.3 1997/09/08 07:26:22 kuma Stab % +.\" +.Dd January 25, 1997 +.Dt FSIRAND 8 +.Os +.Sh 名称 +.Nm fsirand +.Nd inode 世代番号をランダム化する +.Sh 書式 +.Nm fsirand +.Op Fl b +.Op Fl f +.Op Fl p +.Ar special +.Op Ar "special ..." +.Sh 解説 +.Nm fsirand +コマンドは、コマンドラインにて +.Ar special +で指定したファイルシステム上の全ての inode に対し、 +ランダムな世代番号を書き込みます。 +これにより、ファイルハンドルを ``予測'' しにくくし、 +NFS export したファイルシステムのセキュリティを向上させます。 +.Pp +.Em 注: +現在 +.Xr newfs 8 +が +.Nm +と同等の処理を行うため、新規ファイルシステムに対し手動で +.Nm +を実行する必要は有りません。 +用途は、 +既存のファイルシステムを再びランダム化することか、 +そこからレポートを得ることだけです。 +.Pp +.Nm fsirand +は、アンマウントした後 +.Xr fsck 8 +にてチェックしたファイルシステムか、 +リードオンリーにてマウントしたファイルシステムのみに適用すべきです。 +.Nm fsirand +をシングルユーザモードにてルートファイルシステムに適用できますが、 +その後システムを ``reboot -n'' にてリブートしなければなりません。 +.Sh オプション +.Bl -tag -width indent +以下のオプションを使用可能です: +.It Fl b +ディスクラベルから得たブロックサイズではなく、 +デフォルトのブロックサイズ(通常 512 バイト)を使用します。 +.It Fl f +.Ar special +がクリーンとマークされていなくとも、 +.Nm +を強制的に実行します。 +.It Fl p +新たな世代番号を生成するのではなく、 +全ての inode に対して現在の世代番号を表示します。 +.Sh 警告 +.Nm +はシリンダグループ中の全ての inode を保持できるだけの量のメモリを確保するため、 +シリンダグループが少ない大きなディスクにおいては大量のメモリを消費する +可能性があります。 +.Sh 関連項目 +.Xr fs 5 , +.Xr fsck 8 , +.Xr newfs 8 . +.Sh 歴史 +.Nm +コマンドは SunOS 3.x から登場しました。 +.br +このバージョンの +.Nm +は +.Ox 2.1 +から登場しました。 +.Tn FreeBSD +のものは +.Fx 2.2.5 +から登場しました。 +.Sh 作者 +.nf +Todd C. Miller <Todd.Miller@courtesan.com> +.fi diff --git a/ja_JP.eucJP/man/man8/ft.8 b/ja_JP.eucJP/man/man8/ft.8 new file mode 100644 index 0000000000..78ca1b548e --- /dev/null +++ b/ja_JP.eucJP/man/man8/ft.8 @@ -0,0 +1,93 @@ +.\" Copyright (c) 1980, 1989, 1991 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. +.\" +.\" 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. +.\" +.\" @(#)ft.8 +.\" jpman %Id: ft.8,v 1.3 1997/08/20 11:58:37 horikawa Stab % +.\" +.Dd February 7, 1994 +.Dt FT 8 +.Os BSD 4 +.Sh 名称 +.Nm ft +.Nd QIC 40/80 フロッピテープドライブコントローラ +.Sh 書式 +.Nm ft +.Op Fl f Ar tape +.Op Ar description +.Sh 解説 +.Nm ft +コマンドはあらかじめフォーマットされている QIC-40/80 テープに対する、 +マルチボリュームのダンプ、抽出、テープラベルの閲覧を行ないます。 +これは完全にシステム依存であり、QIC 標準とは無関係です。 +.Pp +.Nm ft +はおもにテープ I/O のフィルターとして使われます。 +例えば、 +.Pa /usr +ディレクトリをテープに圧縮して保存するには、以下のように入力します。 +.Bd -literal -offset indent +% tar cvzf - /usr | ft "/usr save" +.Ed +.Pp +テープから /usr を取り出すには、以下のように入力します。 +.Bd -literal -offset indent +% ft | tar xvzf - +.Ed +.\" .Sh 関連項目 +.\" .Xr qtar 1 +.Sh バグ +フォーマットとベリファイ機能については作業中です。 +現在これらを行なうには、今あるバックアッププログラムを使う必要があるでしょう。 +.Sh 注釈 +フロッピーテープドライバは、 +Colorado Jumbo、Mountain Summit Express やいくつかの Archive/Conner モデル、 +またおそらくその他のものもサポートしています。 +これらのテープドライブはフロッピディスクコントローラカードと +フロッピディスクのリボンケーブルの間に接続されます。 +現在のところこのドライバは、 +専用のテープコントローラカードやパラレルポートをサポートしていません。 +.Pp +QIC-40/80 ドライブは SCSI ドライブに比べ CPU に負荷がかかります。 +マシンがネットワークに接続されていたり、 +複数のユーザが同時に作業していたりする場合は、 +QIC-40/80 ドライブは単なる 1 つの負荷の要素に過ぎません。 +個人ユースでは (すなわち典型的なホーム Unix ユーザ)、 +応答時間は完全に許容できるものです。 +テープドライブは書き込みエラーを検出できません。 +そのかわりに、CRC やエラー訂正や不良箇所マッピングを使用しています。 +そのため、フォーマット時間は非常に長くなります。 +ドライブは最初のパスでテープ全体にセクタを書いていきます。 +そして、2 番目のパスを (感度をよくするために) 通常より遅いレートにして、 +テープの不良箇所を検出します。 +通常、1 本の QIC-80 テープ (120Mb 圧縮なし) をフォーマットするには +1 時間かかります。 +.Sh 作者 +Steve Gerakines <steve2@genesis.nred.ma.us> diff --git a/ja_JP.eucJP/man/man8/ftpd.8 b/ja_JP.eucJP/man/man8/ftpd.8 new file mode 100644 index 0000000000..ba1ed0341c --- /dev/null +++ b/ja_JP.eucJP/man/man8/ftpd.8 @@ -0,0 +1,455 @@ +.\" Copyright (c) 1985, 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. +.\" +.\" 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. +.\" +.\" @(#)ftpd.8 8.2 (Berkeley) 4/19/94 +.\" jpman %Id: ftpd.8,v 1.3 1997/09/08 07:23:46 kuma Stab % +.\" %Id: ftpd.8,v 1.9.2.8 1997/05/10 19:48:12 davidn Exp % +.\" +.Dd April 19, 1994 +.Dt FTPD 8 +.Os BSD 4.2 +.Sh 名称 +.Nm ftpd +.Nd +インターネットファイル転送プロトコルサーバ +.Sh 書式 +.Nm ftpd +.Op Fl dl +.Op Fl D +.Op Fl R +.Op Fl S +.Op Fl U +.Op Fl T Ar maxtimeout +.Op Fl t Ar timeout +.Op Fl a Ar address +.Op Fl p Ar file +.Sh 解説 +.Nm ftpd +は、インターネットファイル転送プロトコルサーバプロセスです。 +このサーバは +.Tn TCP +プロトコルを用いて、 +.Dq ftp +サービスに割り当てられたポートを listen() します。 +.Dq ftp +サービスについては、 +.Xr services 5 +を参照して下さい。 +.Pp +利用可能なオプションは以下の通りです: +.Bl -tag -width Ds +.It Fl d +syslog の LOG_FTP のファシリティ (facility) を用いてデバッグ情報を出力します。 +.It Fl l +.Xr ftp 1 +セッションそれぞれの結果を、成功も失敗もともども +syslog の LOG_FTP のファシリティを用いて +ログに残します。このオプションが 2 回指定されると、 +retrieve (get), store (put), append, delete, +make directory, remove directory, rename の各操作およびそれらの引数で指定された +ファイル名も記録されます。 +注意: LOG_FTP メッセージはデフォルトでは +.Xr syslogd 8 +によって表示されません。場合によっては +.Xr syslogd 8 Ns +のコンフィギュレーションファイルでそれを有効にしなければなりません。 +.It Fl D +このオプションがセットされると、 +.Nm ftpd +は制御端末を切り離してデーモンとなり、 +FTP ポートへの接続要求を待ち、 +子プロセスを生成して接続要求に対応します。 +この方式は +.Nm ftpd +を +.Xr inetd 8 +から起動するよりオーバヘッドが少ないため、 +処理量の多いサーバで負荷を低減するのに役立ちます。 +.It Fl R +このオプションがセットされると、 +.Nm ftpd +は、ユーザ操作のセキュリティチェックや PORT 要求の制限に関して +古き良き時代の振る舞いに戻ります。 +現在では、 +.Nm ftpd +はリモートユーザのホストの非特権ポートに向けられた PORT コマンド +だけを用います (これは FTP プロトコルの仕様に違反していますが、 +いくつかのセキュリティホールを閉じることができます)。 +.It Fl S +このオプションがセットされると、 +.Nm ftpd +は匿名 (anonymous) による転送の全てについてのログを、ファイル +.Pa /var/log/ftpd +が存在する場合に限り、このファイルに残します。 +.It Fl U +以前のバージョンの +.Nm ftpd +では、パッシブモードのクライアントがサーバにデータ接続を要求すると、 +サーバは 1024 〜 4999 の範囲のデータポートを使用していました。 +現在のバージョンでは、サーバはデフォルトでは 40000 〜 44999 の範囲の +データポートを使用しますが、 +このオプションを指定することにより、以前の振る舞いに戻ります。 +.It Fl T +クライアントは異なったタイムアウト秒数を要求することもできます。 +.Fl T +オプションにより、 +.Ar タイムアウト +までの最大待ち時間を設定できます。 +デフォルトは 2 時間です。 +.It Fl t +何も操作しないで放置した場合のタイムアウト時間を +.Ar timeout +秒に設定します (デフォルトは 15 分)。 +.It Fl a +.Fl D +オプションが指定されている場合、 +.Ar address +で指定されたアドレスに対する接続のみを許可します。 +.It Fl p +.Fl D +オプションが指定されている場合、 +デーモンのプロセス ID を +.Ar file +に書き出します。 +.It Fl A +匿名 ftp アクセスのみ許可します。 +.El +.Pp +ファイル +.Pa /etc/nologin +は、ftp アクセスを拒否するのに使うことができます。 +このファイルが存在する場合、 +.Nm +はそのファイルの内容を表示して終了します。 +.Pa /etc/ftpwelcome +ファイルが存在する場合、 +.Nm +は +.Dq ready +メッセージを表示する前にその内容を表示します。 +もし +.Pa /etc/ftpmotd +ファイルが存在する場合、 +ログイン成功後に +.Nm +はその内容を出力します。 +.Pp +この ftp サーバは、現在、以下の ftp リクエストをサポートしています。 +リクエストの文字の大文字小文字の区別は無視されます。 +.Bl -column "Request" -offset indent +.It リクエスト Ta "説明" +.It ABOR Ta "abort previous command" +.It ACCT Ta "specify account (ignored)" +.It ALLO Ta "allocate storage (vacuously)" +.It APPE Ta "append to a file" +.It CDUP Ta "change to parent of current working directory" +.It CWD Ta "change working directory" +.It DELE Ta "delete a file" +.It HELP Ta "give help information" +.It LIST Ta "give list files in a directory" Pq Dq Li "ls -lgA" +.It MKD Ta "make a directory" +.It MDTM Ta "show last modification time of file" +.It MODE Ta "specify data transfer" Em mode +.It NLST Ta "give name list of files in directory" +.It NOOP Ta "do nothing" +.It PASS Ta "specify password" +.It PASV Ta "prepare for server-to-server transfer" +.It PORT Ta "specify data connection port" +.It PWD Ta "print the current working directory" +.It QUIT Ta "terminate session" +.It REST Ta "restart incomplete transfer" +.It RETR Ta "retrieve a file" +.It RMD Ta "remove a directory" +.It RNFR Ta "specify rename-from file name" +.It RNTO Ta "specify rename-to file name" +.It SITE Ta "non-standard commands (see next section)" +.It SIZE Ta "return size of file" +.It STAT Ta "return status of server" +.It STOR Ta "store a file" +.It STOU Ta "store a file with a unique name" +.It STRU Ta "specify data transfer" Em structure +.It SYST Ta "show operating system type of server system" +.It TYPE Ta "specify data transfer" Em type +.It USER Ta "specify user name" +.It XCUP Ta "change to parent of current working directory (deprecated)" +.It XCWD Ta "change working directory (deprecated)" +.It XMKD Ta "make a directory (deprecated)" +.It XPWD Ta "print the current working directory (deprecated)" +.It XRMD Ta "remove a directory (deprecated)" +.El +.Pp +以下に示した非標準コマンドあるいは +.Tn UNIX +に特有のコマンドが、SITE リクエストでサポートされています。 +.Pp +.Bl -column Request -offset indent +.It Sy リクエスト Ta Sy 説明 +.It UMASK Ta change umask, e.g. ``SITE UMASK 002'' +.It IDLE Ta set idle-timer, e.g. ``SITE IDLE 60'' +.It CHMOD Ta change mode of a file, e.g. ``SITE CHMOD 755 filename'' +.It HELP Ta give help information. +.El +.Pp +Internet RFC 959 で規定されている ftp リクエストのうちの、これ以外のものは +解釈はされますがインプリメントされていません。 +MDTM および SIZE は RFC 959 では規定されていませんが、次に改訂される +FTP RFC には登場するでしょう。 +.Pp +ftp サーバがアクティブなファイル転送を中断するのは、ABOR コマンドの前に、 +Telnet "Interrupt Process" (IP) シグナルか +Telnet "Synch" シグナルが Telnet ストリーム内にある場合だけです。 +これは Internet RFC 959 に記述されています。 +もし、データの転送中に +STAT +コマンドを受けとり、その前に Telnet IP や Synch +があった場合、転送ステータスが返されます。 +.Pp +.Nm ftpd +は、 +.Xr csh 1 +で使われているファイル名展開を解釈します。これにより、 +ユーザはメタキャラクタ +.Dq Li \&*?[]{}~ +を利用できます。 +.Pp +.Nm ftpd +は、5 つのルールに従ってユーザの認証を行います。 +.Pp +.Bl -enum -offset indent +.It +ログイン名はパスワードデータベース +になければならず、空のパスワードであってはいけません。 +この場合、あらゆるファイルの操作に先だって、クライアント側からパスワードが +提供されていなければなりません。ユーザが S/Key のキーを持っている場合は、 +USER コマンドが成功した際の応答には S/Key チャレンジを含めて送られます。 +クライアントは、それに対して PASS コマンドを使って応答する際に、 +通常のパスワードか S/Key のワンタイムパスワードのどちらをつけて応答 +するかを選択できます。サーバはどちらのパスワードを受け取ったかを自動的に +判定し、それに応じて認証を試みます。S/Key の認証に関する詳細は +.Xr key 1 +を参照して下さい。S/Key は Bellcore 社の商標です。 +.It +ログイン名はファイル +.Pa /etc/ftpusers +に載っていてはいけません。 +.It +ログイン名はファイル +.Pa /etc/ftpusers +で指定されているグループのメンバであってはいけません。 +このファイルでグループ名として解釈されるエントリの先頭には +アットマーク +.Ql \&@ +が付きます。 +.It +ユーザは +.Xr getusershell 3 +が返す標準のシェルを持っていなければなりません。 +.It +ユーザ名がファイル +.Pa /etc/ftpchroot +に載っているか、そのファイルにあるグループエントリ (つまり +.Ql \&@ +で始まるエントリ) のメンバである場合、アカウント +.Dq anonymous +や +.Dq ftp +と同様、 +.Xr chroot 2 +によって、 +そのセッションのルートディレクトリが +ユーザのログインディレクトリに変ります (次の項目を参照して下さい)。 +この機能は、 +.Xr login.conf 5 +でブール型フラグ "ftp-chroot" をオンにしても有効になります。 +しかし、ユーザは依然、パスワードを与える必要があります。 +この特徴は、完全に匿名 (anonymous) なアカウントと +完全な特権のあるアカウントの間での妥協的な利用のためのものです。 +このアカウントは匿名アカウントで設定するのと同様に設定されていなければ +なりません。 +.It +もしユーザ名が +.Dq anonymous +または +.Dq ftp +の場合は、匿名の ftp アカウントがパスワードファイル (ユーザ +.Dq ftp +) で提供されていなければなりません。 +この場合、ユーザはどのようなパスワードでもログインを許可されます (慣習としては +ユーザの email アドレスをパスワードとして用いることになっています)。 +.Fl S +オプションがセットされていると、全ての転送操作も記録されます。 +.El +.Pp +最後のケースの場合、 +.Nm ftpd +は特別な手段でクライアントのアクセス権を制限します。 +サーバは +.Dq ftp +ユーザのホームディレクトリへ +.Xr chroot 2 +します。 +システムのセキュリティが侵害されないために、 +.Dq ftp +サブツリーは、以下の規則に従って慎重に構築することを推奨します。 +.Bl -tag -width "~ftp/pub" -offset indent +.It Pa ~ftp +ホームディレクトリは +.Dq root +の所有とし、誰も書き込みできないようにします。 +.It Pa ~ftp/bin +このディレクトリは +.Dq root +の所有とし、誰も書き込みできないようにします (モード 555)。 +list コマンドのサポートのため、ここに +.Xr ls 1 +プログラムを置くことが必要です。 +このプログラムのモードは 111 とすべきです。 +.It Pa ~ftp/etc +このディレクトリは +.Dq root +の所有とし、誰も書き込みできないようにします (モード 555)。 +.Xr ls +が所有者を数字でなく名前で表示できるようにするために、 +ファイル pwd.db ( +.Xr passwd 5 参照) 及び +.Xr group 5 +が必要です。 +ファイル +.Xr passwd +中のパスワードは使用されませんので、本当のパスワードを入れてはいけません。 +ファイル +.Pa ftpmotd +が存在すると、ログイン成功後、その内容が表示されます。 +このファイルのモードは 444 とすべきです。 +.It Pa ~ftp/pub +このディレクトリのモードは 777、所有者は +.Dq ftp +とします。 +ゲストユーザは、このディレクトリ中にあって匿名アカウントで +アクセス可能なファイルをアクセスします。 +.El +.Pp +システムに複数の IP アドレスがある場合、 +.Nm ftpd +は仮想ホストの概念をサポートします。 +仮想ホストは、複数の匿名 ftp 領域それぞれを別々のインターネットアドレス +に割り当てる機能を提供します。 +ファイル +.Pa /etc/ftphosts +は各仮想ホストに関連した情報を保持します。 +各ホストはそれぞれの行で定義され、 +各行は空白で区切ったいくつかのフィールドからなります: +.Bl -tag -offset indent -width hostname +.It hostname +仮想ホストのホスト名あるいは IP アドレス。 +.It user +システムのパスワードファイル中のユーザレコードを含みます。 +普通の匿名 ftp と同様に、このユーザのアクセス UID, GID および +グループによって匿名 ftp 領域のファイルアクセス権が決まります。 +匿名 ftp 領域 (ログイン時にユーザが chroot するディレクトリ) は、 +そのアカウントに対するホームディレクトリとして決定されます。 +他の ftp アカウントのユーザ ID およびグループも、 +標準 ftp ユーザと同じであって構いません。 +.It statfile +全てのファイル転送のログが記録されるファイル。デフォルトでは +.Pa /var/log/ftpd +です。 +.It welcome +サーバがプロンプトを出す前に表示される welcome メッセージ。デフォルトでは +.Pa /etc/ftpwelcome +です。 +.It motd +このファイル内容はユーザがログインした後に表示されます。デフォルトでは +.Pa /etc/ftpmotd +です。 +.El +.Pp +プライマリ IP アドレスあるいはホスト名に対する仮想ホストを定義すると、 +そのアドレスへの ftp ログインのデフォルト値が変更されます。 +'user', 'statfile', 'welcome', 'motd' の各フィールドは +デフォルト値を用いる場合、ブランクのままもしくはハイフン一つ '-' と +しても構いません。 +.Pp +いかなる匿名ログインの設定についても言えることですが、 +設定と保守には十分に注意を払い、セキュリティ上の問題をきたさないよう +防御しなければなりません。 +.Pp +.Em INTERNAL_LS +オプションをつけてコンパイルすると、 +.Nm ftpd +はリモートからのファイル一覧表示要求に対応するための内部サポートを用意し、 +chroot された環境でもそれ以外でも +.Pa /bin/ls +を実行しなくなります。 +この場合、 +.Pa ~/bin/ls +の実行形式ファイルは chroot されたディレクトリになくてよく、 +.Pa ~/bin +ディレクトリも存在する必要はありません。 +このサポートは、 +.Pa /etc/make.conf +あるいはシェルの環境で +.Em FTP_INTERNAL_LS +変数を設定して ftpd を作成することで追加されます。 +.Sh 関連ファイル +.Bl -tag -width /etc/ftpwelcome -compact +.It Pa /etc/ftpusers +歓迎されない/制限を受けるユーザおよびグループのリスト。 +.It Pa /etc/ftpchroot +chroot される一般ユーザのリスト。 +.It Pa /etc/ftpwelcome +welcome メッセージ。 +.It Pa /etc/ftpmotd +login 後の welcome メッセージ。 +.It Pa /etc/nologin +内容を表示し、アクセスを拒否します。 +.It Pa /var/log/ftpd +匿名による転送のログファイル。 +.El +.Sh 関連項目 +.Xr ftp 1 , +.Xr key 1 , +.Xr getusershell 3 , +.Xr login.conf 5 , +.Xr inetd 8 , +.Xr syslogd 8 +.Sh バグ +特権ポート番号を用いてソケットを作成するために、 +ftpd はスーパーユーザの権限で実行させて下さい。 +サーバはログインユーザの実効ユーザ ID を保持しておき、 +アドレスをソケットにバインドする場合にのみスーパユーザの権限を使います。 +考えられるセキュリティホールについてはかなり詳細にわたって調べ込みをおこないましたが、 +それでも不完全かもしれません。 +.Sh 歴史 +.Nm +コマンドは +.Bx 4.2 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/getty.8 b/ja_JP.eucJP/man/man8/getty.8 new file mode 100644 index 0000000000..4dec3d58b1 --- /dev/null +++ b/ja_JP.eucJP/man/man8/getty.8 @@ -0,0 +1,124 @@ +.\" Copyright (c) 1980, 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. +.\" +.\" 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. +.\" +.\" from: @(#)getty.8 8.1 (Berkeley) 6/4/93 +.\" %Id: getty.8,v 1.4.2.2 1997/08/17 23:44:30 davidn Exp % +.\" jpman %Id: getty.8,v 1.3 1997/05/19 17:00:46 horikawa Stab % +.\" " +.Dd April 25, 1991 +.Dt GETTY 8 +.Os BSD 4 +.Sh 名称 +.Nm getty +.Nd 端末のモードを設定する +.Sh 書式 +.Nm getty +.Oo +.Ar type +.Op Ar tty +.Oc +.Sh 解説 +.Nm getty +プログラムは、 +.Xr init 8 +から呼ばれ、tty回線をオープンしたあと初期化 +し、ログイン名を読んで +.Xr login 1 +を起動します。 +.Pp +.Ar tty +は、端末にどの +.Pa /dev +のスペシャルデバイスファイルを使うかを指定します(例:``ttyh0'')。 +引数がないか +.Ql Fl +ならば、tty回線はファイルディスクリプタ0としてオープンされます。 +.Pp +.Ar type +は、 +.Nm getty +が端末回線を特別に扱うようにするために使われます。 +この +.Ar type +は、 +.Xr gettytab 5 +のデータベースのインデックスとして使われ、 +回線の特徴を決定します。引数が与えられないか、データベースにマッチする +テーブルがなければ、 +.Em default +テーブルが使われます。もし、 +.Pa /etc/gettytab +ファイルがなければ、システムのデフォルトが使われます。 +テーブルにより指示されれば、 +.Nm getty +は端末画面をクリアし、 +バナーヘッダを表示し、 +ログインプロンプトを表示します。通常、このプロンプトのなかに +システムのホスト名が含まれます。 +.Pp +.Nm getty +のデフォルトの行動は、大抵の場合、適当な +.Pa gettytab +テーブルを作成することによって、回避したり修正したりすることができます。 +.Pp +.Nm getty +はタイムアウト時間を設定することができます。これによって、 +ログイン名がすぐに入力されないような場合に、ダイアル回線を切断 +することができます。 +.Sh 診断 +.Bl -diag +.It "ttyxx: No such device or address." +.It "ttyxx: No such file or address." +.Xr ttys +ファイルのなかで有効にされていたターミナルがオープンできませんでした。 +必要な回線がシステムに設定されていなかったか、 +関係するデバイスがブート時のシステム設定の際に組み込まれなかったか、 +もしくは +.Pa /dev +にスペシャルファイルがありませんでした。 +.El +.Sh 関連ファイル +.Bl -tag -width /etc/gettytab -compact +.It Pa /etc/gettytab +端末設定データベース +.El +.Sh 関連項目 +.Xr login 1 , +.Xr ioctl 2 , +.Xr tty 4 , +.Xr gettytab 5 , +.Xr ttys 5 , +.Xr init 8 +.Sh 歴史 +.Nm getty +は +.At v6 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/ibcs2.8 b/ja_JP.eucJP/man/man8/ibcs2.8 new file mode 100644 index 0000000000..89e716d3b8 --- /dev/null +++ b/ja_JP.eucJP/man/man8/ibcs2.8 @@ -0,0 +1,65 @@ +.\" +.\" Copyright (c) 1995 Lyndon Nerenberg +.\" +.\" All rights reserved. +.\" +.\" This program is free software. +.\" +.\" 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. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``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 DEVELOPERS 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: ibcs2.8,v 1.2 1996/02/05 17:32:01 mpp Exp % +.\" jpman %Id: ibcs2.8,v 1.3 1997/09/08 08:46:54 kuma Stab % +.\" +.Dd November 27, 1995 +.Dt IBCS2 8 +.Os FreeBSD-Experimental +.Sh 名称 +.Nm ibcs2 +.Nd SCO および ISC バイナリのための iBCS2 ランタイムサポートをロードする +.Sh 書式 +.Nm ibcs2 +.Sh 解説 +.Nm +ユーティリティは iBCS2 互換プログラムの +カーネルランタイムサポートをロードします。 +本ランタイムサポートの範囲は iBCS2 システムコールインタフェースの +エミュレーションに限定されており、完全サポートには程遠いです。 +COFF バイナリおよび共有ライブラリはサポートされていますが、 +FreeBSD での配布には共有ライブラリは提供されていません。 +.Sh 関連ファイル +.Bl -tag -width /usr/share/examples/ibcs2/* -compact +.It Pa /lkm/ibcs2_mod.o +.It Pa /lkm/ibcs2_coff_mod.o +iBCS2 ローダブルカーネルモジュール。 +.Pp +.It Pa /usr/share/examples/ibcs2/* +エミュレータ検査用のサンプルオブジェクトファイル。 +.Sh 関連項目 +.Pa /sys/i386/ibcs2/README.iBCS2 , +.Xr modload 8 , +.Xr lkm 4 +.Sh バグ +エミュレータは全く不完全です。 +.Pp +動的にリンクされたバイナリを実行するにあたり、 +既存の SCO システムの共有ライブラリへのアクセスが不可欠です。 +.Pp +使用にあたりソースコードを読むことが不可欠です。 diff --git a/ja_JP.eucJP/man/man8/ifconfig.8 b/ja_JP.eucJP/man/man8/ifconfig.8 new file mode 100644 index 0000000000..44d578b9b1 --- /dev/null +++ b/ja_JP.eucJP/man/man8/ifconfig.8 @@ -0,0 +1,350 @@ +.\" Copyright (c) 1983, 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. +.\" +.\" 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. +.\" +.\" From: @(#)ifconfig.8 8.3 (Berkeley) 1/5/94 +.\" %Id: ifconfig.8,v 1.9.2.2 1997/06/30 11:01:59 peter Exp % +.\" jpman %Id: ifconfig.8,v 1.2 1997/03/31 14:09:47 horikawa Stab % +.\" +.Dd February 13, 1996 +.Dt IFCONFIG 8 +.Os BSD 4.2 +.Sh 名称 +.Nm ifconfig +.Nd ネットワークインタフェースのパラメータの設定を行なう +.Sh 書式 +.Nm ifconfig +.Ar interface address_family +.Oo +.Ar address +.Op Ar dest_address +.Oc +.Op Ar parameters +.Nm ifconfig +.Op Fl m +.Ar interface +.Op Ar protocol_family +.Nm ifconfig +.Fl a +.Op Fl m +.Op Fl d +.Op Fl u +.Op Ar protocol_family +.Nm ifconfig +.Fl l +.Op Fl d +.Op Fl u +.Sh 解説 +.Nm +は、ネットワークインタフェースに対してネットワークアドレス +の割り当てを行ない、ネットワークインタフェースのパラメータの設定を行ないます。 +.Nm +は、システム立ち上げ +時に、マシンが備える各ネットワークインタフェースに対してネットワークアドレス +を割り当てるように使用しなければなりません。また、一旦各ネットワークインタフェ +ースに対し設定したネットワークアドレスを再定義したり、パラメータの設定を +変えたりすることも可能です。 +.Pp +.Nm +のオペランドを以下に示します。 +.Bl -tag -width Ds +.It Ar Address +.Tn DARPA-Internet +ファミリでは、アドレスはホスト名データベース +.Xr hosts 5 +に登録されているホスト名であるか、もしくは +インターネット標準の +.Dq ドット表記 +です。 +.\" ゼロックスネットワークシステム(tm)ファミリでは、 +.\" アドレスは +.\" .Ar net:a.b.c.d.e.f +.\" という形式です。 +.\" ここで +.\" .Ar net +.\" は割り当てるネットワーク番号(10進数)、 +.\" 残りの +.\" .Ar a +.\" から +.\" .Ar f +.\" までは +.\" ホスト番号を表す 6 バイトであり 16 進数で指定します。 +.\" ホスト番号は 10Mb/s イーサネットインタフェースでは省略可能です。 +.\" ホスト番号指定を省略した場合には、 +.\" 一番目のインタフェースのハードウェア物理アドレスを +.\" すべてのインタフェースにおいて使用します。 +.\" .Tn ISO +.\" ファミリでは、 +.\" ゼロックスファミリと同じ長さのアドレスを、 +.\" 長い 16 進数の文字列で指定します。 +.\" 違いは、 +.\" ドットが続いた場合にはそのバイトはゼロを表すことと、 +.\" ドットはオプションであることです +.\" (ドットはネットワークバイトオーダの長い数字列を +.\" 注意深く扱うために使用します)。 +.It Ar address_family +他のパラメータの解釈に影響するネットワークアドレスファミリを指定します。 +インタフェースが異なるプロトコルの送信を異なる名前付け体系で +受けることがあるので、アドレスファミリを指定しておくことをお勧めします。 +本コマンドでサポートされるプロトコルファミリは、 +.Dq inet , +.Dq atalk , +.\".Dq iso , +.Dq ipx +.\" .Dq ns +です。 +.It Ar Interface +インタフェースパラメータは、 +.Dq name unit +の形式で表現されます。 +例えば +.Dq en0 +です。 +.El +.Pp +.Nm +では以下のパラメータが利用できます: +.Bl -tag -width dest_addressxx +.It Cm alias +指定したインタフェースに、ネットワークアドレスを追加して指定します。 +これはネットワーク番号を変更した際に、以前のアドレスに送られるパケットを +受けとりたい場合などに便利です。 +.It Cm arp +アドレス解決プロトコル (ARP) を用いてネットワークレベルのアドレスとリンクレベル +のアドレスの対応を取ることを可能にします (デフォルト)。この機能は、 +.Tn DARPA +インターネットアドレスと 10Mb/s イーサネットアドレスの間の対応を取るように +作られています。 +.It Fl arp +アドレス解決プロトコルの使用を禁止します。 +.It Cm broadcast +ネットワークに対するブロードキャストアドレスを指定します。 +ブロードキャストアドレスのデフォルト値は、 +ホスト部のビットがすべて 1 になったアドレスです。 +.It Cm debug +ドライバ依存のデバッグモードを有効にします。 +通常コンソールへのエラーログを有効にします。 +.It Fl debug +ドライバ依存のデバッグモードを無効にします。 +.It Cm delete +指定したネットワークアドレスを無効にします。本機能は、alias で不正なアドレスを +指定した場合や、すでに指定したアドレスが必要ない場合などに使用します。 +誤った NS アドレスをホスト部分とともに指定した場合には、 +NS アドレスを全て無効にすることにより再度ホスト部分を指定可能となります。 +.It Cm dest_address +point to point 接続を行なう場合、相手のアドレスを指定します。 +.It Cm down +指定したネットワークインタフェースに ``down'' とマークします。``down'' と +マークされたインタフェースに対しては、システムはメッセージの送信を行ない +ません。可能であれば、そのインタフェースは受信も不可能となるように +リセットされます。この動作は、そのインタフェースを用いる +ルーティングを使用しないよう自動的に設定するものではありません。 +.\" .It Cm ipdst +.\" リモートネットワーク向け NS パケットをカプセル化している IP パケットを +.\" 受信する、インターネットホストを指定するために使用します。 +.\" 外見上 point to point リンクが構成され、 +.\" 指定されたアドレスは、 +.\" デスティネーションの NS アドレスとネットワークアドレスとされます。 +.\" .Tn CLNP +.\" パケットの IP カプセル化はこれとは異なった方法で実現されます。 +.It Cm media Ar type +インタフェースのメディアタイプを +.Ar type +に設定します。 +インタフェースによっては、 +複数の異なった物理メディアコネクタのうちのいずれかを +排他的に使用することをサポートします。 +例えば、10Mb/s イーサネットインタフェースには +.Tn AUI +とツイストペアコネクタをサポートするものがあります。 +メディアタイプを +.Dq 10base5/AUI +に設定すると、AUI ポートを現在のアクティブなコネクタとします。 +また +.Dq 10baseT/UTP +に設定すると、ツイストペアをアクティブにします。 +使用可能なタイプの完全なリストは、 +インタフェースドライバ固有のマニュアルページを参照してください。 +.It Cm mediaopt Ar opts +インタフェースのメディアオプションを設定します。 +.Ar opts +はコンマで区切ったオプションリストで、インタフェースに適用されます。 +使用可能なオプションの完全なリストは、 +インタフェースドライバ固有のマニュアルページを参照してください。 +.It Fl mediaopt Ar opts +インタフェースのメディアオプションを無効にします。 +.It Cm metric Ar n +インタフェースのルーティングメトリックを +.Ar n +で指定します。初期値は 0 です。 +ルーティングメトリックは、ルーティングプロトコル +.Pq Xr routed 8 +で使用されます。 +.It Cm mtu Ar n +そのインタフェースの最大転送単位 (mtu) を +.Ar n +に設定します。デフォルト値はインタフェースに依存します。 +mtu はインタフェースに送られるパケットの大きさを制限するのに用いられます。 +mtu を設定できなかったり、設定出来る値の範囲に制限のある +インタフェースがあります。 +.It Cm netmask Ar mask +.\" (inet と ISO) +(inet のみ) +ネットワークをサブネットワークに細分割する際に、ネットワークアドレスとして +リザーブするアドレスを指定します。 +mask が指定する部分は、 +アドレスのネットワーク部とサブネット部です。 +サブネット部はアドレスのホスト部の一部です。 +mask は、0x ではじまる16進数、 +ドット表記のインターネットアドレス形式、 +ネットワークテーブル +.Xr networks 5 +に記述されている仮想ネットワーク名のいずれかで指定できます。 +mask での 32ビットアドレスにおける 1 であるビットの部分は、 +ネットワーク部もしくはサブネット部として使用します。 +0 であるビットの部分はホスト部として使用します。 +mask は少なくともネットワーク部を含む必要があり、 +サブネット部はネットワーク部に連続する必要があります。 +.\" see +.\" Xr eon 5 . +.\" .It Cm nsellength Ar n +.\" .Pf ( Tn ISO +.\" のみ) +.\" .Tn NSAP +.\" に後続するローカル識別に使用するバイト数を指定します。 +.\" この部分は +.\" .Tn NET +.\" (Network Entity Title) +.\" として扱われます。 +.\" バイト数のデフォルト値は 1 であり、US +.\" .Tn GOSIP +.\" 準拠です。 +.\" ifconfig コマンドで設定するISO アドレスが、 +.\" .Tn NSAP +.\" です。 +.\" 例えば +.\" .Tn US GOSIP +.\" では、20 文字の 16 進数を +.\" .Tn ISO NSAP +.\" において指定し、 +.\" インタフェースに割り当てる必要があります。 +.\" .Tn AFI +.\" 37 タイプアドレスにおいて、数字が 1 とは異なると便利であるのは、 +.\" それなりの理由があります。 +.\" .It Cm trailers +.\" trailers は、データ送出時の ``trailer'' リンクレベルパケットカプセル化を +.\" 要求します (デフォルト)。もしネットワークインタフェースが +.\" .Cm trailers +.\" をサポートしている場合、可能 +.\" であればシステムは、受信者によるメモリ間コピーの回数を最小になるように、 +.\" 出力メッセージのカプセル化を行ないます。アドレス解決プロトコル +.\" ( +.\" .Xr arp 4 +.\" 参照; 現在 10Mb/s イーサネットのみ) +.\" をサポートする +.\" ネットワーク上では、本フラグは、 +.\" 他のシステムが本ホストに対してメッセージを送出 +.\" する場合に trailers の処理をすることを要求することを示しています。 +.\" 同様に、trailer 要求を行ったホストに対しても、 +.\" trailer カプセル化したパケットを送出します。 +.\" これは現在インターネットプロトコルを用いている場合に限られます。 +.\" .It Fl trailers +.\" ``trailer'' リンクレベルカプセル化を無効にします。 +.It Cm link[0-2] +インタフェースのリンクレベルでの特殊な処理を有効にします。3 つのオプション +の実際の効果はインタフェース依存です。しかしながら、これらのオプションは、 +一般的には特殊なオペレーションモードを選択するのに用いられます。この例として、 +SLIP 使用時のデータ圧縮や、イーサネットカードのコネクタ選択を行います。 +各ドライバごとのマニュアルページに +詳細が記してあるので、詳しくはそちらの方を参照して下さい。 +.It Fl link[0-2] +上記の link[0-2] の指定を無効にします。 +.It Cm up +指定したネットワークインタフェースに ``up'' とマークします。 +本オプションは、 +``ifconfig down'' を行なった後にインタフェースを有効にするのに用いられます。 +最初にインタフェースにアドレスを設定した場合には、自動的に本指定はされたものと +して扱います。もし、down とマークされていたインタフェースがリセットされた場合、 +ハードウェアは再初期化されます。 +.El +.Pp +.Nm +は引数としてネットワークインタフェース以外に何のオプションも与えられない場合、 +ネットワークインタフェースの現在の設定状態を表示します。 +もしプロトコルファミリが指定されている場合、 +.Nm +はプロトコルファミリに特有の情報についてのみ表示します。 +.Pp +インタフェース名の前に +.Fl m +フラグが渡されると、 +.Nm +は、指定されたインタフェースに関し、 +サポートされているメディアを全て表示します。 +.Pp +オプションとして、インタフェース名の代りに +.Fl a +フラグを指定できます。そうすると、 +.Nm +はシステム上の全インタフェースを表示します。 +.Fl d +はこれを down したインタフェースに限定し、 +.Fl u +はこれは up したインタフェースに限定します。 +.Pp +The +.Fl l +フラグを使用するとシステム上の使用可能な全インタフェースのリストを、 +その他の情報は付加せずに表示します。 +このフラグは他のフラグとは排他的ですが、 +.Fl d +(down したインタフェースのみをリスト) +と +.Fl u +(up したインタフェースのみをリスト) +は例外です。 +.Pp +スーパユーザのみがネットワークインタフェースの設定を変更できます。 +.Sh 診断 +指定したインタフェースが存在しない、 +要求したアドレスが未知のものである、 +ユーザがネットワークインタフェースの設定を変更する権限を持っていない、 +といったメッセージを表示します。 +.Sh 関連項目 +.Xr netstat 1 , +.Xr netintro 4 , +.Xr rc 8 , +.Xr routed 8 +.\" .Xr eon 5 +.Sh 歴史 +.Nm +コマンドは +.Bx 4.2 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/inetd.8 b/ja_JP.eucJP/man/man8/inetd.8 new file mode 100644 index 0000000000..c78e2b0c4b --- /dev/null +++ b/ja_JP.eucJP/man/man8/inetd.8 @@ -0,0 +1,485 @@ +.\" Copyright (c) 1985, 1991, 1993, 1994 +.\" 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. +.\" +.\" 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. +.\" +.\" from: @(#)inetd.8 8.3 (Berkeley) 4/13/94 +.\" jpman %Id: inetd.8,v 1.2 1997/05/16 07:22:24 yugawa Stab % +.\" %Id: inetd.8,v 1.9.2.3 1997/09/22 06:23:24 charnier Exp % +.\" +.Dd February 7, 1996 +.Dt INETD 8 +.Os BSD 4.4 +.Sh 名称 +.Nm inetd +.Nd インターネット +.Dq スーパサーバ +.Sh 書式 +.Nm inetd +.Op Fl d +.Op Fl l +.Op Fl R Ar rate +.Op Fl a Ar address +.Op Fl p Ar filename +.Op Ar configuration file +.Sh 解説 +.Nm +は、ブート時に +.Pa /etc/rc +の中で起動されます( +.Xr rc 8 +参照)。起動されると、 +.Nm +は定められたインターネットソケットを監視し、接続要求を待ちます。 +監視しているソケットに対して接続要求が出されると、 +.Nm +はそのソケットに対応したサービスを +判定し、サービスを提供するプログラムを起動します。 +サーバプログラムはサービスソケットを標準入力・標準出力・ +エラー出力として起動されます。 +サービスプログラムが完了すると、 +.Nm +は再びソケットの監視を行ないます(後述するような例外もあります)。 +.Nm +を用いれば 1 つのデーモンで +複数のサービスプログラムを起動することができるので、 +システムの負荷を軽減することができます。 +.Pp +.Nm +は、起動時に以下のオプションを指定できます。 +.Bl -tag -width indent +.It Fl d +デバッグモードにします。 +.It Fl l +ログをとります。 +.It Fl R Ar rate +一分間に起動できる最大のサービス数を指定します。デフォルトは 256 です。 +.It Fl a +監視する IP アドレスを指定します。 +.It Fl p +デフォルトとは異なるプロセス ID を保持するファイルを指定します。 +.El +.Pp +.Nm +は実行時に設定情報を設定ファイルから読み込みます。 +デフォルトでは設定ファイルは +.Pa /etc/inetd.conf +です。 +設定ファイルの各フィールドにはエントリが 1 つなければなりません。 +各フィールドのエントリはタブやスペースで区切ります。 +コメントは行頭に ``#'' をつけます。 +設定ファイルのフィールドは以下のものからなります: +.Pp +.Bd -unfilled -offset indent -compact +サービス名 +ソケットタイプ +プロトコル +{wait/nowait}[/max-child] +ユーザ名 +サーバプログラム名 +サーバプログラム引数 +.Ed +.Pp +.No Tn "ONC RPC" +ベースのサービスを記述する場合には、以下のエントリを記述します。 +.Pp +.Bd -unfilled -offset indent -compact +サービス名/バージョン +ソケットタイプ +RPC/プロトコル +ユーザ名 +サーバプログラム名 +サーバプログラム引数 +.Ed +.Pp +.Nm +が起動することのできるサービスは二種類あります。 +一つは標準で、もう一つは TCPMUX です。 +標準サービスには割り当てられた well-known ポートがあります。 +これは公式のインターネット標準を実装したサービスや BSD 特有のサービスです。 +.Tn RFC 1078 +に書かれているように、TCPMUX は非標準サービスであり、 +well-known ポートが割り当てられていません。 +そういった非標準サービスは、あるプログラムが +.Dq tcpmux +well-known ポートに接続してそのサービス名を指定したとき、 +.Nm +によって起動されます。 +この機能はローカルに開発されたサーバを追加するときに +便利です。 +.Pp +.Em サービス名 +のエントリには、 +.Pa /etc/services +ファイルに記述されているサービス名が記述されます。 +.Dq 内部 +サービス (後述) については、 +名前としてそのサービスのオフィシャル名 +(すなわち +.Pa /etc/services +内の最初のエントリ)を指定 +.Em しなければなりません。 +.No Tn "ONC RPC" +ベースのサービスを指定するためには、このフィールドは +.Pa /etc/rpc +に書かれた有効な RPC サービス名でなければなりません。 +.Dq / +の右の部分が RPC のバージョン番号です。バージョン番号は、 +数字もしくは、バージョンの幅(レンジ)で指定します。 +幅を指定する場合は低い番号から高い番号を指定します。たとえば +.Dq rusers/1-3 +のように記述します。 +TCPMUX サービスでは、 +.Em サービス名 +のフィールドは、文字列 +.Dq tcpmux +、スラッシュ、そしてローカルに選ばれたサービス名から +なります。 +.Pa /etc/services +に書かれたサービス名と +.Dq help +は予約済であり、ローカルなサービス名には使用できません。 +TCPMUX サービスのためにユニークな名前をつけるには、 +頭に組織名をつけ、末尾にバージョン番号をつけるとよいでしょう。 +.Pp +.Em ソケットタイプ +のエントリは、 +.Dq stream , +.Dq dgram , +.Dq raw , +.Dq rdm , +.Dq seqpacket +のいずれかである必要があります。それぞれ、ソケットが +stream, +datagram, +raw, +reliably delivered message, +sequenced packet socket +である場合に対応しています。 +TCPMUX サービスは +.Dq stream +を使わなければなりません。 +.Pp +.Em プロトコル +のエントリには、 +.Pa /etc/protocols +に記述されている有効なプロトコル名が記述されます。 +例えば +.Dq tcp +や +.Dq udp +などです。RPC ベースのサービスの場合、 +.Dq rpc/tcp +や +.Dq rpc/udp +のような指定になります。 +TCPMUX サービスは +.Dq tcp +を使わなければなりません。 +.Pp +.Em wait/nowait +エントリは、 +.Nm +によって起動されたサーバがサービスアクセスポイントに +関連付けられたソケットを引き継ぐかどうか、すなわちサーバが終了するまで +.Nm +が新しいサービス要求を監視するのを待つ必要があるか否かを +指定します。 +datagram サーバは、特定のサービスアドレスと結び付いた +datagram ソケットで毎回起動されるため、 +.Dq wait +を使わなければなりません。こういったサーバは、終了する前に少なくとも +1 データグラムをソケットから読まなければなりません。 +もし datagram サーバが相手に接続したときソケットを +開放するなら、 +.Nm +はソケットに対するメッセージをさらに受けることができます。 +このようなサーバは +.Dq マルチスレッド +サーバと呼ばれます。 +サーバはソケットから datagram を一つ読み込み、相手に接続する新しい +ソケットをつくります。 +サーバは fork() を行い、親プロセス側は終了なければいけません。 +これにより +.Nm +は新しいサービス要求をチェックし、新しいサーバを起動することが +できるようになります。 +入って来る全ての datagram を処理し、 +時間切れまで動作する datagram サーバは、 +.Dq シングルスレッド +サーバと呼ばれます。 +.Xr comsat 8 , +.Pq Xr biff 1 , +.Xr talkd 8 +は後者のタイプの datagram サーバの例です。 +.Xr tftpd 8 +はマルチスレッドで動く datagram サーバの例です。 +.Pp +stream ソケットを使うサーバは一般にマルチスレッドで動き +.Dq nowait +エントリを使います。 +こういったサーバへの接続要求は +.Nm +で受け付けられ、新たに受理し、クライアントにつながった +ソケットのみがサーバに与えられます。 +多くの stream ベースのサービスはこのように行われます。 +.Dq wait +エントリを使う stream ベースのサーバは、 +サービスのソケットを監視し、少なくとも一つの接続要求を受け入れてから +終了しなければなりません。 +そういったサーバは通常、時間切れとなるまで、入って来る要求を +受け付け処理します。 +TCPMUX サービスは +.Dq nowait +を使わなければなりません。 +.Pp +``nowait'' サービスの子プロセス(あるいは ``スレッド'')の最大数は、 +``nowait'' キーワードの後に ``/'' と数字を付け加えることで指定できます。 +通常(あるいはゼロが指定された場合)、子プロセスの数に制限はありません。 +一方、最大数に達すると、それ以降の接続要求は、存在する子プロセスが終了するまで +待ち行列に蓄えられます。これは、``wait'' モードでも同様ですが、通常は +1 (デフォルトの値)以外は意味がありません。 +.Pp +.Em user +エントリには、サーバを実行するユーザ名を書きます。 +これによりサーバを root よりも低い権限で実行できます。 +.Pp +.Em サーバプログラム名 +のエントリには、ソケットに要求があったとき +.Nm +が起動し、当該エントリのサービスを提供する +サーバプログラムのパス名を指定します。 +.Nm +内にすでに実装されているサービスを提供する場合には、サーバプログラムとして +.Dq internal +を指定します。 +.Pp +.Em サーバプログラム引数 +のエントリは、サーバを起動する際の引数を、サーバプログラムの起動文字列 +である argv[0] を含めて記述します。 +.Nm +内に実装されているサービスを提供する場合には、サーバプログラム引数 +として +.Dq internal +を指定します。 +.Pp +.Nm +は、内蔵ルーチンを用いて簡単なサービスを自身で提供します。 +これらのサービスとは +.Dq echo , +.Dq discard , +.Dq chargen +(文字生成), +.Dq daytime +(人間が読む形式で時間を出力します), +.Dq time +(機械可読形式の時間。1900 年 1 月 1 日 0 時からの経過秒数を出力します) +です。 +これらのサービスは TCP と UDP バージョンのいずれでも利用できます。 +UDP バージョンは返事のポートとして内部サービスに相当するポートを +要求されたとき、サービスを拒否します。 +(これはループ攻撃に対する防護です。リモート IP アドレスは記録されます。) +これらのサービスの詳細については適当な +.Tn RFC +ドキュメントを参照して下さい。 +.Pp +.Fl l +オプションが指定された場合、 +.Nm +は、 +.Xr accept 2 +が終了した時点で、選択されたサービスと要求を発したリモートの IP 番号を +syslog に記録します。 +.Pp +.Dv SIGHUP +を受けとると、 +.Nm +は、設定ファイルを再度読み込みます。設定ファイルを +再読み込みするとき、サービスを追加、削除、変更できます。 +デバッグモードで起動された場合をのぞき、 +.Nm +は再設定を容易にするために、プロセス ID を +.Pa /var/run/inetd.pid +に記録します。 +.Sh TCPMUX +.Pp +.Tn RFC 1078 +は TCPMUX プロトコルについて述べています。 +「 TCP クライアントは他のホストに TCP ポート番号 1 で接続します。 +クライアントは、サービス名に<CRLF>を付加して送ります。 +サービス名は大文字/小文字を区別しません。 +サーバは、肯定(+)もしくは否定(\-)を表す一文字を返します。 ++ あるいは \- のすぐ後にメッセージが続く場合があります。 +返答は <CRLF> で終わります。もし返答が肯定で +あれば、選択されたプロトコルが開始されます。 +そうでなければ接続は切られます。」 +プログラムにはファイルディスクプリタ 0 と 1 で TCP コネクションが +渡されます。 +.Pp +TCPMUX サービス名が ``+'' で始まっているとき、 +.Nm +は、プログラムに肯定返答(+)を返します。 +これによって、 +特別なサーバコードを追加することなく +標準入出力を使うプログラムを起動することができます。 +.Pp +特別なサービス名である +.Dq help +により、 +.Nm +は +.Pa inetd.conf +にある TCPMUX サービスの一覧を出力します。 +.Sh 関連ファイル +.Bl -tag -width /var/run/inetd.pid -compact +.It Pa /etc/inetd.conf +設定ファイル +.It Pa /etc/rpc +サービス名を RPC プログラム番号に変換するテーブル +.It Pa /etc/services +サービス名をポート番号に変換するテーブル +.It Pa /var/run/inetd.pid +現在実行中の +.Nm +の pid +.El +.Sh 使用例 +.Pp +次に、いくつかのサービスについて +サービスエントリの +例を挙げておきます。 +.Bd -literal +ftp stream tcp nowait root /usr/libexec/ftpd ftpd -l +ntalk dgram udp wait root /usr/libexec/ntalkd ntalkd +tcpmux/+date stream tcp nowait guest /bin/date date +tcpmux/phonebook stream tcp nowait guest /usr/local/bin/phonebook phonebook +rstatd/1-3 dgram rpc/udp wait root /usr/libexec/rpc.rstatd rpc.rstatd +.Ed +.Sh エラーメッセージ +.Nm +サーバは、 +.Xr syslog 3 +を使ってエラーメッセージを記録します。 +重要なエラーメッセージと +その説明は以下の通りです。 +.Pp +.Bl -ohang -compact +.It Xo +.Ar service Ns / Ns Ar protocol +.No " server failing (looping), service terminated." +.Xc +直前の一分間に、そのサービスについての要求数が制限に達しました。 +不完全なプログラムや悪意のあるユーザがシステムを +ハングアップさせないために、このような制限が設けられています。 +このメッセージが出力される理由はいくつかあります。 +.Bl -enum -offset indent +.It +短時間の間に多くのホストがこのサービスを要求している。 +.It +不完全なクライアントプログラムがサービスを +頻繁に要求しすぎている。 +.It +悪意あるユーザがあるプログラムを起動し、 +サービスが '拒否' されるように攻撃している。 +.It +起動されたサービスプログラムにエラーがあり、 +クライアントがすぐにリトライを起こしてしまう。 +.El +.Pp +.Fl R Ar rate +オプションを使うと、制限を変えることができます。 +制限に達したとき、10 分経つとサービスは自動的に +再許可されます。 +.Pp +.It Xo +.Ar service Ns / Ns Ar protocol : +.No \&No such user +.Ar user , +.No service ignored +.Xc +.It Xo +.Ar service Ns / Ns Ar protocol : +.No getpwnam : +.Ar user : +.No \&No such user +.Xc +.Xr passwd 5 +データベースに +.Ar user +のエントリーがありません。 +最初のメッセージは +.Nm +が設定ファイルを(再度)読み込むときに出されます。 +二つ目のメッセージは、サービスが呼び出されたときに +出されます。 +.Pp +.It Xo +.Ar service : +.No can't set uid +.Ar uid +.Xc +.It Xo +.Ar service : +.No can't set gid +.Ar gid +.Xc +.Ar user +フィールドのユーザ ID もしくは グループ IDが +無効です。 +.Pp +.It "setsockopt(SO_PRIVSTATE): Operation not supported" +.Nm +はそのソケットに設定されている特権状態を放棄しようとしましたが、 +失敗しました。 +.El +.Sh 関連項目 +.Xr passwd 5 , +.Xr rpc 5 , +.Xr services 5 , +.Xr comsat 8 , +.Xr fingerd 8 , +.Xr ftpd 8 , +.Xr portmap 8 , +.Xr rexecd 8 , +.Xr rlogind 8 , +.Xr rshd 8 , +.Xr telnetd 8 , +.Xr tftpd 8 , +.Sh 歴史 +.Nm +コマンドは +.Bx 4.3 +から登場しました。 +TCPMUX は Mark Lottor によるコードとドキュメントを元にしています。 +.Tn "ONC RPC" +ベースのサービスのサポートは、 +.Tn SunOS +4.1 +が供給されてから、 +それにならって作られました。 diff --git a/ja_JP.eucJP/man/man8/init.8 b/ja_JP.eucJP/man/man8/init.8 new file mode 100644 index 0000000000..91641f377c --- /dev/null +++ b/ja_JP.eucJP/man/man8/init.8 @@ -0,0 +1,303 @@ +.\" Copyright (c) 1980, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" This code is derived from software contributed to Berkeley by +.\" Donn Seeley at Berkeley Software Design, Inc. +.\" +.\" 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. +.\" +.\" 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. +.\" +.\" @(#)init.8 8.3 (Berkeley) 4/18/94 +.\" %Id: init.8,v 1.4.2.3 1997/08/18 03:30:04 davidn Exp % +.\" jpman %Id: init.8,v 1.2 1997/05/27 08:12:44 yugawa Stab % +.\" +.Dd April 18, 1994 +.Dt INIT 8 +.Os BSD 4 +.Sh 名称 +.Nm init +.Nd プロセス制御の初期化を行う +.Sh 書式 +.Nm init +.Sh 解説 +.Nm init +はブート処理の最後に起動されます。 +.Nm init +は通常、 +.Xr reboot 8 +で説明されている自動リブートシーケンスを実行します。それが成功すると、 +システムはマルチユーザモードになります。 +リブートスクリプトの実行に失敗すると、 +.Nm init +はスーパユーザが使うシェルを起動してシングルユーザモードを +開始させます。 +.Nm init +プログラムは、ブートプログラムからのパラメータの指示を受けて、マルチユー +ザモードに移行せず、一般のデーモンを起動することなくシングルユーザモードの +シェルを起動させることができます。 +その場合、システムはメンテナンスのためのモードになり、 +シェルを抜ける (^D を入力する)ことで +シングルユーザモードからマルチユーザモードになります。 +これによって、 +.Nm init +は +.Pa /etc/rc +をファストブートモード(ディスクチェック省略)で実行します。 +.Pp +もし +.Xr ttys 5 +ファイルの +.Nm console +のエントリが +``insecure'' にマークされていた場合には、 +.Nm init +はシングルユーザモードのシェルを起動する前に、スーパユーザのパスワードを +要求します。 +パスワードチェックは、 +.Nm console +が ``secure'' にマークされていればスキップされます。 +.Pp +カーネルは 4 種類のセキュリティレベルで走行します。どのスーパーユーザ +プロセスもセキュリティレベルを上げることができますが、レベルを下げることが +できるのは +.Nm init +だけです。セキュリティレベルは以下のように定義されます: +.Bl -tag -width flag +.It Ic -1 +常に危険なモード \- システムは常にレベル 0 モードで走行します。 +.It Ic 0 +危険なモード \- 変更不可(immutable)フラグや追加のみ(append-only)フラグは +無効にされます。 +全てのデバイスは、そのパーミッションに従って読み書きされます。 +.It Ic 1 +安全なモード \- 変更不可フラグや追加のみのフラグは変更されません。 +マウントされたファイルシステムのディスクおよび +.Pa /dev/mem +や +.Pa /dev/kmem +は read-only となります。 +.It Ic 2 +安全度の高いモード \- レベル 1 のモードの効果に加え、ディスクは +マウントさていようといまいと、( +.Xr mount 2 +を除き) 常に read-only となります。 +このレベルは、ファイルシステムをアンマウントして変更を加えることを不可能に +します。また、システムがマルチユーザで走行中に +.Xr newfs 8 +を実行することも出来なくなります。 +.El +.Pp +初期のセキュリティレベルが -1 だった場合、 +.Nm init +はセキュリティレベルを変更しません。 +それ以外の場合、シングルユーザモードではレベル 0 で、マルチユーザモードでは +レベル 1 で、システムは動作します。マルチユーザモードにおいてレベル 2 で +システムを走らせたい場合は、シングルユーザの状態の間に、つまり、 +.Pa /etc/rc +の中で +.Xr sysctl 8 +を使って設定します。 +.Pp +マルチユーザモードの場合、 +.Nm init +は +.Xr ttys 5 +ファイルで指示されたターミナルポートのためのプロセスを管理します。 +.Nm init +はこのファイルを読み込み、2 番目のフィールドに指示されたコマンドを +実行します。 +そのコマンドは通常、 +.Xr getty 8 +で、 +.Nm getty +はtty をオープン、初期化し、 +.Xr login 1 +プログラムを実行します。 +.Nm login +プログラムは、ユーザがログインするとシェルを起動します。ユーザが +ログアウトするか異常終了するなどして、そのシェルが終了すると、 +.Nm init +プログラムが起こされ、 +.Xr utmp 5 +ファイルからユーザを消し、 +.Xr wtmp 5 +ファイルにログアウトを記録します。 +このサイクルは、 +.Nm init +プログラムがその端末に新しい +.Nm getty +を実行することで繰り返されます。 +.Pp +ラインの状態 (on, off, secure, getty, ウインドウの情報) は、 +.Xr ttys 5 +ファイルを書き換えて +.Dq Li "kill -HUP 1" +によってシグナル +.Dv SIGHUP +を +.Nm init +に送ることで、リブートせずに変更できます。 +このシグナルを受け取ると +.Nm init +は +.Xr ttys 5 +ファイルを再度読み込みます。 +.Xr ttys 5 +でラインがオフにされると、 +.Nm init +はそのラインに関係するセッションの制御プロセスに SIGHUP シグナルを送ります。 +オフであったラインが +.Xr ttys 5 +ファイルでオンにされると、 +.Nm init +は新しい +.Nm getty +を起動して、新しいログインを可能にします。 +ラインの getty やウインドウフィールドが変更された場合、その変更は現在 +のログインセッションが終了するまで有効にはなりません。 +(例えば、 +.Nm init +によって新しいプロセスが起動されるまで有効にならない。) +.Xr ttys 5 +中のあるラインをコメントアウトあるいは削除した場合は、 +.Nm init +はそのラインに関しては何も実行しません。 +しかしこの場合、 +.Xr ttys 5 +ファイルと +.Xr utmp 5 +ファイル内の記録情報が一致しなくなるため、試すことはお勧めしません。 +.Pp +.Dq Li "kill \-TERM 1" +などによって terminate シグナル +.Pq Dv TERM +を受けると、 +.Nm init +はマルチユーザモードを終了し、シングルユーザモードに復帰します。 +ハードウェアまたはソフトウェアの問題でデッドロックしたプロセスがある場合、 +.Xr init +はすべてのプロセスの終了を待たず(これは無限に終らないかも知れません)、 +30 秒間でタイムアウトして警告のメッセージを出力します。 +.Pp +terminal stop シグナル +.Pq Dv TSTP +を送ると( +.Dq Li "kill \-TSTP 1" +)、 +.Nm init +は新しい +.Xr getty +を起動するのをやめ、徐々にシステム停止可能な状態にします。 +その後、hangup シグナルで完全なマルチユーザモードに戻り、terminate シグナル +でシングルユーザモードに移ります。 +この hook は +.Xr reboot 8 +と +.Xr halt 8 +で使われています。 +.Pp +interrupt シグナル +.Pq Dv INT +を送ると( +.Dq Li "kill \-INT 1" +)、 +.Nm init +はすべてのプロセスを(デッドロックプロセスを待たずに)終了させ、 +リブートを実行します。 +この操作は、マシンがハングした時に、カーネルの中から、あるいは、X から、 +システムを安全にシャットダウンするのに便利です。 +.Pp +マシンをシャットダウンする時、 +.Nm init +は +.Pa /etc/rc.shutdown +スクリプトを実行しようとします。 +このスクリプトは +.Nm innd +(インターネットニュースサーバ) +のような特定のプログラムを綺麗に終了させるために使用可能です。 +.Pp +.Nm init +の役割は非常に重要で、もし +.Nm init +が死ぬとシステムが自動的にリブートされます。 +もしブート時に +.Nm init +プログラムを見つけられなければ、システムは以下のようなメッセージを出力 +して panic で終了します。 +``panic: init died (signal %d, exit %d)'' +.Sh 診断 +.Bl -diag +.It "getty repeating too quickly on port %s, sleeping" +ラインにサービスを提供するプロセスが、起動されるたびにすぐ終了してしまう。 +これは、端末ラインに着信があるかノイズが大きい場合にしばしば起こります。 +.Em "init は 10 秒間スリープし、" +.Em "その後、プロセスを開始させようとし続けます。" +.Pp +.It "some processes would not die; ps axl advised." +シャットダウンの際、ハングしていて終了させられないプロセスがあります。 +この状態は、通常、デバイスに異常があるときにデバイスドライバではり付い +てしまうことにより起こります。 +.El +.Sh 関連ファイル +.Bl -tag -width /var/log/wtmp -compact +.It Pa /dev/console +システムのコンソールデバイス +.It Pa /dev/tty* +.Xr ttys 5 +内にある端末ポート +.It Pa /var/run/utmp +現在ログインしているのユーザの情報 +.It Pa /var/log/wtmp +すべてのログイン・ログアウトの情報 +.It Pa /etc/ttys +端末の初期化情報が書かれたファイル +.It Pa /etc/rc +システム立ち上げ用スクリプト +.It Pa /etc/rc.shutdown +システムシャットダウン用スクリプト +.El +.Sh 関連項目 +.Xr kill 1 , +.Xr login 1 , +.Xr sh 1 , +.Xr ttys 5 , +.Xr crash 8 , +.Xr getty 8 , +.Xr halt 8 , +.Xr rc 8 , +.Xr reboot 8 , +.Xr shutdown 8 +.Sh 歴史 +.Nm +コマンドは +.At v6 +から登場しました。 +.Sh バグ +.Xr sysctl +を持たないシステムは、セキュリティレベル \-1 で動作します。 diff --git a/ja_JP.eucJP/man/man8/intro.8 b/ja_JP.eucJP/man/man8/intro.8 new file mode 100644 index 0000000000..c32033fab8 --- /dev/null +++ b/ja_JP.eucJP/man/man8/intro.8 @@ -0,0 +1,70 @@ +.\" Copyright (c) 1983, 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. +.\" +.\" 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. +.\" +.\" @(#)intro.8 8.2 (Berkeley) 12/11/93 +.\" 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 +.Os BSD 4.2 +.Sh 名称 +.Nm intro +.Nd システムメンテナンスおよび操作コマンドの紹介 +.Sh 解説 +本セクションにはシステムの操作とメンテナンスに関連した情報が記載されています。 +新しいファイルシステムを作成する時に使用する +.Ql Xr newfs , +ファイルシステムの整合性をチェックする +.Ql Xr fsck , +ディスクの使用を制限するための +.Ql Xr edquota , +システムのバックアップを行なう +.Ql Xr dump , +ディスクの内容が壊れた時にファイルをリカバーする +.Ql Xr restore +について解説されています。 +ディスクやテープをフォーマットする場合には、 +そのシステムが運用されている特定のアーキテクチャ用の +.Ql Xr format +のマニュアルを参照する必要があります。 +.Ql Xr inetd +や +.Ql Xr ftpd +のようなネットワークに関連したサービスについても解説されています。 +システムのクラッシュダンプをどのように解析するかについて理解するには +.Ql Xr crash +のセクションを参照する必要があります。 +.Sh 歴史 +.Nm intro +セクションのマニュアルページは +.Bx 4.2 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/iostat.8 b/ja_JP.eucJP/man/man8/iostat.8 new file mode 100644 index 0000000000..e9ef9017f3 --- /dev/null +++ b/ja_JP.eucJP/man/man8/iostat.8 @@ -0,0 +1,146 @@ +.\" Copyright (c) 1985, 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. +.\" +.\" 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. +.\" +.\" @(#)iostat.8 8.1 (Berkeley) 6/6/93 +.\" jpman %Id: iostat.8,v 1.2 1997/05/19 04:57:59 mitchy Stab % +.\" +.Dd June 6, 1993 +.Dt IOSTAT 8 +.Os BSD 4 +.Sh 名称 +.Nm iostat +.Nd +.Tn I/O +の統計情報を表示する +.Sh 書式 +.Nm iostat +.Op Fl c Ar count +.Op Fl M Ar core +.Op Fl N Ar system +.Op Fl w Ar wait +.Op Ar drives +.Sh 解説 +.Nm iostat +は、端末やディスク、CPU操作のカーネル +.Tn I/O +統計を表示します。 +.Pp +オプションは以下のとおりです: +.Bl -tag -width flag +.It Fl c Ar count +I/O統計情報の表示を +.Ar count +回繰り返します。最初の表示はリブート時からの統計です。 +その後の表示は、最後に表示してから次に表示するまでの間の統計です。 +間隔 +.Ar wait +が指定されていときは、デフォルトの1秒が使われます。 +.It Fl M Ar core +名前リストから値を取り出す際に、デフォルトの +.Dq Pa /dev/kmem +のかわりに指定した +.Ar core +を使います。 +.It Fl N Ar system +名前のリストを取り出す際に、デフォルトの +.Dq Pa /kernel +のかわりに +.Ar system +を使います。 +.It Fl w Ar wait +各表示の間隔を、 +.Ar wait +秒とします。繰り返し回数 +.Ar count +が指定 +されていなければ、デフォルトでは無限に表示を繰り返します。 +.El +.Pp +.Nm iostat +の、表示する情報のフォーマットは以下のとおりです: +.Bl -tag -width flag +.It tty +.Bl -tag -width indent -compact +.It tin +端末から読み込んだ文字数 +.It tout +端末から書き出した文字数 +.El +.It disks +ディスク操作。このフィールドはシステム依存です。このフィールドのヘッダ +はディスクの名前とユニット番号です。システムが4つ以上のディスクドライブ +を扱うように設定されていても、 +.Nm iostat +は最初の4つのドライブだけ +を表示します。特定のドライブを表示するには、コマンドラインでドライブ +の名前を指定します。 +.Pp +.Bl -tag -width indent -compact +.It sps +1秒間に転送されたセクタ数 +.It tps +1秒間の転送回数 +.It msps +平均シーク時間(ミリ秒単位、シーク時間と回転遅延を含む) +.El +.It cpu +.Bl -tag -width indent -compact +.It \&us +ユーザモードのCPU時間の % 表示 +.It \&ni +niceで優先順位づけられたプロセスを動作させるユーザモードのCPU時間 +の % 表示 +.It \&sy +システムモードのCPU時間の % 表示 +.It \&in +インタラプトモードのCPU時間の % 表示 +.It \&id +アイドルモードのCPU時間の % 表示 +.El +.El +.Sh 関連ファイル +.Bl -tag -width /dev/kmem -compact +.It Pa /kernel +デフォルトのカーネルの名前リスト +.It Pa /dev/kmem +デフォルトのメモリファイル +.El +.Sh 関連項目 +.Xr fstat 1 , +.Xr netstat 1 , +.Xr nfsstat 1 , +.Xr ps 1 , +.Xr systat 1 , +.Xr pstat 8 , +.Xr vmstat 8 +.Pp +.%T "Installing and Operating 4.3BSD" +の ``Interpreting system activity'' で始まる章 diff --git a/ja_JP.eucJP/man/man8/ipfw.8 b/ja_JP.eucJP/man/man8/ipfw.8 new file mode 100644 index 0000000000..d2379fd7a9 --- /dev/null +++ b/ja_JP.eucJP/man/man8/ipfw.8 @@ -0,0 +1,489 @@ +.Dd July 20, 1996 +.\" jpman %Id: ipfw.8,v 1.4 1997/05/19 17:19:51 horikawa Stab % +.Dt IPFW 8 SMM +.Os FreeBSD +.Sh 名称 +.Nm ipfw +.Nd IPファイアウォール制御ユーティリィティ +.Sh 書式 +.Nm +.Ar file +.Nm ipfw +.Oo +.Fl f +| +.Fl q +.Oc +flush +.Nm ipfw +.Oo +.Fl q +.Oc +zero +.Op Ar number ... +.Nm ipfw +delete +.Ar number ... +.Nm ipfw +.Op Fl aftN +list +.Nm ipfw +.Oo +.Fl ftN +.Oc +show +.Nm ipfw +.Oo +.Fl q +.Oc +add +.Op Ar number +.Ar action +.Op log +.Ar proto +from +.Ar src +to +.Ar dst +.Op via Ar name | ipno +.Op Ar options +.Sh 解説 +書式の 1 行目のようにファイル名を指定した場合は、 +.Ar file +を 1 行ずつ、引数として読み込みます。 +.Pp +.Nm +はパケットごとに、マッチするルールが見つかるまでルールリストを調べます。 +各ルールにはパケット数とパケットサイズの 2 つのカウンタが用意されていて、 +パケットがマッチするとカウンタ値は更新されます。 +.Pp +全ルールは 1 から 65534 の範囲の行番号で順序付けられます。この番号によって +ルールの並べ変えと削除を行ないます。 +ルールのマッチングは昇順で行なわれ、最初にマッチしたものが適用されます。 +複数のルールが同じ番号を共有することも可能です。この場合はルールが追加された +順序でマッチングが行なわれます。 +.Pp +番号を指定せずにルールを追加した場合は、直前のルールの番号に 100 を加えたものと +なります。 +ルールの番号が 65434 より大きい場合は、新しいルールは最後のルールに追加されます +。 +.Pp +delete 操作は +.Ar number +で指定された番号を持つ最初のルールを、もし有れば、削除します +.Pp +list 操作は現在のルール一覧を出力します +.Pp +show 操作は `ipfw -a list' と同じ結果を出力します +.Pp +zero 操作は +.Ar number +で指定された番号を持つルールのカウンタをクリアします +.Pp +flush 操作は全ルールを削除します +.Pp +どんな場合でも次のルールは存在します +.Bd -literal -offset center +65535 deny all from any to any +.Ed +.Pp +全パケットを拒否するのがデフォルトのポリシーです。 +これを修正し、必要なルールを設定して下さい。 +.Pp +オプションは以下のものが利用可能です。 +.Bl -tag -width flag +.It Fl a +list 操作の時、カウンタの値を表示します。 +show の項を参照のこと。 +.It Fl f +操作を実行する際に確認メッセージを表示しません。 +flush 操作も無条件に実行されます。 +.Ar (注意) +プロセスに tty が関連付けられていない場合には、 +このオプションが指定されているものとして実行されます。 +.It Fl q +ルールを追加したり削除したりする際に、メッセージの出力を抑制します +('-f'も含まれます)。 +このオプションは、リモートログインセッションでルールを調整する際に、 +(例えば sh /etc/rc.firewall のようにして)スクリプトの中から複数の ipfw コマンド +を +実行する場合や、 +多数の ipfw ルールを記述したファイルを用いる場合に +便利です。 +flush 操作が通常の(冗舌な)状態で実行されると、メッセージが出力されます。 +ここで、すべてのルールは削除されるので、メッセージをログインセッションに +送ることができず、ログインセッションがクローズされてしまうので、 +残りのルールセットは実行されません。 +この状態を修復するにはコンソールへのアクセスが必要となります。 +.It Fl t +list 操作の時に、最後にマッチしたパケットのタイムスタンプを表示します。 +.It Fl N +IPアドレスとサービス名をリゾルブしてホスト名で表示します。 +.El +.Pp +.Ar action : +.Bl -hang -offset flag -width 1234567890123456 +.It Ar allow +マッチするパケットを通過させ、マッチングを終了します。 +.Ar pass , +.Ar permit , +.Ar accept +と同じです。 +.It Ar deny +マッチするパケットを破棄し、マッチングを終了します。 +.Ar drop +は +.Ar deny +と同じです。 +.It Ar reject +(パケットを送らないよう嘆願) マッチするパケットを破棄し、 +ICMP の host unreachable を送信して、終了します。 +.It Ar unreach code +パケットを破棄し、ICMP の unreachable に +.Ar code +を付けて送信します。 +.Ar code +は、 0 から 256 までの数字、もしくは、以下に列挙する別名のいずれかです: +.Ar net, +.Ar host , +.Ar protocol , +.Ar port , +.Ar needfrag , +.Ar srcfail , +.Ar net-unknown , +.Ar host-unknown , +.Ar isolated , +.Ar net-prohib , +.Ar host-prohib , +.Ar tosnet , +.Ar toshost , +.Ar filter-prohib , +.Ar host-precedence , +.Ar precedence-cutoff +。送信後、終了します。 +.It Ar reset + TCP パケットのみに対応。 +パケットを破棄し、TCP の (RST) を送信し、終了します。 +.It Ar count +マッチするパケットのカウンタを更新し、引続きマッチングを行ないます。 +.It Ar divert port +マッチするパケットを +.Ar port +で指定されたポートにバインドされている +.Xr divert 4 +ソケットに送り、マッチングを終了します。 +.It Ar tee port +マッチするパケットのコピーを +.Ar port +で指定されたポートにバインドされている +.Xr divert 4 +ソケットに送り、引続きマッチングを行ないます。 +.It Ar skipto number +.Ar number +より小さな番号のルールを飛び越して、 +.Ar number +以上の番号のルールで最初に存在するものから、マッチングを継続します。 +.El +.Pp +パケットが +.Ar divert +や +.Ar tee +のどちらかひとつ以上、もしくは両方の組合せの、複数のルールにマッチした場合、 +最後のものを除き、無視します。 +.Pp +カーネルが +.Dv IPFIREWALL_VERBOSE +オプション付きでコンパイルされている場合に、``log'' が指定されているルールと +マッチした時は、メッセージをコンソールに表示します。 +もし、 +.Dv IPFIREWALL_VERBOSE_LIMIT +オプション付きでコンパイルされている場合、一連のルールに対し指定されたパケット +数を受信した後、メッセージの表示を中止します。 +パケットのカウンタをクリアすれば再びメッセージを出力します。 +.Pp +コンソールへの表示とその制限数は、 +.Xr sysctl 8 +を通し、直接設定できます。 +.Pp +.Ar proto : +.Bl -hang -offset flag -width 1234567890123456 +.It Ar ip +全パケットがマッチします。別名 +.Ar all +も使えます。 +.It Ar tcp +TCP パケットのみマッチします。 +.It Ar udp +UDP パケットのみマッチします。 +.It Ar icmp +ICMP パケットのみマッチします。 +.It Ar <number|name> +指定されたプロトコルのパケットのみマッチします ( +.Pa /etc/protocols +のリストを参照の事) +.El +.Pp +.Ar src +と +.Ar dst : +.Pp +.Bl -hang -offset flag +.It Ar <address/mask> +.Op Ar ports +.El +.Pp +.Em <address/mask> +は以下のように指定できます。 +.Bl -hang -offset flag -width 1234567890123456 +.It Ar ipno +IP番号を 1.2.3.4 の形式で指定します。指定されたアドレスのみがマッチします。 +.It Ar ipno/bits +IP番号とネットマスクの幅を 1.2.3.4/24 の形式で指定します。 +この場合は 1.2.3.0 から 1.2.3.255 のアドレスがマッチします。 +.It Ar ipno:mask +IP番号とネットマスクの幅を 1.2.3.4:255.255.240.0 の形式で指定します。 +この場合は 1.2.0.0 から 1.2.15.255 のアドレスがマッチします。 +.El +.Pp +アドレスの前に ``not'' を付けることによって、マッチの意味を反転させる +ことができます(指定されたアドレス以外の総てのアドレスがマッチします)。 +これはポート番号には影響しません。 +.Pp +TCP と UDP ではさらに、 +.Em ports +を以下のように指定できます。 +.Pp +.Bl -hang -offset flag +.It Ns {port|port-port} Ns Op ,port Ns Op ,... +.El +.Pp +ポート番号の代わりに(ファイル +.Pa /etc/services +から取った)サービス名を使用できます。 +port-port の書式で、最初の値に限り範囲指定できます。 +列挙出来るポート数は +.Pa /usr/src/sys/netinet/ip_fw.h +で +.Dv IP_FW_MAX_PORTS +として定義されています。 +.Pp +マッチングのルールは、入ってくるパケットか、出ていくパケット、もしくはその両方 +に対し適応されます。 +.Ar in +を指定すれば、入ってくるパケットのみにルールを適応します。 +.Ar out +を指定すれば、出ていくパケットのみに適応します。 +.Pp +特定のインタフェースを通過するパケットには、 +.Ar via +を用いてインタフェースを指定します: +.Bl -hang -offset flag -width 1234567890123456 +.It Ar via ifX +.Ar ifX +を通過するパケットを指定します。 +.It Ar via if* +.Ar ifX +を通過するパケットを指定します。X はいずれかのユニットの番号です。 +.It Ar via any +.Em いずれか +のインタフェースを通過するパケットを指定します。 +.It Ar via ipno + IP アドレスが +.Ar ipno +のインタフェースを通過するパケットを指定します。 +.El +.Pp +.Ar via +を用いると、常時指定されたインタフェースがチェックされます。 +.Ar recv +や +.Ar xmit +を、 +.Ar via +の代わりに指定すると、 +受信、もしくは送信インタフェースのみが(各々に)チェックされます。 +両方を指定すれば、 +受信と送信の両方のインタフェースを通るパケットを指定できます。 +例 : +.Pp +.Dl "ipfw add 100 deny ip from any to any out recv ed0 xmit ed1" +.Pp +.Ar recv +で指定したインタフェースでは、受信と送信、両方のパケットをチェックできます。 +それに対し、 +.Ar xmit +で指定したインタフェースでは、送信パケットのみとなります。 +それゆえに、 +.Ar xmit +を指定すると +.Ar out +が、必須です( +.Ar in +は不可)。 +.Ar via +と共に +.Ar xmit +もしくは、 +.Ar recv +を指定する事はできません。 +.Pp +個々のパケットは、受信用ないし送信用インタフェースを持たないかもしれません。 +ローカルホストで発生したパケットには受信用のインタフェースはないし、 +ローカルホスト内宛のパケットは、送信用インタフェースが有りません。 +.Pp +追加用 +.Ar options : +.Bl -hang -offset flag -width 1234567890123456 +.It frag +パケットが断片(フラグメント)化されたデータグラムの一部で、かつデータグラムの +先頭の断片でない場合にマッチします。 +.It in +ネットワークから受信したパケットのみマッチします。 +.It out +ネットワークへ送信するパケットのみマッチします。 +.It ipoptions Ar spec +IP ヘッダが、 +.Ar spec +に指定されたコンマで区切られたオプションのリストを含む場合にのみマッチします。 + サポートされている IP オプションは +.Ar ssrr +(strict source route), +.Ar lsrr +(loose source route), +.Ar rr +(record packet route), +.Ar ts +(timestamp) です。 +``!''によって、特定のオプションを含めないよう指定できます。 +.It established +RST または ACK ビットがセットされているパケットのみマッチします。 +このビットがセットされることがあるのは TCP のパケットのみです。 +.It setup +SYN ビットがセットされ ACK がセットされていないパケットのみマッチします。 +このビットがセットされることがあるのは TCP のパケットのみです。 +.It tcpflags Ar spec +TCP ヘッダが +.Ar spec +に指定されたコンマで区切られたフラグのリストを含む場合にのみマッチします。 + サポートされているフラグは、 +.Ar fin , +.Ar syn , +.Ar rst , +.Ar psh , +.Ar ack , +.Ar urg +です。 +``!''によって、特定のフラグを含めないよう指定できます。 +.It icmptypes Ar types +ICMP タイプが +.Ar types +で指定されたリスト中に存在する場合にのみ適用されるルールとなります。 +リストはレンジの組み合わせでも、各タイプをコンマで区切ったものでもどちらでも +かまいません。 +.El +.Sh チェックリスト +ルールを構成する際に考慮すべき重要な点を述べます。 +.Bl -bullet -hang -offset flag +.It +かならず送信パケットと受信パケットの両方のパケットをフィルタリングします。 +ほとんどのネットワークコネクションではパケットが双方向に流れることが必要です。 +.It +テストは細心の注意を払って行ないます。テストの際にはコンソールの近くにいる +のがよいでしょう。 +.It +ループバックインターフェイスのことを忘れてはなりません。 +.El +.Sh 長所 +ファイアウォールが常に破棄するパケットが 1 種類あります。 +フラグメントオフセットが 1 のフラグメントパケットです。 +これはパケットとしては有効なものですが、利用目的はファイアウォールを +かいくぐることしかありません。 +.Pp +ネットワーク越しにログインしている場合、LKM版の +.Nm +をロードすることはそれほど単純なことではありません。 +以下のコマンドを奨めます。 +.Bd -literal -offset center +modload /lkm/ipfw_mod.o && \e +ipfw add 32000 allow all from any to any +.Ed +.Pp +これに引続き、同じような状況で +.Bd -literal -offset center +ipfw flush +.Ed +.Pp +とするのは良くありません。 +.Sh パケットの行き先変更 +指定されたポートを見ているソケットは、そのポートへ行き先変更されたパケットを、 +全部受けとります。 +.Xr divert 4 +を参照して下さい。ポートを見ているソケットがない場合やカーネルがパケットの行き +先変更をサポートするようにはコンパイルされていない場合、パケットは破棄されます +。 +.Sh 使用例 +次のコマンドは +.Em hacker.evil.org +から +.Em wolf.tambov.su +の telnet ポートへ送られる全ての TCP パケットを拒否するルールを追加します。 +.Pp +.Dl ipfw add deny tcp from hacker.evil.org to wolf.tambov.su 23 +.Pp +次のコマンドはネットワーク hackers からホスト my への全てのコネクションを +拒否します。 +.Pp +.Dl ipfw add deny all from 123.45.67.0/24 to my.host.org +.Pp +次はカウントされている情報とタイムスタンプを見る例です +.Pp +.Dl ipfw -at l +.Pp +これはタイムスタンプを省略して次のように指定できます。 +.Pp +.Dl ipfw -a l +.Pp +次のルールは 192.168.2.0/24 からの全ての受信パケットを、5000番のポートに +行き先変更するものです。 +.Pp +.Dl ipfw divert 5000 all from 192.168.2.0/24 to any in +.Sh 関連項目 +.Xr ip 4 , +.Xr ipfirewall 4 , +.Xr divert 4 , +.Xr protocols 5 , +.Xr services 5 , +.Xr reboot 8 , +.Xr syslogd 8 , +.Xr sysctl 8 +.Sh バグ +.Pp +.Em WARNING!!WARNING!!WARNING!!WARNING!!WARNING!!WARNING!!WARNING!! +.Pp +このプログラムはコンピュータをかなり使いにくい状態にしてしまう可能性があります +。 +はじめて使用する時はコンソール上で実行し、理解していない操作は +.Em 絶対に実行しない +ようにして下さい。 +.Pp +連続したエントリの操作もしくは追加に際し、サービス名やプロトコル名は使用できま +せん。 +.Pp +入ってきたパケットの断片(フラグメント)が +.Ar divert +によって行き先を変更されると、ソケットに配送される前に、組み立て直しをします。 +それに対し、 +.Ar tee +を経由した断片(フラグメント)は、組み立て直しされません。 +.Pp +ポートの別名でダッシュ (-) を含むものは、リストの最初には書けません。 +.Sh 作者 +Ugen J. S. Antsilevich, +Poul-Henning Kamp, +Alex Nash, +Archie Cobbs. +API based upon code written by Daniel Boulet for BSDI. +.Sh 歴史 +.Nm +は、FreeBSD 2.0 で最初に現れました。 diff --git a/ja_JP.eucJP/man/man8/ispcvt.8 b/ja_JP.eucJP/man/man8/ispcvt.8 new file mode 100644 index 0000000000..798ef08c45 --- /dev/null +++ b/ja_JP.eucJP/man/man8/ispcvt.8 @@ -0,0 +1,91 @@ +.\" Copyright (c) 1992, 1995 Hellmuth Michaelis +.\" +.\" 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 Hellmuth Michaelis +.\" 4. The name authors may not be used to endorse or promote products +.\" derived from this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``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 AUTHORS 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. +.\" +.\" @(#)ispcvt.1, 3.20, Last Edit-Date: [Tue Apr 4 12:35:54 1995] +.\" jpman %Id: ispcvt.8,v 1.3 1997/09/09 04:05:01 yugawa Stab % +.\" +.Dd April 4, 1995 +.Dt ISPCVT 1 +.Sh 名称 +.Nm ispcvt +.Nd 現在のビデオドライバが pcvt ドライバか否かを確認する +.Sh 書式 +.Nm ispcvt +.Op Fl c +.Op Fl d Ar device +.Op Fl v +.Sh 解説 +.Nm ispcvt +は、カーネルに組み込まれた現在のビデオドライバが +pcvt ドライバか否かを確認する手段を提供します。 +ドライバのメジャー及びマイナリリース番号も確認します。 +さらに、 +.Nm ispcvt +は、現在実行中のカーネルに組み込まれたドライバをコンパイルした時の、 +すべてのコンパイル時オプション +.Dq Ar PCVT_XXXXXX +を表示する事も可能です。 +.Pp +オプションは以下の通りです: +.Bl -tag -width Ds +.It Fl d +チェックを行うデバイスを指定します。 +.It Fl v +冗長に表示するよう指定します。 +成功すると、名前とリビジョンを報告します。 +失敗すると、どの比較に失敗したかを報告します。 +.It Fl c +現在実行中のカーネルをコンパイルした時の、 +.Dq Ar PCVT_XXXXXX +を #define した値を全て表示します。 +.Fl v +と +.Fl c +を共に指定すると、コンパイル時オプションの冗長な一覧を表示します。 +.Sh 戻り値 +.Bl -tag -width Ds +.Pp +.It Sy 0 +ドライバは pcvt であり、メジャー及びマイナ番号が一致 +.It Sy 1 +open または ioctl システムコールに失敗 +.It Sy 2 +ドライバの名前が不一致 +.It Sy 3 +名称は一致、しかしリリースメジャー番号が不一致 +.It Sy 4 +名称とメジャー番号は一致、しかしマイナ番号が不一致 +.It Sy 5 +使用方法の誤り +.El +.Pp +.Sh バグ +既知のものは有りません。 +.Sh 関連項目 +.Xr pcvt 4 diff --git a/ja_JP.eucJP/man/man8/joy.8 b/ja_JP.eucJP/man/man8/joy.8 new file mode 100644 index 0000000000..e3d00a783f --- /dev/null +++ b/ja_JP.eucJP/man/man8/joy.8 @@ -0,0 +1,46 @@ +.\" +.\" Copyright (c) 1996 Jean-Marc Zucconi <jmz@cabri.obs-besancon.fr> +.\" 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. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``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 DEVELOPERS 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: joy.8,v 1.1 1996/03/16 01:35:48 jmz Exp % +.\" jpman %Id: joy.8,v 1.3 1997/07/22 16:48:04 horikawa Stab % +.\" +.Dd March 16, 1996 +.Dt JOY 8 +.Os FreeBSD +.Sh 名称 +.Nm joy +.Nd ジョイスティックドライバのカーネルモジュールを読み込む。 +.Sh 書式 +.Nm joy +.Sh 解説 +.Nm +は、ジョイスティックドライバのカーネルモジュールを読み込みます。 +.Sh 関連ファイル +.Bl -tag -width /lkm/joy_mod.o +.It Pa /lkm/joy_mod.o +ジョイスティックの読み込み可能カーネルモジュール +.Sh 関連項目 +.Xr joy 4 , +.Xr modload 8 , +.Xr lkm 4 diff --git a/ja_JP.eucJP/man/man8/kernbb.8 b/ja_JP.eucJP/man/man8/kernbb.8 new file mode 100644 index 0000000000..10a7ba8601 --- /dev/null +++ b/ja_JP.eucJP/man/man8/kernbb.8 @@ -0,0 +1,68 @@ +.\" Copyright (c) 1983, 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. +.\" +.\" 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. +.\" +.\" %Id: kernbb.8,v 1.1.6.3 1997/10/12 11:51:46 max Exp % +.\" jpman %Id: kernbb.8,v 1.3 1997/08/16 13:16:53 horikawa Stab % +.\" +.Dd May 22, 1995 +.Dt KERNBB 8 +.Os FreeBSD 2.1 +.Sh 名称 +.Nm kernbb +.Nd カーネルの基本ブロックプロファイルバッファのダンプを生成する +.Sh 書式 +.Nm kernbb +.Sh 解説 +.Nm kernbb +は、動作中のカーネルの基本ブロックプロファイリングバッファを +ダンプするのに用いられるツールです。 +.Pp +動作中のカーネルにおいて、ソースファイルのうちの少なくとも一つは +.Fl a +オプション付きでコンパイルされている必要があります。 +.Pp +出力形式はアスキーであり、1 行に 1 レコードずつ表示されます。 +各レコードは以下のフィールドから成ります: ファイル名、行番号、 +手続き名、アドレス、カウント +.Sh 関連ファイル +.Bl -tag -width /dev/kmemx -compact +.It Pa /kernel +デフォルトのシステム +.It Pa /dev/kmem +デフォルトのメモリ +.El +.Sh 関連項目 +.Xr cc 1 +.Sh 作者 +.Nm +コマンドは +.An Poul-Henning Kamp +がカーネルサポートとともに記述しました。 diff --git a/ja_JP.eucJP/man/man8/keyadmin.8 b/ja_JP.eucJP/man/man8/keyadmin.8 new file mode 100644 index 0000000000..8db1d9ea27 --- /dev/null +++ b/ja_JP.eucJP/man/man8/keyadmin.8 @@ -0,0 +1,248 @@ +.\"# @(#)COPYRIGHT 1.1a (NRL) 17 August 1995 +.\" +.\"COPYRIGHT NOTICE +.\" +.\"All of the documentation and software included in this software +.\"distribution from the US Naval Research Laboratory (NRL) are +.\"copyrighted by their respective developers. +.\" +.\"This software and documentation were developed at NRL by various +.\"people. Those developers have each copyrighted the portions that they +.\"developed at NRL and have assigned All Rights for those portions to +.\"NRL. Outside the USA, NRL also has copyright on the software +.\"developed at NRL. The affected files all contain specific copyright +.\"notices and those notices must be retained in any derived work. +.\" +.\"NRL LICENSE +.\" +.\"NRL grants permission for redistribution and use in source and binary +.\"forms, with or without modification, of the software and documentation +.\"created at NRL 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 at the Information +.\" Technology Division, US Naval Research Laboratory. +.\" +.\"4. Neither the name of the NRL nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\"THE SOFTWARE PROVIDED BY NRL IS PROVIDED BY NRL 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 NRL 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. +.\" +.\"The views and conclusions contained in the software and documentation +.\"are those of the authors and should not be interpreted as representing +.\"official policies, either expressed or implied, of the US Naval +.\"Research Laboratory (NRL). +.\" +.\"----------------------------------------------------------------------*/ +.\" +.\" $ANA: keyadmin.8,v 1.3 1996/06/13 20:15:57 wollman Exp $ +.\" jpman %Id: keyadmin.8,v 1.2 1997/06/14 16:08:59 horikawa Stab % +.\" +.Dd June 13, 1996 +.Dt KEY 8 +.Os +.Sh 名称 +.Nm keyadmin +.Nd カーネルのキー管理データベースを手動管理する +.Sh 書式 +.Nm keyadmin +.Op Ar command Op Ar args +.Sh 解説 +.Nm +コマンドは、セキュリティの関係を +カーネルのキー/セキュリティ関係データベースに +手動で組み込むために使用します。( +.Xr key 4 +参照)。 +.Pp +.Xr key 4 +の API のほとんどは +.Nm keyadmin +を実行することにより特権ユーザが使用可能です。 +自動化されたキー管理プロトコルが実装されるまでは、 +.Nm +だけがセキュリティ関係を確立する方法でした。 +自動化されたキー管理プロトコルでは、 +.Xr routed 8 +や +.Xr gated 8 +がルーティングテーブルを管理するのと似た方法でキーデータベースを管理します。 +.Pp +.Nm +を引数無しで起動すると、対話モードとなり、ユーザは +.Dq Ar command Op Ar args +を対話的に入力可能です。 +引数を付けた場合は、 +.Nm +に単一の +.Dq Ar command Op Ar args +を入力することになります。 +.Ar command +は以下のいずれかです: +.Bl -inset +.It Nm del Ar type spi source destination +.Pp +.Ar source +と +.Ar destination +との間で、 +.Ar type +と +.Ar spi +であるセキュリティの関係を削除します。 +使用例: +.Bd -literal + delete esp 90125 anderson.yes.org rabin.yes.org +.Ed +.It Nm get Ar type spi source destination +.Pp +.Ar source +と +.Ar destination +との間で、 +.Ar type +と +.Ar spi +であるセキュリティの関係を取り出して表示します。 +使用例: +.Bd -literal + get ah 5150 eddie.vanhalen.com alex.vanhalen.com +.Ed +.It Nm dump +.Pp +セキュリティの関係を全て表示します。 +警告: 大量のデータを表示します。 +.It Nm load Ar filename +.Pp +セキュリティの関係を +.Xr keys 5 +に記載されたフォーマットのファイルからロードします。 +.Ar filename +に +.Dq - +を指定した場合、標準入力からキーを読みます。 +.It Nm save Ar filename +.Pp +セキュリティの関係を +.Xr keys 5 +に記載されたフォーマットのファイルにセーブします。 +.Ar filename +に +.Dq - +を指定した場合、標準出力にキーファイルを出力します。 +(軽い +.Nm dump +コマンドとして使用できます。) +注: save コマンドは新規ファイルを作成しなければなりません; +既存のファイルには書き込みません。 +誰でも読めるファイルや名前付きパイプや UNIX ソケットに書き込むことを避ける +ためです( +.Xr socket 2 +と +.Xr mkfifo 1 +を参照)。 +.It Nm help Op command +.Pp +引数無しでは短いヘルプを表示します。 +または指定したコマンドのヘルプを表示します。 +.It Nm flush +.Pp +カーネル内のセキュリティの関係の表を全て消去します。 +.El + +.Pp +以下の +.Ar command +は +.Nm keyadmin +.\" 原文では key となっていますが、keyadmin と改称されています。 +.\" horikawa@jp.freebsd.org (Jun 14 1997) +を対話モードで使用した場合のみ使用可能です: +.Bl -inset +.It Nm add Ar type spi source destination transform key +.Op Ar iv +.Pp +.Ar type +かつ +.Ar spi +の、 +.Ar source +から +.Ar destination +への、 +.Ar transform +を使った +.Ar key +のセキュリティの関係を追加します。 +transform が初期化ベクタを要求する場合、 +.Ar iv +にて指定します。 +このコマンドは対話モードでのみ使用可能です。 +.Nm +は引数ベクタの使用後に破壊しないからです。 +コマンドラインから入力で +.Nm add +を許すと、悪意有るユーザが +.Xr ps 1 +を使ってセキュリティキーを知り得てしまいます。 +使用例: +.Bd -literal + add esp 2112 temples.syrinx.org priests.syrinx.org des-cbc \\ + a652a476a652a476 87ac9876deac9876 +.Ed +.It Nm exit +.It Nm quit +.Pp +.Nm keyadmin +との対話を終了します。 +EOF も同様に +.Nm keyadmin +との対話を終了します。 +.El +.Sh 関連項目 +.Xr ipsec 4 , +.Xr key 4 , +.Xr route 4 , +.Xr gated 8 , +.Xr routed 8 + +.Sh 歴史 +.Nm +コマンドは NRL の +.Bx 4.4 +IPv6 networking distribution から登場しました。 +.Nm keyadmin +は Dan McDonald の空想から生を受け、 +Ran Atkinson, Dan McDonald, Craig Metz, Bao Phan の +非常な努力により誕生しました。 +NRL では元もと +.Nm key +と呼ばれていましたが、 +.Xr key 1 +と衝突しますので、 +.Nm keyadmin +と改称しました。 +.Sh バグ +名前参照を避けるために、 +.Xr route 8 +のように -n フラグが必要です。 +.Pp +現在は、dump と save コマンドは最初の 30 エントリほどを表示します。 diff --git a/ja_JP.eucJP/man/man8/kgmon.8 b/ja_JP.eucJP/man/man8/kgmon.8 new file mode 100644 index 0000000000..ceb7d7da08 --- /dev/null +++ b/ja_JP.eucJP/man/man8/kgmon.8 @@ -0,0 +1,123 @@ +.\" Copyright (c) 1983, 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. +.\" +.\" 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. +.\" +.\" @(#)kgmon.8 8.1 (Berkeley) 6/6/93 +.\" jpman %Id: kgmon.8,v 1.2 1997/05/03 13:42:22 horikawa Stab % +.\" +.Dd June 6, 1993 +.Dt KGMON 8 +.Os BSD 4.2 +.Sh 名称 +.Nm kgmon +.Nd オペレーティングシステムのプロファイルバッファのダンプを生成する +.Sh 書式 +.Nm kgmon +.Op Fl Bbhpr +.Op Fl M Ar core +.Op Fl N Ar system +.Sh 解説 +.Nm +は、オペレーティングシステムのプロファイリングを行うときに使うツールです。 +引数を指定しないときは、 +.Nm +はオペレーティングシステムのプロファイリングの状態、 +つまり、実行中か停止中か未設定か +.Pf ( Xr config 8 +を参照)を示します。 +.Fl p +が指定されると、 +.Nm +はオペレーティングシステムからプロファイルデータを取り出し、後で +.Xr gprof 1 +で分析できるようにファイル +.Pa gmon.out +を作ります。 +.Pp +オプションは以下の通りです: +.Bl -tag -width Ds +.It Fl B +高精度のプロファイルデータの収集を再開します。 +.It Fl b +低精度のプロファイルデータの収集を再開します。 +.It Fl h +プロファイルデータの収集を停止します。 +.It Fl p +プロファイルバッファの内容をファイル +.Pa gmon.out +にダンプします。 +.It Fl r +プロファイルバッファのすべての内容をリセットします。このとき +.Fl p +が指定 +されていると、バッファの内容をリセットする前に +.Pa gmon.out +に出力します。 +.It Fl M +名前のリストに関連する値を取り出す際、デフォルトの ``/dev/kmem'' のかわりに +指定した core を使います。 +.It Fl N +名前のリストを取り出す際に、デフォルトの ``/kernel'' のかわりに +指定した system を使います。 +.El +.Pp +.Fl B , +.Fl b , +.Fl h +のいずれも指定されなければ、プロファイル収集の状態は変化しません。 +たとえば、プロファイルデータの収集中に +.Fl p +が指定されると、 +プロファイリングは一時的に中断され、 +オペレーティングシステムのプロファイルバッファがダンプされ、 +すぐにプロファイリングが再開されます。 +.Sh 関連ファイル +.Bl -tag -width /dev/kmem -compact +.It Pa /kernel +デフォルトのカーネルファイル名 +.It Pa /dev/kmem +デフォルトのメモリファイル +.El +.Sh 関連項目 +.Xr gprof 1 , +.Xr config 8 +.Sh 診断 +.Pa /dev/kmem +にリードパーミッションしか持たないユーザは、プロファイル収集 +の状態を変更することができません。 +.Pa gmon.out +ファイルを得ることはできますが、 +プロファイリング実行中には、 +データに矛盾がでる可能性があるという警告が表示されます。 +.Sh 歴史 +.Nm +コマンドは +.Bx 4.2 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/kvm_mkdb.8 b/ja_JP.eucJP/man/man8/kvm_mkdb.8 new file mode 100644 index 0000000000..edb1455987 --- /dev/null +++ b/ja_JP.eucJP/man/man8/kvm_mkdb.8 @@ -0,0 +1,71 @@ +.\" Copyright (c) 1989, 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. +.\" +.\" 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. +.\" +.\" @(#)kvm_mkdb.8 8.1 (Berkeley) 6/9/93 +.\" jpman %Id: kvm_mkdb.8,v 1.3 1997/09/04 16:37:09 horikawa Stab % +.\" +.Dd June 9, 1993 +.Dt KVM_MKDB 8 +.Os +.Sh 名称 +.Nm kvm_mkdb +.Nd カーネルデータベースの作成 +.Sh 書式 +.Nm kvm_mkdb +.Op file +.Sh 解説 +.Nm +は、指定されたファイルに関する情報を含むデータベースを +.Pa /var/db +に作成します。 +ファイルが指定されない場合は、デフォルトで +.Pa /kernel +が用いられます。 +作成されるファイル名は ``kvm_filename.db'' となります。 +ここで ``filename'' は読み込んだファイルの名前です。 +様々なライブラリルーチンがこのデータベースを参照します。 +現在格納されている情報は、カーネルの名前リストだけです。 +名前リストは +.Xr kvm_nlist 3 +関数で利用されますが、将来はこのデータベースに +現システムに関する他の静的情報も含まれるようになるでしょう。 +.Sh 関連ファイル +.Bl -tag -width /var/db/kvm_kernel.db -compact +.It Pa /kernel +.It Pa /var/db/kvm_kernel.db +.El +.Sh 関連項目 +.Xr kvm_nlist 3 +.Sh 歴史 +.Nm +ユーティリティは +.Bx 4.4 +で初めて登場しました。 diff --git a/ja_JP.eucJP/man/man8/kzip.8 b/ja_JP.eucJP/man/man8/kzip.8 new file mode 100644 index 0000000000..9e41f06234 --- /dev/null +++ b/ja_JP.eucJP/man/man8/kzip.8 @@ -0,0 +1,74 @@ +.\" +.\" Copyright (c) 1996 David E. O'Brien +.\" +.\" 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. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``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 DEVELOPERS 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: kzip.8,v 1.1.2.1 1997/07/21 11:56:34 charnier Exp % +.\" jpman %Id: kzip.8,v 1.3 1997/08/16 13:18:54 horikawa Stab % +.\" +.Dd August 15, 1996 +.Os +.Dt KZIP 8 +.Sh 名称 +.Nm kzip +.Nd カーネルを圧縮する +.Sh 書式 +.Nm kzip +.Op Fl v +.Op Fl l Ar loadaddr +.Sh 解説 +このプログラムは、 +.Xr gzip 1 +を用いてカーネルを圧縮し、ディスク容量を節約します。 +メモリ上にロードされた後の、メモリ使用量を減らすわけでは有りません。 +シンボル情報は全て失われるので、利用法は限られます。 +主な利用目的は、インストールフロッピや fixit フロッピ等のための +カーネルを作成することです。 +.Pp +次のオプションが利用可能です: +.Bl -tag -width flag +.It Fl v +詳細出力モード。圧縮後のカーネルが使用するメモリ量を報告します。 +そのカーネルが 4MB 境界を越えていないことも確認できます。 +.It Fl l Ar loadaddr +カーネルをメモリ上にロードするアドレスを指定します。 +.Sh 診断 +.Nm +ユーティリティは、与えられた引数が不正の場合、終了コード 1 で終了します。 +終了コードが 2 である場合は、 +.Nm +がカーネルファイルを読めないか、処理できないことを示しています。 +.Sh 関連項目 +.Xr gzip 1 +.\" .Sh 規格 +.Sh 歴史 +.Nm +コマンドは +.Fx 2.0.5 +から登場しました。 +Linux から 386BSD を経て取り込まれました。 +Linus Torvalds の tools/build.c がベースになっており、 +Serge Vakulenko が 386BSD に移植しました。 +.Sh 作者 +このマニュアルページは David E. O'Brien が記述しました。 +.\" .Sh バグ diff --git a/ja_JP.eucJP/man/man8/ldconfig.8 b/ja_JP.eucJP/man/man8/ldconfig.8 new file mode 100644 index 0000000000..d8ba383039 --- /dev/null +++ b/ja_JP.eucJP/man/man8/ldconfig.8 @@ -0,0 +1,157 @@ +.\" +.\" Copyright (c) 1993 Paul Kranenburg +.\" 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 Paul Kranenburg. +.\" 3. 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: ldconfig.8,v 1.9.2.2 1997/08/08 02:18:07 jdp Exp % +.\" jpman %Id: ldconfig.8,v 1.3 1997/07/22 16:49:42 horikawa Stab % +.\" +.Dd October 3, 1993 +.Dt LDCONFIG 8 +.Os FreeBSD +.Sh 名称 +.Nm ldconfig +.Nd 共有ライブラリのキャッシュを設定する +.Sh 書式 +.Nm ldconfig +.Op Fl mrsv +.Op Fl f Ar hints_file +.Op Ar directory | file Ar ... +.Sh 解説 +.Nm +は、実効時リンカ +.Xr ld.so 1 +が、複数のディレクトリから利用可能な共有ライブラリを速く捜し出せるよう +につかわれる +.Dq ヒント +の集合を準備するために使われます。 +コマンドは、組み込みのシステムディレクトリと +コマンドラインで指定された任意の +.Ar ディレクトリ +(を指定された順番) で共有ライブラリを探し、 +その結果を +.Pa /var/run/ld.so.hints +に保存します。 +これは、 +.Xr ld.so 1 +が要求された共有ライブラリを読み込む際のディレクトリ検索操作 +オーバヘッドをあらかじめ払っていることになります。 +.Pp +コマンドラインにて指定するファイル名は共有ライブラリを検査するディクトリ +を含むことが期待されます。 +各ディレクトリのパス名は改行文字から始まる必要があります。 +空行およびコメント文字 +.Ql \&# +から始まる行は無視されます。 +このファイルの標準の名前は、 +.Xr /etc/ld.so.conf. +です。 +.Pp +共有ライブラリは、実行されようとするプログラムによって必要とされる +ならば、利用可能なものが自動的に読み込まれることになります。 +これは、実行形式に検索パスを保存する必要性を無くします。 +.Pp +.Ev LD_LIBRARY_PATH +環境変数は、キャッシュから使用するディレクトリ (や、その順序関係) を +上書きしたり、共有ライブラリを探す追加のディレクトリを +指定するために使われます。 +.Ev LD_LIBRARY_PATH +は、共有ライブラリを読み込む必要がある時、 +.Xr ld.so 1 +によって検索されるディレクトリパスのリストを +コロン +.Sq \: +で区切って指定します。 +これは、 +.Xr ld 1 +における +.Fl L +オプションと、実行時点では等価です。 +.Pp +.Nm ldconfig +は典型的にはブート時の手続きのひとつとして実行されます。 +.Pp +以下のオプションが +.Nm ldconfig +で認識されます。 +.Bl -tag -width indent +.It Fl f Ar hints_file +.Pa /var/run/ld.so.hints +の変わりに、 +特定のヒントファイルを読み込んだり、更新したり、その両方を +行ったりします。 +このオプションは、テストのために提供されています。 +.It Fl m +ヒントファイルの内容を指定されたディレクトリで見付かったものに +置き換える代わりに、新しいディレクトリの内容を +.Dq 併合 (merge) +します。 +以前の +.Nm +の実行によってヒントファイル内に記録されているディレクトリも、 +新しい共有ライブラリのために再び検索されます。 +.It Fl r +現在のヒントファイルの中身について、標準出力に表示します。 +ヒントファイルは変更されません。 +.It Fl s +共有ライブラリのために、システムの組み込みディレクトリ +.Pq Dq /usr/lib +を検索しません。 +.It Fl v +冗長モードに切替えます。 +.Sh セキュリティ +.Ev セット uid (set-user-Id) +プログラムのアドレス空間に共有ライブラリを読み込む時には、 +特別の注意をしなければなりません。 +そのようなプログラムが実行される時はいつでも、 +.Nm ld.so +はヒントファイルからだけ共有ライブラリを読み込みます。 +特に、 +.Ev LD_LIBRARY_PATH +は、ライブラリを探すためには使われません。 +したがって、 ldconfig の役割には二つあります。 +素早い検索のためにヒント集合を作成することに加えて、 +共有オブジェクトが共有ライブラリを安全に読み込むことができる +ディレクトリの集まりを特定することも、その役割です。 +.Nm ldconfig +によって特定されたディレクトリ集合は、システム管理者の制御下にあること +が仮定されています。 +.Sh 関連ファイル +.Bl -tag -width /var/run/ld.so.hintsxxx -compact +.It Pa /var/run/ld.so.hints +デフォルトの +.Dq ヒント +ファイル。 +.It Pa /etc/ld.so.conf +標準の構成ファイル。 +.Sh 関連項目 +.Xr ld 1 , +.Xr link 5 +.Sh 歴史 +.Nm +ユーティリティーは SunOS 4.0 ではじめに現れました。 +現在の形は、 FreeBSD 1.1 からです。 diff --git a/ja_JP.eucJP/man/man8/linux.8 b/ja_JP.eucJP/man/man8/linux.8 new file mode 100644 index 0000000000..ad111cd5e3 --- /dev/null +++ b/ja_JP.eucJP/man/man8/linux.8 @@ -0,0 +1,45 @@ +.\" +.\" Copyright (c) 1997 +.\" The FreeBSD Project. 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. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``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 DEVELOPERS 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: linux.8,v 1.1 1997/01/10 05:48:50 mpp Exp % +.\" jpman %Id: linux.8,v 1.3 1997/07/22 16:50:43 horikawa Stab % +.\" +.Dd January 9, 1997 +.Dt LINUX 8 +.Os FreeBSD +.Sh 名称 +.Nm linux +.Nd Linux エミュレータのカーネルモジュールを読み込む +.Sh 書式 +.Nm linux +.Sh 解説 +.Nm +は、 Linux エミュレータのカーネルモジュールを読み込みます。 +.Sh 関連ファイル +.Bl -tag -width /lkm/linux_mod.o +.It Pa /lkm/linux_mod.o +Linux エミュレータの読み込み可能カーネルモジュール +.Sh 関連項目 +.Xr lkm 4 , +.Xr modload 8 diff --git a/ja_JP.eucJP/man/man8/locate.updatedb.8 b/ja_JP.eucJP/man/man8/locate.updatedb.8 new file mode 100644 index 0000000000..bcfec558fe --- /dev/null +++ b/ja_JP.eucJP/man/man8/locate.updatedb.8 @@ -0,0 +1,70 @@ +.\" Copyright (c) 1996 +.\" Mike Pritchard <mpp@FreeBSD.org>. 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 Mike Pritchard. +.\" 4. Neither the name of the author nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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. +.\" +.\" jpman %Id: locate.updatedb.8,v 1.3 1997/09/04 16:39:10 horikawa Stab % +.Dd February 11, 1996 +.Dt LOCATE.UPDATEDB 8 +.Os BSD 4.4 +.Sh 名称 +.Nm locate.updatedb +.Nd locate データベースの更新 +.Sh 書式 +.Nm /usr/libexec/locate.updatedb +.Sh 解説 +.Nm locate.updatedb +は、 +.Xr locate 1 +で使用されるデータベースの更新を行います。 +通常は、 +.Pa /etc/weekly +スクリプト +により週に一度実行されます。 +.Pp +新規に構築されるデータベースの内容は、 +.Pa /etc/locate.rc +ファイル +を用いて設定することが出来ます。 +.Sh 関連ファイル +.Bl -tag -width /var/db/locate.database -compact +.It Pa /var/db/locate.database +デフォルトのデータベース +.It Pa /etc/locate.rc +設定ファイル +.El +.Sh 関連項目 +.Xr locate 1 +.Rs +.%A Woods, James A. +.%D 1983 +.%T "Finding Files Fast" +.%J ";login" +.%V 8:1 +.%P pp. 8-10 +.Re diff --git a/ja_JP.eucJP/man/man8/lpc.8 b/ja_JP.eucJP/man/man8/lpc.8 new file mode 100644 index 0000000000..dfdb80fca4 --- /dev/null +++ b/ja_JP.eucJP/man/man8/lpc.8 @@ -0,0 +1,176 @@ +.\" Copyright (c) 1983, 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. +.\" +.\" 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. +.\" +.\" @(#)lpc.8 8.5 (Berkeley) 4/28/95 +.\" jpman %Id: lpc.8,v 1.2 1997/05/23 00:47:48 mutoh Stab % +.\" +.Dd April 28, 1995 +.Dt LPC 8 +.Os BSD 4.2 +.Sh 名称 +.Nm lpc +.Nd ラインプリンタの制御を行う +.Sh 書式 +.Nm lpc +.Oo +.Ar command +.Op Ar argument ... +.Oc +.Sh 解説 +.Nm +は、システム管理者がラインプリンタの動作を制御するために使われます。 +各ラインプリンタのコンフィギュレーションは +.Pa /etc/printcap +で行います。 +.Nm +は以下の目的で利用します。 +.Bl -bullet -offset indent +.It +プリンタの利用可能/不可能の設定を行う +.It +スプールキューへのジョブ投入可能/不可能の設定を行う +.It +スプールキュー内のジョブの順番を並べ直す +.It +プリンタ、スプールのキュー、およびプリンタデーモンのステータスを調べる +.El +.Pp +引数なしの場合、 +.Nm +は標準入力からコマンドを読むためにプロンプトを出します。 +引数をつけた場合、第 1 引数をコマンドとし、残りの引数を +そのコマンドのパラメータと解釈します。 +標準入力をリダイレクトして、 +.Nm +にファイルからコマンドを読み込ませることもできます。 +コマンドは略して書くことができます。 +利用可能なコマンドを以下に列挙します。 +.Pp +.Bl -tag -width Ds -compact +.It Ic \&? No [ command ... ] +.It Ic help No [ command ... ] +引数で指定したコマンドの簡単な説明を表示します。引数がないときはコマンド +の一覧を表示します。 +.Pp +.It Ic abort No {\ all\ |\ printer\ } +ローカルホスト上の動作中のスプールデーモンをただちに終了させ、指定した +プリンタをプリントアウトできないように( +.Xr lpr 1 +が新しいデーモンをスタートさせないように)します。 +.Pp +.It Ic clean No {\ all\ |\ printer\ } +ローカルマシン上の指定したプリンタのキューから、出力できない(すなわち、 +完全なプリンタジョブの形になっていない)テンポラリファイル、データファイル、 +コントロールファイルをすべて削除します。 +.Pp +.It Ic disable No {\ all\ |\ printer\ } +指定したプリンタのキューをオフにします。これにより、 +.Xr lpr 1 +によって新しいプリンタジョブがキューに入らないようになります。 +.Pp +.It Ic down No {\ all\ |\ printer\ } message ... +指定したプリンタのキューをオフにし、プリントアウトできないようにし、 +プリンタのステータスファイルに +.Em message +を書きます。メッセージは引用符で囲む必要はなく、残りの引数は +.Xr echo 1 +と同様に扱われます。通常、この +コマンドはプリンタをダウンさせ、ユーザに対しそのダウンの理由を +.Xr lpq 1 +によって説明させるために使われます。 +.Pp +.It Ic enable No {\ all\ |\ printer\ } +指定したプリンタ用のキューのスプーリングを行うようにします。これは、 +.Xr lpr 1 +で新しいプリンタジョブをスプールキューに挿入することができるよ +うにします。 +.Pp +.It Ic exit +.It Ic quit +lpc を終了させます。 +.\" ne 1i +.Pp +.It Ic restart No {\ all\ |\ printer\ } +新しいプリンタデーモンの再スタートを試みます。このコマンドは、異常な +状態になって突然デーモンが死に、キュー内にジョブが残ったままになった場合に +有効です。この状態が起きたときには、 +.Xr lpq 1 +は現在デーモンが動いていないことを報告します。 +もしあなたがスーパユーザなら、現在動いているデーモンを先に殺してください +(つまり、動かなくなったデーモンを殺してから再スタートさせるわけです)。 +.Pp +.It Ic start No {\ all\ |\ printer\ } +指定したプリンタを出力可能にしてスプールデーモンをスタートさせます。 +.Pp +.It Ic status No {\ all\ |\ printer\ } +ローカルマシン上のデーモンとキューの状態を表示します。 +.Pp +.It Ic stop No {\ all\ |\ printer\ } +現行のジョブが終了したあとでデーモンのスプーリングをストップさせ、 +プリントアウトできないようにします。 +.Pp +.It Ic topq No printer\ [\ jobnum\ ...\ ]\ [\ user\ ...\ ] +引数に並べた順番で、ジョブをキューの先頭に移動させます。 +.Pp +.It Ic up No {\ all\ |\ printer\ } +すべての状態を可能状態(enable)にし、新しいプリンタデーモンをスタートさせます。 +.Ic down +の逆です。 +.Sh 関連ファイル +.Bl -tag -width /var/spool/*/lockx -compact +.It Pa /etc/printcap +プリンタの設定を記述するファイル +.It Pa /var/spool/* +スプールディレクトリ +.It Pa /var/spool/*/lock +プリンタキューの制御を行うためのロックファイル +.El +.Sh 関連項目 +.Xr lpq 1 , +.Xr lpr 1 , +.Xr lprm 1 , +.Xr printcap 5 , +.Xr lpd 8 +.Sh 診断 +.Bl -tag -width Ds +.It Sy "?Ambiguous command" +コマンド指定が省略し過ぎのため、複数のコマンドにマッチしています。 +.It Sy "?Invalid command" +マッチするコマンドがありません。 +.It Sy "?Privileged command" +"operator" グループのメンバーかルートでなければこのコマンドは +実行できません。 +.El +.Sh 歴史 +.Nm +コマンドは +.Bx 4.2 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/lpd.8 b/ja_JP.eucJP/man/man8/lpd.8 new file mode 100644 index 0000000000..b64b7cabbd --- /dev/null +++ b/ja_JP.eucJP/man/man8/lpd.8 @@ -0,0 +1,258 @@ +\" Copyright (c) 1983, 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. +.\" +.\" 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. +.\" +.\" @(#)lpd.8 8.3 (Berkeley) 4/19/94 +.\" jpman %Id: lpd.8,v 1.2 1997/03/31 13:34:37 horikawa Stab % +.\" +.Dd April 19, 1994 +.Dt LPD 8 +.Os BSD 4.2 +.Sh 名称 +.Nm lpd +.Nd ラインプリンタ・スプーラ・デーモン +.Sh 書式 +.Nm lpd +.Op Fl dl +.Op Ar port# +.Sh 解説 +.Nm +はラインプリンタのためのデーモン(スプール領域を管理するプログラム)で、 +通常はブート時に +.Xr rc 8 +ファイルから起動されます。このデーモンは、接続されているプリンタの情報を +.Xr printcap 5 +ファイルを一通り読み込むことによって取得し、クラッシュ後に残っていた +ファイルがあれば印刷します。その後、システムコールの +.Xr listen 2 +と +.Xr accept 2 +を用いてキュー内のファイルの印刷・スプール領域へのファイル転送・ +キューの表示・キューからのジョブの削除などの要求を受け付けます。 +何か要求があるとlpd は子プロセスを fork してその要求を処理するので、 +親プロセスは続けて次の要求待ちをできるようになっています。 +.Pp +使用できるオプション: +.Bl -tag -width Ds +.It Fl d +インターネットで listen するソケットにて +.Dv SO_DEBUG +をオンにします( +.Xr setsockopt 2 +参照)。 +.It Fl l +.Fl l +オプションを +つけると、 +.Nm +はネットワークから受けとった正当な要求について記録をとるようになります。 +これはデバッグを行う際に有用です。 +.It Ar "port#" +他のプロセスと接続するのに用いる +インターネットポート番号は通常 +.Xr getservbyname 3 +を使って取得しますが、引数 +.Ar port# +を使って変更することも可能です。 +.El +.Pp +プリンタへのアクセス制限は二つの手段を用いて行われます。第一に、全ての要求は +.Pa /etc/hosts.equiv +ファイルもしくは +.Pa /etc/hosts.lpd +ファイルに列挙さ +れているマシンからのものでなければなりません。第二に、アクセスされるプリ +ンタに関する +.Xr printcap +エントリに +.Li rs +特性の指定があると、 +.Em lpr +からの要求はそのプリンタが接続されているマシンにアカウントを持つ +ユーザのものしか受け付けられなくなります。 +.Pp +各スプールディレクトリ内に +.Em minfree +というファイルを作成し、空きとして残しておくディスクのブロック数を +書いておけば、ラインプリンタキューがディスクを使い尽くしてしまわないよう +にできます。 +.Em minfree +ファイルは任意のテキストエディタを使って +編集できます。 +.Pp +このデーモンは、プリンタへのアクセスを +排他的に行うためのロック(後述)を行ったうえで +ファイルの処理を開始し、スプール +ディレクトリの中に +.Em cf +で始まる名前のファイルがあるかどうかを調べます。 +.Em cf +ファイルの内容は印刷すべきファイルの名前もしくは印刷以外で行うべき +何らかの動作を示しています。ファイル中の各行はキー文字から始まっており、 +その行の残りの部分と合わせてどのような動作を行うべきかを表しています。 +.Bl -tag -width Ds +.It J +ジョブ名(job name)。バーストページに印刷されるジョブ名として用いられる文字列。 +.It C +分類(classification)。バーストページに印刷される分類行に用いられる +文字列。 +.It L +リテラル(literal)。この行はパスワードファイルから取り出したID情報を +保持しており、この行があると見出しページが印刷されます。 +.It T +表題(title)。 +.Xr pr 1 +で表題として使用される文字列。 +.It H +ホスト名(host name)。 +.Xr lpr 1 +が実行されたマシンの名前。 +.It P +人物(person)。 +.Xr lpr 1 +を実行した人物のログイン名。これは +.Xr lprm 1 +がジョブの所有権を調べる際に使用されます。 +.It M +現在の印刷ジョブが完了した時、指定のユーザにメールを送ります。 +.It f +整形済みファイル(formatted file)。すでに整形済みである印刷ファイルの名前。 +.It l +``f''とほぼ同じですが、制御文字を通すことと改ページを行わない点が異なります。 +.It p +フィルタとして +.Xr pr 1 +を使用して印刷すべきであるファイルの名前。 +.It t +troffファイル。ファイルの内容が +.Xr troff 1 +の出力結果であることを示します。 +.It n +ditroff ファイル。ファイルの内容がデバイス独立troff +の出力結果であることを示します。 +.It r +DVI ファイル。ファイルの内容が +.Xr TeX l +の出力する DVI 形式であることを示します。 +.It g +graph ファイル。ファイルの内容が +.Xr plot 3 +の生成したデータであることを示します。 +.It c +cifplot ファイル。ファイルの内容が +.Em cifplot +の生成したデータであることを示します。 +.It v +ファイルの内容がラスタイメージであることを示します。 +.It r +ファイルの内容が FORTRAN のキャリッジ制御文字を伴った +テキストデータであることを示します。 +.It \&1 +troff R フォント。デフォルトのものに代えて使用するフォントファイルの名前。 +.It \&2 +troff I フォント。デフォルトのものに代えて使用するフォントファイルの名前。 +.It \&3 +troff B フォント。デフォルトのものに代えて使用するフォントファイルの名前。 +.It \&4 +troff S フォント。デフォルトのものに代えて使用するフォントファイルの名前。 +.It W +幅(width)。 +.Xr pr 1 +および他のテキストフィルタが使用するページ幅(文字数)を変更します。 +.It I +字下げ(indent)。字下げの文字数がASCIIで書かれています。 +.It U +リンク解除(unlink)。印刷完了時に消去するファイルの名前。 +.It N +ファイル名(file name)。印刷中のファイルの名前。ファイルが標準 +入力の場合( +.Xr lpr +がパイプラインの中で実行された場合)は空白になっています。 +.El +.Pp +何らかのファイルがオープンできない場合、 +.Xr syslog 3 +を通じて +.Em LOG_LPR +機能分類でメッセージが記録されます。 +.Nm +は最大20回まで目的のファイルのオープンを試みますが、それでも失敗すると +そのファイルに関わる印刷処理は飛ばします。 +.Pp +.Nm +は、ロックファイルを排他的にアクセスする目的あるいは複数のデーモンが同時 +にアクティブになるのを回避する目的で +.Xr flock 2 +を使用します。デーモンが kill されたり異常終了した場合でもロックファイルを +削除する必要はありません。ロックファイルは普通に読むことができるASCII形式で +書かれており、2行からなります。1行目はデーモンのプロセスIDで、2行目は +現在実行中であるジョブの制御ファイル名です。2行目は +.Xr lpq 1 +および +.Xr lprm 1 +が使用できるよう、常に +.Nm +の現在の状態を示すように更新されています。 +.Sh 関連ファイル +.Bl -tag -width "/var/spool/*/minfree" -compact +.It Pa /etc/printcap +プリンタ記述ファイル +.It Pa /var/spool/* +スプールディレクトリ群 +.It Pa /var/spool/*/minfree +最低限残しておく空き領域の設定 +.It Pa /dev/lp* +ラインプリンタデバイス +.It Pa /var/run/printer +ローカルな要求のためのソケット +.It Pa /etc/hosts.equiv +プリンタへのアクセスを許可されているマシンの一覧 +.It Pa /etc/hosts.lpd +プリンタへのアクセスは許可されているが、同一の管理権限下には +置かれていないマシンの一覧 +.El +.Sh 関連項目 +.Xr lpq 1 , +.Xr lpr 1 , +.Xr lprm 1 , +.Xr setsockopt 2 , +.Xr syslog 3 , +.Xr hosts.lpd 5 , +.Xr printcap 5 , +.Xr lpc 8 , +.Xr pac 8 +.Rs +.%T "4.2 BSD Line Printer Spooler Manual" +.Re +.Sh 歴史 +.Nm +プログラムは +.At v6 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/lptcontrol.8 b/ja_JP.eucJP/man/man8/lptcontrol.8 new file mode 100644 index 0000000000..3993155dc0 --- /dev/null +++ b/ja_JP.eucJP/man/man8/lptcontrol.8 @@ -0,0 +1,78 @@ +.\" +.\" lptcontrol - a utility for manipulating the lpt driver +.\" +.\" 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. +.\" +.\" +.\" %Id: lptcontrol.8,v 1.3.2.2 1997/09/29 06:30:31 charnier Exp % +.\" jpman %Id: lptcontrol.8,v 1.3 1997/08/16 13:20:55 horikawa Stab % +.Dd September 3, 1994 +.Dt LPTCONTROL 8 +.Os FreeBSD 2 +.Sh 名称 +.Nm \&lptcontrol +.Nd lpt プリンタドライバ操作ユーティリティ +.Sh 書式 +.Nm \&lptcontrol +.Cm -i +| +.Cm -p +.Op Fl u Ar unit no +.Sh 解説 +.Nm +コマンドは、各 +.Xr lpt 4 +デバイスの割り込み駆動モード/ポーリングモードを設定するのに用いられます。 +プリンタが割り込み駆動モード/ポーリングモード間で切り替えられると、 +その切り替えは次回デバイスがオープンされたときに有効になります。 +.Sh オプション +.TP +以下のコマンドラインオプションがサポートされています: +.Bl -tag -width indent +.It Fl i +割り込み駆動モードにします。 +.It Fl p +ポーリングモードにします。 +.It Fl u Ar n +.Em n +で指定されたプリンタデバイスのモードを設定します。 +.Em n +のデフォルト値は +.Em 0 +(つまり +.Pa /dev/lpt0 +)です。 +.El +.Pp +.Fl i +または +.Fl p +のいずれか一方を必ず指定しなければなりません。 +.Pp +.Sh 関連ファイル +.Bl -tag -width /sys/i386/conf/GENERIC -compact +.It Pa /dev/lpt? +プリンタデバイス。 +.It Pa /dev/lpctl? +プリンタ制御デバイス。 +.It Pa /sys/i386/conf/GENERIC +カーネル構成ファイル。 +.El +.Sh バグ +きっといくつかあるでしょう。 +.Sh 関連項目 +.Xr lpt 4 +.Sh 作者 +.An Geoffrey M. Rehmet +.Sh 歴史 +.Nm +は +.Fx 1.1.5 +で初めて登場しました。 diff --git a/ja_JP.eucJP/man/man8/mail.local.8 b/ja_JP.eucJP/man/man8/mail.local.8 new file mode 100644 index 0000000000..89cdbe3b07 --- /dev/null +++ b/ja_JP.eucJP/man/man8/mail.local.8 @@ -0,0 +1,114 @@ +.\" 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. +.\" +.\" 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 1996/09/22 21:54:05 wosch Exp % +.\" jpman %Id: mail.local.8,v 1.2 1997/03/31 13:35:26 horikawa Stab % +.\" +.Dd December 11, 1993 +.Dt MAIL.LOCAL 8 +.Os +.Sh 名称 +.Nm mail.local +.Nd メールボックスにメールを格納する +.Sh 書式 +.Nm mail.local +.Op Fl f Ar from +.Op Fl b +.Ar user ... +.Sh 解説 +.Nm mail.local +は EOF がくるまで標準入力から読み込みを行い、 +それらを各 +.Ar user +の +.Pa mail +ファイルに追加します。 +.Ar user +は、有効なユーザ名でなければなりません。 +.Pp +オプション: +.Bl -tag -width xxxfrom +.It Fl f Ar from +送り手の名前を指定します。 +.It Fl b +.Dq biff +サービスに通知する事をやめます。 +.El +.Pp +メールボックスのなかの個々のメッセージは、 +空行に続く +``From '' +という文字列からはじまる行によって区切られます。 +``From'' という文字列、送り手 (sender) の名前、 +時刻 (time stamp) を含む行が配送されたメールそれぞれに +付加されます。 +空行がそれぞれのメッセージに追加されます。 +大なり記号 +(``>'') は ``From '' によって誤って別のメッセージとして処理 +される可能性のある行の行頭に付加されます。 +.Pp +メールファイルはメールが追加されている間は +.Xr flock 2 +によって排他的にロックされます。 +.Pp +.Xr getservbyname 3 +が ``biff'' を返すと、 +biff サーバにメールの配送が伝えられます。 +.Pp +.Nm mail.local +は成功すれば 0 を、失敗すれば 0 より大きな値を返します。 +.Sh 環境変数 +.Bl -tag -width indent +.It Ev TZ +タイムスタンプを記録する際に適切なタイムゾーンを設定します。 +.El +.Sh 関連ファイル +.Bl -tag -width /tmp/local.XXXXXX -compact +.It Pa /tmp/local.XXXXXX +テンポラリファイル +.It Pa /var/mail/user +ユーザのメールボックスディレクトリ +.El +.Sh 関連項目 +.Xr mail 1 , +.Xr flock 2 , +.Xr getservbyname 3 , +.Xr comsat 8 , +.Xr sendmail 8 +.Sh 歴史 +スーパセットの +.Nm mail.local +(メールボックスを読む際、配送時と同様に扱います) は +.At v7 +から、 +.Nm mail +として現れました。 diff --git a/ja_JP.eucJP/man/man8/mailstats.8 b/ja_JP.eucJP/man/man8/mailstats.8 new file mode 100644 index 0000000000..d7faf5b509 --- /dev/null +++ b/ja_JP.eucJP/man/man8/mailstats.8 @@ -0,0 +1,82 @@ +.\"/* +.\" * 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.3 1997/06/28 08:08:11 peter Exp % +.\" 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 の利用統計を表示する +.Sh 書式 +.Nm mailstats +.Op Fl o +.Op Fl C Ar sendmail.cf +.Op Fl f Ar sendmail.st +.Sh 解説 +.Nm mailstats +は、sendmail を利用したメッセージのサイズなどの +統計情報をメーラ毎に表示します。 +出力の各行は、 +.Fl o +フラグが指定された場合を除き、 +メーラ番号、受け取ったメール数、受け取ったバイト数、 +送ったメール数、送ったバイト数、メーラの種類から構成されています。 +メーラの一般的な物には smtp や local (例えば、 +.Nm mail.local +等のローカルに配送されるメールを処理するプログラム) があります。 +.Pp +統計情報は +.Nm sendmail +統計ファイル +.Ar sendmail.st +から読み込まれます。 +.Ar sendmail.st +の場所は +.Ar sendmail.cf +で定義されていますが、 +.Fl f +フラグで指定することもできます。 +同様に、メーラの種類も +.Ar sendmail.cf +で定義されています。統計情報は、累積されていきます。情報をリセットするには +統計ファイルの内容を消す必要があります。 +.Sh 関連ファイル +.Bl -tag -width /var/log/sendmail.st -compact +.It Pa /etc/sendmail.cf +sendmail 設定ファイル +.It Pa /var/log/sendmail.st +メール統計情報データベース +.El +.Sh 関連項目 +.Xr sendmail 8 , +.Xr mail.local 8 diff --git a/ja_JP.eucJP/man/man8/makekey.8 b/ja_JP.eucJP/man/man8/makekey.8 new file mode 100644 index 0000000000..79a6bd7625 --- /dev/null +++ b/ja_JP.eucJP/man/man8/makekey.8 @@ -0,0 +1,60 @@ +.\" Copyright (c) 1990, 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. +.\" +.\" 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. +.\" +.\" @(#)makekey.8 8.2 (Berkeley) 12/11/93 +.\" %Id: makekey.8,v 1.5 1996/09/22 21:54:13 wosch Exp % +.\" jpman %Id: makekey.8,v 1.2 1997/05/21 07:56:47 yugawa Stab % +.\" +.Dd December 11, 1993 +.Dt MAKEKEY 8 +.Os +.Sh 名称 +.Nm makekey +.Nd 暗号キーやパスワードを作成する +.Sh 書式 +.Nm makekey +.Sh 解説 +.Nm makekey +は標準入力から読み込んだキーと隠しキーを暗号化し、 +結果を標準出力へ書き込みます。 +キーは10バイト、隠しキーは2バイトであること期待されます。 +キーと隠しキーはどんな文字を含んでよいか、 +どうやって暗号化計算が行なわれるか、の詳しい情報は +.Xr crypt 3 +を参照のこと。 +.Sh 関連項目 +.Xr login 1 , +.Xr crypt 3 +.Sh 歴史 +.Nm +コマンドは +.At v7 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/makemap.8 b/ja_JP.eucJP/man/man8/makemap.8 new file mode 100644 index 0000000000..d809083fd2 --- /dev/null +++ b/ja_JP.eucJP/man/man8/makemap.8 @@ -0,0 +1,218 @@ +.\" 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. +.\" +.\" 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 +.\" jpman %Id: makemap.8,v 1.3 1997/07/26 21:58:03 horikawa Stab % +.\" +.Dd November 16, 1992 +.Dt MAKEMAP 8 +.Os BSD 4.4 +.Sh 名称 +.Nm makemap +.Nd sendmail 用のデータベースマップを作成する +.Sh 書式 +.Nm makemap +.Op Fl N +.Op Fl d +.Op Fl f +.Op Fl o +.Op Fl r +.Op Fl v +.Ar maptype +.Ar mapname +.Sh 解説 +.Nm +は、 +.Xr sendmail 8 +がキー付きマップを検索する際に用いるデータベースマップを作成します。 +これは標準入力から読み込みを行い、指定された +.Ar mapname +に出力を行います。 +.Pp +コンパイル方法に依存しますが、 +.Nm +は最大 3 種類のデータベースフォーマットを扱います。 +扱うフォーマットは +.Ar maptype +で指定します。 +.Ar maptype +には、以下のようなものがあります。 +.Pp +.Bl -tag -width Fl +.It Li dbm +.Tn DBM +フォーマットマップ。 +.Xr ndbm 3 +ライブラリが必要です。 +.It Li btree +B-Treeフォーマットマップ。 +新しい Berkeley +.Xr db 3 +ライブラリが必要です。 +.It Li hash +ハッシュフォーマットマップ。 +同じく +.Xr db 3 +ライブラリが必要です。 +.El +.Pp +すべてのフォーマットで、 +.Nm makemap +は標準入力から空白文字で区切られた 2 つの単語を読み込みます。 +最初の単語はデータベースキーで、2番目の単語がその値です。 +値が +``%\fIn\fP'' +.Pf ( Ar n +は数字)という文字列を含んでいると、sendmail がパラメータ置換を行います。 +.Dq % +という文字を含めるには、``%%'' とする必要があります。 +空行や ``#'' から始まる行は無視されます。 +.Pp +.Ss フラグ +.Bl -tag -width Fl +.It Fl N +文字列の終端記号として、ヌル文字もマップに含めます。 +これは、sendmail.cf の ``K'' 行における \-N フラグと一致していなければ +なりません。 +.It Fl d +マップ中に重複するキーが存在することを許します。 +B-Treeフォーマットマップでのみ可能です。 +2 つの同じキーが読まれた場合、両方ともマップに挿入されます。 +.It Fl f +通常、キーのなかのすべての大文字(upper case)は、 +すべて小文字(lower case)として記録されますが、 +このフラグを指定することによってこの動作を行わないように指定できます。 +これは、sendmail.cf 中の +\fBK\fP +行における +\-f フラグと一致していなければなりません。 +.It Fl o +すでにあるファイルに追加が行われます。 +すでに存在するファイルを引数として指定することができます。 +.It Fl r +すでに存在しているキーを置き換えます。 +通常はすでに入力したキーをさらに繰り返して入力しても、 +.Nm +は警告を出力し、データベースには取り込みません。 +.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 歴史 +.Nm +コマンドは +.Bx 4.4 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/makewhatis.local.8 b/ja_JP.eucJP/man/man8/makewhatis.local.8 new file mode 100644 index 0000000000..74809c5ef6 --- /dev/null +++ b/ja_JP.eucJP/man/man8/makewhatis.local.8 @@ -0,0 +1,71 @@ +.\" Copyright (c) April 1996 Wolfram Schneider <wosch@FreeBSD.org>. Berlin. +.\" 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. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: makewhatis.local.8,v 1.2.2.1 1996/12/10 17:23:18 joerg Exp % +.\" jpman %Id: makewhatis.local.8,v 1.3 1997/09/09 03:59:22 yugawa Stab % +.Dd April, 26, 1996 +.Dt MAKEWHATIS.LOCAL 8 +.Os FreeBSD 2.2 +.Sh 名称 +.Nm makewhatis.local , catman.local +.Nd ローカルファイルシステムに対して makewhatis を開始する +.Sh 書式 +.Nm /usr/libexec/makewhatis.local +.Op options +.Ar directories ... +.Nm /usr/libexec/catman.local +.Op options +.Ar directories ... +.Sh 解説 +.Nm +は +.Xr makewhatis 1 +を開始しますが、 +.Nm +が実行されるシステムに物理的にマウントされているファイルシステムだけを +対象とします。 +読み書き可能な NFS マウントされた /usr ディレクトリに対し +.Pa /etc/weekly +から makewhatis を起動すると NFS サーバを殺してしまうでしょう -- +すべての NFS クライアントが makewhatis を同時に開始してしまうからです! +ですから、 +.Xr cron 8 +へのラッパにこのプログラムを使用し、直接 makewhatis を呼ばないで下さい。 +.Sh 関連ファイル +.Bl -tag -width /etc/weekly.XXX -compact +.It Pa /etc/weekly +毎週 +.Nm +を実行します。 +.El +.Sh 関連項目 +.Xr catman 1 , +.Xr find 1 , +.Xr makewhatis 1 , +.Xr cron 8 . +.Sh 歴史 +.Nm +コマンドは +.Fx 2.2 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/man8.i386/apm.8 b/ja_JP.eucJP/man/man8/man8.i386/apm.8 new file mode 100644 index 0000000000..6a9dfebc69 --- /dev/null +++ b/ja_JP.eucJP/man/man8/man8.i386/apm.8 @@ -0,0 +1,104 @@ +.\" LP (Laptop Package) +.\" +.\" Copyright (c) 1994 by HOSOKAWA, Tatsumi <hosokawa@mt.cs.keio.ac.jp> +.\" +.\" This software may be used, modified, copied, and distributed, in +.\" both source and binary form provided that the above copyright and +.\" these terms are retained. Under no circumstances is the author +.\" responsible for the proper functioning of this software, nor does +.\" the author assume any responsibility for damages incurred with its +.\" use. +.\" jpman %Id: apm.8,v 1.4 1997/07/26 21:52:01 horikawa Stab % +.Dd November 1, 1994 +.Dt APM 8 +.Os +.Sh 名称 +.Nm apm, zzz +.Nd APM BIOS の制御を行い、その情報を表示する +.Sh 書式 +.Nm apm +.Op Fl z +.Op Fl b +.Op Fl a +.Op Fl l +.Op Fl s +.Pp +.Nm zzz +.Sh 解説 +.Nm apm +は、 Intel / Microsoft APM (Advanced Power Management) BIOS を制御し、 +ラップトップ PC 上の APM の現在の状態を表示します。 +.Nm zzz +は、 APM 制御によって、システムをサスペンドします。 +.Pp +以下のオプションが +.Nm apm +で利用可能です +( +.Nm zzz +には、オプションはありません)。 +オプションが与えられなかった場合は、 +.Nm apm +は、現在の APM の状態や情報を冗長モードで表示します。 +.Bl -tag -width indent +.It Fl z +システムをサスペンドします。これは、 +.Nm zzz +と等価です。 +.Pp +.It Fl b +整数値で、現在のバッテリ状態を表示します。 +0, 1, 2, 3という値はそれぞれ、 +.Dq 良好 (high) +状態、 +.Dq 低バッテリ (low) +状態、 +.Dq 危険 (critical) +状態、 +.Dq 充電 (charging) +状態をあらわします。 +.Pp +.It Fl a +現在の AC 電源の状態を整数値で表示します。 +0, 1がそれぞれ +.Dq 外れている (off-line) +状態と +.Dq つながっている (on-line) +状態をあらわします。 +.Pp +.It Fl l +現在のバッテリの残り割合を表示します。 +もし、あなたのラップトップがこの機能を提供していない時には、 +255 が表示されます。 +.Pp +.It Fl s +APM サポート状態を整数値で表示します。0, 1 という値はそれぞれ、 +.Dq 利用不可 (disabled) +状態 +.Dq 利用可能 (enabled) +状態 +をあらわします。 +.Sh バグ +いくつかの APM 実装では、 +.Nm apm +が必要とするパラメータが提供されていません。 +そのようなシステムに於いては、 +.Nm apm +は、それらを知らないと表示します。 +.Pp +いくつかの APM 実装では、電源スイッチを押したことやカバーが +閉められたことなどのイベントを扱うことができません。 +そのような実装に於いては、 +システムは +.Nm apm +か +.Nm zzz +.Ar だけを +つかってサスペンドする +.Ar べき +です。 +.Sh 関連項目 +.Xr apm 4 , +.Xr apmconf 8 +.Sh 作者 +細川 達己<hosokawa@mt.cs.keio.ac.jp> ( 慶応大学, 日本 ) diff --git a/ja_JP.eucJP/man/man8/manctl.8 b/ja_JP.eucJP/man/man8/manctl.8 new file mode 100644 index 0000000000..3230eadd85 --- /dev/null +++ b/ja_JP.eucJP/man/man8/manctl.8 @@ -0,0 +1,63 @@ +.\" Copyright (c) 1996 Wolfram Schneider <wosch@FreeBSD.org>. Berlin. +.\" 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. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: manctl.8,v 1.3.2.2 1997/09/29 06:32:23 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 +.Op Fl uncompress +.Op Fl purge +.Op Fl help +.Ar path ... + +.Sh 解説 +.Nm manctl +はディレクトリパスにあるマニュアルページを圧縮あるいは圧縮解凍します。 +可能なら、.so マクロはハードリンクで置き換えられます。 + + +.Sh オプション +.Bl -tag -width -indent +.It Fl help +オプション一覧を表示して終了します。 +.It Fl compress +非圧縮マニュアルページを圧縮します(.so は除去します)。 +.It Fl uncompress +圧縮マニュアルページを解凍します。 +.It Fl purge +フォーマット済の古いマニュアルページを一掃します(未実装)。 + +.Sh 関連項目 +.Xr catman 1 , +.Xr man 1 diff --git a/ja_JP.eucJP/man/man8/map-mbone.8 b/ja_JP.eucJP/man/man8/map-mbone.8 new file mode 100644 index 0000000000..7c801e96cc --- /dev/null +++ b/ja_JP.eucJP/man/man8/map-mbone.8 @@ -0,0 +1,98 @@ +.TH 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 +は、 +.I starting_router +で指定したマルチキャストルータから到達可能なすべてのマルチキャストルータに +ついて表示します。 +コマンドラインに何の指定もない場合、デフォルトのマルチキャストルータ +.I starting_router +は、ローカルホスト(localhost)になります。 +.PP +.I map-mbone +は、ASK_NEIGHBORS IGMP メッセージを送信することで、 +隣接するマルチキャストルータのデータ取得を行ないます。 +指定したマルチキャストルータからの応答があった場合には、 +その応答の中にあるバージョン番号と隣接するマルチキャストルータのアドレス一覧が +出力されます。応答したルータが、 +最新のマルチキャストバージョン番号を持つ場合には、 +.I map-mbone +は、そのルータに対してメトリック、スレッショルド、フラグのような追加情報を +要求します。 +隣接するマルチキャストルータに新たな事象が発生し、フルーディングオプションが +使用可能な場合、 +.I map-mbone +は、隣接するそれらのマルチキャストルータそれぞれに対して新たな情報を求めます。 +また、マルチキャストルータの検索は、マルチキャストルータが +それ以上みつからないという状態になるまで継続します。 +.br +.ne 5 +.SH オプション +.PP +"\-d" オプションは、デバッグレベルを設定します。デバッグレベルが +デフォルトレベルである 0 よりも大きい場合、追加デバッグメッセージが画面に +出力されます。デバッグレベルにかかわらず、エラーについてはエラーメッセージが +出力され、 +.I map-mbone +は終了します。 +デバッグレベルが 0 でない場合、以下の効果があります。 +.IP "level 1" +パケットの警告が標準エラー出力に対して出力されます。 +.IP "level 2" +すべてのレベル 1 のメッセージに加えて、ネットワークダウンの情報が +標準エラー出力に対して出力されます。 +.IP "level 3" +すべてのレベル 2 のメッセージに加えて、すべてのパケットタイムアウトの情報が +標準エラー出力に対して出力されます。 +.PP +"\-f" オプションは、フルーディングオプションを設定します。フルーディング +オプションを有効にすることで、再帰的に隣接するマルチキャストルータを検索 +することを許可します。そして、starting_router が指定されない場合には、 +このオプションはデフォルトでは有効になっています。 +.PP +"\-g" オプションは、GraphEdフォーマットにしたがったグラフ出力を有効にします。 +.PP +"\-n" オプションは、マルチキャストルータの名前の検索に DNS を使わないように +設定します。 +.PP +"\-r retry_count" オプションは、隣接ルータに対するリトライ制限を設定します。 +デフォルトではリトライ回数は 1 です。 +.PP +"\-t timeout_count" オプションは、リトライ間隔を秒単位で設定します。 +デフォルトのリトライ間隔は 2 秒です。 +.PP +.SH 注意 +.I map-mbone +は root のみ実行可能です。 +.PP +.SH 関連項目 +.BR mrouted (8) , +.BR mrinfo (8) , +.BR mtrace (8) +.PP +.SH 作者 +Pavel Curtis diff --git a/ja_JP.eucJP/man/man8/mixer.8 b/ja_JP.eucJP/man/man8/mixer.8 new file mode 100644 index 0000000000..31dde7ed95 --- /dev/null +++ b/ja_JP.eucJP/man/man8/mixer.8 @@ -0,0 +1,103 @@ +.\" Copyright (c) 1997 +.\" Mike Pritchard <mpp@FreeBSD.ORG>. 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. Neither the name of the author nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY MIKE PRITCHARD 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 AUTHOR 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. +.\" +.\" jpman %Id: mixer.8,v 1.3 1997/08/16 13:24:56 horikawa Stab % +.Dd January 9, 1997 +.Dt MIXER 8 +.Os +.Sh 名称 +.Nm mixer +.Nd サウンドカードのミキサ値の設定/表示 +.Sh 書式 +.Nm +.Nm mixer +.Ar setting +.Op Ar lvalue:rvalue +.Nm mixer +.Ar +rec | -rec +.Op Ar device +.Sh 解説 +.Nm +コマンドはサウンドカードのミキサの設定を変更あるいは表示するのに +用いられます。 +サウンドカードからの録音の開始および停止の制御にも用いられます。 +変更可能なミキサ設定は以下の通りです: +.Pp +vol, bass, treble, synth, pcm, speaker, mic, cd, mix, +pcm2, rec, igain, ogain, line1, line2, line3 +.Pp +必ずしも全てのサウンドカードで上記全ての項目が設定可能なわけではありません。 +.Pp +.Nm +が引数なしで起動されると、 +そのサウンドカードでサポートされている全項目が表示されます。 +引数 +.Ar setting +が指定されると、その +.Ar setting +の設定値だけが表示されます。 +.Pp +ミキサの設定項目 +.Ar setting +の設定値を変更する場合、オプションにより、 +.Ar lvalue:rvalue +の形式で左右のチャネル設定を指定できます。 +.Ar lvalue +および +.Ar rvalue +引数の値は 0 から 100 までです。 +.Pp +録音を開始するには +.Ar +rec +引数を用い、録音を停止するには +.Ar -rec +引数を用います。オプション引数 +.Ar device +により別のミキサデバイスを指定することもできます。 +デフォルトのデバイスは +.Pa /dev/mixer +です。 +.Sh 関連ファイル +.Bl -tag -width /dev/mixer -compact +.It Pa /dev/mixer +デフォルトのミキサデバイス +.Sh 関連項目 +.Xr cdcontrol 1 , +.Xr cdplay 1 +.Sh 歴史 +.Nm +コマンドは +.Fx 2.0.5 +で初めて登場しました。 +.Sh 作者 +.An Craig Metz Aq cmetz@thor.tjhsst.edu +と +.An Hannu Savolainenl +。 +このマニュアルページは +.An Mike Pritchard Aq mpp@FreeBSD.ORG +によって記述されました。 diff --git a/ja_JP.eucJP/man/man8/mk-amd-map.8 b/ja_JP.eucJP/man/man8/mk-amd-map.8 new file mode 100644 index 0000000000..77d4114ff2 --- /dev/null +++ b/ja_JP.eucJP/man/man8/mk-amd-map.8 @@ -0,0 +1,60 @@ +.\" Copyright (c) 1993 Jan-Simon Pendry +.\" 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. +.\" +.\" 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. +.\" +.\" from: @(#)mk-amd-map.8 8.1 (Berkeley) 6/28/93 +.\" jpman %Id: mk-amd-map.8,v 1.2 1997/06/06 10:48:37 bobson Stab % +.\" +.Dd "June 28, 1993" +.Dt MK-AMD-MAP 8 +.Os BSD 4.4 +.Sh 名称 +.Nm mk-amd-map +.Nd +.Nm amd用のマップデータベースを作成する +.Pp +.Sh 書式 +.Nm mk-amd-map +.Op Fl p +.Ar mapname +.Sh 解説 +.Nm mk-amd-map +は、 +.Xr amd 8 +で参照するキー付きマップによって使用されるデータベースを作成します。 +指定された名前のファイルから入力を読み込み、 +同じ名前を持つハッシュデータベースを出力します。 +.Pp +.Fl p +オプションは、データベースを生成するかわりに、標準出力にマップを表示します。 +これは通常、継続した行を 1 行にまとめるために使われます。 +.Sh 関連項目 +.Xr amd 8 diff --git a/ja_JP.eucJP/man/man8/mknetid.8 b/ja_JP.eucJP/man/man8/mknetid.8 new file mode 100644 index 0000000000..9542a3d5bd --- /dev/null +++ b/ja_JP.eucJP/man/man8/mknetid.8 @@ -0,0 +1,141 @@ +.\" Copyright (c) 1995, 1996 +.\" Bill Paul <wpaul@ctr.columbia.edu>. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by Bill Paul. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: mknetid.8,v 1.1.1.1 1996/06/25 20:26:38 wpaul Exp % +.\" jpman %Id: mknetid.8,v 1.3 1997/08/16 13:26:57 horikawa Stab % +.\" +.Dd June 23, 1996 +.Dt MKNETID 8 +.Os +.Sh 名称 +.Nm mknetid +.Nd netid マップデータの生成 +.Sh 書式 +.Nm mknetid +.Op Fl q +.Op Fl g Ar group_file +.Op Fl p Ar passwd_file +.Op Fl h Ar hosts_file +.Op Fl n Ar netid_file +.Op Fl d Ar domain +.Sh 解説 +.Nm mknetid +は以下のファイル +.Xr group 5 , +.Xr passwd 5 , +.Xr hosts 5 , +.Xr netid 5 +の内容を処理し、NIS マップ +.Pa netid.byname +を生成するのに用いる形式に変換します。 +このマップは、OS に依存しない形式でユーザとホスト双方の信用情報を +保持するために用いられます。 +.Pp +.Nm mknetid +コマンドは重複した netid の出現をチェックし、それらを除去します。 +.Pp +.Nm mknetid +コマンドは結果を標準出力に出力します。 +通常は NIS マップを再構築する際に +.Nm /var/yp/Makefile +からのみ呼び出されます。 +.Pp +.Sh オプション +.Nm mknetid +コマンドには以下のオプションがあります: +.Bl -tag -width flag +.It Fl q +通常、 +.Nm mknetid +は重複した netid を見つけると警告メッセージを表示しますが、 +このオプションにより「静粛」モードとなり、警告は抑制されます。 +他のエラーメッセージはそのまま表示されます。 +.It Fl g Ar group-file +.Fl g +オプションはグループ情報ファイルの場所を指定するのに用いられます。 +コンパイル済みのデフォルト値は +.Pa /etc/group +です。 +.It Fl p Ar passwd-file +.Fl p +オプションはパスワード情報ファイルの場所を指定するのに用いられます。 +コンパイル済みのデフォルト値は +.Pa /etc/passwd +です。 +.It Fl h Ar hosts-file +.\" ↑原文では .It Fl h Ar group-file となっているが、おそらく +.\" cut&paste ミスと思われる。 sakai@jp.freebsd.org (Jun 12, 1997) +.Fl h +オプションはホストデータベースファイルの場所を指定するのに用いられます。 +コンパイル済みのデフォルト値は +.Pa /etc/hosts +です。 +.It Fl n Ar netid-file +.Fl n +オプションは netid 情報ファイルの場所を指定するのに用いられます。 +コンパイル済みのデフォルト値は +.Pa /etc/netid +です。 +注: netid データベースが見つからなくてもエラーにはなりません。 +FreeBSD で Secure RPC がサポートされるようになるまでは、 +ほとんどのシステムでは netid データベースは存在しないことでしょう。 +.It Fl d Ar domain +.Nm mknetid +コマンドが netid レコードを生成する際、デフォルトでは、 +システムのドメイン名を用います。 +もしシステムのドメイン名が設定されていないなら、 +.Fl d +オプションによってコマンドラインからドメイン名を指定しなければなりません。 +ドメイン名が設定されている場合、 +.Fl d +オプションによってその設定値を上書きすることもできます。 +.El +.Sh 関連ファイル +.Bl -tag -width Pa -compact +.It Pa /var/yp/Makefile +NIS データベースを構築するために +.Nm yp_mkdb +および +.Nm mknetid +を呼び出す Makefile +.It Pa /etc/group +デフォルトのグループデータベースファイル +.It Pa /etc/passwd +デフォルトのパスワードデータベースファイル +.It Pa /etc/hosts +デフォルトのホストデータベースファイル +.It Pa /etc/netid +デフォルトの netid データベースファイル +.El +.Sh 関連項目 +.Xr yp 4 , +.Xr yp_mkdb 8 +.Sh 作者 +Bill Paul <wpaul@ctr.columbia.edu> diff --git a/ja_JP.eucJP/man/man8/mknod.8 b/ja_JP.eucJP/man/man8/mknod.8 new file mode 100644 index 0000000000..58ef3370dd --- /dev/null +++ b/ja_JP.eucJP/man/man8/mknod.8 @@ -0,0 +1,107 @@ +.\" Copyright (c) 1980, 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. +.\" +.\" 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. +.\" +.\" @(#)mknod.8 8.2 (Berkeley) 12/11/93 +.\" jpman %Id: mknod.8,v 1.2 1997/03/31 13:37:12 horikawa Stab % +.\" +.Dd December 11, 1993 +.Dt MKNOD 8 +.Os BSD 4 +.Sh 名称 +.Nm mknod +.Nd スペシャルファイルを作成する +.Sh 書式 +.Nm mknod +.Ar name +.Op Cm c | Cm b +.Ar major minor +.Sh 解説 +.Nm mknod +はデバイススペシャルファイルを作成します。通常、シェルスクリプト +.Pa /dev/MAKEDEV +で、よく知られているスペシャルファイルを作成することができます。 +このスクリプトは、 +.Nm mknod +に適当な引数を渡して実行し、必要な全てのデバイスファイルの作成をします。 +.Pp +.Nm mknod +の引数としては、以下の 4 つが必要です。 +.Bl -tag -width majorx +.It Ar name +デバイスファイル名です。たとえば +.Dq sd +は SCSI ディスクで、 +.Dq pty +は疑似デバイスです。 +.It Cm b | Cm c +デバイスのタイプを指定します。 +ブロック型のデバイスは、 +.Cm b +を指定します。 +テープやディスク等がこれに該当しますが、 +ブロックスペシャルデバイス (cooked) とキャラクタスペシャルデバイス (raw) の +両方のスペシャルファイルが必要です。 +キャラクタ型のデバイスは、 +.Cm c +を指定します。 +端末や疑似デバイス等がこれに該当します。 +.It Ar major +メジャーデバイス番号を指定します。 +メジャーデバイス番号は、 +どのデバイスドライバエントリを使用すべきをカーネルに示します。 +メジャーデバイス番号とデバイスの対応を知るには、 +.Ar /dev/MAKEDEV +を見てください。 +.It Ar minor +マイナーデバイス番号を指定します。 +マイナーデバイス番号は、 +デバイスのどのサブユニットが +スペシャルファイルに対応するのかをカーネルに示します。 +例えば、サブユニットは +ファイルシステムのパーティションだったり端末ラインだったりします。 +.El +.Pp +メジャーデバイス番号およびマイナーデバイス番号とも +.Xr strtoul 3 +が受け付ける任意の形式で指定可能です。 +.Ql 0x +で始めることにより 16 進数と、 +.Ql 0 +で始めることにより 8 進数であると解釈させる事が出来ます。 +.Sh 関連項目 +.Xr mkfifo 1 , +.Xr mknod 2 , +.Xr MAKEDEV 8 +.Sh 歴史 +.Nm +コマンドは +.At v6 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/modload.8 b/ja_JP.eucJP/man/man8/modload.8 new file mode 100644 index 0000000000..fedd1e0b82 --- /dev/null +++ b/ja_JP.eucJP/man/man8/modload.8 @@ -0,0 +1,117 @@ +.\" Copyright (c) 1993 Christopher G. Demetriou +.\" 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. 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: modload.8,v 1.7.2.1 1997/03/03 07:01:31 mpp Exp % +.\" jpman %Id: modload.8,v 1.2 1997/04/25 00:25:43 mutoh Stab % +.\" +.Dd September 22, 1994 +.Dt MODLOAD 8 +.Os +.Sh 名称 +.Nm modload +.Nd カーネルモジュールの読み込みを行う +.Sh 書式 +.Nm modload +.Op Fl dquv +.Op Fl A Ar kernel +.Op Fl e Ar entry +.Op Fl p Ar postinstall +.Op Fl o Ar output_file +.Ar input_file +.Sh 解説 +.Nm modload +は、ローダブルカーネルモジュールを稼働中のシステムに読み込み +ます。入力ファイルはオブジェクトファイル (.o) です。 +.Pp +オプションとしては、以下のものがあります。 +.Bl -tag -width indent +.It Fl d +デバッグオプションです。 +.Nm modload +自体をデバッグする時に指定します。 +.It Fl q +沈黙モード。メッセージをほとんど表示しません。 +.It Fl u +モジュールが読み込まれた後で、ファイル +.Pq Ar output_file +を削除します。出力ファイルが指定されていない時は、このオプションは一時 +ファイルを消去する前まで利用します。 +.It Fl v +読み込み処理の詳細を表示します。 +.It Fl A Ar kernel +外部シンボル参照を解決するためにリンカに使わせるファイルを指定します。 +必ず、現在動いているカーネルの +シンボルを含むファイルを指定しなければなりません。 +それ以外のファイルを指定すると、システムがクラッシュするでしょう。 +.It Fl e Ar entry +ローダブルモジュールのエントリポイントを指定します。 +この文字列はモジュールがリンクされる時に +.Xr ld 1 +に渡されます。 +デフォルトのモジュールエントリポイント名は モジュール名に `_mod' を +追加したものです。 +.It Fl p Ar postinstall +ローダブルモジュールの読み込みが成功した後に起動するシェルスクリプト、 +またはプログラムを指定します。 +このスクリプトまたはプログラムには 3 つの引数が渡されます。 +1 つ目はモジュール ID (10 進 )、 2 つ目はモジュールタイプ (16 進 ) です。 +ローダブルモジュールがデバイスドライバならば、 +3 つ目の引数としてメジャー番号が渡されます。 +ローダブルモジュールがシステムコールならば、 +3 つ目の引数としてシステムコール番号が渡されます。 +.It Fl o Ar output_file +リンカが作成する出力ファイルの名前を指定します。このオプションが +指定されていない時は、 /tmp ディレクトリ内のファイルが使われます。 +その名前は、モジュール名に `.out' という拡張子が付けられたものです。 +.El +.Sh 関連ファイル +.Bl -tag -width /usr/include/sys/lkm.h -compact +.It Pa /kernel +外部参照を解決するためにリンカに使わせるデフォルトのファイル。 +.It Pa /usr/include/sys/lkm.h +モジュールタイプが定義されているファイル。 +.\" .It Pa output file. +.\" リンカが作成するデフォルトの出力ファイル。 +.Sh 診断 +.Nm +は、成功時には 0、エラー発生時には 0 以外の値で終了します。 +.Sh 関連項目 +.Xr ld 1 , +.Xr lkm 4 , +.Xr modstat 8 , +.Xr modunload 8 +.Sh 歴史 +.Nm +コマンドは +.Tn "SunOS 4.1.3" +の対応するコマンドと類似した機能になるように設計しました。 +.Sh 作者 +.Bl -tag +Terrence R. Lambert, terry@cs.weber.edu +.El +.Sh バグ +ローダブルデバイスドライバでは、 +キャラクタデバイスまたはブロックデバイスのどちらかのエントリを確保できますが、 +両方を確保することはできません。 diff --git a/ja_JP.eucJP/man/man8/modstat.8 b/ja_JP.eucJP/man/man8/modstat.8 new file mode 100644 index 0000000000..041af60ecc --- /dev/null +++ b/ja_JP.eucJP/man/man8/modstat.8 @@ -0,0 +1,66 @@ +.\" Copyright (c) 1993 Christopher G. Demetriou +.\" 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. 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: modstat.8,v 1.2.8.2 1997/07/30 06:42:43 charnier Exp % +.\" jpman %Id: modstat.8,v 1.3 1997/09/08 07:02:33 seki Stab % +.\" +.Dd June 7, 1993 +.Dt MODSTAT 8 +.Os +.Sh 名称 +.Nm modstat +.Nd 組み込んだカーネルモジュールのステータスを表示する +.Sh 書式 +.Nm modstat +.Op Fl i Ar id +.Op Fl n Ar name +.Sh 解説 +.Nm +は、カーネルに組み込んだローダブルカーネルモジュールの +ステータスを表示します。 +.Pp +オプションとしては以下のものがあります: +.Bl -tag -width indent +.It Fl i Ar id +指定した ID のモジュールのみ表示する +.It Fl n Ar name +指定した名前のモジュールのみ表示する +.El +.Sh 診断 +.Nm +は、成功したときは 0、失敗したときは 0 以外の状態にて終了します。 +.Sh 関連項目 +.Xr lkm 4 , +.Xr modload 8 , +.Xr modunload 8 +.Sh 歴史 +.Nm +コマンドは、 +.Tn "SunOS 4.1.3" +の対応するコマンドと同じ機能になるように設計されました。 +.Sh 作者 +.Bl -tag +Terrence R. Lambert, terry@cs.weber.edu +.El diff --git a/ja_JP.eucJP/man/man8/modunload.8 b/ja_JP.eucJP/man/man8/modunload.8 new file mode 100644 index 0000000000..fc027be331 --- /dev/null +++ b/ja_JP.eucJP/man/man8/modunload.8 @@ -0,0 +1,76 @@ +.\" Copyright (c) 1993 Christopher G. Demetriou +.\" 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. 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: modunload.8,v 1.4.2.1 1996/12/14 13:57:47 joerg Exp % +.\" jpman %Id: modunload.8,v 1.2 1997/04/30 00:37:42 mutoh Stab % +.\" +.Dd June 7, 1993 +.Dt MODUNLOAD 8 +.Os +.Sh 名称 +.Nm modunload +.Nd カーネルモジュールを取り外す +.Sh 書式 +.Nm modunload +.Op Fl i Ar module_id +.Op Fl n Ar module_name +.Sh 解説 +.Nm +は、カーネルに組み込んだ読み込み可能カーネルモジュールを +稼働中のシステムから取り外します。 +.Ar module_id +と +.Ar module_name +は、 +.Xr modstat 8 +で表示される ID と名前です。 +.Pp +以下のオプションのどちらか一方を指定する必要があります。 +.Bl -tag -width indent +.It Fl i Ar module_id +指定した ID +.Ar module_id +のモジュールを取り外す +.It Fl n Ar module_name +指定した名前 +.Ar module_name +のモジュールを取り外す +.El +.Sh 診断 +.Nm +は、成功したときは0、失敗したときは0以外の値になります。 +.Sh 関連項目 +.Xr lkm 4 , +.Xr modload 8 , +.Xr modstat 8 +.Sh 歴史 +.Nm +コマンドは、 +.Tn "SunOS 4.1.3" +の対応するコマンドと同じ機能になるように設計されました。 +.Sh 作者 +.Bl -tag +Terrence R. Lambert, terry@cs.weber.edu +.El diff --git a/ja_JP.eucJP/man/man8/mount.8 b/ja_JP.eucJP/man/man8/mount.8 new file mode 100644 index 0000000000..77513e74cc --- /dev/null +++ b/ja_JP.eucJP/man/man8/mount.8 @@ -0,0 +1,338 @@ +.\" Copyright (c) 1980, 1989, 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. +.\" +.\" 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. +.\" +.\" @(#)mount.8 8.7 (Berkeley) 3/27/94 +.\" %Id: mount.8,v 1.11.2.2 1997/08/24 17:52:01 joerg Exp % +.\" jpman %Id: mount.8,v 1.2 1997/05/03 11:26:50 horikawa Stab % +.\" +.Dd March 27, 1994 +.Dt MOUNT 8 +.Os BSD 4 +.Sh 名称 +.Nm mount +.Nd ファイルシステムをマウントする +.Sh 書式 +.Nm mount +.Op Fl adfpruvw +.Op Fl t Ar ufs | lfs | external_type +.Nm mount +.Op Fl dfpruvw +.Ar special | node +.Nm mount +.Op Fl dfpruvw +.Op Fl o Ar options +.Op Fl t Ar ufs | lfs | external_type +.Ar special node +.Sh 解説 +.Nm mount +コマンドは +.Xr mount 2 +システムコールを使用して、 +.Ar "スペシャルデバイス" +かリモートノード (rhost:path) を +ファイルシステムツリーの +.Ar node +へ接合します。 +もし +.Ar special +または +.Ar node +が指定されなかった場合には、 +.Xr fstab 5 +ファイルから適切な情報を取得します。 +.Pp +システムは、現在マウントしているファイルシステムのリストを管理しています。 +.Nm mount +コマンドを引数を与えずに実行すると、このリストが表示されます。 +.Pp +オプションとしては以下のものがあります: +.Bl -tag -width indent +.It Fl a +.Pa /etc/fstab +に記述されているファイルシステムを +(``noauto'' が指定されているものは除いて) +すべてマウントします。 +通常、これはシステムの起動時に実行されます。 +.It Fl d +システムコールの実行以外のすべてのことを行ないます。 +このオプションを +.Fl v +とともに指定することで、 +.Nm mount +コマンドが何をしようとしているのかを確認することができます。 +.It Fl f +ファイルシステムのマウント状態を読み書き可能から読み込み専用へ +変更しようとするときに、 +すでにオープンされているファイルへの書き込み許可を強制的に取り消します。 +また、正常かどうか不明なファイルシステムも強制的に読み書き可能に +マウントします (危険なため注意して使って下さい)。 +.It Fl o +オプションは +.Fl o +の後にカンマで区切って指定します。 +以下のオプションが指定できます: +.Bl -tag -width indent +.It async +指定したファイルシステムのすべての +.Tn I/O +を非同期に行います。 +このフラグを指定することは非常に +.Em 危険 +ですので、 +システムクラッシュ時にファイルシステムを +作り直す用意ができていないかぎりは使うべきではありません。 +.It force +.Fl f +オプションと同じです。 +ファイルシステムのマウント状態を読み書き可能から読み込み専用へ +変更しようとするときに、 +すでにオープンされているファイルへの書き込み許可を強制的に取り消します。 +また、正常かどうか不明なファイルシステムも強制的に読み書き可能に +マウントします (危険なため注意して使って下さい)。 +.It noatime +ファイル読み取り時に、ファイルアクセス時刻を更新しません。 +このオプションが便利なのは、 +多くのファイルを持ち、(ほとんどの場合重要ではない)ファイルアクセス時刻 +を更新するよりも性能が重要であるファイルシステムです。 +このオプションは現在ローカルファイルシステムでのみサポートされています。 +.It nodev +ファイルシステム上のキャラクタスペシャルデバイスや +ブロックスペシャルデバイスを解釈しません。 +このオプションは、サーバが自分自身以外のアーキテクチャ用の +スペシャルデバイスを含むファイルシステムを持っている場合に有用です。 +.It noexec +マウントしているファイルシステム上のバイナリの +実行を許可しません。 +このオプションは、サーバが自分自身以外のアーキテクチャ用の +バイナリを含むファイルシステムを持っている場合に有用です。 +.It nosuid +実効ユーザ ID (set-user-ID) セット、 +実効グループ ID (set-group-ID) セットビットの +効果をなくします。 +注意: +.Xr suidperl 1 +のような suid/sgid ラッパが +誰でも使えるようにシステムにインストールされている場合には、価値がありません。 +.It rdonly +.Fl r +と同じく、マウントするファイルシステムを読み込み専用とします +(スーパユーザでも書き込みできなくなります)。 +.It sync +ファイルシステムのすべての +.Tn I/O +を同期的に行います。 +.It update +.Fl u +と同じく、すでにマウントされているファイルシステムの状態を変化させることを +指示します。 +.It union +マウントポイント以下の名前空間に、マウントされたファイルシステムのルートと +マウントポイントに元から存在するディレクトリの両方が見えるようにします。 +名前を検索するときは、マウントしたファイルシステムが先に検索されます。 +ファイルが存在しない +ために検索が失敗した場合は、既存のディレクトリがアクセスされます。 +ファイル等の作成は、すべて +マウントしたファイルシステム上に対して行われます。 +.El +.Pp +.Nm mount +が内部で知っているファイルシステムタイプ +.Pf ( Fl t +オプションを参照) +以外の、ファイルシステムタイプに固有のオプションは、 +コンマで区切って指定します。このオプションは、オプションの前に +.Dq \&- +(ダッシュ記号)をつけて区別します。値を持つオプションは、 +-option=valueの形で指定します。 +たとえば、 +.Bd -literal -offset indent +mount -t mfs -o nosuid,-N,-s=4000 /dev/dk0b /tmp +.Ed +.Pp +では、 +.Nm mount +コマンドは以下と同じものを実行します: +.Bd -literal -offset indent +/sbin/mount_mfs -o nosuid -N -s 4000 /dev/dk0b /tmp +.Ed +.It Fl p +マウント情報を fstab の形式で表示します。暗黙的に +.Fl v +オプションを指定します。 +.It Fl r +ファイルシステムをリードオンリーで +マウントします(スーパユーザでも書き込みは行えません)。 +これは、 +.Fl o +オプションで +.Dq rdonly +を指定するのと同じです。 +.It Fl t Ar "ufs \\*(Ba lfs \\*(Ba external type" +.Fl t +のあとの引数にはファイルシステムタイプを指定します。 +デフォルトは、 +.Ar ufs +です。 +.Fl t +オプションによって、 +.Nm mount +コマンドの操作が、指定した特定のタイプのファイルシステムに対してのみ +行われるように指示することができます。 +2つ以上のタイプを指定するにはコンマで区切ります。 +ファイルシステムリスト +の先頭に +.Dq no +という文字をつけることに +よって、 +.Nm mount +コマンドの操作の対象と +.Em しない +ファイルシステムタイプを指定することができます。 +以下に例を示します: +.Bd -literal -offset indent +mount -a -t nonfs,mfs +.Ed +.Pp +は、 +.Tn NFS +と +.Tn MFS +を除いた、すべてのファイルシステムをマウントします。 +.Pp +type を内部で解釈できない場合、 +.Nm mount +は +.Pa /sbin/mount_ Ns Em XXX +というプログラムを実行しようとします。 +.Em XXX +の部分が type になります。たとえば nfs ファイルシステムは、 +.Pa /sbin/mount_nfs +というプログラムによってマウント +されます。 +.Pp +ほとんどのファイルシステム用モジュールは +カーネル中にない場合、ファイルシステム別のマウントプログラム +によって動的に読み込まれます。 +そこでは +.Xr vfsload 3 +サブルーチンが使われます。 +この機構には書き込み可能な作業領域が必要なため、 +.Pa /tmp +があるファイルシステムタイプのモジュールはカーネルに +組み込まれている必要があります。さらに +.Pa /etc/fstab +において、 +.Pa /tmp +や +.Pa /usr/bin/ld +があるファイルシステムは +動的に読み込まれるファイルシステムよりも前に +記述されていなければいけません。 +.It Fl u +.Fl u +フラグは、すでにマウントしているファイルシステム +の状態の変更を指示します。 +ファイルシステムを読み込み専用から読み書き可能へ、またその逆へも変更することを +含めて、すでに説明したすべてのオプション +.Pf ( Fl o +オプション) +の内容を変更することができます。 +読み書き可能なファイルシステムを読み出し専用に変更する場合、 +書き込みのためにオープンしているファイルがあるときには、 +.Fl f +オプションを指定しなければ変更に失敗します。 +どのオプションを適用するかを決定する際、最初に +.Xr fstab 5 +のテーブル +を参照し、適用します。その次に +.Fl o +オプションの引数を適用し、最後に +.Fl r +、 +.Fl w +オプションが適用されます。 +.It Fl v +詳細なメッセージを表示します。 +.It Fl w +ファイルシステムを読み書き可能とします。 +.Pp +.Tn NFS +ファイルシステムに対して指定できるオプションは、 +.Xr mount_nfs 8 +のマニュアルに記述されています。 +.Sh 関連ファイル +.Bl -tag -width /etc/fstab -compact +.It Pa /etc/fstab +ファイルシステムテーブル +.El +.Sh 診断 +多岐に渡りますが、ほぼ全てが自明です。 +.Pp +.Dl XXXXX filesystem is not available +.Pp +カーネルはそのファイルシステムタイプをサポートしていません。 +ファイルシステムのサポートは、 +静的(カーネルコンパイル時)もしくは動的( +.Xr modload 8 +によってカーネルモジュールとしてロードされる)です。 +通常、 +.Nm +もしくはそのサブプロセスは、 +ファイルシステムモジュールが静的に組込まれていない場合は、 +.Xr vfsload 3 +を使用して動的にそのファイルシステムモジュールをロードしようとします。 +この場合上記エラーメッセージは、 +モジュールをロードするパーミッションを持たないことも意味する場合があります。 +.Sh 関連項目 +.Xr mount 2 , +.Xr vfsload 3 , +.Xr fstab 5 , +.Xr mount_cd9660 8 , +.Xr mount_fdesc 8 , +.Xr mount_kernfs 8 , +.Xr mount_lfs 8 , +.Xr mount_mfs 8 , +.Xr mount_msdos 8 , +.Xr mount_nfs 8 , +.Xr mount_null 8 , +.Xr mount_portal 8 , +.Xr mount_procfs 8 , +.Xr mount_umap 8 , +.Xr mount_union 8 , +.Xr umount 8 +.Sh バグ +異常なファイルシステムをマウントすると、 +システムクラッシュを引き起こすことがあります。 +.Sh 歴史 +.Nm mount +コマンドは +.At v1 +から登場しています。 diff --git a/ja_JP.eucJP/man/man8/mount_cd9660.8 b/ja_JP.eucJP/man/man8/mount_cd9660.8 new file mode 100644 index 0000000000..2d48b125bf --- /dev/null +++ b/ja_JP.eucJP/man/man8/mount_cd9660.8 @@ -0,0 +1,122 @@ +.\" Copyright (c) 1993, 1994 +.\" The Regents of the University of California. All rights reserved. +.\" All rights reserved. +.\" +.\" This code is derived from software donated to Berkeley by +.\" Christopher G. Demetriou. +.\" +.\" 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. +.\" +.\" 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. +.\" +.\" @(#)mount_cd9660.8 8.3 (Berkeley) 3/27/94 +.\" jpman %Id: mount_cd9660.8,v 1.2 1997/04/12 15:50:31 horikawa Stab % +.Dd March 27, 1994 +.Dt MOUNT_CD9660 8 +.Os BSD 4 +.Sh 名称 +.Nm mount_cd9660 +.Nd ISO-9660 ファイルシステムのマウント +.Sh 書式 +.Nm mount_cd9660 +.Op Fl egrv +.Op Fl o Ar options +.Op Fl s startsector +.Ar special | node +.Sh 解説 +.Nm mount_cd9660 +コマンドは、デバイス名 +.Pa special +上の ISO-9660 ファイルシステムを、 +グローバルファイルシステムの名前空間の +.Pa node +の示す位置に接続します。 +通常このコマンドは、ブート時に +.Xr mount 8 +によって実行されます。 +.Pp +オプションは、次の通りです: +.Bl -tag -width indent +.It Fl e +拡張属性を使用します。 +.It Fl g +ファイルのバージョン番号を取り除きません (デフォルトでは、ディスク上に +異なったバージョン番号を持つファイルが存在する場合、最新のものだけが +見えます)。 +どちらの場合でも、明示的にバージョン番号を指定しなくてもファイルを +オープンする事が出来ます。 +.It Fl o +.Fl o +フラグの後には、コンマで区切ったオプション文字列を指定することができます。 +指定可能なオプションとその意味は、 +.Xr mount 8 +マニュアルページを参照して下さい。 +.It Fl r +ファイルシステムに含まれるロックリッジ拡張 (Rockridge extension) を +使用しません。 +.It Fl s Ar startsector +ファイルシステム開始位置を +.Ar startsector +とします。 +通常、対象のデバイスが CD-ROM ドライブの場合、 +.Nm +はデータを持つ CD-ROM の最後のトラックを見つけて、 +ファイルシステム開始位置をそこであるとします。 +デバイスが CD-ROM でない場合もしくは目録が判明しない場合、 +ファイルシステムはセクタ 0 から開始されます。 +このオプションはこの動作を変更するものです。 +.Ar startsector +は CD-ROM ブロック、すなわち 2048 バイトが単位であることに注意して下さい。 +これは +.Xr cdcontrol 8 +の +.Cm info +コマンドノ例が示す通りです。 +.It Fl v +どのセクタから開始するかについての決定について冗長に報告します。 +.El +.Sh 関連項目 +.Xr mount 2 , +.Xr unmount 2 , +.Xr fstab 5 , +.Xr cdcontrol 8 , +.Xr mount 8 +.Sh バグ +POSIX デバイスノードマッピングは、現在サポートしていません。 +.Pp +ロックリッジ拡張 (Rockridge extension) で使用している場合、 +バージョン番号を取り除きません。 +この場合、ロックリッジ名を持たないファイルをバージョン番号なしで +アクセスすると、バージョン番号の最も大きいファイルではなく、 +小さいファイルをアクセスします。 +.Pp +ECMA はサポートしていません。 +.Sh 歴史 +.Nm mount_cd9660 +ユーティリティは、 +.Bx 4.4 +で最初に登場しました。 diff --git a/ja_JP.eucJP/man/man8/mount_ext2fs.8 b/ja_JP.eucJP/man/man8/mount_ext2fs.8 new file mode 100644 index 0000000000..512a4dc39a --- /dev/null +++ b/ja_JP.eucJP/man/man8/mount_ext2fs.8 @@ -0,0 +1,75 @@ +.\" Copyright (c) 1993, 1994 +.\" 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. +.\" +.\" 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. +.\" +.\" jpman %Id: mount_ext2fs.8,v 1.3 1997/09/09 04:07:26 yugawa Stab % +.\" +.Dd "January 31, 1996" +.Dt MOUNT_EXT2FS 8 +.Os FreeBSD 2.2 +.Sh 名称 +.Nm mount_ext2fs +.Nd ext2fs ファイルシステムをマウントする +.Sh 書式 +.Nm mount_ext2fs +.Op Fl o Ar options +.Ar special +.Ar node +.Sh 解説 +.Nm mount_ext2fs +コマンドは ext2fs ファイルシステムの +.Ar special +デバイスをファイルシステムツリーの +.Ar node +に接続します。 +.Pp +通常このコマンドは、ブート時に +.Xr mount 8 +によって実行されます。 +.Pp +オプションは、次の通りです: +.Bl -tag -width Ds +.It Fl o +.Fl o +フラグの後には、コンマで区切ったオプション文字列を指定することができます。 +指定可能なオプションとその意味は、 +.Xr mount 8 +マニュアルページを参照して下さい。 +.El +.Sh 関連項目 +.Xr mount 2 , +.Xr unmount 2 , +.Xr fstab 5 , +.Xr mount 8 +.Sh 歴史 +.Nm mount_ext2fs +の機能は +.Fx 2.2 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/mount_msdos.8 b/ja_JP.eucJP/man/man8/mount_msdos.8 new file mode 100644 index 0000000000..644b4fb3da --- /dev/null +++ b/ja_JP.eucJP/man/man8/mount_msdos.8 @@ -0,0 +1,123 @@ +.\" +.\" Copyright (c) 1993,1994 Christopher G. Demetriou +.\" 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 Christopher G. Demetriou. +.\" 3. 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: mount_msdos.8,v 1.3 1996/04/03 23:11:08 gpalmer Exp % +.\" jpman %Id: mount_msdos.8,v 1.3 1997/09/08 01:55:26 seki Stab % +.\" +.Dd April 7, 1994 +.Dt MOUNT_MSDOS 8 +.Os FreeBSD 2.0 +.Sh 名称 +.Nm mount_msdos +.Nd MS-DOS ファイルシステムをマウントする +.Sh 書式 +.Nm mount_msdos +.Op Fl u Ar uid +.Op Fl g Ar gid +.Op Fl m Ar mask +.Pa special +.Pa node +.Sh 解説 +.Nm mount_msdos +コマンドは、デバイス名 +.Pa special +上の MS-DOS ファイルシステムを、 +グローバルファイルシステムの名前空間の +.Pa node +の示す位置に接続します。 +通常このコマンドは、ブート時に +.Xr mount 8 +によって実行されますが、 +任意のユーザが、 +自分の所有する任意のディレクトリに +MS-DOS ファイルシステムをマウントするために使うこともできます。 +(もちろん、 +そのファイルシステムを含むデバイスに対して +適切なアクセスを行えることが条件ですが。) +.Pp +オプションは以下のものが使用できます: +.Bl -tag -width Ds +.It Fl u +ファイルシステム上のファイルの所有者を +.Ar uid +にします。デフォルトの所有者はファイルシステムがマウントされるディレクトリの +所有者です。 +.It Fl g +ファイルシステム上のファイルのグループを +.Ar gid +にします。デフォルトのグループはファイルシステムがマウントされるディレクトリの +グループです。 +.It Fl m +ファイルシステム上のファイルの最大のパーミッションを指定します。 +(例えば、マスク +.Li 755 +は、デフォルトで、 +.\" ここでの by default は「MS-DOS の『ファイル属性』として特別な指定 +.\" がないとき」という意味であると思われる。意味がわかりにくいが、原文 +.\" もわかりにくいので、特に説明を補わない。 +.\" by <seki@sysrap.cs.fujitsu.co.jp> +所有者がファイルの読み書き実行の権限を持ち、 +他のユーザが読みと実行の権限だけを持つことを指定します。 +8 進のファイルモードに関しては +.Xr chmod 1 +を御覧下さい。) +.Ar mask +の下位 9 ビットのみが使用されます。 +デフォルトのマスクは、 +ファイルシステムがマウントされるディレクトリから取得されます。 +.El +.Sh 関連項目 +.Xr mount 2 , +.Xr unmount 2 , +.Xr fstab 5 +.Sh 警告 +.Nm msdos +ファイルシステムは MS-DOS バージョン 3.3 以降で作成されたファイルシステムで +うまく動くかどうかわかっていません。 +.Pp +MS-DOS が義務付けるファイル名の制限は、良く言っても奇妙です。 +例えば大文字小文字は区別されず、8 文字に 3 文字の拡張子しか許されません。 +.Pp +次のような警告: +.Pp +mountmsdosfs(): Warning: root directory is not a multiple of the clustersize in length +.Pp +が表示されるときには、 +MS-DOS ファイルシステムへ書き込みを行うと +ディスクの内容を壊してしまう可能性があります。 +これは直さなければならない問題点です。 +.Sh 歴史 +.Nm mount_msdos +は FreeBSD 2.0 にて初めて登場しました。 +この元になった、 +.Nm mount_pcfs +は FreeBSD 1 にて登場しましたが、 +よりそれらしい名前の +.Nm mount_msdos +が出来たため廃止されました。 diff --git a/ja_JP.eucJP/man/man8/mount_nfs.8 b/ja_JP.eucJP/man/man8/mount_nfs.8 new file mode 100644 index 0000000000..49b1cb72b3 --- /dev/null +++ b/ja_JP.eucJP/man/man8/mount_nfs.8 @@ -0,0 +1,297 @@ +.\" Copyright (c) 1992, 1993, 1994 +.\" 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. +.\" +.\" 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. +.\" +.\" @(#)mount_nfs.8 8.2 (Berkeley) 3/27/94 +.\" +.\" %Id: mount_nfs.8,v 1.5.2.1 1997/05/14 08:19:19 dfr Exp % +.\" jpman %Id: mount_nfs.8,v 1.3 1997/05/19 17:04:14 horikawa Stab % +.\"" +.Dd March 27, 1994 +.Dt MOUNT_NFS 8 +.Os BSD 4.4 +.Sh 名称 +.Nm mount_nfs +.Nd NFS(ネットワークファイルシステム)をマウントする +.Pp +.Sh 書式 +.Nm mount_nfs +.Op Fl 23KPTUbcdilqs +.Op Fl D Ar deadthresh +.Op Fl I Ar readdirsize +.Op Fl L Ar leaseterm +.Op Fl R Ar retrycnt +.Op Fl a Ar maxreadahead +.Op Fl g Ar maxgroups +.Op Fl m Ar realm +.Op Fl o Ar options +.Op Fl r Ar readsize +.Op Fl t Ar timeout +.Op Fl w Ar writesize +.Op Fl x Ar retrans +.Ar rhost:path node +.Sh 解説 +.Nm mount_nfs +は、ファイルシステムツリー上の指定された +.Ar node +にリモートのNFSファイルシステム (rhost:path) をマウントするために、 +.Xr mount 2 +システムコールを呼び出します。このコマンドは通常、 +.Xr mount 8 +によって実行されます。このプログラムは、RFC 1094 の Appendix. A および +.%T "NFS: Network File System Version 3 Protocol Specification" , +Appendix I. +に記述されているマウントプロトコルを実装しています。 +.Pp +オプションを以下に示します: +.Bl -tag -width indent +.It Fl 2 +NFS バージョン 3 プロトコルを使用します +(デフォルトはバージョン 3 をまず試した後にバージョン 2 を用います)。 +.It Fl 3 +NFS バージョン 3 プロトコルを使用します。 +.It Fl D +NQNFSにおいて +.Dq "停止サーバ閾(dead server threshold)" +をタイムアウト (round trip timeout) 回数で指定します。 +再送タイムアウトが +.Dq 停止サーバ閾 +に達した後は、無応答なサーバに関するキャッシュデータを無効なものと見倣します。 +値は 1 から 9 までで、9は +.Dq "無限停止閾(infinite dead threshold)" +です(キャッシュデータを有効と見倣す事はありません)。 +このオプションは一般に薦められるものではなく実験的なものです。 +.It Fl I +readdir での読みとリサイズを指定した値にします。 +値は通常 BIRBLKSIZ の倍数であり、マウントの読み取りサイズ以下です。 +.It Fl K +クライアント-サーバ間のユーザ認証用に Kerberos 認証書をサーバへ渡します。 +カーネルが NFSKERB オプションにて構築されている必要があります +インタネットドラフト +.%T "Authentication Mechanisms for ONC RPC" +を御覧下さい。) +.It Fl L +NQNFSにおいて、リース期間を指定した秒数にします。 +応答遅延 (round trip delay) が大きな場合だけ使って下さい。 +値は通常、 10 秒から 30 秒の間です。 +.It Fl P +予約されたソケットポート番号を使います。 +これはクライアントに、予約されたポートを使用する事によりより安全に NFS +を行えると言う誤った考えに基づき、 +予約されたポートをクライアントに使用させるサーバをマウントする場合に有効です。 +(まれな場合、クライアントが信頼できる root アカウントを持ち、 +信頼できないユーザやネットワークケーブルは安全な所にある場合役に立ちますが、 +通常のデスクトップクライアントには当てはまりません。) +.It Fl R +マウントする際のリトライ回数を、指定された値にします。 +.It Fl T +UDP の代わりに TCP を使います。これは、サーバがクライアントと +同じLANケーブル上にない場合に使うことをお勧めします +(注意:この機能は大抵の非BSDサーバではサポートされていません)。 +.It Fl U +TCP NFS マウントであっても、マウントプロトコルに UDP を強制します。 +(古い BSD サーバにて必要です。) +.It Fl a +先読みブロック数を指定した値に設定します。値は 0 から 4 までの範囲で、 +サイズの大きなファイルをシーケンシャルに読む場合、 +何ブロック先読みするかを決定します。 +帯域幅×遅延が大きな状況でマウントする場合に 1 より大きな値をお勧めします。 +.It Fl b +最初にサーバの接続に失敗した場合、子プロセスを起動して、 +バックグラウンドでマウントを続けようとします。 +マルチユーザモードで起動する際、重要でないファイルシステムを +.Xr fstab 5 +に書いておく場合に役に立ちます。 +.It Fl c +.Tn UDP +マウントポイントに対しては、 +.Xr connect 2 +を使いません。 +これは、標準のポート番号 2049 からのリクエストに答えないサーバ +に対しては使う必要があります。 +.It Fl d +再送タイムアウト時間を動的に予測しません。これは、 +動的最そうタイムアウト時間予測が非常に短いために、 +UDP マウントが高いリトライレートを示しているような場合に有効です。 +.It Fl g +認証用のグループリストの最大サイズを、指定した値に設定します。 +RFC 1057 ではグループリストのサイズは 16 と記述されていますが、これを +扱えない古いサーバをマウントするときに使うべきです。 +多くのグループに属しているユーザに対してマウントポイントから +応答がない場合は、8 を指定してみて下さい。 +.It Fl i +マウントを割り込み可能とします。これは、応答しないサーバがあるために +ファイル関連のシステムコールが遅れるような場合、 +プロセスに終了シグナルが送られると、EINTR で +システムコールが失敗することを意味します。 +.It Fl l +NQNFS と NFSV3 において、\fBReaddir_and_Lookup\fR RPCを使うことを +指定します。 +このオプションは +.Dq "ls -l" +するようなときにRPCのトラフィックを減らしますが、 +属性と名前のキャッシュをプリフェッチエントリで溢れさせる傾向があります。 +このオプションを指定して性能が良くなるのか悪くなるのかを確認して下さい。 +バンド幅と遅延の積が大きなネットワークにて最も有用でしょう。 +.It Fl m +Kerberos の管理領域を文字列で指定します。 +ほかの管理領域にマウントする場合に +.Fl K +オプションと共に使います。 +.It Fl o +.Fl o +フラグの後に、オプションをコンマで区切って並べ指定します。 +指定可能なオプションとその意味は +.Xr mount 8 +を参照してください。 +以下の NFS 固有のオプションを使用可能です: +.Bl -tag -width indent +.It port=<port_number> +指定したポート番号を NFS 要求に使用します。 +デフォルトでは portmapper に問い合わせます。 +.El +.Pp +.Bl -tag -width "dumbtimerXX" +\fB歴史的な \&-o オプション\fR +.Pp +これらのオプションを使用する事は勧められません。 +歴史的な +.Nm mount_nfs +との互換性のためにここに記述してあります。 +.It bg +.Fl b +と同じ。 +.It conn +.Fl c +と同じ。 +.It dumbtimer +.Fl d +と同じ。 +.It intr +.Fl i +と同じ。 +.It kerb +.Fl K +と同じ。 +.It nfsv2 +.Fl 2 +と同じ。 +.It nfsv3 +.Fl 3 +と同じ。 +.It rdirplus +.Fl l +と同じ。 +.It mntudp +.Fl U +と同じ。 +.It resvport +.Fl P +と同じ。 +.It seqpacket +.Fl p +と同じ。 +.It nqnfs +.Fl q +と同じ。 +.It soft +.Fl s +と同じ。 +.It tcp +.Fl T +と同じ。 +.El +.It Fl q +キャッシュの一貫性を保つためにプロトコルのリース拡張を NFS バージョン 3 +プロトコルにて使います。 +このプロトコルのバージョン 2 は Not Quite Nfs (NQNFS) と呼ばれ、 +最新の NFS コードでのみサポートされています。 +(4.4BSD-Lite における NQNFS のリリースとは互換性がありません。 +4.4BSD-Lite NFS システムを混在させて使用する場合には、 +4.4BSD-Lite ベースシステムの NFS コードをアップグレードするまで、 +このオプションを使用してはなりません。) +.It Fl r +データのリードサイズを指定した値にします。この値は通常 1024 +以上の 2 のべき乗でなければなりません。これはマウントポイント +を頻繁に使っている間に、 +.Dq タイムアウトで消失したフラグメント数 +が大きくなっていくときに、UDP マウントに対して使います +.Pf ( Xr netstat 1 +を +.Fl s +オプション付きで使う +ことで、 +.Dq タイムアウトで消失したフラグメント数 +の値を見ることができます)。 +.Fl w +オプションも参照 +してください。 +.It Fl s +ソフトマウントを行います。これは、 +タイムアウトが決められた\fBリトライ\fR回数に達すると、 +システムコールが失敗することを意味します。 +.It Fl t +指定した値に初期再送タイムアウト時間を設定します。パケット +の消失レートの高いネットワークや負荷の高いサーバで行う UDP マウントを +チューニングするときに役立ちます。 +ファイルシステムがアクティブなときに +.Xr nfsstat 1 +が高い再送レートを示す場合には、この値を増やしてみて下さい。 +一方、再送レートは低いが、応答遅延が長い場合はこの値を減らします。 +(通常、-d オプションをこのオプションとともに使い、 +手動でタイムアウトインターバルを調整します。) +.It Fl w +指定した値にライトデータサイズを設定します。解説は +.Fl r +オプションと同様ですが、 +.Dq タイムアウトで消失したフラグメント数 +は、クライアントのかわりにサーバの値を使います。 +.Fl r +や +.Fl w +のオプションは、マウントするサーバが TCP +マウントをサポートしていない場合にパフォーマンスを向上させる +最後の手段であることに注意してください。 +.It Fl x +ソフトマウントの再送タイムアウト回数を設定します。 +.El +.Sh 関連項目 +.Xr mount 2 , +.Xr unmount 2 , +.Xr fstab 5 , +.Xr mount 8 +.Sh バグ +Sun RPCは UDP (信頼性のないデータグラム) トランスポート層上に +実装されているため、マウントの性能をチューニングしても +限界があります。サーバが同じLANケーブル上にない場合や、 +サーバの負荷が高い場合には、 +.Tn TCP +トランスポートを使うことを強くすすめますが、 +残念なことに、ほぼ 4.4BSD サーバに限られています。 diff --git a/ja_JP.eucJP/man/man8/mount_null.8 b/ja_JP.eucJP/man/man8/mount_null.8 new file mode 100644 index 0000000000..6cdc6ba8a8 --- /dev/null +++ b/ja_JP.eucJP/man/man8/mount_null.8 @@ -0,0 +1,208 @@ +.\" +.\" Copyright (c) 1992, 1993, 1994 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" This code is derived from software donated to Berkeley by +.\" John Heidemann of the UCLA Ficus project. +.\" +.\" +.\" 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. +.\" +.\" 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. +.\" +.\" from: @(#)mount_null.8 8.4 (Berkeley) 4/19/94 +.\" %Id: mount_null.8,v 1.5.2.1 1997/10/19 17:23:25 joerg Exp % +.\" jpman %Id: mount_null.8,v 1.2 1997/03/31 13:38:01 horikawa Stab % +.\" +.Dd April 19, 1994 +.Dt MOUNT_NULL 8 +.Os BSD 4.4 +.Sh 名称 +.Nm mount_null +.Nd 何もしない(null)ファイルシステム層の利用のデモ +.Sh 書式 +.Nm mount_null +.Op Fl o Ar options +.Ar target +.Ar mount_point +.Pp +.Sh 解説 +.Nm mount_null +は、null 層を作ります。これは、 +ファイルシステムの名前空間の部分木を、グローバルなファイルシステムの名前空間 +の別の場所にエイリアスします。 +歴史的な +ループバックファイルシステムと異なるのは、次の2つの点です: 1つは、ファイル +システムのスタック化可能層(stackable layers)という技術を使って +実装されている点、もう1つはディレクトリの vnode だけでなく、 +すべての下位層の vnode の上に +``null-node''が積み重なっているという点です。 +.Pp +オプションは以下のものがあります: +.Bl -tag -width indent +.It Fl o +.Fl o +のあとに、オプション文字列をコンマで区切って指定すること +ができます。指定可能なオプションとその意味は +.Xr mount 8 +を参照してください。 +.El +.Pp +この null 層は2つの目的を持っています。1つは、何もしない層 +を提供することでファイルシステムの層の構築のデモを示すことです(実際には +何も行わないというわけではなく、 +ループバックファイルシステムが提供することはすべて行います)。 +もう1つはプロトタイプ層を提供することで +す。層のフレームワークとして必要なことはすべて提供しているので、 +ここから新しいファイルシステム層を簡単に作り出すことができます。 +.Pp +このマニュアルの以下の部分では、新しいファイルシステム層を構築するための +基礎として null 層を調べます。 +.\" +.\" +.Sh 新しい null 層の例示 +新しい null 層は +.Xr mount_null 8 +で作られます。 +.Xr mount_null 8 +は +2つの引数をとります。 +1つは下位層の vfs のパス名(target-pn)で、 +もう1つは null 層が現れる名前空間内のパス名(mount-point-pn)です。 +null 層が適切な場所に置かれた後、 +目的のディレクトリ階層(target-pn)の中身が +マウント先(mount-point-pn)にエイリアスされます。 +.\" +.\" +.Sh null 層の操作 +null 層は最小のファイルシステム層であり、 +すべての操作を下位層に処理させるためにバイパスするだけです。 +ほとんどすべてのvnodeに対する操作はパスすることですが、 +その動作のほとんどはバイパスルーチンに集中します。 +.Pp +バイパスルーチンは下位層における任意の vnode に対する操作を受け付けます。 +まず、vnodeに対する操作の引数を検査し、 +null-node を下位層において等価となるものに置き換えることから始めます。 +次に、下位層の操作を起動します。 +最後に、引数中の null-node を置き換えます。 +もしその操作によってvnodeが返ってきたら、 +その返ってきたvnodeの上に null-node を積みます。 +.Pp +ほとんどの操作をバイパスしますが、 +.Em vop_getattr , +.Em vop_inactive , +.Em vop_reclaim , +や +.Em vop_print +はバイパスしません。 +.Em vop_getattr +は戻り値の fsid を替えなければなりません。 +.Em vop_inactive +と vop_reclaim は、null 層特有のデータを解放するためにバイパスしません。 +.Em vop_print +は過度のデバッグ情報を避けるためにバイパスしません。 +.\" +.\" +.Sh vnodeスタックの概説 +マウントは null 層を下位層に関連づけます。 +その結果 2 つの VFS が積み重なります。 +vnode スタックはファイルがアクセスされるたびに必要に応じて作成されます。 +.Pp +最初のマウントでは新しい null 層の根として単一の vnode スタックを作ります。 +他のすべての vnode スタックは根の vnode スタックや他の null vnode スタックの +操作の結果として作られます。 +.Pp +vnode を返す操作の結果として新しい vnode スタックが生まれます。 +バイパスルーチンは、呼出し側に vnode を返す前に新しい vnode の上に null-node +を積みます。 +.Pp +例えば、null 層を以下のようにマウントする例を想像します。 +.Bd -literal -offset indent +mount_null /usr/include /dev/layer/null +.Ed +.Pa /dev/layer/null +にチェンジディレクトリすると、根の null-node (null 層をマウントした時 +に作られたもの) が割り当てられます。 +ここで +.Pa sys +をオープンすることを考えてみます。 +vop_lookup は根の null-node で行なわれます。 +この操作は下位層にバイパスされ、下位層が +UFS の +.Pa sys +を表す vnode を返します。 +それから null_bypass は +UFS +.Pa sys +にエイリアスする null-node を構築し、呼出元にこれを返します。 +null-node +.Pa sys +に対する以降の操作で他のvnodeスタックを構築する時には +この処理が繰り返されます。 +.\" +.\" +.Sh 他のファイルシステム層の作成 +新しいファイルシステム層を構築する一番簡単な方法は、 +null 層のコピーを作り、すべてのファイル、変数の名前を付け直し、 +そしてそのコピーを変更することです。 +すべての変数の名前を替えるのにはsedが良く使われます。 +.Pp +umap 層は null 層の子孫の 1 例です。 +.\" +.\" +.Sh 下位層の操作の起動 +操作が完全にはバイパスできない時に +下位層にある操作を起動するための方法が 2 つあります。 +それぞれの方法は違った状況に対して適切に使われます。 +両方の場合とも、 +その操作の引数を下位層のために正しく作るのはエイリアスする層の責任であり、 +vnode 引数を下位層にマッピングします。 +.Pp +最初の方法はエイリアスする層のバイパスルーチンを呼ぶことです。 +この方法は、下位層で現在扱われている操作を起動したい時に最も適しています。 +これはバイパスルーチンがすでにマッピングされているという利点があります。 +この例として、 +.Em null_getattrs +が null 層にあります。 +.Pp +2 つ目の方法は、 +.Em VOP_OPERATIONNAME +インターフェースを用いて下位層のvnodeの操作を直接起動することです。 +この方法の利点は、下位層の任意の操作を起動するのが簡単ということにあります。 +欠点は、vnode 引数は手動でマッピングされなければならないことです。 +.\" +.\" +.Sh 関連項目 +.Xr mount 8 +.sp +UCLA Technical Report CSD-910056, +.Em "Stackable Layers: an Architecture for File System Development" . +.Sh 歴史 +.Nm mount_null +は、 +.Bx 4.4 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/mount_portal.8 b/ja_JP.eucJP/man/man8/mount_portal.8 new file mode 100644 index 0000000000..e46e1635dd --- /dev/null +++ b/ja_JP.eucJP/man/man8/mount_portal.8 @@ -0,0 +1,140 @@ +.\" +.\" Copyright (c) 1993, 1994 +.\" The Regents of the University of California. All rights reserved. +.\" All rights reserved. +.\" +.\" This code is derived from software donated to Berkeley by +.\" Jan-Simon Pendry. +.\" +.\" 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. +.\" +.\" 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. +.\" +.\" @(#)mount_portal.8 8.3 (Berkeley) 3/27/94 +.\" jpman %Id: mount_portal.8,v 1.2 1997/03/31 13:38:30 horikawa Stab % +.\" +.\" +.Dd March 27, 1994 +.Dt MOUNT_PORTAL 8 +.Os BSD 4.4 +.Sh 名称 +.Nm mount_portal +.Nd ポータルデーモンをマウントする +.Pp +.Sh 書式 +.Nm mount_portal +.Op Fl o Ar options +.Ar /etc/portal.conf +.Ar mount_point +.Sh 解説 +.Nm mount_portal +コマンドは、ポータルデーモンが提供するインスタンスを +ファイルシステムの名前空間に付加します。 +慣例的なマウントポイントは +.Pa /p +です。このコマンド +は、通常、ブート時に +.Xr mount 8 +によって実行されます。 +.Pp +オプション: +.Bl -tag -width indent +.It Fl o +オプションは +.Fl o +のあとにオプション文字列をコンマで区切って並べることにより指定します。 +指定できるオプションとそれらの意味は +.Xr mount 8 +を参照してください。 +.El +.Pp +ポータルデーモンは +.Em open +サービスを提供します。ポータルマウントポイント下で +オブジェクトをオープンすると、ポータルデーモンは設定ファイル中で指定 +されたルールに従って動的にそのオブジェクトを生成します。 +この機構を使えば、ソケットなどのディスクリプタをファイルシステムの +名前空間の中で使うことができるようになります。 +.Pp +ポータルデーモンは、オープンしようとするオブジェクトのフルパス名を +与えることによって動作します。デーモンは、設定ファイル中のルールに従って +適切なディスクリプタを生成し、このディスクリプタを open システムコールの +戻り値として +呼び出しプロセスに返します。 +.Sh 名前空間 +慣例に従い、ポータルデーモンは名前空間を部分名前空間に分割します。 +それぞれの部分名前空間は特定の型のオブジェクトを扱います。 +.Pp +現在、 +.Pa tcp +と +.Pa fs +という二つの部分名前空間が実装されています。 +.Pa tcp +名前空間はホスト名とポート番号(スラッシュ``/''で区切られる) +を与えられることで +.Tn TCP/IP +接続を確立します。 +.Pa fs +名前空間は、ルートディレクトリまで戻ってそこからたどった名前の +ファイルをオープンします。これは chroot によってルートディレクトリが +変更された環境において、もとのファイル +システムをアクセスする手法を安全に提供するために使用できます。 +.Sh 設定ファイル +設定ファイルはルールのリストによって構成されます。それぞれのルールは +1行に書かれ、空白で区切られた2つ以上のフィールドからなります。ハッシュ記号 +(``#'')から行末までは無視されます。空行も無視されます。 +.Pp +第1フィールドはパス名のプレフィックスで、要求されたパス名と比較されます。 +一致するものが見つかると、第2フィールドがデーモンに渡されてどの型の +オブジェクトを生成するかが示されます。 +その後に続くフィールドは生成関数に渡されます。 +.Pp +.Bd -literal -offset indent +# @(#)portal.conf 5.1 (Berkeley) 7/13/92 +tcp/ tcp tcp/ +fs/ file fs/ +.Ed +.Sh 関連ファイル +.Bl -tag -width /p/* -compact +.It Pa /p/* +慣例的なマウントポイント +.El +.Sh 関連項目 +.Xr mount 2 , +.Xr unmount 2 , +.Xr fstab 5 , +.Xr mount 8 +.Sh 警告 +このファイルシステムは +.Tn NFS +によってエクスポートすることはできません。 +.Sh 歴史 +.Nm mount_portal +は +.Bx 4.4 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/mount_std.8 b/ja_JP.eucJP/man/man8/mount_std.8 new file mode 100644 index 0000000000..f511b7bebc --- /dev/null +++ b/ja_JP.eucJP/man/man8/mount_std.8 @@ -0,0 +1,163 @@ +.\" +.\" Copyright (c) 1992, 1993, 1994 +.\" The Regents of the University of California. All rights reserved. +.\" All rights reserved. +.\" +.\" This code is derived from software donated to Berkeley by +.\" Jan-Simon Pendry. +.\" +.\" 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. +.\" +.\" 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. +.\" +.\" %Id: mount_std.8,v 1.3.2.2 1997/01/02 17:48:06 mpp Exp % +.\" jpman %Id: mount_std.8,v 1.3 1997/09/23 16:40:39 horikawa Stab % +.\" +.Dd May 13, 1996 +.Dt MOUNT_STD 8 +.Os FreeBSD 2.2 +.Sh 名称 +.Nm mount_std , +.Nm mount_devfs , +.Nm mount_fdesc , +.Nm mount_kernfs , +.Nm mount_procfs +.Nd ``標準'' ファイルシステムをマウントする +.Sh 書式 +.Nm mount_ Ns Ar fsname +.Op Fl o Ar options +.Ar "fs" +.Ar mount_point +.Sh 解説 +.Nm +は ``標準'' ファイルシステムをファイルシステムにマウントする一般的な機構です。 +.Nm +は現在以下のファイルシステムをサポートしています: +.Nm devfs , +.Nm fdesc , +.Nm kernfs , +.Nm procfs +。 +``標準'' ファイルシステムは: +.Bl -enum -offset indent +.It +標準の +.Fl o +オプションだけを受け付けます +.Dq ro +.Pq ``rdonly'' , +.Dq rw , +.Dq nodev , +.Dq noexec , +.Dq nosuid , +.Dq union +。 +.It +ユーザに見える名前と同じ、カーネルファイルシステムモジュール名を持ちます。 +.It +.Nm mount_std +では特別な処理を行う必要は有りません。 +.El +.Pp +オプションを以下に示します: +.Bl -tag -width indent +.It Fl o +.Fl o +フラグの後には、コンマで区切ったオプション文字列を指定することができます。 +指定可能なオプションとその意味は、 +.Xr mount 8 +マニュアルページを参照して下さい。 +.El +.Pp +.Nm +は 0 番目のコマンドライン引数(呼ばれたコマンド名)を検査し、 +マウントすべきファイルシステムを判定します。 +これが +.Dq Li _ Ns Ar fsname +で終らない場合、 +.Nm +は( +.Xr mount 8 +と同じく)、ファイルシステムタイプの名前のみが 0 番目の引数に格納されていると +見倣します。 +.Nm +は、この様にマウントされる分散ファイルシステムのコマンドへの +適切なリンクとして、通常はインストールされます。 +各ファイルシステムの機能に関しては、 +.Nm mount_ Ns Ar fsname +を御覧下さい。 +.Pp +ファイルシステムに関する詳細は以下のマニュアルページを参照下さい: +.Xr devfs 5 , +.Xr fdesc 5 , +.Xr kernfs 5 , +.Xr procfs 5 +。 +.Sh 診断 +.Bl -diag +.It argv[0] must end in _fsname +.Nm mount_std +コマンドが +.Dq Li mount_std +の 0 番目の引数のコマンドとして呼ばれました。 +.It vfsload(%s) +.Nm +は %s ファイルシステムタイプを実装するカーネルモジュールをロードできません。 +.It %s filesystem not available +固有のファイルシステムタイプがカーネル中に存在せず、 +ロード可能なモジュールが見付かりません。 +.El +.Sh 関連項目 +.Xr mount 2 , +.Xr unmount 2 , +.Xr getvfsbyname 3 , +.Xr devfs 5 , +.Xr fdesc 5 , +.Xr fstab 5 , +.Xr kernfs 5 , +.Xr procfs 5 , +.Xr mount 8 +.Sh 注意 +``標準'' ファイルシステムは NFS エクスポートできません。 +.Sh 歴史 +.Nm mount_std +は +.Fx 2.2 +から登場しました。 +ロード可能なファイルシステムモジュールは +.Fx 2.0 +から登場しました。 +.Dq fdesc , +.Dq kernfs , +.Dq procfs +ファイルシステムタイプは +.Fx 2.0 +から登場しました; +.Dq devfs +ファイルシステムタイプは +.Fx 2.2 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/mount_umap.8 b/ja_JP.eucJP/man/man8/mount_umap.8 new file mode 100644 index 0000000000..54a4d49ff5 --- /dev/null +++ b/ja_JP.eucJP/man/man8/mount_umap.8 @@ -0,0 +1,124 @@ +.\" Copyright (c) 1992, 1993, 1994 +.\" The Regents of the University of California. All rights reserved. +.\" All rights reserved. +.\" +.\" This code is derived from software donated to Berkeley by +.\" Jan-Simon Pendry and from John Heidemann of the UCLA Ficus project. +.\" +.\" 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. +.\" +.\" 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. +.\" +.\" @(#)mount_umap.8 8.3 (Berkeley) 3/27/94 +.\" jpman %Id: mount_umap.8,v 1.2 1997/04/12 15:56:14 horikawa Stab % +.\" +.Dd "March 27, 1994" +.Dt MOUNT_UMAP 8 +.Os BSD 4.4 +.Sh 名称 +.Nm mount_umap +.Nd ファイルシステム層のサンプルファイルシステム +.Pp +.Sh 書式 +.Nm mount_umap +.Op Fl o Ar options +.Ar target +.Ar mount-point +.Ar uid-mapfile +.Ar gid-mapfile +.Sh 解説 +.Nm mount_umap +は、ローカルシステムとは異なる uid, gid を使用するファイルシステムの +サブトリーをマウントするために使用します。 +そのようなファイルシステムには、別のサイトの NFS や +別のパスワードを使用する場所から持って来たリムーバブルメディア上の +ファイルシステムです。 +.Pp +以下のオプションを使用可能です: +.Bl -tag -width indent +.It Fl o +.Fl o +のあとに、コンマで区切ってオプション文字列を指定することができます。 +可能なオプションとその意味は +.Xr mount 8 +を参照してください。 +.El +.Pp +.Nm mount_umap +はユーザが提供するファイルのセットを使用し、 +サブトリーの元の環境とローカルの環境との uid, gid の対応を取ります。 +元の環境では smith は uid 1000 を持ち、ローカル環境では +uid 2000 を持ちます。 +.Nm mount_umap +は、smith のオリジナルの環境で持っているファイルを次のようにマップさせます: +uid 1000 が所有するファイルを、実際には uid 2000 が所有者である +かのように見せます。 +.Pp +.Em target +は、ローカルファイルシステム中での現在の位置を記述します。 +.Em mount_point +はマップされたサブトリーが置かれるディレクトリです。 +.Em uid-mapfile +と +.Em gid-mapfile +には、識別子の対応が記述されます。 +それぞれのファイルの1行目には、そのファイルがいくつの対応を持っている +かを記述します。 +2行目からは、各行に対応を記述します。 +最初の項目はオリジナル環境での id で、次の項目がローカルな環境での idで、 +項目は空白で区切ります。 +.Em uid-mapfile +にはすべての uid の対応を、 +.Em gid-mapfile +にはすべての gid の対応を記述するべきです。 +.Em uid-mapfile +に記載されない uid は NOBODY と、 +.Em gid-mapfile +に記載されない gid は NULLGROUP と扱われます。 +uid の対応は64個まで、gid の対応は16個まで記述することができます。 +.Pp +マップファイルはファイル階層のどこにでも置くことができますが、 +ファイルの所有者はrootで、rootのみが書き込めるようにしておかなければ +なりません。 +.Nm mount_umap +は、もしこれらのファイルの所有者や権限が +不適切な場合はサブトリーをマップしません。 +もしマップファイルの1行目の対応数と実際の対応数が異なる場合も、 +実行を停止します。 +.Pp +.Nm mount_umap +コマンドで作られるファイルシステム層は、簡単なファイルシステム層の +例となっています。商品としての利用は考えられていません。 +そのため、あまり洗練された実装ではありません。 +.Sh 関連項目 +.Xr mount 8 , +.Xr mount_null 8 +.Sh 歴史 +.Nm mount_umap +は +.Bx 4.4 +から実装されました。 diff --git a/ja_JP.eucJP/man/man8/mount_union.8 b/ja_JP.eucJP/man/man8/mount_union.8 new file mode 100644 index 0000000000..0031d5c023 --- /dev/null +++ b/ja_JP.eucJP/man/man8/mount_union.8 @@ -0,0 +1,194 @@ +.\" Copyright (c) 1994 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" This code is derived from software donated to Berkeley by +.\" Jan-Simon Pendry. +.\" +.\" 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. +.\" +.\" 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. +.\" +.\" @(#)mount_union.8 8.6 (Berkeley) 3/27/94 +.\" jpman %Id: mount_union.8,v 1.3 1997/08/31 14:06:42 horikawa Stab % +.\" +.Dd March 27, 1994 +.Dt MOUNT_UNION 8 +.Os BSD 4.4 +.Sh 名称 +.Nm mount_union +.Nd ユニオンファイルシステムをマウントする +.Sh 書式 +.Nm mount_union +.Op Fl br +.Op Fl o Ar options +.Ar directory +.Ar uniondir +.Sh 解説 +.Nm mount_union +コマンドは +.Ar directory +を +.Ar uniondir +の上に接続し、そこから両方のディレクトリツリーの内容が見えるようにします。 +デフォルトでは、 +.Ar directory +が +.Em 上の +層に、 +.Ar uniondir +が +.Em 下の +層になります。 +.Pp +オプションには以下のものがあります: +.Bl -tag -width indent +.It Fl b +デフォルトの上下関係を反転します。つまり、 +.Ar directory +が下の層に、 +.Ar uniondir +が上の層になります。ただし、マウントポイントは +.Ar uniondir +のままになります。 +.It Fl o +.Fl o +フラグの後には、オプション文字列をコンマで区切って指定します。 +指定可能なオプションと、その意味については +.Xr mount 8 +を参照してください。 +.It Fl r +.Xr mount_null 8 +でマウントした場合と同様に、下の層を完全に隠すようになります。 +.El +.Pp +ファイルシステムのセキュリティを維持するため、 +ファイルシステムをマウントするユーザは、スーパユーザか、 +マウントポイントのディレクトリに書き込み許可を持つ者でなければなりません。 +.Pp +ファイルの検索は、上の層、下の層の順におこなわれます。 +上の層にはエントリのないディレクトリが、下の層で見つかった場合には、上の層に +.Em シャドウ +ディレクトリが作られます。 +このディレクトリはユニオンマウントを実行したユーザの所有になり、モードは +.Dq rwxrwxrwx +(0777) をその時点で有効な umask で修正したものになります。 +.Pp +あるファイルが上の層に存在している場合、下の層にある +同じ名前のファイルをアクセスする方法はありません。 +どうしても必要なら、ループバックマウントとユニオンマウントを +組み合せることで、別のパス名を使って下の層のファイルを +アクセスできるようにしておくことができます。 +.Pp +オブジェクトへのアクセスは、それがディレクトリである場合を除き、 +通常のファイルシステムのアクセス権チェックのあとで実行されます。 +ディレクトリの場合には、アクセスをおこなうユーザは上の層と下の層の +両方のディレクトリのアクセス権を持っていなければなりません +(両方のディレクトリが存在している必要があります)。 +.Pp +いくつかの特別な場合を除き、 +.Ar uniondir +中のオブジェクトの作成や変更の要求は上の層に渡されます。 +下の層に存在するファイルを書き込み用にオープンしようとすると、 +そのファイルの +.Em 完全な +コピーが上の層に作成され、それから上の層のコピーがオープンされます。 +同様に、下の層のファイルを切り詰めてサイズを 0 にしようとすると、 +空のファイルが上の層に作成されることになります。 +これ以外の、本当に下の層の変更が必要となる操作は失敗し、 +.Dv EROFS +が返されます。 +.Pp +ユニオンファイルシステムは、個々のファイルシステムを扱うというよりも +名前空間を扱うものです。ユニオンマウントは +.Ar uniondir +以下のディレクトリツリーに再帰的に影響します。 +このため +.Ar uniondir +以下にマウントされたファイルシステムは、すべて +ユニオン効果を持つようになります。これが +.Xr mount 8 +の +.Em union +オプションとは異なる点です。 +union オプションでは、ユニオン効果はマウントポイントだけに働き、 +ファイル名の探索のみに使われます。 +.Sh 使用例 +コマンド +.Bd -literal -offset indent +mount -t cd9660 -o ro /dev/cd0a /usr/src +mount -t union -o /var/obj /usr/src +.Ed +.Pp +は、CD-ROM ドライブ +.Pa /dev/cd0a +を +.Pa /usr/src +にマウントし、その上に +.Pa /var/obj +を重ねます。ほとんどの場合、これはソースツリーが実際には CD-ROM 上に +あるにもかかわらず、書き込みが可能になるという効果を目的としています。 +.Pp +コマンド +.Bd -literal -offset indent +mount -t union -o -b /sys $HOME/sys +.Ed +.Pp +は、ユーザのホームディレクトリの下の +.Pa sys +ディレクトリに、システムのソースツリーを下の層として重ね合わせます。 +これにより、個々のユーザがそのソースツリーに対して個人的な変更を加えて、 +新しいカーネルを構築することができるようになります。 +他のユーザはその変更に関知しません。 +下の層のファイルは、そのまま +.Pa /sys +からアクセスできることに注意してください。 +.Sh 関連項目 +.Xr intro 2 , +.Xr mount 2 , +.Xr unmount 2 , +.Xr fstab 5 , +.Xr mount 8 , +.Xr mount_null 8 +.Sh バグ +上の層を支えているファイルシステムで、ホワイトアウトが +サポートされていないため、下の層のオブジェクトに対して +削除や名前変更の操作をおこなう方法はありません。 +このような操作や、下の層を変更する操作、たとえば +.Xr chmod 1 +のような操作に対しては、 +.Dv EROFS +が返されます。 +.Pp +ユニオンツリーの上で +.Xr find 1 +を実行すると、上の層にシャドウディレクトリのツリーが +作成されてしまうという副作用があります。 +.Sh 歴史 +.Nm mount_union +コマンドは +.Bx 4.4 +で初めて登場しました。 diff --git a/ja_JP.eucJP/man/man8/mountd.8 b/ja_JP.eucJP/man/man8/mountd.8 new file mode 100644 index 0000000000..9bee5dcf84 --- /dev/null +++ b/ja_JP.eucJP/man/man8/mountd.8 @@ -0,0 +1,177 @@ +.\" Copyright (c) 1989, 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. +.\" +.\" 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. +.\" +.\" @(#)mountd.8 8.4 (Berkeley) 4/28/95 +.\" %Id: mountd.8,v 1.5.2.3 1997/05/14 08:19:20 dfr Exp % +.\" jpman %Id: mountd.8,v 1.3 1997/05/19 17:06:05 horikawa Stab % +.\" +.Dd April 28, 1995 +.Dt MOUNTD 8 +.Os +.Sh 名称 +.Nm mountd +.Nd リモートの +.Tn NFS +マウント要求に対するサービスを行うデーモン +.Sh 書式 +.Nm /sbin/mountd +.Op Fl 2nr +.Op Ar exportsfile +.Sh 解説 +.Nm mountd +は、他のクライアントマシンからの +.Tn NFS +マウント要求のためのサーバです。 +.Nm mountd +は、 +.Tn NFS +サーバの仕様で示されているポート +番号でサービス要求を待ちます。詳細は RFC1094 +.%T "Network File System Protocol Specification" +の Appendix A と +.%T "NFS: Network File System Version 3 Protocol Specification" +の Appendix I +を参照してください。 +.Pp +.Nm mountd +では、以下のオプションや引数を指定できます: +.Bl -tag -width Ds +.It Fl 2 +.Fl 2 +オプションを使用すると、 +このサーバからファイルシステムをマウントするクライアントに対し、 +管理者はバージョン 2 NFS プロトコルのみの使用を強制できます。 +.It Fl n +このオプションは、非ルートからのマウント要求を許可します。 +このオプションは、 +クライアントが PC であるなど、それがどうしても必要な +場合にのみ使うようにしてください。 +その場合、自動的に vfs.nfs.nfs_privport sysctl フラグがクリアされます。 +このフラグはカーネルが nfs 要求を受け付けるのが、 +予約されたポートからのみか否かを制御します。 +.It Fl r +.Fl r +オプションは,レギュラーファイルに対するマウント RPC 要求を許可します。 +これは,マウントプロトコルの仕様によると危険なようですが, +いくつかのディスクレスワークステーションは,スワップファイルをマウント +しようとしますし,それがレギュラーファイルであることを期待しています。 +レギュラーファイルは, +.Pa /etc/exports , +で指定できないので,スワップが置かれようとしているファイルシステム全体 +が, +.Fl alldirs +フラグとともに公開されていなければなりません。 +.Ar exportsfile +には、公開する( +.Tn NFS +エキスポートする) +ファイルシステムを記述したファイル +(公開設定ファイル:エキスポートファイル)のある場所を +指定します。 +.\" ↓以下の文も原文に対応が無い +.\" デフォルトは +.\" .Pa /etc/exports +.\" です。 +.El +.Pp +起動されると、 +.Nm mountd +は +.Xr mount 2 +システムコールによって、公開するホストアドレスとオプションを +カーネル内にロードします。 +公開設定ファイルを変更した場合は、 +.Nm mountd +に対してハングアップシグナルを送って +公開設定情報を再ロードする必要があります。 +.Dv SIGHUP +を送ったあと(例: +kill -HUP `cat /var/run/mountd.pid` +)、エキスポートファイルにエラーがあるかどうか、 +syslogの出力をチェックしてください。 +.Pp +動作中のカーネルは +.Tn NFS +を組み込んでいないものであると判明した場合、 +.Nm mountd +は、 +.Xr vfsload 3 +を用いる +.Xr modload 8 +コマンドを使って、 +.Tn NFS +を含むローダブルカーネルモジュールのロードを試みます。 +これが失敗するか、 +.Tn NFS LKM +が使用できない場合は、 +.Nm mountd +はエラー終了します。 +.\" ↓使用例の章は原文には存在しないのでコメントアウトする -- jpman J.Sakai +.\" .Sh 使用例 +.\" .Pa /etc/exports +.\" の例: +.\" .Pp +.\" .Bd -literal -offset indent +.\" /home/aino -alldirs +.\" .Ed +.\" .Pp +.\" これは、 +.\" .Pa /home/aino +.\" 以下のファイルシステムをすべて +.\" .Tn NFS +.\" で公開しています。 +.\" 詳細は、 +.\" .Xr exports 5 +.\" を参照してください。 +.Sh 関連ファイル +.Bl -tag -width /var/run/mountd.pid -compact +.It Pa /etc/exports +公開設定ファイル(エキスポートファイル) +.It Pa /var/run/mountd.pid +現在実行中の +.Nm mountd +のプロセス id +.Tn ID +.It Pa /var/db/mountdtab +現在マウントされているリモートファイルシステムのリスト +.El +.Sh 関連項目 +.Xr nfsstat 1 , +.Xr exports 5 , +.Xr modload 8 , +.Xr nfsd 8 , +.Xr portmap 8 , +.Xr showmount 8 +.Sh 歴史 +.Nm mountd +ユーティリティは +.Bx 4.4 +から登場しています。 diff --git a/ja_JP.eucJP/man/man8/moused.8 b/ja_JP.eucJP/man/man8/moused.8 new file mode 100644 index 0000000000..8f62043067 --- /dev/null +++ b/ja_JP.eucJP/man/man8/moused.8 @@ -0,0 +1,120 @@ +.\" Copyright (c) 1996 +.\" Mike Pritchard <mpp@FreeBSD.org>. 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 Mike Pritchard. +.\" 4. Neither the name of the author nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: moused.8,v 1.1.2.2 1997/09/29 06:36:12 charnier Exp % +.\" +.\" jpman %Id: moused.8,v 1.3 1997/07/22 16:52:17 horikawa Stab % +.Dd December 16, 1996 +.Dt MOUSED 8 +.Os FreeBSD +.Sh 名称 +.Nm moused +.Nd マウスデータをコンソールドライバに渡す +.Sh 書式 +.Nm +.Op Fl DRcdfs +.Op Fl S Ar baudrate +.Fl p Ar port +.Fl t Ar mousetype +.Sh 解説 +マウスデーモンは、シリアルポートからマウスデータを受け取り、 +データを解釈し、コンソールドライバに ioctl で渡します。 +.Pp +以下のオプションがあります。 +.Bl -tag -width indent +.It Fl D +シリアルポートの DTR を下げます。 +.It Fl R +シリアルポートの RTS を下げます。 +.It Fl S Ar baudrate +シリアルポートの速度を指定します (1200 ボーから 9600 ボー +が指定できます ) 。 +.It Fl c +ChordMiddle オプションを有効にします。 +.It Fl d +デバッグ用のメッセージを有効にします。 +.It Fl f +デーモンにならずに、フォアグラウンドプロセスとして実行します。 +.It Fl p Ar port +マウスと通信するためのシリアルポートとして +.Ar port +を使います。 +.It Fl s +シリアルラインのために 9600 ボーを選びます。 +.It Fl t Ar mousetype +シリアルポートにつながっているマウスの形式を指定します。 +有効なマウスの形式は、以下のものです。 +.Pp +.Bl -tag -compact -width mousesystemsxxx +.It microsoft +マイクロソフトマウス +.It mousesystems +マウスシステムマウス +.It mmseries +MM Series マウス +.It logitech +ロジテックマウス +.It busmouse +バスマウス +.It mouseman +Logitech MouseMan と TrackMan +.It ps/2 +PS/2 マウス +.It mmhittab +MM HitTablet +.El +.El +.Sh 使用例 +.Pp +.Dl moused -t microsoft -p /dev/mouse +.Dl vidcontrol -m on +.Pp +マウスデーモンを、シリアルデバイス +.Pa /dev/mouse +に対し、マイクロソフトマウス、マウスポインタ有効の条件で開始します。 +.Sh 関連項目 +.Xr vidcontrol 1 , +.Xr keyboard 4 , +.Xr pcvt 4 , +.Xr screen 4 , +.Xr sysmouse 4 +.Sh 作者 +.Nm +コマンドは、 +.An Michael Smith +によって書かれました。 +このマニュアルは、 +.An Mike Pritchard .Aq mpp@FreeBSD.org +によって書かれました。 +.Sh 歴史 +.Nm +コマンドは、 +.Fx 2.2 +から導入されました。 diff --git a/ja_JP.eucJP/man/man8/mrinfo.8 b/ja_JP.eucJP/man/man8/mrinfo.8 new file mode 100644 index 0000000000..b52d6c5ded --- /dev/null +++ b/ja_JP.eucJP/man/man8/mrinfo.8 @@ -0,0 +1,91 @@ +.\" 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 +は、 +.I multicast_router +で指定したマルチキャストルータの設定情報を表示します。 +.PP +.I mrinfo +は、ASK_NEIGHBORS IGMP メッセージを送信することで隣接するマルチキャスト +ルータのデータ取得を行ないます。指定したマルチキャストルータからの応答が +あった場合には、バージョン番号と隣接するマルチキャストルータのアドレス一 +覧が応答に含まれます。応答したルータが最新のマルチキャストバージョン番号を +持つ場合には、 +.I mrinfo +はメトリック、スレッシュホールド、フラグのような追加情報を要求します。指 +定したマルチキャストルータからの返答があると、当該ルータから取得した設定 +情報が標準出力に表示されます。 +.br +.ne 5 +.SH 起動 +.PP +"\-d" オプションはデバッグレベルを設定します。デバッグレベルがデフォルト +レベルであるところの 0 よりも大きい場合、追加デバッグメッセージが画面に出力 +されます。デバッグレベルにかかわらず、エラーについてはエラーメッセージ +が出力され、 +.I mrinfo +は終了します。 +デバッグレベルが 0 でない場合、以下の効果が期待できます: +.IP "level 1" +パケットウォーニングが標準エラー出力に対して出力されます。 +.IP "level 2" +レベル 1 のすべてのメッセージに加えて、ネットワークダウンについて標準エラー +出力に対して出力されます。 +.IP "level 3" +レベル 2 のすべてのメッセージに加えて、パケットタイムアウトのすべての情報が +標準エラー出力に対して出力されます。 +.PP +"\-r retry_count" オプションは隣接ルータに対するリトライ制限を設定します。 +デフォルトではリトライ回数は 3 です。 +.PP +"\-t timeout_count" +オプションは隣接ルータからの返答を待つ時間(タイムアウト)を秒単位で設定 +します。デフォルトのタイムアウトは 4 秒です。 +.PP +.SH 出力例 +.nf +.I 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 +指定したマルチキャストルータに隣接する個々のルータの IP アドレスが +表示されます。 +指定したルータの IP アドレスに続き、隣接するルータの IP アドレスと名前 +が表示されます。その後の括弧内には、メトリック(接続コスト)、スレッシュ +ホールド(マルチキャストパケット生存時間)が表示されます。問い合わせを受けた +マルチキャストルータが新しいバージョンの場合には、接続タイプ(tunnel, srcrt) +および接続状態(disabled, down)が表示されます。 +.PP +.SH 注意 +.I mrinfo +は、root で実行して下さい。 +.PP +.SH 関連項目 +.BR mrouted (8) , +.BR map-mbone (8) , +.BR mtrace (8) +.PP +.SH 作者 +Van Jacobson diff --git a/ja_JP.eucJP/man/man8/mrouted.8 b/ja_JP.eucJP/man/man8/mrouted.8 new file mode 100644 index 0000000000..6255e5ab64 --- /dev/null +++ b/ja_JP.eucJP/man/man8/mrouted.8 @@ -0,0 +1,426 @@ +'\"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 % +.\" 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 +は、RFC1075 にて規定されている Distance-Vector Multicast Routing Protocol +(DVMRP) の実装です。本コマンドは distance-vector routing protocol +(RIP に似たプロトコルであり、RFC1058 に記述されています) +を使うことで、ネットワークトポロジに関する情報を管理し、 +そのプロトコルの上で、Reverse Path Multicasting と呼ばれる +マルチキャストデータグラムフォワーディングアルゴリズムを実装しています。 +.PP +.I mrouted +は、マルチキャストデータグラムを、データグラムが生成されたサブネットを幹と +して樹状に構成されるパス上に、パスの最短距離を通過するようにして送出します。 +マルチキャストツリーは目的のグループを含むサブネットを越えないブロード +キャストツリーと考えることができます。 +したがって、データグラムはマルチキャストの受け手がいない枝には送出され +ません。 +さらに、マルチキャストデータグラムパケットの生存時間によっては、到達で +きる範囲が限定される場合もあります。 +.PP +IP マルチキャストをサポートしない (ユニキャスト) ルータを介したサブネット間で、 +マルチキャストを実現する場合、 +.I mrouted +の実装にはトンネリングのサポートも含まれます。トンネリングとは、 +インタネットのあらゆるところにて稼働している +.I mrouted +の組の間で仮想的なポイントツーポイントリンクを確立する技術です。 +IP マルチキャストパケットは、トンネルを通過するところでカプセル化されます。 +カプセル化されたパケットは、 +ルータ及びサブネットを進む通常のユニキャストデータグラムに見えます。 +トンネルの入口でカプセル化が行われ、トンネルの出口でカプセルが取り外されます。 +デフォルトでは、パケットは、IP-in-IP プロトコル +(IP プロトコル番号 4) +を用いることでカプセル化を +行ないます。 +古いバージョンの +.I mrouted +のトンネリングは、 +IP ソースルーティングを用いたものですが、 +本手法はルータによっては大きな負荷をかけることになります。 +本バージョンでは、IP ソースルーティングを用いたトンネリングは +サポートしません。 +.PP +トンネリング機構の実装により、 +.I mrouted +は、 +実際のインタネットとは独立の、 +マルチキャストパケットのみを扱う広範囲の自立システムに跨る +仮想インタネットを構築できます。 +これを可能にすることにより、 +実験的ではあるが、インターネットマルチキャストをサポートし、 +(ユニキャスト)ルータによるマルチキャストルーティング +を可能にします。 +.I mrouted +は deistance vector ルーティングプロトコルが持つ +よく知られたスケーリングの問題の影響を被りますし、 +階層的なマルチキャストルーティングを (まだ) サポートしていません。 +.PP +.I mrouted +はマルチキャストルーティングのみを扱いますので、同じ機械の上でユニキャ +ストルーティングソフトが走っていてもいなくても構いません。 +トンネリングを利用すれば、 +.I mrouted +はマルチキャストフォーワーディングのためにひとつより多くの +物理的なサブネットにアクセスする必要がありません。 +.br +.ne 5 +.SH 起動オプション +.PP +"\-d" オプションが与えられないか、もしくは debug level として 0 が指定された +場合、 +.I mrouted +は起動された端末から切り離されます。それ以外の場合は、 +.I mrouted +は、起動された端末に残り、起動された端末からの割り込みを受け付けます。 +"\-d" が引数なしで指定された場合の debug level はデフォルトの 2 です。 +debug level の指定の有無にかかわらず、 +.I mrouted +は常に警告メッセージやエラーメッセージを syslogd に対して送ります。 +0 以外の debug level が指定された場合、以下の挙動を示します: +.IP "level 1" +すべての syslog へ出力されるメッセージは、stderr へも出力されます。 +.IP "level 2" +debug level 1での挙動に加え、重要と思われる挙動通知を stderr に出力します。 +.IP "level 3" +debug level 2 での挙動に加え、すべてのパケット送出/到着について stderr +に出力します。 +.PP +起動にともない、mrouted はその pid を /var/run/mrouted.pid ファイルに +書き出します。 +.SH 初期設定 +.PP +.I mrouted +は、自動的にすべてのマルチキャスト可能なインタフェース、 +つまり、IFF_MULTICAST フラグがセットされたインターフェース +(ループバックインタフェースは除きます) に対して初期化を行い、別の +.IR mrouted +に直接接続可能なインターフェースを探索します。 +デフォルトの設定を上書きする、あるいは別の +.IR mrouted +に対するトンネルリンクを付加するには、 +/etc/mrouted.conf (もしくは "\-c" オプションによって指定されるファイル) +を編集します。 +コンフィグレーションのためには以下の 4 種類のコマンドがあります。 +.nf + + phyint <local-addr> [disable] [metric <m>] [advert_metric <m>] + [threshold <t>] [rate_limit <b>] + [boundary (<boundary-name>|<scoped-addr>/<mask-len>)] + [altnet <network>/<mask-len>] + + tunnel <local-addr> <remote-addr> [metric <m>] [advert_metric <m>] + [threshold <t>] [rate_limit <b>] + [boundary (<boundary-name>|<scoped-addr>/<mask-len>)] + + cache_lifetime <ct> + + name <boundary-name> <scoped-addr>/<mask-len> + +.fi +.PP +ファイルの形式は自由です。すなわち、空白文字 (改行も含みます) は意味を +持ちません。 +.I boundary +と +.I altnet +オプションは必要な数だけ指定して下さい。 +.PP +phyint コマンドはローカル IP アドレス <local-addr> によって認識される +物理インタフェース上のマルチキャストルーティングを無効にするか、 +デフォルトでない metric あるいは threshold を +物理インタフェースに結びつけます。 +ローカル IP アドレス <local-addr> はインタフェース名 (le0 等) +で代用できます。 +phyint が複数の IP からなるサブネットに向けられる場合、 +altnet キーワードを使用してそれぞれのサブネットについて記述して下さい。 +phyint コマンドは tunnel コマンドより前に書く必要が有ります。 +.PP +tunnel コマンドはローカル IP アドレス <local-addr> と +リモート IP アドレス <remote-addr> とを結ぶトンネルリンクを作り、 +デフォルトでない metric あるいは threshold をそのトンネルに結びつけます。 +ローカル IP アドレス <local-addr> はインタフェース名(le0 等)で +置き換えても構いません。 +リモート IP アドレス <remote-addr> は、 +ホスト名に結びつけられた IP アドレスが 1 つである場合に限り、 +ホスト名で置き換えても構いません。 +双方のルータの mrouted.conf ファイルにおいて、 +そのトンネルが使用される前に記述されている必要があります。 +.PP +cache_lifetime はキャッシュされたマルチキャスト経路がタイムアウトまで +に kernel 内にどれだけ保持されるかを定めます。この変数は 300 (5 分) か +ら 86400 (1 日) の間がいいでしょう。デフォルトは 300 です。 +.PP +設定をキーワードを用いて簡単に行うために、境界に名前をつけることもでき +ます。phyint あるいは tunnel コマンドの boundary オプションは +名前もしくは boundary のいずれかを受け付けます。 +.PP +metric は与えられたインタフェースかトンネルへデータグラムを送るため +の "コスト" です; 経路の選択に影響を与えます。 +デフォルト値は 1 です。metric は可能なかぎり小さくすべきです。 +なぜなら、 +.I mrouted +は metric の合計が 31 を越える経路を通ることができないからです。 +.PP +advert_metric は、与えられたインタフェースもしくは tunnel に関連する +"コスト" です; +これは経路選択に影響します。 +advert_metric のデフォルト値は 0 です。 +リンクの実際の metric は一端の metric ともう一端の advert_metric との和です。 +.LP +threshold は最小の IP の生存時間であり、 +この要件を満たすマルチキャストデータグラムは +指定されるインターフェースもしくはトンネルを転送されます。 +このパラメータによりマルチキャストデータグラムの到達範囲が定められます。 +(転送されたパケットの TTL は threshold と比較するだけで、 +threshold だけ TTL を減らしたりはしません。 +すべてのマルチキャストルータは TTL を 1 づつ減らします。) +デフォルト値は 1 です。 +.LP +特定のサブネットやトンネルへ接続する +.IR mrouted +は、一般的にはすべて同じ metric と threshold を持ちます。 +.PP +rate_limit オプションによって、ネットワークの管理者はマルチキャスト +トラフィックのために何キロビット毎秒のバンド幅をわりあてればよいかを指定 +できます。デフォルト値は、トンネルは 500Kbps、 +物理インタフェースは 0 (無制限) です。 +.PP +boundary オプションは、ある範囲のアドレスに対して、管理可能な境界を設 +定します。この範囲のアドレスに属するパケットは範囲内のインタフェース +には転送されません。boundary オプションは名前もしくは境界にて指定します。 +.PP +.I mrouted +は 2 つ以上の有効な vif (仮想インタフェース) が無いときには実行を開始しません。 +vif はマルチキャスト可能な物理インタフェースもしくはトンネルです。 +全ての仮想インターフェースがトンネルの場合は警告が記録されます; +そのような +.I mrouted +の設定は、より多くの直接トンネルを指定した方が良いかもしれません +(中間管理者を削除するという意味です)。 +.SH 設定例 +.PP +以下は大きな学校にある架空のマルチキャストルータでの例です。 +.sp +.nf +# +# mrouted.conf example +# +# Name our boundaries to make it easier +name LOCAL 239.255.0.0/16 +name EE 239.254.0.0/16 +# +# le1 is our gateway to compsci, don't forward our +# local groups to them +phyint le1 boundary EE +# +# le2 is our interface on the classroom net, it has four +# different length subnets on it. +# note that you can use either an ip address or an +# interface name +phyint 172.16.12.38 boundary EE altnet 172.16.15.0/26 + altnet 172.16.15.128/26 altnet 172.16.48.0/24 +# +# atm0 is our ATM interface, which doesn't properly +# support multicasting. +phyint atm0 disable +# +# This is an internal tunnel to another EE subnet +# Remove the default tunnel rate limit, since this +# tunnel is over ethernets +tunnel 192.168.5.4 192.168.55.101 metric 1 threshold 1 + rate_limit 0 +# +# This is our tunnel to the outside world. +# Careful with those boundaries, Eugene. +tunnel 192.168.5.4 10.11.12.13 metric 1 threshold 32 + boundary LOCAL boundary EE +.fi +.SH シグナル +.PP +.I mrouted +は以下のシグナルに反応します。 +.IP HUP +.I mrouted +を再スタートします。 +設定ファイルは再度読み込まれます。 +.IP INT +後かたづけをしてから実行終了します +(たとえば、隣接するルータすべてにさよならのメッセージを送ります)。 +.IP TERM +INT と同じです。 +.IP USR1 +内部ルーティングテーブルを /var/tmp/mrouted.dump にダンプし +ます。 +.IP USR2 +内部キャッシュテーブルを /var/tmp/mrouted.cache にダンプしま +す。 +.IP QUIT +内部ルーティングテーブルを stderr にダンプします。 +ただし、 +.I mrouted +が 0 以外の debug level の時のみです。 +.PP +シグナルを送る際の便宜のために、 +.I mrouted +は開始時に自身の pid を /var/run/mrouted.pid に書き出します。 +.bp +.SH 使用例 +.PP +ルーティングテーブルは以下のようになります: +.nf + +Virtual Interface Table + Vif Local-Address Metric Thresh Flags + 0 36.2.0.8 subnet: 36.2 1 1 querier + groups: 224.0.2.1 + 224.0.0.4 + pkts in: 3456 + pkts out: 2322323 + + 1 36.11.0.1 subnet: 36.11 1 1 querier + groups: 224.0.2.1 + 224.0.1.0 + 224.0.0.4 + pkts in: 345 + pkts out: 3456 + + 2 36.2.0.8 tunnel: 36.8.0.77 3 1 + peers: 36.8.0.77 (2.2) + boundaries: 239.0.1 + : 239.1.2 + pkts in: 34545433 + pkts out: 234342 + + 3 36.2.0.8 tunnel: 36.6.8.23 3 16 + +Multicast Routing Table (1136 entries) + Origin-Subnet From-Gateway Metric Tmr In-Vif Out-Vifs + 36.2 1 45 0 1* 2 3* + 36.8 36.8.0.77 4 15 2 0* 1* 3* + 36.11 1 20 1 0* 2 3* + . + . + . + +.fi +この例では、4 つの vif が 2 つのサブネットと +2 つのトンネルにつながっています。 +vif 3 がつながったトンネルは使われていません +(peer アドレスが有りません)。 +vif 0 と vif 1 がつながったサブネットには +いくつかのグループが有ります; +トンネルにはグループは有りません。 +この例の +.I mrouted +は、"querier" フラグが示すように、 +定期的なグループメンバシップクエリを vif 0 および vif 1 サブネットにて +送出する責任が有ります。 +境界のリストは当該インタフェースのアドレス範囲が示されます。 +入力及び出力パケット数が各インタフェースに対して示されます。 +.PP +マルチキャストデータグラムの起源となりうるサブネットに関連して +表示される情報は、 +直前のホップのルータのアドレス(サブネットが直接接続されていない場合)、 +起源までのパスのメトリック、 +当該サブネットから最後に更新を受信してから経過した時間、 +当該起源からのマルチキャストが入力される vif、 +出力 vif 一覧です。 +"*" は、 +起源を根とするブロードキャストツリーの葉に、 +当該出力 vif が接続していることを意味します。 +宛先グループのメンバが当該葉にいる時のみ、 +当該起源からのマルチキャストデータグラムを当該出力 vif からフォワードします。 +.bp +.PP +.I mrouted +はカーネル内のフォワーディングキャッシュテーブルも管理します。 +エントリの生成及び削除は +.I mrouted +が行います。 +.PP +キャッシュテーブルは以下のようなものです: +.nf + +Multicast Routing Cache Table (147 entries) + Origin Mcast-group CTmr Age Ptmr IVif Forwvifs + 13.2.116/22 224.2.127.255 3m 2m - 0 1 +>13.2.116.19 +>13.2.116.196 + 138.96.48/21 224.2.127.255 5m 2m - 0 1 +>138.96.48.108 + 128.9.160/20 224.2.127.255 3m 2m - 0 1 +>128.9.160.45 + 198.106.194/24 224.2.135.190 9m 28s 9m 0P +>198.106.194.22 + +.fi +各エントリは起源のサブネット番号、マスク、宛先マルチキャストグループにて +区別します。 +'CTmr' フィールドは当該エントリの生存時間を表します。 +このタイマ値が 0 まで減算されたエントリはキャッシュテーブルから削除されます。 +'Age' フィールドはこのエントリが最初に生成されてから経過した時間を表します。 +キャッシュエントリはリフレッシュされるため、 +当該エントリに関するトラフィックが続く限りルーティングエントリは生き残ります。 +'Ptmr' フィールドは、上流に枝刈が送出されていなければ単に -、 +そうでないばあいには上流の枝刈がタイムアウトするまでの時間を表します。 +'Ivif' フィールドは起源からのマルチキャストパケットが入力される vif +を表します。 +各ルータは特定のソース及びグループに関し、 +隣接するルータより受信する枝刈数の記録も管理します。 +あるサブネットに関してマルチキャストツリーの下流の枝において +マルチキャストグループのメンバが存在しない場合、 +上流のルータに対して枝刈メッセージが送信されます。 +この場合、vif 番号の後に "P" が付けられます。 +'Forwvifs' フィールドは +ソースグループに属するデータグラムがフォワードされる +インタフェースを表します。 +"p" は、このインタフェースを介してフォワードされるデータグラムが存在しない +ことを表します。 +リストされないインタフェースは葉のサブネットであり、 +特定のグループのメンバを当該サブネットに持ちません。 +インタフェースにおける "b" の表示は、 +当該インタフェースが境界インタフェースであることを表します。 +すなわち、範囲内のアドレスのトラフィックは +当該インタフェースを介してフォワードされないことを意味します。 +">" を最初の文字として表示する追加の行は、当該サブネット上のソースと表します。 +一つのサブネット上に複数のソースが存在可能であることに注意して下さい。 +.SH 関連ファイル +/etc/mrouted.conf +.br +/var/run/mrouted.pid +.br +/var/tmp/mrouted.dump +.br +/var/tmp/mrouted.cache +.SH 関連項目 +.BR mrinfo (8) , +.BR mtrace (8) , +.BR map-mbone (8) +.sp +DVMRP は、 +他のマルチキャスト経路制御アルゴリズムと共に、 +ACM SIGCOMM '88 コンファレンスのプロシーディングに、 +S. Deering が +"Multicast Routing in Internetworks and Extended LANs" +として記述しています。 +.SH 作者 +Steve Deering, Ajit Thyagarajan, Bill Fenner diff --git a/ja_JP.eucJP/man/man8/mtest.8 b/ja_JP.eucJP/man/man8/mtest.8 new file mode 100644 index 0000000000..4b71fc0c44 --- /dev/null +++ b/ja_JP.eucJP/man/man8/mtest.8 @@ -0,0 +1,60 @@ +.\" The following requests are required for all man pages. +.Dd December 15, 1996 +.\" jpman %Id: mtest.8,v 1.3 1997/08/16 13:28:57 horikawa Stab % +.Os +.Dt MTEST 8 +.Sh 名称 +.Nm mtest +.Nd マルチキャストメンバシップソケット操作と ioctl のテスト +.Sh 書式 +.Nm +.Sh 解説 +.Nm +はマルチキャストメンバシップソケット操作と ioctl のテストを行なう +簡単なプログラムです。 +以下のコマンドを対話的に受け取ります: +.Bl -tag -width "a ifname e.e.e.e.e.e" -compact -offset indent +.It Ic j Ar g.g.g.g Ar i.i.i.i +アドレス +.Ar i.i.i.i +を持つインタフェース上で、IP グループアドレス +.Ar g.g.g.g +に加わります。 +.Ar i.i.i.i +に 0.0.0.0 を指定するとデフォルトインタフェースを使用します。 +.It Ic l Ar g.g.g.g Ar i.i.i.i +アドレス +.Ar i.i.i.i +を持つインタフェース上で、IP グループアドレス +.Ar g.g.g.g +から抜けます。 +.It Ic a Ar ifname Ar e.e.e.e.e.e +インタフェース +.Ar ifname +上で、イーサネットグループアドレス +.Ar e.e.e.e.e.e +に加わります。 +.It Ic d Ar ifname Ar e.e.e.e.e.e +インタフェース +.Ar ifname +上で、イーサネットグループアドレス +.Ar e.e.e.e.e.e +から抜けます。 +.It Ic m Ar ifname Ar 1/0 +インタフェース +.Ar ifname +で、ALLMULTI モードをセットあるいはリセットします。 +.It Ic p Ar ifname Ar 1/0 +インタフェース +.Ar ifname +で、promiscuous モードをセットあるいはリセットします。 +.It Ic ? +有効なコマンド一覧を表示します。 +.It Ic q +プログラムを終了します。 +.El +.\" .Sh SEE ALSO +.Sh 作者 +.An Steve Deering +.Sh バグ +コマンドパーサはそれほど柔軟性をもっていません。 diff --git a/ja_JP.eucJP/man/man8/mtrace.8 b/ja_JP.eucJP/man/man8/mtrace.8 new file mode 100644 index 0000000000..31507cbc7f --- /dev/null +++ b/ja_JP.eucJP/man/man8/mtrace.8 @@ -0,0 +1,586 @@ +.\" Copyright (c) 1995 by the University of Southern California +.\" All rights reserved. +.\" +.\" Permission to use, copy, modify, and distribute this software and its +.\" documentation in source and binary forms for non-commercial purposes +.\" and without fee is hereby granted, provided that the above copyright +.\" notice appear in all copies and that both the copyright notice and +.\" this permission notice appear in supporting documentation, and that +.\" any documentation, advertising materials, and other materials related +.\" to such distribution and use acknowledge that the software was +.\" developed by the University of Southern California, Information +.\" Sciences Institute. The name of the University may not be used to +.\" endorse or promote products derived from this software without +.\" specific prior written permission. +.\" +.\" THE UNIVERSITY OF SOUTHERN CALIFORNIA makes no representations about +.\" the suitability of this software for any purpose. THIS SOFTWARE IS +.\" PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, +.\" INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF +.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. +.\" +.\" Other copyrights might apply to parts of this software and are so +.\" noted when applicable. +.\" +.\" This manual page (but not the software) was derived from the +.\" manual page for the traceroute program which bears the following +.\" copyright notice: +.\" +.\" Copyright (c) 1988 The Regents of the University of California. +.\" All rights reserved. +.\" +.\" 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" +.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 +から +.I source +への逆のパスに沿ったホップごとにトレースの問い合わせを行ない、パス上の +ホップのアドレス、パケット数、ルーティングのエラー状況の情報を収集し、 +要求者へ応答を返します。 +.PP +唯一必須であるパラメータは +.I source +のホスト名もしくはアドレスです。デフォルトの +.I receiver +は mtrace を実行しているホストとなり、デフォルトの +.I group +は "MBone Audio" (224.2.0.1) となります。特定のマルチキャストグループ +でのパケット消失の統計が必要でなければ、これで十分です。以下に解説され +ているいくつかの制約を条件として、特定の group でのいくつかの他の +receiver をテストするために、これらの 2 つのオプションのパラメータを指 +定することができます。 +.I receiver +はユニキャストアドレスであり、 +.I group +はマルチキャストアドレスであることより、これらの 2 つのパラメータは区 +別することができます。 +.B \-g +フラグが指定されると、source アドレスには mtrace が実行されているホス +トがデフォルトとして使われ、 receiver には +.B \-g +フラグで指定されるルータがデフォルトとして使われます。この場合、必須の +パラメータはありません。 +.PP +注釈: Solaris 2.4/2.5 ではマルチキャストインタフェースがデフォルトの +インタフェースでなければ、 -i オプションによってローカルアドレスをセット +しなければなりません。 +.SH オプション +.TP 8 8 +.BI \-e\ extrahops +応答がないルータを越えて、 +.I extrahops +だけのホップ数のトレースを試みます。 +.TP 8 8 +.BI \-g\ gwy +トレースの問い合わせを、マルチキャストではなく、ユニキャストによって直 +接マルチキャストルータ +.I gwy +へ送ります。 +このマルチキャストルータは意図する +.I source +から +.I receiver +へのパス上の最後のホップのルータでなければなりません。 +.RS 8 +.TP 12 12 +.I 注意!! +バージョン 3.3 と 3.5 の +.B mrouted +は、トレースの問い合わせがユニキャストパケットによって受信されかつ、 +.B mrouted +に +.I source +への経路がないと、クラッシュします。そのためターゲットの +.B mrouted +が 3.4 であるか、3.5 より新しいことが分かっていなければ、 +.B \-g +オプションを使わないでください。 +.RE +.TP 8 8 +.BI \-i\ addr +.I addr +をトレースの問い合わせを送る (マルチホームホスト上の) ローカルインタ +フェイスアドレス、および +.I receiver +と応答先のデフォルトアドレスとして使用します。 +.TP 8 8 +.B \-l +10 秒ごとにマルチキャストパスのパケットレートと消失の統計を表示して、 +無限ループします。 +( +.B \-S +.I stat_int +参照) +.TP 8 8 +.B \-M +試みの後半は、ユニキャストではなく、常にマルチキャストを使って応答を要 +求します。 +.TP 8 8 +.BI \-m\ n +.I receiver +から +.I source +へ遡ってトレースされる最大ホップ数を +.I n +にセットします。 +デフォルトは 32 ホップ (DVMRP ルーティングプロトコルについては無限) で +す。 +.TP 8 8 +.B \-n +ホップアドレスをシンボル名および数字ではなく数字で表示します。(パス上に発見された +各ルータに対するネームサーバでのアドレス-名前検索を省くことができます。) +.TP 8 8 +.BI \-q\ n +すべてのホップに対して試みる問い合わせの最大の回数を +.I n +にセットします。デフォルトは 3 です。 +.TP 8 8 +.B \-O +router-alert IP オプションを、これが必要な要求においても使用しません。 +Cisco の IOSのいくつかのバージョンでは IP オプションつきのマルチキャス +トトレースルートが扱えないため、最後のホップのルータが Cisco のもので +ある時は、-O フラグが必要となることがあります。 +.TP 8 8 +.B \-p +他から起動されたトレースによるマルチキャストの応答を受動的に聴取します。 +これはマルチキャストルータ上で動作している場合に最も良く動作します。 +.TP 8 8 +.B \-P +10 秒おきにパス情報を収集しながら無限ループし +( +.B \-S +.I stat_int +参照)、 +パス情報が変化するとそれを表示します。統計情報は表示しません。 +.TP 8 8 +.BI \-r\ host +トレースの応答を、 +.B mtrace +が実行されているホストや +この目的で登録されている他のマルチキャストアドレス (224.0.1.32) ではなく、 +.I host +へ送ります。 +.TP 8 8 +.B \-s +マルチキャストパスのみを含む短い形式の表示を行ない、パケットレートと +消失統計は表示しません。 +.TP 8 8 +.BI \-S\ n +統計情報を収集する間隔を +.I n +秒 (デフォルトは 10 秒) に変更します。 +.TP 8 8 +.BI \-t\ ttl +マルチキャストトレースの問い合わせと応答の +.I ttl +(time-to-live もしくはホップ数) をセットします。ttl に 1 を使用する "全 +てのルータ" へのローカルな問い合わせの場合を除き、デフォルトは 127 で +す。 +.TP 8 8 +.B \-T +"トンネル統計" モードです。全てのトラフィックでのロスレートを表示しま +す。これらの統計は非常に誤解を招くおそれのあるものです。 +.TP 8 8 +.B \-U +マルチキャストから試みるのではなく、常にユニキャストによる応答を要求し +ます。 +.TP 8 8 +.B \-v +冗長モードです。最初のトレースのホップ時間と統計情報を表示します。最初 +のトレースを転送するのに使用した経路も表示します。 +.TP 8 8 +.BI \-w\ n +トレースの応答の待ち時間を +.I n +秒 (デフォルトは 3 秒) にセットします。 +.SH 使用方法 +.SS どのように動作するか ? +.B traceroute +ツールでユニキャストのネットワーク経路をトレースするために使用している +技法は IP マルチキャストでは動作しません。それは、ICMP 応答が +マルチキャストトラフィックでは禁止されているためです。そのかわりに、 +トレースの機能はマルチキャストルータにおいて実装されています。 +この技法は送出するパケット数を最小にしながら、 +パケットレートやロスを計測できる点で優れています。 +.PP +マルチキャストでは逆経路転送が使われているため、トレースは +.I receiver +から +.I source +へ逆方向に実行されます。 +トレースの問い合わせパケットは最終ホップのマルチキャストルータ ( +.I receiver +アドレスでの末端ルータ) へ送られます。最終ホップのルータではトレースの +応答パケットを生成し、それにそのホップでのレポートを詰め込み、 +ユニキャストを使って、指定された +.I source +から送られてくるパケットにおける、そのルータの前段のホップであると思わ +れるルータへ、生成したパケットを転送します。 +経路上の各ルータはそのパケットにレポートを追加して転送します。 +トレースの応答パケットが最初のホップのルータ ( source のネットワークに +直結されているルータ) に到達すると、そのルータはトレースの問い合わせに +指定されている応答の送り先アドレスへ最終的な形の応答を送ります。 +.PP +経路上のいくつかのマルチキャストルータにマルチキャストのトレースルート +機能が実装されていなかったり、停止しているものがあると、応答は返されま +せん。この問題を解決するには、応答が返されるまでにトレースされるホップ +数を制限するための最大ホップ数フィールドを、トレースの問い合わせに +含ませます。これによって、部分的な経路のトレースが可能となります。 +.PP +各ルータによって挿入されるレポートには、ホップのアドレスだけでなく、転 +送のために必要な ttl とルーティングのエラーを示すいくつかのフラグ、そ +れに受信と送信インタフェース上および指定された +.I group +へ転送されたパケット数の合計が含まれます。時間をあけて 2 回トレースを +行なってこれらのパケット数の差分をとり、あるホップからの送信パケット +数とその次のホップでの受信パケット数を比較することにより、パケットレートと +パケット消失の統計が計算でき、ネットワークへの過負荷による問題を切 +り離すことができます。 +.SS 最終ホップルータを見つける +トレースの問い合わせは +.I source +から +.I receiver +へ到る経路上の最後のホップであるマルチキャストルータへ送られなければな +りません。もし、receiver がローカルサブネット上にあれば (これはサブネットマスク +によって決定されます)、デフォルトの方法ではトレースの問い合わせ +を ttl を 1 にして all-routers.mcast.net (224.0.0.2) へマルチキャスト +します。receiver がサブネット上になければ、 +.I group +へトレースの問い合わせをマルチキャストします。それは receiver がその +グループのメンバであれば、最後のホップルータもグループのメンバであるため +です。そのため、意図している receiver が属しているグループを指定する必 +要があります。このマルチキャストは ttl をデフォルトの 127 にして送られ +ます。この ttl は全ての場合では十分でないかもしれません。( +.B \-t +オプションで変更可能です。) もし最後のホップルータが分かっていれば、 +.B \-g +オプションを使用して直接指定することもできます。また、最後のホップのルータが +別のグループのメンバであるということが分かっており、receiver が属 +していないグループのトレースを行ないたい場合、 +.B \-g +オプションを使用してトレースの問い合わせに別のマルチキャストアドレスを +指定することもできます。 +.PP +マルチホームであるホストやルータからのトレースを行なう場合は、デフォルトの +receiver のアドレスは source からの経路での意図したインタフェース +でないかも知れません。インタフェースを指定したい場合は、 +.I receiver +によって明示的に指定しなければなりません。 +.SS 応答の誘導 +.B \-m +オプションによってトレースするホップ数が明示的に指定されている場合を除 +き、 +.B mtrace +はデフォルトではまず逆経路全てに渡ったトレースを試みます。もしタイムアウト +時間である 3 秒 (これは +.B \-w +オプションで変更できます) 以内に応答がなければ、"*" が表示され、プローブ方式を +hop-by-hop モードに切り替えます。 +トレースの問い合わせは最大ホップ数を 1 から開始し、応答を受信しなくなる +か全ての経路を網羅するまでホップ数を 1 づつ増やして行きます。 +各ホップでは、複数のプローブ (デフォルトでは 3、 +.B \-q +オプションで変更可) +が送られます。トレースの試みの前半 (デフォルトでは 2 回) では、応答 +アドレスを標準のマルチキャストアドレス mtrace.mcast.net (224.0.1.32) に +セットし、ttl を receiver までの経路上で今までにあった最大のスレッショルド +である 32 にセットして行なわれます。引き続く各々の試みについては +ttl は最大 192 まで 32 づつ増やされます。 +目的のルータはマルチキャスト応答を送ることができないかもしれないので、 +残りの試みでは +.B mtrace +が動作しているホストへユニキャストを使って応答することを要求します。 +また、マルチキャストの ttl は +.B \-t +オプションを使って明示的に指定することができ、最初のマルチキャストの試 +みは +.B \-U +オプションを使ってユニキャストに強制的に変更することができ、最後の +マルチキャストの試みは +.B \-M +オプションを使って強制的にマルチキャストにすることができ、また +.B \-UM +を指定することにより、 +.B mtrace +は最初はユニキャストで試み、次にマルチキャストを試みます。各々の試みで +はタイムアウトとなるまで応答が受信できなければ "*" が表示されます。指 +定された回数の試みが失敗すると、 +.B mtrace +は次のホップのルータへ ( +.B mrinfo +プログラムで使われているように) DVMRP_ASK_NEIGHBORS2 要求で問い合わせ +を試み、そのルータの種類を調べます。 +.B mtrace +は応答がないルータを越えて 3 ホップ (これは +.B \-e +オプションで変更可能) へ、応答を返す能力がないとしてもその要求の転送は +できるであろうと想定して、問い合わせを試みます。 +.SH 使用例 +.B mtrace +の出力は 2つのセクションからなります。最初のセクションではホップが問い +合わされた順、すなわち +.I source +から +.I receiver +への逆順で簡潔にリストされます。各々のホップについて、ホップ番号 (逆パス +であることを示すように負の数でカウントされる)、マルチキャスト +ルーティングプロトコル (DVMRP、MOSPF、PIM など)、データの転送 (上向きの矢印で +示されたリストでの前のホップへの転送) 要求のスレッショルド、問い合わせ +がそのホップへ届くまでの遅れの累積 (クロックが同期している時のみ有効) +が 1 行で表示されます。最初のセクションの最後には、問い合わせが発行さ +れてから応答を受信するまでの間隔をローカルのシステムクロックで計測した +ラウンドトリップ時間と、パケットがこの経路を通って行き来するのに必要な +ttl の合計が表示されます。以下に使い方とその出力の例を示します。 +.PP +.nf +.ft C +oak.isi.edu 80# mtrace -l caraway.lcs.mit.edu 224.2.0.3 +Mtrace from 18.26.0.170 to 128.9.160.100 via group 224.2.0.3 +Querying full reverse path... + 0 oak.isi.edu (128.9.160.100) + -1 cub.isi.edu (128.9.160.153) DVMRP thresh^ 1 3 ms + -2 la.dart.net (140.173.128.1) DVMRP thresh^ 1 14 ms + -3 dc.dart.net (140.173.64.1) DVMRP thresh^ 1 50 ms + -4 bbn.dart.net (140.173.32.1) DVMRP thresh^ 1 63 ms + -5 mit.dart.net (140.173.48.2) DVMRP thresh^ 1 71 ms + -6 caraway.lcs.mit.edu (18.26.0.170) +Round trip time 124 ms; total ttl of 6 required. +.fi +.PP +あるホップがパケットを転送するのにデフォルトの経路を使っていることを報 +告すれば、 +.B [default] +がそのホップの後に表示されます。 +.B \-v +フラグが指定されていれば、そのパケットを転送するのに使われた経路が +.B [18.26.0/24] +の形式で表示されます。 +.PP +2 番目のセクションでは転送のパスが図によって表示されます。データの流れ +は下向きの矢印で表され、問い合わせのパスは上向きの矢印で表されます。各 +ホップでは、ルータの入力アドレスと出力アドレスが違っていれば、それらの +アドレスが、そのホップパケットを転送するのに必要な ttl の初期値と、両 +端のルータのクロックが同期していると想定した場合のホップにまたがった伝 +搬遅れとともに表示されます。このセクションの右半分は 2 組の統計情報か +ら構成されます。最初のカラムには各ホップでの全てのトラフィックについて +の平均のパケットレートが表示されます。残りのカラムでは消失したパケット +の数、送信したパケットの数、消失したパーセンテージ、それに平均パケット +レートが各ホップについて表示されます。これらの統計情報は上で解説したよ +うにトレース間の差とホップ間の差から計算されます。最初のグループでは、 +あるホップでのインタフェースにおける全流出トラフィックと次のホップでの全流入 +トラフィックの統計情報が表示されます。2 番目のグループでは、指定された +.I source +から指定された +.I group +への転送トラフィックのみについての統計情報が表示されます。統計の最初の +グループは +.B \-T +オプションを使って消失レートを含ませることもできます。しかし、これらの +数字は大幅な誤差を含む可能性があり、これらを適切に解釈するためには +ルータについての詳細な知識が要求されるでしょう。 +.PP +これらの統計情報は各々のホップにつき 1 行か 2 行で表示されます。 +オプションが何も指定されていないと、この出力中の 2 番目のセクションは最初 +のトレースからおよそ 10 秒後に 1 度のみ表示されます。各ホップにつき 1 +行にその 10 秒間での統計情報を表示します。もし +.B \-l +オプションが指定されていると、2 番目のセクションは 10 秒ごとに繰り返さ +れ、各ホップにつき 2 行が表示されます。最初の行ではそれまでの 10 秒間 +における統計が表示され、2 番目の行で最初のトレースからの累積の統計情報 +が表示されます。下の例ではこれは 101 秒間での統計となっています。 +.B \-s +オプションが指定されるか、マルチキャストグループが指定されていると、こ +の出力での 2 番目のセクションは省略されます。 +.ie t \{\ +.ft C +. ie \w'i'<>\w'm' \{\" looks like this is not proper Courier font +(If this example is not properly columned with a fixed-width font, get +.B groff +and try again.) +. \} +.\} +.PP +.ft C +.nf +Waiting to accumulate statistics... Results after 101 seconds: + + Source Response Dest Overall Packet Statistics For Traffic From +18.26.0.170 128.9.160.100 Packet 18.26.0.170 To 224.2.0.3 + | __/ rtt 125 ms Rate Lost/Sent = Pct Rate + v / hop 65 ms ------- --------------------- +18.26.0.144 +140.173.48.2 mit.dart.net + | ^ ttl 1 0 pps 0/2 = --% 0 pps + v | hop 8 ms 0 pps 0/18 = 0% 0 pps +140.173.48.1 +140.173.32.1 bbn.dart.net + | ^ ttl 2 0 pps 0/2 = --% 0 pps + v | hop 12 ms 0 pps 0/18 = 0% 0 pps +140.173.32.2 +140.173.64.1 dc.dart.net + | ^ ttl 3 27 pps 0/2 = --% 0 pps + v | hop 34 ms 26 pps 0/18 = 0% 0 pps +140.173.64.2 +140.173.128.1 la.dart.net + | ^ ttl 4 83 pps 0/2 = --% 0 pps + v | hop 11 ms 79 pps 0/18 = 0% 0 pps +140.173.128.2 +128.9.160.153 cub.isi.edu + | \\__ ttl 5 83 pps ?/2 0 pps + v \\ hop -8 ms 79 pps ?/18 0 pps +128.9.160.100 128.9.160.100 + Receiver Query Source +.fi +.PP +パケットのカウント数はトレースの問い合わせが伝搬するとともに変化するた +め、統計情報中には小さな誤差 (1 か 2 のずれ) が含まれることがあります。 +しかし、これらの誤差は累積されるべきではないため、累積統計行ではあらた +なトレースが 10 秒ごとに実行されるたびに精度が増さなければなりません。 +大きな誤差の要因としては 2 つあり、このいずれもマイナスのロスとして現 +われます。 +.LP +.RS +.PD 0 +.TP 3 +\(bu +あるノードへの入力カウントが他のノードがアタッチされているマルチアクセス +ネットワークからのものであれば、入力カウントはアタッチされている全てのノード +からの出力カウントの総和となります (もしくは近くなります) が、トレースし +ているパス上のその前のホップからの出力カウントはその単なる一部分となり +ます。そのため、出力カウントから入力カウントを引いたものはマイナスの値 +になります。 +.TP 3 +\(bu +SunOS およびその他のシステムにおける DVMRP マルチキャスト転送ソフトウェアの +リリース 3.3 では、ルータにおいて生成されたマルチキャストパケット +はインタフェースに入力されていない場合においても、入力されたものとし +てカウントされます。これは上の例において見ることのできるマイナスのロス +となります。 +.PD +.RE +.LP +これらのマイナスのロスはプラスのロスを隠してしまうことが +あることに注意してください。 +.PP +この例ではまた、1 つマイナスのホップの時間が表示されています。これは +単にそのホップ間でのシステムクロックが同期していないことを示しています。 +この例ではまた、送られたパケットの数が 10 より少ない時には、パーセンテー +ジの値は統計的に有効ではないため、ロスのパーセンテージが 2 つのダッシュ +として表示されることも示しています。 +.PP +2 番目の例では ローカルでない receiver へのトレースを示します。問い合 +わせは +.B \-g +オプションによって最終ホップのルータに送られます。この例では、全逆パス +のトレースが、マルチキャストトレースルート機能が実装されていない古いバー +ジョンの +.B mrouted +が動作しているノードがあるために応答なしの結果となっており、そのため +.B mtrace +は hop-by-hop モードに切り替わっています。\*(lqOutput pruned\*(rq の +エラーコードはグループ 224.2.143.24 へのトラフィックが転送されていないこ +とを示しています。 +.PP +.nf +.ft C +oak.isi.edu 108# mtrace -g 140.173.48.2 204.62.246.73 \\ + butter.lcs.mit.edu 224.2.143.24 +Mtrace from 204.62.246.73 to 18.26.0.151 via group 224.2.143.24 +Querying full reverse path... * switching to hop-by-hop: + 0 butter.lcs.mit.edu (18.26.0.151) + -1 jam.lcs.mit.edu (18.26.0.144) DVMRP thresh^ 1 33 ms Output pruned + -2 bbn.dart.net (140.173.48.1) DVMRP thresh^ 1 36 ms + -3 dc.dart.net (140.173.32.2) DVMRP thresh^ 1 44 ms + -4 darpa.dart.net (140.173.240.2) DVMRP thresh^ 16 47 ms + -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 関連項目 +.BR mrouted (8) , +.BR mrinfo (8) , +.BR map-mbone (8) , +.BR traceroute (8) +.SH バグ +.PP +パッシブモードでの統計収集は、活発にデータを収集しているときと常に同じ +出力とはなりません。 diff --git a/ja_JP.eucJP/man/man8/mtree.8 b/ja_JP.eucJP/man/man8/mtree.8 new file mode 100644 index 0000000000..61a9765e55 --- /dev/null +++ b/ja_JP.eucJP/man/man8/mtree.8 @@ -0,0 +1,290 @@ +.\" Copyright (c) 1989, 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. +.\" +.\" 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. +.\" +.\" From: @(#)mtree.8 8.2 (Berkeley) 12/11/93 +.\" %Id: mtree.8,v 1.7.2.2 1997/10/02 11:40:13 charnier Exp % +.\" jpman %Id: mtree.8,v 1.3 1997/08/16 13:31:00 horikawa Stab % +.\" +.Dd February 9, 1995 +.Dt MTREE 8 +.Os +.Sh 名称 +.Nm mtree +.Nd ディレクトリ階層をマップする +.Sh 書式 +.Nm mtree +.Op Fl cdeinrUux +.Op Fl f Ar spec +.Op Fl K Ar keywords +.Op Fl k Ar keywords +.Op Fl p Ar path +.Op Fl s Ar seed +.Sh 解説 +.Nm +は、カレントディレクトリをルートとするファイル階層を、 +標準入力から読み込んだファイル階層記述と比較します。 +.\" ↑原文では単に "specification" となっているが、日本語に訳すと +.\" わかりにくいので、「ファイル階層記述」という語をあてている。 +.\" 以下も同様。 -- jpman J.Sakai +その記述とマッチしない特性をもつファイルや、 +実際のファイル階層あるいはファイル階層記述のいずれかから欠落しているファイル +に関するメッセージを標準出力に出力します。 +.Pp +以下のオプションがあります: +.Bl -tag -width flag +.It Fl c +ファイル階層の記述を標準出力に出力します。 +.It Fl d +ディレクトリ型以外のファイルは全て無視します。 +.It Fl e +ファイル階層には存在するが、ファイル階層記述に存在しないファイルが +あっても警告しません。 +.It Fl f Ar file +ファイル階層記述を、標準入力からではなく、ファイル +.Ar file +から読み込みます。 +.It Fl i +.Fl c +オプションでファイル階層記述を作成する際、 +ディレクトリレベルを一つ下りる毎に空白 4 つ分ずつインデントして出力します。 +各ディレクトリ前に出力される /set 文やコメントには影響を与えませんが、 +各ディレクトリの最後に出力されるコメントには影響を及ぼします。 +.It Fl K Ar keywords +指定した +.Ar keywords +(空白あるいはコンマで区切ったもの) を +現在のキーワード集合に追加します。 +.It Fl k Ar keywords +現在のキーワード集合の代わりに、 +``type'' キーワードおよび +指定した +.Ar keywords +(空白あるいはコンマで区切ったもの) を使用します。 +.It Fl n +ファイル階層記述作成の際、パス名コメントを出力しません。 +.Fl c +オプション使用時は通常、各ディレクトリの前後にコメントが出力されます。 +.It Fl p Ar path +ファイル階層のルートディレクトリを、カレントディレクトリではなく +.Ar path +とします。 +.It Fl r +ファイル階層記述に記載されていないファイル階層に含まれるファイルを +全て削除します。 +.It Fl s Ar seed +キーワード +.Cm cksum +が指定されている全ファイルに対する単一のチェックサムを +標準エラー出力に出力します。 +チェックサムのシードには指定された値が用いられます。 +.It Fl U +既存ファイルの所有者、グループおよびパーミッションを +ファイル階層記述に合わせて修正し、欠落しているディレクトリを作成します。 +欠落ディレクトリを作成するために、ユーザ、グループおよびパーミッションの +全てを指定しなければなりません。 +成功するとステータス 0 で終了し、 +何らかのエラーが発生すると 1 で終了します。 +ミスマッチがあっても、それが訂正されればエラーとはみなされません。 +.It Fl u +オプション +.Fl U +と同様ですが、現ファイル階層がファイル階層記述とマッチしなければ +ステータス 2 を返します。 +.It Fl x +ファイル階層中のマウントポイント以下に降下しません。 +.El +.Pp +ファイル階層記述は多くの場合、「キーワード」つまり +ファイルに関連した値を指定する文字列から構成されます。 +どのキーワードにもデフォルト値はありません。 +キーワードに値が設定されていない場合、 +そのキーワードに基づいたチェックは行われません。 +.Pp +現在サポートされているキーワードは以下の通りです: +.Bl -tag -width Cm +.It Cm cksum +.Xr cksum 1 +ユーティリティで規定されるデフォルトアルゴリズムを用いた +ファイルのチェックサム。 +.It Cm ignore +このファイル以下のファイル階層を無視します。 +.It Cm gid +数値で指定したファイルのグループ。 +.It Cm gname +シンボル名で指定したファイルのグループ。 +.It Cm md5digest +ファイルの MD5 メッセージダイジェスト。 +.It Cm mode +数値 (8進数) あるいはシンボル値で指定した現ファイルのパーミッション。 +.It Cm nlink +ファイルが持っているはずのハードリンク数。 +.It Cm uid +数値で指定したファイルの所有者。 +.It Cm uname +シンボル名で指定したファイルの所有者。 +.It Cm size +ファイルサイズ (バイト数)。 +.It Cm link +シンボリックリンクが指し示しているはずのファイル。 +.It Cm time +ファイルの最終修正時刻。 +.It Cm type +ファイルタイプ。以下のいずれかを指定します: +.sp +.Bl -tag -width Cm -compact +.It Cm block +ブロック型スペシャルデバイス +.It Cm char +文字型スペシャルデバイス +.It Cm dir +ディレクトリ +.It Cm fifo +FIFO +.It Cm file +通常ファイル +.It Cm link +シンボリックリンク +.It Cm socket +ソケット +.El +.El +.Pp +デフォルトのキーワード集合は +.Cm gid , +.Cm mode , +.Cm nlink , +.Cm size , +.Cm link , +.Cm time , +.Cm uid +です。 +.Pp +ファイル階層記述には 4 つのタイプの行があります。 +.Pp +1 つめのタイプの行はキーワードに大域的な値を設定するもので、 +文字列 ``/set'' とそれに続く空白、そしてキーワードとその値のペアの集合を +空白で区切ったものから構成されます。 +キーワードとその値のペアはキーワードとそれに続く等号 (``='')、 +そして値から成り、空白は含みません。 +一旦キーワードが設定されると、再設定あるいは設定解除されるまで +その値は変化しません。 +.Pp +2 つめのタイプの行はキーワードの設定を解除するもので、 +文字列 ``/unset'' とそれに続く空白、そして 1 つ以上のキーワードを +空白で区切ったものから構成されます。 +.Pp +3 つめのタイプの行はファイル記述を行うもので、 +ファイル名とそれに続く空白、そしてゼロ個以上のキーワードと値のペアを +空白で区切ったものから構成されます。 +ファイル名の先頭には空白があっても構いません。 +ファイル名には +標準的なファイル名マッチング文字 (``['', ``]'', ``?'', ``*'') が含まれて +いてもよく、その場合、そのファイル階層に存在するファイルは、 +マッチする最初のパターンと関連づけられます。 +.Pp +各キーワードと値のペアはキーワードと等号 (``='')、そして +そのキーワードの値から構成され、空白は含みません。 +これらの値は、対応するキーワードの大域的な値を変更しませんが、 +大域的な値に優先します。 +.Pp +パスは全て相対指定です。 +ディレクトリを指定すると、そのディレクトリ階層の中で +更にファイルが検索されます。 +これがファイル階層記述における 4 つめのタイプの行です: +文字列 +.Dq Nm \&.. +だけが含まれる行は、カレントディレクトリパスを 1 レベル上に上げることを +意味します。 +.Pp +空行および最初の非空白文字がハッシュ記号 (``#'') であるような行は無視されます。 +.Pp +.Nm +は成功するとステータス 0 で終了し、何らかのエラーが生じると 1 で終了します。 +また、ファイル階層がファイル階層記述とマッチしない場合はステータス 2 で +終了します。 +ただしオプション +.Fl U +が指定されている場合は、ステータス 2 はステータス 0 に変換されます。 +.Sh 使用例 +「トロイの木馬」に感染したシステムバイナリを検出するには、 +以下のように操作することを推奨します。 +ファイルシステムに対して +.Nm +.Fl K +.Cm md5digest +を実行し、その結果のコピーを別マシンか、少なくとも暗号化した形式で +ストアします。 +出力ファイル自身は +.Xr md5 1 +ユーティリティを用いてダイジェストを作成します。 +そして定期的に +.Nm +と +.Xr md5 1 +をオンラインのファイル階層記述に対して走らせます。 +クラッカーが手を加えたバイナリに合わせて +オンラインのファイル階層記述を変更することは +可能ですが、オリジナルと同じ MD5 ダイジェストをもつ記述を作成するのは +非現実的だと考えらていれます。 +.Pp +.Fl d +オプションおよび +.Fl u +オプションを組み合わせると、ソフトウェア配布やそれに類する処理のために +ディレクトリ階層を作成するのに用いることができます。 +.Pa /etc/mtree +に置かれたファイル群は、この +.Tn FreeBSD +配布のほとんど全てのディレクトリを作成するのに用いられました。 +.Sh 関連ファイル +.Bl -tag -width /etc/mtree -compact +.It Pa /etc/mtree +システムのファイル階層記述ディレクトリ +.El +.Sh 関連項目 +.Xr chgrp 1 , +.Xr chmod 1 , +.Xr cksum 1 , +.Xr md5 1 , +.Xr stat 2 , +.Xr fts 3 , +.Xr md5 3 , +.Xr chown 8 +.Sh 歴史 +.Nm +ユーティリティは +.Bx 4.3 Reno +で登場しました。 +MD5 ダイジェスト機能は、 +.Xr cksum 1 +をだますプログラムが広範囲に悪用されたのに対抗して +.Fx 2.1 +で追加されました。 diff --git a/ja_JP.eucJP/man/man8/named-xfer.8 b/ja_JP.eucJP/man/man8/named-xfer.8 new file mode 100644 index 0000000000..26c08a17e2 --- /dev/null +++ b/ja_JP.eucJP/man/man8/named-xfer.8 @@ -0,0 +1,155 @@ +.\" ++Copyright++ 1985 +.\" - +.\" Copyright (c) 1985 +.\" 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. +.\" +.\" 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. +.\" - +.\" Portions Copyright (c) 1993 by Digital Equipment Corporation. +.\" +.\" Permission to use, copy, modify, and distribute this software for any +.\" purpose with or without fee is hereby granted, provided that the above +.\" copyright notice and this permission notice appear in all copies, and that +.\" the name of Digital Equipment Corporation not be used in advertising or +.\" publicity pertaining to distribution of the document or software without +.\" specific, written prior permission. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS" AND DIGITAL EQUIPMENT CORP. DISCLAIMS ALL +.\" WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL DIGITAL EQUIPMENT +.\" CORPORATION BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL +.\" DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR +.\" PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS +.\" ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS +.\" SOFTWARE. +.\" - +.\" --Copyright-- +.\" +.\" 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 +は、 +.IR named (8) +によって実行される補助プログラムです。 +インターネットネームサーバから呼び出されて、ゾーン情報を受け取ります。 +直接実行されることはまれであり、ゾーン転送の問題を解決するために +システム管理者にいよってのみ実行されることがある程度です。 +インターネットネームドメインシステムについての詳細は、 +RFC 1033 、1034 、1035 を参照してください。 +.PP +オプションとしては、以下のものがあります: +.TP +.B \-z +転送されるゾーン名を指定します。 +.TP +.B \-f +プライマリサーバーからゾーンが転送された際に、ゾーンの情報をダンプ (格納) する +ファイル名を指定します。 +.TP +.B \-s +転送されるゾーンの情報のシリアル番号を指定します。プライマリサーバーから +得た \s-1SOA RR\s+1 が、このシリアル番号よりも高いシリアル番号を持たない +場合は、転送は中止されます。 +.TP +.B \-d +デバッグ情報を出力します。``d'' のあとの数字は出力されるメッセージのレベルを +決定します。 +.TP +.B \-l +デバッグメッセージのログファイルを指定します。デフォルトでは +システムに依存しますが、通常は +.I /var/tmp +または +.IR /usr/tmp +です。このオプションは +.I \-d +と同時に指定されたときのみ適用されますので注意してください。 +.TP +.B \-t +ゾーン情報転送のプロトコルトレースを格納するトレースファイルを指定します。 +このオプションはネームサーバーそのものをデバッグする人にとってのみ +有益なのかもしれません。 +.TP +.B \-p +デフォルト以外のポート番号を使用するときに指定します。 +デフォルトの標準ポートナンバーは +``domain'' サービスの getservbyname(3) の返す値になります。 +.TP +.B \-S +SOA レコードと NS レコードの転送のみを許可し、 +ゾーンに対して A レコードを結合します。 +SOA レコードは named によって読み込まれませんが、 +NS レコードをいつ検証するのかを決定するのに使用されます。 +詳しくは +.IR named (8) +の ``stubs''を参照してください。 +.TP +.PP +付加的な引数としてネームサーバーのアドレスを、いわゆる ``dotted-quad'' +構文でのみ、とります。ネームサーバのアドレスの省略は許されません。 +少なくとも一つのアドレスを指定しなくてはなりません。 +ネームサーバーのアドレスが複数指定されると、最初のサーバーが転送を失敗すると、 +順番にサーバーを切替えて転送を試みます。 + +.SH 関連項目 +named(8), resolver(3), resolver(5), hostname(7), +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 diff --git a/ja_JP.eucJP/man/man8/named.8 b/ja_JP.eucJP/man/man8/named.8 new file mode 100644 index 0000000000..807e53297f --- /dev/null +++ b/ja_JP.eucJP/man/man8/named.8 @@ -0,0 +1,492 @@ +.\" ++Copyright++ 1985 +.\" - +.\" Copyright (c) 1985 +.\" 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. +.\" +.\" 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. +.\" - +.\" Portions Copyright (c) 1993 by Digital Equipment Corporation. +.\" +.\" Permission to use, copy, modify, and distribute this software for any +.\" purpose with or without fee is hereby granted, provided that the above +.\" copyright notice and this permission notice appear in all copies, and that +.\" the name of Digital Equipment Corporation not be used in advertising or +.\" publicity pertaining to distribution of the document or software without +.\" specific, written prior permission. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS" AND DIGITAL EQUIPMENT CORP. DISCLAIMS ALL +.\" WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL DIGITAL EQUIPMENT +.\" CORPORATION BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL +.\" DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR +.\" PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS +.\" ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS +.\" SOFTWARE. +.\" - +.\" --Copyright-- +.\" +.\" @(#)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 +はインターネットドメインネームサーバです。 +インターネットドメインネームシステムの詳細な情報については +RFC 1033, 1034, 1035 を参照してください。 +パラメータがない場合は +.I named +はデフォルトのブートファイルである +.IR /etc/named.boot +の初期化データを読み込み、問い合わせに対し待機します。 +.PP +指定できるオプションは以下の通りです。 +.TP +.B \-d +デバッグ情報を出力します。 +``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 +再帰的なネームサーバの問い合わせを抑止します。 +問い合わせに対してはローカルゾーン(プライマリもしくはセカンダリ)からのみ +回答されます。 +この指定はルートサーバにて使用することができます。 +\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'' におけるデータがバックアップキャッシュに +置かれることを指定します。 +これはおもにルートドメインサーバの位置のようなデータを指定するために +使われます。 +このキャッシュは通常は使われませんが、現在のルートサーバをみつけるための +ヒント ``hint'' として使われます。 +``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 が missiong 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 +マスターファイルは制御情報とゾーン中のオブジェクトの +資源レコードのリストからなり、次の形式を取ります。 +.RS +.nf + +$INCLUDE <filename> <opt_domain> +$ORIGIN <domain> +<domain> <opt_ttl> <opt_class> <type> <resource_record_data> + +.fi +.RE +ここで、 +.I domain +にはルートの場合は "." を、現在の起点の場合は "@"、 +それら以外では通常のドメイン名を指定します。 +.I domain +が ``.'' で終っていない通常のドメイン名である場合は、 +現在の起点がドメインに追加されます。 +``.'' で終るドメイン名は変更されません。 +.I opt_domain +フィールドにはインクルードファイル中のデータの起点を定義します。 +これはインクルードファイルの最初の行の前に +$ORIGIN 宣言を置くことと等価です。 +このフィールドはオプショナルです。 +.I opt_domain +や、インクルードファイル中の $ORIGIN 宣言は +そのファイル自身の現在の起点を変更することはありません。 +.I opt_ttl +フィールドはオプションであり、 +time-to-live フィールドを指定する整数値となります。 +このデフォルト値はゼロであり、 +そのゾーンの SOA レコードに指定された最小値を意味します。 +.I opt_class +フィールドはオブジェクトのアドレスの型を指定します。 +現在はDARPAインターネットに接続するオブジェクトである +.BR IN +のみがサポートされています。 +.I type +フィールドには以下のトークンのうちひとつが含まれます。 +括弧中におのおの +.I resource_record_data +フィールドに指定すべきデータを示しています。 +.TP "\w'MINFO 'u" +A +ホストアドレス (4つ組ドット) +.IP NS +信頼できるネームサーバ (ドメイン) +.IP MX +メールエクスチェンジャー (ドメイン) +優先順位 (0..32767) に引続き指定します。 +優先順位は小さい値が優先順位の高いことを示します。 +.IP CNAME +別名に対応した正式名 (ドメイン) +.IP SOA +オーソリティゾーンデータの開始を示します。 +(ホストの属するドメイン、メインテーナーのドメインアドレス、 +シリアル番号、その後にリフレッシュ、リトライ、有効期限、最小 TTL (RFC 883を参照) +の各値を秒で指定したパラメータが続く)。 +.IP NULL +ヌルリソースレコード (形式、データなし) +.IP RP +いくつかのドメイン名の責任者 (メールアドレスか参照できるテキスト) +.IP PTR +ドメイン名のポインタ (ドメイン) +.IP HINFO +ホスト情報 (CPUタイプ、OSタイプ) +.PP +通常は行末でリソースレコードは終了しますが、 +左括弧と右括弧で囲まれた場合は複数行にまたがることが可能となります。 +セミコロンから行末まではコメントとして扱われます。 +.PP +ここには示されていませんが、このほかのタイプのリソースレコードも存在します。 +リソースレコードのすべてのタイプを知るには +\s-1BIND\s+1 Operations Guide (``\s-1BOG\s+1'') を参照する必要があるでしょう。 +新しい RFC にていくつかのリソースタイプが標準化されていますが、 +このバージョンの \s-1BIND\s+1 ではまだ実装されていません。 +.PP +各マスターゾーンファイルはそのゾーンの 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 ではシリアル番号を指定します。 +シリアル番号はマスターファイルを更新するたびに変更する必要があります。 +シリアル番号 (serial) は少数点つきの数字を指定することもできますが、 +整数への変換は乗算や加算ではなく文字列としてつなげて行っているため、 +あまり賢い方法とはいえません。 +年月日と 0〜99 のシリアル番号を使用することで、 +このフィールドのサイズである符号なしの 32 ビット以内に収まります。 +このやり方はグレゴリー暦の 4294年には考え直す必要があることは確かですが、 +それについては心配する必要はないでしょう。 +セカンダリサーバは秒で指定されたリフレッシュ時間 (refresh) の間隔で +シリアル番号をチェックします。 +シリアル番号に変更があれば、新しいデータを読み込むために +ゾーン情報が転送されます。 +リフレッシュ時間が過ぎてもマスターサーバに接続できない場合は、 +リトライ時間 (retry) の間隔でリフレッシュが試みられます。 +期限切れ時間 (expire) が過ぎてマスターサーバに接続できない場合は、 +セカンダリサーバはそのゾーンの全てのデータを破棄します。 +最小値 (minimum) はファイル中の生存時間 (``\s-1TTL\s+1'') が +明示的に指定されていないレコードの生存時間となります。 +.SH 注釈 +ブートファイルでの ``domain'' と ``suffixes'' の指定は廃止され、 +もっと便利なリゾルバベースの部分的修飾ドメイン名 +(partially qualified domain names) の接尾辞の実装に取って代わりました。 +以前のメカニズムではかなりの状況下で、 +特にローカルネームサーバが完全な情報を持っていない場合に +うまく動作しないことがありました。 +.sp +以下に各シグナルを +.IR kill (1) +コマンドによってサーバに送った場合の効果を示します。 +.IP SIGHUP +サーバは named.boot を読み、データベースをロードし直します。 +サーバがコンパイルオプションの FOCED_RELOAD を定義されて +コンパイルされている場合は、 +SIGHUPを送るとサーバは全てのセカンダリゾーンのシリアル番号もチェックします。 +通常、シリアル番号は SOA 中に指定された間隔でのみチェックされます。 +.IP SIGINT +現在のデータベースとキャッシュの内容を /var/tmp/named_dump.db にダンプします。 +.IP SIGIOT +サーバが -DSTATS 付きでコンパイルされていれば、 +統計データを /var/tmp/named.stats にダンプします。 +統計データはこのファイルの末尾に追加されます。 +いくつかのシステムでは SIGIOT ではなく SIGABRT で統計データのダンプを行います。 +.IP SIGSYS +サーバがプロファイリング (サーバの fork, chdir と exit) を +有効にされてコンパイルされていれば、 +プロファイリングデータを /var/tmp にダンプします。 +.IP SIGTERM +プライマリおよびセカンダリのデータベースファイルをダンプします。 +サーバが動的更新を有効にしてコンパイルされていれば、 +シャットダウン時に更新されたデータをセーブするために使用されます。 +.IP SIGUSR1 +デバッグ機能を有効にします。 +SIGUSR1が送られるたびにデバッグレベルが上がります。 +(SIGUSR1がない古いシステムではSIGEMTが使われます。) +.IP SIGUSR2 +デバッグ機能を完全に無効にします。 +(SIGUSR2がない古いシステムではSIGFPEが使われます。) +.IP SIGWINCH +全てのサーバに入力される問い合わせの syslog(8) による +ログ採取の有無を切り替えます。 +(ログ採取はサーバが 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), +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 diff --git a/ja_JP.eucJP/man/man8/named.reload.8 b/ja_JP.eucJP/man/man8/named.reload.8 new file mode 100644 index 0000000000..5de785bba7 --- /dev/null +++ b/ja_JP.eucJP/man/man8/named.reload.8 @@ -0,0 +1,71 @@ +.\" ++Copyright++ 1987, 1993 +.\" - +.\" Copyright (c) 1987, 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. +.\" +.\" 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. +.\" - +.\" Portions Copyright (c) 1993 by Digital Equipment Corporation. +.\" +.\" Permission to use, copy, modify, and distribute this software for any +.\" purpose with or without fee is hereby granted, provided that the above +.\" copyright notice and this permission notice appear in all copies, and that +.\" the name of Digital Equipment Corporation not be used in advertising or +.\" publicity pertaining to distribution of the document or software without +.\" specific, written prior permission. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS" AND DIGITAL EQUIPMENT CORP. DISCLAIMS ALL +.\" WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL DIGITAL EQUIPMENT +.\" CORPORATION BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL +.\" DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR +.\" PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS +.\" ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS +.\" SOFTWARE. +.\" - +.\" --Copyright-- +.\" +.\" from hostname.7 6.4 (Berkeley) 1/16/90 +.\" jpman %Id: named.reload.8,v 1.2 1997/05/17 16:55:28 horikawa Stab % +.\" +.TH NAMED.RELOAD 8 "June 26, 1993" +.UC 5 +.SH 名称 +named.reload \- ネームサーバのデータベースを同期させる +.SH 解説 +このコマンドは実行中のネームサーバに \s-1SIGHUP\s+1 を送ります。 +このシグナルは +.IR named (8) +に解説されています。 +.SH バグ +ネームサーバが実際に動作しているか確認をしないため、古い PID キャッシュ +ファイルが残っていると無関係なプロセスを停止させてしまうことがあり得ます。 +.SH 関連項目 +named(8), named.restart(8) +.\" translated to japanese by Mochida Shuji 1995/03/31 diff --git a/ja_JP.eucJP/man/man8/named.restart.8 b/ja_JP.eucJP/man/man8/named.restart.8 new file mode 100644 index 0000000000..67bcfd0265 --- /dev/null +++ b/ja_JP.eucJP/man/man8/named.restart.8 @@ -0,0 +1,74 @@ +.\" ++Copyright++ 1987, 1993 +.\" - +.\" Copyright (c) 1987, 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. +.\" +.\" 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. +.\" - +.\" Portions Copyright (c) 1993 by Digital Equipment Corporation. +.\" +.\" Permission to use, copy, modify, and distribute this software for any +.\" purpose with or without fee is hereby granted, provided that the above +.\" copyright notice and this permission notice appear in all copies, and that +.\" the name of Digital Equipment Corporation not be used in advertising or +.\" publicity pertaining to distribution of the document or software without +.\" specific, written prior permission. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS" AND DIGITAL EQUIPMENT CORP. DISCLAIMS ALL +.\" WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL DIGITAL EQUIPMENT +.\" CORPORATION BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL +.\" DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR +.\" PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS +.\" ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS +.\" SOFTWARE. +.\" - +.\" --Copyright-- +.\" +.\" from hostname.7 6.4 (Berkeley) 1/16/90 +.\" jpman %Id: named.restart.8,v 1.2 1997/05/17 16:56:47 horikawa Stab % +.\" +.TH NAMED.RESTART 8 "June 26, 1993" +.UC 5 +.SH 名称 +named.restart \- ネームサーバを停止し、再起動する +.SH 解説 +このコマンドは実行中のネームサーバに \s-1SIGKILL\s+1 を送り、 +.IR /etc/sysconfig +にネームサーバが実行されるよう記述されていれば、新たに起動します。 +ネームサーバが実際に動作しているか確認をしないため、古い PID キャッシュ +ファイルが残っていると無関係なプロセスを停止させてしまうことがあり得ます。 +.PP +古いサーバにシグナルを送った後、プロセスの完了を待たずに新しいサーバを起動 +します。完了に時間がかかり、古いサーバが残ったまま新しいサーバが起動して +致命的エラーとなると、ネームサーバの動作していない状態に放置されることに +なります。 +.SH 関連項目 +named(8), named.reload(8) +.\" translated to japanese by Mochida Shuji 1995/03/31 diff --git a/ja_JP.eucJP/man/man8/natd.8 b/ja_JP.eucJP/man/man8/natd.8 new file mode 100644 index 0000000000..ed10998370 --- /dev/null +++ b/ja_JP.eucJP/man/man8/natd.8 @@ -0,0 +1,403 @@ +.\" manual page [] for natd 1.4 +.Dd 15 April 1997 +.Os FreeBSD +.Dt NATD 8 +.Sh 名称 +.Nm natd +.Nd +ネットワークアドレス変換デーモン +.Sh 書式 +.Nm +.Op Fl ldsmvu +.Op Fl permanent_link +.Op Fl dynamic +.Op Fl i Ar inport +.Op Fl o Ar outport +.Op Fl p Ar port +.Op Fl a Ar address +.Op Fl i Ar interface +.Op Fl f Ar configfile + +.Nm +.Op Fl log +.Op Fl deny_incoming +.Op Fl use_sockets +.Op Fl same_ports +.Op Fl verbose +.Op Fl unregistered_only +.Op Fl permanent_link +.Op Fl dynamic +.Op Fl inport Ar inport +.Op Fl outport Ar outport +.Op Fl port Ar port +.Op Fl alias_address Ar address +.Op Fl interface Ar interface +.Op Fl config Ar configfile +.Op Fl redirect_port Ar linkspec +.Op Fl redirect_address Ar localIP publicIP + +.Sh 解説 +このプログラムは、FreeBSD における +.Xr divert 4 +ソケットと共に用いることによって、ネットワークアドレスの変換を +行います。 +コマンドラインオプションのほとんどは、1 文字の短縮形か、長い表記が +利用できます。 +見る人がはっきりと理解しやすいように、長い表記を使うことが +推奨されています。 + +.Pp +.Nm natd +は通常、デーモンとしてバックグラウンドで実行します。 +.Nm +はマシンに入ってくるパケット、またはマシンから出て行くパケットを +生(raw)のまま扱い、場合により IP パケットストリームに +再び送り出す前に手を加えます。 + +.Pp +.Nm natd +は他のホストへ向かうすべてのパケットについて、発信元 IP アドレスを +現在のマシンのものにする、という変換を行います。 +このように変換された各パケットについて、変換内容を記録するために +内部テーブルエントリが作成されます。 +発信元ポート番号も、パケットに適用したテーブルエントリを示すように +変更されます。 +現在のホストの、対象となる IP アドレスを使ったパケットが受信されると、 +この内部テーブルがチェックされます。 +エントリが見つかると、パケットに正しい対象 IP アドレスとポート番号を +入れるのに利用されます。 + +.Pp +以下のコマンドラインオプションが利用できます。 +.Bl -tag -width Fl + +.It Fl log | l +様々な alias の統計や情報をファイル +.Pa /var/log/alias.log +に記録します。このファイルは natd が起動されるたびに切りつめられます。 + +.It Fl deny_incoming | d +現在の IP アドレスへ向かうパケットのうち、内部変換テーブルに +エントリの無いものを拒否します。 + +.It Fl use_sockets | s +FTP data コネクションや IRC DCC send コネクションを確立するのに +.Xr socket 2 +を割り当てます。このオプションはよりシステムリソースを消費しますが、 +ポート番号が衝突する場合でもコネクションが成功することを保証します。 + +.It Fl same_ports | m +出て行くパケットを変換する時に、できるだけポート番号を同じまま +保つようにします。このオプションにより、RPC のようなプロトコルが +うまく働く可能性があがります。ポート番号を維持することができない時には、 +暗黙のうちに通常と同じ方法で変換されます。 + +.It Fl verbose | v +起動時に +.Xr fork 2 +や +.Xr daemon 3 +を呼び出しません。よって、制御端末から切り離されずに、標準出力に +すべてのパケット変換を表示します。このオプションはデバッグの目的に +のみ用いるべきです。 + +.It Fl unregistered_only | u +登録されていない発信元アドレスを伴う出て行くパケットのみを変換します。 +rfc 1918 によれば、登録されていない発信元アドレスは 10.0.0.0/8 と +172.16.0.0/12 と 192.168.0.0/16 となっています。 + +.It Fl redirect_port Ar linkspec +指定されたポートに入ってくるコネクションを別のホストとポートに +リダイレクトします。linkspec の書式は + + proto targetIP:targetPORT [aliasIP:]aliasPORT [remoteIP[:remotePORT]] + +のようになります。proto は tcp もしくは udp 、 targetIP は希望する +( リダイレクト先 ) 対象 IP アドレス、targetPORT は希望する対象ポート番号、 +aliasPORT は ( クライアントが ) 要求するポート番号、aliasIP は alias を +行うアドレスです。 +remoteIP と remotePORT は、必要な場合により正確なコネクションを +指定するのに利用できます。 +例えば、 + +.Ar tcp inside1:telnet 6666 + +という引数は、このマシンのポート 6666 に向けられた tcp パケットが +マシン inside1 の telnet ポートに送られることを示しています。 + +.It Fl redirect_address Ar localIP publicIP +公式な IP アドレスへのパケットの流れを、ローカルネットワーク内の +マシンにリダイレクトします。この機能は "静的 NAT (static NAT)" と +呼ばれています。 +静的 NAT はあなたの ISP が IP アドレスの小さなブロックをあたなに +割り当てた時に、単一のアドレスとして用いるのにも利用できます: + + redirect_address 10.0.0.8 0.0.0.0 + +上記のコマンドは入ってくすべてのパケットをマシン 10.0.0.8 に +リダイレクトします。 + +下記のように、いくつかのアドレス alias が同一の公式アドレスを +示すように指定すると、 + + redirect_address 192.168.0.2 public_addr + redirect_address 192.168.0.3 public_addr + redirect_address 192.168.0.4 public_addr + +入ってくるパケットの流れは最後に変換されたローカルアドレス +(192.168.0.4) に向けられますが、最初の二つのアドレスの出て行く +パケットの流れは指定された公式アドレスへの alias のままになります。 + +.It Fl permanent_link Ar linkspec +内部 alias テーブルに恒久的なエントリを作成します。linkspec の書式は + + proto targetIP:targetPORT sourceIP:sourcePORT aliasPORT + +のようになります。proto は tcp もしくは udp 、 targetIP は希望する +( リダイレクト先 ) 対象 IP アドレス、 targetPORT は希望する対象 +ポート番号、 sourceIP と sourcePORT は入ってくるパケットにマッチする +もの、aliasPORT は ( クライアントが ) 要求するポート番号、となります。 +値 0 はワイルドカードとして扱われます。例えば、 + +.Ar tcp inside1:telnet outside1:0 6666 + +はマシン outside1 ( の任意のポート ) からこのマシンのポート 6666 に +向けられた tcp パケットが、マシン inside1 の telnet ポートに送られる +ことを示します。 + +新規に導入する場合は、代わりに redirect_port を使うようにしてください。 + +.It Fl dynamic +.Fl n +オプションや +.Fl interface +オプションが用いられると、 +.Nm +は +指定された +.Ar interface +へルーティングする変換ソケットを監視します。 +.\" (訳注) kuriyama@opt.phys.waseda.ac.jp (Nov 29 1997) +.\" 上の訳はどうも意味が通らない。原文は以下の通り。誰か直して。 +.\" .Nm +.\" will monitor the routing socket for alterations to the +.\" .Ar interface +.\" passed. +.\" (訳注2) kuriyama@opt.phys.waseda.ac.jp (Jan 4 1998) +.\" ちょっと直してみたけどまだ不満。 +インターフェイスの IP アドレスが変化すると、 +.Nm +は alias アドレスを動的に変更します。 + +.It Fl i | inport Ar inport +すべてのパケットをマシンに入ってくるものとして扱い、 +.Ar inport +から読み込み、 +.Ar inport +へ書き出します。 + +.It Fl o | outport Ar outport +すべてのパケットをマシンから出て行くものとして扱い、 +.Ar outport +から読み込み、 +.Ar outport +へ書き出します。 + +.It Fl p | port Ar port +.Xr divert 4 +によって指定されたルールを用いてパケットを識別し、入ってくるパケットを +.Ar port +から読み、出て行くパケットを +.Ar port +へ書き出します。 +.Ar port +が数字でない場合、関数 +.Xr getservbyname 3 +を用いて +.Pa /etc/services +データベースが検索されます。 +このフラグが指定されない時には、デフォルトとして natd という名前の +divert ポートが用いられます。 +.Pa /etc/services +データベースのエントリの例としては以下のようになります: + + natd 6668/divert # Network Address Translation socket + +より詳しい説明は、 +.Xr services 5 +を参照してください。 + +.It Fl a | alias_address Ar address +alias アドレスとして +.Ar address +を用います。このオプションが指定されない場合は、 +.Fl n +オプションか +.Fl interface +オプションが指定されなければなりません。 + +.It Fl n | interface Ar interface +alias アドレスを決めるのに、 +.Ar interface +を用います。 +.Ar interface +に関連づけられた IP アドレスが変化する可能性がある場合には、 +.Fl dynamic +フラグも指定されるべきです。 + +.It Fl f | config Ar configfile +.Ar configfile +から設定を読み込みます。 +.Ar configfile +はオプションのリストを含み、上記のコマンドラインフラグの長い表記と +同じ物が 1 行ずつ入ります。例えば、 + + alias_address 158.152.17.1 + +という行は alias アドレスに 158.152.17.1 を指定します。 +設定ファイル内では、引数を持たないオプションは +.Ar yes +か +.Ar no +を伴って指定されます。例えば、 + + log yes + +は +.Fl log +と同じ意味になります。空行と '#' で始まる行は無視されます。 + +.El + +.Sh NATD の実行 +.Nm natd +を走らせようとする前には以下の手順が必要となります: + +.Bl -enum +.It +バージョン 2.2 かそれ以上の FreeBSD を手に入れる。これより前の +バージョンは +.Xr divert 4 +ソケットをサポートしていません。 + +.It +自分のカーネルを以下のオプションを付けて構築します: + + options IPFIREWALL + options IPDIVERT + +自分のカーネルを構築する方法については、ハンドブックに詳しい説明が +あるのでそちらを参照してください。 + +.It +あなたのマシンがゲートウェイとして働くようにします。これは +.Pa /etc/rc.conf +に + + gateway_enable=YES + +と指定するか、 + + sysctl -w net.inet.ip.forwarding=1 + +というコマンドを用いることで機能するようになります。 + +.It +.Fl n +フラグや +.Fl interface +フラグを使いたい場合は、そのインターフェイスがすでに設定済みとなるように +します。例えば、 +.Ar interface +として tun0 を指定しようとし、そのインターフェイスで +.Xr ppp 8 +を使っている場合には、 +.Nm natd +を起動する前に +.Nm ppp +を起動するようにしなければなりません。 + +.It +.Pa /etc/services +にエントリ: + + natd 6668/divert # Network Address Translation socket + +を作成します。これは +.Fl p +フラグや +.Fl port +フラグのデフォルトの値となります。 + +.El +.Pp +.Nm +の実行は至って簡単です。 + + natd -interface ed0 + +という行でほとんどの場合充分です(正しいインターフェイス名に置き換えて +ください)。 +.Nm +が起動されたら、パケットの流れの方向が natd の方に変わる +(divert される) ようにしなければなりません: + +.Bl -enum +.It +.Pa /etc/rc.firewall +スクリプトをうまく調整する必要があります。防火壁 (firewall) に +興味が無ければ、以下のようにすれば良いでしょう: + + /sbin/ipfw -f flush + /sbin/ipfw add divert natd all from any to any via ed0 + /sbin/ipfw add pass all from any to any + +2 番目の行はあなたのインターフェイスに依ります (ed0 を適切に +変更してください)。 +また、前項のように +.Pa /etc/services +に natd のエントリが入るように更新されていると仮定します。 +本物の防火壁ルールを指定する場合、スクリプトの先頭で上記の 2 行目を +指定すると良いでしょう。 +そうすることによって、防火壁により排除されてしまう前に、 +.Nm +がすべてのパケットを見ることができるようになります。 +すべての divert ルールを除き、 +.Nm +により変換された各パケットには再び防火壁のルールが適用されます。 + +.It +.Pa /etc/rc.conf +で + + firewall_enable=YES + +と設定し、防火壁を作動させます。これはシステムの起動時のスクリプトに +.Pa /etc/rc.firewall +スクリプトを実行するように伝えます。 +今すぐ再起動したくない場合には、コンソールから手で実行してください。 +バックグラウンドで実行させるのでない限り、これは決して仮想セッションから +行ってはいけません。もし実行させてしまうと、flush が行われた後に +あなたは締め出されてしまい、すべてのアクセスを永久に遮断するために +この地点で +.Pa /etc/rc.firewall +の実行は止まってしまいます。スクリプトをバックグラウンドで実行すれば、 +この災害を避けることができます。 + +.El + +.Sh 関連項目 +.Xr socket 2 , +.Xr getservbyname 2 , +.Xr divert 4 , +.Xr services 5 , +.Xr ipfw 8 + +.Sh 作者 +このプログラムは、多くの人々の細切れの努力の結果です: + + Divert ソケット: Archie Cobbs <archie@whistle.com> + パケット alias: Charles Mott <cmott@srv.net> + IRC サポート & その他の追加: Eivind Eklund <perhaps@yes.no> + Natd: Ari Suutari <suutari@iki.fi> + まとめ役: Brian Somers <brian@awfulhak.org> diff --git a/ja_JP.eucJP/man/man8/ndc.8 b/ja_JP.eucJP/man/man8/ndc.8 new file mode 100644 index 0000000000..cbf9ce551f --- /dev/null +++ b/ja_JP.eucJP/man/man8/ndc.8 @@ -0,0 +1,128 @@ +.\" Copyright (c) 1994 +.\" 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. +.\" +.\" 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. +.\" +.\" 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 解説 +このコマンドを使用する事により、ネームサーバの管理者はネームサーバに +各種シグナルを送ったり、ネームサーバをリスタートする事ができます。 +以下のリストの 0 個以上の命令を指定する事ができます。 +.TP +.B status +.BR ps (1) +で得られる +.B named +の現在の状態を表示します。 +.TP +.B dumpdb +.B named +のデータベースおよびキャッシュを +.B /var/tmp/named_dump.db +に出力します。 +(INT シグナルを用います。) +.TP +.B reload +.B named +の全てのプライマリおよびセカンダリゾーンのシリアル番号を調べ、 +変更のあったものをリロードします。 +(HUP シグナルを用います。) +.TP +.B stats +.B named +の現在の統計的な状況を +.B /var/tmp/named.stats +に出力します。 +(IOT ないし ABRT シグナルを用います。) +.TP +.B trace +.B named +の ``tracing level'' を 1 だけ増加させます。``tracing level'' が 0 以上の時、 +トレース情報は +.BR /var/tmp/named.run +に出力します。``tracing level'' が高い程、詳細な情報が得られます。 +(USR1 シグナルを用います。) +.TP +.B notrace +.B named +の ``tracing level'' を 0 にし、 +.B /var/tmp/named.run +がオープンされていればクローズします。 +(USR2 シグナルを用います。) +.TP +.B querylog +.B named +の ``query logging'' を、現在有効になっていれば無効へ、 +現在無効になっていれば有効へ変更します。 +(WINCH シグナルを用います。) +``query logging'' が有効になっている場合、 +ネームサーバへの問い合わせ情報を +.BR syslog (3) +に記録します。 +``query logging'' を有効にすると非常に多くの情報がログファイルに +記録されることに注意して下さい。この命令は +.BR qrylog +と指定することも可能です。 +.TP +.B start +.B named +が実行中でなければ、実行を開始します。 +.TP +.B stop +.B named +が実行中であれば、停止します。 +.TP +.B restart +.B named +を停止させた後、再度実行します。 +.SH バグ +.B named +への引数は、 +.BR restart +では保存されず、 +.BR start +では指定できません。 +パラメータや環境を制御する何らかの方法が必要でしょう。 +.PP +.BR sh (1) +スクリプトにより作成されています。 +.SH 作者 +Paul Vixie (Internet Software Consortium) +.SH 関連項目 +named(8), +named.reload(8), +named.restart(8) diff --git a/ja_JP.eucJP/man/man8/newfs.8 b/ja_JP.eucJP/man/man8/newfs.8 new file mode 100644 index 0000000000..3f05b73902 --- /dev/null +++ b/ja_JP.eucJP/man/man8/newfs.8 @@ -0,0 +1,303 @@ +.\" Copyright (c) 1983, 1987, 1991, 1993, 1994 +.\" 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. +.\" +.\" 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. +.\" +.\" @(#)newfs.8 8.3 (Berkeley) 3/27/94 +.\" jpman %Id: newfs.8,v 1.3 1997/07/26 22:02:06 horikawa Stab % +.\" +.Dd March 27, 1994 +.Dt NEWFS 8 +.Os BSD 4.2 +.Sh 名称 +.Nm newfs , +.Nm mfs +.Nd 新しいファイルシステムを作成する +.Sh 書式 +.Nm newfs +.Op Fl NO +.Op Fl S Ar sector-size +.Op Fl a Ar maxcontig +.Op Fl b Ar block-size +.Op Fl c Ar cylinders +.Op Fl d Ar rotdelay +.Op Fl e Ar maxbpg +.Op Fl f Ar frag-size +.Op Fl i Ar bytes +.Op Fl k Ar skew +.Op Fl l Ar interleave +.Op Fl m Ar free space +.Op Fl o Ar optimization +.Op Fl p Ar sectors +.Op Fl r Ar revolutions +.Op Fl s Ar size +.Op Fl t Ar tracks +.Op Fl u Ar sectors +.Op Fl x Ar sectors +.Ar special +.Nm mount_mfs +.Op Fl N +.Op Fl F Ar file +.Op Fl T Ar disktype +.Op Fl a Ar maxcontig +.Op Fl b Ar block-size +.Op Fl c Ar cylinders +.Op Fl d Ar rotdelay +.Op Fl e Ar maxbpg +.Op Fl f Ar frag-size +.Op Fl i Ar bytes +.Op Fl m Ar free space +.Op Fl o Ar options +.Op Fl s Ar size +.Ar special node +.Sh 解説 +.Nm newfs +は、わかりにくい +.Xr mkfs 8 +の代わりとなるものです。 +.Nm newfs +や +.Nm mount_mfs +を走らせる前に、 +.Xr disklabel 8 +を使ってディスクラベルが書き込んでいなければなりません。 +.Nm newfs +は、指定したスペシャルデバイスにファイルシステムを作成します。 +デフォルト値はたいてい妥当な値となりますが、 +.Nm newfs +にはこの値を変更するための数多くのオプションがあります。 +.Pp +.Nm mount_mfs +は、仮想メモリ上にファイルシステムを構築し、指定したノード +にそのファイルシステムをマウントするために使います。 +ファイルシステムがアンマウントされると、 +.Nm mount_mfs +は終了し、このファイルシステムの内容は失われます。 +.Nm mount_mfs +にシグナルが送られると、 +ファイルシステムをアンマウントしようとします。たとえば、 +シャットダウンする場合がこれにあたります。 +.Nm mount_mfs +に指定するパラメータは +.Nm newfs +のものと同じです。 +スペシャルファイルはディスクラベルを読むためにのみ使われ、 +それによってメモリベースファイルシステムへのコンフィギュレーション +パラメータが得られます。 +このスペシャルファイルは通常、第一スワップ領域を指定します。という +のは、フリーメモリが少なくなって、ファイルシステムをサポートす +るメモリ領域がページングされるとき、ファイルシステムがそこに +バックアップされるからです。 +.Pp +以下のオプションにて一般的な配置方針を定義します。 +.Bl -tag -width Fl +.It Fl T Ar disktype +過去のものとの互換性のためと +.Nm mount_mfs +のための物です。 +.It Fl F Ar file +.Nm mount_mfs +は、ファイルシステムのイメージとしてこのファイルを使用します。 +.Nm mount_mfs +が終了した時、このファイルは残されます。 +.It Fl N +実際にはファイルシステムを構築せずに、ファイルシステム +パラメータの表示のみを行います。 +.It Fl O +4.3BSD フォーマットのファイルシステムを作成します。この +オプションは、古いブート ROM が理解できるルートファイル +システムを使う必要がある場合に使います。 +.It Fl a Ar maxconting +回転遅延 (rotational delay) を強制する前に +配置される連続ブロックの最大数を指定します ( +.Fl d +オプションを参照)。 +デフォルトは 1 です。このオプションをどのように設定す +るかについて、詳しくは +.Xr tunefs 8 +を参照してください。 +.It Fl b Ar block-size +ファイルシステムのブロックサイズをバイト単位で指定します。 +.It Fl c Ar #cylinders/group +ファイルシステムのシリンダグループごとのシリンダ数を指定 +します。デフォルトは 16 です。 +.It Fl d Ar rotdelay +同じディスクに対する +ディスク転送完了割り込みサービスと新たな転送開始に費す時間の +期待値を指定します (ミリ秒単位)。デフォルトは0ミリ秒です。詳細は、 +.Xr tunefs 8 +を参照してください。 +.It Fl e Ar maxbpg +単一のファイルが他のシリンダグループへまたがることを強制される前に、 +1 つのシリンダグループから割り当てることのできる最大のブロック数を指定し +ます。デフォルト値は、シリンダグループのブロック数の約 1/4 です。この +オプションの詳細については、 +.Xr tunefs 8 +を参照してください。 +.It Fl f Ar frag-size +ファイルシステムのフラグメントサイズをバイト単位で指定します。 +.It Fl i Ar number of bytes per inode +ファイルシステム中の i ノードの密度を設定します。デフォルト +は、(4 * フラグメントサイズ) バイトのデータ領域ごとに1つの i ノードを作ります。 +i ノード数を少なくしたい場合は大きな値を指定し、 +i ノード数を多くしたい場合は小さな値を指定します。 +.It Fl m Ar free space \&% +通常のユーザからは保護されている領域のパーセンテージを +指定します。 +これは最低限の空き領域のしきい値となります。 +デフォルト値は +.Ao Pa ufs/ffs/fs.h Ac +にて +.Dv MINFREE +と定義され、現在 8% です。 +このオプションの詳細については、 +.Xr tunefs 8 +を参照してください。 +.It Fl n Ar number of distinguished rotational positions +ディスク一回転あたりに確保する回転時間の数を設定します。デフォルトは 1 +で、回転位置テーブルを無効にすることを意味します。 +.It Fl o Ar optimization\ preference +.Pq ``space'' か ``time'' +ブロック確保に費す時間を最小にするか、 +ディスク上のフラグメント領域を最小にするかを、 +ファイルシステムに指示します。 +デフォルトで minfree (前述) が 8% を下回る場合は、 +領域の最小化が行われ、8% 以上ならば時間の最小化が行われます。 +このオプションの詳細については、 +.Xr tunefs 8 +を参照してださい。 +.It Fl s Ar size +ファイルシステムサイズをセクタ単位で指定します。 +.El +.Pp +次のオプションは、ディスクジオメトリの標準設定を変更します。 +デフォルトの値はディスクラベルから得られます。 +これらの値を変更するのは、 +最初にファイルシステムを構築したときとは異なるタイプのディスク上で +ロウイメージを使用してファイルシステムを構築するようなときだけです +(たとえば、ライトワンスディスク上など)。 +これらの値をデフォルトの +値から変更すると、標準のスーパブロックが壊れたときに、 +.Xr fsck 8 +が代替のスーパブロックを見つけることができなくなるので注意して +ください。 +.Bl -tag -width Fl +.It Fl S Ar sector-size +セクタサイズ (バイト単位) です (通常 512 以外は使用しません)。 +.It Fl k Ar sector \&0 skew , per track +遅いコントローラを補うためにメディアのフォーマット時の補正を指定します。 +トラックスキューは同じシリンダ上のトラック N のセクタ 0 とトラック N-1 +のセクタ 0 のオフセットです。 +.It Fl l Ar hardware sector interleave +遅いコントローラを補うためにメディアのフォーマット時の補正を指定します。 +インタリーブはトラック毎の物理セクタのインタリーブで、次の比の分母で +定義されます: +.Dl 読まれるセクタ/通過するセクタ +つまりインタリーブの 1/1 は連続的に配置されていることを、 1/2 は論理 +セクタ 0 と論理セクタ 1 との間に 1 セクタあることを示します。 +.It Fl p Ar spare sectors per track +予備セクタ (不良セクタと置き換えるセクタ) は、 +各トラックの最後の物理セクタを使用します。 +これらには、ファイルシステムとしてデータを割り当てることができないため、 +セクタ/トラック +.Pq Fl u +に含まれません。 +.It Fl r Ar revolutions/minute +1 分間あたりのディスク回転速度を指定します。 +.It Fl t Ar #tracks/cylinder +ファイルシステムによってデータを割り当てることができるシリンダあたりの +トラック数です。デフォルトは 1 です。0 が設定された場合にはディスクラベル +に指定されている値が使われます。 +.It Fl u Ar sectors/track +ファイルシステムによってデータを割り当てることができるトラックあたりの +セクタ数です。デフォルトは 4096 です。 0 が設定された場合にはディスクラベルに +指定されている値が使われます。この値には、各トラックの最後に確保 +される不良ブロックの置き換えのための予備セクタは含まれません ( +.Fl p +オプションを参照)。 +.It Fl x Ar spare sectors per cylinder +予備セクタ (不良セクタと置き換えるセクタ) は、シリンダの最後のトラック +の物理セクタを使用します。これらには、ファイルシステムとしてデータを +割り当てることができないため、セクタ/トラック +.Pq Fl u +には含まれません。 +.El +.Pp +.Nm mount_mfs +コマンドのオプションは、 +.Fl o +オプションを除いて +.Nm newfs +コマンドと同じものです。 +.Pp +.Fl o +オプションは以下のとおりです: +.Bl -tag -width indent +.It Fl o +.Fl o +フラグに続いて指定されるオプションは、コンマで区切られた文字列です。 +指定できるオプションとその意味は +.Xr mount 8 +を参照してください。 +.El +.Sh 使用例 +.Pp +.Dl mount_mfs -s=20480 -o nosuid,nodev /dev/sd0b /tmp +.Pp +.Xr mount 8 +の nosuid と nodev のオプションを指定し、 +10240 KB の大きさのメモリファイルシステムを /tmp にマウントします。 +.Sh 関連項目 +.Xr fdformat 1 , +.Xr disktab 5 , +.Xr fs 5 , +.Xr disklabel 8 , +.Xr diskpart 8 , +.Xr dumpfs 8 , +.Xr fsck 8 , +.Xr mount 8 , +.Xr scsiformat 8 , +.Xr tunefs 8 +.Rs +.%A M. McKusick +.%A W. Joy +.%A S. Leffler +.%A R. Fabry +.%T A Fast File System for UNIX , +.%J ACM Transactions on Computer Systems 2 +.%V 3 +.%P pp 181-197 +.%D August 1984 +.%O (reprinted in the BSD System Manager's Manual) +.Re +.Sh 歴史 +.Nm +コマンドは、 +.Bx 4.2 +から登場しています。 diff --git a/ja_JP.eucJP/man/man8/newsyslog.8 b/ja_JP.eucJP/man/man8/newsyslog.8 new file mode 100644 index 0000000000..8eeffd7ba6 --- /dev/null +++ b/ja_JP.eucJP/man/man8/newsyslog.8 @@ -0,0 +1,164 @@ +.\" This file contains changes from the Open Software Foundation. +.\" +.\" from: @(#)newsyslog.8 +.\" jpman %Id: newsyslog.8,v 1.3 1997/08/16 13:33:00 horikawa Stab % +.\" %Id: newsyslog.8,v 1.1.1.1.2.3 1997/10/08 07:21:09 charnier Exp % +.\" +.\" Copyright 1988, 1989 by the Massachusetts Institute of Technology +.\" +.\" Permission to use, copy, modify, and distribute this software +.\" and its documentation for any purpose and without fee is +.\" hereby granted, provided that the above copyright notice +.\" appear in all copies and that both that copyright notice and +.\" this permission notice appear in supporting documentation, +.\" and that the names of M.I.T. and the M.I.T. S.I.P.B. not be +.\" used in advertising or publicity pertaining to distribution +.\" of the software without specific, written prior permission. +.\" M.I.T. and the M.I.T. S.I.P.B. make no representations about +.\" the suitability of this software for any purpose. It is +.\" provided "as is" without express or implied warranty. +.\" +.Dd "January 12, 1989" +.Dt NEWSYSLOG 8 +.Os +.Sh 名称 +.Nm newsyslog +.Nd システムのログファイルを保守し、適切なサイズに保つ +.Sh 書式 +.Nm newsyslog +.Op Fl rnv +.Op Fl f Ar config_file +.Sh 解説 +.Nm +は +.Xr cron 8 +から定期的に実行されるようにスケジュールされるべきプログラムです。 +実行されると、 +.Nm +は必要に応じてログファイルを保存(アーカイブ)します。 +あるログファイルを保存する必要があると判断すると、 +.Nm +は、``logfile'' が空になり、``logfile.0'' に前回のログファイルが入り、 +``logfile.1'' に前々回のログが入り‥‥ といった具合に、 +ユーザが指定した数の保存ログが残るよう、ファイルを再編します。 +オプションにより、保存ログを圧縮してスペースを節約することもできます。 +.Pp +ログが保存される場合には 2 つの理由があります。 +そのログファイルのサイズが予めセットしておいたキロバイト数より大きくなった、 +もしくは、前回ログを保存してから指定した時間が経過した、という理由です。 +.Nm +の粒度は、このコマンドが +.Xr cron 8 +からどの程度の頻度で実行されるかに依存しています。 +.Nm +の実行は十分速いので、毎時間実行するようにスケジュールしても +悪影響はありません。 +.Pp +起動されると、 +.Nm +はコンフィギュレーションファイルを読み込んで、 +どのログファイルをチェックすべきかを決定します。 +デフォルトでは、このコンフィギュレーションファイルは +.Pa /etc/newsyslog.conf +です。 +コンフィギュレーションファイルの各行には、 +.Nm +が処理すべき特定のログファイルに関する情報を記述します。 +各行は 5 つの必須フィールドと、2 つのオプションフィールドから成り、 +それらは空白で区切られています。 +空行や ``#'' で始まる行は無視されます。 +コンフィギュレーションファイルの各フィールドは以下の通りです: +.Pp +.Bl -tag -width indent +.It Ar logfile_name +保存するシステムログファイル名。 +.It Ar owner.group +保存ファイルの所有者とグループ名を指定します。 +.Ar owner +あるいは +.Ar group +が空白のままである場合でも "." は必須です。 +指定は数値、あるいは +.Pa /etc/passwd +か +.Pa /etc/group +にある名前で行います。 +.It Ar mode +ログファイルと保存ログファイルのモードを指定します。 +.It Ar count +ログファイルそのものに加えて保存しておく保存ファイルの数を指定します。 +.It Ar size +ログファイルのサイズが +.Ar size +に達すると、ログファイルは上記のように入れ換えられます。 +このフィールドが +.Ar * +で置き換えられると、ログファイル入れ換えに際して +そのサイズは考慮されなくなります。 +.It Ar interval +.Ar interval +時間(60 分×interval の意)が経過すると、ログファイルが入れ換えられます。 +このフィールドが +.Ar * +で置き換えられると、前回の入れ換えからの経過時間は考慮されません。 +.It Ar flags +このフィールドはオプションであり、 +保存に際してログファイルに特別な処理を行うかどうかを指定します。 +.Ar Z +フラグを指定すると、スペース節約のために +保存ファイルは +.Xr gzip 1 +で圧縮されます。 +.Ar B +フラグはファイルがバイナリファイルであることを指示し、 +ログファイルが入れ換わったという意味で +.Nm +が挿入する +.Tn ASCII +メッセージを含めないようにします。 +.El +.Sh オプション +newsyslog では以下のオプションが利用できます: +.Bl -tag -width indent +.It Fl f Ar config_file +コンフィギュレーションファイルとして +.Pa /etc/newsyslog.conf +に代えて +.Ar config_file +を使用します。 +.It Fl v +.Nm +を詳細情報出力モードにします。 +このモードでは、ログを入れ換えるあるいはそれをスキップするたびに、 +そのログファイル名と理由を表示します。 +.It Fl n +実際にログの入れ換えは行わず、このオプションが指定されない場合に +本来行うはずの処理内容を表示します。 +.It Fl r +.Nm +は root として動作しなければならない、という制約を取り除きます。 +もちろん、 +.Nm +は +.Xr syslogd 8 +に HUP シグナルを送れなくなりますから、 +このオプションはデバッグにのみ用いるべきです。 +.El +.Sh 関連ファイル +.Bl -tag -width /etc/newsyslog.confxxxx -compact +.It Pa /etc/newsyslog.conf +.Nm +のコンフィギュレーションファイル +.El +.Sh バグ +セキュリティ侵害を見つけるためにログを自動的に読むことは、 +まだ行っていません。 +.Sh 作者 +.An Theodore Ts'o , +MIT Project Athena +.Pp +Copyright 1987, Massachusetts Institute of Technology +.Sh 関連項目 +.Xr gzip 1 , +.Xr syslog 3 , +.Xr syslogd 8 diff --git a/ja_JP.eucJP/man/man8/nextboot.8 b/ja_JP.eucJP/man/man8/nextboot.8 new file mode 100644 index 0000000000..20cd7c2b34 --- /dev/null +++ b/ja_JP.eucJP/man/man8/nextboot.8 @@ -0,0 +1,99 @@ +.\" %Id: nextboot.8,v 1.3.2.1 1996/12/10 16:43:01 joerg Exp % +.\" jpman %Id: nextboot.8,v 1.3 1997/08/16 13:35:00 horikawa Stab % +.Dd July 9, 1996 +.Dt NEXTBOOT 8 +.\".Os BSD 4 +.Sh 名称 +.Nm nextboot +.Nd ブートディスクにデフォルトのブートストリングブロックをインストールする +.Sh 書式 +.Nm +.Op Fl b +.Ar filename bootstring ... +.Pp +.Nm +.Op Fl ed +.Ar filename +.Bl -tag -width time +.It Fl b +ネームブロックをブートストラップする (最初に構成する) のに用いられます。 +このオプションを指定しない場合、 +.Nm +はマジックナンバをまだもっていないブロックへの書き込みを拒否します。 +.It Fl d +マジックナンバ中のビットを変更して、既存のネームブロックを +一時的に無効化します。 +.It Fl e +-d オプションで無効化されたブロックに、 +有効なマジックナンバを再設定します。 +.El +.Sh 前書き +FreeBSD の +.Nm +プログラムは、次回ブート時のブートブロックの動作を制御します。 +正しいオプションと共にコンパイルされていれば、 +ブートに用いるマジックナンバとデフォルトネームがあるかどうか、 +ブートブロックはネームブロックをチェックします。 +ブートブロックがそのようにコンパイルされている場合、 +ブートが失敗したら再度ブートを試みないように +ブートブロックはブロックからネームを削除します。 +ブートが成功した場合に +.Nm +を用いてブートストリングを再インストールするのは /etc/rc の仕事です。 +これにより、リモートデバッギングや +新しく信頼のおけないカーネルをインストールするといった場合に、 +一度だけのブートストリングを用いることができるようになります。 +コンパイル時に、ネームブロックはディスクの 2 番目の物理ブロックとして +定義されています。 +.Pp +.Sh 解説 +.Nm +はまず、指定ディスクが fdisk テーブルを持ち、 +そのテーブルで定義されている全パーティションがネームブロックを含んでいない +ことをチェックします。 +ネームブロックが使われていないことが明らかになれば、 +.Nm +は +引数に指定されたブートストリングを一つずつ、小さいマジックナンバを前につけ、 +最後に NULL を加えてインストールします。 +ストリングのリストの最後は 0xff バイトの列で区切られます。 +ブートブロックがブートの度にネームブロックを書き戻す (write back) ように +コンパイルされている場合、 +ブートブロックはブート毎に一つずつ供給されたネームをゼロクリアします。 +これは 0xff に到達するまで続き、 +その時点でコンパイル時に組み込まれたブートストリングに戻ります。 +この時点で、ネームブロックはゼロクリアされたネームだけになります。 +.Pp +使用例を示します: +.Bd -literal + nextboot -b /dev/rwd0 1:sd(0,a)/kernel.experimental wd(0,a)/kernel.old +.Ed +.Pp +これは、次回ブート時に実験カーネルを SCSI ディスクからブートしてみるよう、 +ブートブトックに指示します。 +何らかの理由でこれが失敗すると、その次のブートではカーネル +.Em /kernel.old +を IDE ドライブからブートしようと試みます。 +(書き戻しオプションが有効であると仮定しています。) +これも失敗すると、コンパイル時に組み込まれたデフォルトが用いられます。 +.Pp +書き戻し機能が無効化されている場合、nextboot はデフォルトのブートストリングを +変更する簡便な手段となります。 +もしネームブロックで指定されたファイルが存在しないと、 +ネームブロックの次のネームではなく、コンパイル時にブートブロックの中に +組み込まれたネームがブート用に用いられることに注意して下さい。 +ネームブロックはブート毎に「一回だけ」チェックされます。 +.Sh 関連項目 +.Xr boot 8 , +.Xr disklabel 8 , +.Xr fdisk 8 +.Sh バグ +プログラム全体にもっとユーザフレンドリにすべきです。 +書き戻しの有効無効オプション設定はコンパイル時オプションではなく、 +ディスク上にストアすべきです。 +fdisk パーティションテーブルが存在しないディスク (つまり +純粋にディスクラベルだけのシステム) と共存できるように、 +将来、この点に関して再考したいと考えています。 +.Pp +書き戻しを有効とするか否かは実行時にネームブロックで指定し、 +この機能を得るためにブートブロックを書き換える必要のないようにすべきです。 diff --git a/ja_JP.eucJP/man/man8/nfsd.8 b/ja_JP.eucJP/man/man8/nfsd.8 new file mode 100644 index 0000000000..8a271cb217 --- /dev/null +++ b/ja_JP.eucJP/man/man8/nfsd.8 @@ -0,0 +1,139 @@ +.\" Copyright (c) 1989, 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. +.\" +.\" 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. +.\" +.\" @(#)nfsd.8 8.3 (Berkeley) 2/22/94 +.\" jpman %Id: nfsd.8,v 1.2 1997/03/31 14:53:57 horikawa Stab % +.\" +.Dd February 22, 1994 +.Dt NFSD 8 +.Os +.Sh 名称 +.Nm nfsd +.Nd リモートマシンに対して +.Tn NFS +サービスを行うデーモン +.Pp +.Sh 書式 +.Nm nfsd +.Op Fl rut +.Op Fl n Ar num_servers +.Pp +.Sh 解説 +.Nm nfsd +は +.Tn NFS +サーバマシン上で実行され、クライアントからの +.Tn NFS +要求に対するサービスを行います。サーバマシンとして動作させるには、 +最低でも 1 つの +.Nm nfsd +が動作していなければなりません。 +.Pp +何も指定されない場合は、 +.Tn UDP +トランスポートを用いるサーバが 4 つ起動されます。 +.Pp +以下のオプションが利用可能です: +.Bl -tag -width Ds +.It Fl r +新たなサーバを生成せずに、 +.Tn NFS +サービスだけを +.Xr portmap 8 +に登録します。 +このオプションは、portmap サーバが再起動したときに +.Tn NFS +サービスを再登録するために、 +.Fl u +や +.Fl t +オプションといっしょに使われます。 +.It Fl n +スタートさせるサーバの数を指定します。 +.It Fl t +.Tn TCP NFS +クライアントに対するサービスを行います。 +.It Fl u +.Tn UDP NFS +クライアントに対するサービスを行います。 +.El +.Pp +例えば、 +.Dq Li "nfsd -u -t 6" +は、 +.Tn UDP +と +.Tn TCP +トランスポートに対するサービスを行う 6 つのデーモンを生成します。 +.Pp +クライアントからの要求を最大限並列処理するのに十分な数のデーモンを実行 +する必要があります。典型的には 4 個から 6 個です。 +.Pp +.Nm nfsd +は、 +.Tn NFS +サーバの仕様で示されているポートで、サービス要求を待ちます。 +この仕様に関しては、 +.%T "NFS: Network File System Protocol Specification" , +RFC1094, +.%T "NFS: Network File System Version 3 Protocol Specification" +を参照してください。 +.Pp +動作中のカーネルに +.Tn NFS +がロードされていないことを検出すると、 +.Nm nfsd +は +.Xr vfsload 3 +を経由して +.Xr modload 8 +により、 +.Tn NFS +をサポートしたロード可能カーネルモジュールを読み込もうとします。 +.Nm nfsd +は、これに失敗した場合、もしくは +.Tn NFS +LKM が用意されていないときにはエラー終了します。 +.Pp +.Nm nfsd +は、成功した場合は0を、エラーが起きた場合は0より大きな値を返します。 +.Pp +.Sh 関連項目 +.Xr nfsstat 1 , +.Xr nfssvc 2 , +.Xr modload 8 , +.Xr mountd 8 , +.Xr portmap 8 +.Sh 歴史 +.Nm nfsd +ユーティリティは +.Bx 4.4 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/nfsiod.8 b/ja_JP.eucJP/man/man8/nfsiod.8 new file mode 100644 index 0000000000..0c292019fd --- /dev/null +++ b/ja_JP.eucJP/man/man8/nfsiod.8 @@ -0,0 +1,99 @@ +.\" Copyright (c) 1989, 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. +.\" +.\" 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. +.\" +.\" From: @(#)nfsiod.8 8.2 (Berkeley) 2/22/94 +.\" %Id: nfsiod.8,v 1.3 1996/08/23 20:35:40 mpp Exp % +.\" jpman %Id: nfsiod.8,v 1.3 1997/08/10 18:33:51 horikawa Stab % +.\" +.Dd September 22, 1994 +.Dt NFSIOD 8 +.Os +.Sh 名称 +.Nm nfsiod +.Nd ローカルな +.Tn NFS +のための非同期 I/O サーバ +.Pp +.Sh 書式 +.Nm nfsiod +.Op Fl n Ar num_servers +.Pp +.Sh 解説 +.Nm nfsiod +は +.Tn NFS +クライアントマシン上で動作し、サーバに対する非同期 I/O 要求を処理します。 +これによりパフォーマンスは向上しますが、 +正しい動作のために必要とされているわけではありません。 +.Pp +オプションは以下の通りです: +.Bl -tag -width Ds +.It Fl n Ar num_server +サーバをいくつスタートさせるかを指定する。 +.El +.Pp +何も引数が指定されなければ、サーバは1つだけスタートします。 +.Pp +クライアントは、最大限並行処理を行うのに十分な数のデーモンを実行するべきです。 +典型的には 4 つから 6 つです。 +.Pp +動作中のカーネルに +.Tn NFS +サポートが含まれていないことを +.Nm nfsiod +が検出した場合、 +.Nm nfsiod +は +.Xr modload 8 +に含まれる +.Xr vfsload 3 +の機能を用いて、 +.Tn NFS +コードを含むローダブルカーネルモジュールをロードしようとします。 +これが失敗した場合、または +.Tn NFS +ローダブルカーネルモジュールが存在しない場合、 +.Nm nfsiod +はエラーを返して終了します。 +.Pp +.Nm nfsiod +は、成功すれば 0 を、エラーが起きると 0 より大きな値を返して終了します。 +.Sh 関連項目 +.Xr nfsstat 1 , +.Xr nfssvc 2 , +.Xr modload 8 , +.Xr mountd 8 , +.Xr portmap 8 +.Sh 歴史 +.Nm nfsiod +ユーティリティは +.Bx 4.4 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/nologin.8 b/ja_JP.eucJP/man/man8/nologin.8 new file mode 100644 index 0000000000..62e2520266 --- /dev/null +++ b/ja_JP.eucJP/man/man8/nologin.8 @@ -0,0 +1,56 @@ +.\" 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. +.\" +.\" 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. +.\" +.\" @(#)nologin.8 8.1 (Berkeley) 6/19/93 +.\" jpman %Id: nologin.8,v 1.2 1997/03/31 14:54:31 horikawa Stab % +.\" +.Dd June 19, 1993 +.Dt NOLOGIN 8 +.Os BSD 4.4 +.Sh 名称 +.Nm nologin +.Nd 丁寧に login を断る +.Sh 書式 +.Nm nologin +.Sh 解説 +.Nm nologin +は、 +そのアカウントが利用出来ない旨のメッセージを表示して、 +0 でない値を返して終了します。 +このコマンドは、利用不可能とするアカウントの shell フィールドを +置き換えるという用途を想定しています。 +.Sh 関連項目 +.Xr login 1 +.Sh 歴史 +.Nm nologin +コマンドは +.Bx 4.4 +から登場しています。 diff --git a/ja_JP.eucJP/man/man8/nslookup.8 b/ja_JP.eucJP/man/man8/nslookup.8 new file mode 100644 index 0000000000..b467f23d53 --- /dev/null +++ b/ja_JP.eucJP/man/man8/nslookup.8 @@ -0,0 +1,391 @@ +.\" +.\" ++Copyright++ 1985, 1989 +.\" - +.\" Copyright (c) 1985, 1989 +.\" 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. +.\" +.\" 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. +.\" - +.\" Portions Copyright (c) 1993 by Digital Equipment Corporation. +.\" +.\" Permission to use, copy, modify, and distribute this software for any +.\" purpose with or without fee is hereby granted, provided that the above +.\" copyright notice and this permission notice appear in all copies, and that +.\" the name of Digital Equipment Corporation not be used in advertising or +.\" publicity pertaining to distribution of the document or software without +.\" specific, written prior permission. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS" AND DIGITAL EQUIPMENT CORP. DISCLAIMS ALL +.\" WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL DIGITAL EQUIPMENT +.\" CORPORATION BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL +.\" DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR +.\" PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS +.\" ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS +.\" SOFTWARE. +.\" - +.\" --Copyright-- +.\" +.\" @(#)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 +はインターネットネームサーバに問い合わせを行います。 +.I nslookup +には対話モードと非対話モードの二つのモードがあります。 +対話モードでは、 +様々なホストやドメインの情報をネームサーバに対して問い合わせたり、 +あるドメイン内のホスト一覧を表示することができます。 +非対話モードでは、あるホストもしくはドメインの名前および +要求した情報のみが表示されます。 +.sp 1 +.SH 引数 +次の場合は対話モードに入ります。 +.IP a) 4 +引数が与えられなかったとき(デフォルトのネームサーバを利用します)。 +.IP b) 4 +最初の引数がハイフン (\-) であり、二番目の引数がネームサーバの +ホスト名もしくは IP アドレスであるとき。 +.LP +検索したいホストの名前もしくは IP アドレスが最初の引数として与えられた場合は、 +非対話モードになります。 +二番目の引数はオプションで、ネームサーバのホスト名もしくは IP アドレスを +指定します。 +.LP +``set'' コマンドを使うオプションは、ホームディレクトリの .nslookuprc +ファイルに一行に一つずつ書くことでも指定できます。 +オプションはコマンドラインで指定することも可能です。その場合、 +前にハイフンをつけ、引数より先に書きます。たとえば、デフォルトの問い合わせを +ホスト情報に変更し、初期タイムアウトを 10 秒とするには、 +.sp .5v + nslookup \-query=hinfo \-timeout=10 +.sp .5v +とします。 +.SH "対話 コマンド" +コマンドは control-C を入力することでいつでも中断できます。 +終了するには、 control-D (EOF) もしくは exit を入力します。 +コマンドラインの長さは 256 文字以下でなければなりません。 +内部コマンドをホスト名として扱うには、 +エスケープ文字 (\e) を頭につけます。 +\fB注意:\fP 解釈できないコマンドはホスト名として扱われます。 +.sp .5v +.IP "\fIhost\fP [\fIserver\fP]" +\fIhost\fP についての情報を現在のデフォルトサーバ、もしくは +\fIserver\fPが指定されている場合はそのサーバに問い合わせます。 +\fIhost\fP が IP アドレスであり、問い合わせタイプが A もしくは PTR +であるときは、ホスト名が返されます。 +\fIhost\fP が 名前であり、最後にピリオドがないときには、 +その後ろにデフォルトのドメイン名が付加されます(この動作は、 +\fBset\fP オプションの \fBdomain\fP, \fBsrchlist\fP, +\fBdefname\fP, \fBsearch\fP に依存します)。 +現在のドメインにないホストについて調べるときには、 +名前の末尾にピリオドを付加します。 +.sp 1 +.IP "\fBserver\fP \fIdomain\fP" +.ns +.IP "\fBlserver\fP \fIdomain\fP" +デフォルトサーバを \fIdomain\fP に変更します。 +\fBlserver\fP は \fIdomain\fP に +ついての情報を探すのに初期サーバを使い、\fBserver\fPは +現在のデフォルトサーバを使います。 +公式の答えが見つからないときには、答えを持つ可能性のある +サーバ名が返されます。 +.sp 1 +.IP \fBroot\fP +デフォルトサーバをドメイン名空間のルートサーバに変更します。 +現在のところホスト 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]" +現在のホストにあるフィンガーサーバと接続します。 +現在のホストは、以前の問い合わせが成功し、アドレス情報が +返されたときに定義されます(\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 に追加できます。 +デフォルトの出力にはホスト名とその IP アドレスが含まれます。 +.I オプション +は下記のいずれかです。 +.RS +.IP "\fB\-t \fIquerytype\fP" 4 +指定したタイプの全レコードの一覧を出力します(下記の \fIquerytype\fP 参照)。 +.IP \fB\-a\fP 4 +そのドメイン内での、各ホストのエイリアス一覧を出力します。 +\fB\-t\ \ CNAME\fP と同義です。 +.IP \fB\-d\fP 4 +そのドメインの全レコードの一覧を出力します。 +\fB\-t\ \ ANY\fP と同義です。 +.IP \fB\-h\fP 4 +そのドメインの CPU 及び OS 情報を出力します。 +\fB\-t\ \ HINFO\fP と同義です。 +.IP \fB\-s\fP 4 +そのドメイン内のホストの well-known サービスの一覧を出力します。 +\fB\-t\ \ WKS\fP と同義です。 +.P +出力がファイルにリダイレクトされるときには、サーバから 50 レコードを +受け取るたびに区切りが入れられます。 +.RE +.sp 1 +.IP "\fBview\fP \fIfilename\fP" +直前の \fBls\fP コマンドの出力を並べ変え、 +\fImore\fP(1) +で出力します。 +.sp 1 +.ne 4 +.IP "\fBhelp\fP" +.ns +.IP "\fB?\fP" +コマンドの簡単な要約を表示します。 +.sp 1 +.IP "\fBexit\fP" +プログラムを終了します。 +.sp 1 +.IP "\fBset\fP \fIkeyword\fP[=\fIvalue\fP]" +このコマンドは探索に影響するオプションを変更するのに使われます。 +有効な keyword は以下の通りです。 +.RS +.IP "\fBall\fP" +よく使われる \fBset\fP のオプションの現在の値を表示します。 +現在のデフォルトサーバとホストに関する情報も表示されます。 +.IP "\fBclass=\fIvalue\fR" +問い合わせのクラスを次のいずれかに変更します。 +.RS +.IP IN 10 +internet クラス。 +.IP CHAOS 10 +chaos クラス。 +.IP HESIOD 10 +MIT Athena Hesiod クラス。 +.IP ANY 10 +上記すべて。 +.P +クラスは情報のプロトコルグループを特定します。 +.br +(デフォルト = IN, 略記 = cl) +.RE +.IP "\fB[no]debug\fP" +デバッグモードにします。サーバに送られるパケットとそれに +対する返答について、より多くの情報が表示されます。 +.br +(デフォルト = nodebug, 略記 = [no]deb) +.IP "\fB[no]d2\fP" +詳細なデバッグモードにします。 +パケットごとに重要な全てのフィールドが表示されます。 +.br +(デフォルト = nod2) +.IP "\fBdomain=\fIname\fR" +デフォルトドメイン名を \fIname\fP に変更します。 +\fBdefname\fP , \fBsearch\fP オプションの設定に応じて、 +探索要求されるホスト名にデフォルトドメイン名が付加されます。 +デフォルトドメイン名が二つ以上の要素から +なるとき、ドメインサーチリストにはデフォルトドメインの親が含まれます。 +たとえば、デフォルトドメイン名が +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, ...に変更します。スラッシュ (/) で区切って +最大 6 つまで指定可能です。 +たとえば +.sp .5v + set\ srchlist=lcs.MIT.EDU/ai.MIT.EDU/MIT.EDU +.sp .5v +の場合、ドメインを lcs.MIT.EDU にし、サーチリストを上の 3 つの名前に +設定します。 +このコマンドは、\fBset domain\fP コマンドによるデフォルトドメイン名と +サーチリストを上書きします。 +リストを表示するには、 \fBset all\fP コマンドを使います。 +.br +(デフォルト = ホスト名に基づく値, /etc/resolv.conf あるいは LOCALDOMAIN, +略記 = srchl) +.IP "\fB[no]defname\fP" +これが設定されると、単一要素からなる問い合わせ(すなわちピリオドのないもの) +に対して、 +指定したデフォルトドメイン名が付加されます。 +.br +(デフォルト = defname, 略記 = [no]def) +.IP "\fB[no]search\fP" +問い合わせ要求にピリオドが少なくとも一つ含まれているが +ピリオドで終ってはいない場合、 +答えが受け取れるまで、ドメインサーチリスト内のドメイン名を +付加します。 +.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 +問い合わせる情報の種類を変更します。情報は次のうちのいずれかです。 +.RS +.IP A 10 +ホストの IP アドレス。 +.IP CNAME 10 +別名に対する正式名。 +.IP HINFO 10 +ホストの CPU と OS の種類。 +.IP MINFO 10 +メールボックスもしくは、メールリストに関する情報。 +.IP MX 10 +メール交換ホスト。 +.IP NS 10 +その名前空間内のネームサーバ。 +.IP PTR 10 +問い合わせが IP アドレスであればホスト名、そうでなければ +それ以外の情報へのポインタ。 +.IP SOA 10 +ドメインの ``start-of-authority'' 情報。 +.IP TXT 10 +テキスト情報。 +.IP UINFO 10 +ユーザ情報。 +.IP WKS 10 +サポートする well-known サービス。 +.P +他のタイプ (ANY, AXFR, MB, MD, MF, NULL) については、ドキュメント +RFC-1035 に書かれています。 +.br +(デフォルト = A, 略記 = q, ty) +.RE +.IP "\fB[no]recurse\fP" +サーバが情報を持っていないときに、他のサーバに問い合わせるよう +指示します。 +.br +(デフォルト = recurse, 略記 = [no]rec) +.IP \fBretry=\fInumber\fR +リトライ回数を \fInumber\fP 回とします。 +要求に対する返答をある時間内 (\fBset timeout\fP で変更できる) に +受け取らなかったとき、タイムアウト期間は 2 倍にされ、 +要求が再送されます。 +retry の値は、あきらめるまでに要求を何回再送するかを決めます。 +.br +(デフォルト = 4, 略記 = ret) +.IP \fBroot=\fIhost\fR +ルートネームサーバ名を \fIhost\fP に変更します。 +これは \fBroot\fP コマンドに影響します。 +.br +(デフォルト = ns.internic.net., 略記 = ro) +.IP \fBtimeout=\fInumber\fR +返答を待つ初期タイムアウト間隔を \fInumber\fP 秒に変更します。 +リトライのたびにタイムアウト間隔は倍になります。 +.br +(デフォルト = 5 seconds, 略記 = ti) +.IP "\fB[no]vc\fP" +サーバに 要求を出すときに常に 仮想回路 +(virtual circuit) を使います。 +.br +(デフォルト = novc, 略記 = [no]v) +.IP "\fB[no]ignoretc\fP" +パケットトランケーションエラーを無視します。 +.br +(デフォルト = noignoretc, 略記 = [no]ig) +.RE +.SH 診断 +問い合わせが失敗した場合、エラーメッセージが表示されます。 +エラーには次のようなものがあります。 +.IP "Timed out" 5 +サーバに対する要求を、(\fBset timeout=\fIvalue\fR で変更できる)ある時間 +の間に(\fBset retry=\fIvalue\fR で変更できる)ある回数だけ +リトライしましたが、応答しませんでした。 +.IP "No response from server" 5 +サーバマシンでネームサーバが動いていません。 +.IP "No records" 5 +ホスト名は正しいのですが、そのホストについて現在の問い合わせに +関する情報をサーバが持っていません。 +問い合わせる情報は \fBset querytype\fP コマンドで指定できます。 +.IP "Non-existent domain" 5 +そのホスト名もしくはドメイン名が存在しません。 +.IP "Connection refused" 5 +.ns +.IP "Network is unreachable" 5 +現在のところネームサーバもしくはフィンガーサーバに対して +接続できません。 +このエラーは一般に \fBls\fP \fBfinger\fP 要求に対して起こります。 +.IP "Server failure" 5 +ネームサーバが内部でデータベースの矛盾を発見したため +正しい答えが返せませんでした。 +.IP "Refused" 5 +ネームサーバが要求に対するサービスを拒否しました。 +.IP "Format error" 5 +ネームサーバは要求パケットが適切なフォーマットになっていないと +判断しました。 +\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 作者 +Andrew Cherenson diff --git a/ja_JP.eucJP/man/man8/ntpdate.8 b/ja_JP.eucJP/man/man8/ntpdate.8 new file mode 100644 index 0000000000..8df89e0651 --- /dev/null +++ b/ja_JP.eucJP/man/man8/ntpdate.8 @@ -0,0 +1,204 @@ +''' $Header +''' +.\" 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 +は、正確な時刻を決めるために引数に与えられたホスト (複数可) の +ネットワークタイムプロトコル (Network Time Protocol) +サーバを調べることによって、 +ローカルな日付と時刻を設定します。 +これは、ローカルホストの root として起動されなければなりません。 +指定された各サーバからたくさんのサンプルを得て、 +標準の NTP 時計フィルタと選択アルゴリズムを適用し、 +その中から最良のものを選択します。 +通常 +.I ntpdate +コマンドは、ブート時の時刻を設定するために起動時スクリプト +.I /etc/rc.local +の中に挿入したり、 +.IR cron (8) +を介して時間毎に間欠的に走らせたりすることができます。 +.I ntpdate +の信頼性と正確さは、 +サーバ数が増えると劇的に改善することを覚えておいて下さい。 +単一のサーバを使っても構いませんが、 +あまり多くないにしても、 +少なくとも三つないし四つのサーバを用意すると、 +より良い性能と、 +どれかのサーバの部分的な狂いに対するより大きな抵抗性が得られます。 +.PP +.I ntpdate +は二つの方法のうちの一つで時刻の調整を行います。 +.I ntpdate +は、時計が 0.5 秒以上ずれていると判断すると、 +.IR settimeofday (2) +を呼ぶことで単に時刻を合わせ直します。 +しかし、 +誤差が 0.5 秒以内のときは、デフォルトでは、そのずれを指定して +.IR adjtime (2) +を呼ぶことで、時計の時刻を微調整します。 +後者のテクニックは、ずれが小さいときには、より滑らかな上に正確であり、 +.I ntpdate +を +.I cron (8) +で 1 〜 2 時間に一回走らせるときには、かなりうまく働きます。 +後者の方法で行う調整は、実際には、計測されたずれよりも 50% 大きくなります。 +これは、ひどくフラフラする時計をより正確に保持するのに役立つからです。 +(安定性は少し犠牲になりますが、この取り引きは大抵は有効です。) +しかしブート時には、大抵の場合、必ず合わせ直す方がいいでしょう。 +コマンドラインに +.B -b +スイッチを指定することにより、すべての場合にこれを強制することができます。 +.B -s +スイッチは、 +.I ntpdate +の動作を標準出力ではなく、 +.IR syslog (3) +ファシリティでログを取るようにします。 +これはプログラムを +.IR cron (8) +から走らせる際に便利なオプションです。 +.PP +.B -d +フラグは +.I ntpdate +が何を行うのかを、 +実際に実行させずに知るために使われます。 +一般のデバッグに便利な情報も出力されます。 +デフォルトでは、 +.I ntpdate +は、パケットを出力するときに NTPバージョン 3 の実装であると自称します。 +古いソフトウェアのいくつかはバージョン 3 の問い合わせへの返答を拒否するため、 +代わりに +.B -o +.I version +スイッチにより、 +バージョン 2 または 1 の実装として調べるように強制できます。 +.PP +.I ntpdate +が各サーバから得るサンプルの数は、 +.B -p +スイッチを使って、 1 から 8 までを設定することができます。 +デフォルトは 4 です。 +応答待ちに使われる時間は +.B -t +スイッチで設定でき、 0.2 秒の倍数に丸められます。 +デフォルトは 1 秒で、これは LAN を通じて調べるのに適当な値です。 +.PP +必要なら +.I ntpdate +は、その処理を認証します。 +.B -a +スイッチは、すべてのパケットは指定されたキー番号を使って +認証されなければならないという指定です。 +.B -k +スイッチにより、デフォルトで +.I /etc/ntp.keys +となっている、キーを読み込むファイルの名前を変更できます。 +このファイルは +.IR xntpd (8) +に記載されているフォーマットで記述されなければなりません。 +.B -e +オプションは、認証処理による遅れを秒単位で指定できます。 +(詳細は +.IR xntpd (8) +を参照して下さい。) +この値は、通常は +.I ntpdate +の用途では無視し得るほどわずかですが、 +非常に遅い CPU ではこの数を指定することで、 +時間の正確さが改善するかも知れません。 +.PP +.I ntpdate +は、同一ホスト上に NTP サーバデーモン +(例えば +.IR xntpd (8) +) +が走っているときには、時刻の設定を拒否します。 +デーモンを走らせる代わりに +.I ntpdate +を +.IR cron (8) +から定期的に走らせるときは、 +1 時間か 2 時間に一回動かせば、 +時計の合わせ直しを避けて十分正確に時刻を刻むことになるでしょう。 +.SH 関連ファイル +.nf +/etc/ntp.keys\0\0 は、 \fIntpdate\fP で使われる暗号キーを含みます。 +.fi +.SH 関連項目 +xntpd(8) +.SH 歴史 +Toronto 大学の Dennis Ferguson によって書かれました。 +.SH バグ +時計の発振子の誤差を補正して精度を高めるために用いたテクニックは +あまり出来がよくありませんが、 +もっとうまくやるためには、 +このプログラムが前回実行した時の状態を保存しておくことが必要となるでしょう。 diff --git a/ja_JP.eucJP/man/man8/ntpq.8 b/ja_JP.eucJP/man/man8/ntpq.8 new file mode 100644 index 0000000000..11c5fc2578 --- /dev/null +++ b/ja_JP.eucJP/man/man8/ntpq.8 @@ -0,0 +1,609 @@ +''' $Header +''' +.\" jpman %Id: ntpq.8,v 1.3 1997/09/21 12:35:15 seki Stab % +.\" +.\" 対訳覚え書き (seki@sysrap.cs.fujitsu.co.jp 作成) +.\" association アソシエーション +.\" association identifier アソシエーション番号 (訳しすぎか?) +.\" authentication 認証 +.\" clock 時計 +.\" dispersion ばらつき +.\" fuzzball fuzzball (固有名詞; xntpd ベースでない NTP サーバ) +.\" offset ずれ +.\" peer peer のまま +.\" poll ポーリングする +.\" query 問い合わせ +.\" reference clock 参照時計 +.\" 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 +は、 +推奨されている NTP モード 6 制御メッセージフォーマットを実装する NTP サーバに、 +現在の状態について問い合わせを行なったり、 +状態の変更を要求するために使われます。 +このプログラムは対話的モードでも、 +コマンドラインの引数を使っても走らせることができます。 +任意の変数を読み書きする要求を組み立てることができ、 +生のまま、または綺麗に整形する出力オプションがあります。 +.I ntpq +は、サーバに複数の問い合わせを送ることで、共通フォーマットにした +peer のリストを得て、出力することができます。 +.PP +.I ntpq +を実行するときに一つ以上の要求オプションがコマンドラインに含まれていれば、 +それぞれの要求は、 +コマンドラインで指定された各ホストで走っている NTP サーバ、 +またはデフォルトでは +.I localhost +で走っている NTP サーバに送られます。 +要求オプションが与えられなかった場合、 +.I ntpq +は、コマンドを標準入力から読み込み、 +コマンドラインで指定された最初のホストで走っている +NTP サーバに対して実行しようとします。 +このときも、 +ホストが指定されていないときは、デフォルトで +.I localhost +になります。 +標準入力が端末装置である場合は、 +.I ntpq +はコマンドを求めるプロンプトを出します。 +.PP +.I ntpq +は NTP サーバと通信するために、 NTP モード 6 パケットを使います。 +それゆえ、許可されていれば、 +互換のあるどんなネットワーク上のサーバにでも問い合わせることができます。 +NTP は UDP のプロトコルなので、特にネットワークトポロジ的に +遠くにある場合は、この伝達はやや信頼性に欠けるということを覚えておいて +下さい。 +.I ntpq +は、要求を再送する試みを一度行ない、 +適当な制限時間の範囲内でリモートホストから返事がなかったときは、 +その要求は時間切れとなります。 +.PP +コマンドラインオプションは以下の通りです。 +.B -i +または +.B -n +以外のコマンドラインオプションを指定すると、指定したホスト (群) に、 +指定した問い合わせ (または複数の問い合わせ) を直ちに送ることになります。 +そうでなければ +.I ntpq +は、標準入力から対話形式のコマンドを読み込もうとします。 +.Ip -c 8 +後に続く引数は、対話形式のコマンドとして解釈され、 +指定されたホスト (群) に対して実行すべきコマンドのリストに +付け加えられます。 +複数の +.B -c +オプションも与えることができます。 +.Ip -i 8 +.I ntpq +の操作を強制的に対話モードにします。標準出力にプロンプトが書き出され、 +標準入力からコマンドが読み込まれます。 +.Ip -n 8 +すべてのホストアドレスを数字四つを点で区切った形式で出力し、 +正規のホスト名に変換しません。 +.Ip -p 8 +そのサーバに知られている peer の一覧を、その状態の概要と共に出力します。 +これは、対話コマンド \*(L"peers\*(R" と同等です。 +.SH 内部コマンド +.PP +対話形式コマンドは、キーワードとそれに続く 0 個から 4 個の +引数からなります。 +キーワードの単語のうち、他に同じものがないとわかる数の文字がタイプされ +ていれば大丈夫です。コマンドの出力は、通常標準出力に出力されますが、 +コマンドラインの後に \*(L">\*(R" とファイル名をつけると、 +個々のコマンドの出力をファイルに出力することもできます。 +.PP +多くの対話形式コマンドは、 +.I ntpq +プログラム自身の中で実行されてしまい、 +サーバへ送られる NTP モード 6 リクエストとはなりません。 +この種のコマンドを以下に挙げます。 +.PP +.B ? +[ +.I command_keyword +] +.PP +単独の \*(L"?\*(R" は、 +現在の +.I ntpq +のすべてのコマンドキーワードの一覧を出力します。 +\*(L"?\*(R" の後にコマンドキーワードが続くときは、関数とコマンドの使いかた +を出力します。このコマンドは、 +.I ntpq +について、多分このマニュアルよりも良い情報源になります。 +.PP +.B timeout +.I millseconds +.PP +サーバへの問い合わせに対する応答の、制限時間の長さを指定します。 +デフォルトは、約 5000 ミリ秒です。 +.I ntpq +は制限時間が過ぎるとそれぞれの問い合わせを一回リトライするので、 +合計の待ち時間は設定された制限時間の値の 2 倍になることを覚えておいて下さい。 +.PP +.B delay +.I milliseconds +.PP +認証を必要とする要求に含めるタイムスタンプに追加すべき時間間隔を指定します。 +これは、長い遅延のあるネットワーク経路や時計が同期していない +マシン間での (信頼性の低い) サーバの再設定を可能にするために +使われます。 +実際には、サーバは、今では認証される要求のタイムスタンプを必要としません。 +そのため、このコマンドは、すたれているかもしれません。 +.PP +.B host +.I hostname +.PP +問い合わせを送るホストをセットします。 +.I hostname +はホスト名でも数値アドレスでもかまいません。 +.PP +.B poll +[ +.I # +] [ +.B verbose +] +.PP +クライアントモードで現在のサーバをポーリングします。最初の引数はポーリングする +回数 (デフォルトは 1) であり、 2 番目の引数は結果の出力をより詳しく +得るために与えることができます。 +このコマンドは、今のところ希望的観測でしかありません。 +.PP +.B keyid +.I # +.PP +このコマンドは、設定要求を認証するために用いるキー番号を指定します。 +これは、この目的で使うためにサーバに設定されているキー番号に +対応していなければなりません。 +.PP +.B passwd +.PP +このコマンドは、設定要求を認証するために使われるパスワード +(画面に表示されません) の入力を求めるプロンプトを出します。 +その要求を成功させるためには、 +このパスワードが、 +NTP サーバがこの目的で使うように設定されたキーに +対応していなければなりません。 +.PP +.B "hostnames yes|no" +.PP +\*(L"yes\*(R" が指定されると、情報を表示するときにホスト名が出力されます。 +\*(L"no\*(R" が与えられると、代わりに数値アドレスが表示されます。 +コマンドラインの +.B -n +スイッチが使われなければ、 +デフォルトは \*(L"yes\*(R" になります。 +.PP +.B raw +.PP +問い合わせコマンドに対するすべての出力を、リモートサーバから受け取った +通りに出力します。 +データに対して行なわれる唯一の整形/解釈は、印字できる +(しかしめったに理解できない) 形になるように、アスキー文字でないデータを +変換することです。 +.PP +.B cooked +.PP +問い合わせコマンドからの出力を、 \*(L"加工済み (cooked)\*(R" 形にします。 +サーバに認識された変数は、人間に使える形に再整形された値に +なります。 +.I ntpq +が、その変数は本来デコードできる値を持っていると判断したのに、 +デコードされていないものには、後に \*(L"?\*(R" が付けられます。 +.PP +.B ntpversion +.B 1|2|3 +.PP +.I ntpq +がパケットの中で自称する NTP のバージョン番号をセットします。 +デフォルトでは 3 です。 +モード 6 制御メッセージ (詳しく言うとモードも) は、 +NTP バージョン 1 には存在しなかったことに注意して下さい。 +バージョン 1 を必要とするサーバは残っていないようですが。 +.PP +.B authenticate +.B yes|no +.PP +通常、 +.I ntpq +は、 +書き込み要求でない限り要求を認証しません。 +コマンド +.B authenticate yes +は、 +.I ntpq +が生成するすべての要求に認証をつけて送るようにします。 +認証された要求は、サーバによっては少し異なって扱われます。 +もしも peer 表示を行う前に認証をオンにすると、 +時々 fuzzball の CPU を溶かしてしまうかもしれません。 +.PP +.B addvars +.IR <variable_name>[=<value>] [,...] +.B rmvars +.IR <variable_name> [,...] +.B clearvars +.PP +NTP モード 6 メッセージが運ぶデータは、次の形の +項目のリストから成ります。 +.IP "" 8 +<variable_name>=<value> +.PP +ここで、サーバの変数を読み取る要求では、この \*(L"=<value>\*(R" は +無視されるので、省略することができます。 +.I ntpq +は、制御メッセージに含まれるデータを組み立てるための内部リストを保持しており、 +以下に述べる +.B readlist +や +.B writelist +コマンドを使って送ります。 +.B addvars +コマンドで、このリストに、変数と省略可能な値を追加することができます。 +一つ以上の変数を追加するときには、リストはカンマで区切り、 +空白を含んではいけません。 +.B rmvars +コマンドは、個々の変数をリストから削除するために用い、 +.B clearlist +コマンドは、リストからすべての変数を削除します。 +.PP +.B debug +.I more|less|off +.PP +問い合わせプログラムの内部のデバッグをオンまたはオフにします。 +.PP +.B quit +.PP +.I ntpq +を終了します。 +.SH 制御メッセージコマンド +.PP +ある NTP サーバが知っている各 peer には、 +.I アソシエーション番号 +.I (association identifier) +という 16 ビット整数が割り当てられています。 +peer 変数を使う NTP 制御メッセージは、 +アソシエーション番号を含めることによって、 +その値が対応する peer を識別しなければなりません。 +0 というアソシエーション番号は特別で、 +その変数がシステム変数であることを表します。 +システム変数の名前は、独立した名前空間から取りだされます。 +.PP +制御メッセージコマンドは、 +サーバに一つ以上の NTP モード 6 メッセージを送り、 +戻ってきたデータを何らかの書式で出力します。 +現在実装されているほとんどのコマンドは、 +一つのメッセージを送って、一つの応答を受け取ります。 +今のところ例外は、必要なデータを得るためにあらかじめプログラムされた一連の +メッセージを送る +.B peers +コマンドと、 +アソシエーションをある範囲で変えながら繰り返す +.B mreadlist +と +.B mreadvar +コマンドです。 +.PP +.B associations +.PP +問い合わせ対象のサーバの規格内 (in\-spec) の peer についての、 +アソシエーション番号と peer の状態の一覧を得て出力します。 +一覧は複数の欄から成っています。 +最初の欄は、内部で使用のために 1 から振ったアソシエーションの索引番号 (index)、 +2 番目はサーバから返って来た実際のアソシエーション番号、 +3 番目は peer の状態ワードです。 +その後に、状態ワードをデコードしたデータを含む欄がいくつか続きます。 +\*(L"associations\*(R" コマンドによって返ったデータは +.I ntpq +の内部でキャッシュされるということを覚えておいて下さい。 +このため、索引番号は、 +人間にはほとんど打ち込むることができないアソシエーション番号を使う +愚かなサーバを相手にするときに役立ちます。 +すなわち、 +それ以降の任意のコマンドが引き数としてアソシエーション番号を必要とするときに、 +代わりに +.I &index +という形を使うことができます。 +.PP +.B lassocations +.PP +サーバが状態を保持しているすべてのアソシエーションについて +アソシエーション番号と peer の状態の一覧を得て、出力します。 +このコマンドと \*(L"associations\*(R" コマンドは、 +規格外 (out\-of\-spec) のクライアントのアソシエーション +の状態を保持するサーバ (つまり fuzzball) の場合にだけ異なります。 +\*(L"associations\*(R" コマンドが使われたとき、通常そういう関係は +表示から省略されますが、 \*(L"lassociations\*(R" の出力には含まれます。 +.PP +.B passociations +.PP +内部でキャッシュされたアソシエーションの一覧から、 +規格内 (in\-spec) の peer に関する +アソシエーションのデータを出力します。 +このコマンドは、新しい問い合わせをするのではなく +内部に蓄えられたデータを表示するということを除けば、 +\*(L"associations\*(R" と同じに働きます。 +.PP +.B lpassociations +.PP +規格外 (out\-of\-spec) のクライアントとのアソシエーションを含む +全てのアソシエーションに関するデータを、 +内部にキャッシュされたアソシエーションの一覧から出力します。 +このコマンドは、fuzzball を扱う場合だけ、 \*(L"passociations\*(R" と +異なります。 +.PP +.B pstatus +.I assocID +.PP +与えられたアソシエーションに対応するサーバに対し、 +状態読み取り要求を送ります。 +返された peer 変数の名前と値を出力します。 +変数の前に、ヘッダから得た状態ワードが 16 進数と下手な英語で +表示されることに注意して下さい。 +.PP +.B readvar +[ +.I assocID +] [ +.IR <variable_name>[=<value>] [,...] +] +.PP +変数読み取り要求を送ることで、指定した変数の値を返すようにサーバに要求します。 +アソシエーション番号 (assocID) を省略するか 0 を指定したならば、 +変数はシステム変数です。 +そうでなければ peer 変数であり、 +返される値は対応する peer のものとなります。 +変数のリストを省略すると、データ無しの要求を送ります。 +これは、サーバにデフォルトのディスプレイを返させます。 +.PP +.B rv +[ +.I assocID +] [ +.IR <variable_name>[=<value>] [,...] +] +.PP +.B readvar +コマンドの打ちやすい短縮形です。 +.PP +.B writevar +.I assocID +.IR <variable_name>=<value> [,...] +.PP +.B readvar +リクエストと似ていますが、 +指定した変数を読み取る代わりに書き込みます。 +.PP +.B readlist +[ +.I assocID +] +.PP +内部の変数リストの中の変数の値を返すようにサーバに要求します。 +アソシエーション番号が省略されるか 0 の場合、 +変数はシステム変数であるとみなされます。 +そうでなければ、 peer 変数として扱われます。 +内部の変数リストが空の場合は、 +要求はデータ無しで送られます。 +これは、リモートサーバにデフォルトのディスプレイを返させます。 +.PP +.B rl +[ +.I assocID +] +.PP +.B readlist +コマンドの打ちやすい短縮形です。 +.PP +.B writelist +[ +.I assocID +] +.PP +.B readlist +リクエストと似ていますが、 +内部のリストの変数を読み取る代わりに書き込みます。 +.PP +.B mreadvar +.I assocID +.I assocID +[ +.IR <variable_name>[=<value>] [,...] +] +.PP +.B readvar +コマンドと似ていますが、 +問い合わせを (0でない) アソシエーション番号の範囲のそれぞれに +行ないます。 +ここで言う範囲は、直前に実行された +.B associations +コマンドでキャッシュされたアソシエーションの一覧から決めます。 +.PP +.B mrv +.I assocID +.I assocID +[ +.IR <variable_name>[=<value>] [,...] +] +.PP +.B mreadvar +コマンドの打ちやすい短縮形です。 +.PP +.B mreadlist +.I assocID +.I assocID +.PP +.B readlist +コマンドと似ていますが、 +(0 でない) アソシエーション番号の範囲のそれぞれに問い合わせを行います。 +ここで言う範囲は、直前に実行された +.B associations +コマンドでキャッシュされたアソシエーションの一覧から決めます。 +.PP +.B mrl +.I assocID +.I assocID +.PP +.B mreadlist +コマンドの打ちやすい短縮形です。 +.PP +.B clockvar +[ +.I assocID +] +[ +.IR <variable_name>[=<value>] [,...] +] +.PP +サーバの時計変数 (clock variable) の一覧を送るように要求します。 +ラジオ時計や他の外部同期機構を持っているサーバは、 +このコマンドに肯定的に応答します。 +アソシエーション番号が省略されるか 0 だと、 +要求は \*(L"システム時計\*(R" の変数に対するものとなり、 +一般に、時計を持つすべてのサーバから肯定的な応答が得られるでしょう。 +サーバが時計を擬似的な peer として扱い、 +結果として一度に二つ以上の時計を接続することができるようになっていれば、 +適切な peer のアソシエーション番号を参照すれば +特定の時計の変数が表示されます。 +変数のリストを省略すると、サーバはデフォルトの変数のディスプレイを +返すことになります。 +.PP +.B cv +[ +.I assocID +] +[ +.IR <variable_name>[=<value>] [,...] +] +.PP +.B clockvar +コマンドの打ちやすい短縮形です。 +.PP +.B peers +.PP +サーバの規格内の peer の一覧を、各 peer の状態の概要と共に得ます。 +概要の情報には、リモート peer のアドレス、 +参照 ID (参照 IDが不明のときは 0.0.0.0)、 +リモート peer の階層 (stratum)、 +peer の種類 +(ローカル、ユニキャスト、マルチキャスト、ブロードキャストのいずれか)、 +最後のパケットを受信した時間、 +秒単位のポーリング間隔、 +8 進数表記の到達可能性レジスタ +そして、その peer に関する +(全て秒単位で) +現在の遅延の推定値、ずれ (offset)、ばらつき (dispersion) を含んでいます。 +.PP +左端の文字は、時計選択処理におけるこの peer の運命を示します。 +コードの意味は以下です: +<sp> 階層が高いか、または妥当性のチェックにより捨てられたもの; +\*(L"x\*(R" 交差アルゴリスムにより指示された誤りのチェッカ (falsticker); +\*(L".\*(R" 候補リストの最後から間引かれたもの; +\*(L"-\*(R" クラスタリングアルゴリスムにより捨てられたもの; +\*(L"+\*(R" 最終の選択セットに含まれたもの; +\*(L"#\*(R" 同期用に選択されたが隔たりが最大値を越えるもの; +\*(L"*\*(R" 同期用に選択されたもの; +\*(L"o\*(R" 同期用に選択され pps シグナル使用中のもの。 +.PP +.B peers +コマンドは、得られた応答の中の値を解析できるかどうかに依るため、 +データ形式の制御が貧弱なサーバでは、時々動作に失敗するかも +しれません。 +.PP +ホストフィールドの内容は、次の四つの型のうちの一つになります。 +ホスト名、 +IP アドレス、 +参照時計 (reference clock) の実装名とパラメタ、 +\*(L"REFCLK(<実装番号>, <パラメータ>)\*(R" のいずれかです。 +\*(L"hostnames no\*(R" が設定されているときには、 +IP アドレスだけが表示されます。 +.PP +.B lpeers +.PP +.B peers +と似ていますが、 +サーバが状態を保持しているすべてのアソシエーションの概要を出力します。 +これは fuzzball サーバの、より長い peer のリストを生成することがあります。 +.PP +.B opeers +.PP +古い型の \*(L"peers\*(R" コマンドで、 +参照 ID がローカルのインタフェースアドレスになります。 +.SH 歴史 +.PP +Toronto 大学の Dennis Ferguson によって書かれました。 +.SH バグ +.PP +.B peers +コマンドは不可分 (atomic) ではないため、 +不正なアソシエーションという誤ったエラーメッセージが発生し +コマンドが終了することがあります。 +.PP +時間切れまでの時間は固定された定数です。 +これは、ある種の最悪の場合を考えてあるため、 +時間切れになるまで長時間待たされることになります。 +このプログラムは、 +特定のホストへ何回も問い合わせを送る間に +制限時間の見積もりを改善すべきですが、 +実際には行なっていません。 diff --git a/ja_JP.eucJP/man/man8/ntptrace.8 b/ja_JP.eucJP/man/man8/ntptrace.8 new file mode 100644 index 0000000000..3c373f727e --- /dev/null +++ b/ja_JP.eucJP/man/man8/ntptrace.8 @@ -0,0 +1,108 @@ +''' $Header +''' +.\" 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 +は、与えられた +ネットワークタイムプロトコル (NTP) サーバが +どこから時刻を取得するのかを決定し、 +NTP サーバの連鎖をたどってマスタ時刻ソースまで戻ります。 +引数が与えられなかったときは、 ``localhost'' から始めます。 +.PP +以下は、 +.I ntptrace +の出力の例です。 +.RS 2 +.nf + +% 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 +各行のフィールドは (左から右へ): +ホスト名、ホストの階層 (stratum)、 +そのホストとローカルホストの間の時刻のずれ (offset) +( +.I ntptrace +によって測定されたもの; これが ``localhost'' に対して +いつも 0 になるとは限らない理由です) 、 +ホストの ``同期距離'' (synch distance)、 +そして、(階層が 1 のサーバのみですが) 参照時計 ID。 +すべての時間は秒単位です。 +(同期距離というのは、時計の時刻の良さの測度です。) +.SH オプション +.IP "\-d" 5 +デバッグ出力をオンにします。 +.IP "\-n" 5 +ホスト名の印刷をオフにします; 代わりに、ホストの IP アドレスが +使われます。これは、ネームサーバが落ちているときに必要になるかも +しれません。 +.IP "\-r retries" 5 +各ホストに対する再送信の回数をセットします。デフォルト = 5。 +.IP "\-t timeout" 5 +再送信の制限時間 (秒単位) をセットします。デフォルト = 2。 +.IP "\-v" 5 +NTP サーバについての詳細な情報を出力します。 +.SH 関連項目 +xntpd(8), xntpdc(8) +.SH バグ +このプログラムは、複数の標本を取って正確さを増すような試みをしません。 diff --git a/ja_JP.eucJP/man/man8/pac.8 b/ja_JP.eucJP/man/man8/pac.8 new file mode 100644 index 0000000000..b79117e977 --- /dev/null +++ b/ja_JP.eucJP/man/man8/pac.8 @@ -0,0 +1,106 @@ +.\" Copyright (c) 1983, 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. +.\" +.\" 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. +.\" +.\" @(#)pac.8 8.1 (Berkeley) 6/6/93 +.\" jpman %Id: pac.8,v 1.2 1997/05/03 13:43:12 horikawa Stab % +.\" +.Dd June 6, 1993 +.Dt PAC 8 +.Os BSD 4.2 +.Sh 名称 +.Nm pac +.Nd プリンタ/プロッタのアカウンティング情報 +.Sh 書式 +.Nm pac +.Op Fl P Ns Ar printer +.Op Fl c +.Op Fl m +.Op Fl p Ns Ar price +.Op Fl s +.Op Fl r +.Op Ar name ... +.Sh 解説 +.Nm pac +は、プリンタ/プロッタのアカウンティングファイルを読み、 +各ユーザが消費した紙の枚数 (通常の場合) や長さ (ラスタデバイスの場合) +の累計を計算し、各ユーザがどれだけ紙を使ったかを計算し、ページ数や紙の +長さや金額で表示します。 +.Pp +オプションおよびオペランドとしては以下のものがあります: +.Bl -tag -width PPprinter +.It Fl P Ns Ar printer +指定したプリンタでのアカウンティングを見ます。 +これをつけない場合は、デフォルトのプリンタ (サイト依存) か、 +環境変数 +.Ev PRINTER +の値が使われます。 +.It Fl c +出力を金額でソートします。通常の場合、 +出力は名前のアルファベット順にソートされます。 +.It Fl m +アカウンティングファイル内のホスト名部分を無視します。 +これにより、1 人のユーザが複数のマシン上から出力した分の料金 +をひとまとめにすることができます。 +.It Fl p Ns Ar price +単価をデフォルトの値 0.02 や +.Pa /etc/printcap +で指定した値のかわりに +.Ar price +にします。 +.It Fl r +逆順にソートします。 +.It Fl s +アカウント情報が要約され、要約したアカウントファイルに登録されます; +多忙なシステム上では、アカウントファイルが 1 日に何行も +増えるため、この要約が必要となります。 +.It Ar names +.Ar name +のユーザのみについて統計をとります; 通常は紙を使用 +したすべてのユーザの統計をとります。 +.El +.Sh 関連ファイル +.Bl -tag -width /var/account/?_sum -compact +.It Pa /var/account/?acct +未加工のアカウントファイル +.It Pa /var/account/?_sum +要約されたアカウントファイル +.It Pa /etc/printcap +プリンタの特徴を記述したデータベース +.El +.Sh 関連項目 +.Xr printcap 5 +.Sh バグ +計算した料金と実際の値との関係はまだわかっていません。 +.Sh 歴史 +.Nm +コマンドは +.Bx 4.0 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/pccardd.8 b/ja_JP.eucJP/man/man8/pccardd.8 new file mode 100644 index 0000000000..344191dfea --- /dev/null +++ b/ja_JP.eucJP/man/man8/pccardd.8 @@ -0,0 +1,154 @@ +.\" +.\" Copyright (c) 1994 Andrew McRae. 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. 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: pccardd.8,v 1.4.2.2 1997/10/08 07:33:51 charnier Exp % +.\" jpman %Id: pccardd.8,v 1.4 1997/07/26 22:04:06 horikawa Stab % +.\" +.Dd November 1, 1994 +.Dt PCCARD 8 +.Os FreeBSD +.Sh 名称 +.Nm pccardd +.Nd PC-CARD (PCMCIA) 管理デーモン +.Sh 書式 +.Nm pccardd +.Op Fl d +.Op Fl v +.Op Fl f Ar configfile +.Sh 解説 +.Nm +は、普通ブート時に始動され、 PC-CARD カードの抜き差しを管理します。 +.Pp +実行されると、 +.Nm +は (デフォルト名が +.Pa /etc/pccard.conf +の) 設定ファイルを読み込み、カードのために利用可能な PC-CARD スロット +をスキャンします。 +.Nm +は、その後、例えば新しいカードの挿入やカードの取り外しのような、 +.Em "カードイベント" +を待ちます。 +.Pp +カードが挿入された時、以下のような動作が行われます。 +.Bl -enum +.It +カーネルドライバはカードの挿入を検出し、カードに電源を供給します。 +.It +.Nm +は、 +.Em CIS +データをカードの属性メモリから読み込み、製造社名とカードの +バージョンを設定ファイルのカード記述と照合します。 +.It +マッチするものが見付かると、ドライバが割り当てられます。 +.It +ひとたび自由なドライバとデバイス実体が割り当てられると、 +.Nm +は (必要であれば) ISA メモリブロックや入出力ポートのような資源を +共通の資源から割り当てます。 +.It +PC-CARD スロットは、割り当てられた I/O とメモリコンテキストによって +設定され、カーネルドライバがカードに割り当てられます。 +.It +割当が成功すると、例えばネットワークインターフェースを設定するための +.Xr ifconfig 8 +等のような +特定のシェルコマンドがデバイスを設定するために実行されます。 +それぞれ別々のコマンドを各カード・ドライバ・デバイスのために指定して良く、 +その順序で実行されます。 +.El +.Pp +.Nm +がカードの除去を発見した時には、以下の一連の操作が実行されます。 +.Bl -enum +.It +カード除去に対して割り当てられたシェルコマンドが実行されます。 +これは、除去されたカードに割り当てられたどんなデバイスも +リセットしようとします。 +それぞれ別々のコマンドを各カード・ドライバ・デバイスのために指定して良いです。 +.It +PC-CARD スロット資源は解放されます。 +.El +.Pp +ひとたびカード/ドライバ実体が設定されると、 +その実体に割り当てた資源を憶えておきます。 +そして、カードが取り外され再び挿入された場合、 +同じドライバを割り当てます。この主な理由は、一度ドライバがカードに +割り当てられると、ドライバの +.Fn 検査 (prove) +ルーチンが呼ばれ、 +ドライバ固有のデータ領域は +カードに割り当てられた I/O ポートやメモリ資源によって初期化されるからです。 +大多数のドライバは、ハードウエアから関連を解消されたり、その後で再び +違うパラメータで再割当されるように設計されていません。 +これは、読み込み可能カーネルモジュールがサポートされた時に大きく変わ +るでしょう。 +.Pp +.Nm +が理解する実行時オプションは以下の通りです。 +.Bl -tag -width Ds +.It Fl d +デーモンとして実行せず、フォアグランドジョブとして実行し、 +エラーメッセージを表示します。 +.It Fl v +設定ファイルを読み込んだ後で、そのまとめを出力します。 +.It Fl f Ar configfile +デフォルト設定ファイル +.Pa /etc/pccard.conf +とは異なった設定ファイルを指定します。 +ファイルの形式は、 +.Xr card.conf 5 +に詳細に記述されていますし、 +.Nm +によって認識される PC-CARD カードがリストされています。 +また、カードへのインタフェースとして使われるカーネルドライバと +デバイスについても詳細に書かれています。 +.Pp +.Sh 関連ファイル +.Bl -tag -width /etc/pccard.conf -compact +.It Pa /etc/pccard.conf +.El +.Sh 関連項目 +.Xr pccard.conf 5 , +.Xr ifconfig 8 +.Sh 作者 +.An Andrew McRae Aq andrew@mega.com.au +によって開発されました。 +.Sh バグ +.Nm +はカードのパラメータを設定することができますが、 +特定のドライバがカードと動作することを保証しません。 +.Pp +.Nm FreeBSD +は、現在読み込み可能カーネルモジュールをサポートしていないため、 +設定ファイル中のすべての +.Em irq +設定は、カーネルの +.Nm config +エントリにマッチする必要が有ります。 +.Pp +システム資源 (例えばネットワークマウントされているファイルシステム) が +カードに関連している場合は、カードを取り外すと問題が起こるかも知れません。 diff --git a/ja_JP.eucJP/man/man8/pciconf.8 b/ja_JP.eucJP/man/man8/pciconf.8 new file mode 100644 index 0000000000..cfe2f7312d --- /dev/null +++ b/ja_JP.eucJP/man/man8/pciconf.8 @@ -0,0 +1,176 @@ +.\" %Id: pciconf.8,v 1.3.2.1 1997/10/08 10:33:10 obrien Exp % +.\" Copyright (c) 1997 +.\" Stefan Esser <se@freebsd.org>. 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. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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. +.\" +.Dd February 7, 1997 +.Dt PCICONF 8 +.Os FreeBSD +.Sh 名称 +.Nm pciconf +.Nd PCI バスのための診断ユーティリティ +.Sh 書式 +.Nm pciconf Fl l +.Nm pciconf Fl r Ar selector +.Op Fl b | Fl h +.Ar reg +.Nm pciconf Fl w Ar selector +.Op Fl b | Fl h +.Ar reg value +.Sh 解説 +.Nm +コマンドは、 +.Pa /dev/pci +の +.Xr ioctl 2 +インタフェースにより提供されている機能への +コマンドラインインタフェースを提供します。 +.Fl l +オプションを付けると、ブート時のプローブにより見つかったすべてのデバイスを +以下の書式で表示します: +.Bd -literal +pci0:4:0: class=0x010000 card=0x00000000 chip=0x000f1000 rev=0x01 hdr=0x00 +pci0:5:0: class=0x000100 card=0x00000000 chip=0x88c15333 rev=0x00 hdr=0x00 +pci0:6:0: class=0x020000 card=0x00000000 chip=0x802910ec rev=0x00 hdr=0x00 +.Ed +.Pp +最初の欄は、このコマンドの他の書式で直接使えるような形で +.Ar セレクタ +を表示します。 +2 番目の欄はクラスコードで、2 桁の 16 進数で表されるクラスバイトと +サブクラスバイト、インタフェースバイトからなります。 +3 番目の欄は +.Tn PCI +規格のリビジョン 2.1 で導入されたサブベンダ ID レジスタの内容です。 +今日のほとんどの +.Tn PCI +カード (2.0) ではこれは 0 となりますが、新しく開発された +.Tn PCI +カードではそのカード固有の識別コード (unique card identification +code) が入れられます。この値は上位 2 バイトのカード ID と、 +下位 2 バイトのカードベンダ ID から構成されます。 +.Pp +4 番目の欄にはこのカードがどのチップに基づいているか識別する +チップデバイス ID が含まれます。この値は上記と同様に二つの +フィールドに分けられ、チップとベンダを識別します。 +5 番目の欄はチップのリビジョンを表示します。 +6 番目の欄はヘッダタイプを示します。 +現在割り当てられているヘッダタイプは +.Tn PCI +- +.Tn PCI +ブリッジのチップが 1 となる以外はすべて 0 となります。 +ヘッダタイプレジスタが 0 となっている +.Tn PCI +デバイスの最上位ビットがセットされていると、そのデバイスは +.Em 多機能 (multi-function) +デバイスであり、ひとつのチップにいくつかの (似たものかもしれないし、 +まったく異なるものかもしれない) 機能を備えています。 +.Pp +.Fl l +オプションは root ではないユーザが使うことのできる唯一のものです。 +.Nm +を他の方法で実行するには +.Li pci Ns Va bus Ns \&: Ns Va device +(オプションで +.Li \&: Ns Va function +が続きます) という形式で +.Ar セレクタ +を指定する必要があります。 +最後にコロンを付けても構いませんが無視されますので、 +.Nm +.Fl l +の出力の最初の欄をそのまま使うことができます。 +すべての番号は 10 進数で表します。 +.Pp +.Fl r +オプションはデバイス +.Ar selector +のバイトオフセット +.Ar reg +の所のコンフィギュレーションスペースレジスタ +(configuration space register) を読み取り、 +その値を 16 進数で表示します。 +.Fl w +オプションはデバイス +.Ar selector +のバイトオフセット +.Ar reg +の所のコンフィギュレーションスペースレジスタへ +.Ar value +を書き込みます。 +この二つのオプションでは、 +.Fl b +フラグと +.Fl h +フラグで読み書きの大きさを指定できます。 +.Fl b +は 1 バイトの読み書きを行い、 +.Fl h +は 2 バイト (halfword) の読み書きを行います。 +読み書きの大きさのデフォルトは 4 バイト (longword) です。 +.Sh 関連項目 +.Xr ioctl 2 , +.\" .Xr pci 4 , +.Xr modload 8 +.Sh 歴史 +.Nm +コマンドは +.Fx 2.2 +で初めて登場しました。 +.Fl a +オプションは +.Tn PCI +LKM サポートのために +.Fx 3.0 +で追加されました。 +.Sh 作者 +.Nm +は +.An Stefan Esser +と +.An Garrett Wollman +によって書かれました。 +.Sh バグ +.Fl b +オプションと +.Fl h +オプションは +.Nm +の内部で実装されており、 +.Fn ioctl +に基づいているわけではありません。 +.Pp +root ではないユーザが +.Fl a +オプションと +.Fl r +オプションを使うことを許可することは有用かもしれませんが、 +LKM ドライバでデバイスを供給するために +.Nm modload +を実行できるのは root だけでしょうし、 +一部の粗悪な +.Tn PCI +チップではコンフィギュレーションスペースレジスタの +読み込みが故障を引き起こす場合があるのです。 diff --git a/ja_JP.eucJP/man/man8/ping.8 b/ja_JP.eucJP/man/man8/ping.8 new file mode 100644 index 0000000000..15b6dd80b1 --- /dev/null +++ b/ja_JP.eucJP/man/man8/ping.8 @@ -0,0 +1,400 @@ +.\" Copyright (c) 1985, 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. +.\" +.\" 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. +.\" +.\" @(#)ping.8 8.2 (Berkeley) 12/11/93 +.\" %Id: ping.8,v 1.3.2.6 1997/09/14 19:40:03 jkh Exp % +.\" jpman %Id: ping.8,v 1.3 1997/10/11 08:00:36 horikawa Stab % +.\" +.Dd March 1, 1997 +.Dt PING 8 +.Os BSD 4.3 +.Sh 名称 +.Nm ping +.Nd +.Tn ICMP ECHO_REQUEST +パケットをネットワーク上のホストへ送る +.Sh 書式 +.Nm +.Op Fl QRadfnqrv +.Op Fl c Ar count +.Op Fl i Ar wait +.Op Fl l Ar preload +.Op Fl p Ar pattern +.Op Fl s Ar packetsize +.Bo +.Ar host | +.Op Fl L +.Op Fl I Ar interface +.Op Fl T Ar ttl +.Ar mcast-group +.Bc +.Sh 解説 +.Nm +は、 +.Tn ICMP +の +.Tn ECHO_REQUEST +データグラムを用いて、指定したホストやゲートウェイ +からの +.Tn ICMP ECHO_RESPONSE +を引き出します。 +.Tn ECHO_REQUEST +データグラム ( +.Pq Dq ping +) には IP および +.Tn ICMP +ヘッダ、 +.Dq struct timeval +、パケットの残りを埋める適当な数の +.Dq pad +バイトが順にあります。 +オプションは以下の通りです: +.Bl -tag -width Ds +.It Fl a +聴覚モード。パケットを受け取った時に、出力にベル +.Pq ASCII 0x07 +文字を +含みます。このオプションは、別形式のオプションがある場合は無視されます。 +.It Fl c Ar count +.Tn ECHO_RESPONSE +パケットを +.Ar count +回送出 +.Pq そして受信 +してから終了します。 +.It Fl d +使用する socket に +.Dv SO_DEBUG +オプションを設定します。 +.It Fl f +.Tn ECHO_REQUEST +ping を垂れ流します。 +パケットが返って来るとすぐ、もしくは 100 分の 1 秒に 1 回のいずれか多い回数だけ +パケットを出力します。 +.Tn ECHO_REQUEST +パケットを送るたびに +.Dq \&. +が表示され、 +.Tn ECHO_REPLY +パケットを受信するたびにバックスペースが表示されます。 +これによりどれだけのパケットが欠落したのかをすばやく表示することができます。 +スーパユーザのみ使用可能です +.Bf -emphasis +このオプションはネットワークに非常に負荷をかけるので、注意して使用する +必要があります。 +.Ef +.It Fl i Ar wait +.Ar wait +で指定した秒数だけパケットの送出間隔を空けます。 +デフォルトでは送出間隔は 1 秒です。このオプションは +.Fl f +オプションとは同時に指定できません。 +.It Fl I Ar interface +与えられたインタフェースアドレスに対して、マルチキャストパケットを +送ります。このフラグは、 ping の宛先アドレスがマルチキャストアドレスの +場合だけに適用できます。 +.It Fl l Ar preload +指定した +.Ar preload +値だけ +.Tn ECHO_REQUEST +パケットを出来るだけ速く送信し、通常の動作に戻ります。 +スーパユーザのみがこのオプションを使用できます。 +.It Fl L +マルチキャストパケットのループバックを抑制します。 +このフラグは、宛先アドレスがマルチキャストアドレスの場合だけ +適用できます。 +.It Fl n +数値のみ出力します。ホストアドレスに対する名前を調べるようなことは +しません。 +.It Fl p Ar pattern +送出するパケットを埋める +.Dq pad +バイトを指定します。 +.Dq pad +バイトは +16 バイトを上限とします。 +これはネットワーク上でデータ依存の問題を診断するときに有効です。たとえば +.Dq Li \-p ff +は全て 1 の送出パケットを生成します。 +.It Fl Q +いくらか静かな出力にします。 +自己が行なった問い合わせに対しての応答に含まれる +ICMP エラーメッセージは表示されません。 +もともとは、 +.Fl v +オプションがそのようなエラーを表示するために必要でしたが、 +.Fl v +オプションは全ての ICMP エラーメッセージを表示します。忙しい機械上では、 +この出力は更に負荷になるでしょう。 +.Fl Q +オプションを指定しないと、 +.Nm +は、 +自己の ECHO_REQUEST メッセージに起因する ICMP エラーメッセージを表示します。 +.It Fl q +出力を抑制します。開始時と終了時の要約行しか表示しません。 +.It Fl R +指定ホストまでの到達経路を記録します。 +.Tn ECHO_REQUEST +パケット中に +.Tn RECORD_ROUTE +オプションをつけ、返送パケット上の経路バッファを表示します。IP ヘッダには +経路を 9 個収める大きさしかないことに注意してください; +特定の宛先に対してパケットを経路づけるには、通常 +.Xr traceroute 8 +コマンドを使う方が良いでしょう。 +多くのホストは +.Tn RECORD_ROUTE +オプションを無視するか捨てます。 +.It Fl r +通常のルーティングテーブルを無視し、 +直接接続されているネットワーク上のホストに対して送信します。 +指定接続されたネットワーク上にホストが存在しない場合には、エラーが返されます。 +このオプションは経路情報を持たないインタフェースを経由してローカル +ホストに ping をかけるのに用いられます +.Po +たとえばインタフェースが +.Xr routed 8 +によってドロップされた後 +.Pc +。 +.It Fl s Ar packetsize +送出するデータのバイト数を指定します。 +デフォルトでは 56 バイトです。 +これは +.Tn ICMP +ヘッダデータの 8 バイトと合せて 64 +.Tn ICMP +バイトになります。 +.It Fl T Ar ttl +マルチキャストパケットの IP 寿命時間 (Time To Live) を設定します。 +このオプションは、宛先アドレスがマルチキャストアドレスの場合だけ +適用できます。 +.It Fl v +冗長出力を有効にします。 +.Tn ECHO_RESPONSE +以外の受信 +.Tn ICMP +パケットも表示されます。 +.El +.Pp +問題の切り分けのために +.Nm +を用いるにはローカルインタフェースが up かつ running であることを +確認するため、まずローカルホスト上で実行します。 +その後により遠くのホストやゲートウェイに +.Dq ping +します。 +経路周回時間 (round trip time) と消失パケットの統計が計算されます。 +重複したパケットが受信された場合、そのパケットは消失パケットの計算には +含まれませんが、経路周回時間の統計の計算には +使われます。 +指定されたパケットの数が送信され +.Pq 受信され +たとき、もしくはプログラムが +.Dv SIGINT +で終了した場合、簡単な要約が表示されます。 +要約は、送出したパケット数、受信したパケット数、そして +経路周回時間の最小/最大/平均/分散です。 +.Pp +このプログラムは主にネットワークのテスト、計測、管理に用いられことを +想定しています。 +.Nm +はそれ自体ネットワークに負荷をかけるので、トラブルのないときや自動スクリ +プトで用いることは勧められません。 +.Sh ICMP パケットの詳細 +オプションなしの IP ヘッダは 20 バイトです。 +.Tn ICMP +.Tn ECHO_REQUEST +パケットはさらなる 8 バイトの +.Tn ICMP +ヘッダとそれに続く任意の大きさのデータからなっています。 +この大きさは +.Ar packetsize +によって指定されます +.Pq デフォルトでは 56 バイトです +。 +このように受信した IP パケット内の +.Tn ICMP +.Tn ECHO_REPLY +データ量は常に指定されたデータ +.Pq Tn ICMP ヘッダ +の大きさよりも 8 バイト大きくなります。 +.Pp +データ領域が少なくとも 8 バイトあるとき、 +.Nm +は最初の 8 バイトを経路周回時間の計算に用いるタイムスタンプを書くために +用います。指定された pad の大きさが 8 バイトより小さい場合経路周回時間は +得られません。 +.Sh 重複パケットと障害パケット +.Nm +は重複パケットと障害パケットを報告します。重複パケットは +ユニキャストアドレスに対しては起こるはずのないものですが、 +リンク層での不適切な再送信によって引き起こされるようです。 +重複は様々な状況で起こる可能性があります。低いレベルの重複の存在は +必ずしも警告にならないかもしれませんが、よい兆候ではありません。 +ブロードキャストもしくは +マルチキャストアドレスに ping する時には、重複が起こることが期待されます。 +実際に重複するのではなく、 +異ったホストから同じ要求に対して応答が行われからです。 +.Pp +障害を受けたパケットは明らかに重大な警告です。多くの場合、 +.Nm +パケットの経路のどこか(ネットワーク内かホスト内)のハードウェアの故障が +考えられます。 +.Sh 異なったデータパターンの試行 +(インター)ネットワーク層はデータ部分に含まれるデータによってパケットの扱い +を変えません。不幸にもデータ依存性の問題がネットワークに侵入し長い間検知さ +れないままとなる可能性が知られています。多くの場合、問題を引き起こす特殊 +なパターンはたとえば全部 1 や全部 0 のようなもの、あるいは右端以外が 0 +であるような十分な +.Dq 遷移 +を持たないものです。コマンドラインで(たとえば) +全部 0 のデータパターンを指定するだけでは不十分かもしれません。なぜな +ら問題のパターンはデータリンク層にあり、コマンドラインで指定したものと +コントローラが送信するものとの間の関係は複雑だからです。 +.Pp +このことはデータ依存性が問題となるとき、それを見付けるために多くのテストをし +なければならないということを意味します。運がよければ、あるネットワーク +を通して送れない、あるいは同じような長さのファイルよりもずっと長時間かか +るファイルを見付けることができるかもしれません。この場合、そのファイル +を調べ繰り返し現われるパターンを +.Nm +の +.Fl p +オプションを使ってテストできます。 +.Sh TTL の詳細 +IP パケットの +.Tn TTL +値はパケットが捨てられずに通過できる IP ルータの最大数を表わ +します。今のところインターネット上の各ルータは +.Tn TTL +フィールドをちょうど 1 だけ減らすと期待できます。 +.Pp +.Tn TCP/IP +の仕様では +.Tn TCP +パケットの +.Tn TTL +フィールドを 60 にすべきだとなっていますが、多くのシステムは +もっと小さい値を用いています +.Po +.Bx 4.3 +では 30、 +.Bx 4.2 +では 15 を用いています +.Pc +。 +.Pp +このフィールドに許される最大値は 255 です。 +そして多くの Unixシステムでは +.Tn ICMP ECHO_REQUEST +パケットの +.Tn TTL +フィールドを 255 にしています。これが +.Pq ping +は出来るのに +.Xr telnet 1 +や +.Xr ftp 1 +で入れないホストが発生する理由です。 +.Pp +通常 ping は受け取ったパケットの ttl 値を出力します。リモートシステム +が ping パケットを受け取るとき、その応答における +.Tn TTL +フィールドに関し以下の 3 つのうちの 1 つを行なうことができます。 +.Bl -bullet +.It +変更しない;これは +.Bx 4.3 tahoe +リリース前の +.Tn BSD +システムが行なっていたことです。 +この場合、受け取ったパケット中の +.Tn TTL +値は 255 から周回経路におけるルータの数を引いた数です。 +.It +255 にセットする; これは現在の Berkley Unix システムが行なっている +ことです。この場合、受け取ったパケット中の +.Tn TTL +値は 255 から、リモートシステム +.Em から +.Nm +.Em している +ホスト +.Em まで +の経路におけるルータの数を引いた数となります。 +.It +ある他の値にセットする。マシンによっては +30 あるいは 60 のような +.Tn TCP +パケットで用いるのと同じ値を +.Tn ICMP +パケットに使います。また全く異なる値を用いるマシンもあるかもしれません。 +.El +.Sh 戻り値 +.Nm +コマンドは、指定した +.Ar host +から少なくとも 1 回の応答を受信した場合、終了値 0 を返します; +送出は成功したものの応答を受信できない場合は 2 を返します; +エラーが発生した場合は、他の値 +.Pq Aq Pa sysexits.h +が返されます。 +.Sh 関連項目 +.Xr netstat 1 , +.Xr ifconfig 8 , +.Xr routed 8 , +.Xr traceroute 8 +.Sh 歴史 +.Nm +コマンドは +.Bx 4.3 +から登場しました。 +.Sh 作者 +オリジナルの +.Nm +コマンドは、 +Mike Muuss が US Army Ballistics Research Laboratory にて記述しました。 +.Sh バグ +多くのホストやゲートウェイは、 +.Tn RECORD_ROUTE +オプションを無視します。 +.Pp +最大IPヘッダ長は、 +.Tn RECORD_ROUTE +オプションを付加するには小さ過ぎます。しかしながら、これについては出来 +ることは多くありません。 +.Pp +ping を垂れ流しにするのは、一般に勧められません。特に +ブロードキャストアドレスに対して ping の垂れ流しを行なうのは、 +きちんと条件を整えた場合においてのみにとどめるべきです。 diff --git a/ja_JP.eucJP/man/man8/portmap.8 b/ja_JP.eucJP/man/man8/portmap.8 new file mode 100644 index 0000000000..164aba3cac --- /dev/null +++ b/ja_JP.eucJP/man/man8/portmap.8 @@ -0,0 +1,109 @@ +.\" Copyright (c) 1987 Sun Microsystems +.\" Copyright (c) 1990, 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. +.\" +.\" 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. +.\" +.\" @(#)portmap.8 8.1 (Berkeley) 6/6/93 +.\" jpman %Id: portmap.8,v 1.2 1997/03/31 14:54:58 horikawa Stab % +.\" +.Dd June 6, 1993 +.Dt PORTMAP 8 +.Os BSD 4.3 +.Sh 名称 +.Nm portmap +.Nd +.Tn RPC +プログラムおよびバージョンと +.Tn DARPA +ポート番号とのマップを行なう +.Sh 書式 +.Nm portmap +.Op Fl d +.Op Fl v +.Sh 解説 +.Nm +は、 +.Tn RPC +プログラム番号を +.Tn DARPA +プロトコルポート番号に変換するサーバです。 +.Tn RPC +呼び出しを用いる場合には、このプログラムを起動させなければなりません。 +.Pp +.Tn RPC +サーバが起動すると、 +.Tn RPC +サーバは +.Nm +にそのサーバが受信を待機しているポート番号とサーバの +.Tn RPC +プログラム番号を教えます。クライアントがプログラム番号を指定して +.Tn RPC +呼びだしを行なった場合、クライアントはサーバマシンの +.Nm +とコンタクトをとり、 +.Tn RPC +パケットを送出すべきポート番号を決定します。 +.Pp +.Nm +は、 +.Tn RPC +サーバが起動される前に開始される必要があります。 +.Pp +通常、 +.Nm +は、他のデーモンと同じように、起動された端末の動作には影響されません。 +.Nm +は、 +.Xr syslog 3 +を用いてエラーを記録します。 +.Pp +以下のオプションが使用可能です: +.Bl -tag -width Ds +.It Fl d +.Nm +をデーモンとして動作させるのを回避します。そして、エラーおよび +デバッグ情報を標準エラー出力に出力させます。 +.It Fl v +アクセスコントロールチェックに関する冗長なログを取ります。 +.El +.Sh 関連項目 +.Xr inetd.conf 5 , +.Xr inetd 8 , +.Xr rpcinfo 8 +.Sh バグ +.Nm +プロセスが異常終了した場合、関連する全てのサーバを再起動 +しなくてはなりません。 +.Sh 歴史 +.Nm +コマンドは +.Bx 4.3 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/ppp.8 b/ja_JP.eucJP/man/man8/ppp.8 new file mode 100644 index 0000000000..1824a47d12 --- /dev/null +++ b/ja_JP.eucJP/man/man8/ppp.8 @@ -0,0 +1,2222 @@ +.\" %Id: ppp.8,v 1.19.2.32 1997/10/05 14:28:27 brian Exp % +.\" jpman %Id: ppp.8,v 1.4 1997/06/08 18:41:58 saeki Stab % +.Dd 20 September 1995 +.Os FreeBSD +.Dt PPP 8 +.Sh 名称 +.Nm ppp +.Nd +PPP (Point to Point Protocol) (別名 iijppp) +.Sh 書式 +.Nm +.Op Fl auto | background | ddial | direct | dedicated +.Op Fl alias +.Op Ar system +.Sh 解説 +本プログラムは、ユーザプロセスとして動作する +.Em PPP +パッケージです。 +.Em PPP +は通常、(pppd でそうなっているように) カーネルの一部として実装されますが、 +そのため、デバッグや動作の変更が少々難しい場合があります。 +しかしながら、この実装ではトンネルデバイス (tun) を利用して、ユーザプロセスで +.Em PPP +を実現しています。 + +.Sh 主な特徴 + +.Bl -diag +.It 対話的なユーザインターフェースを提供 +コマンドモードで利用する場合、ユーザがコマンドを +入力することで、簡単にリモートコンピュータとの接続の確立や接続状態の確認、 +接続の解放を行なうことができます。 +オプションとして、セキュリティ確保のために +すべての機能をパスワードで保護することができます。 + +.It 手動と自動でのダイアルをサポート +対話モードでは、直接モデムと通信できるように +.Dq term +コマンドが用意されています。 +モデムがリモートホストと接続されて、 +.Em PPP +での通信が始まったら、 +.Em PPP +はそれを検出して自動的にパケットモードに移行します。 +ひとたびリモートホストとの接続に必要なコマンドシーケンスがわかったら、 +後々の接続を簡単にするため、必要なダイアル手順やログイン手順を定義した +チャットスクリプトを書くことができます。 + +.It オンデマンドでのダイアルアップをサポート +auto モード (自動モード) では +.Nm +はデーモンとして動作し、 +.Em PPP +リンクを通して送られるパケットを待ちうけます。 +パケットを検出すると、デーモンが自動的にダイアルを行なって接続を確立します。 + +ddial モード (専用モードまたはデーモンダイアルモード) でも +ほぼ同様に、自動ダイアルと接続の確立を行ないます。 +しかしながらこのモードは、送るべきパケットが存在しない場合にも、 +リンクが切れていることを検出するといつでもリモートへダイアルするという点が +auto モードと異なります。 +このモードは、電話料金よりも常時接続されていることが重視される場合に有用です。 + +.It パケットエイリアシングをサポート +一般には IP マスカレードとして知られるパケットエイリアシングにより、 +未登録でプライベートなネットワーク上のコンピュータからも +インターネットにアクセスすることが可能です。 +.Em PPP +ホストはマスカレードゲートウェイとして動作します。 +送信パケットの IP アドレスと TCP や UDP のポート番号は +どちらもエイリアスされ、返信パケットではエイリアスが元に戻されます。 + +.It バックグラウンド PPP 接続をサポート +バックグラウンドモードでは、接続を確立するのに成功した場合に +.Nm +はデーモンになります。 +それ以外の場合はエラーで終了します。 + +.It サーバとしての PPP 接続をサポート +ダイレクトモードでは、 +.Nm +は標準入力/標準出力からの +.Em PPP +接続を受け入れるサーバとして動作させることができます。 + +.It PAP と CHAP による認証をサポート + +.It 代理 arp (Proxy Arp) をサポート +.Em PPP +がサーバとして動作している時、その接続について代理 arp を行なうよう +設定できます。 + +.It パケットのフィルタリングをサポート +ユーザは 4 種類のフィルタを定義できます。 +.Em ifilter +は受信パケットに対するフィルタです。 +.Em ofilter +は送信パケットに対するフィルタです。 +.Em dfilter +はダイアルを行なうきっかけとなるパケットを定義するフィルタで、 +.Em afilter +は接続を保持するためのパケットを定義するフィルタです。 + +.It トンネルドライバは bpf (Berkeley Packet Filter) をサポート +.Em PPP +リンクを流れるパケットを調べるために、 +.Xr tcpdump 1 +を使うことができます。 + +.It PPP over TCP をサポート + +.It IETF ドラフトの Predictor-1 圧縮をサポート +.Nm +は VJ 圧縮の他に Predictor-1 圧縮もサポートしています。 +モデムは通常 (たとえば v42.bis のような) 組み込みの圧縮機能を持っており、 +その結果システムは +.\"(訳注)「転送データレートよりも」をここにいれたいと考えています。 +.\" 2.2.1R 対象(1997/04/02) Takeshi MUTOH <mutoh@info.nara-k.ac.jp> +より高いデータレートで通信できます。 +これは一般には良いことですが、より高速のデータによってシリアル回線からの +割り込みが増加します。 +システムはこの割り込みをモデムと通信して処理しなくてはならないため、 +システムの負荷と遅延時間が増加することになります。 +VJ 圧縮とは異なり、Predictor-1 圧縮はリンクを通る +.Em すべての +データをあらかじめ圧縮しておくことで、オーバヘッドを最小にします。 + +.It マイクロソフトの IPCP 拡張をサポート +マイクロソフトの +.Em PPP +スタックを使用するクライアント (つまり Win95, WinNT) との間で +ネームサーバのアドレスと NetBIOS ネームサーバのアドレスを +調停することができます。 +.El + +.Sh パーミッション +.Nm ppp +はユーザ +.Dv root +、グループ +.Dv network +、パーミッション +.Dv 4550 +でインストールされます。 +.Nm ppp +は、起動したユーザ ID が 0 でない場合には、 +クライアントモードでは実行しません。 +.Nm ppp +は、通常ユーザの場合には、 +.Fl direct +モードで実行します。 +しかし実行パーミッションの都合により、 +このユーザはグループ +.Dv network +に属する必要があります。 +通常ユーザとして実行するする場合には、 +システムのルーティングテーブルを変更するために、 +.Nm +はユーザ ID 0 に変わります。 +全ての外部コマンド ("shell" や "!bg" で実行されます) は、 +.Nm ppp +を起動したユーザ ID で実行されます。 + +.Sh 始める前に + +最初に +.Nm +を実行する時には、いくつかの初期設定を整える必要があります。 +まず、カーネルにトンネルデバイスが含まれていなければ +なりません (GENERIC カーネルではデフォルトで 1 つ含まれます)。 +もし含まれていない場合や複数の tun インタフェースが必要な場合、 +以下の行をカーネル設定ファイルに追加して、 +カーネルを再構築する必要があります。 + +.Dl pseudo-device tun N + +ここで +.Ar N +は +.Em PPP +接続を行ないたい最大の数です。 + +つぎに、 +.Pa /dev +ディレクトリにトンネルデバイスのエントリ +.Pa /dev/tunN +があるかどうかを調べてください。 +ここで +.Ar N +は、0 から始まる tun デバイスの番号です。 +もし無いようならば、"MAKEDEV tunN" を実行すれば作ることができます。 +これにより 0 から +.Ar N +までの tun デバイスが作成されます。 + +最後に、ログファイルを作成します。 +.Nm ppp +は +.Xr syslog 3 +を使用して情報をログします。通常のログファイル名は +.Pa /var/log/ppp.log +です。 +このファイルに出力を行うためには、以下の行を +.Pa /etc/syslog.conf +ファイルに記述してください: + +.Dl !ppp +.Dl *.*<TAB>/var/log/ppp.log + +TAB と書かれている場所には、実際にはタブを入力します。 +スペースを使うと、なにも知らされぬままこの行は無視されます。 + +ppp の実行形式にリンクを作成することにより、 +複数の ppp ログファイルを持つことが可能です: + +.Dl # cd /usr/sbin +.Dl # ln ppp ppp0 + +として +.Pa /etc/syslog.conf +で + +.Dl !ppp0 +.Dl *.* /var/log/ppp0.log + +とします。 +.Pa /etc/syslog.conf +を更新した後に、 +.Nm syslogd +に +.Dv HUP +シグナルを送ることをお忘れなく。 + +.Sh 手動ダイアル + +以下の例では、あなたのマシン名が +.Nm awfulhak +であるとして説明します。 + +ホスト名とパスワードを +.Pa /etc/ppp/ppp.secret +に設定している場合、help, passwd, quit コマンドしか実行できないでしょう。 + +.Bd -literal -offset indent +ppp on "your hostname"> help + help : Display this message + passwd : Password for security + quit : Quit the PPP program +ppp on awfulhak> pass <password> +.Ed + +正しいパスワードを入力すると、プロンプトの "on" は "ON" に変わります。 + +.Bd -literal -offset indent +ppp ON awfulhak> +.Ed + +ここで、モデムのデバイス名、スピードやパリティの設定、 +CTS/RTS 信号を使うかどうか (デフォルトでは CTS/RTS が使用されます) を +指定できます。もしハードウェアが CTS/RTS 信号を持っていない場合 +(これは ppp 可能な端末サーバに直接つなぐ場合に起こり得ます)、 +.Nm +は そのポートを通してどんな出力も送らず、来るはずのない信号を待ち続けます。 +したがって、直接接続で通信ができないような場合には、 +ctsrts を off にしてみてください。 + +.Bd -literal -offset indent +ppp ON awfulhak> set line /dev/cuaa0 +ppp ON awfulhak> set speed 38400 +ppp ON awfulhak> set parity even +ppp ON awfulhak> set ctsrts on +ppp ON awfulhak> show modem + +* モデム関連のパラメータが、ここに示されます * + +ppp ON awfulhak> +.Ed + +ここでは、直接モデムと通信するために term コマンドを使用可能です。 + +.Bd -literal -offset indent +ppp ON awfulhak> term +at +OK +atdt123456 +CONNECT +login: ppp +Password: +Protocol: ppp +.Ed + +相手が PPP で話しはじめると、 +.Nm +はそれを自動的に検出してコマンドモードに戻ります。 + +.Bd -literal -offset indent +ppp ON awfulhak> +PPP ON awfulhak> +.Ed + +これで接続されました! +プロンプトの +.Sq PPP +が大文字に変化して、接続されたことを知らせます。 +show コマンドを使用すれば、どのように事態が進行しているのかが分ります: + +.Bd -literal -offset indent +PPP ON awfulhak> show lcp + +* LCP 関連の情報がここに表示されます * + +PPP ON awfulhak> show ipcp + +* IPCP 関連の情報がここに表示されます * +.Ed + +この時点で、マシンは接続先に対するホスト単位のルート (host route) +を持っています。 +これはリンクの相手のホストとのみ接続可能であるという意味です。 +デフォルトルートのエントリ +(他のルーティングエントリを持たずに、全パケットを ppp リンクの相手に送る +ように、あなたのマシンに指示します)を追加したければ、 +以下のコマンドを入力してください。 + +.Bd -literal -offset indent +PPP ON awfulhak> add 0 0 HISADDR +.Ed + +.Sq HISADDR +という文字列は、相手側の IP アドレスを表します。 +この変数は接続が確立して始めて使用可能となります。 +よくある誤りとして、上記記述を +.Pa ppp.conf +ファイルに指定してしまうということがあります。 +このファイルが読まれる時には、リモート IP アドレスは確立していませんので、 +うまくいきません。 + +ここで、(ping, telnet, ftp のような) ネットワークアプリケーションを +別のウインドウで使用可能です。 + +使用可能コマンドの詳細は PPP コマンドリストの節を参照してください。 + +.Sh 自動ダイアル + +自動ダイアルを行なうためには、 Dial と Login のチャットスクリプトを +用意しなければなりません。定義の例は +.Pa /etc/ppp/ppp.conf.sample +を見てください (ppp.conf の書式は非常に簡単です)。 + +.Bl -bullet -compact + +.It +各行には一つのコマンドまたはラベル、コメントのいずれかが書かれます。 + +.It +.Sq # +で始まる行は、コメントとして扱われます。 +.It +ラベルは行頭から始まり、最後にコロン (:) が続かなければなりません。 + +.It +コマンド行は、空白かタブで始まらなければなりません。 + +.El + +.Pa ppp.conf +ファイルには少くとも +.Dq default +セクションが存在する必要があります。 +このセクションは常に実行されます。 +このファイルには 1 以上のセクションが含まれます。 +セクション名は用途に応じて付けます。例えば、 +.Dq MyISP +はあなたの ISP を表したり、 +.Dq ppp-in +は入力の +.Nm +構成を表したります。 + +.Nm ppp +を立ち上げる際に、接続先のラベル名を指定可能です。 +.Dq default +ラベルに関係づけられたコマンドが実行されてから、 +接続先ラベルに関連づけられたコマンドが実行されます。 +.Nm +を引数無しで起動した場合、 +.Dq default +だけは実行されます。load コマンドを使用して、 +.Pa ppp.conf +のセクションを手動でロード可能です: + +.Bd -literal -offset indent +PPP ON awfulhak> load MyISP +.Ed + +ひとたび接続が確立したなら、プロンプトの ppp は PPP に変わります: + +.Bd -literal -offset indent +# ppp MyISP +... +ppp ON awfulhak> dial +dial OK! +login OK! +PPP ON awfulhak> +.Ed + +もし +.Pa /etc/ppp/ppp.linkup +が存在していれば、 +.Em PPP +接続が確立された時に、その内容が実行されます。 +デフォルトルート追加については。 +提供されている +.Pa /etc/ppp/ppp.conf.sample +の +.Dq pmdeman +の例を参照してください。 +HISADDR という文字列はリモート側の IP アドレスを表しています。 +同様に、接続が閉じられると、 +.Pa /etc/ppp/ppp.linkdown +ファイルの内容が実行されます。 + +.Sh バックグラウンドダイアル + +.Nm ppp +を使って非対話的に接続を確立したい場合 (たとえば +.Xr crontab(5) +エントリや +.Xr at(1) +ジョブから使うような場合) には、 +.Fl background +オプションを使います。この場合にも +.Pa /etc/ppp/ppp.conf +で定義された接続先のラベルを指定しなければなりません。 +このラベルには +.Dq set ifaddr +コマンドが含まれ、 +リモートの接続先の IP アドレスを定義する必要があります。( +.Pa /etc/ppp/ppp.conf.sample +参照。) + +.Fl background +が指定された場合、 +.Nm +はすぐに接続を確立しようとします。 +複数の電話番号が指定された場合には、各電話番号が一回づつ試されます。 +これらに失敗すると、 +.Nm +は即座に終了し、0 でない終了コードを返します。 + +接続に成功すると +.Nm +はデーモンになり、呼び出し側に終了コード 0 を返します。 +デーモンは、リモートシステムが接続を終了した場合、 +もしくは +.Dv TERM +シグナルを受け取った場合に、自動的に終了します。 + +.Sh ダイアル・オンデマンド + +デマンドダイアル機能は +.Fl auto +または +.Fl ddial +オプションにて有効にされます。この場合にも +.Pa /etc/ppp/ppp.conf +で定義された接続先のラベルを指定しなければなりません。 +これには、リモート接続先の IP アドレスを指定するための +.Dq set ifaddr +コマンドも書かれていなければなりません ( +.Pa /etc/ppp/ppp.conf.sample +を参照してください)。 + +.Bd -literal -offset indent +# ppp -auto pmdemand +... +# +.Ed + +.Fl auto +または +.Fl ddial +が指定された時に +.Nm +はデーモンとして動作しますが、以下のように診断ポートを +通じて設定を確認したり変更したりすることができます +(これは +.Fl background +や +.Fl direct +のモードでも可能です): + +.Bd -literal -offset indent +# pppctl -v 3000 show ipcp +Password: +IPCP [OPEND] + his side: xxxx + .... +.Ed + +現在 +.Xr telnet 1 +を使用して対話的に会話できます。 + +.Pp +それぞれの +.Nm +デーモンは "3000 + トンネルデバイス番号" で計算される番号のポートで +参照できます。 + +.Fl auto +モードにて +送信パケットが検出された時、 +.Nm +は (チャットスクリプトにもとづいて) ダイアルを行ない、 +通信相手に接続しようとします。 +.Fl ddial +モードでは回線がダウンしていることが確認された場合にはいつでも +ダイアルが行なわれます。 + +接続に失敗したら、デフォルトの動作では 30 秒間待ち、 +別の送信パケットが検出された時に接続しようとします。 +この動作は +.Bd -literal -offset indent +set redial seconds|random[.nseconds|random] [dial_attempts] +.Ed +.Pp +によって変更することができます。 +.Sq seconds +は、再び接続しようとするまでの秒数です。 +引数が +.Sq random +の場合には、待ち時間を 0 秒から 30 秒の間でランダムに選びます。 +.Sq nseconds +は電話番号リストの中の次の番号をダイアルする前に待つ秒数です。( +.Dq set phone +コマンドを参照してください)。これのデフォルトは 3 秒です。 +繰り返しますが、引数が +.Sq random +の場合には、待ち時間を 0 秒から 30 秒の間でランダムに選びます。 +.Sq dial_attempts +は、受け取った個々の送信パケットに対して、何回接続を試みるのかを示す +数字です。 +このパラメータが省略された場合には、以前の値がそのまま使われます。 +.Sq dial_attempts +に 0 が指定された場合には、 +.Nm +は接続できるまでダイアルを続けます。 +.Bd -literal -offset indent +set redial 10.3 4 +.Ed +.Pp +は個々の送信パケットに対して 4 回接続を試み、 +番号間の待ち時間が 3 秒で、すべての番号を試した後に +10 秒待つことをあらわします。 +複数の電話番号が指定されている場合でも、トータルのダイアル回数は +4 回のままです。 (それぞれの番号を 4 回ダイアルするのではありません)。 + +リンクの両端が +.Nm +のデマンドダイアルモードを利用している場合は、 +ダイアル間隔を変更しておくのが良いでしょう。 +もし、リンクの両端が同じタイムアウト時間に設定されていて、 +リンクが切れて両方に送信待ちのパケットがあった場合、 +両方が同時に相手を呼び出しあうことになってしまいます。 + +場所によっては、シリアルリンクに信頼性がなく、 +切れるべきでない時にキャリアが失われるかもしれません。 +セッションの途中で予期せずキャリアが失われた場合、 +.Nm +にリダイアルさせることができます。 +.Bd -literal -offset indent +set reconnect timeout ntries +.Ed + +このコマンドは、キャリアが失われた時に +.Ar timeout +秒待ってから +.Ar ntries +回まで接続を再確立するよう ppp に指示します。たとえば、 +.Bd -literal -offset indent +set reconnect 3 5 +.Ed + +は、予期せぬキャリア喪失の際に +.Ar 3 +秒待ってから再接続を試みるように +.Nm +に指示します。これは +.Nm +があきらめる前に +.Ar 5 +回まで行なわれます。 +ntries のデフォルト値はゼロ (再接続しない) です。 +このオプションを使用する際には注意が必要です。 +もしローカル側のタイムアウトがリモート側よりもわずかに長いと、 +リモート側がタイムアウトにより回線を切断した場合に、 +再接続機能が (指定した回数まで) 起動されてしまいます。 + +注: この文脈においては、多くの LQR を喪失するとキャリア喪失を引き起こし、 +ひいては再接続を引き起こします。 + +.Fl background +フラグが指定された場合、接続が行なえるまで +すべての電話番号が最大一回ダイアルされます。 +.Dq set redial +コマンドにて、リダイアル期間の後には、 +再接続回数を指定します。 +リダイアル値が指定した電話番号数より少ない場合、 +指定した電話番号で使用されないものが出来ます。 + +プログラムを終了させるには、以下のように入力してください。 + + PPP ON awfulhak> close + ppp ON awfulhak> quit all + +.Pp +.Dq quit +コマンドは telnet による接続を終了しますが、 +プログラム自身は終了させません。 +プログラムも終了させたい場合には、 +.Dq quit all +を実行してください。 + +.Sh PPP 接続の受け入れ (方法その 1) + +.Em PPP +接続要求を受け入れるには、以下の手順にしたがってください。 + +.Bl -enum +.It +モデムと、 (必要であれば) +.Pa /etc/rc.serial +が正しく設定されていることを確認します。 +.Bl -bullet -compact +.It +フロー制御にはハードフロー (CTS/RTS) を使います。 +.It +モデムはエコーバックを行なわず (ATE0) 、コマンドの結果も報告しない (ATQ1) +ように設定されていなければなりません。 +.El + +.It +モデムが接続されているポートで getty が起動されるように +.Pa /etc/ttys +を編集します。 + +たとえば、以下のように設定すれば良いでしょう。 + +.Dl ttyd1 "/usr/libexec/getty std.38400" dialup on secure + +getty を起動するために init プロセスに +.Dv HUP +シグナルを送るのを +忘れないでください。 + +.Dl # kill -HUP 1 + +.It +接続するユーザのためのアカウントを用意します。 +.Bd -literal +ppp:xxxx:66:66:PPP Login User:/home/ppp:/usr/local/bin/ppplogin +.Ed + +.It +.Pa /usr/local/bin/ppplogin +ファイルを以下のような内容で作成します。 +.Bd -literal -offset indent +#!/bin/sh -p +exec /usr/sbin/ppp -direct +.Ed + +(さらに制御を行なうためにラベル名を指定することもできます。) + +.Pp +ダイレクトモード ( +.Fl direct ) +では、 +.Nm +は標準入力と標準出力を使って動作します。クライアント動作の +.Nm +と同様に、 +.Nm pppctl +を使用するか、3000 番 + 現在のトンネルデバイス番号のポートに +.Nm telnet +することでコマンドモードでの制御が可能です。 + +.It +ネームサーバのアドレスと NetBIOS ネームサーバのアドレスを調停する、 +マイクロソフトの IPCP 拡張のサポートを有効にするには、 +.Dq enable msext +と +.Dq set ns pri-addr [sec-addr] +および +.Dq set nbns pri-addr [sec-addr] +を ppp.conf ファイルに追加します。 + +.El + +.Sh PPP 接続の受け入れ (方法その 2) + +この方法は、モデムの接続を扱うのに +.Em mgetty+sendfax +を使用するようにすすめている点が異なります。 +最近のバージョン 0.99 では、 +.Dq AUTO_PPP +オプションをつけてコンパイルすることで、クライアントが +ログインプロンプトに向かって PPP を話すのを検出することができます。 + +手順は以下の通りです: + +.Bl -enum + +.It +AUTO_PPP オプションが使えるように、バージョン 0.99 か +それ以降の mgetty+sendfax を入手、設定、インストールします。 + +.It +モデムが接続されているポートで mgetty が起動されるように +.Pa /etc/ttys +を編集します。 +例えば、以下のように設定すれば良いでしょう: + +.Dl cuaa1 "/usr/local/sbin/mgetty -s 57600" dialup on + +.It +接続するユーザのためのアカウントを用意します。 +.Bd -literal +Pfred:xxxx:66:66:Fred's PPP:/home/ppp:/etc/ppp/ppp-dialup +.Ed + +.It +以下のファイルをよく読んで、要点を理解してください。 +.Pa /etc/ppp/sample.ppp-dialup +.Pa /etc/ppp/sample.ppp-pap-dialup +.Pa /etc/ppp/ppp.conf.sample +以下のようにすると ppp-pap-dialup が +.Pa /usr/local/etc/mgetty+sendfax/login.conf +から呼び出されます。 + +.Dl /AutoPPP/ - - /etc/ppp/ppp-pap-dialup +.El + +.Sh PPP オーバ TCP (別名: トンネリング) + +シリアルリンク上以外の ppp の使用方法として、 +ホストとポートを指定することにより、 +tcp 接続を使用することが可能です。 + +.Dl set device ui-gate:6669 + +シリアルデバイスをオープンする代りに、 +.Nm +は指定されたマシンンの指定されたソケットへの tcp 接続をオープンします。 +.Nm +は telnet プロトコルを使用しないこと、 +telnet サーバと交渉できないことに注意を払うべきです。 +受信マシン (ui-gate) 上に、 +この ppp 接続を受信するポートを設定する必要があります。まず +.Pa /etc/services +を更新して、サービスを定義します: + +.Dl ppp-in 6669/tcp # Incoming ppp connections over tcp + +そして +.Pa /etc/inetd.conf +を更新して、このポートへの受信接続をどのように扱うかを inetd に指示します: + +.Dl ppp-in stream tcp nowait root /usr/sbin/ppp ppp -direct ppp-in + +.Pa /etc/inetd.conf +を更新した後には、 +.Nm inetd +に +.Dv HUP +シグナルを送るのをお忘れなく。 + +ここではラベル名 +.Dq ppp-in +を使用します。 +ui-gate (受信側) の +.Pa /etc/ppp/ppp.conf +エントリは以下を含みます: + +.Bd -literal -offset indent +ppp-in: + set timeout 0 + set ifaddr 10.0.4.1 10.0.4.2 + add 10.0.1.0 255.255.255.0 10.0.4.1 +.Ed + +セキュリティのために PAP もしくは CHAP の設定をしたいかもしれません。 +PAP を有効にするには以下の行を追加します: +.Bd -literal -offset indent + enable PAP +.Ed +.Pp +また、以下のエントリを +.Pa /etc/ppp/ppp.secret +に作成する必要があります: +.Bd -literal -offset indent +MyAuthName MyAuthPasswd +.Ed +.Pp +awfulhak (起動側) の +.Pa /etc/ppp/ppp.conf +エントリは以下を含む必要があります: + +.Bd -literal -offset indent +ui-gate: + set escape 0xff + set device ui-gate:ppp-in + set dial + set timeout 30 5 4 + set log Phase Chat Connect Carrier hdlc LCP IPCP CCP tun + set ifaddr 10.0.4.2 10.0.4.1 + add 10.0.2.0 255.255.255.0 10.0.4.2 +.Ed +.Pp +PAP を有効にしようとしている場合、以下の設定も必要です: +.Bd -literal -offset indent + set authname MyAuthName + set authkey MyAuthKey +.Ed + +我々は、 +ui-gate に 10.0.4.1 のアドレスを割り当て、 +awfulhak に 10.0.4.2 のアドレスを割り当てようとしています。 + +接続をオープンするためには、以下をタイプするだけで良いです。 + +.Dl awfulhak # ppp -background ui-gate + +結果として、 +awfulhak にはネットワーク 10.0.2.0/24 への新たな「ルート」が、 +ui-gate にはネットワーク 10.0.1.0/24 への新たな「ルート」が、 +tcp 接続経由でそれぞれ作成されます。 + +ネットワークは実質的にブリッジされます - +下にある tcp 接続はパブリックなネットワーク (例えばインターネット) を +またがっても良いです。 +また 2 つのゲートウェイ間では ppp トラフィックは +概念的に tcp ストリーム中でカプセル化されます +(パケットがパケットに対応するわけではありません)。 + +この機構の大きな欠点は、同時に 2 つの「配送保証」機構が存在することです - +この 2 つとは、下の tcp ストリームと ppp リンク上で使用されるプロトコルであり、 +おそらくまた tcp でしょう。 +パケット喪失が起ると、両者はそれぞれの方法で喪失したパケットを再送しようと +するでしょう。 + +.Sh パケットエイリアシング + +.Fl alias +コマンドラインオプションにより、パケットエイリアシングが有効になります。 +これにより、ppp ホストがローカルエリアネットワークの他のコンピュータに対して +マスカレードゲートウェイとして動作するようになります。 +送信される IP パケットは、まるで ppp ホストから来たかのようにエイリアスされ、 +受信パケットは、それがローカルエリアネットワークの正しいマシンに +送られるようにエイリアスが戻されます。 + +パケットエイリアシングにより、 +未登録でプライベートなサブネット上のコンピュータを +外部から見えないようにしつつ、 +インターネットへアクセス可能とします。 + +一般に、ppp が正しく動作していることの確認は、 +まず最初にパケットエイリアシングを禁止して行ないます。 +次に +.Fl alias +オプションを有効にして、ppp ホストの上で (ウェブブラウザや telnet, ftp, ping, +traceroute などの) ネットワークアプリケーションの動作を確認します。 +最後に、LAN 上の別のコンピュータの上で同様なアプリケーションの +動作を確認することになります。 + +ppp ホストではネットワークアプリケーションが正しく動作するのに、 +LAN 上の別のコンピュータでは動かないのであれば、マスカレードソフトウェアは +正しく動いているけれども、ホストが IP パケットをフォワーディングしないか、 +ひょっとするとパケットが送られて来ていないかのどちらかです。 +.Pa /etc/rc.conf +で IP フォワーディングが有効にされていることと、 +他のコンピュータで ppp ホストがその LAN のゲートウェイとして +指定されていることを確認してください。 + +.Sh パケットのフィルタリング + +この実装では、パケットのフィルタリングがサポートされています。 +ifilter, ofilter, dfilter の 3 種類のフィルタがあります。 +ここでは基本的なことについて書くことにします。 + +.Bl -bullet -compact +.It +フィルタ定義は以下のような構文になっています。 + +set filter-name rule-no action [src_addr/src_width] [dst_addr/dst_width] +[proto [src [lt|eq|gt] port ]] [dst [lt|eq|gt] port] [estab] +.Bl -enum +.It +.Sq filter-name +には、ifilter, ofilter, dfilter, afilter のうちのどれか一つを指定します。 +.It +.Sq permit +と +.Sq deny +の二つの action があります。 +もし、あるパケットが規則に一致した場合、 +結びつけられた action が直ちに実行されます。 +.It +.Sq src_width +と +.Sq dst_width +は、アドレスの範囲を表現するネットマスクのように働きます。 +.It +.Sq proto +は icmp, udp, tcp のうちのいずれか一つです。 +.It +.Sq port number +は数字で指定するか、 +.Pa /etc/services +のサービス名で指定することができます。 + +.El + +.It +各フィルタは規則 0 から始まり、20 個までの規則をもつことができます。 +規則の集合は、規則 0 が定義されていなければ、有効にはなりません。 +すなわち、デフォルトでは全てが通されます。 + +.It +パケットにマッチする規則が無い場合は、パケットは破棄 (ブロック) されます。 + +.It +すべての規則を消去するには、 +.Dq set filter-name -1 +を使ってください。 + +.El + +.Pa /etc/ppp/ppp.conf.filter.example +を参照してください。 + + +.Sh アイドルタイマ、回線品質要求タイマ、リトライタイマの設定 + +アイドルタイマを調べたり/設定するためには、それぞれ +.Dq show timeout +と +.Dq set timeout [lqrtimer [retrytimer]] +コマンドを使ってください: + +.Bd -literal -offset indent +ppp ON awfulhak> set timeout 600 +.Ed + +タイムアウト時間は秒数で指定します。デフォルト値は timeout が 180 秒 + (3 分)、lprtimer が 30 秒、 retrytimer が 3 秒です。 +アイドルタイマ機能を使わないようにするためには、 +.Bd -literal -offset indent +ppp ON awfulhak> set timeout 0 +.Ed +コマンドを利用してください。 + +.Fl auto +モードでは、アイドルタイムアウトが発生すると +.Nm +プログラムは実行したままで +.Em PPP +セッションを終了します。別の引金となるパケットがきた時に +リンクを再び確立しようとします。 + +.Sh Predictor-1 圧縮 + +このバージョンでは、現在の IETF ドラフトに基づいた CCP および Predictor type 1 +圧縮をサポートしています。 +デフォルトの動作として、 +.Nm +は、接続相手が同意 (あるいは要求) した場合に、 +この機能を使おうと (もしくは受け入れようと) します。 + +完全に CCP/predictor 機能を停止するためには、 +.Dq disable pred1 +と +.Dq deny pred1 +コマンドを使ってください。 + +.Sh IP アドレスの制御 + +.Nm +は IP アドレスの調停のために IPCP を使います。接続の両側は、自分が +使おうとするアドレスを提示し、要求された IP アドレスが受け入れ可能な +ものであれば、相手に ACK (肯定応答) を返します。 +受け入れることができなければ、別の IP アドレスの使用を促すために +.Nm +は相手に NAK (否定応答) を返します。 +接続の両側が受け取った要求に同意し (ACK を送っ) た時、 +IPCP はオープン状態にセットされ、ネットワーク層での接続が確立されます。 + +IPCP の動作を制御するために、この実装はローカルとリモートの IP +アドレスを定義するための +.Dq set ifaddr +コマンドを持っています。 + +.Bd -literal -offset indent +set ifaddr [src_addr [dst_addr [netmask [trigger_addr]]]] +.Ed + +ここで、 +.Sq src_addr +はローカル側で使おうと思っている IP アドレスで、 +.Sq dst_addr +はリモート側が使用すべき IP アドレスです。 +.Sq netmask +は使用すべきネットマスクです。 +.Sq src_addr +と +.Sq dst_addr +のデフォルトは 0.0.0.0 であり、 +.Sq netmask +のデフォルトは +.Sq src_addr +に適したマスク値です。 +.Sq netmask +は小さくすることのみ可能です。便利な値は 255.255.255.255 でしょう。 +誤った ppp の実装には、接続ネゴシエーションのために、 +.Sq src_addr +ではなく特別な IP アドレスを使用しなければならないものがあります。 +この場合、 +.Sq trg_addr +で指定した IP アドレスが使用されます。 +相手がこの提案された番号に同意しない限り、 +ルーティングテーブルには影響しません。 + +.Bd -literal -offset indent +set ifaddr 192.244.177.38 192.244.177.2 255.255.255.255 0.0.0.0 +.Ed + +上の例は、 +.Bl -bullet -compact +.It +自分の IP アドレスとしてまず 0.0.0.0 を提案しますが、 +アドレス 192.244.177.38 のみは受け付けます。 + +.It +相手側のアドレスとして 192.244.177.2 を使うように要求し, +192.244.177.2 以外のどんなアドレスを使うことも許可しません。 +相手側が別の IP アドレスを要求してきた時は、いつでも +192.244.177.2 を提案します。 + +.It +ルーティングテーブルのネットマスク値は 0xffffffff に設定されます。 +.El + +これは、両側が既に決まった IP アドレスを持っている場合には +うまくいきますが、多くの場合、一方がすべての IP アドレスを制御する +サーバとして動作しており、もう一方はその方針に従わなくてはなりません。 + +より柔軟な動作をさせるために、`ifaddr' 変数の IP アドレス指定を +もっと緩やかにすることが可能です: + +.Dl set ifaddr 192.244.177.38/24 192.244.177.2/20 + +スラッシュ (/) に続く数字は、この IP アドレスで意味のあるビットの数を +表現しています。上の例は以下のことを示しています。 + +.Bl -bullet -compact +.It +可能なら自分のアドレスとして 192.244.177.38 を使おうとしますが、 +192.244.177.0 から 192.244.177.255 の間の任意の IP アドレスも受け入れます。 + +.It +相手のアドレスとして 192.244.177.2 を使うことを希望しますが、 +192.244.176.0 から 192.244.191.255 の間の任意の IP アドレスも許可します。 + +.It +すでにお気づきと思いますが、 192.244.177.2 は 192.244.177.2/32 と書くことと +等価です。 + +.It +例外として、0 は 0.0.0.0/0 と等価であり、希望する IP アドレスは +特に無く、リモート接続先の選択に従うことを意味します。 +0 を使用した場合は、接続が確立するまで、ルーティングテーブルエントリは +まったく設定されません。 + +.It +192.244.177.2/0 は、どんな IP アドレスでも受け入れる/許可することを +意味しますが、最初に 192.244.177.2 を使うように提案します。 +.El + +.Sh インターネットサービスプロバイダと接続する + +プロバイダに接続する際には、以下のステップを踏む必要があるでしょう。 + +.Bl -enum +.It +.Dq set phone +コマンドを使って、ダイアルスクリプトにプロバイダの電話番号を記述します。 +ダイアルやリダイアルに使用する電話番号は、 +パイプ (|) またはコロン (:) で区切って +複数指定することができます。たとえば、以下のようになります。 +.Bd -literal -offset indent +set phone "111[|222]...[:333[|444]...]... +.Ed +最初のパイプで区切られたリストの番号は、 +直前の番号でダイアルもしくはログインスクリプトが失敗した場合のみ使用されます。 +コロンで区切られた番号は、直前の番号の使用によりなにが起ったのかにかかわらず、 +この順番で使用されます。例えば: +.Bd -literal -offset indent +set phone "1234567|2345678:3456789|4567890" +.Ed +.Pp +この場合、まず 1234567 にダイアルしてみます。 +ダイアルもしくはログインスクリプトに失敗したら、 +次は 2345678 を使用します。 +しかしこれはダイアルもしくはログインスクリプトに失敗したとき「のみ」です。 +このダイアルの後、3456789 が使用されます。 +4567890 は 345689 でダイアルもしくはログインスクリプトに失敗したときのみ +使用されます。 +2345678 のログインスクリプトが失敗したとしても、次の番号は 3456789 です。 +必要な数だけ、パイプとコロンを使用可能です +(しかし、通常はパイプのみかコロンのみの使用となるでしょう)。 +次の番号へのリダイアルまでのタイムアウトは、全ての番号にて使用されます。 +リストが終了すると、 +通常のリダイアル期間だけ待ち、 +最初から再開します。 + +.Dq set dial +コマンドの \\\\T 文字列は選択された番号で置きかえられます。 +(以下を参照してください)。 + +.It +リダイアルに関する設定は、 +.Dq set redial +で行ないます。 +たとえば回線の調子が悪かったり、 (最近では +それほど多くないでしょうが) プロバイダがいつも話中だったりすると、 +以下のように設定したくなるかもしれません。 +.Bd -literal -offset indent +set redial 10 4 +.Ed +.Pp +これは最初の番号にリダイアルを行なう前に 10 秒待って、 +4 回までダイアルしてみるという意味になります。 + +.It +.Dq set dial +と +.Dq set login +コマンドを使ってログイン手続きを記述します。 +.Dq set dial +コマンドはモデムと通信してプロバイダへのリンクを確立するのに使われます。 +たとえば、以下のようになります。 +.Bd -literal -offset indent +set dial "ABORT BUSY ABORT NO\\\\sCARRIER TIMEOUT 4 \\"\\" ATZ OK-ATZ-OK ATDT\\\\T TIMEOUT 60 CONNECT" +.Ed +.Pp +このモデム「チャット」文字列の意味は以下の通りです。 + +.Bl -bullet +.It +"BUSY" または "NO CARRIER" を受信した場合には処理を中止します。 +.It +タイムアウトを 4 秒にセットします。 +.It +文字列の受信待ちは行ないません。 +.It +ATZ を送信します。 +.It +OK の受信待ちを行ないます。もし受信できなければ、 +もう一度 ATZ を送信し、OK の受信待ちを行ないます。 +.It +ATDTxxxxxxx を送信します。xxxxxxx は +上の電話番号リストの中の、次にダイアルする番号です。 +.It +タイムアウトを 60 にセットします。 +.It +文字列 CONNECT の受信待ちを行ないます。 +.El + +一旦接続が確立されると、ログインスクリプトが実行されます。 +このスクリプトはダイアルスクリプトと同じスタイルで書かれます。 +.Bd -literal -offset indent +set login "TIMEOUT 15 login:-\\\\r-login: awfulhak word: xxx ocol: PPP HELLO" +.Ed +.Pp +このログイン「チャット」文字列の意味は以下の通りです。 + +.Bl -bullet +.It +タイムアウトを 15 秒にセットします。 +.It +"login:" の受信待ちを行ないます。もし受信できなければ +改行文字を送信して、再び "login:" の受信待ちを行ないます。 +.It +"awfulhak" を送信します。 +.It +"word:" ("Password:" プロンプトの末尾) の受信待ちを行ないます。 +.It +"xxx" を送信します。 +.It +"ocol:" ("Protocol:" プロンプトの末尾) の受信待ちを行ないます。 +.It +"PPP" を送信します。 +.It +"HELLO" の受信待ちを行ないます。 +.El +.Pp +ログインスクリプトはプロバイダによって大きく違うものになるでしょう。 + +.It +シリアル回線と通信速度を指定するためには +.Dq set line +と +.Dq set speed +を使います。たとえば以下のようになります。 +.Bd -literal -offset indent +set line /dev/cuaa0 +set sp 115200 +.Ed +.Pp +FreeBSD では cuaa0 が一つめのシリアルポートになります。 +OpenBSD で +.Nm +を実行している場合には cua00 が一つめです。 +あなたのモデムが 28800 かそれ以上のビットレートで通信することが +できるなら、シリアルポートの速度には 115200 を指定しておくべきでしょう。 +一般に、シリアルポートの速度はモデムの速度の約 4 倍にしておきます。 + +.It +.Dq set ifaddr +コマンドで IP アドレスを定義します。 +.Bl -bullet +.It +プロバイダがどの IP アドレスを使っているのか知っている場合には、 +それをリモートアドレス (dst_addr) として使ってください。 +知らない場合には、10.0.0.2/0 か何かを使ってください (以下を参照してください)。 +.It +特定の IP アドレスをプロバイダから割り当てられている場合は、 +それをローカルアドレス (src_addr) として使ってください。 +.It +プロバイダが IP アドレスを動的に割り当てる場合は、適当に控えめで +緩やかに記述した IP アドレスをローカルアドレスに選んでください。 +10.0.0.1/0 が適切でしょう。 +/ に続く数値は、このアドレスのうち何ビットを重視しているかを示します。 +もしもクラス C のネットワーク 1.2.3.0 上のアドレスを使うことを +主張したいのなら、1.2.3.1/24 と指定することができます。 +.It +ISP があなたが提示した最初の IP 番号を受け付ける場合、 +第 3, 4 の引数に +.Dq 0.0.0.0 +を指定してください。 +これにより ISP が番号を割当てます。 +(3 つめの引数は、 +.Sq src_addr +に対してデフォルトのマスクよりも制約が緩いため、無視されます。) +.El +.Pp +自分の IP アドレスもプロバイダの IP アドレスも +知らない場合には、以下の例のようにするとよいでしょう。 +.Bd -literal -offset indent +set ifaddr 10.10.10.10/0 10.10.11.11/0 0.0.0.0 0.0.0.0 +.Ed + +.It +ほとんどの場合、プロバイダはデフォルトルータでもあるでしょう。 +この場合、以下の行を +.Pa ppp.conf +に追加します。 + +.Bd -literal -offset indent +delete ALL +add 0 0 HISADDR +.Ed + +.Pp +これは、 +.Nm +が使用している tun インタフェースに関連する直接ではない +ルーティングエントリを削除して、 +それから 10.10.11.11 をデフォルトルートとして追加するよう +.Nm +に指示します。 +.Pp +もし動的 IP アドレスを使うのであれば、以下の 2 行を +.Pa ppp.linkup +ファイルに追加しておかなければなりません: + +.Bd -literal -offset indent +delete ALL +add 0 0 HISADDR +.Ed + +HISADDR は「相手」の IP 番号を意味するマクロです。 +使用する IP 番号に関して、 +(IPCP を使用して) 合意されて始めて、使用可能です。 +一旦接続が確立されると、 +.Nm +は直接ではないインタフェースのルートを全て削除し、 +デフォルトルートが相手の IP 番号を差すように設定します。 +.Pa ppp.conf +で使ったのと同じラベルを使用してください。 +.Pp +もしコマンドを対話的に入力しているのであれば、接続に成功した後で +.Bd -literal -offset indent +add 0 0 HISADDR +.Ed +.Pp +とタイプするだけで充分です。 + +.It +プロバイダが PAP/CHAP による認証を要求している場合は、 +.Pa ppp.conf +ファイルに以下の行を追加してください。 +.Bd -literal -offset indent +set authname MyName +set authkey MyPassword +.Ed +.Pp +デフォルトではどちらも受け付けられますので、ISP が何を要求しても大丈夫です。 +.El + +現実の例を見たい場合には、 +.Pa /etc/ppp/ppp.conf.sample +と +.Pa /etc/ppp/ppp.linkup.sample +を参照してください。 +ラベル pmdemand は、ほとんどのプロバイダで使用できるでしょう。 + +.Sh ログ機能 + +.Nm +は以下のログ情報を +.Xr syslog 3 +経由で出力することができます。 + +.Bl -column SMMMMMM -offset indent +.It Li Async 非同期レベルパケットの 16 進ダンプ +.It Li Carrier 'CARRIER' まで含めたチャットログの生成 +.It Li CCP CCP パケットトレースの生成 +.It Li Chat チャットスクリプトのトレースログの生成 +.It Li Command コマンド実行のログ +.It Li Connect 完全なチャットログの生成 +.It Li Debug (非常に長い)デバッグ情報のログ +.It Li HDLC HDLC パケットの 16 進ダンプ +.It Li IPCP IPCP パケットトレースの生成 +.It Li LCP LCP パケットトレースの生成 +.It Li Link アドレスの割当およびリンクの確立、解放イベントのログ +.It Li LQM LQR レポートの生成 +.It Li Phase フェイズ遷移ログの出力 +.It Li TCP/IP 全 TCP/IP パケットのダンプ +.It Li TUN ログの各行に tun デバイスを含めます +.It Li Warning ターミナルデバイスへの出力。ターミナルが存在しない場合は、LOG_WARNING を使用してファイルに送ります。 +.It Li Error ターミナルデバイスとログファイルへの出力で、LOG_ERROR を使用します。 +.It Li Alert ログファイルへの出力で、LOG_ALERT を使用します。 +.El + +.Dq set log +コマンドで、ログの出力レベルを設定することができます。 +また、複数のレベルを指定することも可能です。 +デフォルトは、 +.Dq set log Carrier Link Phase +です。 + +.Dq set log +への最初の引数が '+' か '-' の文字で始まる場合、 +現在のログレベルを消去せずに修正します。例えば: + +.Bd -literal -offset indent +PPP ON awfulhak> show log +Log: Carrier Link Phase +PPP ON awfulhak> set log -Link +tcp/ip +PPP ON awfulhak> show log +Log: Carrier Phase TCP/IP +.Ed + +レベル Warning, Error, Alert のメッセージログは +.Dq set log +では制御できません。 + +.Sh シグナルハンドリング + +.Nm ppp +は以下のシグナルを扱います: + +.Bl -tag -width 20 +.It INT +このシグナルを受信すると、現在の接続がもしあればそれを終了します。 +.Fl auto +もしくは +.Fl ddial +のモードではない場合、 +.Nm +は終了します。 + +.It HUP, TERM, QUIT +.Nm +を終了させます。 + +.It USR1 +対話モードではない場合、 +.Nm +にサーバソケットが存在する場合にはそれらをクローズさせ、 +デフォルトのポート番号選択規則で選んだインターネットソケットを +オープンさせます - このポートは 3000 + トンネルデバイス番号です。 + +.El + +.Sh PPP コマンドリスト + +この節では利用可能コマンドとその効果をリストします。 +ppp セッションで対話的に使用することも、 +コンフィギュレーションファイルで指定することも、 +telnet セッションで指定することも可能です。 + +.Bl -tag -width 20 +.It accept|deny|enable|disable option.... +これらのディレクティブは +最初の接続においてどのように相手と交渉するかを +.Nm +に指示します。各 +.Dq option +には、accept/deny および enable/disable のデフォルトを持ちます。 +.Dq accept +は相手がこのオプションを要求したら、ACK を送ることを意味します。 +.Dq deny +は相手がこのオプションを要求したら、NACK を送ることを意味します。 +.Dq enable +はこのオプションを当方が要求することを意味します。 +.Dq disable +はこのオプションを当方が要求しないことを意味します。 +.Pp +.Dq option +は以下のいずれかです: + +.Bl -tag -width 20 +.It vjcomp +デフォルト: enable かつ accept。 +このオプションは Van Jacobson ヘッダ圧縮を使用するかどうかを決定します。 + +.It lqr +デフォルト: disable かつ accept。 +このオプションはリンク品質要求 (Link Quality Request) を送信するかどうかを +決定します。 +LQR は、モデムのキャリア検出を使用せずに、リンクダウンを +.Nm +に決定させるプロトコルです。 + +.It chap +デフォルト: disable かつ accept。 +CHAP はチャレンジ交換承認プロトコル +(Challenge Handshake Authentication Protocol) を意味します。 +CHAP もしくは PAP (後述) のどちらか一方のみ交渉可能です。 +CHAP では、承認者は「チャレンジ」メッセージを相手に送ります。 +相手は一方向ハッシュ関数を使用して「チャレンジ」を暗号化し、 +結果を送り返します。 +承認者は同じことを行い結果を比較します。 +この機構の利点は、接続を介してパスワードを送らないことです。 + +接続が最初に確立する時にチャレンジが行われます。 +更なるチャレンジが行われるかもしれません。 +相手の承認を行いたい場合は、 +.Dq enable chap +を +.Pa ppp.conf +に書き、相手のエントリを +.Pa ppp.secret +に書く必要があります。 +.Pp +クライアントとして CHAP を使用する場合、 +.Dq AuthName +と +.Dq AuthKey +を +.Pa ppp.conf +に指定するだけで良いです。 +CHAP はデフォルトで accept されます。 + +.It pap +デフォルト: disable かつ accept。 +PAP はパスワード承認プロトコル (Password Authentication Protocol) を +意味します。 +CHAP (前述) もしくは PAP のどちらか一方のみ交渉可能です。 +PAP では、ID とパスワードが相手に送られ続け、 +承認されるか接続が終了されるかまでこれが続きます。 +これは比較的良くないセキュリティ機構です。 +接続が最初に確立した時のみ実行可能です。 + +相手の承認を行いたい場合は、 +.Dq enable pap +を +.Pa ppp.conf +に書き、相手のエントリを +.Pa ppp.secret +に書く必要があります (ただし、後述の +.Dq passwdauth +オプションを参照)。 +.Pp +クライアントとして PAP を使用する場合、 +.Dq AuthName +と +.Dq AuthKey +を +.Pa ppp.conf +に指定するだけで良いです。 +PAP はデフォルトで accept されます。 + +.It acfcomp +デフォルト: enable かつ accept。 +ACFComp はアドレスおよびコントロールフィールド圧縮 +(Address and Control Field Compression) を意味します。 +LCP パケット以外は非常に良く似たフィールトを持ちますので、 +簡単に圧縮可能です。 + +.It protocomp +デフォルト: enable かつ accept。 +このオプションは PFC (プロトコルフィールド圧縮) +の交渉を行うために使用されます。 +この機構により、 +プロトコルフィールドが 2 オクテッドから 1 オクテッドに減ります。 + +.It pred1 +デフォルト: enable かつ accept。 +このオプションは Predictor 1 圧縮を使用するかどうかを決定します。 + +.It msext +デフォルト: disable。 +このオプションは Microsoft の ppp 拡張を使用を許可します。 +これにより、Microsoft PPP DNS と Microsoft NetBIOS NS をサポートします。 +このオプションを有効にすることにより、"set ns" と "set nbns" で +与えられる値を渡せるようになります。 + +.El +以下のオプションは、実際には相手と交渉しません。 +それゆえ accept および deny は意味を持ちません。 + +.Bl -tag -width 20 +.It proxy +デフォルト: disable。 +このオプションを指定することにより、 +.Nm +に相手へのプロクシ ARP をさせます。 + +.It passwdauth +デフォルト: disable。 +このオプションを指定することにより、 +PAP 承認コードが呼び出し側を承認する時に、 +.Pa ppp.secret +ファイルではなく +.Pa passwd +ファイルを使用させます。 + +.It utmp +デフォルト: enable。 +通常ユーザが PAP もしくは CHAP で承認された時で、 +.Nm +が +.Fl direct +モードで実行されている時は、このユーザのエントリが +utmp ファイルおよび wtmp ファイルに作成されます。 +このオプションを disable すると、utmp および wtmp のエントリは作成されません。 +通常、 +ユーザがログインしかつ承認することを要求する場合のみ必要です。 + +.El + +.It add dest mask gateway +.Dq dest +は宛先 IP アドレスであり、 +.Dq mask +はそのマスクです。 +.Dq 0 0 +はデフォルトルートを意味します。 +.Dq gateway +は、 +.Dq dest +マシン/ネットワークに至る、次のホップのゲートウェイです。 + +.It [!]bg command +指定したコマンドをバックグラウンドで実行します。 +擬似引数 +.Dv HISADDR , +.Dv INTERFACE , +.Dv MYADDR +は適切な値に置き換えられます。 +コマンド実行中に +.Nm +を停止させたい場合は、 +.Dv shell +コマンドを使用してください。 + +.It close +現在の接続をクローズします (が終了しません)。 + +.It delete ALL | dest [gateway [mask]] +.Dq ALL +が指定された場合、 +.Nm +が使用中のインタフェースの非直接エントリが全て削除されます。 +tunX のエントリで実際のリンク以外を削除することを意味します。 +.Dq ALL +を使用しない場合、宛先 +.Dq dest +、宛先ネットワーク +.Dq mask +.Dq gateway +へのルートが削除されます。 +デフォルトの +.Dq mask +の値は 0.0.0.0 です + +.It dial|call [remote] +.Dq remote +が指定されている場合、 +.Dq remote +システムへの接続が +.Dq dial +および +.Dq login +スクリプトを使用して確立されます。 +そうでない場合、現在の設定が使用されて接続が確立されます。 + +.It display +上述 +.Dq accept|deny|enable|disable option.... +で指定された、交渉可能な値の現在の状態を表示します。 + +.It passwd pass +全ての +.Nm +コマンドセットにアクセスするために要求されるパスワードを指定します。 + +.It load [remote] +指定された +.Dq remote +ラベルをロードします。 +.Dq remote +が指定されない場合、 +.Dq default +ラベルが仮定されます。 + +.It save +このオプションは (まだ) 実装されていません。 + +.It set[up] var value +このオプションは以下の変数の設定のために使用します: + +.Bl -tag -width 20 +.It set accmap hex-value +ACCMap は非同期制御文字マップ (Asyncronous Control Character Map) を +意味します。 +これはいつも相手と交渉され、デフォルト値は 0x00000000 です。 +このプロトコルが必要なのは、 +特定の文字 (XON/XOFF など) を終点間で受渡すことに依存するハードウェアを +使用する場合です。 + +.It set filter-name rule-no action [src_addr/src_width] +[dst_addr/dst_width] [proto [src [lt|eq|gt] port ]] +[dst [lt|eq|gt] port] [estab] +.Pp +.Nm ppp +は 4 つのフィルタセットをサポートします。 +afilter は接続を維持 - アイドルタイマをリセット - +するためのパケットを指定します。 +dfilter は +.Fl auto +モードにおいて +.Nm +にリダイアルさせるパケットを指定します。 +ifilter はマシンに入力可能なパケットを指定します。 +ofilter はマシンから出力可能なパケットを指定します。 +デフォルトでは全てのフィルタが全パケットを通過させる値に設定されます。 + +ルールは +.Dq n +に従って順番に処理されます。 +各セットに対し 20 までのルールを指定可能です。 +指定されるセットにおけるどのルールにもマッチしないパケットは破棄されます。 +ifilter と ofilter では、パケットをドロップすることを意味します。 +afilter では、アイドルタイマをリセットしないことを意味します。 +dfilter ではダイアルさせることにはならないことを意味します。 + +上述のパケットのフィルタリングの節を参照してください。 + +.It set authkey|key value +クライアントモードでの PAP または CHAP の交渉で使用される +認証キー (もしくはパスワード) を、指定した値に設定します。 +ダイアルもしくはログインスクリプトで使用されるパスワードを指定しますが、 +実際のパスワードがログされることを防ぎます。 + +.It set authname id +クライアントモードでの PAP または CHAP の交渉で使用される +認証 ID を設定します。 + +.It set ctsrts +ハードウェアフロー制御をセットします。 +これがデフォルトです。 + +.It set device|line value +ppp が使用するデバイスを指定する +.Dq value +に設定します。 +全シリアルデバイス名は +.Pa /dev/ +から始まることが仮定されています。 +.Dq value +が +.Pa /dev/ +から始まらない場合、 +.Dq host:port +の形式である必要があります。 +この場合、 +.Nm +指定された +.Dq host +の指定された +.Dq port +と接続しようとします。 +詳細は上述の PPP オーバ TCP の節を参照してください。 + +.It set dial chat-script +相手へダイアルする際に使用されるチャットスクリプトを指定します。 +後述の +.Dv set login +コマンドも参照してください。 +チャットスクリプトのフォーマットの詳細については、 +.Xr chat 8 +とコンフィギュレーションファイルの例を参照してください。 +文字列 \\\\T は現在の電話番号に置換されます (後述の +.Dq set phone +参照) 。 +文字列 \\\\P はパスワードに置換されます (後述の +.Dq set key +参照) 。 + +.It set hangup chat-script +モデムをクローズする前にこれをリセットする時に使用する、 +チャットスクリプトを指定します。 + +.It set escape value... +このオプションは上述の +.Dq set accmap +オプションに似ています。 +リンクを経由する時に「エスケープ」される文字を指定するために使用します。 + +.It set ifaddr [myaddr [hisaddr [netmask [triggeraddr]]]] +このコマンドは、IPCP 交渉の間使用される IP アドレスを指定します。 +アドレスのフォーマットは以下の通りです。 + +.Dl a.b.c.d/n + +a.b.c.d は IP アドレスであり、 +n はこのうち何ビットが有効であるかを示します。 +もし /n ビットが省略された場合、デフォルトの /32 になります。 +ただし IP アドレスが 0.0.0.0 である場合には、マスクのデフォルトは /0 です。 + +.Dq triggeraddr +が指定された場合、この値が +.Dq myaddr +の代りに IPCP 交渉で使用されます。 +ただし、 +.Dq myaddr +の範囲のアドレスのみ受け入れられます。 + +.It set loopback on|off +.Dq on +に設定された場合 (デフォルトです)、 +宛先アドレスが ppp インタフェースのアドレスと同一の送出パケットを、 +.Nm +は自動的にループバックさせます。 +.Dq off +に設定された場合、 +.Nm +はパケットを送信します。 +この場合おそらく相手方で ICMP リダイレクトが発生します。 + +.It set log [+|-]value... +このコマンドにより現在のログレベルを修正できます。 +詳細はログ機能の節を参照してください。 + +.It set login chat-script +このチャットスクリプトはダイアルスクリプトを補います。 +もし両方が指定された場合、ダイアルスクリプトの後で、 +ログインスクリプトが実行されます。 +ダイアルスクリプト中で使用可能なエスケープシーケンスはここでも使用可能です。 + +.It set mru value +デフォルトの MRU は 1500 です。 +この値を増加させた場合、相手は MTU を増加させても *かまいません*。 +デフォルトの MRU より減らすことは意味がありません。 +なぜなら、PPP プロトコルでは少なくとも 1500 オクテッドのパケットを +受信できなければ *ならない* からです。 + +.It set mtu value +デフォルトの MTU は 1500 です。 +相手が指定した MRU によって増加させることができます。 +MTU はこのオプションによってのみ減らすことが可能です。 +この値を増加させることは無効です。 +なぜなら、相手は大きくなったパケットを受信できる保証が無いからです。 + +.It set openmode active|passive +デフォルトでは、openmode は常に active です。 +この場合、 +.Nm +はいつでも LCP/IPCP/CCP の交渉を開始します。 +相手が交渉開始するのを待ちたい場合は、値 +.Dq passive +を使用します。 + +.It set parity odd|even|none|mark +ラインのパリティを設定できます。デフォルト値は none です。 + +.It set phone telno[|telno]...[:telno[|telno]...]... +ダイアルおよびログインのチャットスクリプトで使用される \\\\T 文字列が +置き換えられる電話番号を指定できます。 +複数の電話番号をパイプ (|) もしくはコロン (:) で区切って指定可能です。 +パイプの後の番号がダイアルされるのは、 +直前の番号へのダイアルもしくはログインのスクリプトが失敗した場合のみです。 +ラインの切断の理由にかかわらず、 +コロンで区切られた番号は順番に試行されます。 +複数の番号を指定した場合、接続が確立するまで +.Nm +はこのルールに基いてダイアルします。 +再試行の最大値は、後述の +.Dq set redial +で指定します。 +.Fl background +モードでは各番号は最大 1 回試行されます。 + +.It set reconnect timeout ntries +(CD の喪失もしくは LQR の失敗により) 予想外のライン切断となった場合、 +指定した +.Dq timeout +の後に接続が再確立されます。 +ラインは最大 +.Dq ntries +回、再接続されます。 +.Dq ntries +のデフォルトは 0 です。 +.Dq timeout +に +.Dq random +を指定すると、0 から 30 秒の間の任意時間の停止となります。 + +.It set redial seconds[.nseconds] [attempts] +.Nm ppp +に +.Dq attempts +回のリダイアルを指示できます。 +1 より大きな数を指定した場合 (上述の +.Dq set phone +参照)、 +各番号にダイアルする前に、 +.Dq nseconds +だけ停止します。 +最初の番号にダイアル開始する前に +.Dq seconds +だけ停止します。 +.Dq random +もここで使用できます。 + +.It set stopped [LCPseconds [IPCPseconds [CCPseconds]]] +このオプションが指定されると、 +指定した有限状態機械が停止状態になってから +.Dq seconds +で指定した秒数だけ停止したのち、 +.Nm +はタイムアウトします。 +このオプションが便利かもしれないのは、 +ppp が停止状態になったことにより返事をしないといった状態を見る場合です。 +.Dq set log +lcp +ipcp +ccp +を使用すると、 +.Nm +は全状態遷移をログします。 +.Pp +デフォルト値は 0 であり、 +停止状態による ppp のタイムアウトは発生しません。 + +.It set server|socket TcpPort|LocalName|none [mask] +通常、対話モードでない場合には、 +.Nm +はコマンド接続を受け入れるために TCP ソケットを listen します。 +デフォルトのソケット番号は、3000 + +.Nm +がオープンしたトンネルデバイス番号で計算されます。 +例えば、 +.Nm +が tun2 をオープンした場合、ソケット 3002 を使用します。 +.Pp +このコマンドを使用すると、 +ポート番号やローカルドメインソケット (絶対ファイル名として指定) を指定可能 +ですし、 +.Nm +にコマンド接続を拒否させることも可能です。 +ローカルドメインソケットが指定された場合、 +ソケット作成の前にオクテットマスクを指定可能です。 +.Dv USR1 +シグナルの使用方法も参照してください。 + +.Pp +.Nm +をサーバソケットと共に使用する場合、通信機構として +.Xr pppctl 8 +コマンドを使用する方が好ましいです。 +現在 +.Xr telnet 1 +も使用可能ですが、将来リンク暗号化が実装されますので、 +.Nm telnet +に依存しないようにしてください。 + +.It set speed value +シリアルデバイスの速度を指定します。 + +.It set timeout Idle [ lqr [ retry ] ] +アイドルタイマ、 +(有効にされているなら )LQR タイマ、 +リトライタイマの値を指定します。 + +.It set ns x.x.x.x y.y.y.y +このオプションは交渉される Microsoft DNS サーバを設定します。 + +.It set nbns x.x.x.x y.y.y.y +このオプションは交渉される Microsoft NetBIOS DNS サーバを設定します。 + +.It set help|? +使用可能なセットコマンドのまとめを表示します。 +.El + +.It shell|! [command] +.Dq command +が指定されない場合、 +.Dv SHELL +環境変数で指定されるシェルが起動されます。 +そうでなければ指定されたコマンドが実行されます。 +擬似引数 +.Dv HISADDR , +.Dv INTERFACE , +.Dv MYADDR +は適切な値に置き換えられます。! 文字を使用した場合、 +この後のコマンドとの間にスペースが必要です。 +このコマンドはフォアグラウンドで実行されることに注意してください - +ppp はプロセスが終了するまでは実行を続けません。 +バックグラウンドでコマンド処理を行いたい場合には、 +.Dv bg +コマンドを使用してください。 + +.It show var +このコマンドを使用して、以下を確認できます: + +.Bl -tag -width 20 +.It show [adio]filter +指定したフィルタの現在の規則をリストします。 + +.It show auth +現在の authname と authkey を表示します。 + +.It show ccp +現在の CCP 統計を表示します。 + +.It show compress +現在の圧縮統計を表示します。 + +.It show escape +現在のエスケープ文字を表示します。 + +.It show hdlc +現在の HDLC 統計を表示します。 + +.It show ipcp +現在の IPCP 統計を表示します。 + +.It show lcp +現在の LCP 統計を表示します。 + +.It show loopback +現在のループバック状態を表示します。 + +.It show log +現在のログ値を表示します。 + +.It show mem +現在のメモリ統計を表示します。 + +.It show modem +現在のモデム統計を表示します。 + +.It show mru +現在の MRU を表示します。 + +.It show mtu +現在の MTU を表示します。 + +.It show proto +現在のプロトコルの総計を表示します。 + +.It show reconnect +現在の再接続値を表示します。 + +.It show redial +現在のリダイアル値を表示します。 + +.It show stopped +現在の stopped タイムアウト値を表示します。 + +.It show route +現在のルーティングテーブルを表示します。 + +.It show timeout +現在のタイムアウト値を表示します。 + +.It show msext +現在の Microsoft 拡張値を表示します。 + +.It show version +ppp の現在のバージョン番号を表示します。 + +.It show help|? +利用可能な show コマンドのまとめを表示します。 +.El + +.It term +ターミナルモードに移行します。 +キーボードからタイプした文字はモデムに送られます。 +モデムから読んだ文字はスクリーンに表示されます。 +モデムの相手側に +.Nm +の相手が認識された時には、 +.Nm +は自動的にパケットモードを有効にし、コマンドモードに戻ります。 + +.It alias ..... +このコマンドは +.Nm ppp +組込みのエイリアシング (マスカレーディング) 機能を +制御するために使用します。 +このコードが必要となるまで、 +.Nm ppp +はこのコードをロードしません。 +エイリアスライブラリがあなたのシステムにインストールされないことも +大いにありえます +(エイリアスライブラリがセキュリティ的に危険だと認識する管理者もいます)。 + +あなたのシステムでエイリアシングが有効になると、 +以下のコマンドが使用可能となります: + +.Bl -tag -width 20 +.It alias enable [yes|no] +エイリアシングを有効もしくは無効にします。 +.Fl alias +コマンドラインフラグは +.Dq alias enable yes +と同じ意味です。 + +.It alias port [proto targetIP:targetPORT [aliasIP:]aliasPORT] +このコマンドにより、 +マシン [aliasIP] の +.Dq aliasPORT +へ到着する接続を、 +.Dq targetIP +の +.Dq targetPORT +へリダイレクトします。 +proto を指定した場合、指定したプロトコルの接続のみマッチします。 +あなたのゲートウェイの後のマシンでインターネット電話等を実行したい場合に、 +このオプションは有用です。 + +.It alias addr [addr_local addr_alias] +このコマンドにより、 +.Dq addr_alias +へのデータを +.Dq addr_local +へリダイレクトします。 +あなたのゲートウェイの後で +少数の実 IP アドレスを持ち、 +これらをあなたのゲートウェイの後の特定のマシンにマップしたい場合に有用です。 + +.It alias deny_incoming [yes|no] +yes に設定した場合、ファイアウォールがパケットを落すのと同様に、 +全ての入力の接続を拒否します。 + +.It alias log [yes|no] +このオプションを指定することにより、 +種々のエイリアシングの統計と情報を、ファイル +.Pa /var/log/alias.log +にログします。 + +.It alias same_ports [yes|no] +有効になると、 +エイリアスライブラリが出力パケットのポート番号を変更しようとすることを +止めさせます。 +RPC や LPD といった、 +ウェルノウンポート (well known port) からの接続を要求する +プロトコルをサポートするのに有用です。 + +.It alias use_sockets [yes|no] +有効になると、 +エイリアスライブラリにソケットを作成させ、 +正しい ftp データ入力と IRC 接続を保証できるようになります。 + +.It alias unregistered_only [yes|no] +出力パケットを、登録されていない送信元アドレスに変更することだけを行います。 +RFC1918 に依ると、登録されていない送信元アドレスは +10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16 です。 + +.It alias help|? +このコマンドにより、 +使用可能なエイリアスコマンドのまとめを表示します。 + +.El + +.It quit|bye [all] +.Nm ppp +を終了します。 +.Nm +が対話モードであるか +.Dq all +引数が指定された場合、ppp は終了し、接続をクローズします。 +単に +.Dq quit +を telnet セッションから入力するだけでは現在の接続をクローズしません。 + +.It help|? [command] +利用可能なコマンドをリストします。 +.Dq command +を指定した場合、このコマンドの使用方法を表示します。 + +.It down +リンクを切断しますが、綺麗な方法ではありません。 +このコマンドを使用することは丁寧ではないとされています。 + +.El + +.Sh 更に詳細について + +.Bl -bullet -compact + +.It +設定ファイルの例を読んでください。良い情報源です。 + +また、 +.It +.Dq help , +.Dq show ? , +.Dq alias ? , +.Dq set ? , +.Dq set ? <var> +コマンドを使ってください。 +.El + +.Sh 関連ファイル +.Nm +は、ppp.conf, ppp.linkup, ppp.linkdown, ppp.secret を参照します。 +これらのファイルは +.Pa /etc/ppp +に置かれますが、ユーザが自分用のファイルを +.Pa .ppp.conf , +.Pa .ppp.linkup , +.Pa .ppp.linkdown , +.Pa .ppp.secret +として $HOME ディレクトリに作成することもできます。 +いつでも +.Nm +はユーザの個人設定を優先的に参照します。 + +.Bl -tag -width flag +.Pa $HOME/ppp/.ppp.[conf|linkup|linkdown|secret] +ユーザ個人の設定ファイル。 + +.Pa /etc/ppp/ppp.conf +システムのデフォルト設定ファイル。 + +.Pa /etc/ppp/ppp.secret +各システム用の認証設定ファイル。 + +.Pa /etc/ppp/ppp.linkup +.Nm +がネットワーク層の接続を確立した時に実行されるファイル。 + +.Pa /etc/ppp/ppp.linkdown +.Nm +がネットワークレベルの接続を閉じるときにチェックするファイル。 + +.Pa /var/log/ppp.log +ログとデバッグ情報のファイル。 + +.Pa /var/spool/lock/LCK..* +tty ポートをロックするためのファイル。詳細は +.Xr uucplock 8 +を参照してください。 + +.Pa /var/run/tunX.pid +tunX デバイスに接続されている ppp プログラムのプロセス id (pid) 。 +ここで 'X' はデバイスの番号です。このファイルは +.Fl background , +.Fl auto , +.Fl ddial +のいずれかのモードの時のみ作成されます。 + +.Pa /var/run/ttyXX.if +このポートで使われている tun インターフェース。 +このファイルも +.Fl background , +.Fl auto , +.Fl ddial +のいずれかのモードの時のみ作成されます。 + +.Pa /etc/services +サービス名でポート番号が指定されている場合に、ポート番号を取得します。 +.El + +.Sh 関連項目 +.Xr chat 8 , +.Xr pppd 8 , +.Xr uucplock 3 , +.Xr syslog 3 , +.Xr syslog.conf 5 , +.Xr syslogd 8 , +.Xr pppctl 8 , +.Xr telnet 1 + +.Sh 歴史 +元のプログラムは Toshiharu OHNO (tony-o@iij.ad.jp) が作成し、 +FreeBSD-2.0.5 に Atsushi Murai (amurai@spec.co.jp) が提出しました。 +多くの面で性能向上が計られたため、見た目がかなり異なります。 diff --git a/ja_JP.eucJP/man/man8/pppctl.8 b/ja_JP.eucJP/man/man8/pppctl.8 new file mode 100644 index 0000000000..fe20055386 --- /dev/null +++ b/ja_JP.eucJP/man/man8/pppctl.8 @@ -0,0 +1,164 @@ +.\" %Id: pppctl.8,v 1.1.2.3 1997/10/05 14:23:26 brian Exp % +.Dd 26 June 1997 +.Os FreeBSD +.Dt PPPCTL 8 +.Sh 名称 +.Nm pppctl +.Nd +PPP 制御プログラム +.Sh 書式 +.Nm +.Op Fl v +.Op Fl t Ar n +.Op Fl p Ar passwd +.Ar [host:]Port | LocalSocket +.Ar command +.Op Ar ;command +.Ar ... +.Sh 解説 +このプログラムは +.Nm ppp +デーモンのコマンドラインからの制御手段を提供します。 +基本的な使い方は、実行中のデーモンを制御する単純なスクリプトを +簡単に書けるようにすることです。 + +.Nm +は少なくともふたつの引数を必要とします。ひとつめは +.Nm ppp +デーモンが listen しているソケットを指定します。ソケットが +先頭に '/' を含んでいると、 AF_LOCAL ソケットとして扱われます。 +コロンを含んでいると host:port の組として扱われ、 +それ以外は単にローカルマシン (127.0.0.1) のポートを +指定したものとみなされます。 +DNS 検索を避けたい場合や、 +.Pa /etc/services +内に指定されたポートのエントリがない場合には、 +host と port には数字で指定することができます。 + +.Pp +残りの引数はすべて、 +.Nm ppp +デーモンに送られるコマンドを形成するために連結されます。 +セミコロン文字はコマンドデリミタとして扱われ、ひとつの +"セッション" で複数のコマンドを指定することが可能です。 +例えば; + + pppctl 3000 set timeout 300\\; show timeout + +ほとんどのシェルでは ';' は特殊文字として扱われるので、 +エスケープかクォートすることを忘れないようにしてください。 + +以下のコマンドラインオプションが利用可能です: +.Bl -tag -width Ds +.It Fl v +.Nm ppp +デーモンに送られたデータ、 +.Nm ppp +デーモンから受け取ったデータをすべて表示します。 +.Nm pppctl +は通常、受け取った non-prompt 行のみ表示します。 +.It Fl t Ar n +デフォルトの 2 秒の代わりに +.Ar n +をタイムアウトの値として用います。 +これは (dialup も含む) 遅いリンク上でデーモンを制御しようとする +場合に必要かもしれません。 +.It Fl p Ar passwd +.Nm ppp +デーモンが必要とするパスワードを指定します。 +このスイッチが指定されないと、 +.Nm +は +.Nm ppp +への接続が成功した時にパスワードの入力を促します。 +.El + +.Sh 使用例 +.Nm ppp +を +.Fl auto +モードで実行する場合、 +.Nm +は多くの仕事を自動化するのに利用できます。 +.Xr ps 1 +によりあなたの秘密がもれてしまう可能性のために、 +.Fl p +オプションは +(たとえスクリプトが他の人に読めないようになっていたとしても) +お勧めできません。 +.Pp +.Nm pppctl +と共に利用可能なソケットを +.Nm ppp +が作るようにするためには、ローカルシステムに +パスワードを設定する必要があります。 +.Bd -literal -offset indent +# touch /etc/ppp/ppp.secret +# chown root.wheel /etc/ppp/ppp.secret +# chmod 400 /etc/ppp/ppp.secret +# echo "`hostname -s` MyPassword" >>/etc/ppp/ppp.secret +.Ed + +.Pp +簡単で安全に +.Nm +へアクセスできるようにしたり、 +.Nm ppp +をいくつも起動した場合にそれらを識別したりする最も安全な方法は、 +.Pa /etc/ppp/ppp.conf +(の正しいセクション) にローカルサーバソケットを作成することです: + +.Bd -literal -offset indent +set server /var/run/internet 0666 +.Ed + +これはデフォルトで作られる tcp ソケットではなく、 +ローカルドメインソケットを作成するように +.Nm ppp +に指示します。より詳しい解説はマニュアルページ +.Xr ppp 8 +を参照してください。 + +.Pp +このようにするといくつかのお気楽スクリプトが作成可能になります。 +インターネットに接続するには: + +.Bd -literal -offset indent +#! /bin/sh +test $# -eq 0 && time=300 || time=$1 +exec pppctl -t 60 /var/run/internet set timeout $time\\; dial +.Ed + +.Pp +切断するには: +.Bd -literal -offset indent +#! /bin/sh +exec pppctl /var/run/internet set timeout 300\\; close +.Ed + +.Pp +接続されているかどうか確かめるには: +.Bd -literal -offset indent +#! /bin/sh +pppctl -p '' -v /var/run/internet '' | grep ^PPP >/dev/null +if [ $? -eq 0 ]; then + echo Link is up +else + echo Link is down +fi +.Ed + +.Pp +このような汎用スクリプトも作成可能です: +.Bd -literal -offset indent +#! /bin/sh +exec pppctl /var/run/internet "$@" +.Ed + +.Sh 関連項目 +.Xr ppp 8 , +.Xr services 5 + +.Sh 歴史 +.Nm +コマンドは FreeBSD 2.2.5 で最初に登場しました。 diff --git a/ja_JP.eucJP/man/man8/pppd.8 b/ja_JP.eucJP/man/man8/pppd.8 new file mode 100644 index 0000000000..0f169e45f9 --- /dev/null +++ b/ja_JP.eucJP/man/man8/pppd.8 @@ -0,0 +1,844 @@ +.\" manual page [] for pppd 2.0 +.\" %Id: pppd.8,v 1.7.2.2 1997/05/07 23:57:42 brian Exp % +.\" jpman %Id: pppd.8,v 1.2 1997/05/27 00:43:48 mutoh Stab % +.\" SH section heading +.\" SS subsection heading +.\" LP paragraph +.\" IP indented paragraph +.\" TP hanging label +.TH PPPD 8 +.SH 名称 +pppd \- PPP(Point to Point Protocol) を処理するデーモン +.SH 書式 +.B pppd +[ +.I options +] [ +.I tty_name +] [ +.I speed +] +.SH 解説 +.LP +Point-to-Point プロトコル (PPP) は、シリアル回線上に確立された +Point-to-Point リンクを介したデータグラムの送受方法を提供します。 +PPP は、データグラムのカプセル化方式、拡張可能なリンク制御プロトコル (LCP)、 +そして異なるネットワーク層プロトコルの設定とコネクションの確立を行なう +一群のネットワーク制御プロトコル (NCP) の 3 つの部分から構成されています。 +.LP +カプセル化体系は、カーネル内のドライバコードにより提供されています。 +.B pppd +は、基本的な LCP 機能、認証機能、そして IP コネクションの確立と設定を行なう +NCP(IP Control Protocol(IPCP) と呼ばれています)を提供します。 +.SH よく使われるオプション +.TP +.I <tty_name> +使用するシリアルポートの特殊ファイル名を指定します。 +もし必要であれば、特殊ファイル名の前に"/dev/"文字列が追加されます。 +デバイス名が指定されていない場合や制御端末の名前が与えられた場合には、 +.I pppd +は自らの制御端末をコネクションの確立に使用し、 +バックグラウンド実行のための fork を行ないません。 +.TP +.I <speed> +tty の速度を設定します。4.4BSD や NetBSD では任意の速度を指定することが +できます。その他のシステム (SunOS 等) では一定の組合せのみが指定可能です。 +.TP +.B asyncmap \fI<map> +非同期キャラクタマップを <map> に設定します。 +このマップは、シリアル回線を経由するとどのコントロールキャラクタの受信が +うまくいかなくなるかを記述するものです。 +.I pppd +は、相手側にこれらのキャラクタを 2 バイトのエスケープシーケンスとして +送信するよう依頼します。 +引数は 32 ビットの 16 進数であり、各ビットがエスケープするべきキャラクタを +表しています。 +ビット 0 (00000001) はキャラクタ 0x00 をあらわし、 +ビット 31 (80000000) は、キャラクタ 0x1f '^_' をあらわしています。 +複数の \fBasyncmap\fR オプションが与えられた場合、それらの値の論理和が +採用されます。 +\fBasyncmap\fR が与えられなかった場合には、このホストが受信側となる +非同期キャラクタマップは設定されません。 +相手側はすべてのコントロールキャラクタをエスケープして送信します。 +.TP +.B auth +ネットワークパケットの送受信を許可する前に、相手側に自分自身の認証を +行なうよう要求します。 +.TP +.B connect \fI<p> +\fI<p>\fR で指定された実行可能コマンドまたはシェルコマンドを +シリアル回線のセットアップに用います。 +ほとんどの場合ここで指定されるスクリプトには、 +モデムにダイヤルコマンドを送ったり リモート ppp セッションを +開始したりするための "チャット(chat)" プログラムを使用します。 +.TP +.B connect-max-attempts \fI<n> +指定した時間 (デフォルトでは 1)以上 リモートシステムとの +ダイアルコネクションを保持しません。コネクションができない場合は、 +pppd は終了します。 \fBpersist\fR を指定することが要求されます。 +.TP +.B crtscts +シリアルポートのフロー制御にハードフロー制御 (RTS/CTS) を用います。 +.TP +.B -crtscts +シリアルポートのハードウエアフロー制御 (RTS/CTS) を使いません。 +\fBcrtscts\fR か \fB\-crtscts\fR の両方のオプションが与えられない時、 +シリアルポートのハードウエアフロー制御の設定は変更されずに +そのままになります。 +.TP +.B xonxoff +シリアルポートのフロー制御に XON/XOFF キャラクタによるフロー制御を用います。 +現時点では、このオプションは Linux では実装されていません。 +.TP +.B defaultroute +IPCP ネゴシエーションが成功すると、相手側をゲートウェイとする +デフォルトルートをシステムのルーティングテーブルに追加します。 +このオプションにより追加されたデフォルトルートエントリは、 +PPP コネクションが切断された際に削除されます。 +.TP +.B disconnect \fI<p> +pppd が接続を切った後に \fI<p>\fR で指定した実行可能コマンドまたは +シェルコマンドを実行します。 +このスクリプトで、例えばハードウェアモデム制御信号 (DTR) が使えない場合に +モデムに回線切断のコマンドを発行することができます。 +.TP +.B escape \fIxx,yy,... +転送時にエスケープを行なうべきキャラクタを指定します(相手側が +非同期キャラクタマップでエスケープを要求しているかどうかには影響されません)。 +エスケープされるキャラクタは、カンマで区切られた 16 進の数字で指定します。 +コントロールキャラクタしか指定できない非同期キャラクタマップ (asyncmap) +とは異なり、\fBescape\fR オプションではどんなキャラクタでも指定できる +ことに注意してください。 +ただし 16 進表記で 0x20 から 0x3f までと 0x5e のキャラクタは +エスケープするべきではありません。 +.TP +.B file \fI<f> +オプションをファイル <f> から読み込みます(フォーマットは後述します)。 +.TP +.B lock +シリアルデバイスに対する排他アクセスを確実に行なうために、 +UUCP 形式のロックファイルを作成するよう \fIpppd\fR に指示します。 +.TP +.B mru \fI<n> +ネゴシエーション時の MRU [Maximum Receive Unit] 値を <n> に設定します。 +.I pppd +は、通信相手に <n> バイトを超えるパケットを送信しないよう要求します。 +最小の MRU 値は、128 です。 +デフォルトの MRU 値は 1500 です。低速のリンクでは 296 を推奨します。 +(TCP/IP ヘッダ 40 バイト + データ 256 バイト). +.TP +.B netmask \fI<n> +インターフェースの netmask を <n> に設定します。 +32 bit の netmask を、255.255.255.0 のように、 +10 進 + ピリオド表記 (符号付き 10 進表現) で指定します。 +.TP +.B dns1 \fI<n> +接続先が プライマリ DNS サーバを聞いてきた場合、このアドレスを答えます。 +32 bit IP アドレスを 符号付き 10 進表現で指定します。 +.TP +.B dns2 \fI<n> +接続先が セカンダリ DNS サーバを聞いてきた場合、このアドレスを答えます。 +32 bit IP アドレスを 符号付き 10 進表現で指定します。 +.TP +.B passive +LCP で "passive" オプションを有効にします。このオプションを指定した場合には、 +コネクションを開始しようとしても相手からの返答がない場合、 +.I pppd +は相手から有効な LCP パケットが到着するのを待ち続けます。 +(このオプションを指定しなければ、相手からの返答がない場合に +.I pppd +は実行を中断します。) +.TP +.B silent +このオプションを指定した場合、 +.I pppd +は相手から有効な LCP パケットを受信するまで +接続を開始するための LCP パケットを送信せずに待ちます。 +(旧バージョンの \fIpppd\fR で 'passive' オプションを指定した場合と +同じ動作です。) +.SH オプション +.TP +.I <local_IP_address>\fB:\fI<remote_IP_address> +ローカルインターフェースとリモートインターフェースの IP アドレスを設定します。 +どちらか一方を省略することも可能です。IP アドレスは、ホスト名もしくは +符号付き 10 進表現 (例 :150.234.56.78) のどちらでも指定可能です。 +デフォルトのローカルアドレスは、そのシステムの ( 最初の )IP アドレスと +なります。( ただし +.B noipdefault +オプションが指定された場合を除きます。) リモートアドレスは、 +オプションで指定されていない場合には相手側から取得されます。 +ですから、もっとも単純な指定を行う場合には、このオプションは不必要です。 +ローカルまたはリモートの IP アドレスがこのオプションで指定されている場合には、 +.I pppd +は IPCP ネゴシエーションで相手側がこの指定と異なるアドレスを送って来た場合 +これを拒否します。ただし、 +.B ipcp-accept-local +や +.B ipcp-accept-remote +が指定されている場合にはこの限りではありません。 +.TP +.B -all +LCP や IPCP でのオプションによるネゴシエーションは +要求も許可もされません。(デフォルト値を用います。) +.TP +.B -ac +Address/Control 圧縮ネゴシエーションを無効にします +( これがデフォルトで、address/control フィールドの圧縮は通常行なわれません)。 +.TP +.B -am +asyncmap ネゴシエーションを無効にします(デフォルトの asyncmap が用られ、 +全てのコントロールキャラクタがエスケープされます)。 +.TP +.B -as \fI<n> +.B asyncmap \fI<n> +と同じ意味です。 +.TP +.B -d +デバッグレベルを増やします。(\fBdebug\fR オプションと同じ意味です。) +.TP +.B -detach +バックグラウンドプロセスになるための fork を行ないません( +.I pppd +は、シリアルデバイスが指定されていて +このオプションが指定されていない場合もしくはシリアルデバイスが +制御端末ではない場合には fork します)。 +.TP +.B -ip +IP アドレスネゴシエーションを無効にします +(このオプションを指定した場合には、リモート IP アドレスを +コマンドラインもしくはオプションファイルで指定する必要があります)。 +.TP +.B -mn +magic number ネゴシエーションを無効にします。このオプションを指定した場合には、 +.I pppd +はループバック回線を検出することができません。 +.TP +.B -mru +MRU [Maximum Receive Unit] ネゴシエーションを無効にします +( デフォルトの MRU 値の 1500 を使用します)。 +.TP +.B -p +.B passive +オプションと同じ意味です。 +.TP +.B -pc +プロトコルフィールド圧縮ネゴシエーションを無効にします +(これがデフォルトで、プロトコルフィールドの圧縮は通常無効になっています)。 +.TP +.B +ua \fI<p> +相手側から PAP [Password Authentication Protocol] による認証を +要求された場合には、それに同意します。そしてファイル <p> に記述された +データを用いてユーザ名とパスワードを相手に送ります。 +このファイルには、リモートのユーザ名と改行が格納され、 +続いてリモートパスワードと改行が格納されています。 +このオプションは旧式です。 +.TP +.B +pap +PAP を用いて自分自身の認証を行なうよう相手に要求します。 +.TP +.B -pap +PAP による認証を拒否します。 +.TP +.B +chap +CHAP [Challenge Handshake Authentication Protocol] を用いて +自分自身の認証を行なうことを相手に要求します。 +.TP +.B -chap +CHAP による認証を拒否します。 +.TP +.B -vj +Van Jacobson 形式の IP ヘッダ圧縮のネゴシエーションを無効にします +(これがデフォルトで、ヘッダの圧縮は通常行なわれません)。 +.TP +.B bsdcomp \fInr,nt +接続相手に、BSD圧縮方式を使った送出時のパケット圧縮を要求します。 +ここでの最大コードサイズは \fInr\fR ビットです。 +相手側が送るパケットの最大の大きさは、 \fInt\fR ビットです。 +\fInt\fR が指定されない時は、デフォルトの値が使われます。 +9 から 15 の範囲の値が、 \fInr\fR と \fInt\fR で使われます。 +より大きな値は、よりよい圧縮となりますが、圧縮辞書のためにより多くの +カーネルメモリを消費します。\fInr\fR や \fInt\fR に対して、値 0 を +指定すると、圧縮を指定した方向には行いません。 +.TP +.B \-bsdcomp +圧縮を行いません。 \fBpppd\fR は、BSD 圧縮方式を使ったパケットの圧縮を +要求しませんし、許可もしません。 +.TP +.B debug +デバッグレベルを増加させます (\fB\-d\fR と同じ意味です)。 +このオプションを指定した場合、\fIpppd\fR は送受信した +すべての制御パケットの内容を可読形式でログをとります。 +パケットは syslog を経由して、\fIdaemon\fR ファシリティの +\fIdebug\fR レベルとして記録されます。 +本情報は、/etc/syslog.conf を適切に記述することで +ファイルに記録することができます(syslog.conf(5) 参照)。 +(もし \fIpppd\fR が extra debugging オプションを有効にして +コンパイルされていれば、\fIdaemon\fR ファシリティの +かわりに \fIlocal2\fR ファシリティを使用してメッセージを記録します。) +.TP +.B \-defaultroute +\fBdefaultroute\fR オプションを無効にします。 +\fIpppd\fR を使っているユーザにデフォルトルートを作成させたくない +システム管理者は、このオプションを /etc/ppp/options ファイルに +記述することができます。 +.TP +.B domain \fI<d> +認証のために使用するローカルホスト名にドメイン名 <d> を付加します。 +例えば、FQDN が porsche.Quotron.COM であって、 +gethostname() が porsche という名前を返す場合には、 +このオプションを用いてドメイン名を Quotron.COM と指定します。 +.TP +.B ipparam \fIstring +ip-up と ip-down スクリプト用に余分のパラメータを指定します。 +このオプションが与えられた場合、 \fIstring\fR が 6 番目のパラメータと +して、これらのスクリプトに与えられます。 +.TP +.B modem +モデム制御線を使用します。このオプションはデフォルトです。 +このオプションを使うことで、 +.B pppd +は、シリアルデバイスをオープンした時に +(接続スクリプトが指定されていなくても) +モデムから CD (Carrier Detect) 信号が送られるのを待ちます。 +そして、接続が中断された時や接続スクリプトが終了する時に、 +DTR (Data Terminal Ready) 信号を落します。 Ultrix では、 +このオプションは、 \fBcrtscts\fR オプションのように +ハードワイアフロー制御を実行します。 +.TP +.B kdebug \fIn +カーネルレベルの PPP ドライバのデバッグコードを有効にします。 +引数 \fIn\fR として、以下の数値のうち必要なものの合計を指定します。 +1 は一般的なデバッグメッセージ出力を有効にします。 +2 は受信したパケットの内容の出力を要求します。 +4 は送信したパケットの内容の出力を要求します。 +.TP +.B local +モデム制御線を使用しません。 +.B pppd +は、モデムからの CD (Carrier Detect) 信号の状態を無視し、 +DTR (Data Terminal Ready) 信号の状態を変化しません。 +.TP +.B mtu \fI<n> +MTU [Maximum Transmit Unit] 値を \fI<n>\fR に設定します。 +相手が MRU ネゴシエーションを通じてこれより小さい値を要求してこない限り、 +\fIpppd\ は、PPP ネットワークインタフェースを通して \fIn\fR バイトを +越えないデータパケットを送ることをカーネルのネットワークコードに要求します。 +.TP +.B name \fI<n> +認証の目的で用いられるローカルシステムの名前を <n> に設定します。 +.TP +.B user \fI<u> +PAP を用いてこのマシンの認証を行なう際に用いるユーザ名を <u> に設定します。 +.TP +.B usehostname +認証時にホスト名をローカルシステムの名前として使用することを強制します。 +( +このオプションは +.B name +オプションに優先します。 +) +.TP +.B remotename \fI<n> +リモートシステムの名前を <n> とみなして認証を行ないます。 +.TP +.B papcrypt +相手の同一性を調べるために使われる +/etc/ppp/pap-secrets ファイル内の全ての秘密を暗号化することを +指示します。そして、 pppd は、 (暗号化前の) /etc/ppp/pap-secrets +ファイルからの秘密と等かであってもパスワードを受け入れません。 +.TP +.B proxyarp +自システムの ARP [Address Resolution Protocol] テーブルに相手の IP アドレス +と自イーサネットアドレスを追加します。 +.TP +.B \-proxyarp +\fBproxyarp\fR オプションを使いません。\fIpppd\fR のユーザに +proxy ARP エントリを作成させたくないシステム管理者はこのオプションを +/etc/ppp/options ファイルに記述することでそのようにできます。 +.TP +.B persist +接続が切断された後で終了しません。代わりに再接続しようとします。 +.TP +.B login +PAP を用いた相手の認証に、システムパスワードデータベースを用います。 +.TP +.B noipdefault +ローカル IP アドレスが指定されない場合にデフォルトで行なわれる、 +ホスト名から IP アドレスを ( 可能であれば ) 決定する動作を無効にします。 +このオプションを指定した場合には、IPCP ネゴシエーション時に +相手側がローカルの IP アドレスを指定する必要があります +(明示的にコマンドラインで指定されているか、 +オプションファイルで指定されている場合を除きます)。 +.TP +.B lcp-echo-interval \fI<n> +このオプションを指定すると、\fIpppd\fR は LCP echo-request frame を +\fIn\fR 秒毎に相手側に送信します。Linux では、相手側からのパケットが +\fIn\fR 秒間途切れた場合に echo-request が相手側に送信されます。 +通常、相手側は echo-request を受信すると echo-reply を送り返して返答します。 +このオプションは、相手側との接続が切れたことを検出するために +\fIlcp-echo-failure\fR オプションとともに使用されます。 +.TP +.B lcp-echo-failure \fI<n> +このオプションが指定された場合、 LCP echo-request を \fIn\fR 回送信しても +相手から有効な LCP echo-reply が帰ってこなければ、\fIpppd\fR は +相手がダウンしているものと推測します。このような場合、\fIpppd\fR は +コネクションを切断します。このオプションを使用する際には、 +\fIlcp-echo-interval\fR のパラメータとして 0 以外の数値を指定して下さい。 +このオプションは、ハードウェアモデム制御線 (DSR) が使用できない状況で、 +( モデムが回線を切断するなどの ) 物理的なコネクションが切断された後に +\fIpppd\fR を終了するために用いられます。 +.TP +.B lcp-restart \fI<n> +( 再送のタイムアウトによる ) LCP restart の間隔を <n> 秒に設定します。 +デフォルト値は 3 です。 +.TP +.B lcp-max-terminate \fI<n> +LCP terminate-request の最大送信回数を <n> 回に設定します。 +デフォルト値は 3 です。 +.TP +.B lcp-max-configure \fI<n> +LCP configure-request の最大送信回数を <n> 回に設定します。 +デフォルト値は 10 です。 +.TP +.B lcp-max-failure \fI<n> +LCP configure-Rejects を送信開始するまでの LCP configure-NAKs 最大応答回数を +<n> 回に設定します。デフォルト値は 10 です。 +.TP +.B ipcp-restart \fI<n> +( 再送のタイムアウトによる ) IPCP restart の間隔を <n> 秒に設定します。 +デフォルト値は 3 です。 +.TP +.B ipcp-max-terminate \fI<n> +IPCP terminate-request の最大送信回数を <n> 回に設定します。 +デフォルト値は 3 です。 +.TP +.B ipcp-max-configure \fI<n> +IPCP configure-request の最大送信回数を <n> 回に設定します。 +デフォルト値は 10 です。 +.TP +.B ipcp-max-failure \fI<n> +IPCP configure-Rejects を送信開始するまでの IPCP configure-NAKs 最大応答回数を +<n> 回に設定します。デフォルト値は 10 です。 +.TP +.B pap-restart \fI<n> +( 再送のタイムアウトによる ) PAP restart の間隔を <n> 秒に設定します。 +デフォルト値は 3 です。 +.TP +.B pap-max-authreq \fI<n> +PAP authenticate-request の最大送信回数を <n> 回に設定します。 +デフォルト値は 10 です。 +.TP +.B pap-timeout \fI<n> +.I pppd +が PAP において接続先の認証のために待機する最大時間を <n> 秒に +設定します(0 は制限を設けないことを意味します)。 +.TP +.B chap-restart \fI<n> +( 再送のタイムアウトによる ) CHAP restart の間隔を <n> 秒に設定します。 +デフォルト値は 3 です。 +.TP +.B chap-max-challenge \fI<n> +CHAP challenge の最大送信回数を <n> 回に設定します。 +デフォルト値は 10 です。 +.TP +.B chap-interval \fI<n> +このオプションが指定された場合、 +.I pppd +は <n> 秒おきに CHAP challenge を再送信します。 +.TP +.B ipcp-accept-local +このオプションが指定された場合には、 +別のオプションによってローカル IP アドレスの指定が行なわれている場合でも、 +.I pppd +は相手からのローカル IP アドレスの指定を受け入れます。 +.TP +.B ipcp-accept-remote +このオプションが指定された場合には、 +別のオプションによってリモート IP アドレスの指定が行なわれている場合でも、 +.I pppd +は相手からのリモート IP アドレスの指定を受け入れます。 +.SH オプションファイル +オプションは、コマンドラインから与えられるのと同様に、 +ファイルに記述されたものを用いることも可能です。 +.I pppd +は、コマンドラインからのオプションを +読み込む前に /etc/ppp/options および ~/.ppprc から +オプションを読み込みます。オプションファイルの内容は、 +空白文字をデリミタとする単語の並びとして解釈されます。 +空白文字を含む文字列はダブルクォート (") で囲うことで +1 つの文字列として解釈されるようになります。 +バックスラッシュ (\\) は、直後の 1 キャラクタをクォートします。 +シャープ文字 (#) はコメントの始まりとして解釈され、 +改行までをコメントとみなします。 +.SH 認証 +.I pppd +は、正当なユーザに対するサーバマシンへの PPP アクセスを提供しつつ、 +サーバ自身やそのサーバが存在するネットワークのセキュリティを危険に +さらす心配のない、充分なアクセス制御をシステム管理者に提供します。 +このアクセス制御の一部は、 +/etc/ppp/options ファイルにより提供されます。 +このファイルでシステム管理者は +.I pppd +が実行される時には常に認証を要求するように +オプションを設定することができます。 +また一部は、PAP や CHAP のシークレットファイルにより提供されます。 +このファイルで個々のユーザが使用する IP アドレスの組を +管理者が制限することができます。 +.LP +.I pppd +のデフォルトの挙動は、もし認証の要求があればそれを受け入れ、 +相手側には認証を要求しないというものです。 +ただし、 +.I pppd +がその認証を行なうのに必要なシークレットを持っていない +特定のプロトコルによる認証は拒否します。 +.LP +認証はシークレットファイルから選ばれたシークレットをベースにしています。 +(PAP では /etc/ppp/pap-secrets が、CHAP では /etc/ppp/chap-secrets が +シークレットファイルです。) +どちらのシークレットファイルも同じフォーマットになっており、 +どちらもサーバ ( 認証する側 ) とクライアント ( 認証される側 ) の +それぞれの組合せを記録しておくことができます。 +.I pppd +はサーバにもクライアントにもなれることと、必要ならそれぞれの方向で +異なったプロトコルを使用した認証ができることに注意してください。 +.LP +シークレットファイルはオプションファイルと同じように単語の並びとして +解釈されます。一組のシークレットは最低でも 3 つの単語を含む 1 つの行として +指定され、3 つの単語はそれぞれクライアント名・サーバ名・シークレットとして +解釈されます。残りの単語があれば、それはクライアント側で +使用可能な IP アドレスのリストとして解釈されます。 +もしその行に 3 つの単語しかない場合は、どのような IP アドレスでも受け入れ +可能であると仮定されます。全ての IP アドレスを禁止するには "-" を使います。 +もしシークレットが一個の `@' で始まる場合には、続く文字列がシークレットを +読み込むファイルの名前であると仮定されます。 +クライアント名またはサーバ名が "*" であれば、それはどのような名前とも +マッチします。 +シークレットを選択する際、\fIpppd\fR は最も良くマッチするものを選びます。 +つまり、最もワイルドカードの少ないマッチが選ばれます。 +.LP +このように、シークレットファイルは他のホストを認証するための +シークレットに加えて、自分自身を他のホストに認証させるための +シークレットを含んでいます。 +どのシークレットを使うかは、自分の名前 ( ローカル名 ) と +相手側の名前 ( リモート名 ) をベースにして選ばれます。 +ローカル名は以下のようにしてセットされます。 +.TP 3 +\fBusehostname\fR オプションが指定されていれば、 +ローカル名はそのマシンのホスト名になります +( domain が指定されていれば追加されます)。 +.TP 3 +そうではなく、\fBname\fR が指定されていれば +最初の \fBname\fR オプションの引数が使われます。 +.TP 3 +そうではなく、ローカル IP アドレスがホスト名で指定されていれば +そのホスト名が使われます。 +.TP 3 +何も指定されていない場合は、このマシンのホスト名が使われます +( domain が指定されていれば追加されます)。 +.LP +PAP を使用して自分の認証を行なう場合、ユーザ名というものがありますが、 +デフォルトではローカル名が使われます。 +しかし、\fBuser\fR オプションまたは \fB+ua\fR オプションで +ユーザ名をセットすることができます。 +.LP +リモート名は以下のようにしてセットされます。 +.TP 3 +\fBremotename\fR オプションが指定されていれば、 +最後の \fBremotename\fR の引数が使われます。 +.TP 3 +そうではなく、リモート IP アドレスがホスト名で指定されていれば、 +そのホスト名が使用されます。 +.TP 3 +何も指定されていない場合、リモート名は空文字列 "" になります。 +.LP +PAP シークレットファイルからのシークレットの選択は +以下のように行なわれます。 +.TP 2 +* +相手側の認証を行なう場合には、PAP 認証要求で指定されたユーザ名が +クライアント名と一致し、サーバ名がローカル名と一致する +シークレットが選ばれます。 +.TP 2 +* +相手側に自分を認証してもらう場合には、クライアント名がユーザ名と +一致し、サーバ名がリモート名と一致するシークレットを探します。 +.LP +相手側を PAP で認証する際に、"" というシークレットは相手側から +送られてきた任意のパスワードとマッチします。 +もしパスワードがシークレットとマッチしなければ、 +パスワードは crypt() を使用して暗号化され、再びシークレットと +比較されます。このため相手側の認証に使用するシークレットは +暗号化された形式で記録することができます。 +\fBpapcrypt\fR オプションが与えられた場合、よりよいセキュリティのため +最初の (暗号化されていない) 比較対象は除外されます。 +.LP +もし \fBlogin\fR オプションが指定されていれば、ユーザ名とパスワードも +システムパスワードデータベースでチェックされます。 +このためシステム管理者は特定のユーザだけに PPP アクセスを +許可し、個々のユーザが使用できる IP アドレスの組を +制限するよう pap-secrets ファイルをセットアップすることができます。 +典型的には、\fBlogin\fR オプションを使う時に、 /etc/ppp/pap-secrets +中の シークレット部分を "" とすることで、同じシークレットが二つの +場所で必要とされることを避けることができます。 +.LP +\fBlogin\fR オプションが使われている時には、更なる確認が行われます。 +/etc/ppp/ppp.deny が存在して、ユーザがそこに記述されている場合、 +認証は失敗します。 /etc/ppp/ppp.shells が存在して、ユーザの普通の +ログインシェルが記述されていない場合、認証は失敗します。 +.LP +CHAP シークレットファイルからのシークレットの選択は +以下のように行なわれます。 +.TP 2 +* +相手側の認証を行なう場合には、CHAP-Response メッセージで指定された +名前がクライアント名と一致し、サーバ名がローカル名と一致する +シークレットを探します。 +.TP 2 +* +相手側に自分を認証してもらう場合には、クライアント名がローカル名と +一致し、CHAP-Challenge メッセージで指定された名前がサーバ名と一致する +シークレットを探します。 +.LP +認証は IPCP (またはその他の NCP) が開始される前に納得のいくように +完了している必要があります。 +もしも認証に失敗すると、\fIpppd\fR は (LCP をクローズすることで) +リンクを切断します。 +もし IPCP で得られたリモートホストの IP アドレスが受け入れられない +ものであった場合、IPCP はクローズされます。 IP パケットは IPCP が +オープンしている時だけ送受信可能です。 +.LP +ローカルホストが一般的に認証を必要とする時でも、 +接続を行い限定された IP アドレスの組の一つを使うために +自分自身の認証を行うことができないようないくつかのホストに対して、 +接続を認める必要がある場合もあります。 +もし相手側がこちらの認証要求を拒否した場合、\fIpppd\fR はそれを +ユーザ名とパスワードが空文字列である PAP 認証として扱います。 +そこで、クライアント名とパスワードに空文字列を指定した 1 行を +pap-secrets ファイルに追加することで、自分自身の認証を拒否する +ホストにも制限つきのアクセスを許可することができます。 +.SH 経路制御 +.LP +IPCP negotiation が成功した場合、 +.I pppd +はカーネルに、PPP インタフェースで用いるローカル IP アドレスおよび +リモート IP アドレスを通知します。これは、相手側と IP パケットを交換する +リンクのリモート終端への経路を作成するのに充分な情報です。 +サーバ以外のマシンとの通信には、一般的にはルーティング +テーブルや ARP テーブルのさらなる更新が必要となります。 +いくつかのケースでは、これらのテーブルの +更新は \fIrouted\fR や \fIgated\fR などのデーモンプロセスが +自動的に行なってくれます。 +しかし、大半のケースでは、さらに何らかの介入が必要となります。 +.LP +インターネットへの接続を PPP インタフェース経由のみで行なうマシンの +場合には、リモートホストを通る default route の追加が +しばしば必要となる場合があります。 +\fBdefaultroute\fR オプションは、IPCP が完了した際に \fIpppd\fR に +そのような default route を作成させ、リンクが切断されたときには +その default route を削除させます。 +.LP +例えばサーバマシンが LAN に接続されている場合、LAN 上の他のホストが +リモートホストと通信できるようにするために proxy ARP の使用が +必要な場合もあります。 +\fBproxyarp\fR オプションを指定すると、\fIpppd\fR はリモートホストと +同一サブネット上にある ( ブロードキャストと ARP をサポートし、動作中 +かつ point-to-point やループバックでない ) ネットワークインターフェースを +探します。そのようなインターフェースが見つかった場合、\fIpppd\fR は +恒久的に公開された ARP エントリとしてリモートホストの IP アドレスと +その見つかったネットワークインターフェースのイーサネット (MAC) アドレスを +登録します。 +.SH 使用例 +.LP +もっとも単純な場合では、2 つのマシンのシリアルポートをつなぎ、 +それぞれのマシンで以下のようなコマンドを実行します。 +.IP +pppd /dev/ttya 9600 passive +.LP +ただしそれぞれのマシンにおいて、シリアルポートで \fIgetty\fR が +走っていないものと仮定しています。 +もし片方のマシンで \fIgetty\fR が走っている場合、 +\fIkermit\fR や \fItip\fR などの通信プログラムを用いて \fIgetty\fR が +走っているマシンにログインし、次のようなコマンドを実行します。 +.IP +pppd passive +.LP +それから通信プログラムを終了し、( コネクションが切断されていないことを確 +認して ) 次のようなコマンドを実行します。 +.IP +pppd /dev/ttya 9600 +.LP +もう一方のマシンへのログインおよび \fIpppd\fR の開始処理は、 +\fBconnect\fR オプションを使用して \fIchat\fR スクリプトを起動することで +自動化できます。 +例 : +.IP +pppd /dev/ttya 38400 connect 'chat "" "" "login:" "username" +"Password:" "password" "% " "exec pppd passive"' +.LP +(ただし、このように chat プログラムを起動すると、パスワードの文字列が +pppd や chat のパラメータリスト (ps 等の出力で得られます ) で +見えてしまうことに注意して下さい。) +.LP +もしあなたのシリアルコネクションがケーブル一本でなく、もっと複雑な場合には、 +いくつかのコントロールキャラクタがエスケープされるように +準備しておく必要があります。とりわけ、XON (^Q) および XOFF (^S) を、 +\fBasyncmap a0000\fR を用いてエスケープすることはしばしば有効です。 +パスが telnet を含む場合には、 ^] キャラクタも同様にエスケープ +(\fBasyncmap 200a0000\fR を指定 ) する必要があるでしょう。 +パスが rlogin を含む場合には、rlogin クライアントの動作している側の +ホストで \fBescape ff\fR を指定する必要があるでしょう。これは、多くの +rlogin の実装がネットワーク透過でないためです。 +それらの rlogin では、 0xff, 0xff, 0x73, 0x73 とそれに続く 8 バイトの +シーケンスをストリームから取り除きます。 +.SH 診断 +.LP +メッセージは LOG_DAEMON ファシリティを用いて syslog デーモンに +送られます (これは希望するファシリティを LOG_PPP マクロとして定義し、 +\fIpppd\fR を再コンパイルすることで変更することができます)。 +エラーメッセージやデバッグメッセージを見るためには、 +/etc/syslogd.conf ファイルを編集して pppd からのメッセージが +希望する出力デバイスやファイルに書き出されるようにしておく必要があります。 +.LP +\fBdebug\fR オプションは送受信されるすべての制御パケットの内容が +ログに記録されるようにします。対象となる制御パケットは、 +すべての LCP, PAP, CHAP, IPCP パケットです。 +この機能は、PPP ネゴシエーションがうまくいかない場合の原因究明に +効果的でしょう。 +コンパイル時にデバッギングオプションを有効にしていた場合には、 +\fBdebug\fR もまた他のデバッグメッセージを記録するために使われます。 +.LP +.I pppd +プロセスに SIGUSR1 シグナルを送ってデバッギングを有効にすることが +できます。これはトグル動作します。 +.SH 関連ファイル +.TP +.B /var/run/ppp\fIn\fB.pid \fR(BSD or Linux), \fB/etc/ppp/ppp\fIn\fB.pid \fR(others) +ppp インタフェースユニット \fIn\fR に対応する \fIpppd\fR プロセスの +プロセス ID が記録されます。 +.TP +.B /var/run/tty\fIXn\fB.if \fR(BSD or Linux), \fB/etc/ppp/tty\fIXn\fB.if \fR(others) +シリアルデバイス /dev/tty\fIXn\fR 上の \fIpppd\fR プロセスのための +インターフェイスです。 +.TP +.B /etc/ppp/ip-up +そのリンクで IP パケットの送受信が行なえるようになった時 +(IPCP が完了した時 ) に実行されるプログラムまたはスクリプトです。 +これは +.IP +\fIinterface-name tty-device speed local-IP-address +remote-IP-address\fR +.IP +をパラメータに与えて標準入力をつかって実行されます。 +出力とエラー出力は、 \fB/dev/null\fR にリダイレクトされます。 +.IP +このプログラムまたはスクリプトは、pppd と同一の実ユーザ ID および実効 +ユーザ ID で実行されます。 +つまり、少なくとも実効ユーザ ID は \fBroot\fR であり、 +できれば実ユーザ ID も \fBroot\fR であることが望まれます。 +これは、経路情報を変更したり、( 例えば sendmail のような ) 特権デーモン等を +動作させたりするのに必要だからです。 +/etc/ppp/ip-up や /etc/ppp/ip-down スクリプトの内容については、 +システムのセキュリティを危うくしないよう注意して下さい。 +.TP +.B /etc/ppp/ip-down +そのリンクで IP パケットの送受信ができなくなった場合に実行される +プログラムまたはスクリプトです。 +このスクリプトは /etc/ppp/ip-up スクリプトで行なった変更を +元にもどすために用いられます。 +これは ip-up と同じパラメータを与えて実行されます。 +なお、\fIpppd\fR と同じ実効ユーザ ID および実ユーザ ID で実行されるため、 +ip-up スクリプトと同様にセキュリティ上の考慮が必要になります。 +.TP +.B /etc/ppp/pap-secrets +PAP 認証で使用するユーザ名、パスワード、IP アドレスを格納します。 +.TP +.B /etc/ppp/chap-secrets +CHAP 認証で使用する名前、シークレット、IP アドレスを格納します。 +.TP +.B /etc/ppp/options +.I pppd +のシステムデフォルトオプションを記述します。このファイルは、コマンド +ラインのオプションが解釈される前に読み込まれます。 +.TP +.B ~/.ppprc +ユーザごとのデフォルトオプションを記述します。このファイルは、コマンド +ラインのオプションが解釈される前に読み込まれます。 +.TP +.B /etc/ppp/options.\fIttyname +各シリアルポートのシステムデフォルトオプションを指定します。 +このファイルは、コマンドラインのオプションが解釈された後で読み込まれます。 +.TP +.B /etc/ppp/ppp.deny +システムのパスワードによる PAP 認証を使わせないユーザを記述します。 +.TP +.B /etc/ppp/ppp.shells +システムのパスワードによる PAP 認証ログインのために適切なシェルを +記述します。 +.SH 関連項目 +.IR chat(8), +.IR ppp(8) +.TP +.B RFC1144 +Jacobson, V. +.I Compressing TCP/IP headers for low-speed serial links. +1990 February. +.TP +.B RFC1321 +Rivest, R. +.I The MD5 Message-Digest Algorithm. +1992 April. +.TP +.B RFC1332 +McGregor, G. +.I PPP Internet Protocol Control Protocol (IPCP). +1992 May. +.TP +.B RFC1334 +Lloyd, B.; Simpson, W.A. +.I PPP authentication protocols. +1992 October. +.TP +.B RFC1548 +Simpson, W.A. +.I The Point\-to\-Point Protocol (PPP). +1993 December. +.TP +.B RFC1549 +Simpson, W.A. +.I PPP in HDLC Framing. +1993 December +.SH 注意 +以下のシグナルが +.I pppd +プロセスに送られた場合、ここで説明する効果が得られます。 +.TP +.B SIGINT, SIGTERM +これらのシグナルを受信した場合、\fIpppd\fR は (LCP をクローズすることで ) +リンクを切断し、シリアルデバイスの設定を復元して、プログラムを終了します。 +.TP +.B SIGHUP +物理層のリンク切断を指示します。\fIpppd\fR はシリアルデバイスの設定を復元し、 +プログラムを終了します。 +\fBpersist\fR オプションが指定されている場合、 \fBpppd\fR は +シリアルデバイスを再オープンし、新しい接続を始めようとします。 +そうでない場合は、 \fBpppd\fR は終了します。 +.B SIGUSR2 +このシグナルは、 +.B pppd +に圧縮に付いて再交渉させます。これは、致命的な伸長エラーの結果として +圧縮を止めた後で、再び圧縮を有効にするために便利です。 +BSD 圧縮方式では、致命的な伸長エラーは一般にどちらかの実装上の +バグである可能性を示します。 +.\".SH バグ +.\"モデム制御線の使用と \fBmodem\fR オプション、\fBlocal\fR オプションの +.\"動作については、はっきりとは定義されていません。 +.\"(訳中)前記原文には確認できないので、コメントアウトした。 +.\" 2.2.1R 対象(1997/05/26) Takeshi MUTOH <mutoh@info.nara-k.ac.jp> +.SH 作者 +Drew Perkins, +Brad Clements, +Karl Fox, +Greg Christy, +Brad Parker , +Paul Mackerras (paulus@cs.anu.edu.au) diff --git a/ja_JP.eucJP/man/man8/pppstats.8 b/ja_JP.eucJP/man/man8/pppstats.8 new file mode 100644 index 0000000000..678ac96a3e --- /dev/null +++ b/ja_JP.eucJP/man/man8/pppstats.8 @@ -0,0 +1,46 @@ +.\" @(#) %Id: pppstats.8,v 1.3.2.2 1997/03/15 21:23:40 bde Exp % +.\" jpman %Id: pppstats.8,v 1.2 1997/05/23 09:03:43 mitchy Stab % +.Dd May 2, 1995 +.Dt PPPSTATS 8 +.Sh 名称 +.Nm pppstats +.Nd PPP の利用統計を表示する +.Sh 書式 +.Nm +.Op Fl v +.Op Fl r +.Op Fl c +.Op Fl i Ar secs +.Op Ar unit# +.Sh 解説 +.Nm pppstats +は、PPP に関連した統計情報を表示します。 +.Pp +.Fl v +オプションを指定すると +.Nm +は、通常の情報に加え、追加情報を表示します。 +たとえば、エラーのために発信元に戻ったパケット数です +(VJ TCP ヘッダ圧縮で伸長に失敗した数です)。 +.Pp +.Fl r +オプションを指定すると +.Nm +は、全体のパケットの圧縮率を表示します。圧縮率は、 +0 から 1 の値で表され、 0 はデータが圧縮できないことを意味します。 +.Pp +.Fl c +オプションは、パケット圧縮の統計の別の表示法を指定します: +圧縮、伸長されたパケットの数およびバイト数 (すなわち圧縮前と圧縮後の値)、 +圧縮できなかった (圧縮で小さくならないため無圧縮で送られた) +パケットの数およびバイト数、最近の圧縮率が表示されます。 +圧縮率は、圧縮が許可されてから以降の平均の値ではなく、最近の圧縮率を +反映したものです。 +.Pp +.Fl i +オプションは、統計情報の表示の間隔を指定します。無指定時は 5 秒です。 +.Pp +.Ar unit# +は、統計情報を表示するインターフェースを指定します。 +.Sh 関連項目 +.Xr pppd 8 diff --git a/ja_JP.eucJP/man/man8/praliases.8 b/ja_JP.eucJP/man/man8/praliases.8 new file mode 100644 index 0000000000..376193473f --- /dev/null +++ b/ja_JP.eucJP/man/man8/praliases.8 @@ -0,0 +1,42 @@ +.\" @(#)praliases.8 8.1 (Berkeley) 9/21/96 +.\" jpman %Id: praliases.8,v 1.3 1997/08/30 16:46:16 take-i Stab % +.Dd April 25, 1996 +.Dt PRALIASES 1 +.Os BSD 3 +.Sh 名称 +.Nm praliases +.Nd システムメールエイリアスの表示 +.Sh 書式 +.Nm praliases +.Op Fl f Ar ファイル +.Sh 解説 +.Nm praliases +ユーティリティーは、 +現在のシステムエイリアスを 1 行につき 1 つ +ずつ ( 但し項目順ではなく ) 表示します。 +.Pp +オプションは次の通りです : +.Bl -tag -width Ds +.It Fl f +デフォルトの +.Nm sendmail +システムのエイリアスファイルの代わりに、 +指定されたファイルを読みます。 +.El +.Pp +.Nm praliases +ユーティリティーは成功すると 0 、 +エラーが発生すると 0 より大きな値を返します。 +.Sh 関連ファイル +.Bl -tag -width /var/log/sendmail.stXX -compact +.It Pa /etc/aliases +デフォルトの +.Nm sendmail +システムのエイリアスファイル +.It Pa /etc/aliases.db +.Pa /etc/aliases +ファイルのデータベース版 +.El +.Sh 関連項目 +.Xr mailq 1 , +.Xr sendmail 8 diff --git a/ja_JP.eucJP/man/man8/pstat.8 b/ja_JP.eucJP/man/man8/pstat.8 new file mode 100644 index 0000000000..12d76d7eec --- /dev/null +++ b/ja_JP.eucJP/man/man8/pstat.8 @@ -0,0 +1,379 @@ +.\" 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: +.\" 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. +.\" +.\" 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. +.\" +.\" 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 % +.\" jpman %Id: pstat.8,v 1.2 1997/03/31 14:56:46 horikawa Stab % +.\" +.Dd October 7, 1995 +.Dt PSTAT 8 +.Os BSD 4 +.Sh 名称 +.Nm pstat , +.Nm swapinfo +.Nd システムデータ構造体を表示する +.Pp +.Sh 書式 +.Nm pstat +.Op Fl Tfiknstv +.Op Fl M Ar core +.Op Fl N Ar system +.Pp +.Nm swapinfo +.Op Fl k +.Op Fl M Ar core +.Op Fl N Ar system +.Sh 解説 +.Nm pstat +は、オープンしているファイルのエントリ・ +スワップ領域の利用状況・端末の状態・vnodeデータ構造体 +を表示します。 +.Ar core +が指定されればそこから情報が取り出され、指定されなければ +.Pa /dev/mem +から情報が取り出されます。 +.Ar system +が指定されなければ、 +必要な名前リストは +.Pa /kernel +から取り出されます。 +.Pp +.Nm swapinfo +という名前で起動されると +.Fl s +オプションが指定されたことになり、このときは +.Fl k +オプションだけを指定することができます。 +.Pp +オプションは以下の通りです: +.Bl -tag -width indent +.It Fl n +デバイスを表示するときに、名前ではなくデバイスのメジャー番号と +マイナー番号を使用します。 +.It Fl k +BLOCKSIZE 環境変数での設定に関わらず、容量の表示をキロバイト単位 +で行います。 +.It Fl T +種々のシステムテーブルについて使用スロットと空きスロットの +数を表示します。システムの負荷が非常に重いとき、 +システムテーブルがどれくらいの大きさになっているかを調べる +のに役立ちます。 +.It Fl f +次のようなヘッダとともに、オープンしているファイルのテーブル +を表示します: +.Bl -tag -width indent +.It LOC +このテーブルエントリの core 中における位置 +.It TYPE +このテーブルエントリが指すオブジェクトの型 +.It FLG +その他の状態。以下のように記号化されています: +.Bl -tag -width indent +.It R +読み込み用にオープンされている +.It W +書き込み用にオープンされている +.It A +追加用にオープンされている +.It S +共有ロックが存在している +.It X +排他的ロックが存在している +.It I +データの準備ができたらプロセスグループにシグナルを送る +.El +.It CNT +オープンされたこのファイルのことを知っているプロセスの数 +.It MSG +このファイルに向けられているメッセージの数 +.It DATA +このファイルに関する vnode テーブルエントリもしくはソケット構造体の位置 +.It OFFSET +ファイルオフセット +.Pf ( Xr lseek 2 +参照) +.El +.It Fl s +カーネルに登録されたすべてのスワップ領域について、 +利用状況に関する情報を表示します。第1の欄はパーティションのデバイス名 +です。次の欄はそのパーティションで利用できる領域全体の大きさです。 +.Ar Used +の欄は、現在使われているブロックの合計の大きさを示しています。 +.Ar Available +の欄は、各パーティションに残っている領域の大きさを示しています。 +.Ar Capacity +は領域の何%が使われているかを示します。 +.Pp +2つ以上のパーティションをスワップ領域としてシステムに +設定している場合は、すべての項目について最後の行に合計が +報告されます。 +.It Fl t +次のようなヘッダとともに、端末のテーブルを表示します。 +.Bl -tag -width indent +.It RAW +rawな入力キューにある文字数 +.It CAN +正規化された入力キューにある文字数 +.It OUT +出力キューにある文字数 +.It MODE +.Xr tty 4 +を参照 +.It ADDR +物理デバイスアドレス +.It DEL +正規化された入力キューにある区切り文字(改行)の数 +.It COL +端末の計算した列の位置 +.It STATE +その他の状態。以下のように記号化されています: +.Bl -tag -width indent +.It T +delay がタイムアウトしようとしている +.It W +オープンが完了するのを待っている +.It O +オープンしている +.It F +DMA 中に出力キューがフラッシュされた +.It C +キャリアがオン +.It c +接続している +.It B +出力中のためビジー +.It A +プロセスは出力キューに空きができるのを待っている +.It a +プロセスは出力の完了を待っている +.It X +排他的な利用のためにオープンしている +.It S +出力が停止した (ixon フロー制御の場合) +.It m +出力が停止した (carrier フロー制御の場合) +.It o +出力が停止した (CTS フロー制御の場合) +.It d +出力が停止した (DSR フロー制御の場合) +.It K +入力が停止した +.It Y +入力イベントの際に SIGIO を送る +.It D +小文字(lowercase)の +.Ql \e +が動作する状態 +.It E +PRTRUBのため +.Ql \e.../ +の中にいる +.It L +次の文字はリテラルである +.It P +中断された入力を再タイプしている (PENDIN) +.It N +タブ幅を数えている、FLUSHO を無視する +.It l +ブロックモード入力ルーチンは使用中 +.It s +i/o が snoop された +.It Z +接続が失われた +.It SESS +セッション構造体のカーネル内アドレス +.It PGID +この端末を制御端末としているプロセスグループ +.It DISC +回線規約; +.Ql term +(TTYDISC の場合) +, +.Ql ntty +(NTTYDISC の場合) +, +.Ql tab +(TABLDISC の場合) +, +.Ql slip +(SLIPDISC の場合) +, +.Ql ppp +(PPPDISC の場合) +のいずれか +.El +.It Fl v +アクティブな vnode を表示します。あるファイルシステムに対応する +一連のvnodeには 2 行のヘッダが付いています。1 行目は以下のように +構成されています: +.Pp +.Df I +.No *** MOUNT Em fstype from +on +.Em on fsflags +.De +.Pp +ここで +.Em fstype +には、 +.Em ufs , nfs , mfs , pc +のいずれかが入ります。 +.Em from +にはどのファイルシステムがマウント +されているか、 +.Em on +にはファイルシステムがどこにマウントされ +ているか、 +.Em fsflags +にはマウントで適用されるオプション +.Pf ( Xr mount 8 +を参照)が列挙されます。 +2 行目は各フィールドを説明するヘッダです。 +最初の部分は固定で、2 番目の部分はファイルシステムのタイプによります。 +すべてのvnodeで共通なヘッダは以下の通りです: +.Bl -tag -width indent +.It ADDR +このvnodeの位置 +.It TYP +ファイルタイプ +.It VFLAG +.Pp +vnodeのフラグを表す文字のリスト: +.Bl -tag -width indent +.It R +\- VROOT +.It T +\- VTEXT +.It L +\- VXLOCK +.It W +\- VXWANT +.It E +\- VEXLOCK +.It S +\- VSHLOCK +.It T +\- VLWAIT +.It A +\- VALIASED +.It B +\- VBWAIT +.El +.Pp +.It USE +この vnode への参照数 +.It HOLD +この vnode が確保している I/O バッファの数 +.It FILEID +vnode フィールド。 +.Em ufs +の場合は inode 番号 +.It IFLAG +ファイルシステムに固有なその他の状態。 +以下のように記号化されています: +.Pp +.Bl -tag -width indent +.It "ufsの場合:" +.Bl -tag -width indent +.It L +ロックされている +.It U +更新時間 +.Pf ( Xr fs 5 +参照)は修正されなければならない +.It A +アクセス時刻は修正されなければならない +.It W +別のプロセスに要求されている(Lフラグがオン) +.It C +変更時刻は修正されなければならない +.It S +共有ロックが適用されている +.It E +排他的ロックが適用されている +.It Z +ロックを待っているものがいる +.It M +変更がある +.It R +リネーム中 +.El +.It "nfsの場合:" +.Bl -tag -width indent +.It W +I/O バッファのフラッシュが完了するのを待っている +.It P +I/O バッファがフラッシュされている最中 +.It M +ローカルで変更されたデータがある +.It E +以前の書き込みに失敗したものがある +.It X +キャッシュを行わないリース(lease)(nqnfs) +.It O +書き込みリース(lease)(nqnfs) +.It G +リース(lease)が破棄された(nqnfs) +.El +.El +.It SIZ/RDEV +通常のファイルの場合はバイト数、特殊ファイルの場合は +メジャーデバイスとマイナーデバイス +.El +.It Fl i +.Fl v +と同じですが、バックワードコンパチビリティのためにあります。 +.El +.Sh 関連ファイル +.Bl -tag -width /dev/memxxx -compact +.It Pa /kernel +名前リスト +.It Pa /dev/mem +デフォルトのテーブル情報源 +.El +.Sh 関連項目 +.Xr ps 1 , +.Xr systat 1 , +.Xr stat 2 , +.Xr fs 5 , +.Xr iostat 8 , +.Xr vmstat 8 +.Pp +.Sh バグ +.Pp +.Tn NFS +スワップサーバはサポートしていません。 +.Sh 歴史 +.Nm pstat +コマンドは +.Bx 4.0 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/pw.8 b/ja_JP.eucJP/man/man8/pw.8 new file mode 100644 index 0000000000..40566438c3 --- /dev/null +++ b/ja_JP.eucJP/man/man8/pw.8 @@ -0,0 +1,804 @@ +.\" Copyright (C) 1996 +.\" David L. Nugent. 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. +.\" +.\" THIS SOFTWARE IS PROVIDED BY DAVID L. NUGENT 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 DAVID L. NUGENT OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: pw.8,v 1.1.1.1.2.4 1997/10/14 06:38:56 charnier Exp % +.\" jpman %Id: pw.8,v 1.3 1997/10/28 15:30:48 kuriyama Stab % +.\" +.Dd December 9, 1996 +.Dt PW 8 +.Os +.Sh 名称 +.Nm pw +.Nd システムユーザ、グループの作成、削除、変更、表示 +.Sh 書式 +.Nm pw +.Ar useradd +.Op name|uid +.Op Fl C Ar config +.Op Fl q +.Op Fl n Ar name +.Op Fl u Ar uid +.Op Fl c Ar comment +.Op Fl d Ar dir +.Op Fl e Ar date +.Op Fl p Ar date +.Op Fl g Ar group +.Op Fl G Ar grouplist +.Op Fl m +.Op Fl k Ar dir +.Op Fl s Ar shell +.Op Fl o +.Op Fl L Ar class +.Op Fl h Ar fd +.Op Fl N +.Op Fl P +.Nm pw +.Ar useradd +.Op name|uid +.Op Fl D +.Op Fl C Ar config +.Op Fl q +.Op Fl b Ar dir +.Op Fl e Ar days +.Op Fl p Ar days +.Op Fl g Ar group +.Op Fl G Ar grouplist +.Op Fl k Ar dir +.Op Fl u Ar min,max +.Op Fl i Ar min,max +.Op Fl w Ar method +.Op Fl s Ar shell +.Nm pw +.Ar userdel +.Op name|uid +.Op Fl n Ar name +.Op Fl u Ar uid +.Op Fl r +.Nm pw +.Ar usermod +.Op name|uid +.Op Fl C Ar config +.Op Fl q +.Op Fl n Ar name +.Op Fl u Ar uid +.Op Fl c Ar comment +.Op Fl d Ar dir +.Op Fl e Ar date +.Op Fl p Ar date +.Op Fl g Ar group +.Op Fl G Ar grouplist +.Op Fl l Ar name +.Op Fl m +.Op Fl k Ar dir +.Op Fl w Ar method +.Op Fl s Ar shell +.Op Fl L Ar class +.Op Fl h Ar fd +.Op Fl N +.Op Fl P +.Nm pw +.Ar usershow +.Op name|uid +.Op Fl n Ar name +.Op Fl u Ar uid +.Op Fl F +.Op Fl P +.Op Fl a +.Nm pw +.Ar usernext +.Op Fl C Ar config +.Op Fl q +.Nm pw +.Ar groupadd +.Op group|gid +.Op Fl C Ar config +.Op Fl q +.Op Fl n Ar group +.Op Fl g Ar gid +.Op Fl M Ar members +.Op Fl o +.Op Fl h Ar fd +.Op Fl N +.Op Fl P +.Nm pw +.Ar groupdel +.Op Fl n Ar name +.Op Fl g Ar gid +.Nm pw +.Ar groupmod +.Op Fl C Ar config +.Op Fl q +.Op Fl F +.Op Fl n Ar name +.Op Fl g Ar gid +.Op Fl l Ar name +.Op Fl M Ar members +.Op Fl m Ar newmembers +.Op Fl h Ar fd +.Op Fl N +.Op Fl P +.Nm pw +.Ar groupshow +.Op Fl n Ar name +.Op Fl g Ar gid +.Op Fl F +.Op Fl P +.Op Fl a +.Nm pw +.Ar groupnext +.Op Fl C Ar config +.Op Fl q +.Sh 解説 +.Nm pw +は、システムの +.Ar user +、 +.Ar group +ファイルのユーザ、グループを簡単に、標準的な方法で追加、変更、削除 +することができるようにするコマンドライン版のエディタです。 +.Nm +は、ローカルな user ファイルと group ファイルを操作することができるだ +けだということに注意して下さい。 NIS のユーザ、グループは NIS サーバ上 +で管理しなければなりません。 +.Nm +は root で実行されなければならず、 +.Pa passwd , +.Pa master.passwd , +.Pa group +ファイルや、安全なまたは安全でないパスワードデータベースファイル +の更新作業を行います。 +.Pp +.Xr pw 8 +のコマンドラインにかかれている最初の一つか二つのキーワードは、引数の残り +に対する文脈を規定します。 +.Ar user +と +.Ar group +のキーワードはどちらも、 +.Ar add , +.Ar del , +.Ar mod , +.Ar show , +.Ar next +と組み合わせるか、分離して用いることができ、どちらの順序 (例えば +showuser, usershow, show user, user show はすべて同じことと +みなされます) で指定してもかまいません。 +この柔軟性は、実際のユーザ、グループデータベース操作のために +.Nm +を呼ぶ対話的なスクリプトには便利です。 +.Fl n Ar name , +.Fl u Ar uid , +.Fl g Ar gid +オプションを使う代わりに、 +これらのキーワードに続けてユーザ名、グループ名、数字の ID のうち一つ +を指定することができます。 +.Pp +以下のフラグは操作のすべてのモードで共通です: +.Pp +.Bl -tag -width "-G grouplist" +.It Fl C Ar config +.Nm +は新しいユーザアカウントとグループはどのように作られるべきかという +方針の情報を得るために、デフォルトではファイル +.Pa /etc/pw.conf +を読み込みますが、 +.Fl C +オプションで異なるコンフィグレーションファイルを指定できます。 +コンフィグレーションファイルのほとんどの内容は、コマンドライン +オプションにより上書きされますが、新しいアカウントを追加するための標準 +的な情報をコンフィグレーションファイルに設定しておくと +より便利かもしれません。 +.It Fl q +このオプションを使うと +.Nm +はエラーメッセージを抑制します。これは、注意深くフォーマットされたディスプレイへのメッセージ表示よりも、 +.Nm +から返された戻り値を解釈する方が好まれるような対話的な環境では +便利かもしれません。 +.It Fl N +このオプションは add と modify 操作で使います。 +.Nm +は、ユーザ/グループデータベースの更新をスキップして、操作を実際には +実行せずに、代わりに結果だけを出力します。 +.Fl P +オプションを使うと、標準 passwd と可読なフォーマットの切り替えが +できます。 +.El +.Pp +.Sh ユーザオプション +以下のオプションは +.Ar useradd +と +.Ar usermod +コマンドに付けます: +.Pp +.Bl -tag -width "-G grouplist" +.It Fl n Ar name +ユーザ名/アカウント名を指定します。 +.It Fl u Ar uid +ユーザ ID / アカウント ID を数字で指定します。 +.Pp +アカウント名は uid を含み、逆も同様であるため、通常これらのオプション +のどちらか片方しか必要ではありません。 +また +.Ql Fl n +や +.Ql Fl u +を使わなくても、コマンドライン上で +.Ar useradd , +.Ar userdel , +.Ar usermod , +.Ar usershow +キーワードの直後にアカウントとユーザIDのどちらでも続けることができます。 +しかし、両方を指定しなければならないこともしばしばあります。 +例えば、存在するユーザの uid を +.Ar usermod +で変えたり、新しいアカウントを作るときにデフォルトの uid を上書きした +りするときです。 +.Nm +で +.Ar useradd +を使って新しいユーザに uid を自動的に割り当てたい場合は、 +.Ql Fl u +オプションを使っては +.Em いけません +。 +.El +.Pp +.Ar useradd +と +.Ar usermod +の両方で使えるオプション: +.Bl -tag -width "-G grouplist" +.It Fl c Ar comment +このオプションは passwd の GECOS フィールドの内容をセットします。 +このフィールドは、カンマで区切られた四つのサブフィールドで、一般的には +ユーザの姓名、勤務先または地区、職場と自宅の電話番号を含みます。 +これらのサブフィールドは慣習的に使われるだけであり、省略可能です。 +このフィールドが空白を含む場合、コメント自身をダブルクォート +.Ql \&" +でくくらなければなりません。 +サブフィールドの区切りで使われたような、フィールド内のカンマの使用は +避けて下さい。そして、コロン +.Ql \&: +キャラクタも passwd ファイルのフィールド区切りであるため使えません。 +.It Fl d Ar dir +このオプションは、アカウントのホームディレクトリを設定します。 +通常、これはホームディレクトリがデフォルト (基本のホームディレクトリ +- 普通 +.Pa /home +と サブディレクトリとしてのアカウント名 - を指定する +pw.conf で決定されます) と異なる場合にだけ使うことになるでしょう。 +.It Fl e Ar date +アカウントが破棄される日付をセットします。 +この日付のフォーマットは、 10 進の UNIX 時間か +.Ql \& dd-mmm-yy[yy] +フォーマットの日付のどちらかになり、後者は dd が日、mmmが月で、数字と +アルファベット('Jan', 'Feb' 等)のどちらでもよく、年は 2 または 4 桁の +数字からなります。 +このオプションは、 +.Ql \&+n[mhdwoy] +の形の相対的な日付も受け付けます。 +.Ql \&n +は 10 進数、 8 進数 (0 から始まる) 、 16 進数 (0x で始まる) の数字で、 +その後に現在の日付時刻から破棄される日までの分(m)、時(h)、日(d)、 +曜日(w)、月(o)、年(y)の数がセットされます。 +.It Fl p Ar date +アカウントのパスワードが破棄される日付をセットします。 +このフィールドは、強制的なパスワードの変更を適用することを除けば、 +アカウントを破棄するオプションと同等です。 +アカウントを破棄するオプションと同じフォーマットを受け付けます。 +.It Fl g Ar group +与えられた group をアカウントの初期グループにセットします。 +.Ar group +は、グループ名または対応するグループ ID 番号が使えます。 +.It Fl G Ar grouplist +アカウントが属する別のグループをセットします。 +.Ar grouplist +は、カンマ区切りのリスト、またはグループ名、またはグループ IDです。 +ユーザを加える場合、 +.Pa /etc/group +の各グループにユーザ名が追加されます。 +ユーザを編集する場合、 +.Ar grouplist +に指定されたグループにユーザ名が加えられ、 +指定されなかったグループからは除かれます。 +注意: ユーザは +.Pa /etc/group +の初期グループには加えられるべきではありません。 +また、グループのメンバの変更は現在のログインにはすぐには影響されず、変 +更後のログインにだけ影響します。 +.It Fl L Ar class +このオプションは生成されたユーザのログインクラスをセットします。 +ユーザクラスに関する情報は +.Xr login.conf 5 +を参照して下さい。 +.It Fl m +このオプションは、ユーザのホームディレクトリの作成を試みるように +.Nm +に指示します。 +もちろんこれは +.Ar useradd +で新しいアカウントを加えるときにも役に立ちますが、 +存在するユーザのホームディレクトリをファイルシステムの別の場所に +移動する、という使い方もできます。 +新しいホームディレクトリは、一般にユーザが個人的に使う +シェルコンフィグレーションファイル一式を含む、 +.Ar 雛型 +ディレクトリの内容と共に移されます。 +.Ar usermod +にアカウントを指定して +.Ql Fl m +が用いられると、そのユーザのホームディレクトリにある +コンフィグレーションファイルはプロトタイプのファイルで +.Em 上書きされません +。 +.Pp +ユーザのホームディレクトリが作成されるとき、デフォルトで +.Ql Fl b Ar dir +オプション (下記参照) で指定された +.Ar basehome +ディレクトリのサブディレクトリとして作られ、アカウント名と同じ名前が付 +けられます。 +コマンドラインに +.Ql Fl d Ar dir +オプションを付けると、上書きするようにもできます。 +.It Fl k Ar dir +このオプションは、 +.Ar 雛型 +のサブディレクトリをセットします。ユーザのホームディレクトリが作成 +されるとき、そこから基本の起動時ファイル、コンフィグレーションファイル +がコピーされます。 +このオプションは、 +.Ql Fl D +(下記参照) や +.Ql Fl m +と共に使ったときにのみ意味があります。 +.It Fl s Ar shell +ユーザのログインシェルを +.Ar shell +にセットまたは変更します。 +シェルプログラムへのパスが省略されると、 +.Nm +は +.Pa /etc/pw.conf +で指定された +.Ar shellpath +を探し、それを適切に補います。 +パスを指定するのは、特別な理由があるのでなければ、避けるべきだ +ということを覚えておきましょう。 +指定しないことで、プログラムが存在し、かつ実行可能であることを +.Nm +に確認させることができるからです。 +フルパスを指定する (または空のままの "" シェルにしておく) と +このチェックをせず、対話的なログインをさせないアカウントを +設定しなければならないときに設定される +.Pa /nonexistent +のようなエントリを作ることができます。 +.It Fl L Ar class +ユーザの passwd レコード内の +.Em class +フィールドをセットします。 +このフィールドは現在使われていませんが、将来は +.Em termcap +エントリのようなタグ (詳細は +.Xr passwd 5 +を参照のこと) を指定するために使われるでしょう。 +.It Fl h Ar fd +このオプションは、 +.Nm +を使ってアカウントパスワードを設定することができる対話的なスクリプトを +設定できるような特別のインターフェースを用意します。 +コマンドラインと環境は、プログラムが情報を受け取るしくみとしては +基本的に安全ではないため、 +.Nm +はファイル記述子 (通常対話的スクリプトとプログラム間のパイプ) +を通してのみ、アカウントとグループのパスワードの設定を許可します。 +.Ar sh , +.Ar bash , +.Ar ksh , +.Ar perl +は皆、これができるしくみを持っています。 +.Ql Fl h Ar 0 +が指定されると、代わりに +.Nm +はユーザのパスワードを求めるプロンプトを出し、 +.Em stdin +をパスワードを読み込むファイル記述子とします。 +このパスワードは一度しか読み込まれず、対話的な使用よりも +スクリプト向きにできていることに注意して下さい。 +.Xr passwd 1 +の行に合わせて新しいパスワードの確認をしたい場合、これは +.Nm +を呼び出す対話的なスクリプトの一部として実装されるべきです。 +.Pp +引数 +.Ar fd +として +.Ql \&- +が与えられると、パスワードとして +.Ql \&* +がセットされ、そのアカウントにはパスワードでログインすることが +できないようになります。 +.El +.Pp +.Ar useradd +を使うことで、存在するユーザ ID と重複する新しいアカウントを作成するこ +とができるようになります。 +これは普通エラーになって拒否されるはずですが、 +.Ql Fl o +オプションが重複チェックを上書きし、ユーザ ID の重複を +許すことになります。 +これは、同一のユーザが異なるコンテキスト(異なるグループ割り当てや +異なるホームディレクトリ、異なるシェル)でログインするのを許可する +場合に、各アカウントに基本的に同一のアクセス権を与える場合に便利です。 +.Pp +.Ar useradd +コマンドは +.Ql Fl D +オプションを使うことで新しいユーザとグループのデフォルトも設定できます。 +新しいユーザを付け加える代わりに、 +.Nm +はコンフィグレーションファイル +.Pa /etc/pw.conf +に新しいデフォルトのセットを書き込みます。 +.Ql Fl D +オプションを使う場合、 +.Ql Fl n Ar name +や +.Ql Fl u Ar uid +を使ってはいけません。そうでないとエラーになります。 +.Ql Fl D +を使うと、 +.Ar useradd +コマンドのいくつかのコマンドラインスイッチの意味が変わります。 +それは: +.Bl -tag -width "-G grouplist" +.It Fl D +コンフィグレーションファイル +.Pa /etc/pw.conf +( もしくは +.Ql Fl C Ar config +オプションが使われたときは異なる名前のコンフィグレーションファイル ) +の中でのデフォルトの値をセットします。 +.It Fl b Ar dir +ユーザホームディレクトリが作成されるルートディレクトリをセットします。 +このオプションのデフォルトの値は +.Pa /home +ですが、他の好きなディレクトリにセットできます。 +.It Fl e Ar days +デフォルトのアカウントの有効期間を日数でセットします。 +.Ql Fl D +を付けずに使われる場合と異なり、引数はアカウントが作成されてから無効に +なるまでの日数を指定する数字でなければなりません。 + 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 、もしくはそれらの混在で、 +.Pa /etc/pw.conf +の中にシンボリック名で保存されます。 +.It Fl L Ar class +このオプションは、新しいユーザのデフォルトのログインクラスを +セットします。 +.It Fl k Ar dir +デフォルトの +.Em 雛型 +ディレクトリをセットし、 +.Nm +がユーザのホームディレクトリを作成するときに、 +そこからシェルなどの初期化ファイルのプロトタイプがコピーされます。 +.It Fl u Ar min,max , Fl i Ar min,max +これらのオプションは、 +.Nm +により作成された新しいアカウントとグループのために割り当てるユーザと +グループの最小の ID と最大の ID をセットします。 +デフォルト値はどちらも最小 1000 で最大 32000 です。 +.Ar min +と +.Ar max +はどちらも数字で、 max は min より大きく、両方とも 0 から 32767 の範囲 +内でなければなりません。 +一般に 100 未満のユーザ ID とグループ ID はシステムに予約されており、 +32000 より大きな数も (システム daemon が使う) 特殊な目的に +予約されています。 +.It Fl w Ar method +.Ql Fl w +オプションは新しく作成されたユーザアカウントのパスワードをセットするの +に使われるデフォルトの方法を指定します。 +.Ar method +は以下のうちの一つです: +.Pp +.Bl -tag -width random -offset indent -compact +.It no +新しく作成されたアカウントでのログインを不可とします。 +.It yes +アカウント名をパスワードにします。 +.It none +パスワードを空欄にします。 +.It random +ランダムパスワードを生成します。 +.El +.Pp +The +.Ql \&random +や +.Ql \&no +method は、最も安全です。前者の場合、 +.Nm +はパスワードを生成し、標準出力に出力します。 +このパスワードは、ユーザがそのアカウントにアクセスするパスワードとして +あなたが発行しますが、ユーザ自身が自分のパスワードを指定 +(多分ひどい選択です) するものより適切です。 +.Ql \&no +method にした場合、パスワードでアクセスできるアカウントを与えるために +スーパユーザが +.Xr passwd 1 +を使わなければなりません。 +.El +.Pp +.Ar userdel +コマンドには三つしか正しいオプションがありません。 +.Ql Fl n Ar name +と +.Ql Fl u Ar uid +オプションには、既に前述の説明があります。 +追加オプション: +.Bl -tag -width "-G grouplist" +.It Fl r +このオプションで、 +.Nm +はユーザのホームディレクトリとその内容のすべてを削除します。 +.Nm +はシステムからファイルを削除するとき、慎重すぎるやり方をとります。 +まず、削除されるアカウントの uid がシステムの別のアカウントでも使われ +ていて、パスワードファイルの 'ホーム' ディレクトリが文字 +.Ql \&/ +で始まる正しいパスであった場合にはファイルは削除されません。 +次に、ファイルやディレクトリが実際にそのユーザのものであるか、 +誰かの所有であるシンボリックリンクがユーザのホームディレクトリ下にある +場合にだけ削除されます。 +最後に、そのユーザの所有であるすべての中身を削除した後、 +空のディレクトリだけが削除されます。 +更に別の一掃が必要なときは、管理者に任されます。 +.El +.Pp +メールスプールファイルと crontab はユーザ名に無条件に付属しているもの +なので、アカウントが削除されたとき常に削除されます。 +.Ar at +コマンドによって処理待ちのキューに入っているジョブも、ユーザの uid +がユニークである (そのシステムの別のアカウントに使われていない) 場合は +削除されます。 +.Pp +.Ar usershow +コマンドは、二種類のフォーマットでアカウントを閲覧できます。 +フォーマットは、デフォルトで +.Pa /etc/master.passwd +で使われているものと同じで、パスワードフィールドは +.Ql \&* +に置き換えられています。 +.Ql Fl P +オプションが使われると、 +.Nm +はより人間に読みやすい形でアカウントの詳細を出力します。 +.Ql Fl a +オプションは、現在ファイルにあるすべてのユーザをリストします。 +.Pp +.Ar usernext +コマンドは、利用可能な次のユーザ ID とグループ ID を +コロン区切りで返します。 +これは、通常 +.Nm +を使う対話的なスクリプトやフロントエンド用です。 +.Pp +.Sh グループオプション +グループを操作するコマンドには、 +.Ql Fl C Ar config +と +.Ql Fl q +オプション (前セクションの始めに説明があります) が使えます。 +他のグループ関係のコマンド: +.Bl -tag -width "-m newmembers" +.It Fl n Ar name +グループ名を指定します。 +.It Fl g Ar gid +グループの ID を数字で指定します。 +.Pp +グループ名は uid を意味し、逆も同様なので、アカウント名 +と ID フィールドとして、普通どちらか一つを付ければよいのです。 +両方を指定する必要があるのは、新しいグループに指定したグループ ID を +設定するとき、または存在するグループの uid を変えたいときだけです。 +.It Fl M Ar memberlist +このオプションは、存在するユーザを新しいグループに (groupaddで) +加えたり、存在するメンバリストを (groupmodで) 新しいものに取り換える +もうひとつの方法です。 +.Ar memberlist +は正当で、存在するユーザ名または uid のカンマ区切りのリストです。 +.It Fl m Ar newmembers +.Op M +オプションと同様、このオプションは最初に存在するメンバのリストを +入れ換えることなく、グループに存在するユーザを +.Em 追加 +します。 +ログイン名またはユーザ ID を使うことができ、重複するユーザは警告無く +自動的に削除されます。 +.El +.Pp +.Ar groupadd +にも、存在するグループ ID を新しいグループに割り当てる +.Ql Fl o +オプションがあります。 +デフォルトの動作は、グループ追加の試みを拒否することになっており、この +オプションはグループ ID の重複チェックを上書きします。 +グループ ID を重複させる必要は滅多にありません。 +.Pp +.Ar groupmod +コマンドには、一つの追加オプションがあります: +.Pp +.Bl -tag -width "-m newmembers" +.It Fl l Ar name +このオプションで、存在するグループ名を +.Ql \&name +に変更することができます。 +新しい名前は存在しないものでなければならず、存在するグループ名と +重複させようとすると拒否されます。 +.El +.Pp +.Ar groupshow +へのオプションは +.Ql Fl u Ar uid +の代わりにグループ ID を指定する +.Ql Fl g Ar gid +を付けた +.Ar usershow +と同じです。 +.Pp +.Ar groupnext +コマンドは、次に使用できるグループ ID を標準出力に返します。 +.Sh 診断 +.Nm +は、操作に成功すると EXIT_SUCCESS を返し、そうでなければ +.Xr sysexits 3 +により定義された以下の戻り値のうちどれかひとつを返します: +.Bl -tag -width xxxx +.It EX_USAGE +.Bl -bullet -compact +.It +コマンドラインのシンタックスエラー (不適切なキーワード、未定義オプション)。 +.El +.It EX_NOPERM +.Bl -bullet -compact +.It +root でないユーザとして、何らかの更新を実行しようとした。 +.El +.It EX_OSERR +.Bl -bullet -compact +.It +メモリアロケーションエラー。 +.It +パスワードファイル記述子の読み出しエラー +.El +.It EX_DATAERR +.Bl -bullet -compact +.It +コマンドライン上やパスワードファイル記述子の、間違った、または正しくな +いデータや欠落データ。 +.It +root アカウントの名前や uid の変更、削除をしようとした。 +.El +.It EX_OSFILE +.Bl -bullet -compact +.It +雛型ディレクトリが適切でない、または存在しない。 +.It +基本ホームディレクトリが適切でない、または存在しない。 +.It +指定したシェルが適切でない、または存在しない。 +.El +.It EX_NOUSER +.Bl -bullet -compact +.It +指定されたユーザ、ユーザ ID 、グループ、グループ ID が存在しない。 +.It +記録、追加、または更新されたユーザ、グループが予期せず無くなった。 +.El +.It EX_SOFTWARE +.Bl -bullet -compact +.It +指定した範囲には未使用グループ ID 、ユーザ ID が残っていない。 +.El +.It EX_IOERR +.Bl -bullet -compact +.It +コンフィグレーションファイルの書き換えができない。 +.It +グループやユーザデータベースファイルの更新時エラー。 +.It +パスワードまたはグループデータベースファイルの更新時エラー。 +.El +.It EX_CONFIG +.Bl -bullet -compact +.It +基本ホームディレクトリが設定されていない。 +.El +.El +.Pp +.Sh 注釈 +各コマンドに使用可能なオプションの要約として、 +.Dl pw [command] help +が使えます。例えば、 +.Dl pw useradd help +は useradd 操作に使用できるすべてのオプションをリストします。 +.Sh 関連ファイル +.Bl -tag -width /etc/master.passwd.new -compact +.It Pa /etc/master.passwd +ユーザデータベース +.It Pa /etc/passwd +Version 7 フォーマットのパスワードファイル +.It Pa /etc/login.conf +ユーザケーパビリティデータベース (user capability database) +.It Pa /etc/group +グループデータベース +.It Pa /etc/master.passwd.new +マスタパスワードファイルの一時コピー +.It Pa /etc/passwd.new +Version 7 パスワードファイルの一時コピー +.It Pa /etc/group.new +グループファイルの一時コピー +.It Pa /etc/pw.conf +pw コマンドのデフォルトオプションファイル +.El +.Sh 関連ファイル +.Xr chpass 1 , +.Xr passwd 1 , +.Xr group 5 , +.Xr passwd 5 , +.Xr pw.conf 5 , +.Xr pwd_mkdb 8 , +.Xr login.conf 5 , +.Xr vipw 8 +.Sh 歴史 +.Nm +は、 SYSV の +.Em shadow +サポートで使われていた多くのオプションを模倣して書かれましたが、 +.Bx 4.4 +オペレーティングシステムに特有のパスワードフィールド、 +グループフィールドに合わせて変更されています。また、ほとんどの要素が +一つのコマンドにまとめられています。 diff --git a/ja_JP.eucJP/man/man8/pwd_mkdb.8 b/ja_JP.eucJP/man/man8/pwd_mkdb.8 new file mode 100644 index 0000000000..bdb84a1f9f --- /dev/null +++ b/ja_JP.eucJP/man/man8/pwd_mkdb.8 @@ -0,0 +1,146 @@ +.\" Copyright (c) 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. +.\" +.\" 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. +.\" +.\" @(#)pwd_mkdb.8 8.1 (Berkeley) 6/6/93 +.\" jpman %Id: pwd_mkdb.8,v 1.3 1997/08/27 12:36:09 horikawa Stab % +.\" +.Dd June 6, 1993 +.Dt PWD_MKDB 8 +.Os +.Sh 名称 +.Nm pwd_mkdb +.Nd パスワードデータベースを構築する +.Sh 書式 +.Nm pwd_mkdb +.Op Fl c +.Op Fl p +.Op Fl d Ar directory +.Op Fl u Ar username +.Ar file +.Sh 解説 +.Nm +は、指定されたファイルから +.Xr db 3 +スタイルの、セキュリティのしっかりしたデータベースと +そうでないデータベースの 2 つを構築します。 +そして、これらのデータベースは、それぞれ +.Pa /etc/spwd.db +と +.Pa /etc/pwd.db +にインストールされます。 +このファイルは、 +.Pa /etc/master.passwd +にインストールされます。このファイルは +正しいフォーマットでなければなりません ( +.Xr passwd 5 +を参照) 。このシステムで使われるフォーマットは、旧来の +バージョン 7 スタイルのフォーマットとは異なるので注意を要します。 +.Pp +オプションは以下の通りです。 +.Bl -tag -width flag +.It Fl c +パスワードファイルが正しいフォーマットかどうかをチェックします。 +どのファイルも変更、追加、削除を行ないません。 +.It Fl p +バージョン 7 スタイルのパスワードファイルを作成し、 +.Pa /etc/passwd +にインストールします。 +.It Fl d Ar directory +.Pa /etc +の代わりに、指定された先のディレクトリにデータベースを保存します。 +.It Fl u Ar username +指定したユーザのレコードだけ更新します。 +単一ユーザに対してのみ作用するユーティリティは、このオプションを使用し、 +データベース全体を再構築するオーバヘッドを避けることが出来ます。 +.El +.Pp +2 つのデータベースの違いは、安全なバージョンでは、ユーザのパスワードが +暗号化されて入っており、安全でないバージョンでは、パスワードが ``*'' と +なっていることです。 +.Pp +このデータベースは、 C ライブラリパスワードルーチンに使われます ( +.Xr getpwent 3 +を参照) 。 +.Pp +.Nm +は成功したときは 0 を返し、失敗したときは 0 以外を返します。 +.Sh ファイル +.Bl -tag -width Pa -compact +.It Pa /etc/pwd.db +セキュリティのないパスワードデータベースファイル +.It Pa /etc/pwd.db.tmp +一時ファイル。 +.It Pa /etc/spwd.db +セキュリティのあるパスワードデータベースファイル。 +.It Pa /etc/spwd.db.tmp +一時ファイル。 +.It Pa /etc/master.passwd +現在のパスワードファイル。 +.It Pa /etc/passwd +バージョン 7 フォーマットのパスワードファイル。 +.El +.Sh バグ +パスワードファイルのアトミック (atomic; 不可分) な更新が必要なので、 +.Nm +は、インストールに +.Xr rename 2 +を使います。 +しかし、コマンドラインで指定されたファイルが +.Pa /etc +ディレクトリと同じファイルシステム上に存在しなければなりません。 +.Pp +複数の人が、 +.Nm +を同時に異なるパスワードファイルに対して走らせると、 +明らかにレース (race; 競合) になってしまいます。 +.Nm +のフロントエンドである +.Xr chpass 1 , +.Xr passwd 1 , +.Xr vipw 8 +では、この問題を避けるために必要なロック操作を行います。 +.Sh 可搬性 +以前のバージョンのシステムは、 +.Nm pwd_mkdb , +.Xr mkpasswd 8 +と同様のプログラムを持っており、それはパスワードファイルに対して +.Xr dbm 3 +スタイルのデータベースを構築しましたが、 +これをインストールするために呼ぶプログラムに依存していました。 +このプログラムは、以前のプログラムのユーザが機能の変化で +驚かないように名前が変えられました。 +.Sh 関連項目 +.Xr chpass 1 , +.Xr passwd 1 , +.Xr db 3 , +.Xr getpwent 3 , +.Xr passwd 5 , +.Xr vipw 8 diff --git a/ja_JP.eucJP/man/man8/quot.8 b/ja_JP.eucJP/man/man8/quot.8 new file mode 100644 index 0000000000..e4b357a90a --- /dev/null +++ b/ja_JP.eucJP/man/man8/quot.8 @@ -0,0 +1,103 @@ +.\" Copyright (C) 1994 Wolfgang Solfrank. +.\" Copyright (C) 1994 TooLs GmbH. +.\" 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 TooLs GmbH. +.\" 4. The name of TooLs GmbH may not be used to endorse or promote products +.\" derived from this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY TOOLS GMBH ``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 TOOLS GMBH 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: quot.8,v 1.3.4.3 1997/10/14 06:39:17 charnier Exp % +.\" jpman %Id: quot.8,v 1.3 1997/07/22 16:55:54 horikawa Stab % +.\" +.Dd February 8, 1994 +.Dt QUOT 8 +.Os BSD 4 +.Sh 名称 +.Nm quot +.Nd 各ユーザの利用しているディスク領域を表示する +.Sh 書式 +.Nm quot +.Op Fl acfhknv +.Op Ar filesystem ... +.Sh 解説 +.Nm quot +各ローカルユーザのディスク利用に関する統計情報を集めるために使われます。 +.Pp +以下のオプションが利用可能です。 +.Bl -tag -width indent +.It Fl a +全てのマウントされたファイルシステムに関する統計情報を与えます。 +.It Fl c +一行毎に 3 つのカラムを使って、ファイルあたりのブロック数と、 +この分類に含まれるファイルの数と、このサイズ以下の +ファイルのブロック総数を集計します。 +.It Fl f +個々のユーザに対して、ファイル数と利用されているスペースを表示します。 +.It Fl h +個々のファイルのサイズに基づいて、ブロック数を推定します。 +これは、 ( ファイル中の穴を計算しないので ) 正しい結果を与えないうえ、 +高速でもないので、お勧めしません。 +.It Fl k +デフォルトでは、全てのサイズは 512 バイト / ブロックで報告されます。 +.Fl k +オプションは、報告される値をキロバイト単位にします。 +.It Fl n +標準入力から inode の一覧を (いくつかのオプションデータを加えて 1 行で) +与えることで、個々のファイルに対して持ち主を +( 入力行で与えられた残りの情報と共に ) 表示します。 +これは歴史的にはパイプ中で以下のように使われました。 +.Bd -literal -offset indent +ncheck filesystem | sort +0n | quot -n filesystem +.Ed +.Pp +ファイルの報告とその持ち主を手に入れます。 +.It Fl v +デフォルトの出力に加えて、30, 60, 90 日間アクセスされていないファイルの数 +を報告します。 +.El +.Sh 環境変数 +.Bl -tag -width BLOCKSIZE +.It Ev BLOCKSIZE +環境変数 +.Ev BLOCKSIZE +が設定されており、 +.Gl k +オプションが指定されていない時、ブロックカウントはこのブロックサイズの単位 +で表示されます。 +.El +.Sh バグ +FreeBSD では、 ncheck は存在しません :-) +.Sh 関連項目 +.Xr df 1 , +.Xr quota 1 , +.Xr getmntinfo 3 , +.Xr fstab 5 , +.Xr mount 8 +.Sh 歴史 +この +.Nm quot +の実装は、 +.An Wolfgang Solfrank +/ TooLs GmbH +によって行われました。 diff --git a/ja_JP.eucJP/man/man8/quotacheck.8 b/ja_JP.eucJP/man/man8/quotacheck.8 new file mode 100644 index 0000000000..868dedaa51 --- /dev/null +++ b/ja_JP.eucJP/man/man8/quotacheck.8 @@ -0,0 +1,149 @@ +.\" Copyright (c) 1983, 1990, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" This code is derived from software contributed to Berkeley by +.\" Robert Elz at The University of Melbourne. +.\" +.\" 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. +.\" +.\" 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. +.\" +.\" @(#)quotacheck.8 8.1 (Berkeley) 6/5/93 +.\" jpman %Id: quotacheck.8,v 1.2 1997/05/19 05:05:46 mitchy Stab % +.\" +.Dd June 5, 1993 +.Dt QUOTACHECK 8 +.Os BSD 4.2 +.Sh 名称 +.Nm quotacheck +.Nd ファイルシステムの割り当て制限の一貫性の検査を行う +.Sh 書式 +.Nm quotacheck +.Op Fl g +.Op Fl u +.Op Fl v +.Ar filesystem Ar ... +.Nm quotacheck +.Op Fl g +.Op Fl u +.Op Fl v +.Fl a +.Sh 解説 +.Nm quotacheck +は各ファイルシステムを調べ、現在のディスク使用量のテーブルを作成し、こ +れをディスクに保存されている割り当て制限情報ファイルと比較します。違い +が発見された場合、割り当て制限情報ファイルとシステムが持っている割り当 +て制限情報のコピー(アクティブなファイルシステムを検査した場合)を更新し +ます。デフォルトでは、ユーザ割り当て制限とグループ割り当て制限の両方が +検査されます。 +.Pp +オプションは以下のとおりです: +.Bl -tag -width Ds +.It Fl a +ファイルシステム名のかわりに +.Fl a +が指定されると、 +.Nm quotacheck +は、 +.Pa /etc/fstab +に読み書き可能で割り当て制限ありと設定されているファイルシステムをすべ +て検査します。デフォルトでは、 +.Pa /etc/fstab +に書かれている種類の割り当て制限のみを検査します。 +.It Fl g +.Pa /etc/fstab +にグループ割り当て制限が指定してあるもののみ検査します。 +.It Fl u +.Pa /etc/fstab +にユーザ割り当て制限が指定してあるもののみ検査します。 +.It Fl v +計算した値と記録されていた割り当て制限ファイルとの違いを報告します。 +.El +.Pp +.Fl g +と +.Fl u +の両方を指定すると、デフォルトの動作と同じになります。 +ファイルシステム上では、 +.Xr fsck 8 +と同様に +.Pa /etc/fstab +の中のパス番号を使って、並行して複数のファイルシステムを検査します。 +.Pp +通常 +.Nm quotacheck +は何も表示しません。 +.Pp +.Nm quotacheck +は、チェックされるファイルシステムのルートディレクトリに割り当て制限を +書いたファイル +.Pa quota.user +と +.Pa quota.group +があるものとして動作します。このデフォルトのファイル名は +.Pa /etc/fstab +により変更することができます。もし、割り当て制限を書いたファイル +がなければ、 +.Nm quotacheck +が作成します。 +.Pp +.Nm quotacheck +は、通常 +.Pa /etc/rc.local +からブート時に、 +.Xr quotaon 8 +が割り当て制限を開始する前に実行されます( +.Xr rc 8 +参照)。 +.Pp +.Nm quotacheck +は、各ユーザごとのディスク使用量を計算するために、rawデバイス +をアクセスします。そのため、 +.Nm quotacheck +の実行中にチェックされるファイルシステムを使用してはいけません。 +.Sh 関連ファイル +.Bl -tag -width quota.group -compact +.It Pa quota.user +ファイルシステムのルートにあるユーザ割り当て制限に関するデータ +.It Pa quota.group +ファイルシステムのルートにあるグループ割り当て制限に関するデータ +.It Pa /etc/fstab +ファイルシステムの名前と位置を読み取る +.El +.Sh 関連項目 +.Xr quota 1 , +.Xr quotactl 2 , +.Xr fstab 5 , +.Xr edquota 8 , +.Xr fsck 8 , +.Xr quotaon 8 , +.Xr repquota 8 +.Sh 歴史 +.Nm +は +.Bx 4.2 +で追加されました。 diff --git a/ja_JP.eucJP/man/man8/quotaon.8 b/ja_JP.eucJP/man/man8/quotaon.8 new file mode 100644 index 0000000000..1fbec11d5b --- /dev/null +++ b/ja_JP.eucJP/man/man8/quotaon.8 @@ -0,0 +1,138 @@ +.\" Copyright (c) 1983, 1990, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" This code is derived from software contributed to Berkeley by +.\" Robert Elz at The University of Melbourne. +.\" 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. +.\" +.\" 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. +.\" +.\" @(#)quotaon.8 8.2 (Berkeley) 12/11/93 +.\" jpman %Id: quotaon.8,v 1.2 1997/05/15 08:52:36 mitchy Stab % +.\" +.Dd December 11, 1993 +.Dt QUOTAON 8 +.Os BSD 4.2 +.Sh 名称 +.Nm quotaon , +.Nm quotaoff +.Nd ファイルシステム割り当て制限のオンとオフ +.Sh 書式 +.Nm quotaon +.Op Fl g +.Op Fl u +.Op Fl v +.Ar filesystem Ar ... +.Nm quotaon +.Op Fl g +.Op Fl u +.Op Fl v +.Fl a +.Nm quotaoff +.Op Fl g +.Op Fl u +.Op Fl v +.Ar filesystem Ar ... +.Nm quotaoff +.Op Fl g +.Op Fl u +.Op Fl v +.Fl a +.Sh 解説 +.Nm quotaon +は、システムにファイルシステムの割り当て制限をオンにするように通 +告します。 +.Nm quotaoff +は、システムに指定されたファイルシステムのす +べての割り当て制限をオフにするように通告します。指定される +ファイルシステムは +.Pa /etc/fstab +にエントリがあり、かつ、マウントされていなければいけま +せん。 +.Nm quotaon +は、指定されたファイルシステムのルートディレクトリに割り当て制限を書いた +ファイル +.Pa quota.user +と +.Pa quota.group +があるものとして動作します。このデフォルトのファイル名は +.Pa /etc/fstab +により変更することができます。デフォルトでユーザ +とグループの両方に対する割り当て制限が開始されます。 +.Pp +オプションは以下のとおりです: +.Bl -tag -width indent +.It Fl a +ファイルシステム名のかわりに +.Fl a +が指定されると、 +.Nm quotaon Ns / Ns Nm quotaoff +は +.Pa /etc/fstab +に読み書き可能で割り当て制限が指定されているファイルシステム +をすべてオン/オフします。デフォルトでは、 +.Pa /etc/fstab +で指定されている制限のみがオンになります。 +.It Fl g +.Pa /etc/fstab +にグループ割り当て制限が指定してあるもののみオン/オフします。 +.It Fl u +.Pa /etc/fstab +にユーザ割り当て制限が指定してあるもののみオン/オフします。 +.It Fl v +.Nm quotaon +と +.Nm quotaoff +が各ファイルシステムの割り当て制限をオン/オフす +るときにメッセージを表示します。 +.El +.Pp +.Fl g +と +.Fl u +の両方を指定すると、デフォルトの動作と同じになります。 +.Sh 関連ファイル +.Bl -tag -width quota.group -compact +.It Pa quota.user +ファイルシステムのルートにあるユーザ割り当て制限に関するデータ +.It Pa quota.group +ファイルシステムのルートにあるグループ割り当て制限に関するデータ +.It Pa /etc/fstab +ファイルシステムの名前と位置を読み取る +.El +.Sh 関連項目 +.Xr quota 1 , +.Xr quotactl 2 , +.Xr fstab 5 , +.Xr edquota 8 , +.Xr quotacheck 8 , +.Xr repquota 8 +.Sh 歴史 +.Nm +は +.Bx 4.2 +で追加されました。 diff --git a/ja_JP.eucJP/man/man8/rarpd.8 b/ja_JP.eucJP/man/man8/rarpd.8 new file mode 100644 index 0000000000..a18c85a7dc --- /dev/null +++ b/ja_JP.eucJP/man/man8/rarpd.8 @@ -0,0 +1,121 @@ +.\" @(#) %Id: rarpd.8,v 1.3.2.3 1997/10/14 06:39:27 charnier Exp % (LBL) +.\" +.\" Copyright (c) 1990, 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: (1) source code distributions +.\" retain the above copyright notice and this paragraph in its entirety, (2) +.\" distributions including binary code include the above copyright notice and +.\" this paragraph in its entirety in the documentation or other materials +.\" provided with the distribution, and (3) all advertising materials mentioning +.\" features or use of this software display the following acknowledgement: +.\" ``This product includes software developed by the University of California, +.\" Lawrence Berkeley Laboratory and its contributors.'' 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. +.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED +.\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF +.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. +.\" jpman %Id: rarpd.8,v 1.2 1997/04/12 08:52:47 yugawa Stab % +.\" +.Dd July 19, 1993 +.Dt RARPD 8 +.Os +.Sh 名称 +.Nm rarpd +.Nd 逆 ARP デーモン +.Sh 書式 +.Nm rarpd +.Op Fl afsv +.Op Ar interface +.Sh 解説 +.Nm rarpd +は、 +.Ar interface +に対応するイーサネットについて、逆 ARP 要求に対するサービスを提供します。 +要求を受け付けると、 +.Nm +はイーサネットアドレスより IP アドレス を、ホスト名を経由して対応づけます。 +ホスト名に関しては、 +.Xr ethers 5 +データベースと +.Xr hosts 5 +データベースの両者に登録されている必要があります。もしホスト名がどちらにも登録 +されてない場合、変換処理は実行されず、返答も行われません。 + +デフォルトでは、( +.Nm +が動作している) サーバがターゲットを +「ブート」できる場合にのみ要求が受け付けられます; +これはすなわち、 +.Pa /tftpboot/\fIipaddr\fP* +に該当するファイルもしくはディレクトリ (ここで、 +.Pa ipaddr +は、ターゲットの IP アドレスを16進数で記したものです) +が存在することを意味します。 +例えば、IP アドレス 204.216.27.18 は、 +.Pa /tftpboot/CCD81B12 +、 +.Pa /tftpboot/CCD81B12.SUN3 +、あるいは、 +.Pa /tftpboot/CCD81B12-boot +が存在する場合のみ、返答されます。 +ただし、 +.Fl s +フラグが指定された場合は、この制約はなくなります(下記参照)。 + +通常の動作においては、 +.Nm +は自分自身を fork し、バックグラウンドプロセスとして +実行します。例外およびエラーについては、発生事象を +.Xr syslog 3 +を通じて報告します。 +.Sh オプション +.Bl -tag -width indent +.It Fl a +システムに接続されているすべてのイーサネットについて listen() を行ないます。 +本オプションが指定されてない場合は、ネットワークインタフェースを指定する必要が +あります。 +.It Fl f +.Nm rarpd +をフォアグラウンドプロセスとして起動します。 +.It Fl s +.Pa /tftpboot/\fIipaddr\fP* +のあるなしにかかわらず、 +イーサネットアドレスと IP アドレスの対応付けがあれば全ての RARP 要求に対して +応答します。 +.It Fl v +詳細なログを出力します。 +.El +.Sh 関連ファイル +.Bl -tag -width /etc/ethers -compact +.It Pa /etc/ethers +.It Pa /etc/hosts +.It Pa /tftpboot +.El +.Sh 関連項目 +.Xr bpf 4 +.Pp +RFC 903: Finlayson, R.; Mann, T.; Mogul, J.C.; Theimer, M. Reverse Address +Resolution Protocol. 1984 June; 4 p. +.Sh 作者 +.An Craig Leres Aq leres@ee.lbl.gov +および +.An Steven McCanne Aq mccanne@ee.lbl.gov . +Lawrence Berkeley Laboratory, University of California, Berkeley, CA. +.Sh バグ +.Nm +は、 +.Pa /etc/ethers +で発見されたホスト名の解決に DNS を使用する事も出来ます。 +このホスト名が DNS には登録されていないが、 +.Pa /etc/hosts +には存在する場合、 +DNS への問い合わせのため、RARP の応答に時間がかかる事になります。 +この様な場合は、 +.Pa /etc/host.conf +にて +.Pa /etc/hosts +を先に検索するように設定する事をお薦めします。 diff --git a/ja_JP.eucJP/man/man8/rbootd.8 b/ja_JP.eucJP/man/man8/rbootd.8 new file mode 100644 index 0000000000..323154f924 --- /dev/null +++ b/ja_JP.eucJP/man/man8/rbootd.8 @@ -0,0 +1,159 @@ +.\" Copyright (c) 1988, 1992 The University of Utah and the Center +.\" for Software Science (CSS). +.\" Copyright (c) 1992, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" This code is derived from software contributed to Berkeley by +.\" the Center for Software Science of the University of Utah Computer +.\" Science Department. CSS requests users of this software to return +.\" to css-dist@cs.utah.edu any improvements that they make and grant +.\" CSS redistribution rights. +.\" +.\" 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. +.\" +.\" 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. +.\" +.\" @(#)rbootd.8 8.2 (Berkeley) 12/11/93 +.\" %Id: rbootd.8,v 1.3 1996/09/22 21:54:30 wosch Exp % +.\" +.\" Utah $Hdr: rbootd.man 3.1 92/07/06$ +.\" Author: Jeff Forys, University of Utah CSS +.\" jpman %Id: rbootd.8,v 1.2 1997/03/31 14:57:40 horikawa Stab % +.\" +.Dd "December 11, 1993" +.Dt RBOOTD 8 +.Os +.Sh 名称 +.Nm rbootd +.Nd HP 社製ワークステーションのブート要求に対応するブートサーバ +.Sh 書式 +.Nm rbootd +.Op Fl ad +.Op Fl i Ar interface +.Op config_file +.Sh 解説 +.Nm rbootd +ユーティリティは、LAN 上の Hewlett-Packard 社製ワークステーションからの +ブート要求に対するサービスを行います。 +全てのブートファイルはブートファイル用のディレクトリになければならず、 +さらに、もしクライアントがブートリクエスト中にパス情報をつけていた場合は、 +処理する前にそのパスは取り除かれます。デフォルトでは、 +.Nm rbootd +は, そのコンフィグレーションファイル中にリストされているマシンからの +リクエストにのみ応答します。 +.Pp +オプションとしては以下のものがあります: +.Bl -tag -width Fl +.It Fl a +どのようなマシンからのブート要求にも応えます。このオプションが設定された +場合は、コンフィギュレーションファイルは無視されます。 +.It Fl d +.Nm rbootd +をデバッグモードで起動します。受信および送信 +されたパケットが端末に表示されるようになります。 +.It Fl i Ar interface +指定したインタフェースに対してサービスを行います。 +もし指定されていない場合には、 +.Nm rbootd +はループバック以外のもっとも小さい番号の使用可能なインタフェースを +システムインタフェースリストから探します。 +早いもの順で選ぶので、組合せはバラバラになります。 +.El +.Pp +.Ar config_file +を指定すれば、 +.Nm rbootd +はデフォルトのコンフィギュレーションファイルではなく、こちらのファイルを +使用するようになります。 +.Pp +コンフィギュレーションファイルは、各行に個々のマシンの設定を記述した +テキストファイルです。行の先頭は各マシンの Ethernet アドレスで始め、 +そのあとにブートファイルの名前をオプションとして記述します。 +Ethernet アドレスは 6 オクテッドの値を 16 進数で記述し、 +各間を ``:'' で区切ります。 +ブートファイルの名前は、ブートファイルディレクトリにあるファイルの名前です。 +Ethernet アドレスとブートファイルの名前の間は、空白もしくはコンマで区切ら +なければなりません。 +行中の ``#'' より後は無視します。 +.Pp +コンフィギュレーションファイルの例を以下に示します: +.Bl -column 08:00:09:0:66:ad SYSHPBSD,SYSHPUX "# vandy (anything)" +.It # +.It # ethernet addr boot file(s) comments +.It # +.It 08:00:09:0:66:ad SYSHPBSD # snake (4.3BSD) +.It 08:00:09:0:59:5b # vandy (anything) +.It 8::9:1:C6:75 SYSHPBSD,SYSHPUX # jaguar (either) +.El +.Pp +.Nm rbootd +のログやエラーメッセージは +.Xr syslog 3 +を使っています。スタートアップメッセージはつねにログに記録され、 +致命的なエラー(もしくは +.Nm rbootd +を殺すようなシグナル) +が起こった場合にはサーバの終了メッセージもログに残します。 +一般的には、致命的ではないエラーはそれによってひき起こされる動作を +無視するといった形で扱われます。 +(例えばコンフィギュレーションファイル中の無効なEthernet アドレスは +その行が無効になる原因となります)。 +.Pp +以下のシグナルを +.Xr kill 1 +コマンドを使ってサーバプロセスに送ることで、 +サーバプロセスに影響を与えることができます: +.Bl -tag -width SIGUSR1 -offset -compact +.It SIGHUP +アクティブな接続を切り、リコンフィグします。 +.It SIGUSR1 +デバッグモードをオンにします。すでにオンであれば何もしません。 +.It SIGUSR2 +デバッグモードをオフにします。すでにオフであれば何もしません。 +.El +.Sh 関連ファイル +.Bl -tag -width /usr/libexec/rbootd -compact +.It /dev/bpf# +パケットフィルタのデバイス +.It /etc/rbootd.conf +コンフィギュレーションファイル +.It /tmp/rbootd.dbg +デバッグ出力 +.It /usr/mdec/rbootd +ブートファイルを置くディレクトリ +.It /var/run/rbootd.pid +.Nm rbootd +のプロセス ID +.El +.Sh 関連項目 +.Xr kill 1 , +.Xr socket 2 , +.Xr signal 3 , +.Xr syslog 3 +.Sh バグ +同一インタフェース上に複数のサーバが走った場合、 +同一のパケットに対して各サーバが応答してしまいます。 diff --git a/ja_JP.eucJP/man/man8/rc.8 b/ja_JP.eucJP/man/man8/rc.8 new file mode 100644 index 0000000000..99f6c69a4e --- /dev/null +++ b/ja_JP.eucJP/man/man8/rc.8 @@ -0,0 +1,115 @@ +.\" Copyright (c) 1980, 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. +.\" +.\" 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. +.\" +.\" @(#)rc.8 8.2 (Berkeley) 12/11/93 +.\" jpman %Id: rc.8,v 1.3 1997/08/16 13:37:00 horikawa Stab % +.\" %Id: rc.8,v 1.2.2.1 1997/03/07 04:18:27 mpp Exp % +.\" +.Dd December 11, 1993 +.Dt RC 8 +.Os BSD 4 +.Sh 名称 +.Nm rc +.Nd 自動リブート処理とデーモン起動のためのコマンドスクリプト +.Sh 書式 +.Nm rc +.Nm rc.local +.Sh 解説 +.Nm rc +は自動リブート処理を制御するコマンドスクリプトで、 +.Nm rc.local +は特定サイトに特化したコマンドを記述するスクリプトです。 +.Pp +自動リブート処理の進行中、 +.Nm rc +は +.Em autoboot +を引数として起動されます。 +.Nm rc +はその最初の部分で +.Xr fsck 8 +を +.Fl p +オプション付きで実行し、 +前回のシステムシャットダウンによる些細なディスク不整合を全て「修繕」し、 +ハードウェアあるいはソフトウェアの障害から生じた +重大なディスク不整合を調べます。 +この自動チェックと修繕がうまくいくと、 +.Nm rc +の第二部が開始します。 +.Pp +.Nm rc +の第二部は +自動リブート処理が成功した後および +シングルユーザモードのシェルが終了して +.Nm rc +が起動された場合( +.Xr init 8 +参照)に実行されます。 +この第二部はシステムの全てのデーモンを起動し、 +エディタファイルを保存し、 +一時ディレクトリ +.Pa /tmp +をクリアします。 +.Pp +.Nm rc.local +は +.Nm fsck +の成功後、他のコマンドを実行する直前に実行されます。 +通常、 +.Nm rc.local +ファイル中の最初のコマンドは +.Xr hostname 1 +を用いてマシン名を定義し、 +システムクラッシュの結果生成されたコアイメージがあれば +.Xr savecore 8 +によってそれを保存します。 +後者のコマンドが +.Nm rc.local +に含められているのは、 +コアダンプを保存するディレクトリ位置が普通、サイト毎に異なっているからです。 +.Pp +伝統に従い、スタートアップファイル +.Nm rc +および +.Nm rc.local +は +.Pa /etc +ディレクトリに置かれます。 +.Sh 関連項目 +.Xr init 8 , +.Xr reboot 8 , +.Xr savecore 8 +.Sh 歴史 +.Nm +コマンドは +.Bx 4.0 +で登場しました。 diff --git a/ja_JP.eucJP/man/man8/reboot.8 b/ja_JP.eucJP/man/man8/reboot.8 new file mode 100644 index 0000000000..6154d34112 --- /dev/null +++ b/ja_JP.eucJP/man/man8/reboot.8 @@ -0,0 +1,113 @@ +.\" Copyright (c) 1990, 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. +.\" +.\" 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. +.\" +.\" @(#)reboot.8 8.1 (Berkeley) 6/9/93 +.\" jpman %Id: reboot.8,v 1.3 1997/06/06 11:35:27 bobson Stab % +.\" +.Dd June 9, 1993 +.Dt REBOOT 8 +.Os +.Sh 名称 +.Nm reboot , +.Nm halt +.Nd +システムを停止し、再起動する +.Sh 書式 +.Nm halt +.Op Fl nqp +.Nm reboot +.Op Fl nqp +.Nm fasthalt +.Op Fl nqp +.Nm fastboot +.Op Fl nqp +.Sh 解説 +.Nm halt +と +.Nm reboot +は、ファイルシステムのキャッシュをディスクへ書き出し、 +すべての実行中のプロセスに SIGTERM を +(そして、それに続いて SIGKILL を) 送ります。 +そして、システムを停止( +.Nm halt +) したり、再起動 ( +.Nm reboot +) したりします。 +その動作はログインのアカウンティング・ファイルに記入されます。 +それはログインのアカウンティング・ファイルへのシャットダウン記録の書き出し +を含んでいます。 +.Pp +オプションとしては以下のものがあります。 +.Bl -tag -width Ds +.It Fl n +.Fl n +オプションが指定されると、システムのキャッシュがディスクへ書き出されません。 +このオプションは使用すべきではありません。 +.It Fl q +.Fl q +オプションが指定されると、システムは、とにかく速く停止されたり、 +再起動されたりします。そしてシステムのキャッシュの破棄だけが行われます。 +このオプションは使用すべきではありません。 +.It Fl p +.Fl p +オプションが指定されると、システムは可能であれば電源を切ります。 +これは、もちろん +.Nm reboot +でも、 +.Nm halt +と同じように振る舞うということです。 +.El +.Pp +.Nm fasthalt +と +.Nm fastboot +は、それぞれ +.Nm halt +と +.Nm reboot +の単なる別名にすぎません。 +.Pp +通常、システムの停止や、再起動を要する場合には、ユーザーに事前警告を与える +.Xr shutdown 8 +を使用します。 +.Xr shutdown 8 +は、ログインしているユーザーにシステム停止の警告を与えます。 +.Pp +.Sh 関連項目 +.Xr utmp 5 , +.Xr boot 8 , +.Xr shutdown 8 , +.Xr sync 8 +.Sh 歴史 +.Nm reboot +コマンドは +.At v6 +で追加されました。 diff --git a/ja_JP.eucJP/man/man8/renice.8 b/ja_JP.eucJP/man/man8/renice.8 new file mode 100644 index 0000000000..63aee8c6e5 --- /dev/null +++ b/ja_JP.eucJP/man/man8/renice.8 @@ -0,0 +1,121 @@ +.\" Copyright (c) 1983, 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. +.\" +.\" 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. +.\" +.\" @(#)renice.8 8.1 (Berkeley) 6/9/93 +.\" jpman %Id: renice.8,v 1.3 1997/07/26 22:06:08 horikawa Stab % +.\" +.Dd June 9, 1993 +.Dt RENICE 8 +.Os BSD 4 +.Sh 名称 +.Nm renice +.Nd 走行中のプロセスの優先度を変更する +.Sh 書式 +.Nm renice +.Ar priority +.Oo +.Op Fl p +.Ar pid ... +.Oc +.Oo +.Op Fl g +.Ar pgrp ... +.Oc +.Oo +.Op Fl u +.Ar user ... +.Oc +.Sh 解説 +.Nm renice +は、1 つ以上の走行中プロセスのスケジュール優先度を変更します。 +priority に後続するパラメータ +.Ar who +は、プロセス ID か、プロセスグループ ID か、ユーザ名として解釈されます。 +プロセスグループに対する +.Nm renice +の実行は、そのグループに属するすべてのプロセスの優先度を変化させます。 +ユーザ名に対する +.Nm renice +の実行は、そのユーザが所有するすべてのプロセスの優先度を変化させます。 +デフォルトでは、プロセス ID で指定したプロセスのみが影響を受けます。 +.Pp +.Nm renice +にてサポートされるオプションは以下のとおりです: +.Bl -tag -width Ds +.It Fl g +.Ar who +パラメータをプロセスグループ ID であると解釈させます。 +.It Fl u +.Ar who +パラメータをユーザ名であると解釈させます。 +.It Fl p +.Ar who +パラメータをプロセス ID であると解釈させます(デフォルト)。 +.El +.Pp +たとえば、 +.Bd -literal -offset +renice +1 987 -u daemon root -p 32 +.Ed +.Pp +は、プロセス ID が 987, 32 のプロセスと、 +ユーザ daemon, root が所有するすべてのプロセスの優先度を変更します。 +.Pp +スーパユーザ以外のユーザは所有するプロセスについてのみ変更が可能で、 +プロセスの ``nice 値'' を 0 から +.Dv PRIO_MAX +(20) の範囲内で単調に増加させることができます。 +(これによりシステム管理者による命令が無効になるのを防ぎます。) +スーパユーザは、すべてのプロセスの優先度を +.Dv PRIO_MIN +(\-20) から +.Dv PRIO_MAX +(20) の範囲で自由に変更することができます。 +よく用いられる値としては以下のものがあります: +20 (システム内のほかのプロセスすべてが走行しないときのみ走行する)、 +0 (``基準'' となるスケジュール優先度)、 +適当な負の値(そのプロセスを素早く実行させる) +.Sh 関連ファイル +.Bl -tag -width /etc/passwd -compact +.It Pa /etc/passwd +ユーザ名とユーザ ID を関連づける +.El +.Sh 関連項目 +.Xr getpriority 2 , +.Xr setpriority 2 +.Sh バグ +スーパユーザ以外のユーザは、たとえ以前に優先度を下げたプロセスであって +も優先度を上げることはできません。 +.Sh 歴史 +.Nm +は +.Bx 4.0 +で追加されました。 diff --git a/ja_JP.eucJP/man/man8/repquota.8 b/ja_JP.eucJP/man/man8/repquota.8 new file mode 100644 index 0000000000..17b4a4b601 --- /dev/null +++ b/ja_JP.eucJP/man/man8/repquota.8 @@ -0,0 +1,106 @@ +.\" Copyright (c) 1983, 1990, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" This code is derived from software contributed to Berkeley by +.\" Robert Elz at The University of Melbourne. +.\" +.\" 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. +.\" +.\" 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. +.\" +.\" @(#)repquota.8 8.1 (Berkeley) 6/6/93 +.\" jpman %Id: repquota.8,v 1.2 1997/05/22 07:39:12 mitchy Stab % +.\" +.Dd June 6, 1993 +.Dt REPQUOTA 8 +.Os BSD 4.2 +.Sh 名称 +.Nm repquota +.Nd ファイルシステムの割り当て制限状況を表示する +.Sh 書式 +.Nm repquota +.Op Fl g +.Op Fl u +.Op Fl v +.Ar filesystem Ar ... +.Nm repquota +.Op Fl g +.Op Fl u +.Op Fl v +.Fl a +.Sh 解説 +.Nm repquota +は、指定されたファイルシステムのディスク使用状況と、割り当て制 +限状況を表示します。 +.Pp +オプションは以下のとおりです: +.Bl -tag -width indent +.It Fl a +.Pa /etc/fstab +に記述された全ファイルシステムに関する情報を表示します。 +.It Fl g +グループ割り当て制限のみを表示します(デフォルトでは、グループ、ユーザ +両方の割り当て制限を表示します)。 +.It Fl u +ユーザ割り当て制限のみを表示します(デフォルトでは、グループ、ユーザ +両方の割り当て制限を表示します)。 +.It Fl v +個々のファイルシステムの割り当て(クォータ)を表示する前に、ヘッダ行を出 +力します。 +.El +.Pp +各ユーザやグループに関する現在の、ファイル数、サイズ(キロバイト単位)、 +および割り当て制限 +( +.Xr edquota 8 +により設定される)が表示されます。 +.Pp +operator グループに所属するユーザかスーパユーザのみが、このコマンドを +実行できます。 +.Sh 関連ファイル +.Bl -tag -width quota.group -compact +.It Pa quota.user +ユーザの割り当て制限に関するデータ(ファイルシステムのルートディレクトリに配置される) +.It Pa quota.group +グループの割り当て制限に関するデータ(ファイルシステムのルートディレクトリに配置される) +.It Pa /etc/fstab +ファイルシステムの名前と位置を読み取る +.El +.Sh 関連項目 +.Xr quota 1 , +.Xr quotactl 2 , +.Xr fstab 5 , +.Xr edquota 8 , +.Xr quotacheck 8 , +.Xr quotaon 8 +.Sh 診断 +アクセス不可能なファイルに関する様々なメッセージが出力されます。 +.Sh 歴史 +.Nm +は +.Bx 4.2 +で追加されました。 diff --git a/ja_JP.eucJP/man/man8/restore.8 b/ja_JP.eucJP/man/man8/restore.8 new file mode 100644 index 0000000000..48d57df954 --- /dev/null +++ b/ja_JP.eucJP/man/man8/restore.8 @@ -0,0 +1,413 @@ +.\" Copyright (c) 1985, 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. +.\" +.\" 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. +.\" +.\" @(#)restore.8 8.4 (Berkeley) 5/1/95 +.\" %Id: restore.8,v 1.5.2.3 1997/10/15 18:33:33 markm Exp % +.\" +.\" jpman %Id: restore.8,v 1.2 1997/03/31 14:58:10 horikawa Stab % +.Dd May 1, 1995 +.Dt RESTORE 8 +.Os BSD 4 +.Sh 名称 +.Nm restore +.Nd "dump コマンドで作ったバックアップからファイルやファイルシステムをリストアする" +.Sh 書式 +.Nm restore +.Fl i +.Op Fl chkmvy +.Op Fl b Ar blocksize +.Op Fl f Ar file +.Op Fl s Ar fileno +.Nm restore +.Fl R +.Op Fl ckvy +.Op Fl b Ar blocksize +.Op Fl f Ar file +.Op Fl s Ar fileno +.Nm restore +.Fl r +.Op Fl ckvy +.Op Fl b Ar blocksize +.Op Fl f Ar file +.Op Fl s Ar fileno +.Nm restore +.Fl t +.Op Fl chkvy +.Op Fl b Ar blocksize +.Op Fl f Ar file +.Op Fl s Ar fileno +.Op file ... +.Nm restore +.Fl x +.Op Fl chkmvy +.Op Fl b Ar blocksize +.Op Fl f Ar file +.Op Fl s Ar fileno +.Op file ... +.Pp +.in -\\n(iSu +( +.Bx 4.3 +オプション文法はバックワードコンパチビリティのために実装されていますが、 +ここには記載していません。) +.Sh 解説 +.Nm restore +は +.Xr dump 8 +と逆の動作を行います。 +ファイルシステムの完全なリストアを行うには、 +まず、フルバックアップのリストアから始め、 +続いてその上にインクリメンタルバックアップをリストアします。 +フルまたは部分バックアップから、単一のファイルやディレクトリの部分ツリー +のみをリストア +することも可能です。 +.Nm restore +は、ネットワークを介した動作も可能です。これを行うには、以下で説明されている +.Fl f +フラグを参照してください。 +コマンドに与えるその他の引数は、リストアされるファイルを指定するための +ファイルやディレクトリ名です。 +.Fl h +フラグを指定していない限り(下記参照)、ディレクトリ名を指定することで、 +そのディレクトリ中のファイルや +(再帰的に) サブディレクトリを指定することになります。 +.Pp +以下のいずれか 1 つ(複数指定不可)のフラグが必要です: +.Bl -tag -width Ds +.It Fl i +バックアップからの対話的なリストアを行います。バックアップからディレクトリ情報 +を読み取ると、 +.Nm restore +はユーザに展開すべきファイルを選択させるために、 +シェルに似たインタフェースでコマンドを受け付けます。 +以下のコマンドが使用可能です。引数が必要なコマンドにおいて引数を省略すると、 +デフォルトとしてカレントディレクトリが使われます。 +.Bl -tag -width Fl +.It Ic add Op Ar arg +カレントディレクトリまたは指定した引数のファイルを、リストアするファイルの +リストに付け加えます。ディレクトリ名を指定した場合には、そのディレクトリの下の +すべてのファイルが展開リストに加えられます (コマンドラインに +.Fl h +フラグが指定されなかった場合)。 +.Ic ls +でファイルのリストを表示するときに、展開リストに含まれているファイルの頭 +には ``*'' がつけられています。 +.It Ic \&cd Ar arg +カレントディレクトリを指定したディレクトリに移動します。 +.It Ic delete Op Ar arg +カレントディレクトリまたは引数で指定したファイル名のファイルを、展開する +ファイルのリストから削除します。 +ディレクトリ名を指定した場合には、そのディレクトリの下のすべてのファイルが +展開リストから削除されます (コマンドラインに +.Fl h +フラグが指定されなかった場合)。 +ディレクトリ中のほとんどのファイルを展開する場合には、 +ディレクトリ全体を展開リストに加えたあとで不要なファイルだけを +削除するのが一番便利なやりかたです。 +.It Ic extract +展開ファイルリストにあるすべてのファイルをバックアップから展開します。 +.Nm restore +は、どのボリュームをマウントしたいかをユーザにたずねます。 +数個のファイルのみを展開するのにもっとも早い方法は、最終ボリュームから開始して +最初のボリュームへと戻ることです。 +.It Ic help +利用できるコマンドの簡単な説明を表示します。 +.It Ic \&ls Op Ar arg +カレントディレクトリまたは指定されたディレクトリのリストを表示します。 +ディレクトリ名の後ろには ``/'' が付け加えられ、展開リストにあるファイルの前に +は ``*'' が加えられます。冗長フラグがセットされていた場合には、 +各ディレクトリエントリにあわせて inode 番号も表示されます。 +.It Ic pwd +カレントディレクトリのフルパス名を表示します。 +.It Ic quit +.Nm restore +コマンドを中断します。展開リストに何かファイルがあったとしても終了します。 +.It Ic setmodes +展開リストにあるすべてのディレクトリの所有者、モード、時刻がセットされる +のみで、バックアップからはなにも展開されません。 +これは、リストアを途中で中断してしまった時の後始末に有用です。 +.It Ic verbose +冗長フラグ +.Fl v +の意味を反転します。冗長フラグがセットされている場合には、 +.Ic ls +コマンドは、すべてのエントリに対してその inode 番号を表示します。 +また、 +.Nm restore +コマンドは、ファイルを展開するたびにその情報を表示します。 +.El +.It Fl R +.Nm restore +は、 +フルリストアを再開するために、マルチボリュームのテープのうち特定のものを +リストアすることを要求します +(下記 +.Fl r +フラグを参照)。 +これはリストア動作を中断したときに使われます。 +.It Fl r +リストア(ファイルシステムの再構築)を行います。 +レベル 0 バックアップのリストアの前には、リストア先となるファイルシステムは +.Xr newfs 8 +で初期化しておき、マウントして、そのディレクトリへ +.Xr cd +で移動しておく必要があります。 +レベル 0 バックアップのリストアに成功したら、 +.Fl r +フラグを指定することで、 +それに加えて必要なインクリメンタルバックアップをリストアすることができます。 +.Fl r +フラグは対話的なファイルリストアを行わないため、注意して扱わないと +損害を与えることがあります (ディスクは言うに及ばず、精神的にも)。 +次のように実行します: +.Bd -literal -offset indent +newfs /dev/rrp0g eagle +mount /dev/rp0g /mnt +cd /mnt + +restore rf /dev/rst8 +.Ed +.Pp +.Nm restore +は、インクリメンタルリストアのための情報を、ルートディレクトリの +.Pa restoresymtable +に記録します。このファイルは、すべての増分をリストアしたあとで削除すべきです。 +.Pp +.Nm restore +を、 +.Xr newfs 8 +や +.Xr dump 8 +と組み合わせることで、ファイルシステムのサイズやブロックサイズといった +パラメータを変更するのに使うことができます。 +.It Fl t +指定したファイル名のファイルがバックアップ中にあれば、その名前を表示します。 +ファイル名引数がない場合にはルートディレクトリを表示するため、 +.Fl h +フラグを指定していない限り、バックアップ中のすべてのファイルを表示することに +なります。 +このフラグは、古くからあった +.Xr dumpdir 8 +のかわりの機能を持つことに注意してください。 +.ne 1i +.It Fl x +メディアから、指定したファイルが読み出されます。 +指定ファイルがディレクトリで、そのディレクトリの内容がバックアップ中に存在し、 +かつ +.Fl h +フラグが指定されていないときには、ディレクトリの内容が再帰的に展開されます。 +(可能であれば) ファイルの所有者、修正日時、モードもリストアされます。 +もし引数が与えられていなければルートディレクトリを展開するため、 +.Fl h +フラグを指定していない限り、結果的にバックアップ全体が展開されます。 +.El +.Pp +以下の追加オプションを指定可能です: +.Bl -tag -width Ds +.It Fl b Ar blocksize +ダンプレコードあたりのキロバイト数です。 +.Fl b +が指定されないときは、 +.Nm restore +はメディアのブロックサイズを動的に求めようとします。 +.It Fl c +通常 +.Nm +は、ダンプ対象のファイルシステムフォーマットが +新しいか古い(4.4 以前)かを動的に決定します。 +.Fl c +フラグはこのチェックを無効にし、 +古いフォーマットのダンプからのみ読み込むことを許します。 +.It Fl f Ar file +バックアップを +.Ar file +から読み込みます; +.Ar file +は、 +.Pa /dev/rmt12 +(テープドライブ)や +.Pa /dev/rsd1c +(ディスクドライブ)といったスペシャルデバイスファイル、 +通常のファイル、 +.Ql Fl +(標準入力)のいずれかです。 +ファイル名が +.Dq host:file +や +.Dq user@host:file +という形式である場合は、 +.Nm restore +は +.Xr rmt 8 +を用いて指定したファイルを指定のホストから読み取ります。 +.Pp +.It Fl k +リモートテープサーバとの通信時に Kerberos 認証を使用します +( +.Nm restore +のコンパイル時に有効にされている場合のみ使用可能です。) +.Pp +.It Fl h +ディレクトリ名を指定された場合に、その中のファイルではなく、 +ディレクトリそのものを展開するようにします。 +これによって、ダンプからディレクトリのサブツリーを階層的に +展開してしまうことを防ぎます。 +.It Fl m +展開を、ファイル名ではなく inode 番号によって行います。 +これは数個のファイルのみを展開したい場合で、ファイルの完全なパス名を +再生することを防ぎたい場合に有用です。 +.It Fl s Ar fileno +マルチファイルテープの +.Ar fileno +から読みます。 +ファイル番号は 1 から始まります。 +.It Fl v +普通、 +.Nm restore +は何も表示せずにリストア動作を行います。 +.Fl v +(verbose, 冗長)フラグを指定すると、 +扱うファイルのタイプとファイル名が表示されます。 +.It Fl y +エラーが発生したときに、リストア動作を中断するかどうかの問い合わせを +行いません。 +これによって、不良ブロックをスキップして、可能なかぎり動作を継続します。 +.El +.Sh 診断 +リードエラーが発生するとメッセージを表示します。 +もし、 +.Fl y +が指定されているか、あるいはユーザが +.Ql y +の応答をしたならば、 +.Nm restore +はリストアを続行しようとします。 +.Pp +バックアップが 1 巻より多くのテープボリュームに格納されていたならば、 +.Nm restore +は次のボリュームをマウントすべき時点でそれをユーザに知らせます。 +もし、 +.Fl x +あるいは +.Fl i +フラグが指定されていたら、 +.Nm restore +は、ユーザがマウントしたいのはどのボリュームであるかを問い合わせます。 +少数のファイルを最も早く展開する方法は、最終ボリュームから開始して、 +最初のボリュームへ向けて作業を進めることです。 +.Pp +.Nm restore +は数多くの一貫性検査を行っていて、それを表示します。 +ほとんどの検査結果の表示は自明であるか、あるいは「決して起こらない」ものです。 +良くあるエラーを以下に示します。 +.Pp +.Bl -tag -width Ds -compact +.It Converting to new file system format. +古い形式のファイルシステムで作られたダンプテープがロードされました。 +その場合、自動的に新しいファイルシステムの形式に変換されます。 +.Pp +.It <filename>: not found on tape +指定したファイル名はテープのディレクトリには記録されていましたが、 +テープのなかに本体が見当たりませんでした。 +このような事態が起きるのは、ファイルを探している間にテープのリードエラー +が発生した場合や、稼働中のファイルシステムにおいて作成したダンプテープ +を使った場合です。 +.Pp +.It expected next file <inumber>, got <inumber> +ディレクトリに記録されていなかったファイルが示されます。 +稼働中のファイルシステムにおいて作成したダンプを使った場合に発生することが +あります。 +.Pp +.It Incremental dump too low +インクリメンタルリストアを行う際に、ダンプが直前のインクリメンタルダンプ +よりも以前に書かれたものであったり、増分レベルが低すぎるダンプがロード +された場合に表示されます。 +.Pp +.It Incremental dump too high +インクリメンタルリストアを行う際に、ダンプが直前のインクリメンタルダンプ +の続きの範囲から開始していなかったり、あるいは増分レベルが高すぎる +ダンプがロードされた場合に表示されます。 +.Pp +.It Tape read error while restoring <filename> +.It Tape read error while skipping over inode <inumber> +.It Tape read error while trying to resynchronize +テープ(あるいはその他の媒体)のリードエラーが発生しました。 +ファイル名が表示されていたならば、その内容はおそらく部分的に不正なものに +なっているでしょう。 +もし inode がスキップされたり、テープの resynchronize(再同期)が試みら +れていたならば、展開されたファイルには問題はありません。しかし、テープ +上からいくつかのファイルを見付けることができないかもしれません。 +.Pp +.It resync restore, skipped <num> blocks +ダンプのリードエラーが発生した後に、おそらく +.Nm restore +は自分自身で再同期をとらなければなりません。 +このメッセージはスキップしたブロックの個数を表示します。 +.El +.Sh 関連ファイル +.Bl -tag -width "./restoresymtable" -compact +.It Pa /dev/rst0 +デフォルトのテープドライブ +.It Pa /tmp/rstdir* +テープ中のディレクトリを保持するファイル +.It Pa /tmp/rstmode* +ディレクトリの所有者、モード、タイムスタンプ +.It Pa \&./restoresymtable +インクリメンタルリストア間で渡される情報 +.El +.Sh 関連項目 +.Xr dump 8 , +.Xr ft 8 , +.Xr mount 8 , +.Xr newfs 8 , +.Xr rmt 8 +.Sh バグ +使用中のファイルシステムから作成されたダンプから +インクリメンタルリストアを行うと、誤動作を起こすことがあります。 +.Pp +フルリストアの終了後にはレベル 0 ダンプを行う必要があります。 +.Nm restore +はユーザコードで動作するので、inode の割り当てを制御することができません。 +したがって、ファイルの内容が変更されていない場合でも、新しい inode 割り当てを +新しいディレクトリ集合に反映させるためには、 +フルダンプを行わなければなりません。 +.Pp +ネットワークを介したリストアを行う場合、 +root 権限で restore を実行する必要があります。 +これは、以前の dump と restore のセキュリティ上の歴史によるものです。 +(restore は root に setuid されて使われるように書かれていますが、 +restore のコードから全てのバグが取れているとは思わないので、 +setuid にて使用する場合は自己の責任において行って下さい。) +.Sh 歴史 +.Nm restore +コマンドは +.Bx 4.2 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/revnetgroup.8 b/ja_JP.eucJP/man/man8/revnetgroup.8 new file mode 100644 index 0000000000..50a1e2a7c9 --- /dev/null +++ b/ja_JP.eucJP/man/man8/revnetgroup.8 @@ -0,0 +1,140 @@ +.\" Copyright (c) 1995 +.\" Bill Paul <wpaul@ctr.columbia.edu>. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by Bill Paul. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: revnetgroup.8,v 1.1.1.1 1995/10/26 16:25:29 wpaul Exp % +.\" jpman %Id: revnetgroup.8,v 1.2 1997/06/14 16:12:45 horikawa Stab % +.\" +.Dd October 24, 1995 +.Dt REVNETGROUP 8 +.Os +.Sh 名称 +.Nm revnetgroup +.Nd "逆ネットグループデータを生成する" +.Sh 書式 +.Nm revnetgroup +.Fl u +.Fl h +.Op Fl f Ar netgroup_file +.Sh 解説 +.Nm revnetgroup +は +.Xr netgroup 5 +フォーマットのファイル内容を処理し、 +.Pa 逆ネットグループ +と呼ばれる形式に変換します。 +元のファイルでは、あるグループが含むメンバを示す形式で +ネットグループのメンバが示されます。 +逆ネットグループフォーマットでは、 +あるメンバが属するグループを示します。 +この情報は +.Nm netgroup.byuser +と +.Nm netgroup.byhosts +の NIS マップを作成するために使用します。 +これらの逆ネットグループマップは、ネットグループの参照、 +特に +.Fn innetgr +ライブラリ関数を高速化するために使用されます。 +.Pp +例えば、標準の +.Nm /etc/netgroup +ファイルはネットグループとそのメンバリストを列挙します。 +ここで、ネットグループは +.Pa キー +であるとし、メンバ名を +.Pa データ +であるとします。 +これに対し、逆の +.Nm netgroup.byusers +データベースは、ユニークなメンバをキーとし、 +メンバが属するネットグループをデータとします。 +ユーザとホストに属する情報を保持する別々のデータベースを作成します; +これにより、ネットグループユーザ名参照とネットグループホスト名参照が +独立のキー空間にて実行されます。 +.Pp +あらかじめ逆ネットグループデータベース +(およびこれに対応する NIS マップ)を構築することにより、 +要求ごとに +.Xr getnetgrent 3 +ライブラリ関数が依存関係を処理しなくても良くなります。 +これは、ユーザ数及びホスト数が多いネットワークでは重要です。 +なぜなら、巨大なネットグループデータベースの処理は多大な時間を要するからです。 +.Pp +.Nm revnetgroup +コマンドは結果を標準出力に表示します。 +通常は +.Nm /var/yp/Makefile +から呼ばれるだけであり、 +これは NIS ネットグループマップを構築する時です。 +.Pp +.Sh オプション +.Nm revnetgroup +コマンドは以下のオプションをサポートします: +.Bl -tag -width flag +.It Fl u +netgroup.byuser を生成します; +元のネットグループファイルのユーザ名情報のみが処理されます。 +.It Fl h +netgroup.byhost を生成します; +元のネットグループファイルのホスト名情報のみが処理されます。( +.Fl u +か +.Fl h +のいずれかを指定する必要が有ります。) +.It Op Fl f Ar netgroup_file +.Nm revnetgroup +コマンドは +.Nm /etc/netgroup +をデフォルトの入力ファイルとします。 +.Fl f +フラグにて、ユーザは別の入力ファイルを指定できます。``-'' を +入力ファイルとして指定すると、 +.Nm revnetgroup +は標準入力を読みます。 +.El +.Sh 関連ファイル +.Bl -tag -width Pa -compact +.It Pa /var/yp/Makefile +NIS データベースを構築するために +.Nm yp_mkdb +と +.Nm revnetgroup +を呼び出す Makefile。 +.It Pa /etc/netgroup +デフォルトのネットグループデータベースファイル。 +ほとんどの場合、NIS マスタサーバにだけ有ります。 +.El +.Sh 関連項目 +.Xr yp 4 , +.Xr netgroup 5 , +.Xr yp_mkdb 8 , +.Xr getnetgrent 3 +.Sh 作者 +Bill Paul <wpaul@ctr.columbia.edu> diff --git a/ja_JP.eucJP/man/man8/rexecd.8 b/ja_JP.eucJP/man/man8/rexecd.8 new file mode 100644 index 0000000000..edcf701df2 --- /dev/null +++ b/ja_JP.eucJP/man/man8/rexecd.8 @@ -0,0 +1,143 @@ +.\" Copyright (c) 1983, 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. +.\" +.\" 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. +.\" +.\" @(#)rexecd.8 8.2 (Berkeley) 12/11/93 +.\" jpman %Id: rexecd.8,v 1.2 1997/05/28 07:05:49 yugawa Stab % +.\" %Id: rexecd.8,v 1.3.2.2 1996/11/23 08:25:35 phk Exp % +.\" +.Dd September 23, 1994 +.Dt REXECD 8 +.Os BSD 4.2 +.Sh 名称 +.Nm rexecd +.Nd リモート実行サーバ +.Sh 書式 +.Nm rexecd +.Sh 解説 +.Nm rexecd +は、 +.Xr rexec 3 +ルーチンのためのサーバです。本サーバは、ユーザ名と +パスワードに基づいたユーザ認証による、リモートプロセス実行の環境 +を提供します。 +.Pp +.Nm rexecd +は、 +.Xr services 5 +にて ``exec'' サービスが定義されたポートを +監視します。サービス要求を受信した際に、以下のプロトコルが +実行されます。 +.Bl -enum +.It +サーバは、ソケットから NUL +.Pq Ql \e0 +を受信するまで文字を読みとります。受信した文字は +.Tn ASCII +文字からなる 10 進数の数字として評価されます。 +.It +ステップ 1 で受信した番号が 0 でない場合、その番号は +.Em stderr +のために用いられる +ストリームのためのポート番号として用いられます。その後、第二の接続がクライア +ントホスト上の指定されたポートとの間に生成されます。 +.It +NUL で終了する最大 16 文字のユーザ名が最初のソケットより取得されます。 +.It +NUL で終了する、暗号化が施されていない最大 16 文字のパス +ワードが最初の socket より取得されます。 +.It +NUL で終了する、シェルに渡されるコマンドが最初の socket より取得 +されます。コマンドの長さは、システムの引数リストの制限を越えない長さに +制限されます。 +.It +.Nm rexecd +は、次に、ログイン時と同様にユーザの認証を行い、 +ユーザ認証が成功した場合、 +カレントディレクトリを当該ユーザのホームディレクトリに変更し、 +ユーザとグループの保護を行ないます。仮にこれらの段階が失敗した場合、 +コネクションを切断し、診断メッセージを返します。 +.It +NUL 文字が最初のソケットに返却され、コマンドラインは当該ユーザの +通常のログインシェルに渡されます。シェルは +.Nm rexecd +によって確立されたネットワークコネクションを継承します。 +.El +.Sh 警告 +.Nm rexecd +は root のログイン、/etc/ftpusers にリストされたユーザでのアクセス、 +パスワードの無いユーザのアクセスを許可しません。 +これらはすべて重大なセキュリティホールでした。 +rexec/rexecd のコンセプトは、メジャーなセキュリティホールと、それをさせない +ための例です。 +.Nm rexecd +は /etc/inetd.conf ではデフォルトで無効になっています。 +.Sh 診断 +以下のリストの一番最後のものを除き、全ての診断メッセージは、 +他のネットワークコネクションが切断された後に、最初の socket を経由して返却 +されます。エラーは、最初のバイトが値 1 であることで示されます +(コマンドの実行に先立つ全てのステップが正常に終了した場合、上記のステップ 7 +で、値 0 が返されます)。 +.Pp +.Bl -tag -width Ds +.It Sy username too long +ユーザ名が 16 文字を越えてます。 +.It Sy password too long +パスワードが 16 文字を越えてます。 +.It Sy command too long +コマンドラインの長さが(設定されている)システムの引数の長さ制限を越えてます。 +.It Sy Login incorrect. +パスワードファイルのエントリに当該ユーザ名がありません。 +.It Sy Password incorrect. +パスワードが不正です。 +.It Sy \&No remote directory. +ホームディレクトリへの +.Xr chdir +コマンドが失敗しました。 +.It Sy Try again. +サーバによる +.Xr fork +が失敗しました。 +.It Sy <shellname>: ... +ユーザのログインシェルが起動できませんでした。このメッセージは +.Em stderr +のために確立されたコネクションを用いて送信されます。 +そして、先頭にフラグバイトがつくことはありません。 +.El +.Sh 関連項目 +.Xr rexec 3 +.Sh バグ +すべてのデータとパスワードを交換する場合に、それらの暗号化を行なう機構が +用意されるべきでしょう。 +.Sh 歴史 +.Nm +コマンドは +.Bx 4.2 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/rlogind.8 b/ja_JP.eucJP/man/man8/rlogind.8 new file mode 100644 index 0000000000..d0149428c0 --- /dev/null +++ b/ja_JP.eucJP/man/man8/rlogind.8 @@ -0,0 +1,190 @@ +.\" Copyright (c) 1983, 1989, 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. +.\" +.\" 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. +.\" +.\" from: @(#)rlogind.8 8.1 (Berkeley) 6/4/93 +.\" jpman %Id: rlogind.8,v 1.2 1997/05/23 00:50:03 mutoh Stab % +.\" %Id: rlogind.8,v 1.4.2.1 1996/12/22 23:05:33 mpp Exp % +.\" +.Dd June 4, 1993 +.Dt RLOGIND 8 +.Os BSD 4.2 +.Sh 名称 +.Nm rlogind +.Nd リモートログインのサーバ +.Sh 書式 +.Nm rlogind +.Op Fl Daln +.Sh 解説 +.Nm rlogind +は、 +.Xr rlogin 1 +のためのサーバです。サーバは信頼できるホストからの +特権ポート番号に基づいた認証を用いて、リモートログイン機能を提供します。 +.Nm rlogind +では、以下のオプションが使用可能です。 +.Bl -tag -width Ds +.It Fl D +TCP_NODELAY ソケットオプションを設定します。これは、いくつかの +ネットワークトラフィックの増大に対して、応答性を向上します。 +.It Fl a +検証のために、ホスト名を問い合わせます。 +.It Fl l +ユーザがスーパユーザとしてログインしない限り、 +一般ユーザの +.Dq Pa .rhosts +による、あらゆる認証を禁止します。 +.It Fl n +キープアライブメッセージを禁止します。 +.El +.Pp +Kerberos を使っている時には、以下のようなオプションが利用可能です。 +.Bl -tag -width Ds +.It Fl k +Kerberos 認証を利用可能にします。 +.It Fl v +vacuous モードを利用可能にします。 +.It Fl x +.Nm rlogin +セッションで流される全てのデータに +.Tn DES +暗号化を施します。このオプションを利用すると、応答性や CPU に負荷が +かかりますが、機密性は向上します。 +.El +.Pp +rlogind は、 login サービスの仕様に基づく番号のポートで、要求を受け付けます。 +詳しくは +.Xr services 5 +を参照してください。 +サービスの要求を受け取ると、以下のプロトコルを開始します。 +.Bl -enum +.It +サーバはクライアントの要求元ポート番号を調べます。 +もしポート番号が512〜1023の範囲外であれば、サーバは接続を切断します。 +.It +サーバはクライアントの要求元アドレスを調べ、それに対応するホスト名を +求めます ( +.Xr gethostbyaddr 3 , +.Xr hosts 5 , +.Xr named 8 +を参照してください)。 +ホスト名を決定できなければ、ドット表記法によるホストアドレスを +用います。 +ホスト名がサーバと同じドメインに属しているか (ドメイン名の最後の二つの +構成要素に基づいて判断します)、あるいは +.Fl a +オプションが指定されていたら、 +ホスト名に対するアドレスを調べて、ホスト名とアドレスが一致しているか +どうかを検証します。 +アドレスの検証に失敗した場合は、通常の認証作業は行いません。 +.El +.Pp +要求元ポートの番号を調べ終えたら、 +.Nm rlogind +は、 +.Xr rshd 8 +で説明している認証作業を開始します。 +そして、疑似ターミナル ( +.Xr pty 4 +を参照のこと) を割り当てると共に、 +ファイルディスクリプタを操作して、 +この疑似ターミナルのスレーブ側がログインプロセスの +.Em stdin , +.Em stdout , +.Em stderr +になるようにします。 +認証作業が成功した場合には、 +.Xr login 1 +プログラムに +.Fl f +オプションを指定してログインプロセスを生成します。 +自動認証作業に失敗した場合には、 +通常のターミナルラインからのログインの場合と同様に、 +ユーザに問い合わせをします。 +.Pp +ログインプロセスの親プロセスは、疑似ターミナルのマスター側を操作します。 +すなわちログインプロセスと、クライアント側の +.Xr rlogin +プログラムを実体化したものとの間で処理を行います。 +通常の処理においては、 +.Ql ^S/^Q +のような機能を提供したり、割り込み信号をリモートプログラムへと伝えるために +.Xr pty 4 +で説明しているパケットプロトコルを起動します。 +ログインプロセスは、クライアントのターミナルの通信速度や +環境変数 +.Ql Ev TERM +で指定されているターミナルタイプを伝えます。 +.Xr environ 7 +を参照してください。 +クライアント側に端末の画面、あるいはウィンドウの大きさを問い合わます。 +また、クライアント側からウィンドウサイズの変更が疑似ターミナルへ +伝えられます。 +.Pp +トランスポートレベルのキープアライブメッセージは、オプション +.Fl n +が指定されていない限り出力されます。 +キープアライブメッセージを利用すると、クライアントがクラッシュしたり、 +通信不能になってしまった時に、セッションをタイムアウトで +終了することが可能になります。 +.Sh 診断 +すべての診断メッセージは、ネットワーク接続が切断された後に、最初に 1 の値が +付加されて通知されます。ログインが起動された後にエラーが発生しない場合、 +処理成功の通知のために、NULL バイトを返します。 +.Bl -tag -width Ds +.It Sy Try again. +サーバが fork に失敗したことを表します。 +.El +.Sh 関連項目 +.Xr login 1 , +.Xr ruserok 3 , +.Xr hosts 5 , +.Xr nologin 5 , +.Xr rshd 8 +.Sh 関連ファイル +.Bl -tag -width /etc/hostsxxxxxxxx -compact +.It Pa /etc/hosts +.It Pa /etc/hosts.equiv +.It Pa $HOME/.rhosts +.It Pa /etc/nologin +.El +.Sh バグ +このコマンドが用いている認証手続きは、それぞれのクライアントマシンと +接続媒体が完全であるということを仮定したものです。これはセキュリティホールに +なりやすいのですが、「オープン」な環境においては有用な方針です。 +.Pp +全てのデータについて暗号化を行なう機能が実装されるべきです。 +.Pp +もっと発展性のあるプロトコルが用いられるべきです。 +.Sh 歴史 +.Nm +コマンドは +.Bx 4.2 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/rmail.8 b/ja_JP.eucJP/man/man8/rmail.8 new file mode 100644 index 0000000000..8c70040fcb --- /dev/null +++ b/ja_JP.eucJP/man/man8/rmail.8 @@ -0,0 +1,75 @@ +.\" 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. +.\" +.\" 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 +.\" jpman %Id: rmail.8,v 1.2 1997/05/16 07:57:46 yugawa Stab % +.\" %Id: rmail.8,v 1.2.8.1 1997/02/28 07:54:43 mpp Exp % +.\" +.Dd April 29, 1993 +.Dt RMAIL 8 +.Os BSD 4.2 +.Sh 名称 +.Nm rmail +.Nd uucpで送られてきたメールを処理する +.Sh 書式 +.Nm rmail +.Ar user ... +.Sh 解説 +.Nm rmail +は +.Xr uucp 1 +経由で受けとったメールを解釈し、 +.Xr mail.local 8 +によって生成される``From''行を、``return-path!sender'' +という一行に変換して +.Xr sendmail 8 +に渡します。 +.Pp +.Nm rmail +は、明らかに +.Xr uucp +と +.Xr sendmail +で使われるように設計されています。 +.Sh 関連項目 +.Xr uucp 1 , +.Xr mail.local 8 , +.Xr sendmail 8 +.Sh 歴史 +.Nm rmail +プログラムは +.Bx 4.2 +から登場しました。 +.Sh バグ +.Nm rmail +は +.Pa /bin +に置くべきではありません。 diff --git a/ja_JP.eucJP/man/man8/rmt.8 b/ja_JP.eucJP/man/man8/rmt.8 new file mode 100644 index 0000000000..706d05dc6b --- /dev/null +++ b/ja_JP.eucJP/man/man8/rmt.8 @@ -0,0 +1,208 @@ +.\" Copyright (c) 1983, 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. +.\" +.\" 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. +.\" +.\" @(#)rmt.8 8.2 (Berkeley) 12/11/93 +.\" jpman %Id: rmt.8,v 1.2 1997/03/31 14:58:39 horikawa Stab % +.\" +.Dd December 11, 1993 +.Dt RMT 8 +.Os BSD 4.2 +.Sh 名称 +.Nm rmt +.Nd リモートプログラムから磁気テープの操作を行なうためのプロトコルモジュール +.Sh 書式 +.Nm rmt +.Sh 解説 +.Nm +は、リモートダンプおよびリストアを行なうプログラムから、プロセス間 +通信を用いて磁気テープドライブを操作するために用いられます。 +.Nm +は、通常は +.Xr rexec 3 +もしくは +.Xr rcmd 3 +からの呼び出しに応じて起動されます。 +.Pp +.Nm +は、磁気テープの操作要求を受け付け、コマンドを実行します。その後、 +状態を返却します。 +全ての応答は、 +.Tn ASCII +文字列および以下の 2 つの形式を組み合わせて行なわれます。 +コマンド実行が成功した場合は、以下の応答があります。 +.Bd -filled -offset indent +.Sm off +.Sy A Ar number No \en +.Sm on +.Ed +.Pp +.Ar number +は、10 進の +.Tn ASCII +表現です。コマンド実行が失敗した場合には、以下の +応答があります。 +.Bd -filled -offset indent +.Sm off +.Xo Sy E Ar error-number +.No \en Ar error-message +.No \en +.Xc +.Sm on +.Ed +.Pp +.Ar error-number +は、 +.Xr intro 2 +に記述のあるエラー番号であり、 +.Ar error-message +は、 +.Xr perror 3 +によって出力されるエラー文字列です。プロトコルは、以下のコマンドを含み、 +コマンドと引数の間、もしくは引数間ではスペースは挿入されません。 +.Ql \en +の表示は、その部分で改行が要求されています: +.Bl -tag -width Ds +.Sm off +.It Xo Sy \&O Ar device +.No \en Ar mode No \en +.Xc +指定された +.Ar devide +を +.Ar mode +で指定された属性でオープンします。 +.Ar device +は +フルパスで指定され、 +.Ar mode +は +.Xr open 2 +で用いられる 10 進の +.Tn ASCII +表現です。 +すでにデバイスがオープンされていた場合、 +そのデバイスは一旦クローズされ、再びオープンされます。 +.It Xo Sy C Ar device No \en +.Xc +現在オープンされているデバイスをクローズします。 +.Ar device +指定は無視されます。 +.It Xo Sy L +.Ar whence No \en +.Ar offset No \en +.Xc +.Sm on +指定された引数を用いて、 +.Xr lseek 2 +を実行します。返却値の意味は、 +.Xr lseek +システムコールのそれと同じです。 +.Sm off +.It Sy W Ar count No \en +.Sm on +オープンされているデバイスに対し、データを書き込みます。 +.Nm +は、要求元から +.Ar count +バイトのデータを読み込みます。予期しない EOF を +読み込んだ場合、異常終了します。本コマンドの返却値は、 +.Xr write 2 +システムコールと同じです。 +.Sm off +.It Sy R Ar count No \en +.Sm on +オープンされてるデバイスから +.Ar count +バイトだけのデータを読み込みます。 +.Ar count +がデータバッファのサイズ (10kバイト) を超える場合、 +データバッファサイズに切り詰められます。 +.Nm +は +.Xr read 2 +システムコールを実行し、読み込みが成功すると +.Sm off +.Sy A Ar count-read No \en +.Sm on +と返答します。そうでなければ、 +標準的な形式でエラーが返却されます。読み込みが成功すると、読み込まれたデータ +は要求元に送信されます。 +.Sm off +.It Xo Sy I Ar operation +.No \en Ar count No \en +.Xc +.Sm on +指定された引数を用いて +.Xr ioctl 2 +の +.Dv MTIOCOP +リクエストを実行します。引数は、10 進の +.Tn ASCII +表現に置き換えられ、 +.Xr ioctl 2 +で使用する構造体のメンバ +.Ar mt_op +および +.Ar mt_count +にそれぞれ格納されます。操作が成功した場合の返却値は、引数 +.Xr count +の値です。 +.It Sy S +.Xr ioctl +システムコールの +.Dv MTIOCGET +リクエストを用い、オープンされている +デバイスの状態を返却します。操作が成功すると、ステータスバッファのサイズと +ともに ``ack'' が送信されます。それからステータスバッファが (バイナリ形式で) +送信されます。 +.El +.Sm on +.Pp +上記以外のコマンドを +.Nm +が受信した場合、 +.Nm +は終了します。 +.Sh 診断 +全ての返答は、上記の通りです。 +.Sh 関連項目 +.Xr rcmd 3 , +.Xr rexec 3 , +.Xr mtio 4 , +.Xr rdump 8 , +.Xr rrestore 8 +.Sh バグ +本コマンドをリモートファイルアクセスプロトコルとして使用しないで下さい。 +.Sh 歴史 +.Nm +コマンドは +.Bx 4.2 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/rmuser.8 b/ja_JP.eucJP/man/man8/rmuser.8 new file mode 100644 index 0000000000..ab79bcdbb0 --- /dev/null +++ b/ja_JP.eucJP/man/man8/rmuser.8 @@ -0,0 +1,105 @@ +.\" Copyright 1995, 1996 +.\" Guy Helmer, Madison, South Dakota 57042. 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 as +.\" the first lines of this file unmodified. +.\" 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. 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 GUY HELMER ``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 GUY HELMER 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: rmuser.8,v 1.1.2.3 1997/09/02 06:31:52 charnier Exp % +.\" jpman %Id: rmuser.8,v 1.3 1997/07/22 16:58:06 horikawa Stab % +.\" +.Dd July 16, 1996 +.Dt RMUSER 8 +.Os +.Sh 名称 +.Nm rmuser +.Nd システムからユーザを削除する +.Sh 書式 +.Nm rmuser +.Op Ar username +.Sh 解説 +.Nm +は、ユーザの +.Xr crontab 1 +エントリ (存在すれば) と +.Xr at 1 +ジョブを削除し、ローカルのパスワードファイルからユーザのエントリを +削除します。そして、ホームディレクトリがユーザ所有であれば削除し、 +存在すればメールを削除します。ユーザ名は +.Pa /etc/group +の全てのグループから削除されます。 +グループが空になりかつグループ名とユーザ名が等しければ、 +グループも削除されます ( これは、 +.Xr adduser 8 +がユーザ 1 人に対して唯一のグループを与えているためです ) 。 +.Pp +.Nm +は、 +ユーザ id が 0 であるユーザ ( 典型的には root です ) の削除は拒否します。 +この仕様は、 +.Nm +作成時に良い考えのように思えました。 +.Pp +.Nm +は、選択されたユーザのパスワードファイルエントリを表示し、 +本当に消したいユーザであるのか尋ねます。ユーザのホームディレクトリが +(他のユーザのものでなく) ユーザ所有であれば、 +.Nm +はユーザのホームディレクトリ以下の全てを消してもいいのかどうか +訊いてきます。 +.Pp +以下のオプションが利用可能です。 +.Pp +.Bl -tag -width username +.It Ar \&username +消去するユーザを指定します。 +指定されていなければ、 +.Nm +は、対話的に消去するユーザを尋ねます。 +.Sh 関連ファイル +.Bl -tag -width /etc/master.passwd -compact +.It Pa /etc/master.passwd +.It Pa /etc/passwd +.It Pa /etc/group +.It Pa /etc/spwd.db +.It Pa /etc/pwd.db +.El +.Sh 関連項目 +.Xr at 1 , +.Xr chpass 1 , +.Xr crontab 1 , +.Xr finger 1 , +.Xr passwd 1 , +.Xr group 5 , +.Xr passwd 5 , +.Xr addgroup 8 , +.Xr adduser 8 , +.Xr pwd_mkdb 8 , +.Xr rmgroup 8 , +.Xr vipw 8 +.Sh 歴史 +.Nm +コマンドは、 +.Fx 2.1.5 +から導入されました。 +.\" .Sh 作者 +.\" Guy Helmer, Madison, South Dakota diff --git a/ja_JP.eucJP/man/man8/rndcontrol.8 b/ja_JP.eucJP/man/man8/rndcontrol.8 new file mode 100644 index 0000000000..d186a6177b --- /dev/null +++ b/ja_JP.eucJP/man/man8/rndcontrol.8 @@ -0,0 +1,97 @@ +.\" +.\" Copyright (c) 1995 +.\" Mark Murray. 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 Mark Murray +.\" and Theodore Ts'o +.\" 4. Neither the name of the author nor the names of any co-contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY MARK MURRAY 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 MARK MURRAY OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: rndcontrol.8,v 1.4.2.1 1997/10/14 06:39:42 charnier Exp % +.\" jpman %Id: rndcontrol.8,v 1.3 1997/08/16 13:39:03 horikawa Stab % +.\" +.Dd October 20, 1995 +.Dt RNDCONTROL 8 +.Os FreeBSD 2 +.Sh 名称 +.Nm rndcontrol +.Nd /dev/random デバイス操作ユーティリティ +.Sh 書式 +.Nm rndcontrol +.Op Fl q +.Op Fl s Ar irq_no +.Op Fl c Ar irq_no +.Sh 解説 +.Nm +コマンドは、カーネルが管理する「エントロピーのたまり場」を +乱数化するためにどの割り込みを使用するかを設定するのに用いられます。 +デバイス +.Pa /dev/random +と +.Pa /dev/urandom +がこの乱数源とのユーザインタフェースになります。 +いかなる変更も直ちに有効になります。 +.Sh オプション +以下のコマンドラインオプションがサポートされています: +.Bl -tag -width indent +.It Fl q +エラー以外の全ての出力を抑制します。 +.It Fl s Ar n +IRQ +.Ar n +を乱数源として使用します。 +このオプションを複数使用して、複数の IRQ を指定することもできます。 +.It Fl c Ar n +IRQ +.Ar n +を乱数源として使用するのをやめます。 +このオプションを複数使用して、複数の IRQ を指定することもできます。 +.El +.Pp +デフォルトではどの IRQ も使用しません。 +.Pp +.Sh 関連ファイル +.Bl -tag -width /dev/urandom -compact +.It Pa /dev/random +安全な乱数デバイス +.It Pa /dev/urandom +乱数デバイス +.El +.Sh バグ +きっと何かあるでしょう。 +.Sh 関連項目 +.Xr random 4 +.Sh 作者 +.An Theodore Ts'o +がコアとなるコードを書きました。 +.An Mark Murray +がこのコードを FreeBSD に移植し、 +サポートルーチンを書き、マニュアルページを作成しました。 +.Sh 歴史 +.Nm +は +.Fx 2.1.5 +で初めて登場しました。 diff --git a/ja_JP.eucJP/man/man8/route.8 b/ja_JP.eucJP/man/man8/route.8 new file mode 100644 index 0000000000..3ee1d7792b --- /dev/null +++ b/ja_JP.eucJP/man/man8/route.8 @@ -0,0 +1,333 @@ +.\" Copyright (c) 1983, 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. +.\" +.\" 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. +.\" +.\" @(#)route.8 8.3 (Berkeley) 3/19/94 +.\" jpman %Id: route.8,v 1.3 1997/07/28 05:33:13 konuma Stab % +.|' %Id: route.8,v 1.7.2.1 1997/03/03 07:01:44 mpp Exp % +.\" +.Dd March 19, 1994 +.Dt ROUTE 8 +.Os BSD 4.4 +.Sh 名称 +.Nm route +.Nd マニュアルでルーティングテーブルを操作する。 +.Sh 書式 +.Nm route +.Op Fl nqv +.Ar command +.Oo +.Op Ar modifiers +.Ar args +.Oc +.Sh 解説 +.Nm route +はネットワークルーティングテーブルを +マニュアルで操作するユーティリティです。 +通常は、 +.Xr routed 8 +のようなシステムルーティングテーブル管理デーモンが +保守をしているので、マニュアルでの操作は必要ありません。 +.Pp +.Nm route +ユーティリティは指定できるオプションは少数ですが、 +強力なコマンド言語をサポートしています。ユーザは +.Xr route 4 +において解説されているプログラム可能なインタフェイスを通して、 +任意の要求を指定することができます。 +.Pp +.Bl -tag -width Ds +.It Fl n +レポートの出力において、ホスト名とネットワーク名のシンボル名での表示を +抑止します。 +(シンボル名と数字によるアドレスの変換処理には時間がかかり、 +またネットワークが正常に動作している必要があります。 +そのため、特にネットワークの動作の修正中には、 +変換処理を行なわない方が好都合かもしれません。) +.It Fl v +(冗長モード) 詳細な情報を出力します。 +.It Fl q +全ての出力を行ないません。 +.El +.Pp +.Nm route +ユーティリティでは以下の 6 つのコマンドを提供しています。 +.Pp +.Bl -tag -width Fl -compact +.It Cm add +ルートを追加します。 +.It Cm flush +全てのルートを削除します。 +.It Cm delete +指定されたルートを削除します。 +.It Cm change +ルートの属性 (ゲートウェイなど) を変更します。 +.It Cm get +ある宛先に対するルートを検索し、表示します。 +.It Cm monitor +ルーティング情報ベースの変更、ルーティング検索の失敗、 +ネットワーク分割の疑いなどの情報を継続的に報告します。 +.El +.Pp +monitor コマンドは以下の書式です。 +.Pp +.Bd -filled -offset indent -compact +.Nm route Op Fl n +.Cm monitor +.Ed +.Pp +flush コマンドは以下の書式です。 +.Pp +.Bd -filled -offset indent -compact +.Nm route Op Fl n +.Cm flush +.Op Ar family +.Ed +.Pp +.Cm flush +コマンドが指定されると、 +.Nm route +は全てのゲートウェイのエントリにおけるルーティングテーブルを削除します。 +アドレスファミリが +.Fl osi , +.Fl xns , +.Fl atalk , +.Fl inet +のいずれかの修飾子によって指定されている場合、 +そのアドレスファミリの宛先を持つルートだけが削除されます。 +.Pp +その他のコマンドは以下の書式です。 +.Pp +.Bd -filled -offset indent -compact +.Nm route Op Fl n +.Ar command +.Op Fl net No \&| Fl host +.Ar destination gateway +.Ed +.Pp +ここで +.Ar destination +は宛先のホストもしくはネットワークです。 +.Ar gateway +はパケットがルートされるべき次の中継点です。 +ある特定のホストへのルートは、 +.Ar destination +で指定されたインターネットアドレスを解釈することによって、 +ネットワークへのルートと区別されます。 +オプションの修飾子 +.Fl net , +.Fl host +が指定されると、 +.Ar destination +をそれぞれネットワークもしくはホストとして強制的に解釈します。 +これらの修飾子がないなら、 +.Ar destination +に INADDR_ANY の ``ローカルアドレス部'' が含まれるか +.Ar destination +がネットワークのシンボル名である場合はネットワークへのルート、 +その他の場合はホストへのルートと想定します。 +.Pp +例えば、 +.Li 128.32 +は +.Fl host Li 128.0.0.32 +として解釈されます。 +.Li 128.32.130 +は +.Fl host Li 128.32.0.130 +として、 +.Fl net Li 128.32 +は +.Li 128.32.0.0 +として、 +.Fl net Li 128.32.130 +は +.Li 128.32.130.0 +として解釈されます。 +.Pp +宛先がゲートウェイとして動作する中継点なしで、 +あるインタフェイスから直接到達可能な場合、 +.Fl interface +修飾子を指定しなければなりません。 +この場合、指定されたゲートウェイは共通なネットワーク上の +ローカルホストのアドレスとなり、 +そのインタフェイスが転送に使用されることを示します。 +また、インタフェイスが point to point 接続の場合、 +インタフェイスをその名前で指定できます。 +この場合、ローカルやリモートのアドレスが変更されても +そのルートは有効のまま残ります。 +.Pp +オプションの修飾子 +.Fl xns , +.Fl osi , +.Fl atalk , +.Fl link +はそれに続いて指定されるアドレスが、それぞれ +.Tn XNS , +.Tn OSI , +.Tn AppleTalk +アドレスファミリである、もしくはリンクレベルのアドレスであることを指定します。 +これらの場合、名前はシンボル名ではなく、 +数字によって指定をおこなわなければなりません。 +.Pp +オプションの修飾子 +.Fl netmask +はネットマスクオプションつきの +.Tn OSI +.Tn ESIS +プロトコルによるリダイレクトの効果を実現するためのものです。 +つまり、ネットワークインタフェイスの暗黙のネットマスクとは異なる +ネットマスクをもつサブネットを手動で追加します。 +(この方法によらない場合は、OSPF や ISIS ルーティングプロトコルによって +通信します。) +この修飾子に続いて、アドレスパラメータ +(これはネットワークマスクとして解釈されます) を指定します。 +AF_INET の場合に生成される暗黙のネットワークマスクは、 +このオプションを +.Ar destination +パラメータに続いて指定することによって、上書きすることができます。 +.Pp +ルートにはいくつかのフラグがあり、 +そのルートを使う宛先にデータを送信する時のプロトコルの動作に +影響をおよぼします。 +これらのフラグは以下の修飾子によってセット (もしくはクリア) できます。 +.Bd -literal +-cloning RTF_CLONING - 使用中のルートを新たにひとつ生成する。 +-xresolve RTF_XRESOLVE - (外部からの検索に対して) 使用中である旨のメッ + セージを発行する。 +-iface ~RTF_GATEWAY - 宛先が直接到達可能。 +-static RTF_STATIC - 手動でルートを追加する。 +-nostatic ~RTF_STATIC - カーネルかデーモンによってルートが追加された + ように振舞う。 +-reject RTF_REJECT - マッチした場合に ICMP unreachable を出力する。 +-blackhole RTF_BLACKHOLE - (更新中に) 何も報告せずにパケットを捨てる。 +-proto1 RTF_PROTO1 - プロトコルに特有のフラグ #1 をセットする。 +-proto2 RTF_PROTO2 - プロトコルに特有のフラグ #2 をセットする。 +-llinfo RTF_LLINFO - プロトコルアドレスからリンクアドレスへの変換の + 正当性をチェックする。 +.Ed +.Pp +オプションの修飾子 +.Fl rtt , +.Fl rttvar , +.Fl sendpipe , +.Fl recvpipe , +.Fl mtu , +.Fl hopcount , +.Fl expire , +.Fl ssthresh +によって TCP や TP4 のトランスポートレベルのプロトコルによる +ルーティングのエントリ中でメインテナンスされる値の初期値を指定します。 +これらは各々の修飾子の前に +.Fl lock +メタ修飾子を指定することによって、個別にその値をロックすることができます。 +また +.Fl lockrest +メタ修飾子をつけることによって、 +その後に続く全ての値をロックすることもできます。 +.Pp +.Cm change +もしくは +.Cm add +コマンドにおいて、 +.Ar destination +もしくは +.Ar gateway +がルートを特定するのに不十分であった場合 +(たとえば +.Tn ISO +のケースにおいて、複数のインタフェイスが同じアドレスを持っているような場合)、 +.Fl ifp +や +.Fl ifa +修飾子を使うことによって、 +インタフェイスやインタフェイスアドレスを特定することができます。 +.Pp +.Ar destination +や +.Ar gateway +で指定された全てのシンボル名は、まずホスト名として +.Xr gethostbyname 3 +を使用して検索されます。検索に失敗した場合は、その名前をネットワーク名と見なし +.Xr getnetbyname 3 +によって検索されます。 +.Pp +.Nm route +はルーティングソケットと新しいメッセージタイプである +RTM_ADD, +RTM_DELETE, +RTM_GET, +RTM_CHANGE +を使います。 +ルーティングテーブルの変更はスーパユーザのみがおこなうことができます。 +.Sh 診断 +.Bl -tag -width Ds +.It Sy "add [host \&| network ] %s: gateway %s flags %x" +指定されたルートがテーブルに追加されました。 +出力された値は +.Xr ioctl 2 +の呼出しの中で使われたルーティングテーブルのエントリからのものです。 +指定されたゲートウェイアドレスがそのゲートウェイのプライマリアドレス +( +.Xr gethostbyname 3 +によって返される最初のもの) でなかった場合、 +ゲートウェイアドレスがシンボル名に加えて、数字でも表示されます。 +.It Sy "delete [ host &| network ] %s: gateway %s flags %x" +指定されたルートがテーブルから削除されました。 +.It Sy "%s %s done" +.Cm flush +コマンドが指定された場合、削除された各ルーティングテーブルエントリが +この形式のメッセージで報告されます。 +.It Sy "Network is unreachable" +指定されたゲートウェイが直接到達可能なネットワーク上にないために、 +ルートの追加に失敗しました。 +hop 数が 1 であるゲートウェイを指定しなければなりません。 +.It Sy "not in table" +テーブルにないエントリを削除しようとしました。 +.It Sy "routing table overflow" +ルートの追加を試みましたが、システムの資源が少なく、 +新しいエントリを作成するためのメモリを割り当てられませんでした。 +.El +.Sh 関連項目 +.Xr netintro 4 , +.Xr route 4 , +.Xr IPXrouted 8 , +.Xr routed 8 +.\" .Xr XNSrouted 8 +.\" Xr esis 4 , +.Sh 歴史 +.Nm +コマンドは +.Bx 4.2 +から登場しました。 +.Sh バグ +最初の段落は多少 +.Xr routed +の能力を大げさに書いています。 diff --git a/ja_JP.eucJP/man/man8/routed.8 b/ja_JP.eucJP/man/man8/routed.8 new file mode 100644 index 0000000000..c64726f9f8 --- /dev/null +++ b/ja_JP.eucJP/man/man8/routed.8 @@ -0,0 +1,616 @@ +.\" Copyright (c) 1983, 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. +.\" +.\" 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. +.\" +.\" @(#)routed.8 8.2 (Berkeley) 12/11/93 +.\" %Id: routed.8,v 1.2.2.3 1997/08/19 21:22:05 joerg Exp % +.\" jpman %Id: routed.8,v 1.2 1997/03/31 14:11:11 horikawa Stab % +.\" +.Dd June 1, 1996 +.Dt ROUTED 8 +.Os BSD 4.4 +.Sh 名称 +.Nm routed +.Nd ネットワークの RIP と router discovery のルーティングデーモン +.Sh 書式 +.Nm +.Op Fl sqdghmpAt +.Op Fl T Ar tracefile +.Oo +.Fl F +.Ar net Ns Op /mask Ns Op ,metric +.Oc +.OP Fl P Ar parms +.Sh 解説 +.Nm routed +はネットワークのルーティングテーブルを管理するデーモンで、 +システムのブート時に起動されます。 +これは、カーネルのルーティングテーブルを管理するために、 +ルーティング情報プロトコル (Routing Information Protocol) の +RIPv1 (RFC\ 1058)、RIPv2 (RFC\ 1723)、および +Internet Router Discovery Protocol (RFC 1256) を用います。 +RIPv1 プロトコルは 4.3BSD のデーモンのものをベースとしています。 +.Pp +.Nm routed +は、ルーティング情報プロトコルのパケットを待つために、 +.Xr route 8 +サービス +.Ns ( Xr services 5 +参照) 用の +.Xr udp 4 +ソケットを listen() します。また、マルチキャストによる Router Discovery の +ICMP メッセージの送受信も行います。 +ホストがルータだった場合、 +.Nm routed +は直接接続されている全てのホストやネットワークに、 +ルーティングテーブルの複製を定期的に提供します。 +また、Router Discovery の ICMP メッセージを用いてデフォルトルートを広告したり +要求したりします。 +.Pp +.Nm routed +が走行し始めると (または、ネットワークインタフェースがオンになると)、 +.Nm routed +は AF_ROUTE アドレスファミリを用いて、システムに直結されていて +コンフィギュレーションされているインタフェースのうちで "up" とマークされて +いるものを探します。そしてそのインタフェースに必要な経路をカーネルの +ルーティングテーブルに追加します。スタート直後で、RIP が無効になっていない +インタフェースが少なくとも 1 つある場合は、 +.Nm routed +はカーネルのテーブル内に既に存在する静的でない経路を全て削除します。 +カーネルのテーブル内にある静的な経路は保存され、有効な RIP metric を +持っているものは RIP レスポンスに含められます +.Ns ( Xr route 8 +参照)。 +.Pp +複数のインタフェース (ループバックインタフェースは含めません) が提供されている +場合、そのホストは接続されているネットワーク間でパケットを中継するものと +みなされます。新しいインタフェース上で RIP リクエストを送信した後や +ルータ発見のための広告や要求を送信した後で、デーモンはループに入り、 +他のホストからの RIP リクエストやレスポンスや Router Discovery のパケットを +listen します。 +.Pp +リクエストパケットを受信すると、 +.Nm routed +は内部テーブルに持っている情報からリプライを作成します。 +生成された +.Em レスポンス +パケットには既知の経路のリストが含められ、各経路に +"hop count" metric がつきます (16 以上は "無限大" とみなされます)。 +広告した metric はインタフェースに設定した metric を反映するため +.Ns ( Xr ifconfig 8 +参照)、トラフィックを制御するにはインタフェースの metric を設定するのが +よい方法です。 +.Pp +.Em split-horizon +をインプリメントしているため、リクエストしてきたネットワークの 1 hop 先の +経路はレスポンスには含められません。 +.Xr rtquery 8 +のような問い合わせプログラムからのリクエストに対しては、テーブル全体 +から答を導き出します。 +.Pp +ルータの故障から素早く復旧できるようにするため、 +デーモンが扱うルーティングテーブルには各到達先用のゲートウェイをいくつか +覚えておくための空間があります。受けとった RIP +.Em レスポンス +パケットが更新のために使用されるのは、 +現在認識しているゲートウェイのうちの 1 つから提供された場合、 +もしくは現在あるゲートウェイのうちの少なくとも 1 つよりも +よい metric を広告された場合です。 +.Pp +更新を行う時、 +.Nm +は自分自身が持つテーブルの変更を記録し、到達先への最適な経路が変更された +場合にはカーネルのルーティングテーブルを記録します。カーネルの +ルーティングテーブルに対するこの変更は、次に送出される +.Em レスポンス +パケットに反映されます。次のレスポンスがしばらくの間スケジューリングされない +場合には、最近変更された経路だけを含んだ +.Em flash update +レスポンスが送られます。 +.Pp +到着パケットの処理に加えて、 +.Nm +は定期的にルーティングテーブルのエントリをチェックします。 +あるエントリが 3 分間更新されなかった場合、 +そのエントリの metric は無限大として設定され、 +削除のためのマークがつけられます。 +この無効化がローカルなインタネットを通して伝搬するのを保証するために、 +削除はその経路が無限大の metric を持つと広告されるまで延期されます。これが +.Em poison reverse +方式です。 +.Pp +カーネルのテーブル内の経路のうちで ICMP Redirect メッセージの結果として +追加や変更されたものは、 +.Em black-holes +を最小にするために、しばらく経ってから削除されます。 +TCP コネクションのタイムアウトが起こると、カーネルは +.Nm routed +に対し、そのゲートウェイを通る全てのリダイレクトされた経路を削除し、 +そのゲートウェイを通る全ての RIP の経路の年齢を増やすことで他のゲートウェイが +選択されるようにし、関連する全ての Router Discovery Protocol の +デフォルトルートの年齢を増やします。 +.Pp +ネットワーク間ルータとして動作するホスト群は、直接接続されているホストおよび +ネットワークすべてに対し、30 秒ごとにルーティングテーブルを無条件で提供します。 +この RIP レスポンスは、ブロードキャストをサポートしているネット上の +ブロードキャストアドレス、point-to-point リンクの到達先アドレス、 +ルータ自身の他のネットワークでのアドレスに対して送信されます。 +RIPv2 が有効になっている場合は、マルチキャストをサポートしているインタフェース +に対してマルチキャストパケットが送られます。 +.Pp +リモートインタフェース上でレスポンスが受信されない場合や、 +レスポンスを送っている最中にエラーが起こった場合や、 +エラーが入力や出力よりも多い場合 +.Ns ( Xr netstat 8 +参照) は、ケーブルやインタフェースの他の部分が接続されていないか壊れている +とみなされ、その経路は適切に変更されます。 +.Pp +.Em Internet Router Discovery Protocol +も同様に扱われます。デーモンが RIP の経路を配っている時は、Router Discovery +の要求の listen と Router Discovery の広告の送信も行います。 +デーモンが静かな状態で他の RIP ルータからのパケットを listen している時には、 +Router Discovery の要求を送信して、Router Discovery の広告を listen します。 +受けた広告がよいものであれば、 +RIP レスポンスのブロードキャストやマルチキャストを listen するのをやめます。 +現在利用中のルータが死んだ場合に障害のある状態から短時間で修復できるよう、 +広告されているルータのいくつかを追跡します。 +もし発見してあるルータが全て見えなくなった場合は、RIP レスポンスの listen を +再開します。 +.Pp +Router Discover の仕様では、広告の "生存期間" をデフォルトで 30 分とすることを +要求しています。これは、何かが起こった場合に +クライアントに 30 分間よい経路がなくなる可能性があることを意味しています。 +コマンドラインで +.Fl P Cm rdisc_interval=45 +と指定したり +.Pa /etc/gateways +に +.Cm rdisc_interval=45 +と書くことでデフォルトを 45 秒にするのはいい考えです。 +.Pp +Router Discovery を利用している場合 (システムが持っている +ネットワークインタフェースが 1 つだけでかつ Router Discovery の広告を +受けた場合にはこれがデフォルトです)、カーネルのテーブル内には +デフォルトルートは 1 つだけで、ホストへの経路は可変個数となります。 +複数のネットワークインタフェースを持つホストでは、 +このデフォルトルートはそのインタフェースのうちの 1 つだけを経由します。 +このため、複数のホームを持つホストで +.Fl q +つきで動作しているものは、 +以下に示す +.Cm no_rdisc +が必要です。 +.Pp +RIPv2 と Router Discovery のどちらも扱うことができない "遺物の" システムを +サポートするためには、以下に記述してある +.Cm pm_rdisc +を参照して下さい。 +.Pp +デフォルトでは、point to point リンク (たとえば PPP) には Router Discovery +の広告も要求も送信されません。 +point-to-point リンク (SLIP や PPP などのような、IFF_POINTOPOINT フラグ +のついたもの) のネットマスクは、 +RIPv1 利用時にはそのネットマスクがリモートシステムで利用されると +.Nm routed +は推測します。 +.Pp +.Nm routed +がサポートしているオプションは以下の通りです: +.Bl -tag -width Ds +.It Fl s +このオプションを指定すると、 +.Nm +は強制的にルーティング情報を提供します。 +これは、RIP や Router Discovery を無効にしていない状態で複数の +ネットワークインタフェースが提供されており、カーネルが ipforwarding=1 に +なっている場合にはデフォルトです。 +.It Fl q +.Fl s +オプションとは逆の動作をします。 +インタフェースが 1 つだけの場合は、これがデフォルトです。 +.It Fl d +バックグラウンドでは動作しません。このオプションは対話的に使用するための +ものです。 +.It Fl g +このフラグは、ネットワーク間ルータにおいて "default" の到達先への経路を設ける +ために使われます。これは +.Fl F +.Cm 0/0,1 +と同じ意味を持ち、主として歴史的理由のために提供されています。 +これよりは、 +.Fl P Cm pm_rdisc +をコマンドラインで指定するか、 +.Cm pm_rdisc +を +.Pa /etc/gateways +で指定するほうがよいでしょう。 +大きな metric を使用すれば、 +デフォルトルートの潜在的な危険が広がる可能性を減らせます。 +これは、典型的にはインタネットへのゲートウェイで用いられるか、 +経路を他のローカルルータに対して報告しないような他の +ルーティングプロトコルを利用しているゲートウェイの場合に用いられます。 +metric には 1 が使われるため、この機能は危険です。このオプションは一般に、 +問題を解決するよりも、ルーティングのループによる混乱を引き起こしがちです。 +.It Fl h +ホストルートまたは point-to-point ルートを広告しません。 +これらは同一方向へいくネットワークルートであると規定されます。これは +特別な性質を持つ集合です。このオプションは、イーサネットへのゲートウェイ +でかつ SLIP のような point-to-point リンクで他のゲートウェイマシンが継っている +ゲートウェイにおいて有効です。 +.It Fl m +マシンが、そのプライマリインタフェースへのホストルートや point-to-point ルート +を広告するようになります。 +これは NFS サーバなどのような複数のホームを持つマシンにおいて有効です。 +このオプションは、作成したホストルートのコストがサーバの人気で正当化される +場合を除いて、使うべきではありません。 +これは、マシンがルーティング情報を供給していて、複数のインタフェースを +持っている場合にのみ効果があります。 +.Fl m +オプションは、 +.Fl q +オプションの効果を上書きして、 +ホストルートの広告を限定した範囲に制限します。 +.It Fl A +もし RIPv2 の認証に注意を払わない場合は、RIPv2 の認証を無視しません。 +RFC 1723 に準拠するためにはこのオプションが必要です。 +しかしながら、これは意味がなく、マシンが認証について注意を払わない時に +認証を運ぶ全ての RIPv2 パケットを無視するために検出プロトコルとして +RIP を使う場合の妨げとなります。 +.It Fl T Ar tracefile +デバッグレベルを最低でも 1 まで上げ、デバッグ情報をトレースファイルに +書き加えるようにします。セキュリティ上の都合により、 +.Nm routed +がファイルへのトレースを日常的に行うようにはしないのが賢明です。 +.It Fl t +デバッグレベルを増やします。 +.Fl T +で指定したトレースファイルや標準出力に対し、より詳細な情報を記録するように +なります。デバッグレベルは +.Em SIGUSR1 +シグナルや +.Em SIGUSR2 +シグナルや +.Xr rtquery +で増減できます。 +.It Fl F Ar net[/mask][,metric] +.Em net/mask +にマッチするアドレスを持つインタフェースを介した転送における経路を最小にし、 +このマシンへのデフォルトルートを metric 数 +.Em metric +で作成します。この目的は、RIP 情報をもつ多数の大きな UDP パケットを "にせ" の +デフォルトルートを含んだ 1 つの小さなパケットに置き換えることで、 +遅い、たとえば PPP のような point-to-point リンクでの RIP のトラフィックを +減らすことにあります。 +もし +.Em metric +がない場合は、"にせ" のデフォルトルートが広まるのを制限するために 14 が +指定されたものとみなします。 + +この機能は、不注意に使うとルーティングのループを引き起こすので危険です。 +指定したネットワーク番号とマスクに複数のインタフェースがマッチする可能性がある +ことに注意して下さい。 +.Fl g +も参照してください。 +.It Fl P Ar parms +パラメータ行 +.Em parms +を +.Pa /etc/gateways +ファイルに書くのと同じです。 +.El +.Pp +提供された他の引数は、 +.Nm routed +の動作を記録するファイルの名前として解釈されます。 +トレースファイルの名前をコマンドに追加するよりは、 +.Fl T +を使った方がよいでしょう。 +.Pp +上記の機能に加えて、 +.Nm routed +は "遠隔にある" +.Em パッシブ +もしくは +.Em アクティブ +なゲートウェイという概念をサポートします。 +.Nm +は動作を開始すると、実在しないかもしれない遠隔のゲートウェイを検索するために +.Pa /etc/gateways +を読み込みます。ローカルなゲートウェイがパッシブであるかどうかや、 +他のパラメータの取得には、ルーティングソケットからの情報だけをもとにします。 +このようにして指定されたゲートウェイは、ルーティング情報を交換しない場合は +パッシブマークが付加されます。一方、 RIP パケットを交換するゲートウェイに +ついては、アクティブマークが付与されます。 +.Em パッシブ +ゲートウェイを介す経路については、システムスタートアップ時に一度だけ +カーネル内の経路情報テーブルに設定され、送出される RIP レスポンスには +含められません。 +.Pp +遠隔のアクティブゲートウェイは、ネットワークインタフェースと同様に扱われます。 +RIP レスポンスが遠隔の +.Em アクティブ +ゲートウェイに送られます。 +応答がない場合は、 +その経路はカーネルのテーブルと別のインタフェースから広告された RIP レスポンスの +ぞれぞれから削除されます。遠隔のゲートウェイが RIP レスポンスの送出を +再開した場合は、その経路は再追加されます。 +.Pp +このようなゲートウェイは、ATM ネットワークなどのような、 +ブロードキャストやマルチキャストはサポートしないがそれ以外は Ethernet のような +伝統的な共有メディア方式のように働くネットワークに有効です。 +ATM ネットワーク上にある到達可能な全ての RIP ルータを +.Pa /etc/gateways +の "host" 行を使って記述することができます。 +.Pp +.Em external +マークのついたゲートウェイはパッシブと同様の扱いになりますが、 +カーネル内のルーティングテーブルに載ることはなく、 +ルーティングの更新時にその情報が含められることもありません。 +external エントリの機能は、他のルーティングプロセスがそのような経路を +必要時に追加する可能性があることを知らせるためにあり、その到達先への別の経路は +.Nm routed +で設定されるべきではありません。 +external エントリは、両方のルータが同じ到達先への経路を覚えてもよい場合にのみ +必要です。 +.Pp +.Pa /etc/gateways +ファイルは、以下のフォーマットおよびパラメータからなる行の集まりです: +.Pp +.Bd -ragged +.Cm net +.Ar Nname[/mask] +.Cm gateway +.Ar Gname +.Cm metric +.Ar value +.Pf < Cm passive No \&| +.Cm active No \&| +.Cm extern Ns > +.Ed +.Bd -ragged +.Cm host +.Ar Hname +.Cm gateway +.Ar Gname +.Cm metric +.Ar value +.Pf < Cm passive No \&| +.Cm active No \&| +.Cm extern Ns > +.Ed +.Pp +キーワード +.Ar Nname +や +.Ar Hname +は、到達先のネットワークやホストの名前です。 +.Pp +.Ar name1 +は、到達先のネットワークもしくはホストの名前です。 +これはネットワークのシンボル名または "ドット" 表記による +インタネットアドレスのどちらでも構いません +.Ns ( Xr inet 3 +参照)。(もし名前の場合は、 +.Pa /etc/networks +または +.Pa /etc/hosts +で定義されているか、 +.Nm routed +の動作開始前に +.Xr named 8 +が起動されていなければなりません。) +.Pp +.Ar mask +は省略可能な数値で +.Ar Nname +のネットマスクを表し、1 から 32 までの値をとります。 +.Pp +.Ar Gname +は、RIP レスポンスがフォワードされるべきゲートウェイの名前もしくは +アドレスです。 +.Pp +.Ar value +は、到達先ホストもしくはネットワークへの hop 数です。 +.Ar " host hname " +は +.Ar " net nname/32 " +と同一です。 +.Pp +.Cm passive , +.Cm active , +.Cm external +のキーワードのうちの 1 つを指定することで、ゲートウェイが +.Cm passive +または +.Cm active +(前述の通り) であるか RIP プロトコルのスコープの範囲外つまり +.Cm external +であるかを指示しなければなりません。 +.Pp +"net" と "host" のどちらでも始まらない行は、以下のようなパラメータ設定 +でなければなりません。これは 1 つでも複数でもよく、複数の場合はコンマや +空白で区切ります: +.Bl -tag -width Ds +.It Cm if Ns \&= Ns Ar ifname +その行にある他のパラメータが、名前が +.Ar ifname +のインタフェースに適用されることを示します。 +.It Cm subnet Ns \&= Ns Ar nname[/mask][,metric] +ネットワーク +.Ar nname +への経路をマスク +.Ar mask +と指定された metric (デフォルトは 1) で広告します。 +これは CIDR の確保において "穴" を埋めるのに有効です。 +このパラメータはその行にそれだけで出現しなければなりません。 +.Pp +この機能は不必要に使ってはいけません。危険です。 +.It Cm passwd Ns \&= Ns Ar XXX +RIPv2 の password を指定します。これは送信した全ての RIPv2 レスポンスに +含められ、受信した全ての RIPv2 レスポンスでチェックされます。 +パスワードは、空白やタブ文字やコンマや '#' を含んではいけません。 +.It Cm passwd Ns \&= Ns Ar XXX1[|KeyID[start|stop]] +RIPv2 の生のパスワードを指定します。 +これは、送信される全ての RIPv2 レスポンスに含められ、 +受信した全ての RIPv2 レスポンスでチェックされます。 +パスワード内の空白、タブ文字、コンマ、'#'、'|'、NULL 文字は、 +バックスラッシュ (\\) でエスケープしなければなりません。 +よく使われる \\n, \\r, \\t, \\b, \\xxx などのエスケープシーケンスは、 +それぞれ通常の意味を持っています。 +.Cm KeyID +は一意でなければなりませんが、生のパスワードの場合は無視されます。 +.Cm start +と +.Cm stop +がある場合、これはタイムスタンプで、 +year/month/day@hour:minute の形式をとります。 +これらはパスワードが正しい時に設定されます。 +出力パケットで使われるパスワードには、期限が最も遠い将来まで設定されている +パスワードが使われます。全てのパスワードが期限切れになった場合には、 +最も最近期限切れになったパスワードが使われます。 +また、有効なパスワードがまだ設定されていない場合には、 +パスワードは出力されません。 +到着パケットは有効なパスワードを運んでくる可能性があります。 +ここで有効とは、未来の 24 時間内で有効になるものか、 +過去 24 時間内で有効であったものを指します。 +.It Cm md5_passwd Ns \&= Ns Ar XXX1|KeyID[start|stop] +RIPv2 の MD5 パスワードを指定します。 +.Cm KeyID +が必須であること以外は、このキーワードは +.Cm passwd +と同じです。 +秘密を守るため、パスワードの設定は +.Em /etc/gateways +内のものだけが有効であり、かつ、このファイルが UID 0 でのみ読み込み可能 +でなければなりません。 +.It Cm no_ag +RIPv1 と RIPv2 のレスポンス内のサブネットの合成を行いません。 +.It Cm no_super_ag +RIPv2 のレスポンス内のネットワークのスーパネットへの合成を行いません。 +.It Cm passive +そのインタフェースが更新時に他のインタフェースを通して広告されないように +マークし、指定したインタフェースでは RIP および router discovery 処理を +全く行わないようにします。 +.It Cm no_rip +指定したインタフェースでの全 RIP 処理を行いません。 +RIP パケットを処理するインタフェースがない場合は、 +.Nm +は単に Router Discovery デーモンとして働きます。 +.Pp +.Cm rdisc_adv +または +.Fl s +で明示的に Router Discovery の広告を行うように指示せずに RIP を +行わないようにすると、 +.Nm routed +は広告を行わない Router Discovery デーモンとして働くことに注意して下さい。 +.It Cm no_ripv1_in +受信した RIPv1 レスポンスが無視されるようになります。 +.It Cm no_ripv2_in +受信した RIPv2 レスポンスが無視されるようになります。 +.It Cm ripv2_out +可能な場合にマルチキャストができるよう、 +RIPv1 の出力は行わず、RIPv2 による広告を行います。 +.It Cm ripv2 +.Cm no_ripv1_in +と +.Cm no_ripv1_out +を指定した場合と同じです。 +.It Cm no_rdisc +Internet Router Discovery Protocol を無効にします。 +.It Cm no_solicit +Router Discovery の要求を送信しません。 +.It Cm send_solicit +たとえ point-to-point リンクであっても +Router Discovery の要求を送信します。 +デフォルトでは Router Discovery のメッセージを聞くだけです。 +.It Cm no_rdisc_adv +Router Discovery の広告の送信を行いません。 +.It Cm rdisc_adv +たとえ point-to-point リンクであっても +Router Discovery の広告を送信します。 +デフォルトでは Router Discovery のメッセージを聞くだけです。 +.It Cm bcast_rdisc +Router Discovery のパケットをマルチキャストする代りにブロードキャストします。 +.It Cm rdisc_pref Ns \&= Ns Ar N +Router Discovery の広告の優先度を整数 +.Ar N +にします。 +.It Cm rdisc_interval Ns \&= Ns Ar N +Router Discovery の広告を行う上での名目の送信間隔を N にし、その生存期間を +3*N にします。 +.It Cm fake_default Ns \&= Ns Ar metric +指定したインタフェースのネットワークとネットマスクを使って +.Fl F Ar net[/mask][=metric] +を指定した場合と同じです。 +.It Cm pm_rdisc +.Cm fake_default +に似ています。RIPv2 の経路がマルチキャストの場合、RIPv1 を聞いている +マシンはそれを受信することができないので、この機能を使えば RIPv1 のデフォルト +ルートが RIPv1 を聞いているマシンにブロードキャストされるようになります。 +.Cm fake_default +で変更しない限り、 +デフォルトルートは metric 14 でブロードキャストされます。 +これは "能力の低い router discovery" プロトコルを提供することになります。 +.It Cm trust_gateway Ns \&= Ns Ar rname +指定したルータや他の +.Cm trust_gateway +キーワードで指定したルータからの RIP パケットを受け付け、 +これら以外からのパケットは無視するようになります。 +.It Cm redirect_ok +システムがルータとして動作してパケットのフォワードを行っている場合に、 +RIP が ICMP Redirect メッセージを許可するようになります。 +そうでなければ、ICMP Redirect メッセージは上書きされます。 +.El +.Pp +.Sh 関連ファイル +.Bl -tag -width /etc/gateways -compact +.It Pa /etc/gateways +遠隔ゲートウェイについての情報を記述するファイル。 +.El +.Sh 関連項目 +.Xr icmp 4 , +.Xr udp 4 , +.Xr gated 8 , +.Xr htable 8 , +.Xr rtquery 8 +.Rs +.%T Internet Transport Protocols +.%R XSIS 028112 +.%Q Xerox System Integration Standard +.Re +.Sh バグ +ネットワークインタフェースの一方向の失敗 +(例えば、出力方向にのみ失敗するなど) を常に検出できるとは限りません。 +.Sh 歴史 +.Nm +コマンドは +.Bx 4.2 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/rpc.lockd.8 b/ja_JP.eucJP/man/man8/rpc.lockd.8 new file mode 100644 index 0000000000..6537d4b331 --- /dev/null +++ b/ja_JP.eucJP/man/man8/rpc.lockd.8 @@ -0,0 +1,101 @@ +.\" -*- nroff -*- +.\" +.\" Copyright (c) 1995 A.R.Gordon, andrew.gordon@net-tel.co.uk +.\" 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. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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. +.\" +.\" jpman %Id: rpc.lockd.8,v 1.3 1997/09/04 17:38:06 horikawa Stab % +.\" +.Dd September 24, 1995 +.Dt RPC.LOCKD 8 +.Os +.Sh 名称 +.Nm rpc.lockd +.Nd NFS ファイルロックデーモン +.Sh 書式 +.Nm rpc.lockd +.Op Fl d Op Ar debug_level +.Sh 解説 +.Nm +デーモンは、NFS 環境において、 +ファイルやレコードのロックサービスを提供します。 +.Pp +.Nm +のオプションは以下のとおりです: +.Bl -tag -width indent +.It Fl d +syslog を通してデバッグ情報を書くようになります。 +デーモンへの全ての RPC トランザクションが記録されます。 +このメッセージは level が LOG_DEBUG で facility が LOG_DAEMON として +記録されます。 debug_level が指定されない場合には 1 が使われます。 +debug_level が 1 の場合、1 つのプロトコル操作につき +1 行のログが作成されます。これより高いデバッグレベルを指定すると、 +その操作の引数とデーモンの内部動作も出力するようになります。 +.El +.Pp +エラーの状態は、デバッグレベルに関係なく、log level が LOG_ERR で +facility が LOG_DAEMON として syslog を通して記録されます。 +.Pp +.Nm +デーモンは +.Xr inetd 8 +から起動してはいけません。これは、プロトコルが、システムの開始時に +デーモンが起動されていることを仮定しているためです。 +デーモンは +.Xr rc 8 +によりネットワークの開始後に起動されるべきです。 +.Sh 関連ファイル +.Bl -tag -width /usr/include/rpcsvc/nlm_prot.x -compact +.It Pa /usr/include/rpcsvc/nlm_prot.x +ネットワークロックマネージャプロトコルの RPC プロトコル仕様。 +.El +.Sh 関連項目 +.Xr syslog 3 , +.Xr rc 8 , +.Xr rpc.statd 8 +.Sh バグ +現在の実装では、プロトコルのサーバ側しかありません +(つまり、他の OS 上のクライアントは +.Bx Free +ファイルサーバ上にロックを +確立することはできますが、OS が +.Bx Free +上のクライアントがロックを +確立する手段がありません)。 +.Pp +プロトコルのバージョン 1, 2, 3 が実装されていますが、 +バージョン 2 (Unix systems) および 3 (PC-NFS clients) +が一般的であり、バージョン 1 のクライアントが見つからなかったため +バージョン 1 についてはテストされていません。 +.Sh 標準 +実装は、 +X/Open CAE Specification +C218, "Protocols for X/Open PC Interworking: XNFS, Issue 4", ISBN 1 872630 66 9 +をもとにしています。 diff --git a/ja_JP.eucJP/man/man8/rpc.rquotad.8 b/ja_JP.eucJP/man/man8/rpc.rquotad.8 new file mode 100644 index 0000000000..4d09183fb7 --- /dev/null +++ b/ja_JP.eucJP/man/man8/rpc.rquotad.8 @@ -0,0 +1,65 @@ +.\" +.\" Copyright (c) 1994 Theo de Raadt +.\" 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 Theo de Raadt. +.\" 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: rpc.rquotad.8,v 1.1.1.1.2.1 1997/03/14 06:10:09 mpp Exp % +.\" jpman %Id: rpc.rquotad.8,v 1.3 1997/09/04 17:40:03 horikawa Stab % +.\" +.Dd June 22, 1994 +.Dt RPC.RQUOTAD 8 +.Os BSD 4.3 +.Sh 名称 +.Nm rpc.rquotad +.Nd リモートの quota (割り当て制限) サーバ +.Sh 書式 +.Nm /usr/libexec/rpc.rquotad +.Sh 解説 +.Nm rpc.rquotad +は、リモートマシンへ NFS マウントされているファイルシステムについて +ユーザに対するローカルマシンでの割り当て制限値を返す +.Xr rpc 3 +サーバです。 +.Xr quota 1 +は、リモートファイルシステムの割り +当て制限値を表示するために本サーバを用います。 +.Nm rpc.rquotad +は通常 +.Xr inetd 8 +から起動されます。 +.Pp +.Nm rpc.rquotad +.Pa /usr/include/rpcsvc/rquota.x +で定義される RPC プロトコルを使用します。 +.Sh バグ +.Bx 4.4 +と +.Tn FreeBSD +はグループに対する割り当て制限をサポートしていますが、 +rqutoa プロトコルはこれをサポートしていません。 +.Sh 関連項目 +.Xr quota 1 diff --git a/ja_JP.eucJP/man/man8/rpc.rstatd.8 b/ja_JP.eucJP/man/man8/rpc.rstatd.8 new file mode 100644 index 0000000000..f7194242f7 --- /dev/null +++ b/ja_JP.eucJP/man/man8/rpc.rstatd.8 @@ -0,0 +1,63 @@ +.\" -*- nroff -*- +.\" +.\" Copyright (c) 1985, 1991 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. +.\" +.\" 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. +.\" +.\" %Id: rpc.rstatd.8,v 1.1.1.1 1994/08/28 14:49:04 csgr Exp % +.\" +.Dd June 7, 1993 +.\" jpman %Id: rpc.rstatd.8,v 1.2 1997/05/22 08:05:12 mitchy Stab % +.Dt RPC.RSTATD 8 +.Os BSD 4.3 +.Sh 名称 +.Nm rpc.rstatd +.Nd カーネル統計サーバー +.Sh 書式 +.Nm /usr/libexec/rpc.rstatd +.Sh 解説 +.Nm rpc.rstatd +はカーネルから性能統計を取得するサーバーです。 +この統計は、 +.Xr rup 1 +コマンドを使って読むことができます。 +.Nm rpc.rstatd +デーモンは通常 +.Xr inetd 8 +から起動されます。 +.Pp +.Nm rpc.rstatd +は +.Pa /usr/include/rpcsvc/rstat.x +で定義された RPC プロトコルを使用します。 +.Sh 関連項目 +.Xr rup 1 , +.Xr inetd 8 + diff --git a/ja_JP.eucJP/man/man8/rpc.rusersd.8 b/ja_JP.eucJP/man/man8/rpc.rusersd.8 new file mode 100644 index 0000000000..0a52dad0bc --- /dev/null +++ b/ja_JP.eucJP/man/man8/rpc.rusersd.8 @@ -0,0 +1,66 @@ +.\" -*- nroff -*- +.\" +.\" Copyright (c) 1985, 1991 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. +.\" +.\" 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. +.\" +.\" %Id: rpc.rusersd.8,v 1.1.1.1 1994/08/28 14:53:44 csgr Exp % +.\" jpman %Id: rpc.rusersd.8,v 1.2 1997/05/22 08:10:18 mitchy Stab % +.\" +.Dd June 7, 1993 +.Dt RPC.RUSERSD 8 +.Os BSD 4.3 +.Sh 名称 +.Nm rpc.rusersd +.Nd ログインしているユーザに関する情報のサーバ +.Sh 書式 +.Nm /usr/libexec/rpc.rusersd +.Sh 解説 +.Nm rpc.rusersd +は、システムに現在ログインしているユーザに関する情報を +返すサーバです。 +.Pp +現在ログインしているユーザについて、 +.Xr rusers 1 +を用いることで問い合わせることが出来ます。 +.Nm rpc.rusersd +デーモンは、通常 +.Xr inetd 8 +から起動されます。 +.Pp +.Nm rpc.rusersd +は、 +.Pa /usr/include/rpcsvc/rnusers.x +に定義された RPC プロトコルを使用します。 +.Sh 関連項目 +.Xr rusers 1 , +.Xr who 1 , +.Xr w 1 , +.Xr inetd 8 diff --git a/ja_JP.eucJP/man/man8/rpc.rwalld.8 b/ja_JP.eucJP/man/man8/rpc.rwalld.8 new file mode 100644 index 0000000000..7f63f2f875 --- /dev/null +++ b/ja_JP.eucJP/man/man8/rpc.rwalld.8 @@ -0,0 +1,67 @@ +.\" -*- nroff -*- +.\" +.\" Copyright (c) 1985, 1991 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. +.\" +.\" 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. +.\" +.\" %Id: rpc.rwalld.8,v 1.1.1.1 1994/08/28 14:58:36 csgr Exp % +.\" jpman %Id: rpc.rwalld.8,v 1.2 1997/05/22 08:15:10 mitchy Stab % +.\" +.Dd June 7, 1993 +.Dt RPC.RWALLD 8 +.Os BSD 4.3 +.Sh 名称 +.Nm rpc.rwalld +.Nd ログインしているユーザにメッセージを送るためのサーバ +.Sh 書式 +.Nm /usr/libexec/rpc.rwalld +.Sh 解説 +.Nm rpc.rwalld +は、システムにログインしている全てのユーザに対して +メッセージを送るためのサーバです。本サーバは +.Xr wall 1 +を起動し、メッセージの送信を行ないます。 +.Pp +メッセージは、 +.Xr rwall 1 +コマンドを用いて本サーバに送信されます。 +.Nm rpc.walld +デーモンは、通常は +.Xr inetd 8 +から起動されます。 +.Pp +.Nm rpc.rwalld +は、 +.Pa /usr/include/rpcsvc/rwall.x +に定義された RPC プロトコルを使用します。 +.Sh 関連項目 +.Xr rwall 1 , +.Xr wall 1 , +.Xr inetd 8 diff --git a/ja_JP.eucJP/man/man8/rpc.sprayd.8 b/ja_JP.eucJP/man/man8/rpc.sprayd.8 new file mode 100644 index 0000000000..ba23cbafee --- /dev/null +++ b/ja_JP.eucJP/man/man8/rpc.sprayd.8 @@ -0,0 +1,57 @@ +.\" +.\" Copyright (c) 1994 Christos Zoulas +.\" 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 Christos Zoulas. +.\" 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: rpc.sprayd.8,v 1.2 1996/04/07 00:05:54 mpp Exp % +.\" jpman %Id: rpc.sprayd.8,v 1.3 1997/09/04 17:42:05 horikawa Stab % +.\" +.Dd June 22, 1994 +.Dt RPC.SPRAYD 8 +.Os BSD 4.3 +.Sh 名称 +.Nm rpc.sprayd +.Nd spray 用サーバ +.Sh 書式 +.Nm /usr/libexec/rpc.sprayd +.Sh 解説 +.Nm rpc.sprayd +は、 +.Xr spray 8 +コマンドによって送出されたパケットを記録し、パケットの送出者に +ネットワークトラフィックの情報を送信するサーバです。 +.Nm rpc.sprayd +は、通常 +.Xr inetd 8 +から起動されます。 +.Pp +.Nm rpc.sprayd +は、 +.Pa /usr/include/rpcsvc/spray.x +に定義された RPC プロトコルを使用します。 +.Sh 関連項目 +.Xr spray 8 diff --git a/ja_JP.eucJP/man/man8/rpc.statd.8 b/ja_JP.eucJP/man/man8/rpc.statd.8 new file mode 100644 index 0000000000..6a9896161d --- /dev/null +++ b/ja_JP.eucJP/man/man8/rpc.statd.8 @@ -0,0 +1,115 @@ +.\" -*- nroff -*- +.\" +.\" Copyright (c) 1995 A.R.Gordon, andrew.gordon@net-tel.co.uk +.\" 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. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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. +.\" +.\" jpman %Id: rpc.statd.8,v 1.3 1997/09/04 17:44:05 horikawa Stab % +.\" +.Dd September 19, 1995 +.Dt RPC.STATD 8 +.Os +.Sh 名称 +.Nm rpc.statd +.Nd ホストステータス監視デーモン +.Sh 書式 +.Nm rpc.statd +.Op Fl d +.Sh 解説 +.Nm +は、他のホスト上の rpc.statd デーモンと協調してステータスの監視 +サービスを提供するデーモンです。 +デーモンは、ローカルホスト上で動くプログラム (たとえば +.Xr rpc.lockd 8 +NFS ファイルロックデーモン) からのリクエストを受け取り、 +指定したホストのステータスを監視します。 +監視中のホストがクラッシュし再起動すると、リモートのデーモンは +そのことをローカルデーモンに対し知らせ、さらにローカルデーモンが +監視サービスをリクエスト +したローカルプログラムに対して知らせます。 +逆に、もしこのホストがクラッシュし再起動すると、 +.Nm +は再起動時に、クラッシュ時に監視していた全てのホストに対してクラッシュ +が起こったことを知らせます。 +.Pp +.Nm +のオプションは以下のとおりです: +.Bl -tag -width indent +.It Fl d +syslog を通してデバッグ情報を書くようになります。 +デーモンへの全ての RPC トランザクションが記録されます。 +このメッセージは level が LOG_DEBUG で facility が LOG_DAEMON として +記録されます。 +エラーの状態は、このオプションに関わらず、log level が LOG_ERR で +facility が LOG_DAEMON として syslog を通して記録されます。 +.El +.Pp +.Nm +デーモンは +.Xr inetd 8 +から起動してはいけません。これは、プロトコルが、システムの開始時に +デーモンが起動されていることを仮定しているためです。 +デーモンは +.Xr rc 8 +によりネットワークの開始後に起動されるべきです。 +.Sh 関連ファイル +.Bl -tag -width /usr/include/rpcsvc/sm_inter.x -compact +.It Pa /var/db/statd.status +現在監視しているホストの不揮発レコード +.It Pa /usr/include/rpcsvc/sm_inter.x +ローカルアプリケーションが監視リクエストを登録するために使う RPC プロトコル +の仕様。 +.El +.Sh 関連項目 +.Xr syslog 3 , +.Xr rc 8 , +.Xr rpc.lockd 8 +.Sh バグ +監視中のホストが (致命的なハードウェア障害などのため) 永久に見えなくなっ +たことをデーモンが知る手段はありませんが、 +ホストや中間のルータの一時的な障害は知ることは出来ます。 +現在の実装では、リトライは 10 分間隔、つぎは 1 時間ごとに行い、最後に 24 時間 +経つとあきらめます。 + +プロトコルでは、監視関係の確立に、 +ローカルとリモートの両方のデーモンで対称に監視リクエストを行うことを +要求しています。 +これは NFS のロックプロトコルの場合は便利ですが、 +おそらく他のアプリケーション用の監視システムとしての +有用性が低下しています。 + +現在の実装では、各監視ホストにつき 1Kbytes の領域が +ステータスファイル内 (VM 内にも) に確保されます。このため、 +多くのクライアントを抱える NFS サーバでは非効率的であるかもしれません。 +.Sh 標準 +実装は、 +X/Open CAE Specification +C218, "Protocols for X/Open PC Interworking: XNFS, Issue 4", ISBN 1 872630 66 9 +をもとにしています。 diff --git a/ja_JP.eucJP/man/man8/rpc.yppasswdd.8 b/ja_JP.eucJP/man/man8/rpc.yppasswdd.8 new file mode 100644 index 0000000000..2c0c3f4b66 --- /dev/null +++ b/ja_JP.eucJP/man/man8/rpc.yppasswdd.8 @@ -0,0 +1,326 @@ +.\" Copyright (c) 1995, 1996 +.\" Bill Paul <wpaul@ctr.columbia.edu>. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by Bill Paul. +.\" 4. Neither the name of the author nor the names of contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: rpc.yppasswdd.8,v 1.4.2.1 1997/03/06 08:00:02 mpp Exp % +.\" jpman %Id: rpc.yppasswdd.8,v 1.3 1997/08/31 14:17:34 horikawa Stab % +.\" +.Dd February 8, 1996 +.Dt RPC.YPPASSWDD 8 +.Os +.Sh 名称 +.Nm rpc.yppasswdd +.Nd "NIS パスワードを変更するためのサーバ" +.Sh 書式 +.Nm rpc.yppasswdd +.Op Fl t Ar master.passwd template file +.Op Fl d Ar default domain +.Op Fl p Ar path +.Op Fl s +.Op Fl f +.Op Fl a +.Op Fl m +.Op Fl i +.Op Fl v +.Op Fl u +.Op Fl h +.Sh 解説 +.Nm rpc.yppasswdd +デーモンは、ユーザが +.Xr yppasswd 1 +と +.Xr ypchpass 1 +コマンド使うことで、 +NIS パスワードおよび他の情報を変更することを許します。 +.Nm rpc.yppasswdd +は、パスワードの変更要求を受け入れ、その認証を行い、 +.Pa /var/yp/master.passwd +ファイル中に更新された情報を配置し、 +NIS の +.Pa master.passwd +マップと +.Pa passwd +マップを更新する、 RPC を使ったサーバです。 +.Pp +.Nm rpc.yppasswdd +は、普通の NIS ユーザが、自分の NIS パスワード・ +('GECOS'フィールドとして知られている)フルネーム・シェルを変更することを許します。 +これらの更新は、典型的には +.Xr yppasswd 1 , +.Xr ypchfn 1 , +.Xr ypchsh 1 , +.Xr ypchpass 1 +コマンドを使って行われます。 +(管理者の中には、ユーザが名前の情報やシェルを変更することを +望まない人もいます。サーバは、オプションフラグを使うことで、そのような +変更ができない様にできます。)サーバが更新要求を受け取ると、 +.Pa /var/yp/securenets +ファイルに記述されている +.Pa securenets +規則 (securenets に関する詳細な情報は +.Xr ypserv 8 +のマニュアルページを参照してください。 +.Nm rpc.yppasswdd +サーバは、 +.Xr ypserv 8 +と同じアクセス制御機構を使います。)に照らして、 +要求を行ったクライアントのアドレスを比較します。 +.Pp +サーバは、その後ユーザが入力した '古い' パスワードが有効かどうかを +確認し、その後いくつかの更新情報のチェックを行います +(これらには、制御文字のチェックやコロンや有効なシェルのチェックを +含みます)。ひとたび更新要求が有効であることが満足されると、 +サーバはパスワードテンプレートファイル (デフォルトでは、 +.Pa /var/yp/master.passwd +です) を更新し、その後 NIS マップを再構築するために +.Pa /usr/libexec/yppwupdate +スクリプトを実行します。(このスクリプトは、二つの引数を受け取ります: +それらは変更されたパスワードテンプレートの相対パス名と更新された +ドメインの名前です。これらは、 +.Pa /var/yp/Makefile +に渡されます。) +.Pp +FreeBSD 版の +.Nm rpc.yppasswdd +は、NIS マスタサーバ上のスーパユーザが NIS パスワードマップを更新するための +より洗練された方法を提供します。スーパユーザは任意のドメインの +任意のユーザの master.passwd エントリの任意のフィールドを変更できます。 +これは、ユーザの現在の NIS パスワードについて知らなくても可能です +(サーバがスーパユーザからの要求を受け取ると、パスワード認証は +省略します)。そのうえ、サーバが +.Fl a +フラグ付きで実行された時には、スーパユーザは +.Xr ypchpass 1 +を使って、新しいエントリをマップに付け加えることさえできます。 +また、これは、 NIS マスタサーバ上のスーパユーザだけに適用されます。 +これらの特別な機能はネットワークを介しては提供されません。 +.Pp +.Nm rpc.yppasswdd +デーモンは、 NIS マスタサーバである機械上でだけ実行することが +できます。 +.Sh オプション +以下のオプションとフラグが、 +.Nm rpc.yppasswdd +で提供されています。 +.Bl -tag -width flag +.It Fl t Ar master.passwd template file +デフォルトでは、 +.Nm rpc.yppasswdd +は、デフォルトドメインの +.Pa master.passwd +と +.Pa passwd +を生成するために使われるテンプレートファイルは、 +.Pa /var/yp/master.passwd +であることを仮定しています。このデフォルトは、代わりのファイル名を +.Fl t +フラグとともに指定することで上書きできます。 +.Pp +(注意): このフラグとともに指定されたテンプレートファイルが +.Pa /etc/master.passwd +である場合、 +.Nm rpc.yppasswdd +は NIS のマップに加えてローカルのパスワードデータベースを +再構成するために、自動的に +.Xr pwd_mkdb 8 +を呼び出します。 +.It Fl d Ar domain +.Nm rpc.yppasswdd +サーバは複数のドメインを扱うことができますが、一つのドメインを +デフォルトとして選ばなければなりません。 +.Xr domainname 1 +コマンドによって設定されたシステムデフォルトのドメイン名を +使おうとします。しかしながら、システムドメイン名が設定されていない場合、 +デフォルトドメイン名はコマンドラインで指定しなければなりません。 +システムデフォルトドメインが設定されている場合、このオプションはその +定義を上書きします。 +.It Fl p Ar path +このオプションは、デフォルトの NIS マップデータベースのパスを +上書きするために使われます。コンパイル時に指定されているデフォルトの +パスは +.Pa /var/yp +です。 +.It Fl s +シェル情報の変更を認めません。 +.It Fl f +フルネーム ('GECOS') 情報の変更を認めません。 +.It Fl a +NIS パスワードデータベースへの追加を許可します。NIS マスタサーバ上の +スーパユーザは、 +.Xr ypchpass 1 +コマンドでユーザの +.Pa master.passwd +マップエントリのどんなフィールドでも、無制限の変更を行うことが +許されています。 +.Nm rpc.yppasswdd +がこのフラグを付けて実行された場合、 +.Xr chpass 1 +を使用したローカルパスワードデータベース更新にて可能であるのと同様に、 +スーパユーザが NIS パスワードマップに新しいレコードを追加することを許可します。 +.It Fl m +マルチドメインモードを有効にします。 +.Xr ypserv 8 +は同時にいくつかのドメインを扱うことができますが、ほとんどの +.Nm rpc.yppasswdd +実装では、一つの NIS ドメインだけしか扱うことができません。 +これは、一般に NIS マスタサーバのシステムデフォルトドメインと同じです。 +FreeBSD の +.Nm rpc.yppasswdd +は、 +.Pa yppasswd +プロトコルでは +.Pa domain +引数をクライアントの要求中に含めることが出来ないという +プロトコル固有の制限にもかかわらず、 +この問題を解決しようとしています。 +マルチドメインモードでは、 +.Nm rpc.yppasswdd +は +.Pa /var/yp +下の全ドメインの全パスワードマップを検索し、 +与えられた更新要求で指定されたユーザ情報と一致するエントリを見付けます。 +(一致したかどうかは、ユーザ名と UID および GID フィールドを調べることで +決定されます。) 一致したエントリとそのドメインはその後更新のために +使われます。 +.Pp +マルチドメインモードがうまく動くためには、各ドメイン毎に +別々のテンプレートファイルが必要なことに注意してください。 +例えば、サーバが 3 つのドメイン +.Pa foo , +.Pa bar , +.Pa baz +を提供している時、 3 つの別の master.passwd テンプレートファイル +.Pa /var/yp/foo/master.passwd , +.Pa /var/yp/bar/master.passwd , +.Pa /var/yp/baz/master.passwd +が必要です。 +.Pa foo +がシステムデフォルトドメインであったとすると、そのテンプレートファイル +は +.Pa /var/yp/foo/master.passwd +もしくは +.Pa /var/yp/master.passwd +のどちらであっても構いません。 +サーバは、後のファイルを先に確認し、見付からない場合には先のファイルを +確認します。 +.Pp +デフォルトでは、マルチドメインモードにはなっていません。 +これは、異なったドメインに同じもしくは似ているエントリが存在した場合 +に失敗するからです。検索領域に複数のエントリを見付けた場合、 +サーバは更新要求を停止します。 +したがって、偏執的な管理者はマルチドメインモードを利用不可能にしたいと +思うでしょう。 +.It Fl i +.Nm rpc.yppasswdd +がこのフラグ付きで呼び出された場合、マップ更新をその場で行おうとします。 +この意味は、 +パスワードテンプレートファイルを直接更新してマップ更新する代わりに、 +サーバがマップデータベースを直接更新するということです。 +これは、パスワードマップが大きい時に有効です。例えば、 +パスワードデータベースに 10,000 ものエントリがある場合、マップの更新が +終了するまでに数分かかってしまいます。その場でマップを更新することで、 +この時間を数秒までに減らすことができます。 +.It Fl v +冗長なログモードに入ります。通常、サーバはエラー状態時や +スーパユーザによる NIS マスタサーバ上での更新n時に、 +.Xr syslog 3 +の能力を使ってメッセージを記録します。サーバが +.Fl v +オプションを使って実行されている時には、全ての更新に対する +情報メッセージを記録します。 +.It Fl u +たくさんの商用の +.Xr yppasswd 1 +クライアントは、 +.Nm rpc.yppasswdd +への要求を送る時に予約ポートを使いません。 +これは、 +.Xr yppasswd 1 +が root に set-uid されずにインストールされているか、 RPC の実装が +スーパユーザのためにクライアント接続が確立されたとき、 +予約ポートを割り当てることをしないようになっているためです。 +デフォルトでは、 +.Nm rpc.yppasswdd +は、クライアントからの結果を予約ポートを使って受け取ることを期待します。 +非特権ポートから受け取った要求は、排除されます。不幸にして、この振舞いは +特権ポートを使えないクライアントシステムからのパスワード更新要求を妨げます。 +.Fl u +フラグを指定することで、 +.Nm rpc.yppasswdd +は、特権ポートを使えない +.Xr yppasswd 1 +でも働くように、特権ポートのチェックを無効にします。 +これは、少しセキュリティを低下させますが、クライアントの振舞いを +変更できない場合には必要になるでしょう。 +.It Fl h +.Nm rpc.yppasswdd +が理解できるフラグやオプションのリストを表示します。 +.El +.Sh 関連ファイル +.Bl -tag -width Pa -compact +.It Pa /usr/libexec/yppwupdate +NIS マップを更新し、その後でプッシュするために、 +.Nm rpc.yppasswdd +によって呼び出されるスクリプトです。 +.It Pa /var/yp/master.passwd +デフォルトドメインのためのテンプレートパスワードファイルです。 +.It Pa /var/yp/[domainname]/[maps] +特定の NIS ドメインのための NIS マップです。 +.It Pa /var/yp/[domainname]/master.passwd +デフォルトでないドメインのための一時パスワードファイルです +(マルチドメインモードだけで使われます)。 +.El +.Sh 関連項目 +.Xr yp 4 , +.Xr yppush 8 , +.Xr ypserv 8 , +.Xr ypxfr 8 +.Sh バグ +yppasswd.x プロトコル定義で記述されているように、 +YPPASSWDPROC_UPDATE プロシジャは二つの引数を取ります。 +更新するユーザ情報を含む V7 形式のパスワード構造および、 +ユーザの暗号化されない (クリアテキスト) パスワードです。 +.Nm rpc.yppasswdd +はリモートの NIS クライアントマシンからの更新要求を扱うことを +仮定しています。これは、 +.Xr yppasswd 1 +や似たようなクライアントプログラムがネットワークを通して、 +ユーザのクリアテキストパスワードを転送するということを意味します。 +.Pp +これはパスワード更新では問題ではありません。 +なぜなら、更新と共に送られるプレインテキストパスワードは、 +新しい暗号化されたパスワードが有効になった時には無効になっているからです。 +しかし、ユーザが自分の 'GECOS' 情報やシェルを更新する場合には、 +更新と共に送られるクリアテキストパスワードは、 +更新完了時にも有効です。 +ネットワークがセキュアでない場合、このクリアテキストパスワードは、 +途中でとらえられ、 +そのユーザアカウントに対する不正アクセスに使用されるかも知れません。 +.Sh 作者 +Bill Paul <wpaul@ctr.columbia.edu> diff --git a/ja_JP.eucJP/man/man8/rpc.ypxfrd.8 b/ja_JP.eucJP/man/man8/rpc.ypxfrd.8 new file mode 100644 index 0000000000..bad7b885c0 --- /dev/null +++ b/ja_JP.eucJP/man/man8/rpc.ypxfrd.8 @@ -0,0 +1,139 @@ +.\" Copyright (c) 1995, 1996 +.\" Bill Paul <wpaul@ctr.columbia.edu>. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by Bill Paul. +.\" 4. Neither the name of the author nor the names of contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: rpc.ypxfrd.8,v 1.1.1.1.2.2 1997/10/14 06:40:05 charnier Exp % +.\" jpman %Id: rpc.ypxfrd.8,v 1.3 1997/09/04 17:48:28 horikawa Stab % +.\" +.Dd June 2, 1996 +.Dt RPC.YPXFRD 8 +.Os +.Sh 名称 +.Nm rpc.ypxfrd +.Nd "NIS マップ転送サーバ" +.Sh 書式 +.Nm rpc.ypxfrd +.Op Fl p Ar path +.Sh 解説 +.Nm +デーモンは NIS マスタサーバから NIS スレーブサーバへの巨大な NIS +マップの配布を高速化するためのに使われます。通常、マップの転送はいくつ +かの手順を経ます: +.Bl -bullet -offset indent +.It +マスタサーバが +.Xr yppush 8 +を呼び出し、スレーブサーバが転送を開始するよう指示します。 +.It +スレーブサーバは、 +.Xr ypxfr 8 +を起動します。 +.Xr ypxfr 8 +は、マスタサーバから yp_all() を使ってマップの内容をすべて読みます。 +.It +次に +.Xr ypxfr 8 +は、 +.Xr db 3 +ライブラリを使ってサーバから受け取ったデータをハッシュし新しいマップ +データベースファイルを作成します。 +.It +全てのデータを書き終えてから、 +.Xr ypxfr 8 +は、新しいファイルを置き換え、ローカルマシンの +.Xr ypserv 8 +宛にデータベースハンドルを更新するよう YPPROC_CLEAR を送ります。 +.El +.Pp +巨大なマップが含まれている場合、この処理に数分かかることがあります。 +たとえば、数万のエントリのあるパスワードデータベースでは、数メガバイト +のディスクを消費し、 +.Xr db 3 +ライブラリがハッシュテーブルに全てのエントリをソートし納めるのに +長時間かかります。さらに、マップファイルは2セットあります: +.Pa master.passwd.by{name,uid} +と +.Pa passwd.by{name,uid} +です。 +.Pp +.Nm +サーバは NIS スレーブサーバがマスターサーバのマップファイルを +コピーし、マップファイルの構築を行わないことで、転送処理を高速化し +ます。 +.Nm +は、単に RPC ベースのファイル転送プロトコルを実装しているだけです。 +十分に高速なスレーブサーバが数メガバイトのファイルからマップを構築する +のに数分かかるのにたいし、転送では数秒しかかかりません。 +.Pp +.Nm +サーバは、 +.Xr ypserv 8 +と同じアクセス制限メカニズムを使っています。 +したがって、 +.Xr securenets 5 +データベースで許されているスレーブサーバのみがファイルを転送できます。 +さらに、reserved ポートを使うスレーブサーバのみが、 +.Pa master.passwd +マップを転送することを許されています。 +.Sh オプション +オプションは以下の通りです: +.Bl -tag -width indent +.It Fl p Ar path +このオプションにより、デフォルトの NIS データベースへのパスを変更しま +す。デフォルトパスは、 +.Pa /var/yp +です。 +.El +.Sh 関連ファイル +.Bl -tag -width Pa -compact +.It Pa /var/yp/[domainname]/[maps] +ある NIS ドメインの NIS マップ群。 +.El +.Sh 関連項目 +.Xr yp 4 , +.Xr yppush 8 , +.Xr ypserv 8 , +.Xr ypxfr 8 +.Sh バグ +.Bx Free +の +.Nm +プロトコルは SunOS で使われているものと互換性がありません。これは残念な +ことではありますが、避けることが出来ません: Sun のプロトコルは +自由に入手することは出来ず、さらに入手できたとしても、 +SunOS NIS v2 の実装ではマップデータベースに ndbm パッケージを使ってお +り、 +.Bx Free +の実装で使われている Berkeley DB パッケージではないため不便です。 +これらの二つのパッケージ間のフォーマットは非常に異なっています。 +さらに、 ndbm はバイトオーダの問題があり、ビッグエンディアンのシステムで +作った ndbm データベースはリトルエンディアンのシステムでは読むことが出来 +ません。 +.Sh 作者 +.An Bill Paul Aq wpaul@ctr.columbia.edu diff --git a/ja_JP.eucJP/man/man8/rpcinfo.8 b/ja_JP.eucJP/man/man8/rpcinfo.8 new file mode 100644 index 0000000000..9eb2750dfd --- /dev/null +++ b/ja_JP.eucJP/man/man8/rpcinfo.8 @@ -0,0 +1,157 @@ +.\" from: @(#)rpcinfo.8c 2.2 88/08/03 4.0 RPCSRC; from 1.24 88/02/25 SMI +.\" 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 +.Os +.Sh 名称 +.Nm rpcinfo +.Nd RPC に関する情報を表示する +.Sh 書式 +.Nm rpcinfo +.Fl p +.Op Ar host +.Nm rpcinfo +.Op Fl n Ar portnum +.Fl u Ar host +.Ar program +.Op Ar version +.Nm rpcinfo +.Op Fl n Ar portnum +.Fl t Ar host +.Ar program +.Op Ar version +.Nm rpcinfo +.Fl b +.Ar program version +.Nm rpcinfo +.Fl d +.Ar program version +.Sh 解説 +.Nm +は、 +.Tn RPC +サーバに対して +.Tn RPC +呼び出しを行ない、得られた情報を表示します。 +.Sh オプション +.Bl -tag -width indent +.It Fl p +指定されたホスト上のポートマッパーを検出し、そこに登録されている全ての +.Tn RPC +プログラムの一覧を出力します。 +.Ar host +が指定されない場合、 +.Xr hostname 1 +コマンドをオプション無しで実行した時に出力されるホスト名が +.Ar host +として採用されます。 +.It Fl u +.Tn UDP +プロトコルを用いて、指定したホスト上のプログラムの手続き 0 に対して +.Tn RPC +呼び出しを行ないます。そして、応答があったかどうかを報告します。 +.It Fl t +.Tn TCP +プロトコルを用いて、指定したホスト上のプログラムの手続き 0 に対して +.Tn RPC +呼び出しを行ないます。そして、応答があったかどうかを報告します。 +.It Fl n +.Fl t +や +.Fl u +オプション使用時に、ポートマッパーに与えられたポート番号のかわり +に、引数 +.Ar portnum +で指定した番号をポート番号として用います。 +.It Fl b +.Tn UDP +プロトコルを用いて、引数 +.Ar program +および +.Ar version +で指定したプログラムに対し、手続き 0 に +.Tn RPC +ブロードキャストを行ないます。そして、応答のあった全てのホストにつ +いてのレポートを出力します。 +.It Fl d +引数 +.Ar program +および +.Ar version +で指定したプログラムの +.Tn RPC +サービスへの登録を削除します。 +本オプションは、スーパーユーザのみ指定可能です。 +.El +.Pp +引数 +.Ar program +は、名称・番号のいずれでも構いません。 +.Pp +もし引数 +.Ar version +が指定されると、 +.Nm +は引数 +.Ar program +で指定されたプログラムのそのバージョンの呼び出しを試みます。 +.Ar version +が指定されなかった場合、 +.Nm +は +.Ar program +で指定されたプログラムに対してバージョン 0 呼びだしを行なうことで、 +全ての登録されているバージョンについて検索を試みます +(バージョン 0 は存在しないと仮定してのものです。もし存在すれば +.Ar rpcinfo +は極端に高いバージョンを使って情報を得ようとします)。 +.Fl b +および +.Fl d +オプションには、バージョン番号の指定が必要であることに注意して下さい。 +.Sh 使用例 +ローカルマシンに登録されている全ての +.Tn RPC +サービスを見るには、次のようにします: +.Pp +.Dl example% rpcinfo -p +.Pp +ホスト名 klaxon 上に登録されている全ての +.Tn RPC +サービスを見るには、次のようにします: +.Pp +.Dl example% rpcinfo -p klaxon +.Pp +NIS サービス (Yellow Page サービス) が稼働している +ローカルネットワーク上に接続されているマシンすべてを表示するには、 +次のようにします: +.Pp +.Dl example% rpcinfo -b ypserv 'version' | uniq +.Pp +\&'version' のところには、上記 +.Fl p +オプションの結果から得られた現在の NIS サービス +(Yellow Page サービス) +のバージョンを使います。 +.Pp +バージョン 1 の +.Nm walld +サービスを削除するには、次のようにします: +.Pp +.Dl example% rpcinfo -d walld 1 +.Sh 関連項目 +.Xr rpc 5 , +.Xr portmap 8 +.Rs +.%T "RPC Programming Guide" +.Re +.Sh バグ +SunOS 3.0 以前のリリースでは、ネットワークファイルシステム ( +.Tn NFS +) がポートマッパーに登録されていません。そのため +.Nm +は、そのような OS が稼働しているマシンに対して +.Tn RPC +呼び出しを行なうことが出来ません。 diff --git a/ja_JP.eucJP/man/man8/rshd.8 b/ja_JP.eucJP/man/man8/rshd.8 new file mode 100644 index 0000000000..84130eb419 --- /dev/null +++ b/ja_JP.eucJP/man/man8/rshd.8 @@ -0,0 +1,214 @@ +.\" Copyright (c) 1983, 1989, 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. +.\" +.\" 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. +.\" +.\" @(#)rshd.8 8.1 (Berkeley) 6/4/93 +.\" %Id: rshd.8,v 1.4.2.1 1997/05/10 21:41:51 davidn Exp % +.\" jpman %Id: rshd.8,v 1.4 1997/08/10 18:35:56 horikawa Stab % +.\" +.Dd June 4, 1993 +.Dt RSHD 8 +.Os BSD 4.2 +.Sh 名称 +.Nm rshd +.Nd リモートシェルのサーバ +.Sh 書式 +.Nm rshd +.Op Fl alnL +.Sh 解説 +.Nm rshd +は、 +.Xr rcmd 3 +ルーチンのためのサーバであり、結果として +.Xr rsh 1 +の実行のために必要となるサーバです。 +.Nm rshd +は、信頼できるホストからの特権ポート番号に基づいた +認証を行なうことによって、プログラムのリモート実行機能を提供します。 +.Pp +.Nm rshd +サーバは、``cmd'' サービスに割り当てられたポート ( +.Xr services 5 +参照) でサービス要求を受け付けます。サービス要求を受信すると、 +サーバは以下の手順を開始します: +.Bl -enum +.It +サーバは、クライアントの要求元ポート番号のチェックをおこないます。 +要求元ポート番号 +が 512 から 1023 の範囲にない場合、サーバは接続を強制切断します。 +.It +サーバは、ソケットからヌルバイト (`\e0') を検出するまで文字を読みます。 +受信文字列は、 +.Tn ASCII +コードによる 10 進数の数値に変換します。 +.It +ステップ 2 で受信した数値が 0 でない場合、その数値を +.Em 標準エラー出力 +で使用する 2 番目のストリームのポート番号として解釈します。 +そしてクライアントマシン上でも指定されたポート番号の 2 番目の接続を生成します。 +この 2 番目の接続の要求元ポート番号も、512 から 1023 の範囲で指定します。 +.It +サーバは、クライアントの要求元アドレスをチェックし、該当するホスト名を要求し +ます ( +.Xr gethostbyaddr 3 , +.Xr hosts 5 , +.Xr named 8 +を参照してください)。ホスト名が特定 +できない場合、ドット表記法によるホストアドレスを用います。 +ホスト名で指定されたホストがサーバと同一の +ドメインに存在する場合 (ドメイン名の最後の 2 つの部分が一致する場合)、 +または +.Fl a +オプションが与えられた場合は、ホスト名に対応したアドレスを要求して +名前とアドレスの対応をチェックします。もしこの対応が不正なもので +あった場合、接続を強制切断し、``Host address mismatch.'' の +メッセージを表示します。 +.It +最初のソケットを介して、ヌル終端された最大 16 文字の +ユーザ名を取得します。ユーザ名は、 +.Em クライアント +マシン上のユーザ識別に使用します。 +.It +最初のソケットを介して、ヌル終端された最大 16 文字の +ユーザ名を取得します。ユーザ名は、 +.Em サーバ +マシン上のユーザ認証に使用します。 +.It +最初のソケットを介して、シェルに渡されるべき、ヌル終端された +コマンドを取得します。コマンド長の制限は、システムの引数リスト +サイズの上限に依存します。 +.It +.Nm rshd +は、 +.Pa /etc/hosts.equiv +および当該ユーザのホームディレクトリ上に存在する +.Pa .rhosts +ファイルを用いる +.Xr ruserok 3 +を使用して、ユーザ認証を行います。 +.Fl l +オプションは、ユーザがスーパユーザでない限り、``.rhosts'' ファイルに基づいた +.Xr ruserok 3 +のすべての認証をおこなわないようにします。 +.It +.Pa /etc/nologin +ファイルが存在し、ユーザがスーパユーザでない場合、接続を +切断します。 +nologin ファイルの名前に関しては、login.conf にて +ローカルユーザのログインクラスに関する nologin= ケーパビリティが優先します。 +ログインクラスは、ログイン時間(times.allow と times.denny ケーパビリティ) +およびリモートホスト(hosts.allow と hosts.denny ケーパビリティ)による +rsh アクセスの制限にも使われます。 +.It +最初のソケットを用いてヌルバイトを返し、コマンドライン +を、ユーザの通常のログインシェルに渡します。シェルは +.Nm rshd +によって確立されたネットワーク接続を継承します。 +.El +.Pp +.Fl n +オプションが与えられないかぎり、トランスポートレベルの keepalive メッセージが +有効になります。keepalive メッセージを使用することによって、 +クライアントプロセスが異常終了するか、もしくはネットワーク到達不可に +なった場合にセッションをタイムアウトで終了させることができます。 +.Pp +.Fl L +オプションを用いることで、すべての正常なアクセスを +.Xr syslogd 8 +を経由して +.Li auth.info +メッセージとして、ログします。 +.Sh 診断 +以下に示す例のうち最後のものを除き、 +すべての診断メッセージを最初のソケットを用いて返した後、 +すべての接続をクローズします。 +エラーは、先行する 1 バイトとして値 1 が返されるこ +とでわかります (ログインシェル実行の前のすべてのステップが正常に完了した場合、 +上記のステップ 10 の処理で 0 を返します)。 +.Bl -tag -width indent +.It Sy Locuser too long. +クライアントマシン上のユーザ名が、16 文字を超えています。 +.It Sy Ruser too long. +リモートマシン上のユーザ名が、16 文字を超えています。 +.It Sy Command too long . +渡されたコマンドラインの長さが、引数リストの大きさを超えています +(システムに依存します)。 +.It Sy Login incorrect. +当該ユーザに関するエントリが、パスワードファイルに登録されていません。 +.It Sy Remote directory. +ホームディレクトリへの +.Xr chdir +コマンドが失敗しました。 +.It Sy Permission denied. +前述の認証手続きが失敗しました。 +.It Sy Logins not available right now. +ローカルユーザのログインクラスに対する login.conf において、 +許された時間以外で rsh が試されました。 +.It Sy Can't make pipe. +.Em 標準エラー出力 +に必要なパイプを作成できませんでした。 +.It Sy Can't fork; try again. +サーバによる +.Xr fork +が失敗しました。 +.It Sy <shellname>: ... +ユーザのログインシェルを起動できませんでした。本メッセージの出力は +.Em 標準エラー出力 +に関連づけられたコネクションを介して返されますので、 +フラグバイトは先行しません。 +.El +.Sh 関連項目 +.Xr rlogin 1 , +.Xr rsh 1 , +.Xr gethostbyaddr 3 , +.Xr rcmd 3 , +.Xr ruserok 3 , +.Xr hosts 5 , +.Xr login.conf 5 , +.Xr nologin 5 , +.Xr services 5 , +.Xr named 8 , +.Xr rlogind 8 , +.Xr syslogd 8 . +.Sh 関連ファイル +.Bl -tag -width /etc/hosts -compact +.It Pa /etc/hosts +.It Pa /etc/hosts.equiv +.It Pa $HOME/.rhosts +.It Pa /etc/nologin +.El +.Sh バグ +ここで用いられているユーザ認証手順は、各クライアントマシンおよび接続媒体が +信頼できるものと仮定しています。 +これは安全ではないですが、``オープン'' な環境下では便利です。 +.Pp +全てのデータについて暗号化を行なう機能が実装されるべきです。 +.Pp +TELNET のような、もっと拡張性のあるプロトコルが用いられるべきです。 diff --git a/ja_JP.eucJP/man/man8/rstat_svc.8 b/ja_JP.eucJP/man/man8/rstat_svc.8 new file mode 100644 index 0000000000..3ff2207b9e --- /dev/null +++ b/ja_JP.eucJP/man/man8/rstat_svc.8 @@ -0,0 +1,24 @@ +.\" @(#)rstat_svc.8c 2.2 88/08/03 4.0 RPCSRC; from 1.10 87/09/09 SMI +.\" jpman %Id: rstat_svc.8,v 1.3 1997/07/27 12:04:04 horikawa Stab % +.TH RSTAT_SVC 8 "24 November 1987" +.SH 名称 +rstat_svc \- カーネル統計サーバ +.SH 書式 +.B /etc/rstat_svc +.SH 解説 +.LP +.B rstat_svc +は、 +カーネルから得られた性能統計を返すサーバです。 +これらの統計値はサン・マイクロシステムズのプログラム、 +.BR perfmeter (1) +によってグラフで表示されます。 +.B rstat_svc +デーモンは、 +通常 /etc/rc.local を通してブート時に呼び出されます。 +.PP +.B rstat_svc +は、 +/usr/include/rpcsvc/rstat.x で定義された RPC プロトコルを使用します。 +.\" .SH "関連項目" +.\" .BR rstat (1), diff --git a/ja_JP.eucJP/man/man8/rtquery.8 b/ja_JP.eucJP/man/man8/rtquery.8 new file mode 100644 index 0000000000..2d2fa78dcd --- /dev/null +++ b/ja_JP.eucJP/man/man8/rtquery.8 @@ -0,0 +1,133 @@ +.\" %Id: rtquery.8,v 1.1.1.1.2.4 1997/08/19 21:22:17 joerg Exp % +.\" jpman %Id: rtquery.8,v 1.2 1997/06/12 07:55:04 yugawa Stab % +.Dd June 1, 1996 +.Dt RTQUERY 8 +.Os BSD 4.4 +.Sh 名称 +.Nm rtquery +.Nd ルーティングデーモンが持つルーティングテーブルの問い合わせ +.Sh 書式 +.Nm +.Op Fl np1 +.Op Fl w Ar timeout +.Op Fl r Ar addr +.Op Fl a Ar secret +.Ar host ... + +.Nm +.Op Fl t Ar op +.Ar host ... +.Sh 解説 +.Nm rtquery +は、RIP ネットワークルーティングデーモン、すなわち、 +.Xr routed 8 +あるいは +.Xr gated 8 +へ +.Em request +ないし +.Em poll +コマンドを送る事によりそのルーティングテーブルの問い合わせを行います。 +返答のあった全てのルーティング +.Em 応答 +パケットについてのルーティング情報が数値およびシンボル名を用いて表示されます。 +.Pp +デフォルトでは、 +.Em rtquery +は +.Em request +コマンドを使用します。 +.Ar -p +オプションが指定された場合、 +.Nm rtquery +は +.Em poll +コマンドを使用します。 +これは、 +.Xr gated 8 +でサポートされている、RIP プロトコルへの文書化されていない拡張コマンドです。 +gated への問い合わせを行う場合は、 +.Em request +コマンドより +.Em poll +コマンドを使用する事をお薦めします。なぜなら、応答が Split Horizon や +Poisoned Reverse の影響を受けることがなく、また、ある種のバージョンの +.Xr gated 8 +は、 +.Em request +に対して返答を行わないからです。 +.Nm routed +は +.Em poll +コマンドに対しては返答しませんが、 +.Nm +からの +.Em request +コマンドを認識し、完全な返答をします。 +.Pp +.Nm rtquery +は、 +.Nm routed +のトレース機能を有効にしたり無効にしたりする場合にも用いられます。 +.Pp +.Nm rtquery +には以下のオプションがあります。 +.Bl -tag -width Ds +.It Fl n +通常、ネットワークおよびホスト番号はシンボル名および数値の両方で表示されます。 +.Fl n +オプションはネットワークおよびホスト番号を数値のみで表示します。 +.It Fl p +.Xr gated 8 +から得られる完全なルーティング情報を得るために +.Em Poll +コマンドを使用します。 +これは、 +.Xr gated 8 +のみでサポートされている、RIP プロトコルへの文書化されていない拡張コマンドです。 +.It Fl 1 +RIP バージョン 2 ではなく、RIP バージョン 1 を使用して問い合わせを行います。 +.It Fl w Ar timeout +各ホストから返答を待つ猶予時間を変更します。 +デフォルトでは、返答があるまで 15 秒間待ちます。 +.It Fl r Ar addr +到達先 +.Em addr +への経路を問い合わせます。 +.It Fl a Ar passwd=XXX +.It Fl a Ar md5_passwd=XXX|KeyID +問い合わせの際に、指定されたクリアテキストないし MD5 のパスワードを +使用します。 +.It Fl t Ar op +トレース方法を変更します。 +.Em op +には、以下のうちのひとつを指定します。 +通常、UID 0 以外のプロセスからの問い合わせや、遠隔ネットワークからの +問い合わせは、システムのログにメッセージを記録するだけで、無視されます。 +.Xr gated 8 +は、大抵、これらのデバッグの問い合わせを無視します。 +.El +.Bl -tag -width Ds -offset indent-two +.It Em on=tracefile +トレースを有効にし、指定されたファイルに記録します。このファイルは、 +通常、デーモンが実行を開始した時に指定されるか、一般的な、 +.Pa /etc/routed.trace +等の決まった名前でなければなりません。 +.It Em more +デバッグレベルを増加させます。 +.It Em off +トレースを無効にします。 +.It Em dump +デーモンのルーティングテーブルを現在のトレースファイルにダンプします。 +.El +.Sh 関連項目 +.Xr gated 8 , +.Xr routed 8 +.Rs +.%T Routing Information Protocol, RIPV1 +.%O RFC1058 +.Re +.Rs +.%T Routing Information Protocol, RIPv2 +.%O RFC1723 +.Re diff --git a/ja_JP.eucJP/man/man8/rwhod.8 b/ja_JP.eucJP/man/man8/rwhod.8 new file mode 100644 index 0000000000..fceab7a962 --- /dev/null +++ b/ja_JP.eucJP/man/man8/rwhod.8 @@ -0,0 +1,196 @@ +.\" this file based on that translated to japanese on NetBSD Japanese Reference +.\" Manual Project, and modefied to fit FreeBSD Reference Manual +.\" by Mochida Shuji 1995/03/31 +.\" +.\" Copyright (c) 1983, 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. +.\" +.\" 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. +.\" +.\" from: @(#)rwhod.8 8.2 (Berkeley) 12/11/93 +.\" jpman %Id: rwhod.8,v 1.3 1997/10/11 07:49:54 horikawa Stab % +.\" +.Dd December 11, 1993 +.Dt RWHOD 8 +.Os BSD 4.2 +.Sh 名称 +.Nm rwhod +.Nd システムステータスサーバ +.Sh 書式 +.Nm +.Op Fl m Op Ar ttl +.Sh 解説 +.Nm +は、 +.Xr rwho 1 +や +.Xr ruptime 1 +プログラムで使われるデータベースを管理するサーバです。 +ネットワークにおいて +.Em ブロードキャスト +もしくは +.Em マルチキャスト +メッセージが使用できることが前提となります。 +.Pp +.Nm +は、ステータス情報のを生成と利用の両方を行います。情報の生成では、定期的に +システムに状態を問い合わせ、ステータスメッセージを構築してネットワークに +ブロードキャストします。情報の利用では、他の +.Nm +サーバからの状態メッセージを受け取り、検査してから、 +.Pa /var/rwho +ディレクトリの下のファイルに記録します。 +.Pp +.Fl m +オプションは、インタフェースの "ifnet" 構造体に IFF_MULTICAST フラグが +設定されている全てのインタフェース (ループバックインタフェースは +除きます) 上で、 +.Nm +に (ブロードキャストの代わりに) +IP マルチキャストを使わせます。マルチキャストによる報告は、 +直接つながっているサブネットへの転送を防ぐために +TTL(Time To Live) 1で送られます。 +.Pp +オプションの +.Ar ttl +引数が +.Fl m +フラグとともに与えられた時には、 +.Nm +は +IP マルチキャストデータグラムを TTL が +.Ar ttl +として、 +全てのインタフェースではなく 1 つのインタフェースに対して送ります。 +.Ar ttl +は 0 から 32 (または、MAX_MULTICAST_SCOPE) までの値です。 +.Fl m Ar 1 +は、 +.Fl m +とは異なることに注意してください。 +.Fl m Ar 1 +は、1 つのインタフェースにだけ転送を行います。 +.Pp +.Fl m +フラグが、 +.Ar ttl +引数無しで使われた場合、プログラムはマルチキャスト +.Nm +報告を全ての +マルチキャストが利用可能なインタフェースから受け取ります。 +.Ar ttl +引数が与えられた場合は、マルチキャストレポートは 1 つのインタフェース +からだけ受け取ります。その 1 つは、報告を行っているものです +(これは、ホストルーティング表によって制御されます)。 +.Fl m +オプション無しでは、プログラムはブロードキャストもしくは +ユニキャストによる報告を全てのインタフェースから受け取ります。 +したがって、このプログラムは、古い報告をマルチキャストを使っていない +.Nm +から受け取り、マルチキャストが使われている場合は古い +.Nm +は +このプログラムによって生成される報告を受け取れないことになります。 +.Pp +サーバは、``rwho'' サービスで指定されているポート番号でメッセージを +送受信します。 +.Xr services 5 +を参照して下さい。送受信するメッセージは以下のような形式です。 +.Bd -literal -offset indent +struct outmp { + char out_line[8]; /* 端末 (tty) 名 */ + char out_name[8]; /* ユーザID */ + long out_time; /* 時刻 */ +}; + +struct whod { + char wd_vers; + char wd_type; + char wd_fill[2]; + int wd_sendtime; + int wd_recvtime; + char wd_hostname[32]; + int wd_loadav[3]; + int wd_boottime; + struct whoent { + struct outmp we_utmp; + int we_idle; + } wd_we[1024 / sizeof (struct whoent)]; +}; +.Ed +.Pp +すべてのフィールドは、送信に先立ってネットワークバイトオーダに変換されます。 +ホスト負荷 (load average) は +.Xr w 1 +によって計算され、送信の 5, 10, 15 分前の負荷を 100 倍した +整数として表現されます。ホスト名は、 +.Xr gethostname 3 +システムコールで得られたものがドメイン名を省略して格納されます。 +メッセージの最後の配列には、メッセージを送信したマシンにログインしている +ユーザの情報が格納されています。この情報は、 +.Xr utmp 5 +の非アイドルの端末ラインのエントリと、その端末ラインから最後に文字を +受け取った時間を秒数で表した値が入っています。 +.Pp +.Nm +サーバによって受信されるメッセージは、 +.Nm +サーバのポートから送信されたものでなければ捨てられます。さらにメッセージ +のホストの名前が表示できない +.Tn ASCII +文字を含んでいる場合も、メッセージは捨てられます。 +.Nm +が受け取った正しいメッセージは +.Pa /var/rwho +ディレクトリに +.Pa whod.hostname +というファイル名で格納されます。これらのファイルには、最新のメッセージ +だけが、上で説明した形式で残っています。 +.Pp +ステータスメッセージはほぼ 3 分ごとに作成されます。 +.Nm +は、30 分ごとに +.Pa /kernel +に対して +.Xr nlist 3 +を実行します。これは、このファイルがその時点での実際のシステムイメージ +であることを確認するためです。 +.Sh 関連項目 +.Xr ruptime 1 , +.Xr rwho 1 +.Sh バグ +ネットワーク間でステータス情報を中継する方法が必要です。 +ステータス情報は、ずっと送りつづけるのではなく、要求があったとき +にだけ送るようにするべきでしょう。サーバが死んでいたり、ネットワークの +通信障害を、マシンがダウンしていると思い込んでしまう場合がよくあります。 +.Sh 歴史 +.Nm +コマンドは +.Bx 4.2 +で登場しました。
\ No newline at end of file diff --git a/ja_JP.eucJP/man/man8/sa.8 b/ja_JP.eucJP/man/man8/sa.8 new file mode 100644 index 0000000000..b2003f3c40 --- /dev/null +++ b/ja_JP.eucJP/man/man8/sa.8 @@ -0,0 +1,230 @@ +.\" +.\" Copyright (c) 1994 Christopher G. Demetriou +.\" 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 Christopher G. Demetriou. +.\" 3. 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: sa.8,v 1.4.2.2 1997/10/16 06:26:03 charnier Exp % +.\" jpman %Id: sa.8,v 1.2 1997/03/31 15:00:26 horikawa Stab % +.\" +.Dd February 25, 1994 +.Dt SA 8 +.Os +.Sh 名称 +.Nm sa +.Nd システムアカウント統計情報を表示する +.Sh 書式 +.Nm sa +.Op Fl abcdDfijkKlmnqrstu +.Op Fl v Ar cutoff +.Op Ar file ... +.Pp +.Sh 解説 +.Nm +は、システムアカウント統計情報の表示と、アカウント情報ファイルの +維持管理を行います。 +.Pp +.Nm +を使えば、 +.Pa /var/account/acct +に含まれる情報を、 +サマリファイル +.Pa /var/account/savacct +と +.Pa /var/account/usracct +に +凝縮して収めることができます。これらのファイルには、コマンド名やユーザ ID +にもとづいたシステムの統計情報が記録されます。これらのサマリファイルは、 +.Pa /var/account/acct +が 1 日に数百ブロックも大きくなるような利用者の多い +システムでは必要になります。 +通常、アカウント情報ファイルの前にサマリファイルを読み込むため、 +レポートには全ての保存されている情報が含まれます。 +.Pp +.Ar file +が与えられると、 +.Pa /var/account/acct +のかわりにそのファイル +が読み込まれます。各ファイルが読み込まれたあと、サマリファイルを更新する +必要があればディスクにセーブされます。最後のファイルが処理されたあと、 +報告が表示されます。 +.Pp +個々のオプションで指定されるものを除いて、以下に示すラベルが出力で使わ +れます。 +.Pp +.Bl -tag -width k*sec +.It avio +実行時の I/O 操作の平均回数 +.It cp +ユーザ時間とシステム時間の合計(単位:分) +.It cpu +.Dv cp +と同じ +.It k +CPU 時間1秒あたりのメモリ使用量(単位:KB) +.It k*sec +CPU 時間で積分したメモリ使用量(単位:1KB秒) +.It re +実時間(単位:分) +.It s +システム時間(単位:分) +.It tio +I/O 操作の合計回数 +.It u +ユーザ時間(単位:分) +.El +.Pp +オプション: +.Bl -tag -width Ds +.It Fl a +全コマンド名を表示します。表示できない文字を含んだコマンドなども含みます +デフォルトでは表示できない文字を含むコマンドは、``***other'' に含まれます。 +.It Fl b +コマンド統計情報を表示する場合、ユーザ時間とシステム時間の合計を +コマンドの呼び出し回数で割った値でソートして表示します。 +.It Fl c +表示される呼び出し回数・実時間・CPU 時間それぞれに関して、コマン +ド全体に対するそのコマンドの割合をパーセンテージ表示します。 +.It Fl d +コマンド統計情報を表示する場合は、ディスク I/O 操作の平均回数でソートします。 +ユーザ統計情報を表示する場合は、各ユーザのコマンドあたりのディスクI/O操作回数を表示します。 +.It Fl D +コマンド統計を表示する場合は、ディスク I/O 操作の合計回数でソートします。 +.It Fl f +.Fl v +を使用する際、ユーザに問い合わせを行いません。 +.It Fl i +サマリファイルを読みません。 +.It Fl j +各コマンドの合計時間(単位:分)の代わりに、 +各コマンドの消費時間(合計時間/呼び出し回数; 単位:秒)を +表示します。 +.It Fl k +コマンド統計情報を表示する場合は、CPU 時間 1 秒あたりのメモリ使用量で +ソートします。ユーザ統計を表示する場合は、 +CPU 時間 1 秒あたりのメモリ使用量を表示します。 +.It Fl K +コマンド統計を表示する場合は、CPU 時間で積分したメモリ使用量を表示し、 +これでソートします。 +.It Fl l +システム時間とユーザ時間を別々に表示します。普通は合計して表示されます。 +.It Fl m +コマンド統計情報のかわりに、ユーザ統計を表示します。 +.It Fl n +呼び出し回数でソートします。 +.It Fl q +エラーメッセージ以外の出力は行いません。 +.It Fl r +逆順でソートします。 +.It Fl s +データをサマリファイルに加えたあと、アカウント情報ファイルを空にします。 +.It Fl t +各コマンドごとに、実時間/CPU 時間(システムとユーザ時間)の値を表示します。 +CPU時間が小さすぎる場合は、``*ignore*'' が表示されます。 +.It Fl u +他のオプションを打ち消して、アカウント情報ファイルからユーザ ID、 +CPU を使用した合計秒数、合計メモリ使用量、I/O 操作回数、コマンド名 +を表示します。 +.It Fl v Ar cutoff +.Pp +.Ar cutoff +時間以下のコマンドについて、 +コマンド名を表示し、 +ユーザに問い合わせを行います。返答として ``y'' で始まる文字列を入力すると、 +そのコマンドは ``**junk**'' に分類されます。このオプションは、報告の +なかから意味のないコマンドを取り除くために使われます。 +.El +.Pp +デフォルトでは、コマンド統計を表示します。 +各行には、コマンドの呼び出し回数、コマンドの経過時間(分)、 +ユーザ時間とシステム時間を合計した CPU 時間、 +平均の I/O 操作回数、CPU 時間 1 秒あたりのメモリ使用量、 +コマンド名が列挙されます。 +.Fl m +が指定された場合は、ユーザ統計を表示します。 +それぞれの行は、各ユーザのユーザ名、コマンド実行回数、 +合計 CPU 時間(分)、合計I/O操作回数、 +CPU 時間で積分したメモリ使用量から構成されています。もし +.Fl u +が指定されると、アカウント情報 +ファイルに記録されている各エントリを表示します。 +各行は、ユーザ ID、CPU 時間(秒)、CPU 時間で積分したメモリ使用量、 +I/O 操作回数、コマンド名から構成されています。 +.Pp +.Fl u +が指定されると、 +.Fl q +を除いて、他のオプションは無視されます。 +.Fl m +が指定されると、 +.Fl b , +.Fl d , +.Fl i , +.Fl k , +.Fl q , +.Fl s +フラグだけが認識されます。 +.Pp +成功した場合は 0 を、エラーが発生した場合は 0 より大きな値を返します。 +.Sh 関連ファイル +.Bl -tag -width /var/account/usracct -compact +.It Pa /var/account/acct +生のアカウント情報ファイル +.It Pa /var/account/savacct +コマンドごとのサマリデータベースファイル +.It Pa /var/account/usracct +ユーザごとのサマリデータベースファイル +.El +.Sh 関連項目 +.Xr lastcomm 1 , +.Xr acct 5 , +.Xr ac 8 , +.Xr accton 8 +.Sh バグ +このプログラムのオプションには不合理なものがいっぱいあります。特に +オプション文字は、機能とあまり関係がありません。 +.Pp +各ラベルにはもっと一貫性があるべきです。 +.Pp +仮想メモリ(VM)システムでは、CPU 時間で積分したメモリの使用量は記録されません。 +.Sh 注意 +この +.Nm +のオプションは、オリジナルの +.Nm +をもとに +していますが、内部的にもですが明らかに外部的にも変更点があります。特に +.Fl q +が追加され、 +.Fl m +は以前よりも多くのオプションが利用可能です。 +.Pp +サマリファイルのフォーマットはオリジナルのもの +から変更されていますが、ユーザ id が 32ビットに +なってアカウントのフォーマットも変更されている +ので、これは問題ありません。 +.Sh 作者 +.An Chris G. Demetriou Aq cgd@postgres.berkeley.edu diff --git a/ja_JP.eucJP/man/man8/savecore.8 b/ja_JP.eucJP/man/man8/savecore.8 new file mode 100644 index 0000000000..85c3127a6e --- /dev/null +++ b/ja_JP.eucJP/man/man8/savecore.8 @@ -0,0 +1,130 @@ +.\" Copyright (c) 1980, 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. +.\" +.\" 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. +.\" +.\" From: @(#)savecore.8 8.1 (Berkeley) 6/5/93 +.\" 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 +.Os BSD 4 +.Sh 名称 +.Nm savecore +.Nd オペレーティングシステムのコアダンプを保存する +.Sh 書式 +.Nm savecore +.Fl c +.Nm savecore +.Op Fl fvz +.Op Fl N Ar system +.Ar directory +.Sh 解説 +.Nm savecore +は現在動作中のカーネルおよびそのコアダンプをディレクトリ +.Fa directory +内にコピーし、 +リブートメッセージとコアダンプ情報をシステムログに書き出します。 +.Pp +オプションは以下の通りです: +.Bl -tag -width directory +.It Fl c +ダンプをクリアし、これ以降起動される +.Nm savecore +でそれが用いられないようにします。 +.It Fl f +ダンプが正しくないと思われる場合や、ディスク容量が不足している場合でも、 +強制的にダンプをとります。 +.It Fl N +( +.Xr getbootfile 3 +で決定される) +動作中のカーネルの代わりに、 +.Ar system +をカーネルとして用います。 +.It Fl v +より詳しいデバッグ情報を出力します。 +.It Fl z +コアダンプとカーネルを圧縮します( +.Xr compress 1 +参照)。 +.El +.Pp +.Nm savecore +は様々な方法を用いてコアダンプが最新であること、 +およびそのコアダンプが現在動作しているシステムに対応するものであることを +確認します。 +このチェックにパスすると、 +.Nm +はコアイメージを +.Ar directory Ns Pa /vmcore.# +に保存し、システムを +.Ar directory Ns Pa /kernel.# +に保存します。 +``#'' はファイル +.Ar directory Ns Pa /bounds +先頭からの行数で、 +.Nm savecore +が正常に実行されるたびにインクリメントされてファイルに書き戻されます。 +.Pp +.Nm savecore +はまた、コピーを作る前にディスク容量が足りているかどうかチェックします。 +.Ar directory +を含むファイルシステムのディスク容量が不足している場合、 +あるいは、 +.Ar directory Ns Pa /minfree +が存在し、ファイル生成後のそのファイルシステムの +(非スーパユーザに対する)残りキロバイト数が +このファイル先頭行の数値より小さい場合、 +コピー作成は試みられません。 +.Pp +.Nm savecore +がカーネルとコアダンプのコピーに成功すると、 +コアダンプはクリアされ、その後の +.Nm savecore +では用いられないようになります。 +.Pp +.Nm savecore +は初期化ファイル +.Pa /etc/rc +の最終段階付近で呼び出されることを想定しています( +.Xr rc 8 +参照)。 +.Sh バグ +minfree コードは圧縮の効果を考慮していません。 +.Sh 関連項目 +.Xr compress 1 , +.Xr getbootfile 3 , +.Xr syslogd 8 +.Sh 歴史 +.Nm +コマンドは +.Bx 4.1 +で登場しました。 diff --git a/ja_JP.eucJP/man/man8/sendmail.8 b/ja_JP.eucJP/man/man8/sendmail.8 new file mode 100644 index 0000000000..b7bdaaa971 --- /dev/null +++ b/ja_JP.eucJP/man/man8/sendmail.8 @@ -0,0 +1,588 @@ +.\" Copyright (c) 1983, 1997 Eric P. Allman +.\" 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. +.\" +.\" 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 +.\" jpman %Id: sendmail.8,v 1.2 1997/06/05 01:31:44 yugawa Stab % +.\" +.Dd February 1, 1997 +.Dt SENDMAIL 8 +.Os BSD 4 +.Sh 名称 +.Nm sendmail +.Nd 電子メール配送デーモン +.Sh 書式 +.Nm sendmail +.Op Ar flags +.Op Ar address ... +.Nm newaliases +.Nm mailq +.Op Fl v +.Sh 解説 +.Nm sendmail +はメッセージを他の人に送ります。必要ならばネットワークを +通してメッセージを正しい場所に転送します。 +.Pp +ただし、 +.Nm sendmail +はユーザインタフェースとして使われることは考慮さ +れていません。ユーザにとって使いやすいフロントエンドは別のプログラムで +提供されます。 +.Nm sendmail +は、あらかじめメールとして整形されたメッセージ +を配送するためだけに使われます。 +.Pp +.Nm sendmail +を引数を指定せずに起動すると、 +.Nm sendmail +は標準入力を EOF +(エンド・オブ・ +ファイル)か `.'だけを含む行まで読み込み、メッセージのなかに記述されている +アドレスにメッセージのコピーを送ります。アドレスの文法や内容にもとづいて +経路に使用するネットワークを決定します。 +.Pp +ローカルアドレスは、ファイルの中を検索して適当なエイリアスを行います。 +先頭にバックスラッシュ `\\' のついたアドレスについては、エイリアスは +行なわれません。 +通常、送り手はエイリアスの対象に含まれません。つまり、もし +`john' が `group' にメールを送って、 `john' が `group' に +含まれている場合、送ったメッセージは `john' には送られません。 +.Ss パラメータ +.Bl -tag -width Fl +.It Fl B Ns Ar type +ボディのタイプを +.Ar type +に設定します。現在有効なのは、 +.Li `7BIT' +か +.Li `8BITMIME' +です。 +.It Fl ba +.Tn ARPANET +モードに移行します。すべての入力行は CR-LF で終わらなければならず、 +すべてのメッセージの末尾には CR-LF がつきます。また、``From:'' と ``Sender:'' +フィールドは送り手の名前としてチェックされます。 +.It Fl bd +デーモンモードで実行します。バークレー +.Tn IPC +が必要です。 +.Nm sendmail +は +.Xr fork 2 +を行い、バックグラウンドで動作し、ソケット番号 25 で +.Tn SMTP +コネクションを +待ちます。通常このモードは、 +.Pa /etc/rc +から実行されています。 +.It Fl bD +フォアグラウンドで動作する以外は +.Fl bd +と同じです。 +.It Fl bh +現在のホストの状況のデータベースを表示します。 +.It Fl bH +現在のホストの状況のデータベースをパージします。 +.It Fl bi +エイリアスデータベースを初期化します。 +.It Fl bm +普通にメールを配送します(デフォルト)。 +.It Fl bp +メールキューのリストを表示します。 +.It Fl bs +標準入出力で +.Tn RFC821 +にもとづいた +.Tn SMTP +プロトコルを使います。この +フラグは、 +.Fl ba +フラグのうち +.Tn SMTP +互換の全ての操作を含みます。 +.It Fl bt +アドレスのテストモードで起動します。このモードは対話 +モードでアドレスを入力し、処理の過程を表示します。設定ファイル +をデバッグするのに使います。 +.It Fl bv +名前のチェックだけを行います。メッセージの収集や配送は行い +ません。ベリファイモードは、ユーザやメーリングリストが有効かどうかを確認する +ために使います。 +.It Fl C Ns Ar file +別の設定ファイルを使います。 +.Nm sendmail +は、別の設定ファイル +を使用する場合は root として実行することはできません。 +.It Fl d Ns Ar X +デバッグ値を +.Ar X +に設定します。 +.ne 1i +.It Fl F Ns Ar fullname +送り手のフルネームを設定します。 +.It Fl f Ns Ar name +``from'' に入る名前(つまり、送り手の名前です)を設定します。 +.Fl f +は、``trusted''なユーザ(普通は +.Em root , +.Em daemon , +.Em network +です)が使うか、 +送り手が自分自身の名前を指定して使う場合のみ指定することができます。 +.It Fl h Ns Ar N +ホップカウントを +.Ar N +に設定します。ホップカウントは、 +メールが処理されるたびに増えていきます。ホップカウントがリミットになった +とき、メールは「エイリアスがループしている」という旨のエラーメッセージと +いっしょに送り返されます。 +もしこのフラグが指定されなければ、メッセージのなかの ``Received:'' 行がカウント +されます。 +.It Fl i +入力されるメッセージ中の `.' だけを含む行を無視します。 +このフラグは、データをファイルから読み込むような場合に使用する必要があります。 +.It Fl N Ar dsn +配送状況の通知条件を +.Ar dsn +に設定します。 +.Ar dsn +には、 +.Ql never +(何も通知しない)または、コンマで区切った、 +.Ql failure +(配送が失敗した場合に通知する) +.Ql delay +(配送が遅れた場合に通知する) +.Ql success +(配送が正常に行われた場合に通知する) +の組合せを指定する事ができます。 +.It Fl n +エイリアスを行いません。 +.It Fl O Ar option Ns = Ns Em value +オプション +.Ar option +を、指定した +.Em value +に設定します。この形式では長いオプション名が使用されます。 +詳しくは後に記述します。 +.It Fl o Ns Ar x Em value +オプション +.Ar x +を、指定した +.Em value +に設定します。 +この形式では、一文字のオプション名しか使用できません。 +短いオプション名についてはこのマニュアルには記述されていません。 +詳しくは、 +.%T "Sendmail Installation and Operation Guide" +を参照して下さい。 +.It Fl p Ns Ar protocol +メッセージを受け取るのに利用するプロトコル名を設定します。 +設定できるのは、 +``UUCP'' のようなプロトコル名だけかプロトコル+ホスト名、たとえば ``UUCP:ucbvax'' +などです。 +.It Fl q Ns Bq Ar time +キューのなかにあるメッセージを処理する間隔を設定します。 +.Ar time +を省略した場合は、キューの内容を一度だけしか処理しません。 +.Ar time +は、 +.Ql s +(秒)、 +.Ql m +(分)、 +.Ql h +(時間)、 +.Ql d +(日)、 +.Ql w +(週)の単位を付けた数字で指定します。 +たとえば、 +.Ql -q1h30m +や +.Ql -q90m +は、タイムアウトを 1 時間 30 分に設定します。 +.Ar time +が指定されると、 +.Nm sendmail +はデーモンとしてバックグラウンドで +実行されます。 +デーモンとして実行させる際には、同時にオプション +.Fl bd +を +つけておくほうが安全です。 +.It Fl qI Ns Ar substr +キュー ID の文字列に +.Ar substr +が含まれるジョブのみを処理します。 +.It Fl qR Ns Ar substr +受信者のリストの文字列に +.Ar substr +が含まれるジョブのみを処理します。 +.It Fl qS Ns Ar substr +送信者の文字列に +.Ar substr +が含まれるジョブのみを処理します。 +.It Fl R Ar return +メッセージがバウンスした時に返送されるメッセージの量を設定します。 +.Ar return +パラメータには、メッセージ全体を返送する場合は +.Ql full +を、ヘッダのみを返送する場合は +.Ql hdrs +を指定します。 +.It Fl r Ns Ar name +.Fl f +フラグと同じですが、古い形式です。 +.It Fl t +受信者をメッセージから読み取ります。To:, Cc:, Bcc: フィールドが受信者 +のアドレスとして読み込まれます。Bcc: フィールドはメッセージの転送前に +削除されます。引数で指定されたアドレスは全て無視されますので、メッセー +ジのヘッダに名前が並べてあっても、引数に指定してあるとメッセージは転送 +されません。 +.It Fl U +最初の(ユーザからの)発送である事を示します。 +このフラグは、 +.Nm Mail +や +.Nm exmh +の様なユーザエージェントから呼び出す場合は +.Em 必ず +指定する必要があり、 +.Nm rmail +等のネットワーク配送エージェントから呼び出す場合は、 +.Em 絶対に +指定してはいけません。 +.It Fl V Ar envid +オリジナルのエンベロープ ID を設定します。 +これは、DSN をサポートするサーバ間では SMTP 上を伝達し、 +DSN に従ったエラーメッセージの中で返送されます。 +.It Fl v +詳細モードに移行します。展開されるエイリアスなどが報告されます。 +.It Fl X Ar logfile +指定された +.Ar logfile +に、メーラに出たり入ったり +するすべてメッセージに関する情報を記録します。メーラをデバッグする際の +最後の手段としてのみ使ってください。非常に大量の情報があっという間に記録 +されます。 +.El +.Ss オプション +.Nm sendmail +には、設定することができる多くの処理オプションがあります。 +通常、これらのオプションはシステム管理者のみが使います。 +オプションは、コマンドラインから +.Fl o +フラグを使って(短いオプション名で)指定したり、 +.Fl O +フラグを使って(長いオプション名で)指定したり、 +設定ファイルから指定することができます。ここに記述して +いるのは部分的なもので、コマンド行から指定する場合に便利な物だけを、 +長いオプション名で示しています。完全なリスト(と詳細)は、 +.%T "Sendmail Installation and Operation Guide" +を参照してください。 +オプションには以下の物があります。 +.Bl -tag -width Fl +.It Li AliasFile= Ns Ar file +別のエイリアスファイルを使います。 +.It Li HoldExpensive +接続するのに時間がかかるホストと接続するときは、 +すぐに接続せず、リクエストはキューに入れられます。 +.It Li CheckpointInterval= Ns Ar N +.Nm sendmail +が、 +.Ar N +個の配送に成功するたびにキューファイルに +チェックポイントを設定します(デフォルトは 10 個です)。これによって、 +システムのクラッシュによって長いメーリングリストの配送が中断 +されたときでも、再開時に同じ人に重複して配送されることを防ぎます。 +.ne 1i +.It Li DeliveryMode= Ns Ar x +配送モードを +.Ar x +に設定します。配送モードには +.Ql i +対話的(同期的)配送モード、 +.Ql b +バックグラウンド(非同期的)配送モード、 +.Ql q +キューモード(実際の配送は、キューが実行されるときに行われる)、 +.Ql d +延期モード(データベースの検索(特に DNS や NIS )が行われない以外は +.Ql q +と同じ)があります。 +.It Li ErrorMode= Ns Ar x +エラー処理をモード +.Ar x +に設定します。 +.Ql m +はエラーメッセージを送り返します。 +.Ql w +はエラーメッセージを送り手のターミナルに書き出します +(送り手がログインしていなければ、メールを返します)。 +.Ql p +は、エラーメッセージを端末に表示します(デフォルト)。 +.Ql q +は、エラーメッセージを捨てます(exit コードだけを返します)。 +.Ql e +は、BerkNet 用に特別処理をします。 +もし、モード +.Ql m +や +.Ql w +を使っている場合に、エラーとなったメッセージが +エラーメールとして送り返されず、送り手が +.Nm sendmail +を実行している +マシン上のユーザならば、 +メッセージのコピーは送り手のホームディレクトリにある +.Pa dead.letter +に追加されます。 +.It Li SaveFromLine +メッセージのはじめに +.Tn UNIX Ns \-style +From 行を残します。 +.It Li MaxHopCount= Ar N +メールがループしていると判断されない、最大のホップ数を +指定します。 +.It Li IgnoreDots +`.' だけを含む行をメッセージの終わりとして解釈しません。 +.It Li SendMimeErrors +エラーメッセージをMIMEフォーマットで送り返します。 +設定されていない場合は、DSN (Delivery Status Notification: 配送状況通知) SMTP +拡張は無効になります。 +.It Li ConnectionCacheTimeout= Ns Ar timeout +コネクションキャッシュの +.Ar timeout +を設定します。 +.It Li ConnectionCacheSize= Ns Ar N +コネクションキャッシュのサイズを +.Ar N +に設定します。 +.It Li LogLevel= Ns Ar n +ログレベルを +.Ar n +にします。 +.It Li MeToo +エイリアスに自分自身が含まれている場合、``me''(送り手自身)にも送ります。 +.It Li CheckAliases +.Xr newaliases 1 +コマンドの実行の際、 +エイリアスの右側の項目(エイリアスの値)を有効性をチェックします。 +.It Li OldStyleHeaders +もしオプションが設定されていれば、メッセージが古いスタイルのヘッダ +を持つことがあることを意味します。 +このオプションが設定されていなければ、このメッセージが新しい +スタイルを持っていることが保証されます(2 つのアドレスの間はスペースのかわり +にカンマで区切られます)。このオプションが設定されていると、大抵の場合、 +ヘッダのフォーマットを正しく決定するためのアルゴリズムが用いられます。 +.It Li QueueDirectory= Ns Ar queuedir +キューメッセージを保存するディレクトリを選択します。 +.It Li StatusFile= Ns Ar file +指定した名前のファイルに統計情報をセーブします。 +.It Li Timeout.queuereturn= Ns Ar time +キューのなかの配送されなかったメッセージのタイムアウト時間を設定します。 +この時間内に(ホストのダウンなどにより)配送が行われなかったときには、 +失敗した旨のメッセージが送り返されます。デフォルトは 5 日です。 +.It Li UserDatabaseSpec= Ns Ar userdatabase +このオプションが設定されると、情報を送る際にユーザデータ +ベースに対する問い合わせが行われます。 +この方法をエイリアス機構の補助として使用する事ができます。ただし、 +エイリアスはそのホストローカルでのみ有効なので、データベースが意図的に +分散されている場合は使用できません。 +.Nm sendmail +が +.Dv USERDB +付きでコンパイルされていなければ使うことはできません。 +.It Li ForkEachJob +キューを処理する間、 +.Xr fork 2 +を行います。メモリが少ないマシン +では便利です。 +.It Li SevenBitInput +到着するメッセージを 7 ビットにします (8 ビット目は落します)。 +.It Li EightBitMode= Ns Ar mode +8 ビットの入力を 7 ビットの宛先へ送る場合の処理方法を +.Ar mode +に設定します。 +処理方法には、 +.Li m +(mime 化) 7 ビット MIME 形式へ変換、 +.Li p +(パス) 8 ビットのまま配送(プロトコルには違反します)、 +.Li s +(厳密) メッセージをバウンス、 +があります。 +.It Li MinQueueAge= Ns Ar timeout +配送の試行の間、ジョブがキューに蓄積される時間を設定します。 +.It Li DefaultCharSet= Ns Ar charset +特に指定されていない場合に、8 ビットのデータである事を示す +ラベルとして使用されるデフォルトのキャラクタを設定します。 +.It Li DialDelay= Ns Ar sleeptime +コネクションの確立が失敗した場合に、再試行までに +.Ar sleeptime +だけスリープします。オンデマンドでダイアル接続するサイトでの使用に便利です。 +.It Li NoRecipientAction= Ns Ar action +受信者ヘッダ (To: Cc: あるいは Bcc:) がない場合の動作を +.Ar action +に設定します。 +.Li none +メッセージを変更しない、 +.Li add-to +To: ヘッダにエンベロープで指定された受信者を加える、 +.Li add-apparrently-to +Apparrently-To: ヘッダにエンベロープで指定された受信者を加える、 +.Li add-bcc +空の Bcc: ヘッダを加える、 +.Li add-to-undisclosed +.Ql "To: undisclosed-recipients:;" +というヘッダを加える、という動作が指定できます。 +.It Li MaxDaemonChildren= Ns Ar N +待ち受け SMTP デーモンが同時に動作できる子プロセスの最大数を +.Ar N +に設定します。 +.It Li ConnectionRateThrottle= Ns Ar N +SMTP ポートへの 1 秒当りの最大コネクション数を +.Ar N +に設定します。 +.El +.Pp +エイリアスのなかで最初の文字が `|' で始まるものは、メールの内容をパイプで +コマンドに送るものと解釈されます。引数などをつけるために空白文字が +必要な場合はクォートする (" でくくる)必要があります。以下に、例を示します: +.Pp +.Bd -literal -offset indent -compact +msgs: "|/usr/bin/msgs -s" +.Ed +.Pp +エイリアスには、 +.Dq :include: Ns Ar filename +という文法もあります。 +.Nm sendmail +は、 +メールの受け手のエイリアスとして、指定されたファイルを読みます。 +以下に、例を示します: +.Pp +.Bd -literal -offset indent -compact +poets: ":include:/usr/local/lib/poets.list" +.Ed +.Pp +上記の例の場合は、 +.Pa /usr/local/lib/poets.list +を読み、`poets' のグループの +ためのアドレスリストを作ります。 +.Pp +.Nm sendmail +は、以下に示すような終了コードを返します。これらの +コードは、 +.Aq Pa sysexits.h +に定義されています。 +.Bl -tag -width EX_UNAVAILABLE -compact -offset indent +.It Dv EX_OK +すべてのアドレスについて完全に成功しました。 +.It Dv EX_NOUSER +ユーザ名が認識できません。 +.It Dv EX_UNAVAILABLE +処理に必要なリソースを得ることができません。 +.It Dv EX_SYNTAX +アドレスに文法的な間違いがあります。 +.It Dv EX_SOFTWARE +引数が間違っている等の、内部的なエラーです。 +.It Dv EX_OSERR +.Dq cannot fork +のような、一時的な OS エラーです。 +.It Dv EX_NOHOST +ホスト名が認識できません。 +.It Dv EX_TEMPFAIL +メッセージはすぐには送られませんでしたが、 +キューには入れられました。 +.El +.Pp +.Nm newaliases +というコマンドで実行されると、 +.Nm sendmail +はエイリアス +データベースを再構築します。 +.Nm mailq +というコマンドで実行されると、 +.Nm sendmail +はメールキューの内容を表示します。 +.Sh 関連ファイル +.Pa /etc/sendmail.cf +を除き、以下のファイルのパスはすべて +.Pa /etc/sendmail.cf +内部で決められています。以下は一例に過ぎません。 +.Pp +.Bl -tag -width /usr/lib/sendmail.fc -compact +.It Pa /etc/aliases +エイリアス名の生データ +.It Pa /etc/aliases.db +エイリアス名のデータベース +.It Pa /etc/sendmail.cf +設定ファイル +.It Pa /usr/share/misc/sendmail.hf +ヘルプファイル +.It Pa /var/log/sendmail.st +統計情報ファイル +.It Pa /var/spool/mqueue/* +テンポラリファイル +.It Pa /var/run/sendmail.pid +デーモンのプロセス ID を格納しているファイル +.El +.Sh 関連項目 +.Xr mail 1 , +.Xr syslog 3 , +.Xr aliases 5 , +.Xr mailaddr 7 , +.Xr mail.local 8 , +.Xr rc 8 , +.Xr rmail 8 ; +.Pp +DARPA +Internet Request For Comments +.%T RFC819 , +.%T RFC821 , +.%T RFC822 . +.Rs +.%T "Sendmail \- An Internetwork Mail Router" +.%V SMM +.%N \&No. 9 +.Re +.Rs +.%T "Sendmail Installation and Operation Guide" +.%V SMM +.%N \&No. 8 +.Re +.Sh 歴史 +.Nm +コマンドは +.Bx 4.2 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/showmount.8 b/ja_JP.eucJP/man/man8/showmount.8 new file mode 100644 index 0000000000..a5e23c50df --- /dev/null +++ b/ja_JP.eucJP/man/man8/showmount.8 @@ -0,0 +1,94 @@ +.\" Copyright (c) 1989, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" This code is derived from software contributed to Berkeley by +.\" Rick Macklem at The University of Guelph. +.\" +.\" 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. +.\" +.\" 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. +.\" +.\" @(#)showmount.8 8.3 (Berkeley) 3/29/95 +.\" jpman %Id: showmount.8,v 1.2 1997/05/03 13:44:20 horikawa Stab % +.\" +.Dd March 29, 1995 +.Dt SHOWMOUNT 8 +.Os BSD 4 +.Sh 名称 +.Nm showmount +.Nd NFS サーバに対する現在のリモート NFS マウントを表示する +.Sh 書式 +.Nm showmount +.Op Fl ade3 +.Op Ar host +.Sh 解説 +.Nm +は、ホスト +.Ar host +上の +.Tn NFS +サーバの情報を表示します。 +デフォルトでは、そのホストの +.Tn NFS +ファイルシステムをマウントしているすべての +クライアントのホスト名を表示します。プロトコルの詳細については、RFC1094, +.%T "NFS: Network File System Protocol Specification" +の Appendix A と、 +.%T "NFS: Network File System Version 3 Protocol Specification" +の Appendix I を参照してください。 +.Bl -tag -width Ds +.It Fl a +以下のような形ですべてのマウントポイントを表示します: +.Bd -ragged -offset indent -compact +.Ar host : Ns Ar dirpath +.Ed +.It Fl d +クライアントのホスト名のかわりに、 +マウントポイントのディレクトリパスを表示します。 +.It Fl e +指定した +.Ar host +の公開設定 (NFS エクスポート) しているファイルシステムを表示します。 +.It Fl 3 +NFS バージョン 3 と互換性のある、マウントプロトコルバージョン 3 を使用します。 +.El +.Sh 関連項目 +.Xr mount 8 , +.Xr mountd 8 +.Sh バグ +.Tn NFS +サーバはステートレス (クライアントの状態を持たない) なので、 +サーバ上で実行しているマウントデーモンが分かるのは、 +実際にマウントされているものだけです。 +.Nm +は、マウントデーモンが報告するのと同じ程度の正確さでしか +情報を表示しません。 +.Sh 歴史 +.Nm showmount +ユーティリティは +.Bx 4.4 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/shutdown.8 b/ja_JP.eucJP/man/man8/shutdown.8 new file mode 100644 index 0000000000..85c8681fd6 --- /dev/null +++ b/ja_JP.eucJP/man/man8/shutdown.8 @@ -0,0 +1,133 @@ +.\" 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. +.\" +.\" 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. +.\" +.\" @(#)shutdown.8 8.1 (Berkeley) 6/5/93 +.\" jpman %Id: shutdown.8,v 1.2 1997/05/13 00:55:09 mutoh Stab % +.\" +.Dd June 5, 1993 +.Dt SHUTDOWN 8 +.Os BSD 4 +.Sh 名称 +.Nm shutdown +.Nd 指定時間後にシステムを停止する +.Sh 書式 +.Nm shutdown +.Op Fl +.Op Fl hkrn +.Ar time +.Op Ar warning-message ... +.Sh 解説 +.Nm shutdown +は、ユーザにシステムがシャットダウンされる時にユーザに知らせ、 +システム管理者やハッカーやグルのようなたの人を面倒がらせないように +します。 +.Pp +オプションとしては以下のものがあります。 +.Bl -tag -width time +.It Fl h +.Ar time +で指定された時間に +.Xr halt 8 +を実行し、システムを停止します。 +.It Fl k +実際にはシステムを停止しませんが、 +スーパーユーザ以外のユーザをログインできなくします。 +.It Fl n +停止する前に +.Xr sync 2 +を実行しません。 +.It Fl r +.Ar time +で指定された時間に +.Xr reboot 8 +を実行し、システムを再起動します。 +.It Ar time +.Nm shutdown +がシステムを停止させる時間を指定します。 +.Ar now +を指定すると即時にシステムを停止します。 +また、時間を指定する次の二つの書式があります。 +.Ar +number +もしくは +.Ar yymmddhhmm +の形式で指定します。現在のシステムの年・月・日の値がデフォルトになっています。 +一つめの書式は +.Ar number +分経過後をあらわし、二つめの書式は停止する時刻を直接指定します。 +.It Ar warning-message +その他の引数は現在ログイン中のユーザに送る警告メッセージとして扱われます。 +.It Fl +もし +.Ql Fl +がオプションとして与えられると、警告メッセージを標準入力から読み取ります。 +.El +.Pp +システム停止の 10 時間前から、ログイン中の全てのユーザーの端末に +警告メッセージが表示されはじめ、停止が近付くにつれ頻繁になってきます。 +システム停止の 5 分前、もしくは 5 分以内にシステム停止する場合には、 +ただちに警告メッセージをコピーした +.Pa /etc/nologin +が作られログインが禁止されます。 +ユーザがログインしようとした際にこのファイルが存在する場合には、 +.Xr login 1 +はその内容を表示し終了します。このファイルは +.Nm shutdown +が終了する際に削除されます。 +.Pp +システム停止時には、システムを停止した時間、実行者、理由が +システムログに記録されます。その後、terminate シグナルが +.Xr init +に送られ、システムをシングルユーザ状態にします(この動作は上記の +オプションに依存します)。 +システムを停止する時間と警告メッセージは +.Pa /etc/nologin +に置かれます。これをユーザにシステムを再開する時間や、なぜシステムを +停止するかなどを知らせるために使うべきです。 +.Sh 関連ファイル +.Bl -tag -width /etc/nologin -compact +.It Pa /etc/nologin +login に誰にもログインさせないことを知らせます。 +.El +.Sh 関連項目 +.Xr login 1 , +.Xr wall 1 , +.Xr nologin 5 , +.Xr halt 8 , +.Xr reboot 8 +.Bd -literal -offset indent +.Sh 下位互換性 +下位互換性のため、二つめの書式で時と分をコロン(``:'')で区切ることができます。 +.Ed +.Sh 歴史 +.Nm +コマンドは +.Bx 4.0 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/sicontrol.8 b/ja_JP.eucJP/man/man8/sicontrol.8 new file mode 100644 index 0000000000..e016ba73d5 --- /dev/null +++ b/ja_JP.eucJP/man/man8/sicontrol.8 @@ -0,0 +1,115 @@ +.\" %Id: sicontrol.8,v 1.3.2.2 1997/10/16 06:28:03 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 +.Dt SICONTROL 8 +.Os FreeBSD +.Sh 名称 +.Nm sicontrol +.Nd Specialix 社 SI/XIO ドライバの設定とデバッグ +.Sh 書式 +.Nm sicontrol +device +.Ar command Op Cm Ar param ... +.Sh 解説 +.Nm sicontrol +は SI/XIO デバイスドライバの設定やモニタリングをおこなうために使用します。 +.Pp +.Nm sicontrol +は +.Ar device +で指定されたポートを操作します。 +.Pp +ドライバ全体の設定をおこなう際には、特別なデバイス名 `-' を +.Ar device +に指定します。 +.Pp +必要であれば、デバイス名には '/dev/' が補完されます。 +.Pp +以下のコマンドはドライバ全体の設定をおこなうので、 +デバイス名に '-' を指定する必要があります。 +.Bl -tag -width 4n +.It Cm int_throttle Op Cm value +「総合割り込みスロットル値」を設定します。 +ホストアダプタ割り込みの 1 秒あたりの最大値は次のようにして求められます: +.Pp +.Ar "controller CPU clock / (8 * int_throttle)" +.Pp +ブート時のデフォルト値は 25000 で、ホストアダプタの CPU クロックは +25MHz ですから、この場合の最大割り込みレートは約 125 回/秒になります。 +.Pp +この値を下げると、ホストアダプタがオペレーティングシステムに +処理を要求するための割り込みのレートを増加させることができます。 +.\" +.It Cm rxint_throttle Op Cm value +受信割り込みスロットル値を設定します。 +ブート時のデフォルト値は 4 で、割り込みレートは約 25 回/秒になります。 +.Pp +この値を下げると、ホストアダプタがオペレーティングシステムに受信 FIFO を +空にするよう要求する割り込みのレートを増加させることができます。 +.\" +.It Cm nport +そのデバイスドライバの制御下にあるシリアルポートの数を返します。 +.El +.Pp +以下のコマンドは個々のシリアルポートに対して実行されるため、 +.Pa /dev +以下のデバイス名を指定する必要があります。 +.Bl -tag -width 4n +.It Cm mstate +モデムが駆動する制御信号の、現在の状態を表示します。 +.It Cm ccbstat +指定されたシリアルポートの "ccb" 構造体の、現在の内容を表示します。 +これはドライバのデバッグや、シリアルポートが反応しない原因の調査以外には、 +あまり使い道がありません。 +.It Cm ttystat +指定されたシリアルポートに関するカーネル内部の "tty" 構造体の現在の内容を +表示します。これはドライバのデバッグ以外には、あまり使い道がありません。 +.El +.\" The following requests should be uncommented and used where appropriate. +.\" This next request is for sections 2 and 3 function return values only. +.\" .Sh RETURN VALUES +.\" This next request is for sections 1, 6, 7 & 8 only +.\" .Sh ENVIRONMENT +.Sh 関連ファイル +.Bl -tag -width /dev/si_control -compact +.It Pa /dev/si_control +.Xr sicontrol 8 +で使用される、ドライバ全体の制御ファイル +.It Pa /dev/ttyA* +ターミナル制御ポート +.It Pa /dev/ttyiA* +.Xr stty 1 +で使用される、初期 termios ステートデバイス +.It Pa /dev/ttylA* +.Xr stty 1 +で使用される、ロックされた termios ステートデバイス +.El +.\" .Sh EXAMPLES +.\" This next request is for sections 1, 6, 7 & 8 only +.\" (command return values (to shell) and fprintf/stderr type diagnostics) +.Sh 診断 +一般に自明です..... +.\" The next request is for sections 2 and 3 error and signal handling only. +.\" .Sh ERRORS +.Sh 関連項目 +.Xr stty 1 , +.Xr si 4 , +.Xr termios 4 , +.Xr tty 4 , +.Xr comcontrol 8 . +.\" .Sh STANDARDS +.Sh 歴史 +.Nm sicontrol +は +.An Andy Rutter Aq andy@acronym.co.uk +によって書かれた +.Nm siconfig +ユーティリティを基にしている部分が多少あります。 +.Pp +Specialix International 社は、このデバイスドライバに関して、 +いかなる形のサポートもおこないません。 +.Sh 作者 +Peter Wemm <peter@freebsd.org> +.Sh バグ +たくさんあるでしょう... :-) diff --git a/ja_JP.eucJP/man/man8/slattach.8 b/ja_JP.eucJP/man/man8/slattach.8 new file mode 100644 index 0000000000..31fded1eaf --- /dev/null +++ b/ja_JP.eucJP/man/man8/slattach.8 @@ -0,0 +1,260 @@ +.\" Copyright (c) 1986, 1991 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. +.\" +.\" 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. +.\" +.\" @(#)slattach.8 6.4 (Berkeley) 3/16/91 +.\" jpman %Id: slattach.8,v 1.2 1997/05/19 05:35:41 mitchy Stab % +.\" +.\" %Header: /home/ncvs/src/sbin/slattach/slattach.8,v 1.11.2.2 1997/09/14 19:50:34 jkh Exp % +.\" +.Dd April 4, 1993 +.Dt SLATTACH 8 +.Os BSD 4.3 +.Sh 名称 +.Nm slattach +.Nd シリアルラインをネットワークインターフェースに割り当てる +.Sh 書式 +.Nm slattach +.Op Fl a +.Op Fl c +.Op Fl e Ar exit-command +.Op Fl f +.Op Fl h +.Op Fl l +.Op Fl n +.Op Fl z +.Op Fl L +.Op Fl r Ar redial-command +.Op Fl s Ar baudrate +.Op Fl u Ar unit-command +.Op Fl K Ar keepalive +.Op Fl O Ar outfill +.Op Fl S Ar unit +.Ar ttyname +.Sh 解説 +.Nm slattach +は、シリアルポートをネットワークインタフェースに割り当て自分と相手の +アドレスを定義するために使用されます。 +.Nm slattach +の、オプションは以下のとおりです: +.Bl -tag -width Ar +.It Fl a +VJ ヘッダ圧縮を自動許可します。 +リンクの相手が VJ ヘッダ圧縮可能な時これを使用し、そうでなければ +標準ヘッダを使用します。 +.It Fl c +VJ ヘッダ圧縮を指定します。リンクの両端が VJ ヘッダ圧縮を使用できなければ +ならないことに注意してください。 +.It Fl e Ar exit-command +.Nm slattach +が終了する前にシェルで +.Ql sh \-c Ar exit-command +のように呼び出されるコマンドを指定します。 +.It Fl f +.Nm slattach +をバックグラウンドで動かすための daemon() の呼び出しを行いません。 +.It Fl h +cts/rts によるシリアルのフロー制御を有効にします。無指定時には、 +フロー制御はサポートされません。 +.It Fl l +slip ポートのモデム制御 (CLOCAL) を無効にしキャリア検出を無視します。 +無指定時には、キャリアが落ちた時に +.Ar redial-command +を呼び出しますが、 +.Ar redial-command +が指定されていなければ +.Nm slattach +は終了します。 +.It Fl n +ICMP パケットを捨てます。 slip インターフェースは +ICMP レスポンスによるシリアルラインの遅延を防止するよう +ICMP パケットを無視します。 +.It Fl r Ar redial-command +シリアルラインのキャリアが失われた時にシェルで +.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> +が実行されます。 +.Ar <old> +と +.Ar <new> +はそれぞれ slip の最後にオープンされた時のユニット番号と現在のコネクションの +ユニット番号です。 +このユニット番号は 2 つ以上の slip ラインを使用すればリダイアル後に +変更することが出来ます。 +接続が切れたとき、 +.Nm slattach +は、 +.Ql Nm "sh -c" Ar unit-command <old> Nm \-1 +を実行します。 +.Nm slattach +は、ユニット番号が変更され +.Ql Fl u Ar \%unit-command +が指定されないとき終了します。 +.It Fl z +開始時にキャリアにかかわり無く +.Ar redial-command +のリダイアルを行います。 +.It Fl L +uucp方式のデバイスロックを行います。 +他の uucp ロックを行うプログラムから +.Nm slattach +を開始する場合以外は、このオプションが必要です。 +デフォルトではそのようなプログラムの使用を考え uucp ロックをしません。 +.It Fl K Ar keepalive +SLIP "keep alive" タイムアウト時間を秒単位で設定します。 +FRAME_END がこの時間内に受信できない時、再接続が行われます。 +省略時はタイムアウトは設定されません。 +.It Fl O Ar outfill +SLIP "out fill" タイムアウト時間を秒単位で設定します。 +これにより、相手側の "keep alive" タイムアウトに必要な +FRAME_END をこの時間内に送信します。 +省略時はタイムアウトは設定されません。 +.It Fl S Ar unit +SLIP ユニット番号を直接指定します。 +2 つのインターフェースが同じユニット番号にならないかチェックをしないので、 +注意が必要です。 +省略時は動的にユニット番号を割り当てます。 +.It Ar ttyname +ttyデバイスの名前を指定します。 +.Ar ttyname +は +.Ql ttyXX +か +.Ql /dev/ttyXX +の形式で記述します。 +.El +.Pp +本コマンドを用いてシリアルポートをネットワークインターフェースに +割り当てることが出来るのはスーパーユーザに限られます。 +.Pp +ネットワークインターフェースの割り当てを解除する場合は、 +.Nm slattach +プロセスを +.Ql kill -INT +を使って kill した後に +.Dq Li ifconfig interface-name down +を実行してください。 +.Ar Interface-name +は +.Xr netstat 1 +で見ることが出来ます。 +.Pp +.Nm slattach +をキャリアを失った時にリダイアルするように設定するには、 +.Fl r Ar redial-command +オプションを使って slip サーバに再接続するスクリプトかコマンドを指定 +します。スクリプトはサーバにリダイアルしログインするようなものです。 +.Pp +slipユニット番号が変わった時にネットワークインターフェースを再構成するには、 +.Fl u Ar unit-command +オプションを使用して +.Ql sh \-c Ar unit-command old new +のように呼び出す、スクリプトかコマンドを指定します。 +.Ar old +と +.Ar new +は再接続前後の slip ユニット番号です。 +同時に 2 つ以上のラインが切断されているときユニット番号が変わる可能性 +があります。 +最初の再接続に成功した slip が一番小さいユニット番号を得られます。 +.Pp +.Nm slattach +を kill するには、 tty をクローズしてから終了するように +.Ql kill -INT +(SIGINT)を使用します。 +.Pp +強制的にリダイアルするには、 +.Ql kill -HUP +を使用し +.Nm slattach +がキャリアを失ったように思わせて +.Ql sh \-c Ar redial-command +でサーバに再接続させます。 +.Pp +.Nm slattach +をモデム経由でなく直結で使用する場合、 slip ラインのキャリアを無視するために +.Fl l +オプション付きで実行します。 +.Sh 使用例 +.Bd -literal -offset indent -compact +slattach ttyd8 +slattach \-s 4800 /dev/ttyd1 +slattach \-c \-s 38400 /dev/cuaa1 +slattach \-r 'kermit -y dial.script >kermit.log 2>&1' +.Ed +.Sh 診断 +.Nm slattach +がデーモンの時のエラーメッセージは /var/log/messages にあります。 +指定したネットワークインターフェースが終了しない、 +要求されたアドレスがみつからない、権限のないユーザが +ネットワークインターフェースの設定を変更しようとした、というメッセージは +ここに記録されます。 +.Nm slattach +は端末の制御の設定の失敗や、 +シグナルハンドラの登録の失敗も記録します。 +コネクション開始時とリダイアル時に tty 名と回線速度が記録され、 +終了時に tty 名が記録されます。 +.Pp +.Sh 関連ファイル +.Pa /var/run/slattach.<tty>.pid +.Pp +この +.Ar tty +は +.Ar tty 名 +に置き換えられます。 +このファイルには +.Nm slattach +のプロセス番号が含まれ、 +.Nm slattach +にシグナルを送るスクリプトで確かめることができます。 +.Sh 関連項目 +.Xr netstat 1 , +.Xr startslip 1 , +.Xr uustat 1, +.Xr netintro 4 , +.Xr ifconfig 8 , +.Xr rc 8 , +.Xr sliplogin 8 +.Sh 歴史 +.Nm +は +.Bx 4.3 +ではじめて登場しました。 diff --git a/ja_JP.eucJP/man/man8/sliplogin.8 b/ja_JP.eucJP/man/man8/sliplogin.8 new file mode 100644 index 0000000000..21580e17cc --- /dev/null +++ b/ja_JP.eucJP/man/man8/sliplogin.8 @@ -0,0 +1,287 @@ +.\" Copyright (c) 1990, 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. +.\" +.\" 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. +.\" +.\" @(#)sliplogin.8 8.2 (Berkeley) 1/5/94 +.\" jpman %Id: sliplogin.8,v 1.3 1997/07/26 22:10:08 horikawa Stab % +.\" +.Dd January 5, 1994 +.Dt SLIPLOGIN 8 +.Os +.Sh 名称 +.Nm sliplogin +.Nd シリアル回線とネットワークインタフェースの対応づけ(アタッチ)を行う +.Sh 書式 +.Nm +.Op Ar loginname Op Ar device +.Sh 解説 +.Nm +は、標準入力 (もしくは、 +.Ar device ) +の tty 回線を用いて他のホストと Serial Line IP +.Pq Tn SLIP +による接続を確立するためのコマンドです。 +そのために、まず +.Pa /etc/sliphome/slip.hosts +ファイルを検索し、引数 +.Ar loginname +と一致するエントリを引き出します。 +(ログイン名が省略された場合、コマンドを起動したユーザのログイン名が用い +られます) +ログイン名と一致するエントリが見つかった場合、回線は SLIP に適した設定 +(8ビット透過な入出力) にされ、オプションの回線パラメータを使って +.Tn SLIP +回線に変換されます。 +.Pp +回線パラメータのオプションは次のとおりです: +.Sq normal , +.Sq compress , +.Sq noicmp , +.Sq autocomp +これらはそれぞれ、 +.Sq 通常の設定 (ヘッダ圧縮をしない) +、 +.Sq VJヘッダ圧縮を行う +、 +.Sq ICMP パケットを無視する +、 +.Sq VJヘッダ圧縮を自動設定する (相手がサポートしているときのみヘッダ圧縮する) +です。 +.Pp +その後、 +.Tn IP +アドレスやネットマスクなどの設定を行なう、 +SLIP インタフェース初期化のためのシェルスクリプトが実行され +ます。 +.Pp +通常、初期化のためのシェルスクリプトファイルは +.Pa /etc/sliphome/slip.login +ですが、特定のホスト向けの設定のために、 +.Pa /etc/sliphome/slip.login. Ns Ar loginname +というシェルスクリプトファイルがあった場合は、そちらが実行されます。 +スクリプトは、以下のパラメータとともに起動されます。 +.Bl -tag -width slipunit +.It Em slipunit +回線に割り当てられる SLIP インタフェースです。例えば、 +.Sy 0 +の場合、割り当てられる SLIP インタフェースは +.Sy sl0 +です。 +.It Em speed +回線速度です。 +.It Em args +.Ar loginname +を指定して起動する場合、 +.Pa /etc/sliphome/slip.hosts +の対応エントリに記述されている引数です。 +.El +.Pp +スーパユーザのみが、ネットワークインタフェースのアタッチを行うことが +出来ます。ネットワークインタフェースは、リモートホスト側でハングアップす +るか、ローカルホスト側の +.Nm +プロセスが終了した場合には自動的に対応づけが解消 (デタッチ) されます。 +カーネル SLIP モジュールが設定されていた場合、このインタフェースを経由 +して設定されている全ての経路は、同時に消滅します。 +他の処理も行いたいサイトでは、回線の切断時に +.Pa /etc/sliphome/slip.logout +ファイルもしくは +.Pa /etc/sliphome/slip.logout. Ns Ar loginname +ファイルが有ればその内容が実行されますので、これを使って下さい。 +起動時には、ログインスクリプトと同じ引数が与えられます。 +.Ss /etc/sliphome/slip.hosts の書式 +コメント (`#' で開始する行) および空白行 (もしくは空白で開始する行) は +無視されます。 +他の行は、 +.Ar loginname +で始まる必要があります。 +しかし、他の引数については、そのログイン名に対応して実行される +.Pa slip.login +ファイルに応じたものであれば、何でもかまいません。 +引数は、スペースやタブで区切り、 +.Xr sh 1 +が解釈出来るクォートなどを用いてまとめます(ただし +.Ar loginname +はクォートできません)。 +通常、各行は以下の形式で記述されます: +.Bd -literal -offset indent +loginname local-address remote-address netmask opt-args +.Ed +.Pp +.Em local-address +と +.Em remote-address +については、互いに接続される SLIP インタフェースに割り当てられる IP アドレスを +(ホスト名か数字で) 設定します。そして、 +.Em netmask +については、適切な IP ネットマスクを設定します。これらの引数は、直接 +.Xr ifconfig 8 +に渡されます。 +.Em opt-args +は、オプション引数であり、回線の設定に用いられます。 +.Pp +.Sh FreeBSD での追加 +追加の SLIP 設定用ファイル +.Pa /etc/sliphome/slip.slparms +があるかもしれません。 +特定のホストに異なる設定が必要である場合、 +ファイル +.Pa /etc/sliphome/slip.slparms. Ns Ar loginname +が存在すれば、代わりに使われます。 +.Ss /etc/sliphome/slip.slparms* の書式 +コメント (`#' で開始する行) および空白行 (もしくは空白で開始する行) は +無視されます。 +このファイルには空白で区切られた 1 から 3 個の数字を書きます。 +数字は順に、 +.Ar keepalive , +.Ar outfill , +.Ar slunit +を意味します。 +.Bl -tag -width keepalive +.It Ar keepalive +SLIP "keep alive" タイムアウト時間を秒単位で設定します。 +FRAME_END がこの時間内に受信できない時、 +.Nm +は回線を閉じて終了します。 +省略時はタイムアウトは設定されません ( 0 です)。 +.It Ar outfill +SLIP "out fill" タイムアウト時間を秒単位で設定します。 +これにより、相手側の "keep alive" タイムアウトに必要な +FRAME_END をこの時間内に送信します。 +省略時はタイムアウトは設定されません ( 0 です)。 +.It Ar slunit +SLIP ユニット番号を直接指定します。 +2 つのインターフェースが同じユニット番号にならないかチェックをしないので、 +注意が必要です。 +省略時は動的にユニット番号を割り当てます。 +.El +.Pp +あとの 2 つのパラメータが省略されたときは、これに対応する SLIP の設定には影響が +ありません。最初の 2 つのパラメータが 0 であるときにも、これに対応する設定に +影響しません。 +.Sh 使用例 +通常、 +.Nm +を使う場合、 +リモートの SLIP サイトごとに +.Nm +をシェルフィールドに持つ +.Pa /etc/passwd +のエントリを作ります。例えば +.Bd -literal +Sfoo:ikhuy6:2010:1:slip line to foo:/tmp:/usr/sbin/sliplogin +.Ed +.Pp +(ここでは、リモートホスト +.Ar hostname +のアカウント名を +.Em Shostname +としています) +次に、 +.Pa slip.hosts +に、以下のようなエントリを追加します: +.Pp +.Bd -literal -offset indent -compact +Sfoo `hostname` foo netmask +.Ed +.Pp +ここで、 +.Em `hostname` +は、 +.Xr sh +によって評価されローカルホスト名となり、 +.Em netmask +はローカルホストの IP ネットマスクです。 +.Pp +注意事項があります。 +.Nm +は、root に setuid しなければなりません。 +セキュリティホールではありませんが、心がけの悪い奴が +.Nm +をつかって端末の回線を使えなくしたり、リモートの SLIP サイトのユーザの +アクセスを不可能にしたりすることができます。これを防ぐために、 +.Nm +をユーザ +.Em root +グループ +.Em network +モード 4550 でインストールし、グループ +.Em network +のメンバのみが +.Nm +を実行可能とします。システム管理者は、 +正当なユーザが正しいグループのメンバであることを確認すべきです。 +.Sh 診断 +.Nm +は、様々な情報を +.Em daemon +の facility コードでシステムログデーモン +.Xr syslogd 8 +を通じて、 syslog に書き出します。 +以下に問題の大きさ別にメッセージを列挙します。 +.Pp +.Sy エラー +.Bl -tag -width Ds -compact +.It Sy ioctl (TCGETS): Em 理由 +.Dv TCGETS +.Fn ioctl +を用いた回線のパラメータ取得が失敗しました。 +.Pp +.It Sy ioctl (TCSETS): Em 理由 +.Dv TCSETS +.Fn ioctl +を用いた回線のパラメータ設定が失敗しました。 +.Pp +.It Sy /etc/sliphome/slip.hosts: Em 理由 +.Pa /etc/sliphome/slip.hosts +ファイルがオープン出来ません。 +.Pp +.It Sy access denied for Em user +.Em user +エントリが +.Pa /etc/sliphome/slip.hosts +にありません。 +.El +.Pp +.Sy 報告 +.Bl -tag -width Ds -compact +.It Sy "attaching slip unit" Em unit Sy for Ar loginname +.Tn SLIP +ユニット +.Em unit +は、アタッチに成功しました。 +.El +.Sh 関連項目 +.Xr slattach 8 , +.Xr syslogd 8 , +.Pa /usr/share/examples/sliplogin +.Sh 歴史 +.Nm +コマンドは、現在βテスト版です。 diff --git a/ja_JP.eucJP/man/man8/slstat.8 b/ja_JP.eucJP/man/man8/slstat.8 new file mode 100644 index 0000000000..d4c190a53d --- /dev/null +++ b/ja_JP.eucJP/man/man8/slstat.8 @@ -0,0 +1,124 @@ +.\" Copyright (c) 1986 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. +.\" +.\" 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. +.\" +.\" From: @(#)slstat.8 6.8 (Berkeley) 6/20/91 +.\" %Id: slstat.8,v 1.6.2.2 1997/03/06 08:00:20 mpp Exp % +.\" jpman %Id: slstat.8,v 1.2 1997/05/24 05:28:27 mitchy Stab % +.\" +.Dd October 11, 1996 +.Dt SLSTAT 8 +.Os BSD 4 +.Sh 名称 +.Nm slstat +.Nd シリアル回線 IP (SLIP) の利用統計を表示する +.Sh 書式 +.Nm +.Op Fl i Ar interval +.Op Fl vr +.Op Ar unit +.Sh 解説 +.Nm slstat +はシリアル回線インターネットプロトコル (SLIP) のトラフィックに関連する +カーネルの統計情報を表示します。 +.Pp +オプションは、以下のとおりです: +.Bl -tag -width indent +.It Fl i +.Ar interval +秒毎に表示を繰り返します。 +.Ar interval +が指定されない場合は、デフォルトの 5秒が使用されます。 +.It Fl v +統計情報の追加フィールドを表示します。 +.It Fl r +インターバルあたりの値を全て秒単位で表示します。 +.It Ar unit +.Tn SLIP +インターフェースを指定する 1 桁の数字です。デフォルトは +.Sy 0 +で、インターフェース +.Sy sl0 +が指定されます。 +.El +.Pp +デフォルトでは +.Nm +は以下の情報を表示します: +.Pp +.Bl -tag -width indent +.It in +受信バイト数 +.It out +送信バイト数 +.It pack +送受信したパケット数 +.It comp +送受信した圧縮されたパケット数 +.It uncomp +送受信した圧縮されていないパケット数 +.It unknwn +未知のタイプの入力パケット数 +.It toss +エラーにより返された入力パケット数 +.It other +その他の発信/返信 IP パケット数 +.It err +入出力エラー数 +.It search +コネクションステートのサーチ回数 +.It miss +コネクションステートを発見できなかった回数 +.It coll +clist での衝突の回数 +( 1 日に 1 回か 2 回以上の ) 多数の衝突がある場合には +おそらく clist が不足しています。 +param.c の +.Dv nclist +を増やしておく必要があります。 +.El +.Sh 使用例 +コマンド: +.Dl slstat -i 5 +は 5 秒毎にシステムが何をしているかを表示します。 +.Sh 関連項目 +.Xr fstat 1 , +.Xr netstat 1 , +.Xr nfsstat 1 , +.Xr ps 1 , +.Xr ststat 1 , +.Xr iostat 8 , +.Xr pppstats 8 , +.Xr pstat 8 +.Pp +.%T "Installing and Operating 4.3BSD" +の中の +``Interpreting system activity'' +から始まる章 diff --git a/ja_JP.eucJP/man/man8/smrsh.8 b/ja_JP.eucJP/man/man8/smrsh.8 new file mode 100644 index 0000000000..64833ebe0b --- /dev/null +++ b/ja_JP.eucJP/man/man8/smrsh.8 @@ -0,0 +1,103 @@ +.\" Copyright (c) 1993 Eric P. Allman +.\" 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. +.\" +.\" 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 +.\" jpman %Id: smrsh.8,v 1.3 1997/09/04 18:05:48 horikawa Stab % +.\" +.TH SMRSH 8 11/02/93 +.SH 名称 +smrsh \- sendmail用に制限されたシェル +.SH 書式 +.B smrsh +.B \-c +command +.SH 解説 +.I smrsh +は、 +.IR sendmail (8) +のコンフィグレーションファイルで、 +.I sh +の代わりに ``prog'' メーラとして使用する事を目的としています。 +.I smrsh +は、システムの全体的なセキュリティを改善するために、 +.I sendmail +の ``|program'' 書式により起動する事ができるコマンドを制限します。 +つまり、もし ``悪者'' が alias ファイルや forward ファイルを経由せずに +sendmail からプログラムを実行する事ができたとしても、 +.I smrsh +を使えば、彼(あるいは彼女)が実行できるプログラムを制限する事ができるのです。 +.PP +簡単に言うと、 +.I smrsh +は、実行可能なプログラムを /usr/libexec/sm.bin ディレクトリに存在するもの +だけに限定します。これにより、システム管理者は利用可能なコマンドを選択する +事ができます。 +更に、 +.I smrsh +は、``end run'' 攻撃を防ぐために、コマンド行に +`\`', `<', `>', `|', `;', `&', `$', `(', `)', `\er'(キャリッジリターン), +`\en'(ニューライン) +の文字を含むコマンドは実行しません。 +.PP +プログラム名の前にあるパス名は全て取り除かれるため、 +``/usr/bin/vacation'', ``/home/server/mydir/bin/vacation'', ``vacation'' +などは全て ``/usr/libexec/sm.bin/vacation'' と解釈されます。 +.PP +システム管理者は、 +/usr/libexec/sm.bin に置くプログラムを選ぶ際には慎重な +判断をすべきです。適切な物としては、 +.IR vacation (1) +や +.IR procmail (1) +などがあげられるでしょう。いかなる要望があっても、シェルや、 +.IR perl (1) +などのシェルに似たプログラムを +sm.bin +に入れてはいけません。 +これは、単に任意のプログラムを実行する事を制限するだけで、 +``#!''書式を用いた、シェルスクリプトや perl スクリプトを +sm.bin +ディレクトリに入れる事を制限する訳ではありません。 +.SH コンパイル +コンパイルはほとんどのシステムでつまらないものです。 +デフォルトのサーチパス +(デフォルトでは``/bin:/usr/bin'') +を変更するためには、\-DPATH=\e"\fIpath\fP\e" を +使用する必要があり、また、 +デフォルトのプログラムディレクトリ +(デフォルトでは ``/usr/libexec/sm.bin'') +を変更するためには、\-DCMDBIN=\e"\fIdir\fP\e" を +使用する必要があります。 +.SH 関連ファイル +/usr/libexec/sm.bin \- 制限されたプログラム用のディレクトリ +.SH 関連項目 +sendmail(8) diff --git a/ja_JP.eucJP/man/man8/spkrtest.8 b/ja_JP.eucJP/man/man8/spkrtest.8 new file mode 100644 index 0000000000..1db177d3d2 --- /dev/null +++ b/ja_JP.eucJP/man/man8/spkrtest.8 @@ -0,0 +1,53 @@ +.\" Copyright (c) May 1995 Wolfram Schneider <wosch@FreeBSD.org>. Berlin. +.\" 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. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: spkrtest.8,v 1.2.2.1 1997/03/06 08:00:22 mpp Exp % +.\" jpman %Id: spkrtest.8,v 1.3 1997/08/16 13:43:02 horikawa Stab % + +.Dd May, 1995 +.Dt SPKRTEST 8 +.Os FreeBSD + +.Sh 名称 +.Nm spkrtest +.Nd スピーカドライバ用テストスクリプト + +.Sh 解説 +.Nm +はスピーカドライバ用の簡単に使えるテストスクリプトです。 + +.Sh 関連ファイル +.Bl -tag -width /dev/speakerxx +.It Pa /dev/speaker +スピーカデバイスファイル +.El + +.Sh 関連項目 +.Xr dialog 1 , +.Xr perl 1 , +.Xr spkr 4 + +.Sh 歴史 +.Nm +スクリプトは FreeBSD 1.0 で登場しました。 diff --git a/ja_JP.eucJP/man/man8/spray.8 b/ja_JP.eucJP/man/man8/spray.8 new file mode 100644 index 0000000000..52523137b5 --- /dev/null +++ b/ja_JP.eucJP/man/man8/spray.8 @@ -0,0 +1,77 @@ +.\" +.\" Copyright (c) 1994 James A. Jegers +.\" 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. 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. +.\" +.Dd July 10, 1995 +.\" jpman %Id: spray.8,v 1.3 1997/07/22 16:59:25 horikawa Stab % +.Dt SPRAY 8 +.Os FreeBSD +.Sh 名称 +.Nm spray +.Nd たくさんのパケットをホストに送る +.Sh 書式 +.Nm spray +.Op Fl c Ar count +.Op Fl d Ar delay +.Op Fl l Ar length +.Ar host +\&... +.Ek +.Sh 解説 +.Nm spray +は複数の RPC パケットを +.Ar host +に送り、いくつのパケットが正しく受信され、それにはどのくらいの +時間がかかっているのかを記録します。 +.Pp +以下のようなオプションがあります。 +.Bl -tag -width indent +.It Fl c Ar count +.Ar count +個のパケットを送ります。 +.It Fl d Ar delay +パケット送出間隔を +.Ar delay +マイクロ秒にします。 +.It Fl l Ar length +RPC 呼び出しメッセージを保持するパケットの長さを +.Ar length +バイトに設定します。 +RPC データは XDR を用いて符号化されるため、全ての +.Ar length +値が可能というわけではありません。 +.Nm spray +は、もっとも近い可能な値に切り上げます。 +.El +.Pp +.Nm spray +は、ネットワークのテストや計測や管理のための利用を想定しています。 +このコマンドは、 +.Bf -emphasis +ネットワークにとても負荷をかけますので、利用には注意してください。 +.Ef +.Pp +.Sh 関連項目 +.Xr netstat 1 , +.Xr ifconfig 8 , +.Xr ping 8 , +.Xr rpc.sprayd 8 diff --git a/ja_JP.eucJP/man/man8/sticky.8 b/ja_JP.eucJP/man/man8/sticky.8 new file mode 100644 index 0000000000..749bb77758 --- /dev/null +++ b/ja_JP.eucJP/man/man8/sticky.8 @@ -0,0 +1,99 @@ +.\" Copyright (c) 1980, 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. +.\" +.\" 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. +.\" +.\" @(#)sticky.8 8.1 (Berkeley) 6/5/93 +.\" jpman %Id: sticky.8,v 1.3 1997/07/19 12:27:09 konuma Stab % +.\" %Id: sticky.8,v 1.1.1.1.8.1 1997/03/07 04:18:28 mpp Exp % +.\" +.Dd June 5, 1993 +.Dt STICKY 8 +.Os BSD 4 +.Sh 名称 +.Nm sticky +.Nd スティッキーテキストと追加専用ディレクトリ +.Sh 解説 +特別なファイルモード +.Em sticky bit +(mode S_ISVTX) +は、共有可能な実行ファイルやディレクトリのための +特別な取り扱いを示すために使われます。 +ファイルのモードについての説明は、 +.Xr chmod 2 +や、 +.Pa /usr/include/sys/stat.h +ファイルを参照してください。 +.Sh 実行ファイルのスティッキーテキスト +スティッキービットが設定されている共有可能な実行ファイルは、 +実行が終った後もスワップ領域から直ちには取り除かれません。 +カーネルは、ファイルのテキストセグメントを将来の再利用のために蓄えるので、 +そのプログラムを再ロードする必要がなくなります。 +共有テキストセグメントは普通、利用後は、 +頻繁に使われたものを残すキャッシュに置かれます。 +したがって、 `スティッキービット' はよく使われるテキストイメージには +ほとんど効果がありません。 +.Pp +共有可能な実行ファイルは、 +.Fl n +と +.Fl z +オプションをローダ +.Xr ld 1 +で指定することで作成されます。 +.Pp +スーパーユーザだけが、共有可能な実行ファイルにスティッキービットを +設定できます。 +.Sh スティッキーディレクトリ +`スティッキービット' が設定されたディレクトリは追加専用ディレクトリ、 +より正確にいえば、ファイルの削除が制限されたディレクトリになります。 +スティッキーディレクトリのファイルの削除や名称変更が可能なのは、 +そのディレクトリの書き込み権限を持つそのファイルの所有者か、 +そのディレクトリの所有者か、スーパーユーザだけです。 +この機能は、 +.Pa /tmp +ディレクトリの様に、公共的に書き込み可能であるが、他人の任意のファイルを +消去したり、名称変更したりさせたくない場合には有効です。 +.Pp +どんなユーザもスティッキーディレクトリを作成することができます。 +ファイルモードの変更についての詳細は、 +.Xr chmod 1 +を参照してください。 +.Sh バグ +スティッキーテキストを持つ実行ファイルのテキスト領域は、 +スワップ領域に置かれるので、 +この機能の濫用はスワップの不足を引き起こします。 +.Pp +.Xr open 2 +もしくは +.Xr mkdir 2 +のどちらも、スティッキービットが設定されたファイルを作成できません。 +.Sh 歴史 +.Nm +コマンドは、 Version 32V AT&T UNIX から登場しました。 diff --git a/ja_JP.eucJP/man/man8/strfile.8 b/ja_JP.eucJP/man/man8/strfile.8 new file mode 100644 index 0000000000..e48845cf2e --- /dev/null +++ b/ja_JP.eucJP/man/man8/strfile.8 @@ -0,0 +1,149 @@ +.\" Copyright (c) 1989, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" +.\" This code is derived from software contributed to Berkeley by +.\" Ken Arnold. +.\" +.\" 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. +.\" +.\" 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. +.\" +.\" @(#)strfile.8 8.1 (Berkeley) 6/9/93 +.\" jpman %Id: strfile.8,v 1.3 1997/05/20 08:54:30 mihara Stab % +.\" +.Dd June 9, 1993 +.Dt STRFILE 8 +.Os BSD 4 +.Sh 名称 +.Nm strfile , +.Nm unstr +.Nd "文字列を格納するためのランダムアクセスファイルを作成する" +.Sh 書式 +.Nm strfile +.Op Fl iorsx +.Op Fl c Ar char +.Ar source_file +.Op Ar output_file +.Nm unstr +.Ar source_file +.Sh 解説 +.Nm strfile +は +1 つのパーセント記号 +.Ql \&% +を含む行で区切られる行グループを含むファイルを読み込み、 +ヘッダ構造と各々の行グループのファイルオフセットを含む +データファイルを作成します。 +このファイルによって文字列のランダムアクセスが可能となります。 +.Pp +出力ファイルは、それがコマンド行において指定されていない場合、 +.Ar source_file Ns Sy .out . +というファイル名になります。 +.Pp +指定できるオプションとして、次のものがあります。 +.Bl -tag -width "-c char" +.It Fl c Ar char +区切り文字をパーセント記号から +.Ar char +に変更します。 +.It Fl i +文字列の並び換えを行なう際に、大文字・小文字を区別しません。 +.It Fl o +文字列をアルファベット順に並び換えます。 +オフセットテーブルは参照される行グループのアルファベット順に +ソートされます。 +文字列の頭のアルファベットと数字以外の文字は無視されます。 +このオプションを指定すると、ヘッダ中の +.Ar str_flags +フィールドの +.Dv STR_ORDERED +ビットがセットされます。 +.It Fl r +文字列へのアクセスをランダム化します。 +オフセットテーブル中のエントリはランダムに並び換えられます。 +このオプションを指定すると、ヘッダ中の +.Ar str_flags +フィールドの +.Dv STR_RANDOM +ビットがセットされます。 +.It Fl s +なにも表示せずに実行します。終了時にサマリのメッセージを表示しません。 +.It Fl x +行グループ中の各アルファベット文字を単純シーザー暗号 +(simple caesar cypher) における 13 ポジションだけローテートします。 +このオプションを指定すると、ヘッダ中の +.Ar str_flags +フィールドの +.Dv STR_ROTATED +ビットがセットされます。 +.El +.Pp +ヘッダのフォーマットは以下のとおりです。 +.Bd -literal +#define VERSION 1 +unsigned long str_version; /* バージョン番号 */ +unsigned long str_numstr; /* ファイル中の文字列の数 */ +unsigned long str_longlen; /* 最長文字列の長さ */ +unsigned long str_shortlen; /* 最短文字列の長さ */ +#define STR_RANDOM 0x1 /* ランダムフラグの位置 */ +#define STR_ORDERED 0x2 /* 並び換えフラグの位置 */ +#define STR_ROTATED 0x4 /* rot-13されたテキスト */ +unsigned long str_flags; /* フラグビットフィールド */ +char str_delim; /* 区切り文字 */ +.Ed +.Pp +全てのフィールドはネットワークバイトオーダで書かれます。 +.Pp +.Nm unstr +は +.Nm strfile +で行なったことを元に戻すためのものです。 +.Ar source_file +中に含まれる文字列を +.Ar source_file Ns Pa .dat +ファイルのヘッダにリストされた順で標準出力に表示します。 +.Fl o +を使って +.Nm strfile +を実行した後、 +.Nm unstr +を使ってそれをテーブルの順にダンプすることによって、 +入力ファイルのソートされたバージョンを作成することが可能です。 +.Sh 関連項目 +.Xr byteorder 3 , +.Xr fortune 6 +.Sh 関連ファイル +.Bl -tag -width strfile.out -compact +.It Pa strfile.out +デフォルトの出力ファイル。 +.El +.Sh 歴史 +.Nm strfile +ユーティリティは +.Bx 4.4 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/swapon.8 b/ja_JP.eucJP/man/man8/swapon.8 new file mode 100644 index 0000000000..f4cf35ee72 --- /dev/null +++ b/ja_JP.eucJP/man/man8/swapon.8 @@ -0,0 +1,92 @@ +.\" Copyright (c) 1980, 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. +.\" +.\" 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. +.\" +.\" @(#)swapon.8 8.1 (Berkeley) 6/5/93 +.\" %Id: swapon.8,v 1.4.2.1 1997/08/26 00:32:59 imp Exp % +.\" jpman %Id: swapon.8,v 1.2 1997/05/03 13:45:14 horikawa Stab % +.\" +.Dd June 5, 1993 +.Dt SWAPON 8 +.Os BSD 4 +.Sh 名称 +.Nm swapon +.Nd ページングやスワッピングに使用する追加デバイスを指定する +.Sh 書式 +.Nm swapon +.Fl a +.Nm swapon +.Ar special_file ... +.Sh 解説 +.Nm swapon +は、ページングやスワッピングを行うための追加デバイス指定にて使用します。 +システムは、ただ一つのデバイス上にページングやスワッピングして立ち上がるので、 +起動時にはただ一つのディスクを要求します。 +通常 +.Nm swapon +は、システムのマルチユーザモードの初期化ファイル +.Pa /etc/rc +から起動され、全てのスワップデバイスを有効にし、 +ページングとスワッピング動作を複数デバイスにインタリーブします。 +.Pp +通常は、最初の書式を使用します: +.Bl -tag -width Ds +.It Fl a +.Pa /etc/fstab +で、``noauto'' オプションが設定されていない、 +``sw'' と指定されているすべてのスワップデバイスを使用可能にします。 +.El +.Pp +二番目の書式は、システムスワップコンフィギュレーションテーブルに与えるように、 +個々のブロックデバイスを指定します。 +これにより、システムは指定されたデバイスのみをスワップ空間として利用します。 +.Pp +.Sh 関連項目 +.Xr swapon 2 , +.Xr fstab 5 , +.Xr init 8 , +.Xr rc 8 , +.Xr vnconfig 8 +.Sh 関連ファイル +.Bl -tag -width /dev/[ru][pk]?b -compact +.It Pa /dev/[ru][pk]?b +標準のページングデバイス +.It Pa /etc/fstab +ascii 形式のファイルシステム記述テーブル +.El +.Sh バグ +デバイスへのページングとスワッピングを停止する方法はありません。 +ですから、 +システム動作中にデバイスのマウントを解除して使用することは不可能です。 +.Sh 歴史 +.Nm +コマンドは +.Bx 4.0 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/sync.8 b/ja_JP.eucJP/man/man8/sync.8 new file mode 100644 index 0000000000..225eef8c79 --- /dev/null +++ b/ja_JP.eucJP/man/man8/sync.8 @@ -0,0 +1,76 @@ +.\" Copyright (c) 1980, 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. +.\" +.\" 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. +.\" +.\" @(#)sync.8 8.1 (Berkeley) 5/31/93 +.\" jpman %Id: sync.8,v 1.2 1997/04/10 05:32:43 mutoh Stab % +.\" %Id: sync.8,v 1.3.2.1 1997/08/25 09:25:24 jkh Exp % +.\" +.Dd May 31, 1993 +.Dt SYNC 8 +.Os BSD 4 +.Sh 名称 +.Nm sync +.Nd 未実行のディスク書き込みを強制実行する ( キャッシュのフラッシュ ) +.Sh 書式 +.Nm sync +.Sh 解説 +.Xr reboot 8 +または +.Xr halt 8 +を使わずにプロセッサを停止する場合、全てのディスク書き込みが +適切に完了することを保証するため、停止に先だって +.Nm sync +を呼ぶことができます。 +一般的には、システムをシャットダウンするには +.Xr reboot +もしくは +.Xr halt +を使うことが好ましいでしょう。 +なぜならこれらのプログラムは、最終的な +.Nm sync +を実行する前に、内蔵時計の再同期や内部キャッシュの +フラッシュなどの追加動作を実行する場合があるからです。 +.Pp +.Nm sync +は、 +.Xr sync 2 +ファンクションコールを利用します。 +.Sh 関連項目 +.Xr fsync 2 , +.Xr sync 2 , +.Xr update 4 , +.Xr halt 8 , +.Xr reboot 8 +.Sh 歴史 +.Nm sync +コマンドは +.At v6 +から実装されました。 diff --git a/ja_JP.eucJP/man/man8/sysctl.8 b/ja_JP.eucJP/man/man8/sysctl.8 new file mode 100644 index 0000000000..b8672baacc --- /dev/null +++ b/ja_JP.eucJP/man/man8/sysctl.8 @@ -0,0 +1,247 @@ +.\" 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. +.\" +.\" 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. +.\" +.\" From: @(#)sysctl.8 8.1 (Berkeley) 6/6/93 +.\" %Id: sysctl.8,v 1.10.2.1 1997/08/30 14:11:21 kato Exp % +.\" jpman %Id: sysctl.8,v 1.2 1997/05/30 00:57:58 yugawa Stab % +.\" +.Dd September 23, 1994 +.Dt SYSCTL 8 +.Os +.Sh 名称 +.Nm sysctl +.Nd カーネル状態の取得や設定 +.Sh 書式 +.Nm sysctl +.Op Fl bn +.Ar name ... +.Nm sysctl +.Op Fl bn +.Fl w +.Ar name=value ... +.Nm sysctl +.Op Fl bn +.Fl aAX +.Sh 解説 +.Nm sysctl +はカーネル状態を取り出し、適切な権限があれば +プロセスがカーネル状態を設定することを許します。取り出され +たり、設定されたりした状態は、``Management Information Base''(``MIB'') +形式を使って記述されます。この形式では、要素はドット ``.'' で +接続されます。 +.Pp +.Fl a +フラグを使うと、現在有効な文字列や整数値 +をすべて表示します。 +.Pp +.Fl A +フラグでは、 +.Nm sysctl +がそのデータ形式を知らないもの(以下、形式不明の変数と称する) を含めて、 +存在している全ての MIB を表示します。 +.Fl a +フラグ同様、文字列や整数値も表示されます。 +形式不明の変数に関しては、 +そのフォーマットおよび長さに関する情報と、その変数の内容の最初の数バイトを +16 進数でダンプします。 +.Pp +.Fl X +フラグは、形式不明の変数の全ての内容が 16 進数でダンプされる以外は +.Fl A +と同じです。 +.Pp +.Fl n +フラグをつけると、フィールド名の出力は抑制されて、値 +だけが表示されます。これはシェル変数を設定するのに役に +立ちます。たとえば、ページサイズを変数 psize に保存する +には、以下のようにします: +.Bd -literal -offset indent -compact +set psize=`sysctl -n hw.pagesize` +.Ed +.Pp +.Fl b +フラグをつけると、変数の値を加工せずに、バイナリ形式で表示します。 +変数名や、最後の改行文字は出力されません。これは、単一の変数に対して +操作する際に便利でしょう。 +.Pp +MIB 形式の名前だけを指定すると、その名前に対応する +値が得られます。値を設定するには +.Fl w +フラグを用い、MIB 名 +のあとにイコール記号 ``='' をつけて、そのあとに設定する新 +しい値を指定します。 +.Pp +.Nm sysctl +で得られる情報は、整数、文字列、形式不明の変数です。 +.Nm sysctl +はいくつかの形式不明の変数の形式を知っているだけで、それ以外のものに +対しては 16 進ダンプに頼ります。 +形式不明の変数の情報は、 +.Nm ps +や +.Nm systat +, +.Nm netstat +などの特別な目的のプログラムによって取得された場合に、より効果的です。 +.Pp +文字列と整数の情報を簡単にまとめて以下に示します。これらの +変数の詳細な説明は、 +.Xr sysctl 3 +を参照してください。 +.Pp +changeable の列は、適切な権限を持つプロセスがその値を変更 +できるかどうかを示しています。 +.Bl -column net.inet.ip.forwardingxxxxxx integerxxx +.It Sy Name Type Changeable +.It kern.ostype string no +.It kern.osrelease string no +.It kern.osrevision integer no +.It kern.version string no +.It kern.maxvnodes integer yes +.It kern.maxproc integer yes +.It kern.maxprocperuid integer yes +.It kern.maxfiles integer yes +.It kern.maxfilesperproc integer yes +.It kern.argmax integer no +.It kern.securelevel integer raise only +.It kern.hostname string yes +.It kern.hostid integer yes +.It kern.clockrate struct no +.It kern.posix1version integer no +.It kern.ngroups integer no +.It kern.job_control integer no +.It kern.saved_ids integer no +.It kern.boottime struct no +.It kern.domainname string yes +.It kern.update integer yes +.It kern.osreldate string no +.It kern.bootfile string yes +.It vm.loadavg struct no +.It hw.machine string no +.It hw.model string no +.It hw.ncpu integer no +.It hw.byteorder integer no +.It hw.physmem integer no +.It hw.usermem integer no +.It hw.pagesize integer no +.It hw.floatingpoint integer no +.It hw.machine_arch string no +.It machdep.console_device dev_t no +.It machdep.adjkerntz integer yes +.It machdep.disable_rtc_set integer yes +.It user.cs_path string no +.It user.bc_base_max integer no +.It user.bc_dim_max integer no +.It user.bc_scale_max integer no +.It user.bc_string_max integer no +.It user.coll_weights_max integer no +.It user.expr_nest_max integer no +.It user.line_max integer no +.It user.re_dup_max integer no +.It user.posix2_version integer no +.It user.posix2_c_bind integer no +.It user.posix2_c_dev integer no +.It user.posix2_char_term integer no +.It user.posix2_fort_dev integer no +.It user.posix2_fort_run integer no +.It user.posix2_localedef integer no +.It user.posix2_sw_dev integer no +.It user.posix2_upe integer no +.It user.stream_max integer no +.It user.tzname_max integer no +.El +.Pp +.Sh 使用例 +.Pp +たとえば、システム中で許されている最大のプロセス数を知りたい +ときは、以下のようにします: +.Bd -literal -offset indent -compact +sysctl kern.maxproc +.Ed +.Pp +システム中で許されている最大のプロセス数を 1000 に設定する +には、以下のようにします: +.Bd -literal -offset indent -compact +sysctl -w kern.maxproc=1000 +.Ed +.Pp +システムのクロックレートに関する情報を得るには、以下の +ようにします: +.Bd -literal -offset indent -compact +sysctl kern.clockrate +.Ed +.Pp +システム負荷(ロード・アベレージ)の履歴に関する情報を +得るには、以下のようにします: +.Bd -literal -offset indent -compact +sysctl vm.loadavg +.Ed +.Pp +ここに挙げたもの以外の変数も存在します。それらに関するより深い意味を知る +もっとも良く、かつ、おそらく唯一の方法は、それらを定義しているソースコードを +みる事であることは疑いのない事実でしょう。 +.Sh 関連ファイル +.Bl -tag -width <netinet/icmpXvar.h> -compact +.It Pa <sys/sysctl.h> +トップレベルの識別子、第 2 レベルのカーネル/ハードウェア識別子、 +そしてユーザレベル識別子の定義 +.It Pa <sys/socket.h> +第 2 レベルのネットワーク識別子の定義 +.It Pa <sys/gmon.h> +第 3 レベルのプロファイル識別子の定義 +.It Pa <vm/vm_param.h> +第 2 レベルの仮想メモリ識別子の定義 +.It Pa <netinet/in.h> +第 3 レベルのインターネット識別子と +第 4 レベルの IP 識別子の定義 +.It Pa <netinet/icmp_var.h> +第 4 レベルの ICMP 識別子の定義 +.It Pa <netinet/udp_var.h> +第 4 レベルの UDP 識別子の定義 +.El +.Sh 関連項目 +.Xr sysctl 3 +.Sh バグ +現状では +.Nm sysctl +は、sysctl ツリーの追跡、および、形式と名前の情報を得る際に、 +文書化されていないカーネルの sysctl 機能へのインタフェースを使用しています。 +この方法に関する正しいインタフェースは、現在検討中です。 +.Sh 歴史 +.Nm sysctl +は +.Bx 4.4 +ではじめて登場しました。 +.Pp +.Fx 2.2 +の +.Nm sysctl +は著しく改良されています。 diff --git a/ja_JP.eucJP/man/man8/syslogd.8 b/ja_JP.eucJP/man/man8/syslogd.8 new file mode 100644 index 0000000000..96486e7cee --- /dev/null +++ b/ja_JP.eucJP/man/man8/syslogd.8 @@ -0,0 +1,215 @@ +.\" Copyright (c) 1983, 1986, 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. +.\" +.\" 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. +.\" +.\" @(#)syslogd.8 8.1 (Berkeley) 6/6/93 +.\" %Id: syslogd.8,v 1.6.2.4 1997/09/19 22:27:26 brian Exp % +.\" jpman %Id: syslogd.8,v 1.3 1997/05/19 17:08:30 horikawa Stab % +.\" +.Dd October 12, 1995 +.Dt SYSLOGD 8 +.Os BSD 4.2 +.Sh 名称 +.Nm syslogd +.Nd システムメッセージの記録をとる +.Sh 書式 +.Nm syslogd +.Op Fl ds +.Op Fl a Ar allowed_peer +.Op Fl f Ar config_file +.Op Fl m Ar mark_interval +.Op Fl p Ar log_socket +.Sh 解説 +.Nm syslogd +はコンフィグレーションファイルに指定された通りに、システムコンソール、 +ログファイル、他のマシンやユーザへのメッセージを読み込み、記録します。 +オプションには以下のものがあります。 +.Bl -tag -width Ds +.It Fl a Ar allowed_peer +.Ar allowed_peer +がこの +.Nm syslogd +に UDP データグラムを使用してログすることを許します。複数の +.Fl a +オプションを指定可能です。 +.Pp +.Ar allowed_peer +は以下のいずれかです: +.Bl -tag -width "ipaddr/masklen[:service]XX" +.It Ar ipaddr/masklen Ns Op Ar :service +.Ar ipaddr +(通常のドット表記の 4 つ組) +からのデータグラムを受け付けます。 +アドレス比較の際、 +.Ar masklen +ビットを考慮します。 +.Ar service +が指定された場合、パケット送出元が属すべき +UDP service の名前もしくは番号となります( +.Xr services 5 +参照)。 +.Ar service +に +.Ql \&* +を指定すると、全ての UDP ポートから送信されたパケットを受け付けます。 +デフォルトの +.Ar service +は +.Ql syslog +です。 +.Ar masklen +を指定しないと、 +.Ar ipaddr +がクラス A もしくは B のアドレス範囲に属す場合にはそれぞれ +歴史的なクラス A もしくは B のネットマスクが使用され、 +そうでない場合には 24 が使用されます。 +.It Ar domainname Ns Op Ar :service +送信アドレスのアドレス逆引きにおいて +.Ar domainname +が得られたデータグラムを受け付けます。 +.Ar service +の意味は前述の通りです。 +.It Ar *domainname Ns Op Ar :service +上述の通りですが、送信ホスト名が +.Ar domainname +で +.Em 終る +全てのホストから受け付けます。 +.El +.It Fl d +.Nm syslogd +をデバッグモードで実行します。これは恐らく、 +.Nm syslogd +の開発者にのみ役立ちます。 +.It Fl f +代りのコンフィグレーションファイルのパス名を指定します。 +デフォルトは +.Pa /etc/syslog.conf +です。 +.It Fl m +``mark''されたメッセージの間隔を分単位で指定します。 +デフォルトは20分です。 +.It Fl p +代りのログ用ソケットのパス名を指定します。 +デフォルトは +.Pa /var/run/log +です。 +.It Fl s +セキュアモードで操作します。リモートマシンからのログメッセージを受ける +ために listen しません。 +.El +.Pp +.Nm syslogd +は起動時とhangupシグナルを受けとった時はいつでもコンフィグレーションファ +イルを読み込みます。 +コンフィグレーションファイルのフォーマットに関する情報は、 +.Xr syslog.conf 5 +参照して下さい。 +.Pp +.Nm syslogd +は +.Tn UNIX +ドメインソケット +.Pa /var/run/log、 +.Pa /etc/services +で指定されるインタネットドメインソケット +およびスペシャルデバイス +.Pa /dev/klog +(カーネルメッセージを読むため)からメッセージを読み込みます。 +.Pp +.Nm syslogd +はファイル +.Pa /var/run/syslog.pid +を作成し、プロセスIDを記録します。 +これは +.Nm syslogd +のkillやコンフィグレーションファイルを読み込ませるために使えます。 +.Pp +.Nm syslogd +に送られるメッセージは単一の行で構成されます。このメッセージは先頭に優 +先順位コードを含んでいます。このコードは +.Sq Aq 5 +のように括弧でくくられた十進数から構成されており、インクルードファイル +.Aq Pa sys/syslog.h +で定義されている優先順位に対応します。 +.Sh 関連ファイル +.Bl -tag -width /var/run/syslog.pid -compact +.It Pa /etc/syslog.conf +コンフィグレーションファイル +.It Pa /var/run/syslog.pid +動作している +.Nm syslogd +のプロセスID +.It Pa /var/run/log +.Tn UNIX +ドメインデータグラムのログ用ソケットの名前 +.It Pa /dev/klog +カーネルログ用のデバイス +.El +.Sh 関連項目 +.Xr logger 1 , +.Xr syslog 3 , +.Xr services 5 , +.Xr syslog.conf 5 +.Sh 歴史 +.Nm syslogd +コマンドは +.Bx 4.3 +から登場しました。 +.Pp +.Fl s +および +.Fl a +オプションは +.Fx 2.2 +における拡張です。 +.Sh バグ +UDPパケットで受けとったメッセージを記録する能力は認証されていないディ +スクを溢れさせるリモートサービスと等価であり、恐らくデフォルトで無効に +されるべきです。ある種の +.Nm syslogd +間の認証メカニズムが用意されるべきでしょう。 +最悪の無駄遣いを避けるために、 +.Fl a +オプションの使用を強く勧めます。 +.Pp +.Fl a +のマッチングアルゴリズムは非常に効率的には見えません; +ドメイン名比較より、数値による IP アドレスを使用する方が高速です。 +許可されたピアのリストの検索は線型に行なわれるため、 +多くのメッセージを受け付けると予測されるピアグループは +.Fl a +リストの最初の方に置くべきです。 +.Pp +ログ用ソケットは読み込み専用のルートファイルシステムの扱いを容易にする +ために +.Pa /dev +から移されました。このことは古いバイナリを混乱させるかもしれないので、 +過渡期の間はシンボリックリンクが役に立つでしょう。 diff --git a/ja_JP.eucJP/man/man8/talkd.8 b/ja_JP.eucJP/man/man8/talkd.8 new file mode 100644 index 0000000000..41d0ea879d --- /dev/null +++ b/ja_JP.eucJP/man/man8/talkd.8 @@ -0,0 +1,76 @@ +.\" Copyright (c) 1983, 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. +.\" +.\" 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. +.\" +.\" @(#)talkd.8 8.2 (Berkeley) 12/11/93 +.\" jpman %Id: talkd.8,v 1.2 1997/05/20 01:39:12 mutoh Stab % +.\" +.Dd December 11, 1993 +.Dt TALKD 8 +.Os BSD 4.3 +.Sh 名称 +.Nm talkd +.Nd +.Xr talk 1 +のためのデーモン +.\".Nd remote user communication server +.\"(訳中)上記原文とは異なった訳ですが、分かりやすいのでこのまま採用します。 +.\" 2.2.1R 対象(1997/05/17) Takeshi MUTOH <mutoh@info.nara-k.ac.jp> +.Sh 書式 +.Nm talkd +.Sh 解説 +.Nm talkd +は、他のユーザの会話要求を、ユーザに通知するサーバです。 +会話をしたい複数のクライアントからの +要求に応答する、いわば招待状の貯蔵庫として機能します。 +通常の操作では、呼び出し元のクライアントは、サーバに +メッセージタイプが +.Dv LOOK_UP +.Pf ( Aq Pa protocols/talkd.h +参照) である +.Dv CTL_MSG +構造体のメッセージを送って、 +接続の初期化を行います。すると、サーバはすでに呼び出し +が行われているかどうか内部テーブルを検索します (相手はメッセージ +のなかで指定されています)。検索に失敗すると、クライアントは +.Dv ANNOUNCE +メッセージを送り、サーバに呼び出す相手のログイン端末に通知を +ブロードキャストさせて接続要求を行います。相手が応答すると、ローカル +のサーバは内部テーブルの記録を用いて適切なアドレスで +接続を行い、呼び出し側と呼び出された側との間にストリーム型 +の接続を確立して、そこで会話が行えるようにします。 +.Sh 関連項目 +.Xr talk 1 , +.Xr write 1 +.Sh 歴史 +.Nm +コマンドは +.Bx 4.3 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/telnetd.8 b/ja_JP.eucJP/man/man8/telnetd.8 new file mode 100644 index 0000000000..2067c793ba --- /dev/null +++ b/ja_JP.eucJP/man/man8/telnetd.8 @@ -0,0 +1,587 @@ +.\" Copyright (c) 1983, 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. +.\" +.\" 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. +.\" +.\" @(#)telnetd.8 8.3 (Berkeley) 3/1/94 +.\" %Id: telnetd.8,v 1.5.2.1 1997/02/05 06:02:38 pst Exp % +.\" jpman %Id: telnetd.8,v 1.2 1997/05/12 08:14:57 yugawa Stab % +.\" +.Dd March 1, 1994 +.Dt TELNETD 8 +.Os BSD 4.2 +.Sh 名称 +.Nm telnetd +.Nd DARPA +.Tn TELNET +プロトコルサーバ +.Sh 書式 +.Nm /usr/libexec/telnetd +.Op Fl BUhlkns +.Op Fl D Ar debugmode +.Op Fl I Ns Ar initid +.Op Fl S Ar tos +.Op Fl X Ar authtype +.Op Fl a Ar authmode +.Op Fl edebug +.Op Fl P Ar loginprog +.Op Fl r Ns Ar lowpty-highpty +.Op Fl u Ar len +.Op Fl debug Op Ar port +.Sh 解説 +.Nm telnetd +コマンドは、 +.Tn DARPA +標準 +.Tn TELNET +仮想端末プロトコル +をサポートするサーバです。 +.Nm telnetd +は、通常は +.Pa /etc/services +ファイル( +.Xr services 5 +参照) に記述されている +.Tn TELNET +ポートへの接続要求を受けて、インターネットサーバ ( +.Xr inetd 8 +参照) から起動されます。 +.Fl debug +オプションは、 +.Xr inetd 8 +の代わりに +.Nm telnetd +を手動で起動するために用いられます。 +このように手動で起動された場合には、 +代わりの +.Tn TCP +ポート番号で +.Nm telnetd +を動かすために +.Ar port +を指定する事ができます。 +.Pp +.Nm telnetd +コマンドには以下のオプションがあります: +.Bl -tag -width "-a authmode" +.It Fl a Ar authmode +このオプションは、どのモードが認証に使われるかを指定するために用いられます。 +このオプションは、 +.Nm telnetd +が +.Dv AUTHENTICATION +オプションをサポートする設定で構築された場合においてのみ役に立つことに +注意して下さい。 +以下に示すようないくつかの +.Ar authmode +があります。 +.Bl -tag -width debug +.It debug +認証のデバッグコードを有効にします。 +.It user +リモートユーザは、自分自身であること示すための有効な認証情報を +提供した時にのみ接続が許可されます。 +この場合、指定されたアカウントに対しては、パスワードの提供なしに接続が +許可されます。 +.It valid +リモートユーザが自分自身であることを示すための有効な認証情報を +提供した時にのみ接続が許可されます。 +リモートユーザが指定されたアカウントに対する自動的な接続が許可されて +いなければ +.Xr login 1 +コマンドは、必要となるユーザ認証を実施します。 +.It other +ある種の認証情報を提供した場合のみ接続を許可します。 +現在このオプションはすべての認証方法でサポートされていないため +.Fl a +.Cm valid +オプションを指定した時と同じ動作をします。 +.It none +デフォルトではこの状態です。 +認証情報は要求されません。 +もし認証情報がなかったり不十分であれば、 +.Xr login 1 +プログラムによって必要となるユーザ認証を実施します。 +.It off +認証コードを無効にします。 +すべてのユーザ証明が +.Xr login 1 +プログラムによって行われます。 +.El +.It Fl B +bftp サーバモードを指定します。このモードでは +.Nm telnetd +は、login にユーザの通常のシェルではなく +.Xr bftp 1 +セッションを開始するように指示します。 +bftp デーモンモードにおいて通常のログインはサポートされていません。 +また通常の +.Tn TELNET +ポートではなく別のポートを使わなくてはいけません。 +.It Fl D Ar debugmode +このモードはデバックのために用いられます。 +これによって +.Nm telnetd +がデバッグ情報を表示し、ユーザは +.Nm telnetd +が何をしているのかを見ることが許されます。 +以下に示すようないくつかの +.Ar debugmode +が可能です。 +.Bl -tag -width exercise +.It Cm options +.Tn TELNET +オプションのネゴシエーションについての情報が表示されます。 +.It Cm report +.Cm options +で表示される情報に加えて、 +どのような操作が行われているのかという、いくつかの付加的な情報が +表示されます。 +.It Cm netdata +.Nm telnetd +が受け取ったデータストリームを表示します。 +.It Cm ptydata +pty に書かれたデータを表示します。 +.It Cm exercise +まだ実装されていません。 +.El +.It Fl debug +.Nm telnetd +によって作られたソケットについてのデバッグを可能にします +( +.Xr socket 2 +の +.Dv SO_DEBUG +参照)。 +.It Fl edebug +.Nm telnetd +がデータの暗号化をサポートする設定で構築されている場合に、 +.Fl edebug +オプションは、暗号化デバッグコードを可能にするために使われます。 +.It Fl P Ar loginprog +ログインを完了する際に実行されるコマンドとして +.Xr login 1 +以外のコマンドを指定します。指定されたコマンドは通常の login と同じ引数を +解釈できる必要があります。 +.It Fl h +ログインが完了するまでホストに特有の情報を表示しないようにします。 +.It Fl I Ar initid +このオプションは、バージョン 7.0 以前の +.Tn UNICOS +システムでのみ有効です。 +init がログインセッションを開始したときに、 +.Pa /etc/inittab +から +.Dv ID +を特定します。デフォルトの +.Dv ID +は +.Dv fe +です。 +.It Fl k +このオプションは、 +.Nm telnetd +が linemode と kludge linemode をサポートする設定で構築されている +ときにのみ有効です。 +.Fl k +オプションが指定されている場合で、もしリモートのクライアントが +.Dv LINEMODE +オプションをサポートしていなければ、 +.Nm telnetd +は、 character at a time mode で動きます。 +この様な状態でも kludge linemode をサポートしますが、リモートのクライアントが +要求した場合のみ kludge linemode になります +(これは、クライアントが +.Dv DONT SUPPRESS-GO-AHEAD +と +.Dv DONT ECHO +を送信することによって行われます)。 +.Fl k +オプションは kludge linemode をサポートしていないリモートクライアントが +あるが、(もしクライアントが +.Dv DO TIMING-MARK +に対して +.Dv WILL TIMING-MARK +を応答する事で)自己発見的に kludge linemode をサポートすると認められる +様な場合にとても便利です。 +.It Fl l +line mode を指定します。クライアントを強制的に line-at-a-time mode に +なるよう試みます。 +もし +.Dv LINEMODE +オプションがサポートされてなければ、kludge linemode になります。 +.It Fl n +.Dv TCP +keep-alives を行いません。通常、 +.Nm telnetd +は +.Tn TCP +keep-alive を有効にしています。なぜなら、クラッシュしたり、すでに接続 +出来ないようなマシンからのアイドルコネクションを解消するために、 +ある期間アイドルだった場合にクライアントとの接続がまだ存在するかどうかを +調べる必要があるからです。 +.It Fl r Ar lowpty-highpty +このオプションは、 +.Nm telnetd +が +.Dv UNICOS +用に構築されている場合にのみ有効です。 +使用する仮想端末デバイスの包括的な範囲を指定します。 +システムが sysconf 変数 +.Dv _SC_CRAY_NPTY +を使用するように設定されている場合、デフォルトでの pty の検索範囲は +0から +.Dv _SC_CRAY_NPTY +までになります。そうでなければ、デフォルトでの検索範囲は0から128に +なります。検索範囲のどちらか一方だけを変更したい場合は、 +.Ar lowpty +あるいは +.Ar highpty +は省略する事が出来ます。 +.Ar lowpty +を省略した場合でも文字 - を省略する事は出来ません。 +文字 - を省略してしまうと +.Nm telnetd +はそれが +.Ar highpty +であることを判断できずに +.Ar lowpty +であると判断してしまうからです。 +.It Fl s +このオプションは、 +.Nm telnetd +が +.Tn SecurID +カードをサポートする設定で構築されている時にのみ有効です。 +このオプションを指定すると、 +.Fl s +オプションはそのまま +.Xr login 1 +に渡され、 +.Xr login 1 +が +.Fl s +オプションをサポートしていて +.Tn SecurID +によって認証されたログインのみを許可するような場合に有効です。 +これは、ファイアウォールの外側からのリモートログインを制御するような +場合に有意義でしょう。 +.It Fl S Ar tos +.It Fl u Ar len +このオプションは、 +リモートホスト名を保持している +.Dv utmp +構造体のフィールドの大きさを指定するために使われます。 +もし解決されたホスト名が +.Ar len +よりも長ければ、ホスト名の代わりにドットで区切られたアドレスが使われます。 +これによりフィールドを超えるようなとても長いホスト名を +一意にに特定できるようにします。 +.Fl u0 +を指定することによって、ドットで区切られたアドレスだけが +.Pa utmp +ファイルに書き込まれるようにします。 +.It Fl U +このオプションは +.Nm telnetd +が、 +.Xr gethostbyaddr 3 +ルーチンを通して symbolic name にマップされないようなアドレスからの +コネクションを拒絶するようにします。 +.It Fl X Ar authtype +このオプションは +.Nm telnetd +が認証オプションをサポートする設定で構築されたときにのみ有効です。 +.Ar authtype +認証を使用不能にし、 +.Nm telnetd +を再コンパイルすることなしに +特定の認証タイプを一時的に使用不能にする事が出来ます。 +.El +.Pp +.Nm telnetd +は仮想端末デバイス( +.Xr pty 4 +参照)をクライアントに割り当てます。 +そして、 +.Dv stdin , +.Dv stdout +と +.Dv stderr +として仮想端末のスレーブ側を使用する login プロセスを生成します。 +.Nm telnetd +は、 +.Tn TELNET +プロトコルを実装し、 +リモートクライアントと login プロセスとの間の +キャラクタを通過させることにより、仮想端末のマスター側を操作します。 +.Pp +.Tn TELNET +セッションが開始されると +.Nm telnetd +は以下の +.Tn TELNET +オプションをクライアント側に送信して、これらの +.Tn TELNET +オプションの使用を希望している事を伝えます。 +これらのオプションの詳細はついては以下に説明されています。 +.Bd -literal -offset indent +DO AUTHENTICATION +WILL ENCRYPT +DO TERMINAL TYPE +DO TSPEED +DO XDISPLOC +DO NEW-ENVIRON +DO ENVIRON +WILL SUPPRESS GO AHEAD +DO ECHO +DO LINEMODE +DO NAWS +WILL STATUS +DO LFLOW +DO TIMING-MARK +.Ed +.Pp +クライアントに割り当てられた仮想端末は、 +\*(lqcooked\*(rq +モードで動作し、 +.Dv XTABS +と +.Dv CRMOD +( +.Xr tty 4 +参照) が有効な状態で操作するように設定されます。 +.Pp +.Nm telnetd +は、ローカル側で有効な以下に示す +.Tn TELNET +オプションをサポートしています: +.Bl -tag -width "DO AUTHENTICATION" +.It "WILL ECHO" +.Dv LINEMODE +オプションが設定されている時に +端末エコーの現在の状態を示すためにクライアントに +.Dv WILL ECHO +あるいは +.Dv WONT ECHO +が送信されます。 +端末エコーが不要な場合は、 +.Tn telnetd +がエコーが必要なデータに対する +エコーを処理する事を示すために +.Dv WILL ECHO +が送信され、何もエコーされません。 +端末エコーが必要な場合は、 +.Tn telnetd +がいかなるターミナルエコーも +行わない事を示すために +.Dv WONT ECHO +が送信されるので、必要な時はターミナルエコーをクライアント側が +行わなければなりません。 +.It "WILL BINARY" +クライアントが、通常のネットワーク仮想端末が用いる7ビットのデータ +ではなく、8ビットのデータを送信するように指定します。 +.It "WILL SGA" +.Dv IAC GA +すなわち go ahead コマンドを送信しないように指定します。 +.It "WILL STATUS" +クライアントから要求があった時に、全ての +.Tn TELNET +オプションの現在の状況を送信するように指定します。 +.It "WILL TIMING-MARK" +.Dv DO TIMING-MARK +コマンドが受信された場合に、常にそれに対して +.Dv WILL TIMING-MARK +を返答します。 +.It "WILL LOGOUT" +.Dv DO LOGOUT +が受信されると +.Dv WILL LOGOUT +を返答し、 +.Tn TELNET +セッションはシャットダウンされます。 +.It "WILL ENCRYPT" +.Nm telnetd +がデータの暗号化をサポートする設定で構築された場合のみ送信され、 +データ列に対して暗号の復号するように指定します。 +.El +.Pp +.Nm telnetd +はリモート側で有効な以下に示す +.Tn TELNET +オプションをサポートしています: +.Bl -tag -width "DO AUTHENTICATION" +.It "DO BINARY" +.Tn telnetd +が8ビットのデータ列を受信するように指定します。 +.It "DO LFLOW" +クライアントがフロー制御文字をリモート側で処理するように指定します。 +.It "DO ECHO" +このコマンドは実際にはサポートされないが、クライアントが 4.2BSD +.Xr telnet 1 +クライアント( +.Dv WILL ECHO +に正しく応答しない)であるかを判断するために送信されます。 +もし、 +.Dv WILL ECHO +が受信された場合は、それに対して +.Dv DONT ECHO +が送信されます。 +.It "DO TERMINAL-TYPE" +接続のクライアント側に割り当てられたターミナルタイプの名前を +要求できるように指定します。 +.It "DO SGA" +.Dv IAC GA +すなわち go ahead コマンドを受信する必要がないように指定します。 +.It "DO NAWS" +ウィンドウ(ディスプレイ)のサイズが変わった場合に、クライアントが +それをサーバーに知らせる事を要求します。 +.It "DO TERMINAL-SPEED" +クライアントに割り当てられたシリアルラインの速度に関する情報を +要求できるように指定します。 +.It "DO XDISPLOC" +telnet クライアントが使用している X ウィンドウのディスプレイの名前を +要求できるように指定します。 +.It "DO NEW-ENVIRON" +RFC 1572 に示されている環境変数に関する情報を +要求できるように指定します。 +.It "DO ENVIRON" +RFC 1408 に示されている環境変数に関する情報を +要求できるように指定します。 +.It "DO LINEMODE" +.Nm telnetd +が linemode をサポートする設定で構築された場合のみ送信され、 +クライアントに行単位の処理を行う事を要求します。 +.It "DO TIMING-MARK" +.Nm telnetd +が linemode および kludge linemode の両方をサポートする設定で +構築され、クライアントが +.Dv WONT LINEMODE +を返信した場合のみ送信されます。 +クライアントが +.Dv WILL TM +を返信した場合は、クライアントが kludge linemode を +サポートしていると判断されます。 +.Op Fl k +オプションによりこの機能を無効にする事ができます。 +.It "DO AUTHENTICATION" +.Nm telnetd +が認証機能をサポートする設定で構築された場合のみ送信され、 +自動ログインに使用する認証情報を受信するようにします。 +.It "DO ENCRYPT" +.Nm telnetd +がデータの暗号化をサポートする設定で構築された場合のみ送信され、 +データ列に対して暗号の復号するように指定します。 +.Sh 環境 +.Sh ファイル +.Pa /etc/services +.br +.Pa /etc/inittab +(UNICOS システムのみ) +.br +.Pa /etc/iptos +(サポートされている場合) +.br +.Pa /usr/ucb/bftp +(サポートされている場合) +.Sh "関連項目" +.Xr bftp 1 , +.Xr login 1 , +.Xr telnet 1 +(サポートされている場合) +.Sh 標準 +.Bl -tag -compact -width RFC-1572 +.It Cm RFC-854 +.Tn TELNET +PROTOCOL SPECIFICATION +.It Cm RFC-855 +TELNET OPTION SPECIFICATIONS +.It Cm RFC-856 +TELNET BINARY TRANSMISSION +.It Cm RFC-857 +TELNET ECHO OPTION +.It Cm RFC-858 +TELNET SUPPRESS GO AHEAD OPTION +.It Cm RFC-859 +TELNET STATUS OPTION +.It Cm RFC-860 +TELNET TIMING MARK OPTION +.It Cm RFC-861 +TELNET EXTENDED OPTIONS - LIST OPTION +.It Cm RFC-885 +TELNET END OF RECORD OPTION +.It Cm RFC-1073 +Telnet Window Size Option +.It Cm RFC-1079 +Telnet Terminal Speed Option +.It Cm RFC-1091 +Telnet Terminal-Type Option +.It Cm RFC-1096 +Telnet X Display Location Option +.It Cm RFC-1123 +Requirements for Internet Hosts -- Application and Support +.It Cm RFC-1184 +Telnet Linemode Option +.It Cm RFC-1372 +Telnet Remote Flow Control Option +.It Cm RFC-1416 +Telnet Authentication Option +.It Cm RFC-1411 +Telnet Authentication: Kerberos Version 4 +.It Cm RFC-1412 +Telnet Authentication: SPX +.It Cm RFC-1571 +Telnet Environment Option Interoperability Issues +.It Cm RFC-1572 +Telnet Environment Option +.Sh バグ +いくつかの +.Tn TELNET +コマンドは部分的にしか実装されていまいません。 +.Pp +オリジナルの 4.2 BSD の +.Xr telnet 1 +のバグに対処するため、 +.Nm telnetd +は、ある種のあいまいなプロトコル変換を行うことにより、 +リモートクライアントが実際に 4.2 BSD の +.Xr telnet 1 +であるかどうかを判断しようとします。 +.Pp +バイナリモードは +よく似たオペレーティングシステム(この場合 Unix)間以外では +互換性がありません。 +.Pp +リモートクライアントから受け取った端末タイプの名前は小文字に変換されます。 +.Pp +.Nm telnetd +は、 +.Tn TELNET +.Dv IAC GA +(go ahead) コマンドを絶対に送りません。 diff --git a/ja_JP.eucJP/man/man8/tftpd.8 b/ja_JP.eucJP/man/man8/tftpd.8 new file mode 100644 index 0000000000..6322ec2cfa --- /dev/null +++ b/ja_JP.eucJP/man/man8/tftpd.8 @@ -0,0 +1,127 @@ +.\" Copyright (c) 1983, 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. +.\" +.\" 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. +.\" +.\" @(#)tftpd.8 8.1 (Berkeley) 6/4/93 +.\" jpman %Id: tftpd.8,v 1.3 1997/07/22 17:00:36 horikawa Stab % +.\" +.Dd June 4, 1993 +.Dt TFTPD 8 +.Os BSD 4.2 +.Sh 名称 +.Nm tftpd +.Nd +インターネット TFTP (Trivial File Transfer Protocol) サーバ +.Sh 書式 +.Nm tftpd +.Op Fl l +.Op Fl n +.Op Fl s Ar directory +.Op Ar directory ... +.Sh 解説 +.Nm tftpd +は、インターネット TFTP プロトコル ( +.Tn RFC 783 +) を提供するサーバです。 +.Tn TFTP +サーバは、 +.Ql tftp +サービス定義で指示されたポートを操作します。 +.Xr services 5 +を参照してください。 +このサーバは普通 +.Xr inetd 8 +によって起動されます。 +.Pp +.Xr tftp 1 +の利用には、リモートシステムのアカウントやパスワードを必要としません。 +認証情報がありませんので、 +.Nm tftpd +はパブリックに読み込み可能なファイルだけしかアクセスを許可しません。 +文字列 ``/\|\fB.\|.\fP\|/'' を含んだファイル、もしくは +``\|\fB.\|.\fP\|/'' から始まるファイルのアクセスは許可されません。 +ファイルは、既に存在してパブリックに書き込み可能な場合だけ +書き込まれます。 +.Dq パブリック (public) +という概念は、ネットワークを通して到達可能な全てのホストの全てのユーザ +を含むように拡張されている点に注意してください。 +これは全てのシステムにおいて適当ではないかも知れないし、 +そのことは tftp サービスを有効にする前に考慮すべきです。 +サーバは、もっとも可能な限り小さな権限を持ったユーザ ID を +持たねばなりません。 +.Pp +ファイルへのアクセス制限は、 +.Nm tftpd +起動時のディレクトリリストを、 +.Pa /etc/inetd.conf +にサーバプログラムへの引数として 20 までのパス名を指定することにより可能です。 +この場合、アクセスは、ファイル名がそこで与えられたディレクトリを +頭に付けたものに制限されます。 +与えられたディレクトリは、相対ファイル指定要求に対しての探索パスと +しても利用されます。 +.Pp +chroot オプションは、 tftpd のアクセスを chroot されたファイルシステム +だけに制限することで、セキュリティを追加します。 +これは、ブートサーバとして +.Nm -s +を提供している OS から実行する時に便利です。 +chroot の実行は root に制限されていますので、tftpd は root で +実行しなければなりません。しかしながら、 chroot した場合、 +.Nm tftpd +はユーザ id を nobody に設定します。 +.Pp +以下のようなオプションがあります。 +.Bl -tag -width Ds +.It Fl l +全ての要求を +.Xr syslog 3 +を使ってログ保存します。 +.It Fl n +存在しない相対ファイル名に対する要求の否定応答を抑止します。 +.It Fl s Ar directory +コマンドを受け取る前に tftpd を +.Pa directory +へ chroot させます。更に、ユーザ id を nobody にします。 +.Pp +.Fl s +を使用しない場合、ユーザ id の変更は試みられません。 +.Fl s +を使用しない場合は、 +.Nm +を root で実行してはなりません。 +.El +.Sh 関連項目 +.Xr tftp 1 , +.Xr inetd 8 +.Sh 歴史 +.Nm +コマンドは、 +.Bx 4.2 +から導入されました。 diff --git a/ja_JP.eucJP/man/man8/timed.8 b/ja_JP.eucJP/man/man8/timed.8 new file mode 100644 index 0000000000..1251c4263e --- /dev/null +++ b/ja_JP.eucJP/man/man8/timed.8 @@ -0,0 +1,210 @@ +.\" Copyright (c) 1980, 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. +.\" +.\" 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. +.\" +.\" @(#)timed.8 8.1 (Berkeley) 6/6/93 +.\" jpman %Id: timed.8,v 1.2 1997/05/17 16:08:46 horikawa Stab % +.\" +.Dd June 6, 1993 +.Dt TIMED 8 +.Os BSD 4.3 +.Sh 名称 +.Nm timed +.Nd タイムサーバデーモン +.Sh 書式 +.Nm timed +.Op Fl M +.Op Fl t +.Op Fl d +.Op Fl i Ar network +.Op Fl n Ar network +.Op Fl F Ar host1 host2 ... +.Sh 解説 +本コマンドは、タイムサーバデーモンであり、通常はブート時に +.Xr rc 8 +ファイル内の記述に従って起動されます。本コマンドにより、ホストと、 +.Nm timed +を実行しているローカルネットワーク上のマシンとの時刻の同期を取ります。 +これらのタイムサーバは、 +マシン時刻の刻みを遅らせたり進ませたりすることで、それらのマシンの時計を +ネットワーク平均時間に補正します。 +.Tn ICMP +タイムスタンプリクエストメッセージを用いることで、 +マシン間の時刻差分を計測し、ネットワーク平均時間を計算します。 +.Pp +.Nm timed +によって提供されるサービスは、マスタ−スレーブ構造に基づいて構成されています。 +.Nm timed +がマシン上で動作し始めると、 +.Nm timed +は、マスタサーバにネットワーク時刻を問い合わせ、自マシンの時刻を設定します。 +この後、マスタサーバから送られる同期メッセージを定期的に受け取り、 +マシン時間の補正が必要な場合には +.Xr adjtime 2 +を呼び出します。 +.Pp +本コマンドは、時刻を大域的に設定するために +.Xr date 1 +と通信し、timed 制御プログラムである +.Xr timedc 8 +と通信します。 +マスタサーバが走行しているホストがクラッシュした場合、 +スレーブマシンらは、 +.Fl M +フラグ付きで動作しているスレーブの内から新たなマスタサーバを選びます。 +.Fl M +や +.Fl F +オプションを付加しないで動作している +.Nm timed +は、スレーブのままです。 +.Fl t +フラグは、 +.Nm timed +が受信するメッセージを +.Pa /var/log/timed.log +へ記録するようにします。このトレース機能は、 +.Xr timedc 8 +を用いてオン/オフを変更できます。 +.Fl d +フラグは、デーモンのデバッグのためのオプションです。 +本オプションは、プログラムをバックグラウンド実行しないようにします。通常、 +.Nm timed +は、接続されているネットワーク上のマスタタイムサーバをチェックしますが、 +以下に記述のあるオプションを指定して動作を変更した場合にはこの限りでは +ありません。 +最初に発見したマスタタイムサーバに対し同期サービスを要求します。 +.Fl M +オプションが有効な場合、 +接続されているネットワークにてマスタサーバが存在しない時には、 +同期サービスを他のマシンに提供します。 +その場合、サーバはトップレベルマスタによって計算された時刻を取得し、 +他のマシンに通知します。 +.Fl n +フラグと共に当ホストが接続されたネットワーク名 +( +.Xr networks 5 +を参照)を指定すると、 +ネットワークアドレスに関する当プログラムのデフォルト選択を無効にします。 +.Fl n +フラグが指定されるごとに、ネットワーク名は正当なネットワーク名のリストに +追加されます。他のすべてのネットワークは無視されます。 +.Fl i +フラグと共に当ホストが接続されたネットワーク名 +( +.Xr networks 5 +を参照)を指定すると、 +ネットワークアドレスに関する当プログラムのデフォルト選択を無効にします。 +.Fl i +フラグが指定されるごとに無視すべきネットワーク名のリストに +当該ネットワーク名が追加されます。 +他のすべてのネットワークはデーモンが使用します。 +.Fl n +と +.Fl i +は、同時に使用できません。 +.Pp +.Nm timed +は、接続されているネットワーク上のマスタタイムサーバをチェックします。しかし、 +.Fl n +や +.Fl i +オプションによってその動作が変更されている場合にはその限りではありません。 +複数のマスタタイムサーバが複数のネットワーク上に存在する場合、デーモンは +“スレーブ” になるためのネットワークを 1つ選び、 +マスタサーバが見つからなくなった場合のために、 +定期的に他のネットワークをチェックします。 +.Pp +マシン群の同期をとるための 1つの方法として、NTP デーモンを用いてあるマシン +の時刻を遠距離の標準時刻や電波受信機の時刻に同期させ、かつ、信頼できる +マシンは自分自身だけであることを timed デーモンに +.Fl F Ar hostname +によって通知する、といったものがあります。 +.Pp +カーネルによるシステムコンソールへのメッセージ出力は、 +割り込み禁止にて行われます。 +このことは、メッセージが出力されている +間はシステム時計が停止していることを示します。 +ディスクやネットワークハードウェアに多くの問題を抱え、 +その結果としてメッセージが出力するマシンは、正確な時刻を保持出来ません。 +それぞれのメッセージは、多くは出力されるごとに 10ms 程度の時刻遅延 +を引き起こします。タイムデーモンはこの結果を補正します。 +.Pp +マシンが返答しないというシステムログメッセージは、通常、 +当該マシンがクラッシュまたは動作停止したことを示します。 +マシンの初期時刻設定時の返答失敗に関する不平は、大概の場合、 +“マルチホーム” のマシンが複数のネットワークでタイムマスタを探した後、 +別のネットワークにおいてスレーブになることを選択したことを示します。 +.Sh 警告 +もし +.Nm timed +や +.Xr NTP +のような 2 つ以上の時刻デーモンが同じ時計を更新しようとした場合に、 +一時的に時刻がおかしくなる可能性があります。 +.Nm +と他のタイムデーモンが同じマシン上で走行している場合には、 +.Fl F +オプションを使用していることを確認して下さい。これは、 +.Nm timed +がローカルマシンの時計を更新しないようにするためです。 +.Pp +なお、このデーモンが使用するネットワークプロトコルは、 +UDP/IP ブロードキャストに基づいています。 +ブロードキャスト範囲内で TSP プロトコルを用いるすべてのマシンは +協調しあわなければなりません。 +ブロードキャストパケットが届くマシン間では、 +.Fl F +フラグを使用する管理ドメインを 2 つ以上持つことはできません。 +このルールに従わないと、通常、"信用できない" マシンに関する不平が +システムログに書かれます。 +.Sh 関連ファイル +.Bl -tag -width /var/log/timed.masterlog -compact +.It Pa /var/log/timed.log +timed のトレースファイル +.It Pa /var/log/timed.masterlog +マスタ timed 用のトレースファイル +.El +.Sh 関連項目 +.Xr date 1 , +.Xr adjtime 2 , +.Xr gettimeofday 2 , +.Xr icmp 4 , +.Xr timedc 8 +.Rs +.%T "TSP: The Time Synchronization Protocol for UNIX 4.3BSD" +.%A R. Gusella +.%A S. Zatti +.Re +.Sh 歴史 +.Nm +デーモンは +.Bx 4.3 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/timedc.8 b/ja_JP.eucJP/man/man8/timedc.8 new file mode 100644 index 0000000000..1b1b4d5a5a --- /dev/null +++ b/ja_JP.eucJP/man/man8/timedc.8 @@ -0,0 +1,147 @@ +.\" Copyright (c) 1980, 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. +.\" +.\" 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. +.\" +.\" @(#)timedc.8 8.1 (Berkeley) 6/6/93 +.\" jpman %Id: timedc.8,v 1.3 1997/07/26 22:14:11 horikawa Stab % +.\" +.Dd June 6, 1993 +.Dt TIMEDC 8 +.Os BSD 4.3 +.ad +.Sh 名称 +.Nm timedc +.Nd timed の動作を制御する +.Sh 書式 +.Nm timedc +.Oo Ar command\ \& +.Op Ar argument ... +.Oc +.Sh 解説 +.Nm timedc +は、 +.Xr timed 8 +を制御するために使用します。具体的には、以下に示す機能を有します。 +.Bl -bullet +.It +複数のマシン間の時刻の差の計測 +.It +マスタタイムサーバの所在の検索 +.It +.Xr timed 8 +が受信したメッセージのトレースの有効/無効の切替え +.It +様々なデバッグ動作 +.El +.Pp +.Nm timedc +を引数なしで起動した場合、 +.Nm timedc +はプロンプトを表示し、標準入力からの +コマンド入力待ちの状態になります。起動時に引数を指定した場合、 +.Nm timedc +は、最初の引数をコマンドとして、残りの引数をそのコマンドのパラメータとして +解釈します。 +また +.Nm timedc +は、標準入力の代わりにリダイレクションを使用してファイルからコマンドを +読み込むこともできます。 +コマンドは短縮可能です; 使用可能なコマンドは以下の通りです: +.Bl -tag -width Ds -compact +.It Ic \&? Op Ar command ... +.Pp +.It Ic help Op Ar command ... +引数リストに指定されたコマンドについての簡単な説明を表示します。 +引数を指定しない場合は、 +使用可能なコマンドの一覧を表示します。 +.Pp +.It Ic clockdiff Ar host ... +.Nm timedc +を実行したマシンの時刻と、引数で指定したマシンの時刻 +の比較を行ない、その結果を表示します。 +.Pp +.It Ic msite Op Ar host ... +.Ar host +で指定したホストのマスタタイムサーバを表示します。 +.It Xo +.Ic trace +.Li \&{ Ar on Li \&| +.Ar off \&} +.Xc +.Xr timed 8 +へのメッセージの +.Pa /var/log/timed.log +への記録の有効/無効を指定します。 +.It Ic election Ar host +.Ar host +で指定したホスト上の timed デーモンに対し、"election" タイマをリセットし、 +新たにマスタタイムサーバが選択されていることを確実にするよう要求します。 +.Pp +.It Ic quit +timedc を終了します。 +.El +.Pp +上記以外のコマンドも、 +.Xr timed 8 +のテストやデバッグのために実装してあります。 +それらのコマンドについては、 +.Nm timedc +の help コマンドを用いたり、本コマンドのソースを参照するなどして調べて下さい。 +.Sh 関連ファイル +.Bl -tag -width /var/log/timed.masterlog -compact +.It Pa /var/log/timed.log +timed 用のトレースファイル。 +.It Pa /var/log/timed.masterlog +マスタ timed 用のログファイル。 +.El +.Sh 関連項目 +.Xr date 1 , +.Xr adjtime 2 , +.Xr icmp 4 , +.Xr timed 8 +.Rs +.%T "TSP: The Time Synchronization Protocol for UNIX 4.3BSD" +.%A R. Gusella +.%A S. Zatti +.Re +.Sh 診断 +.Bl -tag -width Ds -compact +.It ?Ambiguous command +省略入力に該当するコマンドが複数存在します。 +.It ?Invalid command +該当するコマンドが見つかりません。 +.It ?Privileged command +本コマンドは、root 権限でのみ実行できます。 +.El +.Sh 歴史 +.Nm +コマンドは +.Bx 4.3 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/traceroute.8 b/ja_JP.eucJP/man/man8/traceroute.8 new file mode 100644 index 0000000000..5896caa481 --- /dev/null +++ b/ja_JP.eucJP/man/man8/traceroute.8 @@ -0,0 +1,321 @@ +.\" Copyright (c) 1989, 1995, 1996 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms are permitted +.\" provided that the above copyright notice and this paragraph are +.\" duplicated in all such forms and that any documentation, +.\" advertising materials, and other materials related to such +.\" distribution and use acknowledge that the software was developed +.\" by the University of California, Berkeley. The name of the +.\" University may not be used to endorse or promote products derived +.\" from this software without specific prior written permission. +.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR +.\" 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 1996/10/08 02:44:23 sef Exp % +.\" +.\" jpman %Id: traceroute.8,v 1.2 1997/05/13 00:58:05 mutoh Stab % +.\" +.TH TRACEROUTE 8 "27 September 1996" +.UC 6 +.SH 名称 +traceroute \- パケットがネットワーク上のホストまでにたどる経路を表示する +.SH 書式 +.. while ((op = getopt(argc, argv, "dnrvg:m:p:q:s:t:w:")) != EOF) +.na +.B traceroute +[ +.B \-Sdnrv +] [ +.B \-g +.I gw_host +] [ +.B \-m +max_ttl +.I ] +.br +.ti +8 +[ +.B \-p +.I port +] [ +.B \-q +.I nqueries +] [ +.B \-s +.I src_addr +] +.br +.ti +8 +[ +.B \-t +.I tos +] [ +.B \-w +.I waittime +] +.I host +[ +.I packetlen +] +.ad +.SH 解説 +インターネットはネットワーク機器の巨大で複雑な集合体で、 +ゲートウェイによって互いに接続されています。 +パケットの流れを追跡すること (あるいはパケットを破棄する悪い +ゲートウェイを見つけること) は大変難しい仕事になり得ます。 +.I traceroute +は IP プロトコルの `time to live' フィールドを利用して、 +あるホストまでの経路上の全てのゲートウェイから +ICMP TIME_EXCEEDED +レスポンスを引き出そうと試みます。 +.PP +唯一の必須パラメータは目的地のホスト名 (IP アドレスでも可) です。 +プローブパケットの長さはデフォルトで 40 バイトですが、 +目的のホスト名の後にパケットサイズを (バイト単位で) 指定することによって +大きくすることもできます。 +.PP +その他のオプションを以下で説明します。 +.TP +.B \-S +各ホップについて、 +どれだけの確認パケットに返答が無かったかのまとめを表示します。 +.TP +.B \-g +粗く、ソースルーティングのためのゲートウエイを指定します。 +最大 8 つ指定できます。 +.TP +.B \-m +送出されるプローブパケットの最大 time-to-live (最大ホップ数) をセットします。 +デフォルトは 30 ホップ (TCP と同じデフォルト値) です。 +.TP +.B \-n +ゲートウェイのアドレスをホスト名と IP アドレスではなく +IP アドレスだけで表示します +(ネームサーバへの IP アドレスからホスト名への変換問い合わせを省きます)。 +.TP +.B \-p +プローブに使用する UDP ポート番号 (デフォルトは 33434) の +基準値 (base) を指定します。 +.I traceroute +は目的のホストにおいて、 +.I base +から +.I base+nhops-1 +までの UDP ポートで listen していないことを期待します +(そして ICMP PORT_UNREACHABLE +メッセージが経路追跡を終了させるために返って来ます)。 +デフォルトの範囲のポートで listen されているものがある場合は、 +このオプションを用いて使用されていない範囲のポートを +使用することができます。 +.TP +.B \-r +通常のルーティングテーブルを使用しません。 +プローブパケットを接続されているネットワーク上のホストに直接送出します。 +そのホストが直接接続されたネットワーク上にない場合には +エラーが返ります。 +このオプションは、 +経路を持たないインタフェースを介してローカルホストに ping する場合 +(たとえば、 +.IR routed 8 +によってインタフェースが消された後) に使用することができます。 +.TP +.B \-s +送出されるプローブパケットのソースアドレス (送出するアドレス) として、 +引数の IP アドレス (ホスト名ではなく、数字で指定して下さい) を用います。 +複数の IP アドレスを持つホストで、 +プローブパケットに別のソースアドレスを +持たせるのに使用することができます。 +指定した IP アドレスが、このホストのインタフェースのアドレスのうちの +1 つでない場合、エラーが返され何も送出されません。 +.TP +.B \-t +プローブパケットの +.I type-of-service +に引数の値 (デフォルトは 0) を指定します。 +値は 0 から 255 までの十進数です。 +.I type-of-service +の値によって、経路が異なるのかを見るために、 +このオプションを使用することができます。 +(telnet や ftp のような通常のネットワークサービスは、 +TOS を制御することはできないので、 +4.4bsd +以降のシステムでなければ、このオプションの実際的な意味はありません。) +全ての TOS の値に意味があるわけではありません。 +定義については IP の詳細を参照してください。 +おそらく、`\-t 16' (low delay) や `\-t 8' (high throughput) が +有益な値でしょう。 +.TP +.B \-v +冗長モードです。 +TIME_EXCEEDED と UNREACHABLE +以外の受信した ICMP パケットを表示します。 +.TP +.B \-w +プローブパケットの応答時間 (デフォルトは 5 秒) を (秒単位で) 指定します。 +.PP +このプログラムは、IP パケットが +あるホストに到達するまでにたどる経路を追跡するものです。 +UDP プローブパケットを小さな ttl (time to live) で送出し、 +ゲートウェイから ICMP "time exceeded" が返ってくるのを待ちます。 +まず、プローブを ttl 1 から始め、(ホストに到達したことを意味する) +ICMP "port unreachable" を受け取るまで、 +あるいは最大 (デフォルトは 30 ですが、 \-m フラグで変更できます) +になるまで ttl を 1 づつ増やします。 +各 ttl に対して、3 個 (\-q フラグで変更可能です) のプローブが送出され、 +ttl、ゲートウェイのアドレス、各プローブの往復時間を 1 行に表示します。 +異なるゲートウェイからプローブが返ってきた場合は、 +それぞれのシステムのアドレスを表示します。 +5 秒 (\-w フラグで変更します) 以内に反応がない場合は、 +各プローブに対して "*" を表示します。 +.PP +目的のホストのポートが不適当な値に設定されているために、 +UDP プローブパケットが処理されてしまうことを我々は望みません。 +(目的のホストがその値を使用している場合、\-p フラグで +変更することができます。) +.PP +使用と出力の例 : + +.RS +.nf +[yak 71]% traceroute nis.nsf.net. +traceroute to nis.nsf.net (35.1.1.48), 30 hops max, 38 byte packet + 1 helios.ee.lbl.gov (128.3.112.1) 19 ms 19 ms 0 ms + 2 lilac-dmc.Berkeley.EDU (128.32.216.1) 39 ms 39 ms 19 ms + 3 lilac-dmc.Berkeley.EDU (128.32.216.1) 39 ms 39 ms 19 ms + 4 ccngw-ner-cc.Berkeley.EDU (128.32.136.23) 39 ms 40 ms 39 ms + 5 ccn-nerif22.Berkeley.EDU (128.32.168.22) 39 ms 39 ms 39 ms + 6 128.32.197.4 (128.32.197.4) 40 ms 59 ms 59 ms + 7 131.119.2.5 (131.119.2.5) 59 ms 59 ms 59 ms + 8 129.140.70.13 (129.140.70.13) 99 ms 99 ms 80 ms + 9 129.140.71.6 (129.140.71.6) 139 ms 239 ms 319 ms +10 129.140.81.7 (129.140.81.7) 220 ms 199 ms 199 ms +11 nic.merit.edu (35.1.1.48) 239 ms 239 ms 239 ms +.fi +.RE + +2 行目と 3 行目が同じであることに注意して下さい。 +これは、2番目のシステム \- lbl-csam.arpa \- が、 +ttl 0 のパケットを転送するという (4.3BSD に含まれる) バグを +持ったカーネルであることによるものです。 +また、NSFNet (129.140) はアドレスをホスト名に変換してくれないので、 +パケットがどの経路をたどったのかを +推測する必要があることに注意して下さい。 +.PP +もっと興味深い例 : + +.RS +.nf +[yak 72]% traceroute allspice.lcs.mit.edu. +traceroute to allspice.lcs.mit.edu (18.26.0.115), 30 hops max + 1 helios.ee.lbl.gov (128.3.112.1) 0 ms 0 ms 0 ms + 2 lilac-dmc.Berkeley.EDU (128.32.216.1) 19 ms 19 ms 19 ms + 3 lilac-dmc.Berkeley.EDU (128.32.216.1) 39 ms 19 ms 19 ms + 4 ccngw-ner-cc.Berkeley.EDU (128.32.136.23) 19 ms 39 ms 39 ms + 5 ccn-nerif22.Berkeley.EDU (128.32.168.22) 20 ms 39 ms 39 ms + 6 128.32.197.4 (128.32.197.4) 59 ms 119 ms 39 ms + 7 131.119.2.5 (131.119.2.5) 59 ms 59 ms 39 ms + 8 129.140.70.13 (129.140.70.13) 80 ms 79 ms 99 ms + 9 129.140.71.6 (129.140.71.6) 139 ms 139 ms 159 ms +10 129.140.81.7 (129.140.81.7) 199 ms 180 ms 300 ms +11 129.140.72.17 (129.140.72.17) 300 ms 239 ms 239 ms +12 * * * +13 128.121.54.72 (128.121.54.72) 259 ms 499 ms 279 ms +14 * * * +15 * * * +16 * * * +17 * * * +18 ALLSPICE.LCS.MIT.EDU (18.26.0.115) 339 ms 279 ms 279 ms +.fi +.RE + +l2, 14, 15, 16, 17 番目のゲートウェイが +ICMP "time exceeded" メッセージを送出していないか、 +あるいは送出された ICMP "time exceeded" メッセージの ttl が小さいために、 +こちらに到達しないのでしょう。 +14 から 17 番目のホストでは、"time exceeded" を送出しない +MIT C Gateway コードが稼動しています。 +12 番目で何が起こっているのかは、神のみぞ知るところです。 +.PP +上記の 12 番目のゲートウェイが反応しないのは、4.[23] BSD +ネットワークコード (かその派生プログラム) のバグのせいでしょう。 +4.x (x <= 3)では、元のデータグラムに残っている ttl がどんな値であっても、 +それを用いて unreachable メッセージを送出します。 +よって、ゲートウェイに対して残っている ttlは 0 なので、 +ICMP "time exceeded" が戻ってこないことが保証されます。 +このバグが目的のシステム上であらわれた場合、 +さらにもう少し興味深いものとなります。 + +.RS +.nf + 1 helios.ee.lbl.gov (128.3.112.1) 0 ms 0 ms 0 ms + 2 lilac-dmc.Berkeley.EDU (128.32.216.1) 39 ms 19 ms 39 ms + 3 lilac-dmc.Berkeley.EDU (128.32.216.1) 19 ms 39 ms 19 ms + 4 ccngw-ner-cc.Berkeley.EDU (128.32.136.23) 39 ms 40 ms 19 ms + 5 ccn-nerif35.Berkeley.EDU (128.32.168.35) 39 ms 39 ms 39 ms + 6 csgw.Berkeley.EDU (128.32.133.254) 39 ms 59 ms 39 ms + 7 * * * + 8 * * * + 9 * * * +10 * * * +11 * * * +12 * * * +13 rip.Berkeley.EDU (128.32.131.22) 59 ms ! 39 ms ! 39 ms ! +.fi +.RE + +12 のゲートウェイ (13 番目は最終目的のホストです) があり、 +ちょうど半分のゲートウェイが失敗しています。 +これは、rip (Sun OS3.5 の稼働している Sun-3) が、 +到着したデータグラムの ttl を ICMP 応答の ttl としてそのまま使用すること +によるものです。 +経路の長さの少なくとも 2 倍の ttl のプローブが送出されるまで、( +ICMP に対して ICMP は送出されないので、誰にも気付かれずに) +帰りの経路上で応答がタイムアウトします。 +すなわち、実際には rip までに 7 ホップしかありません。 +ttlが 1 の応答は、問題解決の糸口になります。 +ttlが 1 以下の場合、 +.I traceroute +は時間の後に "!" を表示します。 +ベンダーは旧式の (DEC の Ultrix、Sun 3.x) あるいは標準でない +(HPUX) ソフトウェアを多く使用しているので、 +しばしばこの問題が起こることを承知して、 +プローブの目標のホストは注意して選んでください。 + +時間の後に付くその他の注釈には、 +.BR !H , +.BR !N , +.BR !P +(それぞれホスト、ネットワーク、プロトコルに到達不能というメッセージを +受け取った) や、 +.BR !S , +.BR !F +(ソースルーティングに失敗とフラグメンテーションが必要) や、 +.B !X +(管理上、通信が禁止されている) や、 +.B !<N> +(ICMP は コード N では到達できない) があります。 +ほとんど全てのプローブが到達不能であれば、 +.I traceroute +は送出を止め終了します。 +.PP +このコマンドはネットワークの検査、測定、管理のために使用するものです。 +本来は手動で障害を切り離すために使用されるべきものです。 +ネットワークにかかる負荷が大きいので、 +.I traceroute +を通常の操作や自動的なスクリプトで使用することは愚かなことです。 +.SH 関連項目 +netstat(1), ping(8) +.SH 作者 +Steve Deering の提案に基づき Van Jacobson によって実装されました。 +デバッグは何千もの人々、特に C.Philip Wood、 Tim Seaver と Ken Adelman +による説得力のある提案と修正によって行なわれました。 +.LP +現在のバージョンは匿名 ftp を使って以下のところから入手できます。 +.LP +.RS +.I ftp://ftp.ee.lbl.gov/traceroute.tar.Z +.RE +.SH バグ +バグレポートは、traceroute@ee.lbl.gov に送ってください。 diff --git a/ja_JP.eucJP/man/man8/trpt.8 b/ja_JP.eucJP/man/man8/trpt.8 new file mode 100644 index 0000000000..ef96c9d2e8 --- /dev/null +++ b/ja_JP.eucJP/man/man8/trpt.8 @@ -0,0 +1,139 @@ +.\" Copyright (c) 1983, 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. +.\" +.\" 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. +.\" +.\" @(#)trpt.8 8.2 (Berkeley) 12/11/93 +.\" jpman %Id: trpt.8,v 1.2 1997/05/25 15:20:26 horikawa Stab % +.\" +.Dd December 11, 1993 +.Dt TRPT 8 +.Os BSD 4.2 +.Sh 名称 +.Nm trpt +.Nd プロトコルトレースの表示 +.Sh 書式 +.Nm trpt +.Op Fl a +.Op Fl f +.Op Fl j +.Op Fl p Ar hex-address +.Op Fl s +.Op Fl t +.Oo +.Ar system Op Ar core +.Oc +.Sh 解説 +.Nm trpt +は、socket に +.Dq デバッグ情報の記録 +を指示した時 ( +.Xr setsockopt 2 +を参照) に生成される、 +.Tn TCP +のトレースレコードの内容を表示します。 +オプションを指定しない場合には、 +.Nm trpt +は、システム中のすべてのトレースレコードを、 +.Tn TCP +コネクションの +.Pq Tn PCB +(protocol control block) +によってグループ化して表示します。 +以下のオプションを使ってこの動作を変更することができます。 +.Bl -tag -width Ds +.It Fl a +通常の出力に加えて、 +記録された各パケットの送信元と宛先のアドレスを表示します。 +.It Fl f +トレースが記録される毎にそれを表示します。 +ログの終りまで表示すると、しばらく次のレコードを待ちます。 +.It Fl j +トレースレコードの存在する PCB (protocol control block) のアドレスの一覧を +表示します。 +.It Fl p +16 進数で指定されたアドレス( +.Ar hex-address +)にある PCB についてのトレースレコードのみを +表示します。 +.It Fl s +通常の出力に加えて、パケットのシーケンス情報の詳細を表示します。 +.It Fl t +通常の出力に加えて、トレースの各時点でのすべてのタイマの値を表示します。 +.El +.Pp +.Nm trpt +は、以下のようにして使ってみて下さい。 +問題となっているコネクションを切り分けて、それに関わる socket に対して +デバッグ機能を有効にします。 +.Xr netstat 1 +コマンドの +.Fl A +オプションを使用して、その socket の PCB のアドレスを見つけます。 +そして、 +.Fl p +オプションと PCB アドレスを引数にして +.Nm trpt +を実行します。 +.Fl f +オプションを使うと、一度見つけたトレースログを追い続けることができます。 +デバッグオプションを使っている socket がたくさんある場合には、 +問題になっている socket にトレースレコードがあるかどうかを +.Fl j +オプションによって確かめる事ができます。 +.Pp +デフォルト以外のカーネルやメモリイメージをデバッグしたいときには、 +最後の 2 つの引数で指定する事ができます。 +.Sh 関連ファイル +.Bl -tag -width /dev/kmem -compact +.It Pa /kernel +.It Pa /dev/kmem +.El +.Sh 関連項目 +.Xr netstat 1 , +.Xr setsockopt 2 , +.Xr trsp 8 +.Sh 診断 +.Bl -tag -width Ds +.It Sy no namelist +トレースバッファを見つけるのに必要なシンボルがシステムイメージに +見つかりません。 +その他のメッセージは読めば分かるでしょう。 +.El +.Sh バグ +入出力されたデータも表示するべきですが、トレースレコードには +記録されていません。 +.Pp +出力フォーマットは非常に難解なので、このマニュアルに説明されて +いるべきです。 +.Sh 履歴 +.Nm +コマンドは、 +.Bx 4.2 +で登場しました。 diff --git a/ja_JP.eucJP/man/man8/tunefs.8 b/ja_JP.eucJP/man/man8/tunefs.8 new file mode 100644 index 0000000000..150e5503aa --- /dev/null +++ b/ja_JP.eucJP/man/man8/tunefs.8 @@ -0,0 +1,147 @@ +.\" Copyright (c) 1983, 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. +.\" +.\" 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. +.\" +.\" @(#)tunefs.8 8.2 (Berkeley) 12/11/93 +.\" jpman %Id: tunefs.8,v 1.3 1997/07/26 22:16:10 horikawa Stab % +.\" +.Dd December 11, 1993 +.Dt TUNEFS 8 +.Os BSD 4.2 +.Sh 名称 +.Nm tunefs +.Nd 既存のファイルシステムをチューンする +.Sh 書式 +.Nm tunefs +.Op Fl A +.Op Fl a Ar maxcontig +.Op Fl d Ar rotdelay +.Op Fl e Ar maxbpg +.Op Fl m Ar minfree +.Op Fl p +.Bk -words +.Op Fl o Ar optimize_preference +.Ek +.Op Ar special | Ar filesys +.Sh 解説 +.Nm tunefs +は、ファイルシステムのレイアウト方針に影響する動的なパラメータを +変更するために使います。変更するパラメータは以下のフラグで指定します: +.Bl -tag -width Ds +.It Fl A +ファイルシステムはスーパブロックのバックアップをいくつか持っています。 +このオプションを指定すると、全てのバックアップの内容は +プライマリスーパブロックと同じく変更されます。 +これはかなりの危険を秘めています。実行する時は気をつけて下さい。 +.It Fl a Ar maxcontig +回転遅延 ( +.Fl d +を参照) が強制的に行われる前に連続して配置されるブロック数を指定します。 +ほとんどのデバイスドライバはディスク転送のたびに割り込みが必要なので、 +デフォルト値は 1 です。 +一度の転送でいくつかのバッファをつないで転送できるデバイスドライバでは、 +この値を最大の連結長にすべきです。 +.It Fl d Ar rotdelay +同じディスクに対する転送完了割り込みサービスと +次の転送を開始する時間の期待値をミリ秒単位で指定します。 +この値は、回転遅延によるファイル中のブロック間隔を決めるのに使います。 +.It Fl e Ar maxbpg +単一のファイルが他のシリンダグループへまたがる前に、1 つのシリンダグループ +から割り当てることのできる最大のブロック数を指定します。 +普通は、この値にはシリンダグループのブロック数の約 1/4 が使われます。 +この値は、単一のファイルが 1 つのシリンダグループのブロックを使いつくして +しまうことを防ぐために指定します。 +なぜなら、これによって、そのシリンダグループに続いて配置される +すべてのファイルのアクセス速度を低下させてしまうからです。 +この制限によって、大きなファイルに対しては 1 つのシリンダに配置するよりも、 +長いシークをより頻繁に行わせることがあります。 +極端に大きなファイルのあるファイルシステムに対しては、 +このパラメータは大きな値にすべきです。 +.It Fl m Ar minfree +一般ユーザが利用することができない領域の割合を指定します。 +これは最低限の空き領域のしきい値となります。 +デフォルト値は 8% です。 +この値はゼロにすることもできますが、10% のしきい値を設けた場合と比較し、 +アクセスの効率が最大 3 倍まで落ちてしまいます。 +5% 以下にすると常に最適化は space 優先になってしまい、 +ファイル書き込みのオーバーヘッドがかなり増えます。 +もしこの値を現在の空き領域より大きな値に引き上げると、 +ファイルを削除してその値を満たすだけの空き領域を用意するまで、 +ユーザはファイルを作成することができなくなります。 +.It Fl o Ar optimize_preference +ファイルシステムの最適化において、 +ブロック割り当てにかかる時間を最小化するか、 +もしくはディスク上のフラグメントサイズを最小にするかの +いずれかを選択できます。 +space 優先の場合、 +ファイル書き込みのオーバヘッドは大きくなります。 +カーネルは通常、 +ファイルシステムのフラグメントの割合に応じて自動的に優先を変化させます。 +.It Fl p +このオプションは、 +指定されたファイルシステムにおいて現在変更可能な設定のまとめを表示します。 +詳細は +.Xr dumpfs 8 +のマニュアルを参照してください。 +.El +.Sh 関連項目 +.Xr fs 5 , +.Xr dumpfs 8 , +.Xr newfs 8 +.Rs +.%A M. McKusick +.%A W. Joy +.%A S. Leffler +.%A R. Fabry +.%T "A Fast File System for UNIX" +.%J "ACM Transactions on Computer Systems 2" +.%N 3 +.%P pp 181-197 +.%D August 1984 +.%O "(reprinted in the BSD System Manager's Manual, SMM:5)" +.Re +.Sh バグ +このプログラムは、 +マウントされているファイルシステムに対しても動作すべきです。 +スーパブロックはバッファキャッシュ内に保存されていないため、 +実行の影響は、それをマウントされていないファイルシステムに +対して実行したときのみ現れます。 +ルートファイルシステムをチューンするには、チューン後に再起動する必要が +あります。 +.\" Take this out and a Unix Demon will dog your steps from now until +.\" the time_t's wrap around. +.Pp +ファイルシステムをチューンする事はできても、ファイルの中身まではチュー +ンできません:-) +.Sh 歴史 +.Nm +コマンドは +.Bx 4.2 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/tzsetup.8 b/ja_JP.eucJP/man/man8/tzsetup.8 new file mode 100644 index 0000000000..97e28b4dcc --- /dev/null +++ b/ja_JP.eucJP/man/man8/tzsetup.8 @@ -0,0 +1,65 @@ +.\" Copyright (c) 1996 Wolfram Schneider <wosch@FreeBSD.org>. Berlin. +.\" 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. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: tzsetup.8,v 1.3.2.1 1997/03/06 08:00:38 mpp Exp % +.\" jpman %Id: tzsetup.8,v 1.3 1997/07/22 17:04:38 horikawa Stab % + +.Dd Jan 1996 +.Dt TZSETUP 8 +.Os FreeBSD + +.Sh 名称 +.Nm tzsetup +.Nd ローカルタイムゾーンを設定する + +.Sh 解説 +.Nm tzsetup +は、メニューによるローカルタイムゾーンの設定を行うためのプログラムです。 +もっとも良くあなたの場所を表現している大陸と (例えば、あなたの首都の様な) +都市を選びます。すると +.Nm tzsetup +が全ての仕事を行ってくれます。 + +.Sh バグ +変更が効果を持つためには、機械をリブートする必要があります。 + +.Sh 関連ファイル +.Bl -tag -width /etc/wall_cmos_clock -compact +.It Pa /etc/localtime +現在のタイムゾーンのファイル +.It Pa /usr/share/zoneinfo +ゾーン情報ファイルのためのディレクトリ +.It Pa /etc/wall_cmos_clock +adjkerntz(8) を見てください。 +.El + +.Sh 関連項目 +.Xr date 1 , +.Xr adjtime 2 , +.Xr ctime 3 , +.Xr timezone 3 , +.Xr tzfile 5 , +.Xr adjkerntz 8 , +.Xr zdump 8 , +.Xr zic 8 diff --git a/ja_JP.eucJP/man/man8/umount.8 b/ja_JP.eucJP/man/man8/umount.8 new file mode 100644 index 0000000000..c83adfdf47 --- /dev/null +++ b/ja_JP.eucJP/man/man8/umount.8 @@ -0,0 +1,145 @@ +.\" Copyright (c) 1980, 1989, 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. +.\" +.\" 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. +.\" +.\" @(#)umount.8 8.1 (Berkeley) 2/20/94 +.\" jpman %Id: umount.8,v 1.3 1997/07/22 17:06:06 horikawa Stab % +.\" +.Dd February 20, 1994 +.Dt UMOUNT 8 +.Os BSD 4 +.Sh 名称 +.Nm umount +.Nd ファイルシステムのアンマウント +.Sh 書式 +.Nm umount +.Op Fl fv +.Ar special | node +.Nm umount +.Fl a +.Op Fl fv +.Op Fl h Ar host +.Op Fl t Ar ufs | lfs | external_type +.Sh 解説 +.Nm umount +コマンドは、 +.Ar "スペシャルデバイス (special device)" +もしくはリモートのノード (rhost:path) をファイルシステムツリーの +.Ar node +の位置から除去するために、 +.Xr unmount 2 +システムコールを呼び出します。 +.Ar special +か +.Ar node +のどちらか一方が指定されなかった時は、適当な情報が +.Xr fstab 5 +ファイルから入手されます。 +.Pp +以下のようなオプションがあります。 +.Bl -tag -width indent +.It Fl a +.Xr fstab 5 +に記述されている全てのファイルシステムをアンマウントします。 +.It Fl f +ファイルシステムを強制的にアンマウントします。 +利用されているスペシャルデバイスは使い続けようとしますが、 +更にアクセスしようとすると、全てのファイルはエラーを返します。 +ルートファイルシステムは強制的にアンマウントすることはできません。 +.It Fl h Ar host +指定されたホストからマウントしているファイルシステムだけをアンマウント +します。 +このオプションは +.Fl a +オプションを暗黙に指定し、 +.Fl t +オプションで他のものを指定しなければ、NFS ファイルシステムだけを +アンマウントします。 +.It Fl t Ar "ufs \\*(Ba lfs \\*(Ba external type" +指定されたタイプのファイルシステムだけを扱うように指示します。 +1 つ以上のタイプは、コンマ (``,'') で分けたリストで指定します。 +ファイルシステム形式のリストは、 +前に +.Dq no +を付けることで、その動作をそのファイルシステムに付いては行わない様に +指定することもできます。 +例えば、 +.Nm umount +コマンド +.Bd -literal -offset indent +umount -a -t nfs,mfs +.Ed +.Pp +は、ファイルシステムのタイプが +.Tn NFS +と +.Tn MFS +である全てのファイルをアンマウントします。 +.It Fl v +冗長モードです。アンマウントされる各ファイルシステムの追加情報が +出力されます。 +.El +.Sh 関連ファイル +.Bl -tag -width /etc/fstab -compact +.It Pa /etc/fstab +ファイルシステムテーブル +.El +.Sh 関連項目 +.Xr unmount 2 , +.Xr fstab 5 , +.Xr mount 8 +.Sh バグ +union ファイルシステムを使っている時は、 +.Xr umount 8 +は、常にマウントポイントであるノードを決定することができません。 +この場合、アンマウントするために +.Xr mount 8 +で表示されるのと同じ形式で適切なディレクトリを指定してやる必要が +あります。 +例えば、マウントエントリが以下のような場合、 +.Bd -literal -offset indent +<above>/tmpdir on /cdrom (local, user mount) +.Ed +.Pp +アンマウントのためのコマンドは、 +.Bd -literal -offset indent +umount '<above>/tmpdir' +.Ed +.Pp +となります。ここで、 +.Ar /tmpdir +は、マウントポイント +.Ar /cdrom +からアンマウントされます。 +.Sh 歴史 +.Nm umount +コマンドは +.At v6 +から導入されました。 diff --git a/ja_JP.eucJP/man/man8/uucico.8 b/ja_JP.eucJP/man/man8/uucico.8 new file mode 100644 index 0000000000..f8435709d3 --- /dev/null +++ b/ja_JP.eucJP/man/man8/uucico.8 @@ -0,0 +1,290 @@ +''' %Id: uucico.8,v 1.5 1995/08/19 21:29:57 ache Exp % +.\" jpman %Id: uucico.8,v 1.3 1997/09/07 14:14:55 horikawa Stab % +.TH uucico 8 "Taylor UUCP 1.06" +.SH 名称 +uucico \- UUCP ファイル転送デーモン +.SH 書式 +.B uucico +[ options ] +.SH 解説 +.I uucico +デーモンは、 +.I uucp +(1) および +.I uux +(1) によってキューに蓄積されたファイル転送リクエストの処理をします。 +.I uucico +は、( +.B \-r +オプションなしに) +.I uucp +あるいは +.I uux +が実行された時に実行を始めます。 +また、典型的な方法として、 +.I crontab +テーブルを用いて定期的に実行されます。 + +.B \-r1, +.B \-\-master, +.B \-s, +.B \-\-system +あるいは +.B \-S +オプションとともに起動された場合、デーモンはリモートシステムを呼び出し、 +マスタモードで動作します。それ以外の場合は、デーモンはスレーブモードで +動作し、リモートシステムからの呼び出しを受け付けます。典型的な方法として、 +UUCP 用の特別なログイン名が準備され、呼び出しを受けると +.I uucico +を自動的に起動するように設定されます。 + +.I uucico +が終了すると、 +.B \-q +あるいは +.B \-\-nouuxqt +が指定されていなければ、 +.I uuxqt +(8) デーモンを起動します。 +.I uuxqt +(8) は、リモートシステムの +.I uux +(1) によって作成された作業を実行し、また、待機していたリモートファイルの +受信によりローカルに作成された作業を実行します。 + +呼び出しが失敗すると、 +.I uucico +は、ある(設定可能な)時間が経過するまで、再呼び出しを拒否します。 +この動作は、 +.B -f, +.B --force +あるいは +.B -S +オプションにより無効にする事ができます。 + +.B \-l, +.B \-\-prompt, +.B \-e +あるいは +.B \-\-loop +オプションを使用する事で、 +.I uucico +に独自の "login:" および "Password:" プロンプトを生成させる事ができます。 +他のデーモンが呼び出して来た場合、このプロンプトを見て、通常通りに +ログインする事ができます。この場合、ログイン名およびパスワードは +.I /etc/passwd +ファイルではなく、 +.I uucico +専用に準備されたリストによりチェックされます。一部のシステムでは、 +.I uucico +が +.I /etc/passwd +ファイルを用いるようにする事も可能です。 +.B \-l +あるいは +.B \--prompt +オプションを用いると、プロンプトを一回だけ生成し、そのセッションが +終了するとプロセスも終了します。 +このモードでは、UUCP 管理者あるいはスーパユーザは +.B \-u +あるいは +.B \--login +オプションを用いてログイン名を指定する事ができます。この時、 +.I uucico +は "login:" プロンプトを生成しません。 +.B \-e +あるいは +.B \--loop +オプションを用いると、最初のセッションが終了すると再びプロンプトを生成 +します。このモードでは、 +.I uucico +は、ポートを永久的に制御します。 + +.I uucico +が SIGQUIT、SIGTERM あるいは SIGPIPE シグナルを受け取ると、 +現在のリモートシステムとのやり取りを中断し、終了します。 +.I uucico +が SIGHUP シグナルを受け取ると、現在のやり取りを中断しますが、 +.B \-r1 +あるいは +.B \-\-master +により起動された場合は、呼び出しを継続し、 +.B \-e +あるいは +.B \-\-loop +により起動された場合は、他のシステムからの呼び出しを受け付けます。 +.I uucico +が SIGINT シグナルを受け取った場合、現在のやり取りを終了し、 +それ以上の呼び出しや受付を行いません。 +.SH オプション +以下のオプションが +.I uucico +で使用可能です。 +.TP 5 +.B \-r1, \-\-master +マスタモードで動作します(他のシステムを呼び出します)。 +.B \-s, +.B \-\-system +あるいは +.B \-S +が指定されていれば、このオプションが指定されたと見なされます。 +システムが指定されていなければ、待機中の作業がある全てのシステムを呼び出します。 +.TP 5 +.B \-r0, \-\-slave +スレーブモードで動作します。デフォルトはこの設定です。 +.TP 5 +.B \-s system, \-\-system system +指定されたシステムを呼び出します。 +.TP 5 +.B \-S system +必要な待ち時間を無視して、指定されたシステムを呼び出します。 +.B \-s system \-f +と等価です。 +.TP 5 +.B \-f, \-\-force +呼び出しに際して、必要な待ち時間を無視します。 +.TP 5 +.B \-l, \-\-prompt +"login:" と "Password:" を表示してログイン名とパスワードの入力を +要求します。このオプションにより、 +.I uucico +を +.I inetd +(8) から起動することを容易にします。ログイン名およびパスワードは +UUCP パスワードファイルによりチェックされ、通常このファイルは +.I /etc/passwd +ファイルとは関連していません。 +.B \-\-login +オプションを用いてログイン名を指定する事ができます。この時、 +.I uucico +は、パスワードの入力のみを要求します。 +.TP 5 +.B \-p port, \-\-port port +呼び出しあるいは待ち受けに使用するポートを指定します。 +.TP 5 +.B \-e, \-\-loop +ログイン/パスワードの要求とスレーブモードデーモンでの実行の無限ループ +に入ります。プログラムは自分自身では終了しないので、終了させるためには +.I kill +(1) を使用する必要があります。 +.TP 5 +.B \-w, \-\-wait +( +.B \-s, +.B \-\-system +あるいは +.B \-S +が指定されていればそのシステムへの、単に +.B \-r1 +あるいは +.B \-\-master +が指定されていれば作業がある全てのシステムへの)呼び出しが終了すると、 +.B \-\-loop +が指定された場合同様、無限ループに入ります。 +.TP 5 +.B \-q, \-\-nouuxqt +終了後に、 +.I uuxqt +(8) デーモンの実行をしません。 +.TP 5 +.B \-c, \-\-quiet +その時間に全ての呼び出しが禁止されていた場合、呼び出しは行わず、 +ログファイルにエラーメッセージも記録せず、 +.I uustat +(1) で報告されるシステム状況も更新しません。 +このオプションは、どのシステムが現在呼び出し可能であるかを気にせずに +全てのシステムへの呼び出しを試すような、自動ポーリングスクリプトから +使用する場合に便利でしょう。さらに、このオプションを使用すると、 +作業が何もない事の記録も行いません。 +.TP 5 +.B \-C, \-\-ifwork +.B \-s, +.B \-\-system +あるいは +.B \-S +で指定されたシステムに対する作業がある場合のみ呼び出しを行います。 +.TP 5 +.B \-D, \-\-nodetach +制御端末の切り離しを行いません。通常、 +.I uucico +は他のシステムの呼び出しや +.I uuxqt +の実行に先立ち、端末を切り離します。 +このオプションはこの動作を防ぎます。 +.TP 5 +.B \-u name, \-\-login name +起動したユーザのログイン名の代わりに使用するログイン名を指定します。 +このオプションは UUCP 管理者あるいはスーパユーザのみが使用できます。 +.B \-\-prompt +とともに使用した場合、 +.I uucico +は、ログイン名の入力待ちはせず、パスワードの入力だけを待ちます。 +.TP 5 +.B \-z, \-\-try-next +リモートシステムに接続したあとに呼び出しが失敗した場合、 +単に終了するのではなく、次の選択肢を試行します。 +.TP 5 +.B \-i type, \-\-stdin type +標準入力を使用する場合のポートのタイプを指定します。サポートされる +唯一のタイプは TLI で、TLI ネットワークインターフェイスをサポートしている +マシンでしか使用する事ができません。 +.B \-iTLI +を指定すると、 +.I uucico +は、入出力を行う時に TLI 呼び出しを使用します。 +.TP 5 +.B \-x type, \-X type, \-\-debug type +特定のデバッグタイプを指定します。タイプとしては、 +abnormal, chat, handshake, uucp-proto, proto, port, +config, spooldir, execute, incoming, outgoing があります。 + +コンマで区切ることで複数のデバッグタイプが指定可能です。そして、 +.B \-\-debug +オプションは、1回のコマンド起動で複数回指定可能です。また、タイプとして +数字を指定することも可能です。 +例えば、 +.B \-\-debug 2 +は、 +.B \-\-debug abnormal,chat +と同じ意味です。 + +デバッグ出力は、デバッグファイルに記録されます。通常、デバッグファイルは、 +/var/spool/uucp/Debug, /usr/spool/uucp/DEBUG, +/usr/spool/uucp/.Admin/audit.local のいずれかです。 +.TP 5 +.B \-I file, \-\-config file +使用する初期設定ファイルの指定を行います。 +ただし、本オプションが使用可能かどうかは、 +.I uucico +がどのようにコンパイルされたかによります。 +.TP 5 +.B \-v, \-\-version +バージョンを表示し、終了します。 +.TP 5 +.B \-\-help +ヘルプを表示し、終了します。 +.SH 関連ファイル +関連ファイル名は、コンパイル時の指定ないしは初期設定ファイルにより +変化します。以下に挙げるものは、その一例です。 + +.br +/etc/uucp/config - 初期設定ファイル +.br +/etc/uucp/passwd - デフォルトの UUCP パスワードファイル +.br +/var/spool/uucp - +UUCP スプールディレクトリ +.br +/var/spool/uucp/Log - +UUCP ログファイル +.br +/var/spool/uucppublic - +デフォルトの UUCP パブリックディレクトリ +.br +/var/spool/uucp/Debug - +デバッグファイル +.SH 関連項目 +kill(1), uucp(1), uux(1), uustat(1), uuxqt(8) +.SH 作者 +Ian Lance Taylor +<ian@airs.com> diff --git a/ja_JP.eucJP/man/man8/uucpd.8 b/ja_JP.eucJP/man/man8/uucpd.8 new file mode 100644 index 0000000000..cb663ceecf --- /dev/null +++ b/ja_JP.eucJP/man/man8/uucpd.8 @@ -0,0 +1,68 @@ +.\" Copyright (c) 1983, 1989, 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. +.\" +.\" 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. +.\" +.\" @(#)rshd.8 8.1 (Berkeley) 6/4/93 +.\" %Id: uucpd.8,v 1.2 1996/08/23 20:36:11 mpp Exp % +.\" +.\" jpman %Id: uucpd.8,v 1.3 1997/09/04 16:43:12 horikawa Stab % +.Dd Feb 18, 1996 +.Dt UUCPD 8 +.Os BSD 4.4 +.Sh 名称 +.Nm uucpd +.Nd uucp ネットワークサーバ +.Sh 書式 +.Nm uucpd +.Sh 解説 +.Nm uucpd +は、ネットワーク経由での uucp 接続をサポートするサーバです。 +.Nm uucpd +は、``uucp'' サービスとして定められたポート( +.Xr services 5 +参照)を監視し、リクエストが来るのを待ちます。 +サーバは、ログイン名とパスワードによる認証を行った後、実際の転送を行う +.Nm uucico +を起動します。 +.Sh 関連項目 +.Xr services 5 , +.Xr inetd.conf 5 , +.Xr inetd 8 , +.Xr uucico 8 +.Sh 関連ファイル +.Bl -tag -width /etc/hosts -compact +.It Pa /etc/services +.It Pa /etc/inetd.conf +.El +.Sh 歴史 +.Nm uucpd +ユーティリティは、 +.Bx 4.3 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/uuxqt.8 b/ja_JP.eucJP/man/man8/uuxqt.8 new file mode 100644 index 0000000000..6eeabbf569 --- /dev/null +++ b/ja_JP.eucJP/man/man8/uuxqt.8 @@ -0,0 +1,113 @@ +''' %Id: uuxqt.8,v 1.4 1995/08/19 21:30:28 ache Exp % +.\" jpman %Id: uuxqt.8,v 1.2 1997/03/31 15:01:29 horikawa Stab % +.TH uuxqt 8 "Taylor UUCP 1.05" +.SH 名称 +uuxqt \- UUCP 実行デーモン +.SH 書式 +.B uuxqt +[ options ] +.SH 解説 +.B uuxqt +デーモンは、ローカルもしくはリモートシステムの +.I uux +(1) によって要求されたコマンドを実行します。このデーモンは +.I uucico +(8) によって自動的に実行開始されます。ただし、 +.I uucico +(8) デーモンが +.B \-q +オプションか +.B \-\-nouuxqt +オプションを付加して実行された場合にはこの限りではありません。 + +通常は、 +.I uucico +(8) から本コマンドを起動するため、本コマンドをユーザが直接実行する +必要はありません。しかし、処理キューの処理について、なんらかの融通を +きかせたい場合に本コマンドは有効です。 + +.I uuxqt +の複数同時起動については、初期化コマンドの +.I max-uuxqt +を用いることによって +同時起動最大数を制御することが出来ます。 +.SH オプション +以下のオプションが +.B uuxqt +で使用可能です。 +.TP 5 +.B \-c command, \-\-command command +引数 +.I command +で指定したコマンドの要求のみを実行します。例: +.br +.in +0.5i +.nf +uuxqt --command rmail +.fi +.in -0.5i +.TP 5 +.B \-s system, \-\-system system +指定したシステムからの要求のみを実行します。 +.TP 5 +.B \-x type, \-\-debug type +特定のデバッグタイプを有効にします。デバッグタイプとしては、 +abnormal, chat, handshake, uucp-proto, proto, port, +config, spooldir, execute, incoming, outgoing が有効です。 +なお、 +.I uuxqt +自体に意味のあるデバッグタイプは +abnormal, config, spooldir, execute +の 4 つだけです。 + +デバッグタイプに関しては、コンマで区切ることで複数指定が可能になります。 +.B \-\-debug +によるデバッグタイプ指定は、 +1 つのコマンドライン中に複数存在してもかまいません。 +数字による指定を行なうと、先述のリスト中、先頭から指定した番号までの +デバッグタイプが有効になります。例えば、 +.B \-\-debug 2 +と指定した場合は、 +.B \-\-debug abnormal,chat +と指定したのと同じです。 + +デバッグ出力は、デバッグファイルに記録されます。デバッグファイルは、通常は、 +/var/spool/uucp/Debug, /var/spool/uucp/DEBUG, +/var/spool/uucp/.Admin/audit.local +のいずれかです。 +.TP 5 +.B \-I file, \-\-config +使用するコンフィギュレーションファイルを指定します。しかし +このオプションが利用できるかできないかは +.I uuxqt +をどのようにコンパイルしたかに依存します。 +.TP 5 +.B \-v, \-\-version +バージョン情報を表示して終了します。 +.TP 5 +.B \-\-help +ヘルプメッセージを表示して終了します。 +.SH 関連ファイル +ファイル名は、コンパイル時もしくは +コンフィギュレーションファイルによって変更可能です。 +したがって、これは目安だと思って下さい。 + +.br +/etc/uucp/config - コンフィギュレーションファイル。 +.br +/var/spool/uucp - +UUCP スプールディレクトリ。 +.br +/var/spool/uucp/Log - +UUCP ログ記録ファイル。 +.br +/var/spool/uucppublic - +デフォルト時の UUCP パブリックディレクトリ。 +.br +/var/spool/uucp/Debug - +デバッグ情報ファイル。 +.SH 関連項目 +uucp(1), uux(1), uucico(8) +.SH 作者 +Ian Lance Taylor +(ian@airs.com) diff --git a/ja_JP.eucJP/man/man8/vipw.8 b/ja_JP.eucJP/man/man8/vipw.8 new file mode 100644 index 0000000000..f417060a03 --- /dev/null +++ b/ja_JP.eucJP/man/man8/vipw.8 @@ -0,0 +1,89 @@ +.\" %NetBSD: vipw.8,v 1.4 1995/01/20 19:19:56 mycroft Exp % +.\" +.\" Copyright (c) 1983, 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. +.\" +.\" 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. +.\" +.\" @(#)vipw.8 8.1 (Berkeley) 6/6/93 +.\" jpman %Id: vipw.8,v 1.2 1997/04/10 02:03:18 mutoh Stab % +.\" +.Dd June 6, 1993 +.Dt VIPW 8 +.Os BSD 4 +.Sh 名称 +.Nm vipw +.Nd パスワードファイルの編集 +.Sh 書式 +.Nm vipw +.Sh 解説 +.Nm vipw +は、適切なロックをしてパスワードファイルの編集を行い、 +ロックを解除した後で必要な処理を行います。すでに他のユーザによって +パスワードファイルが編集中でロックされていた場合には、 +.Nm vipw +は後で再度実行するように知らせます。 +デフォルトでは、 +.Xr vi 1 +がエディタとして使用されます。 +.Pp +.Nm vipw +はパスワードファイルエントリの多くの整合性をチェックし、「間違った」エントリを +含むパスワードファイルがインストールされないようにします。 +間違っていた場合にはユーザに再編集を要求します。 +.Pp +パスワードファイルの情報が正しいことが確かめられると、 +.Nm vipw +は +.Xr pwd_mkdb 8 +を使ってデータベースを更新します。これはバックグラウンドで行なわれ、 +大きなサイトでは数分かかります。 +この更新が終了するまで、他でパスワードファイルを更新したり、 +新しい情報をプログラムで利用することはできません。 +.Sh 環境変数 +以下の環境変数が +.Nm vipw +で参照されます。 +.Bl -tag -width EDITOR +.It Ev EDITOR +起動するエディタを指定します。指定がなければ +.Xr vi 1 +を使用します。 +.El +.Sh 関連項目 +.Xr chpass 1 , +.Xr passwd 1 , +.Xr passwd 5 , +.Xr adduser 8 , +.Xr pwd_mkdb 8 +.Sh 歴史 +.Nm +コマンドは +.Bx 4.0 +から登場しました。 diff --git a/ja_JP.eucJP/man/man8/vmstat.8 b/ja_JP.eucJP/man/man8/vmstat.8 new file mode 100644 index 0000000000..ec0381e9c8 --- /dev/null +++ b/ja_JP.eucJP/man/man8/vmstat.8 @@ -0,0 +1,215 @@ +.\" Copyright (c) 1986, 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. +.\" +.\" 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. +.\" +.\" @(#)vmstat.8 8.1 (Berkeley) 6/6/93 +.\" jpman %Id: vmstat.8,v 1.2 1997/05/29 07:57:00 yugawa Stab % +.\" +.Dd June 6, 1996 +.Dt VMSTAT 8 +.Os BSD 4 +.Sh 名称 +.Nm vmstat +.Nd 仮想メモリの統計情報を報告する +.Sh 書式 +.Nm vmstat +.\" .Op Fl fimst +.Op Fl ims +.Op Fl c Ar count +.Op Fl M Ar core +.Op Fl N Ar system +.Op Fl w Ar wait +.Op Ar disks +.Sh 解説 +.Nm +は、プロセス、仮想メモリ、ディスク、トラップ、CPU の活動状況 +などについてカーネルが持っている統計情報を報告します。 +.Pp +オプション: +.Bl -tag -width indent +.It Fl c +表示を +.Ar count +回繰り返します。 +最初の表示はリブート時からの統計で、 +その後の表示は直前の表示から現在までの間の統計です。 +.Ar wait +間隔を指定しないと、デフォルトは 1 秒となります。 +.\" .It Fl f +.\" システムが起動してからの +.\" .Xr fork 2 +.\" と +.\" .Xr vfork 2 +.\" システムコールの回数と、それぞれのシステムコールで使われた +.\" 仮想メモリのページ数を表示します。 +.It Fl i +システムが起動してから各デバイスで起こった割り込みの回数を表示します。 +.It Fl M +名前に関するリストから値を取り出す際に、デフォルトの +.Pa /dev/kmem +の代わりに指定された +.Ar core +を使います。 +.It Fl N +名前のリストを取り出す際に、デフォルトの +.Pa /kernel +の代わりに指定された +.Ar system +を使います。 +.It Fl m +カーネルの動的メモリの利用状況について、確保したサイズ、利用のタイプの +順で一覧にして表示します。 +.It Fl s +.Em sum +構造体の内容を表示し、システムが起動してから起こったいくつかの +種類のページング関連のイベントの合計を報告します。 +.\" .It Fl t +.\" システムが起動してからのページインと際利用されたページ数、 +.\" それぞれが要求した時間の合計を表示します。 +.It Fl w +各表示の間で、 +.Ar wait +秒ポーズします。 +繰り返し回数 +.Ar count +を指定していなければ、デフォルトでは無限に繰り返します。 +.El +.Pp +デフォルトでは、 +.Nm +は以下の情報を表示します。 +.Pp +.Bl -tag -width indent +.It procs +以下の各状態でのプロセス数に関する情報 +.Pp +.Bl -tag -width indent -compact +.It r +実行待ち行列にある状態 +.It b +リソース確保 (i/o やページングなど) のためにブロックされている状態 +.It w +実行可能または短期間のスリープ中 (20 秒以内) であるが、スワップされている状態 +.El +.It memory +仮想メモリと実メモリの使用状況に関する情報を表示します。 +実行中または最近 20 秒間で実行されたプロセスに属する仮想ページ +(1024 バイト単位で表示される) は、アクティブであるとみなします。 +.Pp +.Bl -tag -width indent -compact +.It avm +アクティブな仮想ページ +.It fre +フリーリストのサイズ +.El +.It page +ページフォルトとページングの活動状況に関する情報を表示します。 +これらは 5 秒間の平均として、秒単位で表示します。 +.Pp +.Bl -tag -width indent -compact +.It flt +ページフォルトの総数 +.It re +要求されたページ数 (参照ビットをシミュレート) +.\" .It at +.\" アタッチされたページ数(フリーリストの中から見つけ出されたもの) +.It pi +ページインされたページ数 +.It po +ページアウトされたページ数 +.It fr +秒単位の開放されたページ数 +.\" .It de +.\" 予期される短期的なメモリ不足 +.It sr +クロックアルゴリズムによってスキャンされたページ数 (秒単位) +.El +.It disks +秒単位のディスク操作に関する情報 (このフィールドはシステム依存です)。 +通常、ページングは使用可能なドライブにまたがって分割されます。 +このフィールドのヘッダは、ディスク名の最初の文字とユニット番号です。 +システムが 4 つ以上のディスクドライブを扱うように設定されている場合、 +.Nm +は最初の 4 つのドライブしか表示しません。 +.Nm +で特定のドライブを表示するには、コマンド行でドライブ名を指定します。 +.It faults +最近 5 秒間のトラップ/割り込みの平均レート (秒単位)。 +.Pp +.Bl -tag -width indent -compact +.It in +デバイス割り込み (クロック割り込みを含む) の回数 +.It sy +システムコールの回数 +.It cs +cpu のコンテキストスイッチの回数 +.El +.It cpu +CPU 使用時間の内訳 (%) +.Pp +.Bl -tag -width indent -compact +.It us +通常およびそれより低い優先度のプロセスのユーザ時間 +.It sy +システム時間 +.It id +CPU アイドル時間 +.El +.El +.Sh 使用例 +コマンド: +.Dl vmstat -w 5 +は、5 秒おきにシステムの統計を表示します。これは、システム内の統計を取るのに +ちょうどよい間隔です。 +他の値では秒単位の値にバラツキがあり、しばらく出力を継続すると +1 秒毎に計算しなおしていることがわかるでしょう。 +.Sh 関連ファイル +.Bl -tag -width /dev/kmemxxx -compact +.It Pa /kernel +デフォルトのカーネル名前リスト +.It Pa /dev/kmem +デフォルトのメモリファイル +.El +.Sh 関連項目 +.Xr fstat 1 , +.Xr netstat 1 , +.Xr nfsstat 1 , +.Xr ps 1 , +.Xr systat 1 , +.Xr iostat 8 , +.Xr pstat 8 +.Pp +.%T "Installing and Operating 4.3BSD" +の ``Interpreting system activity'' で始まるセクション +.Sh バグ +.Fl c +と +.Fl w +オプションは、デフォルトの出力を行うときにのみ有効です。 diff --git a/ja_JP.eucJP/man/man8/vnconfig.8 b/ja_JP.eucJP/man/man8/vnconfig.8 new file mode 100644 index 0000000000..88911f0fd6 --- /dev/null +++ b/ja_JP.eucJP/man/man8/vnconfig.8 @@ -0,0 +1,176 @@ +.\" Copyright (c) 1993 University of Utah. +.\" Copyright (c) 1980, 1989, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" This code is derived from software contributed to Berkeley by +.\" the Systems Programming Group of the University of Utah Computer +.\" Science Department. +.\" +.\" 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. +.\" +.\" 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. +.\" +.\" @(#)vnconfig.8 8.1 (Berkeley) 6/5/93 +.\" jpman %Id: vnconfig.8,v 1.2 1997/05/03 13:45:51 horikawa Stab % +.\" +.Dd July 8, 1993 +.Dt VNCONFIG 8 +.Os BSD 4 +.Sh 名称 +.Nm vnconfig +.Nd vnode ディスクを構築して利用できるようする +.Sh 書式 +.Nm vnconfig +.Op Fl cdeuv +.Ar special_file Ar regular_file +.Oo Ar feature Oc +.Nm vnconfig +.Fl a +.Op Fl cdeuv +.Op Fl f Ar config_file +.Sh 解説 +.Nm vnconfig +コマンドは、vnode 疑似ディスクデバイスを構築して使用可能にします。 +コマンドの最初の書式では、スペシャルファイル +.Ar special_file +を通常ファイル +.Ar regular_file +に結びつけ、 +後で通常ファイルをディスクであるかのようにアクセスできるようにします。 +これによりファイルシステム中の通常ファイルを、 +スワップや、名前空間にマウントされるファイルシステムと出来ます。 +.Pp +オプションは動作を指定します: +.Bl -tag -width indent +.It Fl c +デバイスを構築します。 +成功すると、 +.Ar special_file +への参照は、 +.Ar regular_file +の内容へのアクセスとなります。 +.It Fl e +デバイスを構築し、指定された +.Ar feature +を有効にします。 +.Ar feature +が指定されないと、 +.Fl e +は +.Fl c +と同じ意味になります。 +.It Fl d +(可能なら) 指定した +.Ar feature +を無効にします。 +.It Fl u +デバイスを無効にし、``無構築状態'' にします。 +.It Fl v +実行される動作の内容を標準出力に表示します。 +.El +.Pp +動作を指定するオプションがない場合には、 +.Fl c +が指定されたものと見なします。 +.Pp +.Ar feature +引数は、 +.Fl e +によって有効になる機能を指定します。 +.Bl -tag -width indent +.It Dv swap +スペシャルファイル上でのスワップを有効にします。 +.Xr swapon 2 +を参照してください。 +.It Dv Pf mountro= Pa mount_point +スペシャルファイルは、 +.Ar mount_point +へ読み込み専用マウントされます。 +.Xr mount 2 +を参照してください。 +.It Dv Pf mountrw= Pa mount_point +スペシャルファイルは、 +.Ar mount_point +へ読み書き可能マウントされます。 +.Xr mount 2 +を参照してください。 +.It Dv Pf mount= Pa mount_point +``mountrw='' と同じです。 +.El +.Pp +第 2 の書式 ( +.Fl a +) では、構成ファイルを読み込んで、 +デバイスとファイルのそれぞれの組について指定された動作を実行します。 +.Fl f +によって、読み込む構成ファイル +.Ar config_file +を指定します。 +この指定がないと、デフォルトの構成ファイルを読みます。 +構成ファイルは、1 行にデバイスとファイル名の組を次の形式で持ちます: +.Bd -literal + special_file regular_file [ feature ] +.Ed +.Pp +ここでは各フィールドはスペースで分割されます。 +構成ファイル中のすべてのデバイスの動作に関して、 +前述の動作オプションが有効です。 +.Sh 関連ファイル +.Bl -tag -width /etc/vntab -compact +.It Pa /etc/vntab +.Fl a +オプションで使われるデフォルトの構成ファイル +.El +.Sh 使用例 +.Pp +.Dl vnconfig /dev/vn0c /tmp/diskimage +.Pp +vnode ディスクデバイス +.Pa vn0c +を構築します。 +.Pp +.Dl vnconfig -e /dev/vn0c /var/swapfile swap +.Pp +vnode ディスクデバイス +.Pa vn0c +を構築し、それをスワップ領域として使うようにします。 +.Pp +.Dl vnconfig -d /dev/vn0c myfilesystem mount=/mnt +.Pp +vnode ディスクデバイス +.Pa vn0c +のマウントを解除します(また無構築状態にします)。 +.Pp +.Dl vnconfig -ae +.Pp +.Pa /etc/vntab +に記述されているすべてのデバイスを構築して使用可能にします。 +.Sh 関連項目 +.Xr mount 2 , +.Xr swapon 2 , +.Xr unmount 2 , +.Xr vn 4 . diff --git a/ja_JP.eucJP/man/man8/watch.8 b/ja_JP.eucJP/man/man8/watch.8 new file mode 100644 index 0000000000..3ab8cb4863 --- /dev/null +++ b/ja_JP.eucJP/man/man8/watch.8 @@ -0,0 +1,96 @@ +.\" +.\" @(#)watch.8 1.1 (FreeBSD) 2/17/95 +.\" jpman %Id: watch.8,v 1.3 1997/07/22 17:07:53 horikawa Stab % +.\" +.Dd February 17, 1995 +.Dt WATCH 8 +.Os +.Sh 名称 +.Nm watch +.Nd 別の tty 線を覗き見る +.Sh 書式 +.Nm watch +.Op Fl ciotnW +.Ar tty +.\" watch [-ciotnW] [<tty name>] +.Sh 解説 +.Nm watch +は、特定の tty を通して流れてくる全てのデータをスーパユーザに +提供します。 +.Nm watch +は、標準出力に出力します。 +.Pp +以下のようなオプションがあります。 +.Bl -tag -width "-l nul " +.It Fl c +閉じられた時点で再接続を行います。 +.Nm watch +によって観察されている tty が閉じられたならば、自動的に同じ tty に +再接続します。 +このオプションが指定されていない時は、 +.Nm watch +は対話モードで実行されている時には新しい tty を要求し、 +tty 制御を行わずに実行されている場合は終了します。 +.It Fl i +対話モードにします。 +対話モードは、 +.Nm watch +が tty から実行された場合のデフォルトです。 +出力がファイルにリダイレクションされている時は、 +このオプションを指定することで対話モードにできます。 +.It Fl o +オーバフローによって再接続します。 +観察している tty がオーバフローした時の +.Nm watch +の振舞いは、観察している tty が閉じられた時の振舞いに似ています。 +詳しい情報は、 +.Xr snp 4 +を見てください。 +.It Fl t +tty の観察を始めた時の日付と時間を表示します。 +.It Fl n +観察する tty を対話的に変更できなくします。 +これは、<control-X> による変更要求と、 +現在の tty が閉じられたりオーバフローを起こした場合の自動プロンプトともに +無効にします。 +プロンプトが表示される全ての場合、 +.Nm watch +.\"(訳注)実際は文中の語でしたが、ここでは.Nmを使いました。 +.\" 2.2.1R 対象(1997/04/28) Takeshi MUTOH <mutoh@info.nara-k.ac.jp> +は終了します。再接続フラグは、このオプションに影響されません。 +.It Fl W +観察している tty への書き込みを許可します。 +.It Ar tty +tty は、仮想 tty デバイスや仮想コンソールやシリアル線などのように、 +tty 形式のデバイスとして指定しなければなりません。 +名前には、前に "/dev/" をつけても構いません。 +.Sh 操作 +対話的モードで実行中は、全てのユーザの入力は以下のものを除いて、 +捨てられます。 +.Pp +.Bl -tag -width "XXXX" -compact +.It Sy "<control-G>" +.Nm watch +の終了。 +.It Sy "<control-W>" +画面の消去。 +.It Sy "<control-X>" +除き見る tty の変更。 +.Sh 制限事項 +スーパユーザだけが、 +.Nm watch +を実行できます。 +.Sh 関連項目 +.Xr pty 4 , +.Xr sio 4 , +.Xr snp 4 +.Sh バグ +端末エミュレーション機能はありません。 +全てのユーザの出力はそのままの形で再構成されます。 +.Sh 作者 +Ugen J.S. Antsilevich <ugen@NetVision.net.il> +.Sh 歴史 +.Nm watch +は、 +.Fx 2.1 +で、はじめて導入されました。 diff --git a/ja_JP.eucJP/man/man8/wlconfig.8 b/ja_JP.eucJP/man/man8/wlconfig.8 new file mode 100644 index 0000000000..654dada71d --- /dev/null +++ b/ja_JP.eucJP/man/man8/wlconfig.8 @@ -0,0 +1,131 @@ +.Dd December 26 1996 +.Os +.Dt WLCONFIG 8 +.Sh 名称 +.Nm wlconfig +.Nd wavelan の設定パラメータを読み書きする +.Sh 書式 +.Nm wlconfig +.Ar ifname +.Op Ar param value ... +.Sh 解説 +.Nm wlconfig +コマンドは、NCR/AT&T Wavelan 無線 LAN カードのパラメータを読んだり、 +設定したりするのに使うことができます。 +カード内の不揮発性パラメータ格納エリア (Parameter Storage Area; PSA) +はこのプログラムで書き換えることができるので、DOS 用の +.Nm instconf.exe +は必要なくなります。また、ドライバに組み込まれたオプションの +信号強度キャッシュを問い合わせるためにも使えます。 +.Pp +.Ar ifname +パラメータは wavelan インタフェース名を指定します (例えば +.Pa wl0 +)。もしほかに引数がなければ、 PSA の現在の内容が読み込まれ、表示 +されます。 +.Pp +引数 +.Ar param +と +.Ar value +はパラメータの値を変更するために使われます。 +.Ar param value +の組はいくつでも指定できます。 +.Bl -tag -width 15n -compat -offset indent +.It Va param +.Va value +.It irq +IRQ の値 (リセット後に有効)。 3, 4, 5, 6, 10, 11, 12, 15 のうちの +どれか一つ +.It mac +固有の MAC の値 (イーサネットアドレス) +.It macsel +( +.Sq mac +パラメータにより設定される) +.Sq soft +か、(工場で設定される) +.Sq default +のどちらか +.It nwid +NWID はカードの無線モデムに渡される 2 バイトのパラメータです。 +NWID により、同じ空間を共有して複数の論理的に分割された +ネットワークを運用することが可能になります。 +異なった NWID を持ったパケットはモデムにより単に無視されます。 +ハードウェアでは、NWID は不揮発性のメモリ +(PSA もしくはプログラム可能な格納エリア; +programmable storage area と呼ばれます) に長期間保存され、 +ドライバが初期化される際にソフトウェアにより無線モデムに +渡されます。 +このパラメータはスタートアップ時に渡されるデフォルトの +NWID を設定します。 +.It curnwid +現在運用中の NWID を設定します (が、 PSA には保存されません)。 +.It cache +ドライバはインタフェース毎に、送信側の MAC アドレスに対応する +「信号の強度、静けさ、品質」関連の固定サイズのキャッシュを維持しています。 +入力パケットをキャッシュに格納する際に、パケット受信時に +これらの値を無線モデムから取り出してチェックした上で、 +ドライバ内部のキャッシュに格納します。 +特定の入ってくるパケットを遮断するのに使うことのできる二つの +sysctl 値 (iponly と multicast only) が存在します。 +デフォルトでは、キャッシュの仕組みはユニキャストではない +IP パケットのみを格納しますが、これは sysctl(8) で変更する +ことができます。 +入ってくるパケットのうち遮断されないものはキャッシュを更新するので、 +リモートシステムへのアンテナの信号強度をモニタすることができます。 +値として指定できるコマンドは三つあります: +.Sq raw +は無線モデムのハードウェア値から生の信号強度データを表示します。 +.Sq scale +は生のハードウェア値を 0..100% になるように倍率を調整します。 +.Sq zero +は新しいサンプルを得ようとする場合にキャッシュをクリアします。 +.El +.Pp +Wavelan カードの IRQ が間違っている場合には、インタフェースが +設定されたとしても機能しないであろうことに注意して下さい。 +.Nm wlconfig +プログラムは正しい値にカードを再設定するよう使われるべきです。 +.Sh 使用例 +NWID を 0x1234 に設定する : +.Bd -literal -offset +# wlconfig wl0 nwid 0x1234 +.Ed +.Pp +現在の設定を表示する : +.Bd -literal -offset +# wlconfig wl0 +Board type : ISA +Base address options : 0x300, 0x390, 0x3c0, 0x3e0 +Waitstates : 0 +Bus mode : ISA +IRQ : 10 +Default MAC address : 08:00:0e:20:3d:4b +Soft MAC address : 00:00:00:00:00:00 +Current MAC address : Default +Adapter compatability : PC-AT 2.4GHz +Threshold preset : 1 +Call code required : NO +Subband : 2425MHz +Quality threshold : 3 +Hardware version : 0 (Rel1/Rel2) +Network ID enable : YES +NWID : 0xdead +Datalink security : NO +Databus width : 16 (variable) +Configuration state : unconfigured +CRC-16 : 0x3c26 +CRC status : OK +.Pp +信号強度のキャッシュを倍率を調整して表示する : +.Bd -literal -offset +# wlconfig wl0 cache scale +.Ed +.Sh 関連項目 +.Xr wl 4, +.Xr sysctl 8 . +.Sh 歴史 +.Nm wlconfig +コマンドのこの実装は完全に新規のもので、Hilink Internet のために +Michael Smith により書かれ、Jim Binkley &c により更新されました。 diff --git a/ja_JP.eucJP/man/man8/wormcontrol.8 b/ja_JP.eucJP/man/man8/wormcontrol.8 new file mode 100644 index 0000000000..1aefce1c9c --- /dev/null +++ b/ja_JP.eucJP/man/man8/wormcontrol.8 @@ -0,0 +1,232 @@ +.\" +.\" Copyright (C) 1996 +.\" interface business GmbH +.\" Tolkewitzer Strasse 49 +.\" D-01277 Dresden +.\" F.R. Germany +.\" +.\" All rights reserved. +.\" +.\" Written by Joerg Wunsch <joerg_wunsch@interface-business.de> +.\" +.\" +.\" 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. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR(S) ``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(S) 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: wormcontrol.8,v 1.3.2.2 1997/03/06 08:00:45 mpp Exp % +.\" jpman %Id: wormcontrol.8,v 1.3 1997/08/16 13:45:04 horikawa Stab % +.\" +.\" arrgh, hilit19 needs this" :-( +.Dd Jan 27, 1996 +.Os +.Dt WORMCONTROL 8 +.Sh 名称 +.Nm wormcontrol +.Nd CD-R ドライバの制御 +.Sh 書式 +.Nm wormcontrol +.Op Fl f Ar device +.Ar command +.Op Ar params... +.Sh 解説 +.Ss オプション +.Bl -tag -ident -width "XXX" +.It Fl f Ar device +デフォルトの +.Pa /dev/rworm0 +に代えて、デバイス +.Ar device +を使用します。 +.El +.Ss 概略 +.Nm +は、書き込み可能 CD +.Pq CD-R +の様々なパラメータを調整するために +.Xr worm 4 +ドライバの動作を制御するのに用いられるユーティリティです。 +.Pp +他の多くのデバイスと異なり、 +CD-R デバイスは大変厳密な処理手順を要求します。 +データ書き込みに先立って、ドライブ速度を選択しなければなりません。 +またドライブを +.Ql dummy +モードにすることも出来ます。 +このモードでは、あらゆる動作はレーザを止めて行われます。 +このようにして、最悪の事態に陥ってメディアを破壊することなく、 +書き込み環境が実際に CD-R を焼くのに十分なデータ速度を提供できるか否かを +テストすることができます。 +.Pp +新しいトラックに書き込むには、そのトラックが音声トラックになるのか +データトラックになるのかをドライブに教えてやる必要があります。 +音声トラックはブロックサイズ 2352 バイトで書き込まれますが、 +データトラックはブロックあたり 2048 バイトです。 +実際に利用できるデータフォーマットは他にもありますが、 +このドライバが現在のところサポートしているのは、この +.Em Yellow Book +モード 1 フォーマットだけです。 +音声トラックについては、ドライバは更に、 +データをプリエンファシス付きで書き込むかどうかについても +知る必要があります。 +.Pp +ひとたび、あるセッションの全トラックが書き込まれると、 +ディスクは +.Em 定着 +させなければなりません。 +これは目録とリードアウト情報をディスクに書き込む処理であり、 +この処理をしなくてはディスクは利用できません。 +.Ss コマンド +.Bl -tag -indent -width "prepdisk" +.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 +ディスクの書き込み準備を行います。 +この処理はトラック準備の前に行い、 +セッションが完了するまでその状態を保つ必要があります。 +通常 (single) 速度 +.Pq 音声データ用 +あるいは倍速 (double) +.Pq CD-ROM データ用 +のいずれかを指定しなければなりません。 +オプションで引数 +.Ar dummy +を指定することで、テスト用にレーザをオフにしておくよう +ドライブに指示することができます。 +.It track Ar audio \&| data Op Ar preemp +次トラックのフォーマットに関する情報をドライバに伝えます。 +.Ar audio +あるいは +.Ar data +.Pq CD-ROM +を選択しなければなりません。 +音声トラックにおいてデータをプリエンファシス付きで書き込むためには、 +オプション引数 +.Ar preemp +を指定しなければなりません。 +ひとたびこのコマンドを正しく指定したら、 +トラックの書き込み準備は完了です。 +.It fixate Ar toc-type Op Ar onp +ひとたび全トラックを書き込んだら、このコマンドにより +現在のセッションをクローズします。 +引数 +.Ar toc-type +は 0 から 4 までの 1 桁の数で、以下の意味を持ちます: +.Bl -item +.It +0 CD 音声 +.It +1 CD-ROM +.It +2 CD-ROM 第 1 トラック モード 1 +.It +3 CD-ROM 第 1 トラック モード 2 +.It +4 CDI +.El +.Pp +オプション引数 +.Ar onp +は +.Dq open next program area +の意で、この CD-R の次のセッションが将来オープンされ、 +書き込みが可能であることを意味します。 +それ以外の場合、この CD-R はクローズされ、修正できないままとなります。 +.El +.Sh 診断 +内部で呼び出される +.Xr ioctl 2 +コマンドのエラーコードが +.Xr perror 3 +機能によって表示されます。 +.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 +# wormcontrol fixate 1 +.Ed +.Pp +注意: 上の +.Xr dd 1 +コマンドは主として、データストリームを +.Dq スライス +するために用いられています。 +これは、かなり特殊なブロックサイズで音声データを書き込む際に、特に有用です。 +内部で用いられるデバイスは +.Em ロウ +デバイスなので、上のコマンドで用いられるブロックサイズは CD-R の +ブロックサイズの整数倍でなければなりません。 +.Pp +上に述べたコマンド +.Xr team 1 +は基本システムの一部ではありませんが、 +一定のデータストリームを CD レコーダにパイプで流し込むのに +極めて有用です。 +.Sh 関連項目 +.Xr dd 1 , +.Xr team 1 , +.Xr ioctl 2 , +.Xr perror 3 , +.Xr worm 4 +.Pp +.Pa /usr/share/examples/worm/* +.Sh 歴史 +.Nm wormcontrol +は現在も開発途上です。 +.Sh 作者 +本プログラムは +.ie t J\(:org Wunsch +.el Joerg Wunsch +Dresden によって寄贈されました。 diff --git a/ja_JP.eucJP/man/man8/xntpd.8 b/ja_JP.eucJP/man/man8/xntpd.8 new file mode 100644 index 0000000000..83d1c12104 --- /dev/null +++ b/ja_JP.eucJP/man/man8/xntpd.8 @@ -0,0 +1,1089 @@ +.\" 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 +は、インターネットの標準時間サーバに合わせて、 Unix のシステム時刻 +(time\-of\-day) を設定し維持するデーモンです。 +.I xntpd +は、RFC 1305 で定義されている Network Time Protocol (NTP) バージョン +3 標準の完全な実装となっていますが、各々 RFC 1059 と RFC 1119 で定義 +されているバージョン 1 とバージョン 2 に対する互換性も保っています。 +.I xntpd +は全ての計算を固定少数点演算により行うので、浮動少数点を扱うコードは +必要としません。プロトコルおよび時間調整のコードで行われる計算は、高 +精度で実行されます。また、最も正確な外部時計の供給源に対しても同期で +きるだけの精度の維持を計るべく、計算に規則だった補正値を導入するといっ +たように、細部まで注意が払われています。 +.PP +通常、 +.I xntpd +は、起動時にコンフィギュレーションファイルから設定を読込みます。デフォ +ルトのコンフィギュレーションファイル名は、 +.IR /etc/ntp.conf +ですが、コマンドラインの指定の方が優先します。また、もっぱらコマンド +ラインだけで、その局面に役立つ +.I xntpd +の設定を与え、コンフィギュレーションファイルを不要にすることもで +きます。これは、 +.I xntpd +が、実行時にブロードキャストを待受ける (listen) ことで決定される全て +の通信相手 (peer) に対して、ブロードキャストもしくはマルチキャスト・ +クライアントとして設定されるべき時には、特に適しています。 +.I xntpd +デーモンの実行中は、 +.IR ntpq (8) +および +.IR xntpdc (8) +を使用することで、デーモンのさまざまな内部変数を表示したり設定オプショ +ンを変更できます。 +.PP +デーモンはアクティブ/パッシブ, クライアント/サーバ, ブロードキャスト +/マルチキャスト等の対称的なモードを含むいずれかのモードで働くことが +できます。ブロードキャストもしくはマルチキャスト・クライアントは、自 +動的にリモートサーバを探し出し、片道の遅延補正因子を計算して、自動的 +に自身に対する設定を行います。これにより、その環境に固有の詳細な設定 +やコンフィギュレーションファイルなしに、一群のワークステーションを配 +置することが可能になります。 +.PP +以下にあげるコマンドライン引数が +.I xntpd +により理解されます。(より完全な機能の説明については、コンフィギュレー +ションファイルの説明を参照のこと): + +.Ip -a 8 +「認証」 (\*(L"authenticate\*(R") モードで実行します。 +.Ip -b 8 +NTP のブロードキャストを待受けて、可能ならそれに同期します。 +.Ip -c 8 +デフォルトの代わりのコンフィギュレーションファイルを指定します。 +.Ip -d 8 +デバッグモードを指定します。このフラグは何回指定してもかまいませんが、 +回数が多いほど表示がより詳細になります。 +.Ip -e 8 +このコンピュータ上で、NTP の暗号化 (encryption) フィールドを計算する +のに必要な時間を (秒で) 指定します。 +.Ip "-f driftfile" 8 +driftfile のある場所を指定します。 +.Ip -k 8 +NTP の認証キーを含むファイルのある場所を指定します。 +.Ip -m 8 +マルチキャストメッセージを待受けて、可能ならそれらに同期します (マル +チキャストカーネルが必要になります)。 +.Ip -p 8 +デーモンのプロセス ID を記録するためのファイル名を指定します。 +.Ip -r 8 +通常、デーモンは、ブロードキャストもしくはマルチキャストのサーバとク +ライアントとの間のネットワーク遅延を自動的に補正します。遅延の測定作 +業が失敗した場合には、ここで指定した (秒の) デフォルトの遅延を使用す +るようになります。 +.Ip -s 8 +統計ファイルを作成するためのディレクトリを指定します。 +.Ip "-t trustedkey" 8 +キー番号を信頼できるキー (trusted key) のリストに付け加えます。 +.Ip -v 8 +システム変数を追加します。 +.Ip -V 8 +デフォルトでリストされるシステム変数を追加します。 + +.SH "コンフィギュレーションオプション" +.I xntpd +のコンフィギュレーションファイルのフォーマットは、他の Unix コンフィ +ギュレーションファイルのものに似ています。コメントは文字 \*(L"#\*(R" +で始まり、行末まで続きます。空行は無視されます。設定コマンドは、行頭 +のキーワードとそれに続く空白で区切られた引数のリストからなります。引 +数の内いくつかは、省略可能な場合があります。これらのコマンドは複数行 +にわたってはなりません。引数は、ホスト名, ドットで区切られた 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つのコマンドは、利用されるべき時間サーバや与えられるべき時 +間サービスを指定します。 +.B peer +コマンドは、ローカルサーバが、コマンド中の +.I host_address +で示されるリモートサーバに対し、「対称的アクティブ」 (\*(L"symmetric +active\*(R") モードで動作するよう指示します。これは、さまざまな失敗 +の仕方によって、ローカルもしくはリモートのサーバホストのいずれかがよ +り良い時刻供給源となり得るようなサーバのネットワークにおいて、役立つ +ものです。 +.B server +コマンドは、ローカルサーバが、指定したリモートサーバに対して \*(L"ク +ライアント\*(R" モードで動作するよう指示します。このモードでは、ロー +カルサーバはリモートサーバに同期しますが、リモートサーバがローカルサー +バに同期することは決してありません。 +.B broadcast +コマンドは、ローカルサーバが、\*(L"ブロードキャスト\*(R" モードで動 +作するよう指示します。ローカルサーバは、コマンド中で指定されるブロー +ドキャスト/マルチキャスト/アドレスを持つクライアント集団に、定期的に +ブロードキャストメッセージを送ります。通常、この指示は、送信側 +(transmitter) として動作しているローカルサーバにのみ適用されます。 +ブロードキャストクライアントに対する動作については、以下に説明する +.B broadcastclient +もしくは +.B multicastclient +コマンドの項を参照して下さい。このモードでは、 +.I host_address +は、通常、そのローカルネットワーク (もしくは複数のローカルネットワー +クの内のひとつ)の上でのブロードキャストアドレスであるか、NTP に割当 +てられたマルチキャストアドレスです。NTPには、アドレス 224.0.1.1 が割 +当てられてきました。現在のところは、このアドレスのみを使用すべきです。 +マルチキャスト機能はマルチキャストカーネルを必要としますが、これは、 +まだ、どのベンダーの製品にでも存在するものではないということに注意し +て下さい。 +.PP +.B key +オプションが含まれていると、そのアドレスに送られる全てのパケットが、 +指定したキー (32 ビット符号無し整数の範囲の数) を用いて暗号化された +認証フィールドを含むようになります。 +.B version +オプションにより、送出される NTP パケットに使用されるべきバージョン +番号を指定することができます。バージョン 1, 2, 3 のいずれかが選択で +きますが、バージョン 3 がデフォルトになっています。 +.B prefer +オプションは、そのホストを優先的ホストとします。このホストは、その他 +全ての点では同等ですが、正常に動作している一群のホストの中から同期を +取る対象として選ばれます。 +.B ttl +オプションは、ブロードキャストモードでのみ使用され、マルチキャストパ +ケットで用いられる生存時間 (TTL) を指定します。デフォルトは 127 です +が、適切な値を選択することは、黒魔術の一種であり、ネットワーク管理者 +との調整を必要とします。 +.PP +.B broadcastclient +.PP +ローカルサーバに対し、同じサブネット上の他のサーバを見付けるために、 +ローカルネットワーク上のブロードキャストメッセージを待受けるよう指示 +します。ローカルサーバは、最初のブロードキャストメッセージを受取る際、 +リモートサーバとクライアント/サーバ間の短いやりとりを用いて、名目上 +の (nominal) ネットワーク遅延を測定してから、後続のブロードキャスト +メッセージを待ち受けて、それに同期する\*(L"ブロードキャストクライア +ント\*(R" モードに入ります。このモードでの偶然もしくは故意の分裂状態 +を避けるため、ローカルとリモートのサーバの両方は認証に同一の信頼でき +るキーとキー識別子を使用して動作しなくてはならないことに注意して下さ +い。 +.PP +.B multicastclient +[ +.I IP address ... +] +.PP +このコマンドは、 +.IR broadcastclient +コマンドと同じように用いられますが、IP マルチキャストを使用して動作 +します。この機能をサポートするには、マルチキャストカーネルと認証の使 +用が必要です。1 つ以上の IP アドレスが与えられると、サーバはそれぞれ +のマルチキャストグループに加わります。1 つも与えられなければ、NTP に +は IP アドレス (224.0.1.1) が割当てられていると想定されます。 +.PP +.B driftfile +.I filename +.PP +このコマンドは、ローカルの時計発振子の周波数オフセットを記録するため +のファイル名を指定します。このファイルが存在すると、起動時に初期周波 +数オフセットを指定するのに使用され、その後デーモンにより計算されるカ +レント周波数オフセットで、 1 時間に 1 度更新されます。ファイルが存在 +しないか、このコマンドが与えられていない場合、初期周波数オフセットは +ゼロと仮定されます。この場合、周波数が安定し、残った時間誤差が収まる +のに数時間かかります。このファイルが、最初にカレント変動値を一時ファ +イルに書込み、 +.IR rename (3) +により古いファイルと置換えることで更新されることに注意して下さい。これは、 +.I xntpd +が、 ドリフトファイルのあるディレクトリに対し書込み権を持っていなけ +ればならず、ファイルは、シンボリックであろうとなかろうと、ファイルシ +ステムリンクであるべきではないだろうことを意味しています。 +.PP +.B enable auth|bclient|pll|monitor|stats +[ +.I ... +] +.PP +さまざまなサーバオプションを有効にします。指定されていないフラグは影 +響を受けません。\*(L"auth\*(R" フラグは、その通信相手 (peer) が信頼 +できるキーとキー識別子を使用して正しく認証されている場合に限って、サー +バが指定されていない相手に同期するようにします。このフラグのデフォル +トは無効 (オフ) です。 \*(L"bclient\*(R" フラグは、サーバがブロード +キャストもしくはマルチキャストサーバからのメッセージを待受けるように +します。これにより、そのサーバに対する連携 (association) が自動的に +成立します。このフラグのデフォルトは無効 (オフ) です。 \*(L"pll\*(R" +フラグは、サーバのローカル時計を調整するようにします。デフォルトでは +有効 (オン) です。無効にした場合、ローカル時計は固有の時間と周波数の +まま動きます。このフラグは、ローカル時計が他の何らかのデバイスやプロ +トコルにより制御されており、NTPは他のクライアントと同期をとるためだ +けに使用されている場合に、役立ちます。\*(L"monitor\*(R" フラグは、モ +ニタファシリティ (facility) を有効にします(下記参照のこと)。デフォル +トでは有効 (オン) です。\*(L"stats\*(R" フラグは、統計のファシリティ +の filegen (下記説明を参照のこと) を有効にします。デフォルトでは有効 +(オン) です。 +.PP +.B disable auth|bclient|pll|monitor|stats +[ +.I ... +] +.PP +さまざまなサーバオプションを無効にします。指定されていないフラグは影 +響を受けません。現在使用可能なオプションは、enable コマンドの項で説 +明しています。 + +.SH "認証オプション" +.PP +.B keys +.I filename +.PP +このコマンドは、認証モードでの操作の際、 +.I xntpd +により使用される暗号化キーとキー識別子を含むファイルの名前を指定しま +す。このファイルのフォーマットは以降で説明します。 +.PP +.B trustedkey +.I # +[ +.I "# ..." +] +.PP +このコマンドは、同期するのにふさわしい通信相手を認証する目的にとって +信用できる暗号化キー識別子を指定するのに使用されます。異なるサーバは +異なるキーを使用できますが、認証手続きにはローカルとリモート両方のサー +バがこの目的のため同一のキーとキー識別子を共有することが必要です。引 +数は、32bitの符合なし整数ですが、 NTP キー 0 は固定されており周知の +ものであることに注意してください。意味のある認証が行われるべきならば、 +キー 0 は信用すべきではありません。 +.PP +.B requestkey +.I # +.PP +このコマンドは、 +.IR xntpd (8) +の動作に影響を与える問題の診断と修復に役立つ +.IR xntpdc (8) +プログラムにより使用されるキー識別子を指定します。 +.I xntpdc +プログラムの動作は、 xntpd のこの固有の実装に特定されており、これお +よび以前のバージョンのデーモンとのみ動作すると見込まれます。ローカル +サーバの状態に影響を与えるリモートの xntpdc プログラムからの要求は、 +認証されねばなりません。そのためには、リモートプログラムとローカルサー +バが共通のキーとキー識別子を共有することが必要です。このコマンドの引 +数は、32bitの符合なし整数です。コンフィギュレーションファイルに +.B requestkey +コマンドが含まれていないか、キーがマッチしないと、この要求は無視され +ます。 +.PP +.B controlkey +.I # +.PP +このコマンドは、 +.IR xntpd (8) +の動作に影響を与える問題の診断と修復に役立つ +.IR ntpq (8) +プログラムにより使用されるキー識別子を指定します。 +.IR ntpq +プログラムと +.I xntpd +の動作は RFC 1305 の定義を満たしています。ローカルサーバの状態に影響 +を与えるリモートの +.I ntpq +プログラムからの要求は、認証されねばなりません。そのためには、リモー +トプログラムとローカルサーバが共通のキーとキー識別子を共有することが +必要です。このコマンドの引数は、32bitの符合なし整数です。コンフィギュ +レーションファイルに +.B requestkey +コマンドが含まれていないか、キーがマッチしないと、この要求は無視され +ます。 +.PP +.B authdelay +.I seconds +.PP +ローカル計算機上で NTP 認証フィールドを暗号化するのに要する時間の総 +計を示します。この値は、送出パケットに認証が用いられる際、送信タイム +スタンプを修正するのに使用されます。通常、この値は 0.0001 秒から +0.003 秒あたりになりますが、これはホスト計算機の CPU 速度に依存して +います。通常、この値は、ディストリビューションに含まれている +.I authspeed +プログラムを用いて計算されます。 +.SH "アクセス制御オプション" +.B restrict +.I address +[ +.B mask +.I numeric_mask +] [ +.I flag +] [ +.I ... +] +.PP +.I xntpd +は、汎用のアドレスとマスクに基づく制限リストを実装しています。リスト +はアドレスにより、そしてマスクによりソートされ、その順番でマッチして +いるかどうか調べられます。ここで、最後にマッチしたものが受信パケット +に関する制限フラグを定義します。受信パケットのソースアドレスは、制限 +リストのエントリに関するマスクでアンドをとられた 32 ビットアドレスと +マッチするか調べられ、それからエントリアドレス (これもまたマスクとア +ンドをとられます) と比較され、マッチするものを探します。引数 +\*(L"mask\*(R" のデフォルトは 255.255.255.255 で、\*(L"address\*(R" +が個別のホストのアドレスとして扱われることを意味します。デフォルトエ +ントリ (address 0.0.0.0, mask 0.0.0.0) は常にリストに含まれ、既定の +ソートアルゴリズムでは、リストの先頭のエントリとなります。 +\*(L"address\*(R" は、通常、 dotted\-quad 形式で与えられ、 mask オプ +ションを伴わないテキスト文字列 \*(L"default\*(R" は、デフォルトエン +トリを示すために使用できることに、注意して下さい。 +.PP +現在の実装では、フラグは常にアクセスを制限します。すなわち、フラグを +持たないエントリは、サーバへの自由なアクセスが与えられることを示すこ +とになります。フラグは直交的ではなく、より制限の強いフラグは、より制 +限の弱いフラグを冗長にします。フラグは、一般に 2 つのカテゴリに分類 +されます。時間サービスを制限するものと、情報問い合わせやサーバの実 +行時再設定の試みを制限するものです。次のフラグの内1つ以上を指定する +ことができます: +.Ip ignore 10 +このエントリにマッチするホストからのすべてのパケットを無視します。こ +のフラグが指定されると、問い合わせも時間サーバへのポーリングも応答さ +れなくなります。 +.Ip noquery 10 +NTP の モード 6 と 7のすべてのパケット (つまり情報問い合わせと設定要 +求) を無視します。時間サービスは影響を受けません。 +.Ip nomodify 10 +サーバの状態を変えようとするモード 6 と 7のすべてのパケット (つまり +実行時再設定) を無視します。情報を返す問い合わせは許されます。 +.Ip notrap 10 +マッチしたホストにモード 6 の制御メッセージのトラップサービスを提供 +することを拒否します。トラップサービスは、モード 6 の制御メッセージ +プロトコルのサブシステムで、リモートのイベントロギングプログラムによ +る使用が意図されています。 +.Ip lowpriotrap 10 +マッチしたホストによるトラップセットを低い優先度として宣言します。1 +つのサーバが保持し得るトラップの数は制限されています(現在の制限値は +3 です)。トラップは通常、先入れ先処理ベースで割当てられ、後から来た +トラップ要求はサービスを拒否されます。このフラグは、通常優先度のトラッ +プに対する後からの要求が、低い優先度のトラップより優先されることを許 +すことで、通常の割当てアルゴリズムを変更します。 +.Ip noserve 10 +モード 6 と 7 以外のすべての NTP パケットを無視します。基本的には、 +時間サービスは拒否されますが、それでも問い合わせは許されています。 +.Ip nopeer 10 +ポーリングしているホストに、状態を持たない (stateless) 時間サービス +を与えますが、そうしなければ将来的に同期の相手として有用であるかもし +れない場合にさえ、それらに peer メモリ資源を割当てません。 +.Ip notrust 10 +これらのホストは同期源としては決して使用されませんが、その他の点では +普通に扱われます。 +.Ip limited 10 +これらのホストは、同一のネットからのクライアント数の制限の対象となり +ます。ここで言うネットとは、 (class A, class B, class C 等の) ネット +の IP 表記のことです。サーバで見えており、過去 +\*(L"client_limit_period\*(R" 秒の間アクティブであった、最初の +\*(L"client_limit\*(R" 個のホストのみが、受付けられます。同一のネッ +トの他のクライアントからの要求は拒否されます。時間要求パケットのみが、 +考慮されます。\*(L"プライベート\*(R"", \*(L"制御\*(R"", \*(L"ブロー +ドキャスト\*(R" 等のパケットは、クライアント制限の対象にはならず、ク +ライアントの数の内には入れられません。クライアントの履歴は、 +.I xntpd +のモニタリング機能を使用して維持されます。それゆえ、モニタリングは、 +\*(L"limited\*(R" フラグに制限エントリがある限り、アクティブです。 +\*(L"client_limit\*(R" のデフォルト値は 3 です。 +\*(L"client_limit_period\*(R" デフォルト値は 3600 秒です。 +.Ip ntpport 10 +実質的には、制限フラグと言うより、マッチのアルゴリズムを変更するもの +です。このフラグが存在すると、パケットのソースポートが標準の NTP の +UDP ポート (123) である場合にのみ、制限エントリにマッチします。 +\*(L"ntpport\*(R" と non\-\*(L"ntpport\*(R" の両方が指定できます。 +\*(L"ntpport\*(R" はより限定的であると考えられ、リストの後方にソート +されます。 +.PP +デフォルトの制限リストエントリは、フラグ \*(L"ignore, ntpport\*(R" +を持ち、ローカルホストのインターフェイスアドレスの各々に対し、スター +トアップ時にテーブルに挿入され、サーバがそれ自身の時間に同期しようと +しないようにします。また、デフォルトエントリは常に存在しますが、他で +は設定されない場合は、どのフラグもデフォルトエントリに関連づけられま +せん (すなわち、あなた自身の NTP サーバ以外のすべてが無制限になりま +す) 。 +.PP +制限ファシリティは、NSFnet の幹線上で動いている時間サーバの現在のア +クセスポリシが、 +.I xntpd +と同様に実装され得るように、付け加えられたものです。このファシリティ +は、あなたのサーバが、望まないか故障したリモート時間サーバの影響を受 +けないようにするのに、ことのほか有用ですが、これが 標準の NTP 認証ファ +シリティの代わりになると考えるべきではありません。ソースアドレスに基 +づく制限は、確信犯的クラッカーにたやすく裏をかかれます。 +.PP +.B clientlimit +.I limit +.PP +\*(L"client_limit\*(R" を \*(L"limit\*(R" にセットし、クライアント制 +限ポリシの設定を可能にします。この変数は、そのサーバの使用を許される +同一ネットワークからのクライアント数を定義します。 +.PP +.B clientperiod +.I period +.PP +\*(L"client_limit_period\*(R" をセットし、クライアント制限ポリシの設 +定を可能にします。この変数は、その時間後にクライアントがインアクティ +ブになると考えられ、従って制限されるクライアント数にもはや数えられな +くなるような秒数を指定します。 +.SH "モニタリングオプション" +.PP +.B statsdir +.I /directory path/ +.PP +統計ファイルが作られるべきディレクトリのフルパスを指定します(下記参 +照)。このキーワードにより (そうでなければ定数である) filegen ファイ +ル名のプレフィックスを統計ログ処理に対して用いられるファイル生成セッ +トに対して修正することが可能となります (下記 +.B filegen +文を参照)。 +.PP +.B statistics +.IR name \.\.\. +.PP +統計レコードの書込みを有効にします。現在のところ、3 種類の統計がサポー +トされています。 +.Ip loopstats 10 +ループフィルタの統計情報の記録を有効にします。ローカル時計の更新を +行う度に、\*(L"loopstats\*(R" と名付けられたファイル生成セットに次の +形式の行を出力します: +.PP +.RS 5 +48773 10847.650 0.0001307 17.3478 2 +.RE + +.RS 10 +最初の 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 +最初の 2 つのフィールドは、日付 (ユリウス歴に修正済) と時刻 (UTC 午 +前 0 時からの秒数)です。次の 2 つのフィールドは、それぞれ +dotted-quad 記法で表された通信相手のアドレスとステータスです。ステー +タスフィールドは、 NTP の仕様である RFC 1305 の Appendix A で記述さ +れたフォーマットに従い 16 進数にエンコードされています。最後の 3 つ +のフィールドは、オフセット, 遅延, ばらつきで、すべて秒単位です。 +.RE +.Ip clockstats 10 +時計ドライバの統計情報の記録を有効にします。時計ドライバからの更新を +受ける度に、 \*(L"clockstats\*(R" と名付けられたファイル生成セット次 +の形式の行を出力します: +.PP +.RS 5 +49213 525.624 127.127.4.1 93 226 00:08:29.606 D +.RE + +.RS 10 +最初の 2 つのフィールドは、日付 (ユリウス歴に修正済) と時刻 (UTC 午 +前 0 時からの秒数)です。次のフィールドは、dotted-quad 記法で表された +時計のアドレスです。最後のフィールドは、時計から受け取った最後のタイ +ムコードで、ここでは意味のある ASCII 形式になっています。いくつかの +時計ドライバでは、たくさんの付加的情報が集められ、同様に表示されます。 +より詳しくは、それぞれの時計の仕様情報を参照してください。 +.RE +.PP +統計ファイルは、ファイル生成セット(下記 +.B filegen +を参照)を用いて管理されます。統計を記録することで得られる情報は、 +.I xntpd +サーバの一時的なプロパティ (properties) の解析を可能にします。通常は +主要な (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 +ファイル生成セット (file generation set) +.IR name +の設定を行います。ファイル生成セットは、サーバーの活動期間を通じて継 +続的に大きくなっていくファイルを扱う手段を提供します。サーバ統計はこ +のようなファイルの典型例です。ファイル生成セットにより、現状のデータ +を格納するのに用いられるファイル集合にアクセスできます。任意の時点で、 +集合の高々 1 つの要素への書き込みが行われます。 +.I type +は、その集合の新たな要素に、データが、いつ、どのように出力されるのか +の仕様を与えます。この方法で、 +.I xntpd +の動作を妨げる危険なしに、管理的な操作 (administrational operations) +から、現在使用されていないファイル集合の要素に格納されている情報が、 +利用できるようになります。(最重要: それらは、新たな出力データのため +空きを作るのに削除される可能性があります。)要素のファイル名は 3 つの +部分から作られます。 +.Ip prefix 10 +不変なファイル名のパスです。 +.B filegen +文による修正の対象にはなりません。サーバによって定義され、通常コンパ +イル時の定数として指定されます。しかし、他のコマンドにより、個別のファ +イル生成セットに対して設定は可能です。たとえば、"loopstats" と +"peerstats" という filegen で用いられるプレフィックスは、すでに説明 +した +.B statsdir +文を使用して設定できます。 +.Ip filename 10 +この文字列は、上で述べた +.I prefix +に、( \*(L'/\*(R' (スラッシュ) を入れずに ) 直接連結されます。 +\*(L"filegen\*(R" 文の \*(L"file\*(R" 引数を使って修正できます。 +\*(L"prefix\*(R" により示されるファイル名が、ファイルシステム階層の +外側を参照しないように、この部分は \*(L"..\*(R" を含んではいけないよ +うになっています。 +.Ip suffix 10 +この部分はファイル集合の各要素を反映します。後述のように、ファイル集合の +.I type +に従って生成されます。 +.PP +ファイル生成セットは、その型 (type) により特徴づけられます。次の型が +サポートされています: +.Ip none 10 +ファイル集合は実際には、単一のプレーンファイルです。 +.Ip pid 10 +.I xntpd +サーバの起動ごとに、ファイル集合の 1 つの要素が使われます。この型は、 +実行中にファイル集合の要素への変更を一切行いませんが、異なる +.I xntpd +サーバの起動ごとに別々のファイルをつくる簡単な方法になります。要素の +ファイル名は、 \*(L"prefix\*(R" と \*(L"filename\*(R" をドット +(\*(L'.\*(R') でつなげた上、 +.I xntpd +サーバプロセスのプロセス ID の10進表現をつなげで作られます。 +.Ip day 10 +1 日に 1 つのファイル生成セットの要素が作成されます。ここで、 +.I 日 +という用語は、 +.IR UTC +に基づきます。1 日は、 UTC の 00:00 と 24:00 の間の期間として定義さ +れます。要素のサフィックスは、ドット \*(L".\*(R" と +.RI < YYYYMMDD > +の形式の日付指定からなります。 +.I YYYY +は 4 桁の西暦年 (たとえば 1992)で、 +.I MM +は、2 桁の月です。 +.I DD +は、2 桁の日となります。したがって、1992 年 12 月 10 日に情報はすべ +て、 \*(L"<prefix><filename>.19921210\*(R" という名前のファイルに書 +かれます。 +.Ip week 10 +どの要素も 1 年の内のある週に関連するデータを含みます。ここで、 +.I 週 +という用語は、年の始まりからの日数の 7 の商により定義されます。この +ようなファイル生成セットの要素は、ファイル集合のファイル名のベースに +次のようなサフィックスをつけることで区別されます。サフィックスは、ドッ +ト, 4 桁の西暦年, 文字 \*(L"W\*(R", 2 桁の週番号です。例えば、 1992 +年 1 月 10 日からの情報は、サフィックス \*(L".1992W1\*(R" を持つファ +イルに出力されます。 +.Ip month 10 +1 月に 1 つのファイル生成セットの要素が作成されます。ファイル名のサ +フィックスは、ドット, 4 桁の西暦年, 2 桁の月からなります。 +.Ip year 10 +1 年に 1 つのファイル生成セットの要素が作成されます。ファイル名のサ +フィックスは、ドットと 4 桁の西暦年からなります。 +.Ip age 10 +この型のファイル生成セットは、サーバが 24 時間活動するごとに新たな要 +素に変わります。ファイル名のサフィックスは、ドット, 文字 +\*(L"a\*(R", 8 桁の数からなります。この数は、対応する 24 時間の始め +からサーバが実行されている秒数であるようになります。 +.PP +情報は、ファイル生成セットが \*(L"enabled\*(R"のときのみ、そのセット +に書込まれます。出力は \*(L"disabled\*(R"を指定することで抑止されます。 +.PP +ファイル生成セットの +.I 現在の +要素に決まった名前でアクセスできると便利です。この機能は、 +\*(L"link\*(R" を指定することで有効になり、 \*(L"nolink\*(R" を使っ +て無効になります。 \*(L"link\*(R" が指定されると、 現在の要素からサ +フイックスを持たないファイルへのハードリンクが作成されます。その名前 +を持つファイルが既に存在し、そのファイルのリンク数が 1 の場合、その +ファイル名に、ドット, 文字 \*(L"C\*(R", +.I xntpd +サーバプロセスの pid をつなげて、名前変更を行います。リンク数が 1 以 +上の場合、ファイルはアンリンクされます。これにより現在のファイルを定 +数名でアクセスすることができます。 +.SH "その他のオプション" +.PP +.B precision +.I # +.PP +このコマンドは、ローカル時計の名目上の (nominal) 精度を指定します。 +この値は、秒単位のローカルの時間管理精度の底を 2 とする対数に近似的 +に等しい整数です。ふつう、デーモンは起動時に自動的に精度を決定するの +で、このコマンドは、精度を自動的に決定できない特殊な場合にのみ必要に +なります。 +.PP +.B broadcastdelay +.I seconds +.PP +ブロードキャストおよびマルチキャストモードは、ローカルとリモートサー +バ間のネットワーク遅延を決定するため、特別の修正を必要とします。通常、 +この修正は、ローカルとリモートサーバ間の最初のプロトコル交換により、 +自動的に行われます。修正手続きは、例えば、ネットワークもしくはサーバー +のアクセス制御のために失敗する可能性があります。このコマンドは、これ +らの状況下で使用されるデフォルトの遅延を指定します。(イーサネットに +対する)典型としては、0.003 から 0.007 秒が適切です。このコマンドが使 +用されない場合のデフォルトは、 0.004 秒です。 +.PP +.B trap +.I host_address +[ +.B port +.I port_number +] [ +.B interface +.I interface_addess +] +.PP +このコマンドは、指定されたローカルインターフェイスに送られるメッセー +ジに対する、所与のホストアドレスとポート番号でのトラップレシーバを設 +定します。ポート番号が指定されない場合、 18447 が使用されます。イン +ターフェイスアドレスが指定されない場合、メッセージが送信時に通過する +ローカルインターフェイスのアドレスをソースアドレスとしてメッセージが +送られます。マルチホームのホストでは、使用されるインターフェイスが、 +ルーティングの変更にともない変化し得ることに注意してください。 +.PP +トラップレシーバは、一般には、イベントメッセージやサーバからのその他 +の情報をログファイル中に記録するものです。このようなモニタプログラム +はまた、それら自身のトラップをダイナミックに要求するかもしれませんが、 +トラップレシーバの設定は、サーバのスタート時にメッセージが失われない +ことを保証することになっています。 +.PP +.B setvar +.I variable +.I [default] +.PP +このコマンドは、付加的なシステム変数を追加します。これらの変数は、ア +クセスポリシなどの付加的な情報を配布するために使用できます。 +<name>=<value> の形式の変数に、キーワード +.I default +が続いた場合、変数はデフォルトのシステム変数の一部としてリストされる +ようになります ( +.I ntpq rv +コマンド) 。これら付加的な変数は、情報を与える目的だけを果たします。 +リストされ得ると言うこと以外に、プロトコルに関係しません。 +既知のプロトコル変数は常に、 +.I setvar +の機構により定義されたいかなる変数よりも優先されます。 +.PP +同一グループのすべての変数の名前を含む 3 つの特別な変数があります。 +.I sys_var_list +は、すべてのシステム変数の名前を保持しています。 +.I peer_var_list +は、すべての peer (交信相手) 変数の名前を保持しています。 +.I clock_var_list +は、参照時計変数の名前を保持しています。 +.PP +.B monitor yes|no +.B authenticate yes|no +.PP +これらのコマンドは、 +.B enable +と +.B disable +コマンドに置き換えられました。ここにあげたのは歴史を述べるためです。 +.SH "認証キーファイルのフォーマット" +.PP +NTP 標準は、受信した NTP パケットの認証の確認を可能とし、送信パケッ +ト内の認証の指示を与えるための拡張を定めています。これは、 +.I xntpd +においては、デジタル署名, あるいは message-digest を計算するため、 +DES もしくは MD5 アルゴリズムを使用して実装されています。この仕様は、 +32 ビットのキー識別子により、ほぼ 40 億分の 1 が、連携 (association) +の認証に使用できるようにしています。連携に含まれるサーバは、各々独立 +にキーとキー識別子を学習せねばならないにも関わらず、データを認証する +のに使用されるキーとキー識別子に合意せねばなりません。 DES の場合、 +キーは 56 ビット長で、型によっては各バイトにパリティがつきます。MD5 +の場合、キーは 64 ビット (8 バイト) です。 +.I xntpd +は、 +コマンドラインオプション +.B -k +もしくはコンフィギュレーションファイル中の +.B keys +文を使用して指定されるファイルからキーを読み込みます。キー番号 0 は、 +NTP 標準によって (56 ビットの 0 として) 決定されており、変更できませ +んが、一方、1 から 15 のキー番号の内の 1 つ以上がキーファイル中で任 +意にセットできます。 +.PP +キーファイルは、コンフィギュレーションファイルと同様のコメント記述法 +を使用しています。キーエントリはの形式の固定されたフォーマットを +使用します。 +.Ip "" 5 +.I "keyno type key" +.PP +の形式の固定されたフォーマットを使用します。ここで、 \*(L"keyno\*(R" +は正の数、 \*(L"type\*(R" はキーが与えられる形式を定義する単一文字、 +\*(L"key\*(R" はキーそれ自身です。 +.PP +キーは、 \*(L"type\*(R" 文字による制御で、3 つの異なるフォーマットの +内の 1つで与えられます。3 つのキーの型とそれに対応するフォーマットは、 +次にあげるとおりです。 +.Ip "S" 5 +\*(L"key\*(R" は、 DES のドキュメントに定められたフォーマットの 64 +ビットの 16進数で、各オクテットの上位 7 ビットが使用された 56 ビット +キーです。各オクテットの下位 1 ビットは、オクテットを奇数パリティに +保つように与えられます。先頭の 0 は省略できません (すなわち、キーは +正確に 16 桁の 16 進数である必要があります) 。また、奇数パリティが保 +たれねばなりません。それゆえ、ゼロキーは、標準フォーマットで、 +.I 0101010101010101 +として与えられます。 +.Ip "N" 5 +\*(L"key\*(R" は、 NTP 標準で定められたフォーマットの 64 ビットの 16 +進数です。これは、各オクテットを 1 ビット右 rotate して、パリティビッ +トがオクテットの上位ビットになったことを除いては、 DES フォーマット +と同じです。先頭の 0 は省略できず、奇数パリティが保たれねばなりませ +ん。ゼロキーは、 NTP フォーマットで、 +.I 8080808080808080 +のように指定されます。 +.Ip "A" 5 +\*(L"key\*(R" は 1 文字から 8 文字の ASCII 文字列です。キーは、文字 +列中の各文字の ASCII 表現の下位 7 ビットを使用して構成されます。56 +ビット幅のキーを作るために、 Unix パスワードから暗号化キーを作るのと +同じ方法で、必要なら 0 が右端に付加されます。 +.Ip "M" 5 +\*(L"key\*(R" は 1 文字から 8 文字の ASCII 文字列で、 MD5 の認証方式 +を使用しています。キーと認証方式 (DES または MD5) の両方が、同じキー +番号を共有する一組の交信相手の間で一意であることが、必要であることに +注意してください。 +.PP +コンフィギュレーションファイルの +.B requestkey +文の方法で、 +.IR xntpdc (8) +プログラムを用いてなされる実行時の設定要求を認証するために、キーの内 +1 つが選択できます。後者のプログラムは、パスワードとして端末からキー +を得ます。ですから、一般に、この目的のために使用されるキーを ASCII +表現で指定するのは、適切なことです。 +.SH 主要な時計サポート (PRIMARY CLOCK SUPPORT) +.I xntpd +は、オプションで、いくつかの型の参照時計に対するサポートを含むように +コンパイルできます。参照時計は、一般に (常にではなく)、カナダの NRC +やアメリカの NIST により提供されるサービスと同様の標準時刻の供給源に +同期している無線時刻コード受信機です。コンピュータと時刻コード受信機 +の間のインターフェイスはデバイス依存で多種にわたりますが、多くはシリ +アルポートです。 +.PP +多種類の参照時計ドライバに対するサポートは、他の場所で記述されたコン +パイラ定義のコードを使用して、条件コンパイルされます。参照時計を設定 +しようとする試みは、特定のサポートが得られないか、ハードウェアポート +が適切に設定されていないとき、システムログファイルに警告を残しますが、 +そのほかでは障害となりません。 +.PP +設定のために、 +.I xntpd +は、参照時計を、できるかぎり普通の NTP の交信相手にするのと同じよう +な方法で扱います。参照時計は、普通の交信相手と同様にアドレスで参照さ +れますが、普通の交信相手と区別するため、無効なアドレスが使用されます。 +参照時計のアドレスは、 +.I 127.127.t.u +の形式となります。ここで、 +.I t +は、時計の型を示す整数で、 +.I u +は、型で特定されるユニット番号を示します。参照時計は、コンフィギュレー +ションファイル中の +.B server +文を使用して設定されます。このときの +.I host_address +は、時計のアドレスです。 +.I key +と +.I version +と +.I ttl +オプションは、参照時計サポートのためには使用されませんが、 +.I prefer +オプションは、ある参照時計を、それが望ましい場合には、他の参照時計や +交信相手より少し熱心に大事に扱わせるよう、サーバに促すのにうまく使え +ます。時計のアドレスは、一般にコンフィギュレーションファイル中で普通 +の IP アドレスが使用できるところならどこでも使用できます。例えば、 +.B restrict +文中などですが、このような使用法は普通は奇妙に思えるでしょう。 +.PP +参照時計サポートは、特別の方法で参照時計を設定するのに使用できる +.B 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 +と +.B time2 +オプションは、秒単位の固定小数点で指定され、いくつかの時計ドライバで +は、補正定数として使用されます。慣習により、別のやり方で示されない限 +り、 +.B time1 +は、特定の時計の名目上の時間オフセットを、高精度の PPS 信号のような、 +外部の標準に一致させるように調整するための補正定数として使用されます。 +指定されたオフセットは、内部の DIP スイッチのような他の手段により与 +えられた伝搬遅延に付加されます。 +.B stratum +オプションは 0 から 15 までの数で、時計に対し非標準の operating +stratum を割当てるのに使用します。 +.B refid +オプションは、 1 から 4 文字までの ASCII 文字列で、時計に対し非標準 +の参照識別子を割当てるのに使用します。最後に、4つの 2 値フラグ +.B flag1, +.B flag2, +.B flag3, +.B flag4 +は、時計ドライバをカスタマイズするのに使用されます。これらの値の解釈 +や、ともかくそれらが用いられるのかどうかは、特定の時計ドライバが必要 +とするかに関わっています。しかし、慣習により、別のやり方で示されない +限り、 +.B flag3 +は、 ppsclock ストリームモジュールを設定されるドライバにアタッチする +のに使用され、一方、 +.B flag4 +は、 +.I filegen +コマンドで設定される時計統計 (clockstats) ファイルへの詳細なモニタリ +ングデータの記録を有効にするために使用されます。 ppsclock ストリーム +モジュールについてのさらなる情報は、現在の xntp3 プログラムのディス +トリビューション中の ./kernel ディレクトリの README ファイル内にあり +ます。この機能についてのさらなる情報は、同じディストリビューション中 +の ./scripts/stats ディレクトリにあります。 +.PP +通常、参照時計の stratum は、デフォルトで 0 です。 +.I xntpd +デーモンは、各交信相手の stratum に 1 を加算するので、主要 (primary) +サーバは、通常 stratum 1 を示します。巧みに運用されたバックアップを +与えるために、参照時計の stratum を 0 以上に指定することは、役に立つ +ことが多いです。 +.B stratum +オプションは、この目的のために使用されます。また、参照時計と 1-pps +discipline 信号の両方を含む場合、ドライバによっては、参照時計識別子 +をデフォルト以外に指定することは有用です。 +.I refid +オプションは、この目的のために使用されます。そう記されていない限り、 +これらのオプションは、すべての時計ドライバに適用されます。 +.PP +現在、Unix マシン上の +.I xntpd +は、バックアップとして用いられる、あるいは他の時計供給源が与えられな +いとき使用される特殊な仮想時計に加えて、いくつかの異なる型の時計ハー +ドウェアをサポートしています。たいていの時計ドライバの場合、xntp3 プ +ログラムのディストリビューション中の ./doc ディレクトリの README ファ +イル内で述べられているように 1-pps 精度のタイミング信号に対するサポー +トが利用可能です。時計ドライバ、およびそれらを設定するのに使用される +アドレスは、現在の xntp3 プログラムのディストリビューション中の doc +ディレクトリの README.refclocks で記述されています。 +.PP +.SH 変数 + NTP protocol により用いられるたいていの変数は、 +.I xntpdc +(モード 7 メッセージ) と +.I ntpq +(モード 6 メッセージ) で、調べることができます。 +現在は、ごくわずかの変数が、モード 6 メッセージを通して変更可能です。 + +これらの変数は、 +.I setvar +の指示で作られたか、リープ警告 (leap warning) 変数かのどちらかです。 +リープ警告ビットは、 +.B leapwarning +変数で (1 ヶ月前までに) セットされます。 +.B leapwarning +と +.B leapindication +変数内の両方が通常の +.B leap +ビット解釈と少し違ったエンコーディングを持っています: +.P +.Ip 00 8 +デーモンは、同期源のリープビットを渡します (通常モードの動作) 。 +.Ip 01/10 8 +リープ秒が、付加/削除されます (オペレータによるリープ秒の強制)。 +.Ip 11 8 +同期源からのリープ情報は、無視されます (それゆえ LEAP_NOWARNING が与 +えられます) 。 +.PP +.SH 関連ファイル +.Ip /etc/ntp.conf 20 +デフォルトのコンフィギュレーションファイル名 +.Ip /etc/ntp.drift 20 +ドリフトファイルの慣習上の名前 +.Ip /etc/ntp.keys 20 +キーファイルの慣習上の名前 +.SH 関連項目 +.PP +.IR xntpdc (8), +.IR ntpq (8), +.IR ntpdate (8) +.SH 歴史 +.PP +.Nm +コマンドはトロント大学の Dennis Ferguson によって書かれました。テキ +ストはデラウェア大学の David Mills により修正されました。 +.SH バグ +.PP +.I xntpd +はかなり大きくなってしまいました。巨大とは言いませんが、ワークステー +ションで実行される可変プライオリティのデーモンとして望ましい大きさを +超えてしまいました。それは特に、かさばる凝った特徴の多くが、高い +stratum のワークステーションよりは、高負荷の主要 (primary) サーバに +あわせて設計されているからです。 diff --git a/ja_JP.eucJP/man/man8/xntpdc.8 b/ja_JP.eucJP/man/man8/xntpdc.8 new file mode 100644 index 0000000000..3b3e7beeca --- /dev/null +++ b/ja_JP.eucJP/man/man8/xntpdc.8 @@ -0,0 +1,737 @@ +''' $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) +デーモンの現在の状態についての問い合わせや、状態の変更を要求する際に使 +われます。このプログラムは、対話的なモードでもコマンドライン引数を +使った制御でも動作させることができます。 +広範囲にわたる状態や統計の情報が、 +.I xntpdc +のインタフェースを通じて提供されています。 +それに加えて、 +.I xntpd +の設定ファイルを使って起動時に指定できるほとんどすべて +のオプションが、 +.I xntpdc +を使って、実行時にも指定できます。 +.PP +.I xntpdc +が実行されたとき、一つまたは複数のリクエストオプションが、 +コマンドラインに含まれる場合は、それぞれのリクエストは、コマンドライン +引数で与えられるホスト、またはデフォルトである +.I localhost +の NTP サーバに送られます。 +リクエストオプションが付けられなかったとき、 +.I xntpdc +はコマンドを標準入力から読み込もうとし、コマンドラインで与えられた +最初のホストで走っている NTP サーバに対してそのコマンドを実行します。 +ホストが指定されなかったときは、 +デフォルトである +.I localhost +のサーバに対して実行します。 +.I xntpdc +は、標準入力が端末である場合だけ、プロンプトを出します。 +.PP +.I xntpdc +は、 NTP サーバとの通信に NTP mode 7 パケットを使うため、 +ネットワーク上でそれを許すような互換サーバへの問い合わせに使えます。 +NTP は UDP プロトコルなので、特にネットワークトポロジー的に遠くに +ある場合は、この通信はやや信頼性に欠けるということを覚えておいて下さい。 +.I xntpdc +は、リクエストを再送する試みを行ないません。適当なタイムアウト時間の +範囲内でリモートホストから返答がなかったときは、時間切れとなります。 +.PP +コマンドラインオプションは以下の通りです。 +.B -i +または +.B -n +以外のコマンドラインオプションを指定すると、指定したホスト (群) に、 +指定した問い合わせ (または複数の問い合わせ) を直ちに送ることになります。 +指定しなかった場合、 +.I xntpdc +は標準入力から対話的なフォーマットのコマンドを読み込もうとします。 +.Ip -c 8 +次の引数が対話的なフォーマットのコマンドとして解釈され、指定したホストで +実行されるようにコマンドのリストに加えられます。 +複数の +.B -c +オプションを与えることができます。 +.Ip -i 8 +.I xntpdc +を強制的に対話的モードで動作させます。標準出力にプロンプトが +表示され、標準入力からコマンドが読み込まれます。 +.Ip -l 8 +サーバに既知の peer のリストを取得します。このスイッチは、 +\*(L"-c listpeers\*(R" と同等です。 +.Ip -n 8 +すべてのホストアドレスを、標準的なホスト名でなく、ドット区切りの 4 個 +の数値で出力します。 +.Ip -p 8 +サーバに既知の peer のリストと、それらの状況の要約を出力します。 +これは、 \*(L"-c peers\*(R" と同等です。 +.Ip -s 8 +サーバに既知の peer のリストと、それらの状況の要約を、 +.B -p +スイッチとは少し異なるフォーマットで出力します。 +これは \*(L"-c dmpeers\*(R" と同等です。 +.SH 内部コマンド +.PP +対話的なフォーマットのコマンドは、キーワードとそれに続く 0 から 4 個の +引数から構成されます。キーワード全長のうち、他と区別できる文字数が +タイプされれば、有効になります。 +コマンドの出力は通常標準出力に送られますが、コマンドライン上で +\*(L">\*(R" に続けてファイル名を指定することで、個々のコマンドの出力を +ファイルに送ることができます。 +.PP +いくつかの対話的フォーマットのコマンドは、 +.I xntpdc +プログラム自身の中で全体が実行され、サーバへの NTP mode 7 リクエストは +送られません。この種類のコマンドには以下の物があります。 +.PP +.B ? +[ +.I command_keyword +] +.PP +\*(L"?\*(R" のみのコマンドは、 +.I xntpdc +が知っているすべてのコマンドキーワードのリストを出力します。 +\*(L"?\*(R" とそれに続くコマンドキーワードは、コマンドの機能と用法を +出力します。このコマンドは、 +.I xntpdc +に関して、このマニュアルよりも多分良い情報源となるでしょう。 +.PP +.B help +[ +.I command_keyword +] +.PP +.B ? +コマンドと同義です。 +.PP +.B timeout +.I millseconds +.PP +サーバ問い合わせに対する応答のタイムアウト時間を指定します。デフォルト +は、約 8000 ミリ秒です。 +.PP +.B delay +.I milliseconds +.PP +認証を求めるリクエストに含まれるタイムスタンプに加えられる時間を +指定します。これは、長い遅延のあるネットワーク経路や時刻の同期していない +マシン間で (信頼できない) サーバの再設定ができるようにするために +使われます。 +.PP +.B host +.I hostname +.PP +問い合わせを送るホストを指定します。 +.I hostname +は、ホスト名でも数値アドレス (ドット区切りの数値 4 つ) でもかまいません。 +.PP +.B keyid +.I # +.PP +このコマンドで、認証設定リクエストに使われるキー番号を指定できます。 +この番号は、この目的で使うためにサーバが設定したキー番号に一致して +いなければなりません。 +.PP +.B passwd +.PP +このコマンドは、認証設定リクエストに使われるパスワードの入力 +(エコーされません) を求めるプロンプトを出します。 +このリクエストが成功するためには、NTP サーバが認証のために使うよう +設定したキーに、パスワードが一致していなければなりません。 +.PP +.B "hostnames yes|no" +.PP +\*(L"yes\*(R" が指定されると、情報の表示の際、ホスト名が使用されます。 +\*(L"no\*(R" が与えられると、代わりに数値アドレスが使用されます。 +コマンドラインの +.B -n +スイッチが使われなければ、 +デフォルトは \*(L"yes\*(R" になります。 +.PP +.B quit +.PP +.I xntpdc +を終了します。 +.SH 問い合わせコマンド +.PP +問い合わせコマンドは、情報を要求する NTP mode 7 パケットをサーバに送ります。 +これらは、サーバの設定状態を変更できない \*(L"読み込み専用\*(R" コマンドです。 +.PP +.B listpeers +.PP +サーバが状態を管理する peer の簡略なリストを得て、出力します。 +これには、サーバが同期する予定の候補であるとみなす階層の peer を含めた、 +すべての設定された隣接 peer を含んでいるはずです。 +.PP +.B peers +.PP +サーバが状態を管理する peer と、その状態の要約を出力します。 +状態の要約は、以下のものを含みます。すなわち、リモート peer のアドレス、 +ローカルインターフェースアドレス (ローカルアドレスが決まっていないなら +0.0.0.0) 、リモート peer の階層 (階層 16 は、リモートの peer が同期していない +事を示します)、秒で表すポーリング間隔、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 +少々異なる peer 要約リストです。 +行の左端の文字以外は +.B 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 +指定した peer に関連する統計カウンタを peer 毎に表示します。 +.PP +.B clockinfo +.I clock_peer_address +[ +.I addr2 +] [ +.I addr3 +] [ +.I addr4 +] +.PP +peer クロックに関する情報を得て、それを表示します。得られた値は、 +設定上のあいまいな要因の情報と他のクロックの性能の情報を +提供してくれます。 +.PP +.B kerninfo +.PP +カーネルの phase-lock ループ操作パラメータを得て、それを表示します。 +この情報は、精度の高い時刻保持機能のために、カーネルが特に +修正されている場合にだけ得られます。 +.PP +.B loopinfo +[ +.B oneline|multiline +] +.PP +選択されたループフィルタ変数の値を表示します。ループフィルタとは、 +ローカルシステムクロックの調節を行なう NTP の一部です。 +\*(L"offset\*(R" は、パケット処理コードによってループフィルタに +与えられる最後のオフセットです。 \*(L"frequency\*(R" は、 +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" は、 +システム周波数の修正がされた後に残る残留周波数誤差で、 +保守やデバッグに使われます。 +多くのアーキテクチャでは、この値は初期の 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 +プロトコルモジュールで管理される統計カウンタを表示します。 +.PP +.B memstats +.PP +メモリ割り当てコードに関する統計カウンタを表示します。 +.PP +.B iostats +.PP +入力\-出力モジュールで管理される統計カウンタを表示します。 +.PP +.B timerstats +.PP +timer/event キューをサポートするコードで管理される統計カウンタを +表示します。 +.PP +.B reslist +.PP +サーバの制限リストを得て、表示します。このリストは、 +(通常) ソートされた順で出力され、制限がどのように適用されるかを +理解する助けになるかもしれません。 +.PP +.B monlist +[ +.I version +] +.PP +モニタ機能により収集、管理されるトラフィックカウントの値を得て、表示します。 +通常、バージョン番号は指定する必要がありません。 +.PP +.B clkbug +.I clock_peer_address +[ +.I addr2 +] [ +.I addr3 +] [ +.I addr4 +] +.PP +時刻参照ドライバのデバッグ情報を得ます。この情報は、 +一部のクロックドライバでだけ提供され、 +ドライバのソースのコピーが手元に無い場合、ほとんどデコードできません。 +.SH 実行時設定リクエスト +.PP +サーバ内で状態を変更するようなリクエストは、すべてサーバが設定した NTP +キーを使って認証されます +(この機能はキーを設定しないことで、無効にもできます) 。 +キー番号とそれに対応するキーも、 +.I xtnpdc +が知っていなければなりません。 +これは、 +.B keyid +と +.B passwd +コマンドを使えば可能で、後者では、暗号化されたキーを使うために +パスワードを求めるプロンプトを端末に出します。 +サーバへの認証リクエストを必要とするコマンドが最初に実行された場合でも、 +自動的にキー番号とパスワードの入力を要求します。 +認証は、そのような変更をする権限を持っているリクエストであるかを +検証するだけでなく、送信エラーに対するより一層の保護を行う事になります。 +.PP +認証リクエストは、常にパケットデータの中に、認証コードの計算に +含まれているタイムスタンプを含んでいます。 +このタイムスタンプは、サーバによって受信時刻と比較されます。この差がある小さな +値より大きければ、リクエストは拒否されます。これには二つの理由があります。 +一つは、あなたの LAN のトラフィックを盗み聞きできる誰かによるサーバへの +単純かつ繰り返しによる攻撃を困難にします。二つ目は、ネットワーク的に +離れたホストから、あなたのサーバへ設定変更リクエストを行なうことを +困難にします。 +再設定は、ローカルホストのサーバに対しては簡単で、時刻同期した +同じ LAN 上のホストでも普通に行なえますが、より離れたホストでは +やりにくくなっています。 +したがって、適当なパスワードを選択し、キーの配布と防護に注意を払い、 +適切なソースアドレス制限が施されれば、実行時再設定の機能については +適切なセキュリティレベルにあることになります。 +.PP +以下のコマンドは皆、認証リクエストです。 +.PP +.B addpeer +.I peer_address +[ +.I keyid +] [ +.I version# +] [ +.B prefer +] +.PP +与えられたアドレスを設定された隣接 peer として追加し、symmetric active +モードで動作します。 +既に隣接 peer として設定されている peer を指定した場合、その peer は +このコマンドが実行されたときに削除 +されるか、単に新しい設定に従うよう適当に変更されます。 +オプションの \*(L"keyid\*(R" が 0 でない整数の場合、リモートサーバに +出ていくすべてのパケットは、このキーにより暗号化された +認証フィールドを持つことになります。値が 0 の場合 +(または指定されなかった場合)、認証は行なわれません。 +\*(L"version#\*(R" は、1, 2, 3 のどれか +となり、デフォルトは 3 です。 \*(L"prefer\*(R" キーワードは、 +優先する peer を示します(その結果、可能であれば時刻同期の主要元として +使用されます)。 +優先する peer は、 PPS 信号の信頼性も決めます。優先する peer が同期に +適している場合、PPS 信号も信頼できると判断されます。 +.PP +.B addserver +.I peer_address +[ +.I keyid +] [ +.I version# +] [ +.B prefer +] +.PP +操作モードがクライアントであること以外は、 +.B addpeer +コマンドと同等です。 +.PP +.B broadcast +.I peer_address +[ +.I keyid +] [ +.I version# +] +.PP +操作モードが broadcast であること以外は、 +.B addpeer +コマンドと同等です。この場合、正当なキー識別子とキーが +必要になります。 \*(L"peer_address\*(R" パラメータは、 +ローカルネットワークのブロードキャストアドレスか、または NTP に +割り当てられたマルチキャストグループアドレス にできます。 +マルチキャストアドレスの場合、マルチキャストに対応したカーネルが +必要になります。 +.PP +.B unconfig +.I peer_address +[ +.I addr2 +] [ +.I addr3 +] [ +.I addr4 +] +.PP +このコマンドは、指定した peer (群) から設定されている bit を除きます。 +多くの場合、これによって隣接 peer の設定が削除されることになります。 +しかしながら、リモートの peer が設定されていない状態のまま継続しようとし、 +それが適切である場合は、隣接関係は、設定されていないモードのまま残る場合も +あります。 +.PP +.B fudge +.I peer_address +[ +.I time1 +] [ +.I time2 +] [ +.I stratum +] [ +.I refid +] +.PP +このコマンドは、あるデータを参照時刻としてセットすることができます。 +詳しい情報は、ソースリストを見て下さい。 +.PP +.B enable auth|bclient|pll|monitor|stats +[ +.I ... +] +.PP +各種サーバオプションを有効にします。言及されていないフラグ +は影響を受けません。 \*(L"auth\*(R" フラグは、 peer が信頼できるキーと +キー識別子を使って正しく認証されたときだけ、設定されていない +peer にサーバを同期させます。 +デフォルトは無効 (オフ) です。 \*(L"bclient\*(R" フラグは、サーバが +ブロードキャストサーバやマルチキャストサーバからのメッセージを +聞く (listen) ようにして、 自動的にそのサーバと隣接関係を設定します。 +デフォルトは無効 (オフ) です。 \*(L"pll\*(R" フラグは、 +サーバがローカルクロックを修正するようにします。 +デフォルトは有効 (オン) です。これが設定されていないと、ローカルクロック +は内部の時間および周波数オフセットによって勝手に動作することになります。 +このフラグは、ローカルクロックが他のデバイスやプロトコルにより +制御されていて、 NTP は他のクライアントが同期するためだけに使われるような +場合に便利です。 \*(L"monitor\*(R" フラグは、 +モニタ機能 (他を参照のこと) を可能にするもので、 +デフォルトは無効 (オフ) です。 \*(L"stats\*(R" フラグは、統計機能 +ファイル出力 (他の説明を参照のこと) を可能にします。 +デフォルトは、有効 (オン) です。 +.PP +.B disable auth|bclient|pll|monitor|stats +[ +.I ... +] +.PP +各種サーバオプションを無効 (オフ) にします。言及されていない +フラグは影響を受けません。現在有効なフラグは、 enable コマンドのところで +述べられています。 +.PP +.B restrict +.I address +.I mask +.I flag +[ +.I flag +] +.PP +フラグ (群) を存在する制限リストエントリに加えるか、または指定した +フラグ (群) で新しいエントリをリストにつけ加えます。 +可能なフラグ引数の選択は、以下の通りとなります: +.Ip ignore 10 +このエントリにマッチするホストからのすべてのパケットを無視します。 +このフラグが指定されると、どんな問い合わせやタイムサーバの +ポーリングにも反応しなくなります。 +.Ip noquery 10 +ソースからの NTP mode 7 のパケット +(すなわち、情報問い合わせと設定リクエスト) をすべて無視します。 +時刻サービスは影響されません。 +.Ip nomodify 10 +サーバの状態を変更しようとする NTP mode 7 のパケット (すなわち、 +実行時再設定) をすべて無視します。 +情報を返すような問い合わせは許されます。 +.Ip notrap 10 +一致するホストへの、モード 6 制御メッセージのトラップサービスを +提供しません。このトラップサービスはモード 6 制御メッセージプロトコルの +サブシステムで、リモートイベントの記録を行うようなプログラムで使用される +事を意図しています。 +.Ip lowpriotrap 10 +一致するホストによるトラップの優先度を低くします。 +サーバが管理できるトラップの数は制限されています (現在の制限は 3)。 +トラップは、通常早い物勝ちベースで割り当てられ、制限に達すると以降の +トラップ要求は拒否されます。このフラグは割り当てアルゴリズムを変更し、 +優先度の低いトラップは後から発生した通常の優先度のトラップ要求により +無効にされるようになります。 +.Ip noserve 10 +モードが 7 以外の NTP パケットを無視します。要するに、問い合わせは受け +付けるが、時刻サービスは拒否することになります。 +.Ip nopeer 10 +問い合わせて来たホストに、状態を保存しない時刻サービスを行ないます。 +しかし、たとえ将来同期先の相手として便利だとしても、 +これらのホストには peer メモリのリソースを割り当てません。 +.Ip notrust 10 +これらのホストを同期する元としては決して使用しませんが、その他の +部分では通常に扱います。 +.Ip limited 10 +これらのホストは同一のネットからのクライアントの数の制限を受けます。 +この文脈でいう +ネットとは、ネットの IP の概念 (クラス A 、クラス B 、クラス C 等) を +指します。 +サーバが認識している \*(L"client_limit\*(R" 以下のホスト数で、 +過去 \*(L"client_limit_period\*(R" 秒間アクティブ +だったホストは受け入れられます。同じネットの他のクライアントからの +リクエストは、拒否されます。時刻リクエストパケットだけが考慮されます。 +\*(L"private\*(R" と \*(L"control\*(R" と +\*(L"broadcast\*(R" のパケットは、クライアントの制限を受けず、 +したがってクライアント数にも数えられません。 +クライアントの履歴は、 +.I xntpd +のモニタ機能により保存されます。 +したがって、モニタ機能は、 \*(L"limited\*(R" フラグで制限されたエントリが +ある限り機能します。 +デフォルトの \*(L"client_limit\*(R" 値は 3 です。 +デフォルトの \*(L"client_limit_period\*(R" 値は 3600 秒です。 +現在、どちらの変数も実行時には変更できません。 +.Ip ntpport 10 +これは制限フラグというより、実際にはマッチアルゴリズム修飾子です。 +これがあると、パケットのソースポートが標準 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 +や +.I mask +の引数で指定された制限リストエントリから、指定されたフラグを除きます。 +.PP +.B delrestrict +.I address +.I mask +[ +.B ntpport +] +.PP +制限リストから一致するエントリを削除します。 +.PP +.B "monitor yes|no" +.PP +モニタ機能を有効または無効にします。 +.B "monitor no" +に続けて +.B "monitor yes" +コマンドを送るのは、パケット数をリセットする良い方法です。 +.PP +.B readkeys +.PP +現在の認証キーのセットを一掃し、キーファイル (これは +.I xntpd +設定ファイルの中で指定されていなければなりません) の +再読み込みを行なって新しいセットにします。 +こうすることで、サーバを再スタートさせずに暗号化キーの変更ができます。 +.PP +.B trustkey +.I keyid +[ +.I keyid +] [ +.I keyid +] [ +.I keyid +] +.PP +一つないしそれ以上のキーを、信頼キーリストに加えます。 +認証が有効になっているとき、信頼性のある時刻を持つ peer は、 +信頼キーを使って認証されなければなりません。 +.PP +.B untrustkey +.I keyid +[ +.I keyid +] [ +.I keyid +] [ +.I keyid +] +.PP +一つないしそれ以上のキーを、信頼キーリストから削除します。 +.PP +.B authinfo +.PP +既知のキーや実行された暗号化、復号化の数を含む、認証モジュールに関する +情報を返します。 +.PP +.B setprecision +.I precision_value +.PP +サーバが通知する精度の値を設定します。 +値は、 -4 から -20 の範囲の負の整数でなければなりません。 +.PP +.B traps +.PP +サーバに設定されているトラップを表示します。 +詳しくはソースリストを参照して下さい。 +.PP +.B addtrap +.I address +[ +.I port +] [ +.I interface +] +.PP +非同期メッセージのトラップをセットします。 +詳しくはソースリストを参照して下さい。 +.PP +.B clrtrap +.I address +[ +.I port +] [ +.I interface +] +.PP +非同期メッセージのトラップを解除します。 +詳しくはソースリストを参照して下さい。 +.PP +.B reset ... +.PP +サーバのいろいろなモジュールのなかの統計カウンタをクリアします。 +詳しくはソースリストを参照して下さい。 +.SH 関連項目 +.PP +.IR xntpd (8) +.SH 歴史 +.PP +Toronto 大学の Dennis Ferguson によって書かれました。 +.SH バグ +.PP +.I xntpdc +は、未完成のハックです。表示される情報の多くは死ぬほど退屈で、実装した +人間だけに気に入られるものです。このプログラムは、新しい (一時的な) +仕様を追加し易いようデザインされており、使いやすくするには手間が +かかります。それでも、このプログラムは、場合によっては有用です。 diff --git a/ja_JP.eucJP/man/man8/xtend.8 b/ja_JP.eucJP/man/man8/xtend.8 new file mode 100644 index 0000000000..acbb04180c --- /dev/null +++ b/ja_JP.eucJP/man/man8/xtend.8 @@ -0,0 +1,168 @@ +.\" Copyright (c) 1992, 1993 Eugene W. Stark +.\" 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 Eugene W. Stark. +.\" 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 EUGENE W. STARK (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: xtend.8,v 1.4 1996/09/23 22:23:09 wosch Exp % +.\" jpman %Id: xtend.8,v 1.2 1997/06/16 08:01:33 yugawa Stab % +.\" +.Th XTEND 8 "30 Oct 1993" +.Dd Oct 30, 1993 +.Dt XTEND 8 +.Os BSD FreeBSD +.Sh 名称 +xtend \- X-10 デーモン +.Sh 書式 +.Nm xtend +.Sh 解説 +.Nm xtend +は、ユーザレベルのプログラムと TW523 X-10 コントローラとのインターフェイスを +行います。TW523 から受信した全てのパケットを記録し、全ての X-10 デバイスの +状態を可能な限り追跡し、X-10 デバイスの操作を必要とするユーザレベルの +クライアントプログラムからのソケット接続を受け付けます。 +.Pp +.Nm xtend +を起動すると、自分自身をフォークし、制御端末を切り離し、以降発生する +全ての X-10 の活動状況と診断メッセージを記録するログファイルを開きます。 +その後、TW523 から受信したパケットの処理を開始し、X-10 のコマンドを発行する +クライアントの接続を 1 度に ひとつだけ受け付けます。通常、 xtend は、 +.Pa /etc/rc.local +起動スクリプトから実行されます。 +.Pp +.Nm xtend +に SIGHUP を送ると、ログファイルを一旦閉じ、再び開きます。これは、 +ログファイルの肥大化を避けるために、シェルスクリプトによりログファイルを +変更する場合に便利でしょう。 +.Nm xtend +が SIGTERM を受け取ると、素直にシャットダウンし、終了します。 +SIGPIPE を送ると、 +.Nm xtend +は現在のクライアント接続を強制的に切り離します。 +.Pp +.Nm xtend +は、クライアントのプロセスと、単純なプロトコルを用いて通信を行います。 +このプロトコルは、クライアントから送られる 1 行のコマンドに対して、 +デーモンが 1 行の応答を行うような単純な物です。 +.Pp +.Nm xtend +には、4 種類のコマンドがあります。コマンド +.Bl -tag +.It status H U +.El +.Pp +に対して、 +.Nm xtend +は指定されたデバイスの状態を 1 行で返答します。ここで、H はハウスコードを +示す 1 文字で、U は数字のユニットコードです。 +コマンド +.Bl -tag +.It send H U N +.El +.Pp +に対して、 +.Nm xtend +は指定された X-10 の送信を行います。ここで、H はハウスコードを示す 1 文字で、 +U は数字のユニットコードまたはリストに対する機能コード( +.Pa xtend/packet.c +ソースファイル参照)、N はギャップなしに送信されるパケットの数 (通常は 2) +です。送信が成功すると、 +.B +OK +と応答し、それ以外の場合は、 +.B +ERROR +と応答します。 +コマンド +.Bl -tag +.It dump +.El +.Pp +に対して、 +.Nm xtend +はスプールディレクトリの ASCII ファイルに全てのデバイスの現在の状態を +ダンプします。状態のダンプに成功したかどうかに関わらず、 +.B +OK +と応答します。 +コマンド +.Bl -tag +.It monitor H U +.El +.Pp +に対して、 +.Nm xtend +は指定された X-10 デバイスに関する活動状況を報告するクライアントのリストに、 +現在のクライアントのソケット接続を加えます。 +リスト中のクライアント数の最大値 (現状では 5) を超えなければ、 +.B +OK +を返答し、それ以外は +.B +ERROR +を返答します。その後、 +.Nm xtend +クライアントからの接続を受け付ける通常モードに戻ります。 +しかし、それ以降に指定されたデバイスの状態が変化すると、 +.Nm xtend +は ( +.B +status +コマンドにより得られる場合と同じ形式で) +デバイスの状態を保存したソケットに送ります。 +この機能は、動作検出機等、デバイスの活動状況をモニタする必要があり、 +X-10 送信を行うプログラムを作成する場合に便利でしょう。 +.Sh オプション +なし。 +.Sh 関連項目 +.Xr xten 1 , +.Xr tw 4 +.Sh 関連ファイル +.Bl -tag -width /var/spool/xten/Status -compact +.It Pa /dev/tw0 +TW523 スペシャルファイル +.It Pa /var/run/tw523 +クライアント接続用ソケット +.It Pa /var/run/xtend.pid +pid ファイル +.It Pa /var/spool/xten/Log +ログファイル +.It Pa /var/spool/xten/Status +デバイス状態ファイル(バイナリ) +.It Pa /var/spool/xtend/status.out +デバイス情報の ASCII ダンプ +.El +.Sh バグ +現状では、クライアントのソケット接続にタイムアウトはありません。そのため、 +ハングしたクライアントプログラムがあると、他のクライアントはデーモンに +アクセスする事ができなくなります。 +.Pp +.Nm xtend +はできる限りデバイスの状態を追跡しますが、デバイスが手動で操作された +ことを知る方法はありません。これは、ほとんどの X-10 デバイスが状態の +問い合わせに対して応答する事ができないからです。 +.Sh 作者 +Eugene W. Stark (stark@cs.sunysb.edu) diff --git a/ja_JP.eucJP/man/man8/yp_mkdb.8 b/ja_JP.eucJP/man/man8/yp_mkdb.8 new file mode 100644 index 0000000000..b0cec06a7f --- /dev/null +++ b/ja_JP.eucJP/man/man8/yp_mkdb.8 @@ -0,0 +1,184 @@ +.\" Copyright (c) 1995, 1996 +.\" Bill Paul <wpaul@ctr.columbia.edu>. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by Bill Paul +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: yp_mkdb.8,v 1.2.2.2 1997/04/15 08:04:48 jmg Exp % +.\" jpman %Id: yp_mkdb.8,v 1.3 1997/05/19 17:09:21 horikawa Stab % +.\" +.Dd March 12, 1996 +.Dt YP_MKDB 8 +.Os +.Sh 名称 +.Nm yp_mkdb +.Nd "NIS データベースを作成する" +.Sh 書式 +.Nm yp_mkdb +.Fl c +.Nm yp_mkdb +.Fl u Ar dbname +.Nm yp_mkdb +.Op Fl c +.Op Fl b +.Op Fl s +.Op Fl i Ar inputfile +.Op Fl o Ar outputfile +.Op Fl m Ar mastername +.Ar inputfile +.Ar dbname +.Sh 解説 +.Nm yp_mkdb +は FreeBSD の NIS サーバが使用する +.Xr db 3 +スタイルのデータベースを作成します。 +.Nm yp_mkdb +はデータを +.Nm inputfile +から読み取り、 +そのデータを +.Nm dbname +に +.Xr db 3 +フォーマットで書き込みます (ハッシュテーブル法を使用します)。 +入力は 'key data' の形式、 +すなわち空白で区切られた 2 つの ASCII データフィールドである必要があります。 +1 番目のフィールドはキーであるとされ、他は全てデータであるとされます。 +通常、データベースが格納されるのは +.Nm /var/yp/[domainname] +です。ここで、 +.Nm domainname +はサーバが対象とする NIS ドメイン名です。 +.Nm yp_mkdb +が起動されるのは、通常 +.Nm /var/yp/Makefile +からです。 +.Nm yp_mkdb +で NIS データベースファイルをダンプし、内容検査を行えます。 +セキュリティのため、 +.Nm yp_mkdb +が作成した全てのデータベースは、オーナのみ読み書き可能です +(通常オーナは root です)。 +.Sh オプション +.Nm yp_mkdb +コマンドは以下のフラグとオプションをサポートしています: +.Bl -tag -width flag +.It Fl c +YPPROC_CLEAR リクエストをローカルホスト上の +.Xr ypserv 8 +宛に送ることを +.Nm yp_mkdb +に指示します。 +このシグナルにより、 +サーバはオープンしているデータベースデスクリプタをクローズし、 +データベースキャッシュをフラッシュします。 +このフラグを単体で使用した場合、 +サーバにシグナルを送るだけで他には何もしません。 +データベース作成コマンドとともに使用した場合には、 +.Nm yp_mkdb +は新たなデータベースが成功裏に作成された後にのみシグナルを送ります。 +.It Fl b +このフラグを指定すると、キーが +.Em YP_INTERDOMAIN +でありデータフィールドが空である特別のエントリの +データベースへの追加を +.Nm yp_mkdb +に指示します。 +このキーがマップ中に存在すると、 +.Xr ypserv 8 +における 'マッチ' 手続きの動作が何も言わずに変わります。 +(キーにマッチするレコードをサーバが見付けられなかったことにより) +マッチ問い合わせが失敗した場合、 +その要求されたマップに +.Em YP_INTERDOMAIN +キーが存在する場合には、 +.Xr ypserv 8 +は今度はそのエントリが DNS でマッチするか検索します。 +この特別な振舞は +.Em hosts +マップだけに適用されることに注意して下さい。 +他のマップに +.Fl b +フラグを使用しても効果はありません。 +.Pp +.It Fl s +このフラグは、キーが +.Em YP_SECURE +でありデータフィールドが空である特別なエントリを +データベースに追加するために使用します。 +このキーがマップ中にあると、 +.Xr ypserv 8 +は問い合わせのために用意されたポート以外からの +クライアントからのアクセスを拒否します。 +これは主に、特権アクセスのみに制限しなければならない +.Em master.passwd +マップのために使用します。 +.Pp +.It Fl u Ar dbname +.Pp +NIS データベースをダンプします('ほどき'ます)。 +既に存在する NIS データベースの内容を検査するために使用可能です。 +.It Op Fl i Ar inputfile +.Pp +NIS マップ作成時に、キーが +.Em YP_INPUT_FILE +であり +.Nm inputfile +がエンコードされた特別なエントリをデータベース中に作成します。 +.It Op Fl o Ar outputfile +.Pp +NIS マップ作成時に、キーが +.Em YP_OUTPUT_FILE +で +.Nm outputfile +がエンコードされた特別なエントリをデータベース中に作成します。 +.Pp +.It Op Fl m Ar mastername +.Pp +NIS マップ作成時に、キーが +.Em YP_MASTER_NAME +であり +.Nm mastername +がエンコードされた特別なエントリをデータベース中に作成します。 +データベース中のこのエントリは、 +ドメイン中の NIS マスタサーバの名前を判定するために、 +様々な NIS ユーティリティからしばしば使用されます。 +デフォルトでは、 +.Nm yp_mkdb +はローカルホストが NIS マスタであるとします; +.Ar m +オプションをすればこのデフォルトを上書きできます。 +.Sh 関連ファイル +.Bl -tag -width Pa -compact +.It Pa /var/yp/Makefile +.Nm yp_mkdb +を呼び出し NIS データベースを作成する Makefile +.Sh 関連項目 +.Xr db 3 , +.Xr ypserv 8 +.Sh 作者 +Bill Paul <wpaul@ctr.columbia.edu> diff --git a/ja_JP.eucJP/man/man8/ypbind.8 b/ja_JP.eucJP/man/man8/ypbind.8 new file mode 100644 index 0000000000..008193a93b --- /dev/null +++ b/ja_JP.eucJP/man/man8/ypbind.8 @@ -0,0 +1,168 @@ +.\" Copyright (c) 1991, 1993, 1995 +.\" 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. +.\" +.\" 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. +.\" +.\" %Id: ypbind.8,v 1.5.2.2 1997/04/15 08:09:11 jmg Exp % +.\" jpman %Id: ypbind.8,v 1.4 1997/06/18 16:55:44 horikawa Stab % +.\" +.Dd April 9, 1995 +.Dt YPBIND 8 +.Os +.Sh 名称 +.Nm ypbind +.Nd "NIS ドメインをバインドするデーモン" +.Sh 書式 +.Nm ypbind +.Op Fl ypset +.Op Fl ypsetme +.Op Fl s +.Op Fl S Ar domainname,server1,server2,... +.Sh 解説 +.Nm +は NIS バインド情報を管理するプロセスです。 +開始時にネットワークブロードキャストを行い、( +.Xr domainname 1 +コマンドにより設定された) システムデフォルトドメインに対して +サービスする NIS サーバを探します。 +返答を受け取ると、サーバのアドレス等の情報をファイル +.Pa /var/yp/binding +に格納します。 +標準 C ライブラリ中の NIS ルーチンは、 +NIS リクエストを処理する時にはこのファイルを使用します。 +NIS クライアントは複数のドメインにバインドされる事がありうるため、 +このようなファイルが複数ある場合があります。 +.Pp +バインドされると、 +.Nm +は DOMAIN_NONACK リクエストを NIS サーバ宛に 1 分置きに送ります。 +リクエストに対する返答が得られない場合、 +.Nm +はサーバがもう実行していないものとし、 +別サーバにバインドされるまでネットワークブロードキャストを再開します。 +.Nm ypbind +は、サーバが返答しなかったことを検知するたび +および新たなサーバにバインドされるたび、 +警告メッセージを +.Xr syslog 3 +の機能を使用して記録します。 +.Pp +.Sh オプション +以下のオプションが +.Nm +にてサポートされています: +.Bl -tag -width flag +.It Fl ypset +.Xr ypset 8 +コマンドを使用し、 +指定されたドメインの特定の NIS サーバに +.Nm +を強制的にバインドする事は可能です。 +しかし +.Nm +は、正確には誰が要求しているのかを知る事が出来ないため、 +YPBINDPROC_SETDOM リクエストをデフォルトでは拒否します。 +.Fl ypset +フラグを使用する事により、 +.Nm +にあらゆるホストからの YPBINDPROC_SETDOM リクエストを受理させられます。 +任意のユーザにより NIS クライアントのバインドがリセットされてしまうという +セキュリティ上の危険がありますので、 +このオプションは診断目的および短い期間のみ使用すべきです。 +.It Fl ypsetme +これは +.Fl ypset +フラグに似ていますが、YPBINDPROC_SETDOM リクエストがローカルホスト発の場合のみ +処理を許すという点のみ異なります。 +.It Fl s +.Fl s +フラグを指定すると +.Nm +を安全モードで実行します: +root 以外により実行されている NIS サーバ +(つまり、特権 TCP ポートを使用していないもの)へのバインドを拒否します。 +.It Fl S Ar domainname,server1,server2,server3,... +システム管理者は +.Fl S +フラグを指定する事により、 +ypbind を特定のドメインおよび NIS サーバグループへロック出来ます。 +10 サーバまで指定できます。 +domain/server 指定においては、コンマの間には空白を入れてはなりません。 +このオプションを指定する事により、 +ある 1 つのドメインおよび指定されたサーバのうちの 1 つにのみに +システムがバインドされる事を保証できます。 +これは NIS サーバであり NIS クライアントでもあるシステムにて有用です: +システムがバインド可能なマシンの限定を、 +しばしばセキュリティホールであるとされる +.Fl ypset +や +.Fl ypsetme +といったオプションを指定する必要無く行えます。 +指定されるサーバの有効なエントリが、ローカルの +.Pa /etc/hosts +ファイルに存在する必要があります。 +ホスト名の代わりに IP アドレスを指定しても構いません。 +.Nm +が引数を解釈できない場合、 +.Fl S +フラグを無視し、通常の動作を行います。 +.Pp +.Nm +は +.Fl S +フラグにより指定されるドメイン名を、システムデフォルトドメインと解釈 +することに注意して下さい。 +.Sh 注釈 +.Nm +は 2 番目のドメインのバインドを連続して保持しようとはしません。 +2 番目のドメインのサーバが ping に応答しない場合、 +.Nm +はあきらめる前に一度だけ新たなサーバを探してブロードキャストします。 +クライアントプログラムがバインドされていないドメインを参照しようとした場合、 +.Nm +は再度ブロードキャストしようとします。 +これとは対称的に、クライアントプログラムが参照していようといまいと、 +.Nm +はデフォルトドメインへのバインドを自動的に保持します。 +.Sh 関連ファイル +.Bl -tag -width Pa -compact +.It Pa /var/yp/binding/[domainname].[version] +NIS ドメインに関連したバインド情報を保持するファイル。 +.It Pa /etc/sysconfig +システムデフォルトのドメインと ypbind 開始オプションを指定する +コンフィギュレーションファイル。 +.El +.Sh 関連項目 +.Xr domainname 1 , +.Xr syslog 3 , +.Xr yp 4 , +.Xr ypserv 8 , +.Xr ypset 8 +.Sh 作者 +Theo de Raadt <deraadt@fsa.ca> diff --git a/ja_JP.eucJP/man/man8/yppush.8 b/ja_JP.eucJP/man/man8/yppush.8 new file mode 100644 index 0000000000..39f2b7fdef --- /dev/null +++ b/ja_JP.eucJP/man/man8/yppush.8 @@ -0,0 +1,172 @@ +.\" Copyright (c) 1991, 1993, 1995 +.\" 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. +.\" +.\" 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. +.\" +.\" %Id: yppush.8,v 1.4 1996/04/03 03:23:59 wpaul Exp % +.\" jpman %Id: yppush.8,v 1.3 1997/09/09 04:08:40 yugawa Stab % +.\" +.Dd February 5, 1995 +.Dt YPPUSH 8 +.Os +.Sh 名称 +.Nm yppush +.Nd "NIS データベースの更新を強制的に伝搬させる" +.Sh 書式 +.Nm yppush +.Op Fl d Ar domain +.Op Fl t Ar timeout +.Op Fl j Ar #parallel jobs +.Op Fl h Ar host +.Op Fl p Ar path +.Op Fl v +.Ar mapname +.Sh 解説 +.Nm yppush +は、NIS ドメインにおいて、更新した NIS データベース(もしくは +.Pa マップ ) +を NIS マスタサーバから NIS スレーブサーバへ配布します。 +通常、NIS マップが更新された場合に NIS マスタの +.Pa /var/yp/Makefile +からのみ起動されます。 +.Pa /var/yp/Makefile +はデフォルトでは +.Nm yppush +を起動しない事に注意して下さい: +これを変えるにはまず、Makefile 中の +.Nm NOPUSH=True +エントリをコメントアウトしなければなりません +(デフォルトの FreeBSD の設定は小さなネットワークに +単一の NIS サーバがある状況を想定しています; この様な設定では +.Nm yppush +は不要です)。 +.Pp +デフォルトでは、 +.Nm yppush +はドメイン内のスレーブサーバ名を決定するために +.Pa ypservers +マップを検索します。 +宛先ホスト(もしくはホストのリスト)は手動でコマンドラインから指定可能です。 +スレーブサーバのリストが与えられると、 +`マップ転送' 要求を各スレーブに送信します。 +今度はスレーブが、 +.Xr ypxfr 8 +を使用して、NIS マスタサーバからマップのコピーを読み取ります。 +コピーされるマップ名と +.Xr ypxfr 8 +が +.Nm yppush +に `コールバック' して転送を完遂するために必要な特別な情報とが、 +各リクエストに含まれます。 +コールバックにおいて +.Nm yppush +が +.Xr ypxfr 8 +から受け取るエラーメッセージは全て標準エラー出力に出力されます。 +.Pp +.Sh オプション +.Nm yppush +は以下のオプションをサポートしています: +.Bl -tag -width flag +.It Fl d Ar domain +ドメイン名を指定します。 +ローカルホストの NIS ドメイン名がデフォルトで使用されます。 +ローカルホストのドメイン名が設定されていない場合には、 +このフラグでドメイン名を指定しなければなりません。 +.It Fl t Ar timeout +.Fl t +フラグにてタイムアウト値を秒単位で指定します。 +このタイムアウトは、 +.Nm yppush +がリスト中の次のスレーブサーバ宛にマップ転送要求を送る前に +返答をどれくらい待つかを制御します。 +.It Fl j Ar #parallel jobs +.Nm yppush +は通常、転送を逐次的に行います。これはどういうことかというと、 +マップ転送要求をスレーブサーバに送り、 +次のスレーブサーバに取り掛かる前に返答を待つということです。 +多くのスレーブがいる環境では、 +同時に複数のマップ転送を開始し、転送を並列に行う方が効率が良くなります。 +.Fl j +フラグにて並列処理するジョブ数を指定します: +.Nm yppush +は指定された数の転送をすぐに開始し、返答を待ちます。 +並列ジョブ数がスレーブ数より少ない場合は、 +.Nm yppush +は指定されたジョブ数の処理のみを開始し、返答を待ち、 +処理が完了してから残りの処理に取り掛かります。 +.Pp +.Nm yppush +はコールバックを非同期に取り扱う事に注意して下さい。 +これはどういうことかというと、 +全てのマップ転送要求を送信する前であろうとも、 +.Xr ypxfr 8 +からコールバック情報を受け取るとすぐに、 +この情報を表示する事を意味します。 +.It Fl h Ar host +.Fl h +フラグにて、 +.Pa ypservers +マップ中のサーバのリストの代わりに、 +ユーザが指定するマシンもしくはマシンのグループ宛にマップを転送できます。 +複数のホストを指定するためには、複数の +.Fl h +フラグを使用します。 +.It Fl p Ar path +デフォルトでは、 +.Nm yppush +は全てのローカル NIS マップは +.Pa /var/yp +以下に格納してあると期待しています。 +.Fl p +フラグにて別のパスを指定することにより、 +システム管理者が NIS マップを別の場所に格納する状況に対処できます。 +.It Fl v +冗長モード: +.Nm yppush +の実行時にデバッグ情報を表示させます。 +このフラグを 2 回指定すると、 +.Nm yppush +はより冗長に情報を表示します。 +.Sh 関連ファイル +.Bl -tag -width Pa -compact +.It Pa /var/yp/[domainname]/ypservers +ある NIS ドメインにおける全てのサーバ名を格納した NIS ypservers マップ。 +.El +.Sh 関連項目 +.Xr yp 4 , +.Xr ypserv 8 , +.Xr ypxfr 8 +.Sh バグ +NIS v1 における NIS マップ転送機構は NIS v2 におけるものとは異なります。 +このバージョンの +.Nm yppush +は NIS v2 システム宛のマップ転送のみをサポートしています。 +.Sh 作者 +Bill Paul <wpaul@ctr.columbia.edu> diff --git a/ja_JP.eucJP/man/man8/ypserv.8 b/ja_JP.eucJP/man/man8/ypserv.8 new file mode 100644 index 0000000000..a021d730b7 --- /dev/null +++ b/ja_JP.eucJP/man/man8/ypserv.8 @@ -0,0 +1,364 @@ +.\" Copyright (c) 1995 +.\" Bill Paul <wpaul@ctr.columbia.edu>. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by Bill Paul. +.\" 4. Neither the name of the author nor the names of any co-contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: ypserv.8,v 1.8.2.2 1997/04/15 08:12:11 jmg Exp % +.\" jpman %Id: ypserv.8,v 1.3 1997/05/19 17:11:16 horikawa Stab % +.\" +.Dd February 4, 1995 +.Dt YPSERV 8 +.Os +.Sh 名称 +.Nm ypserv +.Nd NIS データベースサーバ +.Sh 書式 +.Nm +.Op Fl n +.Op Fl d +.Op Fl p Ar path +.Sh 解説 +.Tn NIS +は RPC ベースのサービスであり、多くの UNIX ベースのマシン間で +共通のコンフィギュレーションファイルの集合を共有する事ができます。 +NIS では、 +.Pa /etc/hosts , +.Pa /etc/passwd , +.Pa /etc/group +といった、ほとんどの環境で頻繁に更新されるファイルの複数のコピーを +システム管理者が更新する必要は無く、 +一箇所で更新可能な 1 組のデータを計算機の集合が共有する事を許します。 +.Pp +.Nm +は NIS +.Em ドメイン +内のクライアントシステムに NIS データベースを配布するサーバです。 +NIS ドメイン内のクライアントは +.Xr domainname 1 +コマンドを使用し、 +.Nm +がサービスしているドメイン名を設定しなければなりません。 +単一 NIS ドメイン中に複数のサーバが存在しうるため、 +クライアントは、 +.Xr ypbind 8 +を実行させ、特定のサーバに接続する必要もあります。 +.Pp +.Nm +によって配布されるデータベースは +.Pa /var/yp/[domainname] +に格納されます。 +ここで +.Pa domainname +はサービスを受けるドメイン名です。 +この様なディレクトリは様々なドメイン名にて複数存在可能ですが、 +単一の +.Nm +デーモンにて全て処理可能です。 +.Pp +データベース、(もしくはしばしば +.Pa マップ +と呼ばれます)は、様々なシステムファイルを元に +.Pa /var/yp/Makefile +から作成されます。 +データベースファイルは +.Xr db 3 +フォーマットであり、レコード数が多くとも高速に検索可能です。 +FreeBSD では、セキュリティのため、マップの読み書きは root のみ可能です。 +技術的には、パスワードマップのみこの様な制限が必要です。 +他のマップの内容は誰もが読める他のファイルに書いてありますので、 +この様な制約は害ではなく、現実的だと考えられています。 +.Pp +.Nm +は +.Pa /etc/sysconfig +にて有効にされている場合に +.Pa /etc/rc +から起動されます。 +.Sh 特別な仕様 +FreeBSD のパスワードデータベースを NIS にて配布する場合には問題があります: +FreeBSD は通常、暗号化したパスワードを、root のみ読み書き可能な +.Pa /etc/master.passwd +に格納します。 +このファイルを NIS マップにすると、セキュリティが完全に破れてしまいます。 +.Pp +これに対処するために、FreeBSD の +.Nm +は +.Pa master.passwd.byname +と +.Pa master.basswd.byuid +のマップを特別な方法で扱います。 +サーバがこれら 2 つのマップへのアクセス要求を受け付けると、 +要求元の TCP ポートをチェックし、ポート番号が 1023 より大きい場合には +エラーを返します。 +スーパユーザのみ 1024 より小さい TCP ポートにバインドする事を許されているため、 +サーバはこれを利用して特権ユーザからの要求か否かを判定できます。 +非特権ユーザからの全ての要求は拒否されます。 +.Pp +また、FreeBSD の標準 C ライブラリ中の +.Xr getpwent 3 +ルーチンは、スーパユーザが使用した場合には +.Pa master.passwd.byname +と +.Pa master.passwd.byuid +のマップからデータを取得します: 通常のユーザが使用した場合には、 +標準の +.Pa passwd.byname +と +.Pa passwd.byuid +のマップにアクセスします。後者の 2 つのマップは +.Pa /var/yp/Makefile +により、 +.Pa master.passwd +ファイルをパースし、パスワードフィールドを削除する事により作成されますので、 +非特権ユーザに渡しても安全です。 +このように +.Pa master.passwd +データベースのシャドウパスワード機構は NIS においても守られます。 +.Pp +.Sh 注釈 +.Ss 制限 +NIS 環境にてシャドウパスワードを使用する事に起因する問題が 2 つあります。 +ユーザは次の事に気を付けねばなりません: +.Bl -enum -offset indent +.It +.Sq TCP ポートが 1024 より小さい +というテストは非常に簡単であるため、 +同一ネットワーク上の、無制限のアクセスが可能なマシンを持つユーザは +これを破る事が可能です +(UNIX ベースではないオペレーティングシステムを実行するマシンでも可能です)。 +.It +FreeBSD システムを、シャドウパスワードをサポートしない非 FreeBSD クライアント +(ほとんどがそうです)に対するサーバにしようとしている場合には、 +.Pa /var/yp/Makefile +の +.Em UNSECURE=True +エントリのコメントを外し、 +シャドウパスワードを無効にする必要があります。 +.Pa passwd.byname +と +.Pa passwd.byuid +のマップに、非 FreeBSD クライアントが NIS を通じてユーザ認証を +行うために必要とする、 +有効な暗号化されたパスワードフィールドが含まれるようになります。 +.El +.Pp +.Ss セキュリティ +一般的に、リモートユーザは、ドメイン名を知ってさえいれば、RPC を +.Nm +に発行し、NIS マップの内容を取得可能です。 +このような権限の無いトランザクションを防ぐために、 +.Nm +は +.Pa securenets +と呼ばれる、あるホストの集合にのみアクセスを制限する機能があります。 +起動時に、 +.Nm +は securenets 情報をファイル +.Pa /var/yp/securenets +から読み込みます。 +(後述するように、このパスは、 +.Fl p +オプションによって指定するパスによって変化する事に注意して下さい。) +このファイルは、空白によって区切られるネットワークとネットワークマスクからなる +エントリを複数含みます。 +.Dq \&# +から始まる行はコメントと見なされます。 +securenets ファイルの例を以下に示します: +.Bd -unfilled -offset indent +# allow connections from local host -- mandatory +127.0.0.1 255.255.255.255 +# allow connections from any host +# on the 129.168.128.0 network +192.168.128.0 255.255.255.0 +# allow connections from any host +# between 10.0.0.0 to 10.0.15.255 +10.0.0.0 255.255.240.0 +.Ed +.Pp +.Nm +がこれらのルールに適合するアドレスからの要求を受け取った場合には、 +通常通り要求を処理します。 +アドレスがルールに適合しない場合には、要求は無視され、警告がログされます。 +.Pa /var/yp/securenets +ファイルが存在しない場合には、 +.Nm +は全てのホストからの接続を許します。 +.Pp +.Nm +は、Wietse Venema の +.Em tcpwrapper +パッケージをサポートしますが、 +.Em tcpwrapper +パッケージは FreeBSD とともに配布されていないため、 +デフォルトでは組み込まれていません。 +.Pa libwrap.a +と +.Pa tcpd.h +を持っているならば、容易に +.Nm +をリコンパイル出来ます。 +これにより、アクセス管理のために、 +システム管理者は tcpwrapper のコンフィグレーションファイル +( +.Pa /etc/hosts.allow +と +.Pa /etc/hosts.deny +) +を +.Pa /var/yp/securenets +の代わりに使用できます。 +.Pp +注: どちらのアクセス制御もそれなりのセキュリティを提供しますが、 +特権ポートテストと同様、 +.Dq IP 詐称(spoofing) +攻撃には無力であることに +注意して下さい。 +.Pp +.Ss NIS v1 互換性 +このバージョンの +.Nm +は NIS v1 クライアントに対してある程度サービス可能です。 +FreeBSD の NIS 実装は NIS v2 プロトコルのみを使用しますが、 +他の実装は古いシステムとのバックワードコンパチビリティのために +v1 プロトコルのサポートを含みます。 +このようなシステムに提供されている +.Xr ypbind 8 +デーモンは、実際にはそうする事が不要であっても、 +NIS v1 サーバにバインドしようとします。 +(そして、v2 サーバから返答を受け取ったとしてもサーバを探すために +ブロードキャストし続けます)。 +通常のクライアントの呼び出しがサポートされていますが、 +このバージョンの +.Nm +は v1 マップ転送要求を扱いません; +すなわち、古い NIS サーバとともに、マスタとしてもしくはスレーブとして +使用する事は出来ません。 +好運なことに、今日ではこの様なサーバは存在しない事でしょう。 +.Ss NIS クライアントでもある NIS サーバ +複数のサーバが存在するドメインにおいて、 +サーバが NIS クライアントでもある場合には、 +.Nm +の実行に注意を払う必要があります。 +バインド要求をブロードキャストさせてサーバ間でバインドさせるのではなく、 +サーバを自分自身にバインドすることは一般的には良い考えです: +あるサーバがダウンし、他のサーバがそのサーバに依存していた場合には、 +奇妙な障害が生じ得ます。(結果として全てのクライアントがタイムアウトし、 +他のサーバにバインドしようとしますが、遅延は無視できず、 +サーバはまだ互いにバインドしようとしますので、障害は残ります。) +.Pp +特定のサーバに強制的にバインドさせるための詳細は +.Xr ypbind 8 +マニュアルページを参照して下さい。 +.Sh オプション +以下のオプションが +.Nm +にてサポートされています: +.Bl -tag -width flag +.It Fl n +このオプションは +.Nm +が +.Pa hosts.byname +と +.Pa hosts.byaddress +のマップに対する yp_match 要求を扱う方法を操作します。 +デフォルトでは、 +.Nm +が与えられたホストのエントリをホストマップ中に見付けられなかった場合には、 +エラーを返しそれ以上の処理を行いません。 +.Fl n +フラグを指定すると、 +.Nm +はさらなる処理を行います: +すぐにあきらめずに、ホスト名もしくはアドレスを DNS ネームサーバに問い合わせて +解決しようとします。 +問い合わせが成功すると、 +.Nm +は偽のデータベースレコードを作成し、それをクライアントに返しますので、 +クライアントの yp_match 要求は成功したように見えます。 +.Pp +この仕様は SunOS 4.1.x との互換性のために用意されています。 +そのシステムの標準 C ライブラリではリゾルバが腐っており、 +ホスト名とアドレスの解決のために NIS に依存していました。 +FreeBSD のリゾルバは DNS への問い合わせを直接行えますので、 +FreeBSD である NIS クライアントに対してのみサービスする場合は、 +このオプションを有効にする必要はありません。 +.It Fl d +サーバをデバッグモードで実行します。 +通常 +.Nm +は異常時のエラー(アクセス違反、ファイルアクセス失敗)のみを +.Xr syslog 3 +機能を使用して報告します。 +デバッグモードでは、サーバは自身をバックグラウンドでは実行せず、 +リクエストを受けるたびに、 +状態を表す追加のメッセージを標準エラー出力に表示します。 +また、デバッグモードで実行している間は、通常とは異なり、 +yp_all 要求処理時や DNS 検索処理時に +.Nm ypserv +サブプロセスを生成しません。 +(これらの処理は多くの場合完了までに時間がかかるために +サブプロセスにより処理され、 +親であるサーバは別の要求を処理できるようになっています。) +これによりデバッグツールによるサーバのトレースが容易になります。 +.It Fl p Ar path +通常 +.Nm +は NIS マップは +.Pa /var/yp +以下にあるものと期待します。 +.Fl p +フラグを使用し、別の NIS ルートパスを指定できますので、 +システム管理者はファイルシステム中の別の場所にマップファイルを移動できます。 +.El +.Sh 関連ファイル +.Bl -tag -width Pa -compact +.It Pa /var/yp/[domainname]/[maps] +NIS マップ。 +.It Pa /etc/host.conf +リゾルバ構成ファイル。 +.It Pa /var/yp/securenets +ホストアクセス制御ファイル。 +.El +.Sh 関連項目 +.Xr ypcat 1 , +.Xr db 3 , +.Xr yp 4 , +.Xr ypbind 8 , +.Xr yppasswdd 8 , +.Xr yppush 8 , +.Xr ypxfr 8 +.Sh 作者 +Bill Paul <wpaul@ctr.columbia.edu> +.Sh 歴史 +このバージョンの +.Nm +が最初に登場したのは +.Fx 2.2 +です。 diff --git a/ja_JP.eucJP/man/man8/ypset.8 b/ja_JP.eucJP/man/man8/ypset.8 new file mode 100644 index 0000000000..5cdbc60a19 --- /dev/null +++ b/ja_JP.eucJP/man/man8/ypset.8 @@ -0,0 +1,89 @@ +.\" +.\" Copyright (c) 1994 Jason R. Thorpe +.\" 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 Jason Thorpe. +.\" 4. Neither the name of the author nor the names of its contributors +.\" may 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: ypset.8,v 1.1.2.1 1997/03/06 08:01:10 mpp Exp % +.\" jpman %Id: ypset.8,v 1.2 1997/04/06 14:59:23 horikawa Stab % +.\" +.Dd October 25, 1994 +.Dt YPSET 8 +.Os +.Sh 名称 +.Nm ypset +.Nd +.Xr ypbind 8 +に使用すべき YP サーバを指示する +.Sh 書式 +.Nm ypset +.Op Fl h Ar host +.Op Fl d Ar domain +.Ar server +.Sh 解説 +.Nm ypset +は、同一マシン上の +.Xr ypbind 8 +プロセスに、通信すべき YP サーバプロセスを指示します。 +もし +.Ar server +がダウンしていたり YP サーバプロセスが動作していない場合、 +YP クライアントプロセスが +YP マップにアクセスしようと試みるまでは検知されません。 +YP マップをアクセスしようとした時に、 +.Xr ypbind 8 +はバインドをテストして適切な処理を行います。 +.Pp +.Nm ypset +は、最も近い YP サーバともブロードキャストネットワークが異なる +YP クライアントをバインドする場合に最も有用ですが、 +ローカルなネットワークの YP の構成をデバッグする場合、 +特定の YP クライアントのプログラムをテストする場合、 +ローカルネットワークに存在する複数の YP サーバの中から +特定のサーバにバインドする場合にも使用できます。 +.Pp +オプションは以下の通りです: +.Bl -tag -width flag +.It Fl h Ar host +ローカルマシンではなく、指定したホスト +.Ar host +にバインドします。 +.It Fl d Ar domain +.Xr domainname 1 +が返すデフォルトドメインではなく、指定した YP ドメイン +.Ar domain +を使用します。 +.El +.Sh 関連項目 +.Xr domainname 1 , +.Xr yp 8 +.Xr ypcat 1 , +.Xr ypmatch 1 , +.Xr ypbind 8 , +.Sh 作者 +Theo De Raadt diff --git a/ja_JP.eucJP/man/man8/ypxfr.8 b/ja_JP.eucJP/man/man8/ypxfr.8 new file mode 100644 index 0000000000..bc0b6c3579 --- /dev/null +++ b/ja_JP.eucJP/man/man8/ypxfr.8 @@ -0,0 +1,237 @@ +.\" Copyright (c) 1995 +.\" Bill Paul <wpaul@ctr.columbia.edu>. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by Bill Paul. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: ypxfr.8,v 1.3 1996/06/05 05:42:47 wpaul Exp % +.\" jpman %Id: ypxfr.8,v 1.3 1997/09/09 04:09:30 yugawa Stab % +.\" +.Dd February 5, 1995 +.Dt YPXFR 8 +.Os +.Sh 名称 +.Nm ypxfr +.Nd "リモートのサーバからローカルホストへ NIS データベースを転送する" +.Sh 書式 +.Nm ypxfr +.Op Fl f +.Op Fl c +.Op Fl d Ar target domain +.Op Fl h Ar source host +.Op Fl s Ar source domain +.Op Fl p Ar path +.Op Fl C Ar taskid program-number ipaddr port +.Ar mapname +.Sh 解説 +.Nm ypxfr +は NIS サービスを使用し、NIS データベース(または +.Pa マップ ) +を NIS サーバから別のホストにコピーします。FreeBSD では一般的に、 +.Xr yppush 8 +からマップ転送要求を受け取った +.Xr ypserv 8 +から +.Nm ypxfr +が起動されます。 +基本的には、 +.Nm ypxfr +が使用されるのは、複数の NIS サーバが単一ドメイン内で使用される環境です。 +あるサーバ(NIS マスタ)は全ての NIS マップの基準となるコピーを管理します。 +その他のサーバ(NIS スレーブ)は、(ユーザが +.Xr yppasswd 1 +を用いてパスワードを更新した時等)マップに更新があった時に、 +新しいバージョンのマップをマスタからコピーします。 +.Pp +実行時、 +.Nm ypxfr +は一時データベースファイルを +.Pa /var/yp/[domainmame] +に作成し、 +指定された +.Ar source host +により提供される +.Ar mapname +の内容で埋めます。 +マップ全体の転送が完了すると、 +.Nm ypxfr +は +.Ar mapname +のオリジナルのコピーを消去し、一時ファイルを代わりにそこに置きます。 +転送完了時に、 +.Nm ypxfr +は `現在のマップをクリア' する要求を、 +古いマップを参照しているかもしれないのでそれをクリアさせなければならない、 +ローカルの +.Xr ypserv 8 +プロセス宛に送信しようとします。 +.Pp +.Nm ypxfr +が作成した全てのファイルがオーナのみ読み書き可能なのは、 +セキュリティのためである事に注意して下さい。 +NIS マップとそれを格納するディレクトリは通常 root が所有しますので、 +非特権ユーザによる権限の無い変更を防ぎます。 +.Pp +全ての NIS サーバ間で一貫性を保持するために +.Nm ypxfr +を +.Xr cron 8 +ジョブとして定期的に実行する事が出来ます。 +ほとんど変更されないマップは 1 日 1 度 +(システム使用率が一番低い深夜が望ましいでしょう)更新すれば良いですが、 +頻繁に変更されるマップ(例えば +.Pa passwd.byname +や +.Pa passwd.byuid ) +はおそらく 1 時間に 1 度変更すべきでしょう。 +.Xr cron 8 +を使用し NIS マップを自動的に更新する事は厳密には必須ではありません。 +なぜなら、全ての更新は NIS マスタサーバ上で +.Pa /var/yp/Makefile +が実行された時に +.Xr yppush 8 +にて伝搬されているはずだからです。 +ただし、通信不能となって NIS サーバ間で同期が取れなくなる事があるような +大きなネットワークでは、良い実現方式です。 +.Pp +.Nm ypxfr +が制御端末無しで起動された場合、例えば +.Xr ypserv 8 +内部から起動された場合には、 +.Xr syslog 3 +機構を使用して、全ての出力のログを取ります。 +.Sh 注釈 +FreeBSD の +.Nm ypxfr +は FreeBSD の +.Xr rpc.ypxfrd 8 +サーバと連動する特別なマップ転送プロトコルをサポートします。 +このプロトコルは、 +生のマップデータベースファイルを NIS マスタサーバから転送する事を許しますので、 +特に大きな NIS マップの場合は、標準の転送方法よりも数倍高速です。 +.Nm ypxfr +コマンドは NIS マスタサーバ上に +.Xr rpc.ypxfrd 8 +が登録されているかをチェックし、存在する場合にはこれを使用しようとします。 +存在しない場合には、標準プロトコルを使用し、 +.Xr ypserv 8 +からマップの内容をコピーし、新たなマップを作成します。 +.Pp +概念的には FreeBSD の ypxfrd プロトコルは +SunOS の ypxfrd プロトコルと同じですが、 +FreeBSD のプロトコルは SunOS のプロトコルとは互換ではないため、 +Sun の ypxfrd サーバとともに使用する事は出来ない事に注意して下さい。 +FreeBSD のスレーブは 非 FreeBSD の NIS サーバから +マップを転送する事が出来ますが、 +高速プロトコルを使用できるのは、マスタサーバも FreeBSD の場合だけです。 +.Sh オプション +以下のオプションが +.Nm ypxfr +にてサポートされています: +.Bl -tag -width flag +.It Fl f +マップ転送を強制します。通常、 +NIS マスタ上のコピーがローカルホスト上にあるコピーよりも新しくない場合には、 +.Nm ypxfr +はマップを転送しません: +.Fl f +フラグにより、サーバ上のバージョンが新しいか否かにかにかかわらず、 +転送を強制します。 +.It Fl c +ローカルホスト上で実行されている +.Xr ypserv 8 +プロセス宛に `現在のマップをクリア' する要求を送信しません。 +このフラグは通常 +.Xr ypserv 8 +を実行していないマシン上で +.Nm ypxfr +を手動で起動する時に使用します。 +このフラグを指定しないと、ローカルの NIS サーバと通信できないために、 +.Nm ypxfr +が転送を中止してしまいます。 +.It Fl d Ar target domain +現在の NIS ドメインではない別のドメイン名を指定します。 +.It Fl h Ar source host +NIS マップのコピー元のホスト名を指定します。 +このオプションにより +.Nm ypxfr +が NIS マスタサーバからのみマップをコピーする事を保証できます。 +.It Fl s Ar source domain +マップの転送元のドメインを指定します。 +これは 2 つの NIS ドメイン間で転送を行う時に有用です。 +.It Fl p Ar path +NIS マップを保持する最上位ディレクトリを指定します。 +デフォルトではこのパスは +.Pa /var/yp +です。 +.Fl p +フラグにより別のパスを指定し、 +NIS マップを別の場所に格納する場合に対処できます。 +NIS サーバ +.Xr ypserv 8 +が別のパスを使用するように指示された場合にも、このフラグを +.Nm ypxfr +に渡します。 +.It Fl C Ar taskid program-number ipaddr port +.Xr yppush 8 +によるマップ転送要求への応答として、 +.Nm ypxfr +が +.Xr ypserv 8 +から起動された場合にのみ、このオプションは使用されます。 +この場合、 +.Nm ypxfr +は +.Xr yppush 8 +を `コールバック' して通信する必要がありますので、 +.Xr yppush 8 +は IP アドレス +.Ar ipaddr +、ポート番号 +.Ar port +、登録プログラム番号(registered program number) +.Ar program-number +、トランザクション ID +.Ar taskid +を渡し、 +マスタサーバ上で待っている +.Xr yppush 8 +プロセスと通信出来るようにします。 +.It Ar mapname +転送するマップを指定します。 +.El +.Sh 関連ファイル +.Bl -tag -width Pa -compact +.It Pa /var/yp/[domainname]/[maps] +ある NIS ドメインの NIS マップ。 +.El +.Sh 関連項目 +.Xr yp 4 , +.Xr ypserv 8 , +.Xr yppush 8 +.Sh 作者 +Bill Paul <wpaul@ctr.columbia.edu> diff --git a/ja_JP.eucJP/man/man8/zdump.8 b/ja_JP.eucJP/man/man8/zdump.8 new file mode 100644 index 0000000000..d4297bc102 --- /dev/null +++ b/ja_JP.eucJP/man/man8/zdump.8 @@ -0,0 +1,39 @@ +.TH ZDUMP 8 +.\" jpman %Id: zdump.8,v 1.3 1997/08/30 18:39:05 take-i Stab % +.SH 名称 +zdump \- タイムゾーンをダンプする +.SH 書式 +.B zdump +[ +.B \-v +] [ +.B \-c +cutoffyear ] [ zonename ... ] +.SH 解説 +.I zdump +は、コマンドラインの +.I zonename +で指定された各タイムゾーンを用いて現在時刻を表示します。 +.PP +以下のオプションが利用可能です: +.TP +.B \-v +コマンドラインの各 +.I zonename +に対し、表現可能な最も古い時刻、 +その最も古い時刻から 1 日後の時刻、 +検知された時間の不連続点の 1 秒前および不連続点そのものの時刻、 +表現可能な最も先の時刻の 1 日前の時刻、 +および表現可能な最も先の時刻そのもの +を表示します。 +各時刻は、それが夏時間 (Daylight Saving Time) であれば +.B isdst=1 +、そうでなければ +.B isdst=0 +と行末にしるして表示されます。 +.TP +.BI "\-c " cutoffyear +指定した年の最初に近い余分な出力をなくします。 +.SH 関連項目 +ctime(3), tzfile(5), zic(8) +.\" @(#)zdump.8 7.3 diff --git a/ja_JP.eucJP/man/man8/zic.8 b/ja_JP.eucJP/man/man8/zic.8 new file mode 100644 index 0000000000..3e104a929e --- /dev/null +++ b/ja_JP.eucJP/man/man8/zic.8 @@ -0,0 +1,396 @@ +.TH ZIC 8 +.\" jpman %Id: zic.8,v 1.2 1997/06/16 08:24:17 yugawa Stab % +.SH 名称 +zic \- タイムゾーンコンパイラ +.SH 書式 +.B zic +[ +.B \-v +] [ +.B \-d +.I directory +] [ +.B \-l +.I localtime +] [ +.B \-p +.I posixrules +] [ +.B \-L +.I leapsecondfilename +] [ +.B \-s +] [ +.B \-y +.I command +] [ +.I filename +\&... ] +.SH 解説 +.if t .ds lq `` +.if t .ds rq '' +.if n .ds lq \&"\" +.if n .ds rq \&"\" +.de q +\\$3\*(lq\\$1\*(rq\\$2 +.. +.I zic +はコマンド行で指定されたファイルを読み取り、その内容に従って +時刻変換情報のファイルを作成します。 +.I filename +が +.BR \- +だった場合、標準入力から読み込みます。 +.PP +以下のオプションがあります。 +.TP +.BI "\-d " directory +下記に示した標準ディレクトリではなく、指定されたディレクトリに時刻変換情報 +ファイルを作成します。 +.TP +.BI "\-l " timezone +指定されたタイムゾーンをローカルの時刻に使用します。 +.I zic +は、以下のリンク行が入力ファイルにあった場合と同様に働きます。 +.sp +.ti +.5i +Link \fItimezone\fP localtime +.TP +.BI "\-p " timezone +POSIX 形式のタイムゾーンの環境変数を扱う場合に、指定されたタイムゾーンの +ルールを使用します。 +.I zic +は、以下のリンク行が入力ファイルにあった場合と同様に働きます。 +.sp +.ti +.5i +Link \fItimezone\fP posixrules +.TP +.BI "\-L " leapsecondfilename +指定された名前のファイルからうるう秒の情報を読み込みます。 +このオプションが指定されなかった場合、 +出力ファイルにはうるう秒の情報は記録されません。 +.TP +.B \-v +データファイル中の年が +.IR time (2) +で表示できる年の範囲を超えていた場合、警告します。 +.TP +.B \-s +出力ファイルに記録される時刻の値を、それが符号付きと扱われるか符号なしと +扱われるかに関係なく同じ値になるように制限します。 +SVVS と互換のファイルを生成する場合に、このオプションを使用できます。 +.TP +.BI "\-y " command +年のタイプをチェックする際に、 +.B yearistype +の代わりに指定された +.I command +を用います(下記参照)。 +.PP +入力の各行はフィールドから構成されます。 +各フィールドは任意の数の空白文字により分離されます。先行する空白や、 +行末の空白は無視されます。クォートされていない井桁文字 (#) から +その行の末尾まではコメントとして扱われます。 +空白文字や井桁文字をフィールドの一部として使用する場合は、二重クォート +(") で囲みます。 +(コメントを取り除いた後の)空白行は無視されます。 +空白ではない行は、ルール行、ゾーン行、リンク行の 3 種類のいずれか +であるとみなされます。 +.PP +ルール行は、 +.nf +.ti +.5i +.ta \w'Rule\0\0'u +\w'NAME\0\0'u +\w'FROM\0\0'u +\w'1973\0\0'u +\w'TYPE\0\0'u +\w'Apr\0\0'u +\w'lastSun\0\0'u +\w'2:00\0\0'u +\w'SAVE\0\0'u +.sp +Rule NAME FROM TO TYPE IN ON AT SAVE LETTER/S +.sp +と言う形式です。例えば、 +.ti +.5i +.sp +Rule US 1967 1973 \- Apr lastSun 2:00 1:00 D +.sp +.fi +となります。ルール行を構成するフィールドは以下の通りです。 +.TP "\w'LETTER/S'u" +.B NAME +このルールが属するルールの(任意の)名前を指定します。 +.TP +.B FROM +ルールが適用される最初の年を指定します。 +如何なる整数の年も指定できます。グレゴリオ歴を仮定しています。 +単語 +.B minimum +(あるいはその短縮形)は、整数で表せる最小の年を示します。 +単語 +.B maximum +(あるいはその短縮形)は、整数で表せる最大の年を示します。 +ルールは、時刻の値として表す事ができない時刻を定義します。 +表す事ができない時刻は無視されます。これにより、時刻の値のタイプが +異なるホスト間でルールを共用する事ができます。 +.TP +.B TO +ルールが適用される最後の年を指定します。 +.B minimum +や +.B maximum +(上記と同様)に加え、 +単語 +.B only +(あるいはその短縮形) +は、 +.B FROM +フィールドの値を使用する場合に指定できます。 +.TP +.B TYPE +ルールが適用される年のタイプを指定します。 +.B TYPE +が +.B \- +だった場合、ルールは、 +.B FROM +から +.B TO +までのその年を含む全ての年に適用されます。 +.B TYPE +がそれ以外だった場合、 +.I zic +は、コマンド +.ti +.5i +\fByearistype\fP \fIyear\fP \fItype\fP +.br +を実行して、年のタイプをチェックします。 +終了ステータスが 0 だった場合は、その年が指定されたタイプであり、 +終了ステータスが 1 だった場合は、その年が指定されたタイプではないと +判断します。 +.TP +.B IN +ルールが適用される月の名前を指定します。 +月名は短縮形でも構いません。 +.TP +.B ON +ルールが適用される日を指定します。 +指定できる形式は以下の通りです。 +.nf +.in +.5i +.sp +.ta \w'Sun<=25\0\0'u +5 その月の 5 日 +lastSun その月の最後の日曜日 +lastMon その月の最後の月曜日 +Sun>=8 8 日以降の最初の日曜日 +Sun<=25 25 日以前の最後の日曜日 +.fi +.in -.5i +.sp +曜日は短縮形でも、フルスペルでも構いません。 +.B ON +フィールドにスペースが含まれない事に注意して下さい。 +.TP +.B AT +ルールが適用される時刻を指定します。 +指定できる形式は以下の通りです。 +.nf +.in +.5i +.sp +.ta \w'1:28:13\0\0'u +2 時 +2:00 時と分 +15:00 (正午以降の時刻の) 24 時間形式の時刻 +1:28:14 時、分、秒 +.fi +.in -.5i +.sp +これらの形式の最後に +.B w +をつけると、指定した時刻がローカルの +.q "ウォールクロック" +(夏時間の適用される地域で、ローカルの標準時に、 +夏時間の期間であればその修正を加えた時刻) +.\" 上記の()内の記述は、wall clock では、特に日本人には +.\" 理解しづらいので追加した。 +.\" 2.2.2-RELEASE 対象 +.\" By yugawa@orleans.rim.or.jp (Jun 16 1997) +であり、 +.B s +をつけると、指定した時刻がローカルの +.q 標準時 +であり、 +.B u +(あるいは +.B g +ないし +.BR z ) +をつけると、指定した時刻が世界標準時であることを示します。 +これらの文字を指定していない場合は、ウォールクロックが適用されます。 +.TP +.B SAVE +ルールが有効な場合にローカルの標準時に加えられる量を指定します。 +このフィールドの形式は +.B AT +フィールドと同じです +(この場合は、末尾に +.B w +と +.B s +を指定する事はできません)。 +.TP +.B LETTER/S +ルールが有効な場合にタイムゾーンの短縮形に用いられる +.q "変化部分" +(例えば、 +.q EST +や +.q EDT +の +.q S +や +.q D ) +を指定します。 +このフィールドが +.B \- +だった場合、変化部分はヌル (NULL) になります。 +.PP +ゾーン行は、 +.sp +.nf +.ti +.5i +.ta \w'Zone\0\0'u +\w'Australia/Adelaide\0\0'u +\w'GMTOFF\0\0'u +\w'RULES/SAVE\0\0'u +\w'FORMAT\0\0'u +Zone NAME GMTOFF RULES/SAVE FORMAT [UNTIL] +.sp +と言う形式です。例えば、 +.sp +.ti +.5i +Zone Australia/Adelaide 9:30 Aus CST 1971 Oct 31 2:00 +.sp +.fi +となります。ゾーン行を構成するフィールドは以下の通りです。 +.TP "\w'GMTOFF'u" +.B NAME +タイムゾーンの名称です。 +そのゾーンに対する時刻変換情報ファイルを作成する時の名前になります。 +.TP +.B GMTOFF +そのゾーンの標準時を得る時に GMT に加算される量です。 +このフィールドの形式は、ルール行の +.B AT +および +.B SAVE +フィールドと同じです。 +GMT から時刻を引く場合は、フィールドの最初にマイナスをつけます。 +.TP +.B RULES/SAVE +そのタイムゾーンに適用されるルールの名前、あるいは、ローカルの標準時に +加算される量を指定します。 +このフィールドが +.B \- +だった場合、そのタイムゾーンには常に標準時が適用されます。 +.TP +.B FORMAT +そのタイムゾーンで使用されるタイムゾーンの短縮形の形式を指定します。 +文字列 +.B %s +は、タイムゾーンの短縮形で用いられる +.q "変化部分" +を示します。 +一方、 +スラッシュ (/) +で標準時の短縮形と夏時間の短縮形を指定する事もできます。 +.TP +.B UNTIL +その場所で GMT との差あるいはルールが変化する時刻を指定します。 +年、月、日、時刻を用いて指定できます。 +このフィールドが指定された場合、その時刻になるまでは与えられた GMT との差 +およびルールからタイムゾーンの情報が生成されます。 +.IP +この次の行は +.q 継続 +行でなくてはなりません。この行は最初の +.q Zone +と NAME フィールドがない点を除いてはゾーン行と同一の形式で、その前の行の +.B UNTIL +フィールドで指定した時刻以降の情報を指定します。 +この継続行にも +.B UNTIL +フィールドを指定する事ができ、その場合は、次の行に +その時刻以降の情報を指定します。 +.PP +リンク行は、 +.sp +.nf +.ti +.5i +.ta \w'Link\0\0'u +\w'Europe/Istanbul\0\0'u +Link LINK-FROM LINK-TO +.sp +と言う形式です。例えば、 +.sp +.ti +.5i +Link Europe/Istanbul Asia/Istanbul +.sp +.fi +となります。 +.B LINK-FROM +フィールドは、存在するゾーン行の +.B NAME +フィールドのいずれかと一致していなければなりません。 +.B LINK-TO +フィールドはそのゾーンに対する別名として使用されます。 +.PP +継続行以外は、入力中での行の順番に制限はありません。 +.PP +うるう秒の定義ファイルの各行は以下のような形式になります。 +.nf +.ti +.5i +.ta \w'Leap\0\0'u +\w'YEAR\0\0'u +\w'MONTH\0\0'u +\w'DAY\0\0'u +\w'HH:MM:SS\0\0'u +\w'CORR\0\0'u +.sp +Leap YEAR MONTH DAY HH:MM:SS CORR R/S +.sp +例えば、 +.ti +.5i +.sp +Leap 1974 Dec 31 23:59:60 + S +.sp +.fi +となります。 +.BR YEAR , +.BR MONTH , +.BR DAY , +.B HH:MM:SS +フィールドは、うるう秒が起きる時刻を指定します。 +.B CORR +フィールドは、 +秒が加えられる場合は +.q + +で、秒がスキップされる場合は +.q - +となります。 +.\" 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. +.\" The C Standard is in error in suggesting the possibility. +.\" See Terry J Quinn, The BIPM and the accurate measure of time, +.\" Proc IEEE 79, 7 (July 1991), 894-905. +.\" or +.\" .q ++ +.\" if two seconds were added +.\" or +.\" .q -- +.\" if two seconds were skipped. +.B R/S +フィールドは +他のフィールドで与えられるうるう秒の時刻が GMT である場合は、 +.q Stationary +(またはその短縮形)で、 +他のフィールドで与えられるうるう秒の時刻がローカルのウォールクロックである +場合は、 +.q Rolling +(またはその短縮形)となります。 +.SH 注釈 +ローカル時刻が複数のタイプとなる地域では、 +作成されたファイルの最初の変化時刻を正しく設定するためには、 +最初の変化時刻のルールの +.B AT +フィールドでローカルの標準時を使用する必要があります。 +.SH 関連ファイル +/usr/share/zoneinfo 作成されたファイルが置かれる標準ディレクトリ +.SH 関連項目 +ctime(3), tzfile(5), zdump(8) +.\" @(#)zic.8 7.12 |
