diff --git a/ja/man/man5/a.out.5 b/ja/man/man5/a.out.5 index 2c7609a3fa..cec7ab4db5 100644 --- a/ja/man/man5/a.out.5 +++ b/ja/man/man5/a.out.5 @@ -1,485 +1,485 @@ .\" Copyright (c) 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This man page is derived from documentation contributed to Berkeley by .\" Donn Seeley at UUNET Technologies, 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. .\" .\" @(#)a.out.5 8.1 (Berkeley) 6/5/93 .\" %Id: a.out.5,v 1.4.2.1 1996/12/31 22:50:38 mpp Exp % .\" -.\" jpman $Id: a.out.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: a.out.5,v 1.3 1998/08/09 12:51:56 horikawa Stab % .\" WORD: byte order バイト順 .\" WORD: posision independent 位置独立(な) .\" WORD: link editor リンクエディタ .\" WORD: link edit リンクエディット .\" .Dd June 5, 1993 .Dt A.OUT 5 .Os .Sh 名称 .Nm a.out .Nd 実行可能バイナリファイルのフォーマット .Sh 書式 .Fd #include .Sh 解説 インクルードファイル .Aq Pa a.out.h では 3 つの構造体といくつかのマクロが宣言されています。 これらの構造体は、このシステムで実行可能な機械語コードファイル .Pq Sq バイナリ のフォーマットを規定します。 .Pp バイナリファイルは最大で 7 つのセクションから構成されます。 これらのセクションを順にあげると以下のようになります: .Bl -tag -width "テキストリロケーション" .It exec ヘッダ バイナリファイルをメモリ上にロードして実行するために カーネルが用いるパラメータを含んでいます。 これらのパラメータはリンクエディタ .Xr ld 1 がバイナリファイルを他のバイナリファイルと結合する際にも 用いられます。 このセクションは唯一の必須セクションです。 .It テキストセグメント プログラムが実行される際にメモリ上にロードされる 機械語コード及び関連データを含んでいます。 読み込み専用でロードされる場合があります。 .It データセグメント 初期化済データを含んでいます。 常に書き込み可能なメモリ上にロードされます。 .It テキストリロケーション バイナリファイル結合時にテキストセグメント内のポインタを修正するために、 リンクエディタによって用いられるレコードを含んでいます。 .It データリロケーション 前出のテキストリロケーションセクションと似ていますが、 データセグメント内のポインタ修正用です。 .It シンボルテーブル バイナリファイル間で 名前付きの変数や関数 .Pq Sq シンボル のアドレス相互参照を解決するために、 リンクエディタによって用いられるレコードを含んでいます。 .It string table シンボル名に対応する文字列を含んでいます。 .El .Pp 全てのバイナリファイルは次の .Fa exec 構造体で始まります: .Bd -literal -offset indent struct exec { unsigned long a_midmag; unsigned long a_text; unsigned long a_data; unsigned long a_bss; unsigned long a_syms; unsigned long a_entry; unsigned long a_trsize; unsigned long a_drsize; }; .Ed .Pp これらのフィールドは以下の機能を持っています: .Bl -tag -width a_trsize .It Fa a_midmag このフィールドはホストのバイト順 (host byte-order) で格納されます。 このフィールドはいくつかのサブコンポーネントを持っており、それらは 以下のマクロ .Dv N_GETFLAG() , .Dv N_GETMID() , .Dv N_GETMAGIC() で参照され、マクロ .Dv N_SETMAGIC() で設定されます。 .Pp マクロ .Dv N_GETFLAG() は以下のフラグを返します: .Bl -tag -width EX_DYNAMIC .It Dv EX_DYNAMIC この実行可能ファイルがランタイムリンクエディタのサービスを要求することを 示します。 .It Dv EX_PIC このオブジェクトファイルが位置独立 (position independent) なコードを 含んでいることを示します。 このフラグは .Sq -k フラグ指定時に .Xr as 1 によって設定され、必要なら .Xr ld 1 はこれを保存します。 .El .Pp EX_DYNAMIC と EX_PIC の両方がセットされている場合、 そのオブジェクトファイルは位置独立な実行可能イメージです (例: 共有ライブラリ)。 これはランタイムリンクエディタによってプロセスのアドレス空間にロードされます。 .Pp マクロ .Dv N_GETMID() はマシン識別コード (machine-id) を返します。 これは、バイナリファイルが実行されるべきマシンを示しています。 .Pp .Dv N_GETMAGIC() はマジックナンバを示します。 マジックナンバはバイナリファイル種別を一意に識別し、 様々なロード方法を区別します。 このフィールドは以下の値のいずれか 1 つを含んでいなければなりません: .Bl -tag -width ZMAGIC .It Dv OMAGIC テキストセグメントとデータセグメントはヘッダの直後にあり、 連続しています。 カーネルはテキスト/データセグメントの両方を書き込み可能メモリ領域に ロードします。 .It Dv NMAGIC .Dv OMAGIC と同様、テキスト/データセグメントはヘッダの直後にあり、連続しています。 しかし、カーネルはテキストセグメントを読み込み専用メモリ領域にロードし、 テキストに続くページ境界から始まる 書き込み可能メモリ領域にデータセグメントをロードします。 .It Dv ZMAGIC カーネルは各々のページを必要に応じてバイナリからロードします。 ヘッダ、テキストセグメント及びデータセグメントはいずれも、 ページサイズの倍数の大きさになるよう、 リンクエディタによってパディングされます。 カーネルがテキストセグメントからロードしたページは読み込み専用ですが、 データセグメントからロードしたページは書き込み可能です。 .El .It Fa a_text テキストセグメントのサイズ (バイト単位) を保持します。 .It Fa a_data データセグメントのサイズ (バイト単位) を保持します。 .It Fa a_bss .Sq bss セグメント のバイト数を保持します。 この値はカーネルが最初の break 値 .Pq Xr brk 2 をデータセグメントの後ろに設定するのに用いられます。 カーネルは、ここに示されるサイズの書き込み可能メモリ領域が データセグメントの後ろに用意され、それらの初期状態が 0 になるように、 プログラムをロードします。 .It Fa a_syms シンボルテーブルセクションのサイズ (バイト単位) を保持します。 .It Fa a_entry カーネルがバイナリファイルをロードした後の、 プログラムのエントリポイントのメモリアドレスを保持します。 カーネルは、このアドレスにある機械命令からプログラムの実行を開始します。 .It Fa a_trsize テキストリロケーションテーブルのサイズ (バイト単位) を保持します。 .It Fa a_drsize データリロケーションテーブルのサイズ (バイト単位) を保持します。 .El .Pp インクルードファイル .Pa a.out.h では、 .Fa exec 構造体を用いて一貫性をテストしたりバイナリファイル中のセクションオフセットを 知るためのマクロが定義されています。 .Bl -tag -width N_BADMAG(exec) .It Fn N_BADMAG exec .Fa a_magic フィールドに、認識できない値が含まれている場合、非 0 を返します。 .It Fn N_TXTOFF exec バイナリファイルにおけるテキストセグメントの先頭のバイトオフセットを返します。 .It Fn N_SYMOFF exec シンボルテーブルの先頭のバイトオフセットを返します。 .It Fn N_STROFF exec 文字列テーブルの先頭のバイトオフセットを返します。 .El .Pp リロケーションレコードは、 .Fa relocation_info 構造体で規定される標準フォーマットです: .Bd -literal -offset indent struct relocation_info { int r_address; unsigned int r_symbolnum : 24, r_pcrel : 1, r_length : 2, r_extern : 1, r_baserel : 1, r_jmptable : 1, r_relative : 1, r_copy : 1; }; .Ed .Pp .Fa relocation_info 構造体の各フィールドは以下のように用いられます: .Bl -tag -width r_symbolnum .It Fa r_address リンクエディットが必要なポインタのバイトオフセットを保持します。 テキストリロケーションオフセットはテキストセグメントの先頭から、 データリロケーションオフセットはデータセグメントの先頭から、 それぞれ計算します。 リンクエディタはこのオフセットにストアされている値を加算し、 このリロケーションレコードを用いて計算した新しい値に変換します。 .It Fa r_symbolnum シンボルテーブルにおけるシンボル構造体の順序番号 ( バイトオフセット .Em ではありません ) を保持します。 リンクエディタはこのシンボルの絶対アドレスを解決した後、 そのアドレスをリロケーション中のポインタに加算します。 (もし .Fa r_extern ビットが立っていなければ状況は異なります。以下を参照して下さい。) .It Fa r_pcrel もしこのビットが立っていれば、 リンクエディタは、PC 相対アドレシングを用いる機械語命令の一部である ポインタを更新しているものと仮定します。 リロケートされるポインタのアドレスは、実行中のプログラムがそれを用いる際に、 暗黙的にその値に加算されます。 .It Fa r_length ポインタの長さを 2 を底とする対数で表したバイト単位で保持します。 1 バイトディスプレースメントなら 0、 2 バイトディスプレースメントなら 1、 4 バイトディスプレースメントなら 2 となります。 .It Fa r_extern このリロケーションが外部参照を必要としている場合にセットされます。 リンクエディタは、シンボルアドレスを用いてこのポインタを 更新しなければなりません。 .Fa r_extern ビットが立っていない場合、そのリロケーションは .Sq ローカル です。 リンクエディタは、シンボル値の変化ではなく、 各セグメントのロードアドレスの変化に応じてポインタを更新します (ただし、 .Fa r_baserel もセットされている場合(後述)は除きます)。 この場合、 .Fa r_symbolnum フィールドの内容は .Fa n_type の値となります(後述)。 リンクエディタは、この型フィールドから、 リロケートされるポインタがどのセグメントを指しているのかの情報を得ます。 .It Fa r_baserel セットされている場合、 .Fa r_symbolnum フィールドで指定される場合のように、 このシンボルはグローバルオフセットテーブルへのオフセットに リロケートされます。 実行時に、グローバルオフセットテーブル中の、このオフセット位置にある エントリが、シンボルのアドレスを持つようにセットされます。 .It Fa r_jmptable セットされている場合、 .Fa r_symbolnum フィールドで指定される場合のように、 このシンボルはプロシージャリンケージテーブルへのオフセットに リロケートされます。 .It Fa r_relative セットされている場合、 このリロケーションは、このオブジェクトファイルが含まれる イメージの (実行時の) ロードアドレスとの相対値となります。 この種のリロケーションは共有オブジェクトにのみ現れます。 .It Fa r_copy セットされている場合、 このリロケーションレコードは、 その内容を .Fa r_address で指定される位置にコピーしなければならないシンボルを示します。 コピー処理は、実行時のリンクエディタによって、 共有オブジェクト中の適切なデータアイテムから行われます。 .El .Pp シンボルは名前とアドレスを対応づけます (より一般的には、 文字列を値へ対応づけます)。 リンクエディタがアドレスを調節するため、 絶対値が割り当てられるまではシンボルを用いてアドレスを表現しなければ なりません。 シンボルは、シンボルテーブル中の固定長のレコードと、 文字列テーブル中の可変長の名前から成ります。 シンボルテーブルは .Fa nlist 構造体の配列です: .Bd -literal -offset indent struct nlist { union { char *n_name; long n_strx; } n_un; unsigned char n_type; char n_other; short n_desc; unsigned long n_value; }; .Ed .Pp これらのフィールドは以下のように用いられます: .Bl -tag -width n_un.n_strx .It Fa n_un.n_strx このシンボルの名前の、文字列テーブルでのバイトオフセットを保持します。 プログラムが .Xr nlist 3 関数を用いてシンボルテーブルをアクセスする場合、 このフィールドは、 メモリ中の文字列へのポインタである .Fa n_un.n_name フィールドに置き換えられます。 .It Fa n_type リンクエディタがシンボル値の更新方法を決定するのに用いられます。 .Fa n_type フィールドは、ビットマスクを用いた 3 つのサブフィールドに分けられます。 リンクエディタは .Dv N_EXT ビットがセットされているシンボルを .Sq external シンボルとして扱い、他のバイナリファイルからの参照を許可します。 .Dv N_TYPE マスクはリンクエディタに必要なビットを選択します: .Bl -tag -width N_TEXT .It Dv N_UNDF 未定義シンボル。 リンクエディタは、他のバイナリファイル中の同じ名前の外部シンボルを探して このシンボルの絶対値を決定しなければなりません。 特別な場合として、もし .Fa n_value フィールドが非 0 で、リンクエディット対象のどのバイナリファイルも このシンボルを定義していない場合、 リンクエディタはこのシンボルが bss セグメント中のアドレスであるとみなし、 .Fa n_value に等しいバイト数の領域を予約します。 もしこのシンボルが複数のバイナリファイル中で未定義となっており、 それらのバイナリファイル間でサイズが異なっている場合、 リンクエディタはそれらのサイズの最大値を選びます。 .It Dv N_ABS 絶対シンボル。 リンクエディタは絶対シンボルは更新しません。 .It Dv N_TEXT テキストシンボル。 このシンボルの値はテキストアドレスであり、 リンクエディタはバイナリファイルをマージする際、その値を更新します。 .It Dv N_DATA データシンボル。 .Dv N_TEXT と同様ですが、データアドレスを表します。 テキストシンボル及びデータシンボルの値は、 ファイルオフセットではなくアドレスです。 ファイルオフセットを復元するために、 対応するセクションの先頭のロードアドレスを見つけてそれを減じ、 次にそのセクションのオフセットを加算する必要があります。 .It Dv N_BSS bss シンボル。テキストシンボルやデータシンボルと似ていますが、 バイナリファイル中に対応するオフセットを持ちません。 .It Dv N_FN ファイル名シンボル。 バイナリファイルをマージする際、 リンクエディタはバイナリファイルの他のシンボルの前にこのシンボルを 挿入します。 このシンボルの名前はリンクエディタに与えられたファイル名で、 シンボルの値はバイナリファイルから得た先頭テキストアドレスです。 ファイル名シンボルはリンクエディト処理やロード処理には不要ですが、 デバッガには有用な情報です。 .El .Pp .Dv N_STAB マスクは .Xr gdb 1 等のシンボリックデバッガに必要なビットを選択します。 その値は .Xr stab 5 に示されています。 .It Fa n_other このフィールドは、 .Fa n_type フィールドで決定されるセグメントに関して、 そのシンボルのロケーションとは独立した シンボルの特質に関する情報を提供します。 現在のところ、 .Fa n_other フィールドの下位 4 ビットは .Dv AUX_FUNC あるいは .Dv AUX_OBJECT のいずれかをとります .Po これらの定義については .Aq Pa link.h を参照してください .Pc 。 .Dv AUX_FUNC はシンボルと呼び出し可能な関数を関連づけ、他方、 .Dv AUX_OBJECT はシンボルとデータを関連づけます。 これらの関連はテキストセグメント/データセグメントの別とは無関係です。 このフィールドは、 .Xr ld 1 が動的な実行可能形式を構築するために使うことを意図しています。 .It Fa n_desc デバッガ用に予約されており、リンクエディタはこのフィールドを全く変更しません。 デバッガによって異なった目的に使われます。 .It Fa n_value シンボルの値を保持します。 テキスト, データおよび bss シンボルの場合、その値はアドレスです。 他のシンボル (例えばデバッガシンボル等) の場合、その値は様々です。 .El .Pp 文字列テーブルは .Em unsigned long 型の長さと、それに続くナル終端のシンボル文字列から成ります。 この長さは、テーブル全体のサイズをバイト単位で表します。 つまり、その最小値 (言い替えれば、最初の文字列のオフセット) は、 32 ビットマシンでは常に 4 となります。 .Sh 関連項目 .Xr as 1 , .Xr gdb 1 , .Xr ld 1 , .Xr brk 2 , .Xr execve 2 , .Xr nlist 3 , .Xr core 5 , .Xr link 5 , .Xr stab 5 .Sh 歴史 インクルードファイル .Pa a.out.h は .At v7 で登場しました。 .Sh バグ 必ずしも全てのサポート対象アーキテクチャが .Fa a_midmag フィールドを用いるわけではないので、 あるバイナリがどのようなアーキテクチャ上で実行されるのかは、 実際のマシンコードを調べない限り判定困難な可能性があります。 マシン ID があったとしても、 .Fa exec ヘッダのバイト順はマシン依存です。 .Pp .Em bss が何の略なのか、に関する合意はないようです。 .Pp 将来、新しいバイナリファイルフォーマットがサポートされるかも知れませんが、 その新フォーマットは恐らく、 あらゆるレベルでこの太古のフォーマットと互換性がないでしょう。 diff --git a/ja/man/man5/acct.5 b/ja/man/man5/acct.5 index 2d99ce3746..dca16ef9fc 100644 --- a/ja/man/man5/acct.5 +++ b/ja/man/man5/acct.5 @@ -1,115 +1,115 @@ .\" 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. .\" .\" @(#)acct.5 8.1 (Berkeley) 6/5/93 .\" %Id: acct.5,v 1.1.1.1.8.4 1998/06/28 21:34:26 hoek Exp % .\" -.\" jpman $Id: acct.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: acct.5,v 1.3 1998/05/27 11:45:48 kuma Stab % .\" .\" WORD: account アカウント[acct.5] .\" WORD: accounting file アカウンティングファイル[acct.5] .\" WORD: structure 構造体(C言語の)[C] .\" .Dd June 5, 1993 .Dt ACCT 5 .Os .Sh 名称 .Nm acct .Nd 実行アカウントファイル .Sh 書式 .Fd #include .Fd #include .Sh 解説 カーネルは、下記の .Fa acct 情報構造を、全プロセスに対して管理します。 プロセスが終了すると、アカウンティングが有効になっている場合には、 カーネルは .Xr acct 2 関数呼び出しを行い、アカウンティングファイルに記録を追加します。 .Bd -literal /* * アカウンティング構造体; これらは、基底値 8 の 3 ビット指数部および * 13 ビット小数部の ``浮動小数点数'' である comp_t 型を使用します。 * 単位は 1/AHZ 秒です。 */ typedef u_short comp_t; #define AC_COMM_LEN 16 struct acct { char ac_comm[AC_COMM_LEN]; /* コマンド名 */ comp_t ac_utime; /* ユーザ時間 */ comp_t ac_stime; /* システム時間 */ comp_t ac_etime; /* 経過時間 */ time_t ac_btime; /* 開始時刻 */ uid_t ac_uid; /* ユーザ ID */ gid_t ac_gid; /* グループ ID */ short ac_mem; /* 平均メモリ使用量 */ comp_t ac_io; /* 入出力ブロック数 */ dev_t ac_tty; /* 制御 tty */ #define AFORK 0x01 /* fork したが exec されていない */ #define ASU 0x02 /* スーパユーザ権限を使用した */ #define ACOMPAT 0x04 /* 互換モードを使用した */ #define ACORE 0x08 /* コアダンプした */ #define AXSIG 0x10 /* シクナルにより kill された */ char ac_flag; /* アカウンティングフラグ */ }; /* * 1/AHZ の粒度で、データは comp_t フィールドにエンコードされます。 * 必ずしも周波数と同一となるとは限りません。 */ #define AHZ 64 .Ed .Pp 終了したプロセスが .Xr execve 2 により生成されたものだった場合、 実行されたファイルのファイル名 (最大 10 文字まで) が .Fa ac_comm フィールドに保存され、その状態は .Fa ac_flag の次のフラグの 1 つ以上を設定することにより保存されます: .Dv AFORK , .Dv ASU , .Dv ACOMPAT , .Dv ACORE , .Dv ASIG 。 .Sh 関連項目 .Xr acct 2 , .Xr execve 2 , .Xr sa 8 .Sh 歴史 .Nm ファイルフォーマットは .At v7 から登場しました。 diff --git a/ja/man/man5/aliases.5 b/ja/man/man5/aliases.5 index 1083fbfd2f..3b8503862c 100644 --- a/ja/man/man5/aliases.5 +++ b/ja/man/man5/aliases.5 @@ -1,108 +1,108 @@ .\" Copyright (c) 1983, 1997 Eric P. Allman .\" 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. .\" .\" @(#)aliases.5 8.3 (Berkeley) 2/1/97 -.\" jpman $Id: aliases.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: aliases.5,v 1.3 1998/05/28 15:47:09 kuma Stab % .\" .\" WORD: alias (名)別名(sendmail),エイリアス(csh)(動)エイリアスする(sendmail)[aliases.5,csh.1] .\" .Dd February 1, 1997 .Dt ALIASES 5 .Os BSD 4 .Sh 名称 .Nm aliases .Nd sendmail のためのエイリアスファイル .Sh 書式 .Nm aliases .Sh 解説 このファイルには、 .Pa /usr/sbin/sendmail が使用する、ユーザ .Tn ID の別名を記述します。 このファイルは .Pa /etc に置かれる、下記の形式の一連の行です。 .Bd -filled -offset indent name: name_1, name_2, name_3, . . . .Ed .Pp .Em name はエイリアスする名前、 .Em name_n はその名前の別名です。 空白ではじまる行は継続行です。 .Ql # ではじまる行はコメントです。 .Pp エイリアスはローカル名でのみ適用されます。 ループは起りえません。 なぜなら、メッセージは同じ人に複数回送られないからです。 .Pp エイリアス適用後、ローカルかつ有効な受信者で .Dq Pa .forward ファイルをホームディレクトリに持つ人のメッセージは、 このファイルに定義された一連のユーザに転送されます。 .Pp これは単なる生のデータファイルです; 実際のエイリアス情報は .Xr newaliases 1 プログラムを使用することにより、バイナリ形式でファイル .Pa /etc/aliases.db に置かれます。aliases ファイルを更新したときには、その内容を反映させるために、 .Xr newaliases コマンドを実行する必要があります。 .Sh 関連項目 .Xr newaliases 1 , .Xr dbm 3 , .Xr dbopen 3 , .Xr sendmail 8 .Rs .%T "SENDMAIL Installation and Operation Guide" .Re .Rs .%T "SENDMAIL An Internetwork Mail Router" .Re .Sh バグ .Xr sendmail を NEWDB サポート付きではなく DBM サポート付きでコンパイルした時には、 エイリアス 1 つがおよそ 1000 バイトまでの情報に限るという .Xr dbm 3 の制約が問題となるかもしれません。 このような場合に長いエイリアスを使用するためには ``連鎖'' を使用します; これは別名の最後の名前をダミーの名前にし、 これを引続き別の別名として使用するというものです。 .Sh 歴史 .Nm ファイルフォーマットは .Bx 4.0 に登場しました。 diff --git a/ja/man/man5/ar.5 b/ja/man/man5/ar.5 index 633b3d79a2..6059899e48 100644 --- a/ja/man/man5/ar.5 +++ b/ja/man/man5/ar.5 @@ -1,158 +1,158 @@ .\" 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. .\" .\" @(#)ar.5.5 8.1 (Berkeley) 6/9/93 -.\" jpman $Id: ar.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: ar.5,v 1.3 1998/06/15 05:38:19 kuma Stab % .\" .\" WORD: archive アーカイブ .\" .Dd June 9, 1993 .Dt AR 5 .Os .Sh 名称 .Nm ar .Nd アーカイブ (ライブラリ) ファイルフォーマット .Sh 書式 .Fd #include .Sh 解説 アーカイブコマンド .Nm ar は複数のファイルをひとつにまとめます。 アーカイブは主にリンクエディタ .Xr ld 1 を使ってロードするための オブジェクトファイルのライブラリとして使用します。 .Pp .Nm ar によって作成されたファイルは ``マジック'' ストリング "!\en" で 始まっています。 アーカイブの残りはオブジェクトからなり、その各々はファイルのヘッダと ファイル名 (オプション) とファイルの中身から構成されます。 ヘッダは異なるマシンアーキテクチャ間で互換性のあるもので、 ファイルの内容が印字可能なものであれば アーカイブそのものも印字可能となります。 .Pp ヘッダは、可変長の .Tn ASCII のフィールド 6 つとそれに続く2 文字の終端から構成されます。 フィールドはオブジェクトの名前 (16 文字)、 ファイルの最終更新時間 (12 文字)、 ユーザとグループ ID (各々 6 文字)、 ファイルモード (8文字)、 それにファイルサイズ (10 文字) です。 全ての数字フィールドは 10 進数ですが、ファイルモードだけは 8 進数です。 .Pp 更新時間はファイルの .Fa st_mtime フィールドです。すなわち 基準時点 (epoch) からの時間 .Dv CUT 秒です。 ユーザ ID とグループ ID はファイルの .Fa st_uid と .Fa st_gid フィールドです。 ファイルモードはファイルの .Fa st_mode フィールドです。 ファイルサイズはファイルの .Fa st_size フィールドです。 最後の 2 バイトは文字列 "\`\en" となります。 .Pp 名前のフィールドに限りあふれることが考えられるため、以下のよ うに対応しています。 もしファイル名の長さが 16 文字を超えるかスペースを含む場合は、 名前のフィールドには文字列 "#1/" に続いてその名前の .Tn ASCII での長さが書き込まれます。 ファイルサイズ (アーカイブヘッダに書き込まれているもの) には その名前の長さが加算されます。 そして名前はアーカイブヘッダの直後に書かれます。 .Pp これらのフィールドにおいて使用されていない部分には 空白文字が書き込まれます。 もしフィールドにその最長の文字数が書き込まれていると、 フィールドの間の区切りはないことになります。 .Pp アーカイブ中のオブジェクトは常に偶数バイトの長さとなります。 ファイルの長さが奇数バイトである場合は 改行 (``\en'') 文字でパディングされます。 その場合、ヘッダ中のファイルサイズにはパディングの分は反映されません。 .Sh 関連項目 .Xr ar 1 , .Xr stat 2 .Sh 歴史 これまでに少なくとも 4 つの .Nm ar フォーマットがありました。 最初のものは先頭の ``マジック'' ナンバー 0177555 (int 型で書かれていた) で示されていました。 これらのアーカイブはほとんどが 16 ビットマシン上で作られたものであり、 ヘッダは 5 つのフィールドから構成されていました。 ヘッダのフィールドにはオブジェクト名 (8 文字)、 ファイルの最終更新時間 (long 型)、 ユーザ ID (char 型)、 ファイルモード (char 型)、 そしてファイルサイズ (符号なし int 型) がありました。 ファイルはバイト数で偶数長となるようにパディングされていました。 .Pp 2 つ目のものは先頭の ``マジック'' ナンバー 0177545 (int 型で書かれていた) で示されていました。 これらのアーカイブは 16 もしくは 32 ビットマシンで作られたものであり、 ヘッダは 6 つのフィールドから構成されていました。 フィールドにはオブジェクト名 (14 文字)、 ファイルの最終更新時間 (long 型)、 ユーザおよびグループ ID (各々 char 型)、 ファイルモード (int 型)、 そしてファイルサイズ (long 型) がありました。 ファイルはバイト数で偶数長となるようにパディングされていました。 .\" For more information on converting from this format see .\" .Xr arcv 8 . .Pp 現在のアーカイブフォーマット (長い名前とスペースを含む名前をサポートしていないもの) は .Bx 4.0 で導入されました。 ヘッダは現在のフォーマットと同じですが、 16 文字以上の名前は切り捨てられ、 スペースを含む名前 (および名前の末尾にスペースがつくもの) はサポートされていません。 これらの理由により、このフォーマットに前述の拡張がなされました。 現在のこのフォーマットは .Bx 4.4 で最初に出現しました。 .Sh 互換性 現在アーカイブフォーマットは標準では規定されていません。 .At V では、昔から上述のいずれとも異なるフォーマットの アーカイブで配布されています。 diff --git a/ja/man/man5/bootparams.5 b/ja/man/man5/bootparams.5 index a357d43cb4..800eb21aa5 100644 --- a/ja/man/man5/bootparams.5 +++ b/ja/man/man5/bootparams.5 @@ -1,78 +1,78 @@ .\" .\" Copyright (c) 1994 Gordon W. Ross .\" 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. .\" .\" from: Id: bootparams.5,v 1.2 1994/10/03 19:26:13 gwr Exp .\" %Id: bootparams.5,v 1.2.2.5 1998/03/09 13:50:33 jkh Exp % -.\" jpman $Id: bootparams.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: bootparams.5,v 1.3 1998/04/29 11:35:09 kuma Stab % .\" .Dd October 2, 1994 .Dt BOOTPARAMS 5 .Os .Sh 名称 .Nm bootparams .Nd ブートパラメータデータベース .Sh 書式 .Nm /etc/bootparams .Sh 解説 .Nm ファイルは、 ディスクレスクライアントがネットワーク越しにブートする時に要求する、 ブートパラメータを指定します。 このサーバがサポートする各クライアントは、 .Nm ファイル中に、 .Nm root のパス名と (オプションで) .Nm swap 領域のパス名を含むエントリを持つ必要があります。 .Pp ファイル中の各行 (# から初まるコメント行以外) は、 クライアント名、 それに続いてクライアントの論理名にて要求するパス名から成ります。 行内部の要素は空白もしくはタブで区切られ、 バックスラッシュを使用すれば複数行を続けて使用することができます。 .Pp 例を以下に示します: .Bd -literal -offset indent dummy root=host:/export/dummy/root \\ swap=host:/export/dummy/swap \\ dump=host:/export/dummy/swap .Ed .Pp 名前が "dummy" のクライアントが、自らの論理 "root" のパス名を要求した時、 この .Tn RPC リクエストに対してパス名 .Dq Pa "host:/export/dummy/root" が返答として与えられます。"host:" 部分は必ず指定する必要があります。 .Sh 関連ファイル .Bl -tag -width /etc/bootparams -compact .It Pa /etc/bootparams デフォルトの構成ファイル .El .Sh 関連項目 .Xr bootparamd 8 , .Xr diskless 8 diff --git a/ja/man/man5/bootptab.5 b/ja/man/man5/bootptab.5 index 9401f95b53..e2e8849165 100644 --- a/ja/man/man5/bootptab.5 +++ b/ja/man/man5/bootptab.5 @@ -1,395 +1,395 @@ .\" Copyright (c) 1988, 1989, 1991 Carnegie Mellon University .\" .\" %Header: /home/ncvs/src/libexec/bootpd/bootptab.5,v 1.1.1.2.2.2 1998/02/18 05:55:30 jkh Exp % .\" .TH BOOTPTAB 5 "October 31, 1991" "Carnegie Mellon University" -.\" jpman $Id: bootptab.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: bootptab.5,v 1.3 1998/07/02 18:50:36 kumano Stab % .UC 6 .SH 名称 bootptab \- インターネットブートストラッププロトコルサーバのデータベース .SH 解説 .I bootptab ファイルは、 .IR bootpd すなわちインターネットブートストラッププロトコルサーバの 設定データベースファイルです。 このフォーマットは .IR termcap (5) のものに似ており、2 文字の大文字小文字を区別するタグシンボルが ホストパラメータを表現します。 これらのパラメータ宣言はコロン (:) によって分けられ、次のような形式になります。 .PP .I " hostname:tg=value. . . :tg=value. . . :tg=value. . . ." .PP ここで .I hostname は実際の bootp クライアントの名前 (もしくは「ダミーエントリ」) であり、 .I tg は 2 文字のタグシンボルです。 ダミーエントリは不正なホスト名 ("." を最初の文字とする名前) を持ち、 .B tc=.dummy-entry 機構を介して他のエントリにデフォルト値を提供します。 ほとんどのタグの後には、上記のように等号と値を続ける必要があります。 値を伴わないブール形式のものもあります (すなわち .RI : tg : の形式です)。 現在、認識されるタグを示します: .PP .br bf ブートファイル .br bs 512 オクテットブロックでのブートファイルの大きさ .br cs クッキーサーバのアドレスリスト .br df メリットダンプファイル .br dn ドメイン名 .br ds ドメインネームサーバのアドレスリスト .br ef 拡張ファイル .br gw ゲートウェイのアドレスリスト .br ha ホストのハードウェアアドレス .br hd ブートファイルのホームディレクトリ .br hn クライントのホスト名をクライアントに送る .br ht ホストのハードウェアタイプ (Assigned Numbers RFC を参照) .br im インプレスサーバのアドレスリスト .br ip ホストの IP アドレス .br lg ログサーバのアドレスリスト .br lp LPR サーバのアドレスリスト .br ns IEN-116 ネームサーバのアドレスリスト .br nt NTP (時刻) サーバ (RFC 1129) .br ra 返答アドレスの上書き .br rl リソースロケーションプロトコルサーバのアドレスリスト .br rp ルートとしてマウントするルートパス .br sa クライアントが使用すべき TFTP サーバのアドレス .br sm ホストのサブネットマスク .br sw スワップサーバのアドレス .br tc テーブル継続 (同様の「テンプレート」ホストエントリを指します) .br td 「安全な」 TFTP サーバが使用するルートディレクトリ .br to 秒で表現した UTC からのオフセット .br ts タイムサーバのアドレスリスト .br vm ベンダマジッククッキーセレクタ .br yd YP (NIS) のドメイン名 .br ys YP (NIS) のサーバアドレス .PP 包括的な .RI T n タグもあります。ここで .I n は RFC1084 のベンダフィールドタグ番号です。 これにより、まず .I bootpd を変更しなくとも、 RFC1084 に対する将来の拡張の利点をすぐに利用することができます。 包括的なデータは、 16 進数のストリームもしくはクォートされた ASCII 文字列として表現されます。 包括的なデータの長さは自動的に判定され、 RFC1084 スタイルのブートストラップリプライの適切なフィールドに挿入されます。 .PP 以下のタグは空白で区切られた IP アドレスのリストを取ります: .BR cs , .BR ds , .BR gw , .BR im , .BR lg , .BR lp , .BR ns , .BR nt , .BR ra , .BR rl , .BR ts 。また .BR ip , .BR sa , .BR sw , .BR sm , .B ys タグはそれぞれ単一の IP アドレスを取ります。 IP アドレスは全て標準のインターネット「ドット」表記で指定されます。 10 進数、8 進数、16 進数のいずれも使用可能です (8 進数は 0 から始まり、16 進数は '0x' または '0X' から始まります)。 IP アドレスは代りにホスト名で指定可能です。 この場合、 .I bootpd はそのホスト名の IP アドレスを得るために gethostbyname(3) を使用します。 もし .B ip タグが指定されなかった場合、 .I bootpd はエントリ名をホスト名とすることにより IP アドレスを判定します。 (ダミーエントリは不正なホスト名とすることにより、 自動的な IP 検索を避けます) .PP .B ht タグは、10 進数・8 進数・16 進数の符号無し整数、 もしくは以下のいずれかのシンボル名をもって、 ハードウェアタイプコードを指定します。 .BR ethernet , .B ether は 10Mb イーサネットを、 .BR ethernet3 , .B ether3 は 3Mb の実験的イーサネットを、 .BR ieee802 , .BR tr , .B token-ring は IEEE 802 ネットワークを、 .B pronet は Proteon ProNET Token Ring を、 .BR chaos , .BR arcnet , .B ax.25 は Chaos, ARCNET, AX.25 Amateur Radio networks を、それぞれ表現します。 .B ha タグは、ホスト名もしくは数値形式で、ハードウェアアドレスを指定します。 数値形式は 16 進数で指定する .I 必要があります 。可読性のためにピリオドを付けたり、前に '0x' を付けても良いです。 .B ha タグの前に .B ht タグがある必要があります (明示的でも暗黙的でもかまいません。後述の .B tc 参照)。ハードウェアアドレスが指定されない場合、指定されたタイプが \&"ethernet" もしくは \&"ieee802" の場合、 .I bootpd は ether_hostton(3) を使用してハードウェアアドレスを決定しようとします。 .PP ホスト名・ホームディレクトリ・ブートファイルは ASCII 文字列であり、 ダブルクォート (") で括ることもできます。 クライアントのリクエストおよび .B hd シンボルと .B bf シンボルの値は、bootp リプライパケットのブートファイルフィールドを サーバがどのように埋めるかを決定します。 .PP クライアントがファイル名を指定した場合、それはそのまま残されます。 そうでない場合は、 .B bf オプションが指定されていれば、その値がリプライパケットにコピーされます。 もし .B hd オプションも指定されている場合には、 その値がリプライパケットにコピーされるブートファイルの前に付きます。 ブートファイルの存在確認は .BR bs =auto オプションが使用されているときのみ行われます (ブートファイルサイズ確認のためです)。 ブートファイルが存在しようとしまいと、リプライは送られます。 .PP 新しいバージョンの .I tftpd では、 .IR chroot (2) システムコールを使用してルートディレクトリを変更するという セキュリティ機能を提供します。 .B td タグは、 .IR tftpd が使用するこの特殊ルートディレクトリを .I bootpd に通知するために使用します。 (代りに .I bootpd "-c chdir" オプションを使用したいかもしれません。) 実際、 .B hd タグは .B td タグにより指定されるルートディレクトリからの相対指定です。 例えば、BOOTP クライアントブートファイルの現実の絶対パスが /tftpboot/bootfiles/bootimage であり、 .IR tftpd が /tftpboot を「安全な」ディレクトリとする場合、 .IR bootptab では次のように指定します。 .PP .br :td=/tftpboot:hd=/bootfiles:bf=bootimage: .PP ブートファイルを直接 /tftpboot に置く場合には次のようにします。 .PP .br :td=/tftpboot:hd=/:bf=bootimage: .PP .B sa タグは、あなたがクライアントに使用させたい特定の TFTP サーバの IP アドレスを 指定するために使用します。 このタグを指定しないと、 .I bootpd が実行されているのと同じマシンに対して TFTP を行うように、 .I bootpd はクライアントに指示します。 .PP 時刻オフセット .B to は、クライアントの UTC からのタイムゾーンオフセットを秒で表現した 符号付き 10 進数、 またはサーバのタイムゾーンオフセットを使用することを意味するキーワード .B auto です。 .B to シンボルをブール値として指定することは、 .B auto を値として指定するのと同じ効果があります。 .PP ブートファイルサイズ .B bs は、10 進数・8 進数・16 進数の整数で ブートファイルのサイズを 512 オクテットブロックで表現したもの、 またはサーバが各リクエストに際して ブートファイルサイズを自動的に計算することを示すキーワード .B auto です。 時刻オフセットと同じく、 .B bs シンボルをブール値として指定することは、 .B auto を値として指定するのと同じ効果があります。 .PP ベンダマジッククッキーセレクタ ( .B vm タグ) は以下のキーワードのいずれかを取ります。 .B auto (ベンダ情報をクライアントリクエストから判別)、 .B rfc1048 または .B rfc1084 (常に RFC1084 スタイルのリプライを強制)、または .B cmu (常に CMU スタイルのリプライを強制) です。 .PP .B hn タグは厳密にブール値のタグです。通常の等号および値を取りません。 このタグが存在すると、ホスト名を RFC1084 クライアントに送ることを意味します。 .I bootpd は、構成ファイルで指定されるホスト名全体を送ろうとします。 リプライパケットに収まらない場合、 名前は (存在するならば最初のピリオドまでの) ホストフィールドのみに縮められ、 再度試されます。 任意の長さに縮められたホスト名が送られてしまうということはありません (収まるものがない場合には、なにも送られません)。 .PP しばしば、多くのホストエントリが特定のタグの共通の値を共有します (ネームサーバなど)。 これらのタグを何度も書くのではなく、 全体仕様を 1 つのホストエントリに記述してこれを .B tc (テーブル継続) 機構を介して共有することができます。 多くの場合、このテンプレートエントリは実際には存在しないダミーホストであり、 bootp リクエストを送ることはありません。 この機能は、 .IR termcap (5) で似た端末を記述するための .B tc 機能に似ています。 .I termcap では最後のタグでなければなりませんが、 .I bootpd では .B tc タグシンボルがホストエントリ中のどこにあらわれても良いことに注意してください。 ホストに対して明示的に指定した情報は、エントリ中の .B tc タグシンボルの位置にかかわらず、これにより暗黙に指定される情報を上書きします。 .B tc タグの値はホスト名もしくは構成ファイルで前に記述されている IP アドレスです。 .PP .BR tc タグで暗示された特定のタグの削除が必要になることがあります。 これは .IB tag @ 構造を使用することにより、 .IR termcap (5) の場合と同様に .I tag の効果を削除することにより実現できます。 例えば、IEN-116 ネームサーバ仕様を完全に無効にしたい場合には、 構成ファイルのエントリの適切な位置に \&":ns@:" を置きます。 .BR @ を使用して削除を行った後には、 .B tc 機構を使用してそのタグを再度設定することができます。 .PP 構成ファイル中の、空行および "#" で始まる行は無視されます。 ホストエントリは改行で分けられます。 単一のホストエントリは、 行がバックスラッシュ (\\) で終る場合に複数行にまたがることができます。 行が 80 文字を越えることも許されます。 タグは任意の順序で現われてかまいませんが、次のような例外があります。 ホスト名はエントリの最初のフィールドである必要があり、 ハードウェアタイプはハードウェアアドレスの前に指定する必要があります。 .PP .I /etc/bootptab ファイルの例を示します: .PP .nf # Sample bootptab file (domain=andrew.cmu.edu) .default:\\ :hd=/usr/boot:bf=null:\\ :ds=netserver, lancaster:\\ :ns=pcs2, pcs1:\\ :ts=pcs2, pcs1:\\ :sm=255.255.255.0:\\ :gw=gw.cs.cmu.edu:\\ :hn:to=-18000: carnegie:ht=6:ha=7FF8100000AF:tc=.default: baldwin:ht=1:ha=0800200159C3:tc=.default: wylie:ht=1:ha=00DD00CADF00:tc=.default: arnold:ht=1:ha=0800200102AD:tc=.default: bairdford:ht=1:ha=08002B02A2F9:tc=.default: bakerstown:ht=1:ha=08002B0287C8:tc=.default: # Special domain name server and option tags for next host butlerjct:ha=08002001560D:ds=128.2.13.42:\\ :T37=0x12345927AD3BCF:\\ :T99="Special ASCII string":\\ :tc=.default: gastonville:ht=6:ha=7FFF81000A47:tc=.default: hahntown:ht=6:ha=7FFF81000434:tc=.default: hickman:ht=6:ha=7FFF810001BA:tc=.default: lowber:ht=1:ha=00DD00CAF000:tc=.default: mtoliver:ht=1:ha=00DD00FE1600:tc=.default: .fi .SH 関連ファイル /etc/bootptab .SH "関連項目" bootpd (8), tftpd(8) .br DARPA Internet Request For Comments RFC951, RFC1048, RFC1084, Assigned Numbers diff --git a/ja/man/man5/core.5 b/ja/man/man5/core.5 index 9ce0a27ce4..39069976e4 100644 --- a/ja/man/man5/core.5 +++ b/ja/man/man5/core.5 @@ -1,110 +1,110 @@ .\" 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. .\" .\" @(#)core.5 8.3 (Berkeley) 12/11/93 .\" %Id: core.5,v 1.2.2.2 1998/05/11 03:42:44 steve Exp % .\" -.\" jpman $Id: core.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: core.5,v 1.3 1998/06/12 15:55:30 kumano Stab % .\" .Dd December 11, 1993 .Dt CORE 5 .Os BSD 4 .Sh 名称 .Nm core .Nd メモリイメージのファイルフォーマット .Sh 書式 .Fd #include .Sh 解説 プロセスを異常終了させる少数のシグナルは、 プロセスのメモリ内状態の記録をディスクに書き出させる効果もあります。 これにより、デバッガを使用して後で検査を行うことが可能です。( .Xr sigaction 2 を参照してください。) このメモリイメージは作業ディレクトリの .Nm プログラム名.core という名前のファイルに書かれます。 ただし、終了したプロセスがそのディレクトリに書きこみ権限を持ち、 発生した異常がシステムを破壊しないことが前提です。 (システムが破壊された場合には、 コアファイルを保存するかどうかの決定は不定です。 .Xr savecore 8 を参照してください。) .Pp .Nm プログラム名.core ファイルの最大サイズは .Xr setrlimit 2 により制限されます。 制限よりも大きくなるファイルは生成されません。 .Pp .Nm プログラム名.core ファイルは、(ページ数での) 大きさが .Aq Pa sys/param.h ファイルで .Dv UPAGES と定義されている .Fa u . 領域からなります。 .Fa u . 領域は .Aq Pa sys/user.h に記述されている .Fa user 構造体から始まります。 .Nm プログラム名.core の残りの部分には、 データページに続いてプロセスイメージのスタックページが格納されます。 .Nm プログラム名.core ファイル中のデータ空間イメージの (ページ数での) 大きさは、 .Fa u . 領域の変数 .Fa u_dsize で与えられます。 コアファイル中のスタックイメージの (ページ数での) 大きさは、 .Fa u . 領域の変数 .Fa u_ssize で与えられます。 ``ページ'' サイズは定数 .Dv PAGE_SIZE .\" docs/6573 の内容を反映 horikawa@jp.freebsd.org 1998/05/18 で与えられます (これも .Aq Pa sys/param.h から与えられます)。 .Sh 関連項目 .Xr gdb 1 , .Xr kgdb 1 , .Xr setrlimit 2 , .Xr sigaction 2 .Sh 歴史 .Nm core ファイルのフォーマットは .At v6 に登場しました。 diff --git a/ja/man/man5/crontab.5 b/ja/man/man5/crontab.5 index 846c0551ba..dddc38f22a 100644 --- a/ja/man/man5/crontab.5 +++ b/ja/man/man5/crontab.5 @@ -1,223 +1,223 @@ .\"/* Copyright 1988,1990,1993,1994 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 uunet!decwrl!vixie!paul .\" */ .\" .\" %Id: crontab.5,v 1.1.1.1.8.4 1998/07/18 11:09:18 jkh Exp % .\" -.\" jpman $Id: crontab.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: crontab.5,v 1.3 1998/07/02 14:12:25 horikawa Stab % .\" .\" WORD: day of the week 曜日 .Dd January 24, 1994 .Dt CRONTAB 5 .Os .Sh 名称 .Nm crontab .Nd cron を駆動するための一覧表 .Sh 解説 1 つの .Nm ファイルには ``この日のこの時間にこのコマンドを実行せよ'' という一般的な形式の .Xr cron 8 デーモンへの複数の指示が含まれています。 各々ユーザは各自所有の crontab を持ち、crontab に書かれたコマンドはその crontab を所有するユーザとして実行されることになります。UUCP と News は 通常それ自身所有の crontab を持ち、cron コマンドの一部として .Xr su 1 を実際に実行させる必要のないようにしています。 .Pp 空行と、先頭の空白およびタブは無視されます。 最初の非空白文字がポンド記号 (#) である行は注釈行であり、無視されます。 注釈は cron コマンドと同じ行にあってはいけません。 なぜなら、注釈自身がコマンドの一部とみなされるからです。 同様に、注釈は環境変数を設定する行と同じ行にあって はいけません。 .Pp crontab の中で有効なのは環境変数の設定かまたは cron コマンドのどちらかです。 環境変数の設定は次のような形で行います。 .Pp name = value .Pp ここで等号 (=) の周囲の空白は有っても良いですが、 .Em value の中で = に引き続くスペースでない部分だけが .Em name に割当てられる値となります。 .Em value 文字列はクォート (シングルクォートまたはダブルクォートですがどちらかに統一します) で囲うこともでき、そのときには = に続くブランクや末尾のブランク を含むことができます。 .Pp いくつかの環境変数は自動的に .Xr cron 8 デーモンによって設定されます。 .Ev SHELL は .Pa /bin/sh に設定され、 .Ev LOGNAME と .Ev HOME はその crontab の所有者の .Pa /etc/passwd 行を元に設定されます。 .Ev HOME と .Ev SHELL は、crontab ファイル中で設定することで上書きできますが、 .Ev LOGNAME はできません。 .Pp (別注: .Ev LOGNAME 変数は BSD システム上では .Ev USER と呼ばれることがあります。このようなシステム上では .Ev USER も設定されます。) .Pp .Ev LOGNAME , .Ev HOME , .Ev SHELL に加え、 ``この'' crontab で実行したコマンドの実行結果をメールで送る理由がある場合、 .Xr cron 8 は .Ev MAILTO を見ます。 .Ev MAILTO が定義されていて (かつ空でない) とき、そこで指定された名前のユーザへメール が送られます。 .Ev MAILTO が定義されているが空のとき (MAILTO="")、メールは送られません。 その他の場合にはメールは crontab の所有者に送られます。 cron インストール時に、メーラとして .Pa /usr/lib/sendmail ではなく .Pa /bin/mail を使う場合、このオプションは有用です -- .Pa /bin/mail はエリアスを行いませんし、UUCP は通常自分宛のメールを読みません。 .Pp cron コマンドのフォーマットはほとんど V7 標準であり、多くの上位互換拡張を 持っています。各行は 5 つの時間と日付の欄、システム crontab ファイルの場合は続いてユーザ名 (``:<グループ>'' および ``/<ログインクラス>'' の添字が付くこともあります)、 その後にコマンドが続きます。分、時間、月の欄と現在の時刻が一致し、 .Em かつ 2 つの日付欄 (月における日または曜日) のうちの少なくとも 1 つと 現在の時刻が一致したとき (下記の ``注'' 参照) に、コマンドは .Xr cron 8 により実行されます。 .Xr cron 8 は 1 分ごとに cron エントリを調べます。時間と日付の欄は次のとおりです。 .Bd -literal -offset indent 欄 　　　　　　　　　許される値 ------------ ------------------------------------------------ 分 0-59 時間 0-23 月における日 1-31 月 1-12 (または名前、下記参照) 曜日 0-7 (0 および 7 は日曜のこと。名前を用いてもよい) .Ed .Pp 欄はアスタリスク (*) でも良いですが、このときには常に "最初-最後" を表すこ とになります。 .Pp 数値領域を指定できます。領域指定は、2 つの数をハイフンでつなげたものです。 指定された領域は、両端を含みます。 たとえば ``時間'' エントリの 8-11 は、 8, 9, 10, 11 時の実行を指定することになります。 .Pp リスト指定もできます。リスト指定はコンマによって数 (または領域指定) をつな げた 1 組のことです。例: ``1,2,5,9'', ``0-4,8-12''。 .Pp 間隔値は領域指定と共に用いることができます。領域指定に続けて ``/<数>'' を指定すると、その領域を通じてその数の値だけ飛ばす値になります。 たとえば ``0-23/2'' は時間の欄で用いられると、2 時間おきにコマンドを実行 することになります (別の方法で V7 標準で表せば ``0,2,4,6,8,10,12,14,16,18,20,22'' となります)。間隔指定はアスタリスクの 後で付けても構いません。たとえば ``2 時間おきに全て'' ということをしたい なら ``*/2'' とするだけです。 .Pp ``月'' および ``曜日'' の指定には、名前を使用することができます。 曜日と月の指定には、最初の 3 文字を使ってください (この場合、 大文字・小文字の区別はありません)。名前による領域指定やリスト指定はでき ません。 .Pp ``6 番目'' の欄 (行の残りの部分) には実行したいコマンドを指定します。行の 中のコマンド部全体、これは改行または % 文字までですが、は .Pa /bin/sh かまたはその cron ファイルの .Ev SHELL 変数で指定されたシェルによって実行されます。コマンド内のパーセント記号 (%) はバックスラッシュ (\\) でエスケープされない限り改行文字に変換され、そ の最初の % 以降の全てのデータはそのコマンドの標準入力となります。 .Pp 注: コマンド実行の日付は 2 つの欄 \(em 1 ヶ月中の日 および曜日 \(em で指定できます。両方の欄が領域限定されている (すなわち * でない ) 場合、コマンドは .Em どちらかの 欄が現在の時刻と一致するときに実行されます。たとえば .br ``30 4 1,15 * 5'' は各月の 1 日および 15 日に加えて全ての金曜日において、 午前 4:30 にコマンドを実行させます。 .Sh cron ファイルの例 .Bd -literal # /etc/passwd の設定に関係なく、コマンドの実行には /bin/sh を用いる SHELL=/bin/sh # これが誰の crontab であっても、全ての出力は `paul' にメールする MAILTO=paul # # 毎月 深夜 0時5分 に実行する 5 0 * * * $HOME/bin/daily.job >> $HOME/tmp/out 2>&1 # 毎月の最初の日の PM 2:15 に実行する -- 出力結果は paul にメールされる 15 14 1 * * $HOME/bin/monthly # ウィークディの PM 10 時に実行して Joe をうるさがらせる 0 22 * * 1-5 mail -s "It's 10pm" joe%Joe,%%Where are your kids?% 23 0-23/2 * * * echo "run 23 minutes after midn, 2am, 4am ..., everyday" 5 4 * * sun echo "run at 5 after 4 every sunday" .Ed .Sh 関連項目 .Xr crontab 1 , .Xr cron 8 .Sh 機能拡張項目 曜日を指定するとき、日 0 と日 7 は日曜日とみなされます。BSD お よび ATT はこれに同意しないようです。 .Pp リスト指定および領域指定は同じ欄内で指定できます。"1-3,7-9" は ATT や BSD cron では受け付けません -- "1-3" や "7,8,9" だけが許されます。 .Pp 領域指定は ``間隔指定'' を含むことができますので "1-9/2" は "1,3,5,7,9" と 同じことになります。 .Pp 月の名前や曜日の名前は、名前で指定できます。 .Pp 環境変数は crontab の中で指定できます。BSD や ATT では 子プロセスに渡さ れた環境変数は基本的に .Pa /etc/rc から渡された環境変数です。 .Pp crontab 所有者へメールされる (BSD はできません) コマンド出力結果は、 crontab 所有者以外の人へメールしたり (SysV はできません)、 この機能を停止して誰にもメールを送らなくできます (SysV はこれもできません) 。 .Sh 作者 .An Paul Vixie Aq paul@vix.com diff --git a/ja/man/man5/ctm.5 b/ja/man/man5/ctm.5 index 4b10fb421e..c3a02f9e1a 100644 --- a/ja/man/man5/ctm.5 +++ b/ja/man/man5/ctm.5 @@ -1,225 +1,225 @@ .\"---------------------------------------------------------------------------- .\""THE BEER-WARE LICENSE" (Revision 42): .\" wrote this file. As long as you retain this notice you .\"can do whatever you want with this stuff. If we meet some day, and you think .\"this stuff is worth it, you can buy me a beer in return. Joerg Wunsch .\"---------------------------------------------------------------------------- .\" .\" This manual page is partially obtained from Poul-Hennings CTM README .\" file. .\" .\" CTM and ctm(1) by .\" .\" %Id: ctm.5,v 1.3.2.2 1998/07/18 11:09:44 jkh Exp % .\" -.\" jpman $Id: ctm.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: ctm.5,v 1.3 1998/07/02 14:18:10 horikawa Stab % .\" .Dd March 25, 1995 .Os .Dt CTM 5 .Sh 名称 .Nm ctm .Nd source code mirror system .Sh 解説 .Nm は CTM デルタと呼ばれる特別のファイルフォーマットでデータを送ります。 CTM デルタは制御行とデータ塊を含みます。 各制御行は .Dq CTM という文字で始まり、CTM 文と制御データが続いて、文字 '\en' で終ります。 データ塊は常に先行する制御行に属して、その制御行の 最後のフィールドにはデータ塊のバイト数が入っています。 後に続く改行文字 '\en' が各データ塊に続き、この 改行は塊には含まれずバイト数にも数えられません。 CTM 文は以下の形式をとります。 .Bl -tag -width indent .It _BEGIN Ar version name number timestamp prefix これが CTM デルタファイル全体の始まりです。 .Ar version フィールドはプログラムのバージョンと一致しなければなりません .Pq 現在は 2.0 。 .Ar name は名前で .Ar number は CTM サービスの通し番号です。通し番号はファイル .Pa .ctm_status と照合され、そのデルタがすでに適用されていないかの確認に使われます。 .Ar timestamp はデルタ生成日時の年、月、日、時、分、秒を参考のために含みます .Po 文字 .Sq Z が続いて UTC のタイムスタンプであることを示します .Pc 。 .Ar prefix フィールドは現在実装されていません。 .It _END Ar md5 この文で CTM デルタは終了します。 .Ar md5 は全体のチェックサムで デルタ全体の MD5 チェックサムと照合されます。 デルタ全体とは ``_END'' に続く空白 (0x20) 文字までのことです。 .It \&FM Ar name uid gid mode md5 count ファイル .Ar name を作成します。元のファイルは uid として .Ar uid .Pq 数値、10進 を、 gid として .Ar gid .Pq 数値、10進 を、モードとして .Ar mode .Pq 数値、8進 を、そして MD5 チェックサムとして .Ar md5 を持ちます。 続く .Ar count バイトのデータが新しいファイルの内容です。 .It \&FS Ar name uid gid mode md5before md5after count ファイル .Ar name の内容を置き換えます。 元のファイルは新しい uid として .Ar uid .Pq 数値、10進 を、新しい gid として .Ar gid .Pq 数値、10進 を、新しいモードとして .Ar mode .Pq 数値、8進 を、古い MD5 チェックサムとして .Ar md5before を、そして新しい MD5 チェックサムとして .Ar md5after を持ちます。 続く .Ar count バイトのデータが新しいファイルの内容です。 ファイルを編集するためのコマンドがファイルサイズを超えてしまい 置き換えの方が効率的な場合に、ファイルの置き換えが使われます。 .It \&FN Ar name uid gid mode md5before md5after count ファイル .Ar name を編集します。引数は上にある通りですが、データ部分には .Xr diff 1 の -n スクリプトを含み該当ファイルに適用されます。 .It \&FR Ar name md5 ファイル .Ar name を削除します。 対象ファイルの MD5 チェックサムが .Ar md5 と一致しなければなりません。 .It \&AS Ar name uid gid mode 元のファイル .Ar name の所有者を .Ar uid に、グループを .Ar gid に、そして/またはモードを .Ar mode に変更します。 .It \&DM Ar name uid gid mode ディレクトリ .Ar name が作成されます。元々、ディレクトリの所有者は .Ar uid 、グループは .Ar gid 、そしてモードは .Ar mode でした。 .It \&DR name ディレクトリ .Ar name を削除します。 .El .Sh 使用例 以下の使用例では、長い行は表示できるように改行してあります .Pq バックスラッシュを付けてあります 。 .Bd -literal CTM_BEGIN 2.0 cvs-cur 485 19950324214652Z . CTMFR src/sys/gnu/i386/isa/scd.c,v 5225f13aa3c7e458f9dd0d4bb637b18d CTMFR src/sys/gnu/i386/isa/scdreg.h,v e5af42b8a06f2c8030b93a7d71afb223 CTMDM src/sys/gnu/i386/isa/Attic 0 552 775 CTMFS .ctm_status 545 552 664 d9ccd2a84a9dbb8db56ba85663adebf0 \\ e2a10c6f66428981782a0a18a789ee2e 12 cvs-cur 485 CTMFN CVSROOT/commitlogs/gnu 545 552 664 \\ 5d7bc3549140d860bd9641b5782c002d 7fb04ed84b48160c9b8eea84b4c0b6e3 394 a6936 21 ache 95/03/24 09:59:50 Modified: gnu/lib/libdialog kernel.c prgbox.c Log: [...] CTM_END 74ddd298d76215ae45a077a4b6a74e9c .Ed .Sh 関連項目 .Xr ctm 1 , .Xr ctm_rmail 1 , .Xr ed 1 . .Sh 歴史 最初の試用は .Fx 1.1.5 で行われて、多くのバグと手法が出されました。 CTM システムは .Fx 2.1 で公開されました。 .Sh 作者 CTM システムは .An Poul-Henning Kamp .Aq phk@FreeBSD.org によって設計、実装が行われました。 このマニュアルページは .An Joerg Wunsch .Aq joerg@FreeBSD.org が書きました。 diff --git a/ja/man/man5/cvs.5 b/ja/man/man5/cvs.5 index ebd17d5eed..9cf0c1a3d9 100644 --- a/ja/man/man5/cvs.5 +++ b/ja/man/man5/cvs.5 @@ -1,365 +1,365 @@ -.\" jpman $Id: cvs.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: cvs.5,v 1.2 1998/06/13 12:32:50 horikawa Chk % .\" WORD: concurrent version system: コンカレントバージョンシステム [cvs.1,cvs.5] .\" WORD: repository: (CVS の)リポジトリ [cvs.1,cvs.5] .\" WORD: commit: (通常の文中では)コミット [cvs.1,cvs.5] .\" WORD: check out: (通常の文中では)チェックアウト [cvs.1,cvs.5] .\" WORD: wrapper: ラッパ .\" WORD: newsgroup: ニュースグループ [limits.1,patch.1,init.8 のニュース] .\" WORD: history: (CVS の) ヒストリ [cvs.1,cvs.5] .\" WORD: template: テンプレート .TH cvs 5 "12 February 1992" .\" Full space in nroff; half space in troff .de SP .if n .sp .if t .sp .5 .. .SH NAME cvs \- コンカレントバージョンシステムのサポートファイル .SH 書式 .hy 0 .na .TP .B $CVSROOT/CVSROOT/commitinfo,v .TP .B $CVSROOT/CVSROOT/cvsignore,v .TP .B $CVSROOT/CVSROOT/cvswrappers,v .TP .B $CVSROOT/CVSROOT/editinfo,v .TP .B $CVSROOT/CVSROOT/history .TP .B $CVSROOT/CVSROOT/loginfo,v .TP .B $CVSROOT/CVSROOT/modules,v .TP .B $CVSROOT/CVSROOT/rcsinfo,v .TP .B $CVSROOT/CVSROOT/taginfo,v .ad b .hy 1 .SH 解説 .B cvs は、ソースディレクトリの階層的な集合を 管理するシステムです。 \fBcvs\fP を使う際のコマンドと手続きは .BR cvs ( 1 ) に記述されています。 .SP .B cvs は、リビジョン管理されたファイルのマスタコピーを含むディレクトリである \fIソースリポジトリ\fP を管理し、 ここから開発者の個人的な \fI作業ディレクトリ\fP へ特定のリビジョンの ファイルをコピーしたり、作業ディレクトリから修正を採り入れたりします。 ファイルの構造という点から見ると、各ソースリポジトリは \fB$CVSROOT\fP の直下のサブディレクトリになります。 .SP ここで示すファイルは補助的なファイルであり、 \fBcvs\fP を利用するにあたってなくてはならないものではありませんが、 \fBcvs\fP をより柔軟に操作することができるようになります。 .SP \fBcvs\fP により管理されているソースの集合に分かり易い 名前をつけるために、`\|modules\|' を利用できます。 `\|modules\|' が存在しなければ、開発者は \fBcvs\fP コマンドで ファイルを操作する際に完全なパス名 (絶対パスもしくは \fB$CVSROOT\fP からの相対パス) を指定しなければなりません。 .SP `\|\fBcvs commit\fP\|' が実行される際に常に実行されるプログラムを 定義するために、`\|commitinfo\|' ファイルを利用できます。 これらのプログラムは、修正、追加、削除されたファイルが本当に コミットされる準備ができているかどうかをチェックする「コミット前の」 チェックとして用いられます。 このチェックを、ソースリポジトリの一部 (もしくは全体) から 特定の人やグループを除外するために利用している人もいます。 また、変更されたファイルがそのサイトのコーディング規約に 沿っているかどうかを確かめるためにも利用されるでしょう。 .SP ファイルがリポジトリにチェックインされる時や、リポジトリから チェックアウトされる時に使われるラッパコマンドを .B cvs に登録するために、 `\|cvswrappers\|' ファイルを利用できます。 ラッパは CVS に入ってくる、もしくは CVS から出ていくファイルや ディレクトリを加工することができます。 使い方はいろいろありますが、一例としては、 ファイルがチェックインされる前に C ファイルを整形し、 リポジトリ内の全てのコードの見栄えを揃えるという用法があります。 .SP .BR commit 後に常に実行される、 リポジトリ内の変更に関するログエントリを書き込むプログラムを定義するために、 `\|loginfo\|' ファイルを利用できます。 これらのプログラムは、ファイルにログメッセージを追加したり、 電子メールを通じて開発者のグループにログメッセージを送ったり、 特定のニュースグループにログメッセージを投稿したりするために使われます。 .SP .BR tag 操作や .BR rtag 操作の後で実行されるプログラムを定義するために、 `\|taginfo\|' ファイルを利用できます。 これらのプログラムは、 新しいタグ名とそのタグを作成したプログラマ名の一覧ファイルに メッセージを追加したり、 開発者のグループにメールを送ったり、 特定のニュースグループにメッセージを投稿したりするために使われます。 .SP ログメッセージの書式を定義するために、 `\|rcsinfo\|' ファイルを利用できます。 .SP `\|\fBcvs commit\fP\|' のログエントリを編集・確認する際に実行する プログラムを定義するために、 `\|editinfo\|' ファイルを利用できます。 これは `\|rcsinfo\|' の書式指定と共に用いると非常に便利であり、 変更をコミットするユーザが、書式の適切な欄を埋めていることを チェックすることができます。 .SP \fBupdate\fP の時に無視するファイルのデフォルトの一覧を指定するために、 `\|cvsignore\|' ファイルを利用できます。 .SP リポジトリに影響を及ぼす \fBcvs\fP コマンドを記録するために、 `\|history\|' ファイルを利用できます。 このファイルを作成するとヒストリが記録されるようになります。 .SH 関連ファイル .TP .B modules `\|modules\|' ファイルは、あなたがソースコードの集合に付けた名前を記録します。 \fBcvs\fP を使って、正しい書式でファイルを `\|\fB$CVSROOT/CVSROOT/modules,v\fP\|' にチェックインすると、 \fBcvs\fP はこれらの定義を利用するようになります。 .SP `\|modules\|' ファイルは、モジュール定義以外にも、空行やコメント (`\|\fB#\fP\|' から始まる行) を含むことができます。 長い行は、行の最後の文字にバックスラッシュ (``\e'') を置くことで 次の行に続けることができます。 .SP \fIモジュール定義\fP は `\|modules\|' ファイルの単一行で、 2 つの書式があります。どちらにおいても \fImname\fP はモジュール名を 表し、行の残りはその定義になります。 .SP \fImname\fP \fB\-a\fP \fIaliases\fP\|.\|.\|. .br これはモジュール \fImname\fP を定義する最も簡単な方法です。 `\|\fB\-a\fP\|' はこの定義が単なる別名 (alias) であることを示します。 \fBcvs\fP は (コマンドの引数として) \fImname\fP が使われると、 代わりに \fIaliases\fP の名前のリストが指定されたものとして扱います。 \fIaliases\fP には、他のモジュール名もしくはパスを指定します。 \fIaliases\fP にパスを指定すると、 \fBcvs\fP の引数に明示的にパスが指定した場合と同様、 `\|\fBcvs checkout\fP\|' は 作業ディレクトリへの全ての中間ディレクトリを作成します。 .SP .nf \fImname\fP [ \fIoptions\fP ] \fIdir\fP [ \fIfiles\fP\|.\|.\|. ] [ \fB&\fP\fImodule\fP\|.\|.\|. ] .fi .SP もっとも単純な場合、この形式のモジュール定義は `\|\fImname dir\fP\|' となります。 これはディレクトリ \fIdir\fP 内のすべてのファイルをモジュール \fImname\fP として定義します。 \fIdir\fP は (\fB$CVSROOT\fP から、ソースリポジトリ内にある) ソースファイルのディレクトリへの相対パスです。 この場合、\fBcheckout\fP 時には作業ディレクトリとして \fImname\fP という単一のディレクトリのみが作成され、 \fIdir\fP が複数ディレクトリ階層を含むパスであろうと、 中間のディレクトリはデフォルトでは作成されません。 .SP モジュール定義の \fIdir\fP の後で \fIfiles\fP を明示的に指定することで、 \fIdir\fP 内の特定のファイルを選択することができます。 \fBmodules\fP にあるサンプル定義は、あるディレクトリの 単一のファイルから定義されるモジュールの例となっています。 ここでは別の例を示します: .SP .nf .ft B m4test unsupported/gnu/m4 foreach.m4 forloop.m4 .ft P .fi .SP この定義では、`\|\fBcvs checkout m4test\fP\|' を実行すると、 単一階層の作業ディレクトリ `\|m4test\|' が作成され、 \fBcvs\fP ソースリポジトリ内の深い階層のディレクトリにある、 指定された 2 つのファイルが置かれます。 .SP モジュール定義中に `\|\fB&\fP\fImodule\fP\|' と書くことによって、 他のモジュールを参照することができます。 \fBcheckout\fP 時には、作業ディレクトリ内に各 \fImodule\fP 毎の ディレクトリが作成されます。 .br .I \fBcvs\fP 1.3 の新機能; モジュール定義ファイルを古いバージョンの \fBcvs\fP と共有する場合は、 この機能は使わないでください。 .SP そして、モジュール定義に以下の \fIoptions\fP を加えることができます: .SP \&`\|\fB\-d\fP \fIname\fP\|', モジュール名ではなく、他の名前を 作業ディレクトリの名前として用います。 .br .I \fBcvs\fP 1.3 の新機能; モジュール定義ファイルを古いバージョンの \fBcvs\fP と共有する場合は、 この機能は使わないでください。 .SP \&`\|\fB\-i\fP \fIprog\fP\|' を用いると、モジュール内のファイルが コミットされたときに実行されるプログラム \fIprog\fP を指定できます。 \fIprog\fP は、ソースリポジトリ内の影響を受けるディレクトリへの フルパスを単一引数として受け取ります。 \fBコミット\fP 時にプログラムを実行するためには、 `\|commitinfo\|', `\|loginfo\|', `\|editinfo\|' ファイルを使う方法もあります。 .SP `\|\fB\-o\fP \fIprog\fP\|' を用いると、モジュール内のファイルが チェックアウトされたときに実行されるプログラム \fIprog\fP を指定できます。 \fIprog\fP は、モジュール名を単一引数として受け取ります。 .SP `\|\fB\-e\fP \fIprog\fP\|' を用いると、モジュール内のファイルが エクスポート (export) されたときに実行される プログラム \fIprog\fP を指定できます。 \fIprog\fP は、モジュール名を単一引数として受け取ります。 .SP `\|\fB\-t\fP \fIprog\fP\|' を用いると、モジュール内のファイルに タグが付けられたときに実行されるプログラム \fIprog\fP を指定できます。 \fIprog\fP は、 モジュール名と \fBrtag\fP で指定されたシンボリックタグの 2 つを 引数として受け取ります。 .SP `\|\fB\-u\fP \fIprog\fP\|' を用いると、チェックアウトされたモジュールの トップディレクトリにて `\|\fBcvs update\fP\|' が用いられたときに 実行されるプログラム \fIprog\fP を指定できます。 \fIprog\fP は、このモジュールのソースリポジトリへのフルパスを 単一引数として受け取ります。 .TP \&\fBcommitinfo\fP, \fBloginfo\fP, \fBrcsinfo\fP, \fBeditinfo\fP これらのファイルは全て、`\|\fBcvs commit\fP\|' 処理の間の 様々な場面で呼び出されるプログラムを指定します。 これらのファイルは共通の構造を持ちます。 各行は、次の 2 つのフィールドを持ちます: すなわち、 正規表現と、 空白の後にファイル名かコマンド行のテンプレートです。 正規表現の 1 つがリポジトリ内のディレクトリ名にマッチすると、 行の残りが使われます。 行が文字 \fB#\fP で始まっている場合、コメントとして無視されます。 フィールド間の空白も無視されます。 .SP `\|loginfo\|' では、行の残りは実行されるコマンド行の テンプレートとなります。 テンプレートはプログラム名だけでなく、 好きなだけ引数を付けることもできます。 引数リストのどこかに `\|\fB%s\fP\|' を指定すると、 \fBcvs\fP はその場所に \fBコミット\fP により影響を受ける ファイルリストを列挙します。 リストの最初のエントリは、 ソースリポジトリ内の変更が行われる位置への相対パスです。 リストの残りは、この \fBコミット\fP により修正・追加・削除される ファイルとなります。 .SP `\|taginfo\|' では、行の残りは実行されるコマンド行の テンプレートとなります。 コマンドに渡される引数は、順番に .I タグ名 、 .I 操作 (すなわち、 .B add は `tag' を、 .B mov は `tag -F' を、 .B del は `tag -d` をそれぞれ意味します)、 .I リポジトリ となり、残りは全て .B ファイル名 と .B リビジョン の組となります。 フィルタプログラムが 0 以外を返して終了すると、タグ処理は中断されます。 .SP `\|commitinfo\|' では、行の残りは実行されるコマンド行の テンプレートとなります。 テンプレートはプログラム名だけでなく、 好きなだけ引数を付けることもできます。 テンプレートには現在のソースリポジトリへのフルパスが付け加えられ、 コミットにより (追加・削除・修正など) 影響をおよぼされる ファイルのファイル名が続きます。 .SP `\|rcsinfo\|' では、行の残りはログメッセージ用のテンプレートへ 読み込まれるファイルへのフルパスです。 .SP `\|editinfo\|' では、行の残りは実行されるコマンド行の テンプレートとなります。 テンプレートはプログラム名だけでなく、 好きなだけ引数を付けることもできます。 現在のログメッセージ用のテンプレートファイルへのフルパスが 最後に追加されます。 .SP 正規表現の代わりに、以下の 2 つのうちどちらかの特殊文字列 を使うことができます: `\|\fBALL\fP\|' では常に実行されるべきコマンド行テンプレート を指定し、 `\|\fBDEFAULT\fP\|' ではどの正規表現にもマッチしなかったときに 用いられるコマンド行テンプレートを指定します。 .SP `\|commitinfo\|' ファイルには、 他の \fBコミット\fP 操作が行われる \fI前に\fP 実行されるコマンドを指定し、 \fBコミット\fP が行われる前に満たすべき状況をチェックするために 利用できます。 \fBコミット\fP 操作の残りは、このファイルで指定されたコマンド全てが 終了ステータス \fB0\fP で終了したときにのみ続行されます。 .SP `\|rcsinfo\|' ファイルにより、\fBコミット\fP のログ作成の際の \fIログ用テンプレート\fP を指定できます。 このテンプレートの書式を埋めていくだけで、\fBコミット\fP ログを 作成できるようになります。 このファイルでは、正規表現より後のフィールドはコマンドテンプレートではなく、 ログ用テンプレート書式ファイル (複数可) のファイル名となります。 .SP `\|editinfo\|' ファイルにより、\fIコミットが開始する前\fP で ログ情報が記録された後の段階で実行されるスクリプトを指定できます。 これらの「編集」スクリプトは、 ログファイルに記録された情報を確認することができます。 編集スクリプトが 0 以外の終了ステータスを返した場合、コミットは中断されます。 .SP `\|loginfo\|' ファイルにより、コミットの \fI最終段階\fP で実行される コマンドを指定できます。 コミットログメッセージとして指定されたテキストはコマンドにパイプされます: よくある用法としては、メールを送る、ニュースグループの記事とする、 中央ファイルに追加書き込みするというものがあります。 .TP \&\fBcvsignore\fP, \fB.cvsignore\fP `\|\fBcvs update\fP\|' 中に無視されるデフォルトのファイル (もしくは .BR sh ( 1 ) のファイル名パターン) のリストです。 まず最初に、\fBcvs\fP はコンパイル時に組み込まれたデフォルトの ファイル名パターンのリストを読み込みます ( .BR cvs ( 1 ) を参照)。 その後、\fB$CVSROOT/CVSROOT/cvsignore\fP ファイルが存在すれば、 その中のリポジトリ毎のリストを読み込みます。 そして、`\|$HOME/.cvsignore\|' にあるユーザ毎のリストを読み込みます。 最後に、\fBcvs\fP はディレクトリを辿る時に ディレクトリ中に `\|.cvsignore\|' ファイルがあれば、それを読み込みます。 これらのディレクトリ毎のファイルは、それを含むディレクトリにのみ 有効で、サブディレクトリには作用しません。 .TP .B history ヒストリを記録するには \fB$CVSROOT/CVSROOT\fP にこのファイルを作成します (詳細は `\|\fBcvs history\fP\|' の記述を参照)。 .SH 関連項目 .BR cvs ( 1 ), .SH 著作権 Copyright \(co 1992 Cygnus Support, Brian Berliner, and Jeff Polk .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/man/man5/devfs.5 b/ja/man/man5/devfs.5 index c740451f90..55e3799e6f 100644 --- a/ja/man/man5/devfs.5 +++ b/ja/man/man5/devfs.5 @@ -1,95 +1,95 @@ .\" Copyright (c) 1996 .\" Mike Pritchard . All rights reserved. .\" .\" 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: devfs.5,v 1.2.2.2 1998/07/19 06:52:11 jkh Exp % .\" -.\" jpman $Id: devfs.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: devfs.5,v 1.3 1998/04/29 11:36:05 kuma Stab % .\" .\" WORD: mount point マウントポイント .\" WORD: namespace 名前空間 .\" .Dd December 14, 1996 .Dt devfs 5 .Os FreeBSD 2.2 .Sh 名称 .Nm devfs .Nd デバイスファイルシステム .Sh 書式 devfs /devs devfs rw 0 0 .Sh 解説 デバイスファイルシステム、または .Nm devfs は、グローバルファイルシステム名前空間において、 カーネルのデバイス名前空間へのアクセスを提供します。 伝統的なマウントポイントは .Pa /devs です。 .Pp このファイルシステムは、ディレクトリ、リンク、シンボリックリンク、 デバイスを含みます。 それらの中には書き込み可能なものがあります。 chroot した環境では、 .Nm を使用して新しい .Pa /devs マウントポイントを作成可能です。 .Sh 関連ファイル .Bl -tag -width /devs/XXXX -compact .It Pa /devs 通常の .Nm マウントポイント .El .Sh 関連項目 .Xr mount_devfs 8 .Sh 歴史 .Nm ファイルシステムは、最初に .Fx 2.0 に登場しました。 .Nm マニュアルページは、最初に .Fx 2.2 に登場しました。 .Sh 作者 .Nm マニュアルページは、 .Xr mount_devfs 8 マニュアルページを元に、 .An Mike Pritchard Aq mpp@FreeBSD.org が記述しました。 diff --git a/ja/man/man5/dir.5 b/ja/man/man5/dir.5 index 98937888eb..5b3766a1c4 100644 --- a/ja/man/man5/dir.5 +++ b/ja/man/man5/dir.5 @@ -1,174 +1,174 @@ .\" 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. .\" .\" @(#)dir.5 8.3 (Berkeley) 4/19/94 -.\" jpman $Id: dir.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: dir.5,v 1.3 1998/07/19 22:22:07 yohta Stab % .\" %Id: dir.5,v 1.4.2.1 1997/02/28 03:27:22 mpp Exp % .\" .\" WORD: graft 接合 [mount.8] .Dd April 19, 1994 .Dt DIR 5 .Os BSD 4.2 .Sh 名称 .Nm dir , .Nm dirent .Nd ディレクトリファイルフォーマット .Sh 書式 .Fd #include .Fd #include .Sh 解説 ディレクトリは、土台となる記憶媒体の詳細を隠蔽し、 ファイルをグループ分けする便利な階層手段を提供します。 ディレクトリファイルは、その .Xr inode 5 エントリ中のフラグによって、通常ファイルと区別されます。 ディレクトリファイルはレコード (ディレクトリエントリ) から構成され、 各レコードはファイルに関する情報とそのファイル自身へのポインタを 含んでいます。 ディレクトリエントリは、通常ファイルと同様に、 他のディレクトリを含むこともあります。 そのような入れ子になったディレクトリはサブディレクトリと呼ばれます。 このようにしてディレクトリとファイルの階層構造が形成され、 この構造はファイルシステムと呼ばれます (あるいはファイルシステムツリー と呼ばれます)。 .\" 以下の3行は英語版にコメントの形で含まれていたもの .\" An entry in this tree, .\" nested or not nested, .\" is a pathname. .Pp 各ディレクトリファイルには特別なディレクトリエントリが 2 つあります。 1 つはそのディレクトリ自身へのポインタで、ドット .Ql \&. と呼ばれます。 もう 1 つは自分の親ディレクトリへのポインタで、ドットドット .Ql \&.. と呼ばれます。 ドットとドットドットは有効なパス名ですが、 システムのルートディレクトリ .Ql / には親ディレクトリがなく、ドットドットはドットと同じく自分自身を指します。 .Pp ファイルシステムノードは普通のディレクトリファイルであり、 その上に物理ディスクやそのディスク中の分割された領域といった ファイルシステムオブジェクトを接合します ( .Xr mount 2 および .Xr mount 8 参照)。 .Pp ディレクトリエントリの形式はファイル .Aq dirent.h で定義されています: .Bd -literal #ifndef _DIRENT_H_ #define _DIRENT_H_ /* * ディレクトリエントリはその先頭に dirent 構造体を持ちます。dirent * 構造体は inode 番号、そのエントリの長さ、そのエントリに含まれる * 名前の長さを保持します。その後に、ナルで 4 バイト境界までパディング * した名前が続きます。名前は全てナルで終端していることが保証されます。 * ディレクトリ中の名前の長さの最大値は MAXNAMLEN です。 */ struct dirent { u_long d_fileno; /* エントリのファイル番号 */ u_short d_reclen; /* このレコードの長さ */ u_char d_type; /* ファイルタイプ, 以下参照 */ u_char d_namlen; /* d_name の文字列長 */ #ifdef _POSIX_SOURCE char d_name[255 + 1]; /* 名前の長さの最大値 */ #else #define MAXNAMLEN 255 char d_name[MAXNAMLEN + 1]; /* 名前の長さの最大値 */ #endif }; /* * ファイルタイプ */ #define DT_UNKNOWN 0 #define DT_FIFO 1 #define DT_CHR 2 #define DT_DIR 4 #define DT_BLK 6 #define DT_REG 8 #define DT_LKN 10 #define DT_SOCK 12 #define DT_WHT 14 #ifdef _POSIX_SOURCE typedef void * DIR; #else #define d_ino d_fileno /* 下位互換性 */ /* ディレクトリ操作ライブラリルーチン用定義 */ #define DIRBLKSIZ 1024 /* オープンしたディレクトリを記述する構造体 */ typedef struct _dirdesc { int dd_fd; /* ディレクトリに対応するファイル記述子 */ long dd_loc; /* 現バッファ中のオフセット */ long dd_size; /* getdirentriesが返すデータ量 */ char *dd_buf; /* データバッファ */ int dd_len; /* データバッファのサイズ */ long dd_seek; /* getdirentriesが返すマジッククッキー */ long dd_rewind;/* 巻き戻し用マジッククッキー */ } DIR; #define dirfd(dirp) ((dirp)->dd_fd) #ifndef NULL #define NULL 0 #endif #endif /* _POSIX_SOURCE */ #ifndef KERNEL #include #endif /* !KERNEL */ #endif /* !_DIRENT_H_ */ .Ed .Sh 関連項目 .Xr fs 5 , .Xr inode 5 .Sh 歴史 ファイル形式 .Nm は .At v7 で登場しました。 diff --git a/ja/man/man5/disklabel.5 b/ja/man/man5/disklabel.5 index 4764c052c7..a5f8481d35 100644 --- a/ja/man/man5/disklabel.5 +++ b/ja/man/man5/disklabel.5 @@ -1,394 +1,394 @@ .\" Copyright (c) 1987, 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 acknowledgment: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" 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.5.5 8.1 (Berkeley) 6/5/93 .\" %Id: disklabel.5,v 1.2.2.2 1998/07/17 20:12:59 jkh Exp % .\" -.\" jpman $Id: disklabel.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: disklabel.5,v 1.3 1998/06/12 15:48:23 kumano Stab % .\" .\" WORD: initial bootstrap 初期ブートストラップ .\" WORD: initial label 初期ラベル .\" WORD: primary bootstrap 一次ブートストラップ .\" WORD: secondary bootstrap 二次ブートストラップ .\" WORD: ratio of physical sectors traversed per logical sector 論理セクタあたりの物理セクタ通過率 .\" .Dd June 5, 1993 .Dt DISKLABEL 5 .Os .Sh 名称 .Nm disklabel .Nd ディスクパックラベル .Sh 書式 .Fd #include .Sh 解説 システム上のそれぞれのディスクやディスクパックは、ディスクのジオメトリ やディスクを分割しているパーティションについての詳細な情報を提供する ディスクラベルを持っています。 ディスクラベルはディスクがフォーマットされたときに 初期化されなければならず、 後から .Xr disklabel 8 プログラムによって変更することができます。 システムディクスドライバやブートストラッププログラムがこの情報を使って、 ドライブのプログラム方法や、ディスクパーティション上の ファイルシステムの見つけ方を決定します。 ファイルシステムは、付加的な情報を使ってディスクを最も効果的に使い、 重要なファイルシステム情報の位置を特定します。 各パーティションの記述は、パーティションタイプ(標準ファイル、スワップ 領域等)の識別子を含みます。 ラベルのメモリ内コピーにあるファイルシステム情報が不完全な場合には、 ファイルシステムはそれを更新します。 .Pp ラベルは、ドライブのセクタ番号 .Dv LABELSECTOR にあります。 通常は、ディスクジオメトリについての情報がなくても見つけられる、 セクタ 0 にあります。 ラベルは、初期ブートストラップの場所を確保するために、 セクタの先頭からオフセット .Dv LABELOFFSET にあります。 ラベルを含むディスクセクタは、通常読み込み専用になっています。 これは、 パックからパックへの複写やスワップ操作時に .Xr disklabel 8 プログラムによって必要に応じて行なわれる .Dv DIOCWLABEL .Xr ioctl 2 により不用意に上書きされないようにするためです。 .Pp ディスクのメモリ内ラベルコピーは .Dv DIOCGDINFO .Xr ioctl 2 で得られます。 この操作は、ディスクの任意のパーティションに対するブロックデバイスや キャラクタ (``raw'') デバイスへのファイル記述子に対して 行うことができます。 また、ディスクのメモリ内ラベルコピーは .Dv DIOCSDINFO .Xr ioctl 2 によりセットされます。 パーティションのオフセットは、一般にパーティションがオープンされている ときには変更したり小さくしたりはできません。 ただし例外として、ディスクにラベルが見つからず、ドライバが パーティション情報を含まない骨組みのラベルだけを構築できるときには、 どんな変更も許されます。 最後に、 .Dv DIOCWDINFO .Xr ioctl 2 操作がメモリ内のラベルをセットし、ディスク上のラベルを更新します。 この操作が成功するためにはディスク上にラベルが存在しなければなりません。 つまり、ディスクやディスクパックの初期ラベルは生の (raw) ディスクに 対して書き込むことでインストールされなければなりません。 これらの操作はすべて、普通 .Xr disklabel 8 コマンドを使って行なわれます。 .Pp .Pa で指定されるようにディスクラベルのフォーマットは以下のようになります。 .Bd -literal /* * ディスク記述テーブル, disktab(5) を参照 */ #define DISKTAB "/etc/disktab" /* * 各ディスクはハードウェアディスクジオメトリ、ファイルシステムパーティション、 * ドライブ固有の情報についての情報を含むラベルを持っています。 * ラベルはブロック 0 か 1 、つまりブートストラップ等のための場所を空けて * なるべく先頭のオフセットにあります。 */ #ifndef LABELSECTOR #define LABELSECTOR 0 /* ラベルを含むセクタ */ #endif #ifndef LABELOFFSET #define LABELOFFSET 64 /* セクタ内のラベルのオフセット */ #endif #define DISKMAGIC ((u_long) 0x82564557) /* ディスクのマジックナンバ */ #ifndef MAXPARTITIONS #define MAXPARTITIONS 8 #endif #ifndef LOCORE struct disklabel { u_long d_magic; /* マジックナンバ */ short d_type; /* ドライブタイプ */ short d_subtype; /* コントローラ/d_type に固有 */ char d_typename[16]; /* タイプ名、たとえば "eagle" */ /* * d_packname は、パック識別子を含み、ディスク上やメモリ内コピーの * ディスクラベルを読んだときに返されます。 * d_boot0 と d_boot1 は、/usr/mdec にある一次 (block 0) または * 二次 (block 1-15) ブートストラップの (省略可能な) 名前です。 * この名は、/etc/disktab から値を取り出すために getdiskbyname(3) * を使う場合に返されます。 */ #if defined(KERNEL) || defined(STANDALONE) char d_packname[16]; /* パック識別子 */ #else union { char un_d_packname[16]; /* パック識別子 */ struct { char *un_d_boot0; /* 一次ブートストラップ名 */ char *un_d_boot1; /* 二次ブートストラップ名 */ } un_b; } d_un; #define d_packname d_un.un_d_packname #define d_boot0 d_un.un_b.un_d_boot0 #define d_boot1 d_un.un_b.un_d_boot1 #endif /* ! KERNEL or STANDALONE */ /* ディスクジオメトリ */ u_long d_secsize; /* セクタあたりのバイト数 */ u_long d_nsectors; /* トラックあたりのデータセクタ数 */ u_long d_ntracks; /* シリンダあたりのトラック数 */ u_long d_ncylinders; /* ユニットあたりのデータシリンダ数 */ u_long d_secpercyl; /* シリンダあたりのデータセクタ数 */ u_long d_secperunit; /* ユニットあたりのデータセクタ数 */ /* * 以下の予備 (不良セクタ置換) は in d_nsectors や d_secpercyl * には数えられません。 * 予備セクタは、各トラックまたはシリンダの末尾の場所を占める * 物理セクタにあることにします。 */ u_short d_sparespertrack; /* トラックあたりの予備セクタ */ u_short d_sparespercyl; /* シリンダあたりの予備セクタ */ /* * メインテナンス、置換、コンフィグレーション記述領域等を * 含む交替シリンダ */ u_long d_acylinders; /* ユニットあたりの交替シリンダ */ /* ハードウェア特性 */ /* * d_interleave, d_trackskew, d_cylskew は、遅いコントローラの * 埋め合わせに使うための、メディアフォーマット中の * ぶれを記述します。 * interleave は、フォーマット時にフォーマッタやコントローラに * よって設定される物理セクタインタリーブです。 * インタリーブが使われているとき、論理的に隣り合ったセクタは * 物理的には連続ではなく、幾つかのセクタに分断されています。 * これは論理セクタあたりの物理セクタ通過率として指定されます。 * すなわち、1:1 のインタリーブは連続したレイアウトを意味し、 * 2:1 は論理セクタ 0 が論理セクタ 1 から 1 セクタ離れていること * を意味します。 * d_trackskew は、同一シリンダ上でトラック N-1 上のセクタ 0 から * トラック N のセクタ 0 の相対的なオフセットです。 * 最後の d_cylskew は、シリンダ N-1 上のセクタ 0 からシリンダ N * 上のセクタ 0 の相対的なオフセットです。 */ u_short d_rpm; /* 回転スピード */ u_short d_interleave; /* ハードウェアセクタインタリーブ */ u_short d_trackskew; /* トラックあたりのセクタ 0 スキュー */ u_short d_cylskew; /* シリンダあたりのセクタ 0 スキュー */ u_long d_headswitch; /* ハードスイッチ時間 usec */ u_long d_trkseek; /* トラック間シーク usec */ u_long d_flags; /* 一般フラグ */ #define NDDATA 5 u_long d_drivedata[NDDATA]; /* ドライブの型固有の情報 */ #define NSPARE 5 u_long d_spare[NSPARE]; /* 将来使うための予備 */ u_long d_magic2; /* マジックナンバ (再度) */ u_short d_checksum; /* データを含むパーティションの xor */ /* ファイルシステムとパーティション情報 */ u_short d_npartitions; /* 後に続くパーティション数 */ u_long d_bbsize; /* sn0 のブート領域の大きさ(バイト単位) */ u_long d_sbsize; /* fs スーパブロックの最大サイズ(バイト単位) */ struct partition { /* パーティションテーブル */ u_long p_size; /* パーティション内のセクタ数 */ u_long p_offset; /* 開始セクタ */ u_long p_fsize; /* ファイルシステム規定フラグメントサイズ */ u_char p_fstype; /* ファイルシステムタイプ、下記参照 */ u_char p_frag; /* ブロックあたりのファイルシステムフラグメント */ union { u_short cpg; /* UFS: FS グループあたりのシリンダ数 */ u_short sgs; /* LFS: FS セグメントシフト */ } __partition_u1; #define p_cpg __partition_u1.cpg #define p_sgs __partition_u1.sgs u_short p_cpg; /* グループあたりのファイルシステムシリンダ数 */ } d_partitions[MAXPARTITIONS]; /* 実際にはもっとある */ }; /* d_type values: */ #define DTYPE_SMD 1 /* SMD, XSMD; VAX hp/up */ #define DTYPE_MSCP 2 /* MSCP */ #define DTYPE_DEC 3 /* その他の DEC (rk, rl) */ #define DTYPE_SCSI 4 /* SCSI */ #define DTYPE_ESDI 5 /* ESDI インタフェース */ #define DTYPE_ST506 6 /* ST506 他 */ #define DTYPE_HPIB 7 /* CS/80 on HP-IB */ #define DTYPE_HPFL 8 /* HP ファイバリンク */ #define DTYPE_FLOPPY 10 /* フロッピー */ #ifdef DKTYPENAMES static char *dktypenames[] = { "unknown", "SMD", "MSCP", "old DEC", "SCSI", "ESDI", "ST506", "HP-IB", "HP-FL", "type 9", "floppy", 0 }; #define DKMAXTYPES (sizeof(dktypenames) / sizeof(dktypenames[0]) - 1) #endif /* * ファイルシステムタイプとバージョン * パーティションあたりの他のファイルシステム固有情報に使われます。 */ #define FS_UNUSED 0 /* 未使用 */ #define FS_SWAP 1 /* スワップ */ #define FS_V6 2 /* 第 6 版 */ #define FS_V7 3 /* 第 7 版 */ #define FS_SYSV 4 /* System V */ #define FS_V71K 5 /* 7 版 1K ブロック (4.1, 2.9) */ #define FS_V8 6 /* 8 版 4K ブロック */ #define FS_BSDFFS 7 /* 4.2BSD fast ファイルシステム */ #define FS_MSDOS 8 /* MSDOS ファイルシステム */ #define FS_BSDLFS 9 /* 4.4BSD log-structured ファイルシステム */ #define FS_OTHER 10 /* 使用中だが未知/未サポート */ #define FS_HPFS 11 /* OS/2 high-performance ファイルシステム */ #define FS_ISO9660 12 /* ISO 9660, 通常は CD-ROM */ #define FS_BOOT 13 /* ブートストラップを含むパーティション */ #ifdef DKTYPENAMES static char *fstypenames[] = { "unused", "swap", "Version 6", "Version 7", "System V", "4.1BSD", "Eighth Edition", "4.2BSD", "MSDOS", "4.4LFS", "unknown", "HPFS", "ISO9660", "boot", 0 }; #define FSMAXTYPES (sizeof(fstypenames) / sizeof(fstypenames[0]) - 1) #endif /* * 多様なドライブが共有するフラグ */ #define D_REMOVABLE 0x01 /* リムーバブルメディア */ #define D_ECC 0x02 /* ECC サポート */ #define D_BADSECT 0x04 /* バッドセクタフォワードのサポート */ #define D_RAMDISK 0x08 /* ディスクエミュレータ */ #define D_CHAIN 0x10 /* back-back 転送ができる */ /* * SMD のドライブデータ */ #define d_smdflags d_drivedata[0] #define D_SSE 0x1 /* セクタスキップのサポート */ #define d_mindist d_drivedata[1] #define d_maxdist d_drivedata[2] #define d_sdist d_drivedata[3] /* * ST506 のドライブデータ */ #define d_precompcyl d_drivedata[0] #define d_gap3 d_drivedata[1] /* フォーマット時にのみ使われる */ /* * SCSI のドライブデータ */ #define d_blind d_drivedata[0] #ifndef LOCORE /* * フォーマットや生の操作をする際に使われる * 構造体で、データやレジスタ値を返します。 * レジスタの識別とフォーマットは、 * デバイス依存、ドライバ依存です。 */ struct format_op { char *df_buf; int df_count; /* 値-結果 */ daddr_t df_startblk; int df_reg[8]; /* 結果 */ }; /* * ディスク上のパーティションに関する情報を * 引き出すために内部で使われる構造体 */ struct partinfo { struct disklabel *disklab; struct partition *part; }; /* * ディスク固有の ioctl */ /* ディスクラベルの取得と設定; 内部では DIOCGPART が使われる */ #define DIOCGDINFO _IOR('d', 101, struct disklabel) /* 取得 */ #define DIOCSDINFO _IOW('d', 102, struct disklabel) /* 設定 */ #define DIOCWDINFO _IOW('d', 103, struct disklabel) /* 設定、ディスク更新 */ #define DIOCGPART _IOW('d', 104, struct partinfo) /* パーティション取得 */ /* do format operation, read or write */ #define DIOCRFORMAT _IOWR('d', 105, struct format_op) #define DIOCWFORMAT _IOWR('d', 106, struct format_op) #define DIOCSSTEP _IOW('d', 107, int) /* ステップレート設定 */ #define DIOCSRETRIES _IOW('d', 108, int) /* リトライ回数の設定 */ #define DIOCWLABEL _IOW('d', 109, int) /* 書き込み可/不可のラベル */ #define DIOCSBAD _IOW('d', 110, struct dkbad) /* カーネル dkbad の設定 */ #endif LOCORE .Ed .Sh 関連項目 .Xr disktab 5 , .Xr disklabel 8 diff --git a/ja/man/man5/disktab.5 b/ja/man/man5/disktab.5 index 93726046f0..60cb458ab0 100644 --- a/ja/man/man5/disktab.5 +++ b/ja/man/man5/disktab.5 @@ -1,140 +1,140 @@ .\" 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. .\" .\" @(#)disktab.5 8.1 (Berkeley) 6/5/93 -.\" jpman $Id: disktab.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: disktab.5,v 1.3 1998/06/12 15:50:37 kumano Stab % .\" %Id: disktab.5,v 1.1.1.1.8.2 1997/03/07 04:18:02 mpp Exp % .\" .Dd June 5, 1993 .Dt DISKTAB 5 .Os BSD 4.2 .Sh 名称 .Nm disktab .Nd ディスク記述ファイル .Sh 書式 .Fd #include .Sh 解説 .Nm disktab は、ディスクジオメトリとディスクパーティション特性を記述する 簡単なデータベースで、 .\"by the formatter(\c .\"IR.Xr format 8 ) .\"to determine how to format the disk, and ディスク上のディスクラベルを初期化する際に使われます。 フォーマットは .Xr termcap 5 端末データベースと同様のパターンです。 .Nm disktab 内のエントリは、たくさんの `:' で区切られたフィールドからなります。 各ディスクの最初のエントリは `|' 文字で区切られていて、そのディスクの 既知の名前を与えます。最後の名前はディスクをディスクを識別する完全に 長い名前でなければなりません。 .Pp 以下のリストは、各ディスクエントリのための通常の値です。 .Bl -column "indent" "boolx" .It Sy 名前 型 解説 .It "\&ty str ディスクの種類 (例えば removable, winchester)" .It "\&dt str コントローラの種類 (例えば " .Tn SMD , ESDI , フロッピー) .It "\&ns num トラックあたりのセクタ数" .It "\&nt num シリンダあたりのトラック数" .It "\&nc num ディスク上の総シリンダ数" .It "\&sc num シリンダあたりのセクタ数、デフォルトは nc*nt" .It "\&su num ユニットあたりのセクタ数、デフォルトは sc*nc" .It "\&se num バイト単位のセクタサイズ" デフォルトは .Dv DEV_BSIZE .It "\&sf bool コントローラが bad144 スタイルのバッドセクタフォワードをサポートする" .It "\&rm num 回転スピード (rpm), デフォルトは 3600" .It "\&sk num トラックあたりのセクタスキュー、デフォルトは 0" .It "\&cs num シリンダあたりのセクタスキュー、デフォルトは 0" .It "\&hs num ヘッドスイッチ時間 (usec), デフォルトは 0" .It "\&ts num 1 シリンダシーク時間 (usec), デフォルト 0" .It "\&il num セクタインタリーブ (n:1), デフォルトは 1" .It "\&d[0-4] num ドライブタイプ依存パラメータ" .It "\&bs num ブートブロックサイズ、デフォルト" .Dv BBSIZE .It "\&sb num スーパブロックサイズ、デフォルト" .Dv SBSIZE .It "\&ba num パーティション `a' のブロックサイズ (bytes)" .It "\&bd num パーティション `d' のブロックサイズ (bytes)" .It "\&be num パーティション `e' のブロックサイズ (bytes)" .It "\&bf num パーティション `f' のブロックサイズ (bytes)" .It "\&bg num パーティション `g' のブロックサイズ (bytes)" .It "\&bh num パーティション `h' のブロックサイズ (bytes)" .It "\&fa num パーティション `a' のフラグメントサイズ (bytes)" .It "\&fd num パーティション `d' のフラグメントサイズ (bytes)" .It "\&fe num パーティション `e' のフラグメントサイズ (bytes)" .It "\&ff num パーティション `f' のフラグメントサイズ (bytes)" .It "\&fg num パーティション `g' のフラグメントサイズ (bytes)" .It "\&fh num パーティション `h' のフラグメントサイズ (bytes)" .It "\&oa num パーティション `a' のセクタ内オフセット" .It "\&ob num パーティション `b' のセクタ内オフセット" .It "\&oc num パーティション `c' のセクタ内オフセット" .It "\&od num パーティション `d' のセクタ内オフセット" .It "\&oe num パーティション `e' のセクタ内オフセット" .It "\&of num パーティション `f' のセクタ内オフセット" .It "\&og num パーティション `g' のセクタ内オフセット" .It "\&oh num パーティション `h' のセクタ内オフセット" .It "\&pa num パーティション `a' セクタサイズ" .It "\&pb num パーティション `b' セクタサイズ" .It "\&pc num パーティション `c' セクタサイズ" .It "\&pd num パーティション `d' セクタサイズ" .It "\&pe num パーティション `e' セクタサイズ" .It "\&pf num パーティション `f' セクタサイズ" .It "\&pg num パーティション `g' セクタサイズ" .It "\&ph num パーティション `h' セクタサイズ" .It "\&ta str パーティション `a' のパーティションタイプ" .Pf ( Bx 4.2 ファイルシステム, スワップ他) .It "\&tb str パーティション `b のパーティションタイプ" .It "\&tc str パーティション `c のパーティションタイプ" .It "\&td str パーティション `d のパーティションタイプ" .It "\&te str パーティション `e のパーティションタイプ" .It "\&tf str パーティション `f のパーティションタイプ" .It "\&tg str パーティション `g のパーティションタイプ" .It "\&th str パーティション `h のパーティションタイプ" .El .Sh 関連ファイル .Bl -tag -width /etc/disktab -compact .It Pa /etc/disktab .El .Sh 関連項目 .Xr getdiskbyname 3 , .Xr disklabel 5 , .Xr disklabel 8 , .Xr newfs 8 .Sh 歴史 .Nm この記述ファイルは .Bx 4.2 から登場しました。 diff --git a/ja/man/man5/dm.conf.5 b/ja/man/man5/dm.conf.5 index 96c4757def..3a5f2219cc 100644 --- a/ja/man/man5/dm.conf.5 +++ b/ja/man/man5/dm.conf.5 @@ -1,106 +1,106 @@ .\" 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. .\" .\" WORD: configuration file 設定ファイル .\" WORD: day of the week 曜日 .\" .\" @(#)dm.conf.5 8.1 (Berkeley) 5/31/93 -.\" jpman $Id: dm.conf.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: dm.conf.5,v 1.3 1998/07/30 15:23:17 horikawa Stab % .\" .Dd May 31, 1993 .Dt DM.CONF 5 .Os BSD 4.2 .Sh 名称 .Nm dm.conf .Nd \&dm 設定ファイル .Sh 解説 .Xr dm.conf ファイルは .Xr \&dm 8 プログラムの設定ファイルです。 このファイルは ``badtty'', ``game'', ``time'' の 3 個のキーワードの どれか1つから始まる行で構成されます。その他の行は全て無視されます。 .Pp キーワード ``badtty'' の後にリストされた全ての tty 上では、 ゲームで遊ぶことができません。 エントリは空白文字で区切られた2個のフィールドからなります。 その 2 つは文字列 ``badtty'' と .Xr ttyname 3 の戻り値となる tty 名です。 例えば、uucp ダイアルアウト用の ``tty19'' を、ゲームに 用いられないようにするためには、以下のようにします。 .Bd -literal -offset indent badtty /dev/tty19 .Ed .Pp キーワード ``time'' の後に、日付/時間の組合せをリストすると、その時間帯は ゲームがすべて禁止されます。 このエントリは空白文字で区切られた 4 個のフィールドからなります。 その 4 つは文字列 ``time'' と省略なしの曜日、ゲームをしてはいけない時間帯 の始まりと終わりを示します。 時間のフィールドは 0 時から始まる 24 時間制で表します。 例えば、以下のエントリは、月曜日には午前 8 時以前と午後 5 時以降のみに ゲームで遊ぶことを許可するものです。 .Bd -literal -offset indent time Monday 8 17 .Ed .Pp キーワード ``game'' の後に何らかのゲームをリストすると、 特定のゲームのためにパラメータをセットします。 このエントリは空白文字で区切られた 5 個のフィールドからなります。 その 5 つはキーワード ``game''、ゲームの名前、ゲームで遊ぶことが許される ロードアベレージの最大値、ケームで遊ぶことが許されるときの最大ユーザ数、 ゲームが実行されるときの優先度です。 これらのフィールドはすべて、数字以外の文字で始めることができ、 その場合はそのフィールドに基づいたゲームの制限や優先度が課せられない 結果になります。 ゲーム "default" は他のどこにもリストされていないゲーム全ての設定を 制御するもので、ファイル内の最後の ``game'' エントリである必要があります。 優先度は負の値にすることはできません。 例えば以下のエントリは、ゲーム ``hack'' に対しては、 システムのユーザが 10 人以下でロードアベレージが 5 以下であるときのみ許可し、 その他の全てのゲームにはシステムのユーザが 15 人以下であるとき常に許可する 制限を課します。 .Bd -literal -offset indent game hack 5 10 * game default * 15 * .Ed .Sh 関連ファイル .Bl -tag -width /etc/dm.conf -compact .It Pa /etc/dm.conf .Xr \&dm 8 設定ファイル .El .Sh 関連項目 .Xr setpriority 2 , .Xr ttyname 3 , .Xr dm 8 diff --git a/ja/man/man5/editrc.5 b/ja/man/man5/editrc.5 index 28d78ed63b..759c42cd25 100644 --- a/ja/man/man5/editrc.5 +++ b/ja/man/man5/editrc.5 @@ -1,300 +1,300 @@ .\" %NetBSD: editrc.5,v 1.4 1997/04/24 20:20:31 christos Exp % .\" .\" Copyright (c) 1997 The NetBSD Foundation, Inc. .\" All rights reserved. .\" .\" This file was contributed to The NetBSD Foundation by Luke Mewburn. .\" .\" 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 NetBSD .\" Foundation, Inc. and its contributors. .\" 4. Neither the name of The NetBSD Foundation 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 NETBSD FOUNDATION, INC. 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: editrc.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: editrc.5,v 1.3 1998/07/02 18:50:17 kumano Stab % .Dd January 11, 1997 .Os BSD 4.4 .Dt EDITRC 5 .Sh 名称 .Nm editrc .Nd editline ライブラリの設定ファイル .Sh 書式 .Nm .Sh 解説 .Nm は .Xr editline 3 ライブラリで使用されている様々な設定を定義します。 .Pp それぞれの行のフォーマットは、 .Dl prog:command [arg [...]] または .Dl command [arg [...]] のどちらかです。 .Pp .Ar command は .Xr editline 3 の組み込みコマンドのうちの 1 つです。 より詳しい情報は .Sx 組み込みコマンド を参照してください。 .Pp .Ar prog はプログラムが .Xr editline 3 をセットアップするために .Xr el_init 3 を呼び出す時に定義したプログラム名の文字列で、 通常は .Va argv[0] です。 .Ar command は .Ar prog にマッチする全てのプログラムに対しても実行されます。 .Pp .Ar prog は .Xr regex 3 形式の正規表現であってもよく、その場合 .Ar command はその正規表現にマッチする全てのプログラムに対して実行されます。 .Sh 組み込みコマンド .Nm editline ライブラリはいくつかの組み込みコマンドがあり、行編集とヒストリ機能操作の 方法に作用します。 これらは .Xr tcsh 1 シェルに存在する似た名前の組み込みコマンドに基づいています。 .Pp 以下の組み込みコマンドが利用可能です。 .Bl -tag -width 4n .It Ic bind Xo .Op Fl a .Op Fl e .Op Fl k .Op Fl l .Op Fl r .Op Fl s .Op Fl v .Op Ar key Op Ar command .Xc オプション無しでは、全ての割り当てられたキーと、 それぞれが割り当てられた編集コマンドを表示します。 もし .Ar key が与えられたら、 .Ar key に対する割り当てを示します。 もし .Ar key command が与えられたら、 .Ar command を .Ar key に割り当てます。 含まれるオプションは、 .Bl -tag -width 4n .It Fl e 全てのキーを GNU Emacs の標準に似た割り当てに割り当てます。 .It Fl v 全てのキーを .Xr vi 1 の標準に似た割り当てに割り当てます。 .It Fl a .Xr vi 1 モードのもう 1 つ (コマンドモード) のキーマップにおける キー割り当てを表示または変更します。 .It Fl k .Ar key は矢印記号キー名、 .Sq up , .Sq down , .Sq left または .Sq right のうちの 1 つ、として解釈されます。 .It Fl l 全ての編集コマンドとそれぞれの短い説明を表示します。 .It Fl r キーの割り当てを削除します。 .It Fl s .Ar command は文字列リテラルとして扱われ、 .Ar key がタイプされた時に端末入力として扱われます。 .Ar command 中の割り当てられたキーは、それ自身が再解釈され、 これは 10 レベルの解釈まで継続されます。 .El .Pp .Ar key と .Ar command は .Sm off .Sq No ^ Ar character .Sm on .Po 例えば .Sq ^A .Pc 形式のコントロール文字と、 以下のバックスラッシュ付きのエスケープシーケンスを含むことができます。 .Pp .Bl -tag -compact -offset indent -width 4n .It Ic \ea ベル .It Ic \eb バックスペース .It Ic \ee エスケープ .It Ic \ef フォームフィード .It Ic \en 改行 .It Ic \er キャリッジリターン .It Ic \et (水平) タブ .It Ic \ev 垂直タブ .Sm off .It Sy \e Ar nnn .Sm on 8 進数 .Ar nnn で表される ASCII 文字 .El .Pp .Sq \e は、次の文字に特別な意味があるならば、それを無効化します。 特に、 .Sq \e と .Sq ^ の特別な意味を無効化します。 .It Ic echotc Xo .Op Fl sv .Ar arg .Ar ... .Xc .Ar arg Ar ... で与えられた端末能力を実行します。 もし .Ar arg が .Sq baud , .Sq cols , .Sq lines , .Sq rows , .Sq meta , .Sq tabs であればその能力の値が表示されます。 .Dq yes または .Dq no は、端末がその能力を持つのか持たないのかを表します。 .Pp .Fl s を指定すると存在しない能力に対してエラーを起こすのではなく、 空の文字列を返します。 .Fl v を指定するとメッセージを冗長に表示します。 .It Ic history ヒストリを表示します。 .It Ic telltc 全ての端末能力の値を表示します。 .Pf ( Xr termcap 5 参照)。 .It Ic settc Ar cap Ar val .Xr termcap 5 で定義された端末能力 .Ar cap を .Ar val に設定します。 正しさのチェックは行なわれません。 .It Ic setty Xo .Op Fl a .Op Fl d .Op Fl q .Op Fl x .Op Ar +mode .Op Ar -mode .Op Ar mode .Xc .Nm がどの tty モードの変更をユーザに許可しないかを制御します。 .Fl d , .Fl q , .Fl x は .Ic setty に対してそれぞれ .Sq edit , .Sq quote , .Sq execute tty モードセットにおいて働くことを示します。 デフォルトでは .Fl x です。 .Pp 他の引数がなければ、 .Ic setty は選択されたセットにおいて何が on .Po .Sq +mode .Pc または off .Po .Sq -mode .Pc に固定されているかを表示します。 .Fl a は設定に関わらず選択されたセットにおける全ての tty モードを表示します。 .Ar +mode , .Ar -mode , .Ar mode , は選択されたセットにおいて .Ar mode を on または off に固定すること、あるいは .Ar mode の制御を行なわないことを指定します。 .El .Sh 関連項目 .Xr editline 3 , .Xr regex 3 , .Xr termcap 5 .Sh 作者 .Nm editline ライブラリは .An Christos Zoulas によって書かれ、このマニュアルは いくつかの節は .Xr tcsh 1 に影響されて、 .An Luke Mewburn によって書かれました。 diff --git a/ja/man/man5/ethers.5 b/ja/man/man5/ethers.5 index 9334cbc2f8..53fde9ab51 100644 --- a/ja/man/man5/ethers.5 +++ b/ja/man/man5/ethers.5 @@ -1,101 +1,101 @@ .\" Copyright (c) 1995 .\" Bill Paul . 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 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: ethers.5,v 1.2.2.2 1998/01/07 00:55:01 steve Exp % -.\" jpman $Id: ethers.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: ethers.5,v 1.3 1998/04/29 11:33:25 kuma Stab % .\" .\" WORD: Internetworking インターネット .\" WORD: fully-qualified-host-name 完全な形でのホスト名 .\" .Dd April 12, 1995 .Dt ETHERS 5 .Os FreeBSD 2.1 .Sh 名称 .Nm ethers .Nd イーサネットアドレスのデータベース .Sh 解説 .Nm ethers データベースは、 インターネット上のホストの既知の 48 ビットイーサネットアドレスを格納します。 データは .Pa /etc/ethers と呼ばれるファイルに次のフォーマットで格納されます: .Bd -unfilled -offset indent .Pa イーサネットアドレス 完全な形でのホスト名 .Ed .Pp 項目は任意個の空白文字やタブ文字で区切ります。 行頭の ``#'' は行末まで続くコメントの開始を表します。 行頭に ``+'' があると、 .Xr ethers 3 ライブラリ関数は、 .Pa /etc/ethers ファイルのデータだけでなく、 .Xr NIS 4 の .Pa ethers.byname と .Pa ethers.byaddr のマップのデータも使用します。 .Pp イーサネットアドレスは .Tn ASCII 形式で "x:x:x:x:x:x" と表記されます。ここで、 .Ar x は 0x00 から 0xFF までの 16 進数です。 アドレス値はネットワークオーダである必要があります。 .Pa /etc/ethers データベースで指定するホスト名は、 .Xr hosts 5 ファイルのエントリに対応する必要があります。 .Pp 標準 C ライブラリの .Fn ether_line 関数を使用して、 .Pa /etc/ethers データベースの各行を、個々のコンポーネントに分割可能です: バイナリのイーサネットアドレスは .Pa ether_addr 構造として、ホスト名は文字列として格納されます。 .Sh 関連ファイル .Bl -tag -width /etc/services -compact .It Pa /etc/ethers .Nm ethers ファイルは .Pa /etc にあります。 .El .Sh 関連項目 .Xr ethers 3 , .Xr yp 4 .Sh 歴史 .Nm ethers フォーマットは SunOS 4.1.x で使用されている形式を元にしています。 diff --git a/ja/man/man5/exports.5 b/ja/man/man5/exports.5 index 2e5ef1b3be..87fb725151 100644 --- a/ja/man/man5/exports.5 +++ b/ja/man/man5/exports.5 @@ -1,256 +1,256 @@ .\" 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. .\" .\" @(#)exports.5 8.3 (Berkeley) 3/29/95 .\" %Id: exports.5,v 1.3.2.1 1997/03/12 15:07:13 mpp Exp % -.\" jpman $Id: exports.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: exports.5,v 1.3 1998/07/02 14:10:07 horikawa Stab % .\" .Dd March 29, 1995 .Dt EXPORTS 5 .Os .Sh 名称 .Nm exports .Nd .Tn NFS マウント要求に対するリモートマウント点を定義する .Sh 書式 .Nm exports .Sh 解説 .Nm exports ファイルは .Tn NFS サーバの指定 1 つについて .Tn NFS マウントプロトコルに対するリモートマウント点を指定します。 .%T "Network File System Protocol Specification \\*(tNRFC\\*(sP 1094, Appendix A" および .%T "NFS: Network File System Version 3 Specification, Appendix I" を参照してください。 .Pp .Nm exports ファイルの各行 (# で始まる注釈行以外) は、1 つ以上のホスト向けに、 1 つのローカルサーバファイルシステム内の マウント点 (複数) とエクスポートフラグを指定します。 あるホストは、 サーバの各ローカルファイルシステムに関して唯 1 度だけ指定可能です。 また他の全てのホストに適用されるデフォルトエントリは、 各サーバファイルシステムに関して唯 1 つだけ指定できます。 後者は ``世界'' に対しそのファイルシステムを公開することになるので、 そのファイルシステムが公の情報を含むときにのみ用いるべきです。 .Pp マウントエントリ内の最初の欄 (複数) には、 対応するクライアント (複数) がマウント可能である サーバファイルシステム内ディレクトリパス (複数) を指定します。 この指定には 2 つの形式があります。 最初の指定形式は、 全マウント点のリストであり、絶対ディレクトリパスを空白で区切ったものです。 次の指定形式は、そのファイルシステムのルートパス名に続いて .Fl alldirs フラグを指定するものです。この形式は、そのファイルシステム内の任意の点を ホスト (複数) がマウントすることを可能にします。mountd で .Fl r オプションを用いれば、任意の点には通常ファイルを含むことができます。 パス名中には、シンボリックリンクを含んではなりませんし、また "." または ".." を含んではなりません。 1 つのファイルシステムに対するマウント点を複数指定することが可能であり、 それぞれ異ったホストとエクスポートオプションの組を指定することができます。 .Pp 行の 2 番目の部分には、そのファイルシステムがホストの組にどのように エクスポートされているかを指定します。 オプションフラグは、 そのファイルシステムを読み取り専用でエクスポートしているのか それとも読み書き可でエクスポートしているのかを指定したり、 クライアントの UID がサーバ上のユーザ資格にどのように マップされているのかを指定します。 .Pp エクスポートオプションは以下のとおりです。 .Pp .Sm off .Fl maproot No = Sy user .Sm on 指定されたユーザの資格を、root によるリモートアクセスに対して使用します。 その資格には、ローカルマシン上でユーザが属する全てのグループを含みます ( .Xr id 1 参照)。ユーザは名前または数字です。 .Pp .Sm off .Fl maproot No = Sy user:group1:group2:... .Sm on コロンによって区切られたリストは、 root によるリモートアクセスに対して使用する正確な資格を指定するために 使用します。 リストの要素は名前または数字です。 グループを含まない資格をユーザに関する完全な資格と区別するためには、 user: を使用すべきであることに注意してください。 .Pp .Sm off .Fl mapall No = Sy user .Sm on または .Sm off .Fl mapall No = Sy user:group1:group2:... .Sm on .Fl maproot と同じ指定方法で、 (root を含む) 全てのクライアントの UID に対するマッピングを指定します。 .Pp .Fl r オプションは .Fl maproot と同じ意味です。 これは古い export ファイル形式と互換性を保つために用意されました。 .Pp .Fl maproot および .Fl mapall オプションのない場合には、 root によるリモートアクセスは -2:-2 という資格を用いることになります。 その他の全てのユーザはそれぞれのリモート資格にマップされます。 .Fl maproot オプションを指定すると、root によるリモートアクセスは -2:-2 の代りに 指定した資格にマップされます。 .Fl mapall オプションを指定すると、root を含む全てのユーザはそれら自身の資格の代りに 指定した資格にマップされます。 .Pp .Fl kerb オプションを指定すると、Kerberos 認証サーバを使用して 認証とクライアント資格のマップを行います。 このオプションを利用するには、カーネルを NFSKERB オプション付きで 構築してある必要があります。 .Pp .Fl ro オプションは、ファイルシステムが読み取り専用としてエクスポートされることを 指定します (デフォルトは読み書き可)。 .Fl o オプションは .Fl ro と同じ意味です。 これは古い export ファイル形式と互換性を保つために用意されました。 .Pp 行の 3 番目の部分には、その行が適用されるホストの組を指定します。 この組は 3 つの方法で指定できます。 最初の方法はホスト名 (複数) を空白で区切って並べる方法です。 (名前の代りに、標準的なインターネット ``ドット'' アドレスを用いることも できます)。2 番目の方法はネットグループファイル ( .Xr netgroup 5 参照) の中で定義した ``netgroup'' を指定する方法です。 3 番目の方法は、 1 つのネットワークとネットワークマスクを用いることにより、 1 つのインターネットサブネットワークを指定する方法です。 これは、 そのサブネットワーク内のアドレスを持つ全てのホストの組として定義されます。 この最後の方法はカーネルのオーバヘッドを低く押えられるため、 1 つの管理サブネット内の多くのクライアントを エクスポートの行が参照する場合に推奨されます。 .Pp 最初の 2 つの指定方法では、単に空白で区切られた名前 (複数) を並べて指定します。 全ての名前は、まずそれらが ``netgroup'' 名であるかチェックされ、 そうでなければホスト名であると仮定されます。 ホスト名に完全ドメイン指定をすれば、 ネットグループと同じ名前を持つホストの問題を通常避けることができます。 3 番目の指定方法は、 .Sm off .Fl network No = Sy netname .Sm on フラグとオプションの .Sm off .Fl mask No = Sy netmask .Sm on フラグによって指定します。マスクが指定されないと、そのネットワーククラス (A, B, C のどれかです。 .Xr inet 4 を参照してください) に対するマスクとなります。 .Pp 例: .Bd -literal -offset indent /usr /usr/local -maproot=0:10 friends /usr -maproot=daemon grumpy.cis.uoguelph.ca 131.104.48.16 /usr -ro -mapall=nobody /u -maproot=bin: -network 131.104.48 -mask 255.255.255.0 /u2 -maproot=root friends /u2 -alldirs -kerb -network cis-net -mask cis-mask .Ed .Pp .Sy /usr , .Sy /u , .Sy /u2 がローカルファイルシステムマウント点とすると、上の例は以下を指定します: .Sy /usr はネットクグープファイルで指定されるホスト群 .Em friends にエクスポートされ、 この際ユーザはそれぞれのリモート資格にマップされ、 root は UID 0 およびグループ 10 にマップされます。 このファイルシステムは読み書き可でエクスポートされ、 ``friends'' 内のホストは /usr と /usr/local のどちらもマウントできます。 このファイルシステムは .Em 131.104.48.16 および .Em grumpy.cis.uoguelph.ca にエクスポートされ、 この際ユーザはそれぞれのリモート資格にマップされ、 root は ``daemon'' に結び付けられたユーザおよびグループにマップされます。 このファイルシステムは残りの世界へ読み出しのみでエクスポートされ、 この際全てのユーザは ``nobody'' に結び付けられたユーザおよびグループに マップされます。 .Pp .Sy /u はサブネットワーク .Em 131.104.48 上の全てのホストにエクスポートされ、 この際 root は ``bin'' の UID にマップされてグループアクセスを持ちません。 .Pp .Sy /u2 は ``friends'' 中のホストにエクスポートされ、 その際 root は ``root'' に結び付けられた UID とグループにマップされます。 このファイルシステムは ``cis-net'' ネットワーク上の全てのホストへ エクスポートされ、 この際 /u2 内のどんなディレクトリへもマウントを許し、 Kerberos 許可書によって認証される principal についての資格に 全 UID をマップします。 .Sh 関連ファイル .Bl -tag -width /etc/exports -compact .It Pa /etc/exports デフォルトリモートマウント点ファイル .El .Sh 関連項目 .Xr netgroup 5 , .Xr mountd 8 , .Xr nfsd 8 , .Xr showmount 8 .Sh バグ エクスポートオプションはカーネル内ではローカルマウント点に結び付けられます。 ローカルサーバマウント点のサブディレクトリでエクスポートされたものに、 エクスポートオプションの矛盾があってはいけません。 同じファイルシステム内の全てのエクスポートされたディレクトリは、 木を下る順に隣り合った行で指定されることが推奨されます。 ネットグループ名と同じ名前のホスト名は指定できません。 完全ドメイン指定でホスト名を指定すれば通常は問題ありません。 diff --git a/ja/man/man5/fbtab.5 b/ja/man/man5/fbtab.5 index 8309d176dd..49aeba9793 100644 --- a/ja/man/man5/fbtab.5 +++ b/ja/man/man5/fbtab.5 @@ -1,49 +1,49 @@ .\" .\" %Id: fbtab.5,v 1.1.8.3 1998/06/28 21:34:26 hoek Exp % .\" -.\" jpman $Id: fbtab.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: fbtab.5,v 1.3 1998/04/29 11:36:22 kuma Stab % .\" .\" WORD: permission パーミッション .\" WORD: device デバイス(/dev 下のデバイスファイル関連のもの) .\" WORD: comment コメント .\" WORD: whitespace 空白 .\" WORD: ownership 所有権(ファイルの) .\" .Dd August 22, 1994 .Dt FBTAB 5 .Os FreeBSD 2.0 .Sh 名称 .Nm fbtab .Nd ログイン時にデパイスの保護状態を変更する .Sh 解説 .Nm fbtab ファイルには、 単一デバイス・複数デバイスのリスト・それらのパーミッション の 3 つを指定する行が複数個格納されます。 コメントは # から開始し、行末まで続きます。 .Pp 空行もしくはコメントのみの行は無視されます。 .Pp 他の行は空白で区切られる次の 3 フィールドからなります: ログインデバイス (/dev/ttyv0)・8 進数でのパーミッション値 (0600)・ そして ":" で区切ったデバイスリスト (/dev/console) です。 デバイス名は全て絶対パスで記述します。 \&"/*" で終るパスは "." と ".." 以外の全ディレクトリエントリを参照します。 .Pp tty 引数 (相対パス) がログインデバイス名 (絶対パス) にマッチする場合、 \&":" 区切りでリストされるデバイスのパーミッションが 第 2 フィールドで指定される値に設定され、 所有者が UID と GID 引数の値に設定されます。 .Sh 関連ファイル .Bl -tag -width /etc/fbtab -compact .It Pa /etc/fbtab .Nm fbtab ファイルは .Pa /etc にあります。 .El .Sh 関連項目 .Xr login 1 , .Xr getty 8 .Sh 作者 .An Guido van Rooij diff --git a/ja/man/man5/fdesc.5 b/ja/man/man5/fdesc.5 index e048cee83a..71d9b3b40a 100644 --- a/ja/man/man5/fdesc.5 +++ b/ja/man/man5/fdesc.5 @@ -1,152 +1,152 @@ .\" Copyright (c) 1996 .\" Mike Pritchard . All rights reserved. .\" .\" 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: fdesc.5,v 1.2.2.2 1998/07/19 06:52:11 jkh Exp % .\" -.\" jpman $Id: fdesc.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: fdesc.5,v 1.3 1998/07/30 15:24:07 horikawa Stab % .\" WORD: file descriptor ファイル記述子 .\" WORD: augment (union マウントによる)重ね合わせ .\" .Dd December 14, 1996 .Dt fdesc 5 .Os BSD 4.4 .Sh 名称 .Nm fdesc .Nd ファイル記述子ファイルシステム .Sh 書式 fdesc /dev fdesc rw 0 0 .Sh 解説 ファイル記述子ファイルシステム、別名 .Nm fdesc は、プロセス毎のファイル記述子の名前空間をグローバルなファイルシステムの 名前空間からアクセスする機能を提供します。 通常のマウントポイントは .Pa /dev であり、 .Pa /dev の既存のエントリを置き換えるのではなく重ね合わせるために、 ファイルシステムを union マウントする必要があります。 .Pp マウントポイントの内容は .Pa fd , .Pa stderr , .Pa stdin , .Pa stdout および .Pa tty です。 .Pp .Pa fd はディレクトリで、その中身は、番号で表したファイルのリストとして見えます。 これらのファイルは、ディレクトリを読むプロセスが現在オープンしている ファイルに対応しています。 .Pa /dev/fd/0 から .Pa /dev/fd/# までのファイルは記述子への参照であり、 ファイルシステムを通じてアクセスすることができます。 ファイル記述子がオープンされていて、ファイルをオープンしたときのモードが 既存の記述子のモードのサブセットである場合は、システムコール呼び出し .Bd -literal -offset indent fd = open("/dev/fd/0", mode); .Ed .Pp と、システムコール呼び出し .Bd -literal -offset indent fd = fcntl(0, F_DUPFD, 0); .Ed .Pp は等価です。 .Pp ファイル .Pa /dev/stdin , .Pa /dev/stdout および .Pa /dev/stderr は .Pa /dev/fd サブディレクトリの対応するエントリへのシンボリックリンクとなります。 これらをオープンするのは、以下のシステムコール呼び出しと等価です。 .Bd -literal -offset indent fd = fcntl(STDIN_FILENO, F_DUPFD, 0); fd = fcntl(STDOUT_FILENO, F_DUPFD, 0); fd = fcntl(STDERR_FILENO, F_DUPFD, 0); .Ed .Pp .Xr open 2 呼び出し時のフラグは .Dv O_RDONLY , .Dv O_WRONLY および .Dv O_RDWR 以外は無視されます。 .Pp .Pa /dev/tty エントリはカレントプロセスの制御端末への間接参照です。 これは見かけ上は名前つきパイプ (FIFO) ですが、本物の制御端末デバイスと 全く同じ振舞いをします。 .Sh 関連ファイル .Bl -tag -width /dev/stderr -compact .It Pa /dev/fd/# .It Pa /dev/stdin .It Pa /dev/stdout .It Pa /dev/stderr .It Pa /dev/tty .El .Sh 関連項目 .Xr tty 4 , .Xr mount_devfs 8 , .Xr mount_fdesc 8 .Sh 歴史 .Nm ファイルシステムは .Bx 4.4 で最初に登場しました。 .Nm マニュアルページは .Fx 2.2 で最初に登場しました。 .Sh 作者 .Nm マニュアルページは .An Mike Pritchard Aq mpp@FreeBSD.org によって書かれたもので、 .An Jan-Simon Pendry による .Xr mount_fdesc 8 マニュアルページに基づいています。 diff --git a/ja/man/man5/forward.5 b/ja/man/man5/forward.5 index e650414965..6751a2bde4 100644 --- a/ja/man/man5/forward.5 +++ b/ja/man/man5/forward.5 @@ -1,83 +1,83 @@ .\" Copyright (c) 1996 .\" Mike Pritchard . 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 and .\" contributors. .\" 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: forward.5,v 1.1.2.1 1997/03/07 04:18:03 mpp Exp % -.\" jpman $Id: forward.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: forward.5,v 1.3 1998/04/29 11:32:30 kuma Stab % .\" .\" WORD: quote クォート(単一引用符または二重引用符文字のこと) .\" .Dd July 2, 1996 .Dt FORWARD 5 .Os .Sh 名称 .Nm forward .Nd メールの転送指示 .Sh 解説 .Nm .forward ファイルは、ユーザのメールの転送先の メールアドレスもしくはプログラムのリストを格納します。 このファイルが存在しない場合には、メール転送は行なわれません。 行頭に標準のシェルパイプシンボル (|) を付けることにより、 メールはプログラムの標準入力として転送されます。 引数をコマンドに渡す場合には、行全体をクォートで括る必要があります。 セキュリティ上の理由で、 .Nm .forward ファイルはメール送付先のユーザもしくは root が所有者である必要があり、 ユーザのシェルが .Pa /etc/shells にリストされている必要があります。 .Pp 例えば、 .Nm .forward ファイルが以下の行を含む場合: .Bd -literal -offset indent nobody@FreeBSD.org "|/usr/bin/vacation nobody" .Ed .Pp メールは .Ar nobody@FreeBSD.org に転送され、 単一引数 .Ar nobody を伴なってプログラム .Pa /usr/bin/vacation に転送されます。 .Sh 関連ファイル .Bl -tag -width $HOME/.forward -compact .It Pa $HOME/.forward ユーザによる転送指示 .El .Sh 関連項目 .Xr mailaddr 7 , .Xr sendmail 8 diff --git a/ja/man/man5/fs.5 b/ja/man/man5/fs.5 index 7c27531abb..1c87cedba3 100644 --- a/ja/man/man5/fs.5 +++ b/ja/man/man5/fs.5 @@ -1,363 +1,363 @@ .\" 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. .\" .\" @(#)fs.5 8.2 (Berkeley) 4/19/94 -.\" jpman $Id: fs.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: fs.5,v 1.3 1998/06/22 11:05:13 kumano Stab % .\" %Id: fs.5,v 1.3.2.2 1997/03/07 04:18:04 mpp Exp % .\" .Dd April 19, 1994 .Dt FS 5 .Os BSD 4.2 .Sh 名称 .Nm fs , .Nm inode .Nd ファイルシステムボリュームのフォーマット .Sh 書式 .Fd #include .Fd #include .Fd #include .Sh 解説 ファイル .Aq Pa fs.h と .Aq Pa inode.h は、ランダムアクセスデバイス (ディスク) 上のファイルシステムオブジェクト の基本フォーマットを作成、管理する際に使われるいくつかの構造体、 定義済み変数、マクロを宣言します。 .Pp ファイルシステムはブロックサイズとブロック数から構成されており、 これらはファイルシステムのパラメータになります。 .Dv BBLOCK から始まり 大きさ .Dv BBSIZE だけ続くセクタは、 ディスクラベルといくつかの一次、二次ハードウェアブートストラッププログラム のために使われます。 .Pp 実際のファイルシステムは、 .Dv SBLOCK セクタから始まり、そこには 大きさが .Dv SBSIZE である .Em スーパブロック があります。 ファイル .Aq Pa ufs/ffs/fs.h にある以下の構造体は、スーパブロックを記述しています。 .Bd -literal /* * ファイルシステムのスーパブロック */ struct fs { struct fs *fs_link; /* 内部スーパブロック用に使われるファイルシステムの */ struct fs *fs_rlink; /* リンク済みリスト */ daddr_t fs_sblkno; /* ファイルシステム内のスーパブロックのアドレス */ daddr_t fs_cblkno; /* ファイルシステム内のシリンダブロックのオフセット */ daddr_t fs_iblkno; /* ファイルシステム内の inode ブロックのオフセット */ daddr_t fs_dblkno; /* cg 後の最初のデータのオフセット */ long fs_cgoffset; /* シリンダ内のシリンダグループオフセット */ long fs_cgmask; /* mod fs_ntrak の計算に使われる */ time_t fs_time; /* 最後に書き込まれた時刻 */ long fs_size; /* fs 内のブロック数 */ long fs_dsize; /* fs 内のデータブロック数 */ long fs_ncg; /* シリンダグループの数 */ long fs_bsize; /* fs 内の基本ブロックサイズ */ long fs_fsize; /* fs 内のフラグメントブロックサイズ */ long fs_frag; /* fs の 1 ブロック中のフラグメント数 */ /* 以下はコンフィグレーションパラメータ */ long fs_minfree; /* フリーブロックの最小パーセンテージ */ long fs_rotdelay; /* 最適な次ブロックのための ms 数 */ long fs_rps; /* 1 秒あたりのディスク回転 */ /* これらのフィールドは他のフィールドから計算できる */ long fs_bmask; /* ``blkoff'' ブロックオフセットの計算 */ long fs_fmask; /* ``fragoff'' フラグメントオフセットの計算 */ long fs_bshift; /* ``lblkno'' 論理ブロック番号の計算 */ long fs_fshift; /* ``numfrags'' フラグメント数の計算 */ /* 以下はコンフィグレーションパラメータ */ long fs_maxcontig; /* 連続したブロックの最大数 */ long fs_maxbpg; /* シリンダグループあたりの最大ブロック数 */ /* これらのフィールドは他のフィールドから計算できる */ long fs_fragshift; /* フラグメントシフトするブロック */ long fs_fsbtodb; /* fsbtodb と dbtofsb シフト定数 */ long fs_sbsize; /* スーパブロックの実際の大きさ */ long fs_csmask; /* csum ブロックオフセット */ long fs_csshift; /* csum ブロック数 */ long fs_nindir; /* NINDIR の値 */ long fs_inopb; /* INOPB の値 */ long fs_nspf; /* NSPF の値 */ /* 別のコンフィグレーションパラメータ */ long fs_optim; /* 最適化の選択、以下を参照 */ /* これらのフィールドはハードウェアから引き出される */ long fs_npsect; /* 予備を含むトラックあたりのセクタ数 */ long fs_interleave; /* ハードウェアセクタインタリーブ */ long fs_trackskew; /* トラックあたりのセクタ 0 ゆがみ */ long fs_headswitch; /* ヘッドスイッチ時間 (usec) */ long fs_trkseek; /* トラック間シーク (usec) */ /* シリンダグループの数とサイズにより決められるサイズ */ daddr_t fs_csaddr; /* シリンダグループ総括領域のブロックアドレス */ long fs_cssize; /* シリンダグループ総括領域のサイズ */ long fs_cgsize; /* シリンダグループサイズ */ /* これらのフィールドはハードウェアから引き出される */ long fs_ntrak; /* シリンダあたりのトラック数 */ long fs_nsect; /* トラックあたりのセクタ数 */ long fs_spc; /* シリンダあたりのセクタ数 */ /* これはディスクドライバパーティション作成時のもの */ long fs_ncyl; /* ファイルシステムのシリンダ数 */ /* これらのフィールドは他のフィールドから計算できる */ long fs_cpg; /* グループあたりのシリンダ数 */ long fs_ipg; /* グループあたりの inode 数 */ long fs_fpg; /* グループあたりのブロック数 * fs_frag */ /* このデータはクラッシュ後に再計算されなければならない */ struct csum fs_cstotal; /* シリンダ総括情報 */ /* 以下のフィールドはマウント時にクリアされる */ char fs_fmod; /* スーパブロック変更フラグ */ char fs_clean; /* ファイルシステムがクリーンであるフラグ */ char fs_ronly; /* 読み込み専用でマウントされたフラグ */ char fs_flags; /* 現在未使用のフラグ */ char fs_fsmnt[MAXMNTLEN]; /* マウントされている名前 */ /* これらのフィールドは現在のブロックの配置情報を保持する */ long fs_cgrotor; /* 最後に検索された cg */ struct csum *fs_csp[MAXCSBUFS]; /* fs_cs 情報バッファのリスト */ long fs_cpc; /* postbl 内のサイクルあたりのシリンダ */ short fs_opostbl[16][8]; /* 旧回転ブロックリストヘッド */ long fs_sparecon[50]; /* 将来のために予約された定数 */ long fs_contigsumsize;/* クラスタ総括配列の大きさ */ long fs_maxsymlinklen;/* 内部シンボリックリンクの最大長 */ long fs_inodefmt; /* ディスク上の inode のフォーマット */ u_quad_t fs_maxfilesize;/* 最大表示可能ファイルサイズ */ quad fs_qbmask; /* ~fs_bmask - quad サイズで使う */ quad fs_qfmask; /* ~fs_fmask - quad サイズで使う */ long fs_postblformat; /* 位置レイアウトテーブルのフォーマット */ long fs_nrpos; /* 回転位置の数 */ long fs_postbloff; /* (short) 回転ブロックリストヘッド */ long fs_rotbloff; /* (u_char) 各回転毎のブロック */ long fs_magic; /* マジックナンバ */ u_char fs_space[1]; /* 各回転毎のブロックのリスト */ /* 実際はもっと長い */ }; /* * ファイルシステム識別 */ #define FS_MAGIC 0x011954 /* fast ファイルシステムのマジックナンバ */ #define FS_OKAY 0x7c269d38 /* スーパブロックチェックサム */ #define FS_42INODEFMT -1 /* 4.2BSD inode フォーマット */ #define FS_44INODEFMT 2 /* 4.4BSD inode フォーマット */ /* * 最適化のための選択 */ #define FS_OPTTIME 0 /* 最小アロケーション時間 */ #define FS_OPTSPACE 1 /* 最小ディスクフラグメンテーション */ /* * 回転レイアウトテーブルフォーマットタイプ */ #define FS_42POSTBLFMT -1 /* 4.2BSD 回転テーブルフォーマット */ #define FS_DYNAMICPOSTBLFMT 1 /* 動的回転テーブルフォーマット */ .Ed .Pp 各ディスクドライブはいくつかのファイルシステムを含んでいます。 1 つのファイルシステムは、いくつかのシリンダグループから成ります。 各シリンダグループには inode とデータがあります。 .Pp ファイルシステムは、シリンダグループを順番に記述するスーパブロックに よって記述されています。 スーパブロックは重要なデータであり、壊滅的な損失から守るために 各シリンダグループに複製されています。 これはファイルシステム作成時に行なわれ、重要なスーパブロックデータは 変更されないので、特に惨事がふりかからなければ、複製が参照される 必要はありません。 .Pp inode に保存されたアドレスによって、`ブロック' のフラグメントの 位置を決めることができます。 ファイルシステムブロックのほとんどは .Dv MAXBSIZE ですが、2, 4, 8 個に分けることが自由にでき、 それぞれを位置指定できます。 これらの断片は .Dv DEV_BSIZE または .Dv DEV_BSIZE 単位の倍数であれば良いのです。 .Pp 大きなファイルは、非常に大きなデータブロックからなります。 ディスクスペースの過度の浪費を避けるために、小さなファイルの 最後のデータブロックは、 大きなブロックのフラグメントが必要な数だけ配置されます。 ファイルシステムフォーマットは、そのようなフラグメント (大きなブロックを 分割した一片) の 1 つへのポインタだけを保持します。 そのようなフラグメントの大きさは、 inode にある情報から決定することができ、 .Fn blksize fs ip lbn マクロが使っています。 .Pp ファイルシステムは、提供可能な空きをフラグメントレベルで記録します。 つまり、ブロックの空きを決定するために、フラグメントを並べて調べます。 .Pp root inode は、ファイルシステムのおおもとです。 inode 0 は、通常の目的では使われず、歴史的に バッドブロックは inode 1 にリンクされます。 したがって root inode は、2 です (inode 1 は、もはやこの目的では使われませんが、 多くのダンプテープがこの仮定をしているので、それについては変更できません)。 .Pp .Fa fs_minfree 要素は、空いているファイルシステムブロックの最低許容割合を与えます。 空きリストがこのレベル以下になった場合、スーパユーザ だけがブロックの確保を続けることができます。 .Fa fs_minfree 要素は、空きブロックの予備が必要ないと思われたら 0 にセットしても かまいませんが、ファイルシステムが 90% 以上詰まった状態で動いているときには、 かなり性能が低下するでしょう。 そのためデフォルトの .Fa fs_minfree の値は 10% になっています。 .Pp 経験上、ブロックフラグメンテーションと 90% 使用中のディスク全体の利用 の兼ね合いが最も良いのは、フラグメンテーション 8 のときです。 そのためデフォルトのフラグメントサイズはブロックサイズの 8 倍になっています。 .Pp 要素 .Fa fs_optim はファイルシステムがブロックを確保するのに要する時間を最小に しようとするか、それともディスク上の領域のフラグメンテーションを最小に しようとするかを指定します。 fs_minfree (上記参照) の値が 10% より小さい場合は、ファイルシステム は空間の最適化をデフォルトとし、 完全な大きさのブロックがなくならないようにします。 minfree の値が 10% と等しいかそれ以上の場合には、フラグメンテーション が問題とはなりにくく、ファイルシステムは時間の最適化をデフォルトに します。 .Pp .Em シリンダグループに関連した制限 : 連続したブロックを最小の回転遅れで配置することができるよう、 各シリンダは異なる回転位置での利用可能なブロック数を保持し続けます。 デフォルトでは回転位置を 8 分割で表し、このときの総括情報の分解能は 典型的な 3600 rpm のドライブで 2ms になります。 .Pp 要素 .Fa fs_rotdelay は、同一シリンダ上で別のディスク転送を開始する 最小ミリ秒数を与えます。 これは、あるファイル中のディスクブロックの周回の中での最適な配置を 決定するのに使われます。 デフォルトの .Fa fs_rotdelay の値は 2ms です。 .Pp 各ファイルシステムは、静的に割り当てられた数の inode を持っています。 inode は、ディスク空間あたり .Dv NBPI バイト確保されます。 inode を配置する戦略は、極端に保守的です。 .Pp .Dv MINBSIZE が許される最小のブロックサイズです。 .Dv MINBSIZE が 4096 では、2 段までの(ブロック)間接参照を使って 2^32 の大きさのファイルを作ることができます。 .Dv MINBSIZE は、シリンダグループブロックを保持するのに十分な大きさでなければ なりません。 したがって .Pq Fa 構造体 cg への変更は大きさを .Dv MINBSIZE 以内にしておかなければなりません。 スーパブロックは決して .Dv SBSIZE の大きさ以上ではないということに注意して下さい。 .Pp ファイルシステムがマウントされているパス名は、 .Fa fs_fsmnt に保持されます。 .Dv MAXMNTLEN は、この名前のためにスーパブロックに割り当てられた領域の量を定義します。 ファイルシステム毎の総括情報の量の上限は、 .Dv MAXCSBUFS により定義されています。 4096 バイトブロックサイズの場合では、これは現在最大 200 万シリンダ分 用意されています。 .Pp それぞれのシリンダグループ情報は、先頭のシリンダグループ データブロックから確保されたブロックに要約されます。 これらのブロックはスーパブロックに加えて .Fa fs_csaddr ( .Fa fs_cssize の大きさ) から読み込まれます。 .Pp .Sy 注意: .Fn sizeof "struct csum" は .Fn fs_cs マクロを動かすために 2 のべき乗でなければなりません。 .Pp .Em "ファイルシステムのスーパブロック" : 周回レイアウトテーブルの大きさは、スーパブロックが .Dv SBSIZE の大きさを持つことにより制限されています。 これらのテーブルの大きさは、ファイルシステムのブロックサイズに .Em 逆比例 します。 セクタサイズが 2 のべき乗でないときには、周回パターンを .Pq Fa fs_cpc だけ繰り返すまでに含まれるシリンダ数が増加するので、 同様にテーブルの大きさも増加します。 周回レイアウトテーブルの大きさは、 .Pq Fa struct fs に残っているバイト数から割り出されます。 .Pp シリンダグループあたりのデータブロック数は、シリンダグループが たかだか 1 ブロックであるので、制限されています。 inode と空きブロックテーブルは、単一ブロックから シリンダグループ構造体 .Pq Fa struct cg のための領域を除いた残りにぴったり合っていなければなりません。 .Pp .Em Inode : inode は、 .Tn UNIX ファイルシステム内のすべてのファイルに関する動作の中心です。 各アクティブなファイル、カレントディレクトリ、マウントされたファイル、 テキストファイル、root には、それぞれユニークな inode が割り当てられます。 inode はそのデバイス / i 番号によって `名前付け' されています。 詳しくはインクルードファイル .Aq Pa sys/inode.h を参照して下さい。 .Sh 歴史 filsys と名付けられたスーパブロック構造は .At v6 から登場しました。このマニュアルで記述されているファイルシステムは .Bx 4.2 から登場しました。 diff --git a/ja/man/man5/fstab.5 b/ja/man/man5/fstab.5 index 608d5d0060..43d542ba7a 100644 --- a/ja/man/man5/fstab.5 +++ b/ja/man/man5/fstab.5 @@ -1,246 +1,246 @@ .\" 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. .\" .\" @(#)fstab.5 8.1 (Berkeley) 6/5/93 .\" %Id: fstab.5,v 1.4.2.5 1998/06/28 21:34:26 hoek Exp % .\" -.\" jpman $Id: fstab.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: fstab.5,v 1.3 1998/06/12 11:00:49 mutoh Stab % .\" .Dd June 5, 1993 .Dt FSTAB 5 .Os BSD 4 .Sh 名称 .Nm fstab .Nd ファイルシステムに関する静的情報 .Sh 書式 .Fd #include .Sh 解説 .Nm fstab ファイルは、さまざまなファイルシステムについて記述した情報を格納します。 .Nm fstab はプログラムによって読み出されるだけで、書き込みはされません。 このファイルを適切に作成、保守するのはシステム管理者の責務です。 各ファイルシステムは個別の行に記述されます。 各々の行のフィールドはタブまたはスペースによって区切られます。 .Xr fsck 8 , .Xr mount 8 , および .Xr umount 8 が .Nm fstab を通じて必要な処理を連続して繰り返すため、 .Nm fstab のレコードの順序は重要な意味を持ちます。 .Pp 第1フィールド .Pq Fa fs_spec はマウントされるブロックスペシャルデバイス、またはリモートのファイル システムを表します。 .Em ufs 形式のファイルシステムでは、スペシャルファイル名はブロックスペシャル ファイル名であり、キャラクタスペシャルファイル名ではありません。 プログラムがキャラクタスペシャルファイル名を必要とする場合、そのプログラム がスペシャルファイル名の中の最後の ``/'' の後ろに ``r'' を追加することで キャラクタスペシャルファイル名を作成しなければなりません。 .Pp 第2フィールド .Pq Fa fs_file はファイルシステムのマウントポイントを表します。 スワップパーティションでは、このフィールドには ``none'' と記述すべきです。 .Pp 第3フィールド .Pq Fa fs_vfstype はファイルシステムの形式を表します。 システムはさまざまなファイルシステム形式をサポートできます。 ルート、 /usr および /tmp のファイルシステムだけはカーネルに静的に組み 込まれている必要があります。 他の全てのファイルシステムはマウント時に自動的にロードされます (例外 : UFS 系 - FFS , MFS および LFS は現在のところデマンドロードは できません)。 いまだに他のファイルシステムも同様に静的に組み込むのを好む人もいるようです。 .Bl -tag -width indent -offset indent .It Em ufs ローカルの .Tn UNIX ファイルシステム .It Em mfs ローカルのメモリベース .Tn UNIX ファイルシステム .It Em nfs Sun Microsystems 互換 ``Network File System'' .It Em swap スワッピングに使用されるディスクパーティション .It Em msdos DOS 互換ファイルシステム .It Em cd9660 ( ISO 9660 による) CD-ROM ファイルシステム .\" おそらく、例えばRock Ridge extension形式なども処理される? .It Em procfs プロセスデータへのアクセスのためのファイルシステム .It Em kernfs カーネルパラメータへのアクセスのためのファイルシステム .El .Pp 第4フィールド .Pq Fa fs_mntops は、ファイルシステムに関連するマウントオプションを表します。 これはコンマで区切られたオプションのリストとして記述されます。 これは少なくともマウントの形式(以下の .Fa fs_type 参照)を含み、加えてファイルシステム形式に特有のいくつかの追加の オプションを含みます。 .Pp ``userquota'' および ``groupquota'' オプションの双方、またはいずれかが 指定されている場合、ファイルシステムは自動的に .Xr quotacheck 8 コマンドによって処理され、ユーザおよびグループクォータが .Xr quotaon 8 で有効にされます。 デフォルトでは、ファイルシステムのクォータは関連するファイルシステムの ルートに置かれた .Pa quota.user および .Pa quota.group というファイルで管理されます。 これらのデフォルトは、クォータオプションの直後に等号とデフォルトに代わる 絶対パス名を置くことで変更することができます。 従って、 .Pa /tmp のユーザクォータファイルを .Pa /var/quotas/tmp.user に置く場合、そのファイルの場所は以下のように指定されます。 .Bd -literal -offset indent userquota=/var/quotas/tmp.user .Ed .Pp ``noauto'' オプションが指定されている場合、ファイルシステムはシステム 起動時に自動的にマウントされません。 .Pp マウント形式は .Fa fs_mntops フィールドから取り出され、 .Fa fs_type フィールドに個別に保存されます( .Fa fs_mntops フィールドからは削除されません)。 .Fa fs_type が ``rw'' または ``ro'' ならば、 .Fa fs_file フィールドで指定されたファイルシステムは、読み書き可能、または読み出し 専用で指定のスペシャルファイルに正常にマウントされます。 .Fa fs_type が ``sw'' ならば、スペシャルファイルはシステムのリブート処理の最後に .Xr swapon 8 コマンドによってスワップ領域の一部として使用されます。 .Fa fs_spec と .Fa fs_type 以外のフィールドは使用されません。 .Fa fs_type が ``xx'' と指定されている場合、このエントリは無視されます。 これは、現在使用されていないディスクパーティションを表すのに便利です。 .Pp 第5フィールド .Pq Fa fs_freq は、どのファイルシステムがダンプされる必要があるか決定するために .Xr dump 8 コマンドによって使用されます。 第5フィールドが与えられていない場合は 0 が返され、 .Nm dump コマンドはそのファイルシステムをダンプする必要がないと見なします。 .Pp 第6フィールド .Pq Fa fs_passno は、リブート時にファイルシステムのチェックが行われる順序を決定するために .Xr fsck 8 プログラムによって使用されます。 ルートファイルシステムは .Fa fs_passno に 1 、他のファイルシステムは .Fa fs_passno に 2 が指定されているべきです。 １つのドライブ内のファイルシステムは逐次的にチェックされますが、 異なるドライブ上のファイルシステムは、ハードウェアの並列性を利用して 同時にチェックされます。 第6フィールドが与えられていないか 0 の場合、0 が返され、 .Xr fsck 8 コマンドはそのファイルシステムをチェックする必要がないと見なします。 .Bd -literal #define FSTAB_RW "rw" /* 読み書き可能デバイス */ #define FSTAB_RQ "rq" /* クォータ付き読み書き可能デバイス */ #define FSTAB_RO "ro" /* 読み出し専用デバイス */ #define FSTAB_SW "sw" /* スワップデバイス */ #define FSTAB_XX "xx" /* 完全に無視 */ struct fstab { char *fs_spec; /* ブロックスペシャルデバイス名 */ char *fs_file; /* ファイルシステムのパスのプレフィックス */ char *fs_vfstype; /* ufs,nfs などのファイルシステム形式 */ char *fs_mntops; /* -o に準拠したマウントオプション */ char *fs_type; /* fs_mntops から FSTAB_* のコピー */ int fs_freq; /* ダンプ周期の日数 */ int fs_passno; /* 並列 fsck のパス番号 */ }; .Ed .Pp .Pa fstab のレコードを適切に読み出すには、 .Xr getfsent 3 , .Xr getfsspec 3 , .Xr getfstype 3 , および .Xr getfsfile 3 ルーチンを使用します。 .Sh 関連ファイル .Bl -tag -width /etc/fstab -compact .It Pa /etc/fstab .Nm fstab ファイルは .Pa /etc に存在します。 .El .Sh 関連項目 .Xr getfsent 3 , .Xr getvfsbyname 3 , .Xr dump 8 , .Xr fsck 8 , .Xr mount 8 , .Xr quotacheck 8 , .Xr quotaon 8 , .Xr swapon 8 , .Xr umount 8 .Sh 歴史 .Nm ファイルフォーマットは .Bx 4.0 から登場しました。 diff --git a/ja/man/man5/gettytab.5 b/ja/man/man5/gettytab.5 index 486371d9ce..22c153e70a 100644 --- a/ja/man/man5/gettytab.5 +++ b/ja/man/man5/gettytab.5 @@ -1,521 +1,521 @@ .\" 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: @(#)gettytab.5 8.4 (Berkeley) 4/19/94 .\" %Id: gettytab.5,v 1.7.2.8 1998/07/19 06:53:01 jkh Exp % .\" -.\" jpman $Id: gettytab.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: gettytab.5,v 1.3 1998/07/30 15:25:14 horikawa Stab % .\" " .\" WORD: terminal line 端末回線 .\" WORD: .Sh CAPABILITIES ケーパビリティ .\" WORD: erase 文字消去 .\" WORD: kill 行削除 .\" WORD: delay 遅延 .\" WORD: comma コンマ .\" WORD: banner バナー .\" WORD: answer chat script アンサーチャットスクリプト .\" WORD: screen 画面 [termcap.5 gettytab.5] .\" " .Dd April 19, 1994 .Dt GETTYTAB 5 .Os BSD 4.2 .\" turn off hyphenation .hym 999 .Sh 名称 .Nm gettytab .Nd 端末設定データベース .Sh 書式 .Nm gettytab .Sh 解説 .Nm ファイルは .Xr termcap 5 データベースを単純化したバージョンで、 端末回線を記述するのに用いられます。 冒頭に起動される端末ログインプロセス .Xr getty 8 は起動されるたびに .Nm ファイルにアクセスするので、 比較的簡単に端末の特性を再設定することができます。 データベースの各エントリは、それぞれ1個の端末クラスを記述するのに用いられます。 .Pp デフォルトの端末クラス .Em default が存在し、 他の全てのクラスに対するグローバルなデフォルト値を記述するのに 用いられます。 (言い替えれば、まず、 .Em default エントリを読み込み、その後で、必要なクラスのエントリを読み込み、 デフォルトの設定をクラス固有の設定で上書きします。) .Sh ケーパビリティ ファイルレイアウトの解説については、 .Xr termcap 5 を参照して下さい。 以下の .Em デフォルト 欄は、 使用する端末用のテーブルに値がなく、特別の .Em default テーブルにも値がない場合に用いられる値です。 .Bl -column 名称 文字列 /usr/bin/login .It Sy 名称 型 デフォルト 解説 .It "ac 文字列 unused モデム応答のための想定文字列-応答チャットスクリプト" .It "ap bool 偽 端末はどのパリティでも受け付ける" .It "bk 文字列 0377 代用の行末文字 (入力ブレーク)" .It "c0 数値 unused メッセージ書き出しのための tty コントロールフラグ群" .It "c1 数値 unused ログイン名読み込みのための tty コントロールフラグ群" .It "c2 数値 unused 端末を去るときのコントロールフラグ群" .It "ce bool 偽 crt 文字消去アルゴリズムを用いる" .It "ck bool 偽 crt 行削除アルゴリズムを用いる" .It "cl 文字列" Ta Dv NULL Ta .No "画面削除シーケンス" .It "co bool 偽 コンソール -" .Ql \en をログインプロンプトの後に追加する .It "ct 数値 10 ac/ic スクリプトのためのチャットタイムアウト" .It "dc 数値 0 チャットデバッグ用ビットマスク" .It "de 数値 0 この秒数だけ待って、最初のプロンプトを描く前に入力をフラッシュする" .It "ds 文字列" Ta So Li ^Y Sc Ta .No "遅延されたサスペンド文字" .It "dx bool 偽 " .Dv DECCTLQ をセットする .It "ec bool 偽 echo を残す" .Tn OFF .It "ep bool 偽 端末は偶数パリティを用いる" .It "er 文字列" Ta So Li ^? Sc Ta .No "消去文字" .It "et 文字列" Ta So Li ^D Sc Ta .No "テキストの終り" .Pq Dv EOF 文字 .It "ev 文字列" Ta Dv NULL Ta .No "環境変数の初期設定" .It "f0 数値 unused メッセージ書き出しのための tty モードフラグ群" .It "f1 数値 unused ログイン名読み込みのための tty モードフラグ群" .It "f2 数値 unused 端末を去るときの tty モードフラグ群" .It "fl 文字列" Ta So Li ^O Sc Ta .No "出力フラッシュ文字" .It "hc bool 偽 " 最後のクローズのときに回線をハングアップ .Tn させない .It "he 文字列" Ta Dv NULL Ta .No "ホスト名編集文字列" .It "hn 文字列 hostname ホスト名" .It "ht bool 偽 端末に本物のタブが実装されている" .It "hw bool 偽 cts/rts によるハードウェアフロー制御を行う" .It "i0 数値 unused メッセージ書き出しのための tty 入力フラグ群" .It "i1 数値 unused ログイン名読み込みのための tty 入力フラグ群" .It "i2 数値 unused 端末を去るときの tty 入力フラグ群" .It "ic 文字列 unused モデム初期化のための、想定入力-出力チャットスクリプト" .It "if 文字列 unused プロンプトの前に、/etc/issue のように名前で指定したファイルを表示する" .It "ig bool 偽 ログイン名に含まれるガベージ文字を無視する" .It "im 文字列" Ta Dv NULL Ta .No "冒頭の (バナー) メッセージ" .It "in 文字列" Ta So Li ^C Sc Ta .No "割り込み文字" .It "is 数値 unused 入力スピード" .It "kl 文字列" Ta So Li ^U Sc Ta .No "行消去文字" .It "l0 数値 unused メッセージ書き出しのための tty ローカルフラグ群" .It "l1 数値 unused ログイン名読み込みのための tty ローカルフラグ群" .It "l2 数値 unused 端末を去るときの tty ローカルフラグ群" .It "lm 文字列 login: ログインプロンプト" .It "ln 文字列" Ta So Li ^V Sc Ta .No "次の文字がリテラル値であることを示す文字" .It "lo 文字列" Ta Pa /usr/bin/login Ta .No "名前を得たときに実行するプログラム" .It "mb bool 偽 キャリアに基づいたフロー制御を行う" .It "nl bool 偽 端末には改行文字がある (あるいは、あるはずである)" .It "np bool 偽 端末はパリティを用いない (つまり 8bit 文字)" .It "nx 文字列 default (速度の自動選択のための) 次のテーブル" .It "o0 数値 unused メッセージ書き出しのための tty 出力フラグ群" .It "o1 数値 unused ログイン名読み込みのための tty 出力フラグ群" .It "o2 数値 unused 端末を去るときの tty 出力フラグ群" .It "op bool 偽 端末は奇数パリティを用いる" .It "os 数値 unused 出力スピード" .It "pc 文字列" Ta So Li \e0 Sc Ta .No "パッド文字" .It "pe bool 偽 プリンタの (ハードコピー) 文字消去アルゴリズムを用いる" .It "pf 数値 0 最初のプロンプトと" 引き続くフラッシュの間の遅延 (秒数) .It "pp 文字列 unused PPP 認証プログラム" .It "ps bool 偽 回線は" .Tn MICOM ポートセレクタに接続されている .It "qu 文字列" Ta So Li \&^\e Sc Ta .No "終了文字" .It "rp 文字列" Ta So Li ^R Sc Ta .No "行の再タイプ文字" .It "rt 数値 unused ac 使用時の ring タイムアウト" .It "rw bool 偽 入力に raw モードを" .Tn 用いずに 、cbreak を用いる .It "sp 数値 unused (入力および出力の) 回線速度" .It "su 文字列" Ta So Li ^Z Sc Ta .No "サスペンド文字" .It "tc 文字列 none テーブルの続き" .It "to 数値 0 タイムアウト (秒数)" .It "tt 文字列" Ta Dv NULL Ta .No "端末の型 (環境変数用)" .It "ub bool 偽 (プロンプトなどの) バッファリングしない出力を行う" .It "we 文字列" Ta So Li ^W Sc Ta .No "単語消去文字" .It xc bool 偽 コントロール文字を .Ql ^X の形で出力 .Tn しない .It "xf 文字列" Ta So Li ^S Sc Ta Dv XOFF (出力ストップ) 文字 .It "xn 文字列" Ta So Li ^Q Sc Ta Dv XON (出力開始) 文字 .It "Lo 文字列 C バナーメッセージでの \&%d のために用いるロケール" .El .Pp 以下のケーパビリティはもはや .Xr getty 8 によってサポートされていません。 .Bl -column 名称 文字列 /usr/bin/login .It "bd 数値 0 バックスペースでの遅延" .It "cb bool 偽 crt バックスペースモードを用いる" .It "cd 数値 0 復帰 (carriage return) での遅延" .It "fd 数値 0 フォームフィード (垂直移動) での遅延" .It "lc bool 偽 端末では小文字が使える" .It "nd 数値 0 改行 (ラインフィード) での遅延" .It "uc bool 偽 端末では大文字しか使えない" .El .Pp 回線速度が指定されていない場合、 getty が起動された時に設定されている速度は 変更されません。 入力速度または出力速度を指定したときは、 指定した方向の回線速度のみが上書き更新されます。 .Pp メッセージの出力時、ログイン名の入力時、 getty が処理を済ませて端末を手放す時に用いる 端末モードの値は ブール型フラグの指定に基づいて決定されます。 もしこの決定が適切でないことが分かった場合、 これら3つのどれか (あるいはすべて) の値は、数値指定 .Em \&c0 , .Em \&c1 , .Em \&c2 , .Em \&i0 , .Em \&i1 , .Em \&i2 , .Em \&l0 , .Em \&l1 , .Em \&l2 , .Em \&o0 , .Em \&o1 , または .Em \&o2 のどれかで上書きされます。 これらの数値指定では、フラグの値 (通常は、0 を頭につけた 8 進数) そのものを指定することができます。 これらのフラグは termio の .Em c_cflag , .Em c_iflag , .Em c_lflag , および .Em c_oflag の各フィールドにそれぞれ対応します。 それらのセットの各々は、完全に指定しなければ有効になりません。 .Em \&f0 , .Em \&f1 , および .Em \&f2 はTTYサブシステムの旧版の実装に対する後方互換性を意図した物です。 これらのフラグには、sgttyb の .Em sg_flags フィールドの (32ビット) 値の下位16ビットが含まれます。また、上位16ビットは ローカルモードを収めるワードを表します。 .Pp もし .Xr getty 8 がナル文字 (回線ブレークを示すものと見なされます) を受け取った場合、 プログラムは .Em nx エントリに示されたテーブルを用いて再始動します。 もしこのエントリがなければ、今まで用いていたテーブルを再び用います。 .Pp 遅延はミリ秒単位で指定し、tty ドライバが使用可能な遅延のうち最も 近いものが用いられます。 より大きな確実性が必要な場合は、0 から 1, 2, 3 までの値の 遅延はドライバの特別な遅延アルゴリズムから選択するものと解釈されます。 .Pp .Em \&cl 画面消去文字列には、その前に必要な遅延時間をミリ秒単位の (10 進数) 数値で (termcap 風に) 書くことができます。 この遅延はパディング文字 .Em \&pc を繰り返して用いることによりシミュレートされます。 .Pp 初期化メッセージ .Em \&im ログインメッセージ .Em \&lm および初期化ファイル .Em \&if は、以下の文字の並びをどれでも含めることができます。これらは .Xr getty 8 が実行されている環境から得た情報に展開されます。 .Pp .Bl -tag -offset indent -width \&%xxxxxxxxxxxxxx .It \&%d 現在の日付と時間を、 .Em \&Lo 文字列で指定したロケールでの表記法 ( .Xr strftime 3 の \&%+ フォーマット) で表したもの。 .It \&%h マシンのホスト名。通常は .Xr gethostname 3 によってシステムから得ますが、テーブルの .Em \&hn エントリで指定して、この値を書き換えることができます。 どちらの場合でも、これは .Em \&he 文字列を用いて編集することができます。 .Em \&he 文字列の中にある 1 個の '@' は 実際のホスト名から最終的なホスト名に 1文字のコピーを引き起こします。 .Em \&he 文字列中の '#' は実際のホスト名の次の1文字をスキップさせます。 '@' でも '#' でもない各文字は最終的なホスト名にコピーされます。 余分な '@' と '#' は無視されます。 .It \&%t tty の名前。 .It "\&%m, \&%r, \&%s, \&%v" それぞれ、 .Xr uname 3 が返す マシンの型、オペレーティングシステムのリリース、オペレーティングシステムの 名前、そしてカーネルのバージョンです。 .It \&%% 1個の .Dq % 文字。 .El .Pp getty がログインプロセス (通常は .Dq Pa /usr/bin/login ですが、 .Em \&lo 文字列で指定されていればそれ)を実行するとき、このプロセスの環境には .Em \&tt 文字列 (が存在すれば) で指定した 端末の型が設定されます。 .Em \&ev 文字列は、プロセスの環境にデータを追加するために使用することができます。 これはコンマで区切られた文字列からなり、それぞれは、 .Em name=value という形式になっていると仮定されます。 .Pp もしタイムアウトとして、 .Em \&to に 0 以外の値を指定した場合、 指定された秒数経過した後に終了します。 すなわち、getty はログイン名を受け取って制御を .Xr login 1 に渡すか、または alarm シグナルを受け取って終了します。 これはダイアルイン回線をハングアップするために有用です。 .Pp .Xr getty 8 からの出力は、 .Em \&op か .Em \&np が指定された場合を除いて、偶数パリティを用います。 .Em \&op 文字列と .Em \&ap を一緒に指定すると、 入力としてはパリティが何であっても許可し、出力としては奇数パリティを 生成します。 注意: これは、getty が実行されているときのみ適用され、端末ドライバの 制限によりここまで完全な実装ができないかもしれません。 .Xr getty 8 は .Dv RAW モードのときは入力文字のパリティ検査を行いません。 .Pp もし .Em \&pp 文字列が指定されていて、 PPP リンク確立シーケンスが認識されると、 getty は pp オプションで指定されているプログラムを起動します。 これは PPP 着信を取り扱うために用いることができます。 .Pp .Nm getty は以下の2つのケーパビリティを用いて利用できるチャットスクリプト機能を 提供します。これによって、 基本的なインテリジェントモデムをある程度取り扱えるようにします。 .Pp .Bl -tag -offset indent -width \&xxxxxxxx -compact .It ic モデムを初期化するチャットスクリプト。 .It ac コールに答えるチャットスクリプト。 .El .Pp チャットスクリプトは、受信を想定した文字列/送信する文字列の対の連なり からなります。チャット文字列が始まるとき、 .Nm getty は最初の文字列を待ち、その文字列を見つけたら 2 番目の文字列を送ります。 以後も同様に処理を進めます。 指定された文字列は 1 個以上のタブあるいはスペースで区切られています。 文字列には標準 ASCII 文字と、特別な「エスケープ」を含めることが できます。エスケープは、バックスラッシュに続き1文字以上の文字が 続いたもので、それは 以下のように解釈されます。 .Pp .Bl -tag -offset indent -width \&xxxxxxxx -compact .It \ea ベル文字。 .It \eb バックスペース。 .It \en 改行。 .It \ee エスケープ。 .It \ef フォームフィード。 .It \ep 0.5秒の一時停止。 .It \er 復帰文字。 .It \eS, \es 空白文字。 .It \et タブ。 .It \exNN 16 進数のバイト値。 .It \e0NNN 8 進数のバイト値。 .El .Pp .Ql \ep 文字列は送信文字列でのみ有効で、前の文字と次の文字を送る間に 0.5 秒の 一時停止を発生することに注意のこと。 16 進数値は最大で 16 進数 2 桁で、 8 進数値は最大で 8 進数 3 桁です。 .Pp .Em \&ic チャットシーケンスはモデムやそれに類似したデバイスを初期化するのに 用いられます。ヘイズ互換のコマンドセットを持つモデム用の初期化チャット スクリプトの典型例は、以下のようなものでしょう。 .Pp .Dl :ic="" ATE0Q0V1\er OK\er ATS0=0\er OK\er: .Pp このスクリプトは何も待たず (つまり常に成功し)、モデムが正しいモード (コマンドエコーを抑制し、応答を返す際に冗長モードで返す) に確実になるようなシーケンスを送り、それから自動応答を 切ります。 終了する前に、 "OK" という反応を待ちます。 この初期化シーケンスは、モデムの応答をチェックして モデムが正しく機能しているかを確かめるために 用いられます。 初期化スクリプトが完了するのに失敗した場合、 .Nm getty はこれを致命的な状態であると見なし、その結果として、 .Xr syslogd 8 を用いてログを残してから終了します。 .Pp 同様に、アンサーチャットスクリプトは (通常) "RING" に対して手動で電話に応答するために 用いることができます。 アンサースクリプトを指定して起動した場合、 .Nm getty はポートをノンブロッキングモードでオープンし、それ以前の余分な入力をすべて 消去し、ポートへのデータを待ちます。 何らかのデータが取得可能になるとすぐ、アンサーチャットスクリプトが 開始し、文字列がスキャンされ、アンサーチャットスクリプトに従って 応答します。 ヘイズ互換のモデムでは、スクリプトは通常以下のような感じのものになるでしょう。 .Pp .Dl :ac=RING\er ATA\er CONNECT: .Pp これは、"ATA" コマンドによってモデムに応答させ、続いて 入力をスキャンして文字列 "CONNECT" を探します。 もし .Em \&ct タイムアウトが生じる前にこの文字列を受け取った場合、 通常のログインシーケンスが開始されます。 .Pp .Em \&ct ケーパビリティはすべての送信文字列および想定される入力文字列 に適用されるタイムアウトの値を指定します。このタイムアウトは 文字列待ちを行うごと、および文字列送信を行うごとに設定されます。 少なくともリモートとローカルのモデムの間のコネクションが確立される のにかかる時間 (通常およそ10秒) だけの長さは必要です。 .Pp ほとんどの情況で、コネクションが検出された後に 追加の入力のすべてをフラッシュしたいと思うものですが、 この目的には .Em \&de ケーパビリティを使うことができます。これは、 コネクションが確立された後で短時間の遅延をかけ、 その間に接続データがすべてモデムによって送られてしまうのと 同じ効果を持ちます。 .Pp .Sh 関連項目 .Xr login 1 , .Xr gethostname 3 , .Xr uname 3 , .Xr termcap 5 , .Xr getty 8 , .Xr telnetd 8 . .Sh バグ 特殊文字 (文字消去、行削除など) は .Xr login 1 によってシステムのデフォルトに再設定されてしまいます。 .Em 常に、 ログイン名としてタイプした '#' あるいは '^H' は1文字消去として 扱われ、 '@' は行消去として扱われます。 .Pp 遅延機能は実クロックです。 全般的に柔軟性がないという問題はさておき、遅延アルゴリズムのいくつかは 実装されていません。 端末ドライバが正常な遅延の設定をサポートしている必要があります。 .Pp .Em \&he ケーパビリティは全く知的ではありません。 .Pp 忌まわしい .Xr termcap 5 フォーマットより、もっと合理的なものを選ぶべきでした。 .Sh 歴史 .Nm ファイルフォーマットは .Bx 4.2 で登場しました。 diff --git a/ja/man/man5/groff_font.5 b/ja/man/man5/groff_font.5 index 4abb9e0bbf..af5110dcdf 100644 --- a/ja/man/man5/groff_font.5 +++ b/ja/man/man5/groff_font.5 @@ -1,370 +1,370 @@ -.\" jpman $Id: groff_font.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: groff_font.5,v 1.3 1998/08/09 15:05:21 ryo2 Stab % .\" FreeBSD jpman project 訳語表 .\" WORD: machine unit マシン単位 .\" WORD: scaled point スケールドポイント (troff.1 の記述にあわせた) .\" WORD: font position フォント位置 (troff.1 の記述にあわせた) .\" WORD: mount マウント .ig \"-*- nroff -*- Copyright (C) 1989-1995 Free Software Foundation, Inc. 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. 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. 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. .. .de TQ .br .ns .TP \\$1 .. .\" Like TP, but if specified indent is more than half .\" the current line-length - indent, use the default indent. .de Tp .ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP .el .TP "\\$1" .. .TH GROFF_FONT 5 "7 September 1996" "Groff Version 1.10" .SH 名称 groff_font \- groff のデバイスとフォントを記述するファイルの書式 .SH 解説 groff のフォントの書式は ditroff のフォントの書式に対し、 ほぼスーパセットになっています。 ditroff のフォントの書式とは異なり、 関連したバイナリ書式はありません。 .I name というデバイス用のフォントファイルは .BI dev name というディレクトリに納められます。 ファイルには 2 つの種類があります: それは .B DESC と呼ばれるデバイス記述ファイルと、各フォント .I F ごとに存在する .IR F と呼ばれるフォントファイルです。 これらはテキストファイルであり、関連したバイナリ書式の ファイルはありません。 .SS DESC ファイルの書式 DESC ファイルは以下の形式の行を含むことができます: .TP .BI res\ n 1 インチあたりのマシン単位は .I n です。 .TP .BI hor\ n 水平解像度は .I n マシン単位です。 .TP .BI vert\ n 垂直解像度は .I n マシン単位です。 .TP .BI sizescale\ n ポイント数への倍率を指定します。デフォルトの値は 1 です。1 .I スケールドポイント は、1 .RI ポイント/ n と等しくなります。 .B unitwidth コマンドと .B sizes コマンドへの引数はスケールドポイントで指定されます。 .TP .BI unitwidth\ n ポイントサイズが .I n スケールドポイントのフォントに対して、 フォントファイル毎の数量をマシン単位で与えます。 .TP .B tcommand ポストプロセッサが .B t と .B u の出力コマンドを扱えることを表します。 .TP .BI sizes\ s1\ s2\|.\|.\|.\|sn\ 0 デバイスが .IR s1 , .IR s2 ,\|.\|.\|.\| sn スケールドポイントのフォントを持つことを表します。 大きさのリストは .BR 0 で終らなければなりません。 各 .BI s i は大きさの範囲 .IR m \- n でも指定できます。 リストは複数行にわたることも可能です。 .TP .BI styles\ S1\ S2\|.\|.\|.\|Sm 先頭 .I m 個のフォント位置が、スタイル .IR S1\|.\|.\|.\|Sm に関連づけられます。 .TP .BI fonts\ n\ F1\ F2\ F3\|.\|.\|.\|Fn フォント .I F1\|.\|.\|.\|Fn がフォント位置 .IR m +1,\|.\|.\|., m + n にマウントされます( .I m はスタイル数)。 このコマンドは複数行にわたることができます。 .B 0 というフォント名を指定すると、 対応するフォント位置にはフォントはマウントされません。 .TP .BI family\ fam デフォルトのフォントファミリは .IR fam です。 .TP .B charset この行とファイル内の以下に続く行はすべて無視されます。 これは下位互換性のために許されています。 .LP res, unitwidth, fonts, sizes の行は必須です。 他のコマンドは .B troff には無視されますが、デバイスに関する任意の情報を DESC ファイルに 入れておくためにポストプロセッサにより使われるかもしれません。 .SS フォントファイルの書式 フォントファイルには 2 つのセクションがあります。 最初のセクションは空白で区切られた単語が並んだ一連の行からなります。 行の最初の単語はキーで、以降の単語はそのキーに対する値となります。 .TP .BI name\ F フォントの名前は .IR F です。 .TP .BI spacewidth\ n 空白の通常の幅は .IR n です。 .TP .BI slant\ n フォントの文字が .I n 度傾斜していることを表します (正の値は進行方向を意味します)。 .TP .BI ligatures\ lig1\ lig2\|.\|.\|.\|lign\ \fR[ 0 \fR] 文字 .IR lig1 , .IR lig2 ,\|.\|.\|., lign は合字 (リガチャ; ligature) です。合字には .BR ff , .BR fi , .BR fl , .BR ffl が使用可能です。 下位互換性のために、合字のリストは .BR 0 で終ってもかまいません。 合字のリストは複数行にわたってはいけません。 .TP .B special フォントは .IR スペシャル です。これは現在のフォントに存在しない文字が要求された場合、 マウントされた全てのスペシャルフォントが検索されることを示しています。 .LP 他のコマンドは .B troff には無視されますが、フォントに関する任意の情報をフォントファイルに 入れておくためにポストプロセッサにより使われるかも知れません。 .LP 最初のセクションには .B # 文字ではじまるコメントを、行末まで入れることができます。 .LP 次のセクションには 1 つか 2 つのサブセクションが含まれます。 サブセクション .I charset は必須で、サブセクション .I kernpairs はオプションです。 これらのサブセクションは任意の順番で書くことができます。 各サブセクションは、サブセクション名のみからなる行から始まります。 .LP 単語 .B charset で charset サブセクションを開始します。 .B charset 行には一連の行が続きます。 各行は 1 文字の情報を与えます。 行は空白かタブにより区切られたいくつかのフィールドから成ります。 書式は .IP .I name metrics type code comment .LP で、 .I name は文字を識別します: .I name が単一の文字 .I c ならば、それは groff の入力文字 .I c を表します。 .BI \e c という形式で c が単一の文字なら、groff の入力文字 .BI \e c を表します。それ以外は groff の入力文字 .BI \e[ name ] を表します (2 文字の .I xx だとすると、 .BI \e( xx として入力されます) 。 groff は 8 ビット文字に対応していますが、いくつかのユーティリティでは 8 ビット文字を扱うのが困難です。 このような理由から、文字コードが .I n である単一の文字と等価な .BI char n という表記法が存在します。 例えば、 .B char163 は ISO Latin-1 で英国ポンド記号を表す文字コード 163 の文字と等価です。 .B \-\-\- という name は特別で、その文字に名前が無いことを示します。 そのような文字は .BR troff 中でエスケープシーケンス .B \eN によってのみ使われます。 .LP .I type フィールドは文字の種類を示します: .TP 1 は descender (ベースラインより下にはみ出した部分) を持つ 文字であることを表します。例えば p があてはまります。 .TP 2 は ascender (x の高さより上に出る部分) を持つ文字であることを表します。 例えば b があてはまります。 .TP 3 は ascender と descender の両方を持つ文字であることを表します。 例えば ( があてはまります。 .LP .I code フィールドはポストプロセッサが文字を印字するために使うコードを示します。 .B \eN というエスケープシーケンスを用いたこのコードを使って、groff に文字を 入力することもできます。 code はどんな整数でもかまいません。 .B 0 から始まると、8 進数として扱われ、 .B 0x や .B 0X で始まると 16 進数として扱われます。 .LP 行の code フィールド以降はすべて無視されます。 .LP .I metrics フィールドの形式はこのようになります: .IP .IR width [\fB, height [\fB, depth [\fB, italic_correction [\fB, \ left_italic_correction [\fB, subscript_correction ]]]]] .LP サブフィールド間には空白を入れてはいけません。 サブフィールドが存在しない場合は 0 として扱われます。 サブフィールドは全て 10 進数の整数で指定されます。 対応するバイナリフォーマットが存在しないので、 ditroff のようにこれらの値を .B char 型変数の範囲に合わせるという必要はありません。 サブフィールド .I width では文字の幅を指定します。 サブフィールド .I height では文字の高さを指定します (上が正)。 文字がベースラインよりも上にいかない場合、負の高さを持つとするのではなく 高さが 0 であるとします。 サブフィールド .I depth では文字の深さを指定します。これはベースラインから文字の一番下までの 長さです (下が正) 。 文字がベースラインより下に出ていない場合、負の深さを持つとするのではなく 深さが 0 であるとします。 サブフィールド .I italic_correction では直後にローマンフォントの文字が続く時に、文字の後に加えられる空白の 量を指定します。 サブフィールド .I left_italic_correction では直前にローマンフォントの文字がある時に、文字の前に加えられる空白の 量を指定します。 サブフィールド .I subscript_correction では添字 (subscript) を加える際に文字の後に加えられる空白の量を 指定します。 これはイタリック補正 (上記の italic_correction) よりは少なくなければ なりません。 .LP charset セクション内では、以下のような書式の行も可能です .IP .I name \fB" .LP これは .I name が前の行で言及した文字の別名であることを表します。 .LP kernpairs セクションは .B kernpairs という単語から始まります。このセクションは以下のような書式の 行からなります: .IP .I c1 c2 n .LP 文字 .I c1 が文字 .I c2 の次に現れる時には、それらの間の空白に .IR n を加えることを意味します。 kernpairs セクションのほとんどのエントリは .IR n に負の値を持つことになります。 .SH 関連ファイル .Tp \w'/usr/share/groff_font/devname/DESC'u+3n .BI /usr/share/groff_font/dev name /DESC デバイス .IR name 用のデバイス記述ファイル .TP .BI /usr/share/groff_font/dev name / F デバイス .IR name のフォント .I F 用のフォントファイル .SH 関連項目 .BR groff_out (5), .BR troff (1). diff --git a/ja/man/man5/groff_out.5 b/ja/man/man5/groff_out.5 index acb339d5e5..dfe9d9ec74 100644 --- a/ja/man/man5/groff_out.5 +++ b/ja/man/man5/groff_out.5 @@ -1,226 +1,226 @@ '\" e .ig \"-*- nroff -*- Copyright (C) 1989-1995 Free Software Foundation, Inc. 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. 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. 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. .. .\" This man page must be preprocessed with eqn. .\" -.\" jpman $Id: groff_out.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: groff_out.5,v 1.3 1998/08/09 15:06:44 ryo2 Stab % .\" FreeBSD jpman project 訳語表 .\" WORD: scaled point スケールドポイント (troff.1, groff_font.5 参照) .\" WORD: special character 特殊文字 (troff.1 参照) .\" WORD: special font スペシャルフォント (troff.1 参照) .\" WORD: machine unit マシン単位 (pic.1, groff_font.5 参照) .\" WORD: print 印字 .ie \n(.g .ds ic \/ .el .ds ic \^ .TH GROFF_OUT 5 "11 May 1998" "Groff Version 1.10" .SH 名称 groff_out \- groff の中間出力フォーマット .SH 解説 このマニュアルページは、GNU troff の出力フォーマットについて記述します。 GNU troff が使用する出力フォーマットは、 UNIX のデバイス非依存 troff が使用するものと似ています。 ここでは両者の差のみを記述します。 .LP .B s コマンドへの引数はスケールドポイントです (これは .IR ポイント/ n を意味します。 .I n は DESC ファイル中の .B sizescale コマンドへの引数です)。 .B x\ Height コマンドへの引数もまたスケールドポイントです。 .LP 最初の 3 つの出力コマンドは次のようになっていなければなりません: .IP .BI x\ T\ device .br .BI x\ res\ n\ h\ v .br .B x init .LP DESC ファイル中に .B tcommand 行が存在する場合には、troff は以下の 2 つのコマンドを使用します。 .TP .BI t xxx .I xxx は、任意の文字のシーケンスであり、空白または改行を終端とします; 最初の文字を現在位置で印字し、 現在の水平位置を最初の文字の幅だけ増加させます。 続けて、同じ処理を各文字に対して実行します。 文字の幅は、フォントファイルにおいて与えられたものを 現在のポイントサイズに応じて適切にスケーリングしてから、 水平解像度の倍数となるように丸めます。 特殊文字はこのコマンドでは印字できません。 .TP .BI u n\ xxx .B t コマンドと同様ですが、各文字の印字後に現在の水平位置に加えられるものが、 文字幅と .IR n の和である点が違います。 .LP 単一文字は 8 ビット目がセットされていてもかまわないことに注意してください。 これはフォント名や特殊文字名にもあてはまります。 .LP 文字名やフォント名は任意の長さが許されます; ドライバはこれらの長さが 2 文字のみであると仮定してはなりません。 .LP 文字を印字する時、その文字は常に現在のフォント中に存在します。 デバイス非依存 troff とは異なり、 ドライバがスペシャルフォントから文字を探す必要はありません。 .LP .B D 描画コマンドは拡張されています。 .B \-n オプション指定時には、GNU pic はこれらの拡張を使用しません。 .TP \fBDf \fIn\fR\*(ic\en オブジェクトの塗り潰しに使用する陰影を .IR n に設定します; ここで .I n は 0 から 1000 の範囲の整数である必要があり、0 は白の塗り潰しを、 1000 は黒の塗り潰しを、 そしてそれらの間の値は中間の陰影を意味します。 この設定は、円の塗り潰し、楕円の塗り潰し、多角形の塗り潰しにのみ適用されます。 デフォルトでは 1000 が使用されます。 塗り潰しオブジェクトが色を持つ場合、 その色でそのオブジェクトの下の全てのものを完全に隠します。 1000 より大きい値や 0 より小さい値も使用される可能性があります: これらの値を指定すると、 現在線やテキストで使用している陰影で塗り潰すことを意味します。 通常はこれは黒ですが、 ドライバによってはこれを変更する手段を提供するものがあります。 .TP \fBDC \fId\fR\*(ic\en 現在位置を最左端とする、半径 .I d の塗り潰された円を描画します。 .TP \fBDE \fIdx dy\fR\*(ic\en 現在位置を最左端とする、水平半径 .I dx 垂直半径 .I dy の塗り潰された楕円を描画します。 .EQ delim $$ .EN .TP \fBDp\fR $dx sub 1$ $dy sub 1$ $dx sub 2$ $dy sub 2$ $...$ $dx sub n$ $dy sub n$\en $i = 1 ,..., n+1$ に対し、 .I i 番目の頂点を現在位置 $+ sum from j=1 to i-1 ( dx sub j , dy sub j )$ とする多角形を描画します。 今のところ、GNU pic のみがこのコマンドを使用し、三角形と矩形を生成します。 .TP \fBDP\fR $dx sub 1$ $dy sub 1$ $dx sub 2$ $dy sub 2$ $...$ $dx sub n$ $dy sub n$\en .B Dp と同様ですが、多角形の外形のみの描画でなく、塗り潰しも行います。 .TP \fBDt \fIn\fR\*(ic\en 現在の線の太さを .I n マシン単位に設定します。 伝統的に UNIX troff ドライバは、 現在のポイントサイズに比例する線の太さを使用します; .B Dt コマンドが指定されない場合や、 .B Dt コマンドに負の .IR n が指定された場合は、ドライバはこの方法を使用する必要があります。 .I n に 0 を指定すると、利用可能な最小の線の太さを選択します。 .LP これらのコマンドを実行した後、 現在位置をどのように変更するのかという問題が生じます。 GNU pic が生成するコードはこの問題に依存しませんので、 これはたいして重要ではありません。 .IP \fB\eD\(fm\fIc\fR $x sub 1$ $y sub 1$ $x sub 2$ $y sub 2$ $...$ $x sub n$ $y sub n$\(fm .LP の形式、ただし .I c は .BR c , .BR e , .BR l , .BR a , .BR ~ のいずれでもない描画コマンドが与えられた時、 UNIX troff は各 $x sub i$ を水平の単位で扱い、$y sub i$ を垂直の単位で扱い、 描画されるオブジェクトの幅は $sum from i=1 to n x sub i$ であり、 高さは $sum from i=1 to n y sub i$ であると仮定します。 (高さに関する仮定は、このような .B D コマンドを \ew エスケープシーケンス中で使用した後、 .B st レジスタおよび .B sb レジスタを検査することにより確認できます。) この規則は全てのオリジナルの描画コマンドにあてはまりますが、 .B De は例外です。 .BR Df , .B Dt コマンドや、影響は少ないですが .B DE コマンドにおいて、たとえ醜い結果となったとしても、 GNU troff もまた互換性のためにこの規則に従います。 それゆえ、 .IP \fBD\fIc\fR $x sub 1$ $y sub 1$ $x sub 2$ $y sub 2$ $...$ $x sub n$ $y sub n$\en .LP の形式の .B D コマンドを実行した後は、現在位置は $( sum from i=1 to n x sub i , sum from i=1 to n y sub i )$ だけ増えます。 .LP .B x\ X コマンドへの引数に改行を含めることを許すという、 継続に関する取り決めがあります: .B x\ X コマンドへの引数を出力する時、GNU troff は 引数中の .B + 文字付きの改行を辿ります (通常は改行で引数全体が終端されます); それゆえ、 .B x\ X コマンドを含む行の次行が .B + で開始する場合には、 .B x\ X コマンドを含む行の終端となっている改行は .B x\ X コマンドへの引数の一部として扱い、 .B + を無視し、行の .B + に続く部分を .B x\ X コマンドに続く行の部分として扱います。 .SH "関連項目" .BR groff_font (5) diff --git a/ja/man/man5/group.5 b/ja/man/man5/group.5 index ad6e268e39..362a6acff6 100644 --- a/ja/man/man5/group.5 +++ b/ja/man/man5/group.5 @@ -1,149 +1,149 @@ .\" 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: @(#)group.5 8.3 (Berkeley) 4/19/94 .\" %Id: group.5,v 1.4.2.2 1998/06/28 21:34:26 hoek Exp % -.\" jpman $Id: group.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: group.5,v 1.3 1998/07/02 14:08:51 horikawa Stab % .\" .Dd September 29, 1994 .Dt GROUP 5 .Os .Sh 名称 .Nm group .Nd グループ許可ファイルのフォーマット .Sh 解説 .Aq Pa /etc/group ファイルは改行で区切られた .Tn ASCII レコードから成ります。1 レコードが 1 グループに対応し、コロン .Ql \&: で区切られた 4 つの欄から成ります。 これらの欄の意味は以下のとおりです: .Bl -tag -width password -offset indent -compact .It group そのグループの名前。 .It passwd グループの .Em 暗号化された パスワード。 .It gid そのグループの 10 進数 ID。 .It member グループメンバ。 .El .Pp .Ar group 欄は、そのグループのメンバであるユーザにファイルアクセスを許可するために 用いる、グループの名前です。 .Ar gid 欄はそのグループ名に結び付けられた番号です。両者はファイルアクセスを制御 しますので、システム (またしばしば複数システムの 1 グループ) 中で一意的で ある必要があります。 .Ar passwd 欄はなくてもいい .Em 暗号化された パスワードです。この欄はめったに用いられるこ とはなく、通常ブランクにしておくよりもむしろアスタリスクが置かれます。 .Ar member 欄は .Ar group の権利を許可されたユーザの名前を含んでいます。メンバ名は空白や改行なし にコンマで区切られます。ユーザの .Pa /etc/passwd エントリ中にグループが指定されていれば自動的にそのグループに入ることに なりますので、 .Pa /etc/group ファイル中にそのユーザを追加する必要はありません。 .\" .Pp .\" When the system reads the file .\" .Pa /etc/group .\" the fields are read into the structure .\" .Fa group .\" declared in .\" .Aq Pa grp.h : .\" .Bd -literal -offset indent .\" struct group { .\" char *gr_name; /* group name */ .\" char *gr_passwd; /* group password */ .\" int gr_gid; /* group id */ .\" char **gr_mem; /* group members */ .\" }; .\" .Ed .Sh YP/NIS との相互作用 .Pa /etc/group ファイルは YP/NIS グループデータベースを有効にするように作成可能です。 C ライブラリ内部としては、 .Ar name 欄が 1 つのプラス符号 (`+') に続く 1 つのグループ名から成るエントリは、 その名前のグループに対する YP/NIS グループエントリで置き換えられます。 .Ar name 欄が引き続いてグループ名を持たない 1 つのプラス符号から成るエントリは、 YP/NIS の .Dq Li group.byname マップ全体で置き換えられます。 .Pp 何らかの理由で YP/NIS グループデータベースが有効になった場合、 少数のグループのみが有効であるときですら、全ての逆検索 (すなわち .Fn getgrgid ) ではデータベース全体を利用することになるでしょう。それ故、 .Fn getgrgid が返すグループ名が正しい前方マッピングを持つことは保証できません。 .Sh 制限 1 つのグループは 200 以上のメンバを持つことはできません。 .Pa /etc/group の最大行長は 1024 文字です。それより長い行は読み飛ばされます。 .Sh 関連ファイル .Bl -tag -width /etc/group -compact .It Pa /etc/group .El .Sh 関連項目 .Xr passwd 1 , .Xr setgroups 2 , .Xr crypt 3 , .Xr getgrent 3 , .Xr initgroups 3 , .Xr yp 4 , .Xr passwd 5 .Sh バグ .Xr passwd 1 コマンドは .Nm group パスワードを変更しません。 .Sh 歴史 .Nm ファイルフォーマットは .At v6 で現われました。 YP/NIS の機能は .Tn SunOS を手本に作られ、 .Tn FreeBSD 1.1 で初めて現われました。 diff --git a/ja/man/man5/hosts.5 b/ja/man/man5/hosts.5 index 2ddfbb8e9c..a3f2bde98e 100644 --- a/ja/man/man5/hosts.5 +++ b/ja/man/man5/hosts.5 @@ -1,102 +1,102 @@ .\" 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. .\" .\" @(#)hosts.5 8.2 (Berkeley) 12/11/93 .\" %Id: hosts.5,v 1.2.2.2 1998/06/28 21:34:26 hoek Exp % .\" -.\" jpman $Id: hosts.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: hosts.5,v 1.3 1998/06/12 15:52:05 kumano Stab % .Dd December 11, 1993 .Dt HOSTS 5 .Os BSD 4.2 .Sh 名称 .Nm hosts .Nd ホスト名データベース .Sh 解説 .Nm hosts ファイルはネットワーク上の既知のホストに関する情報を保持します。 各ホストに対して、1つの行に以下の情報を与えます。 .Bd -unfilled -offset indent インターネットアドレス 正式なホスト名 別名 .Ed .Pp 各項目は任意の数の空白やタブ文字で区切られます。 ``#'' はコメントの開始を表し、これ以降の行末までの文字はこの ファイルを検索するルーチンによって解釈されません。 .Pp ネームサーバ .Xr named 8 使用時には、このファイルはネームサーバが動作していない時の予備として 機能します。 ネームサーバのために、ごく少数のアドレスがこのファイルに含まれて いなければなりません。 これらはブート時に .Xr ifconfig 8 が必要とするローカルインタフェースのアドレス、およびローカルネットワーク 上の少数のマシンを含みます。 .Pp このファイルは Network Information Control Center .Pq Tn NIC で保守された正式なホストデータベースから作成されますが、非公式な別名や 未知のホストに関しては、ローカルでの変更を最新に保つ必要があります。 .Tn NIC で保守されたデータベースは不完全なので、 .Tn DARPA インターネット上のサイトではネームサーバの使用が推奨されます。 .Pp ネットワークアドレスは、インターネットアドレス操作ライブラリ .Xr inet 3 の .Xr inet_addr 3 ルーチンを用いた伝統的な ``.'' (ドット) 表記で指定されます。 ホスト名は、フィールド区切り文字、改行、およびコメント文字 以外のあらゆる印字可能文字を含むことができます。 .Sh 関連ファイル .Bl -tag -width /etc/hosts -compact .It Pa /etc/hosts .Nm hosts ファイルは .Pa /etc に存在します。 .El .Sh 関連項目 .Xr gethostbyname 3 , .Xr ifconfig 8 , .Xr named 8 .Rs .%T "Name Server Operations Guide for BIND" .Re .Sh 歴史 .Nm ファイルフォーマットは .Bx 4.2 から登場しました。 diff --git a/ja/man/man5/hosts.equiv.5 b/ja/man/man5/hosts.equiv.5 index e093198303..a141911bf4 100644 --- a/ja/man/man5/hosts.equiv.5 +++ b/ja/man/man5/hosts.equiv.5 @@ -1,124 +1,124 @@ .\" 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: hosts.equiv.5,v 1.2.2.2 1998/06/28 21:34:26 hoek Exp % .\" -.\" jpman $Id: hosts.equiv.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: hosts.equiv.5,v 1.3 1998/06/12 11:02:12 mutoh Stab % .Dd Feb 1996 .Dt HOSTS.EQUIV 5 .Os FreeBSD .Sh 名称 .Nm hosts.equiv , .Nm .rhosts .Nd 信頼できるリモートホスト名、およびユーザのデータベース .Sh 解説 .Nm hosts.equiv および .Nm .rhosts ファイルは、ネットワーク上の信頼できるホストとユーザに関する情報を格納 します。 各ホストに対して、1つの行に以下の情報を与えます。 単純に .Bd -unfilled -offset indent hostname [username] .Ed あるいは、より冗長に以下のようにします。 .Bd -unfilled -offset indent [+-][hostname|@netgroup] [[+-][username|@netgroup]] .Ed .Pp ``@'' は netgroup というグループによってホスト、またはユーザを表します。 単独の ``+'' は全てのホスト、またはユーザと一致します。 前に ``-'' を伴うホスト名は、一致する全てのホストとそのホスト上の全ての ユーザを拒否します。 前に ``-'' を伴うユーザ名は、指定されたホスト上の一致したユーザ全てを 拒否します。 .Pp 各項目は任意の数の空白やタブ文字で区切られます。 ``#'' はコメントの開始を表し、これ以降の行末までの文字はこのファイルを 検索するルーチンによって解釈されません。 .Pp ホスト名は、インターネットアドレス操作ライブラリ .Xr inet 3 の .Xr inet_addr 3 ルーチンを用いた伝統的な ``.'' (ドット) 表記で指定されます。 ホスト名は、フィールド区切り文字、改行、およびコメント文字 以外のあらゆる印字可能文字を含むことができます。 .Pp セキュリティ上の理由から、ユーザの .Nm .rhosts が通常ファイルでないか、所有者がそのユーザでないか、あるいはその ユーザ以外のユーザが書き込み可能な場合、そのファイルは無視されます。 .Sh 使用例 .Pp .Dl bar.com foo .Pp ホスト ``bar.com'' の ユーザ ``foo'' を信頼します。 .Pp .Dl +@allclient .Pp ネットグループ ``allclient'' の全てのホストを信頼します。 .Pp .Dl +@allclient -@dau .Pp ネットグループ ``allclient'' の全てのホストとそのユーザを信頼しますが、 ネットグループ ``dau'' のユーザは例外です。 .Sh 関連ファイル .Bl -tag -width /etc/hosts.equivxxx -compact .It Pa /etc/hosts.equiv .Nm hosts.equiv ファイルは .Pa /etc に存在します。 .It Pa $HOME/.rhosts .Nm .rhosts ファイルは .Pa $HOME に存在します。 .El .Sh 関連項目 .Xr rcp 1 , .Xr rlogin 1 , .Xr rsh 1 , .Xr gethostbyname 3 , .Xr inet 3 , .Xr innetgr 3 , .Xr ruserok 3 , .Xr yp 4 , .Xr ifconfig 8 , .Xr named 8 .Sh バグ このマニュアルページは不完全です。 より詳細については、 lib/libc/net/rcmd.c のソースか、 SunOS の マニュアルページを参照してください。 diff --git a/ja/man/man5/hosts.lpd.5 b/ja/man/man5/hosts.lpd.5 index 14fa7fc27d..21e4b10261 100644 --- a/ja/man/man5/hosts.lpd.5 +++ b/ja/man/man5/hosts.lpd.5 @@ -1,57 +1,57 @@ .\" 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: hosts.lpd.5,v 1.2.2.1 1997/03/07 04:18:06 mpp Exp % -.\" jpman $Id: hosts.lpd.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: hosts.lpd.5,v 1.3 1998/04/29 11:35:23 kuma Stab % .\" .\" WORD: trusted host 信頼できるホスト .\" .Dd June 1, 1996 .Dt HOSTS.LPD 5 .Os FreeBSD .Sh 名称 .Nm hosts.lpd .Nd ローカルプリントサービスを使用可能な信頼できるホスト .Sh 解説 .Nm hosts.lpd ファイルは、あなたのマシンのローカルプリントサービスを許可するホストの ホスト名もしくは IP アドレスのリストを含みます。 ホスト名および IP アドレスは、各々 1 行に 1 つずつ記述します。 .Sh 関連ファイル .Bl -tag -width /etc/hosts.lpdxxxxx -compact .It Pa /etc/hosts.lpd .Nm hosts.lpd ファイルは .Pa /etc にあります。 .Sh 関連項目 .Xr printcap 5 , .Xr lpd 8 . diff --git a/ja/man/man5/intro.5 b/ja/man/man5/intro.5 index 29e5b712c5..521bca75e0 100644 --- a/ja/man/man5/intro.5 +++ b/ja/man/man5/intro.5 @@ -1,58 +1,58 @@ .\" 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: intro.5,v 1.2 1997/02/16 16:36:31 mpp Exp % -.\" jpman $Id: intro.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: intro.5,v 1.3 1998/04/29 11:34:46 kuma Stab % .\" .\" WORD: configuration file 構成ファイル .\" .Dd February 16, 1997 .Dt INTRO 5 .Os FreeBSD 2.2 .Sh 名称 .Nm intro .Nd "ファイルフォーマットの手引" .Sh 解説 このセクションにはファイルフォーマットの情報が書かれています。 .Sh 関連項目 .Xr apropos 1 , .Xr intro 1 , .Xr intro 8 .Sh 関連ファイル .Bl -tag -width /etc/shells -compact .It Pa /etc ほとんどのシステム構成ファイルが置かれる場所 .El .Sh 歴史 .Nm intro セクションマニュアルページは .Fx 2.2 から登場しました。 diff --git a/ja/man/man5/kernfs.5 b/ja/man/man5/kernfs.5 index 3f4026e87e..5411aca7a8 100644 --- a/ja/man/man5/kernfs.5 +++ b/ja/man/man5/kernfs.5 @@ -1,138 +1,138 @@ .\" Copyright (c) 1996 .\" Mike Pritchard . 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 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: kernfs.5,v 1.2.2.4 1998/07/19 06:52:11 jkh Exp % .\" -.\" jpman $Id: kernfs.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: kernfs.5,v 1.3 1998/07/21 23:04:50 jsakai Stab % .\"WORD: machine independent 機種に依存しない .\"WORD: decimal ASCII ASCII 表記の 10 進数 .\"WORD: mount point マウントポイント .\" .Dd December 14, 1996 .Dt kernfs 5 .Os BSD 4.4 .Sh 名称 .Nm kernfs .Nd カーネルファイルシステム .Sh 書式 .Bd -literal kern /kern kernfs rw 0 0 .Ed .Sh 解説 カーネルファイルシステム .Nm kernfs は、現在実行中のカーネルに関する情報へのアクセス手段を提供するものです。 これは通常 .Pa /kern にマウントされます。 このファイルシステムは読み取り可能な数個の通常ファイルを含んでおり、 これらのファイルの一部には書き込むこともできます。 ファイルの内容は文字列と ASCII 表記の 10 進整数からなり、 機種に依存しない書式になっています。 数値が返されるときは、後ろに改行文字が付け加えられます。 .Pp マウントポイントには以下のファイルが含まれます。 .Bl -tag -width copyright .It Pa bootfile 現在のカーネルが起動したパス。 .It Pa boottime システムが最後に起動した時間 (ASCII 表記の 10 進数)。 .It Pa copyright カーネルの著作権標示。 .It Pa hostname 現在のホスト名。後ろに改行がつきます。 このファイルに書き込むことにより、現在のホスト名を変更することが できます。 ホスト名に後続する改行文字は書き込み時には取り除かれます。 .It Pa hz システムクロックの周波数 (ASCII 表記の 10 進数)。 .It Pa loadavg 過去 1 分間、5 分間および 15 分間のロードアベレージで、カーネル固定小数点 フォーマットで表されます。最後の整数は固定小数のスケーリングファクタ です。全ての数値は ASCII 10 進数で表されます。 .It Pa pagesize マシンのページサイズ (ASCII 10進数)。 .It Pa physmem マシンの物理メモリのページ数 (ASCII 表記の 10 進数)。 .It Pa root システムのルートディレクトリ。chroot した環境では、 .Xr mount_kernfs 8 を、新しい .Pa /kern マウントポイントを生成するために用いることができます。 .Pa /kern/root はカレントプロセスのルートではなく、システム全体のルートを示すことに なる予定です。現在はまだ利用できません。 .It Pa rootdev ルートデバイス。現在はまだ利用できません。 .It Pa rrootdev raw ルートデバイス。現在はまだ利用できません。 .It Pa time システムクロックの秒数およびマイクロ秒数 (ASCII 表記の 10 進数)。 .It Pa version カーネルのバージョン文字列。 .Pa /etc/motd のヘッドラインは .Dq Ic "sed 1q /kern/version" を実行することによって生成することができます。 .El .Pp .Nm によって得られる情報のほとんどは .Xr sysctl 8 からも入手可能です。 .Sh 関連ファイル .Bl -tag -width /kern/XXXXXXX .It Pa /kern .Nm kernfs のための通常のマウントポイント。 .El .Sh 関連項目 .Xr sysctl 3 , .Xr mount_kernfs 8 , .Xr sysctl 8 .Sh 歴史 .Nm ファイルシステムは .Bx 4.4 で最初に登場しました。 .Nm マニュアルページは .Fx 2.2 で最初に登場しました。 .Sh 作者 .Nm マニュアルページは .An Mike Pritchard Aq mpp@FreeBSD.org によって書かれたもので、 .An Jan-Simon Pendry による .Xr mount_kernfs 8 マニュアルページに基づいています。 diff --git a/ja/man/man5/keycap.5 b/ja/man/man5/keycap.5 index 6c4f63e99a..37c5de613e 100644 --- a/ja/man/man5/keycap.5 +++ b/ja/man/man5/keycap.5 @@ -1,128 +1,128 @@ .\" .\" Copyright (c) 1992,1993,1994 Hellmuth Michaelis .\" .\" Copyright (c) 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. .\" .\"WORD: keyboard mapping キーボードマッピング .\"WORD: .Sh CAPABILITIES ケーパビリティ .\" .\" @(#)keycap.5, 3.00, Last Edit-Date: [Sun Jan 2 13:45:59 1994] -.\" jpman $Id: keycap.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: keycap.5,v 1.3 1998/06/22 10:45:11 kumano Stab % .\" %Id: keycap.5,v 1.2.2.1 1997/01/02 17:48:10 mpp Exp % .\" .Dd January 3, 1993 .Dt KEYCAP 5 .Sh 名称 .Nm keycap .Nd キーボードマッピングデータベース .Sh 書式 .Nm keycap .Sh 解説 .Nm keycap ファイルはキーボードマッピングを記述するデータベースで、 .Xr kcon 1 が用います。 .Pp .Nm keycap のエントリは `:' で区切られた多数のフィールドからなります。 各マッピングの最初のエントリは、そのマッピングの名称として 認識される名前を、文字 `|' で区切って並べたものです。 最初と最後以外の全ての名前は全部小文字で、空白文字を含まない必要があります。 最後の名前は可読性を高めるために、大文字や空白文字を含めることができます。 .Sh ケーパビリティ .Pp .Bl -column indent indent .Sy 名称 型 解説 .It "de bool キーボードマッピングをコンパイル時に入れたデフォルトにリセットする" .It "D bool キー を完全に使用不可にする" .It "m num ALT キーのキー番号を指定する .It "l num ALTGR キーのキー番号を指定する .It "h num SHIFT キーのキー番号を指定する .It "t num CONTROL キーのキー番号を指定する .It "ca num CAPS LOCK キーのキー番号を指定する .It "sh num SHIFT LOCK キーのキー番号を指定する .It "nl num NUM LOCK キーのキー番号を指定する .It "sc num SCROLL LOCK キーのキー番号を指定する .It "K str シフトなし (通常) のキーに文字列を対応させる .It "S str シフト (SHIFT キーと同時に押す) 時のキーに文字列を対応させる .It "C str CONTROL キーと同時に押したときの文字列を対応づける .It "A str ALTGR キーと同時に押したときの文字列を対応づける .It "tc str 指定箇所以外が同じマップを持つエントリ \- 最後に指定する必要があります。" .El キー番号を記述するパラメータ は 1 から 128 までの番号を取ることが できます。 文字列パラメータは 15 文字までの値を取ることができます。 .Pp .Ss エントリの例 以下のエントリはテスト用のエントリ記述で、 .Nm keycap ファイルの中のごく単純なエントリ記述の1つに、この記述通りのものが存在します。 .Pp .Bd -literal tt\||test\||Test entry which swaps y and z:\e :K22=z:S22=Z:C22=\e032:\e :K46=y:S46=Y:C46=\e031: .Ed .Pp 行の最後に \e を置くことによって、エントリを複数行に続けることができます。 コメントは .Dq # で始まる行に含めることができます。 .Sh 関連ファイル .Bl -tag -width /usr/share/misc/keycap.pcvt -compact .It Pa /usr/share/misc/keycap.pcvt キーボードマッピングの記述を含むファイル .El .Sh 関連項目 .Xr kcon 1 , .Xr keycap 3 .Sh 使用例 .Dq Li l1#60 は、 ALTGR キーのキー番号として、 60 を指定します。 .Dq Li K100=hugo は、キー番号 100 のキーに文字列 'hugo' を対応させます。 .Dq Li K100=^D は、キー番号 100 のキーにコントロール文字 EOT (0x04) を対応させます。 .Dq Li K100=\e000 は、キー番号 100 のキーにコントロール文字 NUL (0x00) を対応させます。 diff --git a/ja/man/man5/link.5 b/ja/man/man5/link.5 index dc33cd7145..6f80378dc5 100644 --- a/ja/man/man5/link.5 +++ b/ja/man/man5/link.5 @@ -1,617 +1,617 @@ .\" 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: link.5,v 1.7.2.4 1998/03/07 09:07:03 jkh Exp % -.\" jpman $Id: link.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: link.5,v 1.3 1998/08/09 12:52:25 horikawa Stab % .\" .Dd October 23, 1993 .Dt LINK 5 .Os .Sh 名称 .Nm link .Nd ダイナミックローダとリンクエディタインタフェース .Sh 書式 .Fd #include .Fd #include .Fd #include .Sh 解説 インクルードファイル .Aq Pa link.h では、ダイナミックにリンクされたプログラムやライブラリに含まれる 数種の構造体が宣言されています。 その構造体は、リンクエディタとローダ機構のいくつかの構成要素間の インタフェースを定義します。 バイナリ中でのこれらの構造体のレイアウトは 多くの点で a.out 形式に類似しており、 シンボル定義 (付随する文字列テーブルを含む) や外部エンティティへの参照を 解決するのに必要なリロケーションレコードといった、 よく似た機能を提供します。 それに加え、ダイナミックロードとリンク処理に固有のいくつかのデータ構造も 記録しています。このようなデータ構造としては、 リンクエディット処理を完結するのに必要な他のオブジェクトへの参照や、 異なるプロセス間でコードページの共有を進めるための .Em 位置独立コード (Position Independent Code 略して PIC) を機能させるための 間接テーブルがあります。 ここで述べるデータ構造全体を .Em ランタイムリロケーションセクション (RRS) と呼び、ダイナミックにリンクされるプログラムや共有オブジェクトの 標準テキスト及びデータセグメントに埋め込まれます。 これは、既存の .Xr a.out 5 形式には RRS のための場所が他にないからです。 .Pp あるプログラムを実行可能とする処理が、 システムリソースの使用を最適化しつつ正しく完了するよう、 複数のユーティリティが協調して働きます。 コンパイラは PIC コードを出力し、 それから .Xr ld 1 によって共有ライブラリが作られます。 コンパイラはまた、初期化される各データアイテムのサイズ情報を アセンブラディレクティブ .size を用いて記録します。 PIC コードは、ある間接テーブルを通じてデータ変数にアクセスする点で 従来のコードと異なっています。 この表はグローバルオフセットテーブルと呼ばれ、 慣習によって、予約名 .Em _GLOBAL_OFFSET_TABLE_ によってアクセス可能です。 ここで用いられるメカニズムの詳細は機種依存ですが、通常は そのマシンのレジスタ 1 本がこの用途に予約されます。 このような仕組みの背景にある合理性は、 実際のロードアドレスとは独立したコードを生成することです。 実行時には、アドレス空間において様々な共有オブジェクトがロードされるアドレス に応じて、グローバルオフセットテーブルに含まれる値のみ変更すればよいのです。 .Pp 同様に、大域的に定義された関数の呼び出しは、 コアイメージのデータセグメント中に置かれている プロシージャリンケージテーブル (PLT) を通じて間接的に行われます。 これもまた、実行時にテキストセグメントを修正せずに済ませるためのものです。 .Pp リンクエディタがグローバルオフセットテーブルとプロシージャリンケージテーブルを 配置するのは、 複数の PIC オブジェクトファイルを結合して プロセスのアドレス空間にマップするのに適した 1 つのイメージにする時です。 リンクエディタはまた、実行時のリンクエディタが必要とする全てのシンボルを集め、 それらをイメージのテキストとデータのビット列と共にストアします。 もう 1 つの予約シンボル .Em _DYNAMIC は、実行時のリンク構造が存在することを示すのに用いられます。 _DYNAMIC が 0 にリロケートされる場合は、実行時リンクエディタを起動する 必要はありません。 もし _DYNAMIC が非 0 なら、_DYNAMIC は、必要なリロケーション情報と シンボル情報の位置を引き出すことができるデータ構造を指しています。 これは特に、スタートアップモジュール .Em crt0 で利用されます。 慣習として、_DYNAMIC 構造体は、 それが属するイメージのデータセグメントの最初に置かれます。 .Pp .Sh データ構造 ダイナミックリンクと実行時リロケーションをサポートするデータ構造は、 それらの処理の適用対象イメージのテキスト及びデータセグメントの 両方の中にあります。 テキストセグメントにはシンボル記述や名前といった読み取り専用データが含まれ、 他方データセグメントにはリロケーション処理で更新する必要のあるテーブル類が 含まれます。 .Pp シンボル _DYNAMIC は .Fa _dynamic 構造体を参照します: .Bd -literal -offset indent struct _dynamic { int d_version; struct so_debug *d_debug; union { struct section_dispatch_table *d_sdt; } d_un; struct ld_entry *d_entry; }; .Ed .Bl -tag -width d_version .It Fa d_version このフィールドは異なったバージョンのダイナミックリンク実装用に 提供されています。 .Xr ld 1 及び .Xr ld.so 1 が理解する現在のバージョン番号は、 .Tn SunOS 4.x リリースで用いられている .Em LD_VERSION_SUN (3) と、 .Fx 1.1 以来使用されている .Em LD_VERSION_BSD (8) です。 .It Fa d_un .Em d_version に応じたデータ構造を参照します。 .It Fa so_debug このフィールドは、 共有オブジェクトのシンボルテーブルをアクセスするためのフックを デバッガに提供します。 この共有オブジェクトは、 実行時リンクエディタの処理の結果ロードされたものです。 .El .Pp .Fa section_dispatch_table 構造体がメインとなる .Dq ディスパッチャ テーブルであり、 イメージ内で様々なシンボル情報やリロケーション情報が置かれるセグメントへの オフセットを保持します。 .Bd -literal -offset indent struct section_dispatch_table { struct so_map *sdt_loaded; long sdt_sods; long sdt_filler1; long sdt_got; long sdt_plt; long sdt_rel; long sdt_hash; long sdt_nzlist; long sdt_filler2; long sdt_buckets; long sdt_strings; long sdt_str_sz; long sdt_text_sz; long sdt_plt_sz; }; .Ed .Pp .Bl -tag -width sdt_filler1 .It Fa sdt_loaded ロードされた最初のリンクマップ (後述) へのポインタ。 このフィールドは .Nm ld.so によって設定されます。 .It Fa sdt_sods .Em この オブジェクトが必要とする共有オブジェクトデスクリプタの (リンク) リストの先頭。 .It Fa sdt_filler1 使用しないで下さい (SunOS では ライブラリの検索ルールを指定するのに使用されていました)。 .It Fa sdt_got このイメージ中でのグローバルオフセットテーブルの位置。 .It Fa sdt_plt このイメージ中でのプロシージャリンケージテーブルの位置。 .It Fa sdt_rel 実行時のリロケーションを指定する .Fa relocation_info 構造体 .Po .Xr a.out 5 参照 .Pc の配列の位置。 .It Fa sdt_hash このオブジェクトのシンボルテーブルでシンボル検索を高速化するための ハッシュテーブルの位置。 .It Fa sdt_nzlist シンボルテーブルの位置。 .It Fa sdt_filler2 現在使用されていません。 .It Fa sdt_buckets .Fa sdt_hash 中のバケット数。 .It Fa sdt_strings .Fa sdt_nzlist に対応するシンボル文字列テーブルの位置。 .It Fa sdt_str_sz 文字列テーブルのサイズ。 .It Fa sdt_text_sz このオブジェクトのテキストセグメントのサイズ。 .It Fa sdt_plt_sz プロシージャリンケージテーブルのサイズ。 .El .Pp .Fa sod 構造体は、それを含むオブジェクトのリンクエディット処理を完了するのに 必要な共有オブジェクトを記述します。 そのようなオブジェクトのリスト .Po .Fa sod_next で連結されます .Pc は section_dispatch_table 構造体の .Fa sdt_sods によって指し示されます。 .Bd -literal -offset indent struct sod { long sod_name; u_int sod_library : 1, sod_reserved : 31; short sod_major; short sod_minor; long sod_next; }; .Ed .Pp .Bl -tag -width sod_library .It Fa sod_name このリンクオブジェクトを記述する文字列の、 テキストセグメントにおけるオフセット。 .It Fa sod_library もし設定されていれば、 .Fa sod_name は .Nm ld.so が検索することになるライブラリを指定します。 そのパス名は、あるディレクトリ群 .Po .Xr ldconfig 8 参照 .Pc で .Em lib\&\&.so.n.m. にマッチする共有オブジェクトを検索することで得られます。 もし設定されていなければ、 .Fa sod_name は希望する共有オブジェクトに対するフルパス名を指し示す必要があります。 .It Fa sod_major ロードすべき共有オブジェクトのメジャーバージョン番号を指定します。 .It Fa sod_minor ロードすべき共有オブジェクトの希望するマイナーバージョン番号を指定します。 .El .Pp プロセスのアドレス空間にロードされる共有オブジェクト全てを追跡するために、 実行時リンクエディタは .Em リンクマップ と呼ばれる構造体のリストを管理しています。 これらの構造体は実行時にのみ用いられ、 実行可能ファイルや共有ライブラリのテキストあるいはデータセグメントには ありません。 .Bd -literal -offset indent struct so_map { caddr_t som_addr; char *som_path; struct so_map *som_next; struct sod *som_sod; caddr_t som_sodbase; u_int som_write : 1; struct _dynamic *som_dynamic; caddr_t som_spd; }; .Ed .Bl -tag -width som_dynamic .It Fa som_addr このリンクマップに対応する共有オブジェクトがロードされるアドレス。 .It Fa som_path ロードされるオブジェクトのフルパス名。 .It Fa som_next 次のリンクマップへのポインタ。 .It Fa som_sod この共有オブジェクトのロードをつかさどる .Fa sod 構造体。 .It Fa som_sodbase 将来のバージョンにおいては、実行時リンカに渡されます。 .It Fa som_write このオブジェクトのテキストセグメント (の一部分) が現在書き込み可能である 場合にセットされます。 .It Fa som_dynamic このオブジェクトの .Fa _dynamic 構造体へのポインタ。 .It Fa som_spd 実行時リンクエディタが管理するプライベートデータと連結するためのフック。 .El .Pp サイズ付きシンボル記述。 これは単に .Fa nlist 構造体にフィールド .Pq Fa nz_size を 1 つ追加したものです。 共有オブジェクトのデータセグメントにあるアイテムの サイズ情報を伝達するのに用いられます。 この構造体の配列は共有オブジェクトのテキストセグメントに存在し、 そのアドレスは .Fa section_dispatch_table の .Fa sdt_nzlist フィールドで指定されます。 .Bd -literal -offset indent struct nzlist { struct nlist nlist; u_long nz_size; #define nz_un nlist.n_un #define nz_strx nlist.n_un.n_strx #define nz_name nlist.n_un.n_name #define nz_type nlist.n_type #define nz_value nlist.n_value #define nz_desc nlist.n_desc #define nz_other nlist.n_other }; .Ed .Bl -tag -width nz_size .It Fa nlist .Po .Xr nlist 3 参照 .Pc 。 .It Fa nz_size このシンボルで表現されるデータのサイズ。 .El .Pp 実行時のリンクエディットで行われるシンボル検索を高速化するため、 共有オブジェクトのテキストセグメントにハッシュテーブルが含まれています。 .Fa section_dispatch_table の .Fa sdt_hash フィールドは .Fa rrs_hash 構造体を指し示します: .Bd -literal -offset indent struct rrs_hash { int rh_symbolnum; /* シンボル番号 */ int rh_next; /* 次のハッシュエントリ */ }; .Ed .Pp .Bl -tag -width rh_symbolnum .It Fa rh_symbolnum 共有オブジェクトのシンボルテーブル ( .Fa ld_symbols で与えられます) での当該シンボルのインデックス。 .It Fa rh_next 衝突が起きたとき、このフィールドはこのハッシュテーブルのバケットにおける 次のエントリのオフセットを保持します。 最終バケット要素の場合は 0 となります。 .El .Fa rt_symbol 構造体は、 実行時にアロケートされるコモン(commons)と 共有オブジェクトからコピーされるデータアイテムを 追跡するのに用いられます。 これらのアイテムはリンクリストで管理され、デバッガでの利用のために .Fa so_debug 構造体 (後述) 中の .Fa dd_cc フィールドによって公開されます。 .Bd -literal -offset indent struct rt_symbol { struct nzlist *rt_sp; struct rt_symbol *rt_next; struct rt_symbol *rt_link; caddr_t rt_srcaddr; struct so_map *rt_smp; }; .Ed .Pp .Bl -tag -width rt_scraddr .It Fa rt_sp シンボル記述。 .It Fa rt_next 次の rt_symbol の仮想アドレス。 .It Fa rt_link ハッシュバケットにおける次の要素。 .Nm ld.so の内部で用いられます。 .It Fa rt_srcaddr 共有オブジェクト中での初期化済データのソース位置。 .It Fa rt_smp この実行時シンボルが記述するデータの元のソースとなる共有オブジェクト。 .El .Pp .Fa so_debug 構造体は、 実行時リンクエディットの結果、当該プロセスのアドレス空間にロードされた あらゆる共有オブジェクトの情報を得るために、 デバッガによって利用されます。 実行時リンクエディタはプロセスの初期化処理の一部として実行されるため、 共有オブジェクトからシンボルにアクセスしようとするデバッガは、 crt0 からリンクエディタが呼ばれた後でのみそれが可能となります。 ダイナミックリンクされているバイナリは .Fa so_debug 構造体を持っています。この構造体の場所は .Fa _dynamic 中の .Fa d_debug フィールドで指示されます。 .Bd -literal -offset indent struct so_debug { int dd_version; int dd_in_debugger; int dd_sym_loaded; char *dd_bpt_addr; int dd_bpt_shadow; struct rt_symbol *dd_cc; }; .Ed .Pp .Bl -tag -width dd_in_debugger .It Fa dd_version このインタフェースのバージョン番号。 .It Fa dd_in_debugger 当該プログラムがデバッガの制御下にあることを実行時リンカに知らせるために デバッガによってセットされます。 .It Fa dd_sym_loaded 共有オブジェクトをロードすることで実行時リンカがシンボルを追加した場合、 実行時リンカによってセットされます。 .It Fa dd_bpt_addr デバッガに制御を移すために実行時リンカによってセットされる ブレークポイントアドレス。 このアドレスは、_main 呼び出しの前に、スタートアップモジュール .Em crt0.o によってある適切な場所に決定されます。 .It Fa dd_bpt_shadow アドレス .Fa dd_bpt_addr にあった元の機械命令を保持します。 デバッガは、プログラム実行を再開する前にこの機械命令を元に戻すことに なっています。 .It Fa dd_cc デバッガが必要とする可能性のある、実行時にアロケートしたシンボルの リンクリストへのポインタ。 .El .Pp .Em ld_entry 構造体は .Nm ld.so 中のサービスルーチン一式を定義します。 .\" See .\" .Xr libdl.a .\" for more information. .Bd -literal -offset indent struct ld_entry { void *(*dlopen)(char *, int); int (*dlclose)(void *); void *(*dlsym)(void *, char *); char *(*dlerror)(void); }; .Ed .Fa crt_ldso 構造体は、crt0 中のスタートアップコードと .Nm ld.so との間のインタフェースを定義します。 .Bd -literal -offset indent struct crt_ldso { int crt_ba; int crt_dzfd; int crt_ldfd; struct _dynamic *crt_dp; char **crt_ep; caddr_t crt_bp; char *crt_prog; char *crt_ldso; struct ld_entry *crt_ldentry; }; #define CRT_VERSION_SUN 1 #define CRT_VERSION_BSD_2 2 #define CRT_VERSION_BSD_3 3 #define CRT_VERSION_BSD_4 4 .Ed .Bl -tag -width crt_dzfd .It Fa crt_ba crt0 によって .Nm ld.so がロードされた仮想アドレス。 .It Fa crt_dzfd SunOS では、このフィールドは .Dq Pa /dev/zero へのオープンされたファイル記述子を保持し、 0 クリアされたデマンドページを得ます。 .Tn FreeBSD ではこのフィールドは -1 を保持します。 .It Fa crt_ldfd .Nm ld.so をロードするために crt0 が用いる、オープンされたファイル記述子 を保持します。 .It Fa crt_dp main の .Fa _dynamic 構造体へのポインタ。 .It Fa crt_ep 環境文字列へのポインタ。 .It Fa crt_bp メインプログラムがデバッガで実行される場合、 実行時リンカがブレークポイントを置くアドレス。 .Fa so_debug を参照してください。 .It Fa crt_prog crt0 で決定されるメインプログラムの名前 (CRT_VERSION_BSD3 のみ)。 .It Fa crt_ldso crt0 でマップされる実行時リンカのパス (CRT_VERSION_BSD4 のみ)。 .El .Pp .Fa hints_header 構造体及び .Fa hints_bucket 構造体は、通常 .Dq Pa /var/run/ld.so.hints に置かれるライブラリヒントのレイアウトを定義します。 ライブラリヒントは、ファイルシステム中で共有オブジェクトイメージの在処を すばやく見つけるために .Nm ld.so によって利用されます。 ヒントファイルの構成は .Dq a.out とそれほど異なりません。つまりヒントファイルは、 固定長ハッシュバケットのオフセットとサイズを決定するためのヘッダと、 共通の文字列プールを持っています。 .Bd -literal -offset indent struct hints_header { long hh_magic; #define HH_MAGIC 011421044151 long hh_version; #define LD_HINTS_VERSION_1 1 long hh_hashtab; long hh_nbucket; long hh_strtab; long hh_strtab_sz; long hh_ehints; }; .Ed .Bl -tag -width hh_strtab_sz .It Fa hh_magic ヒントファイルのマジックナンバ。 .It Fa hh_version インタフェースのバージョン番号。 .It Fa hh_hashtab ハッシュテーブルのオフセット。 .It Fa hh_strtab 文字列テーブルのオフセット。 .It Fa hh_strtab_sz 文字列テーブルのサイズ。 .It Fa hh_ehints ヒントファイルで利用可能な最大オフセット。 .El .Pp .Bd -literal -offset indent /* * ヒントファイルのハッシュテーブル要素 */ struct hints_bucket { int hi_namex; int hi_pathx; int hi_dewey[MAXDEWEY]; int hi_ndewey; #define hi_major hi_dewey[0] #define hi_minor hi_dewey[1] int hi_next; }; .Ed .Bl -tag -width hi_ndewey .It Fa hi_namex ライブラリを指定する文字列のインデックス。 .It Fa hi_pathx ライブラリのフルパス名を表す文字列のインデックス。 .It Fa hi_dewey 共通ライブラリのバージョン番号。 .It Fa hi_ndewey .Fa hi_dewey 中の有効エントリ数。 .It Fa hi_next ハッシュ衝突の際の次のバケット。 .El .Sh 警告 現在のところ、共有ライブラリ生成をサポートしているのは (GNU) C コンパイラ のみです。他のプログラミング言語では利用できません。 diff --git a/ja/man/man5/login.access.5 b/ja/man/man5/login.access.5 index 7b436ce1bf..3b44941375 100644 --- a/ja/man/man5/login.access.5 +++ b/ja/man/man5/login.access.5 @@ -1,56 +1,56 @@ .\" this is comment -.\" jpman $Id: login.access.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: login.access.5,v 1.3 1998/04/29 11:37:56 kuma Stab % .\" .\" WORD: access granted アクセス許可(許可された状態) .\" .Dd April 30, 1994 .Dt LOGIN.ACCESS 5 .Os FreeBSD 1.2 .Sh 名称 .Nm login.access .Nd ログインアクセス制御表 .Sh 解説 .Nm ファイルは、ログインを許可または拒否する (ユーザ, ホスト) の組や (ユーザ, tty) の組を指定します。 .Pp 誰かがログインする際に、 .Nm から (ユーザ, ホスト) の組にマッチする最初のエントリを探します。 非ネットワークログインの場合には、 (ユーザ, tty) の組にマッチする最初のエントリを探します。 表のエントリ中のパーミッションフィールドは、 ログインを許可するか拒否するかを決定します。 .Pp ログインアクセス制御表の各行は、":" 文字で区切られる 次のような 3 フィールドから成ります: パーミッション : ユーザ : 起点 .Pp 第 1 フィールドは、"+" (アクセス許可) もしくは "-" (アクセス不許可) の 文字です。 第 2 フィールドは、ログイン名・グループ名・ALL (常にマッチ) を 1 つ以上含むリストです。 第 3 フィールドは、tty 名 (非ネットワークログイン用)・ホスト名・ ドメイン名 ("." から開始)・ホストアドレス・インターネットのネットワーク番号 ("." で終了)・ALL (常にマッチ)・LOCAL ("." を含まない文字列にマッチ) を 1 つ以上含むリストです。 NIS 使用時には、ホストおよびユーザの指定に @netgroupname を使用できます。 .Pp EXCEPT 演算子を使用すると、非常に小さいルールを記述できます。 .Pp 名前がログインしたユーザ名にマッチしない場合のみ、 グループファイルが検索されます。 ユーザが明示的にリストされている グループのみがマッチします。 このプログラムはユーザのプライマリグループ ID 値を見ません。 .Sh 関連ファイル .Bl -tag -width /etc/login.access -compact .It Pa /etc/login.access .Nm ファイルは .Pa /etc にあります。 .El .Sh 関連項目 .Xr login 1 .Sh 作者 Guido van Rooij diff --git a/ja/man/man5/login.conf.5 b/ja/man/man5/login.conf.5 index 0533a67a82..6f654f9e3e 100644 --- a/ja/man/man5/login.conf.5 +++ b/ja/man/man5/login.conf.5 @@ -1,354 +1,354 @@ .\" Copyright (c) 1996 David Nugent .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, is permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice immediately at the beginning of the file, without modification, .\" 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. This work was done expressly for inclusion into FreeBSD. Other use .\" is permitted provided this notation is included. .\" 4. Absolutely no warranty of function or purpose is made by the author .\" David Nugent. .\" 5. Modifications may be freely made to this file providing the above .\" conditions are met. .\" .\" %Id: login.conf.5,v 1.8.2.7 1998/02/21 23:36:10 fenner Exp % -.\" jpman $Id: login.conf.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: login.conf.5,v 1.3 1998/07/21 23:10:00 jsakai Stab % .\" .Dd November 22, 1996 .Dt LOGIN.CONF 5 .Os FreeBSD .Sh 名称 .Nm login.conf .Nd ログインクラス ケーパビリティ データベース .Sh 書式 .Pa /etc/login.conf , .Pa ~/.login_conf .Sh 解説 login.conf には、ログインクラスについてのさまざまな属性やケーパビリティが 含まれています。 ログインクラス (ユーザアカウントデータベースである .Pa /etc/master.passwd のそれぞれの行について自由に設定できる注釈) は、セッションの アカウンティングやリソース制限、ユーザ環境設定などを決定します。 ログインクラスはシステム内のさまざまなプログラムから利用され、 ユーザのログイン環境を設定するほか、 ポリシー、アカウンティング及び管理上の制限を設定します。 ログインクラスはまた、 システムや利用可能な種々の認証機構に対するユーザ認証手段を提供します。 .Pp システムのユーザクラスケーパビリティデータベースである .Pa /etc/login.conf の中の "default" という特別なレコードは、 .Pa /etc/master.passwd 内に有効なログインクラスを持たない root 以外のすべてのユーザに よって自動的に使われます。有効なログインクラスを持たない uid が 0 の ユーザは、"root" レコードが存在する場合はそのレコードが、 存在しない場合は "default" レコードがログインクラスとして使われます。 .Pp FreeBSD においては、個々のユーザは .Pa .login_conf というファイルをホームディレクトリに作成することができます。 このファイルは (/etc/login.conf と) 同じフォーマットで、 レコード id が "me" である 1 エントリのみで構成されます。 もし .login.conf が存在するならば、このファイルは .Xr login 1 によって使用され、システムのログインケーパビリティデータベースによって 指定されたユーザ環境設定を上書き設定します。 その際、ログインケーパビリティのサブセット、 典型的には承認やリソース制限そしてアカウンティングを含まないもの のみが上書きされます。 .Pp クラスケーパビリティデータベースのレコードは、コロンで区切られた いくつかのフィールドから構成されています。 各レコードの最初のフィールドは、レコードを特定するための 1 つまたは複数の名前で、それらは '|' 文字で区切られます。 その最初の名前が、最も一般化された短縮名称です。 最後の名前は、ログインケーパビリティエントリをより分かりやすく説明した 長い名前であるべきで、他の名前はその同義語です。 すべての名前は小文字かつ空白を含まないようにすべきですが、 最後の名前は可読性を考慮して、大文字やブランクを含んでいてもよいでしょう。 .Pp ケーパビリティデータベースのフォーマットについての詳細な説明は .Xr getcap 3 を参照してください。 .Sh ケーパビリティ データベース内のそれぞれの行に含まれるフィールドは、 .Xr getcap 3 の慣習に従い、ブール型、文字列型 .Ql \&= 数値型 .Ql \&# があります。 しかしながら数値データのところは、数値型が拒否され文字列型が 受け入れられることがあったり、両方の書式が両方の書式が受け入れられることも あります。 値は次のカテゴリに分類されます。 .Bl -tag -width "program" .It file データファイルへのパス名 .It program 実行可能ファイルへのパス名 .It list コンマや空白で区切られた値のリスト (または値の組) .It path 普通の csh の慣習に従った、空白やコンマで区切られたパス名のリスト (先頭のユーザ名を伴う/伴わないチルダはホームディレクトリに展開される等) .It number 10進数(デフォルト)、16進数(0xで始まる)、または 8進数(0で始まる)の 数値型の値。数値型の場合、設定できる値は 1 つだけです。 数値型は文字列型のフォーマットでも指定できる場合があります (ケーパビリティタグ '#' の代わりに '=' で値が区切られているなど)。 どの方法が使われた場合でも、データベース中のすべての行は修正したい行の値を 正確に上書きするために、同じ方法を用いなければなりません。 .It size サイズを表す文字。単位のデフォルトの解釈はバイトで、サフィックスに よって別の単位を指定できます。 .Bl -tag -offset indent -compact -width xxxx .It b 512バイトブロックの明示的な指定 .It k キロバイトの指定 (1024バイト) .It m 1 メガバイトの乗数の指定 (1048576 バイト) .It g ギガバイト単位の指定。そして .It t テラバイトの記述。 .El サイズの値は数値であり、サフィックスの大文字小文字は重要ではありません。 連続した値は足し込まれます。 .It time 時間の期間。デフォルトの単位は秒。 プレフィックスによって別の単位を指定できます。 .Bl -tag -offset indent -compact -width xxxx .It y 1 年を 365 日で数えた年数の指定 .It w 週の数の指定 .It d 日数 .It h 時間数 .It m 分数 .It s 秒数 .El 連続した値は足し込まれます。 たとえば 2 時間 40 分は 9600s、160m または 2h40m と 表現することができます。 .El .Pp 特別な .Em tc=value 表記を使用することにより、通常の約束事であるケーパビリティエントリの 補間が可能です。 .Pp .Sh リソース制限 .Bl -column coredumpsize indent indent .Sy Name Type Notes Description .It cputime time CPU 使用制限 .It filesize size ファイルサイズの最大値制限 .It datasize size データサイズの最大値制限 .It stacksize size スタックサイズの最大値制限 .It coredumpsize size コアダンプサイズの最大値制限 .It memoryuse size コアメモリ使用量の最大値制限 .It memorylocked size コアメモリロック可能量の最大値制限 .It maxproc number プロセス数の最大値制限 .It openfiles number プロセスごとにオープンできるファイル数の最大値制限 .El .Pp これらのリソース制限エントリは、実際には最大値と現在の 制限値の両方を指定します ( .Xr getrlimit 2 を参照してください)。 普通は現在の制限値 (ソフトリミット) が使われますが、 ユーザは現在の制限値を最大制限値 (ハードリミット) まで増やすことが 許されています。 最大制限値と現在の制限値はケーパビリティ名に各々 -max 及び -cur を 追加することによって指定できます。 .Pp .Sh 環境 .Bl -column ignorenologin indent xbinxxusrxbin .Sy Name Type Notes Description .It charset string $MM_CHARSET 環境変数の明示的な設定値 .It hushlogin bool false ~/.hushlogin ファイルがある場合と同じ .It ignorenologin bool false nologin によってログインを禁止されません .It lang string $LANG 環境変数を指定した値に設定します .It manpath path マニュアルページのデフォルト検索パス .It nologin file このファイルが存在する場合、ファイルの内容が画面に表示され、そのログインセッションは終了されます .It path path /bin /usr/bin デフォルトコマンド検索パス .It priority number 優先度 (nice) レベルの初期値 .It requirehome bool false ログインのために有効なホームディレクトリが必要 .It setenv list コンマで区切られた環境変数とその設定値のリスト .It shell prog パスワードファイルで指定されているシェルより優先して実行されるセッションシェル。SHELL 環境変数の値は、パスワードファイルで指定されているものになります。 .It term string su 他の手段によって決定できない場合のデフォルトの端末タイプ .It timezone string $TZ 環境変数のデフォルト値 .It umask number 022 umask の初期値。続く数字が 8進数と解釈されるように、常に 0 から始めます .It welcome file /etc/motd ウェルカムメッセージが入っているファイル .El .Pp .Sh 認証 .Bl -column minpasswordlen indent indent .Sy Name Type Notes Description .It minpasswordlen number 6 ローカルパスワード文字列長の最小値 .\" .It approve program Program to approve login. .It auth list passwd 許可される認証形式。 最初の値がデフォルトの形式になります。 .It auth- list 'type' で指定された認証タイプで許可される認証形式。 .It copyright file 追加のコピーライト情報を含んだファイル .\".It widepasswords bool false Use the wide password format. The wide password .\" format allows up to 128 significant characters in the password. .It host.allow list クラス内のユーザがアクセス可能なリモートホストワイルドカードのリスト .It host.deny list クラス内のユーザがアクセス不可なリモートホストワイルドカードのリスト .It times.allow list ログインが許されている時間帯のリスト .It times.deny list ログインが許されない時間帯のリスト .It ttys.allow list クラス内のユーザがアクセスに使用できる端末と端末グループのリスト .It ttys.deny list クラス内のユーザがアクセスに使用不可な端末と端末グループのリスト .El .Pp これらのフィールドは、ログイン認証システムの中で .Xr passwd 1 や、その他のプログラムから使用される予定です。 .Pp 環境変数を設定するケーパビリティは、その中の文字 .Ql \&~ と .Ql \&$ の両方がスキャンされ、これらはそれぞれ ユーザのホームディレクトリ及びユーザ名に置換されます。 環境変数中にこれらの文字をそのまま含める場合には、 その前にバックスラッシュ '\\' をつけてエスケープします。 .Pp .Em host.allow と .Em host.deny エントリはコンマで区切られたリストで、システムへのリモートアクセスの チェックに使われます。 これらはホスト名か IP アドレスまたはその両方を含むリストからなり、 それらに対してリモートログインのチェックが行われます。 このリストの各項目は、ワイルドカード一致用にシェルプログラムが使用しているのと 同じ書式のワイルドカードを含むことができます (実装の詳細は .Xr fnmatch 3 を参照してください)。 ホストのチェックは、リモートシステムのインターネットアドレス と (もし有効なら) ホスト名の両方をつきあわせて行われます。 両方のリストが空かもしくは指定されていない場合、あらゆるリモートホスト からのログインは許可されます。 host.allow が 1 つかそれ以上のホストを含む場合、リスト中の 各項目のどれかにマッチしたリモートシステムのみがログインを許されます。 host.deny が 1 つかそれ以上のホストを含む場合、そのリストのどれかに マッチしたホストからのログインが禁止されます。 .Pp .Em times.allow と .Em times.deny エントリはコンマで区切られた期間のリストであり、この期間はクラス内の ユーザがログインを許されます。 これらは 1 つ以上の日のコード指定と、これに続けて 24 時間表記の開始時刻と 終了時刻をハイフンまたはダッシュで区切ったものとして表現されます。 たとえば MoThSa0200-1300 は、月、木、土の 午前 2 時から午後 1 時と解釈されます。 これらの時間指定リストの両方が空だった場合、クラス内のユーザはいつでもアクセス 可能になります。 .Em times.allow が指定されている場合、ログインは指定された期間のみ許可されます。 もし .Em times.deny が指定されている場合、 .Em times.allow の中で期間が指定されているかどうかに関わらず、指定された期間は ログインできなくなります。 .Pp .Xr login 1 が強制することは、これらのエントリにより許可された期間内に実際の ログインが行なわれることのみである点に注意して下さい。 セッションの生存期間に関して更なる規制をかけるには、別のデーモンを用意し、 許可されている期間から許可されていない期間への 遷移を監視する必要があります。 .Pp .Em ttys.allow と .Em ttys.deny エントリは、クラス内のユーザがシステムにアクセスするために使う コンマで区切られた(/dev/ プレフィックスを除く)端末デバイスと、 端末グループ (ttygroup) のリストです (ttygroup の詳細は .Xr getttyent 3 と .Xr ttys 5 を参照して下さい)。 どちらのエントリも存在しない場合、ユーザが使用するログインデバイスの選択には 制限はありません。 .Em ttys.allow のみ指定されている場合、ユーザの使えるデバイスは指定されたグループ またはデバイスリストのみに制限されます。 .Em ttys.deny のみ指定されている場合、ユーザは指定されたデバイスやデバイス グループを使用できません。 両方が与えられていてかつどちらも空でない場合、ユーザは ttys.allow で指定されていて、ttys.deny では指定されていないデバイス群のみ 使用できます。 .Sh アカウント制限 .Bl -column passwordperiod indent indent .Sy Name Type Notes Description .It accounted bool false このクラス内の全ユーザの セッション時間アカウウンティングを有効化 .It autodelete time アカウント失効後自動で削除されるまでの時間 .It bootfull bool false セッション終了時の「ttygroup が一杯の場合にのみブート」戦略を 有効にする .It daytime time 1 日あたりのログイン最大時間 .It expireperiod time 期限切れまでの割り当て時間 .It graceexpire time 失効したアカウントの猶予日数 .It gracetime time 追加された、猶予ログイン許可時間 .It host.accounted list ログインセッションがアカウントされる リモートホストワイルドカードのリスト .It host.exempt list ログインセッションのアカウンティング を免除されたリモートホストワイルドカードのリスト .It idletime time ログアウトまでの最大アイドル時間 .It monthtime time 月毎の最大ログイン時間 .It passwordtime time パスワードが無効になるまでの時間 .It refreshtime time アカウントのリフレッシュ許可時間 .It refreshperiod str リフレッシュが行なわれる頻度 .It sessiontime time セッション毎の最大ログイン時間 .It sessionlimit number すべてのグループに対する tty 上の 同時最大ログイン数 .It ttys.accounted list ログインアカウントが有効な tty と ttygroup のリスト .It ttys.exempt list ログインアカウントが無効な tty と ttygroup のリスト .It warnexpire time 失効しそうなアカウントに対する事前の注意を 行なう時間 .It warnpassword time 失効しそうなパスワードに対する事前の 注意を行なう時間 .It warntime time 時間切れになりそうな場合に対する事前の注意を 行なう時間 .It weektime time 1 週間毎の最大ログイン時間 .El .Pp これらのフィールドは、ユーザのログインアクセスを規制、コントロール、記録する タイムアカウンティングシステムによって使われます。 .Pp .Em ttys.accounted と .Em ttys.exempt フィールドは、先に述べた .Em ttys.allow と .Em ttys.deny と同じような方法で状態を操作します。 .Em host.accounted と .Em host.exempt のリストも同様です。 .Sh 関連項目 .Xr login 1 , .Xr getcap 3 , .Xr getttyent 3 , .Xr login_cap 3 , .Xr login_class 3 , .Xr passwd 5 , .Xr ttys 5 diff --git a/ja/man/man5/magic.5 b/ja/man/man5/magic.5 index bcdea4a201..ab5572edef 100644 --- a/ja/man/man5/magic.5 +++ b/ja/man/man5/magic.5 @@ -1,230 +1,230 @@ .\" .\" @(#)%Id: magic.5,v 1.4.2.3 1998/07/16 23:52:12 jkh Exp % .\" .\" install as magic.4 on USG, magic.5 on V7 or Berkeley systems. .\" -.\" jpman $Id: magic.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: magic.5,v 1.3 1998/07/21 05:29:49 jsakai Stab % .Dd September 3, 1994 .Dt MAGIC 5 .Os "Public Domain" .Sh 名称 .Nm magic .Nd file コマンドのマジック番号ファイル .Sh 解説 このマニュアルページでは .Xr file 1 コマンド バージョン 3.22 で使用されるマジックファイルのフォーマットに ついて説明します。 .Nm file コマンドは、他のテストと共に、ファイルがある .Em "マジック番号" で始まっているかどうかをテストして、ファイルのタイプを識別します。 ファイル .Pa /usr/share/misc/magic では、どのマジック番号をテストするか、 あるマジック番号が見つかったときにどのようなメッセージを出力するか、 また、そのファイルから抽出するべき追加情報について指定しています。 .Pp このファイルの各行ではテストすべき項目について指定しています。 テストは、ファイル中のある特定のオフセットで始まるデータを 1 バイト、2 バイトもしくは 4 バイトの数値あるいは文字列と 比較して行います。 もしテストが成功するとメッセージが出力されます。 各行は以下のフィールドから構成されます。 .Bl -tag -width indent .It offset テストするファイルのデータのオフセットをバイト数で指定する数字です。 .It type テストするデータの型です。指定できる値は .Bl -tag -width indent .It byte 1 バイトの値。 .It short (ほとんどのシステムにおいて) 2 バイトの値。 そのマシンの固有のバイト順で指定します。 .It long (ほとんどのシステムにおいて) 4 バイトの値。 そのマシンの固有のバイト順で指定します。 .It string バイトの文字列。 .It date UNIX 日時として解釈される 4 バイトの値。 .It beshort (ほとんどのシステムにおいて) 2 バイトの値。 ビッグエンディアンのバイト順です。 .IP belong (ほとんどのシステムにおいて) 4 バイトの値。 ビッグエンディアンのバイト順です。 .IP bedate UNIX 日時として解釈される (ほとんどのシステムにおいて) 4 バイトの値。 ビッグエンディアンのバイト順です。 .IP leshort (ほとんどのシステムにおいて) 2 バイトの値。 リトルエンディアンのバイト順です。 .IP lelong (ほとんどのシステムにおいて) 4 バイトの値。 リトルエンディアンのバイト順です。 .IP ledate UNIX 日時として解釈される (ほとんどのシステムにおいて) 4 バイトの値。 リトルエンディアンのバイト順です。 .El .El .Pp 数字の型にはオプションとして .Em & と数値を続けることができ、 これにより比較を行う前に AND をとる数値を指定します。 型の前に .Em u を付加すると比較は符号なしで行なわれます。 .Bl -tag -width indent .It test ファイル中の値と比較される値。 型が数字の場合、この値は C 言語の形式で指定されます。 これが文字列の場合、 通常のエスケープ記法 (たとえば改行では\en) が可能な C 言語文字列として 指定されます。 .It "" 数値の前には実行される操作を示す文字を付加することができます。 その文字には ファイルの値が指定された値と等価であることを指定する .Em = 、ファイルの値が指定された値より小さいことを指定する .Em < 、ファイルの値が指定された値より大きいことを指定する .Em > 、指定された値の中でセットされているすべてのビットが ファイルでの値ですべてセットされていることを指定する .Em & 、指定された値の中でセットされているどれかのビットが ファイルでの値でオフであることを指定する .Em ^ 、何らかの値がマッチすることを指定する .Em x があります。 これらの文字がない場合は .Em = が指定されているものとみなされます。 .It "" 数値は C 言語の形式で指定されます。例えば .Em 13 は 10 進数、 .Em 013 は 8 進数、 .Em 0x13 は 16 進数となります。 .It "" 文字列値については、 ファイル中のバイト文字列は指定されたバイト文字列に マッチしなければなりません。 オペレータ .Em = と .Em < と .Em > ( .Em & を除く) が文字列に適用できます。 マッチングに使用される長さは マジックファイルでの文字列の引数の長さとなります。 これは .Em >\e0 とすることにより、 その行はどの文字列にもマッチすることが可能であり、 おそらくその文字列が出力されることを意味します (すべての文字列はヌル文字列より長いため)。 .It message 比較が成立したときに出力されるメッセージです。 文字列に .Xr printf 3 指定形式が含まれている場合は、ファイルから得た値 (指定されたマスクを 適用したもの) が、そのメッセージをフォーマット文字列として用いて出力さ れます。 .El .Pp いくつかのファイルフォーマットは、ファイルタイプと共に出力される追加情報 を含んでいます。文字 .Em > で始まる行は追加テストと出力されるメッセージを指定します。 その行での .Em > の数はテストのレベルを指定します。行頭に .Em > がない行はレベル 0 とみなされます。 レベル .Em n+1 の各行はマジックファイル中でその行より前にあるもっとも近いレベル .Em n の行の制御下にあります。レベル .Em n での行のテストが成功した場合、それに続く行で指定されたすべてのレベル .Em n+1 のテストが実施され、 それらのテストが成功するとメッセージが出力されます。 次のレベル .Em n の行でこれが終了します。 最後の .Em > に続く最初の文字が .Em ( であれば、その括弧の後の文字列は間接オフセットとして解釈されます。 これは括弧の後の数字がそのファイル中のオフセットとして使用されることを 意味します。そのオフセットでの値が読み込まれ、再度ファイルのオフセット として使用されます。間接オフセットは .Em (x[.[bsl]][+-][y]) の形式をとります。値 .Em x はファイル中でのオフセットとして使われます。 型指定子 .Em [bsl] によりそれぞれバイト、short もしくは long として読み込まれます。 その数字に値 .Em y が加算され、その結果はファイルの中でのオフセットとして使用されます。型 指定子がない場合は long がデフォルトの型となります。 .Pp オフセットは、その前にあるフィールドの長さに依存するため、 正確な値が分からない場合があります。 そのような場合は最後の上位レベルのフィールドの最後からの 相対的なオフセットを指定することができます。 (もちろんこれは下位レベルのテスト、すなわち .Em > で始まるテストでのみ可能です。) この場合の相対オフセットは .Em & をオフセットのプレフィックスとして使用して指定します。 .Sh バグ フォーマット .Em long , .Em belong , .Em lelong , .Em short , .Em beshort , .Em leshort , .Em date , .Em bedate , .Em ledate はシステムに依存します。 テストされるファイルは通常それらの長さが不変であるシステムのものであり、 これらはおそらくバイト数 (2B とか 4B とか) として指定すべきででょう。 .Pp 間接オフセットで使用されるエンディアンを指定したデータは (現在は) サポートされていません。 .Sh 関連項目 .Xr file 1 .\" .\" From: guy@sun.uucp (Guy Harris) .\" Newsgroups: net.bugs.usg .\" Subject: /etc/magic's format isn't well documented .\" Message-ID: <2752@sun.uucp> .\" Date: 3 Sep 85 08:19:07 GMT .\" Organization: Sun Microsystems, Inc. .\" Lines: 136 .\" .\" Here's a manual page for the format accepted by the "file" made by adding .\" the changes I posted to the S5R2 version. .\" .\" Modified for Ian Darwin's version of the file command. diff --git a/ja/man/man5/map3270.5 b/ja/man/man5/map3270.5 index de99a3655f..ca741f224d 100644 --- a/ja/man/man5/map3270.5 +++ b/ja/man/man5/map3270.5 @@ -1,338 +1,338 @@ .\" 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. .\" .\" @(#)map3270.5 8.4 (Berkeley) 6/1/94 -.\" jpman $Id: map3270.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: map3270.5,v 1.3 1998/06/13 12:33:46 horikawa Stab % .\" .\" WORD: terminal 端末 .\" WORD: caret キャレット (`^' のこと) .\" WORD: column tab カラムタブ .TH MAP3270 5 "June 1, 1994" .UC 6 .SH 名称 map3270 \- ASCII のキー入力を IBM 3270 キーにマッピングするためのデータベース .SH 書式 .B map3270 .SH 解説 IBM タイプの 3270 端末を \s-1UNIX\s0 でエミュレーションする場合 (\fItn3270\fR(1) 参照)、 ユーザが (ASCII) キーボードを押すシーケンスと 3270 で使用可能なキーの間でマッピングを行わなければなりません。 例えば、3270には .B EEOF とラベルされたキーがあり、これはカーソル位置から終わりまでの 現在のフィールドの内容を消去するものです。 この機能を実現するためには、 .B EEOF 機能を起動するためにタイプするキーについて、 端末のユーザと 3270 をエミュレートしているプログラムが 合意しておく必要があります。 .PP これらのシーケンスには以下の項目が要求されます。 .nf .ta 4n 9n .sp 1) シーケンスの最初の文字が標準の ASCII の印字可能文字でないこと。 .sp 2) どのシーケンスも他のシーケンスの最初の部分で\fIない\fRこと。 (ただしシーケンスは最初の部分を\fI共有\fRできます。) .sp .fi .SH フォーマット 本ファイルはいろいろなキーボードのエントリから成ります。 エントリの最初の部分はそのエントリを使用するキーボード名を列挙します。 これらの名称はたいていは .I /etc/termcap ( .IR termcap (5) 参照) にあるものと同じものです。 しかし、termcap の様々なエントリの端末すべてが、同じ .I map3270 のエントリを使用することがあることに注意してください。 例えば、925 と 925vb (ビジュアルベルを有する 925) はおそらく両方とも同じ .I map3270 のエントリを使用するでしょう。 さらに、端末のタイプがウィンドウマネージャを定義していることがあり、 その場合はキーボード名を (環境変数 .B KEYBD によって) エントリ名として指定する必要があります。 キーボード名の後には縦棒 (`|') で区切って、 左中括弧 (`{')、定義、そして右中括弧 (`}') が続きます。 .PP 各定義は 3270 の機能 (以下に定義するように拡張されたもの) を示す 予約語 (下のリストを参照)、等号 (`=')、この機能を生成するための 様々な方法、セミコロン (`;') の順で続きます。 各方法は .I 印字可能な ASCII 文字の文字列のシーケンスをシングルクォート (`\(aa') で括ったものであり、 様々な (別の) 方法は縦棒 (`|') で区切られています。 .PP シングルクォートではいくつかの文字は特別な扱いを受けます。 キャレット (`^') は次の文字が何であろうが ``制御'' 文字 であることを指定します。 つまり `^a' は control-a を表し、 すなわち 16 進数の 1 となります (`^A' は同じコードを生成することに注意)。 .B rubout (DEL) を生成するには `^?' を入力します。 ファイルの中で制御文字を表現するにはコントロールシーケンスを表示する ためにキャレットを使う必要があります。 ただ単に control-A をタイプするだけではうまくいきません。 注釈: control-^ シーケンス (16 進数で 1E) は `^^' (`^\e^' ではありません) として表現されます。 .PP キャレットのほかに、バックスラッシュ (`\e') に文字を続けることもできます。 これはほとんどの文字では効果はないので、 通常はこうすることは推奨されていません。 シングルクォート (`\(aa') の場合、バックスラッシュをつけると シングルクォートによって文字列は終了しません。 キャレット (`^') の場合、バックスラッシュによって キャレットは特殊な意味を持たなくなります。 文字列中にバックスラッシュを含めるには、 ファイル中に 2 つバックスラッシュ (`\e\e') を置く必要があります。 .PP これらの他に、以下の文字が特殊な意味を持ちます。 .sp .nf .in +0.5i `\eE' はエスケープ文字の意です。 `\en' は改行の意です。 `\et' はタブの意です。 `\er' は復改の意です。 .in -0.5i .fi .sp .sp 各文字は文字列中でシングルクォートで囲まれている必要はありません。 `\eE\eE\eE' は 3 つのエスケープ文字を示します。 .PP コメントは行の中でどこにでも置くことができますが、 ハッシュマーク (`#') で始まり行末で終了します。 しかし、コメントはクォートで囲まれた文字列の中で開始することはできません。 クォートで囲まれた文字列の中でのハッシュマークは特別の意味を持たなくなります。 .PP .SH サポートされている 3270 のキー 以下はこのファイルにおいてサポートされている 3270 のキーの名称のリストです。 これらのキーには、 実際には 3270 に存在しないものがあることに注意してください。 特にこのファイルの開発者は Yale University Computer Center で IBM の Series/1 のフロントエンドとして動作していた 3270 エミュレータ を使用した作業にかなり依存しています。 以下のリストは Yale のコードの開発者が彼らの製品に適用していた 機能に非常に密着したものです。 .sp .B 以下のリストで .B スター ("*") .B 印がつけられた機能は .IR tn3270 (1) .B ではサポートされていません。 サポートされていない機能がある場合、 .IR tn3270(1) はユーザの端末にベル (もしくはビジュアルベル) シーケンスを送信します。 .sp .nf 3270 キー名称 機能説明 (*)LPRT ローカルプリント DP 文字複写 FM フィールドマーク文字 CURSEL カーソル選択 CENTSIGN EBCDIC のセント (¢) 記号 RESHOW スクリーンの再描画 EINP 入力消去 EEOF フィールドの末尾まで消去 DELETE 文字削除 INSRT 挿入モードのトグル TAB フィールドタブ BTAB フィールド逆タブ COLTAB カラムタブ COLBAK カラム逆タブ INDENT 1 タブ分インデント UNDENT 1 タブ分逆インデント NL 改行 HOME カーソルをホーム位置へ UP カーソルを上へ DOWN カーソルを下へ RIGHT カーソルを右へ LEFT カーソルを左へ SETTAB カラムタブをセット DELTAB カラムタブを削除 SETMRG 左マージンをセット SETHOM ホーム位置をセット CLRTAB すべてのカラムタブストップを消去 (*)APLON apl オン (*)APLOFF apl オフ (*)APLEND 入力を ASCII として扱う (*)PCON xon/xoff オン (*)PCOFF xon/xoff オフ DISC 接続断 (サスペンド) (*)INIT 新端末タイプ (*)ALTK DVRAK キーボード FLINP 入力消去 ERASE 最後の文字を消去 WERASE 最後の単語を消去 FERASE フィールド消去 SYNCH ユーザと同期中 RESET リセットキー - キーロック解除 MASTER_RESET リセットし、ロック解除し、再表示する (*)XOFF 出力保留 (*)XON 出力促進 ESCAPE telnet コマンドモードに入る WORDTAB 次の語へタブ移動 WORDBACKTAB 現在/最後の語の最初にタブ移動 WORDEND 現在/次の語の最後にタブ移動 FIELDEND 現在/次の保護されていない (書き込み可能) フィールドの最後の空白でない位置へタブ移動 PA1 プログラムアテンション 1 PA2 プログラムアテンション 2 PA3 プログラムアテンション 3 CLEAR 3270 画面のローカルクリア TREQ テスト要求 ENTER エンターキー PFK1 プログラムファンクションキー 1 PFK2 プログラムファンクションキー 2 etc. etc. PFK36 プログラムファンクションキー 36 .SH エントリの例 以下のエントリは、ユーザ環境と /usr/share/misc/map3270 において 適切なものが見つからない場合に tn3270(1) で使用されるエントリです。 .sp .nf name { # 環境変数 TERM による実際の名前 clear = '^z'; flinp = '^x'; enter = '^m'; delete = '^d' | '^?'; # '^?' は削除 (rubout) です。 synch = '^r'; reshow = '^v'; eeof = '^e'; tab = '^i'; btab = '^b'; nl = '^n'; left = '^h'; right = '^l'; up = '^k'; down = '^j'; einp = '^w'; reset = '^t'; xoff = '^s'; xon = '^q'; escape = '^c'; ferase = '^u'; insrt = '\E '; # プログラムアテンションキー pa1 = '^p1'; pa2 = '^p2'; pa3 = '^p3'; # プログラムファンクションキー pfk1 = '\eE1'; pfk2 = '\eE2'; pfk3 = '\eE3'; pfk4 = '\eE4'; pfk5 = '\eE5'; pfk6 = '\eE6'; pfk7 = '\eE7'; pfk8 = '\eE8'; pfk9 = '\eE9'; pfk10 = '\eE0'; pfk11 = '\eE-'; pfk12 = '\eE='; pfk13 = '\eE!'; pfk14 = '\eE@'; pfk15 = '\eE#'; pfk16 = '\eE$'; pfk17 = '\eE%'; pfk18 = '\eE'; pfk19 = '\eE&'; pfk20 = '\eE*'; pfk21 = '\eE('; pfk22 = '\eE)'; pfk23 = '\eE_'; pfk24 = '\eE+'; } .fi .SH "上記の定義での IBM 3270 キー定義" .IR tn3270 (1) と .IR mset (1) が提供するデフォルトキーマッピング使用時の、 3270 の各機能をエミュレートするキーを下表に示します。 .sp .nf コマンドキー IBM 3270 キー デフォルトキー Enter RETURN Clear control-z カーソル移動キー New Line control-n もしくは Home Tab control-i Back Tab control-b Cursor Left control-h Cursor Right control-l Cursor Up control-k Cursor Down control-j もしくは LINE FEED 編集制御キー Delete Char control-d もしくは RUB Erase EOF control-e Erase Input control-w Insert Mode ESC Space End Insert ESC Space プログラムファンクションキー PF1 ESC 1 PF2 ESC 2 ... ... PF10 ESC 0 PF11 ESC - PF12 ESC = PF13 ESC ! PF14 ESC @ ... ... PF24 ESC + プログラムアテンションキー PA1 control-p 1 PA2 control-p 2 PA3 control-p 3 ローカル制御キー Reset After Error control-r Purge Input Buffer control-x .ne 1i Keyboard Unlock control-t Redisplay Screen control-v その他のキー Erase current field control-u .fi .SH 関連ファイル /usr/share/misc/map3270 .SH 関連項目 tn3270(1), mset(1), \fIYale ASCII Terminal Communication System II Program Description/Operator's Manual\fR (IBM SB30-1911) .SH 作者 Greg Minshall .SH バグ .I map3270 で提供されている機能すべてについてどのように処理すれば良いのかを、未だ .I tn3270 は理解していません。 その様な機能が要求されると .I tn3270 はビープを鳴らします。 .PP (「語消去」や「語タブ」での) 「語」の定義は実行時オプションにするべきです。 現在これはカーネルの tty ドライバでの定義のまま (空白以外の文字列) に 定義されています。"vi" での定義 (特殊文字の文字列、アルファベット数字の文字列) を使用したい人もいるでしょう。 diff --git a/ja/man/man5/modems.5 b/ja/man/man5/modems.5 index e10e7aec7b..9b1bb17589 100644 --- a/ja/man/man5/modems.5 +++ b/ja/man/man5/modems.5 @@ -1,146 +1,146 @@ .\" 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. .\" .\" @(#)modems.5 3/24/95 -.\" jpman $Id: modems.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: modems.5,v 1.3 1998/07/02 14:15:42 horikawa Stab % .\" .Dd March 24, 1995 .Dt MODEMS 5 .Os BSD 4.4 .Sh 名称 .Nm modems .Nd モデム設定データベース .Sh 解説 .Xr tip 1 によって知られるモデムとその属性は .Xr termcap 5 ファイルのような構造の .Tn ASCII ファイルに記録されます。 ファイルの各行は、1 つの .Em モデム についての記述を提供します。 フィールドはコロン (``:'') で分けられています。 \e 文字の直後に改行がある行末は、次の行へ継続されます。 .Pp 最初のエントリはモデムの (複数の) 名称です。 .\" docs7092 の内容を反映 もしモデムの名称が 1 つ以上ある場合、名称は縦棒で区切られます。 モデムの名称の後に記述フィールドが続きます。 `=' 記号が続くフィールド名は、文字型が続くことを示します。 `#' 記号が続くフィールド名は、数値が続くことを示します。 .Pp .Xr tip 1 が呼び出された時、リモートシステムに対するエントリが .\" docs7092 の内容を反映 .Pa /etc/remote データベースから検索されます。 (短縮されている) "ACU" タイプケーパビリティが含まれる場合、 .Xr tip 1 は特定のモデムを .Pa /etc/modems から検索します。 モデムエントリが見付かった場合、リモートシステムとの接続時や切断時に どのように .Xr tip 1 プログラムがモデムを扱うかの適当なケーパビリティを決定します。 .Sh ケーパビリティ ケーパビリティは、文字列 (str) ・数値 (num) ・ブーリアンフラグ (bool) のいずれかです。文字列ケーパビリティは .Em capability Ns Ar = Ns Em value のように指定されます。例えば、 ``reset_command=ATZ\\r'' のように指定 します。数値ケーパビリティは .Em capability Ns Ar # Ns Em value のように指定されます。例えば、``intercharacter_delay#50'' のように指 定します。ブーリアンケーパビリティは単にケーパビリティを記述するだけで 指定されます。 .Bl -tag -width intercharacter_delay indent .It Cm \&dial_command (str) リモートシステムにダイアルするために使われる AT コマンドです (典型的には "ATDT" でしょう)。 .It Cm \&echo_off_command (str) コマンドエコーを抑制するための ATコマンドです。 .It Cm \&escape_guard_time (num) ミリ秒で表現されたディレイです。 コマンドに戻るエスケープシーケンスフレームに使われます。 .It Cm \&escape_sequence (str) コマンドに戻るためのエスケープシーケンスです。 .It Cm \&hangup_command (str) モデムをハングアップするために使われる AT コマンドです。 .It Cm \&hw_flow_control (bool) コンピュータとモデム (DTE/DCE) の間でハードウェア (RTS/CTS) フロー制御 を行うようにします。 .It Cm \&init_string (str) ダイアル前にモデムを初期化するために使われる AT コマンドです。 .It Cm \&intercharacter_delay (num) コマンドをモデムに送る時の文字間に開けられる、ミリ秒で指定され るディレイ値です。 .It Cm \&intercommand_delay (num) モデムに発行されるコマンド間に開けられる、ミリ秒で指定される最小ディレイ 値です。 .It Cm \&lock_baud (bool) コンピュータとモデム (DTE / DCE) の間で固定のビットレートが使われます。 ビットレートは .Pa /etc/remote で指定されます。 .It Cm \&reset_command (str) モデムをリセットするための AT コマンドです。 .It Cm \&reset_delay (num) リセットし準備状態に戻るのにモデムで必要とされるミリ秒で指定される時間 です。 .Sh 関連ファイル .Bl -tag -width /etc/modems -compact .It Pa /etc/modems .Pa /etc ディレクトリにおかれた .Nm モデム 設定データベースファイルです。 .El .Sh 関連項目 .Xr tip 1 , .Xr remote 5 .Sh 歴史 .Nm ファイル書式は .Bx 4.4 から登場しました。 diff --git a/ja/man/man5/motd.5 b/ja/man/man5/motd.5 index c88b9c0542..6e5dc14785 100644 --- a/ja/man/man5/motd.5 +++ b/ja/man/man5/motd.5 @@ -1,44 +1,44 @@ .\" %NetBSD: motd.5,v 1.2 1994/12/28 18:58:53 glass Exp % .\" .\" This file is in the public domain. .\" .Dd February 13, 1997 -.\" jpman $Id: motd.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: motd.5,v 1.3 1998/06/12 15:52:50 kumano Stab % .Dt MOTD 5 .Os .Sh 名称 .Nm motd .Nd 今日のメッセージを含むファイル .Sh 解説 通常、ユーザがログインした後のシェル実行前に、 .Xr login 1 は .Pa /etc/motd ファイルを表示します。 このファイルは、一般的にはシステムに関する重要なアナウンスのために使用します。 システム起動時に、カーネルバージョン文字列を含む行が このファイルの前に付きます。 .Pp 個々のユーザはこのファイルの表示を抑制することができます。 そのためには、 .Dq Pa .hushlogin という名前のファイルをホームディレクトリに置くか、 .Xr login.conf 5 で制御します。 .Sh 関連ファイル .Bl -tag -width $HOME/.hushlogin -compact .It Pa /etc/motd 今日のメッセージ。 .It Pa $HOME/.hushlogin .Pa /etc/motd の出力を抑制。 .El .Sh 使用例 .Bd -literal FreeBSD 2.1.6.1-RELEASE (GENERIC) #0: Sun Dec 29 03:08:31 PST 1996 /home is full. Please cleanup your directories. .Ed .Sh 関連項目 .Xr login 1 , .Xr login.conf 5 diff --git a/ja/man/man5/netgroup.5 b/ja/man/man5/netgroup.5 index a3ac4b9c4c..ce4f0106e7 100644 --- a/ja/man/man5/netgroup.5 +++ b/ja/man/man5/netgroup.5 @@ -1,188 +1,188 @@ .\" Copyright (c) 1992, 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. .\" .\" @(#)netgroup.5 8.2 (Berkeley) 12/11/93 -.\" jpman $Id: netgroup.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: netgroup.5,v 1.3 1998/07/31 00:57:44 moro Stab % .\" .Dd December 11, 1993 .Dt NETGROUP 5 .Os .Sh 名称 .Nm netgroup .Nd ネットワークグループを定義する .Sh 書式 .Nm netgroup .Sh 解説 .Nm ファイルは ネットワークへの同じようなアクセス権を与えられた .Sy (host, user, domain) の形式の値の組を指定します。 .Pp このファイル中のそれぞれの行は、ネットグループ名とそれに続くネットグループの メンバリストで構成されます。 それぞれのメンバは、他のネットグループ名か、次のような値の組に する事ができます。 .Bd -literal -offset indent (host, user, domain) .Ed .Pp ここで .Sy host , .Sy user および .Sy domain は、それぞれの構成要素に対応する文字列名です。 コンマで区切られたフィールドはどれも、空にする事で ``ワイルドカード'' を、 ``-'' にする事で ``値無し'' を指定する事ができます。 メンバリストは空白またはコンマで区切る事ができ、文字 ``\e'' を行の最後 に使う事によって行を継続できます。 1 行は 1024 文字までに制限されています。 .Nm データベースにアクセスするためには、通常 .Xr getnetgrent 3 の中の関数が使われます。 .Pp # で始まる行はコメントとして扱われます。 .Sh NIS/YP の相互作用 他の多くのプラットフォームでは、 .Nm はもっぱら .Tn NIS と一緒に用いられ、ローカルの .Pa /etc/netgroup ファイルは無視されます。 .Bx Free では .Tn NIS かローカルファイルの .Nm のどちらかを使うようにする事が出来ます。しかし、 この機能は慎重に使うべきです。 現在の .Nm システムは、 .Fn innetgr 3 を用いた照会に関する部分が極めて非効率です。 これは、問い合わせのあったその場で .Nm のメンバ情報を計算するためです。 それに比べて、 .Tn NIS の .Nm データベースは .Fn innetgr 3 が素早く照会を完了させるためのキー項目を持った 3つのマップ (netgroup, netgroup.byuser そして netgroup.byhost)によって構成されています。 .Bx Free の .Nm システムは、 次の方法で .Tn NIS の .Nm マップと互いに作用し合う事が出来ます: .Bl -bullet -offset indent .It もし .Pa /etc/netgroup ファイルが存在しなかった場合、または存在しても空の場合、または存在して も .Sq + しか書かれていない場合で、これらのいずれかの場合に加えて .Tn NIS が動いている場合は、 .Nm は .Tn NIS だけを使って照会を行ないます。このとき、 .Fn innetgr 3 は、netgroup.byuser マップと netgroup.byhost マップを最大限に利用して 高速検索を行ないます (これは、SunOS とそれに類するプラットホームの 実装とほとんど同じです) 。 .It もし .Pa /etc/netgroup が存在し、かつローカルの .Nm 情報のみを含んでいる ( .Tn NIS の .Sq + がない) 場合、 そのローカルの .Nm 情報のみが使用されます ( .Tn NIS の情報は無視されます)。 .It もし、 .Pa /etc/netgroup が存在し、かつローカルの netgroup データ .Pa および .Tn NIS の .Sq + トークンの両方が含まれている場合、ローカルのデータと .Tn NIS の netgroup マップは 1 つにつながれた .Nm データベースの様に処理されます。この構成は最も柔軟ですが、 最も非効率です。特に、このデータベースが大きい場合は .Fn innetgr 3 による照会は極端に遅くなります。 .El .Sh 関連ファイル .Bl -tag -width /etc/netgroup -compact .It Pa /etc/netgroup ネットグループデータベース .El .Sh 関連項目 .Xr getnetgrent 3 , .Xr exports 5 .Sh 互換性 このファイルフォーマットは、さまざまなベンダと互換性がありますが、 すべてのベンダが同一のフォーマットを使っているわけではないようです。 .Sh バグ ネットグループのメンバの組に基づいたアクセス制限の解釈は、さまざまな ネットワークアプリケーション任せになっています。 また、ドメイン指定を .Bx 環境に適用する方法も不明確です。 .Pp .Nm データベースは逆引きスピードアップのため、 .Xr passwd 5 の様にハッシュ化された .Xr db 3 データベースに格納されるべきです。 diff --git a/ja/man/man5/networks.5 b/ja/man/man5/networks.5 index 9acb558714..4c0d3dfd3e 100644 --- a/ja/man/man5/networks.5 +++ b/ja/man/man5/networks.5 @@ -1,90 +1,90 @@ .\" 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. .\" .\" @(#)networks.5 8.1 (Berkeley) 6/5/93 .\" %Id: networks.5,v 1.2.2.2 1998/06/28 21:34:27 hoek Exp % .\" -.\" jpman $Id: networks.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: networks.5,v 1.3 1998/06/12 15:54:06 kumano Stab % .\" .Dd June 5, 1993 .Dt NETWORKS 5 .Os BSD 4.2 .Sh 名称 .Nm networks .Nd ネットワーク名のデータベース .Sh 解説 .Nm networks ファイルは、 .Tn DARPA インターネットを含む既知のネットワークの情報を保持します。 各ネットワーク毎に、以下の情報を表す 1 行が存在します。 .Bd -unfilled -offset indent 公式ネットワーク名 ネットワーク番号 別名 .Ed .Pp 各項目は任意個の空白文字やタブ文字で分けられます。 ``#'' はコメント開始を表し、 行末までの文字はファイルを検索するルーチンに解釈されません。 このファイルは通常 Network Information Control Center .Pq Tn NIC が管理する公式ネットワークデータベースから生成しますが、 非公式な別名や未知のネットワークに関する情報を最新とするために、 ローカルでの変更が必要になるかもしれません。 .Pp ネットワーク番号は、 インターネットアドレス操作ライブラリ .Xr inet 3 の .Xr inet_network 3 ルーチンが使用する、伝統的な ``.'' (ドット) 表記で指定します。 ネットワーク名は、フィールド区切り文字・改行文字・コメント文字以外の、 任意の表示可能文字からなります。 .Sh 関連ファイル .Bl -tag -width /etc/networks -compact .It Pa /etc/networks .Nm networks は .Pa /etc にあります。 .El .Sh 関連項目 .Xr getnetent 3 .Sh バグ 静的ファイルの代わりに、ネームサーバを使用すべきです。 .Sh 歴史 .Nm ファイルフォーマットは .Bx 4.2 に登場しました。 diff --git a/ja/man/man5/nologin.5 b/ja/man/man5/nologin.5 index a0b6e630aa..23c6a820b2 100644 --- a/ja/man/man5/nologin.5 +++ b/ja/man/man5/nologin.5 @@ -1,67 +1,67 @@ .\" 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 .\" %Id: nologin.5,v 1.2.2.2 1998/07/17 20:13:42 jkh Exp % .\" -.\" jpman $Id: nologin.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: nologin.5,v 1.3 1998/06/13 09:47:03 kumano Stab % .\" .Dd June 19, 1993 .Dt NOLOGIN 5 .Os FreeBSD 2.1 .Sh 名称 .Nm nologin .Nd ログインを拒否する .Sh 解説 .Nm は、 .Pa /etc/nologin ファイルがあるとログインを拒否します。 このプログラムはユーザに .Pa /etc/nologin の内容を表示し、終了します。 .Sh セキュリティ ユーザ root の .Xr login 1 では無視されます。 .Sh 関連ファイル .Bl -tag -width /etc/nologinxxx -compact .It Pa /etc/nologin .Nm ファイルは .Pa /etc にあります。 .El .Sh 関連項目 .Xr login 1 , .Xr rlogin 1 , .Xr telnet 1 , .Xr shutdown 8 diff --git a/ja/man/man5/opieaccess.5 b/ja/man/man5/opieaccess.5 index 9b06f778d8..fc76738794 100644 --- a/ja/man/man5/opieaccess.5 +++ b/ja/man/man5/opieaccess.5 @@ -1,94 +1,94 @@ .\" opieaccess.5: Manual page describing the /etc/opieaccess file. .\" .\" Portions of this software are Copyright 1995 by Randall Atkinson and Dan .\" McDonald, All Rights Reserved. All Rights under this copyright are assigned .\" to the U.S. Naval Research Laboratory (NRL). The NRL Copyright Notice and .\" License Agreement applies to this software. .\" .\" History: .\" .\" Written at NRL for OPIE 2.0. .\" .ll 6i -.\" jpman $Id: opieaccess.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: opieaccess.5,v 1.3 1998/07/21 23:15:14 jsakai Stab % .pl 10.5i .\" @(#)opieaccess.5 2.0 (NRL) 1/10/95 .\" WORD: passive attack 受動攻撃 .\" .lt 6.0i .TH OPIEACCESS 5 "January 10, 1995" .AT 3 .SH 名称 /etc/opieaccess \- 信頼できるネットワークの OPIE(One-time Password In Everything) データベース .SH 解説 .I opieaccess ファイルは、受動攻撃に対するセキュリティに関して、そのシステム が信頼しても構わないと考えられるネットワークのリストを含みます。 ここで、信頼できるネットワークからのユーザは、OPIE 応答を用いてログインする ことができますが、必ずしも OPIE 応答を使う必要はありません。一方、 信頼できないネットワークからのユーザは、必ず OPIE 応答を使う (これがデフォルトの動作) 必要があります。 "内側の" ネットワークに関しては、そのサイトに対して OPIE の使用を強制 しませんし、また、OPIE を使って自分のパスワードを保護するかどうかを ユーザが選ぶことができるので、この信頼関係により、サイトがよりスムーズに OPIE に移行することができます。 .sp OPIE システムは受動攻撃からユーザを保護するものですが、 .I opeiaccess ファイルで実装された信頼という全概念は、 それと同様の受動攻撃に対して システムのバックアップをオープンにしてしまいます。 従って、この信頼という概念は重大なセキュリティホールとなります。 本バージョンの OPIE にこのような .I opieaccess が存在するのは、ひとえに、OPIE を使いたくないユーザのせいで自分の アカウントを破られたくないユーザが OPIE を使えなくなるよりも、 このようなユーザが OPIE を使えるようにすることの方がよいと信じているためです。 どのような環境であれ、 trust 機能を活かした本バージョンの OPIE は移行のためのツールと考えるべきで、 永久に使い続けるべきではありません。 移行のためのツールとして使う必要がなくなった時点で、 .I opieaccess ファイルをサポートしないバージョンの OPIE を構築し、OPIE システムの 裏をかくための手段としてこのファイルを使おうとする攻撃者にチャンスを 与えないようにする必要があります。 .sp .I opieaccess は、以下のように空白で区切られた 3 つのフィールドからなる行から構成されます (区切りとしてタブも正しく解釈されますが、空白を代わりに使って下さい)。 .PP .nf .ta \w' 'u フィールド名 内容 action OPIEを利用しないログインを "許可" もしくは "拒否" します address 照合するネットワークのアドレスです mask 照合のためのネットワークのマスクです .fi サブネットは適切なアドレスとマスクを使うことで制御されます。 個々のホストは 255.255.255.255 のマスクと適切なアドレスを使うことで 制御されます。 どの規則も一致しない場合、デフォルトでは OPIE 無しのログインは拒否されます。 .SH 関連項目 .BR ftpd (8) .BR login (1), .BR opie (4), .BR opiekeys (5), .BR opiepasswd (1), .BR opieinfo (1), .BR su (1), .SH 作者 Bellcore の S/Key は Bellcore の Phil Karn, Neil M. Haller, John S. Walden によって書かれました。 OPIE は NRL で Randall Atkinson, Dan McDonald, Craig Metz によって作成 されました。 S/Key は Bell Communications Research (Bellcore) のトレードマークです。 .SH 連絡先 OPIE は Bellcore の "S/Key Users" メーリングリストで議論されました。 参加するためには、電子メールを以下の所に送って下さい。 .sp skey-users-request@thumper.bellcore.com diff --git a/ja/man/man5/opiekeys.5 b/ja/man/man5/opiekeys.5 index 7c317d9e84..07a5c00f76 100644 --- a/ja/man/man5/opiekeys.5 +++ b/ja/man/man5/opiekeys.5 @@ -1,67 +1,67 @@ .\" opieaccess.5: Manual page describing the /etc/opiekeys file. .\" .\" Portions of this software are Copyright 1995 by Randall Atkinson and Dan .\" McDonald, All Rights Reserved. All Rights under this copyright are assigned .\" to the U.S. Naval Research Laboratory (NRL). The NRL Copyright Notice and .\" License Agreement applies to this software. .\" .\" History: .\" .\" Written at NRL for OPIE 2.0. .\" .ll 6i -.\" jpman $Id: opiekeys.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: opiekeys.5,v 1.3 1998/07/03 09:08:53 mutoh Stab % .pl 10.5i .\" @(#)opiekeys.1 2.0 (NRL) 1/10/95 .\" .lt 6.0i .TH OPIEKEYS 1 "January 10, 1995" .AT 3 .SH 名称 /etc/opiekeys \- ユーザキー情報の OPIE(One-time Password In Everything) データベース .SH 解説 .I opiekeys ファイルには OPIE ソフトウェアがユーザ認証のために使用するユーザ情報が格納されます。 .I opiekeys ファイルは S/Key の .I /etc/skeykeys データベースファイルに対して下位互換ですが、これは ハッシングアルゴリズム (MD4 および MD5) が S/Key と OPIE で同一の 場合に限られます (すなわち、 MD5 OPIE は MD4 S/Key キーを使用できません)。 .I opiekeys ファイルは、空白 (タブは正しく解釈されますが、代りにスペースを使うべきです) で区切られた次のような 6 フィールドから成ります: .PP .nf .ta \w' 'u フィールド名 内容 name ユーザのログイン名。 sequence ユーザのシーケンス番号。 seed ユーザの種。 key ユーザの最後のレスポンス (16 進数)。 date 最後に変更された日付。 time 最後に変更された時刻。 .fi .SH 関連項目 .BR ftpd (8) .BR login (1), .BR opie (4), .BR opiekeys (5), .BR opiepasswd (1), .BR opieinfo (1), .BR su (1), .SH 作者 Bellcore の S/Key は、 Bellcore の Phil Karn, Neil M. Haller, John S. Walden が記述しました。 OPIE は NRL にて Randall Atkinson, Dan McDonald, Craig Metz が作成しました。 S/Key は Bell Communications Research (Bellcore) の商標です。 .SH 連絡先 OPIE は Bellcore の "S/Key Users" メーリングリストで議論されています。 加入要求は電子メールを下記アドレスに送ってください: .sp skey-users-request@thumper.bellcore.com diff --git a/ja/man/man5/passwd.5 b/ja/man/man5/passwd.5 index b466809d28..f3867f3da7 100644 --- a/ja/man/man5/passwd.5 +++ b/ja/man/man5/passwd.5 @@ -1,678 +1,678 @@ .\" 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. .\" .\" From: @(#)passwd.5 8.1 (Berkeley) 6/5/93 .\" %Id: passwd.5,v 1.6.2.8 1998/07/19 06:52:11 jkh Exp % .\" -.\" jpman $Id: passwd.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: passwd.5,v 1.3 1998/07/30 15:26:15 horikawa Stab % .\" .\" WORD: NIS/YP INTERACTION NIS/YP との相互作用 [yppasswd.1] .\" WORD: accounting アカウンティング (パスワード期限等の意味) .\" WORD: epoch 基準時点 .Dd September 29, 1994 .Dt PASSWD 5 .Os .Sh 名称 .Nm passwd .Nd パスワードファイルのフォーマット .Sh 解説 .Nm passwd ファイルは改行で区切られたレコードから成ります。 ユーザごとに 1 レコードが対応し、 コロン(``:'')で区切られた 10 個の欄が含まれます。 これらの欄は以下の通りです: .Pp .Bl -tag -width password -offset indent .It name ユーザのログイン名。 .It password ユーザの .Em 暗号化された パスワード。 .It uid ユーザのid。 .It gid ユーザのログイングループid。 .It class ユーザのログインクラス。 .It change パスワードの変更時間。 .It expire アカウントの有効期限。 .It gecos ユーザについての一般的な情報。 .It home_dir ユーザのホームディレクトリ。 .It shell ユーザのログインシェル。 .El .Pp 最初の空白文字でない文字がポンド記号(#)であるような行は注釈であり、無視 されます。スペース、タブ、改行だけからなる空行もまた無視されます。 .Pp .Ar name 欄はコンピュータアカウントにアクセスするのに用いられるログインであり、 .Ar uid 欄はそれに結び付けられた数字です。これらはファイルアクセスを制御するので、 両方共そのシステム(またしばしば複数のシステムにわたる1つのグループ)の中 で一意であるべきです。 .Pp 同じログイン名や同じユーザidのエントリを複数持つことは可能で すが、普通それは誤りです。これらのファイルを取り扱うルーチンはしばしばそ の複数エントリの 1 つだけを返しますし、 そしてそれはランダムな選択によるものです。 .Pp ログイン名は決してハイフン(``-'')で始めてはいけません。また、メーラを 混乱させる傾向にあるので、大文字やドット(``.'')も絶対に名前の一部にしな いことを強く推奨します。コロン(``:'')は歴史的にユーザデータベース中の欄 を分けるために用いられてきたので、いかなる欄にも含まれません。 .Pp password欄はパスワードの .Em 暗号化された 形です。 .Ar password 欄が空ならば、そのマシンへアクセスするのに何のパスワードも必要としないで しょう。これはほとんど恒常的に誤りです。これらのファイルは暗号化された ユーザパスワードを含んでいるので、 適当な権利無しにはいかなる人によっても可読であっ てはいけません。管理上のアカウントは1個のアスタリスク .Ql \&* を含むパスワード欄を有しており、これは通常のログインを許しません。 .Pp group欄はユーザがログインした上で位置付けられるグループです。このシステムは マルチグループ( .Xr groups 1 参照) をサポートしますが、この欄はユーザの1次グループを指名します。2次グループの メンバは .Pa /etc/group の中で選ばれます。 .Pp .Ar class 欄はユーザのログインクラスに対するキーです。ログインクラスは .Xr login.conf 5 の中で定義されます。 .Xr login.conf 5 は、ユーザの属性、アカウンティング、リソース、環境設定に関する .Xr termcap 5 形式のデータベースです。 .Pp .Ar change 欄は .Dv GMT における基準時点からの秒数を表したものであり、 この時までにアカウントに対するパスワードを変更する必要があります。 パスワードエージング機能をなくすには、 この欄を空欄にしておくか0をセットしておけば良いです。 .Pp .Ar expire 欄は .Dv GMT における基準時点からの秒数を表したものであり、 その時にアカウントが消滅します。 アカウント再設定機能をなくすには、 この欄を空にセットしておくか0をセットしておけば良いです。 .Pp .Ar gecos 欄はコンマ(``,'')で区切られた以下のような副欄を通常含んでいます: .Pp .Bd -unfilled -offset indent fullname ユーザのフルネーム office ユーザの職場の位置 wphone ユーザの職場の電話番号 hphone ユーザの自宅の電話番号 .Ed .Pp この情報は フィンガープログラム .Xr finger 1 によって利用され、最初の欄はシステムのメーラ によって使われます。fullname 欄内にアンパサンド文字 .Ql \&& が現われると、この欄を使うプログラムはそれをそのアカウントのログイン名の 大文字版に置き換えます。 .Pp ユーザのホームディレクトリは、ユーザがログインして位置付けられる完全な .Tn UNIX パス名です。 .Pp shell欄はユーザの好むインタプリタです。 .Ar shell 欄になにも無ければ Bourne シェル .Pq Pa /bin/sh が仮定されます。セキュリティ上の理由により、シェルがシステムへのアクセス を許さないスクリプト(例えば .Xr nologin 8 スクリプト)に設定されている場合、いかなる環境変数も渡されないように配慮さ れるべきです。 .Xr sh 1 については、これは .Fl p フラグを指定することで可能です。これが他のシェルでどのように行なわれるか は、特定のシェルの文書を調べてください。 .Sh YP/NIS との相互作用 .Ss NISパスワードデータへのアクセスを可能にする システム管理者は .Pa /etc/master.passwd ファイルに特別なレコードを付け加えることによって、パスワード情報について NIS/YPを用いるように .Tn FreeBSD を設定できます。ハッシュされたパスワードデータベースおよび .Pa /etc/passwd ファイル( .Pa /etc/passwd は絶対に手動で編集してはいけません)に変更が適切にマージされるように、 エントリは .Xr vipw 8 で付加するべきです。別の方法としては、なんらかの方法で .Pa /etc/master.passwd を修正した後、 .Xr pwd_mkdb 8 を用いてパスワードデータベースを手動で更新することができます。 .Pp NISを活性化するための最も簡単な方法は、名前欄にプラス符号(`+')だけを持つ、 以下のような空のレコードを付け加えることです。 .Bd -literal -offset indent +::::::::: .Ed `+' は、 .Tn FreeBSD の標準Cライブラリの .Xr getpwent 3 ルーチンに対し、 検索において NIS パスワードマップを使用開始するよう指示します。 .Pp 上記のエントリは .Em ワイルドカード エントリとして知られていることに注意してください。なぜなら、それは全ての ユーザと一致し (他に情報を持たない `+' は、全員に一致します)、 全 NIS パスワードデータを無変更にて引き出すことを許します。 一方、 NIS エントリで `+' の次にユーザ名やネットグループ名を指定することによって、 どのようなデータが NIS パスワードマップから展開されるのか、 およびそれがどのように解釈されるのかについて、 管理者が影響を与えることができます。 この特徴を示す、少数のレコード例を挙げます(1 つの .Pa master.passwd ファイル中には複数の NIS エントリを持つことが可能であることに注意): .Bd -literal -offset indent -mitnick::::::::: +@staff::::::::: +@permitted-users::::::::: +dennis::::::::: +ken:::::::::/bin/csh +@rejected-users::32767:32767::::::/bin/false .Ed 特定のユーザ名は明示的にリストされますが、ネットグループは `@' を前に付け て表されます。 上の例では、``staff'' および ``permitted-users'' ネットグループ のユーザは、NIS から読まれ無変更で使用されるパスワード情報を持ちます。 言い換えれば、それらのユーザはそのマシンに通常のアクセスを許される ということです。ユーザ ``ken'' および ``dennis'' は、 ネットグループを通じてではなく明示的に名前が指定されており、 NIS から読まれるパスワード情報を持ちます。 例外は、ユーザ ``ken'' のシェルが .Pa /bin/csh に再マップされることです。 これは、NISパスワードマップで指定されたシェルの値が、ローカル .Pa master.passwd ファイルの特別なNISエントリで指定された値によって上書きされることを意味します。 ユーザ ``ken'' は csh シェルを割り当てておいても良いかも知れません。 なぜなら、 政治的あるいは技術的な理由でクライアントマシンにインストールされていない 別のシェルを、彼の NIS パスワードエントリに指定されているかもしれないためです。 他方、``rejected-users''ネットグループのユーザは、そのUID、 GID、シェルが不正な値で上書きされているのでログインできなくなります。 .Pp ユーザ ``mitnick'' は、そのエントリが `+' ではなく `-' で指定されているので、 完全に無視されることになります。 マイナスエントリは、 ある NIS エントリを完全に遮断するために用いることができます。 このような方法でパスワードデータが除外されたユーザは、 システムから全く認識されません。(マイナスエントリで指定された 上書き情報は無視されます。 なぜなら、システムが最初に認識しないことにしたユーザの上書き情報を処理 することは無駄だからです。) 一般にマイナスエントリは、 ある権限のあるネットグループのメンバとなってアクセスを許されるかもしれない ユーザを特別に除外するために使用します。 例えば ``mitnick'' が ``permitted-users'' ネットグループのメンバであり、 いかなる理由があってもそのネットグループ内に留まることを許す必要がある場合 (おそらくそのドメイン内の他のマシンにアクセスすることを保証するため)、 管理者はマイナスエントリを使用することにより、 特定のシステムへのアクセスを拒否し続けるこ とができます。また、アクセスを許されたユーザおよびその残りを削除したよう なよくありそうな混み入ったユーザのリストを生成するよりは、むしろアクセスを 許されないユーザを明示的にリストする方が容易なことが多いです。 .Pp プラスおよびマイナスエントリは、先行一致優先で最初から最後の順で評価されま す。これはシステムが特定のユーザに一致する最初のエントリだけを使用するこ とを意味します。例えば、``staff'' ネットグループと ``rejected-users'' ネットグループの両方のメンバとなっているようなユーザ ``foo'' は、 上の例では ``rejected-users'' のエントリの前に ``staff'' のエントリがありますので、 システムに許可されます。もし順序が逆なら、今度はユーザ ``foo'' は ``rejected-users'' として認識され、アクセスは拒否されます。 .Pp 最後に、 .Pa /etc/master.passwd ファイルの NIS アクセスエントリで指定されたユーザまたはネットグループ のどれとも一致しないNISパスワードデータベースレコードは、(マイナスエントリ を使って指定した全てのユーザと共に)全て無視されます。先に示した例 ではリストの最後にワイルドカードエントリが無いので、 ``ken'' と ``dennis'' と ``staff'' ネットグループと ``permitted-users'' ネットグループとを除く全てのユーザを システムは権限があるユーザとして認識しないでしょう。 ``rejected-users'' ネットグループは認識されますが、 全メンバのシェルは再マップされますので、 アクセスは拒否されるでしょう。他の全てのNISパスワードレコードは無視され るでしょう。 管理者は以下のようなワイルドカードエントリをリストの最後に 付けても良いでしょう。 .Bd -literal -offset indent +:::::::::/usr/local/bin/go_away .Ed このエントリは他の全てのエントリと一致しない全てのユーザを一挙にとらえる 働きをします。 .Pa /usr/local/bin/go_away は、システムにアクセスを許可されないユーザに伝えるメッセージを出力する短か いスクリプトまたはプログラムでしょう。 必ずしもログインアクセスを許可せずに、 特定のNISドメイン内の全ユーザをシステムが認識可能であることが望ましいときには、 このテクニックが有効なことがあります。 ログインシェルとシェルスクリプトを使用するときのセキュリティに関する事柄 について、上記のシェル欄の記述を参照してください。 .Pp この .Pa 上書き 機能の主な用途は、 管理者がNISクライアント上でアクセス制限を強化可能とすることです。 単に特定のネットグループに対してユーザを追加したり削除したりするだけで、 そのユーザにあるマシン群へのアクセスを許可し、 かつ他のマシン群へのアクセスを拒否することができます。 ネットグループデータベースもまた NIS 経由でアクセスできるので、 1 個所すなわち NIS マスタサーバからアクセス制限を管理できます。 一旦ホストのアクセスリストが .Pa /etc/master.passwd に設定されると、新にネットグループが作られない限りそれは再度変更する必要 はありません。 .Sh 注釈 .Ss NIS経由のシャドウパスワード .Tn FreeBSD はシャドウパスワード法を採用しており、 ユーザの暗号化されたパスワードはスーパユーザだけが読み書き可能な .Pa /etc/master.passwd および .Pa /etc/spwd.db にのみに記憶されます。 暗号化されたパスワードをパスワード推測プログラムに通すことにより、 ユーザが他のユーザアカウントに対して不正アクセスすることを防ぐためです。 NIS にはパスワード隠蔽のための標準的な方法がありません。 これは、 パスワードデータを全てNISパスワードマップに置き換えることは、 .Tn FreeBSD のパスワード隠蔽システムのセキュリティを無効にしてしまうことを意味します。 .Pp .Tn FreeBSD にはこの問題を回避するのに役立つ少数の特別な特徴が備わっています。 .Tn FreeBSD NIS クライアントと .Tn FreeBSD NIS サーバとの間でパスワード隠蔽を実装することは可能です。 .Xr getpwent 3 ルーチンは .Pa /etc/master.passwd と同じデータを含む .Pa master.passwd.byname と .Pa master.passwd.byuid マップを検索します。マップが存在すれば .Tn FreeBSD は標準の .Pa passwd.byname および .Pa passwd.byuid マップの代りにそれらをユーザ認証に利用しようとします。 .Tn FreeBSD の .Xr ypserv 8 はまたクライアントの要求をチェックして、 クライアントの要求が特権ポートから来たことを確認します。 スーパユーザのみが特権ポートにアクセスすることが許されるので、 要求しているユーザがスーパユーザであるか否か判断可能です。 .Pa master.passwd マップにアクセスする権限の無いユーザからの全ての要求は拒否されるでしょう。 全てのユーザ認証プログラムはスーパユーザの権限で実行されるので、 ユーザの暗号化されたパスワードデータへの必要なアクセスを持ちますが、 通常ユーザはパスワード情報を含まない標準 .Pa passwd マップへのアクセスのみ許されます。 .Pp この特徴は .Tn FreeBSD 以外のシステムがある環境では利用できないことに注意してください。 また、ネットワーク に無制限にアクセスできる真に限定されたユーザは依然 .Pa master.passwd マップを危うくすることにも注意してください。 .Ss NISの上書きに伴なうUIDおよびGIDの再マップ .Tn SunOS や Sun の NIS コードを利用しているオペレーティングシステムとは異なり、 .Tn FreeBSD ではユーザがNIS .Pa passwd エントリ中の .Pa 全て の欄を上書きすることを許しています。例えば以下のような .Pa /etc/master.passwd エントリを考えてみましょう。 .Bd -literal -offset indent +@foo-users:???:666:666:0:0:0:Bogus user:/home/bogus:/bin/bogus .Ed このエントリにより、`foo-users' ネットグループ中の全てのユーザは、 UID、GID、パスワードを含めて .Pa 全て のパスワード情報を上書きされます。この結果、彼等のパスワードは不正な 値に再マップされるので、全ての `foo-users' はシステムから締め出さ れることになるでしょう。 .Pp 以下のようにNISワイルドカードエントリを使う習慣のある人が多いので、 このことは覚えておくべき重要なことです。 .Bd -literal -offset indent +:*:0:0::: .Ed これはしばしば新米の .Tn FreeBSD 管理者が以下のように .Pa master.passwd ファイルのNISエントリを選んでしまうことにつながります。 .Bd -literal -offset indent +:*:0:0:::::: .Ed 更に悪く、以下のようにしてしまうこともあります。 .Bd -literal -offset indent +::0:0:::::: .Ed .Sy Pa master.passwd .Sy ファイルには「絶対に」このようなエントリは入れないでください!! 最初のものは、 全てのパスワードを `*' に再マップし (これは誰もログインできなくします)、 全ての UID および GID を 0 に再マップする (これは皆をスーパユーザにします) ことを .Tn FreeBSD に指示します。 2 番目のものは全 UID および GID をちょうど 0 にマップします が、これは .Pa 全てのユーザがrootになってしまう ことを意味します! .Pp .Ss NIS上書き評価の互換性 Sunが最初に .Xr getpwent 3 ルーチンにNISサポートを追加したとき、 .Tn SunOS のパスワードファイル .Pa /etc/passwd はプレーン .Tn ASCII フォーマットであるということが考慮されていました。 .Tn SunOS のドキュメントによれば、パスワードファイルに '+' エントリを付け加えると、 パスワードファイル中の '+' エントリがある位置に NIS パスワードデータベースの内容が「挿入」されます。例えば 管理者が .Pa /etc/passwd の中央に +:::::: エントリを置いた場合、 NIS パスワードマップの全体の内容が パスワードファイルの中央にコピーされたかのように現われるでしょう。 管理者が +:::::: エントリを .Pa /etc/passwd の中央と最後の両方に置けばNISパスワードマップは2度現われることになるでしょ う。すなわち 1 度目はそのファイルの中央に現れ、もう 1 度は最後に現れます (単純なワイルドカードの代りに上書きエントリを用いることで、 他の組合せが可能です)。 .Pp これに対し .Tn FreeBSD では単一の .Tn ASCII パスワードファイルを持つというわけではありません。 .Tn FreeBSD ではハッシュ化されたパスワードデータベースを持ちます。このデータベースで は最初や中央や最後を容易に定義できませんので、 .Tn SunOS に 100% 互換の手法を設計することは非常に困難です。例えば .Tn FreeBSD の .Fn getpwnam 関数と .Fn getpwuid 関数は、線形検索ではなくハッシュデータベースに直接問い合わせするように設計さ れています。パスワードデータベースが大きいシステムでは、 このアプローチの方が高速です。 しかしデータベースへ直接問い合わせを利用するとき、 システムは元のパスワードファイルの順序を知り得ませんし気にしませんので、 .Tn SunOS が使用するものと同じ上書き論理は容易に適用できません。 .Pp 代りに .Tn FreeBSD では全ての NIS 上書きエントリを一緒のグループにまとめ、それらから 1 つ のフィルタを作ります。各 NIS パスワードエントリはちょうど 1 回上書きフィルタ に対して比較され、それに応じて取り扱われます。フィルタがエントリを変更せ ずに通すことを許すならエントリは変更されないものとして取り扱われ、フィルタ が欄の再マップを要求するなら欄は再マップされ、フィルタが明白な除外を要求 するなら(すなわちエントリが '-' 上書きと一致するなら)エントリは無視され、 エントリがフィルタ指定のどれとも一致しないならエントリは捨てられます。 .Pp また、NIS の '+' および '-' エントリ自身は、 .Pa /etc/master.passwd の中で指定された順序で取り扱われることに再度注意してください。 それ以外の方法で取り扱うと、予測不可能な振舞いとなってしまうからです。 .Pp 結局のところ、データベースのパラダイムを保ちつつ .Tn FreeBSD では .Tn SunOS と非常によく似た動作を行いますが、 .Xr getpwent 3 関数は .Tn SunOS のものとはいくぶん異なった振舞いをします。主な違いは以下の通りです。 .Bl -bullet -offset indent .It NIS パスワードマップの各々のレコードは、ローカルパスワード空間のパスワードに 1 度だけマップすることができます。 .It NIS の '+' および '-' のエントリの位置は、 NIS パスワードレコードがパスワード空間にマップされる場所に 必ずしも影響を与えません。 .El .Pp あらゆる .Tn FreeBSD の構成のうち99%においてはNISクライアントの振舞いは .Tn SunOS や他の同種のシステムのそれと区別できないものとなるでしょう。それでもこれ らのアーキテクチャ的な違いを知っておくことは必要です。 .Pp .Ss NIS上書きに関しネットグループの代りにグループを用いる .Tn FreeBSD はネットグループではなくユーザグループに基づいた上書き照合を行なう能力 を提供します。例えば NIS エントリが以下のように指定されたとき、 .Bd -literal -offset indent +@operator::::::::: .Ed システムはまず `operator' と呼ばれるネットグループに対してユーザを 照合しようとします。 `operator' ネットグループが存在しないとき、 システムは代りに通常の `operator' グループに対して照合しようとします。 .Ss FreeBSDの古いバージョンからの動作の変遷 .Tn FreeBSD のNIS/YPの取り扱いについてはいくつかのバグフィックスと改善がありました。 そのいくつかは動作上の変化をもたらしました。動作上の変化は一般に良い方向 にありますが、ユーザおよびシステム管理者がそれらについて知っておくことは 重要です。 .Bl -enum -offset indent .It 2.0.5 以前のバージョンでは、逆方向検索 (つまり .Fn getpwuid を用いる) には上書きは適用されませんでした。つまり、 .Fn getpwuid は .Fn getpwnam が認識しないログイン名を返すことがありました。 これは現在では .Pa /etc/master.passwd で指定された上書きを全ての .Xr getpwent 3 関数に適用することで解決されました。 .It .Fx 2.0.5 以前では、ネットグループの上書きは全く動作しませんでした。 これは主に .Tn FreeBSD が NIS を通してネットグループを読むことをサポートしなかったことが原因です。 これもまた修正され、 .Tn SunOS や同種の NIS を使用可能なシステムと全く同様に、 ネットグループを指定可能となりました。 .It .Tn FreeBSD は現在NISサーバの能力を持っており、標準第6版形式の .Pa passwd マップに加え .Pa master.passwd NIS マップの使用もサポートしています。このことは、NIS サーバとして .Tn FreeBSD システムを利用するなら、変更情報、有効期限の情報、クラス情報を指定可能であ るということを意味しています。 .El .Sh 関連ファイル .Bl -tag -width /etc/master.passwd -compact .It Pa /etc/passwd パスワードを除いた .Tn ASCII パスワードファイル .It Pa /etc/pwd.db パスワードを除いた .Xr db 3 形式のパスワードデータベース .It Pa /etc/master.passwd パスワードの入った .Tn ASCII パスワードファイル .It Pa /etc/spwd.db パスワードの入った .Xr db 3 形式のパスワードデータベース .El .Sh 関連項目 .Xr chpass 1 , .Xr login 1 , .Xr passwd 1 , .Xr getpwent 3 , .Xr login.conf 5 , .Xr login_getclass 3 , .Xr yp 4 , .Xr login.conf 5 , .Xr adduser 8 , .Xr pwd_mkdb 8 , .Xr vipw 8 , .Xr pw 8 .Sh バグ ユーザ情報は他のどこか に入れるべき(そして結局は入れることになる)でしょう。 .Pp YP/NISパスワードデータベースでは、 普通のユーザには暗号化されたパスワードが見えてしまいます。したがって .Pa master.passwd マップのシャドウパスワードおよび .Tn FreeBSD の .Xr ypserv 8 サーバを利用しないと、 簡単にパスワードクラッキングを許してしまうことになります。 .Pp .Pa master.passwd タイプのマップの使用をサポートする .Tn FreeBSD の .Xr ypserv 8 を使用しないと、 YP/NIS パスワードデータベースは 古いスタイル (第 6 版) のフォーマットになります。これは、 .Tn FreeBSD システムを標準 NIS サーバのクライアントとして利用するとき、 ユーザのログインクラスやパスワード期限等の 現在のフォーマットにある欄の値については サイトワイドな値が利用できなくなることを意味します。 .Sh 互換性 パスワードファイル形式は .Bx 4.3 以降で変更されました。以下の awk スクリプトは、古いスタイルの パスワードファイルを新しいスタイルのパスワードファイルに 変換するのに利用できます。 .Dq class , .Dq change , .Dq expire 欄が追加されましたが、デフォルトでは無効になっています。 これらの欄を設定するには .Xr vipw 8 もしくは .Xr pw 8 を使用してください。 .Bd -literal -offset indent BEGIN { FS = ":"} { print $1 ":" $2 ":" $3 ":" $4 "::0:0:" $5 ":" $6 ":" $7 } .Ed .Sh 歴史 .Nm ファイルは .At v6 で現われました。YP/NISの機能は .Tn SunOS を雛型として .Fx 1.1 で初めて現われました。上書き機能は .Fx 2.0 において新しく組込まれました。上書き機能はネットグループを適切に サポートするために .Fx 2.0.5 で更新されました。注釈のサポートは .Fx 3.0 で初めてサポートされました。 diff --git a/ja/man/man5/pbm.5 b/ja/man/man5/pbm.5 index ed4ff22a4a..3ac9ff653d 100644 --- a/ja/man/man5/pbm.5 +++ b/ja/man/man5/pbm.5 @@ -1,88 +1,88 @@ .\" .\" %Id: pbm.5,v 1.1.2.4 1998/07/19 06:52:12 jkh Exp % -.\" jpman $Id: pbm.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: pbm.5,v 1.3 1998/04/29 11:36:38 kuma Stab % .\" .\" WORD: whitespace 空白 .\" .Dd September 27, 1991 .Dt PBM 5 .Sh 名称 .Nm pbm .Nd ボータブルビットマップファイルのフォーマット .Sh 解説 ポータブルビットマップフォーマットは、 最低位の共通の白黒画像ファイルフォーマットです。 元々は、異なったタイプのマシン間で、 ビットマップ転送には適さないネットワークメーラを使用して、 ビットマップをメールで受け渡しする妥当な方法としてデザインされました。 現在は、多くのビットマップ変換フィルタ群の共通語として使用されています。 定義を以下に示します: .Pp .Bl -bullet -compact .It ファイルタイプを識別するための "マジックナンバ"。 pbm ファイルのマジックナンバは "P1" の 2 文字です。 .It 空白 (複数のブランク・TAB・CR・LF から成ります)。 .It 幅を ASCII 10 進数で表記します。 .It 空白。 .It 高さを ASCII 10 進数で表記します。 .It 空白。 .It 幅 * 高さの数のビット。各ビットは '1' または '0' で表し、 ビットマップ左上角を起点として通常の英語を読む向きに連続します。 .It 文字 '1' は黒を、'0' は白を表します。 .It ビット部の空白は無視されます。 .It \&"#" から行末までの文字列は無視されます (コメント)。 .It 長さが 70 文字を越える行は許されません。 .El .Pp 以下に、このフォーマットでの小さなビットマップの例を示します: .Bd -literal P1 # feep.pbm 24 7 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 1 1 1 0 0 1 1 1 1 0 0 1 1 1 1 0 0 1 1 1 1 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 1 0 0 1 1 1 0 0 0 1 1 1 0 0 0 1 1 1 0 0 0 1 1 1 1 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 1 1 1 0 0 1 1 1 1 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .Ed .Pp このフォーマットを読むプログラムは可能な限り寛大になるべきで、 少しでもビットマップのように見えるものはなんでも受け付けるべきです。 .Pp このフォーマットには派生形式があり、 RAWBITS オプションをコンパイル時にセットすることで利用可能です。 この派生形式は、以下の点が異なります: .Pp .Bl -bullet -compact .It \&"マジックナンバ" が "P1" ではなく "P4" です。 .It 8 ビットが 1 バイトに格納されます。上位ビットが先で下位ビットが後になります。 .It ビット部には空白は許されませんし、 高さの後には単一の空白 (通常は改行) のみが許されます。 .It ファイルは 1/8 の大きさになり、読み書きが何倍も高速になります。 .El .Sh 作者 Copyright (C) 1989, 1991 by .An Jef Poskanzer . .\" 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. This software is provided "as is" without express or .\" implied warranty. diff --git a/ja/man/man5/pccard.conf.5 b/ja/man/man5/pccard.conf.5 index 7126d2fed9..428ce09a34 100644 --- a/ja/man/man5/pccard.conf.5 +++ b/ja/man/man5/pccard.conf.5 @@ -1,189 +1,189 @@ -.\" jpman $Id: pccard.conf.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: pccard.conf.5,v 1.3 1998/07/10 15:23:53 jsakai Stab % .\" .\" 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. .\" .\" WORD: resource リソース[pccard.conf.5] .\" .Dd November 2, 1994 .Dt PCCARD.CONF 5 .Os FreeBSD .Sh 名称 .Nm pccard.conf .Nd .Xr pccardd 8 設定ファイル .Sh 解説 .Nm pccard.conf ファイルは、PC-CARD スロット管理デーモン .Xr pccardd 8 用の設定ファイルです。カードを識別し、 PC-CARD カードにドライバ (ドライバ用リソースも含む) を 対応させることが出来る情報を提供します。 .Pp 設定ファイル内には四つの基本的な要素があります。 オプションとして他のセクションに先立って .Em "リソースプール" があり、その後 1 つ以上の .Em "カード識別子" と .Em "デバイス実体" が続きます。 最後の 2 つはどんな順序で現れてもよく、 都合に応じてあちこちへ散在しても構いません。 .Pp それぞれの PC-CARD カードは、製造者やカードのバージョンを規定する 設定タプルを含んでいます。これらは、設定ファイル中でカードの仕様を 特定するのに使われ、それによって、そのカードとインタフェースをとれる ドライバを見つけます。 カードとドライバの間には、多対 1 の対応関係があります。すなわち、 単一のドライバが複数の型のカードにインタフェースをとることがあります。 この助けとして、ドライバの指定とは別に、カードの初期化や (ネットワークカードの場合なら) イーサネットアドレスの取り出し用に パラメータを指定することもできます。 .Pp ドライバは一度カードに割り当てられると、そのカードに割り当てられた ままになります。しかし、同じ型のドライバの複数の実体が設定される こともあるため、もし、同じの型のドライバが対応づけられているカードが 2 枚挿し込まれたら、同じ名前で別のドライバ実体が設定される可能性があります。 .Pp .Em insert と .Em remove コマンドは、実行可能なシェルコマンド行を指定することができます。 実行されるコマンドは、そのキーワードの後の行の残りです。 行は、バックスラッシュを使って継続することができます。 簡単なマクロ置換によって、現在のカーネルのデバイス名 .Em ( $device ) とネットワークカードのイーサネットアドレス .Em ( $ether ) をコマンド行へ入れることが可能です。 .Xr pccardd 8 は、コマンド行を実行するために .Xr system 3 サブルーチンを使います。 .Pp 数値は 8 進数、16 進数、10 進数のいずれかの表現をとります。 もし 10 進数に .Em k か .Em K が付いていれば、その値は 1024 を掛けたものになります。 名前にスペースを含める必要があるならば、 ダブルクォートで括っておくとよいでしょう。 ハッシュ文字 (#) は、その行の残りをコメントにします。 .Ss "リソースプール" この (オプションである) セクションは、ISA バスのメモリアドレス空間や I/O ポート、割込み要求番号 (IRQ) といったシステムリソースのプールを指定します。 このリソースプールは、それぞれのドライバの記述中で指定された要求に応じて、 動的にアドレス空間や割り込み番号を割り当てるのに使われます。 .Pp リソースに関する構文は以下の通りです。 .Pp .Dl io Ar start - end ... .Dl memory Ar address size ... .Dl irq Ar irq-number ... .Pp 各文では、初期化時にドライバへ割り当てるのに使える、 I/O やメモリや IRQ のブロックを定義します。 .Pp 上の文はどれも複数行にすることができ、 これで各々のリソースをかたまりに分けて定義することができます。 .Ss "カード識別子" カード識別子の構文は以下の通りです。 .Pp .Dl card Ar manufacturer version .Dl config Ar index driver interrupt [ flags ] .Dl ether Ar offset .Dl insert Ar command .Dl remove Ar command .Pp 第 1 行は必須です。あとの文はオプションであり、 どのような順序で現れても構いません。 .Em config 行は複数存在することもあります。 .Em card のパラメータには、製造者名とカードのバージョンがあり、 カードの CIS メモリから得た値との一致をみるのに使われます。 .Em config パラメータは、 カードの CIS で得られる範囲からそのカードの設定インデックスを選択し、 この設定で関連づけられたドライバを選択し、 そして (もしあれば) 割り当てられるべき割り込みレベルを選択します。 オプションとしてフラグの集合を割り当てることもできます。 .Pp オプションの .Em ether キーワードは、カードの属性メモリ内に ネットワークカードの物理イーサネットアドレスが保持されているときに使われます。 この文のパラメータは、イーサネットアドレスの属性メモリ内での オフセットを指しています。この値は、 .Em $ether マクロを使うことで、 insert/remove コマンド内でも使用できます。 .Pp .Em insert 及び .Em remove セクションでは、カードが挿入されたり取り外されたりしたときに 実行されるべきシェルコマンドを書くことができます。複数の .Em insert や .Em remove コマンドも書くことができ、その場合列挙された順に実行されます。 .Sh 使用例 典型的な設定ファイルは以下のような体裁でしょう。 .Bd -literal # # サンプル設定ファイル # # パラメータのプール # io 0x280 - 0x2F0 0x300 - 0x360 irq 5 6 8 9 10 15 memory 0xd4000 96k memory 0xc4000 32k # # カードデータベース # card "RPTI LTD." "EP400" # NE2000 clone ether 0x110 config 0x21 "ed0" 5 insert ifconfig $device physical $ether insert ifconfig $device bean remove ifconfig $device down card "XYZZY" "FAX/1.0" tty config 0x30 "sio1" 11 insert echo start getty remove echo stop getty .Ed .Sh 関連ファイル .Bl -tag -width /etc/pccard.conf -compact .It Pa /etc/pccard.conf .Xr pccardd 8 の設定ファイル。 .El .Sh 関連項目 .Xr pccardd 8 diff --git a/ja/man/man5/phones.5 b/ja/man/man5/phones.5 index dde7ae4d9d..fcab2f29bb 100644 --- a/ja/man/man5/phones.5 +++ b/ja/man/man5/phones.5 @@ -1,80 +1,80 @@ .\" 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. .\" .\" @(#)phones.5 8.1 (Berkeley) 6/5/93 -.\" jpman $Id: phones.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: phones.5,v 1.3 1998/07/21 23:07:26 jsakai Stab % .\" %Id: phones.5,v 1.1.1.1.8.1 1997/03/07 04:18:08 mpp Exp % .\" .Dd June 5, 1993 .Dt PHONES 5 .Os BSD 4.2 .Sh 名称 .Nm phones .Nd リモートホストの電話番号のデータベース .Sh 解説 ファイル .Pa /etc/phones には、 .Xr tip 1 プログラムが使用する、 システム内のプライベートな電話番号が格納されます。 このファイルは通常は読めませんので、特権情報を格納することができます。 このファイルのフォーマットは、次の形式の一連の行です: <システム名>[\ \et]*<電話番号>。 システム名は .Xr remote 5 ファイルで定義されているものの 1 つであり、 電話番号は ``,'' もしくは行末で終わる任意の文字列からなります。 ``='' および ``*'' の文字は、(交換機を通す場合) 一旦停止して次のダイアルトーンを待つように自動電話機能に指示します。 ``='' は .Tn DF02-AC にて必要ですし、``*'' は .Tn BIZCOMP 1030 にて必要です。 .Pp 1 行には 1 つの電話番号のみ記述可能です。 しかしながら、ファイル中に同じシステム名が含まれる場合、 .Xr tip 1 は接続を確立するまで順番に各番号にダイアルしようとします。 .Sh 関連ファイル .Bl -tag -width /etc/phones -compact .It Pa /etc/phones .El .Sh 関連項目 .Xr tip 1 , .Xr remote 5 .Sh 歴史 .Nm ファイルは .Bx 4.2 に登場しました。 diff --git a/ja/man/man5/printcap.5 b/ja/man/man5/printcap.5 index dc1044186e..7b2647f8d4 100644 --- a/ja/man/man5/printcap.5 +++ b/ja/man/man5/printcap.5 @@ -1,279 +1,279 @@ .\" 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. .\" .\" @(#)printcap.5 8.2 (Berkeley) 12/11/93 .\" %Id: printcap.5,v 1.5.2.5 1998/04/28 13:49:50 danny Exp % .\" -.\" jpman $Id: printcap.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: printcap.5,v 1.3 1998/07/21 23:12:17 jsakai Stab % .Dd December 11, 1993 .Dt PRINTCAP 5 .Os BSD 4.2 .Sh 名称 .Nm printcap .Nd プリンタケーパビリティデータベース .Sh 書式 .Nm printcap .Sh 解説 .Nm printcap は、 ラインプリンタの記述に使われる .Xr termcap 5 を簡略化したものです。 スプールシステムは利用のたび毎に .Nm printcap ファイルにアクセスするため、 プリンタを動的に追加したり削除することが可能です。 データベース中の各々のエントリが、1 台のプリンタを記述するのに使われます。 .Xr termcap 5 とは異なり、このデータベースは代替できません。 これは、アカウント情報がバイパスされてしまうことがあるからです。 .Pp デフォルトのプリンタは通常 .Em lp ですが、環境変数 .Ev PRINTER によって上書きすることもできます。 各スプーリングユーティリティはオプション .Fl P Ar printer をサポートし、出力先のプリンタ名を明示することが可能です。 .Pp あるプリンタに対するデータベースをセットアップする方法の詳細については、 .%T "4.3 BSD Line Printer Spooler Manual" を参照してください。 .Sh ケーパビリティ ファイルレイアウトの解説については .Xr termcap 5 を参照してください。 .Bl -column Namexxx Typexx "/var/spool/lpdxxxxx" .Sy Name Type Default Description .It "af str" Ta Dv NULL Ta No "アカウンティングファイル名" .It "br num none lp が tty の場合、ボーレートを設定 " .Pf ( Xr ioctl 2 call) .It "cf str" Ta Dv NULL Ta No "cifplot データ用フィルタ" .It "ct num 120 TCP コネクションのタイムアウト時間(秒)" .It "df str" Ta Dv NULL Ta No "tex データ用フィルタ" .Pf ( Tn DVI フォーマット) .It "ff str" Ta So Li \ef Sc Ta No "フォームフィード送信文字" .It "fo bool false デバイスオープン時にフォームフィードを印字" .It "gf str" Ta Dv NULL Ta No "グラフデータフィルタ" .Pf ( Xr plot 3 フォーマット .It "hl bool false バーストヘッダページを最後に印刷" .It "ic bool false 字下げ出力の用の(非標準の) ioctl をサポートした ドライバ" .It "if str" Ta Dv NULL Ta No "アカウンティングを行うためのテキストフィルタ名" .It "lf str" Ta Pa /dev/console Ta No "エラーロギングファイル名" .It "lo str" Ta Pa lock Ta No "ロックファイル名" .It "lp str" Ta Pa /dev/lp Ta No "出力時にオープンするデバイス名" .It "ms str" Ta Dv NULL Ta No "lp が tty の場合、コンマで区切ったリスト。" tty モード記述用の .Xr stty 1 リストに似ている。 .It "mx num 1000 最大ファイルサイズ (" .Dv BUFSIZ ブロック単位)。0 = 制限なし。 .It "nd str" Ta Dv NULL Ta No "キューのリスト用の次のディレクトリ (未実装)" .It "nf str" Ta Dv NULL Ta No "ditroff データ用フィルタ (device independent troff)" .It "of str" Ta Dv NULL Ta No "出力用フィルタリングプログラム名" .It "pc num 200 1 フィートまたは 1 ページあたりの 費用 (1/100 セント単位)" .It "pl num 66 1 ページの行数" .It "pw num 132 1 行の文字数" .It "px num 0 ピクセル単位のページ幅 (水平方向)" .It "py num 0 ピクセル単位のページ長 (垂直方向)" .It "rf str" Ta Dv NULL Ta No "" .Tn FORTRAN 形式のテキストファイル出力用フィルタ .It "rg str" Ta Dv NULL Ta No "グループ制限。許可されたグループのメンバのみアクセスが許可される" .It "rm str" Ta Dv NULL Ta No "リモートプリンタ名" .It "rp str ``lp'' リモートプリンタ名引数" .It "rs bool false ローカルにアカウントを持つリモートユーザに対する制限" .It "rw bool false 読み書き用にオープンするプリンタデバイス名" .It "sb bool false 短いバナー (1 行のみ)" .It "sc bool false 複数コピーの抑制" .It "sd str" Ta Pa /var/spool/lpd Ta No "スプール ディレクトリ" .It "sf bool false フォームフィードの抑制" .It "sh bool false バーストページヘッダの出力抑制" .It "st str" Ta Pa status Ta No "状態ファイル名" .It "tf str" Ta Dv NULL Ta No "troff データ用フィルタ (cat phototypesetter)" .It "tr str" Ta Dv NULL Ta No "キューが空の時に印刷するトレイラ文字列" .It "vf str" Ta Dv NULL Ta No "ラスタイメージ用フィルタ" .El .Pp ローカルラインプリンタのドライバが字下げをサポートしているならば、 プリンタデーモンはその使い方を理解しなければなりません。 .Sh フィルタ .Xr lpd 8 デーモンは .Em filters のパイプラインを作成し、さまざまなタイプのプリンタ用に処理を行います。 フィルタは .Xr lpr 1 へ渡されるフラグに応じて選択されます。 パイプラインは次のように設定されます。 .Bd -literal -offset indent p pr | if 通常テキスト + pr(1) none if 通常テキスト c cf cifplot d df DVI (tex) g gf plot(3) n nf ditroff f rf Fortran t tf troff v vf ラスタイメージ .Ed .Pp .Sy if フィルタは次の引数をとります。 .Bd -filled -offset indent .Cm if .Op Fl c .Fl w Ns Ar width .Fl l Ns Ar length .Fl i Ns Ar indent .Fl n Ar login .Fl h Ar host acct-file .Ed .Pp .Fl c フラグは .Fl l フラグ (コントロール文字をそのまま通過させます) が .Xr lpr 1 に指定された場合のみ渡されます。 .Ar width 機能と .Ar length 機能はページ幅とページ長を (それぞれ .Cm pw と .Cm pl によって) 文字単位で指定します。 .Fl n と .Fl h パラメータでそれぞれのジョブの所有者のログイン名とログイン先ホスト名を 指定します。 .Ar acct-file 機能は .Nm printcap の .Cm af エントリがそのまま使われます。 .Pp .Cm if が指定されなかった場合、 .Cm of が代わりに使われます。 .Cm of は .Cm if が個々のジョブ毎にオープンされるのに対して、たった 1 回だけ オープンされると言う特徴を持っています。 そのため、アカウンティングを行うには .Cm if の方が向いています。 .Cm of には、 .Ar width と .Ar length フラグのみが与えられます。 .Pp その他の全てのフィルタは次のように呼び出されます。 .Bd -filled -offset indent .Nm filter .Fl x Ns Ar width .Fl y Ns Ar length .Fl n Ar login .Fl h Ar host acct-file .Ed .Pp .Ar width と .Ar length はピクセル単位で表され、それぞれ .Cm px と .Cm py エントリで指定されます。 .Pp 全てのフィルタはファイルを .Em stdin から読み込み .Em stdout からの出力をプリンタに送られ、 .Em stderr または .Xr syslog 3 がログ出力に使われます。 フィルタは .Dv SIGINT を無視してはいけません。 .Sh ロギング ラインプリンタプログラム自身 (つまり .Xr lpd 8 とそれに関連するプログラム) が生成したエラーメッセージは、 .Xr syslog 3 の .Dv LPR ファシリティを使ってロギングされます。 フィルタの 1 つから .Em stderr に出力されたメッセージは、対応する .Cm lf で指定されたファイルに送られます。 当然、フィルタ自身もまた .Xr syslog 8 を使うことがあるかも知れません。 .Pp コンソールに送られるエラーメッセージには、ラインフィードだけではなく キャリッジリターンとラインフィードが追加されます。 .Sh 関連項目 .Xr lpq 1 , .Xr lpr 1 , .Xr lprm 1 , .Xr hosts.lpd 5 , .Xr termcap 5 , .Xr lpc 8 , .Xr lpd 8 , .Xr pac 8 .Rs .%T "4.3 BSD Line Printer Spooler Manual" .Re .Sh 歴史 .Nm ファイルフォーマットは .Bx 4.2 から登場しました。 diff --git a/ja/man/man5/procfs.5 b/ja/man/man5/procfs.5 index 41e5071e64..17230a3e05 100644 --- a/ja/man/man5/procfs.5 +++ b/ja/man/man5/procfs.5 @@ -1,216 +1,216 @@ .\" %Id: procfs.5,v 1.2.8.4 1998/06/28 21:34:27 hoek Exp % -.\" jpman $Id: procfs.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: procfs.5,v 1.3 1998/07/03 09:09:33 mutoh Stab % .\" Written by Garrett Wollman .\" This file is in the public domain. .\" .Dd August 10, 1994 .Dt PROCFS 5 .Os BSD 4.4 .Sh 名称 .Nm procfs .Nd プロセスファイルシステム .Sh 書式 .Bd -literal proc /proc procfs rw 0 0 .Ed .Sh 解説 プロセスファイルシステム、すなわち .Nm procfs はファイルシステム中でシステムプロセステーブルの閲覧を可能にします。 .Nm procfs は通常 .Pa /proc にマウントされ、 .Xr ps 1 や .Xr w 1 といったプログラムの完全な動作に必要なものです。 .Pp .Nm は以前の .Fx 1.1 .Nm での実装とは異なり、 プロセス空間に 2 つのレベルの視点を提供します。 高いレベルでは、プロセスはそれ自身が、10 進数による先頭に 0 の付かない 自分のプロセス ID によって、名前付けされます。また .Pa curproc と呼ばれる調査要求を行なったプロセスを参照する特別なノードが存在します。 .Pp それぞれのノードは以下の項目を含むディレクトリです: .Pp それぞれのディレクトリは数個のファイルを含んでいます: .Bl -tag -width status .It Pa ctl 多様な制御操作をサポートする書き込みのみのファイル。 制御コマンドは .Pa ctl ファイルに文字列として書き込まれます。 制御コマンドは: .Bl -tag -width detach -compact .It attach 対象プロセスを停止し、 送信プロセスに対してデバッグ制御プロセスとなるよう手配する。 .It detach 対象プロセスの実行を継続し、デバッグプロセスの制御下から離します (送信プロセスである必要はありません)。 .It run シグナルが届くか、ブレークポイントに達するか、または対象プロセスが 終了するまで対象プロセスを継続して動作させます。 .It step シグナルを届けずに対象プロセスをシングルステップさせます。 .It wait 対象プロセスがデバッグに適した平衡状態になるまで待ちます。 対象プロセスは他のどのコマンドが許可されるよりも前に この状態になる必要があります。 .El .Pp 文字列は、 .Dv SIG 接頭辞なしの小文字のシグナル名でも構いません。 この場合、指定したシグナルがプロセスに届けられます。 .Pf ( Xr (sigaction 2 参照)。 .It Pa etype .Pa file 項目によって参照される実行形式のタイプ。 .It Pa file プロセステキストが読まれる vnode への参照。 これはプロセスのシンボルテーブルへのアクセスを得る、 またはプロセスのもう 1 つのコピーを始めるために使われます。 .It Pa fpregs .Pa 中の .Dv "struct fpregs" で定義される浮動小数点レジスタ。 .Pa fpregs は、汎用レジスタセットと浮動小数点レジスタセットが明確に区別されたマシンにのみ 実装されています。 .It Pa map プロセスの仮想メモリのマップ。 .It Pa mem プロセスの完全な仮想メモリイメージ。 プロセス中に存在するアドレスのみがアクセスできます。 このファイルに対する読み書きはプロセスを修正します。 テキストセグメントに対する書き込みはそのプロセスのみに留まります。 .It Pa note プロセスへシグナルを送るために使われます。実装されていません。 .It Pa notepg プロセスグループへシグナルを送るために使われます。実装されていません。 .It Pa regs プロセスのレジスタセットへの読み書き手段を提供します。 このファイルは .Pa 中で定義されている .Dv "struct regs" バイナリデータ構造体を含んでいます。 .Pa regs はプロセスが停止しているときのみ書き込みできます。 .It Pa status プロセスの状態。 このファイルは読み込みのみで、空白で分けられた以下の多数のフィールドを 含んだ 1 行を返します: .Pp .Bl -bullet -compact .It コマンド名 .It プロセス ID .It 親プロセス ID .It プロセスグループ ID .It セッション ID .It 制御端末の .Ar major,minor 、またはもし制御端末がない場合には .Dv -1,-1 。 .It プロセスフラグのリスト: .Dv ctty 制御端末がある、 .Dv sldr プロセスがセッションリーダである、 .Dv noflags 他の 2 つのフラグがセットされていない。 .It コンマで区切った秒とマイクロ秒によるプロセス開始時刻 .It コンマで区切った秒とマイクロ秒によるユーザ時間 .It コンマで区切った秒とマイクロ秒によるシステム時間 .It ウェイトチャンネルメッセージ .It 実効ユーザ ID と全てコンマで区切られた グループリスト(最初の項目は実効グループ ID) から成っている プロセスクリデンシャル .El .El .Pp 対象がデバッガによって fork/exec される通常のデバッギング環境では、 デバッガが fork し、子は自分自身で止まる(例えば自分で与えた .Dv SIGSTOP ) べきです。 親は適切な .Pa ctl ファイルを通じて .Dv wait そして .Dv attach コマンドを発行するべきです。 子プロセスは exec 呼び出しが終わった直後に .Dv SIGTRAP を受け取ります .Pf ( Xr execve 2 参照)。 .Pp それぞれのノードはプロセスのユーザに所持され、 ユーザのプライマリグループに属します。 .Pa mem ノードは例外的に .Li kmem グループに属します。 .Sh 関連ファイル .Bl -tag -width /proc/curproc/XXXXXXX -compact .It Pa /proc .Nm procfs の通常のマウントポイント。 .It Pa /proc/pid プロセス .Pa pid のプロセス情報を含んだディレクトリ .It Pa /proc/curproc カレントプロセスのプロセス情報を含んだディレクトリ .It Pa /proc/curproc/ctl プロセスへの制御メッセージを送るために使われます .It Pa /proc/curproc/etype 実行形式タイプ .It Pa /proc/curproc/file 実行形式イメージ .It Pa /proc/curproc/fpregs プロセス浮動小数点レジスタセット .It Pa /proc/curproc/map プロセスの仮想メモリマップ .It Pa /proc/curproc/mem プロセスの完全な仮想アドレス空間 .It Pa /proc/curproc/note プロセスへのシグナル送信に使われます .It Pa /proc/curproc/notepg プロセスグループへのシグナル送信に使われます .It Pa /proc/curproc/regs プロセスのレジスタセット .It Pa /proc/curproc/status プロセスの現在の状態 .El .Sh 関連項目 .Xr mount 2 , .Xr sigaction 2 , .Xr unmount 2 , .Xr mount_procfs 8 .Sh 作者 このマニュアルページは Jan-Simon Pendry によって提供された記述に基づいて Garrett Wollman によって書かれ、 後に Mike Pritchard によって手直しされました。 diff --git a/ja/man/man5/protocols.5 b/ja/man/man5/protocols.5 index 380db74917..93bec4853f 100644 --- a/ja/man/man5/protocols.5 +++ b/ja/man/man5/protocols.5 @@ -1,76 +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. .\" .\" @(#)protocols.5 8.1 (Berkeley) 6/5/93 -.\" jpman $Id: protocols.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: protocols.5,v 1.3 1998/06/17 07:52:20 kumano Stab % .\" %Id: protocols.5,v 1.1.1.1.8.1 1997/03/07 04:18:09 mpp Exp % .\" .Dd June 5, 1993 .Dt PROTOCOLS 5 .Os BSD 4.2 .Sh 名称 .Nm protocols .Nd プロトコル名のデータベース .Sh 解説 .Nm protocols ファイルには .Tn DARPA インターネットで使用される既知のプロトコルの情報が格納されます。 各プロトコル毎に、以下の情報を表す 1 行が存在します。 .Bd -unfilled -offset indent 公式なプロトコル名 プロトコル番号 別名 .Ed .Pp 項目は任意個の空白文字やタブ文字で分けられます。 ``#'' はコメント開始を表し、 行末までの文字はファイルを検索するルーチンに解釈されません。 .Pp プロトコル名は、フィールド区切り文字・改行文字・コメント文字以外の、 任意の表示可能文字からなります。 .Sh 関連ファイル .Bl -tag -width /etc/protocols -compact .It Pa /etc/protocols .Nm protocols ファイルは .Pa /etc にあります。 .El .Sh 関連項目 .Xr getprotoent 3 .Sh バグ 静的ファイルの代わりに、ネームサーバを使用すべきです。 .Sh 歴史 .Nm ファイルフォーマットは .Bx 4.2 に登場しました。 diff --git a/ja/man/man5/pw.conf.5 b/ja/man/man5/pw.conf.5 index 26084e81bf..717fee09b6 100644 --- a/ja/man/man5/pw.conf.5 +++ b/ja/man/man5/pw.conf.5 @@ -1,283 +1,283 @@ .\" 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.conf.5,v 1.1.1.1.2.5 1997/12/25 09:35:59 hoek Exp % -.\" jpman $Id: pw.conf.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: pw.conf.5,v 1.3 1998/07/02 18:49:55 kumano Stab % .\" .Dd December 9, 1996 .Dt PW.CONF 5 .Os .Sh 名称 .Nm pw.conf .Nd pw.conf 設定ファイルのフォーマット .Sh 解説 ファイル .Aq Pa /etc/pw.conf には .Xr pw 8 プログラムで使用される設定データが含まれています。 .Xr pw 8 プログラムはシステムのパスワードとグループファイルのメンテナンスに使用され、 ユーザやグループを追加、削除、変更します。 このファイルは .Xr pw 8 コマンドによって .Ar useradd コマンドと .Fl D オプション を使うか、テキストエディタによって直接編集することによって変更されます。 .Pp .Aq Pa /etc/pw.conf における各行は、コメントもしくは設定データとして扱われます。 空白行と .Ql \&# 文字によって開始している行はコメントとなります。 それら以外の行はキーワードが最初に指定され、 それに対応するデータが続くものとして処理されます。 .Pp .Xr pw 8 によって認識されるキーワードには以下のものがあります。 .Bl -tag -width password_days -offset indent -compact .It defaultpasswd 新規ユーザのパスワードとなります。 .It reuseuids UID の空き番号を再使用します。 .It reusegids GID の空き番号を再使用します。 .It skeleton ホームディレクトリにコピーするデフォルトのファイルの在処です。 .It newmail 新規ユーザに送付するメールです。 .It logfile このファイルにユーザ/グループの変更のログを取ります。 .It home ホームディレクトリのルートディレクトリです。 .It shellpath シェルプログラムのパスです。 .It shells 有効なシェルのリストです (パスは含みません)。 .It defaultshell デフォルトのシェルです (パスは含みません)。 .It defaultgroup デフォルトのグループです。 .It extragroups 新規ユーザをこのグループに追加します。 .It defaultclass 新規ユーザのこのログインクラスに設定します。 .It minuid .It maxuid 有効なデフォルトユーザ ID の範囲です。 .It mingid .It maxgid 有効なデフォルトグループ ID の範囲です。 .It expire_days アカウントが期限切れとなるまでの日数です。 .It password_days パスワードが期限切れとなるまでの日数です。 .El .Pp .Ar defaultpasswd の有効な値は以下の通りです。 .Bl -tag -width password_days -offset indent -compact .It no 新規に作成したアカウントでのログインを無効にします。 .It yes パスワードをアカウント名に強制的に設定します。 .It none 強制的にパスワードをブランクにします。 .It random ランダムなパスワードを生成します。 .El .Pp 2 番目と 3 番目のオプションは安全ではなく、 一般からアクセス可能なシステムでは可能であれば避けるべきです。 最初のオプションはそのアカウントが使用される前にスーパユーザが .Xr passwd 1 を使ってパスワードを設定する必要があります。 これは管理者のアカウントを作成する場合にも便利です。 最後のオプションでは .Xr pw 8 は標準出力にランダムに生成したパスワードを出力します。 これが最も好ましく安全なオプションです。 .Xr pw 8 はファイルハンドル経由で (コマンド行による方法は安全でないためです) 新規ユーザに特定のパスワードを設定する方法も提供しています。 .Pp .Ar reuseuids と .Ar reusegids は新規のユーザ ID とグループ ID 番号の生成方法を指定します。 このフィールドで .Ql \&yes が指定されていると .Xr pw 8 は許可された範囲で 最初の使用されていないユーザ ID か グループ ID を検索します。 .Ql \&no が指定されていると 範囲中のすでに存在している他のユーザ ID もしくはグループ ID が 新規に生成された ID より必ず小さくなることを保証し、 以前にユーザもしくはグループを削除したことによって生じた グループ ID もしくはユーザ ID の空き番号を再度使用することを 避けることができます。 デフォルトグループがキーワード .Ar defaultgroup によって指定されていない場合、 .Xr pw 8 は新規ユーザに対して新規グループを生成し、 新規のユーザ ID とグループ ID に同じものを使用するように試みます。 新規ユーザのユーザ ID がすでにグループ ID として使用されている場合は、 その代わりに次に使用可能なグループ ID が選択されます。 .Pp .Ar skeleton キーワードはユーザの新規のホームディレクトリの内容を作る上での もととなるディレクトリを指定します。 デフォルトでは .Pa /usr/share/skel となっています。 .Xr pw 8 で .Fl m オプションを指定すると、ユーザのホームディレクトリが作成され、 .Ar skeleton ディレクトリに含まれるファイルがそこにコピーされます。 .Pp .Ar newmail キーワードによって送信するメッセージの本文を含むファイルの パス名を指定することによって、 新規ユーザに通知の電子メールを送信することができます。 アカウントが作成された時にメールを出さないようにするには、 このエントリを空にしておくか .Ql \&no を指定します。 .Pp .Ar logfile オプションによってパスワードファイルの変更のログを指定したログファイルに 取ることができます。 ログファイルを作成したり追加したりしないようにするには、 このフィールドを空にしておくか .Ql \&no を指定します。 .Pp .Ar home キーワードは必ず指定する必要のあるものです。 これはすべての新規ユーザのホームディレクトリが作成される ディレクトリの場所を指定するものです。 .Pp .Ar shellpath はログインシェルとして使われるプログラムが含まれる ディレクトリのリストをコロン .Ql \&: で区切って指定します。 .Pp .Ar shells キーワードはログインシェルとして使用可能なプログラムのリストを指定します。 このリストはコンマで区切られたシェル名のリストであり、パスは含みません。 これらのシェルは .Ar shellpath によって指定されているいずれかのディレクトリの中にある必要があります。 .Pp .Ar defaultshell キーワードは .Xr pw 8 のコマンド行で新規ユーザのシェルプログラムが 何も指定されていない場合のシェルプログラムを指定します。 .Pp .Ar defaultgroup キーワードは新規アカウントに使用される第 1 グループ (パスワードファイル中のグループ ID 番号) を指定します。 これが空であるか、 .Ql \&no が指定されていると各々の新規ユーザには自動的に各々のグループが 作成されます。 これはユーザによって通常使われている .Em umask に関係なく、システムの他のユーザによる不正アクセスから 各ユーザのファイルを守ることができるため、 新規にユーザを作成する場合の推奨方法となります。 .Pp .Ar extragroups によって新規ユーザを自動的に .Pa /etc/groups ファイル中のグループに登録することができます。 これはすべてのユーザがあるリソースを共有していたり、 ユーザを同じ第 1 グループに登録したい場合に便利な機能です。 .Xr pw 8 のコマンドオプションで .Fl G を使用することによって、このキーワードの効果を変更することができます。 .Pp .Ar defaultclass フィールドにより、 .Xr pw 8 によって指定されない場合に新規ユーザが割り当てられるログインクラス ( .Xr login.conf 5 参照) を指定することができます。 .Pp .Ar minuid , .Ar maxuid , .Ar mingid , .Ar maxgid の各キーワードは自動的に割り当てるユーザ ID とグループ ID 番号の 範囲を指定します。 ユーザとグループ ID のデフォルトの値は最小 1000 から最大 32000 の 範囲となります。 実際に .Xr pw 8 によってアカウントを作成する際に使用されるユーザとグループ ID は コマンド行のオプションの .Fl u と .Fl g によって変更することができます。 .Pp .Ar expire_days と .Ar password_days はそれぞれアカウントが作成された日から、 アカウントの期限が切れる日、 またはユーザがアカウントのパスワードの変更を強要される日までの 日数計算を自動的に行うために使用されます。 いずれかのフィールドで値 .Ql \&0 を指定すると、対応する (アカウントかパスワードの) 期限切れを抑止します。 .Pp .Sh 制限事項 .Pa /etc/pw.conf で 1 行は最長 1024 文字までとなります。 これより長い行についてはスキップされコメントとして扱われます。 .Sh 関連ファイル .Bl -tag -width /etc/master.passwd -compact .It Pa /etc/pw.conf .It Pa /etc/passwd .It Pa /etc/master.passwd .It Pa /etc/group .El .Sh 関連項目 .Xr passwd 1 , .Xr group 5 , .Xr login.conf 5 , .Xr passwd 5 , .Xr pw 8 diff --git a/ja/man/man5/ranlib.5 b/ja/man/man5/ranlib.5 index e21e3eb0e1..778261e603 100644 --- a/ja/man/man5/ranlib.5 +++ b/ja/man/man5/ranlib.5 @@ -1,73 +1,73 @@ .\" 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. .\" .\" @(#)ranlib.5.5 8.1 (Berkeley) 6/6/93 -.\" jpman $Id: ranlib.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: ranlib.5,v 1.3 1998/06/25 08:46:35 jsakai Stab % .\" .Dd June 6, 1993 .Dt RANLIB 5 .Os .Sh 名称 .Nm ranlib .Nd アーカイブ (ライブラリ) の目次テーブルのフォーマット .Sh 書式 .Fd #include .Sh 解説 アーカイブの目次テーブルコマンド .Nm は、オブジェクトファイルを含むアーカイブの目次テーブルを作成します。 このテーブルはリンクエディタ .Xr ld 1 が使用します。 このコマンドは、ユーティリティ .Xr ar 1 が作成したアーカイブに対して操作を行ないます。 .Pp .Nm の機能により、 3 つの部分からなる新しいファイルがアーカイブの先頭に付加されます。 最初の部分は標準のアーカイブヘッダであり、特別な名前フィールド \&"__.SYMDEF" を持ちます。 .Pp 2 番目の部分は ``long'' に ranlib 構造のリストが続きます。 long は ranlib 構造のバイトでの大きさです。 各 ranlib 構造は、 次の部分 (シンボルの文字列テーブル) への 0 を基準としたオフセットと、 シンボルを定義するアーカイブファイルへのアーカイブの先頭からのオフセット からなります。 実際の ranlib 構造の個数は、 この数値を個々の ranlib 構造の大きさで割ったものです。 .Pp 3 番目の部分は ``long'' に文字列テーブルが続きます。 long は文字列テーブルのバイト数です。 .Sh 関連項目 .Xr ar 1 , .Xr ranlib 1 diff --git a/ja/man/man5/rc.conf.5 b/ja/man/man5/rc.conf.5 index 3fe1058b7c..c8cf62d30b 100644 --- a/ja/man/man5/rc.conf.5 +++ b/ja/man/man5/rc.conf.5 @@ -1,880 +1,880 @@ .\" Copyright (c) 1995 .\" Jordan K. Hubbard .\" .\" 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 ``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: rc.conf.5,v 1.1.2.11 1998/06/27 21:23:28 steve Exp % .\" -.\" jpman $Id: rc.conf.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: rc.conf.5,v 1.3 1998/06/26 09:39:58 jsakai Stab % .\" .Dd April 26, 1997 .Dt RC.CONF 5 .Os FreeBSD 2.2.2 .Sh 名称 .Nm rc.conf .Nd ローカルコンフィギュレーションの情報 .Sh 解説 .Nm rc.conf ファイルはローカルホスト名、全ての潜在的なネットワークインタフェースに 関するコンフィギュレーションの詳細、システムの初期起動時に立ち上げるべき サービスに関する記述可能な情報を含んできます。初めてインストールする際に は、一般に .Nm rc.conf ファイルはシステムインストールユーティリティ .Pa /stand/sysinstall によって初期化されます。 .Pp ローカルホスト上で変化が生じるたびにこのファイルを適切に保守することはシ ステム管理者の仕事です。 .Sh 関連ファイル .Bl -tag -width /etc/rc.conf -compact .It Pa /etc/rc.conf .El .Sh 解説 .Nm の目的は、 コマンドの実行やシステム起動操作を直接行うことではありません。 それに代わり、 そこに見出される設定にしたがって内部操作を条件付きで制御する .Pa /etc 下のいろいろな類の起動スクリプトの一部をなしています。 .Pp 以下に示すのは .Nm ファイル中で設定可能な各変数について、 その名前と簡単な解説をリストしたものです。 .Bl -tag -width Ar .It Ar swapfile (文字列) .Ar NO にセットすると スワップファイルはインストールされません。 .Ar NO 以外の場合、その値は追加スワップ領域のために利用するファイルの 完全パス名として用いられます。 .It Ar apm_enable (ブール値) .Ar YES にセットすると .Xr apm 8 コマンドでの自動電源管理(Automatic Power Management)のサポートを有効に します。 .It Ar pccard_enable (ブール値) .Ar YES にセットすると起動時にPCCARDのサポートを有効にします。 .It Ar pccard_mem (文字列) PCCARDコントローラメモリアドレスをセットします。 .Ar DEFAULT とするとデフォルト値になります。 .It Ar pccard_ifconfig (文字列) 挿入または起動時に動的にifconfigされるべきイーサネットデバイス のリストです。 (例 .Ar "ed0 ed1 ep0 ..." ) .It Ar local_startup (文字列) 起動スクリプトファイルを検索するためのディレクトリのリストです。 .It Ar hostname (文字列) ネットワーク上でのあなたのホストの完全な形のドメイン名 (The Fully Qualified Domain Name) です。あなたがネットワークに接続されていない 場合でも、この変数は確実に何か意味のあるものに設定すべきです。 .It Ar nisdomainname (文字列) あなたのホストの NIS ドメイン名。NIS が動いてないときは .Ar NO とします。 .It Ar firewall_enable (ブール値) 起動時にロードされるファイアウォール規則を持ちたくないときには .Ar NO 、持ちたいときには .Ar YES をセットします。 .Ar YES にセットし、かつカーネルが IPFIREWALL 付きで作られなかった場合、 ipfw カーネルモジュールがロードされます。 .It Ar firewall_type (文字列) .Pa /etc/rc.firewall 中で選択されたファイアウォールのタイプまたはローカルファイアウォール規則 の組を含むファイルを名付けます。 .Pa /etc/rc.firewall 中では以下のものが選択可能です: ``open''- 無制限の IP アクセス; ``closed''- lo0 経由を除く全ての IP サービスを禁止; ``client''- ワークステーション向けの基本的な保護; ``simple''- LAN 向けの基本的な保護。 ファイル名が指定される場合には完全なパス名でなければなりません。 .It Ar firewall_quiet (ブール値) .Ar YES にセットすると起動時にコンソール上で ipfw 規則の表示を行ないません。 .It Ar natd_enable (ブール値) .Ar YES にセットすると natd を有効にします。 .Ar firewall_enable もまた .Ar YES にセットされ、 .Xr divert 4 ソケットがカーネルで有効にされている必要があります。 .It Ar natd_interface natd が実行されるパブリックインタフェースの名前です。 .Ar natd_enable が .Ar YES にセットされている場合には、これを設定する必要があります。 .It Ar natd_flags 追加の natd フラグはここに記述する必要があります。 .Fl n フラグは上記 .Ar natd_interface とともに自動的に引数として追加されます。 .It Ar tcp_extensions (ブール値) デフォルトでは .Ar YES です。これは RFC 1323 や 1644 で述べられているような ある TCP オプションを有効にします。 もしネットワークコネクションが不規則にハングアップしたり、 それに類する他の不具合がある場合には、これを .Ar NO にセットして様子をみてみるのもよいかもしれません。世間に出回っている ハードウェア/ソフトウェアの中には、これらのオプションでうまく動作しない ものがあることが知られています。 .It Ar network_interfaces (文字列) このホスト上で形成されるネットワークインタフェースのリストを 設定します。 たとえば、ループバックデバイス (標準) および SMC Elite Ultra NIC があるなら .Qq Ar "lo0 ed0" という 2 つのインタフェースを設定します。 .Em interface の各値に対して .No ifconfig_ Ns Em interface という変数が存在すると仮定されます。 1 つのインタフェースに複数の IP アドレスを登録したい場合は、 ここに IP エイリアスのエントリを追加することも可能です。 対象とするインタフェースが ed0 であると仮定すると、 .Bd -literal ifconfig_ed0_alias0="inet 127.0.0.253 netmask 0xffffffff" ifconfig_ed0_alias1="inet 127.0.0.254 netmask 0xffffffff" .Ed というようになります。 見つかった各 ifconfig__alias エントリについて、 その内容が .Xr ifconfig 8 に渡されます。最初にアクセスに失敗した時点で実行は中止されるので .Bd -literal ifconfig_ed0_alias0="inet 127.0.0.251 netmask 0xffffffff" ifconfig_ed0_alias1="inet 127.0.0.252 netmask 0xffffffff" ifconfig_ed0_alias2="inet 127.0.0.253 netmask 0xffffffff" ifconfig_ed0_alias4="inet 127.0.0.254 netmask 0xffffffff" .Ed のようにすると、alias4 は追加され\fB ない\fR ことに注意してください。これは alias3 エントリを抜かしたことで検索が中止されるからです。 .It Ar syslogd_enable (ブール値) .Ar YES にセットすると .Xr syslogd 8 デーモンを起動します。 .It Ar syslogd_flags (文字列) syslogd_enable が .Ar YES の場合、これらは .Xr syslogd 8 に渡すフラグになります。 .It Ar inetd_enable (ブール値) .Ar YES にセットすると .Xr inetd 8 デーモンを起動します。 .It Ar inetd_flags (文字列)inetd_enable が .Ar YES の場合、これらは .Xr inetd 8 へ渡すフラグとなります。 .It Ar named_enable (ブール値) .Ar YES にセットすると .Xr named 8 デーモンを起動します。 .It Ar named_program (文字列) .Xr named 8 のパス。(デフォルトは .Pa /usr/sbin/named ) .It Ar named_flags (文字列) .Ar named_enable が .Ar YES の場合、これらは .Xr named 8 に渡すフラグとなります。 .It Ar kerberos_server_enable (ブール値) ブート時に Kerberos 認証サーバを起動したい場合は .Ar YES にセットします。 .It Ar kadmind_server_enable .Xr kadmind 8 (Kerberos 管理デーモン) を実行したい場合は .Ar YES とします。スレーブサーバ上では .Ar NO にセットします。 .It Ar kerberos_stash (文字列) .Ar YES なら (唯一 .Ar kerberos_server_enable が .Ar YES にセットされ、かつ .Xr kerberos 1 および .Xr kadmind 8 の両方を用いるときにのみ) 隠されたマスタキーのプロンプト入力を行なう代りに、 そのキーを用いるよう Kerberos サーバに指示します。 .It Ar rwhod_enable (ブール値) .Ar YES にセットするとブート時に .Xr rwhod 8 デーモンを起動します。 .It Ar amd_enable (ブール値) .Ar YES にセットするとブート時に .Xr amd 8 デーモンを起動します。 .It Ar amd_flags (文字列) .Ar amd_enable が .Ar YES にセットされている場合、これらは amd に渡すフラグとなります。 詳しくは\fBinfo amd\fR コマンドを利用してください。 .It Ar nfs_client_enable (ブール値) .Ar YES にセットするとブート時に NFS クライアントデーモンを起動します。 .It Ar nfs_client_flags (文字列) .Ar nfs_client_enable が .Ar YES の場合、これらは .Xr nfsiod 8 デーモンに渡すフラグとなります。 .It Ar nfs_server_enable (ブール値) .Ar YES にセットするとブート時に NFS サーバデーモンを起動します。 .It Ar nfs_server_flags (文字列) .Ar nfs_server_enable が .Ar YES の場合、これらは .Xr nfsd 8 デーモンに渡すフラグとなります。 .It Ar weak_mountd_authentication (ブール値) .Ar YES にセットすると、権限付けられていないマウント要求を行なうために \fBPCNFSD\fR のようなサービスを許可します。 .It Ar nfs_reserved_port_only (ブール値) .Ar YES にセットすると、安全なポート上でのみ NFS サービスを提供します。 .It Ar rcp_lockd_enable (ブール値) この変数が .Ar YES にセットされ、しかも NFS サーバである場合、ブート時に .Xr rpc.lockd 8 を起動します。 .It Ar rcp_statd_enable (ブール値) この変数が .Ar YES にセットされ、しかも NFS サーバである場合、ブート時に .Xr rpc.statd 8 を起動します。 .It Ar portmap_enable (ブール値) .Ar YES の場合、ブート時に .Xr portmap 8 サービスを起動します。 .It Ar portmap_flags (文字列) .Ar portmap_enable が .Ar YES の場合、これらは .Xr portmap 8 デーモンに渡すフラグとなります。 .It Ar xtend_enable (ブール値) .Ar YES にセットすると、ブート時に .Xr xtend 8 デーモンを起動します。 .It Ar xtend_flags (文字列) .Ar xtend_enable が .Ar YES の場合、これらは .Xr xtend 8 デーモンに渡すフラグとなります。 .It Ar timed_enable (ブール値) .Ar YES なら、ブート時に .Xr timed 8 サービスを実行します。このコマンドは、全ホストについて一貫した .Qq "ネットワーク時間" が確立されなければならないマシンネットワークのためにあります。 これが有用である典型例は、 ファイルのタイムスタンプがネットワークワイドで一貫性をもつことが 期待されるような、大規模 NFS 環境です。 .It Ar timed_flags (文字列) .Ar timed_enable が .Ar YES の場合、これらは .Xr timed 8 サービスに渡すフラグとなります。 .It Ar ntpdate_enable (ブール値) .Ar YES にセットすると、システムスタートアップ時に ntpdate を実行します。 このコマンドは、ある標準的な参照先を元に、ただ .Ar 1 回 だけシステム時刻を同期させるためにあります。 また、システムを最初にインストールする際、 これを (知られているサービスのリストから) 最初にセットアップするオプションが .Pa /stand/sysinstall プログラムによって提供されます。 .It Ar ntpdate_program (文字列) .Xr ntpdate 8 のパス (デフォルトは .Pa /usr/sbin/ntpdate です)。 .It Ar ntpdate_flags (文字列) .Ar ntpdate_enable が .Ar YES の場合、これらは .Xr ntpdate 8 コマンドに渡すフラグとなります (典型的にはホスト名)。 .It Ar xntpd_enable (ブール値) .Ar YES にセットすると、ブート時に .Xr xntpd 8 コマンドが起動されます。 .It Ar xntpd_program (文字列) .Xr xntpd 8 のパス (デフォルトは .Pa /usr/sbin/xntpd です)。 .It Ar xntpd_flags (文字列) .Ar xntpd_enable が .Ar YES の場合、これらは .Xr xntpd 8 デーモンに渡すフラグとなります。 .It Ar tickadj_enable (ブール値) .Ar YES にセットすると、システムブート時に .Xr tickadj 8 コマンドを実行します。 .It Ar tickadj_flags (文字列) .Ar tickadj_enable が .Ar YES の場合、これらは .Xr tickadj 8 コマンドに渡すフラグとなります。 .It Ar nis_client_enable (ブール値) .Ar YES にセットすると、システムブート時に .Xr ypbind 8 サービスを起動します。 .It Ar nis_client_flags (文字列) .Ar nis_client_enable が .Ar YES の場合、これらは .Xr ypbind 8 サービスに渡すフラグとなります。 .It Ar nis_ypset_enable (ブール値) .Ar YES にセットすると、システムブート時に .Xr ypset 8 デーモンを起動します。 .It Ar nis_ypset_flags (文字列) .Ar nis_ypset_enable が .Ar YES の場合、これらは .Xr ypset 8 デーモンに渡すフラグとなります。 .It Ar nis_server_enable (ブール値) .Ar YES にセットすると、システムブート時に .Xr ypserv 8 デーモンを起動します。 .It Ar nis_server_flags (文字列) .Ar nis_server_enable が .Ar YES の場合、これらは .Xr ypserv 8 デーモンに渡すフラグとなります。 .It Ar nis_ypxfrd_enable (ブール値) .Ar YES にセットすると、システムブート時に .Xr ypxfrd 8 デーモンを起動します。 .It Ar nis_ypxfrd_flags (文字列) .Ar nis_ypxfrd_enable が .Ar YES の場合、これらは .Xr ypxfrd 8 デーモンに渡すフラグとなります。 .It Ar nis_yppasswdd_enable (ブール値) .Ar YES にセットすると、システムブート時に .Xr yppasswdd 8 デーモンを起動します。 .It Ar nis_yppasswdd_flags (文字列) .Ar nis_yppasswdd_enable が .Ar YES の場合、これらは .Xr yppasswdd 8 デーモンに渡すフラグとなります。 .It Ar defaultrouter (文字列) .Ar NO をセットしないと、このホスト名または IP アドレスへのデフォルトルートを 作成します (このルータがネームサーバへたどりつく必要がある 場合は IPアドレスを使用すること!)。 .It Ar static_routes (文字列) システムブート時に追加したいスタティックルートのリストを セットします。 .Ar NO 以外をセットした場合、その値を空白で区切った各要素について、 各 .Em element 毎に変数 .No route_ Ns em element が存在すると仮定され、その後、``route add'' 操作に渡されます。 .It Ar gateway_enable (ブール値) .Ar YES にセットすると、IP ルータとして動作する、 たとえばインタフェース間でパケットをフォワードするように ホストを設定します。 .It Ar router_enable (ブール値) .Ar YES にセットすると、 .Ar router および .Ar router_flags の設定に基づいて、ある種のルーティングデーモンを実行します。 .It Ar router (文字列) .Ar router_enable が .Ar YES にセットされると、これが使用するルーティングデーモン名になります。 .It Ar router_flags (文字列) .Ar router_enable が .Ar YES にセットされると、これらがルーティングデーモンへ渡すフラグとなります。 .It Ar mrouted_enable (ブール値) .Ar YES にセットすると、マルチキャストルーティングデーモン .Xr mrouted 8 を起動します。 .It Ar mrouted_flags (文字列) .Ar mrouted_enable が .Ar YES の場合、これらはマルチキャストルーティングデーモンへ渡すフラグとなります。 .It Ar ipxgateway_enable (ブール値) .Ar YES にセットすると、IPX トラフィックのルーティングを有効にします。 .It Ar ipxrouted_enable (ブール値) .Ar YES にセットすると、ブート時に .Xr ipxrouted 8 デーモンを起動します。 .It Ar ipxrouted_flags (文字列) .Ar ipxrouted_enable が .Ar YES の場合、これらは .Xr ipxrouted 8 デーモンへ渡すフラグとなります。 .It Ar arpproxy_all .Ar YES にセットするとグローバルプロキシ ARP を有効にします。 .It Ar forward_sourceroute これが .Ar YES にセットされ、更に .Ar gateway_enable もまた .Ar YES にセットされている場合、 送信元が経路指定したパケット (source routed packets) はフォワードされます。 .It Ar accept_sourceroute .Ar YES にセットすると、 システムは自分宛の送信元経路指定パケットを受け付けます。 .It Ar rarpd_enable (ブール値) .Ar YES にセットすると、システムブート時に .Xr rarpd 8 デーモンを起動します。 .It Ar rarpd_flags (文字列) .Ar rarpd_enable が .Ar YES の場合、これらは .Xr rarpd 8 デーモンへ渡すフラグとなります。 .It Ar keymap (文字列) .Ar NO にセットするとキーマップはインストールされません。それ以外の場合、 ここで指定した .Ar value がキーマップファイル .Pa /usr/share/syscons/keymaps/.kbd をインストールするのに用いられます。 .It Ar keyrate (文字列) キーボードのリピートスピードです。以下のいずれかにセットします。 .Ar slow , .Ar normal , .Ar fast デフォルト値を希望する場合は .Ar NO とします。 .It Ar keychange (文字列) .Ar NO 以外にセットすると、その値でファンクションキーをプログラムしようとします。 指定できる値は単一の文字列で, .Qq Ar " [ ]..." という形式でないといけません。 .It Ar cursor (文字列) カーソルの動作を明示的に指定する場合は .Ar normal , .Ar blink , .Ar destructive のいずれかの値にセットします。デフォルト動作を選ぶには .Ar NO とします。 .It Ar scrnmap (文字列) .Ar NO にセットすると、スクリーンマップはインストールされません。 それ以外の場合には、ここで指定した .Ar value がスクリーンマップファイル .Pa /usr/share/syscons/scrnmaps/ をインストールするのに用いられます。 .It Ar font8x16 (文字列) .Ar NO にセットするとスクリーンサイズの要求に対しデフォルトの 8x16 フォント値が 用いられます。それ以外の場合は .Pa /usr/share/syscons/fonts/ の値が用いられます。 .It Ar font8x14 (文字列) .Ar NO にセットするとスクリーンサイズの要求に対しデフォルトの 8x14 フォント値が 用いられます。それ以外の場合は .Pa /usr/share/syscons/fonts/ の値が用いられます。 .It Ar font8x8 (文字列) .Ar NO にセットすると、スクリーンサイズの要求に対しデフォルトの 8x8 フォント値が 用いられます。それ以外の場合は .Pa /usr/share/syscons/fonts/ の値が用いられます。 .It Ar blanktime (整数) .Ar NO にセットすると、デフォルトのスクリーンブランク時間間隔が用いられます。 それ以外の場合は .Ar value 秒にセットされます。 .It Ar saver (文字列) .Ar NO 以外にセットすると、これが実際に使用する スクリーンセーバ (ブランク, 蛇, デーモンなど) となります。 .It Ar moused_enable (文字列) .Ar YES にセットすると、コンソール上でのカット/ペーストセレクション用に .Xr moused 8 デーモンが起動されます。 .It Ar moused_type (文字列) 利用したいマウスのプロトコルのタイプ。 .Ar moused_enable が .Ar YES の場合、この変数は必ず設定しなければなりません。 多くの場合、 .Xr moused 8 デーモンは適切なマウスタイプを自動的に検出することができます。 デーモンにマウスを検出させるには、この変数を .Ar auto にセットします。 自動検出が失敗する場合、以下のリストから 1 つを選びます。 .Bd -literal microsoft Microsoft マウス intellimouse Microsoft IntelliMouse mousesystems Mouse system 社製のマウス mmseries MM シリーズのマウス logitech Logitech 製のマウス busmouse バスマウス mouseman Logitech の MouseMan および TrackMan glidepoint ALPS 製の GlidePoint thinkingmouse Kensignton 製の ThinkingMouse ps/2 PS/2 マウス mmhittab MM の HitTablet .Ed お使いのマウスが上記のリストにない場合でも、 リスト中のいずれかと互換性があるかも知れません。 互換性に関する情報については .Xr moused 8 のマニュアルページを参照してください。 .Pp また、 この変数が有効であるときは、(Xサーバのような) 他の全てのマウスクライアントは 仮想マウスデバイス .Pa /dev/sysmouse を通してマウスにアクセスし、 それを sysmouse タイプのマウスとして構成すべきであると いうことにも注意すべきです。これは、 .Xr moused 8 使用時は、全てのマウスデータがこの単一の標準フォーマットに変換されるためです。 クライアントプログラムが sysmouse タイプを サポートしないなら次に望ましいタイプとして mousesystems を指定してください。 .It Ar moused_port (文字列) .Ar moused_enable が .Ar YES の場合、これはマウスが接続されている実際のポートになります。 たとえば、COM1 シリアルマウスに対しては .Pa /dev/cuaa0 、PS/2 マウスに対しては .Pa /dev/psm0 、バスマウスに対しては .Pa /dev/mse0 となります。 .It Ar moused_flags (文字列) .Ar moused_type がセットされている場合、これらは .Xr moused 8 デーモンに渡す追加のフラグとなります。 .It Ar cron_enable (ブール値) .Ar YES にセットすると、システムブート時に .Xr cron 8 デーモンを起動します。 .It Ar lpd_enable (ブール値) .Ar YES にセットすると、システムブート時に .Xr lpd 8 デーモンを起動します。 .It Ar lpd_flags (文字列) .Ar lpd_enable が .Ar YES の場合、これらは .Xr lpd 8 デーモンに渡すフラグとなります。 .It Ar sendmail_enable (ブール値) .Ar YES にセットすると、システムブート時に .Xr sendmail 8 デーモンを起動します。 .It Ar sendmail_flags (文字列) .Ar sendmail_enable が .Ar YES の場合、これらは .Xr sendmail 8 デーモンに渡すフラグとなります。 .It Ar savecore_enable (ブール値) .Ar YES にセットすると、クラッシュ後システムが復旧するとき、デバッグ用にカーネル のクラッシュダンプを保存します。クラッシュイメージは通常 .Pa /var/crash ディレクトリに格納されます。 .It Ar dumpdev (文字列) .Ar NO にセットしないと、カーネルクラッシュダンプ出力先を .Em value で指定したスワップデバイスに向けます。 .It Ar check_quotas (ブール値) .Xr quotacheck 8 コマンドによってユーザディスクのクォータチェックを有効にしたいなら、 .Ar YES にセットします。 .It Ar accounting_enable (ブール値) .Xr accton 8 ファシリティでシステムアカウンティングを有効にしたいなら .Ar YES にセットします。 .It Ar ibcs2_enable (ブール値) システム初期ブート時に iBCS2 (SCO) バイナリエミュレーションを有効にしたいなら .Ar YES にセットします。 .It Ar linux_enable (ブール値) システムブート時に Linux/ELF バイナリエミュレーションを有効にしたいなら .Ar YES にセットします。 .It Ar rand_irqs (文字列) 乱数生成用に監視する IRQ のリストをセットします ( .Xr rndcontrol 8 のマニュアル参照)。 .It Ar clear_tmp_enable (ブール値) 起動時に .Pa /tmp 下を消去したいなら .Ar YES をセットします。 .It Ar ldconfig_paths (文字列) .Xr ldconfig 8 で使用する共有ライブラリのパスのリストをセットします。注意: .Pa /usr/lib は常に先頭に追加されるので、このリストに指定する必要はありません。 .Sh 関連項目 .Xr gdb 1 , .Xr info 1 , .Xr exports 5 , .Xr accton 8 , .Xr amd 8 , .Xr apm 8 , .Xr cron 8 , .Xr gated 8 , .Xr ifconfig 8 , .Xr inetd 8 , .Xr lpd 8 , .Xr moused 8 , .Xr mrouted 8 , .Xr named 8 , .Xr nfsd 8 , .Xr nfsiod 8 , .Xr ntpdate 8 , .Xr pcnfsd 8 , .Xr portmap 8 , .Xr quotacheck 8 , .Xr rc 8 , .Xr rndcontrol 8 , .Xr route 8 , .Xr routed 8 , .Xr rpc.lockd 8 , .Xr rpc.statd 8 , .Xr rwhod 8 , .Xr sendmail 8 , .Xr syslogd 8 , .Xr swapon 8 , .Xr tickadj 8 , .Xr timed 8 , .Xr vnconfig 8 , .Xr xntpd 8 , .Xr xtend 8 , .Xr ypbind 8 , .Xr ypserv 8 , .Xr ypset 8 .Sh 歴史 .Nm ファイルは .Fx 2.2.2 で登場しました。 .Sh 作者 Jordan K. Hubbard. diff --git a/ja/man/man5/rcsfile.5 b/ja/man/man5/rcsfile.5 index da1735d812..2f19c9f8e1 100644 --- a/ja/man/man5/rcsfile.5 +++ b/ja/man/man5/rcsfile.5 @@ -1,426 +1,426 @@ -.\" jpman $Id: rcsfile.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: rcsfile.5,v 1.3 1998/06/17 07:53:51 kumano Stab % .\" FreeBSD jpman project 訳語表 .\" WORD: phrase 句 .\" WORD: meta syntax メタ文法 .\" WORD: altanatives 選言 .\" WORD: trunk 幹 .\" WORD: branch 枝 .\" WORD: branch point 分岐点 .\" WORD: numebr (RCSのリビジョン番号1.1, 1.2.2.1等を意味する時は) 番号 .lf 1 ./rcsfile.5in .\" Set p to 1 if your formatter can handle pic output. .if t .nr p 1 .de Id .ds Rv \\$3 .ds Dt \\$4 .. .Id %Id: rcsfile.5,v 1.2 1995/10/28 21:50:16 peter Exp % .ds r \s-1RCS\s0 .if n .ds - \%-- .if t .ds - \(em .TH RCSFILE 5 \*(Dt GNU .SH 名称 rcsfile \- RCS ファイルの書式 .SH 解説 \*r ファイルの内容は以下の文法に基づき記述されます。 .PP テキストはフリーフォーマットであり、 文字列中のスペース、バックスペース、 タブ、改行、垂直タブ、改頁、復帰 (まとめて .IR "空白" と呼びます) は意味を持ちません。 例外として、id, num, sym 内では空白があってはならず、 \*r ファイルは改行で終わらなければなりません。 .PP 文字列は .BR @ で括られます。文字列が .BR @ 自身を含む場合、2 重化されなければならず、それ以外は任意の バイナリデータを含むことができます。 .PP 以下、簡便のためにメタ文法を用います。 `|' (縦棒) は選言を分けます。 `{' と `}' は省略可能な句を括ります。 `{' と `}*' は 0 回以上繰り返される句を括ります。 `{' と `}+' は 1 回以上繰り返される句を括ります。 終端記号は .BR 太字 で、非終端記号は .IR 斜体 で表記します。 .LP .nr w \w'\f3deltatext\fP ' .nr y \w'\f3newphrase\fP ' .if \nw<\ny .nr w \ny .nr x \w'\f3branches\fP' .nr y \w'{ \f3comment\fP' .if \nx<\ny .nr x \ny .nr y \w'\f3{ branch\fP' .if \nx<\ny .nr x \ny .ta \nwu +\w'::= 'u +\nxu+\w' 'u .fc # .nf \f2rcstext\fP ::= \f2admin\fP {\f2delta\fP}* \f2desc\fP {\f2deltatext\fP}* .LP \f2admin\fP ::= \f3head\fP {\f2num\fP}\f3;\fP { \f3branch\fP {\f2num\fP}\f3;\fP } \f3access\fP {\f2id\fP}*\f3;\fP \f3symbols\fP {\f2sym\fP \f3:\fP \f2num\fP}*\f3;\fP \f3locks\fP {\f2id\fP \f3:\fP \f2num\fP}*\f3;\fP {\f3strict ;\fP} { \f3comment\fP {\f2string\fP}\f3;\fP } { \f3expand\fP {\f2string\fP}\f3;\fP } { \f2newphrase\fP }* .LP \f2delta\fP ::= \f2num\fP \f3date\fP \f2num\fP\f3;\fP \f3author\fP \f2id\fP\f3;\fP \f3state\fP {\f2id\fP}\f3;\fP \f3branches\fP {\f2num\fP}*\f3;\fP \f3next\fP {\f2num\fP}\f3;\fP { \f2newphrase\fP }* .LP \f2desc\fP ::= \f3desc\fP \f2string\fP .LP \f2deltatext\fP ::= \f2num\fP \f3log\fP \f2string\fP { \f2newphrase\fP }* \f3text\fP \f2string\fP .LP \f2num\fP ::= {\f2digit\fP | \f3.\fP}+ .LP \f2digit\fP ::= \f30\fP | \f31\fP | \f32\fP | \f33\fP | \f34\fP | \f35\fP | \f36\fP | \f37\fP | \f38\fP | \f39\fP .LP \f2id\fP ::= {\f2num\fP} \f2idchar\fP {\f2idchar\fP | \f2num\fP}* .LP \f2sym\fP ::= {\f2digit\fP}* \f2idchar\fP {\f2idchar\fP | \f2digit\fP}* .LP \f2idchar\fP ::= \f2special\fP を除く任意の可視文字 (visible graphic character) .LP \f2special\fP ::= \f3$\fP | \f3,\fP | \f3.\fP | \f3:\fP | \f3;\fP | \f3@\fP .LP \f2string\fP ::= \f3@\fP{任意の文字、ただし \f3@\fP は 2 重化される}*\f3@\fP .LP \f2newphrase\fP ::= \f2id\fP \f2word\fP* \f3;\fP .LP \f2word\fP ::= \f2id\fP | \f2num\fP | \f2string\fP | \f3:\fP .fi .PP 識別子は大文字小文字を区別します。 キーワードは小文字のみです。 キーワードと識別子の集合は重複可能です。 ほとんどの環境では、\*r は \s-1ISO\s0 8859/1 エンコーディングを用います。 このコードでは、可視文字のコードが 041\-176 と 240\-377 で、 空白文字のコードが 010\-015 と 040 です。 .PP .B date キーワードの後に現れる日時は \f2Y\fP\f3.\fP\f2mm\fP\f3.\fP\f2dd\fP\f3.\fP\f2hh\fP\f3.\fP\f2mm\fP\f3.\fP\f2ss\fP という書式で、それぞれ .I Y が年を、 .I mm が月 (01\-12) を、 .I dd が日 (01\-31) を、 .I hh が時 (00\-23) を、 .I mm が分 (00\-59) を、 .I ss が秒 (00\-60) を表します。 .I Y は 1900 年から 1999 年までは年の最後の 2 桁で表し、それ以降は 年のすべての桁で表します。 日付はグレゴリオ暦を用い、時刻は UTC (世界標準時) で表します。 .PP 文法中の .I newphrase は \*r ファイル書式の今後の拡張のために予約されています。 すでに使われているキーワードでは .I newphrase は始まりません。 .PP 複数の .I delta ノードが集まって、木を形成します。 単一の組からなる番号のノード (例えば 2.3, 2.1, 1.3 など) は すべて幹 (trunk) であり、降順で .B next フィールドを通してリンクされています。 .I admin ノードの .B head フィールドは、このシーケンスの先頭 (head; すなわち最高位の組) を示します。 admin ノードの .B branch ノードは、 ほとんどの \*r 操作が利用するデフォルトの枝 (もしくはリビジョン) を示します。 もしこれが存在しなければ、幹の最高位の枝が用いられます。 .PP .RI 2 n 個 .RI ( n \(>=2) のフィールドからなる番号を持つ全 .I delta ノード (例えば 3.1.1.1, 2.1.2.2 など) は、次のようにリンクされます。 すなわち、先頭の .RI 2 n \-1 個のフィールドの番号が等しい全ノードは、昇順で .B next フィールドを通してリンクされます。 シーケンス中の delta ノードの番号の先頭 .RI 2 n \-2 個分と等しい番号を持つ .I delta ノードは、そのシーケンスの分岐点と呼ばれます。 ノードの .B branches フィールドは、 そのノードが分岐点となっている全シーケンスに対し、 最初のノード番号のリストを保持しています。 このリストは昇順で並べられています。 .LP 以下の図は \*r ファイルの構成の例を示しています。 .if !\np \{\ .nf .vs 12 .ne 36 .cs 1 20 .eo Head | | v / \ --------- / \ / \ / \ | | / \ / \ / \ / \ | 2.1 | / \ / \ / \ / \ | | / \ / \ /1.2.1.3\ /1.3.1.1\ | | /1.2.2.2\ /1.2.2.1.1.1\ --------- --------- --------- --------- ------------- ^ ^ | ^ ^ | | | | | | | v | | / \ | --------- / \ | / \ | \ 1.3 / / \ | / \ ---------\ / / \----------- /1.2.1.1\ \ / /1.2.2.1\ --------- \ / --------- ^ | ^ | | | | v | | --------- | | \ 1.2 / | ----------------------\ /--------- \ / \ / | | v --------- \ 1.1 / \ / \ / \ / .ec .cs 1 .vs .fi .\} .if \np \{\ .lf 232 .PS 4.250i 3.812i .\" -2.0625 -4.25 1.75 0 .\" 0.000i 4.250i 3.812i 0.000i .nr 00 \n(.u .nf .nr 0x 1 \h'3.812i' .sp -1 .lf 242 \h'2.062i-(\w'Head'u/2u)'\v'0.125i-(0v/2u)+0v+0.22m'Head .sp -1 \h'2.062i'\v'0.250i'\D'l0.000i 0.500i' .sp -1 \h'2.087i'\v'0.650i'\D'l-0.025i 0.100i' .sp -1 \h'2.062i'\v'0.750i'\D'l-0.025i -0.100i' .sp -1 \h'1.688i'\v'1.250i'\D'l0.750i 0.000i' .sp -1 \h'2.438i'\v'1.250i'\D'l0.000i -0.500i' .sp -1 \h'2.438i'\v'0.750i'\D'l-0.750i 0.000i' .sp -1 \h'1.688i'\v'0.750i'\D'l0.000i 0.500i' .sp -1 .lf 244 \h'2.062i-(\w'2.1'u/2u)'\v'1.000i-(0v/2u)+0v+0.22m'2.1 .sp -1 \h'2.062i'\v'1.250i'\D'l0.000i 0.500i' .sp -1 \h'2.087i'\v'1.650i'\D'l-0.025i 0.100i' .sp -1 \h'2.062i'\v'1.750i'\D'l-0.025i -0.100i' .sp -1 .lf 246 \h'2.062i-(\w'1.3'u/2u)'\v'2.000i-(1v/2u)+0v+0.22m'1.3 .sp -1 \h'2.062i'\v'2.250i'\D'l-0.375i -0.500i' .sp -1 \h'1.688i'\v'1.750i'\D'l0.750i 0.000i' .sp -1 \h'2.438i'\v'1.750i'\D'l-0.375i 0.500i' .sp -1 \h'1.875i'\v'2.000i'\D'~-0.500i 0.000i 0.000i -0.500i' .sp -1 \h'1.350i'\v'1.600i'\D'l0.025i -0.100i' .sp -1 \h'1.375i'\v'1.500i'\D'l0.025i 0.100i' .sp -1 .lf 249 \h'1.375i-(\w'1.3.1.1'u/2u)'\v'1.250i-(1v/2u)+1v+0.22m'1.3.1.1 .sp -1 \h'1.375i'\v'1.000i'\D'l-0.375i 0.500i' .sp -1 \h'1.000i'\v'1.500i'\D'l0.750i 0.000i' .sp -1 \h'1.750i'\v'1.500i'\D'l-0.375i -0.500i' .sp -1 \h'2.062i'\v'2.250i'\D'l0.000i 0.500i' .sp -1 \h'2.087i'\v'2.650i'\D'l-0.025i 0.100i' .sp -1 \h'2.062i'\v'2.750i'\D'l-0.025i -0.100i' .sp -1 .lf 252 \h'2.062i-(\w'1.2'u/2u)'\v'3.000i-(1v/2u)+0v+0.22m'1.2 .sp -1 \h'2.062i'\v'3.250i'\D'l-0.375i -0.500i' .sp -1 \h'1.688i'\v'2.750i'\D'l0.750i 0.000i' .sp -1 \h'2.438i'\v'2.750i'\D'l-0.375i 0.500i' .sp -1 \h'1.875i'\v'3.000i'\D'~-0.500i 0.000i -0.500i 0.000i -0.500i 0.000i 0.000i -0.500i' .sp -1 \h'0.350i'\v'2.600i'\D'l0.025i -0.100i' .sp -1 \h'0.375i'\v'2.500i'\D'l0.025i 0.100i' .sp -1 .lf 255 \h'0.375i-(\w'1.2.1.1'u/2u)'\v'2.250i-(1v/2u)+1v+0.22m'1.2.1.1 .sp -1 \h'0.375i'\v'2.000i'\D'l-0.375i 0.500i' .sp -1 \h'0.000i'\v'2.500i'\D'l0.750i 0.000i' .sp -1 \h'0.750i'\v'2.500i'\D'l-0.375i -0.500i' .sp -1 \h'0.375i'\v'2.000i'\D'l0.000i -0.500i' .sp -1 \h'0.350i'\v'1.600i'\D'l0.025i -0.100i' .sp -1 \h'0.375i'\v'1.500i'\D'l0.025i 0.100i' .sp -1 .lf 257 \h'0.375i-(\w'1.2.1.3'u/2u)'\v'1.250i-(1v/2u)+1v+0.22m'1.2.1.3 .sp -1 \h'0.375i'\v'1.000i'\D'l-0.375i 0.500i' .sp -1 \h'0.000i'\v'1.500i'\D'l0.750i 0.000i' .sp -1 \h'0.750i'\v'1.500i'\D'l-0.375i -0.500i' .sp -1 \h'2.250i'\v'3.000i'\D'~0.500i 0.000i 0.000i -0.500i' .sp -1 \h'2.725i'\v'2.600i'\D'l0.025i -0.100i' .sp -1 \h'2.750i'\v'2.500i'\D'l0.025i 0.100i' .sp -1 .lf 261 \h'2.750i-(\w'1.2.2.1'u/2u)'\v'2.250i-(1v/2u)+1v+0.22m'1.2.2.1 .sp -1 \h'2.750i'\v'2.000i'\D'l-0.375i 0.500i' .sp -1 \h'2.375i'\v'2.500i'\D'l0.750i 0.000i' .sp -1 \h'3.125i'\v'2.500i'\D'l-0.375i -0.500i' .sp -1 \h'2.938i'\v'2.250i'\D'~0.500i 0.000i 0.000i -0.500i 0.000i -0.500i' .sp -1 \h'3.413i'\v'1.350i'\D'l0.025i -0.100i' .sp -1 \h'3.438i'\v'1.250i'\D'l0.025i 0.100i' .sp -1 .lf 264 \h'3.438i-(\w'\s-21.2.2.1.1.1\s0'u/2u)'\v'1.000i-(1v/2u)+1v+0.22m'\s-21.2.2.1.1.1\s0 .sp -1 \h'3.438i'\v'0.750i'\D'l-0.375i 0.500i' .sp -1 \h'3.062i'\v'1.250i'\D'l0.750i 0.000i' .sp -1 \h'3.812i'\v'1.250i'\D'l-0.375i -0.500i' .sp -1 \h'2.750i'\v'2.000i'\D'l0.000i -0.500i' .sp -1 \h'2.725i'\v'1.600i'\D'l0.025i -0.100i' .sp -1 \h'2.750i'\v'1.500i'\D'l0.025i 0.100i' .sp -1 .lf 267 \h'2.750i-(\w'1.2.2.2'u/2u)'\v'1.250i-(1v/2u)+1v+0.22m'1.2.2.2 .sp -1 \h'2.750i'\v'1.000i'\D'l-0.375i 0.500i' .sp -1 \h'2.375i'\v'1.500i'\D'l0.750i 0.000i' .sp -1 \h'3.125i'\v'1.500i'\D'l-0.375i -0.500i' .sp -1 \h'2.062i'\v'3.250i'\D'l0.000i 0.500i' .sp -1 \h'2.087i'\v'3.650i'\D'l-0.025i 0.100i' .sp -1 \h'2.062i'\v'3.750i'\D'l-0.025i -0.100i' .sp -1 .lf 270 \h'2.062i-(\w'1.1'u/2u)'\v'4.000i-(1v/2u)+0v+0.22m'1.1 .sp -1 \h'2.062i'\v'4.250i'\D'l-0.375i -0.500i' .sp -1 \h'1.688i'\v'3.750i'\D'l0.750i 0.000i' .sp -1 \h'2.438i'\v'3.750i'\D'l-0.375i 0.500i' .sp -1 .sp 4.250i+1 .if \n(00 .fi .br .nr 0x 0 .lf 271 .PE .lf 272 .\} .PP .SH 作者 .de VL \\$2 .. Author: Walter F. Tichy, Purdue University, West Lafayette, IN, 47907. .br Manual Page Revision: \*(Rv; Release Date: \*(Dt. .br Copyright \(co 1982, 1988, 1989 Walter F. Tichy. .br Copyright \(co 1990, 1991, 1992, 1993, 1994, 1995 Paul Eggert. .SH 関連項目 rcsintro(1), ci(1), co(1), ident(1), rcs(1), rcsclean(1), rcsdiff(1), rcsmerge(1), rlog(1) .br Walter F. Tichy, \*r\*-A System for Version Control, .I "Software\*-Practice & Experience" .BR 15 , 7 (July 1985), 637-654. diff --git a/ja/man/man5/remote.5 b/ja/man/man5/remote.5 index 8d9c3fd861..e01f533a7c 100644 --- a/ja/man/man5/remote.5 +++ b/ja/man/man5/remote.5 @@ -1,193 +1,193 @@ .\" 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. .\" .\" @(#)remote.5 8.1 (Berkeley) 6/5/93 .\" %Id: remote.5,v 1.2.2.2 1998/06/28 21:34:27 hoek Exp % -.\" jpman $Id: remote.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: remote.5,v 1.3 1998/07/02 14:12:58 horikawa Stab % .\" .Dd June 5, 1993 .Dt REMOTE 5 .Os BSD 4.2 .Sh 名称 .Nm remote .Nd リモートホスト記述ファイル .Sh 解説 .Xr tip 1 によって知られるシステムとその属性は、 .Xr termcap 5 ファイルのような構造の .Tn ASCII ファイルに記録されます。 ファイルの各行は、1 つの .Em システム についての記述を提供します。 フィールドはコロン (``:'') で分けられています。 \e 文字の直後に改行がある行末は、次の行へ継続されます。 .Pp 最初のエントリはホストシステムの (複数の) 名称です。 システムの名称が 1 つ以上ある場合、名称は縦棒で区切られます。 システムの名称の後に記述フィールドが続きます。 `=' 記号が続くフィールド名は、文字列型を示します。 `#' 記号が続くフィールド名は、数値を示します。 .Pp ``tip*'' と ``cu*'' という名前が付いたエントリは、 .Xr tip 1 や、以下で述べるように .Nm tip に対するインタフェース .Xr cu 1 でデフォルトのエントリとして使われます。 .Nm tip が電話番号だけをつけて呼び出された時、 ``tip300'' の形式のエントリを探 します。 ここで、 300 は接続が張られたボーレートです。 .Nm cu インタフェースが使われた時は、 ``cu300'' という形式のエントリが使わ れます。 .Sh ケーパビリティ ケーパビリティは、文字列 (str) ・数値 (num) ・ブーリアンフラグ (bool) のいずれかです。文字列ケーパビリティは .Em capability Ns Ar = Ns Em value のように指定されます。例えば、 ``dv=/dev/harris'' のように指定します。 数値ケーパビリティは .Em capability Ns Ar # Ns Em value のように指定されます。例えば、 ``xa#99'' のように指定します。 ブーリアンケーパビリティは単にケーパビリティを記述するだけで 指定されます。 .Bl -tag -width indent .It Cm \&at (str) 自動呼び出しユニットの形式です。 .It Cm \&br (num) リモートホストと接続を確立するために使われるボーレート。 これは、10 進の数値です。デフォルトのボーレートは 300 ボーです。 .It Cm \&cm (str) リモートホストに送られる初期接続メッセージです。 例えば、ホストにポート選択器を通して到達する場合、 ここにはホストに切替えるために必要とされる適切なシーケンスが設定されて いるべきです。 .It Cm \&cu (str) 電話の呼び出しが行われる場合の呼び出しユニットです。 デフォルトは、 `dv' フィールドと同じです。 .It Cm \&di (str) ユーザによって切断が要求されている時にホストに送られる 切断メッセージです。 .It Cm \&du (bool) このホストはダイアルアップ線上にあることを示します。 .It Cm \&dv (str) 接続を確立するためにオープンする (複数の) .Tn UNIX デバイスです。このファイルが端末線を参照している場合、 .Xr tip 1 は、1 度に 1 ユーザだけがポートにアクセスすることを保証するために、 デバイスを排他的にオープンします。 .It Cm \&el (str) 行末 (end-of-line) を示す文字です。 デフォルトでは .Dv NULL 文字です。`el' 中の 1 文字もしくは復帰文字 (carriage return) の後の `~' エスケープは .Nm tip だけで認識されます。 .It Cm \&fs (str) 転送のためのフレームサイズです。 デフォルトフレームサイズは .Dv BUFSIZ と同じです。 .It Cm \&hd (bool) ホストが半 2 重通信を使い、ローカルエコーが行われることを示します。 .It Cm \&ie (str) 入力のファイル終了 (end-of-file) マークです。 デフォルトは .Dv NULL です。 .It Cm \&oe (str) 出力のファイル終了 (end-of-file) 文字列です。 デフォルトは .Dv NULL です。 .Nm tip がファイルを転送している時、この文字列はファイル終了時に送られます。 .It Cm \&pa (str) データをホストに送っている時に使われるパリティの形式です。 これは ``even'', ``odd'', ``none'', ``zero'' (いつでも 8 ビット目を 0 に設定する), ``one'' (いつでも 8 ビット目を 1 に設定する)のいずれかです。 デフォルトではイーブンパリティです。 .It Cm \&pn (str) ホストに対する (複数の) 電話番号です。 電話番号フィールドが @ 符号を含んでいる場合、 .Nm tip は電話番号の一覧を .Pa /etc/phones ファイルから検索します ( .Xr phones 5 参照)。 .It Cm \&tc (str) ケーパビリティのリストが、名前で与えられた記述に継続されることを示し ます。これは主に共通のケーパビリティ情報を共有するために使われます。 .El .Pp ここで、ケーパビリティの継続機能の利用をしめす短い例をお見せしましょう: .Bd -literal UNIX-1200:\e :dv=/dev/cau0:el=^D^U^C^S^Q^O@:du:at=ventel:ie=#$%:oe=^D:br#1200: arpavax|ax:\e :pn=7654321%:tc=UNIX-1200 .Ed .Sh 関連ファイル .Bl -tag -width /etc/remote -compact .It Pa /etc/remote .Pa /etc に置かれた .Nm リモート ホスト記述ファイル。 .El .Sh 関連項目 .Xr tip 1 , .Xr phones 5 .Sh 歴史 .Nm ファイル書式は .Bx 4.2 から登場しました。 diff --git a/ja/man/man5/resolver.5 b/ja/man/man5/resolver.5 index 9470e136ca..7449f62af3 100644 --- a/ja/man/man5/resolver.5 +++ b/ja/man/man5/resolver.5 @@ -1,137 +1,137 @@ .\" Copyright (c) 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. .\" .\" @(#)resolver.5 8.1 (Berkeley) 6/5/93 -.\" jpman $Id: resolver.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: resolver.5,v 1.3 1998/07/22 02:40:21 issei Stab % .\" %Id: resolver.5,v 1.2.2.1 1997/03/07 04:18:10 mpp Exp % .\" .Dd June 5, 1993 .Dt RESOLVER 5 .Os BSD 4 .Sh 名称 .Nm resolver .Nd リゾルバ設定ファイル .Sh 書式 .Nm resolv.conf .Sh 解説 .Xr resolver 3 はインターネットドメインネームシステムへのアクセスを提供する C ライブラリのルーチン群です。 リゾルバ設定ファイルは、はじめてリゾルバルーチンがプロセスによって呼び出 されたときに読み込まれる情報を含んでいます。 ファイルは人に可読なように設計されており、様々な種類のリゾルバ情報を 提供する、値を伴うキーワードのリストを含んでいます。 .Pp 普通に構成されたシステムでは、このファイルは必要ではありません。 問い合わせされる唯一のネームサーバはローカルマシン上にあり、ホスト名 からドメイン名が決定され、ドメインの検索パスがそのドメイン名から作成 されます。 .Pp 様々な設定オプションは以下の通りです。 .Bl -tag -width nameserver .It Sy nameserver リゾルバが問い合わせをするネームサーバのインターネットアドレス (ドット表記)です。 キーワード毎に 1 つづつ、計 .Dv MAXNS (現状では 3)台までのネームサーバが記述できます。 複数のサーバが記述されている場合、リゾルバライブラリは記述された順に 問い合わせを出します。 .Sy nameserver エントリが記述されていない場合、デフォルトではローカルマシン上のネーム サーバを使用します (ここで使われるアルゴリズムは以下のようになります。まず、あるネーム サーバに問い合わせを試みます。この問い合わせがタイムアウトになれば、 次のネームサーバに問い合わせを試み、これをネームサーバがなくなるまで 続けます。応答がない場合、この一連の問い合わせの試みをリトライ最大回 数に達するまで繰り返します)。 .It Sy domain ローカルドメイン名。 そのドメイン内での名前の問い合わせのほとんどが、ローカルドメインにおける 短い名前を使用することができます。 .Sy domain エントリが記述されていない場合、 .Xr gethostname 3 で得たローカルホスト名からドメインを決定します。 ドメイン部は最初の `.' 以降の全てとなります。 ホスト名がドメイン部を含んでいない場合、最終的にはルートドメインが使用されます。 .It Sy search ホスト名調査のための検索リスト。 通常、検索リストはローカルドメイン名から決定されます。 デフォルトでは、ローカルドメイン名から始まり、次に少なくとも 2 つの構成要素を 持つ親ドメインを検索します。 検索リストは、 .Sy search キーワードの後にスペースまたはタブで区切られたドメイン検索パス名を羅列することで 変更できます。 ほとんどのリゾルバの問い合わせは、検索パスの各構成要素を一致するエントリが 見つかるまでまで順に試します。 記述されたドメインのサーバがローカルではない場合、この処理は低速で多くの ネットワークトラフィックを発生させる可能性があることと、それらのいずれかの ドメインに関して、使用可能なサーバが 1 つも存在しない場合には問い合わせが タイムアウトすることに注意する必要があります。 .Pp 現在のところ、検索リストは 6 ドメイン、計 256 文字に制限されます。 .El .Pp .Sy domain と .Sy search キーワードは排他的です。 これらのキーワードが 1 つ以上記述されている場合、 最後のキーワードが有効になります。 .Pp キーワードと値は同一行に存在する必要があり、キーワード (例えば .Sy nameserver ) は行の先頭にある必要があります。 値はキーワードに続いて空白で区切って記述します。 .Sh 関連ファイル .Bl -tag -width /etc/resolv.conf -compact .It Pa /etc/resolv.conf .Nm resolv.conf は .Pa /etc に存在します。 .El .Sh 関連項目 .Xr gethostbyname 3 , .Xr resolver 3 , .Xr hostname 7 , .Xr named 8 .Rs .%T "Name Server Operations Guide for BIND" .Re .Sh 歴史 .Nm resolv.conf ファイルフォーマットは .Bx 4.3 から登場しました。 diff --git a/ja/man/man5/rpc.5 b/ja/man/man5/rpc.5 index ca02eab8b8..07904b0358 100644 --- a/ja/man/man5/rpc.5 +++ b/ja/man/man5/rpc.5 @@ -1,33 +1,33 @@ .\" @(#)rpc.5 2.2 88/08/03 4.0 RPCSRC; from 1.4 87/11/27 SMI; -.\" jpman $Id: rpc.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: rpc.5,v 1.3 1998/06/25 08:44:57 jsakai Stab % .Dd "September 26, 1985" .Dt RPC 5 .Sh 名称 .Nm rpc .Nd rpc プログラム番号データベース .Sh 書式 /etc/rpc .Sh 解説 .Pa /etc/rpc ファイルには、rpc プログラム番号の代わりに使用可能な、 ユーザが可読な名前が記述されています。 各行は以下の情報から成ります。 .Pp .Bl -bullet -compact .It rpc プログラムのサーバ名 .It rpc プログラム番号 .It 別名 .El .Pp 各項目は任意個の空白文字もしくはタブ文字で分けられます。 ``#'' はコメントの開始を示します。 行末までの文字はファイルを検索するルーチンには解釈されません。 .Sh 関連ファイル .Bl -tag -compact -width /etc/rpc .Pa /etc/rpc .El .Sh "関連項目" .Xr getrpcent 3 diff --git a/ja/man/man5/services.5 b/ja/man/man5/services.5 index 8fec1ad5ac..17b2ca32b7 100644 --- a/ja/man/man5/services.5 +++ b/ja/man/man5/services.5 @@ -1,88 +1,88 @@ .\" 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. .\" .\" @(#)services.5 8.1 (Berkeley) 6/5/93 -.\" jpman $Id: services.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: services.5,v 1.3 1998/06/17 07:53:27 kumano Stab % .\" %Id: services.5,v 1.3.2.1 1997/03/07 04:18:11 mpp Exp % .\" .Dd June 5, 1993 .Dt SERVICES 5 .Os BSD 4.2 .Sh 名称 .Nm services .Nd サービス名のデータベース .Sh 解説 .Nm services ファイルには .Tn DARPA インターネットで利用可能な既知のサービスの情報が格納されます。 各サービス毎に、以下の情報を表す 1 行が存在します。 .Bd -unfilled -offset indent 公式なサービス名 ポート番号 プロトコル名 別名 .Ed .Pp 項目は任意個の空白文字やタブ文字で分けられます。 ポート番号およびプロトコル名は単一の .Em 項目 とみなされ、 ``/'' を 1 つ使用してポートとプロトコルを分けます (例 ``512/tcp'')。 ``#'' はコメント開始を表し、 行末までの文字はファイルを検索するルーチンに解釈されません。 .Pp サービス名は、フィールド区切り文字・改行文字・コメント文字以外の、 任意の表示可能文字からなります。 .Sh NIS との相互作用 NIS の .Pa services.byname マップへのアクセスを有効にするには、単一の ``+'' のみからなる行を .Pa /etc/services ファイルに追加します。 こうすると、NIS のサービスマップの内容が ``+'' のある位置に挿入されます。 .Sh 関連ファイル .Bl -tag -width /etc/services -compact .It Pa /etc/services .Nm services ファイルは .Pa /etc にあります。 .El .Sh 関連項目 .Xr getservent 3 .Sh バグ 静的ファイルの代わりに、ネームサーバを使用すべきです。 .Sh 歴史 .Nm ファイルフォーマットは .Bx 4.2 に登場しました。 diff --git a/ja/man/man5/shells.5 b/ja/man/man5/shells.5 index 797b2d89e0..5bbcbc97be 100644 --- a/ja/man/man5/shells.5 +++ b/ja/man/man5/shells.5 @@ -1,64 +1,64 @@ .\" Copyright (c) 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. .\" .\" @(#)shells.5 8.1 (Berkeley) 6/5/93 -.\" jpman $Id: shells.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: shells.5,v 1.3 1998/06/25 08:44:02 jsakai Stab % .\" %Id: shells.5,v 1.1.1.1.8.1 1997/03/07 04:18:11 mpp Exp % .\" .Dd June 5, 1993 .Dt SHELLS 5 .Os BSD 4.2 .Sh 名称 .Nm shells .Nd シェルデータベース .Sh 解説 .Nm shells ファイルはシステム上のシェルのリストを格納します。 各シェルごとに 1 行ずつ、ルートからの相対でシェルのパスを記述します。 .Pp ハッシュマーク (``#'') はコメントの開始を意味します。 それ以降行末までの文字列はファイルを検索するルーチンには解釈されません。 空行もまた無視されます。 .Sh 関連ファイル .Bl -tag -width /etc/shells -compact .It Pa /etc/shells .Nm shells ファイルは .Pa /etc にあります。 .El .Sh 関連項目 .Xr getusershell 3 .Sh 歴史 .Nm ファイルフォーマットは .Bx 4.3 tahoe から登場しました。 diff --git a/ja/man/man5/skey.access.5 b/ja/man/man5/skey.access.5 index 56671a9b93..9b6e784be6 100644 --- a/ja/man/man5/skey.access.5 +++ b/ja/man/man5/skey.access.5 @@ -1,136 +1,136 @@ -.\" jpman $Id: skey.access.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: skey.access.5,v 1.3 1998/08/09 12:54:01 horikawa Stab % .TH SKEY.ACCESS 5 .SH 名称 skey.access \- S/Key パスワード制御テーブル .SH 解説 S/Key パスワード制御テーブル (\fIetc/skey.access\fR) は \fIlogin\fR のようなプログラムが使用し、 システムアクセスのために UNIX パスワードをいつ使用するかを決定します。 .IP \(bu テーブルが存在しない場合は、パスワード制限はありません。 ユーザは UNIX パスワードあるいは S/Key パスワードを入力することができます。 .IP \(bu テーブルが存在する場合は、 明白に記述されている場合のみ UNIX パスワードが許可されます。 .IP \(bu ただし、システムコンソールからは常に UNIX パスワードは許可されます。 .SH テーブルの書式 テーブルのフォーマットは 1 行当たり 1 ルールです。 ルールは順番に検索されます。 最初に条件が合うルールが見つかったとき、 またはテーブルの最後に到達したとき、検索は終了します。 .PP ルールのフォーマットは次の通りです: .sp .in +5 permit 条件\ 条件... .br deny 条件\ 条件... .in .PP .I permit と .I deny の後には 0 個以上の条件を記述可能です。 コメントは `#\' で始まり、行末までコメントになります。 空行やコメントのみの行は無視されます。 .PP すべての条件が満たされるときにルールがマッチします。 条件のないルールは常に満たされます。 例えば、最後のエントリは語 .I deny のみとなっているかもしれません。 .SH 条件 .IP "hostname wzv.win.tue.nl" wzv.win.tue.nl というホストからログインしたとき真になります。 警告の節を参照してください。 .IP "internet 131.155.210.0 255.255.255.0" 131.155.210 のネットワークからログインしたら真になります。 ネットワークアドレスとネットマスクは次の書式になります。 .sp .ti +5 internet net mask .sp mask とのビットごとの論理積が net と等しくなるインターネットアドレスを ホストが持つ場合、式は真になります。 警告の節を参照してください。 .IP "port ttya" ログインしている端末が .IR /dev/ttya ならば真になります。 UNIX パスワードはシステムコンソールからの ログインには常に許されている点は憶えておいてください。 .IP "user uucp" .IR uucp ユーザがログインしようとしたとき真になります。 .IP "group wheel" .I wheel グループとしてログインしようとしたとき真になります。 .SH 互換性 過去の互換性のために、 .I internet というキーワードはネットワークアドレスとマスクのパターンから 省略可能です。 .SH 警告 S/Key 制御テーブル (\fI/etc/skey.access\fR) が存在する場合、 S/Key パスワードを持たないユーザは、 UNIX パスワードの使用が許されるところからのみログインが許されます。 特に \fIlogin(1)\fR が擬似 tty (例えば \fIxterm(1)\fR や \fIscreen(1)\fR の中) から起動される場合、 コンソールからのログインでもなければ ネットワークからのログインでもないと扱われますので、 S/Key パスワードの使用が義務づけられます。 このような状況で起動される \fIlogin(1)\fR は、 S/Key パスワードを持たないユーザに対しては必ず失敗します。 .PP いくつかのルール型は、ネットワークを通じて与えられるホスト名やアドレス情報に 依存しています。 このことから考えられる、システムに UNIX パスワードを許させる攻撃の一覧を 示します。 .IP "ホストアドレス偽造 (ソースルーティング)" 侵入者は自分のインタフェースを信頼されているネットワーク内のアドレス として構成し、 そのソースアドレスを使用して、被害者に接続します。 誤ったクライアントアドレスを与えられると、 ホストアドレスに基づくルールもしくは アドレスから導かれるホスト名に基づくルールを元にして、 被害者は間違った結論を導きます。 .sp 対処法: (1) ネットワークからの UNIX パスワードを用いたログインを許さない。 (2) ソースルーティング情報を捨てるネットワークソフトウェアを使う (例えば、tcp wrapper)。 .PP ほとんどのネットワークサーバはクライアントのネットワークアドレスから クライアントの名前を解決します。 それゆえ、次の明らかな攻撃は以下のようになります。 .IP "ホスト名偽造 (悪い PTR レコード)" 誤ったホスト名を与えられると、 ホスト名に基づくルールもしくは ホスト名から導かれるアドレスに基づくルールを元にして、 被害者は間違った結論を導きます。 .sp 対処法: (1) ネットワークからの UNIX パスワードを用いたログインを許さない。 (2) ホスト名からクライアントのネットワークアドレスを解決できることを確認する ネットワークソフトウェアを使用する (例えば、tcp wrapper)。 .PP UNIX の login プログラムのように、 クライアントのホスト名からクライアントのネットワークアドレスを 求める必要があるアプリケーションが存在します。 今述べた攻撃に加えて、もう 1 つの可能性があります。 .IP "ホストアドレスの偽造 (余分な A レコード)" 侵入者はクライアントのホスト名について (もまた)、信頼されたアドレスとして 解決させるためにネームサーバシステムを操作します。 .sp 対処法: (1) ネットワークからの UNIX パスワードを用いたログインを許さない。 (2) skeyaccess() は他の人が属するネットワークアドレスを無視する。 .SH 診断 構文エラーは syslogd に報告されます。 エラーが見つかったらそのルールはスキップされます。 .SH 関連ファイル /etc/skey.access パスワード制御テーブル .SH 作者 .nf Wietse Venema Eindhoven University of Technology The Netherlands diff --git a/ja/man/man5/stab.5 b/ja/man/man5/stab.5 index 0c38a31aff..76b273ea70 100644 --- a/ja/man/man5/stab.5 +++ b/ja/man/man5/stab.5 @@ -1,225 +1,225 @@ .\" 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. .\" .\" @(#)stab.5 8.1 (Berkeley) 6/5/93 .\" %Id: stab.5,v 1.2.2.1 1997/03/07 04:18:12 mpp Exp % -.\" jpman $Id: stab.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: stab.5,v 1.3 1998/07/21 23:07:45 jsakai Stab % .\" WORD: symbol table シンボルテーブル .\" WORD: directive ディレクティブ(命令、指令の類) .\" .Dd June 5, 1993 .Dt STAB 5 .Os BSD 4 .Sh 名称 .Nm stab .Nd シンボルテーブルの型 .Sh 書式 .Fd #include .Sh 解説 .Aq Pa stab.h ファイルは a.out ファイルで使われる、シンボルテーブルのいくつかの .Fa n_type フィールド値の定義します。 これらは、恒久的なシンボル形式であり (つまり、ローカルなラベルなどではない)、古いデバッガである .Em sdb や Berkeley パスカルコンパイラ .Xr pc 1 で使われます。 .\" (訳注) BerkeleyパスカルコンパイラはFreeBSDディストリビューション .\" に含まれない。 .\" 1998/05/05 Takeshi MUTOH シンボルテーブルエントリは .Pa .stabs アセンブラディレクティブによって生成することができます。 ここでは、ダブルクオートで区切られた名前、シンボルの型、シンボルに ついての char 1 つと short 1 つ分の情報、 そして (通常はアドレスを示す) unsigned long の整数を指定できます。 アドレスフィールドに明示的なラベルを生成するのを避けるため、 .Pa .stabd ディレクティブを使い、現在の場所を指すようにすることができます。 もし名前が必要ない場合、 .Pa .stabn ディレクティブを使うことで、シンボルテーブルエントリを生成することができます。 ローダは、 .Pa .stab ディレクティブによって生成されたシンボルテーブルのエントリ順を変えないこと を保証します。 .Xr a.out 5 に記述されているように、シンボルテーブルの要素は以下の構造を持ちます。 .Bd -literal /* * シンボルテーブルエントリの書式 */ struct nlist { union { char *n_name; /* コア内部 (in-core) で使用 */ long n_strx; /* ファイル文字列表へのインデックス */ } n_un; unsigned char n_type; /* 型のフラグ */ char n_other; /* 使用されていない */ short n_desc; /* 以下の struct desc 参照 */ unsigned n_value; /* アドレスまたはオフセットまたは行 */ }; .Ed .Pp .Fa n_type フィールドの下位ビットは、シンボルをたかだか 1 つのセグメントに置くため に使用します。どのセグメントに置くかは .Aq Pa a.out.h 内で定義されている以下のマスクに基づきます。 これらのセグメントビットを設定しないようにすることで、シンボルをどの セグメントにも属さないようにすることができます。 .Bd -literal /* * n_type の単純な値 */ #define N_UNDF 0x0 /* 定義されていない */ #define N_ABS 0x2 /* 絶対指定 */ #define N_TEXT 0x4 /* テキスト */ #define N_DATA 0x6 /* データ */ #define N_BSS 0x8 /* bss */ #define N_EXT 01 /* 外部参照を表すビット(or して使う) */ .Ed .Pp シンボルの .Fa n_value フィールドは、リンカ .Xr ld 1 によって、正しいセグメント内のアドレスに再配置されます。 どのセグメントにも入っていないシンボルの .Fa n_value フィールドは、リンカによって変更されません。 さらに、 .Fa n_type フィールドで、以下のビットのいずれもセットされていない場合は、 リンカは自分が持っている規則にしたがって、 いくつかのシンボルを破棄します。 .Bd -literal /* * その他の永続的なシンボルテーブルエントリでは、N_STAB のいくつかのビットが * セットされています。これらは、 内に記述があります。 */ #define N_STAB 0xe0 /* もしこれらのビットのいずれかがセットされていれば破棄されません */ .Ed .Pp これで、112 (7 \(** 16) 個までのシンボルを、さまざまなセグメントで分けて 定義できるようになります。 これらのいくつかについては既に述べられています。 古いシンボリックデバッガ .Em sdb は、以下の n_type 値を使います。 .Bd -literal #define N_GSYM 0x20 /* グローバルシンボル : name,,0,type,0 */ #define N_FNAME 0x22 /* プロシジャ名 (f77 kludge): name,,0 */ #define N_FUN 0x24 /* プロシジャ: name,,0,linenumber,address */ #define N_STSYM 0x26 /* 静的シンボル: name,,0,type,address */ #define N_LCSYM 0x28 /* .lcomm シンボルl: name,,0,type,address */ #define N_RSYM 0x40 /* レジスタシンボル: name,,0,type,register */ #define N_SLINE 0x44 /* ソース行: 0,,0,linenumber,address */ #define N_SSYM 0x60 /* structure elt: name,,0,type,struct_offset */ #define N_SO 0x64 /* ソースファイル名: name,,0,0,address */ #define N_LSYM 0x80 /* ローカルシンボル: name,,0,type,offset */ #define N_SOL 0x84 /* #includeされたファイル名: name,,0,0,address */ #define N_PSYM 0xa0 /* パラメータ: name,,0,type,offset */ #define N_ENTRY 0xa4 /* 別のエントリ: name,linenumber,address */ #define N_LBRAC 0xc0 /* 左かっこ: 0,,0,nesting level,address */ #define N_RBRAC 0xe0 /* 右かっこ: 0,,0,nesting level,address */ #define N_BCOMM 0xe2 /* 共通の開始符号: name,, */ #define N_ECOMM 0xe4 /* 共通の終了符号: name,, */ #define N_ECOML 0xe8 /* (ローカル名の)共通の終了符号: ,,address */ #define N_LENG 0xfe /* 長さ情報を持った2番目の stab エントリ */ .Ed .Pp ここで、コメントには 与えられた .Fa n_type の .Fa n_name , .Fa n_other , .Fa n_desc , .Fa n_value フィールド と .Pa .stab .Fa s の典型的な利用法が書かれています。 .Em sdb は、ポータブル C コンパイラ .Xr cc 1 によって使われる形式の型の指定子を持っている .Fa n_desc フィールドを使います。これらの型の値のフォーマットの詳細はヘッダファイル .Pa pcc.h を参照して下さい。 .Pp Berkeley パスカルコンパイラ .Xr pc 1 は、以下の .Fa n_type 値をつかいます: .Bd -literal #define N_PC 0x30 /* グローバルなパスカルシンボル: name,,0,subtype,line */ .Ed .Pp と、以下のサブ型を使い、別々のコンパイルファイルにまたがる型チェックを 行います。 .Bd -unfilled -offset indent 1 ソースファイル名 2 インクルードされたファイル名 3 グローバルなラベル 4 グローバルな定数 5 グローバルな型 6 グローバルな変数 7 グローバルな関数 8 グローバルな手続き 9 外部関数 10 外部手続き 11 ライブラリ変数 12 ライブラリルーチン .Ed .Sh 関連項目 .Xr as 1 , .Xr ld 1 , .Xr a.out 5 .Sh バグ .Pp もっと基本的な形式が必要でしょう。 .Sh 歴史 .Nm stab ファイルは .Bx 4.0 から登場しました。 diff --git a/ja/man/man5/syslog.conf.5 b/ja/man/man5/syslog.conf.5 index 20befb9e4d..d3ada4ba97 100644 --- a/ja/man/man5/syslog.conf.5 +++ b/ja/man/man5/syslog.conf.5 @@ -1,340 +1,340 @@ .\" 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. .\" .\" From: @(#)syslog.conf.5 8.1 (Berkeley) 6/9/93 .\" %Id: syslog.conf.5,v 1.3.2.6 1998/07/18 11:37:22 jkh Exp % .\" -.\" jpman $Id: syslog.conf.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: syslog.conf.5,v 1.3 1998/07/16 01:34:25 yohta Stab % .\" .Dd June 9, 1993 .Dt SYSLOG.CONF 5 .Os .Sh 名称 .Nm syslog.conf .Nd .Xr syslogd 8 設定ファイル .Sh 解説 .Nm ファイルは .Xr syslogd 8 プログラムの設定ファイルです。 このファイルは .Em program 指定によって分けられた行ブロックから構成されています。 それぞれの行は 2つのフィールドを含みます。 その行が適用されるメッセージのタイプと優先度を指定する .Em selector フィールドと、 .Xr syslogd が選んだ基準とマッチしたマッチしたメッセージを受けとった場合の動作を指定する .Em action フィールドです。 .Em selector フィールドと .Em action フィールドは 1 つ以上のタブ文字で区切られています。 .Pp .Em selectors 機能は .Em facility とピリオド .Pq Dq \&. そして .Em level で符合化され、間に空白は含みません。 .Em facility と .Em level の双方とも、大文字小文字の違いはありません。 .Pp .Em facility はシステムが発するメッセージの一部を表し、次にあげるキーワード群の 1 つで表されます : auth, authpriv, cron, daemon, ftp, kern, lpr, mail, mark, news, ntp, syslog, user, uucp と local0 から local7. これらのキーワード(markを除く)は .Xr openlog 3 と .Xr syslog 3 ライブラリルーチンで指定される .Dq Dv LOG_ で始まる値と一致します。 .Pp .Em level はメッセージの重要度を表し、以下のキーワードの順に高から低になります: emerg, alert, crit, err, warning, notice, info, debug。 これらのキーワードは .Xr syslog 3 ライブラリルーチンで指定される .Dq Dv LOG_ で始まる値と一致します。 .Pp それぞれの行ブロックはタグによって前のブロックと区別されます。 タグは行の先頭が .Em #!prog または .Em !prog (前者は以前の syslogd との互換性のためのものです。 例えば syslog.conf ファイルを共有したい時などに便利です) で始まり、それぞれのブロックは syslog を呼び出す特定のプログラムと 関連付けられています。 また、タグ ``foo'' は、 ``foo: '' というプレフィックスを持つ カーネルログメッセージにもマッチします。 .Pp .Em facility と .Em level の両方のキーワードとその意味のより詳細な説明を知りたい場合は .Xr syslog 3 を見てください。 選択は .Em facility で行なう方が .Em program で行なうよりも好まれています。 なぜなら、後者はネットワーク環境の中では 簡単に変化してしまう場合があるからです。しかし、適切な .Em facility が本当に存在しない場合もあります。 .Pp もし .Em facility 指定に一致したメッセージを受けとり、なおかつそれが 指定した .Em level .Em (もしくはそれ以上の level) だった場合、またはメッセージ中の日付の後ろの最初の単語が .Em program と一致した場合、 .Em action フィールドで指定された動作が選択されます。 .Pp 複数の .Em selector を、セミコロン .Pq Dq \&; によって区切ることにより、1 つの .Em action に対して指定することができます。 しかしそれぞれの .Em selector はその前にある指定を上書き修正できてしまいますので注意してください。 .Pp 複数の .Em facility は、コンマ .Pq Dq \&, によって区切ることにより 1 つの .Em level を指定することができます。 .Pp アスタリスク .Pq Dq * は、全ての .Em facility 、全ての .Em levels 、または全ての .Em programs を指定するのに使用できます。 .Pp 特別な .Em facility である .Dq mark は、20分毎に .Dq info の優先度を持つメッセージを受け取ります ( .Xr syslogd 8 を参照 )。これは アスタリスクを含む .Em facility フィールドには適用されません。 .Pp 特別な .Em level である .Dq none は、特定の .Em facility を無効にします。 .Pp それぞれの行の .Em action フィールドは、 .Em selector フィールドに指定されたメッセージを受け取った際の動作を指定します。 動作指定には次の 5つの形式があります: .Bl -bullet .It パス名 (先頭がスラッシュで始まります)。 該当するメッセージは、そのファイルに追加されます。 .It ホスト名 ( .Pq Dq @ 文字から始まる必要があります)。 該当するメッセージは、指定されたホストの .Xr syslogd プログラムに転送されます。 .It コンマで区切られたユーザのリスト。 該当するメッセージは、指定されたユーザがログインしていれば、 そのユーザの画面に出力されます。 .It 1 つのアスタリスク。 該当するメッセージは、ログイン中の全てのユーザの画面に出力されます。 .It 垂直バー .Pq Dq \&| とそれに続くコマンド。該当したメッセージをパイプを使って コマンドに渡すことができます。 このコマンドは、 .Pa /bin/sh によって評価されるので、通常のシェルメタキャラクタや入力/出力 リダイレクトを利用できます。 (しかし実行されたコマンドからの .Xr stdio 3 バッファされた出力のリダイレクトは余計な遅延を引き起こしたり、 あるいはシグナルによってロギング中のサブプロセスが終了した場合など 出力データを失うことがあるかもしれないことに注意してください) コマンドそれ自身は .Em stdout と .Em stderr を .Pa /dev/null にリダイレクトして動作します。 .Dv SIGHUP を受け取ると、 .Nm はそのプロセスとのパイプを閉じます。もしそのプロセスが自発的に終了しない 場合は、60秒の猶予期間の後 .Dv SIGTERM を送ります。 .Pp コマンドはパイプでつながれるデータが到着した際に 1 度だけ起動されます。 その後、コマンドが終了した場合には必要に応じて再起動されます。 そのため、1行の入力だけをサブプロセスが手に入れるよう望んでいるなら、 (もし多くのメッセージが速く流れる場合には、 資源を大量に消費する可能性がありますが) 1行の入力があった後に終了する事によって達成する事ができます。 必要ならば、この効果のためにラッパスクリプトを書くこともできます。 .Pp そのコマンドが完全なパイプラインでない場合、コマンドを .Em exec で起動すると、起動したシェルプロセスがコマンドの完了を待たなくなるので 便利かもしれません。 警告: このプロセスは .Xr syslogd 8 の UID のもとで動きます。通常はスーパユーザです。 .El .Pp 空行と最初の空白でない文字がハッシュ .Pq Dq # 文字である行は無視されます。 .Sh 使用例 .Pp 設定ファイルは次のようになります: .Bd -literal # err レベル以上の全てのメッセージ、全てのレベルの kernel メッセージ、 # notice レベルの auth メッセージをコンソールに出力します。 # プライベートな認証メッセージは記録をとりません! *.err;kern.*;auth.notice;authpriv.none /dev/console # info 以上のレベルを持つ(mail を除く)全てのメッセージを記録します。 # プライベートな認証メッセージは記録をとりません! *.info;mail.none;authpriv.none /var/log/messages # authpriv ファイルはアクセス制限を持ちます。 .\" /var/log/secure の read permission を限定するということ？ .\" 2.2.6-RELEASE 対象 .\" By yohta@bres.tsukuba.ac.jp (July 8 1998) authpriv.* /var/log/secure # 全てのレベルの mail メッセージを一箇所にまとめて記録します。 mail.* /var/log/maillog # emerg(非常事態)レベルの全てのメッセージは全員が受け取ります。 *.emerg * *.emerg @arpa.berkeley.edu # alert レベル以上のメッセージを root と eric の画面に表示されます。 .\" 原文は Root and Eric get alert and higher messages を意訳 .\" 2.2.6-RELEASE 対象 .\" By yohta@bres.tsukuba.ac.jp (July 10 1998) *.alert root,eric # err レベル以上の mail と news の エラーを特別なファイルに保存します。 mail;news.err /var/log/spoolerr .\" 原文は uucp,news.crit / send-pr 予定 .\" 2.2.6-RELEASE 対象 .\" By yohta@bres.tsukuba.ac.jp (July 10 1998) # 全てのレベルの認証メッセージをフィルタにパイプします。 auth.* |exec /usr/local/sbin/authfilter # ftpd のトランザクションを mail と news にあわせて保存します。 !ftpd *.* /var/log/spoolerr # カーネルのファイヤウォールレポートを別のファイルに保存します。 !ipfw *.* /var/log/ipfw .Ed .Sh 関連ファイル .Bl -tag -width /etc/syslog.conf -compact .It Pa /etc/syslog.conf .Xr syslogd 8 設定ファイル .El .Sh バグ 複数のセレクタ指定は、時々思ったように効果を発揮しない事があります。 例えば、 .Dq mail.crit,*.err と設定すると、 .Dq mail ファシリティのメッセージのレベルは .Dq err かそれ以上となり、 .Dq crit かそれ以上のレベルにはなりません。 .Pp ネットワーク環境においては、全てのオペレーティングシステムが 同じ facility 名のセットを実装しているわけではない点に注意してください。 authpriv, cron, ftp, ntp といったこの実装において知られた facility が、 目的のシステムには存在しないかもしれません。更に悪い事に、 DEC UNIX は AdvFS ファイルシステムのログイベントに facility 番号 10 (この実装では authpriv です) を使っています。 .Sh 関連項目 .Xr syslog 3 , .Xr syslogd 8 diff --git a/ja/man/man5/term.5 b/ja/man/man5/term.5 index 7036211624..92d70d257e 100644 --- a/ja/man/man5/term.5 +++ b/ja/man/man5/term.5 @@ -1,153 +1,153 @@ .TH TERM 5 -.\" jpman $Id: term.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: term.5,v 1.3 1998/07/30 15:27:11 horikawa Stab % .\" WORD: compiled コンパイル済みの .\" WORD: linear search 線形探索(パス名から inodeを) .\" WORD: boolean value ブール値 .\" WORD: terminate 終端する .ds n 5 .ds d /usr/lib/terminfo .SH 名称 term \- コンパイル済みの term ファイルの形式 .SH 書式 .B term .SH 解説 .PP コンパイル済みの terminfo 属性記述はディレクトリ \fB\*d\fP の下にあります。 \s-1UNIX\s+1 システムの巨大なディレクトリを線形探索するのを避けるため、 \fB\*b/c/name\fP という形の 2 階層の命名規則が用いられます。 (ここで、 .I name は端末の名前で、 .I c は .I name の最初の文字です。) ですから、 .I act4 は、 \fB\*d/a/act4\fP というファイル名で見つけることができます。 同じ端末を示す同義な名前は、同じコンパイル済みファイルへの複数の リンクとして実装されています。 .PP この形式は、全てのハードウェアで同じになるように選ばれています。 1 バイトが 8 ビット以上であることは仮定していますが、バイトオーダや 符合拡張の方式については仮定していません。 .PP コンパイル済みのファイルは .I tic プログラムにより生成され、 .I setupterm ルーチンにより読み取られます。 これらのソフトウェア部品は .IR ncurses (3) の一部です。 このファイルは 6 つの部分に分割されます。すなわち、 ヘッダ、 端末の名称、 ブール値のフラグ、 数値、 文字列、および 文字列テーブルです。 .PP ヘッダセクションはファイルの冒頭にあります。 このセクションは、以下に示す形式の short 型の整数 6 個からなります。 これらの整数は (1) マジックナンバ (8 進で 0432)、 (2) 名称セクションのバイト単位での大きさ、 (3) ブール値のセクションに含まれるバイトの個数、 (4) 数値セクションに含まれる short 型整数の個数、 (5) 文字列セクションに含まれるオフセットの個数 (short 型整数)、 (6) 文字列テーブルのバイト単位での大きさ です。 .PP short 型の整数は 2 個の 8 ビットバイトに格納されています。 最初のバイトは値の最下位 8 ビットを、2 番目のバイトは最上位 8 ビットを 含みます。(すなわち、値は 256*second+first と表現されます。) 値 \-1 は 0377, 0377 で表現されますが、その他の負の値は構文違反です。 一般に、値 \-1 は、あるケーパビリティがその端末に備わっていないことを 示します。 この形式は \s-1VAX\s+1 と \s-1PDP\s+1-11 のハードウェアに 一致するものであることにご注意下さい。これに一致しないハードウェアの マシンでは、整数を 2 個のバイトとして読み込み、結果を算出します。 .PP 次に現れるのは端末名セクションです。 これは、端末のさまざまな名前を `|' 文字で区切って列挙した、 terminfo 記述の最初の行を含みます。 このセクションは 1 個の \s-1ASCII NUL\s+1 文字で終端されます。 .PP ブール型のフラグは、フラグ 1 個につき 1 バイトを占めます。 このバイトは、フラグが存在するかしないかに従って、0 か 1 となる必要があります。 ケーパビリティはファイル に含まれるのと同じ順番に並びます。 .PP 数値セクションが偶数バイト目から開始されるように、 ブール値のセクションと数値セクションの間には、 必要なら 1 個のナルバイトを挿入します。 すべての short 型整数は short 型のワード境界に揃えて配置されます。 .PP 数値セクションはフラグセクションと同様です。 各ケーパビリティは 2 バイトを占め、short 型整数として格納されます。 もし表現された値が \-1 なら、そのケーパビリティは存在しないものと 解釈されます。 .PP 文字列セクションもまた同様です。 各ケーパビリティは上記の形式に従い、2 バイトの short 型整数として 格納されます。 値 \-1 は、ケーパビリティが存在しないことを意味します。 それ以外の場合、値は、文字列テーブルの先頭からのオフセットとして 解釈されます。 ^X や \ec といった記法で示された特殊文字は、その記法を解釈した結果の形で 格納され、印刷可能表現では格納されません。 パッド情報 $ とパラメータ情報 %x は解釈を行なわずそのままの形で 格納されます。 .PP 最後のセクションは文字列テーブルです。これは文字列セクションで参照されている すべての文字列ケーパビリティの値を含みます。 各文字列はナルで終端されています。 .PP .I setupterm ルーチンでは、ファイルに実際に存在するケーパビリティ とは異なるものが予想され得ることにご注意下さい。 .I setupterm が再コンパイルされた後にデータベースが更新される (ファイルにいくつかの未知のエントリが含まれる結果になります)か、 データベースが最後にコンパイルされた後にプログラムが再コンパイルされる (存在しないエントリを生む結果になります)両方の可能性があります。 ルーチン .I setupterm は両方の可能性に備える必要があります \- これが、データ内に個数と大きさが含まれている理由です。 また、新しいケーパビリティは常に、ブール値、数値、文字列の ケーパビリティリストのそれぞれの最後に追加しなければなりません。 .PP 使用例として、 Microterm ACT 4 の記述の 8 進数ダンプをここに収めます。 .nf .sp microterm|act4|microterm act iv, cr=^M, cud1=^J, ind=^J, bel=^G, am, cub1=^H, ed=^_, el=^^, clear=^L, cup=^T%p1%c%p2%c, cols#80, lines#24, cuf1=^X, cuu1=^Z, home=^], .sp .ft CW \s-2000 032 001 \e0 025 \e0 \eb \e0 212 \e0 " \e0 m i c r 020 o t e r m | a c t 4 | m i c r o 040 t e r m a c t i v \e0 \e0 001 \e0 \e0 060 \e0 \e0 \e0 \e0 \e0 \e0 \e0 \e0 \e0 \e0 \e0 \e0 \e0 \e0 \e0 \e0 100 \e0 \e0 P \e0 377 377 030 \e0 377 377 377 377 377 377 377 377 120 377 377 377 377 \e0 \e0 002 \e0 377 377 377 377 004 \e0 006 \e0 140 \eb \e0 377 377 377 377 \en \e0 026 \e0 030 \e0 377 377 032 \e0 160 377 377 377 377 034 \e0 377 377 036 \e0 377 377 377 377 377 377 200 377 377 377 377 377 377 377 377 377 377 377 377 377 377 377 377 * 520 377 377 377 377 \e0 377 377 377 377 377 377 377 377 377 377 540 377 377 377 377 377 377 007 \e0 \er \e0 \ef \e0 036 \e0 037 \e0 560 024 % p 1 % c % p 2 % c \e0 \en \e0 035 \e0 600 \eb \e0 030 \e0 032 \e0 \en \e0\s+2 .ft R .fi .sp .PP いくつかの制限: コンパイル済みのエントリは 4096 バイトを超えることが できません。名前フィールドは 128 バイトを超えることができません。 .SH 関連ファイル \*d/*/* コンパイル済みの端末ケーパビリティデータベース .SH 関連項目 ncurses(3), terminfo(5). diff --git a/ja/man/man5/termcap.5 b/ja/man/man5/termcap.5 index ff75acdb80..589ba18120 100644 --- a/ja/man/man5/termcap.5 +++ b/ja/man/man5/termcap.5 @@ -1,2081 +1,2081 @@ .\" 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. .\" .\" @(#)termcap.5 8.3 (Berkeley) 4/16/94 .\" .\" /*************************************************************************** .\" * COPYRIGHT NOTICE * .\" **************************************************************************** .\" * ncurses is copyright (C) 1992-1995 * .\" * Zeyd M. Ben-Halim * .\" * zmbenhal@netcom.com * .\" * Eric S. Raymond * .\" * esr@snark.thyrsus.com * .\" * * .\" * Permission is hereby granted to reproduce and distribute ncurses * .\" * by any means and for any fee, whether alone or as part of a * .\" * larger distribution, in source or in binary form, PROVIDED * .\" * this notice is included with any such distribution, and is not * .\" * removed from any of its header files. Mention of ncurses in any * .\" * applications linked with it is highly appreciated. * .\" * * .\" * ncurses comes AS IS with no warranty, implied or expressed. * .\" * * .\" ***************************************************************************/ .\" .\" %Id: termcap.5,v 1.2.2.2 1998/06/23 05:31:20 hoek Exp % .\" -.\" jpman $Id: termcap.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: termcap.5,v 1.4 1998/06/13 12:34:58 horikawa Stab % .\" FreeBSD jpman project 訳語表 .\" WORD: terminal 端末 .\" WORD: text テキスト .\" WORD: convention 約束 .\" WORD: virtual terminal 仮想端末 .\" WORD: print 印字 .\" WORD: display 描画 .\" WORD: screen 画面 .\" WORD: CRT CRT .\" WORD: attribute 属性 .\" WORD: underline 下線 .\" WORD: standout 強調表示 .\" WORD: column 桁 .\" WORD: row 行 .\" WORD: carriage return キャリッジリターン .\" WORD: home など ホーム(ホームポジション)、home(home キー) .\" など、キーそのものについては英語のままとした .\" WORD: foreground color 前景色 .\" WORD: background color 背景色 .\" WORD: bottom margin 下マージン .\" WORD: top margin 上マージン .\" WORD: bold mode ボールドモード .\" WORD: scroll forward 前進スクロール .\" WORD: scroll backward 後退スクロール .\" WORD: glitch グリッチ (他の端末と不整合な機能) .\" その他 Beehive はメーカ名です(.Ss Glitches and Braindamages 参照)。 .Dd April 16, 1994 .Dt TERMCAP 5 .Os BSD 3 .Sh 名称 .Nm termcap .Nd 端末ケーパビリティのデータベース .Sh 書式 .Nm .Sh 解説 .Nm ファイルは端末に関するデータベースであり、例えば .Xr \&vi 1 や .Xr curses 3 が使用します。 .Nm には、端末が持つケーパビリティと、 操作がどのように行われるのかが記述されています。 パディングの必要性および初期化シーケンスも .Nm に記述されています。 .Pp .Nm のエントリは `:' で区切られた複数個のフィールドからなります。 各端末の最初のエントリは、`|' 文字で区切った端末名です。 最初の名前は、その端末の最も一般的な省略形です。 最後の名前は端末を完全に識別するための長い名前であり、 その他は端末名の類義語です。 最後以外の名前は小文字を使い、空白を含まないようにしてください; 最後の名前は、可読性のために大文字や空白を含んでかまいません。 .Pp 端末名 (最後の冗長なエントリを除く) は次の約束に従い選んでください。 端末を構成するハードウェアの特定の一部を、 .Dq hp2621 のように根幹の名前として選びます。 この名前はハイフンを含んではなりません。 ハードウェアのモードやユーザのプリファレンスは、 ハイフンとモード指示子を追加して示します。 ですから、132 桁モードの .Dq vt100 は .Dq vt100-w になります。可能ならば、以下の接尾辞を使用してください: .Pp .Bd -filled -offset indent .Bl -column indent "With automatic margins (usually default)xx" .Sy 接尾辞 意味 例 -w 広いモード (80 桁超) vt100-w -am 自動マージン付 (通常はデフォルト) vt100-am -nam 自動マージン無し vt100-nam .Pf \- Ar n Ta No "画面上の行数 aaa-60" -na 矢印キー無し (ローカルのままにする) concept100-na .Pf \- Ar \&np Ta No "メモリページ数 concept100-4p" -rv 反転表示 concept100-rv .El .Ed .Sh ケーパビリティ 記述フィールドに、ケーパビリティの意味を示そうとしています。 記述フィールドには次のようなコードが書いてあることがあります: .Pp .Bl -tag -width #[1-9] .It (P) パディングが指定されるかもしれないことを表します。 .It #[1-9] 記述フィールドでは、文字列が (#\fIi\fP) として与えられる引数として .Xr tparm や .Xr tgoto を介して渡されることを示します。 .It (P*) 影響を受ける行数に従いパディングが変化することを示します。 .It (#\d\fIi\fP\u) \fIi\fP 番目のパラメータを表します。 .El .Pp 以下、ブール値のケーパビリティです: .Bd -literal \fBブール値 TCap 記述\fR \fB変数 コード\fR auto_left_margin bw cursor_left は桁 0 から最後の桁に回り込む auto_right_margin am 端末は自動マージンを持つ no_esc_ctlc xb beehive (f1=escape, f2=ctrl C) ceol_standout_glitch xs 強調表示は上書きによって消去されない (hp) eat_newline_glitch xn 80 桁より後の改行は無視される (concept) erase_overstrike eo 空白を上打ちすることで消去可能 generic_type gn 一般的な行タイプ hard_copy hc ハードコピー端末 has_meta_key km メタキーを持ち、最上位ビットをセットする has_status_line hs 追加のステータス行を持つ insert_null_glitch in 挿入モードはナルを区別する memory_above da 画面より上の描画が保存される memory_below db 画面より下の描画が保存される move_insert_mode mi 挿入モードでの移動が安全 move_standout_mode ms 強調表示モードでの移動が安全 over_strike os 端末は上打ちが可能 status_line_esc_ok es ステータス行でエスケープを使用可能 dest_tabs_magic_smso xt 破壊的タブ、強調文字の奇妙な動作 (t1061) tilde_glitch hz ~ を印字できない (hazeltine) transparent_underline ul 下線文字の上打ち xon_xoff xo 端末は xon/xoff のハンドシェークを使用 needs_xon_xoff nx パディングは動作しないので xon/xoff が必要 prtr_silent 5i プリンタ出力は画面にエコーしない hard_cursor HC カーソルが見にくい non_rev_rmcup NR enter_ca_mode は exit_ca_mode を反転しない no_pad_char NP パディング文字が存在しない non_dest_scroll_region ND スクロール領域が非破壊的 can_change cc 端末は既存の色を再定義可能 back_color_erase ut 画面は背景色で消される hue_lightness_saturation hl 端末は HLS カラー表現のみ使用 (tektronix) col_addr_glitch YA 桁位置指定および micro_column_address ケーパビリティは正方向の動きのみ cr_cancels_micro_mode YB cr を使用するとマイクロモードがオフになる has_print_wheel YC オペレータが文字セットを変更する必要がある プリンタ row_addr_glitch YD row_address および micro_row_address は 正方向の動きのみ semi_auto_right_margin YE 最終桁で印字すると cr となる cpi_changes_res YF 文字ピッチを変えると解像度が変わる lpi_changes_res YG 行ピッチを変えると解像度が変わる .Ed .Pp 以下、数値のケーパビリティです: .Bd -literal \fB数値 TCap 記述\fR \fB変数 コード\fR columns co 1 行の桁数 init_tabs it タブの初期設定は # 個の空白ごと lines li 画面もしくはページの行数 lines_of_memory lm 行より大きい場合はメモリの行数、 0 の場合はさまざま .\" => は大小関係を表すのではない See .Sh その他 magic_cookie_glitch sg enter_standout_mode や exit_standout_mode が残す空白文字数 padding_baud_rate pb パディングが必要な最低ボーレート virtual_terminal vt 仮想端末番号 (CB/unix) width_status_line ws ステータス行の桁数 num_labels Nl 画面上のラベル数 label_height lh 各ラベルの行数 label_width lw 各ラベルの桁数 max_attributes ma 端末が扱える属性の最大の組み合わせ maximum_windows MW 定義可能なウィンドウ数の最大 magic_cookie_glitch_ul ug 下線により残される空白数 # # 以下は SVr4 のカラーサポートにより導入 # max_colors Co 画面上の最大色数 max_pairs pa 画面上の色の組の最大数 no_color_video NC 色付きでは使用できないビデオ属性 # # 以下の数値ケーパビリティは SVr4.0 の term 構造体に存在しますが、 # マニュアルには記述されていません。 # これらは SVr4 のプリンタサポートにより追加されました。 # buffer_capacity Ya 印字前にバッファされるバイト数 dot_vert_spacing Yb 1 インチあたりのピン数で表した垂直ピン間隔 dot_horz_spacing Yc 1 インチあたりのドット数で表した水平 ドット間隔 max_micro_address Yd micro_..._address での最大値 max_micro_jump Ye parm_..._micro での最大値 micro_char_size Yf マイクロモードでの文字サイズ micro_line_size Yg マイクロモードでの行サイズ number_of_pins Yh プリントヘッドのピン数 output_res_char Yi 行あたりのユニット数による水平解像度 output_res_line Yj 行あたりのユニット数による垂直解像度 output_res_horz_inch Yk インチあたりのユニット数による水平解像度 output_res_vert_inch Yl インチあたりのユニット数による垂直解像度 print_rate Ym 1 秒あたりの文字数による印字レート wide_char_size Yn 倍幅モードでの文字ステップサイズ buttons BT マウスのボタン数 bit_image_entwining Yo 各ビットイメージ行として渡される数 bit_image_type Yp ビットイメージデバイスのタイプ .Ed .Pp 以下、文字列ケーパビリティです: .Bd -literal \fB文字列 TCap 記述\fR \fB変数 コード\fR back_tab bt 後退タブ (P) bell bl 可聴シグナル (ベル) (P) carriage_return cr キャリッジリターン (P*) change_scroll_region cs 領域を行 #1 から行 #2 までに変更 (P) clear_all_tabs ct 全タブストップをクリア (P) clear_screen cl 画面を消去しカーソルをホームに移動 (P*) clr_eol ce 行末までクリア (P) clr_eos cd 画面末までクリア (P*) column_address ch 絶対指定での水平位置 #1 (P) command_character CC 端末がプロトタイプで設定可能なコマンド文字 cursor_address cm 行 #1 桁 #2 に移動 cursor_down do 1 行下に移動 cursor_home ho カーソルをホームに移動 cursor_invisible vi カーソルを見えなくする cursor_left le 1 つ左に移動 cursor_mem_address CM メモリ相対のカーソル位置指定 cursor_normal ve 通常のカーソル表示にする (cursor_invisible/cursor_visible の無効化) cursor_right nd 1 つ右に移動 cursor_to_ll ll 最終行の最初の桁 cursor_up up 1 行上に移動 cursor_visible vs カーソルを非常に見易くする delete_character dc 文字削除 (P*) delete_line dl 行削除 (P*) dis_status_line ds ステータス行を無効にする down_half_line hd 半行下に移動 enter_alt_charset_mode as 別の文字セット開始 (P) enter_blink_mode mb 点滅オン enter_bold_mode md ボールド (さらに明るい) モードオン enter_ca_mode ti cursor_address を使用するプログラムを開始 する文字列 enter_delete_mode dm 削除モードへ入る enter_dim_mode mh 半輝度モードオン enter_insert_mode im 挿入モードへ入る enter_secure_mode mk ブランクモードオン (文字が見えません) enter_protected_mode mp 保護モードオン enter_reverse_mode mr 反転表示モードオン enter_standout_mode so 強調表示モード開始 enter_underline_mode us 下線モード開始 erase_chars ec #1 個文字を削除 (P) exit_alt_charset_mode ae 別の文字セット終了 (P) exit_attribute_mode me 全属性をオフ exit_ca_mode te cup 使用のプログラムを終了する文字列 exit_delete_mode ed 削除モード終了 exit_insert_mode ei 挿入モードから抜ける exit_standout_mode se 強調表示モードから抜ける exit_underline_mode ue 下線モードから抜ける flash_screen vb 可視ベル (カーソルは移動しません) form_feed ff ハードコピー端末でのページ排出 (P*) from_status_line fs ステータス行からの復帰 init_1string i1 初期化文字列 init_2string is 初期化文字列 init_3string i3 初期化文字列 init_file if 初期化ファイルの名前 insert_character ic 文字挿入 (P) insert_line al 行挿入 (P*) insert_padding ip 挿入された文字の後にパディングを挿入 key_backspace kb backspace キー key_catab ka clear-all-tabs キー key_clear kC clear-screen または erase キー key_ctab kt clear-tab キー key_dc kD delete-character キー key_dl kL delete-line キー key_down kd down-arrow キー key_eic kM 挿入モードで mir や smir により送られる key_eol kE clear-to-end-of-line キー key_eos kS clear-to-end-of-screen キー key_f0 k0 F0 ファンクションキー key_f1 k1 F1 ファンクションキー key_f10 k; F10 ファンクションキー key_f2 k2 F2 ファンクションキー key_f3 k3 F3 ファンクションキー key_f4 k4 F4 ファンクションキー key_f5 k5 F5 ファンクションキー key_f6 k6 F6 ファンクションキー key_f7 k7 F7 ファンクションキー key_f8 k8 F8 ファンクションキー key_f9 k9 F9 ファンクションキー key_home kh home キー key_ic kI insert-character キー key_il kA insert-line キー key_left kl left-arrow キー key_ll kH last-line キー key_npage kN next-page キー key_ppage kP prev-page キー key_right kr right-arrow キー key_sf kF scroll-forward キー key_sr kR scroll-backward キー key_stab kT set-tab キー key_up ku up-arrow キー keypad_local ke 'キーボード送出' モードから抜ける keypad_xmit ks 'キーボード送出' モードに入る lab_f0 l0 非 f0 の時、ファンクションキー f0 のラベル lab_f1 l1 非 f1 の時、ファンクションキー f1 のラベル lab_f10 la 非 f10 の時、ファンクションキー f10 の ラベル lab_f2 l2 非 f2 の時、ファンクションキー f2 のラベル lab_f3 l3 非 f3 の時、ファンクションキー f3 のラベル lab_f4 l4 非 f4 の時、ファンクションキー f4 のラベル lab_f5 l5 非 f5 の時、ファンクションキー f5 のラベル lab_f6 l6 非 f6 の時、ファンクションキー f6 のラベル lab_f7 l7 非 f7 の時、ファンクションキー f7 のラベル lab_f8 l8 非 f8 の時、ファンクションキー f8 のラベル lab_f9 l9 非 f9 の時、ファンクションキー f9 のラベル meta_off mo メタモードオフ meta_on mm メタモードオン (8 ビット目をオン) newline nw 改行 (cr の後に lf が来たように振舞います) pad_char pc パディング文字 (ナルの代り) parm_dch DC #1 文字を削除 (P*) parm_delete_line DL #1 行を削除 (P*) parm_down_cursor DO #1 行下に移動 (P*) parm_ich IC #1 文字を挿入 (P*) parm_index SF #1 行の前進スクロール (P) parm_insert_line AL #1 行を挿入 (P*) parm_left_cursor LE #1 文字左に移動 (P) parm_right_cursor RI #1 文字右に移動 (P*) parm_rindex SR #1 行の後退スクロール (P) parm_up_cursor UP #1 行上に移動 (P*) pkey_key pk 文字列 #2 をタイプする プログラムファンクションキー #1 pkey_local pl 文字列 #2 を実行する プログラムファンクションキー #1 pkey_xmit px 文字列 #2 を転送する プログラムファンクションキー #1 print_screen ps 画面の内容を印字 prtr_off pf プリンタオフ prtr_on po プリンタオン repeat_char rp 文字 #1 を #2 回繰り返す (P*) reset_1string r1 リセット文字列 reset_2string r2 リセット文字列 reset_3string r3 リセット文字列 reset_file rf リセットファイルの名前 restore_cursor rc save_cursor の最後の位置へカーソルを戻す row_address cv 絶対指定での垂直位置 #1 (P) save_cursor sc 現在のカーソル位置を保存 (P) scroll_forward sf テキストを上にスクロール (P) scroll_reverse sr テキストを下にスクロール (P) set_attributes sa ビデオ属性 #1-#9 を定義 (PG9) set_tab st 全ての行において今いる桁にタブを設定 set_window wi 現在のウィンドウを、行 #1-#2 桁 #3-#4 に 設定 tab ta 次の 8 スペースハードウェアタブストップへ タブ to_status_line ts ステータス行へ移動 underline_char uc 文字に下線を引きその後に移動 up_half_line hu 半行上に移動 init_prog iP 初期化プログラムのパス名 key_a1 K1 キーパッドの左上キー key_a3 K3 キーパッドの右上キー key_b2 K2 キーパッドの中央キー key_c1 K4 キーパッドの左下キー key_c3 K5 キーパッドの右下キー prtr_non pO #1 バイトだけプリンタをオンする termcap_init2 i2 2 番目の初期化文字列 termcap_reset rs 端末リセット文字 # # SVr1 のケーパビリティはここまでです。 # IBM の terminfo はここまでは SVr4 と同じですが、ここから先は異なります。 # char_padding rP insert_padding と似ていますが挿入モード時 に使用 acs_chars ac 図形文字セットの組 - def=vt100 plab_norm pn プログラムラベル #1 は文字列 #2 を表示 key_btab kB back-tab キー enter_xon_mode SX xon/xoff ハンドシェークオン exit_xon_mode RX xon/xoff ハンドシェークオフ enter_am_mode SA 自動マージンオン exit_am_mode RA 自動マージンオフ xon_character XN XON 文字 xoff_character XF XOFF 文字 ena_acs eA 別の文字セットを有効にする label_on LO ソフトラベルオン label_off LF ソフトラベルオフ key_beg @1 begin キー key_cancel @2 cancel キー key_close @3 close キー key_command @4 command キー key_copy @5 copy キー key_create @6 create キー key_end @7 end キー key_enter @8 enter/send キー key_exit @9 exit キー key_find @0 find キー key_help %1 help キー key_mark %2 mark キー key_message %3 message キー key_move %4 move キー key_next %5 next キー key_open %6 open キー key_options %7 options キー key_previous %8 previous キー key_print %9 print キー key_redo %0 redo キー key_reference &1 reference キー key_refresh &2 refresh キー key_replace &3 replace キー key_restart &4 restart キー key_resume &5 resume キー key_save &6 save キー key_suspend &7 suspend キー key_undo &8 undo キー key_sbeg &9 シフト状態の begin キー key_scancel &0 シフト状態の cancel キー key_scommand *1 シフト状態の command キー key_scopy *2 シフト状態の copy キー key_screate *3 シフト状態の create キー key_sdc *4 シフト状態の delete char キー key_sdl *5 シフト状態の delete line キー key_select *6 select キー key_send *7 シフト状態の end キー key_seol *8 シフト状態の end-of-line キー key_sexit *9 シフト状態の exit キー key_sfind *0 シフト状態の find キー key_shelp #1 シフト状態の help キー key_shome #2 シフト状態の home キー key_sic #3 シフト状態の insert char キー key_sleft #4 シフト状態の left キー key_smessage %a シフト状態の message キー key_smove %b シフト状態の move キー key_snext %c シフト状態の next キー key_soptions %d シフト状態の options キー key_sprevious %e シフト状態の previous キー key_sprint %f シフト状態の print キー key_sredo %g シフト状態の redo キー key_sreplace %h シフト状態の replace キー key_sright %i シフト状態の right キー key_srsume %j シフト状態の resume キー key_ssave !1 シフト状態の save キー key_ssuspend !2 シフト状態の suspend キー key_sundo !3 シフト状態の undo キー req_for_input RF 次の入力文字を送る (pty で使用) key_f11 F1 F11 ファンクションキー key_f12 F2 F12 ファンクションキー key_f13 F3 F13 ファンクションキー key_f14 F4 F14 ファンクションキー key_f15 F5 F15 ファンクションキー key_f16 F6 F16 ファンクションキー key_f17 F7 F17 ファンクションキー key_f18 F8 F18 ファンクションキー key_f19 F9 F19 ファンクションキー key_f20 FA F20 ファンクションキー key_f21 FB F21 ファンクションキー key_f22 FC F22 ファンクションキー key_f23 FD F23 ファンクションキー key_f24 FE F24 ファンクションキー key_f25 FF F25 ファンクションキー key_f26 FG F26 ファンクションキー key_f27 FH F27 ファンクションキー key_f28 FI F28 ファンクションキー key_f29 FJ F29 ファンクションキー key_f30 FK F30 ファンクションキー key_f31 FL F31 ファンクションキー key_f32 FM F32 ファンクションキー key_f33 FN F33 ファンクションキー key_f34 FO F34 ファンクションキー key_f35 FP F35 ファンクションキー key_f36 FQ F36 ファンクションキー key_f37 FR F37 ファンクションキー key_f38 FS F38 ファンクションキー key_f39 FT F39 ファンクションキー key_f40 FU F40 ファンクションキー key_f41 FV F41 ファンクションキー key_f42 FW F42 ファンクションキー key_f43 FX F43 ファンクションキー key_f44 FY F44 ファンクションキー key_f45 FZ F45 ファンクションキー key_f46 Fa F46 ファンクションキー key_f47 Fb F47 ファンクションキー key_f48 Fc F48 ファンクションキー key_f49 Fd F49 ファンクションキー key_f50 Fe F50 ファンクションキー key_f51 Ff F51 ファンクションキー key_f52 Fg F52 ファンクションキー key_f53 Fh F53 ファンクションキー key_f54 Fi F54 ファンクションキー key_f55 Fj F55 ファンクションキー key_f56 Fk F56 ファンクションキー key_f57 Fl F57 ファンクションキー key_f58 Fm F58 ファンクションキー key_f59 Fn F59 ファンクションキー key_f60 Fo F60 ファンクションキー key_f61 Fp F61 ファンクションキー key_f62 Fq F62 ファンクションキー key_f63 Fr F63 ファンクションキー clr_bol cb 行頭までクリア clear_margins MC 左右のソフトマージンをクリア set_left_margin ML 左のソフトマージンを設定 set_right_margin MR 右のソフトマージンを設定 label_format Lf ラベルフォーマット set_clock SC 時刻を #1 時 #2 分 #3 秒に設定 display_clock DK 位置 (#1,#2) に時計を表示 remove_clock RC 時計を取り除く create_window CW ウィンドウ #1 を #2, #3 から #4, #5 までと 定義 goto_window WG ウィンドウ #1 に移動 hangup HU 電話をハングアップする dial_phone DI 番号 #1 にダイアルする quick_dial QD チェックせずに番号 #1 にダイアルする tone TO タッチトーンダイアルを選択 pulse PU パルスダイアルを選択 flash_hook fh スイッチフックをフラッシュする fixed_pause PA 2-3 秒待つ wait_tone WA ダイアルトーンを待つ user0 u0 ユーザ文字列 #0 user1 u1 ユーザ文字列 #1 user2 u2 ユーザ文字列 #2 user3 u3 ユーザ文字列 #3 user4 u4 ユーザ文字列 #4 user5 u5 ユーザ文字列 #5 user6 u6 ユーザ文字列 #6 user7 u7 ユーザ文字列 #7 user8 u8 ユーザ文字列 #8 user9 u9 ユーザ文字列 #9 # # SVr4 は以下のケーパビリティを追加してカラーをサポートしました # orig_pair op デフォルトのペアを元の値に戻す orig_colors oc 色のペア全てを元に戻す initialize_color Ic 色 #1 を (#2,#3,#4) に設定 initialize_pair Ip 色のペア #1 を fg=(#2,#3,#4), bg=(#5,#6,#7) に設定 set_color_pair sp 現在の色のペアを #1 に設定 set_foreground Sf 前景色を #1 に設定 set_background Sb 背景色を #1 に設定 # # SVr4 は以下のケーパビリティを追加してプリンタをサポートしました # change_char_pitch ZA 1 インチあたりの文字数を変更 change_line_pitch ZB 1 インチあたりの行数を変更 change_res_horz ZC 水平解像度を変更 change_res_vert ZD 垂直解像度を変更 define_char ZE 文字を定義 enter_doublewide_mode ZF 倍幅モードに入る enter_draft_quality ZG ドラフト印字モードに入る enter_italics_mode ZH イタリックモードに入る enter_leftward_mode ZI キャリッジの左向き移動開始 enter_micro_mode ZJ マイクロ移動モードに入る enter_near_letter_quality ZK NLQ 印字モードに入る enter_normal_quality ZL 通常品質印字モードに入る enter_shadow_mode ZM シャドウプリントモード開始 enter_subscript_mode ZN 下付き文字モード enter_superscript_mode ZO 上付き文字モード enter_upward_mode ZP キャリッジの上向き移動開始 exit_doublewide_mode ZQ 倍幅印字モード終了 exit_italics_mode ZR イタリックモード終了 exit_leftward_mode ZS 左向き移動モード終了 exit_micro_mode ZT マイクロ移動モード終了 exit_shadow_mode ZU シャドウプリントモード終了 exit_subscript_mode ZV 下付き文字モード終了 exit_superscript_mode ZW 上付き文字モード終了 exit_upward_mode ZX 逆向き文字移動終了 micro_column_address ZY マイクロモードの column_address micro_down ZZ マイクロモードの cursor_down micro_left Za マイクロモードの cursor_left micro_right Zb マイクロモードの cursor_right micro_row_address Zc マイクロモードの row_address micro_up Zd マイクロモードの cursor_up order_of_pins Ze ソフトウェアビットを印字ヘッドピンに あわせる .\" Match software bits to print-head pins ？ parm_down_micro Zf マイクロモードの parm_down_cursor parm_left_micro Zg マイクロモードの parm_left_cursor parm_right_micro Zh マイクロモードの parm_right_cursor parm_up_micro Zi マイクロモードの parm_up_cursor select_char_set Zj 文字セットの選択 set_bottom_margin Zk 現在の行を下マージンに設定 set_bottom_margin_parm Zl 下マージンを行 #1 または下から #2 行に設定 set_left_margin_parm Zm 左 (右) マージンを桁 #1 (#2) に設定 set_right_margin_parm Zn 右マージンを桁 #1 に設定 set_top_margin Zo 上マージンを現在の行に設定 set_top_margin_parm Zp 上 (下) マージンを行 #1 (#2) に設定 start_bit_image Zq ビットイメージグラフィクスの印刷開始 start_char_set_def Zr 文字セットの定義開始 stop_bit_image Zs ビットイメージグラフィクスの印刷停止 stop_char_set_def Zt 文字セットの定義終了 subscript_characters Zu 下付き文字となりうる文字のリスト superscript_characters Zv 上付き文字となりうる文字のリスト these_cause_cr Zw 印字すると CR となる文字 zero_motion Zx 次の文字表示では移動しない # # 以下の文字列ケーパビリティは SVr4.0 の term 構造体にありますが、 # マニュアルページには記述されていません。 # char_set_names Zy 文字セット名のリスト key_mouse Km マウスイベントが発生した mouse_info Mi マウス状態の情報 req_mouse_pos RQ マウス位置の要求 get_mouse Gm curses がボタンイベントを取得すべき set_a_foreground AF ANSI 前景色を設定 set_a_background AB ANSI 背景色を設定 pkey_plab xl 文字列 #2 をタイプし、文字列 #3 を表示する プログラムファンクションキー device_type dv 言語/コードセットサポートの表示 code_set_init ci 複数コードセットシーケンスの初期化 set0_des_seq s0 コードセット 0 へシフト (EUC セット 0, ASCII) set1_des_seq s1 コードセット 1 へシフト set2_des_seq s2 コードセット 2 へシフト set3_des_seq s3 コードセット 3 へシフト set_lr_margin ML 左右マージンをそれぞれ #1, #2 に設定 set_tb_margin MT 上下マージンをそれぞれ #1, #2 に設定 bit_image_repeat Xy ビットイメージセル #1 を #2 回繰り返す bit_image_newline Zz ビットイメージの次の行に移動 bit_image_carriage_return Yv 同一行の先頭に移動 color_names Yw 色 #1 の名前を与える define_bit_image_region Yx 長方形のビットイメージ領域を定義 end_bit_image_region Yy ビットイメージ領域の終了 set_color_band Yz 色リボン #1 に変更 set_page_length YZ ページ長を #1 行に設定 # # SVr4 は以下のケーパビリティを追加し、直接 PC クローンをサポートしました # display_pc_char S1 PC 文字を表示 enter_pc_charset_mode S2 PC 文字表示モードに入る exit_pc_charset_mode S3 PC 文字表示モード終了 enter_scancode_mode S4 PC スキャンコードモードに入る exit_scancode_mode S5 PC スキャンコードモードから抜ける pc_term_options S6 PC 端末オプション scancode_escape S7 スキャンコードエミュレーションのための エスケープ alt_scancode_esc S8 スキャンコードエミュレーションのための 別のエスケープ # # XSI curses 標準は、以下のケーパビリティを追加しました。 # enter_horizontal_hl_mode Xh 水平ハイライトモードに入る enter_left_hl_mode Xl 左ハイライトモードに入る enter_low_hl_mode Xo 下ハイライトモードに入る enter_right_hl_mode Xr 右ハイライトモードに入る enter_top_hl_mode Xt 上ハイライトモードに入る enter_vertical_hl_mode Xv 垂直ハイライトモードに入る .Pp 以下は廃れた termcap ケーパビリティです。 新しいソフトウェアはどれにも依存しないようにしてください。 .Bd -literal \fBブール値 TCap 記述\fR \fB変数 コード\fR linefeed_is_newline NL ^J で下に移動 even_parity EP 端末は偶数パリティを要求 odd_parity OP 端末は奇数パリティを要求 half_duplex HD 端末は半 2 重 lower_case_only LC 端末は小文字のみ持つ upper_case_only UC 端末は大文字のみ持つ has_hardware_tabs pt ^I で起動される 8 文字タブがある return_does_clr_eol xr リターンは行をクリアする tek_4025_insert_line xx Tektronix 4025 の insert-line グリッチ backspaces_with_bs bs 左に移動するために ^H を使用 crt_no_scrolling ns crt はスクロールできない no_correctly_working_cr nc 行頭に行く手段が無い .Ed .Bd -literal \fB数値 TCap 記述\fR \fB変数 コード\fR backspace_delay dB ^H に必要なパディング form_feed_delay dF ^L に必要なパディング horizontal_tab_delay dT ^I に必要なパディング vertical_tab_delay dV ^V に必要なパディング number_of_function_keys kn ファンクションキーの数 carriage_return_delay dC CR に必要なパディング new_line_delay dN LF に必要なパディング .Ed .Bd -literal \fB文字列 TCap 記述\fR \fB変数 コード\fR other_non_function_keys ko 自己にマップされたキーのリスト arrow_key_map ma 矢印キーを rogue(1) の移動キーにマップ memory_lock_above ml 現在の行より上の画面で見える部分のメモリを ロック memory_unlock mu 現在の行より上の画面で見える部分のメモリの ロックを解除 linefeed_if_not_lf nl 下に移動するために使用 backspace_if_not_bs bc ^H でない場合に左に移動 .Ed .Ss エントリのサンプル 以下のエントリは Concept\-100 について記述しており、 本書の中でも最も複雑なエントリの 1 つです。 .Pp .Bd -literal ca\||\|concept100\||\|c100\||\|concept\||\|c104\||\|concept100-4p\||\|HDS Concept\-100:\e :al=3*\eE^R:am:bl=^G:cd=16*\eE^C:ce=16\eE^U:cl=2*^L:cm=\eEa%+ %+ :\e :co#80:.cr=9^M:db:dc=16\eE^A:dl=3*\eE^B:do=^J:ei=\eE\e200:eo:im=\eE^P:in:\e :ip=16*:is=\eEU\eEf\eE7\eE5\eE8\eEl\eENH\eEK\eE\e200\eEo&\e200\eEo\e47\eE:k1=\eE5:\e :k2=\eE6:k3=\eE7:kb=^h:kd=\eE<:ke=\eEx:kh=\eE?:kl=\eE>:kr=\eE=:ks=\eEX:\e :ku=\eE;:le=^H:li#24:mb=\eEC:me=\eEN\e200:mh=\eEE:mi:mk=\eEH:mp=\eEI:\e :mr=\eED:nd=\eE=:pb#9600:rp=0.2*\eEr%.%+ :se=\eEd\eEe:sf=^J:so=\eEE\eED:\e :.ta=8\et:te=\eEv \e200\e200\e200\e200\e200\e200\eEp\er\en:\e :ti=\eEU\eEv 8p\eEp\er:ue=\eEg:ul:up=\eE;:us=\eEG:\e :vb=\eEk\e200\e200\e200\e200\e200\e200\e200\e200\e200\e200\e200\e200\e200\e200\eEK:\e :ve=\eEw:vs=\eEW:vt#8:xn:\e :bs:cr=^M:dC#9:dT#8:nl=^J:ta=^I:pt: .Ed .Pp 行末文字に \e を使用すれば、複数行にエントリを続けることができます。 また空のフィールドを含めて可読性を上げることもできます (ある行の最後のフィールドから次の行の最初のフィールドまでです)。 コメントは .Dq # で始まる行に含めることができます。 .Ss ケーパビリティの型 .Nm のケーパビリティには次の 3 種類があります: 特定の機能を端末が持つかどうかを示す、ブール値ケーパビリテイ; 画面の大きさや他の属性の大きさを与える、数値ケーパビリティ; そして特定の端末操作を行うために使用可能な文字列を与える、 文字列ケーパビリティです。 全てのケーバビリティが 2 文字のコードを持ちます。 例えば、Concept が .Em 自動マージン (行末に到達すると、自動的にリターンおよびラインフィードする機能) を持つという事実は、ブール値ケーパビリティ .Sy \&am で示されます。 それゆえ Concept の記述は .Sy \&am を含みます。 .Pp 数値ケーパビリティの後には文字 `#' が続き、そして値が続きます。 上の例では、画面の桁数を示す .Sy \&co は Concept に対しては値 `80' を与えます。 .Pp 最後に、文字列値のケーパビリティ、例えば .Sy \&ce (行末までクリアのシーケンス) は、2 文字のコード、単一の `='、 そして次の `:' までの文字列で与えられます。 このケーパビリティにおいては、ミリ秒指定の遅延を `=' の後に指定可能です。 この場合、残りの文字列が送られた後、パディング文字が .Xr tputs により与えられ、この遅延を発生させます。 遅延は `20' のような数値または `3*' のような `*' が続く数値です。 `*' は、 この操作により影響を受ける行数に必要なパディングが比例すること、 そして指定量は影響を受ける各行に必要なパディングであることを示します。 (insert-character の場合でも、係数は影響を受ける .Em 行 数です; ただし、端末が .Sy \&in を持っていてソフトウェアがこれを使用する場合以外は、この値は常に 1 です。) `*' が指定される時、`3.5' のような形式により 1/10 ミリ秒単位で 行あたりの遅延を指定するのが便利な場合があります。 (10 進数 1 桁分のみ許されます。) .Pp 多くのエスケープシーケンスが文字列値のケーパビリティで提供されますので、 ここでは容易に制御文字をエンコードできます。 .Sy \&\eE は .Dv ESC 文字にマップし、 .Sy \&^X は適切な X に対して control-X にマップし、シーケンス .Sy \&\en .Sy \&\er .Sy \&\et .Sy \&\eb .Sy \&\ef はそれぞれ、ラインフィード、リターン、タブ、バックスペース、フォームフィード にマップします。 最後に、文字は .Sy \&\e の後に 3 桁 8 進数として指定可能ですし、 .Sy \&^ と .Sy \&\e の文字は .Sy \&\e^ と .Sy \&\e\e として与えられます。 ケーパビリティ中に .Sy \&: を入れる必要がある場合、8 進数で .Sy \&\e072 とエスケープする必要があります。 文字列ケーパビリティ中に .Dv NUL 文字を入れる必要がある場合、 .Sy \&\e200 とエンコードする必要があります。( .Nm を扱うルーチンは C の文字列を使用し、 出力の最上位ビットをかなり遅い段階で取り除くので、 .Sy \&\e200 は .Sy \&\e000 として出力されます。) .Pp 個々のケーパビリティをコメントアウトする必要があるかもしれません。 その場合には、ケーパビリティ名の前にピリオドを付けます。 例えば、例における最初の .Sy \&cr と .Sy \&ta を見てください。 .Ss 記述の準備 端末記述を準備する最も効果的な方法は、 .Nm 中の似た端末の記述を真似し、 .Xr \&vi を使用して部分記述の正しさを確認することにより、 徐々に記述を構築するというものです。 非常に稀なことですが、端末によっては、 .Nm ファイルの記述能力不足や .Xr \&vi のバグが露呈することがありますので注意してください。 あなたが新しく作った端末記述を簡単にテストするには、 あなたのホームディレクトリに .Pa .termcap という名前のファイルとして置き、 プログラムが .Pa /usr/share/misc/termcap の前にこれを見るようにします。 環境変数 .Ev TERMPATH をあなたが作成した記述を含む絶対ファイルパス名のリスト (空白もしくはコロンで区切ります) に設定することにより、 プログラムはこれらをリスト順に検索し、他は検索しないようになります。 .Xr termcap 3 を参照してください。 .Ev TERMCAP 環境変数は、通常 .Nm エントリ自身に設定され、プログラム起動時にファイルを読むことを避けます。 .Pp 行挿入に対する適切なパディングを得るためには (端末製造元が記述しなかった場合には)、 .Xr \&vi を使用して .Pa /etc/passwd を 9600 ボーで編集し、およそ 16 行を画面中央から削除し、 それから `u' キーを何度か素早く押すという、厳しいテストを行います。 画面がぐちゃぐちゃになった場合には、 通常はより多くのパディングが必要となります。 同様のテストを文字挿入に対しても行うことが可能です。 .Ss 基本ケーパビリティ 表示の各行の桁数は .Sy \&co 数値ケーパビリティで与えられます。 表示が .Tn CRT になされる場合、画面の行数は .Sy \&li ケーパビリティで与えられます。 カーソルが右マージンに到達した時に、表示が次の行の先頭に回り込む場合には、 .Sy \&am ケーパビリティを持ちます。 端末が画面をクリア可能な場合には、そうするためのコードが .Sy \&cl 文字列ケーパビリティで与えられます。 端末が (上書きされる文字の位置をクリアするのではなく) 上打ちする場合には、 .Sy \&os ケーパビリティがあります。 端末がプリント端末でソフトコピーユニットを持たない場合、 .Sy \&hc と .Sy \&os を指定してください。 .Pf ( Sy \&os があてはまるのは Tektronix 4010 シリーズのようなストレージスコープ端末、 ハードコピー端末、そして .Tn APL 端末です。) カーソルを直ちに左端に移動するためのコードがある場合には、それを .Sy \&cr で指定します。 (通常これは復帰文字(キャリッジリターン)、すなわち .Sy \&^M です。) 可聴シグナル (ベルやビープなど) を発生するコードがある場合には、それを .Sy \&bl で指定します。 .Pp (バックスペースのように) カーソルを 1 つ左に移動するコードがある場合には、 このケーパビリテイは .Sy \&le で指定します。 同様に、右上下に移動するコードはそれぞれ .Sy \&nd , .Sy \&up , .Sy \&do で指定します。 これらの .Em ローカルなカーソル移動 は、カーソルが通過する文字を変化させてはなりません; 例えば、通常は .Dq nd=\ \& を使用してはなりません。例外は 端末が .Sy \&os ケーパビリティを持つ場合です。 この理由は、通過する文字を空白が消してしまうからです。 .Pp ここで非常に重要なポイントは、 .Nm でエンコードされるローカルなカーソル移動は、 .Tn CRT 表示の左端および上端では動作が未定義だということです。 ローカルなカーソル移動を使用している場合には、 左端においては .Sy \&bw が与えられているのでなければ、 プログラムはバックスペースを試してはなりませんし、 上端においては上への移動を試してはなりません。 .Pp テキストを上にスクロールするには、プログラムは画面左下角に移動して、 .Sy \&sf (インデックス) 文字列を送ります。 テキストを下にスクロールするには、プログラムは画面左上角に移動して、 .Sy \&sr (逆インデックス) 文字列を送ります。 期待された角以外での .Sy \&sf および .Sy \&sr 文字列の動作は未定義です。 パラメータ化したバージョンのスクロールシーケンスは .Sy \&SF および .Sy \&SR で、 .Sy \&sf および .Sy \&sr と同様の意味ですが、 1 つパラメータを取ってその行数だけスクロールさせるというところが違います。 これらもまた、画面上の適切な角以外での動作は未定義です。 .Pp .Sy \&am ケーパビリティは、画面の右端にてテキスト出力を行った時に、 カーソルがその位置に留まるか否かを示します。 しかしこれは、最後の桁での .Sy \&nd を必ずしも意味しません。 左端らかの左向きのローカル移動は、 .Sy \&bw が与えられている場合のみ定義されます; この場合、左端における .Sy \&le は、直前行の右端へ移動します。 例えば、画面の周囲に箱を描画する場合に便利です。 端末が切替選択式の自動マージンを持つ場合には、 .Nm 記述は通常この機能、 .Em すなわち .Sy \&am がオンであることを仮定します。 次行の先頭桁への移動コマンドを端末が持つ場合、このコマンドは .Sy \&nw (改行) で与えることができます。 これを使用して現在の行の残りの部分をクリアすることができますので、 正しく動作する .Tn \&CR および .Tn \&LF を持たない場合には、これらの代りに使用することができます。 .Pp これらの機能で、ハードコピー端末および .Dq ガラスの tty 端末を記述するためには十分です。 Teletype model 33 は以下のように記述されています .Bd -literal -offset indent T3\||\|tty33\||\|33\||\|tty\||\|Teletype model 33:\e :bl=^G:co#72:cr=^M:do=^J:hc:os: .Ed .Pp また Lear Siegler .Tn ADM Ns \-3 は以下のように記述されています .Bd -literal -offset indent l3\||\|adm3\||\|3\||\|LSI \s-1ADM\s0-3:\e :am:bl=^G:cl=^Z:co#80:cr=^M:do=^J:le=^H:li#24:sf=^J: .Ed .Ss パラメータ化された文字列 カーソル位置設定などのパラメータを要求する文字列は、 パラメータ化された文字列ケーパビリティで記述します。 ここでは .Xr printf 3 に似たエスケープ .Sy \&%x を使用します。その他の文字は変更されずに渡されます。 例えば、カーソル位置設定のために .Sy \&cm ケーパビリティが与えられますが、これは 2 つのパラメータを使用します: それぞれ移動先の行と桁です。 (行と桁は 0 から番号が振られ、ユーザから見える物理画面を参照します。 見えないメモリは参照しません。 端末がメモリ相対のカーソル位置設定機能を持つ場合には、 .Sy \&CM という似たケーパビリティで指定されます。) .Pp .Sy \&% エンコードは以下の意味を持ちます: .Bl -column xxxxx .It %% Ta No `%' を出力 .It "%d 値を" .Xr printf %d のように出力 .It "%2 値を" .Xr printf %2d のように出力 .It "%3 値を" .Xr printf %3d のように出力 .It "%. 値を" .Xr printf %c のように出力 .It "%+" Ns Em x Ta No 値に .Em x を加え、% を実行 .It "%>" Ns Em \&xy Ta No もし 値 \&> .Em x の場合には .Em y を加える。無出力 .It "%r 2 つのパラメータの順を逆転。無出力" .It "%i 1 増加。無出力" .It "%n 全パラメータに関した 0140 との排他的論理和 (Datamedia 2500)" .It "%B" Ta Tn BCD No "(16*(value/10)) + (value%10) を実行。無出力" .It "%D 逆コーディング (value \- 2*(value%16))。無出力 (Delta Data)" .El .Pp Hewlett-Packard 2645 において第 3 行第 12 桁に移動する場合、 .Dq \eE&a12c03Y を送って 6 ミリ秒パディングする必要があります。 行と桁の関係がここでは逆であり、行および桁は 2 桁の整数として送る ことに注意してください。 よって、この端末の .Sy \&cm ケーパビリティは .Dq Li cm=6\eE&%r%2c%2Y となります。 .Pp Datamedia 2500 は現在の行と桁を .Dq \&%. でバイナリエンコードして送る必要があります。 .Dq \&%. を使用する端末は、カーソルをバックスペース .Po Sy \&le Pc させる機能と画面上で 1 行カーソルを上に移動 .Po Sy \&up Pc する機能を持つ必要があります。 なぜなら .Sy \&\en , .Sy \&^D , .Sy \&\er を送出するのは常に安全というわけではなく、 システムがこれらに変更を加えたり捨てたりする場合があるからです。( .Nm を使用するプログラムは、タブが展開されないように端末モードを設定し、 .Sy \&\et が安全に送られるようにしなければなりません。 これは Ann Arbor 4080 において本質的です。) .Pp 最後の例は Lear Siegler .Tn ADM Ns \-3a です。この端末では行と桁は空白文字で与えますので、 .Dq Li cm=\eE=%+ %+\ となります。 .Pp 絶対値での行や桁のカーソル位置設定は、単一パラメータのケーパビリティ .Sy \&ch (水平絶対位置) および .Sy \&cv (垂直絶対位置) で与えられます。 一般的な 2 パラメータシーケンスよりもこれらを使用する方が短かいことがあり (Hewlett-Packard 2645 の場合)、 .Sy \&cm よりも好んで使用され得ます。 パラメータ化されたローカル移動 .Pf ( Em 例えば 、 .Ar n 個右に移動) の機能がある場合、 .Sy \&DO , .Sy \&LE , .Sy \&RI , .Sy \&UP として与えられます。これらは単一パラメータを取り、 いくつ移動するのかを示します。 第 1 に Tektronix 4025 のような .Sy \&cm を持たない端末で有用です。 .Ss カーソル移動 .Pp 端末が高速にカーソルをホーム (画面の左上角) に移動する方法がある場合、これは .Sy \&ho として与えられます。 同様に、高速に左下角に移動する方法は、 .Sy \&ll で与えられます; これには、ホームポジションにて .Sy \&up を使用することによる上への移動を含みますが、 プログラム自身がこれを実行してはなりません (ただし .Sy \&ll が実行する場合を除く)。 なぜならプログラムはホームポジションでの上への移動の効果を 仮定できないからです。) ホームポジションは、カーソル位置 (0,0) と同じです: 画面の左上角であり、メモリは無関係です。 (それゆえ、Hewlett-Packard 端末の .Dq \eEH シーケンスは、 .Sy \&ho としては使用できません。) .Ss 領域クリア 端末が、現在位置に留まりつつ、現在位置から行末までクリア可能である場合には、 この機能は .Sy \&ce として与えられます。 端末が、現在位置から描画終端までをクリア可能である場合には、この機能は .Sy \&cd として与えられます。 .Sy \&cd は行の最初の桁においてのみ起動可能です。(よって、真の .Sy \&cd が利用できない場合、この機能は多数の行を削除する要求にてシミュレート可能です。) .Ss 行の挿入および削除 端末が、カーソルがいる行の前に新しい空行を開けることが可能な場合、この機能は .Sy \&al として与えられます; この機能を起動するには行頭にいる必要があります。 行を開けると、カーソルは新しい空行の左端に移動します。 端末が、カーソルがいる行を削除可能な場合、この機能は .Sy \&dl として与えられます； この機能を起動するには削除する行の先頭にいる必要があります。 1 つパラメータを取ってその数だけ行を挿入および削除する .Sy \&al および .Sy \&dl の変形は、 .Sy \&AL および .Sy \&DL として与えられます。 端末が、(VT100 のように) 設定可能なスクロール領域を持つ場合、 設定コマンドは 2 つのパラメータを取る .Sy \&cs ケーパビリティとして記述されます: パラメータはスクロール領域の上端行および下端行です。 なんとしたことか、このコマンド使用後のカーソル位置は未定義です。 行挿入および行削除の効果はこのコマンドを使用することで得られます \(em .Sy \&sc および .Sy \&rc (カーソルの保存と回復) コマンドもまた有用です。 画面の上端または下端における行挿入は、 真の行挿入/削除を持たない多くの端末において、 .Sy \&sr または .Sy \&sf にて実行できます。 また、真の行挿入/削除機能を持つ端末においても、 こちらの方が高速な場合が多いです。 .Pp メモリの一部を、 全コマンドが影響するウィンドウとして定義する能力を端末が持つ場合、 これはパラメータ化された文字列 .Sy \&wi で与えられます。 4 つのパラメータは順番に、メモリにおける開始行・終了行・開始桁・終了桁です。 (この .Xr terminfo ケーパビリティは完全性のために記述しています。 .Nm を使用するプログラムはこの機能を使ってはいないでしょう。) .Pp 端末が画面より上方の表示メモリを保存する場合、 .Sy \&da ケーパビリティが与えられます; 下方の表示メモリが保存される場合、 .Sy \&db が与えられます。 これらの機能は、 行削除やスクロールにより非空白行が下から現れることや、 .Sy \&sr による後退スクロールにより非空白行が上から現れることを示します。 .Ss 文字の挿入および削除 .Nm にて記述可能な文字挿入および削除に関しては、 基本的に 2 種類のインテリジェント端末があります。 最も一般的な文字の挿入/削除操作は現在行の文字にのみ作用し、 行末までの文字を厳格にシフトします。 他の端末、Concept\-100 や Perkin Elmer Owl では、 タイプされた空白とタイプされたものではない空白を区別し、 挿入/削除に際するシフトは 画面上のタイプされたものではない空白にのみ適用されます。 タイプされたものではない空白は、削除されるか、 2 つのタイプされたものではない空白に拡張されます。 使用している端末の種類を判別するためには、 画面をクリアし、カーソル移動を含めてテキストをタイプします。例えば .Dq Li abc\ \ \ \ def を、 .Dq abc と .Dq def の間でローカルなカーソル移動 (空白ではありません) を行ってタイプします。 その後、カーソルを .Dq abc の前に移動し、端末を挿入モードにします。 そこで文字をタイプすると 行の残りの部分が厳密にシフトされ終端から出て行く場合、 あなたの端末は空白とタイプされたものではない位置とを区別しません。 もし挿入に際して、 .Dq abc が .Dq def のところまでシフトし、 それから一緒に現在の行の終端まで移動して次行に移動する場合、 あなたの端末は 2 番目の種類の端末を持っていますので、 .Dq ナル挿入 を表すケーパビリティ .Sy \&in を指定します。 これら 2 つは論理的に別の属性 (1 行 .Em 対 複数行の挿入モードでタイプされたものではない空白を特別に扱う) ですが、 挿入モードをどちらかで記述できない端末を我々は見たことがありません。 .Pp .Nm エントリは、挿入モードを持つ端末も、 単純なシーケンスを送って現在の行に空白位置を開ける端末も、両方記述可能です。 .Sy \&im は挿入モードに入るシーケンスを表します。 .Sy \&ei は挿入モードから抜けるシーケンスを表します。そして、 .Sy \&ic は、挿入する文字を送る直前に送る必要があるシーケンスを表します。 真の挿入モードを持つほとんどの端末は、 .Sy \&ic を指定しません; 一方、画面上の位置を開けるためにシーケンスを使用する端末は、 これを指定する必要があります。 (端末が両方の機能を持つ場合には、挿入モードは通常 .Sy \&ic が好まれます。実際に両機能を組み合せる必要がある端末の場合以外は、 両方を指定しないでください。) 挿入後にパディングが必要な場合、ミリ秒数にて .Sy \&ip (文字列オプション) で与えます。 1 文字挿入後に送る必要があるシーケンスもまた .Sy \&ip で指定します。`挿入モード' である必要があり、 なおかつ挿入文字の前に特別のコードを送る必要がある端末の場合、 .Sy \&im Ns / Sy \&ei と .Sy \&ic が与えられ、両方を使用します。 単一のパラメータ .Em n を取る .Sy \&IC ケーパビリティは、 .Sy \&ic の効果を .Em n 回繰り返します。 .Pp 挿入モード中で同一行の文字を削除するために、時々移動が必要になります .Pf ( Em 例えば 挿入位置の後にタブがある場合)。 挿入モード中で移動を許す端末の場合、ケーパビリティ .Sy \&mi を指定して、このような場合の挿入を高速化できます。 .Sy \&mi を省略しても速度に影響するだけです。 端末によっては (特に Datamedia のものでは)、挿入モードの動作方法の理由により、 .Sy \&mi を指定してはなりません。 .Pp 最後に、1 文字削除のために .Sy \&dc を指定可能です。 .Sy \&DC は単一パラメータ .Em n を取り .Em n 文字削除します。 そして削除モードは、 .Sy \&dm および .Sy \&ed で、削除モードの入り方および抜け方を示します (削除モードとは、 .Sy \&dc が動作するために端末がいるべきモードです)。 .Ss ハイライト・下線・可視ベル 端末が 1 つまたはそれ以上の種類の表示属性を持つ場合、 これらは様々な方法で表現されていることでしょう。 1 つの表示形式を .Em 強調表示モード として選択してください。このモードは十分高いコントラストで見易く、 エラーメッセージや注意を引く表示のハイライトに適します。 (選択可能ならば、反転表示に半分の明るさ、もしくは反転表示のみが良いでしょう。) 強調表示モードに入るシーケンスおよび出るシーケンスは、それぞれ .Sy \&so および .Sy \&se で与えられます。 .Tn TVI 912 や Teleray 1061 のように、 強調表示モードの出入りのコードが、 1 つ 2 つの空白やごみの文字を画面上に残す場合、 .Sy \&sg を指定して、何文字残されるのかを指定してください。 .Pp 下線の開始および下線の終了は、それぞれ .Sy \&us および .Sy \&ue で指定します。 下線モード変更によるごみは、 .Sy \&sg 同様 .Sy \&ug として指定します。 Microterm Mime のように、現在位置の文字に下線を引き、 カーソルをひとつ右の位置に移動するコードを端末が持つ場合、 このコードは .Sy \&uc で指定します。 .Pp その他もろもろのハイライトモードに入るケーパビリティには、 .Sy \&mb (点滅)、 .Sy \&md (ボールドまたは更に明るい)、 .Sy \&mh (暗いまたは半輝度)、 .Sy \&mk (空白または見えないテキスト)、 .Sy \&mp (保護状態)、 .Sy \&mr (反転表示)、 .Sy \&me .Pf ( Em 全て の属性モードをオフ)、 .Sy \&as (別の文字セットモードに入る) そして .Sy \&ae (別の文字セットモードから抜ける) があります。 これらのモードを単独でオンにした場合、 他のモードをオフにする場合もありますし、オフにしない場合もあります。 .Pp モードの任意の組み合わせを設定するシーケンスがある場合、 これは 9 個のパラメータを取る .Sy \&sa (属性設定) で指定します。 それぞれのパラメータは 0 または 1 であり、 対応する属性がオンまたはオフされます。 9 個のパラメータは順番に次の通りです: 強調表示・下線・反転・点滅・ 暗い・ボールド・空白・保護・別の文字セット。 全モードが .Sy \&sa によりサポートされている必要は無く、 サポートされているものに対応するコマンドが存在することのみ必要です。( .Nm を使用するプログラムはこのケーパビリティをサポートしていないでしょう。 このケーパビリティは .Xr terminfo との互換性のために定義しています。) .Pp 各文字セルに追加された属性ビットを管理するのではなく、 .Dq マジッククッキー グリッチ .Pf ( Sy \&sg および .Sy \&ug ) を持つ端末では、 描画アルゴリズムに影響するモード設定シーケンスを受信した時に、 特別な .Dq クッキー または .Dq ごみ文字 を画面に残します。 .Pp Hewlett-Packard 2621 のように、 新しい行へ移動した時やカーソル位置を設定した時に 自動的に強調表示モードから抜ける端末があります。 このような端末においては、強調表示モードを使用するプログラムは、 カーソル移動や改行送信前に強調表示モードから抜ける必要があります。 このような問題が無い端末では、 .Sy \&ms ケーパビリティが存在し、このオーバヘッドが不要であることを示します。 .Pp エラーを静かに伝えるために端末が画面をフラッシュさせる方法を持つ場合 (ベルの代りです)、これは .Sy \&vb として指定します; この機能はカーソルを移動してはなりません。 .Pp カーソルが最下行になくても、 通常時よりも見易くする必要がある場合 (例えば、点滅していない下線を、 より見付け易いブロックや点滅する下線に変更する場合)、このシーケンスは .Sy \&vs で与えます。 カーソルを完全に見えなくする方法がある場合には、これは .Sy \&vi ケーパビリティで指定します。 これらのモードの効果を打ち消すケーパビリティ .Sy \&ve も指定する必要があります。 .Pp (特別なコードを必要とせずに) 下線を引かれた文字を端末が正しく表示する場合、 しかもその機能が上打ちではない場合、 このケーパビリティを .Sy \&ul で示します。 上打ちを空白にて消去可能な場合、これは .Sy \&eo で示します。 .Ss キーパッド キーを押した時にコードを送出するキーパッドを持つ端末では、 この情報を指定することができます。 キーパッドがローカルモードにおいてのみ動作する端末は 扱うことができないことに注意してください。 (これは例えば Hewlett-Packard 2621 でシフト状態でないキーにあてはまります)。 キーコードの送出 / 非送出をキーパッドに設定できる場合は、 設定のためのコードは .Sy \&ks および .Sy \&ke で指定します。 そうでない場合はキーパッドは常にコードを送出するものと仮定されます。 left-arrow, right-arrow, up-arrow, down-arrow, home のキーで送出されるコードは それぞれ .Sy \&kl , .Sy \&kr , .Sy \&ku , .Sy \&kd , .Sy \&kh , で指定します。 f0, f1, ..., f9 のようなファンクションキーがある場合には、 これらのキーが送るコードは .Sy \&k0 , .Sy \&k1 , ..., .Sy \&k9 で指定します。 これらのキーがデフォルトの f0 から f9 以外のラベルを持つ場合、このラベルは .Sy \&l0 , .Sy \&l1 , ..., .Sy \&l9 で指定します。 その他の特殊キーで送出されるコードは次のように与えられます: .Sy \&kH (ホームダウン)、 .Sy \&kb (バックスペース)、 .Sy \&ka (全タブクリア)、 .Sy \&kt (この桁のタブストップをクリア)、 .Sy \&kC (画面クリアまたは消去)、 .Sy \&kD (文字削除)、 .Sy \&kL (行削除)、 .Sy \&kM (挿入モードから抜ける)、 .Sy \&kE (行末までクリア)、 .Sy \&kS (画面の終りまでクリア)、 .Sy \&kI (文字挿入または挿入モードに入る)、 .Sy \&kA (行挿入)、 .Sy \&kN (次のページ)、 .Sy \&kP (前のページ)、 .Sy \&kF (前進/下降スクロール)、 .Sy \&kR (後退/上昇スクロール)、 .Sy \&kT (この桁にタブストップを設定)。 更に、キーパッドが 4 つの矢印キーを含む 3 × 3 のキー配列を持つ場合、 他の 5 つのキーは .Sy \&K1 , .Sy \&K2 , .Sy \&K3 , .Sy \&K4 , .Sy \&K5 で指定します。 3 × 3 の方向パッドが必要な時、これらのキーは有用です。 以前 .Dq その他 のファンクションキーを記述するために使用された、廃れた .Sy \&ko ケーパビリティは、上記のケーパビリティにより完全に置き換えられました。 .Pp .Sy \&ma エントリはまた、 端末の矢印キーが 1 文字矢印キーであることを示すためにも使用されます。 これは廃れた方法ですが、 .Sy \&vi のバージョン 2 で未だ使用されています。 メモリ制約の理由で、このコマンドを使用しているミニコンピュータがあるでしょう。 このフィールドは .Sy \&kl , .Sy \&kr , .Sy \&ku , .Sy \&kd , .Sy \&kh と冗長関係にあります。 このフィールドは 2 文字の複数グループから構成されます。 各グループにおいては、最初の文字は矢印キーが何を送るかを表し、 2 番目の文字は対応する .Sy \&vi のコマンドを表します。 コマンドは、 .Ar h が .Sy \&kl に、 .Ar j が .Sy \&kd に、 .Ar k が .Sy \&ku に、 .Ar l が .Sy \&kr に、 .Ar H が .Sy \&kh に対応します。 例えば Mime では .Dq Li ma=^Hh^Kj^Zk^Xl となり、矢印キーの left (^H), down (^K), up (^Z), down (^X) を示します。 (Mime には home キーはありません。) .Ss タブおよび初期化 これらのケーパビリティを使用するプログラムを実行する時に 端末を特別なモードにすることが必要な場合、 このモードに入るコードおよび出るコードは .Sy \&ti と .Sy \&te で指定します。 これが関係あるのは、例えば Concept のようなメモリページを複数持つ端末です。 端末がメモリ相対のカーソル位置設定のみ持ち、 画面相対のカーソル位置設定を持たない場合には、 画面サイズのウィンドウに表示を固定し、 カーソル位置設定が正しく動作するようにする必要があります。 これは Tektronix 4025 でも使用され、 .Sy \&ti はコマンド文字を .Nm が使うように設定します。 .Pp 他のケーパビリティとしては、端末初期化文字列 .Sy \&is や、長い初期化文字列を格納するファイル名 .Sy \&if があります。 これらの文字列は、端末を .Nm 記述と矛盾がないモードに設定するものと期待されています。 これらは通常、ユーザがログインするたびに、 .Xr tset プログラムによって端末に送られます。 印字は次の順に行われます: まず .Sy \&is ; 次に .Sy \&ct と .Sy \&st によるタブ設定; そして最後に .Sy \&if です。 .Pf ( Xr terminfo では .Sy \&is の代りに .Sy \&i\&1-i2 を使用し、プログラム .Sy \&iP を実行し、他の初期化の後 .Sy "\&i\&3" を印字します。) まったくわけがわからない状態から回復するためのよりハードな リセットシーケンスの組が、類推できる名前 .Sy \&rs および .Sy \&rf で与えられます。 これらの文字列は、端末がはまった状態に陥いった時に使用される .Xr reset プログラムにより出力されます。 .Pf ( Xr terminfo は .Sy \&rs の代りに .Sy "\&r1-r3" を使用します。) これらのコマンドが画面上を騒がせ、 なおかつログイン時に必ずしも必要ではない場合に限り、 通常これらは .Sy \&rs および .Sy \&rf に格納します。 例えば、VT100 を 80 桁モードに設定するコマンドは、普通に考えると .Sy \&is の一部に入れるでしょうが、これは画面に困ったゴミを生じさせますし、 端末は普段既に 80 桁モードですので、実際は入れる必要はありません。 .Pp 端末がハードウェアタブを持つ場合、 次のタブストップまで進むコマンドは .Sy \&ta で指定します (通常は .Sy \&^I です)。 直前のタブストップへ左向きに移動する .Dq バックタブ コマンドは、 .Sy \&bt で指定します。 タブストップが端末には送られずに計算機により展開されることを 端末ドライバモードが示す場合、 .Sy \&ta や .Sy \&bt が存在するとしても、プログラムでこれらを使用しないというのが約束になって います。 なぜなら、ユーザがタブストップを正しく設定していないかもしれないからです。 端末電源オン時に各 .Ar n 位置ごとにハードウェアタブが初期設定される端末の場合、 数値パラメータ .Sy \&it を使用し、タブストップ間隔を示します。 このコマンドは通常 .Xr tset コマンドが使用し、ドライバモードをハードウェアタブ展開に設定するか否か、 およびタブストップを設定するか否かを決定します。 端末が不揮発性メモリにタブストップを保存可能な場合、 .Nm 記述はタブストップが正しく設定されるものと仮定できます。 .Pp タブストップを設定およびクリアするコマンドが存在する場合、 これらのコマンドは .Sy \&ct (全タブストップをクリア) および .Sy \&st (全ての行における現在の桁にタブストップを設定) で指定します。 タブ設定のために、ここで示した方法より複雑なシーケンスが必要な場合、 このシーケンスは .Sy \&is や .Sy \&if で指定します。 .Ss 遅延 端末ドライバのパディングを制御するケーパビリティもあります。 これらのケーパビリティは、第 1 にハードコピー端末にて必要とされ、 .Xr tset プログラムにより端末ドライバのモードを適切に設定するために使用されます。 ケーパビリティ .Sy \&cr , .Sy \&sf , .Sy \&le , .Sy \&ff , .Sy \&ta に埋め込まれる遅延は、端末ドライバの適切な遅延ビットを設定する効果があります。 .Sy \&pb (パディングボーレート) を指定した場合、 この値より低いボーレートにおいては、これらの値は無視されます。 .Bx 4.2 の .Xr tset では、遅延は別の数値ケーパビリティ .Sy \&dC , .Sy \&dN , .Sy \&dB , .Sy \&dF , .Sy \&dT で与えられます。 .Ss その他 端末が .Dv NUL (0) 文字以外のパディング文字を必要とする場合には、 .Sy \&pc で指定します。 .Sy \&pc 文字列の最初の文字のみが使用されます。 .Pp 端末がカーソル位置を保存および回復するコマンドを持つ場合には、これらは .Sy \&sc および .Sy \&rc で指定します。 .Pp 通常はソフトウェアが使用しない追加の .Dq ステータス行 を端末が持つ場合、この事実を示すことができます。 ステータス行が最下行の下に追加の行として見える場合には、ケーパビリティ .Sy \&hs を指定します。 ステータス行の位置への移動およびステータス行からの復帰のための特別な文字列は、 .Sy \&ts および .Sy \&fs で指定します。 .Pf ( Sy \&ts の前にカーソルが存在した位置に、 .Sy \&fs はカーソルを戻す必要があります。必要ならば、 .Sy \&sc および .Sy \&rc の文字列を .Sy \&ts および .Sy \&fs に含めてこの効果を得ることができます。) ケーパビリティ .Sy \&ts は、ステータス行の何桁目にカーソルが移動すべきを示すパラメータを 1 つ取ります。 エスケープシーケンスや他の特殊コマンド、 例えばタブがステータス行でも動作するならば、フラグ .Sy \&es を指定します。 ステータス行をオフにする (または内容を消去する) 文字列は、 .Sy \&ds で指定します。 通常、ステータス行の幅は画面の他の部分、 .Em すなわち .Sy \&co と同じであると仮定されます。(端末が行全体の使用を許さない等の理由で) ステータス行の幅が異なる場合には、その幅を桁数で数値パラメータ .Sy \&ws で指定します。 .Pp 端末が半行上下に移動可能な場合、 .Sy \&hu (半行上) および .Sy \&hd (半行下) で指定します。 これは、ハードコピー端末で上付き文字および下付き文字を使用するために有用です。 ハードコピー端末がページを排出して次のページに移動 (フォームフィード) する ことができる場合、これは .Sy \&ff (通常 .Sy \&^L です) で指定します 。 .Pp 指定した文字を指定した回数繰り返すコマンド (同一文字を何度も送出する時間を節約します) がある場合、 パラメータ化された文字列 .Sy \&rp で指定します。 最初のパラメータは繰り返される文字であり、2 番目のパラメータは 繰り返す回数です。(これは .Xr terminfo の機能であり、 .Nm を使用するプログラムはこの機能をサポートしていないでしょう。) .Pp Tektronix 4025 のように端末が設定可能なコマンド文字を持つ場合、 .Sy \&CC で指定します。 全ケーパビリティで使用されるプロトタイプコマンド文字が選択されます。 この文字を識別するために、この文字が .Sy \&CC ケーパビリティにより与えられます。 次の約束をサポートしている .Ux システムがあります: すなわち、 .Ev \&CC 環境変数を検査し、もし設定されている場合には、 プロトタイプ文字を環境変数で設定されているものと置き換えるという約束です。 このように .Ev \&CC 環境変数を使用することは、 .Xr make 1 との衝突が発生しますので、非常に悪い考えです。 .Pp 特定の既知の端末を表現するものではない端末記述、 .Em switch , .Em dialup , .Em patch , .Xr network では .Sy \&gn (一般) ケーパビリティを設定し、 端末に対してどのように話しかければよいのか分らないと プログラムが文句を言えるようにします。 (このケーパビリティは、エスケープシーケンスが既知である .Em 仮想 端末記述にはあてはまりません。 .Pp 端末が xoff/xon .Pq Tn DC3 Ns / Ns Tn DC1 ハンドシェークを使用してフロー制御する場合、 .Sy \&xo を指定します。 コストに関するより良い判定を可能とするために 依然としてパディング情報を指定する必要がありますが、 実際にパディング文字が送出されるということはありません。 .Pp シフトキーのように動作し、送出される文字の 8 ビット目をセットする .Dq メタキー を端末が備える場合、 .Sy \&km を設定してこの事実を示すことができます。 これが指定されない場合は、ソフトウェアは 8 ビット目はパリティであると仮定し、 通常これをクリアしてしまいます。 .Dq メタモード をオンおよびオフする文字列が存在する場合、これらは .Sy \&mm および .Sy \&mo で指定します。 .Pp 画面 1 枚分より多くのメモリ行を端末が備える場合、 メモリの行数を .Sy \&lm で指定します。 明示的に値 0 を指定すると、行数は固定ではないものの 画面分より多くのメモリがあることを示します。 .Pp .Ux システムの仮想端末プロトコルにてサポートされる端末である場合、 端末番号は .Sy \&vt で与えられます。 .Pp 端末に接続された外部プリンタを制御するメディアコピー文字列は、 次のように与えられます。すなわち .Sy \&ps : 画面内容の印字; .Sy \&pf : プリンタオフ; および .Sy \&po : プリンタオンです。 プリンタオン時には、端末に送られる全てのテキストはプリンタに送られます。 プリンタオン時に端末画面にもテキストが表示されるか否かは未定義です。 このバリエーションである .Sy \&pO は単一のパラメータを取り、 パラメータ値で指定される文字数だけプリンタをオンにし、 その後プリンタをオフにします。 このパラメータは 255 を越えてはなりません。 .Sy \&pf を含む全テキストは、 .Sy \&pO が有効である間、透過的にプリンタに渡されます。 .Pp プログラムファンクションキーへの文字列は .Sy \&pk , .Sy \&pl , .Sy \&px で指定します。 これらの文字列は次の 2 つのパラメータを取ります: それぞれ、プログラム対象のファンクションキー番号 (0 から 9 まで) と、 プログラムの文字列です。 この範囲外のファンクションキー番号を指定すると、 ここでは定義できないキーを端末依存の方式でプログラムするかもしれません。 これらのケーパビリティの差異は、 .Sy \&pk は指定したキーを押すと指定した文字列を ユーザがタイプしたものとして扱うものであり; .Sy \&pl はローカルモードの端末にて指定した文字列を実行させるものであり; .Sy \&px は指定した文字列を計算機に送出させるものである点です。 不幸なことに、 .Nm では文字列パラメータが定義されていないため、 .Xr terminfo のみがこれらのケーパビリティをサポートします。 .Ss グリッチと不良 文字 `~' を表示できない Hazeltine 端末は .Sy \&hz を指定する必要があります。 .Pp .Sy \&nc ケーパビリティは現在廃れていますが、 以前は Datamedia 端末を表すために使用していました。 この端末では、キャリッジリターンに対して .Sy \&\er \en をエコーし、続くラインフィードを無視します。 .Pp Concept のように .Sy \&am による折り返しの直後のラインフィードを無視する端末では、 .Sy \&xn を指定します。 .Pp 強調表示を取り除くために (単に通常のテキストを上書きするだけで済まず) .Sy \&ce が必要な場合、 .Sy \&xs を指定します。 .Pp タブによって移動された全ての文字が空白にされてしまう Teleray 端末では、 .Sy \&xt (破壊的なタブ) を指定する必要があります。 このグリッチは、\*(lqマジッククッキー\*(rq の先頭に カーソル位置を設定できないことと、 強調表示を消すためには行削除と行挿入が必要であることも表現します。 .Pp .Dv ESC や .Sy \&^C の文字を正しく送出できない Beehive Superbee は .Sy \&xb を指定し、 .Dq \&f\&1 キーが .Dv ESC として使用され、 .Dq \&f\&2 キーが ^C として使用されることを示します。( 特定の Superbee のみがこの問題を持ち、これは .Tn ROM に依存します。) .Pp ある特定の端末に他の問題がある場合、 .Sy x Ns Em x の形式のケーパビリティを追加することにより正しく動作するようにしても 構いません。 .Ss 似た端末 2 つの非常によく似た端末がある場合、 例外はあるもののもう一方にそっくりであると、 一方を定義することができます。 文字列ケーパビリティ .Sy \&tc には似た端末の名前を与えます。 このケーパビリティは .Em 最後 である必要があり、組み合わせたエントリの長さは 1024 を越えてはなりません。 .Sy \&tc の前に指定したケーパビリティは .Sy \&tc により呼び出される端末タイプの記述に優先します。 ケーパビリティのキャンセルのためには .Sy \&xx@ を .Sy \&tc の呼び出しの左に置きます。 .Sy \&xx はキャンセルされるケーパビリティです。 例えば、エントリ .Bd -literal -offset indent hn\||\|2621\-nl:ks@:ke@:tc=2621: .Ed .Pp は、ビジュアルモードでファンクションキーラベルをオンにしないために .Sy \&ks と .Sy \&ke のケーパビリティを持たない .Dq 2621\-nl を定義します。 端末の種々のモードやユーザの種々のプリファレンスを記述するために有用です。 .Sh 関連ファイル .Bl -tag -width /usr/share/misc/termcap.db -compact .It Pa /usr/share/misc/termcap 端末記述を格納するファイル .It Pa /usr/share/misc/termcap.db 端末記述を格納するハッシュデータベースファイル .Pf ( Xr cap_mkdb 1 を参照)。 .El .Sh 関連項目 .Xr cap_mkdb 1 , .Xr ex 1 , .Xr more 1 , .Xr tset 1 , .Xr ul 1 , .Xr vi 1 , .Xr curses 3 , .Xr printf 3 , .Xr termcap 3 , .Xr term 5 .Sh 警告およびバグ .Em 注 : .Nm の機能は .At V Release 2.0 の .Xr terminfo に置き換えられました。 .Dq 廃れた とされるケーパビリティを使用していなければ、 移行のための苦痛は比較的少ないです。 .Pp 現在、行数および桁数は、 termcap エントリに格納するものと同様に、カーネルが格納します。 現在、ほとんどのプログラムはカーネルの情報を最初に使用します; このファイルに記述されている情報は、 カーネルが情報を持たない時のみ使用されます。 .Pp .Xr \&vi 1 プログラムは文字列ケーパビリティには 256 文字しか許しませんが、 .Xr termlib 3 のルーチンはこのバッファの溢れをチェックしません。 単一エントリの総計の長さは 1024 を越えてはなりません (エスケープされた改行は除きます)。 .Pp 全てのプログラムが全てのエントリをサポートしているわけではありません。 .Sh 歴史 .Nm ファイルフォーマットは .Bx 3 に登場しました。 diff --git a/ja/man/man5/terminfo.5 b/ja/man/man5/terminfo.5 index 5e6a4750c2..cc7de902cb 100644 --- a/ja/man/man5/terminfo.5 +++ b/ja/man/man5/terminfo.5 @@ -1,1718 +1,1718 @@ .\" Note: this must be run through tbl befor nroff .TH TERMINFO 5 -.\" jpman $Id: terminfo.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: terminfo.5,v 1.3 1998/06/13 12:36:00 horikawa Stab % .\" .\" WORD: capability ケーパビリティ(termcapで、端末の機能の 1 つ 1 つを指す) .\" WORD: terminal 端末(いわゆるターミナル、文字端末を表す) .\" WORD: display 描画 .\" WORD: screen 画面 .\" WORD: CRT CRT .\" WORD: attribute 属性 .\" WORD: underline 下線 .\" WORD: return 復帰(文字) .\" WORD: carriage return 復帰(文字) .\" WORD: backspace 逆行文字 .\" WORD: backward tab 後退タブ(文字) .\" WORD: padding パディング(時間かせぎのためのダミーで埋め込むバイト) .\" WORD: erase (画面の)消去 .\" WORD: standout 強調(明るく/目立つ色で印字するなど) .\" WORD: column 桁(カラム) .\" WORD: arrow key 矢印キー .\" WORD: reverse video 反転表示(白黒反転モードのこと) .\" WORD: overstrike 重ね打ち(上打ち) .\" WORD: status line ステータス行(画面最下にある状態表示行) .\" WORD: scroll forward 前進スクロール .\" WORD: scroll backward 後退スクロール .\" WORD: background color 背景色 .\" WORD: foreground color 前景色 .\" WORD: color pair 色のペア、色ペア .\" WORD: micro mode マイクロ移動モード .\" WORD: magic cookie glitch 「魔法のクッキー」とでも呼ぶべきゴミ .\" WORD: teletype driver 端末ドライバ(tty.4 のこと...terminfo のみで使われる?!) .\" WORD: teletype driver mode 端末ドライバのモード .\" WORD: glass-tty ブラウン管テレタイプ[terminfo.5,termcap.5] .\" .ds n 5 .ds d /usr/lib/terminfo .SH 名称 terminfo \- 端末ケーパビリティのデータベース .SH 書式 \*d/*/* .SH 解説 .I terminfo は端末の特性を記述するデータベースであり、 .IR vi (1), .IR rogue (1) や .IR ncurses (3) など、画面を活用したプログラムによって使用されます。 .I terminfo は、端末が持つケーパビリティの集合を与え、画面操作をどのようにして行うか を指定し、必要なパディングや初期化シーケンスを指定することで、端末の特性 を記述します。 .PP .I terminfo のエントリは、',' で区切られた幾つかのフィールドからなります。 \&',' の後の空白類文字(空白、タブ)は無視されます。各端末を表す最初の エントリは、端末を表すものとしてよく知られている省略形の名前を指定します。 名前を複数指定するときは '|' で区切ります。最初の名前は、その端末のものと して最もよく知られた名前を与えます。最後の名前には、その端末を識別できるだけの 長い名前を指定するべきです。それら以外の名前は、同じ端末を指す別名と見な されます。最後のもの以外の名前は、全て英小文字からなり、空白が含まれてい てはいけません。最後の名前には、読みやすくするための大文字や空白を含めて もかまいません。 .PP 端末名(最後の冗長なものは除く)は、以下の約束にしたがって付けてください。 名前の基本部分を、端末を構成するハードウェアの特徴的部分から名付けます (``hp2621''のように)。この名前にはハイフンを含めてはいけません。ただし、 別名は他の名前と重ならないように選べば構いません。ハードウェアが持つ モードや、ユーザのプリファレンスが現れる部分については、基本名の後に、ハイフンと モードを表す名前をつけて表してください。例えば、vt100 の 132 桁モードは vt100-w のようになります。使えるところがあれば、以下の接尾辞を使ってくだ さい: .TS center; l c l l l l. \fB接尾辞 意味 例\fP -w 広いモード(80 桁以上) vt100-w -am 自動マージン付 (通常これがデフォルト) vt100-am -nam 自動マージン無し vt100-nam -\fIn\fP 画面の行数 aaa-60 -na 矢印キー無し(もしくはローカルでのみ有効) c100-na -\fIn\fPp 画面記憶ページ数 c100-4p -rv 反転表示 c100-rv .TE .SH ケーパビリティ variable は、(terminfo レベルの)プログラマがケーパビリティ情報を使用する ときに用いる名前です。capname は、データベースのテキストの中で用いる短縮 名で、データベースを更新する人間が用いる名前です。i.code は、コンパイル されたデータベース中で用いられる2文字の内部コードで、古典的な .B termcap ケーパビリティの名前と常に対応しています。 .P ケーパビリティの名前の長さには、決まった上限はありません。ただし、名前を 短くし、ソースファイルにタブを使って .B caps をきれいに並べられるように、非公式ながら上限 5 文字の制限が既に 採用されています。 可能な場合は常に、名前は ANSI X3.64-1979 標準規格と同一もしくは類似のも のを選んであります。その意味も、その規格での規定に合致するようにしてあり ます。 .TP (P) パディングが指定可能であることを表します。 .TP (G) tparm を使って文字列を渡す際に、(#\fIi\fP) で与えたパラメータをともに 渡すことを表します。 .TP (*) 影響を受ける行数にパディングが依存することを表します。 .TP (#\d\fIi\fP\u) 第 \fIi\fP 番目のパラメータを表します。 .TS center; c c c c c c c c l l l l. \fBvariable cap- i. 説明\fR \f3ブール値: name code\fR \s-1auto_left_margin, bw bw cub1 は桁0から最後の桁に回り 込む\s+1 \s-1auto_right_margin, am am 自動マージン機能を持つ\s+1 \s-1back_color_erase, bce ut 画面を背景色で消去する\s+1 \s-1can_change, ccc cc 既存の色を再定義可能\s+1 \s-1ceol_standout_glitch, xhp xs 強調出力は上書きで消去されない (hp 系端末)\s+1 \s-1col_addr_glitch, xhpa YA hcp/mhpc では正方向のみ移動可能\s+1 \s-1cpi_changes_res, cpix YF 文字ピッチを変えると解像度が変わる\s+1 \s-1cr_cancels_micro_mode, crxm YB cr を使用するとマイクロモードが オフになる\s+1 \s-1eat_newline_glitch, xenl xn 80 桁より後の改行は無視される (Concept の機能)\s+1 \s-1erase_overstrike, eo eo 空白の重ね打ちで消去可能\s+1 \s-1generic_type, gn gn 一般的な回線タイプ (例: dialup, switch)\s+1 \s-1hard_copy, hc hc ハードコピー端末\s+1 \s-1hard_cursor, chts HC カーソルが見にくい\s+1 \s-1has_meta_key, km km メタキーを持つ (押すとパリティ ビットがセットされる)\s+1 \s-1has_print_wheel, daisy YC 文字セットを変更するのに人手が 必要なプリンタ\s+1 \s-1has_status_line, hs hs ステータス行を持つ\s+1 \s-1hue_lightness_saturation, hls hl 端末は HLS 色表記のみ使用 (tektronix社端末)\s+1 \s-1insert_null_glitch, in in 挿入モードでナル文字を区別する\s+1 \s-1lpi_changes_res, lpix YG 行ピッチを変えると解像度が変わる\s+1 \s-1memory_above, da da 画面より上の描画が保持される\s+1 \s-1memory_below, db db 画面より下の描画が保持される\s+1 \s-1move_insert_mode, mir mi 挿入モードで安全にカーソル移動可能\s+1 \s-1move_standout_mode, msgr ms 強調モードで安全にカーソル移動可能\s+1 \s-1needs_xon_xoff, nxon nx パディング機能が働かない。 xon/xoff 制御が必要\s+1 \s-1no_esc_ctl_c, xsb xb Beehive 端末 (f1=escape, f2=ctrl C)\s+1 \s-1non_rev_rmcup, nrrmc NR smcup は rmcup の動作を反転しない\s+1 \s-1no_pad_char, npc NP パディング文字が存在しない\s+1 \s-1non_dest_scroll_region, ndscr ND スクロール領域が非破壊的\s+1 \s-1over_strike, os os 端末は重ね打ち可能\s+1 \s-1prtr_silent, mc5i 5i プリンタ出力は画面にエコーしない\s+1 \s-1row_addr_glitch, xvpa YD vhp/mvpa では正方向のみ移動可能\s+1 \s-1semi_auto_right_margin, sam YE 最終桁で出力すると cr 動作をする\s+1 \s-1status_line_esc_ok, eslok es ステータス行上でエスケープ可能\s+1 \s-1dest_tabs_magic_smso, xt xt タブは破壊的 / 強調文字の動作が 奇妙 (Teleray 1061)\s+1 \s-1tilde_glitch, hz hz Hazeltine 端末。~ 表示不可\s+1 \s-1transparent_underline, ul ul 下線付文字は上書きする\s+1 \s-1xon_xoff, xon xo 端末は xon/xoff ハンドシェークを 行う\s+1 \s-1\f3数値:\fR\s+1 \s-1bit_image_entwining, bitwin Yo SVr4.0 に記述なし\s+1 \s-1buffer_capacity, bufsz Ya 印字前にバッファリング可能な バイト数\s+1 \s-1columns, cols co 1行の桁数\s+1 \s-1dot_vert_spacing, spinv Yb 水平方向のドット間隔(dots/inch)\s+1 \s-1dot_horz_spacing, spinh Yc 垂直方向のピン間隔(pins/inch)\s+1 \s-1init_tabs, it it タブの初期設定は空白幾つか\s+1 \s-1label_height, lh lh ラベル 1 つの行数\s+1 \s-1label_width, lw lw ラベル 1 つの桁数\s+1 \s-1lines, lines li 画面 / ページの行数\s+1 \s-1lines_of_memory, lm lm lines の値以上の場合メモリの行数。 0 は行数が可変であることを表す\s+1 \s-1magic_cookie_glitch, xmc sg smso や rmso で画面に残る空白数\s+1 \s-1max_colors, colors Co 画面上の最大色数\s+1 \s-1max_micro_address, maddr Yd micro_..._address での最大値\s+1 \s-1max_micro_jump, mjump Ye parm_..._micro での最大値\s+1 \s-1max_pairs, pairs pa 画面上の色ペアの最大値\s+1 \s-1micro_col_size, mcs Yf マイクロモードでの文字ステップ サイズ\s+1 \s-1micro_line_size, mls Yg マイクロモードでの行ステップ サイズ\s+1 \s-1no_color_video, ncv NC 色付きでは使用できないビデオ属性\s+1 \s-1number_of_pins, npins Yh プリントヘッドのピン数\s+1 \s-1num_labels, nlab Nl 画面上のラベル数\s+1 \s-1output_res_char, orc Yi 水平解像度(1行あたりのユニット 数で)\s+1 \s-1output_res_line, orl Yj 垂直解像度(1行あたりのユニット 数で)\s+1 \s-1output_res_horz_inch, orhi Yk 水平解像度(インチあたりのユニッ ト数で)\s+1 \s-1output_res_vert_inch, orvi Yl 垂直解像度(インチあたりのユニッ ト数で)\s+1 \s-1padding_baud_rate, pb pb 復帰改行でパディングが必要な 最低ボー速度\s+1 \s-1virtual_terminal, vt vt 仮想画面番号 (\s-1UNIX\s+1 system)\s+1 \s-1width_status_line, wsl ws ステータス行の桁数\s+1 .TE (以下の数値ケーパビリティは、SVr4.0 の term 構造体に存在していますが、 マニュアルには未だに説明がありません。以下のコメントは term 構造体ヘッダ から取りました。) .TS center; l l l l. \s-1bit_image_type, bitype Yp ビットイメージデバイスのタイプ\s+1 \s-1buttons, btns BT マウスのボタン数\s+1 \s-1max_attributes, ma ma 端末が組み合わせて処理できる 属性数の最大値\s+1 \s-1maximum_windows, wnum MW 定義可能なウィンドウ数の最大\s+1 \s-1print_rate, cps Ym 印字速度(文字/秒)\s+1 \s-1wide_char_size, widcs Yn 倍幅モードでの文字ステップサイズ\s+1 \s-1\f3文字列:\fR\s+1 \s-1acs_chars, acsc ac 図形文字セットの組 - def=vt100\s+1 \s-1alt_scancode_esc, scesa S8 スキャンコードエミュレーション のための別のエスケープ文字 (デフォルトは vt100)\s+1 \s-1back_tab, cbt bt 後退タブ (P)\s+1 \s-1bell, bel bl 可聴シグナル(ベル) (P)\s+1 \s-1bit_image_repeat, birep Xy ビットイメージセル #1 を #2 回 繰り返す (tparm使用)\s+1 \s-1bit_image_newline, binel Zz ビットイメージの次の行に移動 (tparm使用)\s+1 \s-1bit_image_carriage_return, bicr Yv 同一行の先頭へ移動(tparm使用)\s+1 \s-1carriage_return, cr cr 復帰文字 (P*)\s+1 \s-1change_char_pitch, cpi ZA 1インチあたりの文字数を変更\s+1 \s-1change_line_pitch, lpi ZB 1インチあたりの行数を変更\s+1 \s-1change_res_horz, chr ZC 水平解像度を変更\s+1 \s-1change_res_vert, cvr ZD 垂直解像度を変更\s+1 \s-1change_scroll_region, csr cs #1 行目から #2 行目までに変更 (vt100) (PG)\s+1 \s-1char_padding, rmp rP ip と同様だが挿入モードで使用\s+1 \s-1char_set_names, csnm Zy 文字セット名のリスト\s+1 \s-1clear_all_tabs, tbc ct タブ設定全てをクリア (P)\s+1 \s-1clear_margins, mgc MC マージン設定全てをクリア(上, 下, 横)\s+1 \s-1clear_screen, clear cl 画面をクリアし、カーソルをホーム に移動 (P*)\s+1 \s-1clr_bol. el1 cb 行先頭までクリア\s+1 \s-1clr_eol, el ce 行末までクリア (P)\s+1 \s-1clr_eos, ed cd 画面末までクリア (P*)\s+1 \s-1code_set_init, csin ci 複数コードセットの初期化 シーケンス\s+1 \s-1color_names, colornm Yw 色 #1 の名前を与える\s+1 \s-1column_address, hpa ch カーソルの桁位置を指定 (PG)\s+1 \s-1command_character, cmdch CC 端末がプロトタイプで設定可能な コマンド文字\s+1 \s-1cursor_address, cup cm 画面相対でカーソルを行 #1 桁 #2 に移動 (PG)\s+1 \s-1cursor_down, cud1 do 1 行下に移動\s+1 \s-1cursor_home, home ho カーソルをホームに移動 (cup が ない場合)\s+1 \s-1cursor_invisible, civis vi カーソルを見えなくする\s+1 \s-1cursor_left, cub1 le カーソルを1 空白分左に移動\s+1 \s-1cursor_mem_address, mrcup CM メモリ相対のカーソル位置指定\s+1 \s-1cursor_normal, cnorm ve カーソルを通常表示にする (vs/vi を元に戻す)\s+1 \s-1cursor_right, cuf1 nd 非破壊空白 (カーソル右移動)\s+1 \s-1cursor_to_ll, ll ll 最終行の最初の桁 (cup がない場合)\s+1 \s-1cursor_up, cuu1 up 1 行上へ (カーソルを上へ)\s+1 \s-1cursor_visible, cvvis vs カーソルを見えるようにする\s+1 \s-1define_bit_image_region, defbi Yx 矩形のビットイメージ領域を定義 (tparmを使用)\s+1 \s-1define_char, defc ZE 文字セット中の文字を定義\s+1 \s-1delete_character, dch1 dc 文字削除 (P*)\s+1 \s-1delete_line, dl1 dl 行削除 (P*)\s+1 \s-1device_type, devt dv 言語/コードセットサポートの指定\s+1 \s-1dis_status_line, dsl ds ステータス行を無効にする\s+1 \s-1display_pc_char, dispc S1 PC 文字を表示\s+1 \s-1down_half_line, hd hd 半行下へ (1/2 改行)\s+1 \s-1ena_acs, enacs eA 別の文字セットを有効にする\s+1 \s-1end_bit_image_region, endbi Yy ビットイメージ領域の終了 (tparm使用)\s+1 \s-1enter_alt_charset_mode, smacs as 別の文字セット開始 (P)\s+1 \s-1enter_am_mode, smam SA 自動マージンオン\s+1 \s-1enter_blink_mode, blink mb 点滅モードオン\s+1 \s-1enter_bold_mode, bold md ボールド(更に明るい)モードオン\s+1 \s-1enter_ca_mode, smcup ti cup を用いたプログラムを開始する 文字列\s+1 \s-1enter_delete_mode, smdc dm 削除モード開始\s+1 \s-1enter_dim_mode, dim mh 半輝度モードオン\s+1 \s-1enter_doublewide_mode, swidm ZF 倍幅モード開始\s+1 \s-1enter_draft_quality, sdrfq ZG ドラフト印字モード開始\s+1 \s-1enter_insert_mode, smir im 挿入モード開始\s+1 \s-1enter_italics_mode, sitm ZH 斜体モード開始\s+1 \s-1enter_leftward_mode, slm ZI 左向き移動モード開始\s+1 \s-1enter_micro_mode, smicm ZJ マイクロ移動モード開始\s+1 \s-1enter_near_letter_quality, snlq ZK NLQ印字モード開始\s+1 \s-1enter_normal_quality, snrmq ZL 通常品質印字モード開始\s+1 \s-1enter_pc_charset_mode, smpch S2 PC 文字表示モード開始\s+1 \s-1enter_protected_mode, prot mp 保護モードオン\s+1 \s-1enter_reverse_mode, rev mr 反転表示モードオン\s+1 \s-1enter_scancode_mode, smsc S4 PC スキャンコードモード開始\s+1 \s-1enter_secure_mode, invis mk ブランクモードオン (文字が 見えない)\s+1 \s-1enter_shadow_mode, sshm ZM シャドウプリントモード開始\s+1 \s-1enter_standout_mode, smso so 強調モード開始\s+1 \s-1enter_subscript_mode, ssubm ZN 下付き文字モード開始\s+1 \s-1enter_superscript_mode, ssupm ZO 上付き文字モード開始\s+1 \s-1enter_underline_mode, smul us 下線モード開始\s+1 \s-1enter_upward_mode, sum ZP 上向き移動モードに入る\s+1 \s-1enter_xon_mode, smxon SX xon/xoff ハンドシェークオン\s+1 \s-1erase_chars, ech ec #1 個の文字を削除 (PG)\s+1 \s-1exit_alt_charset_mode, rmacs ae 別の文字セット終了 (P)\s+1 \s-1exit_am_mode, rmam RA 自動マージンオフ\s+1 \s-1exit_attribute_mode, sgr0 me 全属性オフ\s+1 \s-1exit_ca_mode, rmcup te cup を用いたプログラムを終了する 文字列\s+1 \s-1exit_delete_mode, rmdc ed 削除モード終了\s+1 \s-1exit_doublewide_mode, rwidm ZQ 倍幅印字モード終了\s+1 \s-1exit_insert_mode, rmir ei 挿入モード終了\s+1 \s-1exit_italics_mode, ritm ZR 斜体モードを止める\s+1 \s-1exit_leftward_mode, rlm ZS (通常の)右向き移動モードに入る\s+1 \s-1exit_micro_mode, rmicm ZT マイクロ移動モード終了\s+1 \s-1exit_pc_charset_mode, rmpch S3 PC 文字表示終了\s+1 \s-1exit_scancode_mode, rmsc S5 PC スキャンコードモード終了\s+1 \s-1exit_shadow_mode, rshm ZU シャドウプリントモード終了\s+1 \s-1exit_standout_mode, rmso se 強調モード終了\s+1 \s-1exit_subscript_mode, rsubm ZV 下付き文字モード終了\s+1 \s-1exit_superscript_mode, rsupm ZW 上付き文字モード終了\s+1 \s-1exit_underline_mode, rmul ue 下線モード終了\s+1 \s-1exit_upward_mode, rum ZX (通常の)下向き移動モードに入る\s+1 \s-1exit_xon_mode, rmxon RX xon/xoff ハンドシェークオフ\s+1 \s-1flash_screen, flash vb 可視ベル (カーソルは移動しない)\s+1 \s-1form_feed, ff ff ハードコピー端末でのページ排出 (P*)\s+1 \s-1from_status_line, fsl fs ステータス行からの復帰\s+1 \s-1init_1string, is1 i1 端末初期化文字列\s+1 \s-1init_2string, is2 i2 端末初期化文字列\s+1 \s-1init_3string, is3 i3 端末初期化文字列\s+1 \s-1init_file, if if is を含むファイルの名前\s+1 \s-1init_prog, iprog iP 初期化プログラムのパス名\s+1 \s-1initialize_color, initc Ic 色定義の初期化\s+1 \s-1initialize_pair, initp Ip 色ペアの初期化\s+1 \s-1insert_character, ich1 ic 文字の挿入 (P)\s+1 \s-1insert_line, il1 al 空白行の追加 (P*)\s+1 \s-1insert_padding, ip ip 文字挿入の後にパディングを挿入 (P*)\s+1 \s-1key_a1, ka1 K1 キーパッドの左上キー\s+1 \s-1key_a3, ka3 K3 キーパッドの右上キー\s+1 \s-1key_b2, kb2 K2 キーパッドの中央キー\s+1 \s-1key_backspace, kbs kb backspace キーが送出する文字列\s+1 \s-1key_beg, kbeg @1 begin キー\s+1 \s-1key_btab, kcbt kB back tab キー\s+1 \s-1key_c1, kc1 K4 キーパッドの左下キー\s+1 \s-1key_c3, kc3 K5 キーパッドの右下キー\s+1 \s-1key_cancel, kcan @2 cancel キー\s+1 \s-1key_catab, ktbc ka clear-all-tabs キーが送出する データ\s+1 \s-1key_clear, kclr kC clear screen キー または erase キーが送出するデータ\s+1 \s-1key_close, kclo @3 close キー\s+1 \s-1key_command, kcmd @4 command キー\s+1 \s-1key_copy, kcpy @5 copy キー\s+1 \s-1key_create, kcrt @6 create キー\s+1 \s-1key_ctab, kctab kt clear-tab キーが送出するデータ\s+1 \s-1key_dc, kdch1 kD delete character キーが送出する データ\s+1 \s-1key_dl, kdl1 kL delete line キーが送出するデータ\s+1 \s-1key_down, kcud1 kd 下向き矢印キーが送出するデータ\s+1 \s-1key_eic, krmir kM 挿入モードで rmir か smir が送出 するデータ\s+1 \s-1key_end, kend @7 end キー\s+1 \s-1key_enter, kent @8 enter/send キー\s+1 \s-1key_eol, kel kE clear-to-end-of-line キーが送出 するデータ\s+1 \s-1key_eos, ked kS clear-to-end-of-screen キーが送出 するデータ\s+1 \s-1key_exit, kext @9 exit キー\s+1 \s-1key_f0, kf0 k0 f0 ファンクションキー\s+1 \s-1key_f1, kf1 k1 f1 フンクションキー\s+1 \s-1key_f2, kf2 k2 f2 ファンクションキー\s+1 \s-1key_f3, kf3 k3 f3 ファンクションキー\s+1 \s-1key_f4, kf4 k4 f4 ファンクションキー\s+1 \s-1key_f5, kf5 k5 f5 ファンクションキー\s+1 \s-1key_f6, kf6 k6 f6 ファンクションキー\s+1 \s-1key_f7, kf7 k7 f7 ファンクションキー\s+1 \s-1key_f8, kf8 k8 f8 ファンクションキー\s+1 \s-1key_f9, kf9 k9 f9 ファンクションキー\s+1 \s-1key_f10, kf10 k; f10 ファンクションキー\s+1 \s-1key_f11, kf11 F1 F11 ファンクションキー\s+1 \s-1key_f12, kf12 F2 F12 ファンクションキー\s+1 \s-1key_f13, kf13 F3 F13 ファンクションキー\s+1 \s-1key_f14, kf14 F4 F14 ファンクションキー\s+1 \s-1key_f15, kf15 F5 F15 ファンクションキー\s+1 \s-1key_f16, kf16 F6 F16 ファンクションキー\s+1 \s-1key_f17, kf17 F7 F17 ファンクションキー\s+1 \s-1key_f18, kf18 F8 F18 ファンクションキー\s+1 \s-1key_f19, kf19 F9 F19 ファンクションキー\s+1 \s-1key_f20, kf20 FA F20 ファンクションキー\s+1 \s-1key_f21, kf21 FB F21 ファンクションキー\s+1 \s-1key_f22, kf22 FC F22 ファンクションキー\s+1 \s-1key_f23, kf23 FD F23 ファンクションキー\s+1 \s-1key_f24, kf24 FE F24 ファンクションキー\s+1 \s-1key_f25, kf25 FF F25 ファンクションキー\s+1 \s-1key_f26, kf26 FG F26 ファンクションキー\s+1 \s-1key_f27, kf27 FH F27 ファンクションキー\s+1 \s-1key_f28, kf28 FI F28 ファンクションキー\s+1 \s-1key_f29, kf29 FJ F29 ファンクションキー\s+1 \s-1key_f30, kf30 FK F30 ファンクションキー\s+1 \s-1key_f31, kf31 FL F31 ファンクションキー\s+1 \s-1key_f32, kf32 FM F32 ファンクションキー\s+1 \s-1key_f33, kf33 FN F33 ファンクションキー\s+1 \s-1key_f34, kf34 FO F34 ファンクションキー\s+1 \s-1key_f35, kf35 FP F35 ファンクションキー\s+1 \s-1key_f36, kf36 FQ F36 ファンクションキー\s+1 \s-1key_f37, kf37 FR F37 ファンクションキー\s+1 \s-1key_f38, kf38 FS F38 ファンクションキー\s+1 \s-1key_f39, kf39 FT F39 ファンクションキー\s+1 \s-1key_f40, kf40 FU F40 ファンクションキー\s+1 \s-1key_f41, kf41 FV F41 ファンクションキー\s+1 \s-1key_f42, kf42 FW F42 ファンクションキー\s+1 \s-1key_f43, kf43 FX F43 ファンクションキー\s+1 \s-1key_f44, kf44 FY F44 ファンクションキー\s+1 \s-1key_f45, kf45 FZ F45 ファンクションキー\s+1 \s-1key_f46, kf46 Fa F46 ファンクションキー\s+1 \s-1key_f47, kf47 Fb F47 ファンクションキー\s+1 \s-1key_f48, kf48 Fc F48 ファンクションキー\s+1 \s-1key_f49, kf49 Fd F49 ファンクションキー\s+1 \s-1key_f50, kf50 Fe F50 ファンクションキー\s+1 \s-1key_f51, kf51 Ff F51 ファンクションキー\s+1 \s-1key_f52, kf52 Fg F52 ファンクションキー\s+1 \s-1key_f53, kf53 Fh F53 ファンクションキー\s+1 \s-1key_f54, kf54 Fi F54 ファンクションキー\s+1 \s-1key_f55, kf55 Fj F55 ファンクションキー\s+1 \s-1key_f56, kf56 Fk F56 ファンクションキー\s+1 \s-1key_f57, kf57 Fl F57 ファンクションキー\s+1 \s-1key_f58, kf58 Fm F58 ファンクションキー\s+1 \s-1key_f59, kf59 Fn F59 ファンクションキー\s+1 \s-1key_f60, kf60 Fo F60 ファンクションキー\s+1 \s-1key_f61, kf61 Fp F61 ファンクションキー\s+1 \s-1key_f62, kf62 Fq F62 ファンクションキー\s+1 \s-1key_f63, kf63 Fr F63 ファンクションキー\s+1 \s-1key_find, kfnd @0 find キー\s+1 \s-1key_help, khlp %1 help キー\s+1 \s-1key_home, khome kh home キーが送出するデータ\s+1 \s-1key_ic, kich1 kI ins char/enter ins モードキーが 送出するデータ\s+1 \s-1key_il, kil1 kA insert line キーが送出するデータ\s+1 \s-1key_left, kcub1 kl terminal left arrow キーが送出 するデータ\s+1 \s-1key_ll, kll kH home-down キーが送出するデータ\s+1 \s-1key_mark, kmrk %2 mark キー\s+1 \s-1key_message, kmsg %3 message キー\s+1 \s-1key_move, kmov %4 move キー\s+1 \s-1key_next, knxt %5 next キー\s+1 \s-1key_npage, knp kN next-page キーが送出するデータ\s+1 \s-1key_open, kopn %6 open キー\s+1 \s-1key_options, kopt %7 options キー\s+1 \s-1key_ppage, kpp kP previous-page キーが送出する データ\s+1 \s-1key_previous, kprv %8 previous キー\s+1 \s-1key_print, kprt %9 print キー\s+1 \s-1key_redo, krdo %0 redo キー\s+1 \s-1key_reference, kref &1 reference キー\s+1 \s-1key_refresh, krfr &2 refresh キー\s+1 \s-1key_replace, krpl &3 replace キー\s+1 \s-1key_restart, krst &4 restart キー\s+1 \s-1key_resume, kres &5 resume キー\s+1 \s-1key_right, kcuf1 kr terminal right arrow キーが送出 するデータ\s+1 \s-1key_save, ksav &6 save キー\s+1 \s-1key_sbeg, kBEG &9 シフト状態の begin キー\s+1 \s-1key_scancel, kCAN &0 シフト状態の cancel キー\s+1 \s-1key_scommand, kCMD *1 シフト状態の command キー\s+1 \s-1key_scopy, kCPY *2 シフト状態の copy キー\s+1 \s-1key_screate, kCRT *3 シフト状態の create キー\s+1 \s-1key_sdc, kDC *4 シフト状態の delete char キー\s+1 \s-1key_sdl, kDL *5 シフト状態の delete line キー\s+1 \s-1key_select, kslt *6 select キー\s+1 \s-1key_send, kEND *7 シフト状態の end キー\s+1 \s-1key_seol, kEOL *8 シフト状態の end-of-line キー\s+1 \s-1key_sexit, kEXT *9 シフト状態の exit キー\s+1 \s-1key_sf, kind kF scroll-forward/down キーが送出 するデータ\s+1 \s-1key_sfind, kFND *0 シフト状態の find キー\s+1 \s-1key_shelp, kHLP #1 シフト状態の help キー\s+1 \s-1key_shome, kHOM #2 シフト状態の home キー\s+1 \s-1key_sic, kIC #3 シフト状態の insert char キー\s+1 \s-1key_sleft, kLFT #4 シフト状態の left キー\s+1 \s-1key_smessage, kMSG %a シフト状態の message キー\s+1 \s-1key_smove, kMOV %b シフト状態の move キー\s+1 \s-1key_snext, kNXT %c シフト状態の next キー\s+1 \s-1key_soptions, kOPT %d シフト状態の options キー\s+1 \s-1key_sprevious, kPRV %e シフト状態の previous キー\s+1 \s-1key_sprint, kPRT %f シフト状態の print キー\s+1 \s-1key_sr, kri kR scroll-backward/up キーが送出する データ\s+1 \s-1key_sredo, kRDO %g シフト状態の redo キー\s+1 \s-1key_sreplace, kRPL %h シフト状態の replace キー\s+1 \s-1key_sright, kRIT %i シフト状態の right キー\s+1 \s-1key_srsume, kRES %j シフト状態の resume キー\s+1 \s-1key_ssave, kSAV !1 シフト状態の save キー\s+1 \s-1key_ssuspend, kSPD !2 シフト状態の suspend キー\s+1 \s-1key_stab, khts kT set-tab キーが送出するデータ\s+1 \s-1key_sundo, kUND !3 シフト状態の undo キー\s+1 \s-1key_suspend, kspd &7 suspend キー\s+1 \s-1key_undo, kund &8 undo キー\s+1 \s-1key_up, kcuu1 ku terminal up arrow キーが送出 するデータ\s+1 \s-1keypad_local, rmkx ke "keypad transmit" モードから抜ける\s+1 \s-1keypad_xmit, smkx ks "keypad transmit" モードに入る\s+1 \s-1lab_f0, lf0 l0 f0 でない場合、ファンクション キー f0 のラベル\s+1 \s-1lab_f1, lf1 l1 f1 でない場合、ファンクション キー f1 のラベル\s+1 \s-1lab_f2, lf2 l2 f2 でない場合、ファンクション キー f2 のラベル\s+1 \s-1lab_f3, lf3 l3 f3 でない場合、ファンクション キー f3 のラベル\s+1 \s-1lab_f4, lf4 l4 f4 でない場合、ファンクション キー f4 のラベル\s+1 \s-1lab_f5, lf5 l5 f5 でない場合、ファンクション キー f5 のラベル\s+1 \s-1lab_f6, lf6 l6 f6 でない場合、ファンクション キー f6 のラベル\s+1 \s-1lab_f7, lf7 l7 f7 でない場合、ファンクション キー f7 のラベル\s+1 \s-1lab_f8, lf8 l8 f8 でない場合、ファンクション キー f8 のラベル\s+1 \s-1lab_f9, lf9 l9 f9 でない場合、ファンクション キー f9 のラベル\s+1 \s-1lab_f10, lf10 la f10 でない場合、ファンクション キー f10 のラベル\s+1 \s-1label_on, smln LO ソフトラベルオン\s+1 \s-1label_off, rmln LF ソフトラベルオフ\s+1 \s-1meta_off, rmm mo メタモードオフ\s+1 \s-1meta_on, smm mm メタモード(8番目のビット)の オン\s+1 \s-1micro_column_address, mhpa ZY マイクロモードの column_address\s+1 \s-1micro_down, mcud1 ZZ マイクロモードの cursor_down\s+1 \s-1micro_left, mcub1 Za マイクロモードの cursor_left\s+1 \s-1micro_right, mcuf1 Zb マイクロモードの cursor_right\s+1 \s-1micro_row_address, mvpa Zc マイクロモードの row_address\s+1 \s-1micro_up, mcuu1 Zd マイクロモードの cursor_up\s+1 \s-1newline, nel nw 改行 (cr のあとに lf が来る)\s+1 \s-1order_of_pins, porder Ze ソフトウェアビットを印字ヘッドピン に一致させる\s+1 \s-1orig_colors, oc oc 全ての色ペアをリセット\s+1 \s-1orig_pair, op op デフォルトの色ペアを本来のものに する\s+1 \s-1pad_char, pad pc パディング文字 (ナル文字以外)\s+1 \s-1parm_dch, dch DC #1 文字を削除 (PG*)\s+1 \s-1parm_delete_line, dl DL #1 行を削除 (PG*)\s+1 \s-1parm_down_cursor, cud DO カーソルを下に #1 行移動 (PG*)\s+1 \s-1parm_down_micro, mcud Zf マイクロモードの cud\s+1 \s-1parm_ich, ich IC 空白文字を #1 文字挿入 (PG*)\s+1 \s-1parm_index, indn SF #1 行の前進スクロール (PG)\s+1 \s-1parm_insert_line, il AL 空行を #1 行挿入する (PG*)\s+1 \s-1parm_left_cursor, cub LE カーソルを左へ #1 文字分移動 (PG)\s+1 \s-1parm_left_micro, mcub Zg マイクロモードの cul\s+1 \s-1parm_right_cursor, cuf RI カーソルを右へ #1 文字分移動 (PG*)\s+1 \s-1parm_right_micro, mcuf Zh マイクロモードの cuf\s+1 \s-1parm_rindex, rin SR #1 行の後退スクロール (PG)\s+1 \s-1parm_up_cursor, cuu UP カーソルを上へ #1 行動かす (PG*)\s+1 \s-1parm_up_micro, mcuu Zi マイクロモードの cuu\s+1 \s-1pkey_key, pfkey pk ファンクションキー #1 の打鍵 文字列を #2 とする\s+1 \s-1pkey_local, pfloc pl ファンクションキー #1 の実行 文字列を #2 とする\s+1 \s-1pkey_xmit, pfx px ファンクションキー #1 の送信 文字列を #2とする\s+1 \s-1pkey_plab, pfxl xl ファンクションキー #1 に #2 を 送信させ #3 を表示させる\s+1 \s-1plab_norm, pln pn ラベル #1 に文字列 #2 を表示\s+1 \s-1print_screen, mc0 ps 画面の内容を印字させる\s+1 \s-1prtr_non, mc5p pO #1 バイトだけプリンタをオンにする\s+1 \s-1prtr_off, mc4 pf プリンタをオフにする\s+1 \s-1prtr_on, mc5 po プリンタをオンにする\s+1 \s-1repeat_char, rep rp 文字 #1 を #2 回繰り返す (PG*)\s+1 \s-1req_for_input, rfi RF 入力を要求する\s+1 \s-1reset_1string, rs1 r1 端末を完全にリセットしてまともな モードに戻す\s+1 \s-1reset_2string, rs2 r2 端末を完全にリセットしてまともな モードに戻す\s+1 \s-1reset_3string, rs3 r3 端末を完全にリセットしてまともな モードに戻す\s+1 \s-1reset_file, rf rf リセット文字列を持つファイル名\s+1 \s-1restore_cursor, rc rc 最後の sc の位置にカーソルを戻す\s+1 \s-1row_address, vpa cv 垂直方向の絶対座標移動 (行設定) (PG)\s+1 \s-1save_cursor, sc sc カーソル位置を保存 (P)\s+1 \s-1scancode_escape, scesc S7 スキャンコードエミュレーションの ためのエスケープ\s+1 \s-1scroll_forward, ind sf テキストを上にスクロール (P)\s+1 \s-1scroll_reverse, ri sr テキストを下にスクロール (P)\s+1 \s-1select_char_set, scs Zj 文字セットの選択\s+1 \s-1set0_des_seq, s0ds s0 コードセット 0 にシフト (EUC セット 0, ASCII)\s+1 \s-1set1_des_seq, s1ds s1 コードセット 1 にシフト\s+1 \s-1set2_des_seq, s2ds s2 コードセット 2 にシフト\s+1 \s-1set3_des_seq, s3ds s3 コードセット 3 にシフト\s+1 \s-1set_a_background, setab AB ANSI エスケープシーケンスを使って 背景色を設定\s+1 \s-1set_a_foreground, setaf AF ANSI エスケープシーケンスを使って 前景色を設定\s+1 \s-1set_attributes, sgr sa ビデオ属性を定義 (PG9)\s+1 \s-1set_background, setb Sb 現在の背景色を設定\s+1 \s-1set_bottom_margin, smgb Zk 現在行を下マージンに設定\s+1 \s-1set_bottom_margin_parm, smgbp Zl 最下行を #1 行目か下から #2 行目 にする\s+1 \s-1set_color_band, setcolor Yz リボンの色を #1 に変更\s+1 \s-1set_color_pair, scp sp 現在の色のペアを設定\s+1 \s-1set_foreground, setf Sf 現在の前景色を設定\s+1 \s-1set_left_margin, smgl ML 左マージンを現在行で設定\s+1 \s-1set_left_margin_parm, smglp Zm 左 (右) マージンを桁 #1 (#2) に 設定\s+1 \s-1set_lr_margin, smglr ML 左右両マージンを設定\s+1 \s-1set_page_length, slines YZ ページ長を #1 行に設定 (tparm 使用)\s+1 \s-1set_right_margin, smgr MR 右マージンを現在桁に設定\s+1 \s-1set_right_margin_parm, smgrp Zn 右マージンを桁 #1 に設定\s+1 \s-1set_tab, hts st 全行のタブを現在の桁に設定\s+1 \s-1set_tb_margin, smgtb MT 上下両マージンを設定\s+1 \s-1set_top_margin, smgt Zo 現在行を上マージンに設定\s+1 \s-1set_top_margin_parm, smgtp Zp 上マージンを行 #1 に設定\s+1 \s-1set_window, wind wi 現在のウインドウを行 #1-#2 桁 #3-#4 とする\s+1 \s-1start_bit_image, sbim Zq ビットイメージグラフィック印字の 開始\s+1 \s-1start_char_set_def, scsd Zr 文字セット定義の開始\s+1 \s-1stop_bit_image, rbim Zs ビットイメージグラフィック印字の 終了\s+1 \s-1stop_char_set_def, rcsd Zt 文字セット定義の終了\s+1 \s-1subscript_characters, subcs Zu 下付き文字となりうる文字の リスト\s+1 \s-1superscript_characters, supcs Zv 上付き文字となりうる文字の リスト\s+1 \s-1tab, ht ta 8文字分のハードタブストップの タブ文字\s+1 \s-1these_cause_cr, docr Zw CR を引き起こす文字\s+1 \s-1to_status_line, tsl ts ステータス行の桁 #1 に移動\s+1 \s-1underline_char, uc uc 文字 1 つに下線を付け、次の文字に 移動\s+1 \s-1up_half_line, hu hu 半行上へ (1/2 逆改行)\s+1 \s-1xoff_character, xoffc XF XON 文字\s+1 \s-1xon_character, xonc XN XOFF 文字\s+1 .TE (以下の文字列ケーパビリティは、SVr4.0 の term 構造体に存在していますが、 マニュアルで今だに説明がなされていません。以下のコメントは term 構造体ヘッ ダから取りました。) .TS center; l l l l. \s-1label_format, fln Lf ??\s+1 \s-1set_clock, sclk SC 時計を設定\s+1 \s-1display_clock, dclk DK 時計を表示\s+1 \s-1remove_clock, rmclk RC 時計を削除??\s+1 \s-1create_window, cwin CW ウィンドウ #1 を #2, #3 から #4, #5 までと定義\s+1 \s-1goto_window, wingo WG ウィンドウ #1 に移動\s+1 \s-1hangup, hup HU 電話をハングアップする\s+1 \s-1dial_phone, dial DI 番号 #1 にダイアルする\s+1 \s-1quick_dial, qdial QD 進行確認なしで電話番号 #1 にダイアルする\s+1 \s-1tone, tone TO タッチトーンダイアルを選択\s+1 \s-1pulse, pulse PU パルスダイアルを選択\s+1 \s-1flash_hook, hook fh スイッチフックをフッキングする\s+1 \s-1fixed_pause, pause PA 2-3 秒待つ\s+1 \s-1wait_tone, wait WA ダイアルトーンを待つ\s+1 \s-1user0, u0 u0 ユーザ文字列 # 0\s+1 \s-1user1, u1 u1 ユーザ文字列 # 1\s+1 \s-1user2, u2 u2 ユーザ文字列 # 2\s+1 \s-1user3, u3 u3 ユーザ文字列 # 3\s+1 \s-1user4, u4 u4 ユーザ文字列 # 4\s+1 \s-1user5, u5 u5 ユーザ文字列 # 5\s+1 \s-1user6, u6 u6 ユーザ文字列 # 6\s+1 \s-1user7, u7 u7 ユーザ文字列 # 7\s+1 \s-1user8, u8 u8 ユーザ文字列 # 8\s+1 \s-1user9, u9 u9 ユーザ文字列 # 9\s+1 \s-1get_mouse, getm Gm curses がボタンイベントを取得すべき\s+1 \s-1key_mouse, kmous Km ??\s+1 \s-1mouse_info, minfo Mi マウス状態の情報\s+1 \s-1pc_term_options, pctrm S6 PC 端末オプション\s+1 \s-1req_mouse_pos, reqmp RQ マウス位置報告の要求\s+1 \s-1zero_motion, zerom, Zx 次の文字表示を移動無しで行う\s+1 .TE .PP .B エントリの例 .PP 以下のエントリ(Concept\-100について記述したもの)は、ここで説明している .I terminfo ファイルの中でも複雑な部類のエントリの 1 つです。 .PP .nf .in -2 .ta .3i .ft CW \s-2concept100\||\|c100|\|\|concept\||\|c104\||\|c100-4p\||\|concept 100, am, bel=^G, blank=\eEH, blink=\eEC, clear=^L$<2*>, cnorm=\eEw, cols#80, cr=^M$<9>, cub1=^H, cud1=^J, cuf1=\eE=, cup=\eEa%p1%' '%+%c%p2%' '%+%c, cuu1=\eE;, cvvis=\eEW, db, dch1=\eE^A$<16*>, dim=\eEE, dl1=\eE^B$<3*>, ed=\eE^C$<16*>, el=\eE^U$<16>, eo, flash=\eEk$<20>\eEK, ht=\et$<8>, il1=\eE^R$<3*>, in, ind=^J, .ind=^J$<9>, ip=$<16*>, is2=\eEU\eEf\eE7\eE5\eE8\eEl\eENH\eEK\eE\e200\eEo&\e200\eEo\e47\eE, kbs=^h, kcub1=\eE>, kcud1=\eE<, kcuf1=\eE=, kcuu1=\eE;, kf1=\eE5, kf2=\eE6, kf3=\eE7, khome=\eE?, lines#24, mir, pb#9600, prot=\eEI, rep=\eEr%p1%c%p2%' '%+%c$<.2*>, rev=\eED, rmcup=\eEv $<6>\eEp\er\en, rmir=\eE\e200, rmkx=\eEx, rmso=\eEd\eEe, rmul=\eEg, rmul=\eEg, sgr0=\eEN\e200, smcup=\eEU\eEv 8p\eEp\er, smir=\eE^P, smkx=\eEX, smso=\eEE\eED, smul=\eEG, tabs, ul, vt#8, xenl,\s+2 .in +2 .fi .ft R .PP 2行目以後の行先頭に空白類文字を置くことで、エントリを複数行に分けて継続 して書くことができます。行先頭に ``#'' を置くことでコメントを置くことが できます。 .I terminfo のケーパビリティには、3つの型があります。ブール型(boolean) ケーパビリティは、その端末がある特性を有しているかどうかを表します。数値型 ケーパビリティは、その端末の大きさや、ある機能の遅れの大きさを指定します。 文字列ケーパビリティは、端末のある機能を実行させる際に用いるシーケンス を指定します。 .PP .B ケーパビリティの型 .PP 全てのケーパビリティには名前があります。例えば、Concept が .I "自動マージン" (つまり、行の端に到達すれば自動的に復帰改行がなされること)を有すること は、ケーパビリティ \fBam\fR で表されます。 数値ケーパビリティの後には文字 `#' が続き、そして値が続きます。 \fBcols\fR は、その端末 の桁数を表しており、Concept では、この値は `80' であることを示します。 .PP 最後に、文字列ケーパビリティは、\fBel\fR (行末まで消去するシーケンス) などのように、2 文字のコードと、 `=' と、その先の `,' までの間の文字列 とで表されます。ミリ秒単位の遅延は、\fBel\fP=\eEK$<3> のように、 ケーパビリティのどの場所でも $<..> のブラケットで囲んで置くことができます。 この遅延を与えるためのパディングは、関数 .I tputs が行います。 遅延は数値(例えば `20' のような)もしくは、数値の後に `*' を付けたもの (例えば `3*' のような)で指定します。`*' は、パディングをその処理で影響 を受ける行の行数に比例させる必要があること、そしてその総計は影響を受け る 1 単位あたりの必要パディングにより決まることを表します。(文字挿入の場 合、乗数は影響を受ける .IR 行 の数です。端末が \fBxenl\fP を持たないか、持っていてもソフトウェアがそ れを使用しない場合は常に、この乗数は 1 になります。) `*' を指定する場合、`3.5' のような形式によって、ミリ秒の 1/10 単位(1桁 のみ可能)で遅延を指定することが適切な場合もあるでしょう。 .PP 文字列ケーパビリティの中で、文字のエンコードを簡単にするために、いくつ かのエスケープシーケンスが利用できます。\fB\eE\fR と \fB\ee\fR はとも に、\s-1ESCAPE\s0 文字にマップされます。\fB^x\fR は、任意の x に関して control-x にマッピングされます。\fB\en \el \er \et \eb \ef \es\fR はそ れぞれ、改行、ラインフィード、復帰、タブ、バックスペース、フォームフィード、 空白にマップされます。その他に、\e^ は^ に、\e\e は \e に、\e, は コンマに、 \e: は : に、\e0 はナル文字にマップされます。(\e0 は \e200 を 生成します。これは文字列を終端しませんが、ほとんどの端末でナル文字と同 様の挙動を示すからです。) 最後に、\fB\e\fR の後に 8 進桁 3 桁を指定し て文字を表すこともできます。 .PP あるケーパビリティをコメントアウトせねばならない場合があります。そうい う場合は、ケーパビリティ名の前にピリオドを置いてください。上の例の 2 番目の .B ind がその例です。 .br .ne 5 .PP .B 端末記述の準備 .PP ここでは、どのようにして端末の記述を整えるかの概略を説明します。もっと も効率的なやり方は、 .I terminfo の中から類似の端末の記述を探してそれをまねて作成することです。さらに、 .I vi などのスクリーンエディタに書き掛けの記述を使わせてみて、 その記述が正しいかどうかをチェックしながら、 記述を徐々に作り上げてゆくことです。 通常のものとあまりにもかけ離れた端末の場合、 .I terminfo ファイルの記述能力の欠陥、もしくはテストプログラムの画面操作のコードの バグを明らかにしてくれるかもしれないので、それには注意してください。 端末の記述を新しく用意したとき、それを簡単にテストするには、環境変数 TERMINFO に、作業中の記述をコンパイルしたものを含むディレクトリのパス名 を設定します。これにより、プログラムは .IR \*d を参照する代りにそちらを参照するようになります。 (端末メーカが文書に書いてくれていない場合に)行の右挿入の際のパディング を得るには、/etc/passwd を 9600 ボーで編集し、画面の中ほどで 16 行程 度を削除してから、 `u' キーを数度すばやく連打するという厳しいテストを行 うとよいでしょう。 端末がぐちゃぐちゃになるのなら、普通は、もう少しパディングが必要 だということです。文字挿入についても似たようなテストを行うことができま す。 .PP .B 基本的なケーパビリティ .PP 端末の各行の桁数は数値型ケーパビリティ \fBcols\fR で指定します。端末が \s-1CRT\s0 の場合、画面の行数はケーパビリティ \fBlines\fR で指定します。 カーソルが右マージンに達したときに次の行の左端に回り込む場合、 ケーパビリティ \fBam\fR を指定する必要があります。端末が、画面消去後 カーソルをホームポジションにもってゆくことができる場合、その機能は文字列 ケーパビリティ \fBclear\fR で指定します。端末が(ある文字を上に出力した時に その場所を消去するのではなく)重ね打ちする場合、ケーパビリティ \fBos\fR を指定する必要があります。印字端末で、ソフトコピー装置を持たない場合、 .B hc と .BR os とを指定します。 .RB ( os は、ハードコピー端末や、 APL 端末だけでなく、\s-1TEKTRONIX\s+1 4010 シリーズのようなストレージスコープ管端末にも適用されます。) 現在の行の左端にカーソルを移動させるコードが存在する場合、それを .BR cr で指定します。 (通常、これは復帰文字、つまり control-M になります。) 可聴シグナル(ベル、ビープ音など)を生成するコードがある場合、それを .BR bel で指定します。 .PP カーソルを(バックスペースのように) 1 ポジションだけ左へ移動させるコード がある場合、それは .BR cub1 として指定します。 同様に、右への移動、上への移動、下への移動はそれぞれ、 .BR cuf1 , .BR cuu1 , .BR cud1 で指定します。 これらの局所的カーソル移動機能は、通過する場所のテキストを変更するもの であってはなりません。たとえば、空白文字はその下のテキストを消去してし まうため、普通は `\fBcuf1\fP=\ ' とは指定しません。 .PP ここで極めて重要なこととして、 .I terminfo にエンコードされた局所的カーソル移動は、\s-1CRT\s0 端末の左端および 上端では定義 されないということです。プログラムは、 .B bw の指定がない限り、左端でバックスペースを出力しようとしてはいけません。 また、画面上端で、上に移動しようとしてはいけません。テキストを上に スクロールするためには、プログラムは画面左下隅にカーソルを移動させて、 .B ind (index) 文字列を送出してください。 .PP テキストを下にスクロールするには、プログラムは画面左上隅にカーソルを移 動させて、 .B ri (reverse index) 文字列を送出してください。 文字列 .B ind と .B ri の挙動は、それぞれ先に述べた画面隅にカーソルがない場合には定義されませ ん。 .PP スクロールシーケンスのパラメータ付きバージョンは、 .B indn と .B rin で、これらは、スクロールする行数を指定するパラメータを1つ取ることを除 いては .B ind や .B ri と、同じ挙動を示します。 これらも、カーソルが適切な画面端に存在しない場合の挙動は定義されません。 .PP ケーパビリティ \fBam\fR は、右端でテキストが出力されてもカーソルが右端 に留まり続けるかどうかを示します。ただし、この挙動は最終桁での .B cuf1 の挙動には必ずしも適用されません。 左端からの局所的移動で定義されたものは、 .B bw が指定されている場合に、左端からの .B cub1 が 1 つ前の行の右端に移動するということだけです。 .B bw が指定されていない場合、この効果は定義されません。 これは、例えば、画面の端に沿って箱を描くときに便利なものです。 端末が自動マージン機能を切り替え可能な場合、 .I terminfo ファイルでは、通常はその機能はオン状態、つまり \fBam\fR であると想定し ます。 端末が次の行の先頭桁に移動するコマンドを持つ場合、そのコマンドを .B nel (newline) で指定することができます。 このコマンドは、現在行の残りの部分を消去するかどうかとは関係ありません。 ですから、端末が、 .B cr も .B lf も持たない場合でも、これらの代りに .B nel を利用して仕事をこなすことが可能です。 .PP これまで紹介したケーパビリティで、ハードコピー端末や、\*(lqブラウン管 テレタイプ(glass-tty)\*(rq を十分記述できます。ここで、model 33 teletype は、 .PP .DT .nf .ft CW .in -7 \s-133\||\|tty33\||\|tty\||\|model 33 teletype, bel=^G, cols#72, cr=^M, cud1=^J, hc, ind=^J, os,\s+1 .in +7 .ft R .PP と記述されます。一方、Lear Siegler 社 \s-1ADM\-3\s0 は、 .PP .DT .nf .ft CW .in -7 \s-1adm3\||\|3\||\|lsi adm3, am, bel=^G, clear=^Z, cols#80, cr=^M, cub1=^H, cud1=^J, ind=^J, lines#24,\s+1 .in +7 .ft R .fi .PP と記述されます。 .PP .B パラメータ化された文字列 .PP カーソル位置設定など、パラメータを必要とする文字列は、 .IR printf (3S) 風のエスケープ \fB%x\fR を含むパラメータ化文字列ケーパビリティを用いて 記述します。例えば、カーソル位置を指定する .B cup ケーパビリティは、移動先の行と桁を指定する2つのパラメータを与える必要が あります。 (行と桁は 0 から数え、ユーザに見える物理画面を参照します。目に見えない メモリ部分は参照しません。) 端末がメモリ相対のカーソル位置指定機能を持 つ場合、これは .BR mrcup で表します。 .PP パラメータ渡し機構では、スタックと、それを操作する特別の \fB%\fP コード を用います。通常は、シーケンスはパラメータを 1 つスタックにプッシュし、 それをある形式で出力します。もっと複雑な操作が必要なこともしばしばあり ます。 .PP \fB%\fR コードには以下の意味があります。 .PP .DT .nf .ta .5i 1.5i \s-1%% `%' を出力する %d pop() を printf のように出力する %2d pop() を %2d のように出力する %2d pop() を %3d のように出力する %02d %03d これらは printf と同様 %c pop() を %c に適用する %s pop() を %s に適用する %p[1-9] i 番目のパラメータをプッシュする %P[a-z] pop() を変数 [a-z] に設定する %g[a-z] 変数 [a-z] の値をプッシュする %'c' 文字定数 c %{nn} 整数定数 nn %+ %- %* %/ %m 算術演算 (%m は剰余): push(pop() op pop()) %& %| %^ ビット演算: push(pop() op pop()) %= %> %< 論理演算: push(pop() op pop()) %! %~ 単項演算 push(op pop()) %i 最初の2パラメータに1足す (ANSI 端末用) %? expr %t thenpart %e elsepart %; if-then-else, %e elsepart はオプショナル else-if は Algol 68 風に指定可能: %? c\d1\u %t b\d1\u %e c\d2\u %t b\d2\u %e c\d3\u %t b\d3\u %e c\d4\u %t b\d4\u %e %; \s+1 c\di\u は条件節で、b\di\u は本体 .fi .PP 2 項演算は、通常の順序で並べたオペランドに対して後置形式で指定します。 例えば、x-5 を得るには、"%gx%{5}%-" を指定します。 .PP HP2645 の例を考えてみましょう。これで 3行12桁に移動させるには、 \eE&a12c03Y に 6 ミリ秒のパディングを送出する必要があります。ここで行と 桁とが逆になっていること、行、桁とも 2 桁で出力されていることに注意して ください。この端末の \fBcup\fR ケーパビリティは、 \*(lqcup=\eE&%p2%2dc%p1%2dY$<6>\*(rq となります。 .PP Microterm 社 \s-1ACT-IV\s0 は、\fB^T\fR の後に現在の行と桁を、どち らも単にバイナリ値で送る必要がありますが、\*(lqcup=^T%p1%c%p2%c\*(rq と なります。 \*(lq%c\*(rq を使う端末は、カーソルを前方に戻す (\fBcub1\fR) ことと、画 面上で 1 行上にカーソルを移動させる (\fBcuu1\fR) ことができる必要があり ます。 これは、システムが変更したり握りつぶしたりする可能性があるため、 \fB\en\fR, \fB^D\fR, \fB\er\fR を確実に送信できるとは限らないからです。 terminfo を扱うライブラリルーチンは、タブが決して展開されないように端末 モードを設定します。ですから \et は確実に送信できます。これは Ann Arbor 4080 では重要なことが分っています。) .PP 最後の例は、\s-1LSI ADM\s0-3a です。これは行と桁を空白文字に対する オフセットで表します。ですから、\*(lqcup=\eE=%p1%' '%+%c%p2%' '%+%c\*(rq と なります。`\eE=' を送出した後、最初のパラメータをプッシュし、空白文字の ASCII 値 (32) をプッシュし、それらを加えて (それらの2つの値の代りにその 和をスタックにプッシュし)、得た値を文字として出力します。その後、2番目 のパラメータについても同様の処理を行います。スタックを使うことで、さら に複雑な計算も可能です。 .PP 端末が行や桁の絶対カーソル位置指定機能を持つ場合、単一パラメータを取る ケーパビリティ .B hpa (水平絶対位置) と .B vpa (垂直絶対位置) で指定します。 (hp2645 のような)一般的な 2 パラメータのシーケンスよりもこれらの方が短く なる場合がときどきあり、その場合、 .B cup よりもそれらを使う可能性があります。 パラメータ化された局所的移動機能が存在する (例えば、 .I n 桁右へ移動する) 場合、これらは、いくつ移動するかを指定するパラメータを 1 つ持つ .BR cud , .BR cub , .BR cuf , .BR cuu を使って指定することができます。 これらは主に、\s-1TEKTRONIX\s+1 4025 のように端末が .BR cup を持たない場合に有益です。 .PP .\"=.B Cursor Motions .B カーソル移動 .PP カーソルを高速にホームポジション(画面の左上隅)に移動させる方法を持つ 端末の場合、これを \fBhome\fR で指定することができます。同様に、高速に 左下隅に移動させる方法を持つ場合も \fBll\fR で指定することができます。 端末によっては、ホームポジションから \fBcuu1\fR を使って上に移動する ことでこの動作が可能な場合もありますが、プログラムは、(\fBll\fR でそう指定しない限り)自分からそうしてはならないことになっています。これは、 ホームポジションから上に移動した場合の動作について、プログラムは一切 想定できないからです。ホームポジションは位置指定 (0,0)、つまり、(メモリ ではなく)画面の左上隅と等しいことに注意してください。(ですから、HP 端末の \eEH シーケンスは .BR home として使用できません。) .PP .B 領域消去 .PP 端末がカーソルを動かさずに現在位置から行の末端まで消去可能である場合、 これを\fBel\fR で指定しなければなりません。端末が現在位置から画面の終り までを消去可能な場合、これを \fBed\fR で指定しなければなりません。 \fBed\fR は行の第1桁から行う場合のみ定義されます。(ですから、 .B ed が利用できない場合でも、大量の行削除リクエストを使ってシミュレート可能です。) .PP .B 行の挿入/削除 .PP カーソルのある行の前に空白行を新規につくることができる端末の場合、これ を \fBil1\fR で指定する必要があります。これは行の先頭位置で行う場合のみ 定義されます。作成後、カーソルは新しくできた空白行に置かれなければなり ません。端末がカーソルがある行を削除できる場合、これを \fBdl1\fR で指定 する必要があります。この機能は削除される行の先頭でのみ行われます。 .B il1 と .B dl1 の変種で、挿入/削除する行数を表すパラメータを 1 つ取るものは、 .B il と .BR dl とで指定することができます。 (vt100 のように)スクロール領域を設定可能な端末の場合、領域設定コマンドを .B csr ケーパビリティを用いて指定可能です。 このケーパビリティは2つのパラメータ(スクロール領域の先頭行と最終行)を 取ります。困ったことに、このコマンド実行後のカーソル位置は定義されません。 このコマンドを用いて、行の挿入/削除の効果を得ることが可能です。ここで、 .B sc と .B rc (カーソルの保存と回復)コマンドもまた有用でしょう。 まともな行挿入/削除コマンドを持たない端末で、画面の最上端もしくは最下端 で行を挿入する場合、 .B ri もしくは .B ind を使って行うこともできます。まともな行挿入/削除コマンドを持つ場合でも、 これらを使う方が速い場合もあるかもしれません。 .PP メモリの一部にウインドウ(全てのコマンドが影響する)を定義することがで きる端末の場合、それは、パラメータ化文字列 .BR wind で指定する必要があります。 メモリ中での開始行、終了行、開始桁、終了桁を表す 4 パラメータは、この 順番で与えます。 .PP 上側の表示メモリを保持できる端末の場合、\fBda\fR ケーパビリティを指定す る必要があります。下側の表示メモリを保持できる場合、\fBdb\fR を指定する 必要があります。これらは、行削除やスクロールにより、画面最下端に非空白行が 上がってくること、および、\fBri\fR による逆スクロールにより非空白行 が下がってくることを表します。 .PP .B 文字の挿入/削除 .PP .I terminfo で記述可能な文字の挿入/削除に関して、基本的には 2 種類の インテリジェント端末があります。 もっとも標準的な文字挿入/削除機能は、現在行の文字のみが影響を受け、 シフトした文字は一体となって移動し行端で消えて行くものです。その他の 端末、例えば Concept 100 や Perkin Elmer Owl のようなものの場合、表示 出力された空白とそうでない空白との間に区別があります。挿入/削除にともな うシフトは画面上の表示出力されていない空白に対してのみ適用され、それぞ れ空白の消滅、もしくは表示出力されていない空白2つになります。自分が持っ ている端末がどちらのタイプかを調べるには、画面を消去してから、(カーソル 移動を用いて)テキストを2箇所に分けて出力します。\*(lqabc\*(rq と \*(lqdef\*(rq の間に(空白文字でなく)局所的カーソル移動を用いて \*(lqabc\ \ \ \ def\*(rq を出力してください。その後、カーソルを \*(lqabc\*(rq の前に移動させ、端末を挿入モードにします。 文字を打ち込むと、行の残りが一体となってシフトして行の端で文字がこぼれ おちてゆくならば、この端末は表示出力された空白とそうでない空白を区別し ないタイプのものです。\*(lqabc\*(rq がシフトして \*(lqdef\*(rq に当り、 その後はそれらが一緒に行の端まで進み、次の行まで進むならば、この端末は2 番目のタイプのもので、\*(lqinsert null\*(rq を表すケーパビリティ \fBin\fR を指定する必要があります。論理的には、これらは別の属性(挿入モード が1行か複数行か、および、表示出力されていない空白を特別扱いするか否か) ですが、挿入モードをこの属性 1 つで記述できない端末に、今までお目にかかっ たことはありません。 .PP terminfo では、挿入モードを持つ端末も、現在行の上で場所を空ける短い シーケンスを送る端末も、両方ともに記述することができます。挿入モードに 入る シーケンスは \fBsmir\fR で、挿入モードから出るシーケンスは \fBrmir\fR で指定 してください。挿入したい文字の直前にあるシーケンスを送出する必要がある場 合は \fBich1\fR で指定してください。ちゃんとした挿入モードを持つ端末のほ とんどでは、\fBich1\fR を指定することはないでしょう。一方、画面上で場所 を空けるシーケンスを送る端末の場合は、必ず \fBich1\fR を指定してください。 (両方持つ端末の場合、通常は \fBich1\fR よりも挿入モードの方が望ましいで しょう。実際に両方を組み合わせて使用する必要がある場合以外は、両方同時に 指定しないでください。) 挿入後のパディングが必要な場合、文字列オプション \fBip\fR に必要なミリ秒 の数を指定してください。その他のシーケンスで文字1文字を挿入後に送出する 必要のあるものを、いっしょに \fBip\fR で指定することもできます。 「挿入モード」に入り、 かつ挿入する文字ごとにあるコードを付けて送出しなければならない端末の場合、 .BR smir / rmir と .B ich1 とを両方とも指定してください。そうすることで、それらが使われるようになり ます。 ケービリティ .B ich は、パラメータ .IR n 1つを取り、これは .B ich1 の動作を .I n 回繰り返します。 .PP 挿入モード途中で同じ行の文字を削除するために、カーソルを動かす必要がある 場合があります(例えば、挿入位置の後にタブがある場合)。挿入モードに入っ たままでカーソルを移動させることができる場合、このような場合の挿入を高速 に行うために、ケーパビリティ \fBmir\fR を指定することができます。 \fBmir\fR を省略しても、影響を受けるのは速度のみです。端末によっては(有名な Datamedia のアレとか)、挿入モードの動作方法の違いにより \fBmir\fR を 指定してはいけないものがあります。 .PP 最後に、文字1文字の削除用として .B dch1 を、 .IR n 文字削除用として、パラメータ1つをとる .B dch を、 そして、削除モード用として \fBsmdc\fR と \fBrmdc\fR を、それぞれ 削除モード ( .B dch1 が動作するために、端末が入っていなければならないモード) へ入るシーケンス と出るシーケンスとして指定することができます。 .PP .I n 文字を削除する(カーソルを移動させずに空白を .I n 個出力することと同等の処理)ためのコマンドは、パラメータを 1つとる .B ech を使って指定することができます。 .PP .\" .B "Highlighting, Underlining, and Visible Bells" .B "ハイライト・下線・可視ベル" .PP 端末が1つまたはそれ以上の表示属性を持つ場合、これらを表す方法として異なっ たやり方がいくつかあります。エラーメッセージや他の種類の注意を引くメッセージ に適した、十分コントラストが高く目立つ形式から1つ、\f2強調モード\fR を 選択してください。(選ぶなら、反転表示に半輝度を加えたもの、もしくは単に 反転のみが良いでしょう。)強調モードに入るシーケンス、出るシーケンスはそ れぞれ \fBsmso\fR と \fBrmso\fR で指定します。TVI 912 や Teleray 1061 の ように、強調モードへの出入りにより画面に空白が1つ2つ残る場合、\fBxmc\fR を指定して空白がいくつ残るかを教えてやる必要があります。 .PP 下線引きを開始するコード、終了するコードは、それぞれ \fBsmul\fR と \fBrmul\fR で指定します。Microterm 社の Mime のように、現在位置の文字に 下線を引き、空白1つ分カーソルを右に移動するコードを持つ端末の場合、その コードを \fBuc\fR で指定することができます。 .PP その他もろもろの強調モードに入るケーパビリティには、 .B blink (点滅) .B bold (ボールドもしくは更に明るい) .B dim (暗いもしくは半輝度) .B invis (空白もしくは見えないテキスト) .B prot (保護状態) .B rev (反転表示) .B sgr0 ( .I 全ての 属性モードをオフにする) .B smacs (別の文字セットモードに入る) .B rmacs (別の文字セットモードから出る)が含まれます。 これらのモードのどれか1つをオンにした場合に、他のモードがオフになる場合 もありますし、ならない場合もあります。 .PP モードの任意の組み合わせを設定するシーケンスが存在する場合、それを 9つのパラメータを持つ .B sgr (属性の設定)で指定します。 パラメータのそれぞれは、0 または 1 を取ります。それぞれ対応する属性が オンかオフかを表します。9つのパラメータとは、順に:強調、下線、反転表示、 点滅、暗い表示、ボールド、空白、保護、別の文字セットです。必ずしも全ての モードが .BR sgr によってサポートされねばならない必要性はありません。 独立した属性コマンドが存在するものだけで構いません。 .PP 「魔法のクッキー(magic cookie)」 .RB ( xmc ) を持つ端末では、 モード設定シーケンスを受信すると特殊な「クッキー」と呼ぶべきゴミを 画面に残します。この端末では、モード設定シーケンスは、各文字に余分のビット を持たせるのではなく、表示アルゴリズムそのものに影響を与えます。 HP 2621 などのような端末では、次の行へ移動したり、カーソルを移動させたり した際に強調モードから勝手に抜け出てしまいます。プログラムで強調モードを 用いる場合、 .B msgr ケーパビリティの指定が無い場合は、カーソルを移動させたり改行文字を送出す る前に強調モードから脱出して、プログラム内部で強調モードでのカーソル移動 がないことを確実にしておかねばなりません。 .PP エラー発生を無音で(ベルの代わりに)通知するため、画面をフラッシュさせる 方法が提供されている端末の場合、それを \fBflash\fR で指定することがで きます。これはカーソルを移動させてはなりません。 .PP カーソルが最下行にないときに通常の状態以上に見易くする(例えば、点滅しな い下線カーソルを、より見つけやすいブロックカーソルや点滅下線カーソルにす る)必要がある場合、そのシーケンスを .BR cvvis で指定してください。 カーソルを完全に見えないようにする方法がある場合、それを .BR civis で指定してください。 これらのモードを打ち消す効果を持つシーケンスとして、ケーパビリティ .BR cnorm を指定しなければなりません。 .PP これらのケーパビリティを使用するプログラムを実行する際に、端末を特殊なモード にする必要がある場合、このモードに入るコード、出るコードをそれぞれ \fBsmcup\fR と \fBrmcup\fR で指定することができます。こういう事態が生じ る場合として、例えば、Concept のように、複数ページのメモリを持つ端末があ ります。画面相対指定を持たず、メモリ相対のカーソル位置指定機能しか持たな いこの端末の場合、画面の大きさのウィンドウ1枚を端末に固定で割り付け、 カーソル位置指定を適切にできるようにしなければなりません。このケーパビリティ は、\s-1TEKTRONIX\s+1 4025 でも使用されています。こちらでは、 .B smcup で terminfo で使用するものをコマンド文字として設定しています。 .PP たとえ重ね打ちでないとしても、(特殊なコードなしで)下線文字を正しく生成 できる端末の場合、ケーパビリティ \fBul\fR を指定する必要があります。 重ね打ちが空白文字で消去可能な場合、\fBeo\fR を指定してそのことを明らか にしておく必要があります。 .PP .\" .B Keypad .B キーパッド .PP キーを押すとコードを送出するキーパッドを持つ場合、そのキーパッド に関する情報を指定することができます。注意すべき点として、キーパッドが ローカルモードでしか動作しない端末(例えば、シフト状態でない HP 2621 の キーがこれに該当します)を扱うことはできないことがあります。送信状態か 非送信状態かを設定できるキーパッドの場合、それらのためのコードを \fBsmkx\fR と \fBrmkx\fR とで指定することができます。これらの指定がない場合、 キーパッドは常に送信状態として扱われます。 左矢印、右矢印、上矢印、下矢印キー、home キーが送出するコードは、それぞ れ \fBkcub1, kcuf1, kcuu1, kcud1, khome\fR で指定できます。f0, f1, ..., f10 のようなファンクションキーがある場合、これらが送出するコードは \fBkf0, kf1, ..., kf10\fR で指定できます。これらのキーがデフォルトのラベル (f0 から f10 まで)を持たない場合、このラベルを \fBlf0, lf1, ..., lf10\fR で指定できます。他の特殊キーが送出するコードは、以下のように指定 できます。 .B kll (ホームダウン(home down))、 .B kbs (バックスペース(backspace))、 .B ktbc (全タブクリア(clear all tabs))、 .B kctab (この桁のタブストップをクリア)、 .B kclr (画面消去(clear screen)キーまたは抹消(erase)キー)、 .B kdch1 (文字削除(delete character))、 .B kdl1 (行削除(delete line))、 .B krmir (挿入モードから抜ける(exit insert mode))、 .B kel (行末までクリア(clear to end of line))、 .B ked (画面の終りまでクリア(clear to end of screen))、 .B kich1 (文字挿入または挿入モードに入る)、 .B kil1 (行挿入(insert line))、 .B knp (次のページ(next page))、 .B kpp (前のページ(previous page))、 .B kind (前進スクロール(scroll forward)/下降スクロール(scroll down))、 .B kri (後退スクロール(scroll backward)/上昇スクロール(scroll up))、 .B khts (この桁にタブストップを設定)、 更に、キーパッドが4つの矢印を含む 3 × 3 のキー配列を持つ場合、他の 5 つ のキーを .BR ka1 , .BR ka3 , .BR kb2 , .BR kc1 , .BR kc3 で指定します。 3×3のカーソル移動キーパッドが必要な場合、これらのキーが有用です。 .PP .\" .B Tabs and Initialization .B タブと初期化 .PP 端末がハードウェアタブを持つ場合、次のタブストップまでカーソルを進める コマンドを .B ht (通常、control I です)で指定することができます。 左方向の次のタブストップまで進める「後退タブ」コマンドは、 .BR cbt で指定することができます。 端末ドライバが、タブが端末に送出されずにコンピュータ内部で空白に展開され るモードになっている場合、プログラムは、たとえ .B ht や .B cbt が存在しても、それらを使用しないという約束になっています。これは、ユーザ がタブストップを正しく設定していない可能性があるためです。 電源投入時に、 .I n 個の空白ごとにハードウェアタブが初期化されている端末の場合、数値パラメータ .B it を指定します。これはタブとして設定される空白数を表します。 通常、これは .IR tset コマンドが、ハードウェアタブ展開を使用するモード設定と、タブストップ設定 とを行うかどうかを決定するために使用します。 タブストップ設定を不揮発性メモリに記憶できる端末の場合、terminfo での記述の 際に、タブストップは正しく設定されていることを想定して構いません。 .PP 他のケーパビリティとして、 .BR is1 , .BR is2 , .BR is3 があり、これらは端末を初期化する文字列を指定します。また、 .BR iprog があり、これは端末初期化用として実行するプログラムのパス名を指定します。 また、\fBif\fR があり、これは初期化文字列が長い場合、それを含むファイル の名前を指定します。これらの文字列により、terminfo の残りの記述と矛盾な く動作するモードに端末が設定されることが求められます。通常、ユーザが ログインするたびに、 .IR tset プログラムがこれらの文字列を端末に対して送出します。送出は以下の順序で 行われます: まず .BR is1 ; 次に .BR is2 ; そして .B tbc と .BR hts でタブを設定; 次に .BR if ; そして .BR iprog でプログラムを実行; 最後に .BR is3 で終わります。初期化のほとんどは .BR is2 で行われます。 共通のシーケンスを .B is2 に置き、特殊な場合を .B is1 と .BR is3 とに置くことで、文字列をそれぞれに複製して持たせなくても、特殊な端末 モードを設定することができます。 まったくわけのわからない状態から復帰するための、よりハード寄りのリセット を行うためのシーケンスの組を、 .BR rs1 , .BR rs2 , .BR rf , .BR rs3 で指定することができます。これらは .B is2 と .BR if と良く似たシーケンスです。 端末がハマったときに使うプログラムである、 .IR reset がこれらのシーケンスを出力します。 コマンドを .B rs2 と .B rf とに置くのは、普通、ユーザを混乱させる効果を産み出し、かつ ログインの際に必要ない場合に限ります。 例えば、vt100 を 80 桁モードに設定するコマンドは、普通なら .BR is2 に含めるはずですが、 このコマンドは画面に混乱させるゴミを作り出しますし、端末は既に 80 桁モードに なっているのが普通ですので、このコマンドを含める必要ありません。 .PP タブストップの設定、クリアを行うコマンドがある場合、それらを .B tbc (全タブストップのクリア) と .B hts (現在桁にタブストップを設定) に指定することができます。 タブ設定に関して、ここで説明したものより複雑なシーケンスが必要な場合、そ のシーケンスを .B is2 や、 .BR if に置いても構いません。 .PP 遅延 .PP 端末ドライバのパディングを制御するケーパビリティがいくつかあります。まず 第 1 に、ハードコピー端末で必要となります。さらに .IR tset プログラムが、端末ドライバのモードを適切に設定する際にこれらを使用します。 以下のケーパビリティ .BR cr , .BR ind , .BR cub1 , .BR ff , .B tab に遅延を組み込んでおくと、端末ドライバ内部の遅延ビットが適切な値に設定さ れます。 .B pb (パディングボーレート) を指定することで、ボーレートが .BR pb の値より低い場合、これらの遅延指定を無視させることができます。 .PP .B その他 .PP ナル(0)文字以外のパディング文字を必要とする端末の場合、それを \fBpad\fR で指定することができます。 .B pad 文字列の最初の文字のみが使用されます。 .PP 端末が、通常のソフトウェアでは使用されない追加の「ステータス行」を持つ 場合、そのことを表すことができます。ステータス行が最下行より下に余分な 行として見え、通常のカーソル位置指定でそこにカーソルを移動させることが できる場合(Heathkit h19 の 25 行目や、スクロール領域を 23 行に設定した ときの vt100 の 24 行目などのような場合)、ケーパビリティ .B hs を指定する必要があります。 ステータス行の先頭に移動するための特殊な文字列と、ステータス行から戻る ための特殊な文字列は、それぞれ .B tsl と .BR fsl で指定します .RB ( fsl は、 .BR tsl 以前にカーソルがあった位置にカーソルを戻さねばなりません。この効果を出す ために、必要があれば、 .B sc と .B rc 文字列を .B tsl と .B fsl とに含めても構いません。) .B tsl はパラメータを1つ取ります。それは、ステータス行で、カーソル移動先の桁 数です。ステータス行内部でエスケープシーケンスや、他の特殊なコマンド (タブなど)が動作する場合、フラグ .B eslok を指定することができます。 ステータス行をオフにする文字列(または、オフにしないまでもステータス行 の内容を消去する文字列)を、 .BR dsl で指定する必要があります。 カーソル位置の保存および回復を行うコマンドを持つ端末の場合、それらを .B sc と .BR rc とで指定します。 通常、ステータス行は、画面の他の行の幅、つまり、 .BR cols と同じ幅であると仮定されます。 他の行とステータス行の幅が異なる場合(端末がロードされた行全てに移動を許し ていない場合など)、その桁単位の幅を、数値パラメータ .BR wsl で表すことができます。 .PP 端末が半行だけ上下移動できる場合、それを .B hu (半行上)と .B hd (半行下)とで指定することができます。 これは、まず第 1 に、ハードコピー端末で上付き文字、下付き文字を使うた めに用いられます。 ハードコピー端末が用紙を排出し次のページに行くこと (フォームフィード) ができる場合、それを .B ff (通常は control L)で指定します。 .PP (同じ文字を極めて多数回繰り返し送信する際の時間節約のため)指定した文字を 指定した回数だけ繰り返すコマンドが存在する場合、パラメータ化文字列 .BR rep を用いてそれを指定することができます。 1 番目のパラメータは繰り返し送信される文字で、2番目のパラメータは繰り返し 回数です。ですから、tparm(repeat_char, 'x', 10) は `xxxxxxxxxx' と同じこ とです。 .PP \s-1TEKTRONIX\s+1 4025 のように、 コマンド文字を設定可能な端末の場合、 .BR cmdch を用いてそれを表すことができます。 全てのケーパビリティで使用されるプロトタイプコマンド文字を指定できます。 この文字は .B cmdch ケーパビリティで指定され、それが識別されます。 いくつかの UNIX システムでは以下の約束にしたがって処理がなされます: すな わち、まず環境変数 .B CC を検査し、それが設定されている場合は、ケーパビリティ中にあるプロトタイプ 文字の全てがその環境変数で指定された文字と置き換えられます。 .PP .IR switch , .IR dialup , .IR patch , .IR network などのような、特定の端末の種類を表さない端末記述には、プログラムが その端末とどう通信すればよいかが分からないと表明できるようにするた め、 .B gn (一般的)ケーパビリティを指定しなければなりません。(このケーパビリティは、 エスケープシーケンスがわかっている .I 仮想 端末の記述には適用されません。) .PP 端末がフロー制御のための xon/xoff ハンドシェークを使用する場合、 .BR xon を指定します。 プログラムがコストに関してよりよい見積もりを立てることができるように、こ の場合でもパディング情報を指定すべきです。しかし、実際はパディング文字は 送信されません。 .PP 端末が、シフトキーとして動作し、文字全ての8ビット目を立てて送出する 「メタキー」を持つ場合、このことを .BR km により表すことができます。 この指定がない場合、ソフトウェアは、8ビット目はパリティで、通常はクリア されていると想定します。この「メタモード」をオンオフする文字列が存在す る場合、それを .B smm と .BR rmm とで指定することができます。 .PP 端末が画面1枚分より多い行数のメモリを持つ場合、メモリの行数を .BR lm で指定できます。値 .BR lm #0 は、行数は固定でないものの、1画面分以上のメモリを持つことを表します。 .PP 端末が \s-1UNIX\s+1 の仮想端末プロトコルをサポートしている場合、その端末 番号を .BR vt で指定できます。 .PP 端末に接続された外部プリンタを制御するメディアコピー文字列は、次のように 指定できます。すなわち、 .BR mc0 : 画面内容の印字、 .BR mc4 : プリンタオフ、 .BR mc5 : プリンタオンです。 プリンタがオンのとき、端末に送出されたテキストの全てはプリンタに送られま す。プリンタがオンの状態でもなお端末画面が表示されているか否かは未定義で す。変種である .B mc5p はパラメータを1つ取り、そのパラメータの値だけの文字を送る間 プリンタをオンにし続け、そのあとオフにします。 このパラメータは 255 を越えてはなりません。 .BR mc4 を含む全てのテキストは、 .B mc5p が有効な間、透過的にプリンタに渡されます。 .PP プログラムファンクションキーに対する文字列は、 .BR pfkey , .BR pfloc , .BR pfx で指定できます。 これらの文字列それぞれは、2つの引数を取ります: それぞれ、プログラム対象のファンクションキー番号 (0 から 10 まで) と、 そこにプログラムする文字列です。この 範囲外のファンクションキー番号を使うと未定義のキーに対してプログラムして しまうかもしれず、これは端末依存の動作となります。これらのケーパビリティ の違いは以下の通りです: .B pfkey は、そのキーの押し下げを生じ、ユーザが指定した文字列をタイプしたのと同じ 動作になります。 .B pfloc は、端末内部でローカルにその文字列が実行されることになります。 .B pfx は、その文字列がコンピュータに送出されることになります。 .PP .B ゴミ機能、困った機能(Glitches and Braindamage) .PP Hazeltine 端末は `~' 文字を表示できません。これには \fBhz\fR を指定する 必要があります。 .PP Concept や vt100 のように、\fBam\fR 直後の改行文字を無視する端末の場合、 \fBxenl\fR を指定する必要があります。 .PP 強調モードを取り除くため(単に通常のテキストを上に書くだけで済まず) .B el が必要な場合、\fBxhp\fP を指定する必要があります。 .PP Teleray 端末は、タブでカーソル移動した下にあった文字を全て空白にしてしま いますので、この端末では \fBxt\fR (タブは破壊的) を指定する必要があります。 注意: これに対応する変数は、現在は `dest_tabs_magic_smso' ですが、以前の バージョンでは、teleray_glitch でした。このふざけた機能は、「魔法のクッキー」 の先頭にカーソルを置けないことと、強調モードを消去するために、行削除と 行挿入が必要であることも意味します。 .PP Beehive の Superbee 端末は、エスケープ文字や control C 文字を正しく送信 できません。これには .BR xsb を指定し、 f1 キーをエスケープとし、f2 キーを control C として使用することを表します (この問題が現れるのは特定の Superbee に限られ、その ROM に依存します)。注意: terminfo の古いバージョンでは、このケーパビリティ は `beehive_glitch' と呼ばれていましたが、現在では `no_esc_ctl_c' と呼ば れています。 .PP なにか特定の端末に固有の他の問題を解決したい場合、\fBx\fIx\fR の形式で新 しいケーパビリティを追加して使っても構いません。 .PP .B 似た端末 .PP 2 つの非常によく似た端末がある場合、いくつかの例外を除いて一方は他方と似 ているという定義を行うことができます。文字列ケーパビリティ \fBuse\fR で、 そのよく似た端末の名前を指定することができます。 .B use の指定より前に与えたケーパビリティは、 .BR use により得られる端末タイプの中のケーパビリティに優先します。 ケーパビリティ定義の左側に \fBxx@\fR を置くことにより、そのケーパビリティ をキャンセルできます。ここで xx はそのケーパビリティです。例えば、エントリ .PP 2621-nl, smkx@, rmkx@, use=2621, .PP は、\fBsmkx\fR も \fBrmkx\fR も持たない 2621-nl を定義します。つまり、こ の端末は、ビジュアルモードでもファンクションキーラベルを有効にしません。 この機能はある端末の種々の機能や、ユーザの種々のプリファレンスを表す際に 有用です。 .SH 関連ファイル .TP 25 \*d/?/* ファイルに端末記述が含まれています。 .SH 関連項目 tic(1), curses(3), printf(3), term(5). .SH 作者 Pavel Curtis, Zeyd M. Ben-Halim .\" Translated by Norihiro Kumagai (kuma@slab.tnr.sharp.co.jp), 98-5-24 .\"# .\"# The following sets edit modes for GNU EMACS .\"# Local Variables: .\"# mode:nroff .\"# fill-column:79 .\"# End: diff --git a/ja/man/man5/ttys.5 b/ja/man/man5/ttys.5 index 36a61a34c5..660431d84d 100644 --- a/ja/man/man5/ttys.5 +++ b/ja/man/man5/ttys.5 @@ -1,167 +1,167 @@ .\" 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. .\" .\" WORD: line 回線 .\" .\" from: @(#)ttys.5 8.1 (Berkeley) 6/4/93 -.\" jpman $Id: ttys.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: ttys.5,v 1.3 1998/06/17 07:52:43 kumano Stab % .\" %Id: ttys.5,v 1.3.2.3 1997/12/15 07:10:54 charnier Exp % .\" " .Dd November 17, 1996 .Dt TTYS 5 .Os .Sh 名称 .Nm ttys .Nd 端末初期設定情報 .Sh 解説 ファイル .Nm は端末特殊ファイルを初期化したり制御するあらゆるルーチンが使用する 情報を含んでいます。 この情報は .Xr getttyent 3 ライブラリルーチンで読まれます。 .Nm ファイルの中には 1 つのスペシャルデバイスファイルにつき 1 行の記述が あります。 フィールドはタブやスペースにより区切られます。 1 語以上からなるフィールドはダブルクォート (``"'') で括られていなければ なりません。 空行やコメントはファイル中のどこに現れても構いません。 コメントはハッシュ記号 (``#'') および改行によって区切られます。 指定されていないフィールドはデフォルトでナルです。 .Pp 最初のフィールドは .Pa /dev にあるような端末特殊ファイルの名前です。 .Pp 2 番目のフィールドはその回線に対して実行するコマンドで、 通常 .Xr getty 8 です。これは回線を初期化して開くプログラムで、スピードを設定したり、 ユーザ名を待ったり .Xr login 1 プログラムを実行します。 しかしながら、それはどんな希望するコマンド、例えばウィンドウシステム の端末エミュレータやデーモンプロセスの起動コマンドでも構いません。 そして、もしクォートで括られているのなら複数語を含む事もできます。 .Pp 3 番目のフィールドは通常その tty 回線に接続される端末のタイプで、普通 .Xr termcap 5 データベースファイル中に収められています。 環境変数 .Ev TERM は .Xr getty 8 または .Xr login 1 による値に初期化されます。 .Pp 残りのフィールドは .Fa ty_status エントリ .Xr (getttyent 3 参照) 中のフラグを指定したり、その端末回線に対して .Xr init 8 が維持するウィンドウシステムのプロセスを指定したり、 オプションで tty のタイプ (ダイアルインか、ネットワークか、またはそれ以外か) を決定したり、 またログインクラスのデータベース .Xr (login.conf 5 参照) が多くの tty をグループとして参照できるような tty グループ名を指定します。 これはグループとして tty に対して選択的にアクセスを許可または 拒否したりアカウンティング機能を可能または不可能にするためです。 .Pp フラグの値としては、文字列 ``on'' と ``off'' は .Xr init 8 が 2 番目のフィールドで与えられるコマンドを実行するか(しないか)を 指定します。一方 ``secure'' は ( ``on'' も与えられていれば) uid が 0 のユーザがこの回線にログインすることを許可します。 フラグ ``dialin'' は tty エントリがダイアルイン回線であることを 示しており、 ``network'' は tty エントリがネットワーク接続で あることを示しています。 端末タイプのフィールドには、これらの文字列のどちらかが指定できます。 文字列 ``window='' の後には .Xr init 8 が 2 番目のフィールドで指定されるコマンドを開始する .Em 前 に実行するコマンド列をクォートで括って続けます。 .Pp 文字列 ``group='' の後には、 多くの tty 回線をアクセスの許可/拒否やアカウンティング機能の 可能/不可能を決めるためのグループとして参照するために .Xr login.conf 5 で使われる、文字・数字のグループ名を続けます。 何のグループも指定されなかった場合、ttyはグループ "none" に属するように なります。 以前との互換性のために、 ``group='' は行の最後に、任意のコメントのすぐ前 に現れなければなりません。 .Sh 使用例 .Bd -literal # 1200 ボーでコンソール、root でのログイン可 console "/usr/libexec/getty std.1200" vt100 on secure # 1200 ボーでダイアルアップ、root でのログイン不可 ttyd0 "/usr/libexec/getty d1200" dialup on group=dialup # 555-1234 # Mike の端末: hp2621 ttyh0 "/usr/libexec/getty std.9600" hp2621-nl on group=dialup # 457 Evans # John の端末: vt100 ttyh1 "/usr/libexec/getty std.9600" vt100 on group=dialup # 459 Evans # 端末エミュレート/ウィンドウシステム ttyv0 "/usr/new/xterm -L :0" vs100 on window="/usr/new/Xvs100 0" # ネットワーク仮想 tty -- getty は使用しません ttyp0 none network group=pty ttyp1 none network off group=pty .Ed .\" 「使用例」1行目 `root login on ...' .\" 3行目の `no root logins' との対比であるから、 .\" 3行目の訳と対比させて「root でのログイン可」と訳した。 .\" (98/06/17 kumano@jp.freebsd.org) .Sh 関連ファイル .Bl -tag -width /etc/ttys -compact .It Pa /etc/ttys .El .Sh 関連項目 .Xr login 1 , .Xr getttyent 3 , .Xr ttyslot 3 , .Xr gettytab 5 , .Xr login.conf 5 , .Xr termcap 5 , .Xr getty 8 , .Xr init 8 .\".Xr init 8 , .\".Xr ttyflags 8 .Sh 歴史 .Nm ファイルは .At v6 で登場しました。 diff --git a/ja/man/man5/types.5 b/ja/man/man5/types.5 index 5ec2ab555e..7b82d564b0 100644 --- a/ja/man/man5/types.5 +++ b/ja/man/man5/types.5 @@ -1,196 +1,196 @@ .\" 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. .\" .\" @(#)types.5 8.1 (Berkeley) 6/5/93 -.\" jpman $Id: types.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: types.5,v 1.3 1998/07/30 15:28:11 horikawa Stab % .\" %Id: types.5,v 1.3.2.2 1997/02/28 05:53:25 mpp Exp % .\" .Dd June 5, 1993 .Dt TYPES 5 .Os BSD 4 .Sh 名称 .Nm types .Nd システムのデータ型 .Sh 書式 .Fd #include .Sh 解説 ファイル .Pa sys/types.h はカーネル内部で (ほとんどの物はシステム全体を通じて) 用いられる、 定義済みのデータ型を含みます。 .Bd -literal #ifndef _SYS_TYPES_H_ #define _SYS_TYPES_H_ /* 機種に依存するパラメータ。 */ #include #include #ifndef _POSIX_SOURCE typedef unsigned char u_char; typedef unsigned short u_short; typedef unsigned int u_int; typedef unsigned long u_long; typedef unsigned short ushort; /* Sys V との互換性 */ typedef unsigned int uint; /* Sys V との互換性 */ #endif typedef u_int64_t u_quad_t; /* quads */ typedef int64_t quad_t; typedef quad_t * qaddr_t; typedef char * caddr_t; /* コアアドレス */ typedef int32_t daddr_t; /* ディスクアドレス */ typedef u_int32_t dev_t; /* デバイス番号 */ typedef u_int32_t fixpt_t; /* 固定小数点数 */ typedef u_int32_t gid_t; /* グループ ID */ typedef u_int32_t ino_t; /* i ノード番号 */ typedef long key_t; /* IPC キー (Sys V プロセス間通信用) */ typedef u_int16_t mode_t; /* パーミッション */ typedef u_int16_t nlink_t; /* リンクカウント */ typedef _BSD_OFF_T_ off_t; /* ファイルオフセット */ typedef _BSD_PID_T_ pid_t; /* プロセス ID */ typedef int32_t segsz_t; /* セグメントサイズ */ typedef int32_t swblk_t; /* スワップオフセット */ typedef u_int32_t uid_t; /* ユーザ id */ typedef quad_t rlim_t; /* リソースリミット */ #ifdef KERNEL typedef int boolean_t; typedef struct vm_page *vm_page_t; #endif /* * これは unistd.h にあるべきですが、lseek の第 2 引数を off_t にキャスト * しているプログラムが正しい版の lseek を用いることを確実にするために * ここに置かれています。 */ #ifndef KERNEL #include __BEGIN_DECLS off_t lseek __P((int, off_t, int)); __END_DECLS #endif #ifndef _POSIX_SOURCE /* * minor() はインデックスの代わりにクッキーを与えます。これは、ビット0-15 * の意味を変更したり、ビット 16-31 をシフトして、それを使わないデバイス * にとって時間とスペースの無駄遣いになることをしたくないからです。 */ #define major(x) ((int)(((u_int)(x) >> 8)&0xff)) /* メジャー番号 */ #define minor(x) ((int)((x)&0xffff00ff)) /* マイナー番号 */ #define makedev(x,y) ((dev_t)(((x) << 8) | (y))) /* dev_t を生成する */ #endif #include #ifdef _BSD_CLOCK_T_ typedef _BSD_CLOCK_T_ clock_t; #undef _BSD_CLOCK_T_ #endif #ifdef _BSD_SIZE_T_ typedef _BSD_SIZE_T_ size_t; #undef _BSD_SIZE_T_ #endif #ifdef _BSD_SSIZE_T_ typedef _BSD_SSIZE_T_ ssize_t; #undef _BSD_SSIZE_T_ #endif #ifdef _BSD_TIME_T_ typedef _BSD_TIME_T_ time_t; #undef _BSD_TIME_T_ #endif #ifndef _POSIX_SOURCE #define NBBY 8 /* 1 バイトに含まれるビット数 */ /* * select は long 型のファイル記述子ビットマスクを用います。これらの * マクロはこの型のビットフィールドを操作します (ファイルシステムの * マクロは char 型を用います)。 * FD_SETSIZE はユーザによって定義することもできますが、ほとんどの * ユーザにとっては、ここに示すデフォルトで十分でしょう。 */ #ifndef FD_SETSIZE #define FD_SETSIZE 256 #endif typedef long fd_mask; #define NFDBITS (sizeof(fd_mask) * NBBY) /* マスクごとのビット */ #ifndef howmany #define howmany(x, y) (((x) + ((y) - 1)) / (y)) #endif typedef struct fd_set { fd_mask fds_bits[howmany(FD_SETSIZE, NFDBITS)]; } fd_set; #define FD_SET(n, p) ((p)->fds_bits[(n)/NFDBITS] |= (1 << ((n) % NFDBITS))) #define FD_CLR(n, p) ((p)->fds_bits[(n)/NFDBITS] &= ~(1 << ((n) % NFDBITS))) #define FD_ISSET(n, p) ((p)->fds_bits[(n)/NFDBITS] & (1 << ((n) % NFDBITS))) #define FD_COPY(f, t) bcopy(f, t, sizeof(*(f))) #define FD_ZERO(p) bzero(p, sizeof(*(p))) #if defined(__STDC__) && defined(KERNEL) /* * 関数プロトタイプのための構造体の先行定義。サブシステムの境界を越えて * 用いられる共通の構造体をここに含めます。その他の構造体は、ほとんど * 定義されたのと同じ場所でしか使用されません。 */ struct proc; struct pgrp; struct ucred; struct rusage; struct file; struct buf; struct tty; struct uio; #endif #endif /* !_POSIX_SOURCE */ #endif /* !_SYS_TYPES_H_ */ .Ed .Sh 関連項目 .Xr gdb 1 , .Xr lseek 2 , .Xr time 3 , .Xr fs 5 .Sh 歴史 .Nm ファイルは .At v7 から登場しました。 diff --git a/ja/man/man5/tzfile.5 b/ja/man/man5/tzfile.5 index 8be4fd0cd7..db188c3cb6 100644 --- a/ja/man/man5/tzfile.5 +++ b/ja/man/man5/tzfile.5 @@ -1,123 +1,123 @@ .Dd September 13, 1994 -.\" jpman $Id: tzfile.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: tzfile.5,v 1.3 1998/06/22 10:44:36 kumano Stab % .Dt TZFILE 5 .Os FreeBSD 2.0 .Sh 名称 .Nm tzfile .Nd タイムゾーンの情報 .Sh 書式 .Fd #include .Sh 解説 .Xr tzset 3 が使用するタイムゾーン情報ファイルは、 将来の使用のために予約されている数バイトから始まり、 4 つの .Fa long 型 4 バイト値が続きます。 これは ``標準'' バイトオーダ (上位バイトを最初に格納) で格納されます。 これらの値を順序に従い、以下に示します。 .Pp .Bl -tag -compact -width tzh_ttisstdcnt .It Li tzh_ttisstdcnt ファイルに格納された、標準/ウォール指示子の数。 .It Li tzh_leapcnt ファイルに格納された、閏秒データの数。 .It Li tzh_timecnt ファイルに格納された ``遷移時刻'' データの数。 .It Li tzh_typecnt ファイルに格納された ``ローカルタイム型'' データの数 (0 であってはなりません)。 .It Li tzh_charcnt ファイルに格納された ``タイムゾーン省略形文字列'' の文字数。 .El .Pp 上記のヘッダに続いて、 4 バイト .Fa long 型の値が .Li tzh_timecnt 個、昇順に並びます。 値は ``標準'' バイトオーダで格納されます。 それぞれ、ローカルタイム計算方法が変わる遷移時刻 ( .Xr time 3 で返される形式) として使用されます。 続いて、1 バイト .Fa "unsigned char" 型の値が .Li tzh_timecnt 個続きます。 このそれぞれは、同一インデックスの遷移時刻に、 ファイル中のどの ``ローカルタイム'' 型が対応するかを示します。 値は、このファイル中で後続する .Fa ttinfo 構造体の配列に対するインデックスです。 .\" つまり struct ttinfo が tzh_typecnt 個あるということ .\" See src/lib/libc/stdtime/tzfile.h .\" 1998/05/01 horikawa@jp.freebsd.org この構造体の定義を以下に示します。 .Pp .Bd -literal -offset indent struct ttinfo { long tt_gmtoff; int tt_isdst; unsigned int tt_abbrind; }; .Ed .Pp 各構造体は、 標準バイトオーダの 4 バイト .Fa long 型の値 .Li tt_gmtoff 、それに続く 1 バイトの値 .Li tt_isdst 、そして 1 バイトの値 .Li tt_abbrind の順に格納されます。 .Li tt_gmtoff は GMT に加えるべき秒数を、 .Li tt_isdst は .Li tm_isdst が .Xr localtime 3 により設定されるべきかどうかを、 .Li tt_abbrind はタイムゾーン省略文字列の配列に対するインデックスを意味します。 タイムゾーン省略文字列の配列は、同一ファイル中の .Li ttinfo 構造体に後続しています。 .Pp その後には標準バイトオーダで格納される 4 バイト値のペアが .Li tzh_leapcnt 個格納されています。 各ペアの最初の値は、閏秒が発生する時刻 ( .Xr time 3 で返される形式) です。 2 番目の値は、 指定された時刻以降に適用される閏秒の .Em 総計 です。 値のペアは時刻の昇順で格納されます。 .Pp 最後に、1 バイト値の標準/ウォールの指示子が .Li tzh_ttisstdcnt 個格納されています。 これらは、ローカルタイム型に関する遷移時刻が 標準時刻で指定されているのか、 それともウォールクロックの時刻で指定されているのかを示します。 この情報は、POSIX スタイルのタイムゾーン環境変数を扱う際に、 タイムゾーンファイルを使用するときに使用します。 .Pp .Li tzh_timecnt が 0 の場合もしくは時刻引数がファイル中の最初の遷移時刻以前の場合、 .Nm localtime は、ファイル中の最初の標準時間の .Li ttinfo 構造体を使用します (標準時間の構造体が無い場合には、単に最初の .Li ttinfo 構造体を使用します)。 .Sh 関連項目 .Xr ctime 3 , .Xr time2posix 3 , .Xr zic 8 .\" @(#)tzfile.5 7.2 diff --git a/ja/man/man5/utmp.5 b/ja/man/man5/utmp.5 index c73ced729f..89929ba437 100644 --- a/ja/man/man5/utmp.5 +++ b/ja/man/man5/utmp.5 @@ -1,219 +1,219 @@ .\" 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. .\" .\" @(#)utmp.5 8.2 (Berkeley) 3/17/94 .\" %Id: utmp.5,v 1.3.2.6 1998/06/28 21:34:27 hoek Exp % .\" -.\" jpman $Id: utmp.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: utmp.5,v 1.3 1998/06/17 07:53:04 kumano Stab % .Dd March 17, 1994 .Dt UTMP 5 .Os BSD 4 .Sh 名称 .Nm utmp , .Nm wtmp , .Nm lastlog .Nd ログイン記録 .Sh 書式 .Fd #include .Fd #include .Sh 解説 .Aq Pa utmp.h ファイルは、 .Nm utmp ファイルでの現在のユーザについての情報や .Nm wtmp ファイル中でのログインやログアウトの情報、 .Nm lastlog ファイル中での最終ログイン情報の記録のために使われる構造体を 宣言しています。 時刻の変更やシャットダウンおよびリブートのタイムスタンプは、同じように .Nm wtmp ファイルに記録されます。 .Pp これらのファイルは、忙しいシステムでは急速に大きくなりますので、 毎日もしくは毎週ローテションすることを推奨します。 もし、これらのファイルのどれかが存在しない場合、そのファイルは作成されません。 これらのファイルは、手動で作成されなければならず、 .Xr newsyslog 8 によって管理されます。 .Bd -literal -offset indent #define _PATH_UTMP "/var/run/utmp" #define _PATH_WTMP "/var/log/wtmp" #define _PATH_LASTLOG "/var/log/lastlog" #define UT_NAMESIZE 8 #define UT_LINESIZE 8 #define UT_HOSTSIZE 16 struct lastlog { time_t ll_time; char ll_line[UT_LINESIZE]; char ll_host[UT_HOSTSIZE]; }; struct utmp { char ut_line[UT_LINESIZE]; char ut_name[UT_NAMESIZE]; char ut_host[UT_HOSTSIZE]; long ut_time; }; .Ed .Pp ユーザがログインするたびに、 .Xr login 1 プログラムは .Nm lastlog ファイル中のユーザの .Tn UID を検索します。 もし見つかった場合、ユーザが最後にログインした時刻のタイムスタンプ、 端末線、ホスト名が標準出力に書き出されます ( ログインが .Em メッセージを表示しない ように設定されていない場合。 .Xr login 1 を参照 )。 .Nm login プログラムは、その後 .Nm lastlog ファイルに新しいログイン時刻を記録します。 .Pp 新しい .Fa lastlog への記録が書き出された後で、 .\" the .\" .Xr libutil 3 .\" routine .Nm utmp ファイルがオープンされ、ユーザに対する .Fa utmp 記録が挿入されます。 この記録は、ユーザがログアウトして削除される時まで保持されます。 .Nm utmp ファイルは、 .Xr rwho 1 , .Xr users 1 , .Xr w 1 , .Xr who 1 プログラムで使われます。 .Pp 次に、 .Xr login プログラムは .Nm wtmp ファイルをオープンし、ユーザの .Fa utmp 記録を追加します。 同じ .Fa utmp 記録が更新されたタイムスタンプ付きで、ユーザがログアウトした時に、 ファイルに追加されます ( .Xr init 8 参照)。 .Nm wtmp ファイルは、 .Xr last 1 と .Xr ac 8 プログラムで使われます。 .Pp 時刻変更やシャットダウン・リブートの際には、 以下の項目が .Nm wtmp ファイルに記録されます。 .Pp .Bl -tag -width shutdownxx -compact .It Li reboot .It Li shutdown システムのリブートやシャットダウンが開始された。 .Fa ut_line フィールドに .Ql \&~ と言う文字が、 .Fa ut_name フィールド中に .Li reboot もしくは .Li shutdown が記録されます ( .Xr shutdown 8 と .Xr reboot 8 参照)。 .Pp .It Li date システム時刻が手動もしくは自動で更新された ( .Xr date 1 参照)。 コマンド名 .Xr date がフィールド .Fa ut_name に記録されます。 .Fa ut_line フィールド中の .Ql \\*(Ba 文字は、変更前の時刻を示し、 .Ql \&{ 文字は新しい時刻を示しています。 .El .Sh 関連ファイル .Bl -tag -width /var/log/lastlog -compact .It Pa /var/run/utmp .Nm utmp ファイル。 .It Pa /var/log/wtmp .Nm wtmp ファイル。 .It Pa /var/log/lastlog .Nm lastlog ファイル。 .El .Sh 関連項目 .Xr last 1 , .Xr login 1 , .Xr w 1 , .Xr who 1 , .Xr ac 8 , .Xr init 8 .Sh 歴史 A .Nm utmp と .Nm wtmp ファイル書式は .At v6 から登場しました。 .Nm lastlog ファイル書式は .Bx 3.0 から登場しました。 diff --git a/ja/man/man5/uuencode.format.5 b/ja/man/man5/uuencode.format.5 index fe73b1a293..e5cd5f93b1 100644 --- a/ja/man/man5/uuencode.format.5 +++ b/ja/man/man5/uuencode.format.5 @@ -1,99 +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. .\" .\" @(#)uuencode.format.5 8.2 (Berkeley) 1/12/94 -.\" jpman $Id: uuencode.format.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: uuencode.format.5,v 1.3 1998/07/02 18:49:29 kumano Stab % .\" .\" WORD: trailer トレーラ .\" .Dd January 12, 1994 .Dt UUENCODE 5 .Os BSD 4 .Sh 名称 .Nm uuencode .Nd uuencode ファイルのフォーマット .Sh 解説 .Xr uuencode 1 によって出力されるファイルは、ヘッダ行、それに続く本体の行、 およびトレーラ行から構成されています。 .Xr uudecode 1 コマンドはヘッダ行の前やトレーラ行の後ろにある行を無視します。 ヘッダの前にある行は、当然ヘッダのようには見えてはいけません。 .Pp ヘッダ行は行の先頭にある 6 文字 .Dq begin\ \& (最後の空白に注意) によって識別されます。 .Em begin の後ろには (8 進数の) モード、そしてリモートファイルの名前を指定する 文字列が続きます。 空白がヘッダ行中の 3 つの要素を分けています。 .Pp 本体は、それぞれが最大 62 文字 (行末の改行を含みます) の行から 構成されています。これらは文字カウント、それに続く符合化された文字、 それに続く改行からなります。 文字カウントは印刷可能な 1 文字で、その行の残りのバイト数を整数で表して います。 その整数は常に 1 から 45 または 64 の範囲にあり、その文字から空白文字 (8 進数で 40) を引く事によって決定可能です。文字 64 は 0 のカウントを 表しています。 .Pp 3 バイトのグループが 4 文字に (訳注: 3 バイト (24 ビット) を 1 グループとしこれを 4 つに分けて 4 文字に) .\" 上記訳注は、原文の理解を助けるために追加しました。 .\" 2.2.6-RELEASE 対象 .\" By kumano@jp.freebsd.org (Jun 27 1998) 、つまり 6 ビットが 1 文字に蓄えられます。 すべての文字はいつも 1 から 64 の範囲にあり印刷可能な文字にするために 空白文字 (8 進数で 40) でかさあげされます。 文字 64 は 0 のカウントを表します。 最後の行は通常の 45 バイトより短くてもかまいません。 もしサイズが 3 の倍数でない場合、 そのことは最終行のカウントの値を見ればわかります。 文字カウントを 4 の倍数にするために、余分なゴミが含まれる事があります。 本体は、0 のカウントを持つ行で終了します。 この行は .Tn ASCII バッククォート (8 進数で 140) の 1 文字からなります。 .Pp トレーラ行は .Dq end だけの行からなります。 .Sh 関連項目 .Xr mail 1 , .Xr uucp 1 , .Xr uudecode 1 , .Xr uuencode 1 .Sh 歴史 .Nm uuencode ファイルフォーマットは .Bx 4.0 から登場しました。 .\" It was named uuencode.5 prior to 4.3 diff --git a/ja/man/man5/vgrindefs.5 b/ja/man/man5/vgrindefs.5 index a858c2d732..b3266f219f 100644 --- a/ja/man/man5/vgrindefs.5 +++ b/ja/man/man5/vgrindefs.5 @@ -1,165 +1,165 @@ .\" 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. .\" .\" @(#)vgrindefs.5 8.1 (Berkeley) 6/6/93 -.\" jpman $Id: vgrindefs.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: vgrindefs.5,v 1.3 1998/07/30 15:29:11 horikawa Stab % .\" WORD: lexical 字句上の(的な)、字句(複合語の場合) .\" WORD: optional 省略可能な .\" .Dd June 6, 1993 .Dt VGRINDEFS 5 .Os BSD 4.2 .Sh 名称 .Nm vgrindefs .Nd .Xr vgrind 1 のための言語定義データベース .Sh 書式 .Nm vgrindefs .Sh 解説 .Nm vgrindefs ファイルは .Xr vgrind 1 が用いるすべての言語定義を含んでいます。 このデータベースは .Xr termcap 5 に非常によく類似しています。 .Sh フィールド 以下の表は、各フィールドの名称と意味を解説しています。 .Pp .Bl -column Namexxx Tpexxx .Sy 名称 型 解説 .It "ab 文字列 代替コメントの始まりを示す正規表現" .It "ae 文字列 代替コメントの終りを示す正規表現" .It "pb 文字列 手続きの始まりを示す正規表現" .It "bb 文字列 字句的ブロックの始まりを示す正規表現" .It "be 文字列 字句的ブロックの終りを示す正規表現" .It "cb 文字列 コメントの始まりを示す正規表現" .It "ce 文字列 コメントの終りを示す正規表現" .It "sb 文字列 文字列の始まりを示す正規表現" .It "se 文字列 文字列の終りを示す正規表現" .It "lb 文字列 文字列定数の始まりを示す正規表現" .It "le 文字列 文字列定数の終りを示す正規表現" .It "nc 文字列 非コメントを示す正規表現 (下記参照)" .It "tl bool 指定した場合、字句上のトップレベル以外では手続きが定義されないことを意味する" .It "oc bool 指定した場合、大文字と小文字が等価であることを意味する" .It "kw 文字列 スペースで区切られたキーワードのリスト" .El .Pp 非コメントは、通常はコメントの始まりを示すシーケンスがその特殊な意味を 失うような特別な状況を記述するのに必要です。この典型的な実例は、 Perl において、通常コメントを .Ql # で始めるのに対し、文字列 .Ql $# が配列に対するオペレータである例に見ることができます。 .Sh 使用例 以下のエントリは C 言語を記述するもので、言語エントリの典型例です。 .Bd -literal C|c:\ :pb=^\ed?*?\ed?\ep\ed?\e(\ea?\e):bb={:be=}:cb=/*:ce=*/:sb=":se=\ee":\e :lb=':le=\ee':tl:\e :kw=asm auto break case char continue default do double else enum\e extern float for fortran goto if int long register return short\e sizeof static struct switch typedef union unsigned while #define\e #else #endif #if #ifdef #ifndef #include #undef # define else endif\e if ifdef ifndef include undef: .Ed .Pp 最初のフィールドは単に言語名 (とそのすべての変種) を示すに過ぎないことに 注意して下さい。この場合、C言語は "c" か "C" という名前で .Xr vgrind 1 に指定することができます。 .Pp 行の最後の文字として \e を与えることにより、 エントリは複数行に続けることができます。 .Nm vgrindefs のケーパビリティは 2 つの型に分かれます。すなわち、 言語に特定の機能が備わっていることを示すブール型のケーパビリティと、 正規表現またはキーワードのリストを示す文字列のケーパビリティです。 .Sh 正規表現 .Nm vgrindefs は .Xr ex 1 や .Xr lex 1 の正規表現に非常によく似たものを用います。 文字 `^', `$', `:' および `\e' は予約された文字なので、これらが通常の文字として含まれる場合は .Ql \e を直前に置くことによって "クォート" しなければなりません。 メタシンボルとそれらの意味は、以下のとおりです。 .Bl -tag -width indent .It $ 行末 .It \&^ 行頭 .It \ed デリミタ (スペース、タブ、改行、行の始まり) .It \ea シンボルからなるすべての文字列にマッチする (lex での .* と同じ) .It \ep すべての英数字からなる名前にマッチする。手続き定義の内部 (pb) では このシンボルにマッチする文字列が手続きの名前として用いられます。 .It () グループ化 .It \&| 選択 .It ? 直前の項目が省略可能である .It \ee 文字列の前に置くことにより、その文字列と、 先頭がエスケープ文字 (\e) である入力文字列とはマッチしなくなります。 文字列デリミタをエスケープすることにより文字列中に含むことが可能な (C のような) 言語で使用されるのが、典型的な使用法です。 .El .Pp その他のシステム内の正規表現と異なり、これらは文字単位ではなく単語単位で マッチします。ですから、 "(tramp|steamer)flies?" のような場合は "tramp", "steamer", "trampflies", または "steamerflies" にマッチします。 .Sh キーワードリスト キーワードリストは言語におけるキーワードをスペースで区切って単純に 列挙したものです。もし "oc" ブール値フラグが指定されていれば、これは 大文字と小文字が等価であることを示すので、すべてのキーワードは小文字で 指定するべきです。 .Sh 関連ファイル .Bl -tag -width /usr/share/misc/vgrindefs -compact .It Pa /usr/share/misc/vgrindefs 端末記述を含むファイル .El .Sh 関連項目 .Xr troff 1 , .Xr vgrind 1 .Sh 歴史 .Nm ファイルフォーマットは .Bx 4.2 で登場しました。 diff --git a/ja/man/man8/xntpd.8 b/ja/man/man8/xntpd.8 index b7922d7698..f418f96152 100644 --- a/ja/man/man8/xntpd.8 +++ b/ja/man/man8/xntpd.8 @@ -1,1087 +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") モードで動作するよう指示します。これは、さまざまな失敗 -の仕方によって、ローカルもしくはリモートのサーバホストのいずれかが -より良い時刻供給源となり得るようなサーバのネットワークにおいて、役立つ -ものです。 +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 このコマンドは、同期するのにふさわしい通信相手を認証する目的にとって 信用できる暗号化キー識別子を指定するのに使用されます。異なるサーバは 異なるキーを使用できますが、認証手続きにはローカルとリモート両方の サーバがこの目的のため同一のキーとキー識別子を共有することが必要です。 引数は、32 ビット符合なし整数ですが、 NTP キー 0 は固定されており周知の ものであることに注意してください。意味のある認証が行われるべきならば、 キー 0 は信用すべきではありません。 .PP .B requestkey .I # .PP このコマンドは、 .IR xntpd (8) の動作に影響を与える問題の診断と修復に役立つ .IR xntpdc (8) プログラムにより使用されるキー識別子を指定します。 .I xntpdc プログラムの動作は、 xntpd のこの固有の実装に特定されており、これ および以前のバージョンのデーモンとのみ動作すると見込まれます。ローカル サーバの状態に影響を与えるリモートの .I xntpdc プログラムからの要求は、 認証されねばなりません。そのためには、リモートプログラムとローカル サーバが共通のキーとキー識別子を共有することが必要です。このコマンドの引数は、 32 ビット符合なし整数です。設定ファイルに .B controlkey コマンドが含まれていないか、キーがマッチしないと、この要求は無視され ます。 .PP .B controlkey .I # .PP このコマンドは、 .IR xntpd (8) の動作に影響を与える問題の診断と修復に役立つ .IR ntpq (8) プログラムにより使用されるキー識別子を指定します。 .IR ntpq プログラムと .I xntpd の動作は RFC 1305 の定義を満たしています。ローカルサーバの状態に影響 を与えるリモートの .I ntpq プログラムからの要求は、認証されねばなりません。そのためには、リモート プログラムとローカルサーバが共通のキーとキー識別子を共有することが 必要です。このコマンドの引数は、32 ビット符合なし整数です。 設定ファイルに .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".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 このコマンドは、付加的なシステム変数を追加します。これらの変数は、 アクセスポリシなどの付加的な情報を配布するために使用できます。 = の形式の変数に、キーワード .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/man5/a.out.5 b/ja_JP.eucJP/man/man5/a.out.5 index 2c7609a3fa..cec7ab4db5 100644 --- a/ja_JP.eucJP/man/man5/a.out.5 +++ b/ja_JP.eucJP/man/man5/a.out.5 @@ -1,485 +1,485 @@ .\" Copyright (c) 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This man page is derived from documentation contributed to Berkeley by .\" Donn Seeley at UUNET Technologies, 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. .\" .\" @(#)a.out.5 8.1 (Berkeley) 6/5/93 .\" %Id: a.out.5,v 1.4.2.1 1996/12/31 22:50:38 mpp Exp % .\" -.\" jpman $Id: a.out.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: a.out.5,v 1.3 1998/08/09 12:51:56 horikawa Stab % .\" WORD: byte order バイト順 .\" WORD: posision independent 位置独立(な) .\" WORD: link editor リンクエディタ .\" WORD: link edit リンクエディット .\" .Dd June 5, 1993 .Dt A.OUT 5 .Os .Sh 名称 .Nm a.out .Nd 実行可能バイナリファイルのフォーマット .Sh 書式 .Fd #include .Sh 解説 インクルードファイル .Aq Pa a.out.h では 3 つの構造体といくつかのマクロが宣言されています。 これらの構造体は、このシステムで実行可能な機械語コードファイル .Pq Sq バイナリ のフォーマットを規定します。 .Pp バイナリファイルは最大で 7 つのセクションから構成されます。 これらのセクションを順にあげると以下のようになります: .Bl -tag -width "テキストリロケーション" .It exec ヘッダ バイナリファイルをメモリ上にロードして実行するために カーネルが用いるパラメータを含んでいます。 これらのパラメータはリンクエディタ .Xr ld 1 がバイナリファイルを他のバイナリファイルと結合する際にも 用いられます。 このセクションは唯一の必須セクションです。 .It テキストセグメント プログラムが実行される際にメモリ上にロードされる 機械語コード及び関連データを含んでいます。 読み込み専用でロードされる場合があります。 .It データセグメント 初期化済データを含んでいます。 常に書き込み可能なメモリ上にロードされます。 .It テキストリロケーション バイナリファイル結合時にテキストセグメント内のポインタを修正するために、 リンクエディタによって用いられるレコードを含んでいます。 .It データリロケーション 前出のテキストリロケーションセクションと似ていますが、 データセグメント内のポインタ修正用です。 .It シンボルテーブル バイナリファイル間で 名前付きの変数や関数 .Pq Sq シンボル のアドレス相互参照を解決するために、 リンクエディタによって用いられるレコードを含んでいます。 .It string table シンボル名に対応する文字列を含んでいます。 .El .Pp 全てのバイナリファイルは次の .Fa exec 構造体で始まります: .Bd -literal -offset indent struct exec { unsigned long a_midmag; unsigned long a_text; unsigned long a_data; unsigned long a_bss; unsigned long a_syms; unsigned long a_entry; unsigned long a_trsize; unsigned long a_drsize; }; .Ed .Pp これらのフィールドは以下の機能を持っています: .Bl -tag -width a_trsize .It Fa a_midmag このフィールドはホストのバイト順 (host byte-order) で格納されます。 このフィールドはいくつかのサブコンポーネントを持っており、それらは 以下のマクロ .Dv N_GETFLAG() , .Dv N_GETMID() , .Dv N_GETMAGIC() で参照され、マクロ .Dv N_SETMAGIC() で設定されます。 .Pp マクロ .Dv N_GETFLAG() は以下のフラグを返します: .Bl -tag -width EX_DYNAMIC .It Dv EX_DYNAMIC この実行可能ファイルがランタイムリンクエディタのサービスを要求することを 示します。 .It Dv EX_PIC このオブジェクトファイルが位置独立 (position independent) なコードを 含んでいることを示します。 このフラグは .Sq -k フラグ指定時に .Xr as 1 によって設定され、必要なら .Xr ld 1 はこれを保存します。 .El .Pp EX_DYNAMIC と EX_PIC の両方がセットされている場合、 そのオブジェクトファイルは位置独立な実行可能イメージです (例: 共有ライブラリ)。 これはランタイムリンクエディタによってプロセスのアドレス空間にロードされます。 .Pp マクロ .Dv N_GETMID() はマシン識別コード (machine-id) を返します。 これは、バイナリファイルが実行されるべきマシンを示しています。 .Pp .Dv N_GETMAGIC() はマジックナンバを示します。 マジックナンバはバイナリファイル種別を一意に識別し、 様々なロード方法を区別します。 このフィールドは以下の値のいずれか 1 つを含んでいなければなりません: .Bl -tag -width ZMAGIC .It Dv OMAGIC テキストセグメントとデータセグメントはヘッダの直後にあり、 連続しています。 カーネルはテキスト/データセグメントの両方を書き込み可能メモリ領域に ロードします。 .It Dv NMAGIC .Dv OMAGIC と同様、テキスト/データセグメントはヘッダの直後にあり、連続しています。 しかし、カーネルはテキストセグメントを読み込み専用メモリ領域にロードし、 テキストに続くページ境界から始まる 書き込み可能メモリ領域にデータセグメントをロードします。 .It Dv ZMAGIC カーネルは各々のページを必要に応じてバイナリからロードします。 ヘッダ、テキストセグメント及びデータセグメントはいずれも、 ページサイズの倍数の大きさになるよう、 リンクエディタによってパディングされます。 カーネルがテキストセグメントからロードしたページは読み込み専用ですが、 データセグメントからロードしたページは書き込み可能です。 .El .It Fa a_text テキストセグメントのサイズ (バイト単位) を保持します。 .It Fa a_data データセグメントのサイズ (バイト単位) を保持します。 .It Fa a_bss .Sq bss セグメント のバイト数を保持します。 この値はカーネルが最初の break 値 .Pq Xr brk 2 をデータセグメントの後ろに設定するのに用いられます。 カーネルは、ここに示されるサイズの書き込み可能メモリ領域が データセグメントの後ろに用意され、それらの初期状態が 0 になるように、 プログラムをロードします。 .It Fa a_syms シンボルテーブルセクションのサイズ (バイト単位) を保持します。 .It Fa a_entry カーネルがバイナリファイルをロードした後の、 プログラムのエントリポイントのメモリアドレスを保持します。 カーネルは、このアドレスにある機械命令からプログラムの実行を開始します。 .It Fa a_trsize テキストリロケーションテーブルのサイズ (バイト単位) を保持します。 .It Fa a_drsize データリロケーションテーブルのサイズ (バイト単位) を保持します。 .El .Pp インクルードファイル .Pa a.out.h では、 .Fa exec 構造体を用いて一貫性をテストしたりバイナリファイル中のセクションオフセットを 知るためのマクロが定義されています。 .Bl -tag -width N_BADMAG(exec) .It Fn N_BADMAG exec .Fa a_magic フィールドに、認識できない値が含まれている場合、非 0 を返します。 .It Fn N_TXTOFF exec バイナリファイルにおけるテキストセグメントの先頭のバイトオフセットを返します。 .It Fn N_SYMOFF exec シンボルテーブルの先頭のバイトオフセットを返します。 .It Fn N_STROFF exec 文字列テーブルの先頭のバイトオフセットを返します。 .El .Pp リロケーションレコードは、 .Fa relocation_info 構造体で規定される標準フォーマットです: .Bd -literal -offset indent struct relocation_info { int r_address; unsigned int r_symbolnum : 24, r_pcrel : 1, r_length : 2, r_extern : 1, r_baserel : 1, r_jmptable : 1, r_relative : 1, r_copy : 1; }; .Ed .Pp .Fa relocation_info 構造体の各フィールドは以下のように用いられます: .Bl -tag -width r_symbolnum .It Fa r_address リンクエディットが必要なポインタのバイトオフセットを保持します。 テキストリロケーションオフセットはテキストセグメントの先頭から、 データリロケーションオフセットはデータセグメントの先頭から、 それぞれ計算します。 リンクエディタはこのオフセットにストアされている値を加算し、 このリロケーションレコードを用いて計算した新しい値に変換します。 .It Fa r_symbolnum シンボルテーブルにおけるシンボル構造体の順序番号 ( バイトオフセット .Em ではありません ) を保持します。 リンクエディタはこのシンボルの絶対アドレスを解決した後、 そのアドレスをリロケーション中のポインタに加算します。 (もし .Fa r_extern ビットが立っていなければ状況は異なります。以下を参照して下さい。) .It Fa r_pcrel もしこのビットが立っていれば、 リンクエディタは、PC 相対アドレシングを用いる機械語命令の一部である ポインタを更新しているものと仮定します。 リロケートされるポインタのアドレスは、実行中のプログラムがそれを用いる際に、 暗黙的にその値に加算されます。 .It Fa r_length ポインタの長さを 2 を底とする対数で表したバイト単位で保持します。 1 バイトディスプレースメントなら 0、 2 バイトディスプレースメントなら 1、 4 バイトディスプレースメントなら 2 となります。 .It Fa r_extern このリロケーションが外部参照を必要としている場合にセットされます。 リンクエディタは、シンボルアドレスを用いてこのポインタを 更新しなければなりません。 .Fa r_extern ビットが立っていない場合、そのリロケーションは .Sq ローカル です。 リンクエディタは、シンボル値の変化ではなく、 各セグメントのロードアドレスの変化に応じてポインタを更新します (ただし、 .Fa r_baserel もセットされている場合(後述)は除きます)。 この場合、 .Fa r_symbolnum フィールドの内容は .Fa n_type の値となります(後述)。 リンクエディタは、この型フィールドから、 リロケートされるポインタがどのセグメントを指しているのかの情報を得ます。 .It Fa r_baserel セットされている場合、 .Fa r_symbolnum フィールドで指定される場合のように、 このシンボルはグローバルオフセットテーブルへのオフセットに リロケートされます。 実行時に、グローバルオフセットテーブル中の、このオフセット位置にある エントリが、シンボルのアドレスを持つようにセットされます。 .It Fa r_jmptable セットされている場合、 .Fa r_symbolnum フィールドで指定される場合のように、 このシンボルはプロシージャリンケージテーブルへのオフセットに リロケートされます。 .It Fa r_relative セットされている場合、 このリロケーションは、このオブジェクトファイルが含まれる イメージの (実行時の) ロードアドレスとの相対値となります。 この種のリロケーションは共有オブジェクトにのみ現れます。 .It Fa r_copy セットされている場合、 このリロケーションレコードは、 その内容を .Fa r_address で指定される位置にコピーしなければならないシンボルを示します。 コピー処理は、実行時のリンクエディタによって、 共有オブジェクト中の適切なデータアイテムから行われます。 .El .Pp シンボルは名前とアドレスを対応づけます (より一般的には、 文字列を値へ対応づけます)。 リンクエディタがアドレスを調節するため、 絶対値が割り当てられるまではシンボルを用いてアドレスを表現しなければ なりません。 シンボルは、シンボルテーブル中の固定長のレコードと、 文字列テーブル中の可変長の名前から成ります。 シンボルテーブルは .Fa nlist 構造体の配列です: .Bd -literal -offset indent struct nlist { union { char *n_name; long n_strx; } n_un; unsigned char n_type; char n_other; short n_desc; unsigned long n_value; }; .Ed .Pp これらのフィールドは以下のように用いられます: .Bl -tag -width n_un.n_strx .It Fa n_un.n_strx このシンボルの名前の、文字列テーブルでのバイトオフセットを保持します。 プログラムが .Xr nlist 3 関数を用いてシンボルテーブルをアクセスする場合、 このフィールドは、 メモリ中の文字列へのポインタである .Fa n_un.n_name フィールドに置き換えられます。 .It Fa n_type リンクエディタがシンボル値の更新方法を決定するのに用いられます。 .Fa n_type フィールドは、ビットマスクを用いた 3 つのサブフィールドに分けられます。 リンクエディタは .Dv N_EXT ビットがセットされているシンボルを .Sq external シンボルとして扱い、他のバイナリファイルからの参照を許可します。 .Dv N_TYPE マスクはリンクエディタに必要なビットを選択します: .Bl -tag -width N_TEXT .It Dv N_UNDF 未定義シンボル。 リンクエディタは、他のバイナリファイル中の同じ名前の外部シンボルを探して このシンボルの絶対値を決定しなければなりません。 特別な場合として、もし .Fa n_value フィールドが非 0 で、リンクエディット対象のどのバイナリファイルも このシンボルを定義していない場合、 リンクエディタはこのシンボルが bss セグメント中のアドレスであるとみなし、 .Fa n_value に等しいバイト数の領域を予約します。 もしこのシンボルが複数のバイナリファイル中で未定義となっており、 それらのバイナリファイル間でサイズが異なっている場合、 リンクエディタはそれらのサイズの最大値を選びます。 .It Dv N_ABS 絶対シンボル。 リンクエディタは絶対シンボルは更新しません。 .It Dv N_TEXT テキストシンボル。 このシンボルの値はテキストアドレスであり、 リンクエディタはバイナリファイルをマージする際、その値を更新します。 .It Dv N_DATA データシンボル。 .Dv N_TEXT と同様ですが、データアドレスを表します。 テキストシンボル及びデータシンボルの値は、 ファイルオフセットではなくアドレスです。 ファイルオフセットを復元するために、 対応するセクションの先頭のロードアドレスを見つけてそれを減じ、 次にそのセクションのオフセットを加算する必要があります。 .It Dv N_BSS bss シンボル。テキストシンボルやデータシンボルと似ていますが、 バイナリファイル中に対応するオフセットを持ちません。 .It Dv N_FN ファイル名シンボル。 バイナリファイルをマージする際、 リンクエディタはバイナリファイルの他のシンボルの前にこのシンボルを 挿入します。 このシンボルの名前はリンクエディタに与えられたファイル名で、 シンボルの値はバイナリファイルから得た先頭テキストアドレスです。 ファイル名シンボルはリンクエディト処理やロード処理には不要ですが、 デバッガには有用な情報です。 .El .Pp .Dv N_STAB マスクは .Xr gdb 1 等のシンボリックデバッガに必要なビットを選択します。 その値は .Xr stab 5 に示されています。 .It Fa n_other このフィールドは、 .Fa n_type フィールドで決定されるセグメントに関して、 そのシンボルのロケーションとは独立した シンボルの特質に関する情報を提供します。 現在のところ、 .Fa n_other フィールドの下位 4 ビットは .Dv AUX_FUNC あるいは .Dv AUX_OBJECT のいずれかをとります .Po これらの定義については .Aq Pa link.h を参照してください .Pc 。 .Dv AUX_FUNC はシンボルと呼び出し可能な関数を関連づけ、他方、 .Dv AUX_OBJECT はシンボルとデータを関連づけます。 これらの関連はテキストセグメント/データセグメントの別とは無関係です。 このフィールドは、 .Xr ld 1 が動的な実行可能形式を構築するために使うことを意図しています。 .It Fa n_desc デバッガ用に予約されており、リンクエディタはこのフィールドを全く変更しません。 デバッガによって異なった目的に使われます。 .It Fa n_value シンボルの値を保持します。 テキスト, データおよび bss シンボルの場合、その値はアドレスです。 他のシンボル (例えばデバッガシンボル等) の場合、その値は様々です。 .El .Pp 文字列テーブルは .Em unsigned long 型の長さと、それに続くナル終端のシンボル文字列から成ります。 この長さは、テーブル全体のサイズをバイト単位で表します。 つまり、その最小値 (言い替えれば、最初の文字列のオフセット) は、 32 ビットマシンでは常に 4 となります。 .Sh 関連項目 .Xr as 1 , .Xr gdb 1 , .Xr ld 1 , .Xr brk 2 , .Xr execve 2 , .Xr nlist 3 , .Xr core 5 , .Xr link 5 , .Xr stab 5 .Sh 歴史 インクルードファイル .Pa a.out.h は .At v7 で登場しました。 .Sh バグ 必ずしも全てのサポート対象アーキテクチャが .Fa a_midmag フィールドを用いるわけではないので、 あるバイナリがどのようなアーキテクチャ上で実行されるのかは、 実際のマシンコードを調べない限り判定困難な可能性があります。 マシン ID があったとしても、 .Fa exec ヘッダのバイト順はマシン依存です。 .Pp .Em bss が何の略なのか、に関する合意はないようです。 .Pp 将来、新しいバイナリファイルフォーマットがサポートされるかも知れませんが、 その新フォーマットは恐らく、 あらゆるレベルでこの太古のフォーマットと互換性がないでしょう。 diff --git a/ja_JP.eucJP/man/man5/acct.5 b/ja_JP.eucJP/man/man5/acct.5 index 2d99ce3746..dca16ef9fc 100644 --- a/ja_JP.eucJP/man/man5/acct.5 +++ b/ja_JP.eucJP/man/man5/acct.5 @@ -1,115 +1,115 @@ .\" 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. .\" .\" @(#)acct.5 8.1 (Berkeley) 6/5/93 .\" %Id: acct.5,v 1.1.1.1.8.4 1998/06/28 21:34:26 hoek Exp % .\" -.\" jpman $Id: acct.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: acct.5,v 1.3 1998/05/27 11:45:48 kuma Stab % .\" .\" WORD: account アカウント[acct.5] .\" WORD: accounting file アカウンティングファイル[acct.5] .\" WORD: structure 構造体(C言語の)[C] .\" .Dd June 5, 1993 .Dt ACCT 5 .Os .Sh 名称 .Nm acct .Nd 実行アカウントファイル .Sh 書式 .Fd #include .Fd #include .Sh 解説 カーネルは、下記の .Fa acct 情報構造を、全プロセスに対して管理します。 プロセスが終了すると、アカウンティングが有効になっている場合には、 カーネルは .Xr acct 2 関数呼び出しを行い、アカウンティングファイルに記録を追加します。 .Bd -literal /* * アカウンティング構造体; これらは、基底値 8 の 3 ビット指数部および * 13 ビット小数部の ``浮動小数点数'' である comp_t 型を使用します。 * 単位は 1/AHZ 秒です。 */ typedef u_short comp_t; #define AC_COMM_LEN 16 struct acct { char ac_comm[AC_COMM_LEN]; /* コマンド名 */ comp_t ac_utime; /* ユーザ時間 */ comp_t ac_stime; /* システム時間 */ comp_t ac_etime; /* 経過時間 */ time_t ac_btime; /* 開始時刻 */ uid_t ac_uid; /* ユーザ ID */ gid_t ac_gid; /* グループ ID */ short ac_mem; /* 平均メモリ使用量 */ comp_t ac_io; /* 入出力ブロック数 */ dev_t ac_tty; /* 制御 tty */ #define AFORK 0x01 /* fork したが exec されていない */ #define ASU 0x02 /* スーパユーザ権限を使用した */ #define ACOMPAT 0x04 /* 互換モードを使用した */ #define ACORE 0x08 /* コアダンプした */ #define AXSIG 0x10 /* シクナルにより kill された */ char ac_flag; /* アカウンティングフラグ */ }; /* * 1/AHZ の粒度で、データは comp_t フィールドにエンコードされます。 * 必ずしも周波数と同一となるとは限りません。 */ #define AHZ 64 .Ed .Pp 終了したプロセスが .Xr execve 2 により生成されたものだった場合、 実行されたファイルのファイル名 (最大 10 文字まで) が .Fa ac_comm フィールドに保存され、その状態は .Fa ac_flag の次のフラグの 1 つ以上を設定することにより保存されます: .Dv AFORK , .Dv ASU , .Dv ACOMPAT , .Dv ACORE , .Dv ASIG 。 .Sh 関連項目 .Xr acct 2 , .Xr execve 2 , .Xr sa 8 .Sh 歴史 .Nm ファイルフォーマットは .At v7 から登場しました。 diff --git a/ja_JP.eucJP/man/man5/aliases.5 b/ja_JP.eucJP/man/man5/aliases.5 index 1083fbfd2f..3b8503862c 100644 --- a/ja_JP.eucJP/man/man5/aliases.5 +++ b/ja_JP.eucJP/man/man5/aliases.5 @@ -1,108 +1,108 @@ .\" Copyright (c) 1983, 1997 Eric P. Allman .\" 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. .\" .\" @(#)aliases.5 8.3 (Berkeley) 2/1/97 -.\" jpman $Id: aliases.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: aliases.5,v 1.3 1998/05/28 15:47:09 kuma Stab % .\" .\" WORD: alias (名)別名(sendmail),エイリアス(csh)(動)エイリアスする(sendmail)[aliases.5,csh.1] .\" .Dd February 1, 1997 .Dt ALIASES 5 .Os BSD 4 .Sh 名称 .Nm aliases .Nd sendmail のためのエイリアスファイル .Sh 書式 .Nm aliases .Sh 解説 このファイルには、 .Pa /usr/sbin/sendmail が使用する、ユーザ .Tn ID の別名を記述します。 このファイルは .Pa /etc に置かれる、下記の形式の一連の行です。 .Bd -filled -offset indent name: name_1, name_2, name_3, . . . .Ed .Pp .Em name はエイリアスする名前、 .Em name_n はその名前の別名です。 空白ではじまる行は継続行です。 .Ql # ではじまる行はコメントです。 .Pp エイリアスはローカル名でのみ適用されます。 ループは起りえません。 なぜなら、メッセージは同じ人に複数回送られないからです。 .Pp エイリアス適用後、ローカルかつ有効な受信者で .Dq Pa .forward ファイルをホームディレクトリに持つ人のメッセージは、 このファイルに定義された一連のユーザに転送されます。 .Pp これは単なる生のデータファイルです; 実際のエイリアス情報は .Xr newaliases 1 プログラムを使用することにより、バイナリ形式でファイル .Pa /etc/aliases.db に置かれます。aliases ファイルを更新したときには、その内容を反映させるために、 .Xr newaliases コマンドを実行する必要があります。 .Sh 関連項目 .Xr newaliases 1 , .Xr dbm 3 , .Xr dbopen 3 , .Xr sendmail 8 .Rs .%T "SENDMAIL Installation and Operation Guide" .Re .Rs .%T "SENDMAIL An Internetwork Mail Router" .Re .Sh バグ .Xr sendmail を NEWDB サポート付きではなく DBM サポート付きでコンパイルした時には、 エイリアス 1 つがおよそ 1000 バイトまでの情報に限るという .Xr dbm 3 の制約が問題となるかもしれません。 このような場合に長いエイリアスを使用するためには ``連鎖'' を使用します; これは別名の最後の名前をダミーの名前にし、 これを引続き別の別名として使用するというものです。 .Sh 歴史 .Nm ファイルフォーマットは .Bx 4.0 に登場しました。 diff --git a/ja_JP.eucJP/man/man5/ar.5 b/ja_JP.eucJP/man/man5/ar.5 index 633b3d79a2..6059899e48 100644 --- a/ja_JP.eucJP/man/man5/ar.5 +++ b/ja_JP.eucJP/man/man5/ar.5 @@ -1,158 +1,158 @@ .\" 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. .\" .\" @(#)ar.5.5 8.1 (Berkeley) 6/9/93 -.\" jpman $Id: ar.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: ar.5,v 1.3 1998/06/15 05:38:19 kuma Stab % .\" .\" WORD: archive アーカイブ .\" .Dd June 9, 1993 .Dt AR 5 .Os .Sh 名称 .Nm ar .Nd アーカイブ (ライブラリ) ファイルフォーマット .Sh 書式 .Fd #include .Sh 解説 アーカイブコマンド .Nm ar は複数のファイルをひとつにまとめます。 アーカイブは主にリンクエディタ .Xr ld 1 を使ってロードするための オブジェクトファイルのライブラリとして使用します。 .Pp .Nm ar によって作成されたファイルは ``マジック'' ストリング "!\en" で 始まっています。 アーカイブの残りはオブジェクトからなり、その各々はファイルのヘッダと ファイル名 (オプション) とファイルの中身から構成されます。 ヘッダは異なるマシンアーキテクチャ間で互換性のあるもので、 ファイルの内容が印字可能なものであれば アーカイブそのものも印字可能となります。 .Pp ヘッダは、可変長の .Tn ASCII のフィールド 6 つとそれに続く2 文字の終端から構成されます。 フィールドはオブジェクトの名前 (16 文字)、 ファイルの最終更新時間 (12 文字)、 ユーザとグループ ID (各々 6 文字)、 ファイルモード (8文字)、 それにファイルサイズ (10 文字) です。 全ての数字フィールドは 10 進数ですが、ファイルモードだけは 8 進数です。 .Pp 更新時間はファイルの .Fa st_mtime フィールドです。すなわち 基準時点 (epoch) からの時間 .Dv CUT 秒です。 ユーザ ID とグループ ID はファイルの .Fa st_uid と .Fa st_gid フィールドです。 ファイルモードはファイルの .Fa st_mode フィールドです。 ファイルサイズはファイルの .Fa st_size フィールドです。 最後の 2 バイトは文字列 "\`\en" となります。 .Pp 名前のフィールドに限りあふれることが考えられるため、以下のよ うに対応しています。 もしファイル名の長さが 16 文字を超えるかスペースを含む場合は、 名前のフィールドには文字列 "#1/" に続いてその名前の .Tn ASCII での長さが書き込まれます。 ファイルサイズ (アーカイブヘッダに書き込まれているもの) には その名前の長さが加算されます。 そして名前はアーカイブヘッダの直後に書かれます。 .Pp これらのフィールドにおいて使用されていない部分には 空白文字が書き込まれます。 もしフィールドにその最長の文字数が書き込まれていると、 フィールドの間の区切りはないことになります。 .Pp アーカイブ中のオブジェクトは常に偶数バイトの長さとなります。 ファイルの長さが奇数バイトである場合は 改行 (``\en'') 文字でパディングされます。 その場合、ヘッダ中のファイルサイズにはパディングの分は反映されません。 .Sh 関連項目 .Xr ar 1 , .Xr stat 2 .Sh 歴史 これまでに少なくとも 4 つの .Nm ar フォーマットがありました。 最初のものは先頭の ``マジック'' ナンバー 0177555 (int 型で書かれていた) で示されていました。 これらのアーカイブはほとんどが 16 ビットマシン上で作られたものであり、 ヘッダは 5 つのフィールドから構成されていました。 ヘッダのフィールドにはオブジェクト名 (8 文字)、 ファイルの最終更新時間 (long 型)、 ユーザ ID (char 型)、 ファイルモード (char 型)、 そしてファイルサイズ (符号なし int 型) がありました。 ファイルはバイト数で偶数長となるようにパディングされていました。 .Pp 2 つ目のものは先頭の ``マジック'' ナンバー 0177545 (int 型で書かれていた) で示されていました。 これらのアーカイブは 16 もしくは 32 ビットマシンで作られたものであり、 ヘッダは 6 つのフィールドから構成されていました。 フィールドにはオブジェクト名 (14 文字)、 ファイルの最終更新時間 (long 型)、 ユーザおよびグループ ID (各々 char 型)、 ファイルモード (int 型)、 そしてファイルサイズ (long 型) がありました。 ファイルはバイト数で偶数長となるようにパディングされていました。 .\" For more information on converting from this format see .\" .Xr arcv 8 . .Pp 現在のアーカイブフォーマット (長い名前とスペースを含む名前をサポートしていないもの) は .Bx 4.0 で導入されました。 ヘッダは現在のフォーマットと同じですが、 16 文字以上の名前は切り捨てられ、 スペースを含む名前 (および名前の末尾にスペースがつくもの) はサポートされていません。 これらの理由により、このフォーマットに前述の拡張がなされました。 現在のこのフォーマットは .Bx 4.4 で最初に出現しました。 .Sh 互換性 現在アーカイブフォーマットは標準では規定されていません。 .At V では、昔から上述のいずれとも異なるフォーマットの アーカイブで配布されています。 diff --git a/ja_JP.eucJP/man/man5/bootparams.5 b/ja_JP.eucJP/man/man5/bootparams.5 index a357d43cb4..800eb21aa5 100644 --- a/ja_JP.eucJP/man/man5/bootparams.5 +++ b/ja_JP.eucJP/man/man5/bootparams.5 @@ -1,78 +1,78 @@ .\" .\" Copyright (c) 1994 Gordon W. Ross .\" 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. .\" .\" from: Id: bootparams.5,v 1.2 1994/10/03 19:26:13 gwr Exp .\" %Id: bootparams.5,v 1.2.2.5 1998/03/09 13:50:33 jkh Exp % -.\" jpman $Id: bootparams.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: bootparams.5,v 1.3 1998/04/29 11:35:09 kuma Stab % .\" .Dd October 2, 1994 .Dt BOOTPARAMS 5 .Os .Sh 名称 .Nm bootparams .Nd ブートパラメータデータベース .Sh 書式 .Nm /etc/bootparams .Sh 解説 .Nm ファイルは、 ディスクレスクライアントがネットワーク越しにブートする時に要求する、 ブートパラメータを指定します。 このサーバがサポートする各クライアントは、 .Nm ファイル中に、 .Nm root のパス名と (オプションで) .Nm swap 領域のパス名を含むエントリを持つ必要があります。 .Pp ファイル中の各行 (# から初まるコメント行以外) は、 クライアント名、 それに続いてクライアントの論理名にて要求するパス名から成ります。 行内部の要素は空白もしくはタブで区切られ、 バックスラッシュを使用すれば複数行を続けて使用することができます。 .Pp 例を以下に示します: .Bd -literal -offset indent dummy root=host:/export/dummy/root \\ swap=host:/export/dummy/swap \\ dump=host:/export/dummy/swap .Ed .Pp 名前が "dummy" のクライアントが、自らの論理 "root" のパス名を要求した時、 この .Tn RPC リクエストに対してパス名 .Dq Pa "host:/export/dummy/root" が返答として与えられます。"host:" 部分は必ず指定する必要があります。 .Sh 関連ファイル .Bl -tag -width /etc/bootparams -compact .It Pa /etc/bootparams デフォルトの構成ファイル .El .Sh 関連項目 .Xr bootparamd 8 , .Xr diskless 8 diff --git a/ja_JP.eucJP/man/man5/bootptab.5 b/ja_JP.eucJP/man/man5/bootptab.5 index 9401f95b53..e2e8849165 100644 --- a/ja_JP.eucJP/man/man5/bootptab.5 +++ b/ja_JP.eucJP/man/man5/bootptab.5 @@ -1,395 +1,395 @@ .\" Copyright (c) 1988, 1989, 1991 Carnegie Mellon University .\" .\" %Header: /home/ncvs/src/libexec/bootpd/bootptab.5,v 1.1.1.2.2.2 1998/02/18 05:55:30 jkh Exp % .\" .TH BOOTPTAB 5 "October 31, 1991" "Carnegie Mellon University" -.\" jpman $Id: bootptab.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: bootptab.5,v 1.3 1998/07/02 18:50:36 kumano Stab % .UC 6 .SH 名称 bootptab \- インターネットブートストラッププロトコルサーバのデータベース .SH 解説 .I bootptab ファイルは、 .IR bootpd すなわちインターネットブートストラッププロトコルサーバの 設定データベースファイルです。 このフォーマットは .IR termcap (5) のものに似ており、2 文字の大文字小文字を区別するタグシンボルが ホストパラメータを表現します。 これらのパラメータ宣言はコロン (:) によって分けられ、次のような形式になります。 .PP .I " hostname:tg=value. . . :tg=value. . . :tg=value. . . ." .PP ここで .I hostname は実際の bootp クライアントの名前 (もしくは「ダミーエントリ」) であり、 .I tg は 2 文字のタグシンボルです。 ダミーエントリは不正なホスト名 ("." を最初の文字とする名前) を持ち、 .B tc=.dummy-entry 機構を介して他のエントリにデフォルト値を提供します。 ほとんどのタグの後には、上記のように等号と値を続ける必要があります。 値を伴わないブール形式のものもあります (すなわち .RI : tg : の形式です)。 現在、認識されるタグを示します: .PP .br bf ブートファイル .br bs 512 オクテットブロックでのブートファイルの大きさ .br cs クッキーサーバのアドレスリスト .br df メリットダンプファイル .br dn ドメイン名 .br ds ドメインネームサーバのアドレスリスト .br ef 拡張ファイル .br gw ゲートウェイのアドレスリスト .br ha ホストのハードウェアアドレス .br hd ブートファイルのホームディレクトリ .br hn クライントのホスト名をクライアントに送る .br ht ホストのハードウェアタイプ (Assigned Numbers RFC を参照) .br im インプレスサーバのアドレスリスト .br ip ホストの IP アドレス .br lg ログサーバのアドレスリスト .br lp LPR サーバのアドレスリスト .br ns IEN-116 ネームサーバのアドレスリスト .br nt NTP (時刻) サーバ (RFC 1129) .br ra 返答アドレスの上書き .br rl リソースロケーションプロトコルサーバのアドレスリスト .br rp ルートとしてマウントするルートパス .br sa クライアントが使用すべき TFTP サーバのアドレス .br sm ホストのサブネットマスク .br sw スワップサーバのアドレス .br tc テーブル継続 (同様の「テンプレート」ホストエントリを指します) .br td 「安全な」 TFTP サーバが使用するルートディレクトリ .br to 秒で表現した UTC からのオフセット .br ts タイムサーバのアドレスリスト .br vm ベンダマジッククッキーセレクタ .br yd YP (NIS) のドメイン名 .br ys YP (NIS) のサーバアドレス .PP 包括的な .RI T n タグもあります。ここで .I n は RFC1084 のベンダフィールドタグ番号です。 これにより、まず .I bootpd を変更しなくとも、 RFC1084 に対する将来の拡張の利点をすぐに利用することができます。 包括的なデータは、 16 進数のストリームもしくはクォートされた ASCII 文字列として表現されます。 包括的なデータの長さは自動的に判定され、 RFC1084 スタイルのブートストラップリプライの適切なフィールドに挿入されます。 .PP 以下のタグは空白で区切られた IP アドレスのリストを取ります: .BR cs , .BR ds , .BR gw , .BR im , .BR lg , .BR lp , .BR ns , .BR nt , .BR ra , .BR rl , .BR ts 。また .BR ip , .BR sa , .BR sw , .BR sm , .B ys タグはそれぞれ単一の IP アドレスを取ります。 IP アドレスは全て標準のインターネット「ドット」表記で指定されます。 10 進数、8 進数、16 進数のいずれも使用可能です (8 進数は 0 から始まり、16 進数は '0x' または '0X' から始まります)。 IP アドレスは代りにホスト名で指定可能です。 この場合、 .I bootpd はそのホスト名の IP アドレスを得るために gethostbyname(3) を使用します。 もし .B ip タグが指定されなかった場合、 .I bootpd はエントリ名をホスト名とすることにより IP アドレスを判定します。 (ダミーエントリは不正なホスト名とすることにより、 自動的な IP 検索を避けます) .PP .B ht タグは、10 進数・8 進数・16 進数の符号無し整数、 もしくは以下のいずれかのシンボル名をもって、 ハードウェアタイプコードを指定します。 .BR ethernet , .B ether は 10Mb イーサネットを、 .BR ethernet3 , .B ether3 は 3Mb の実験的イーサネットを、 .BR ieee802 , .BR tr , .B token-ring は IEEE 802 ネットワークを、 .B pronet は Proteon ProNET Token Ring を、 .BR chaos , .BR arcnet , .B ax.25 は Chaos, ARCNET, AX.25 Amateur Radio networks を、それぞれ表現します。 .B ha タグは、ホスト名もしくは数値形式で、ハードウェアアドレスを指定します。 数値形式は 16 進数で指定する .I 必要があります 。可読性のためにピリオドを付けたり、前に '0x' を付けても良いです。 .B ha タグの前に .B ht タグがある必要があります (明示的でも暗黙的でもかまいません。後述の .B tc 参照)。ハードウェアアドレスが指定されない場合、指定されたタイプが \&"ethernet" もしくは \&"ieee802" の場合、 .I bootpd は ether_hostton(3) を使用してハードウェアアドレスを決定しようとします。 .PP ホスト名・ホームディレクトリ・ブートファイルは ASCII 文字列であり、 ダブルクォート (") で括ることもできます。 クライアントのリクエストおよび .B hd シンボルと .B bf シンボルの値は、bootp リプライパケットのブートファイルフィールドを サーバがどのように埋めるかを決定します。 .PP クライアントがファイル名を指定した場合、それはそのまま残されます。 そうでない場合は、 .B bf オプションが指定されていれば、その値がリプライパケットにコピーされます。 もし .B hd オプションも指定されている場合には、 その値がリプライパケットにコピーされるブートファイルの前に付きます。 ブートファイルの存在確認は .BR bs =auto オプションが使用されているときのみ行われます (ブートファイルサイズ確認のためです)。 ブートファイルが存在しようとしまいと、リプライは送られます。 .PP 新しいバージョンの .I tftpd では、 .IR chroot (2) システムコールを使用してルートディレクトリを変更するという セキュリティ機能を提供します。 .B td タグは、 .IR tftpd が使用するこの特殊ルートディレクトリを .I bootpd に通知するために使用します。 (代りに .I bootpd "-c chdir" オプションを使用したいかもしれません。) 実際、 .B hd タグは .B td タグにより指定されるルートディレクトリからの相対指定です。 例えば、BOOTP クライアントブートファイルの現実の絶対パスが /tftpboot/bootfiles/bootimage であり、 .IR tftpd が /tftpboot を「安全な」ディレクトリとする場合、 .IR bootptab では次のように指定します。 .PP .br :td=/tftpboot:hd=/bootfiles:bf=bootimage: .PP ブートファイルを直接 /tftpboot に置く場合には次のようにします。 .PP .br :td=/tftpboot:hd=/:bf=bootimage: .PP .B sa タグは、あなたがクライアントに使用させたい特定の TFTP サーバの IP アドレスを 指定するために使用します。 このタグを指定しないと、 .I bootpd が実行されているのと同じマシンに対して TFTP を行うように、 .I bootpd はクライアントに指示します。 .PP 時刻オフセット .B to は、クライアントの UTC からのタイムゾーンオフセットを秒で表現した 符号付き 10 進数、 またはサーバのタイムゾーンオフセットを使用することを意味するキーワード .B auto です。 .B to シンボルをブール値として指定することは、 .B auto を値として指定するのと同じ効果があります。 .PP ブートファイルサイズ .B bs は、10 進数・8 進数・16 進数の整数で ブートファイルのサイズを 512 オクテットブロックで表現したもの、 またはサーバが各リクエストに際して ブートファイルサイズを自動的に計算することを示すキーワード .B auto です。 時刻オフセットと同じく、 .B bs シンボルをブール値として指定することは、 .B auto を値として指定するのと同じ効果があります。 .PP ベンダマジッククッキーセレクタ ( .B vm タグ) は以下のキーワードのいずれかを取ります。 .B auto (ベンダ情報をクライアントリクエストから判別)、 .B rfc1048 または .B rfc1084 (常に RFC1084 スタイルのリプライを強制)、または .B cmu (常に CMU スタイルのリプライを強制) です。 .PP .B hn タグは厳密にブール値のタグです。通常の等号および値を取りません。 このタグが存在すると、ホスト名を RFC1084 クライアントに送ることを意味します。 .I bootpd は、構成ファイルで指定されるホスト名全体を送ろうとします。 リプライパケットに収まらない場合、 名前は (存在するならば最初のピリオドまでの) ホストフィールドのみに縮められ、 再度試されます。 任意の長さに縮められたホスト名が送られてしまうということはありません (収まるものがない場合には、なにも送られません)。 .PP しばしば、多くのホストエントリが特定のタグの共通の値を共有します (ネームサーバなど)。 これらのタグを何度も書くのではなく、 全体仕様を 1 つのホストエントリに記述してこれを .B tc (テーブル継続) 機構を介して共有することができます。 多くの場合、このテンプレートエントリは実際には存在しないダミーホストであり、 bootp リクエストを送ることはありません。 この機能は、 .IR termcap (5) で似た端末を記述するための .B tc 機能に似ています。 .I termcap では最後のタグでなければなりませんが、 .I bootpd では .B tc タグシンボルがホストエントリ中のどこにあらわれても良いことに注意してください。 ホストに対して明示的に指定した情報は、エントリ中の .B tc タグシンボルの位置にかかわらず、これにより暗黙に指定される情報を上書きします。 .B tc タグの値はホスト名もしくは構成ファイルで前に記述されている IP アドレスです。 .PP .BR tc タグで暗示された特定のタグの削除が必要になることがあります。 これは .IB tag @ 構造を使用することにより、 .IR termcap (5) の場合と同様に .I tag の効果を削除することにより実現できます。 例えば、IEN-116 ネームサーバ仕様を完全に無効にしたい場合には、 構成ファイルのエントリの適切な位置に \&":ns@:" を置きます。 .BR @ を使用して削除を行った後には、 .B tc 機構を使用してそのタグを再度設定することができます。 .PP 構成ファイル中の、空行および "#" で始まる行は無視されます。 ホストエントリは改行で分けられます。 単一のホストエントリは、 行がバックスラッシュ (\\) で終る場合に複数行にまたがることができます。 行が 80 文字を越えることも許されます。 タグは任意の順序で現われてかまいませんが、次のような例外があります。 ホスト名はエントリの最初のフィールドである必要があり、 ハードウェアタイプはハードウェアアドレスの前に指定する必要があります。 .PP .I /etc/bootptab ファイルの例を示します: .PP .nf # Sample bootptab file (domain=andrew.cmu.edu) .default:\\ :hd=/usr/boot:bf=null:\\ :ds=netserver, lancaster:\\ :ns=pcs2, pcs1:\\ :ts=pcs2, pcs1:\\ :sm=255.255.255.0:\\ :gw=gw.cs.cmu.edu:\\ :hn:to=-18000: carnegie:ht=6:ha=7FF8100000AF:tc=.default: baldwin:ht=1:ha=0800200159C3:tc=.default: wylie:ht=1:ha=00DD00CADF00:tc=.default: arnold:ht=1:ha=0800200102AD:tc=.default: bairdford:ht=1:ha=08002B02A2F9:tc=.default: bakerstown:ht=1:ha=08002B0287C8:tc=.default: # Special domain name server and option tags for next host butlerjct:ha=08002001560D:ds=128.2.13.42:\\ :T37=0x12345927AD3BCF:\\ :T99="Special ASCII string":\\ :tc=.default: gastonville:ht=6:ha=7FFF81000A47:tc=.default: hahntown:ht=6:ha=7FFF81000434:tc=.default: hickman:ht=6:ha=7FFF810001BA:tc=.default: lowber:ht=1:ha=00DD00CAF000:tc=.default: mtoliver:ht=1:ha=00DD00FE1600:tc=.default: .fi .SH 関連ファイル /etc/bootptab .SH "関連項目" bootpd (8), tftpd(8) .br DARPA Internet Request For Comments RFC951, RFC1048, RFC1084, Assigned Numbers diff --git a/ja_JP.eucJP/man/man5/core.5 b/ja_JP.eucJP/man/man5/core.5 index 9ce0a27ce4..39069976e4 100644 --- a/ja_JP.eucJP/man/man5/core.5 +++ b/ja_JP.eucJP/man/man5/core.5 @@ -1,110 +1,110 @@ .\" 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. .\" .\" @(#)core.5 8.3 (Berkeley) 12/11/93 .\" %Id: core.5,v 1.2.2.2 1998/05/11 03:42:44 steve Exp % .\" -.\" jpman $Id: core.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: core.5,v 1.3 1998/06/12 15:55:30 kumano Stab % .\" .Dd December 11, 1993 .Dt CORE 5 .Os BSD 4 .Sh 名称 .Nm core .Nd メモリイメージのファイルフォーマット .Sh 書式 .Fd #include .Sh 解説 プロセスを異常終了させる少数のシグナルは、 プロセスのメモリ内状態の記録をディスクに書き出させる効果もあります。 これにより、デバッガを使用して後で検査を行うことが可能です。( .Xr sigaction 2 を参照してください。) このメモリイメージは作業ディレクトリの .Nm プログラム名.core という名前のファイルに書かれます。 ただし、終了したプロセスがそのディレクトリに書きこみ権限を持ち、 発生した異常がシステムを破壊しないことが前提です。 (システムが破壊された場合には、 コアファイルを保存するかどうかの決定は不定です。 .Xr savecore 8 を参照してください。) .Pp .Nm プログラム名.core ファイルの最大サイズは .Xr setrlimit 2 により制限されます。 制限よりも大きくなるファイルは生成されません。 .Pp .Nm プログラム名.core ファイルは、(ページ数での) 大きさが .Aq Pa sys/param.h ファイルで .Dv UPAGES と定義されている .Fa u . 領域からなります。 .Fa u . 領域は .Aq Pa sys/user.h に記述されている .Fa user 構造体から始まります。 .Nm プログラム名.core の残りの部分には、 データページに続いてプロセスイメージのスタックページが格納されます。 .Nm プログラム名.core ファイル中のデータ空間イメージの (ページ数での) 大きさは、 .Fa u . 領域の変数 .Fa u_dsize で与えられます。 コアファイル中のスタックイメージの (ページ数での) 大きさは、 .Fa u . 領域の変数 .Fa u_ssize で与えられます。 ``ページ'' サイズは定数 .Dv PAGE_SIZE .\" docs/6573 の内容を反映 horikawa@jp.freebsd.org 1998/05/18 で与えられます (これも .Aq Pa sys/param.h から与えられます)。 .Sh 関連項目 .Xr gdb 1 , .Xr kgdb 1 , .Xr setrlimit 2 , .Xr sigaction 2 .Sh 歴史 .Nm core ファイルのフォーマットは .At v6 に登場しました。 diff --git a/ja_JP.eucJP/man/man5/crontab.5 b/ja_JP.eucJP/man/man5/crontab.5 index 846c0551ba..dddc38f22a 100644 --- a/ja_JP.eucJP/man/man5/crontab.5 +++ b/ja_JP.eucJP/man/man5/crontab.5 @@ -1,223 +1,223 @@ .\"/* Copyright 1988,1990,1993,1994 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 uunet!decwrl!vixie!paul .\" */ .\" .\" %Id: crontab.5,v 1.1.1.1.8.4 1998/07/18 11:09:18 jkh Exp % .\" -.\" jpman $Id: crontab.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: crontab.5,v 1.3 1998/07/02 14:12:25 horikawa Stab % .\" .\" WORD: day of the week 曜日 .Dd January 24, 1994 .Dt CRONTAB 5 .Os .Sh 名称 .Nm crontab .Nd cron を駆動するための一覧表 .Sh 解説 1 つの .Nm ファイルには ``この日のこの時間にこのコマンドを実行せよ'' という一般的な形式の .Xr cron 8 デーモンへの複数の指示が含まれています。 各々ユーザは各自所有の crontab を持ち、crontab に書かれたコマンドはその crontab を所有するユーザとして実行されることになります。UUCP と News は 通常それ自身所有の crontab を持ち、cron コマンドの一部として .Xr su 1 を実際に実行させる必要のないようにしています。 .Pp 空行と、先頭の空白およびタブは無視されます。 最初の非空白文字がポンド記号 (#) である行は注釈行であり、無視されます。 注釈は cron コマンドと同じ行にあってはいけません。 なぜなら、注釈自身がコマンドの一部とみなされるからです。 同様に、注釈は環境変数を設定する行と同じ行にあって はいけません。 .Pp crontab の中で有効なのは環境変数の設定かまたは cron コマンドのどちらかです。 環境変数の設定は次のような形で行います。 .Pp name = value .Pp ここで等号 (=) の周囲の空白は有っても良いですが、 .Em value の中で = に引き続くスペースでない部分だけが .Em name に割当てられる値となります。 .Em value 文字列はクォート (シングルクォートまたはダブルクォートですがどちらかに統一します) で囲うこともでき、そのときには = に続くブランクや末尾のブランク を含むことができます。 .Pp いくつかの環境変数は自動的に .Xr cron 8 デーモンによって設定されます。 .Ev SHELL は .Pa /bin/sh に設定され、 .Ev LOGNAME と .Ev HOME はその crontab の所有者の .Pa /etc/passwd 行を元に設定されます。 .Ev HOME と .Ev SHELL は、crontab ファイル中で設定することで上書きできますが、 .Ev LOGNAME はできません。 .Pp (別注: .Ev LOGNAME 変数は BSD システム上では .Ev USER と呼ばれることがあります。このようなシステム上では .Ev USER も設定されます。) .Pp .Ev LOGNAME , .Ev HOME , .Ev SHELL に加え、 ``この'' crontab で実行したコマンドの実行結果をメールで送る理由がある場合、 .Xr cron 8 は .Ev MAILTO を見ます。 .Ev MAILTO が定義されていて (かつ空でない) とき、そこで指定された名前のユーザへメール が送られます。 .Ev MAILTO が定義されているが空のとき (MAILTO="")、メールは送られません。 その他の場合にはメールは crontab の所有者に送られます。 cron インストール時に、メーラとして .Pa /usr/lib/sendmail ではなく .Pa /bin/mail を使う場合、このオプションは有用です -- .Pa /bin/mail はエリアスを行いませんし、UUCP は通常自分宛のメールを読みません。 .Pp cron コマンドのフォーマットはほとんど V7 標準であり、多くの上位互換拡張を 持っています。各行は 5 つの時間と日付の欄、システム crontab ファイルの場合は続いてユーザ名 (``:<グループ>'' および ``/<ログインクラス>'' の添字が付くこともあります)、 その後にコマンドが続きます。分、時間、月の欄と現在の時刻が一致し、 .Em かつ 2 つの日付欄 (月における日または曜日) のうちの少なくとも 1 つと 現在の時刻が一致したとき (下記の ``注'' 参照) に、コマンドは .Xr cron 8 により実行されます。 .Xr cron 8 は 1 分ごとに cron エントリを調べます。時間と日付の欄は次のとおりです。 .Bd -literal -offset indent 欄 　　　　　　　　　許される値 ------------ ------------------------------------------------ 分 0-59 時間 0-23 月における日 1-31 月 1-12 (または名前、下記参照) 曜日 0-7 (0 および 7 は日曜のこと。名前を用いてもよい) .Ed .Pp 欄はアスタリスク (*) でも良いですが、このときには常に "最初-最後" を表すこ とになります。 .Pp 数値領域を指定できます。領域指定は、2 つの数をハイフンでつなげたものです。 指定された領域は、両端を含みます。 たとえば ``時間'' エントリの 8-11 は、 8, 9, 10, 11 時の実行を指定することになります。 .Pp リスト指定もできます。リスト指定はコンマによって数 (または領域指定) をつな げた 1 組のことです。例: ``1,2,5,9'', ``0-4,8-12''。 .Pp 間隔値は領域指定と共に用いることができます。領域指定に続けて ``/<数>'' を指定すると、その領域を通じてその数の値だけ飛ばす値になります。 たとえば ``0-23/2'' は時間の欄で用いられると、2 時間おきにコマンドを実行 することになります (別の方法で V7 標準で表せば ``0,2,4,6,8,10,12,14,16,18,20,22'' となります)。間隔指定はアスタリスクの 後で付けても構いません。たとえば ``2 時間おきに全て'' ということをしたい なら ``*/2'' とするだけです。 .Pp ``月'' および ``曜日'' の指定には、名前を使用することができます。 曜日と月の指定には、最初の 3 文字を使ってください (この場合、 大文字・小文字の区別はありません)。名前による領域指定やリスト指定はでき ません。 .Pp ``6 番目'' の欄 (行の残りの部分) には実行したいコマンドを指定します。行の 中のコマンド部全体、これは改行または % 文字までですが、は .Pa /bin/sh かまたはその cron ファイルの .Ev SHELL 変数で指定されたシェルによって実行されます。コマンド内のパーセント記号 (%) はバックスラッシュ (\\) でエスケープされない限り改行文字に変換され、そ の最初の % 以降の全てのデータはそのコマンドの標準入力となります。 .Pp 注: コマンド実行の日付は 2 つの欄 \(em 1 ヶ月中の日 および曜日 \(em で指定できます。両方の欄が領域限定されている (すなわち * でない ) 場合、コマンドは .Em どちらかの 欄が現在の時刻と一致するときに実行されます。たとえば .br ``30 4 1,15 * 5'' は各月の 1 日および 15 日に加えて全ての金曜日において、 午前 4:30 にコマンドを実行させます。 .Sh cron ファイルの例 .Bd -literal # /etc/passwd の設定に関係なく、コマンドの実行には /bin/sh を用いる SHELL=/bin/sh # これが誰の crontab であっても、全ての出力は `paul' にメールする MAILTO=paul # # 毎月 深夜 0時5分 に実行する 5 0 * * * $HOME/bin/daily.job >> $HOME/tmp/out 2>&1 # 毎月の最初の日の PM 2:15 に実行する -- 出力結果は paul にメールされる 15 14 1 * * $HOME/bin/monthly # ウィークディの PM 10 時に実行して Joe をうるさがらせる 0 22 * * 1-5 mail -s "It's 10pm" joe%Joe,%%Where are your kids?% 23 0-23/2 * * * echo "run 23 minutes after midn, 2am, 4am ..., everyday" 5 4 * * sun echo "run at 5 after 4 every sunday" .Ed .Sh 関連項目 .Xr crontab 1 , .Xr cron 8 .Sh 機能拡張項目 曜日を指定するとき、日 0 と日 7 は日曜日とみなされます。BSD お よび ATT はこれに同意しないようです。 .Pp リスト指定および領域指定は同じ欄内で指定できます。"1-3,7-9" は ATT や BSD cron では受け付けません -- "1-3" や "7,8,9" だけが許されます。 .Pp 領域指定は ``間隔指定'' を含むことができますので "1-9/2" は "1,3,5,7,9" と 同じことになります。 .Pp 月の名前や曜日の名前は、名前で指定できます。 .Pp 環境変数は crontab の中で指定できます。BSD や ATT では 子プロセスに渡さ れた環境変数は基本的に .Pa /etc/rc から渡された環境変数です。 .Pp crontab 所有者へメールされる (BSD はできません) コマンド出力結果は、 crontab 所有者以外の人へメールしたり (SysV はできません)、 この機能を停止して誰にもメールを送らなくできます (SysV はこれもできません) 。 .Sh 作者 .An Paul Vixie Aq paul@vix.com diff --git a/ja_JP.eucJP/man/man5/ctm.5 b/ja_JP.eucJP/man/man5/ctm.5 index 4b10fb421e..c3a02f9e1a 100644 --- a/ja_JP.eucJP/man/man5/ctm.5 +++ b/ja_JP.eucJP/man/man5/ctm.5 @@ -1,225 +1,225 @@ .\"---------------------------------------------------------------------------- .\""THE BEER-WARE LICENSE" (Revision 42): .\" wrote this file. As long as you retain this notice you .\"can do whatever you want with this stuff. If we meet some day, and you think .\"this stuff is worth it, you can buy me a beer in return. Joerg Wunsch .\"---------------------------------------------------------------------------- .\" .\" This manual page is partially obtained from Poul-Hennings CTM README .\" file. .\" .\" CTM and ctm(1) by .\" .\" %Id: ctm.5,v 1.3.2.2 1998/07/18 11:09:44 jkh Exp % .\" -.\" jpman $Id: ctm.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: ctm.5,v 1.3 1998/07/02 14:18:10 horikawa Stab % .\" .Dd March 25, 1995 .Os .Dt CTM 5 .Sh 名称 .Nm ctm .Nd source code mirror system .Sh 解説 .Nm は CTM デルタと呼ばれる特別のファイルフォーマットでデータを送ります。 CTM デルタは制御行とデータ塊を含みます。 各制御行は .Dq CTM という文字で始まり、CTM 文と制御データが続いて、文字 '\en' で終ります。 データ塊は常に先行する制御行に属して、その制御行の 最後のフィールドにはデータ塊のバイト数が入っています。 後に続く改行文字 '\en' が各データ塊に続き、この 改行は塊には含まれずバイト数にも数えられません。 CTM 文は以下の形式をとります。 .Bl -tag -width indent .It _BEGIN Ar version name number timestamp prefix これが CTM デルタファイル全体の始まりです。 .Ar version フィールドはプログラムのバージョンと一致しなければなりません .Pq 現在は 2.0 。 .Ar name は名前で .Ar number は CTM サービスの通し番号です。通し番号はファイル .Pa .ctm_status と照合され、そのデルタがすでに適用されていないかの確認に使われます。 .Ar timestamp はデルタ生成日時の年、月、日、時、分、秒を参考のために含みます .Po 文字 .Sq Z が続いて UTC のタイムスタンプであることを示します .Pc 。 .Ar prefix フィールドは現在実装されていません。 .It _END Ar md5 この文で CTM デルタは終了します。 .Ar md5 は全体のチェックサムで デルタ全体の MD5 チェックサムと照合されます。 デルタ全体とは ``_END'' に続く空白 (0x20) 文字までのことです。 .It \&FM Ar name uid gid mode md5 count ファイル .Ar name を作成します。元のファイルは uid として .Ar uid .Pq 数値、10進 を、 gid として .Ar gid .Pq 数値、10進 を、モードとして .Ar mode .Pq 数値、8進 を、そして MD5 チェックサムとして .Ar md5 を持ちます。 続く .Ar count バイトのデータが新しいファイルの内容です。 .It \&FS Ar name uid gid mode md5before md5after count ファイル .Ar name の内容を置き換えます。 元のファイルは新しい uid として .Ar uid .Pq 数値、10進 を、新しい gid として .Ar gid .Pq 数値、10進 を、新しいモードとして .Ar mode .Pq 数値、8進 を、古い MD5 チェックサムとして .Ar md5before を、そして新しい MD5 チェックサムとして .Ar md5after を持ちます。 続く .Ar count バイトのデータが新しいファイルの内容です。 ファイルを編集するためのコマンドがファイルサイズを超えてしまい 置き換えの方が効率的な場合に、ファイルの置き換えが使われます。 .It \&FN Ar name uid gid mode md5before md5after count ファイル .Ar name を編集します。引数は上にある通りですが、データ部分には .Xr diff 1 の -n スクリプトを含み該当ファイルに適用されます。 .It \&FR Ar name md5 ファイル .Ar name を削除します。 対象ファイルの MD5 チェックサムが .Ar md5 と一致しなければなりません。 .It \&AS Ar name uid gid mode 元のファイル .Ar name の所有者を .Ar uid に、グループを .Ar gid に、そして/またはモードを .Ar mode に変更します。 .It \&DM Ar name uid gid mode ディレクトリ .Ar name が作成されます。元々、ディレクトリの所有者は .Ar uid 、グループは .Ar gid 、そしてモードは .Ar mode でした。 .It \&DR name ディレクトリ .Ar name を削除します。 .El .Sh 使用例 以下の使用例では、長い行は表示できるように改行してあります .Pq バックスラッシュを付けてあります 。 .Bd -literal CTM_BEGIN 2.0 cvs-cur 485 19950324214652Z . CTMFR src/sys/gnu/i386/isa/scd.c,v 5225f13aa3c7e458f9dd0d4bb637b18d CTMFR src/sys/gnu/i386/isa/scdreg.h,v e5af42b8a06f2c8030b93a7d71afb223 CTMDM src/sys/gnu/i386/isa/Attic 0 552 775 CTMFS .ctm_status 545 552 664 d9ccd2a84a9dbb8db56ba85663adebf0 \\ e2a10c6f66428981782a0a18a789ee2e 12 cvs-cur 485 CTMFN CVSROOT/commitlogs/gnu 545 552 664 \\ 5d7bc3549140d860bd9641b5782c002d 7fb04ed84b48160c9b8eea84b4c0b6e3 394 a6936 21 ache 95/03/24 09:59:50 Modified: gnu/lib/libdialog kernel.c prgbox.c Log: [...] CTM_END 74ddd298d76215ae45a077a4b6a74e9c .Ed .Sh 関連項目 .Xr ctm 1 , .Xr ctm_rmail 1 , .Xr ed 1 . .Sh 歴史 最初の試用は .Fx 1.1.5 で行われて、多くのバグと手法が出されました。 CTM システムは .Fx 2.1 で公開されました。 .Sh 作者 CTM システムは .An Poul-Henning Kamp .Aq phk@FreeBSD.org によって設計、実装が行われました。 このマニュアルページは .An Joerg Wunsch .Aq joerg@FreeBSD.org が書きました。 diff --git a/ja_JP.eucJP/man/man5/cvs.5 b/ja_JP.eucJP/man/man5/cvs.5 index ebd17d5eed..9cf0c1a3d9 100644 --- a/ja_JP.eucJP/man/man5/cvs.5 +++ b/ja_JP.eucJP/man/man5/cvs.5 @@ -1,365 +1,365 @@ -.\" jpman $Id: cvs.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: cvs.5,v 1.2 1998/06/13 12:32:50 horikawa Chk % .\" WORD: concurrent version system: コンカレントバージョンシステム [cvs.1,cvs.5] .\" WORD: repository: (CVS の)リポジトリ [cvs.1,cvs.5] .\" WORD: commit: (通常の文中では)コミット [cvs.1,cvs.5] .\" WORD: check out: (通常の文中では)チェックアウト [cvs.1,cvs.5] .\" WORD: wrapper: ラッパ .\" WORD: newsgroup: ニュースグループ [limits.1,patch.1,init.8 のニュース] .\" WORD: history: (CVS の) ヒストリ [cvs.1,cvs.5] .\" WORD: template: テンプレート .TH cvs 5 "12 February 1992" .\" Full space in nroff; half space in troff .de SP .if n .sp .if t .sp .5 .. .SH NAME cvs \- コンカレントバージョンシステムのサポートファイル .SH 書式 .hy 0 .na .TP .B $CVSROOT/CVSROOT/commitinfo,v .TP .B $CVSROOT/CVSROOT/cvsignore,v .TP .B $CVSROOT/CVSROOT/cvswrappers,v .TP .B $CVSROOT/CVSROOT/editinfo,v .TP .B $CVSROOT/CVSROOT/history .TP .B $CVSROOT/CVSROOT/loginfo,v .TP .B $CVSROOT/CVSROOT/modules,v .TP .B $CVSROOT/CVSROOT/rcsinfo,v .TP .B $CVSROOT/CVSROOT/taginfo,v .ad b .hy 1 .SH 解説 .B cvs は、ソースディレクトリの階層的な集合を 管理するシステムです。 \fBcvs\fP を使う際のコマンドと手続きは .BR cvs ( 1 ) に記述されています。 .SP .B cvs は、リビジョン管理されたファイルのマスタコピーを含むディレクトリである \fIソースリポジトリ\fP を管理し、 ここから開発者の個人的な \fI作業ディレクトリ\fP へ特定のリビジョンの ファイルをコピーしたり、作業ディレクトリから修正を採り入れたりします。 ファイルの構造という点から見ると、各ソースリポジトリは \fB$CVSROOT\fP の直下のサブディレクトリになります。 .SP ここで示すファイルは補助的なファイルであり、 \fBcvs\fP を利用するにあたってなくてはならないものではありませんが、 \fBcvs\fP をより柔軟に操作することができるようになります。 .SP \fBcvs\fP により管理されているソースの集合に分かり易い 名前をつけるために、`\|modules\|' を利用できます。 `\|modules\|' が存在しなければ、開発者は \fBcvs\fP コマンドで ファイルを操作する際に完全なパス名 (絶対パスもしくは \fB$CVSROOT\fP からの相対パス) を指定しなければなりません。 .SP `\|\fBcvs commit\fP\|' が実行される際に常に実行されるプログラムを 定義するために、`\|commitinfo\|' ファイルを利用できます。 これらのプログラムは、修正、追加、削除されたファイルが本当に コミットされる準備ができているかどうかをチェックする「コミット前の」 チェックとして用いられます。 このチェックを、ソースリポジトリの一部 (もしくは全体) から 特定の人やグループを除外するために利用している人もいます。 また、変更されたファイルがそのサイトのコーディング規約に 沿っているかどうかを確かめるためにも利用されるでしょう。 .SP ファイルがリポジトリにチェックインされる時や、リポジトリから チェックアウトされる時に使われるラッパコマンドを .B cvs に登録するために、 `\|cvswrappers\|' ファイルを利用できます。 ラッパは CVS に入ってくる、もしくは CVS から出ていくファイルや ディレクトリを加工することができます。 使い方はいろいろありますが、一例としては、 ファイルがチェックインされる前に C ファイルを整形し、 リポジトリ内の全てのコードの見栄えを揃えるという用法があります。 .SP .BR commit 後に常に実行される、 リポジトリ内の変更に関するログエントリを書き込むプログラムを定義するために、 `\|loginfo\|' ファイルを利用できます。 これらのプログラムは、ファイルにログメッセージを追加したり、 電子メールを通じて開発者のグループにログメッセージを送ったり、 特定のニュースグループにログメッセージを投稿したりするために使われます。 .SP .BR tag 操作や .BR rtag 操作の後で実行されるプログラムを定義するために、 `\|taginfo\|' ファイルを利用できます。 これらのプログラムは、 新しいタグ名とそのタグを作成したプログラマ名の一覧ファイルに メッセージを追加したり、 開発者のグループにメールを送ったり、 特定のニュースグループにメッセージを投稿したりするために使われます。 .SP ログメッセージの書式を定義するために、 `\|rcsinfo\|' ファイルを利用できます。 .SP `\|\fBcvs commit\fP\|' のログエントリを編集・確認する際に実行する プログラムを定義するために、 `\|editinfo\|' ファイルを利用できます。 これは `\|rcsinfo\|' の書式指定と共に用いると非常に便利であり、 変更をコミットするユーザが、書式の適切な欄を埋めていることを チェックすることができます。 .SP \fBupdate\fP の時に無視するファイルのデフォルトの一覧を指定するために、 `\|cvsignore\|' ファイルを利用できます。 .SP リポジトリに影響を及ぼす \fBcvs\fP コマンドを記録するために、 `\|history\|' ファイルを利用できます。 このファイルを作成するとヒストリが記録されるようになります。 .SH 関連ファイル .TP .B modules `\|modules\|' ファイルは、あなたがソースコードの集合に付けた名前を記録します。 \fBcvs\fP を使って、正しい書式でファイルを `\|\fB$CVSROOT/CVSROOT/modules,v\fP\|' にチェックインすると、 \fBcvs\fP はこれらの定義を利用するようになります。 .SP `\|modules\|' ファイルは、モジュール定義以外にも、空行やコメント (`\|\fB#\fP\|' から始まる行) を含むことができます。 長い行は、行の最後の文字にバックスラッシュ (``\e'') を置くことで 次の行に続けることができます。 .SP \fIモジュール定義\fP は `\|modules\|' ファイルの単一行で、 2 つの書式があります。どちらにおいても \fImname\fP はモジュール名を 表し、行の残りはその定義になります。 .SP \fImname\fP \fB\-a\fP \fIaliases\fP\|.\|.\|. .br これはモジュール \fImname\fP を定義する最も簡単な方法です。 `\|\fB\-a\fP\|' はこの定義が単なる別名 (alias) であることを示します。 \fBcvs\fP は (コマンドの引数として) \fImname\fP が使われると、 代わりに \fIaliases\fP の名前のリストが指定されたものとして扱います。 \fIaliases\fP には、他のモジュール名もしくはパスを指定します。 \fIaliases\fP にパスを指定すると、 \fBcvs\fP の引数に明示的にパスが指定した場合と同様、 `\|\fBcvs checkout\fP\|' は 作業ディレクトリへの全ての中間ディレクトリを作成します。 .SP .nf \fImname\fP [ \fIoptions\fP ] \fIdir\fP [ \fIfiles\fP\|.\|.\|. ] [ \fB&\fP\fImodule\fP\|.\|.\|. ] .fi .SP もっとも単純な場合、この形式のモジュール定義は `\|\fImname dir\fP\|' となります。 これはディレクトリ \fIdir\fP 内のすべてのファイルをモジュール \fImname\fP として定義します。 \fIdir\fP は (\fB$CVSROOT\fP から、ソースリポジトリ内にある) ソースファイルのディレクトリへの相対パスです。 この場合、\fBcheckout\fP 時には作業ディレクトリとして \fImname\fP という単一のディレクトリのみが作成され、 \fIdir\fP が複数ディレクトリ階層を含むパスであろうと、 中間のディレクトリはデフォルトでは作成されません。 .SP モジュール定義の \fIdir\fP の後で \fIfiles\fP を明示的に指定することで、 \fIdir\fP 内の特定のファイルを選択することができます。 \fBmodules\fP にあるサンプル定義は、あるディレクトリの 単一のファイルから定義されるモジュールの例となっています。 ここでは別の例を示します: .SP .nf .ft B m4test unsupported/gnu/m4 foreach.m4 forloop.m4 .ft P .fi .SP この定義では、`\|\fBcvs checkout m4test\fP\|' を実行すると、 単一階層の作業ディレクトリ `\|m4test\|' が作成され、 \fBcvs\fP ソースリポジトリ内の深い階層のディレクトリにある、 指定された 2 つのファイルが置かれます。 .SP モジュール定義中に `\|\fB&\fP\fImodule\fP\|' と書くことによって、 他のモジュールを参照することができます。 \fBcheckout\fP 時には、作業ディレクトリ内に各 \fImodule\fP 毎の ディレクトリが作成されます。 .br .I \fBcvs\fP 1.3 の新機能; モジュール定義ファイルを古いバージョンの \fBcvs\fP と共有する場合は、 この機能は使わないでください。 .SP そして、モジュール定義に以下の \fIoptions\fP を加えることができます: .SP \&`\|\fB\-d\fP \fIname\fP\|', モジュール名ではなく、他の名前を 作業ディレクトリの名前として用います。 .br .I \fBcvs\fP 1.3 の新機能; モジュール定義ファイルを古いバージョンの \fBcvs\fP と共有する場合は、 この機能は使わないでください。 .SP \&`\|\fB\-i\fP \fIprog\fP\|' を用いると、モジュール内のファイルが コミットされたときに実行されるプログラム \fIprog\fP を指定できます。 \fIprog\fP は、ソースリポジトリ内の影響を受けるディレクトリへの フルパスを単一引数として受け取ります。 \fBコミット\fP 時にプログラムを実行するためには、 `\|commitinfo\|', `\|loginfo\|', `\|editinfo\|' ファイルを使う方法もあります。 .SP `\|\fB\-o\fP \fIprog\fP\|' を用いると、モジュール内のファイルが チェックアウトされたときに実行されるプログラム \fIprog\fP を指定できます。 \fIprog\fP は、モジュール名を単一引数として受け取ります。 .SP `\|\fB\-e\fP \fIprog\fP\|' を用いると、モジュール内のファイルが エクスポート (export) されたときに実行される プログラム \fIprog\fP を指定できます。 \fIprog\fP は、モジュール名を単一引数として受け取ります。 .SP `\|\fB\-t\fP \fIprog\fP\|' を用いると、モジュール内のファイルに タグが付けられたときに実行されるプログラム \fIprog\fP を指定できます。 \fIprog\fP は、 モジュール名と \fBrtag\fP で指定されたシンボリックタグの 2 つを 引数として受け取ります。 .SP `\|\fB\-u\fP \fIprog\fP\|' を用いると、チェックアウトされたモジュールの トップディレクトリにて `\|\fBcvs update\fP\|' が用いられたときに 実行されるプログラム \fIprog\fP を指定できます。 \fIprog\fP は、このモジュールのソースリポジトリへのフルパスを 単一引数として受け取ります。 .TP \&\fBcommitinfo\fP, \fBloginfo\fP, \fBrcsinfo\fP, \fBeditinfo\fP これらのファイルは全て、`\|\fBcvs commit\fP\|' 処理の間の 様々な場面で呼び出されるプログラムを指定します。 これらのファイルは共通の構造を持ちます。 各行は、次の 2 つのフィールドを持ちます: すなわち、 正規表現と、 空白の後にファイル名かコマンド行のテンプレートです。 正規表現の 1 つがリポジトリ内のディレクトリ名にマッチすると、 行の残りが使われます。 行が文字 \fB#\fP で始まっている場合、コメントとして無視されます。 フィールド間の空白も無視されます。 .SP `\|loginfo\|' では、行の残りは実行されるコマンド行の テンプレートとなります。 テンプレートはプログラム名だけでなく、 好きなだけ引数を付けることもできます。 引数リストのどこかに `\|\fB%s\fP\|' を指定すると、 \fBcvs\fP はその場所に \fBコミット\fP により影響を受ける ファイルリストを列挙します。 リストの最初のエントリは、 ソースリポジトリ内の変更が行われる位置への相対パスです。 リストの残りは、この \fBコミット\fP により修正・追加・削除される ファイルとなります。 .SP `\|taginfo\|' では、行の残りは実行されるコマンド行の テンプレートとなります。 コマンドに渡される引数は、順番に .I タグ名 、 .I 操作 (すなわち、 .B add は `tag' を、 .B mov は `tag -F' を、 .B del は `tag -d` をそれぞれ意味します)、 .I リポジトリ となり、残りは全て .B ファイル名 と .B リビジョン の組となります。 フィルタプログラムが 0 以外を返して終了すると、タグ処理は中断されます。 .SP `\|commitinfo\|' では、行の残りは実行されるコマンド行の テンプレートとなります。 テンプレートはプログラム名だけでなく、 好きなだけ引数を付けることもできます。 テンプレートには現在のソースリポジトリへのフルパスが付け加えられ、 コミットにより (追加・削除・修正など) 影響をおよぼされる ファイルのファイル名が続きます。 .SP `\|rcsinfo\|' では、行の残りはログメッセージ用のテンプレートへ 読み込まれるファイルへのフルパスです。 .SP `\|editinfo\|' では、行の残りは実行されるコマンド行の テンプレートとなります。 テンプレートはプログラム名だけでなく、 好きなだけ引数を付けることもできます。 現在のログメッセージ用のテンプレートファイルへのフルパスが 最後に追加されます。 .SP 正規表現の代わりに、以下の 2 つのうちどちらかの特殊文字列 を使うことができます: `\|\fBALL\fP\|' では常に実行されるべきコマンド行テンプレート を指定し、 `\|\fBDEFAULT\fP\|' ではどの正規表現にもマッチしなかったときに 用いられるコマンド行テンプレートを指定します。 .SP `\|commitinfo\|' ファイルには、 他の \fBコミット\fP 操作が行われる \fI前に\fP 実行されるコマンドを指定し、 \fBコミット\fP が行われる前に満たすべき状況をチェックするために 利用できます。 \fBコミット\fP 操作の残りは、このファイルで指定されたコマンド全てが 終了ステータス \fB0\fP で終了したときにのみ続行されます。 .SP `\|rcsinfo\|' ファイルにより、\fBコミット\fP のログ作成の際の \fIログ用テンプレート\fP を指定できます。 このテンプレートの書式を埋めていくだけで、\fBコミット\fP ログを 作成できるようになります。 このファイルでは、正規表現より後のフィールドはコマンドテンプレートではなく、 ログ用テンプレート書式ファイル (複数可) のファイル名となります。 .SP `\|editinfo\|' ファイルにより、\fIコミットが開始する前\fP で ログ情報が記録された後の段階で実行されるスクリプトを指定できます。 これらの「編集」スクリプトは、 ログファイルに記録された情報を確認することができます。 編集スクリプトが 0 以外の終了ステータスを返した場合、コミットは中断されます。 .SP `\|loginfo\|' ファイルにより、コミットの \fI最終段階\fP で実行される コマンドを指定できます。 コミットログメッセージとして指定されたテキストはコマンドにパイプされます: よくある用法としては、メールを送る、ニュースグループの記事とする、 中央ファイルに追加書き込みするというものがあります。 .TP \&\fBcvsignore\fP, \fB.cvsignore\fP `\|\fBcvs update\fP\|' 中に無視されるデフォルトのファイル (もしくは .BR sh ( 1 ) のファイル名パターン) のリストです。 まず最初に、\fBcvs\fP はコンパイル時に組み込まれたデフォルトの ファイル名パターンのリストを読み込みます ( .BR cvs ( 1 ) を参照)。 その後、\fB$CVSROOT/CVSROOT/cvsignore\fP ファイルが存在すれば、 その中のリポジトリ毎のリストを読み込みます。 そして、`\|$HOME/.cvsignore\|' にあるユーザ毎のリストを読み込みます。 最後に、\fBcvs\fP はディレクトリを辿る時に ディレクトリ中に `\|.cvsignore\|' ファイルがあれば、それを読み込みます。 これらのディレクトリ毎のファイルは、それを含むディレクトリにのみ 有効で、サブディレクトリには作用しません。 .TP .B history ヒストリを記録するには \fB$CVSROOT/CVSROOT\fP にこのファイルを作成します (詳細は `\|\fBcvs history\fP\|' の記述を参照)。 .SH 関連項目 .BR cvs ( 1 ), .SH 著作権 Copyright \(co 1992 Cygnus Support, Brian Berliner, and Jeff Polk .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/man5/devfs.5 b/ja_JP.eucJP/man/man5/devfs.5 index c740451f90..55e3799e6f 100644 --- a/ja_JP.eucJP/man/man5/devfs.5 +++ b/ja_JP.eucJP/man/man5/devfs.5 @@ -1,95 +1,95 @@ .\" Copyright (c) 1996 .\" Mike Pritchard . All rights reserved. .\" .\" 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: devfs.5,v 1.2.2.2 1998/07/19 06:52:11 jkh Exp % .\" -.\" jpman $Id: devfs.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: devfs.5,v 1.3 1998/04/29 11:36:05 kuma Stab % .\" .\" WORD: mount point マウントポイント .\" WORD: namespace 名前空間 .\" .Dd December 14, 1996 .Dt devfs 5 .Os FreeBSD 2.2 .Sh 名称 .Nm devfs .Nd デバイスファイルシステム .Sh 書式 devfs /devs devfs rw 0 0 .Sh 解説 デバイスファイルシステム、または .Nm devfs は、グローバルファイルシステム名前空間において、 カーネルのデバイス名前空間へのアクセスを提供します。 伝統的なマウントポイントは .Pa /devs です。 .Pp このファイルシステムは、ディレクトリ、リンク、シンボリックリンク、 デバイスを含みます。 それらの中には書き込み可能なものがあります。 chroot した環境では、 .Nm を使用して新しい .Pa /devs マウントポイントを作成可能です。 .Sh 関連ファイル .Bl -tag -width /devs/XXXX -compact .It Pa /devs 通常の .Nm マウントポイント .El .Sh 関連項目 .Xr mount_devfs 8 .Sh 歴史 .Nm ファイルシステムは、最初に .Fx 2.0 に登場しました。 .Nm マニュアルページは、最初に .Fx 2.2 に登場しました。 .Sh 作者 .Nm マニュアルページは、 .Xr mount_devfs 8 マニュアルページを元に、 .An Mike Pritchard Aq mpp@FreeBSD.org が記述しました。 diff --git a/ja_JP.eucJP/man/man5/dir.5 b/ja_JP.eucJP/man/man5/dir.5 index 98937888eb..5b3766a1c4 100644 --- a/ja_JP.eucJP/man/man5/dir.5 +++ b/ja_JP.eucJP/man/man5/dir.5 @@ -1,174 +1,174 @@ .\" 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. .\" .\" @(#)dir.5 8.3 (Berkeley) 4/19/94 -.\" jpman $Id: dir.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: dir.5,v 1.3 1998/07/19 22:22:07 yohta Stab % .\" %Id: dir.5,v 1.4.2.1 1997/02/28 03:27:22 mpp Exp % .\" .\" WORD: graft 接合 [mount.8] .Dd April 19, 1994 .Dt DIR 5 .Os BSD 4.2 .Sh 名称 .Nm dir , .Nm dirent .Nd ディレクトリファイルフォーマット .Sh 書式 .Fd #include .Fd #include .Sh 解説 ディレクトリは、土台となる記憶媒体の詳細を隠蔽し、 ファイルをグループ分けする便利な階層手段を提供します。 ディレクトリファイルは、その .Xr inode 5 エントリ中のフラグによって、通常ファイルと区別されます。 ディレクトリファイルはレコード (ディレクトリエントリ) から構成され、 各レコードはファイルに関する情報とそのファイル自身へのポインタを 含んでいます。 ディレクトリエントリは、通常ファイルと同様に、 他のディレクトリを含むこともあります。 そのような入れ子になったディレクトリはサブディレクトリと呼ばれます。 このようにしてディレクトリとファイルの階層構造が形成され、 この構造はファイルシステムと呼ばれます (あるいはファイルシステムツリー と呼ばれます)。 .\" 以下の3行は英語版にコメントの形で含まれていたもの .\" An entry in this tree, .\" nested or not nested, .\" is a pathname. .Pp 各ディレクトリファイルには特別なディレクトリエントリが 2 つあります。 1 つはそのディレクトリ自身へのポインタで、ドット .Ql \&. と呼ばれます。 もう 1 つは自分の親ディレクトリへのポインタで、ドットドット .Ql \&.. と呼ばれます。 ドットとドットドットは有効なパス名ですが、 システムのルートディレクトリ .Ql / には親ディレクトリがなく、ドットドットはドットと同じく自分自身を指します。 .Pp ファイルシステムノードは普通のディレクトリファイルであり、 その上に物理ディスクやそのディスク中の分割された領域といった ファイルシステムオブジェクトを接合します ( .Xr mount 2 および .Xr mount 8 参照)。 .Pp ディレクトリエントリの形式はファイル .Aq dirent.h で定義されています: .Bd -literal #ifndef _DIRENT_H_ #define _DIRENT_H_ /* * ディレクトリエントリはその先頭に dirent 構造体を持ちます。dirent * 構造体は inode 番号、そのエントリの長さ、そのエントリに含まれる * 名前の長さを保持します。その後に、ナルで 4 バイト境界までパディング * した名前が続きます。名前は全てナルで終端していることが保証されます。 * ディレクトリ中の名前の長さの最大値は MAXNAMLEN です。 */ struct dirent { u_long d_fileno; /* エントリのファイル番号 */ u_short d_reclen; /* このレコードの長さ */ u_char d_type; /* ファイルタイプ, 以下参照 */ u_char d_namlen; /* d_name の文字列長 */ #ifdef _POSIX_SOURCE char d_name[255 + 1]; /* 名前の長さの最大値 */ #else #define MAXNAMLEN 255 char d_name[MAXNAMLEN + 1]; /* 名前の長さの最大値 */ #endif }; /* * ファイルタイプ */ #define DT_UNKNOWN 0 #define DT_FIFO 1 #define DT_CHR 2 #define DT_DIR 4 #define DT_BLK 6 #define DT_REG 8 #define DT_LKN 10 #define DT_SOCK 12 #define DT_WHT 14 #ifdef _POSIX_SOURCE typedef void * DIR; #else #define d_ino d_fileno /* 下位互換性 */ /* ディレクトリ操作ライブラリルーチン用定義 */ #define DIRBLKSIZ 1024 /* オープンしたディレクトリを記述する構造体 */ typedef struct _dirdesc { int dd_fd; /* ディレクトリに対応するファイル記述子 */ long dd_loc; /* 現バッファ中のオフセット */ long dd_size; /* getdirentriesが返すデータ量 */ char *dd_buf; /* データバッファ */ int dd_len; /* データバッファのサイズ */ long dd_seek; /* getdirentriesが返すマジッククッキー */ long dd_rewind;/* 巻き戻し用マジッククッキー */ } DIR; #define dirfd(dirp) ((dirp)->dd_fd) #ifndef NULL #define NULL 0 #endif #endif /* _POSIX_SOURCE */ #ifndef KERNEL #include #endif /* !KERNEL */ #endif /* !_DIRENT_H_ */ .Ed .Sh 関連項目 .Xr fs 5 , .Xr inode 5 .Sh 歴史 ファイル形式 .Nm は .At v7 で登場しました。 diff --git a/ja_JP.eucJP/man/man5/disklabel.5 b/ja_JP.eucJP/man/man5/disklabel.5 index 4764c052c7..a5f8481d35 100644 --- a/ja_JP.eucJP/man/man5/disklabel.5 +++ b/ja_JP.eucJP/man/man5/disklabel.5 @@ -1,394 +1,394 @@ .\" Copyright (c) 1987, 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 acknowledgment: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" 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.5.5 8.1 (Berkeley) 6/5/93 .\" %Id: disklabel.5,v 1.2.2.2 1998/07/17 20:12:59 jkh Exp % .\" -.\" jpman $Id: disklabel.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: disklabel.5,v 1.3 1998/06/12 15:48:23 kumano Stab % .\" .\" WORD: initial bootstrap 初期ブートストラップ .\" WORD: initial label 初期ラベル .\" WORD: primary bootstrap 一次ブートストラップ .\" WORD: secondary bootstrap 二次ブートストラップ .\" WORD: ratio of physical sectors traversed per logical sector 論理セクタあたりの物理セクタ通過率 .\" .Dd June 5, 1993 .Dt DISKLABEL 5 .Os .Sh 名称 .Nm disklabel .Nd ディスクパックラベル .Sh 書式 .Fd #include .Sh 解説 システム上のそれぞれのディスクやディスクパックは、ディスクのジオメトリ やディスクを分割しているパーティションについての詳細な情報を提供する ディスクラベルを持っています。 ディスクラベルはディスクがフォーマットされたときに 初期化されなければならず、 後から .Xr disklabel 8 プログラムによって変更することができます。 システムディクスドライバやブートストラッププログラムがこの情報を使って、 ドライブのプログラム方法や、ディスクパーティション上の ファイルシステムの見つけ方を決定します。 ファイルシステムは、付加的な情報を使ってディスクを最も効果的に使い、 重要なファイルシステム情報の位置を特定します。 各パーティションの記述は、パーティションタイプ(標準ファイル、スワップ 領域等)の識別子を含みます。 ラベルのメモリ内コピーにあるファイルシステム情報が不完全な場合には、 ファイルシステムはそれを更新します。 .Pp ラベルは、ドライブのセクタ番号 .Dv LABELSECTOR にあります。 通常は、ディスクジオメトリについての情報がなくても見つけられる、 セクタ 0 にあります。 ラベルは、初期ブートストラップの場所を確保するために、 セクタの先頭からオフセット .Dv LABELOFFSET にあります。 ラベルを含むディスクセクタは、通常読み込み専用になっています。 これは、 パックからパックへの複写やスワップ操作時に .Xr disklabel 8 プログラムによって必要に応じて行なわれる .Dv DIOCWLABEL .Xr ioctl 2 により不用意に上書きされないようにするためです。 .Pp ディスクのメモリ内ラベルコピーは .Dv DIOCGDINFO .Xr ioctl 2 で得られます。 この操作は、ディスクの任意のパーティションに対するブロックデバイスや キャラクタ (``raw'') デバイスへのファイル記述子に対して 行うことができます。 また、ディスクのメモリ内ラベルコピーは .Dv DIOCSDINFO .Xr ioctl 2 によりセットされます。 パーティションのオフセットは、一般にパーティションがオープンされている ときには変更したり小さくしたりはできません。 ただし例外として、ディスクにラベルが見つからず、ドライバが パーティション情報を含まない骨組みのラベルだけを構築できるときには、 どんな変更も許されます。 最後に、 .Dv DIOCWDINFO .Xr ioctl 2 操作がメモリ内のラベルをセットし、ディスク上のラベルを更新します。 この操作が成功するためにはディスク上にラベルが存在しなければなりません。 つまり、ディスクやディスクパックの初期ラベルは生の (raw) ディスクに 対して書き込むことでインストールされなければなりません。 これらの操作はすべて、普通 .Xr disklabel 8 コマンドを使って行なわれます。 .Pp .Pa で指定されるようにディスクラベルのフォーマットは以下のようになります。 .Bd -literal /* * ディスク記述テーブル, disktab(5) を参照 */ #define DISKTAB "/etc/disktab" /* * 各ディスクはハードウェアディスクジオメトリ、ファイルシステムパーティション、 * ドライブ固有の情報についての情報を含むラベルを持っています。 * ラベルはブロック 0 か 1 、つまりブートストラップ等のための場所を空けて * なるべく先頭のオフセットにあります。 */ #ifndef LABELSECTOR #define LABELSECTOR 0 /* ラベルを含むセクタ */ #endif #ifndef LABELOFFSET #define LABELOFFSET 64 /* セクタ内のラベルのオフセット */ #endif #define DISKMAGIC ((u_long) 0x82564557) /* ディスクのマジックナンバ */ #ifndef MAXPARTITIONS #define MAXPARTITIONS 8 #endif #ifndef LOCORE struct disklabel { u_long d_magic; /* マジックナンバ */ short d_type; /* ドライブタイプ */ short d_subtype; /* コントローラ/d_type に固有 */ char d_typename[16]; /* タイプ名、たとえば "eagle" */ /* * d_packname は、パック識別子を含み、ディスク上やメモリ内コピーの * ディスクラベルを読んだときに返されます。 * d_boot0 と d_boot1 は、/usr/mdec にある一次 (block 0) または * 二次 (block 1-15) ブートストラップの (省略可能な) 名前です。 * この名は、/etc/disktab から値を取り出すために getdiskbyname(3) * を使う場合に返されます。 */ #if defined(KERNEL) || defined(STANDALONE) char d_packname[16]; /* パック識別子 */ #else union { char un_d_packname[16]; /* パック識別子 */ struct { char *un_d_boot0; /* 一次ブートストラップ名 */ char *un_d_boot1; /* 二次ブートストラップ名 */ } un_b; } d_un; #define d_packname d_un.un_d_packname #define d_boot0 d_un.un_b.un_d_boot0 #define d_boot1 d_un.un_b.un_d_boot1 #endif /* ! KERNEL or STANDALONE */ /* ディスクジオメトリ */ u_long d_secsize; /* セクタあたりのバイト数 */ u_long d_nsectors; /* トラックあたりのデータセクタ数 */ u_long d_ntracks; /* シリンダあたりのトラック数 */ u_long d_ncylinders; /* ユニットあたりのデータシリンダ数 */ u_long d_secpercyl; /* シリンダあたりのデータセクタ数 */ u_long d_secperunit; /* ユニットあたりのデータセクタ数 */ /* * 以下の予備 (不良セクタ置換) は in d_nsectors や d_secpercyl * には数えられません。 * 予備セクタは、各トラックまたはシリンダの末尾の場所を占める * 物理セクタにあることにします。 */ u_short d_sparespertrack; /* トラックあたりの予備セクタ */ u_short d_sparespercyl; /* シリンダあたりの予備セクタ */ /* * メインテナンス、置換、コンフィグレーション記述領域等を * 含む交替シリンダ */ u_long d_acylinders; /* ユニットあたりの交替シリンダ */ /* ハードウェア特性 */ /* * d_interleave, d_trackskew, d_cylskew は、遅いコントローラの * 埋め合わせに使うための、メディアフォーマット中の * ぶれを記述します。 * interleave は、フォーマット時にフォーマッタやコントローラに * よって設定される物理セクタインタリーブです。 * インタリーブが使われているとき、論理的に隣り合ったセクタは * 物理的には連続ではなく、幾つかのセクタに分断されています。 * これは論理セクタあたりの物理セクタ通過率として指定されます。 * すなわち、1:1 のインタリーブは連続したレイアウトを意味し、 * 2:1 は論理セクタ 0 が論理セクタ 1 から 1 セクタ離れていること * を意味します。 * d_trackskew は、同一シリンダ上でトラック N-1 上のセクタ 0 から * トラック N のセクタ 0 の相対的なオフセットです。 * 最後の d_cylskew は、シリンダ N-1 上のセクタ 0 からシリンダ N * 上のセクタ 0 の相対的なオフセットです。 */ u_short d_rpm; /* 回転スピード */ u_short d_interleave; /* ハードウェアセクタインタリーブ */ u_short d_trackskew; /* トラックあたりのセクタ 0 スキュー */ u_short d_cylskew; /* シリンダあたりのセクタ 0 スキュー */ u_long d_headswitch; /* ハードスイッチ時間 usec */ u_long d_trkseek; /* トラック間シーク usec */ u_long d_flags; /* 一般フラグ */ #define NDDATA 5 u_long d_drivedata[NDDATA]; /* ドライブの型固有の情報 */ #define NSPARE 5 u_long d_spare[NSPARE]; /* 将来使うための予備 */ u_long d_magic2; /* マジックナンバ (再度) */ u_short d_checksum; /* データを含むパーティションの xor */ /* ファイルシステムとパーティション情報 */ u_short d_npartitions; /* 後に続くパーティション数 */ u_long d_bbsize; /* sn0 のブート領域の大きさ(バイト単位) */ u_long d_sbsize; /* fs スーパブロックの最大サイズ(バイト単位) */ struct partition { /* パーティションテーブル */ u_long p_size; /* パーティション内のセクタ数 */ u_long p_offset; /* 開始セクタ */ u_long p_fsize; /* ファイルシステム規定フラグメントサイズ */ u_char p_fstype; /* ファイルシステムタイプ、下記参照 */ u_char p_frag; /* ブロックあたりのファイルシステムフラグメント */ union { u_short cpg; /* UFS: FS グループあたりのシリンダ数 */ u_short sgs; /* LFS: FS セグメントシフト */ } __partition_u1; #define p_cpg __partition_u1.cpg #define p_sgs __partition_u1.sgs u_short p_cpg; /* グループあたりのファイルシステムシリンダ数 */ } d_partitions[MAXPARTITIONS]; /* 実際にはもっとある */ }; /* d_type values: */ #define DTYPE_SMD 1 /* SMD, XSMD; VAX hp/up */ #define DTYPE_MSCP 2 /* MSCP */ #define DTYPE_DEC 3 /* その他の DEC (rk, rl) */ #define DTYPE_SCSI 4 /* SCSI */ #define DTYPE_ESDI 5 /* ESDI インタフェース */ #define DTYPE_ST506 6 /* ST506 他 */ #define DTYPE_HPIB 7 /* CS/80 on HP-IB */ #define DTYPE_HPFL 8 /* HP ファイバリンク */ #define DTYPE_FLOPPY 10 /* フロッピー */ #ifdef DKTYPENAMES static char *dktypenames[] = { "unknown", "SMD", "MSCP", "old DEC", "SCSI", "ESDI", "ST506", "HP-IB", "HP-FL", "type 9", "floppy", 0 }; #define DKMAXTYPES (sizeof(dktypenames) / sizeof(dktypenames[0]) - 1) #endif /* * ファイルシステムタイプとバージョン * パーティションあたりの他のファイルシステム固有情報に使われます。 */ #define FS_UNUSED 0 /* 未使用 */ #define FS_SWAP 1 /* スワップ */ #define FS_V6 2 /* 第 6 版 */ #define FS_V7 3 /* 第 7 版 */ #define FS_SYSV 4 /* System V */ #define FS_V71K 5 /* 7 版 1K ブロック (4.1, 2.9) */ #define FS_V8 6 /* 8 版 4K ブロック */ #define FS_BSDFFS 7 /* 4.2BSD fast ファイルシステム */ #define FS_MSDOS 8 /* MSDOS ファイルシステム */ #define FS_BSDLFS 9 /* 4.4BSD log-structured ファイルシステム */ #define FS_OTHER 10 /* 使用中だが未知/未サポート */ #define FS_HPFS 11 /* OS/2 high-performance ファイルシステム */ #define FS_ISO9660 12 /* ISO 9660, 通常は CD-ROM */ #define FS_BOOT 13 /* ブートストラップを含むパーティション */ #ifdef DKTYPENAMES static char *fstypenames[] = { "unused", "swap", "Version 6", "Version 7", "System V", "4.1BSD", "Eighth Edition", "4.2BSD", "MSDOS", "4.4LFS", "unknown", "HPFS", "ISO9660", "boot", 0 }; #define FSMAXTYPES (sizeof(fstypenames) / sizeof(fstypenames[0]) - 1) #endif /* * 多様なドライブが共有するフラグ */ #define D_REMOVABLE 0x01 /* リムーバブルメディア */ #define D_ECC 0x02 /* ECC サポート */ #define D_BADSECT 0x04 /* バッドセクタフォワードのサポート */ #define D_RAMDISK 0x08 /* ディスクエミュレータ */ #define D_CHAIN 0x10 /* back-back 転送ができる */ /* * SMD のドライブデータ */ #define d_smdflags d_drivedata[0] #define D_SSE 0x1 /* セクタスキップのサポート */ #define d_mindist d_drivedata[1] #define d_maxdist d_drivedata[2] #define d_sdist d_drivedata[3] /* * ST506 のドライブデータ */ #define d_precompcyl d_drivedata[0] #define d_gap3 d_drivedata[1] /* フォーマット時にのみ使われる */ /* * SCSI のドライブデータ */ #define d_blind d_drivedata[0] #ifndef LOCORE /* * フォーマットや生の操作をする際に使われる * 構造体で、データやレジスタ値を返します。 * レジスタの識別とフォーマットは、 * デバイス依存、ドライバ依存です。 */ struct format_op { char *df_buf; int df_count; /* 値-結果 */ daddr_t df_startblk; int df_reg[8]; /* 結果 */ }; /* * ディスク上のパーティションに関する情報を * 引き出すために内部で使われる構造体 */ struct partinfo { struct disklabel *disklab; struct partition *part; }; /* * ディスク固有の ioctl */ /* ディスクラベルの取得と設定; 内部では DIOCGPART が使われる */ #define DIOCGDINFO _IOR('d', 101, struct disklabel) /* 取得 */ #define DIOCSDINFO _IOW('d', 102, struct disklabel) /* 設定 */ #define DIOCWDINFO _IOW('d', 103, struct disklabel) /* 設定、ディスク更新 */ #define DIOCGPART _IOW('d', 104, struct partinfo) /* パーティション取得 */ /* do format operation, read or write */ #define DIOCRFORMAT _IOWR('d', 105, struct format_op) #define DIOCWFORMAT _IOWR('d', 106, struct format_op) #define DIOCSSTEP _IOW('d', 107, int) /* ステップレート設定 */ #define DIOCSRETRIES _IOW('d', 108, int) /* リトライ回数の設定 */ #define DIOCWLABEL _IOW('d', 109, int) /* 書き込み可/不可のラベル */ #define DIOCSBAD _IOW('d', 110, struct dkbad) /* カーネル dkbad の設定 */ #endif LOCORE .Ed .Sh 関連項目 .Xr disktab 5 , .Xr disklabel 8 diff --git a/ja_JP.eucJP/man/man5/disktab.5 b/ja_JP.eucJP/man/man5/disktab.5 index 93726046f0..60cb458ab0 100644 --- a/ja_JP.eucJP/man/man5/disktab.5 +++ b/ja_JP.eucJP/man/man5/disktab.5 @@ -1,140 +1,140 @@ .\" 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. .\" .\" @(#)disktab.5 8.1 (Berkeley) 6/5/93 -.\" jpman $Id: disktab.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: disktab.5,v 1.3 1998/06/12 15:50:37 kumano Stab % .\" %Id: disktab.5,v 1.1.1.1.8.2 1997/03/07 04:18:02 mpp Exp % .\" .Dd June 5, 1993 .Dt DISKTAB 5 .Os BSD 4.2 .Sh 名称 .Nm disktab .Nd ディスク記述ファイル .Sh 書式 .Fd #include .Sh 解説 .Nm disktab は、ディスクジオメトリとディスクパーティション特性を記述する 簡単なデータベースで、 .\"by the formatter(\c .\"IR.Xr format 8 ) .\"to determine how to format the disk, and ディスク上のディスクラベルを初期化する際に使われます。 フォーマットは .Xr termcap 5 端末データベースと同様のパターンです。 .Nm disktab 内のエントリは、たくさんの `:' で区切られたフィールドからなります。 各ディスクの最初のエントリは `|' 文字で区切られていて、そのディスクの 既知の名前を与えます。最後の名前はディスクをディスクを識別する完全に 長い名前でなければなりません。 .Pp 以下のリストは、各ディスクエントリのための通常の値です。 .Bl -column "indent" "boolx" .It Sy 名前 型 解説 .It "\&ty str ディスクの種類 (例えば removable, winchester)" .It "\&dt str コントローラの種類 (例えば " .Tn SMD , ESDI , フロッピー) .It "\&ns num トラックあたりのセクタ数" .It "\&nt num シリンダあたりのトラック数" .It "\&nc num ディスク上の総シリンダ数" .It "\&sc num シリンダあたりのセクタ数、デフォルトは nc*nt" .It "\&su num ユニットあたりのセクタ数、デフォルトは sc*nc" .It "\&se num バイト単位のセクタサイズ" デフォルトは .Dv DEV_BSIZE .It "\&sf bool コントローラが bad144 スタイルのバッドセクタフォワードをサポートする" .It "\&rm num 回転スピード (rpm), デフォルトは 3600" .It "\&sk num トラックあたりのセクタスキュー、デフォルトは 0" .It "\&cs num シリンダあたりのセクタスキュー、デフォルトは 0" .It "\&hs num ヘッドスイッチ時間 (usec), デフォルトは 0" .It "\&ts num 1 シリンダシーク時間 (usec), デフォルト 0" .It "\&il num セクタインタリーブ (n:1), デフォルトは 1" .It "\&d[0-4] num ドライブタイプ依存パラメータ" .It "\&bs num ブートブロックサイズ、デフォルト" .Dv BBSIZE .It "\&sb num スーパブロックサイズ、デフォルト" .Dv SBSIZE .It "\&ba num パーティション `a' のブロックサイズ (bytes)" .It "\&bd num パーティション `d' のブロックサイズ (bytes)" .It "\&be num パーティション `e' のブロックサイズ (bytes)" .It "\&bf num パーティション `f' のブロックサイズ (bytes)" .It "\&bg num パーティション `g' のブロックサイズ (bytes)" .It "\&bh num パーティション `h' のブロックサイズ (bytes)" .It "\&fa num パーティション `a' のフラグメントサイズ (bytes)" .It "\&fd num パーティション `d' のフラグメントサイズ (bytes)" .It "\&fe num パーティション `e' のフラグメントサイズ (bytes)" .It "\&ff num パーティション `f' のフラグメントサイズ (bytes)" .It "\&fg num パーティション `g' のフラグメントサイズ (bytes)" .It "\&fh num パーティション `h' のフラグメントサイズ (bytes)" .It "\&oa num パーティション `a' のセクタ内オフセット" .It "\&ob num パーティション `b' のセクタ内オフセット" .It "\&oc num パーティション `c' のセクタ内オフセット" .It "\&od num パーティション `d' のセクタ内オフセット" .It "\&oe num パーティション `e' のセクタ内オフセット" .It "\&of num パーティション `f' のセクタ内オフセット" .It "\&og num パーティション `g' のセクタ内オフセット" .It "\&oh num パーティション `h' のセクタ内オフセット" .It "\&pa num パーティション `a' セクタサイズ" .It "\&pb num パーティション `b' セクタサイズ" .It "\&pc num パーティション `c' セクタサイズ" .It "\&pd num パーティション `d' セクタサイズ" .It "\&pe num パーティション `e' セクタサイズ" .It "\&pf num パーティション `f' セクタサイズ" .It "\&pg num パーティション `g' セクタサイズ" .It "\&ph num パーティション `h' セクタサイズ" .It "\&ta str パーティション `a' のパーティションタイプ" .Pf ( Bx 4.2 ファイルシステム, スワップ他) .It "\&tb str パーティション `b のパーティションタイプ" .It "\&tc str パーティション `c のパーティションタイプ" .It "\&td str パーティション `d のパーティションタイプ" .It "\&te str パーティション `e のパーティションタイプ" .It "\&tf str パーティション `f のパーティションタイプ" .It "\&tg str パーティション `g のパーティションタイプ" .It "\&th str パーティション `h のパーティションタイプ" .El .Sh 関連ファイル .Bl -tag -width /etc/disktab -compact .It Pa /etc/disktab .El .Sh 関連項目 .Xr getdiskbyname 3 , .Xr disklabel 5 , .Xr disklabel 8 , .Xr newfs 8 .Sh 歴史 .Nm この記述ファイルは .Bx 4.2 から登場しました。 diff --git a/ja_JP.eucJP/man/man5/dm.conf.5 b/ja_JP.eucJP/man/man5/dm.conf.5 index 96c4757def..3a5f2219cc 100644 --- a/ja_JP.eucJP/man/man5/dm.conf.5 +++ b/ja_JP.eucJP/man/man5/dm.conf.5 @@ -1,106 +1,106 @@ .\" 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. .\" .\" WORD: configuration file 設定ファイル .\" WORD: day of the week 曜日 .\" .\" @(#)dm.conf.5 8.1 (Berkeley) 5/31/93 -.\" jpman $Id: dm.conf.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: dm.conf.5,v 1.3 1998/07/30 15:23:17 horikawa Stab % .\" .Dd May 31, 1993 .Dt DM.CONF 5 .Os BSD 4.2 .Sh 名称 .Nm dm.conf .Nd \&dm 設定ファイル .Sh 解説 .Xr dm.conf ファイルは .Xr \&dm 8 プログラムの設定ファイルです。 このファイルは ``badtty'', ``game'', ``time'' の 3 個のキーワードの どれか1つから始まる行で構成されます。その他の行は全て無視されます。 .Pp キーワード ``badtty'' の後にリストされた全ての tty 上では、 ゲームで遊ぶことができません。 エントリは空白文字で区切られた2個のフィールドからなります。 その 2 つは文字列 ``badtty'' と .Xr ttyname 3 の戻り値となる tty 名です。 例えば、uucp ダイアルアウト用の ``tty19'' を、ゲームに 用いられないようにするためには、以下のようにします。 .Bd -literal -offset indent badtty /dev/tty19 .Ed .Pp キーワード ``time'' の後に、日付/時間の組合せをリストすると、その時間帯は ゲームがすべて禁止されます。 このエントリは空白文字で区切られた 4 個のフィールドからなります。 その 4 つは文字列 ``time'' と省略なしの曜日、ゲームをしてはいけない時間帯 の始まりと終わりを示します。 時間のフィールドは 0 時から始まる 24 時間制で表します。 例えば、以下のエントリは、月曜日には午前 8 時以前と午後 5 時以降のみに ゲームで遊ぶことを許可するものです。 .Bd -literal -offset indent time Monday 8 17 .Ed .Pp キーワード ``game'' の後に何らかのゲームをリストすると、 特定のゲームのためにパラメータをセットします。 このエントリは空白文字で区切られた 5 個のフィールドからなります。 その 5 つはキーワード ``game''、ゲームの名前、ゲームで遊ぶことが許される ロードアベレージの最大値、ケームで遊ぶことが許されるときの最大ユーザ数、 ゲームが実行されるときの優先度です。 これらのフィールドはすべて、数字以外の文字で始めることができ、 その場合はそのフィールドに基づいたゲームの制限や優先度が課せられない 結果になります。 ゲーム "default" は他のどこにもリストされていないゲーム全ての設定を 制御するもので、ファイル内の最後の ``game'' エントリである必要があります。 優先度は負の値にすることはできません。 例えば以下のエントリは、ゲーム ``hack'' に対しては、 システムのユーザが 10 人以下でロードアベレージが 5 以下であるときのみ許可し、 その他の全てのゲームにはシステムのユーザが 15 人以下であるとき常に許可する 制限を課します。 .Bd -literal -offset indent game hack 5 10 * game default * 15 * .Ed .Sh 関連ファイル .Bl -tag -width /etc/dm.conf -compact .It Pa /etc/dm.conf .Xr \&dm 8 設定ファイル .El .Sh 関連項目 .Xr setpriority 2 , .Xr ttyname 3 , .Xr dm 8 diff --git a/ja_JP.eucJP/man/man5/editrc.5 b/ja_JP.eucJP/man/man5/editrc.5 index 28d78ed63b..759c42cd25 100644 --- a/ja_JP.eucJP/man/man5/editrc.5 +++ b/ja_JP.eucJP/man/man5/editrc.5 @@ -1,300 +1,300 @@ .\" %NetBSD: editrc.5,v 1.4 1997/04/24 20:20:31 christos Exp % .\" .\" Copyright (c) 1997 The NetBSD Foundation, Inc. .\" All rights reserved. .\" .\" This file was contributed to The NetBSD Foundation by Luke Mewburn. .\" .\" 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 NetBSD .\" Foundation, Inc. and its contributors. .\" 4. Neither the name of The NetBSD Foundation 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 NETBSD FOUNDATION, INC. 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: editrc.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: editrc.5,v 1.3 1998/07/02 18:50:17 kumano Stab % .Dd January 11, 1997 .Os BSD 4.4 .Dt EDITRC 5 .Sh 名称 .Nm editrc .Nd editline ライブラリの設定ファイル .Sh 書式 .Nm .Sh 解説 .Nm は .Xr editline 3 ライブラリで使用されている様々な設定を定義します。 .Pp それぞれの行のフォーマットは、 .Dl prog:command [arg [...]] または .Dl command [arg [...]] のどちらかです。 .Pp .Ar command は .Xr editline 3 の組み込みコマンドのうちの 1 つです。 より詳しい情報は .Sx 組み込みコマンド を参照してください。 .Pp .Ar prog はプログラムが .Xr editline 3 をセットアップするために .Xr el_init 3 を呼び出す時に定義したプログラム名の文字列で、 通常は .Va argv[0] です。 .Ar command は .Ar prog にマッチする全てのプログラムに対しても実行されます。 .Pp .Ar prog は .Xr regex 3 形式の正規表現であってもよく、その場合 .Ar command はその正規表現にマッチする全てのプログラムに対して実行されます。 .Sh 組み込みコマンド .Nm editline ライブラリはいくつかの組み込みコマンドがあり、行編集とヒストリ機能操作の 方法に作用します。 これらは .Xr tcsh 1 シェルに存在する似た名前の組み込みコマンドに基づいています。 .Pp 以下の組み込みコマンドが利用可能です。 .Bl -tag -width 4n .It Ic bind Xo .Op Fl a .Op Fl e .Op Fl k .Op Fl l .Op Fl r .Op Fl s .Op Fl v .Op Ar key Op Ar command .Xc オプション無しでは、全ての割り当てられたキーと、 それぞれが割り当てられた編集コマンドを表示します。 もし .Ar key が与えられたら、 .Ar key に対する割り当てを示します。 もし .Ar key command が与えられたら、 .Ar command を .Ar key に割り当てます。 含まれるオプションは、 .Bl -tag -width 4n .It Fl e 全てのキーを GNU Emacs の標準に似た割り当てに割り当てます。 .It Fl v 全てのキーを .Xr vi 1 の標準に似た割り当てに割り当てます。 .It Fl a .Xr vi 1 モードのもう 1 つ (コマンドモード) のキーマップにおける キー割り当てを表示または変更します。 .It Fl k .Ar key は矢印記号キー名、 .Sq up , .Sq down , .Sq left または .Sq right のうちの 1 つ、として解釈されます。 .It Fl l 全ての編集コマンドとそれぞれの短い説明を表示します。 .It Fl r キーの割り当てを削除します。 .It Fl s .Ar command は文字列リテラルとして扱われ、 .Ar key がタイプされた時に端末入力として扱われます。 .Ar command 中の割り当てられたキーは、それ自身が再解釈され、 これは 10 レベルの解釈まで継続されます。 .El .Pp .Ar key と .Ar command は .Sm off .Sq No ^ Ar character .Sm on .Po 例えば .Sq ^A .Pc 形式のコントロール文字と、 以下のバックスラッシュ付きのエスケープシーケンスを含むことができます。 .Pp .Bl -tag -compact -offset indent -width 4n .It Ic \ea ベル .It Ic \eb バックスペース .It Ic \ee エスケープ .It Ic \ef フォームフィード .It Ic \en 改行 .It Ic \er キャリッジリターン .It Ic \et (水平) タブ .It Ic \ev 垂直タブ .Sm off .It Sy \e Ar nnn .Sm on 8 進数 .Ar nnn で表される ASCII 文字 .El .Pp .Sq \e は、次の文字に特別な意味があるならば、それを無効化します。 特に、 .Sq \e と .Sq ^ の特別な意味を無効化します。 .It Ic echotc Xo .Op Fl sv .Ar arg .Ar ... .Xc .Ar arg Ar ... で与えられた端末能力を実行します。 もし .Ar arg が .Sq baud , .Sq cols , .Sq lines , .Sq rows , .Sq meta , .Sq tabs であればその能力の値が表示されます。 .Dq yes または .Dq no は、端末がその能力を持つのか持たないのかを表します。 .Pp .Fl s を指定すると存在しない能力に対してエラーを起こすのではなく、 空の文字列を返します。 .Fl v を指定するとメッセージを冗長に表示します。 .It Ic history ヒストリを表示します。 .It Ic telltc 全ての端末能力の値を表示します。 .Pf ( Xr termcap 5 参照)。 .It Ic settc Ar cap Ar val .Xr termcap 5 で定義された端末能力 .Ar cap を .Ar val に設定します。 正しさのチェックは行なわれません。 .It Ic setty Xo .Op Fl a .Op Fl d .Op Fl q .Op Fl x .Op Ar +mode .Op Ar -mode .Op Ar mode .Xc .Nm がどの tty モードの変更をユーザに許可しないかを制御します。 .Fl d , .Fl q , .Fl x は .Ic setty に対してそれぞれ .Sq edit , .Sq quote , .Sq execute tty モードセットにおいて働くことを示します。 デフォルトでは .Fl x です。 .Pp 他の引数がなければ、 .Ic setty は選択されたセットにおいて何が on .Po .Sq +mode .Pc または off .Po .Sq -mode .Pc に固定されているかを表示します。 .Fl a は設定に関わらず選択されたセットにおける全ての tty モードを表示します。 .Ar +mode , .Ar -mode , .Ar mode , は選択されたセットにおいて .Ar mode を on または off に固定すること、あるいは .Ar mode の制御を行なわないことを指定します。 .El .Sh 関連項目 .Xr editline 3 , .Xr regex 3 , .Xr termcap 5 .Sh 作者 .Nm editline ライブラリは .An Christos Zoulas によって書かれ、このマニュアルは いくつかの節は .Xr tcsh 1 に影響されて、 .An Luke Mewburn によって書かれました。 diff --git a/ja_JP.eucJP/man/man5/ethers.5 b/ja_JP.eucJP/man/man5/ethers.5 index 9334cbc2f8..53fde9ab51 100644 --- a/ja_JP.eucJP/man/man5/ethers.5 +++ b/ja_JP.eucJP/man/man5/ethers.5 @@ -1,101 +1,101 @@ .\" Copyright (c) 1995 .\" Bill Paul . 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 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: ethers.5,v 1.2.2.2 1998/01/07 00:55:01 steve Exp % -.\" jpman $Id: ethers.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: ethers.5,v 1.3 1998/04/29 11:33:25 kuma Stab % .\" .\" WORD: Internetworking インターネット .\" WORD: fully-qualified-host-name 完全な形でのホスト名 .\" .Dd April 12, 1995 .Dt ETHERS 5 .Os FreeBSD 2.1 .Sh 名称 .Nm ethers .Nd イーサネットアドレスのデータベース .Sh 解説 .Nm ethers データベースは、 インターネット上のホストの既知の 48 ビットイーサネットアドレスを格納します。 データは .Pa /etc/ethers と呼ばれるファイルに次のフォーマットで格納されます: .Bd -unfilled -offset indent .Pa イーサネットアドレス 完全な形でのホスト名 .Ed .Pp 項目は任意個の空白文字やタブ文字で区切ります。 行頭の ``#'' は行末まで続くコメントの開始を表します。 行頭に ``+'' があると、 .Xr ethers 3 ライブラリ関数は、 .Pa /etc/ethers ファイルのデータだけでなく、 .Xr NIS 4 の .Pa ethers.byname と .Pa ethers.byaddr のマップのデータも使用します。 .Pp イーサネットアドレスは .Tn ASCII 形式で "x:x:x:x:x:x" と表記されます。ここで、 .Ar x は 0x00 から 0xFF までの 16 進数です。 アドレス値はネットワークオーダである必要があります。 .Pa /etc/ethers データベースで指定するホスト名は、 .Xr hosts 5 ファイルのエントリに対応する必要があります。 .Pp 標準 C ライブラリの .Fn ether_line 関数を使用して、 .Pa /etc/ethers データベースの各行を、個々のコンポーネントに分割可能です: バイナリのイーサネットアドレスは .Pa ether_addr 構造として、ホスト名は文字列として格納されます。 .Sh 関連ファイル .Bl -tag -width /etc/services -compact .It Pa /etc/ethers .Nm ethers ファイルは .Pa /etc にあります。 .El .Sh 関連項目 .Xr ethers 3 , .Xr yp 4 .Sh 歴史 .Nm ethers フォーマットは SunOS 4.1.x で使用されている形式を元にしています。 diff --git a/ja_JP.eucJP/man/man5/exports.5 b/ja_JP.eucJP/man/man5/exports.5 index 2e5ef1b3be..87fb725151 100644 --- a/ja_JP.eucJP/man/man5/exports.5 +++ b/ja_JP.eucJP/man/man5/exports.5 @@ -1,256 +1,256 @@ .\" 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. .\" .\" @(#)exports.5 8.3 (Berkeley) 3/29/95 .\" %Id: exports.5,v 1.3.2.1 1997/03/12 15:07:13 mpp Exp % -.\" jpman $Id: exports.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: exports.5,v 1.3 1998/07/02 14:10:07 horikawa Stab % .\" .Dd March 29, 1995 .Dt EXPORTS 5 .Os .Sh 名称 .Nm exports .Nd .Tn NFS マウント要求に対するリモートマウント点を定義する .Sh 書式 .Nm exports .Sh 解説 .Nm exports ファイルは .Tn NFS サーバの指定 1 つについて .Tn NFS マウントプロトコルに対するリモートマウント点を指定します。 .%T "Network File System Protocol Specification \\*(tNRFC\\*(sP 1094, Appendix A" および .%T "NFS: Network File System Version 3 Specification, Appendix I" を参照してください。 .Pp .Nm exports ファイルの各行 (# で始まる注釈行以外) は、1 つ以上のホスト向けに、 1 つのローカルサーバファイルシステム内の マウント点 (複数) とエクスポートフラグを指定します。 あるホストは、 サーバの各ローカルファイルシステムに関して唯 1 度だけ指定可能です。 また他の全てのホストに適用されるデフォルトエントリは、 各サーバファイルシステムに関して唯 1 つだけ指定できます。 後者は ``世界'' に対しそのファイルシステムを公開することになるので、 そのファイルシステムが公の情報を含むときにのみ用いるべきです。 .Pp マウントエントリ内の最初の欄 (複数) には、 対応するクライアント (複数) がマウント可能である サーバファイルシステム内ディレクトリパス (複数) を指定します。 この指定には 2 つの形式があります。 最初の指定形式は、 全マウント点のリストであり、絶対ディレクトリパスを空白で区切ったものです。 次の指定形式は、そのファイルシステムのルートパス名に続いて .Fl alldirs フラグを指定するものです。この形式は、そのファイルシステム内の任意の点を ホスト (複数) がマウントすることを可能にします。mountd で .Fl r オプションを用いれば、任意の点には通常ファイルを含むことができます。 パス名中には、シンボリックリンクを含んではなりませんし、また "." または ".." を含んではなりません。 1 つのファイルシステムに対するマウント点を複数指定することが可能であり、 それぞれ異ったホストとエクスポートオプションの組を指定することができます。 .Pp 行の 2 番目の部分には、そのファイルシステムがホストの組にどのように エクスポートされているかを指定します。 オプションフラグは、 そのファイルシステムを読み取り専用でエクスポートしているのか それとも読み書き可でエクスポートしているのかを指定したり、 クライアントの UID がサーバ上のユーザ資格にどのように マップされているのかを指定します。 .Pp エクスポートオプションは以下のとおりです。 .Pp .Sm off .Fl maproot No = Sy user .Sm on 指定されたユーザの資格を、root によるリモートアクセスに対して使用します。 その資格には、ローカルマシン上でユーザが属する全てのグループを含みます ( .Xr id 1 参照)。ユーザは名前または数字です。 .Pp .Sm off .Fl maproot No = Sy user:group1:group2:... .Sm on コロンによって区切られたリストは、 root によるリモートアクセスに対して使用する正確な資格を指定するために 使用します。 リストの要素は名前または数字です。 グループを含まない資格をユーザに関する完全な資格と区別するためには、 user: を使用すべきであることに注意してください。 .Pp .Sm off .Fl mapall No = Sy user .Sm on または .Sm off .Fl mapall No = Sy user:group1:group2:... .Sm on .Fl maproot と同じ指定方法で、 (root を含む) 全てのクライアントの UID に対するマッピングを指定します。 .Pp .Fl r オプションは .Fl maproot と同じ意味です。 これは古い export ファイル形式と互換性を保つために用意されました。 .Pp .Fl maproot および .Fl mapall オプションのない場合には、 root によるリモートアクセスは -2:-2 という資格を用いることになります。 その他の全てのユーザはそれぞれのリモート資格にマップされます。 .Fl maproot オプションを指定すると、root によるリモートアクセスは -2:-2 の代りに 指定した資格にマップされます。 .Fl mapall オプションを指定すると、root を含む全てのユーザはそれら自身の資格の代りに 指定した資格にマップされます。 .Pp .Fl kerb オプションを指定すると、Kerberos 認証サーバを使用して 認証とクライアント資格のマップを行います。 このオプションを利用するには、カーネルを NFSKERB オプション付きで 構築してある必要があります。 .Pp .Fl ro オプションは、ファイルシステムが読み取り専用としてエクスポートされることを 指定します (デフォルトは読み書き可)。 .Fl o オプションは .Fl ro と同じ意味です。 これは古い export ファイル形式と互換性を保つために用意されました。 .Pp 行の 3 番目の部分には、その行が適用されるホストの組を指定します。 この組は 3 つの方法で指定できます。 最初の方法はホスト名 (複数) を空白で区切って並べる方法です。 (名前の代りに、標準的なインターネット ``ドット'' アドレスを用いることも できます)。2 番目の方法はネットグループファイル ( .Xr netgroup 5 参照) の中で定義した ``netgroup'' を指定する方法です。 3 番目の方法は、 1 つのネットワークとネットワークマスクを用いることにより、 1 つのインターネットサブネットワークを指定する方法です。 これは、 そのサブネットワーク内のアドレスを持つ全てのホストの組として定義されます。 この最後の方法はカーネルのオーバヘッドを低く押えられるため、 1 つの管理サブネット内の多くのクライアントを エクスポートの行が参照する場合に推奨されます。 .Pp 最初の 2 つの指定方法では、単に空白で区切られた名前 (複数) を並べて指定します。 全ての名前は、まずそれらが ``netgroup'' 名であるかチェックされ、 そうでなければホスト名であると仮定されます。 ホスト名に完全ドメイン指定をすれば、 ネットグループと同じ名前を持つホストの問題を通常避けることができます。 3 番目の指定方法は、 .Sm off .Fl network No = Sy netname .Sm on フラグとオプションの .Sm off .Fl mask No = Sy netmask .Sm on フラグによって指定します。マスクが指定されないと、そのネットワーククラス (A, B, C のどれかです。 .Xr inet 4 を参照してください) に対するマスクとなります。 .Pp 例: .Bd -literal -offset indent /usr /usr/local -maproot=0:10 friends /usr -maproot=daemon grumpy.cis.uoguelph.ca 131.104.48.16 /usr -ro -mapall=nobody /u -maproot=bin: -network 131.104.48 -mask 255.255.255.0 /u2 -maproot=root friends /u2 -alldirs -kerb -network cis-net -mask cis-mask .Ed .Pp .Sy /usr , .Sy /u , .Sy /u2 がローカルファイルシステムマウント点とすると、上の例は以下を指定します: .Sy /usr はネットクグープファイルで指定されるホスト群 .Em friends にエクスポートされ、 この際ユーザはそれぞれのリモート資格にマップされ、 root は UID 0 およびグループ 10 にマップされます。 このファイルシステムは読み書き可でエクスポートされ、 ``friends'' 内のホストは /usr と /usr/local のどちらもマウントできます。 このファイルシステムは .Em 131.104.48.16 および .Em grumpy.cis.uoguelph.ca にエクスポートされ、 この際ユーザはそれぞれのリモート資格にマップされ、 root は ``daemon'' に結び付けられたユーザおよびグループにマップされます。 このファイルシステムは残りの世界へ読み出しのみでエクスポートされ、 この際全てのユーザは ``nobody'' に結び付けられたユーザおよびグループに マップされます。 .Pp .Sy /u はサブネットワーク .Em 131.104.48 上の全てのホストにエクスポートされ、 この際 root は ``bin'' の UID にマップされてグループアクセスを持ちません。 .Pp .Sy /u2 は ``friends'' 中のホストにエクスポートされ、 その際 root は ``root'' に結び付けられた UID とグループにマップされます。 このファイルシステムは ``cis-net'' ネットワーク上の全てのホストへ エクスポートされ、 この際 /u2 内のどんなディレクトリへもマウントを許し、 Kerberos 許可書によって認証される principal についての資格に 全 UID をマップします。 .Sh 関連ファイル .Bl -tag -width /etc/exports -compact .It Pa /etc/exports デフォルトリモートマウント点ファイル .El .Sh 関連項目 .Xr netgroup 5 , .Xr mountd 8 , .Xr nfsd 8 , .Xr showmount 8 .Sh バグ エクスポートオプションはカーネル内ではローカルマウント点に結び付けられます。 ローカルサーバマウント点のサブディレクトリでエクスポートされたものに、 エクスポートオプションの矛盾があってはいけません。 同じファイルシステム内の全てのエクスポートされたディレクトリは、 木を下る順に隣り合った行で指定されることが推奨されます。 ネットグループ名と同じ名前のホスト名は指定できません。 完全ドメイン指定でホスト名を指定すれば通常は問題ありません。 diff --git a/ja_JP.eucJP/man/man5/fbtab.5 b/ja_JP.eucJP/man/man5/fbtab.5 index 8309d176dd..49aeba9793 100644 --- a/ja_JP.eucJP/man/man5/fbtab.5 +++ b/ja_JP.eucJP/man/man5/fbtab.5 @@ -1,49 +1,49 @@ .\" .\" %Id: fbtab.5,v 1.1.8.3 1998/06/28 21:34:26 hoek Exp % .\" -.\" jpman $Id: fbtab.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: fbtab.5,v 1.3 1998/04/29 11:36:22 kuma Stab % .\" .\" WORD: permission パーミッション .\" WORD: device デバイス(/dev 下のデバイスファイル関連のもの) .\" WORD: comment コメント .\" WORD: whitespace 空白 .\" WORD: ownership 所有権(ファイルの) .\" .Dd August 22, 1994 .Dt FBTAB 5 .Os FreeBSD 2.0 .Sh 名称 .Nm fbtab .Nd ログイン時にデパイスの保護状態を変更する .Sh 解説 .Nm fbtab ファイルには、 単一デバイス・複数デバイスのリスト・それらのパーミッション の 3 つを指定する行が複数個格納されます。 コメントは # から開始し、行末まで続きます。 .Pp 空行もしくはコメントのみの行は無視されます。 .Pp 他の行は空白で区切られる次の 3 フィールドからなります: ログインデバイス (/dev/ttyv0)・8 進数でのパーミッション値 (0600)・ そして ":" で区切ったデバイスリスト (/dev/console) です。 デバイス名は全て絶対パスで記述します。 \&"/*" で終るパスは "." と ".." 以外の全ディレクトリエントリを参照します。 .Pp tty 引数 (相対パス) がログインデバイス名 (絶対パス) にマッチする場合、 \&":" 区切りでリストされるデバイスのパーミッションが 第 2 フィールドで指定される値に設定され、 所有者が UID と GID 引数の値に設定されます。 .Sh 関連ファイル .Bl -tag -width /etc/fbtab -compact .It Pa /etc/fbtab .Nm fbtab ファイルは .Pa /etc にあります。 .El .Sh 関連項目 .Xr login 1 , .Xr getty 8 .Sh 作者 .An Guido van Rooij diff --git a/ja_JP.eucJP/man/man5/fdesc.5 b/ja_JP.eucJP/man/man5/fdesc.5 index e048cee83a..71d9b3b40a 100644 --- a/ja_JP.eucJP/man/man5/fdesc.5 +++ b/ja_JP.eucJP/man/man5/fdesc.5 @@ -1,152 +1,152 @@ .\" Copyright (c) 1996 .\" Mike Pritchard . All rights reserved. .\" .\" 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: fdesc.5,v 1.2.2.2 1998/07/19 06:52:11 jkh Exp % .\" -.\" jpman $Id: fdesc.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: fdesc.5,v 1.3 1998/07/30 15:24:07 horikawa Stab % .\" WORD: file descriptor ファイル記述子 .\" WORD: augment (union マウントによる)重ね合わせ .\" .Dd December 14, 1996 .Dt fdesc 5 .Os BSD 4.4 .Sh 名称 .Nm fdesc .Nd ファイル記述子ファイルシステム .Sh 書式 fdesc /dev fdesc rw 0 0 .Sh 解説 ファイル記述子ファイルシステム、別名 .Nm fdesc は、プロセス毎のファイル記述子の名前空間をグローバルなファイルシステムの 名前空間からアクセスする機能を提供します。 通常のマウントポイントは .Pa /dev であり、 .Pa /dev の既存のエントリを置き換えるのではなく重ね合わせるために、 ファイルシステムを union マウントする必要があります。 .Pp マウントポイントの内容は .Pa fd , .Pa stderr , .Pa stdin , .Pa stdout および .Pa tty です。 .Pp .Pa fd はディレクトリで、その中身は、番号で表したファイルのリストとして見えます。 これらのファイルは、ディレクトリを読むプロセスが現在オープンしている ファイルに対応しています。 .Pa /dev/fd/0 から .Pa /dev/fd/# までのファイルは記述子への参照であり、 ファイルシステムを通じてアクセスすることができます。 ファイル記述子がオープンされていて、ファイルをオープンしたときのモードが 既存の記述子のモードのサブセットである場合は、システムコール呼び出し .Bd -literal -offset indent fd = open("/dev/fd/0", mode); .Ed .Pp と、システムコール呼び出し .Bd -literal -offset indent fd = fcntl(0, F_DUPFD, 0); .Ed .Pp は等価です。 .Pp ファイル .Pa /dev/stdin , .Pa /dev/stdout および .Pa /dev/stderr は .Pa /dev/fd サブディレクトリの対応するエントリへのシンボリックリンクとなります。 これらをオープンするのは、以下のシステムコール呼び出しと等価です。 .Bd -literal -offset indent fd = fcntl(STDIN_FILENO, F_DUPFD, 0); fd = fcntl(STDOUT_FILENO, F_DUPFD, 0); fd = fcntl(STDERR_FILENO, F_DUPFD, 0); .Ed .Pp .Xr open 2 呼び出し時のフラグは .Dv O_RDONLY , .Dv O_WRONLY および .Dv O_RDWR 以外は無視されます。 .Pp .Pa /dev/tty エントリはカレントプロセスの制御端末への間接参照です。 これは見かけ上は名前つきパイプ (FIFO) ですが、本物の制御端末デバイスと 全く同じ振舞いをします。 .Sh 関連ファイル .Bl -tag -width /dev/stderr -compact .It Pa /dev/fd/# .It Pa /dev/stdin .It Pa /dev/stdout .It Pa /dev/stderr .It Pa /dev/tty .El .Sh 関連項目 .Xr tty 4 , .Xr mount_devfs 8 , .Xr mount_fdesc 8 .Sh 歴史 .Nm ファイルシステムは .Bx 4.4 で最初に登場しました。 .Nm マニュアルページは .Fx 2.2 で最初に登場しました。 .Sh 作者 .Nm マニュアルページは .An Mike Pritchard Aq mpp@FreeBSD.org によって書かれたもので、 .An Jan-Simon Pendry による .Xr mount_fdesc 8 マニュアルページに基づいています。 diff --git a/ja_JP.eucJP/man/man5/forward.5 b/ja_JP.eucJP/man/man5/forward.5 index e650414965..6751a2bde4 100644 --- a/ja_JP.eucJP/man/man5/forward.5 +++ b/ja_JP.eucJP/man/man5/forward.5 @@ -1,83 +1,83 @@ .\" Copyright (c) 1996 .\" Mike Pritchard . 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 and .\" contributors. .\" 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: forward.5,v 1.1.2.1 1997/03/07 04:18:03 mpp Exp % -.\" jpman $Id: forward.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: forward.5,v 1.3 1998/04/29 11:32:30 kuma Stab % .\" .\" WORD: quote クォート(単一引用符または二重引用符文字のこと) .\" .Dd July 2, 1996 .Dt FORWARD 5 .Os .Sh 名称 .Nm forward .Nd メールの転送指示 .Sh 解説 .Nm .forward ファイルは、ユーザのメールの転送先の メールアドレスもしくはプログラムのリストを格納します。 このファイルが存在しない場合には、メール転送は行なわれません。 行頭に標準のシェルパイプシンボル (|) を付けることにより、 メールはプログラムの標準入力として転送されます。 引数をコマンドに渡す場合には、行全体をクォートで括る必要があります。 セキュリティ上の理由で、 .Nm .forward ファイルはメール送付先のユーザもしくは root が所有者である必要があり、 ユーザのシェルが .Pa /etc/shells にリストされている必要があります。 .Pp 例えば、 .Nm .forward ファイルが以下の行を含む場合: .Bd -literal -offset indent nobody@FreeBSD.org "|/usr/bin/vacation nobody" .Ed .Pp メールは .Ar nobody@FreeBSD.org に転送され、 単一引数 .Ar nobody を伴なってプログラム .Pa /usr/bin/vacation に転送されます。 .Sh 関連ファイル .Bl -tag -width $HOME/.forward -compact .It Pa $HOME/.forward ユーザによる転送指示 .El .Sh 関連項目 .Xr mailaddr 7 , .Xr sendmail 8 diff --git a/ja_JP.eucJP/man/man5/fs.5 b/ja_JP.eucJP/man/man5/fs.5 index 7c27531abb..1c87cedba3 100644 --- a/ja_JP.eucJP/man/man5/fs.5 +++ b/ja_JP.eucJP/man/man5/fs.5 @@ -1,363 +1,363 @@ .\" 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. .\" .\" @(#)fs.5 8.2 (Berkeley) 4/19/94 -.\" jpman $Id: fs.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: fs.5,v 1.3 1998/06/22 11:05:13 kumano Stab % .\" %Id: fs.5,v 1.3.2.2 1997/03/07 04:18:04 mpp Exp % .\" .Dd April 19, 1994 .Dt FS 5 .Os BSD 4.2 .Sh 名称 .Nm fs , .Nm inode .Nd ファイルシステムボリュームのフォーマット .Sh 書式 .Fd #include .Fd #include .Fd #include .Sh 解説 ファイル .Aq Pa fs.h と .Aq Pa inode.h は、ランダムアクセスデバイス (ディスク) 上のファイルシステムオブジェクト の基本フォーマットを作成、管理する際に使われるいくつかの構造体、 定義済み変数、マクロを宣言します。 .Pp ファイルシステムはブロックサイズとブロック数から構成されており、 これらはファイルシステムのパラメータになります。 .Dv BBLOCK から始まり 大きさ .Dv BBSIZE だけ続くセクタは、 ディスクラベルといくつかの一次、二次ハードウェアブートストラッププログラム のために使われます。 .Pp 実際のファイルシステムは、 .Dv SBLOCK セクタから始まり、そこには 大きさが .Dv SBSIZE である .Em スーパブロック があります。 ファイル .Aq Pa ufs/ffs/fs.h にある以下の構造体は、スーパブロックを記述しています。 .Bd -literal /* * ファイルシステムのスーパブロック */ struct fs { struct fs *fs_link; /* 内部スーパブロック用に使われるファイルシステムの */ struct fs *fs_rlink; /* リンク済みリスト */ daddr_t fs_sblkno; /* ファイルシステム内のスーパブロックのアドレス */ daddr_t fs_cblkno; /* ファイルシステム内のシリンダブロックのオフセット */ daddr_t fs_iblkno; /* ファイルシステム内の inode ブロックのオフセット */ daddr_t fs_dblkno; /* cg 後の最初のデータのオフセット */ long fs_cgoffset; /* シリンダ内のシリンダグループオフセット */ long fs_cgmask; /* mod fs_ntrak の計算に使われる */ time_t fs_time; /* 最後に書き込まれた時刻 */ long fs_size; /* fs 内のブロック数 */ long fs_dsize; /* fs 内のデータブロック数 */ long fs_ncg; /* シリンダグループの数 */ long fs_bsize; /* fs 内の基本ブロックサイズ */ long fs_fsize; /* fs 内のフラグメントブロックサイズ */ long fs_frag; /* fs の 1 ブロック中のフラグメント数 */ /* 以下はコンフィグレーションパラメータ */ long fs_minfree; /* フリーブロックの最小パーセンテージ */ long fs_rotdelay; /* 最適な次ブロックのための ms 数 */ long fs_rps; /* 1 秒あたりのディスク回転 */ /* これらのフィールドは他のフィールドから計算できる */ long fs_bmask; /* ``blkoff'' ブロックオフセットの計算 */ long fs_fmask; /* ``fragoff'' フラグメントオフセットの計算 */ long fs_bshift; /* ``lblkno'' 論理ブロック番号の計算 */ long fs_fshift; /* ``numfrags'' フラグメント数の計算 */ /* 以下はコンフィグレーションパラメータ */ long fs_maxcontig; /* 連続したブロックの最大数 */ long fs_maxbpg; /* シリンダグループあたりの最大ブロック数 */ /* これらのフィールドは他のフィールドから計算できる */ long fs_fragshift; /* フラグメントシフトするブロック */ long fs_fsbtodb; /* fsbtodb と dbtofsb シフト定数 */ long fs_sbsize; /* スーパブロックの実際の大きさ */ long fs_csmask; /* csum ブロックオフセット */ long fs_csshift; /* csum ブロック数 */ long fs_nindir; /* NINDIR の値 */ long fs_inopb; /* INOPB の値 */ long fs_nspf; /* NSPF の値 */ /* 別のコンフィグレーションパラメータ */ long fs_optim; /* 最適化の選択、以下を参照 */ /* これらのフィールドはハードウェアから引き出される */ long fs_npsect; /* 予備を含むトラックあたりのセクタ数 */ long fs_interleave; /* ハードウェアセクタインタリーブ */ long fs_trackskew; /* トラックあたりのセクタ 0 ゆがみ */ long fs_headswitch; /* ヘッドスイッチ時間 (usec) */ long fs_trkseek; /* トラック間シーク (usec) */ /* シリンダグループの数とサイズにより決められるサイズ */ daddr_t fs_csaddr; /* シリンダグループ総括領域のブロックアドレス */ long fs_cssize; /* シリンダグループ総括領域のサイズ */ long fs_cgsize; /* シリンダグループサイズ */ /* これらのフィールドはハードウェアから引き出される */ long fs_ntrak; /* シリンダあたりのトラック数 */ long fs_nsect; /* トラックあたりのセクタ数 */ long fs_spc; /* シリンダあたりのセクタ数 */ /* これはディスクドライバパーティション作成時のもの */ long fs_ncyl; /* ファイルシステムのシリンダ数 */ /* これらのフィールドは他のフィールドから計算できる */ long fs_cpg; /* グループあたりのシリンダ数 */ long fs_ipg; /* グループあたりの inode 数 */ long fs_fpg; /* グループあたりのブロック数 * fs_frag */ /* このデータはクラッシュ後に再計算されなければならない */ struct csum fs_cstotal; /* シリンダ総括情報 */ /* 以下のフィールドはマウント時にクリアされる */ char fs_fmod; /* スーパブロック変更フラグ */ char fs_clean; /* ファイルシステムがクリーンであるフラグ */ char fs_ronly; /* 読み込み専用でマウントされたフラグ */ char fs_flags; /* 現在未使用のフラグ */ char fs_fsmnt[MAXMNTLEN]; /* マウントされている名前 */ /* これらのフィールドは現在のブロックの配置情報を保持する */ long fs_cgrotor; /* 最後に検索された cg */ struct csum *fs_csp[MAXCSBUFS]; /* fs_cs 情報バッファのリスト */ long fs_cpc; /* postbl 内のサイクルあたりのシリンダ */ short fs_opostbl[16][8]; /* 旧回転ブロックリストヘッド */ long fs_sparecon[50]; /* 将来のために予約された定数 */ long fs_contigsumsize;/* クラスタ総括配列の大きさ */ long fs_maxsymlinklen;/* 内部シンボリックリンクの最大長 */ long fs_inodefmt; /* ディスク上の inode のフォーマット */ u_quad_t fs_maxfilesize;/* 最大表示可能ファイルサイズ */ quad fs_qbmask; /* ~fs_bmask - quad サイズで使う */ quad fs_qfmask; /* ~fs_fmask - quad サイズで使う */ long fs_postblformat; /* 位置レイアウトテーブルのフォーマット */ long fs_nrpos; /* 回転位置の数 */ long fs_postbloff; /* (short) 回転ブロックリストヘッド */ long fs_rotbloff; /* (u_char) 各回転毎のブロック */ long fs_magic; /* マジックナンバ */ u_char fs_space[1]; /* 各回転毎のブロックのリスト */ /* 実際はもっと長い */ }; /* * ファイルシステム識別 */ #define FS_MAGIC 0x011954 /* fast ファイルシステムのマジックナンバ */ #define FS_OKAY 0x7c269d38 /* スーパブロックチェックサム */ #define FS_42INODEFMT -1 /* 4.2BSD inode フォーマット */ #define FS_44INODEFMT 2 /* 4.4BSD inode フォーマット */ /* * 最適化のための選択 */ #define FS_OPTTIME 0 /* 最小アロケーション時間 */ #define FS_OPTSPACE 1 /* 最小ディスクフラグメンテーション */ /* * 回転レイアウトテーブルフォーマットタイプ */ #define FS_42POSTBLFMT -1 /* 4.2BSD 回転テーブルフォーマット */ #define FS_DYNAMICPOSTBLFMT 1 /* 動的回転テーブルフォーマット */ .Ed .Pp 各ディスクドライブはいくつかのファイルシステムを含んでいます。 1 つのファイルシステムは、いくつかのシリンダグループから成ります。 各シリンダグループには inode とデータがあります。 .Pp ファイルシステムは、シリンダグループを順番に記述するスーパブロックに よって記述されています。 スーパブロックは重要なデータであり、壊滅的な損失から守るために 各シリンダグループに複製されています。 これはファイルシステム作成時に行なわれ、重要なスーパブロックデータは 変更されないので、特に惨事がふりかからなければ、複製が参照される 必要はありません。 .Pp inode に保存されたアドレスによって、`ブロック' のフラグメントの 位置を決めることができます。 ファイルシステムブロックのほとんどは .Dv MAXBSIZE ですが、2, 4, 8 個に分けることが自由にでき、 それぞれを位置指定できます。 これらの断片は .Dv DEV_BSIZE または .Dv DEV_BSIZE 単位の倍数であれば良いのです。 .Pp 大きなファイルは、非常に大きなデータブロックからなります。 ディスクスペースの過度の浪費を避けるために、小さなファイルの 最後のデータブロックは、 大きなブロックのフラグメントが必要な数だけ配置されます。 ファイルシステムフォーマットは、そのようなフラグメント (大きなブロックを 分割した一片) の 1 つへのポインタだけを保持します。 そのようなフラグメントの大きさは、 inode にある情報から決定することができ、 .Fn blksize fs ip lbn マクロが使っています。 .Pp ファイルシステムは、提供可能な空きをフラグメントレベルで記録します。 つまり、ブロックの空きを決定するために、フラグメントを並べて調べます。 .Pp root inode は、ファイルシステムのおおもとです。 inode 0 は、通常の目的では使われず、歴史的に バッドブロックは inode 1 にリンクされます。 したがって root inode は、2 です (inode 1 は、もはやこの目的では使われませんが、 多くのダンプテープがこの仮定をしているので、それについては変更できません)。 .Pp .Fa fs_minfree 要素は、空いているファイルシステムブロックの最低許容割合を与えます。 空きリストがこのレベル以下になった場合、スーパユーザ だけがブロックの確保を続けることができます。 .Fa fs_minfree 要素は、空きブロックの予備が必要ないと思われたら 0 にセットしても かまいませんが、ファイルシステムが 90% 以上詰まった状態で動いているときには、 かなり性能が低下するでしょう。 そのためデフォルトの .Fa fs_minfree の値は 10% になっています。 .Pp 経験上、ブロックフラグメンテーションと 90% 使用中のディスク全体の利用 の兼ね合いが最も良いのは、フラグメンテーション 8 のときです。 そのためデフォルトのフラグメントサイズはブロックサイズの 8 倍になっています。 .Pp 要素 .Fa fs_optim はファイルシステムがブロックを確保するのに要する時間を最小に しようとするか、それともディスク上の領域のフラグメンテーションを最小に しようとするかを指定します。 fs_minfree (上記参照) の値が 10% より小さい場合は、ファイルシステム は空間の最適化をデフォルトとし、 完全な大きさのブロックがなくならないようにします。 minfree の値が 10% と等しいかそれ以上の場合には、フラグメンテーション が問題とはなりにくく、ファイルシステムは時間の最適化をデフォルトに します。 .Pp .Em シリンダグループに関連した制限 : 連続したブロックを最小の回転遅れで配置することができるよう、 各シリンダは異なる回転位置での利用可能なブロック数を保持し続けます。 デフォルトでは回転位置を 8 分割で表し、このときの総括情報の分解能は 典型的な 3600 rpm のドライブで 2ms になります。 .Pp 要素 .Fa fs_rotdelay は、同一シリンダ上で別のディスク転送を開始する 最小ミリ秒数を与えます。 これは、あるファイル中のディスクブロックの周回の中での最適な配置を 決定するのに使われます。 デフォルトの .Fa fs_rotdelay の値は 2ms です。 .Pp 各ファイルシステムは、静的に割り当てられた数の inode を持っています。 inode は、ディスク空間あたり .Dv NBPI バイト確保されます。 inode を配置する戦略は、極端に保守的です。 .Pp .Dv MINBSIZE が許される最小のブロックサイズです。 .Dv MINBSIZE が 4096 では、2 段までの(ブロック)間接参照を使って 2^32 の大きさのファイルを作ることができます。 .Dv MINBSIZE は、シリンダグループブロックを保持するのに十分な大きさでなければ なりません。 したがって .Pq Fa 構造体 cg への変更は大きさを .Dv MINBSIZE 以内にしておかなければなりません。 スーパブロックは決して .Dv SBSIZE の大きさ以上ではないということに注意して下さい。 .Pp ファイルシステムがマウントされているパス名は、 .Fa fs_fsmnt に保持されます。 .Dv MAXMNTLEN は、この名前のためにスーパブロックに割り当てられた領域の量を定義します。 ファイルシステム毎の総括情報の量の上限は、 .Dv MAXCSBUFS により定義されています。 4096 バイトブロックサイズの場合では、これは現在最大 200 万シリンダ分 用意されています。 .Pp それぞれのシリンダグループ情報は、先頭のシリンダグループ データブロックから確保されたブロックに要約されます。 これらのブロックはスーパブロックに加えて .Fa fs_csaddr ( .Fa fs_cssize の大きさ) から読み込まれます。 .Pp .Sy 注意: .Fn sizeof "struct csum" は .Fn fs_cs マクロを動かすために 2 のべき乗でなければなりません。 .Pp .Em "ファイルシステムのスーパブロック" : 周回レイアウトテーブルの大きさは、スーパブロックが .Dv SBSIZE の大きさを持つことにより制限されています。 これらのテーブルの大きさは、ファイルシステムのブロックサイズに .Em 逆比例 します。 セクタサイズが 2 のべき乗でないときには、周回パターンを .Pq Fa fs_cpc だけ繰り返すまでに含まれるシリンダ数が増加するので、 同様にテーブルの大きさも増加します。 周回レイアウトテーブルの大きさは、 .Pq Fa struct fs に残っているバイト数から割り出されます。 .Pp シリンダグループあたりのデータブロック数は、シリンダグループが たかだか 1 ブロックであるので、制限されています。 inode と空きブロックテーブルは、単一ブロックから シリンダグループ構造体 .Pq Fa struct cg のための領域を除いた残りにぴったり合っていなければなりません。 .Pp .Em Inode : inode は、 .Tn UNIX ファイルシステム内のすべてのファイルに関する動作の中心です。 各アクティブなファイル、カレントディレクトリ、マウントされたファイル、 テキストファイル、root には、それぞれユニークな inode が割り当てられます。 inode はそのデバイス / i 番号によって `名前付け' されています。 詳しくはインクルードファイル .Aq Pa sys/inode.h を参照して下さい。 .Sh 歴史 filsys と名付けられたスーパブロック構造は .At v6 から登場しました。このマニュアルで記述されているファイルシステムは .Bx 4.2 から登場しました。 diff --git a/ja_JP.eucJP/man/man5/fstab.5 b/ja_JP.eucJP/man/man5/fstab.5 index 608d5d0060..43d542ba7a 100644 --- a/ja_JP.eucJP/man/man5/fstab.5 +++ b/ja_JP.eucJP/man/man5/fstab.5 @@ -1,246 +1,246 @@ .\" 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. .\" .\" @(#)fstab.5 8.1 (Berkeley) 6/5/93 .\" %Id: fstab.5,v 1.4.2.5 1998/06/28 21:34:26 hoek Exp % .\" -.\" jpman $Id: fstab.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: fstab.5,v 1.3 1998/06/12 11:00:49 mutoh Stab % .\" .Dd June 5, 1993 .Dt FSTAB 5 .Os BSD 4 .Sh 名称 .Nm fstab .Nd ファイルシステムに関する静的情報 .Sh 書式 .Fd #include .Sh 解説 .Nm fstab ファイルは、さまざまなファイルシステムについて記述した情報を格納します。 .Nm fstab はプログラムによって読み出されるだけで、書き込みはされません。 このファイルを適切に作成、保守するのはシステム管理者の責務です。 各ファイルシステムは個別の行に記述されます。 各々の行のフィールドはタブまたはスペースによって区切られます。 .Xr fsck 8 , .Xr mount 8 , および .Xr umount 8 が .Nm fstab を通じて必要な処理を連続して繰り返すため、 .Nm fstab のレコードの順序は重要な意味を持ちます。 .Pp 第1フィールド .Pq Fa fs_spec はマウントされるブロックスペシャルデバイス、またはリモートのファイル システムを表します。 .Em ufs 形式のファイルシステムでは、スペシャルファイル名はブロックスペシャル ファイル名であり、キャラクタスペシャルファイル名ではありません。 プログラムがキャラクタスペシャルファイル名を必要とする場合、そのプログラム がスペシャルファイル名の中の最後の ``/'' の後ろに ``r'' を追加することで キャラクタスペシャルファイル名を作成しなければなりません。 .Pp 第2フィールド .Pq Fa fs_file はファイルシステムのマウントポイントを表します。 スワップパーティションでは、このフィールドには ``none'' と記述すべきです。 .Pp 第3フィールド .Pq Fa fs_vfstype はファイルシステムの形式を表します。 システムはさまざまなファイルシステム形式をサポートできます。 ルート、 /usr および /tmp のファイルシステムだけはカーネルに静的に組み 込まれている必要があります。 他の全てのファイルシステムはマウント時に自動的にロードされます (例外 : UFS 系 - FFS , MFS および LFS は現在のところデマンドロードは できません)。 いまだに他のファイルシステムも同様に静的に組み込むのを好む人もいるようです。 .Bl -tag -width indent -offset indent .It Em ufs ローカルの .Tn UNIX ファイルシステム .It Em mfs ローカルのメモリベース .Tn UNIX ファイルシステム .It Em nfs Sun Microsystems 互換 ``Network File System'' .It Em swap スワッピングに使用されるディスクパーティション .It Em msdos DOS 互換ファイルシステム .It Em cd9660 ( ISO 9660 による) CD-ROM ファイルシステム .\" おそらく、例えばRock Ridge extension形式なども処理される? .It Em procfs プロセスデータへのアクセスのためのファイルシステム .It Em kernfs カーネルパラメータへのアクセスのためのファイルシステム .El .Pp 第4フィールド .Pq Fa fs_mntops は、ファイルシステムに関連するマウントオプションを表します。 これはコンマで区切られたオプションのリストとして記述されます。 これは少なくともマウントの形式(以下の .Fa fs_type 参照)を含み、加えてファイルシステム形式に特有のいくつかの追加の オプションを含みます。 .Pp ``userquota'' および ``groupquota'' オプションの双方、またはいずれかが 指定されている場合、ファイルシステムは自動的に .Xr quotacheck 8 コマンドによって処理され、ユーザおよびグループクォータが .Xr quotaon 8 で有効にされます。 デフォルトでは、ファイルシステムのクォータは関連するファイルシステムの ルートに置かれた .Pa quota.user および .Pa quota.group というファイルで管理されます。 これらのデフォルトは、クォータオプションの直後に等号とデフォルトに代わる 絶対パス名を置くことで変更することができます。 従って、 .Pa /tmp のユーザクォータファイルを .Pa /var/quotas/tmp.user に置く場合、そのファイルの場所は以下のように指定されます。 .Bd -literal -offset indent userquota=/var/quotas/tmp.user .Ed .Pp ``noauto'' オプションが指定されている場合、ファイルシステムはシステム 起動時に自動的にマウントされません。 .Pp マウント形式は .Fa fs_mntops フィールドから取り出され、 .Fa fs_type フィールドに個別に保存されます( .Fa fs_mntops フィールドからは削除されません)。 .Fa fs_type が ``rw'' または ``ro'' ならば、 .Fa fs_file フィールドで指定されたファイルシステムは、読み書き可能、または読み出し 専用で指定のスペシャルファイルに正常にマウントされます。 .Fa fs_type が ``sw'' ならば、スペシャルファイルはシステムのリブート処理の最後に .Xr swapon 8 コマンドによってスワップ領域の一部として使用されます。 .Fa fs_spec と .Fa fs_type 以外のフィールドは使用されません。 .Fa fs_type が ``xx'' と指定されている場合、このエントリは無視されます。 これは、現在使用されていないディスクパーティションを表すのに便利です。 .Pp 第5フィールド .Pq Fa fs_freq は、どのファイルシステムがダンプされる必要があるか決定するために .Xr dump 8 コマンドによって使用されます。 第5フィールドが与えられていない場合は 0 が返され、 .Nm dump コマンドはそのファイルシステムをダンプする必要がないと見なします。 .Pp 第6フィールド .Pq Fa fs_passno は、リブート時にファイルシステムのチェックが行われる順序を決定するために .Xr fsck 8 プログラムによって使用されます。 ルートファイルシステムは .Fa fs_passno に 1 、他のファイルシステムは .Fa fs_passno に 2 が指定されているべきです。 １つのドライブ内のファイルシステムは逐次的にチェックされますが、 異なるドライブ上のファイルシステムは、ハードウェアの並列性を利用して 同時にチェックされます。 第6フィールドが与えられていないか 0 の場合、0 が返され、 .Xr fsck 8 コマンドはそのファイルシステムをチェックする必要がないと見なします。 .Bd -literal #define FSTAB_RW "rw" /* 読み書き可能デバイス */ #define FSTAB_RQ "rq" /* クォータ付き読み書き可能デバイス */ #define FSTAB_RO "ro" /* 読み出し専用デバイス */ #define FSTAB_SW "sw" /* スワップデバイス */ #define FSTAB_XX "xx" /* 完全に無視 */ struct fstab { char *fs_spec; /* ブロックスペシャルデバイス名 */ char *fs_file; /* ファイルシステムのパスのプレフィックス */ char *fs_vfstype; /* ufs,nfs などのファイルシステム形式 */ char *fs_mntops; /* -o に準拠したマウントオプション */ char *fs_type; /* fs_mntops から FSTAB_* のコピー */ int fs_freq; /* ダンプ周期の日数 */ int fs_passno; /* 並列 fsck のパス番号 */ }; .Ed .Pp .Pa fstab のレコードを適切に読み出すには、 .Xr getfsent 3 , .Xr getfsspec 3 , .Xr getfstype 3 , および .Xr getfsfile 3 ルーチンを使用します。 .Sh 関連ファイル .Bl -tag -width /etc/fstab -compact .It Pa /etc/fstab .Nm fstab ファイルは .Pa /etc に存在します。 .El .Sh 関連項目 .Xr getfsent 3 , .Xr getvfsbyname 3 , .Xr dump 8 , .Xr fsck 8 , .Xr mount 8 , .Xr quotacheck 8 , .Xr quotaon 8 , .Xr swapon 8 , .Xr umount 8 .Sh 歴史 .Nm ファイルフォーマットは .Bx 4.0 から登場しました。 diff --git a/ja_JP.eucJP/man/man5/gettytab.5 b/ja_JP.eucJP/man/man5/gettytab.5 index 486371d9ce..22c153e70a 100644 --- a/ja_JP.eucJP/man/man5/gettytab.5 +++ b/ja_JP.eucJP/man/man5/gettytab.5 @@ -1,521 +1,521 @@ .\" 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: @(#)gettytab.5 8.4 (Berkeley) 4/19/94 .\" %Id: gettytab.5,v 1.7.2.8 1998/07/19 06:53:01 jkh Exp % .\" -.\" jpman $Id: gettytab.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: gettytab.5,v 1.3 1998/07/30 15:25:14 horikawa Stab % .\" " .\" WORD: terminal line 端末回線 .\" WORD: .Sh CAPABILITIES ケーパビリティ .\" WORD: erase 文字消去 .\" WORD: kill 行削除 .\" WORD: delay 遅延 .\" WORD: comma コンマ .\" WORD: banner バナー .\" WORD: answer chat script アンサーチャットスクリプト .\" WORD: screen 画面 [termcap.5 gettytab.5] .\" " .Dd April 19, 1994 .Dt GETTYTAB 5 .Os BSD 4.2 .\" turn off hyphenation .hym 999 .Sh 名称 .Nm gettytab .Nd 端末設定データベース .Sh 書式 .Nm gettytab .Sh 解説 .Nm ファイルは .Xr termcap 5 データベースを単純化したバージョンで、 端末回線を記述するのに用いられます。 冒頭に起動される端末ログインプロセス .Xr getty 8 は起動されるたびに .Nm ファイルにアクセスするので、 比較的簡単に端末の特性を再設定することができます。 データベースの各エントリは、それぞれ1個の端末クラスを記述するのに用いられます。 .Pp デフォルトの端末クラス .Em default が存在し、 他の全てのクラスに対するグローバルなデフォルト値を記述するのに 用いられます。 (言い替えれば、まず、 .Em default エントリを読み込み、その後で、必要なクラスのエントリを読み込み、 デフォルトの設定をクラス固有の設定で上書きします。) .Sh ケーパビリティ ファイルレイアウトの解説については、 .Xr termcap 5 を参照して下さい。 以下の .Em デフォルト 欄は、 使用する端末用のテーブルに値がなく、特別の .Em default テーブルにも値がない場合に用いられる値です。 .Bl -column 名称 文字列 /usr/bin/login .It Sy 名称 型 デフォルト 解説 .It "ac 文字列 unused モデム応答のための想定文字列-応答チャットスクリプト" .It "ap bool 偽 端末はどのパリティでも受け付ける" .It "bk 文字列 0377 代用の行末文字 (入力ブレーク)" .It "c0 数値 unused メッセージ書き出しのための tty コントロールフラグ群" .It "c1 数値 unused ログイン名読み込みのための tty コントロールフラグ群" .It "c2 数値 unused 端末を去るときのコントロールフラグ群" .It "ce bool 偽 crt 文字消去アルゴリズムを用いる" .It "ck bool 偽 crt 行削除アルゴリズムを用いる" .It "cl 文字列" Ta Dv NULL Ta .No "画面削除シーケンス" .It "co bool 偽 コンソール -" .Ql \en をログインプロンプトの後に追加する .It "ct 数値 10 ac/ic スクリプトのためのチャットタイムアウト" .It "dc 数値 0 チャットデバッグ用ビットマスク" .It "de 数値 0 この秒数だけ待って、最初のプロンプトを描く前に入力をフラッシュする" .It "ds 文字列" Ta So Li ^Y Sc Ta .No "遅延されたサスペンド文字" .It "dx bool 偽 " .Dv DECCTLQ をセットする .It "ec bool 偽 echo を残す" .Tn OFF .It "ep bool 偽 端末は偶数パリティを用いる" .It "er 文字列" Ta So Li ^? Sc Ta .No "消去文字" .It "et 文字列" Ta So Li ^D Sc Ta .No "テキストの終り" .Pq Dv EOF 文字 .It "ev 文字列" Ta Dv NULL Ta .No "環境変数の初期設定" .It "f0 数値 unused メッセージ書き出しのための tty モードフラグ群" .It "f1 数値 unused ログイン名読み込みのための tty モードフラグ群" .It "f2 数値 unused 端末を去るときの tty モードフラグ群" .It "fl 文字列" Ta So Li ^O Sc Ta .No "出力フラッシュ文字" .It "hc bool 偽 " 最後のクローズのときに回線をハングアップ .Tn させない .It "he 文字列" Ta Dv NULL Ta .No "ホスト名編集文字列" .It "hn 文字列 hostname ホスト名" .It "ht bool 偽 端末に本物のタブが実装されている" .It "hw bool 偽 cts/rts によるハードウェアフロー制御を行う" .It "i0 数値 unused メッセージ書き出しのための tty 入力フラグ群" .It "i1 数値 unused ログイン名読み込みのための tty 入力フラグ群" .It "i2 数値 unused 端末を去るときの tty 入力フラグ群" .It "ic 文字列 unused モデム初期化のための、想定入力-出力チャットスクリプト" .It "if 文字列 unused プロンプトの前に、/etc/issue のように名前で指定したファイルを表示する" .It "ig bool 偽 ログイン名に含まれるガベージ文字を無視する" .It "im 文字列" Ta Dv NULL Ta .No "冒頭の (バナー) メッセージ" .It "in 文字列" Ta So Li ^C Sc Ta .No "割り込み文字" .It "is 数値 unused 入力スピード" .It "kl 文字列" Ta So Li ^U Sc Ta .No "行消去文字" .It "l0 数値 unused メッセージ書き出しのための tty ローカルフラグ群" .It "l1 数値 unused ログイン名読み込みのための tty ローカルフラグ群" .It "l2 数値 unused 端末を去るときの tty ローカルフラグ群" .It "lm 文字列 login: ログインプロンプト" .It "ln 文字列" Ta So Li ^V Sc Ta .No "次の文字がリテラル値であることを示す文字" .It "lo 文字列" Ta Pa /usr/bin/login Ta .No "名前を得たときに実行するプログラム" .It "mb bool 偽 キャリアに基づいたフロー制御を行う" .It "nl bool 偽 端末には改行文字がある (あるいは、あるはずである)" .It "np bool 偽 端末はパリティを用いない (つまり 8bit 文字)" .It "nx 文字列 default (速度の自動選択のための) 次のテーブル" .It "o0 数値 unused メッセージ書き出しのための tty 出力フラグ群" .It "o1 数値 unused ログイン名読み込みのための tty 出力フラグ群" .It "o2 数値 unused 端末を去るときの tty 出力フラグ群" .It "op bool 偽 端末は奇数パリティを用いる" .It "os 数値 unused 出力スピード" .It "pc 文字列" Ta So Li \e0 Sc Ta .No "パッド文字" .It "pe bool 偽 プリンタの (ハードコピー) 文字消去アルゴリズムを用いる" .It "pf 数値 0 最初のプロンプトと" 引き続くフラッシュの間の遅延 (秒数) .It "pp 文字列 unused PPP 認証プログラム" .It "ps bool 偽 回線は" .Tn MICOM ポートセレクタに接続されている .It "qu 文字列" Ta So Li \&^\e Sc Ta .No "終了文字" .It "rp 文字列" Ta So Li ^R Sc Ta .No "行の再タイプ文字" .It "rt 数値 unused ac 使用時の ring タイムアウト" .It "rw bool 偽 入力に raw モードを" .Tn 用いずに 、cbreak を用いる .It "sp 数値 unused (入力および出力の) 回線速度" .It "su 文字列" Ta So Li ^Z Sc Ta .No "サスペンド文字" .It "tc 文字列 none テーブルの続き" .It "to 数値 0 タイムアウト (秒数)" .It "tt 文字列" Ta Dv NULL Ta .No "端末の型 (環境変数用)" .It "ub bool 偽 (プロンプトなどの) バッファリングしない出力を行う" .It "we 文字列" Ta So Li ^W Sc Ta .No "単語消去文字" .It xc bool 偽 コントロール文字を .Ql ^X の形で出力 .Tn しない .It "xf 文字列" Ta So Li ^S Sc Ta Dv XOFF (出力ストップ) 文字 .It "xn 文字列" Ta So Li ^Q Sc Ta Dv XON (出力開始) 文字 .It "Lo 文字列 C バナーメッセージでの \&%d のために用いるロケール" .El .Pp 以下のケーパビリティはもはや .Xr getty 8 によってサポートされていません。 .Bl -column 名称 文字列 /usr/bin/login .It "bd 数値 0 バックスペースでの遅延" .It "cb bool 偽 crt バックスペースモードを用いる" .It "cd 数値 0 復帰 (carriage return) での遅延" .It "fd 数値 0 フォームフィード (垂直移動) での遅延" .It "lc bool 偽 端末では小文字が使える" .It "nd 数値 0 改行 (ラインフィード) での遅延" .It "uc bool 偽 端末では大文字しか使えない" .El .Pp 回線速度が指定されていない場合、 getty が起動された時に設定されている速度は 変更されません。 入力速度または出力速度を指定したときは、 指定した方向の回線速度のみが上書き更新されます。 .Pp メッセージの出力時、ログイン名の入力時、 getty が処理を済ませて端末を手放す時に用いる 端末モードの値は ブール型フラグの指定に基づいて決定されます。 もしこの決定が適切でないことが分かった場合、 これら3つのどれか (あるいはすべて) の値は、数値指定 .Em \&c0 , .Em \&c1 , .Em \&c2 , .Em \&i0 , .Em \&i1 , .Em \&i2 , .Em \&l0 , .Em \&l1 , .Em \&l2 , .Em \&o0 , .Em \&o1 , または .Em \&o2 のどれかで上書きされます。 これらの数値指定では、フラグの値 (通常は、0 を頭につけた 8 進数) そのものを指定することができます。 これらのフラグは termio の .Em c_cflag , .Em c_iflag , .Em c_lflag , および .Em c_oflag の各フィールドにそれぞれ対応します。 それらのセットの各々は、完全に指定しなければ有効になりません。 .Em \&f0 , .Em \&f1 , および .Em \&f2 はTTYサブシステムの旧版の実装に対する後方互換性を意図した物です。 これらのフラグには、sgttyb の .Em sg_flags フィールドの (32ビット) 値の下位16ビットが含まれます。また、上位16ビットは ローカルモードを収めるワードを表します。 .Pp もし .Xr getty 8 がナル文字 (回線ブレークを示すものと見なされます) を受け取った場合、 プログラムは .Em nx エントリに示されたテーブルを用いて再始動します。 もしこのエントリがなければ、今まで用いていたテーブルを再び用います。 .Pp 遅延はミリ秒単位で指定し、tty ドライバが使用可能な遅延のうち最も 近いものが用いられます。 より大きな確実性が必要な場合は、0 から 1, 2, 3 までの値の 遅延はドライバの特別な遅延アルゴリズムから選択するものと解釈されます。 .Pp .Em \&cl 画面消去文字列には、その前に必要な遅延時間をミリ秒単位の (10 進数) 数値で (termcap 風に) 書くことができます。 この遅延はパディング文字 .Em \&pc を繰り返して用いることによりシミュレートされます。 .Pp 初期化メッセージ .Em \&im ログインメッセージ .Em \&lm および初期化ファイル .Em \&if は、以下の文字の並びをどれでも含めることができます。これらは .Xr getty 8 が実行されている環境から得た情報に展開されます。 .Pp .Bl -tag -offset indent -width \&%xxxxxxxxxxxxxx .It \&%d 現在の日付と時間を、 .Em \&Lo 文字列で指定したロケールでの表記法 ( .Xr strftime 3 の \&%+ フォーマット) で表したもの。 .It \&%h マシンのホスト名。通常は .Xr gethostname 3 によってシステムから得ますが、テーブルの .Em \&hn エントリで指定して、この値を書き換えることができます。 どちらの場合でも、これは .Em \&he 文字列を用いて編集することができます。 .Em \&he 文字列の中にある 1 個の '@' は 実際のホスト名から最終的なホスト名に 1文字のコピーを引き起こします。 .Em \&he 文字列中の '#' は実際のホスト名の次の1文字をスキップさせます。 '@' でも '#' でもない各文字は最終的なホスト名にコピーされます。 余分な '@' と '#' は無視されます。 .It \&%t tty の名前。 .It "\&%m, \&%r, \&%s, \&%v" それぞれ、 .Xr uname 3 が返す マシンの型、オペレーティングシステムのリリース、オペレーティングシステムの 名前、そしてカーネルのバージョンです。 .It \&%% 1個の .Dq % 文字。 .El .Pp getty がログインプロセス (通常は .Dq Pa /usr/bin/login ですが、 .Em \&lo 文字列で指定されていればそれ)を実行するとき、このプロセスの環境には .Em \&tt 文字列 (が存在すれば) で指定した 端末の型が設定されます。 .Em \&ev 文字列は、プロセスの環境にデータを追加するために使用することができます。 これはコンマで区切られた文字列からなり、それぞれは、 .Em name=value という形式になっていると仮定されます。 .Pp もしタイムアウトとして、 .Em \&to に 0 以外の値を指定した場合、 指定された秒数経過した後に終了します。 すなわち、getty はログイン名を受け取って制御を .Xr login 1 に渡すか、または alarm シグナルを受け取って終了します。 これはダイアルイン回線をハングアップするために有用です。 .Pp .Xr getty 8 からの出力は、 .Em \&op か .Em \&np が指定された場合を除いて、偶数パリティを用います。 .Em \&op 文字列と .Em \&ap を一緒に指定すると、 入力としてはパリティが何であっても許可し、出力としては奇数パリティを 生成します。 注意: これは、getty が実行されているときのみ適用され、端末ドライバの 制限によりここまで完全な実装ができないかもしれません。 .Xr getty 8 は .Dv RAW モードのときは入力文字のパリティ検査を行いません。 .Pp もし .Em \&pp 文字列が指定されていて、 PPP リンク確立シーケンスが認識されると、 getty は pp オプションで指定されているプログラムを起動します。 これは PPP 着信を取り扱うために用いることができます。 .Pp .Nm getty は以下の2つのケーパビリティを用いて利用できるチャットスクリプト機能を 提供します。これによって、 基本的なインテリジェントモデムをある程度取り扱えるようにします。 .Pp .Bl -tag -offset indent -width \&xxxxxxxx -compact .It ic モデムを初期化するチャットスクリプト。 .It ac コールに答えるチャットスクリプト。 .El .Pp チャットスクリプトは、受信を想定した文字列/送信する文字列の対の連なり からなります。チャット文字列が始まるとき、 .Nm getty は最初の文字列を待ち、その文字列を見つけたら 2 番目の文字列を送ります。 以後も同様に処理を進めます。 指定された文字列は 1 個以上のタブあるいはスペースで区切られています。 文字列には標準 ASCII 文字と、特別な「エスケープ」を含めることが できます。エスケープは、バックスラッシュに続き1文字以上の文字が 続いたもので、それは 以下のように解釈されます。 .Pp .Bl -tag -offset indent -width \&xxxxxxxx -compact .It \ea ベル文字。 .It \eb バックスペース。 .It \en 改行。 .It \ee エスケープ。 .It \ef フォームフィード。 .It \ep 0.5秒の一時停止。 .It \er 復帰文字。 .It \eS, \es 空白文字。 .It \et タブ。 .It \exNN 16 進数のバイト値。 .It \e0NNN 8 進数のバイト値。 .El .Pp .Ql \ep 文字列は送信文字列でのみ有効で、前の文字と次の文字を送る間に 0.5 秒の 一時停止を発生することに注意のこと。 16 進数値は最大で 16 進数 2 桁で、 8 進数値は最大で 8 進数 3 桁です。 .Pp .Em \&ic チャットシーケンスはモデムやそれに類似したデバイスを初期化するのに 用いられます。ヘイズ互換のコマンドセットを持つモデム用の初期化チャット スクリプトの典型例は、以下のようなものでしょう。 .Pp .Dl :ic="" ATE0Q0V1\er OK\er ATS0=0\er OK\er: .Pp このスクリプトは何も待たず (つまり常に成功し)、モデムが正しいモード (コマンドエコーを抑制し、応答を返す際に冗長モードで返す) に確実になるようなシーケンスを送り、それから自動応答を 切ります。 終了する前に、 "OK" という反応を待ちます。 この初期化シーケンスは、モデムの応答をチェックして モデムが正しく機能しているかを確かめるために 用いられます。 初期化スクリプトが完了するのに失敗した場合、 .Nm getty はこれを致命的な状態であると見なし、その結果として、 .Xr syslogd 8 を用いてログを残してから終了します。 .Pp 同様に、アンサーチャットスクリプトは (通常) "RING" に対して手動で電話に応答するために 用いることができます。 アンサースクリプトを指定して起動した場合、 .Nm getty はポートをノンブロッキングモードでオープンし、それ以前の余分な入力をすべて 消去し、ポートへのデータを待ちます。 何らかのデータが取得可能になるとすぐ、アンサーチャットスクリプトが 開始し、文字列がスキャンされ、アンサーチャットスクリプトに従って 応答します。 ヘイズ互換のモデムでは、スクリプトは通常以下のような感じのものになるでしょう。 .Pp .Dl :ac=RING\er ATA\er CONNECT: .Pp これは、"ATA" コマンドによってモデムに応答させ、続いて 入力をスキャンして文字列 "CONNECT" を探します。 もし .Em \&ct タイムアウトが生じる前にこの文字列を受け取った場合、 通常のログインシーケンスが開始されます。 .Pp .Em \&ct ケーパビリティはすべての送信文字列および想定される入力文字列 に適用されるタイムアウトの値を指定します。このタイムアウトは 文字列待ちを行うごと、および文字列送信を行うごとに設定されます。 少なくともリモートとローカルのモデムの間のコネクションが確立される のにかかる時間 (通常およそ10秒) だけの長さは必要です。 .Pp ほとんどの情況で、コネクションが検出された後に 追加の入力のすべてをフラッシュしたいと思うものですが、 この目的には .Em \&de ケーパビリティを使うことができます。これは、 コネクションが確立された後で短時間の遅延をかけ、 その間に接続データがすべてモデムによって送られてしまうのと 同じ効果を持ちます。 .Pp .Sh 関連項目 .Xr login 1 , .Xr gethostname 3 , .Xr uname 3 , .Xr termcap 5 , .Xr getty 8 , .Xr telnetd 8 . .Sh バグ 特殊文字 (文字消去、行削除など) は .Xr login 1 によってシステムのデフォルトに再設定されてしまいます。 .Em 常に、 ログイン名としてタイプした '#' あるいは '^H' は1文字消去として 扱われ、 '@' は行消去として扱われます。 .Pp 遅延機能は実クロックです。 全般的に柔軟性がないという問題はさておき、遅延アルゴリズムのいくつかは 実装されていません。 端末ドライバが正常な遅延の設定をサポートしている必要があります。 .Pp .Em \&he ケーパビリティは全く知的ではありません。 .Pp 忌まわしい .Xr termcap 5 フォーマットより、もっと合理的なものを選ぶべきでした。 .Sh 歴史 .Nm ファイルフォーマットは .Bx 4.2 で登場しました。 diff --git a/ja_JP.eucJP/man/man5/groff_font.5 b/ja_JP.eucJP/man/man5/groff_font.5 index 4abb9e0bbf..af5110dcdf 100644 --- a/ja_JP.eucJP/man/man5/groff_font.5 +++ b/ja_JP.eucJP/man/man5/groff_font.5 @@ -1,370 +1,370 @@ -.\" jpman $Id: groff_font.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: groff_font.5,v 1.3 1998/08/09 15:05:21 ryo2 Stab % .\" FreeBSD jpman project 訳語表 .\" WORD: machine unit マシン単位 .\" WORD: scaled point スケールドポイント (troff.1 の記述にあわせた) .\" WORD: font position フォント位置 (troff.1 の記述にあわせた) .\" WORD: mount マウント .ig \"-*- nroff -*- Copyright (C) 1989-1995 Free Software Foundation, Inc. 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. 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. 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. .. .de TQ .br .ns .TP \\$1 .. .\" Like TP, but if specified indent is more than half .\" the current line-length - indent, use the default indent. .de Tp .ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP .el .TP "\\$1" .. .TH GROFF_FONT 5 "7 September 1996" "Groff Version 1.10" .SH 名称 groff_font \- groff のデバイスとフォントを記述するファイルの書式 .SH 解説 groff のフォントの書式は ditroff のフォントの書式に対し、 ほぼスーパセットになっています。 ditroff のフォントの書式とは異なり、 関連したバイナリ書式はありません。 .I name というデバイス用のフォントファイルは .BI dev name というディレクトリに納められます。 ファイルには 2 つの種類があります: それは .B DESC と呼ばれるデバイス記述ファイルと、各フォント .I F ごとに存在する .IR F と呼ばれるフォントファイルです。 これらはテキストファイルであり、関連したバイナリ書式の ファイルはありません。 .SS DESC ファイルの書式 DESC ファイルは以下の形式の行を含むことができます: .TP .BI res\ n 1 インチあたりのマシン単位は .I n です。 .TP .BI hor\ n 水平解像度は .I n マシン単位です。 .TP .BI vert\ n 垂直解像度は .I n マシン単位です。 .TP .BI sizescale\ n ポイント数への倍率を指定します。デフォルトの値は 1 です。1 .I スケールドポイント は、1 .RI ポイント/ n と等しくなります。 .B unitwidth コマンドと .B sizes コマンドへの引数はスケールドポイントで指定されます。 .TP .BI unitwidth\ n ポイントサイズが .I n スケールドポイントのフォントに対して、 フォントファイル毎の数量をマシン単位で与えます。 .TP .B tcommand ポストプロセッサが .B t と .B u の出力コマンドを扱えることを表します。 .TP .BI sizes\ s1\ s2\|.\|.\|.\|sn\ 0 デバイスが .IR s1 , .IR s2 ,\|.\|.\|.\| sn スケールドポイントのフォントを持つことを表します。 大きさのリストは .BR 0 で終らなければなりません。 各 .BI s i は大きさの範囲 .IR m \- n でも指定できます。 リストは複数行にわたることも可能です。 .TP .BI styles\ S1\ S2\|.\|.\|.\|Sm 先頭 .I m 個のフォント位置が、スタイル .IR S1\|.\|.\|.\|Sm に関連づけられます。 .TP .BI fonts\ n\ F1\ F2\ F3\|.\|.\|.\|Fn フォント .I F1\|.\|.\|.\|Fn がフォント位置 .IR m +1,\|.\|.\|., m + n にマウントされます( .I m はスタイル数)。 このコマンドは複数行にわたることができます。 .B 0 というフォント名を指定すると、 対応するフォント位置にはフォントはマウントされません。 .TP .BI family\ fam デフォルトのフォントファミリは .IR fam です。 .TP .B charset この行とファイル内の以下に続く行はすべて無視されます。 これは下位互換性のために許されています。 .LP res, unitwidth, fonts, sizes の行は必須です。 他のコマンドは .B troff には無視されますが、デバイスに関する任意の情報を DESC ファイルに 入れておくためにポストプロセッサにより使われるかもしれません。 .SS フォントファイルの書式 フォントファイルには 2 つのセクションがあります。 最初のセクションは空白で区切られた単語が並んだ一連の行からなります。 行の最初の単語はキーで、以降の単語はそのキーに対する値となります。 .TP .BI name\ F フォントの名前は .IR F です。 .TP .BI spacewidth\ n 空白の通常の幅は .IR n です。 .TP .BI slant\ n フォントの文字が .I n 度傾斜していることを表します (正の値は進行方向を意味します)。 .TP .BI ligatures\ lig1\ lig2\|.\|.\|.\|lign\ \fR[ 0 \fR] 文字 .IR lig1 , .IR lig2 ,\|.\|.\|., lign は合字 (リガチャ; ligature) です。合字には .BR ff , .BR fi , .BR fl , .BR ffl が使用可能です。 下位互換性のために、合字のリストは .BR 0 で終ってもかまいません。 合字のリストは複数行にわたってはいけません。 .TP .B special フォントは .IR スペシャル です。これは現在のフォントに存在しない文字が要求された場合、 マウントされた全てのスペシャルフォントが検索されることを示しています。 .LP 他のコマンドは .B troff には無視されますが、フォントに関する任意の情報をフォントファイルに 入れておくためにポストプロセッサにより使われるかも知れません。 .LP 最初のセクションには .B # 文字ではじまるコメントを、行末まで入れることができます。 .LP 次のセクションには 1 つか 2 つのサブセクションが含まれます。 サブセクション .I charset は必須で、サブセクション .I kernpairs はオプションです。 これらのサブセクションは任意の順番で書くことができます。 各サブセクションは、サブセクション名のみからなる行から始まります。 .LP 単語 .B charset で charset サブセクションを開始します。 .B charset 行には一連の行が続きます。 各行は 1 文字の情報を与えます。 行は空白かタブにより区切られたいくつかのフィールドから成ります。 書式は .IP .I name metrics type code comment .LP で、 .I name は文字を識別します: .I name が単一の文字 .I c ならば、それは groff の入力文字 .I c を表します。 .BI \e c という形式で c が単一の文字なら、groff の入力文字 .BI \e c を表します。それ以外は groff の入力文字 .BI \e[ name ] を表します (2 文字の .I xx だとすると、 .BI \e( xx として入力されます) 。 groff は 8 ビット文字に対応していますが、いくつかのユーティリティでは 8 ビット文字を扱うのが困難です。 このような理由から、文字コードが .I n である単一の文字と等価な .BI char n という表記法が存在します。 例えば、 .B char163 は ISO Latin-1 で英国ポンド記号を表す文字コード 163 の文字と等価です。 .B \-\-\- という name は特別で、その文字に名前が無いことを示します。 そのような文字は .BR troff 中でエスケープシーケンス .B \eN によってのみ使われます。 .LP .I type フィールドは文字の種類を示します: .TP 1 は descender (ベースラインより下にはみ出した部分) を持つ 文字であることを表します。例えば p があてはまります。 .TP 2 は ascender (x の高さより上に出る部分) を持つ文字であることを表します。 例えば b があてはまります。 .TP 3 は ascender と descender の両方を持つ文字であることを表します。 例えば ( があてはまります。 .LP .I code フィールドはポストプロセッサが文字を印字するために使うコードを示します。 .B \eN というエスケープシーケンスを用いたこのコードを使って、groff に文字を 入力することもできます。 code はどんな整数でもかまいません。 .B 0 から始まると、8 進数として扱われ、 .B 0x や .B 0X で始まると 16 進数として扱われます。 .LP 行の code フィールド以降はすべて無視されます。 .LP .I metrics フィールドの形式はこのようになります: .IP .IR width [\fB, height [\fB, depth [\fB, italic_correction [\fB, \ left_italic_correction [\fB, subscript_correction ]]]]] .LP サブフィールド間には空白を入れてはいけません。 サブフィールドが存在しない場合は 0 として扱われます。 サブフィールドは全て 10 進数の整数で指定されます。 対応するバイナリフォーマットが存在しないので、 ditroff のようにこれらの値を .B char 型変数の範囲に合わせるという必要はありません。 サブフィールド .I width では文字の幅を指定します。 サブフィールド .I height では文字の高さを指定します (上が正)。 文字がベースラインよりも上にいかない場合、負の高さを持つとするのではなく 高さが 0 であるとします。 サブフィールド .I depth では文字の深さを指定します。これはベースラインから文字の一番下までの 長さです (下が正) 。 文字がベースラインより下に出ていない場合、負の深さを持つとするのではなく 深さが 0 であるとします。 サブフィールド .I italic_correction では直後にローマンフォントの文字が続く時に、文字の後に加えられる空白の 量を指定します。 サブフィールド .I left_italic_correction では直前にローマンフォントの文字がある時に、文字の前に加えられる空白の 量を指定します。 サブフィールド .I subscript_correction では添字 (subscript) を加える際に文字の後に加えられる空白の量を 指定します。 これはイタリック補正 (上記の italic_correction) よりは少なくなければ なりません。 .LP charset セクション内では、以下のような書式の行も可能です .IP .I name \fB" .LP これは .I name が前の行で言及した文字の別名であることを表します。 .LP kernpairs セクションは .B kernpairs という単語から始まります。このセクションは以下のような書式の 行からなります: .IP .I c1 c2 n .LP 文字 .I c1 が文字 .I c2 の次に現れる時には、それらの間の空白に .IR n を加えることを意味します。 kernpairs セクションのほとんどのエントリは .IR n に負の値を持つことになります。 .SH 関連ファイル .Tp \w'/usr/share/groff_font/devname/DESC'u+3n .BI /usr/share/groff_font/dev name /DESC デバイス .IR name 用のデバイス記述ファイル .TP .BI /usr/share/groff_font/dev name / F デバイス .IR name のフォント .I F 用のフォントファイル .SH 関連項目 .BR groff_out (5), .BR troff (1). diff --git a/ja_JP.eucJP/man/man5/groff_out.5 b/ja_JP.eucJP/man/man5/groff_out.5 index acb339d5e5..dfe9d9ec74 100644 --- a/ja_JP.eucJP/man/man5/groff_out.5 +++ b/ja_JP.eucJP/man/man5/groff_out.5 @@ -1,226 +1,226 @@ '\" e .ig \"-*- nroff -*- Copyright (C) 1989-1995 Free Software Foundation, Inc. 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. 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. 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. .. .\" This man page must be preprocessed with eqn. .\" -.\" jpman $Id: groff_out.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: groff_out.5,v 1.3 1998/08/09 15:06:44 ryo2 Stab % .\" FreeBSD jpman project 訳語表 .\" WORD: scaled point スケールドポイント (troff.1, groff_font.5 参照) .\" WORD: special character 特殊文字 (troff.1 参照) .\" WORD: special font スペシャルフォント (troff.1 参照) .\" WORD: machine unit マシン単位 (pic.1, groff_font.5 参照) .\" WORD: print 印字 .ie \n(.g .ds ic \/ .el .ds ic \^ .TH GROFF_OUT 5 "11 May 1998" "Groff Version 1.10" .SH 名称 groff_out \- groff の中間出力フォーマット .SH 解説 このマニュアルページは、GNU troff の出力フォーマットについて記述します。 GNU troff が使用する出力フォーマットは、 UNIX のデバイス非依存 troff が使用するものと似ています。 ここでは両者の差のみを記述します。 .LP .B s コマンドへの引数はスケールドポイントです (これは .IR ポイント/ n を意味します。 .I n は DESC ファイル中の .B sizescale コマンドへの引数です)。 .B x\ Height コマンドへの引数もまたスケールドポイントです。 .LP 最初の 3 つの出力コマンドは次のようになっていなければなりません: .IP .BI x\ T\ device .br .BI x\ res\ n\ h\ v .br .B x init .LP DESC ファイル中に .B tcommand 行が存在する場合には、troff は以下の 2 つのコマンドを使用します。 .TP .BI t xxx .I xxx は、任意の文字のシーケンスであり、空白または改行を終端とします; 最初の文字を現在位置で印字し、 現在の水平位置を最初の文字の幅だけ増加させます。 続けて、同じ処理を各文字に対して実行します。 文字の幅は、フォントファイルにおいて与えられたものを 現在のポイントサイズに応じて適切にスケーリングしてから、 水平解像度の倍数となるように丸めます。 特殊文字はこのコマンドでは印字できません。 .TP .BI u n\ xxx .B t コマンドと同様ですが、各文字の印字後に現在の水平位置に加えられるものが、 文字幅と .IR n の和である点が違います。 .LP 単一文字は 8 ビット目がセットされていてもかまわないことに注意してください。 これはフォント名や特殊文字名にもあてはまります。 .LP 文字名やフォント名は任意の長さが許されます; ドライバはこれらの長さが 2 文字のみであると仮定してはなりません。 .LP 文字を印字する時、その文字は常に現在のフォント中に存在します。 デバイス非依存 troff とは異なり、 ドライバがスペシャルフォントから文字を探す必要はありません。 .LP .B D 描画コマンドは拡張されています。 .B \-n オプション指定時には、GNU pic はこれらの拡張を使用しません。 .TP \fBDf \fIn\fR\*(ic\en オブジェクトの塗り潰しに使用する陰影を .IR n に設定します; ここで .I n は 0 から 1000 の範囲の整数である必要があり、0 は白の塗り潰しを、 1000 は黒の塗り潰しを、 そしてそれらの間の値は中間の陰影を意味します。 この設定は、円の塗り潰し、楕円の塗り潰し、多角形の塗り潰しにのみ適用されます。 デフォルトでは 1000 が使用されます。 塗り潰しオブジェクトが色を持つ場合、 その色でそのオブジェクトの下の全てのものを完全に隠します。 1000 より大きい値や 0 より小さい値も使用される可能性があります: これらの値を指定すると、 現在線やテキストで使用している陰影で塗り潰すことを意味します。 通常はこれは黒ですが、 ドライバによってはこれを変更する手段を提供するものがあります。 .TP \fBDC \fId\fR\*(ic\en 現在位置を最左端とする、半径 .I d の塗り潰された円を描画します。 .TP \fBDE \fIdx dy\fR\*(ic\en 現在位置を最左端とする、水平半径 .I dx 垂直半径 .I dy の塗り潰された楕円を描画します。 .EQ delim $$ .EN .TP \fBDp\fR $dx sub 1$ $dy sub 1$ $dx sub 2$ $dy sub 2$ $...$ $dx sub n$ $dy sub n$\en $i = 1 ,..., n+1$ に対し、 .I i 番目の頂点を現在位置 $+ sum from j=1 to i-1 ( dx sub j , dy sub j )$ とする多角形を描画します。 今のところ、GNU pic のみがこのコマンドを使用し、三角形と矩形を生成します。 .TP \fBDP\fR $dx sub 1$ $dy sub 1$ $dx sub 2$ $dy sub 2$ $...$ $dx sub n$ $dy sub n$\en .B Dp と同様ですが、多角形の外形のみの描画でなく、塗り潰しも行います。 .TP \fBDt \fIn\fR\*(ic\en 現在の線の太さを .I n マシン単位に設定します。 伝統的に UNIX troff ドライバは、 現在のポイントサイズに比例する線の太さを使用します; .B Dt コマンドが指定されない場合や、 .B Dt コマンドに負の .IR n が指定された場合は、ドライバはこの方法を使用する必要があります。 .I n に 0 を指定すると、利用可能な最小の線の太さを選択します。 .LP これらのコマンドを実行した後、 現在位置をどのように変更するのかという問題が生じます。 GNU pic が生成するコードはこの問題に依存しませんので、 これはたいして重要ではありません。 .IP \fB\eD\(fm\fIc\fR $x sub 1$ $y sub 1$ $x sub 2$ $y sub 2$ $...$ $x sub n$ $y sub n$\(fm .LP の形式、ただし .I c は .BR c , .BR e , .BR l , .BR a , .BR ~ のいずれでもない描画コマンドが与えられた時、 UNIX troff は各 $x sub i$ を水平の単位で扱い、$y sub i$ を垂直の単位で扱い、 描画されるオブジェクトの幅は $sum from i=1 to n x sub i$ であり、 高さは $sum from i=1 to n y sub i$ であると仮定します。 (高さに関する仮定は、このような .B D コマンドを \ew エスケープシーケンス中で使用した後、 .B st レジスタおよび .B sb レジスタを検査することにより確認できます。) この規則は全てのオリジナルの描画コマンドにあてはまりますが、 .B De は例外です。 .BR Df , .B Dt コマンドや、影響は少ないですが .B DE コマンドにおいて、たとえ醜い結果となったとしても、 GNU troff もまた互換性のためにこの規則に従います。 それゆえ、 .IP \fBD\fIc\fR $x sub 1$ $y sub 1$ $x sub 2$ $y sub 2$ $...$ $x sub n$ $y sub n$\en .LP の形式の .B D コマンドを実行した後は、現在位置は $( sum from i=1 to n x sub i , sum from i=1 to n y sub i )$ だけ増えます。 .LP .B x\ X コマンドへの引数に改行を含めることを許すという、 継続に関する取り決めがあります: .B x\ X コマンドへの引数を出力する時、GNU troff は 引数中の .B + 文字付きの改行を辿ります (通常は改行で引数全体が終端されます); それゆえ、 .B x\ X コマンドを含む行の次行が .B + で開始する場合には、 .B x\ X コマンドを含む行の終端となっている改行は .B x\ X コマンドへの引数の一部として扱い、 .B + を無視し、行の .B + に続く部分を .B x\ X コマンドに続く行の部分として扱います。 .SH "関連項目" .BR groff_font (5) diff --git a/ja_JP.eucJP/man/man5/group.5 b/ja_JP.eucJP/man/man5/group.5 index ad6e268e39..362a6acff6 100644 --- a/ja_JP.eucJP/man/man5/group.5 +++ b/ja_JP.eucJP/man/man5/group.5 @@ -1,149 +1,149 @@ .\" 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: @(#)group.5 8.3 (Berkeley) 4/19/94 .\" %Id: group.5,v 1.4.2.2 1998/06/28 21:34:26 hoek Exp % -.\" jpman $Id: group.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: group.5,v 1.3 1998/07/02 14:08:51 horikawa Stab % .\" .Dd September 29, 1994 .Dt GROUP 5 .Os .Sh 名称 .Nm group .Nd グループ許可ファイルのフォーマット .Sh 解説 .Aq Pa /etc/group ファイルは改行で区切られた .Tn ASCII レコードから成ります。1 レコードが 1 グループに対応し、コロン .Ql \&: で区切られた 4 つの欄から成ります。 これらの欄の意味は以下のとおりです: .Bl -tag -width password -offset indent -compact .It group そのグループの名前。 .It passwd グループの .Em 暗号化された パスワード。 .It gid そのグループの 10 進数 ID。 .It member グループメンバ。 .El .Pp .Ar group 欄は、そのグループのメンバであるユーザにファイルアクセスを許可するために 用いる、グループの名前です。 .Ar gid 欄はそのグループ名に結び付けられた番号です。両者はファイルアクセスを制御 しますので、システム (またしばしば複数システムの 1 グループ) 中で一意的で ある必要があります。 .Ar passwd 欄はなくてもいい .Em 暗号化された パスワードです。この欄はめったに用いられるこ とはなく、通常ブランクにしておくよりもむしろアスタリスクが置かれます。 .Ar member 欄は .Ar group の権利を許可されたユーザの名前を含んでいます。メンバ名は空白や改行なし にコンマで区切られます。ユーザの .Pa /etc/passwd エントリ中にグループが指定されていれば自動的にそのグループに入ることに なりますので、 .Pa /etc/group ファイル中にそのユーザを追加する必要はありません。 .\" .Pp .\" When the system reads the file .\" .Pa /etc/group .\" the fields are read into the structure .\" .Fa group .\" declared in .\" .Aq Pa grp.h : .\" .Bd -literal -offset indent .\" struct group { .\" char *gr_name; /* group name */ .\" char *gr_passwd; /* group password */ .\" int gr_gid; /* group id */ .\" char **gr_mem; /* group members */ .\" }; .\" .Ed .Sh YP/NIS との相互作用 .Pa /etc/group ファイルは YP/NIS グループデータベースを有効にするように作成可能です。 C ライブラリ内部としては、 .Ar name 欄が 1 つのプラス符号 (`+') に続く 1 つのグループ名から成るエントリは、 その名前のグループに対する YP/NIS グループエントリで置き換えられます。 .Ar name 欄が引き続いてグループ名を持たない 1 つのプラス符号から成るエントリは、 YP/NIS の .Dq Li group.byname マップ全体で置き換えられます。 .Pp 何らかの理由で YP/NIS グループデータベースが有効になった場合、 少数のグループのみが有効であるときですら、全ての逆検索 (すなわち .Fn getgrgid ) ではデータベース全体を利用することになるでしょう。それ故、 .Fn getgrgid が返すグループ名が正しい前方マッピングを持つことは保証できません。 .Sh 制限 1 つのグループは 200 以上のメンバを持つことはできません。 .Pa /etc/group の最大行長は 1024 文字です。それより長い行は読み飛ばされます。 .Sh 関連ファイル .Bl -tag -width /etc/group -compact .It Pa /etc/group .El .Sh 関連項目 .Xr passwd 1 , .Xr setgroups 2 , .Xr crypt 3 , .Xr getgrent 3 , .Xr initgroups 3 , .Xr yp 4 , .Xr passwd 5 .Sh バグ .Xr passwd 1 コマンドは .Nm group パスワードを変更しません。 .Sh 歴史 .Nm ファイルフォーマットは .At v6 で現われました。 YP/NIS の機能は .Tn SunOS を手本に作られ、 .Tn FreeBSD 1.1 で初めて現われました。 diff --git a/ja_JP.eucJP/man/man5/hosts.5 b/ja_JP.eucJP/man/man5/hosts.5 index 2ddfbb8e9c..a3f2bde98e 100644 --- a/ja_JP.eucJP/man/man5/hosts.5 +++ b/ja_JP.eucJP/man/man5/hosts.5 @@ -1,102 +1,102 @@ .\" 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. .\" .\" @(#)hosts.5 8.2 (Berkeley) 12/11/93 .\" %Id: hosts.5,v 1.2.2.2 1998/06/28 21:34:26 hoek Exp % .\" -.\" jpman $Id: hosts.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: hosts.5,v 1.3 1998/06/12 15:52:05 kumano Stab % .Dd December 11, 1993 .Dt HOSTS 5 .Os BSD 4.2 .Sh 名称 .Nm hosts .Nd ホスト名データベース .Sh 解説 .Nm hosts ファイルはネットワーク上の既知のホストに関する情報を保持します。 各ホストに対して、1つの行に以下の情報を与えます。 .Bd -unfilled -offset indent インターネットアドレス 正式なホスト名 別名 .Ed .Pp 各項目は任意の数の空白やタブ文字で区切られます。 ``#'' はコメントの開始を表し、これ以降の行末までの文字はこの ファイルを検索するルーチンによって解釈されません。 .Pp ネームサーバ .Xr named 8 使用時には、このファイルはネームサーバが動作していない時の予備として 機能します。 ネームサーバのために、ごく少数のアドレスがこのファイルに含まれて いなければなりません。 これらはブート時に .Xr ifconfig 8 が必要とするローカルインタフェースのアドレス、およびローカルネットワーク 上の少数のマシンを含みます。 .Pp このファイルは Network Information Control Center .Pq Tn NIC で保守された正式なホストデータベースから作成されますが、非公式な別名や 未知のホストに関しては、ローカルでの変更を最新に保つ必要があります。 .Tn NIC で保守されたデータベースは不完全なので、 .Tn DARPA インターネット上のサイトではネームサーバの使用が推奨されます。 .Pp ネットワークアドレスは、インターネットアドレス操作ライブラリ .Xr inet 3 の .Xr inet_addr 3 ルーチンを用いた伝統的な ``.'' (ドット) 表記で指定されます。 ホスト名は、フィールド区切り文字、改行、およびコメント文字 以外のあらゆる印字可能文字を含むことができます。 .Sh 関連ファイル .Bl -tag -width /etc/hosts -compact .It Pa /etc/hosts .Nm hosts ファイルは .Pa /etc に存在します。 .El .Sh 関連項目 .Xr gethostbyname 3 , .Xr ifconfig 8 , .Xr named 8 .Rs .%T "Name Server Operations Guide for BIND" .Re .Sh 歴史 .Nm ファイルフォーマットは .Bx 4.2 から登場しました。 diff --git a/ja_JP.eucJP/man/man5/hosts.equiv.5 b/ja_JP.eucJP/man/man5/hosts.equiv.5 index e093198303..a141911bf4 100644 --- a/ja_JP.eucJP/man/man5/hosts.equiv.5 +++ b/ja_JP.eucJP/man/man5/hosts.equiv.5 @@ -1,124 +1,124 @@ .\" 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: hosts.equiv.5,v 1.2.2.2 1998/06/28 21:34:26 hoek Exp % .\" -.\" jpman $Id: hosts.equiv.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: hosts.equiv.5,v 1.3 1998/06/12 11:02:12 mutoh Stab % .Dd Feb 1996 .Dt HOSTS.EQUIV 5 .Os FreeBSD .Sh 名称 .Nm hosts.equiv , .Nm .rhosts .Nd 信頼できるリモートホスト名、およびユーザのデータベース .Sh 解説 .Nm hosts.equiv および .Nm .rhosts ファイルは、ネットワーク上の信頼できるホストとユーザに関する情報を格納 します。 各ホストに対して、1つの行に以下の情報を与えます。 単純に .Bd -unfilled -offset indent hostname [username] .Ed あるいは、より冗長に以下のようにします。 .Bd -unfilled -offset indent [+-][hostname|@netgroup] [[+-][username|@netgroup]] .Ed .Pp ``@'' は netgroup というグループによってホスト、またはユーザを表します。 単独の ``+'' は全てのホスト、またはユーザと一致します。 前に ``-'' を伴うホスト名は、一致する全てのホストとそのホスト上の全ての ユーザを拒否します。 前に ``-'' を伴うユーザ名は、指定されたホスト上の一致したユーザ全てを 拒否します。 .Pp 各項目は任意の数の空白やタブ文字で区切られます。 ``#'' はコメントの開始を表し、これ以降の行末までの文字はこのファイルを 検索するルーチンによって解釈されません。 .Pp ホスト名は、インターネットアドレス操作ライブラリ .Xr inet 3 の .Xr inet_addr 3 ルーチンを用いた伝統的な ``.'' (ドット) 表記で指定されます。 ホスト名は、フィールド区切り文字、改行、およびコメント文字 以外のあらゆる印字可能文字を含むことができます。 .Pp セキュリティ上の理由から、ユーザの .Nm .rhosts が通常ファイルでないか、所有者がそのユーザでないか、あるいはその ユーザ以外のユーザが書き込み可能な場合、そのファイルは無視されます。 .Sh 使用例 .Pp .Dl bar.com foo .Pp ホスト ``bar.com'' の ユーザ ``foo'' を信頼します。 .Pp .Dl +@allclient .Pp ネットグループ ``allclient'' の全てのホストを信頼します。 .Pp .Dl +@allclient -@dau .Pp ネットグループ ``allclient'' の全てのホストとそのユーザを信頼しますが、 ネットグループ ``dau'' のユーザは例外です。 .Sh 関連ファイル .Bl -tag -width /etc/hosts.equivxxx -compact .It Pa /etc/hosts.equiv .Nm hosts.equiv ファイルは .Pa /etc に存在します。 .It Pa $HOME/.rhosts .Nm .rhosts ファイルは .Pa $HOME に存在します。 .El .Sh 関連項目 .Xr rcp 1 , .Xr rlogin 1 , .Xr rsh 1 , .Xr gethostbyname 3 , .Xr inet 3 , .Xr innetgr 3 , .Xr ruserok 3 , .Xr yp 4 , .Xr ifconfig 8 , .Xr named 8 .Sh バグ このマニュアルページは不完全です。 より詳細については、 lib/libc/net/rcmd.c のソースか、 SunOS の マニュアルページを参照してください。 diff --git a/ja_JP.eucJP/man/man5/hosts.lpd.5 b/ja_JP.eucJP/man/man5/hosts.lpd.5 index 14fa7fc27d..21e4b10261 100644 --- a/ja_JP.eucJP/man/man5/hosts.lpd.5 +++ b/ja_JP.eucJP/man/man5/hosts.lpd.5 @@ -1,57 +1,57 @@ .\" 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: hosts.lpd.5,v 1.2.2.1 1997/03/07 04:18:06 mpp Exp % -.\" jpman $Id: hosts.lpd.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: hosts.lpd.5,v 1.3 1998/04/29 11:35:23 kuma Stab % .\" .\" WORD: trusted host 信頼できるホスト .\" .Dd June 1, 1996 .Dt HOSTS.LPD 5 .Os FreeBSD .Sh 名称 .Nm hosts.lpd .Nd ローカルプリントサービスを使用可能な信頼できるホスト .Sh 解説 .Nm hosts.lpd ファイルは、あなたのマシンのローカルプリントサービスを許可するホストの ホスト名もしくは IP アドレスのリストを含みます。 ホスト名および IP アドレスは、各々 1 行に 1 つずつ記述します。 .Sh 関連ファイル .Bl -tag -width /etc/hosts.lpdxxxxx -compact .It Pa /etc/hosts.lpd .Nm hosts.lpd ファイルは .Pa /etc にあります。 .Sh 関連項目 .Xr printcap 5 , .Xr lpd 8 . diff --git a/ja_JP.eucJP/man/man5/intro.5 b/ja_JP.eucJP/man/man5/intro.5 index 29e5b712c5..521bca75e0 100644 --- a/ja_JP.eucJP/man/man5/intro.5 +++ b/ja_JP.eucJP/man/man5/intro.5 @@ -1,58 +1,58 @@ .\" 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: intro.5,v 1.2 1997/02/16 16:36:31 mpp Exp % -.\" jpman $Id: intro.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: intro.5,v 1.3 1998/04/29 11:34:46 kuma Stab % .\" .\" WORD: configuration file 構成ファイル .\" .Dd February 16, 1997 .Dt INTRO 5 .Os FreeBSD 2.2 .Sh 名称 .Nm intro .Nd "ファイルフォーマットの手引" .Sh 解説 このセクションにはファイルフォーマットの情報が書かれています。 .Sh 関連項目 .Xr apropos 1 , .Xr intro 1 , .Xr intro 8 .Sh 関連ファイル .Bl -tag -width /etc/shells -compact .It Pa /etc ほとんどのシステム構成ファイルが置かれる場所 .El .Sh 歴史 .Nm intro セクションマニュアルページは .Fx 2.2 から登場しました。 diff --git a/ja_JP.eucJP/man/man5/kernfs.5 b/ja_JP.eucJP/man/man5/kernfs.5 index 3f4026e87e..5411aca7a8 100644 --- a/ja_JP.eucJP/man/man5/kernfs.5 +++ b/ja_JP.eucJP/man/man5/kernfs.5 @@ -1,138 +1,138 @@ .\" Copyright (c) 1996 .\" Mike Pritchard . 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 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: kernfs.5,v 1.2.2.4 1998/07/19 06:52:11 jkh Exp % .\" -.\" jpman $Id: kernfs.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: kernfs.5,v 1.3 1998/07/21 23:04:50 jsakai Stab % .\"WORD: machine independent 機種に依存しない .\"WORD: decimal ASCII ASCII 表記の 10 進数 .\"WORD: mount point マウントポイント .\" .Dd December 14, 1996 .Dt kernfs 5 .Os BSD 4.4 .Sh 名称 .Nm kernfs .Nd カーネルファイルシステム .Sh 書式 .Bd -literal kern /kern kernfs rw 0 0 .Ed .Sh 解説 カーネルファイルシステム .Nm kernfs は、現在実行中のカーネルに関する情報へのアクセス手段を提供するものです。 これは通常 .Pa /kern にマウントされます。 このファイルシステムは読み取り可能な数個の通常ファイルを含んでおり、 これらのファイルの一部には書き込むこともできます。 ファイルの内容は文字列と ASCII 表記の 10 進整数からなり、 機種に依存しない書式になっています。 数値が返されるときは、後ろに改行文字が付け加えられます。 .Pp マウントポイントには以下のファイルが含まれます。 .Bl -tag -width copyright .It Pa bootfile 現在のカーネルが起動したパス。 .It Pa boottime システムが最後に起動した時間 (ASCII 表記の 10 進数)。 .It Pa copyright カーネルの著作権標示。 .It Pa hostname 現在のホスト名。後ろに改行がつきます。 このファイルに書き込むことにより、現在のホスト名を変更することが できます。 ホスト名に後続する改行文字は書き込み時には取り除かれます。 .It Pa hz システムクロックの周波数 (ASCII 表記の 10 進数)。 .It Pa loadavg 過去 1 分間、5 分間および 15 分間のロードアベレージで、カーネル固定小数点 フォーマットで表されます。最後の整数は固定小数のスケーリングファクタ です。全ての数値は ASCII 10 進数で表されます。 .It Pa pagesize マシンのページサイズ (ASCII 10進数)。 .It Pa physmem マシンの物理メモリのページ数 (ASCII 表記の 10 進数)。 .It Pa root システムのルートディレクトリ。chroot した環境では、 .Xr mount_kernfs 8 を、新しい .Pa /kern マウントポイントを生成するために用いることができます。 .Pa /kern/root はカレントプロセスのルートではなく、システム全体のルートを示すことに なる予定です。現在はまだ利用できません。 .It Pa rootdev ルートデバイス。現在はまだ利用できません。 .It Pa rrootdev raw ルートデバイス。現在はまだ利用できません。 .It Pa time システムクロックの秒数およびマイクロ秒数 (ASCII 表記の 10 進数)。 .It Pa version カーネルのバージョン文字列。 .Pa /etc/motd のヘッドラインは .Dq Ic "sed 1q /kern/version" を実行することによって生成することができます。 .El .Pp .Nm によって得られる情報のほとんどは .Xr sysctl 8 からも入手可能です。 .Sh 関連ファイル .Bl -tag -width /kern/XXXXXXX .It Pa /kern .Nm kernfs のための通常のマウントポイント。 .El .Sh 関連項目 .Xr sysctl 3 , .Xr mount_kernfs 8 , .Xr sysctl 8 .Sh 歴史 .Nm ファイルシステムは .Bx 4.4 で最初に登場しました。 .Nm マニュアルページは .Fx 2.2 で最初に登場しました。 .Sh 作者 .Nm マニュアルページは .An Mike Pritchard Aq mpp@FreeBSD.org によって書かれたもので、 .An Jan-Simon Pendry による .Xr mount_kernfs 8 マニュアルページに基づいています。 diff --git a/ja_JP.eucJP/man/man5/keycap.5 b/ja_JP.eucJP/man/man5/keycap.5 index 6c4f63e99a..37c5de613e 100644 --- a/ja_JP.eucJP/man/man5/keycap.5 +++ b/ja_JP.eucJP/man/man5/keycap.5 @@ -1,128 +1,128 @@ .\" .\" Copyright (c) 1992,1993,1994 Hellmuth Michaelis .\" .\" Copyright (c) 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. .\" .\"WORD: keyboard mapping キーボードマッピング .\"WORD: .Sh CAPABILITIES ケーパビリティ .\" .\" @(#)keycap.5, 3.00, Last Edit-Date: [Sun Jan 2 13:45:59 1994] -.\" jpman $Id: keycap.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: keycap.5,v 1.3 1998/06/22 10:45:11 kumano Stab % .\" %Id: keycap.5,v 1.2.2.1 1997/01/02 17:48:10 mpp Exp % .\" .Dd January 3, 1993 .Dt KEYCAP 5 .Sh 名称 .Nm keycap .Nd キーボードマッピングデータベース .Sh 書式 .Nm keycap .Sh 解説 .Nm keycap ファイルはキーボードマッピングを記述するデータベースで、 .Xr kcon 1 が用います。 .Pp .Nm keycap のエントリは `:' で区切られた多数のフィールドからなります。 各マッピングの最初のエントリは、そのマッピングの名称として 認識される名前を、文字 `|' で区切って並べたものです。 最初と最後以外の全ての名前は全部小文字で、空白文字を含まない必要があります。 最後の名前は可読性を高めるために、大文字や空白文字を含めることができます。 .Sh ケーパビリティ .Pp .Bl -column indent indent .Sy 名称 型 解説 .It "de bool キーボードマッピングをコンパイル時に入れたデフォルトにリセットする" .It "D bool キー を完全に使用不可にする" .It "m num ALT キーのキー番号を指定する .It "l num ALTGR キーのキー番号を指定する .It "h num SHIFT キーのキー番号を指定する .It "t num CONTROL キーのキー番号を指定する .It "ca num CAPS LOCK キーのキー番号を指定する .It "sh num SHIFT LOCK キーのキー番号を指定する .It "nl num NUM LOCK キーのキー番号を指定する .It "sc num SCROLL LOCK キーのキー番号を指定する .It "K str シフトなし (通常) のキーに文字列を対応させる .It "S str シフト (SHIFT キーと同時に押す) 時のキーに文字列を対応させる .It "C str CONTROL キーと同時に押したときの文字列を対応づける .It "A str ALTGR キーと同時に押したときの文字列を対応づける .It "tc str 指定箇所以外が同じマップを持つエントリ \- 最後に指定する必要があります。" .El キー番号を記述するパラメータ は 1 から 128 までの番号を取ることが できます。 文字列パラメータは 15 文字までの値を取ることができます。 .Pp .Ss エントリの例 以下のエントリはテスト用のエントリ記述で、 .Nm keycap ファイルの中のごく単純なエントリ記述の1つに、この記述通りのものが存在します。 .Pp .Bd -literal tt\||test\||Test entry which swaps y and z:\e :K22=z:S22=Z:C22=\e032:\e :K46=y:S46=Y:C46=\e031: .Ed .Pp 行の最後に \e を置くことによって、エントリを複数行に続けることができます。 コメントは .Dq # で始まる行に含めることができます。 .Sh 関連ファイル .Bl -tag -width /usr/share/misc/keycap.pcvt -compact .It Pa /usr/share/misc/keycap.pcvt キーボードマッピングの記述を含むファイル .El .Sh 関連項目 .Xr kcon 1 , .Xr keycap 3 .Sh 使用例 .Dq Li l1#60 は、 ALTGR キーのキー番号として、 60 を指定します。 .Dq Li K100=hugo は、キー番号 100 のキーに文字列 'hugo' を対応させます。 .Dq Li K100=^D は、キー番号 100 のキーにコントロール文字 EOT (0x04) を対応させます。 .Dq Li K100=\e000 は、キー番号 100 のキーにコントロール文字 NUL (0x00) を対応させます。 diff --git a/ja_JP.eucJP/man/man5/link.5 b/ja_JP.eucJP/man/man5/link.5 index dc33cd7145..6f80378dc5 100644 --- a/ja_JP.eucJP/man/man5/link.5 +++ b/ja_JP.eucJP/man/man5/link.5 @@ -1,617 +1,617 @@ .\" 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: link.5,v 1.7.2.4 1998/03/07 09:07:03 jkh Exp % -.\" jpman $Id: link.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: link.5,v 1.3 1998/08/09 12:52:25 horikawa Stab % .\" .Dd October 23, 1993 .Dt LINK 5 .Os .Sh 名称 .Nm link .Nd ダイナミックローダとリンクエディタインタフェース .Sh 書式 .Fd #include .Fd #include .Fd #include .Sh 解説 インクルードファイル .Aq Pa link.h では、ダイナミックにリンクされたプログラムやライブラリに含まれる 数種の構造体が宣言されています。 その構造体は、リンクエディタとローダ機構のいくつかの構成要素間の インタフェースを定義します。 バイナリ中でのこれらの構造体のレイアウトは 多くの点で a.out 形式に類似しており、 シンボル定義 (付随する文字列テーブルを含む) や外部エンティティへの参照を 解決するのに必要なリロケーションレコードといった、 よく似た機能を提供します。 それに加え、ダイナミックロードとリンク処理に固有のいくつかのデータ構造も 記録しています。このようなデータ構造としては、 リンクエディット処理を完結するのに必要な他のオブジェクトへの参照や、 異なるプロセス間でコードページの共有を進めるための .Em 位置独立コード (Position Independent Code 略して PIC) を機能させるための 間接テーブルがあります。 ここで述べるデータ構造全体を .Em ランタイムリロケーションセクション (RRS) と呼び、ダイナミックにリンクされるプログラムや共有オブジェクトの 標準テキスト及びデータセグメントに埋め込まれます。 これは、既存の .Xr a.out 5 形式には RRS のための場所が他にないからです。 .Pp あるプログラムを実行可能とする処理が、 システムリソースの使用を最適化しつつ正しく完了するよう、 複数のユーティリティが協調して働きます。 コンパイラは PIC コードを出力し、 それから .Xr ld 1 によって共有ライブラリが作られます。 コンパイラはまた、初期化される各データアイテムのサイズ情報を アセンブラディレクティブ .size を用いて記録します。 PIC コードは、ある間接テーブルを通じてデータ変数にアクセスする点で 従来のコードと異なっています。 この表はグローバルオフセットテーブルと呼ばれ、 慣習によって、予約名 .Em _GLOBAL_OFFSET_TABLE_ によってアクセス可能です。 ここで用いられるメカニズムの詳細は機種依存ですが、通常は そのマシンのレジスタ 1 本がこの用途に予約されます。 このような仕組みの背景にある合理性は、 実際のロードアドレスとは独立したコードを生成することです。 実行時には、アドレス空間において様々な共有オブジェクトがロードされるアドレス に応じて、グローバルオフセットテーブルに含まれる値のみ変更すればよいのです。 .Pp 同様に、大域的に定義された関数の呼び出しは、 コアイメージのデータセグメント中に置かれている プロシージャリンケージテーブル (PLT) を通じて間接的に行われます。 これもまた、実行時にテキストセグメントを修正せずに済ませるためのものです。 .Pp リンクエディタがグローバルオフセットテーブルとプロシージャリンケージテーブルを 配置するのは、 複数の PIC オブジェクトファイルを結合して プロセスのアドレス空間にマップするのに適した 1 つのイメージにする時です。 リンクエディタはまた、実行時のリンクエディタが必要とする全てのシンボルを集め、 それらをイメージのテキストとデータのビット列と共にストアします。 もう 1 つの予約シンボル .Em _DYNAMIC は、実行時のリンク構造が存在することを示すのに用いられます。 _DYNAMIC が 0 にリロケートされる場合は、実行時リンクエディタを起動する 必要はありません。 もし _DYNAMIC が非 0 なら、_DYNAMIC は、必要なリロケーション情報と シンボル情報の位置を引き出すことができるデータ構造を指しています。 これは特に、スタートアップモジュール .Em crt0 で利用されます。 慣習として、_DYNAMIC 構造体は、 それが属するイメージのデータセグメントの最初に置かれます。 .Pp .Sh データ構造 ダイナミックリンクと実行時リロケーションをサポートするデータ構造は、 それらの処理の適用対象イメージのテキスト及びデータセグメントの 両方の中にあります。 テキストセグメントにはシンボル記述や名前といった読み取り専用データが含まれ、 他方データセグメントにはリロケーション処理で更新する必要のあるテーブル類が 含まれます。 .Pp シンボル _DYNAMIC は .Fa _dynamic 構造体を参照します: .Bd -literal -offset indent struct _dynamic { int d_version; struct so_debug *d_debug; union { struct section_dispatch_table *d_sdt; } d_un; struct ld_entry *d_entry; }; .Ed .Bl -tag -width d_version .It Fa d_version このフィールドは異なったバージョンのダイナミックリンク実装用に 提供されています。 .Xr ld 1 及び .Xr ld.so 1 が理解する現在のバージョン番号は、 .Tn SunOS 4.x リリースで用いられている .Em LD_VERSION_SUN (3) と、 .Fx 1.1 以来使用されている .Em LD_VERSION_BSD (8) です。 .It Fa d_un .Em d_version に応じたデータ構造を参照します。 .It Fa so_debug このフィールドは、 共有オブジェクトのシンボルテーブルをアクセスするためのフックを デバッガに提供します。 この共有オブジェクトは、 実行時リンクエディタの処理の結果ロードされたものです。 .El .Pp .Fa section_dispatch_table 構造体がメインとなる .Dq ディスパッチャ テーブルであり、 イメージ内で様々なシンボル情報やリロケーション情報が置かれるセグメントへの オフセットを保持します。 .Bd -literal -offset indent struct section_dispatch_table { struct so_map *sdt_loaded; long sdt_sods; long sdt_filler1; long sdt_got; long sdt_plt; long sdt_rel; long sdt_hash; long sdt_nzlist; long sdt_filler2; long sdt_buckets; long sdt_strings; long sdt_str_sz; long sdt_text_sz; long sdt_plt_sz; }; .Ed .Pp .Bl -tag -width sdt_filler1 .It Fa sdt_loaded ロードされた最初のリンクマップ (後述) へのポインタ。 このフィールドは .Nm ld.so によって設定されます。 .It Fa sdt_sods .Em この オブジェクトが必要とする共有オブジェクトデスクリプタの (リンク) リストの先頭。 .It Fa sdt_filler1 使用しないで下さい (SunOS では ライブラリの検索ルールを指定するのに使用されていました)。 .It Fa sdt_got このイメージ中でのグローバルオフセットテーブルの位置。 .It Fa sdt_plt このイメージ中でのプロシージャリンケージテーブルの位置。 .It Fa sdt_rel 実行時のリロケーションを指定する .Fa relocation_info 構造体 .Po .Xr a.out 5 参照 .Pc の配列の位置。 .It Fa sdt_hash このオブジェクトのシンボルテーブルでシンボル検索を高速化するための ハッシュテーブルの位置。 .It Fa sdt_nzlist シンボルテーブルの位置。 .It Fa sdt_filler2 現在使用されていません。 .It Fa sdt_buckets .Fa sdt_hash 中のバケット数。 .It Fa sdt_strings .Fa sdt_nzlist に対応するシンボル文字列テーブルの位置。 .It Fa sdt_str_sz 文字列テーブルのサイズ。 .It Fa sdt_text_sz このオブジェクトのテキストセグメントのサイズ。 .It Fa sdt_plt_sz プロシージャリンケージテーブルのサイズ。 .El .Pp .Fa sod 構造体は、それを含むオブジェクトのリンクエディット処理を完了するのに 必要な共有オブジェクトを記述します。 そのようなオブジェクトのリスト .Po .Fa sod_next で連結されます .Pc は section_dispatch_table 構造体の .Fa sdt_sods によって指し示されます。 .Bd -literal -offset indent struct sod { long sod_name; u_int sod_library : 1, sod_reserved : 31; short sod_major; short sod_minor; long sod_next; }; .Ed .Pp .Bl -tag -width sod_library .It Fa sod_name このリンクオブジェクトを記述する文字列の、 テキストセグメントにおけるオフセット。 .It Fa sod_library もし設定されていれば、 .Fa sod_name は .Nm ld.so が検索することになるライブラリを指定します。 そのパス名は、あるディレクトリ群 .Po .Xr ldconfig 8 参照 .Pc で .Em lib\&\&.so.n.m. にマッチする共有オブジェクトを検索することで得られます。 もし設定されていなければ、 .Fa sod_name は希望する共有オブジェクトに対するフルパス名を指し示す必要があります。 .It Fa sod_major ロードすべき共有オブジェクトのメジャーバージョン番号を指定します。 .It Fa sod_minor ロードすべき共有オブジェクトの希望するマイナーバージョン番号を指定します。 .El .Pp プロセスのアドレス空間にロードされる共有オブジェクト全てを追跡するために、 実行時リンクエディタは .Em リンクマップ と呼ばれる構造体のリストを管理しています。 これらの構造体は実行時にのみ用いられ、 実行可能ファイルや共有ライブラリのテキストあるいはデータセグメントには ありません。 .Bd -literal -offset indent struct so_map { caddr_t som_addr; char *som_path; struct so_map *som_next; struct sod *som_sod; caddr_t som_sodbase; u_int som_write : 1; struct _dynamic *som_dynamic; caddr_t som_spd; }; .Ed .Bl -tag -width som_dynamic .It Fa som_addr このリンクマップに対応する共有オブジェクトがロードされるアドレス。 .It Fa som_path ロードされるオブジェクトのフルパス名。 .It Fa som_next 次のリンクマップへのポインタ。 .It Fa som_sod この共有オブジェクトのロードをつかさどる .Fa sod 構造体。 .It Fa som_sodbase 将来のバージョンにおいては、実行時リンカに渡されます。 .It Fa som_write このオブジェクトのテキストセグメント (の一部分) が現在書き込み可能である 場合にセットされます。 .It Fa som_dynamic このオブジェクトの .Fa _dynamic 構造体へのポインタ。 .It Fa som_spd 実行時リンクエディタが管理するプライベートデータと連結するためのフック。 .El .Pp サイズ付きシンボル記述。 これは単に .Fa nlist 構造体にフィールド .Pq Fa nz_size を 1 つ追加したものです。 共有オブジェクトのデータセグメントにあるアイテムの サイズ情報を伝達するのに用いられます。 この構造体の配列は共有オブジェクトのテキストセグメントに存在し、 そのアドレスは .Fa section_dispatch_table の .Fa sdt_nzlist フィールドで指定されます。 .Bd -literal -offset indent struct nzlist { struct nlist nlist; u_long nz_size; #define nz_un nlist.n_un #define nz_strx nlist.n_un.n_strx #define nz_name nlist.n_un.n_name #define nz_type nlist.n_type #define nz_value nlist.n_value #define nz_desc nlist.n_desc #define nz_other nlist.n_other }; .Ed .Bl -tag -width nz_size .It Fa nlist .Po .Xr nlist 3 参照 .Pc 。 .It Fa nz_size このシンボルで表現されるデータのサイズ。 .El .Pp 実行時のリンクエディットで行われるシンボル検索を高速化するため、 共有オブジェクトのテキストセグメントにハッシュテーブルが含まれています。 .Fa section_dispatch_table の .Fa sdt_hash フィールドは .Fa rrs_hash 構造体を指し示します: .Bd -literal -offset indent struct rrs_hash { int rh_symbolnum; /* シンボル番号 */ int rh_next; /* 次のハッシュエントリ */ }; .Ed .Pp .Bl -tag -width rh_symbolnum .It Fa rh_symbolnum 共有オブジェクトのシンボルテーブル ( .Fa ld_symbols で与えられます) での当該シンボルのインデックス。 .It Fa rh_next 衝突が起きたとき、このフィールドはこのハッシュテーブルのバケットにおける 次のエントリのオフセットを保持します。 最終バケット要素の場合は 0 となります。 .El .Fa rt_symbol 構造体は、 実行時にアロケートされるコモン(commons)と 共有オブジェクトからコピーされるデータアイテムを 追跡するのに用いられます。 これらのアイテムはリンクリストで管理され、デバッガでの利用のために .Fa so_debug 構造体 (後述) 中の .Fa dd_cc フィールドによって公開されます。 .Bd -literal -offset indent struct rt_symbol { struct nzlist *rt_sp; struct rt_symbol *rt_next; struct rt_symbol *rt_link; caddr_t rt_srcaddr; struct so_map *rt_smp; }; .Ed .Pp .Bl -tag -width rt_scraddr .It Fa rt_sp シンボル記述。 .It Fa rt_next 次の rt_symbol の仮想アドレス。 .It Fa rt_link ハッシュバケットにおける次の要素。 .Nm ld.so の内部で用いられます。 .It Fa rt_srcaddr 共有オブジェクト中での初期化済データのソース位置。 .It Fa rt_smp この実行時シンボルが記述するデータの元のソースとなる共有オブジェクト。 .El .Pp .Fa so_debug 構造体は、 実行時リンクエディットの結果、当該プロセスのアドレス空間にロードされた あらゆる共有オブジェクトの情報を得るために、 デバッガによって利用されます。 実行時リンクエディタはプロセスの初期化処理の一部として実行されるため、 共有オブジェクトからシンボルにアクセスしようとするデバッガは、 crt0 からリンクエディタが呼ばれた後でのみそれが可能となります。 ダイナミックリンクされているバイナリは .Fa so_debug 構造体を持っています。この構造体の場所は .Fa _dynamic 中の .Fa d_debug フィールドで指示されます。 .Bd -literal -offset indent struct so_debug { int dd_version; int dd_in_debugger; int dd_sym_loaded; char *dd_bpt_addr; int dd_bpt_shadow; struct rt_symbol *dd_cc; }; .Ed .Pp .Bl -tag -width dd_in_debugger .It Fa dd_version このインタフェースのバージョン番号。 .It Fa dd_in_debugger 当該プログラムがデバッガの制御下にあることを実行時リンカに知らせるために デバッガによってセットされます。 .It Fa dd_sym_loaded 共有オブジェクトをロードすることで実行時リンカがシンボルを追加した場合、 実行時リンカによってセットされます。 .It Fa dd_bpt_addr デバッガに制御を移すために実行時リンカによってセットされる ブレークポイントアドレス。 このアドレスは、_main 呼び出しの前に、スタートアップモジュール .Em crt0.o によってある適切な場所に決定されます。 .It Fa dd_bpt_shadow アドレス .Fa dd_bpt_addr にあった元の機械命令を保持します。 デバッガは、プログラム実行を再開する前にこの機械命令を元に戻すことに なっています。 .It Fa dd_cc デバッガが必要とする可能性のある、実行時にアロケートしたシンボルの リンクリストへのポインタ。 .El .Pp .Em ld_entry 構造体は .Nm ld.so 中のサービスルーチン一式を定義します。 .\" See .\" .Xr libdl.a .\" for more information. .Bd -literal -offset indent struct ld_entry { void *(*dlopen)(char *, int); int (*dlclose)(void *); void *(*dlsym)(void *, char *); char *(*dlerror)(void); }; .Ed .Fa crt_ldso 構造体は、crt0 中のスタートアップコードと .Nm ld.so との間のインタフェースを定義します。 .Bd -literal -offset indent struct crt_ldso { int crt_ba; int crt_dzfd; int crt_ldfd; struct _dynamic *crt_dp; char **crt_ep; caddr_t crt_bp; char *crt_prog; char *crt_ldso; struct ld_entry *crt_ldentry; }; #define CRT_VERSION_SUN 1 #define CRT_VERSION_BSD_2 2 #define CRT_VERSION_BSD_3 3 #define CRT_VERSION_BSD_4 4 .Ed .Bl -tag -width crt_dzfd .It Fa crt_ba crt0 によって .Nm ld.so がロードされた仮想アドレス。 .It Fa crt_dzfd SunOS では、このフィールドは .Dq Pa /dev/zero へのオープンされたファイル記述子を保持し、 0 クリアされたデマンドページを得ます。 .Tn FreeBSD ではこのフィールドは -1 を保持します。 .It Fa crt_ldfd .Nm ld.so をロードするために crt0 が用いる、オープンされたファイル記述子 を保持します。 .It Fa crt_dp main の .Fa _dynamic 構造体へのポインタ。 .It Fa crt_ep 環境文字列へのポインタ。 .It Fa crt_bp メインプログラムがデバッガで実行される場合、 実行時リンカがブレークポイントを置くアドレス。 .Fa so_debug を参照してください。 .It Fa crt_prog crt0 で決定されるメインプログラムの名前 (CRT_VERSION_BSD3 のみ)。 .It Fa crt_ldso crt0 でマップされる実行時リンカのパス (CRT_VERSION_BSD4 のみ)。 .El .Pp .Fa hints_header 構造体及び .Fa hints_bucket 構造体は、通常 .Dq Pa /var/run/ld.so.hints に置かれるライブラリヒントのレイアウトを定義します。 ライブラリヒントは、ファイルシステム中で共有オブジェクトイメージの在処を すばやく見つけるために .Nm ld.so によって利用されます。 ヒントファイルの構成は .Dq a.out とそれほど異なりません。つまりヒントファイルは、 固定長ハッシュバケットのオフセットとサイズを決定するためのヘッダと、 共通の文字列プールを持っています。 .Bd -literal -offset indent struct hints_header { long hh_magic; #define HH_MAGIC 011421044151 long hh_version; #define LD_HINTS_VERSION_1 1 long hh_hashtab; long hh_nbucket; long hh_strtab; long hh_strtab_sz; long hh_ehints; }; .Ed .Bl -tag -width hh_strtab_sz .It Fa hh_magic ヒントファイルのマジックナンバ。 .It Fa hh_version インタフェースのバージョン番号。 .It Fa hh_hashtab ハッシュテーブルのオフセット。 .It Fa hh_strtab 文字列テーブルのオフセット。 .It Fa hh_strtab_sz 文字列テーブルのサイズ。 .It Fa hh_ehints ヒントファイルで利用可能な最大オフセット。 .El .Pp .Bd -literal -offset indent /* * ヒントファイルのハッシュテーブル要素 */ struct hints_bucket { int hi_namex; int hi_pathx; int hi_dewey[MAXDEWEY]; int hi_ndewey; #define hi_major hi_dewey[0] #define hi_minor hi_dewey[1] int hi_next; }; .Ed .Bl -tag -width hi_ndewey .It Fa hi_namex ライブラリを指定する文字列のインデックス。 .It Fa hi_pathx ライブラリのフルパス名を表す文字列のインデックス。 .It Fa hi_dewey 共通ライブラリのバージョン番号。 .It Fa hi_ndewey .Fa hi_dewey 中の有効エントリ数。 .It Fa hi_next ハッシュ衝突の際の次のバケット。 .El .Sh 警告 現在のところ、共有ライブラリ生成をサポートしているのは (GNU) C コンパイラ のみです。他のプログラミング言語では利用できません。 diff --git a/ja_JP.eucJP/man/man5/login.access.5 b/ja_JP.eucJP/man/man5/login.access.5 index 7b436ce1bf..3b44941375 100644 --- a/ja_JP.eucJP/man/man5/login.access.5 +++ b/ja_JP.eucJP/man/man5/login.access.5 @@ -1,56 +1,56 @@ .\" this is comment -.\" jpman $Id: login.access.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: login.access.5,v 1.3 1998/04/29 11:37:56 kuma Stab % .\" .\" WORD: access granted アクセス許可(許可された状態) .\" .Dd April 30, 1994 .Dt LOGIN.ACCESS 5 .Os FreeBSD 1.2 .Sh 名称 .Nm login.access .Nd ログインアクセス制御表 .Sh 解説 .Nm ファイルは、ログインを許可または拒否する (ユーザ, ホスト) の組や (ユーザ, tty) の組を指定します。 .Pp 誰かがログインする際に、 .Nm から (ユーザ, ホスト) の組にマッチする最初のエントリを探します。 非ネットワークログインの場合には、 (ユーザ, tty) の組にマッチする最初のエントリを探します。 表のエントリ中のパーミッションフィールドは、 ログインを許可するか拒否するかを決定します。 .Pp ログインアクセス制御表の各行は、":" 文字で区切られる 次のような 3 フィールドから成ります: パーミッション : ユーザ : 起点 .Pp 第 1 フィールドは、"+" (アクセス許可) もしくは "-" (アクセス不許可) の 文字です。 第 2 フィールドは、ログイン名・グループ名・ALL (常にマッチ) を 1 つ以上含むリストです。 第 3 フィールドは、tty 名 (非ネットワークログイン用)・ホスト名・ ドメイン名 ("." から開始)・ホストアドレス・インターネットのネットワーク番号 ("." で終了)・ALL (常にマッチ)・LOCAL ("." を含まない文字列にマッチ) を 1 つ以上含むリストです。 NIS 使用時には、ホストおよびユーザの指定に @netgroupname を使用できます。 .Pp EXCEPT 演算子を使用すると、非常に小さいルールを記述できます。 .Pp 名前がログインしたユーザ名にマッチしない場合のみ、 グループファイルが検索されます。 ユーザが明示的にリストされている グループのみがマッチします。 このプログラムはユーザのプライマリグループ ID 値を見ません。 .Sh 関連ファイル .Bl -tag -width /etc/login.access -compact .It Pa /etc/login.access .Nm ファイルは .Pa /etc にあります。 .El .Sh 関連項目 .Xr login 1 .Sh 作者 Guido van Rooij diff --git a/ja_JP.eucJP/man/man5/login.conf.5 b/ja_JP.eucJP/man/man5/login.conf.5 index 0533a67a82..6f654f9e3e 100644 --- a/ja_JP.eucJP/man/man5/login.conf.5 +++ b/ja_JP.eucJP/man/man5/login.conf.5 @@ -1,354 +1,354 @@ .\" Copyright (c) 1996 David Nugent .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, is permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice immediately at the beginning of the file, without modification, .\" 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. This work was done expressly for inclusion into FreeBSD. Other use .\" is permitted provided this notation is included. .\" 4. Absolutely no warranty of function or purpose is made by the author .\" David Nugent. .\" 5. Modifications may be freely made to this file providing the above .\" conditions are met. .\" .\" %Id: login.conf.5,v 1.8.2.7 1998/02/21 23:36:10 fenner Exp % -.\" jpman $Id: login.conf.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: login.conf.5,v 1.3 1998/07/21 23:10:00 jsakai Stab % .\" .Dd November 22, 1996 .Dt LOGIN.CONF 5 .Os FreeBSD .Sh 名称 .Nm login.conf .Nd ログインクラス ケーパビリティ データベース .Sh 書式 .Pa /etc/login.conf , .Pa ~/.login_conf .Sh 解説 login.conf には、ログインクラスについてのさまざまな属性やケーパビリティが 含まれています。 ログインクラス (ユーザアカウントデータベースである .Pa /etc/master.passwd のそれぞれの行について自由に設定できる注釈) は、セッションの アカウンティングやリソース制限、ユーザ環境設定などを決定します。 ログインクラスはシステム内のさまざまなプログラムから利用され、 ユーザのログイン環境を設定するほか、 ポリシー、アカウンティング及び管理上の制限を設定します。 ログインクラスはまた、 システムや利用可能な種々の認証機構に対するユーザ認証手段を提供します。 .Pp システムのユーザクラスケーパビリティデータベースである .Pa /etc/login.conf の中の "default" という特別なレコードは、 .Pa /etc/master.passwd 内に有効なログインクラスを持たない root 以外のすべてのユーザに よって自動的に使われます。有効なログインクラスを持たない uid が 0 の ユーザは、"root" レコードが存在する場合はそのレコードが、 存在しない場合は "default" レコードがログインクラスとして使われます。 .Pp FreeBSD においては、個々のユーザは .Pa .login_conf というファイルをホームディレクトリに作成することができます。 このファイルは (/etc/login.conf と) 同じフォーマットで、 レコード id が "me" である 1 エントリのみで構成されます。 もし .login.conf が存在するならば、このファイルは .Xr login 1 によって使用され、システムのログインケーパビリティデータベースによって 指定されたユーザ環境設定を上書き設定します。 その際、ログインケーパビリティのサブセット、 典型的には承認やリソース制限そしてアカウンティングを含まないもの のみが上書きされます。 .Pp クラスケーパビリティデータベースのレコードは、コロンで区切られた いくつかのフィールドから構成されています。 各レコードの最初のフィールドは、レコードを特定するための 1 つまたは複数の名前で、それらは '|' 文字で区切られます。 その最初の名前が、最も一般化された短縮名称です。 最後の名前は、ログインケーパビリティエントリをより分かりやすく説明した 長い名前であるべきで、他の名前はその同義語です。 すべての名前は小文字かつ空白を含まないようにすべきですが、 最後の名前は可読性を考慮して、大文字やブランクを含んでいてもよいでしょう。 .Pp ケーパビリティデータベースのフォーマットについての詳細な説明は .Xr getcap 3 を参照してください。 .Sh ケーパビリティ データベース内のそれぞれの行に含まれるフィールドは、 .Xr getcap 3 の慣習に従い、ブール型、文字列型 .Ql \&= 数値型 .Ql \&# があります。 しかしながら数値データのところは、数値型が拒否され文字列型が 受け入れられることがあったり、両方の書式が両方の書式が受け入れられることも あります。 値は次のカテゴリに分類されます。 .Bl -tag -width "program" .It file データファイルへのパス名 .It program 実行可能ファイルへのパス名 .It list コンマや空白で区切られた値のリスト (または値の組) .It path 普通の csh の慣習に従った、空白やコンマで区切られたパス名のリスト (先頭のユーザ名を伴う/伴わないチルダはホームディレクトリに展開される等) .It number 10進数(デフォルト)、16進数(0xで始まる)、または 8進数(0で始まる)の 数値型の値。数値型の場合、設定できる値は 1 つだけです。 数値型は文字列型のフォーマットでも指定できる場合があります (ケーパビリティタグ '#' の代わりに '=' で値が区切られているなど)。 どの方法が使われた場合でも、データベース中のすべての行は修正したい行の値を 正確に上書きするために、同じ方法を用いなければなりません。 .It size サイズを表す文字。単位のデフォルトの解釈はバイトで、サフィックスに よって別の単位を指定できます。 .Bl -tag -offset indent -compact -width xxxx .It b 512バイトブロックの明示的な指定 .It k キロバイトの指定 (1024バイト) .It m 1 メガバイトの乗数の指定 (1048576 バイト) .It g ギガバイト単位の指定。そして .It t テラバイトの記述。 .El サイズの値は数値であり、サフィックスの大文字小文字は重要ではありません。 連続した値は足し込まれます。 .It time 時間の期間。デフォルトの単位は秒。 プレフィックスによって別の単位を指定できます。 .Bl -tag -offset indent -compact -width xxxx .It y 1 年を 365 日で数えた年数の指定 .It w 週の数の指定 .It d 日数 .It h 時間数 .It m 分数 .It s 秒数 .El 連続した値は足し込まれます。 たとえば 2 時間 40 分は 9600s、160m または 2h40m と 表現することができます。 .El .Pp 特別な .Em tc=value 表記を使用することにより、通常の約束事であるケーパビリティエントリの 補間が可能です。 .Pp .Sh リソース制限 .Bl -column coredumpsize indent indent .Sy Name Type Notes Description .It cputime time CPU 使用制限 .It filesize size ファイルサイズの最大値制限 .It datasize size データサイズの最大値制限 .It stacksize size スタックサイズの最大値制限 .It coredumpsize size コアダンプサイズの最大値制限 .It memoryuse size コアメモリ使用量の最大値制限 .It memorylocked size コアメモリロック可能量の最大値制限 .It maxproc number プロセス数の最大値制限 .It openfiles number プロセスごとにオープンできるファイル数の最大値制限 .El .Pp これらのリソース制限エントリは、実際には最大値と現在の 制限値の両方を指定します ( .Xr getrlimit 2 を参照してください)。 普通は現在の制限値 (ソフトリミット) が使われますが、 ユーザは現在の制限値を最大制限値 (ハードリミット) まで増やすことが 許されています。 最大制限値と現在の制限値はケーパビリティ名に各々 -max 及び -cur を 追加することによって指定できます。 .Pp .Sh 環境 .Bl -column ignorenologin indent xbinxxusrxbin .Sy Name Type Notes Description .It charset string $MM_CHARSET 環境変数の明示的な設定値 .It hushlogin bool false ~/.hushlogin ファイルがある場合と同じ .It ignorenologin bool false nologin によってログインを禁止されません .It lang string $LANG 環境変数を指定した値に設定します .It manpath path マニュアルページのデフォルト検索パス .It nologin file このファイルが存在する場合、ファイルの内容が画面に表示され、そのログインセッションは終了されます .It path path /bin /usr/bin デフォルトコマンド検索パス .It priority number 優先度 (nice) レベルの初期値 .It requirehome bool false ログインのために有効なホームディレクトリが必要 .It setenv list コンマで区切られた環境変数とその設定値のリスト .It shell prog パスワードファイルで指定されているシェルより優先して実行されるセッションシェル。SHELL 環境変数の値は、パスワードファイルで指定されているものになります。 .It term string su 他の手段によって決定できない場合のデフォルトの端末タイプ .It timezone string $TZ 環境変数のデフォルト値 .It umask number 022 umask の初期値。続く数字が 8進数と解釈されるように、常に 0 から始めます .It welcome file /etc/motd ウェルカムメッセージが入っているファイル .El .Pp .Sh 認証 .Bl -column minpasswordlen indent indent .Sy Name Type Notes Description .It minpasswordlen number 6 ローカルパスワード文字列長の最小値 .\" .It approve program Program to approve login. .It auth list passwd 許可される認証形式。 最初の値がデフォルトの形式になります。 .It auth- list 'type' で指定された認証タイプで許可される認証形式。 .It copyright file 追加のコピーライト情報を含んだファイル .\".It widepasswords bool false Use the wide password format. The wide password .\" format allows up to 128 significant characters in the password. .It host.allow list クラス内のユーザがアクセス可能なリモートホストワイルドカードのリスト .It host.deny list クラス内のユーザがアクセス不可なリモートホストワイルドカードのリスト .It times.allow list ログインが許されている時間帯のリスト .It times.deny list ログインが許されない時間帯のリスト .It ttys.allow list クラス内のユーザがアクセスに使用できる端末と端末グループのリスト .It ttys.deny list クラス内のユーザがアクセスに使用不可な端末と端末グループのリスト .El .Pp これらのフィールドは、ログイン認証システムの中で .Xr passwd 1 や、その他のプログラムから使用される予定です。 .Pp 環境変数を設定するケーパビリティは、その中の文字 .Ql \&~ と .Ql \&$ の両方がスキャンされ、これらはそれぞれ ユーザのホームディレクトリ及びユーザ名に置換されます。 環境変数中にこれらの文字をそのまま含める場合には、 その前にバックスラッシュ '\\' をつけてエスケープします。 .Pp .Em host.allow と .Em host.deny エントリはコンマで区切られたリストで、システムへのリモートアクセスの チェックに使われます。 これらはホスト名か IP アドレスまたはその両方を含むリストからなり、 それらに対してリモートログインのチェックが行われます。 このリストの各項目は、ワイルドカード一致用にシェルプログラムが使用しているのと 同じ書式のワイルドカードを含むことができます (実装の詳細は .Xr fnmatch 3 を参照してください)。 ホストのチェックは、リモートシステムのインターネットアドレス と (もし有効なら) ホスト名の両方をつきあわせて行われます。 両方のリストが空かもしくは指定されていない場合、あらゆるリモートホスト からのログインは許可されます。 host.allow が 1 つかそれ以上のホストを含む場合、リスト中の 各項目のどれかにマッチしたリモートシステムのみがログインを許されます。 host.deny が 1 つかそれ以上のホストを含む場合、そのリストのどれかに マッチしたホストからのログインが禁止されます。 .Pp .Em times.allow と .Em times.deny エントリはコンマで区切られた期間のリストであり、この期間はクラス内の ユーザがログインを許されます。 これらは 1 つ以上の日のコード指定と、これに続けて 24 時間表記の開始時刻と 終了時刻をハイフンまたはダッシュで区切ったものとして表現されます。 たとえば MoThSa0200-1300 は、月、木、土の 午前 2 時から午後 1 時と解釈されます。 これらの時間指定リストの両方が空だった場合、クラス内のユーザはいつでもアクセス 可能になります。 .Em times.allow が指定されている場合、ログインは指定された期間のみ許可されます。 もし .Em times.deny が指定されている場合、 .Em times.allow の中で期間が指定されているかどうかに関わらず、指定された期間は ログインできなくなります。 .Pp .Xr login 1 が強制することは、これらのエントリにより許可された期間内に実際の ログインが行なわれることのみである点に注意して下さい。 セッションの生存期間に関して更なる規制をかけるには、別のデーモンを用意し、 許可されている期間から許可されていない期間への 遷移を監視する必要があります。 .Pp .Em ttys.allow と .Em ttys.deny エントリは、クラス内のユーザがシステムにアクセスするために使う コンマで区切られた(/dev/ プレフィックスを除く)端末デバイスと、 端末グループ (ttygroup) のリストです (ttygroup の詳細は .Xr getttyent 3 と .Xr ttys 5 を参照して下さい)。 どちらのエントリも存在しない場合、ユーザが使用するログインデバイスの選択には 制限はありません。 .Em ttys.allow のみ指定されている場合、ユーザの使えるデバイスは指定されたグループ またはデバイスリストのみに制限されます。 .Em ttys.deny のみ指定されている場合、ユーザは指定されたデバイスやデバイス グループを使用できません。 両方が与えられていてかつどちらも空でない場合、ユーザは ttys.allow で指定されていて、ttys.deny では指定されていないデバイス群のみ 使用できます。 .Sh アカウント制限 .Bl -column passwordperiod indent indent .Sy Name Type Notes Description .It accounted bool false このクラス内の全ユーザの セッション時間アカウウンティングを有効化 .It autodelete time アカウント失効後自動で削除されるまでの時間 .It bootfull bool false セッション終了時の「ttygroup が一杯の場合にのみブート」戦略を 有効にする .It daytime time 1 日あたりのログイン最大時間 .It expireperiod time 期限切れまでの割り当て時間 .It graceexpire time 失効したアカウントの猶予日数 .It gracetime time 追加された、猶予ログイン許可時間 .It host.accounted list ログインセッションがアカウントされる リモートホストワイルドカードのリスト .It host.exempt list ログインセッションのアカウンティング を免除されたリモートホストワイルドカードのリスト .It idletime time ログアウトまでの最大アイドル時間 .It monthtime time 月毎の最大ログイン時間 .It passwordtime time パスワードが無効になるまでの時間 .It refreshtime time アカウントのリフレッシュ許可時間 .It refreshperiod str リフレッシュが行なわれる頻度 .It sessiontime time セッション毎の最大ログイン時間 .It sessionlimit number すべてのグループに対する tty 上の 同時最大ログイン数 .It ttys.accounted list ログインアカウントが有効な tty と ttygroup のリスト .It ttys.exempt list ログインアカウントが無効な tty と ttygroup のリスト .It warnexpire time 失効しそうなアカウントに対する事前の注意を 行なう時間 .It warnpassword time 失効しそうなパスワードに対する事前の 注意を行なう時間 .It warntime time 時間切れになりそうな場合に対する事前の注意を 行なう時間 .It weektime time 1 週間毎の最大ログイン時間 .El .Pp これらのフィールドは、ユーザのログインアクセスを規制、コントロール、記録する タイムアカウンティングシステムによって使われます。 .Pp .Em ttys.accounted と .Em ttys.exempt フィールドは、先に述べた .Em ttys.allow と .Em ttys.deny と同じような方法で状態を操作します。 .Em host.accounted と .Em host.exempt のリストも同様です。 .Sh 関連項目 .Xr login 1 , .Xr getcap 3 , .Xr getttyent 3 , .Xr login_cap 3 , .Xr login_class 3 , .Xr passwd 5 , .Xr ttys 5 diff --git a/ja_JP.eucJP/man/man5/magic.5 b/ja_JP.eucJP/man/man5/magic.5 index bcdea4a201..ab5572edef 100644 --- a/ja_JP.eucJP/man/man5/magic.5 +++ b/ja_JP.eucJP/man/man5/magic.5 @@ -1,230 +1,230 @@ .\" .\" @(#)%Id: magic.5,v 1.4.2.3 1998/07/16 23:52:12 jkh Exp % .\" .\" install as magic.4 on USG, magic.5 on V7 or Berkeley systems. .\" -.\" jpman $Id: magic.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: magic.5,v 1.3 1998/07/21 05:29:49 jsakai Stab % .Dd September 3, 1994 .Dt MAGIC 5 .Os "Public Domain" .Sh 名称 .Nm magic .Nd file コマンドのマジック番号ファイル .Sh 解説 このマニュアルページでは .Xr file 1 コマンド バージョン 3.22 で使用されるマジックファイルのフォーマットに ついて説明します。 .Nm file コマンドは、他のテストと共に、ファイルがある .Em "マジック番号" で始まっているかどうかをテストして、ファイルのタイプを識別します。 ファイル .Pa /usr/share/misc/magic では、どのマジック番号をテストするか、 あるマジック番号が見つかったときにどのようなメッセージを出力するか、 また、そのファイルから抽出するべき追加情報について指定しています。 .Pp このファイルの各行ではテストすべき項目について指定しています。 テストは、ファイル中のある特定のオフセットで始まるデータを 1 バイト、2 バイトもしくは 4 バイトの数値あるいは文字列と 比較して行います。 もしテストが成功するとメッセージが出力されます。 各行は以下のフィールドから構成されます。 .Bl -tag -width indent .It offset テストするファイルのデータのオフセットをバイト数で指定する数字です。 .It type テストするデータの型です。指定できる値は .Bl -tag -width indent .It byte 1 バイトの値。 .It short (ほとんどのシステムにおいて) 2 バイトの値。 そのマシンの固有のバイト順で指定します。 .It long (ほとんどのシステムにおいて) 4 バイトの値。 そのマシンの固有のバイト順で指定します。 .It string バイトの文字列。 .It date UNIX 日時として解釈される 4 バイトの値。 .It beshort (ほとんどのシステムにおいて) 2 バイトの値。 ビッグエンディアンのバイト順です。 .IP belong (ほとんどのシステムにおいて) 4 バイトの値。 ビッグエンディアンのバイト順です。 .IP bedate UNIX 日時として解釈される (ほとんどのシステムにおいて) 4 バイトの値。 ビッグエンディアンのバイト順です。 .IP leshort (ほとんどのシステムにおいて) 2 バイトの値。 リトルエンディアンのバイト順です。 .IP lelong (ほとんどのシステムにおいて) 4 バイトの値。 リトルエンディアンのバイト順です。 .IP ledate UNIX 日時として解釈される (ほとんどのシステムにおいて) 4 バイトの値。 リトルエンディアンのバイト順です。 .El .El .Pp 数字の型にはオプションとして .Em & と数値を続けることができ、 これにより比較を行う前に AND をとる数値を指定します。 型の前に .Em u を付加すると比較は符号なしで行なわれます。 .Bl -tag -width indent .It test ファイル中の値と比較される値。 型が数字の場合、この値は C 言語の形式で指定されます。 これが文字列の場合、 通常のエスケープ記法 (たとえば改行では\en) が可能な C 言語文字列として 指定されます。 .It "" 数値の前には実行される操作を示す文字を付加することができます。 その文字には ファイルの値が指定された値と等価であることを指定する .Em = 、ファイルの値が指定された値より小さいことを指定する .Em < 、ファイルの値が指定された値より大きいことを指定する .Em > 、指定された値の中でセットされているすべてのビットが ファイルでの値ですべてセットされていることを指定する .Em & 、指定された値の中でセットされているどれかのビットが ファイルでの値でオフであることを指定する .Em ^ 、何らかの値がマッチすることを指定する .Em x があります。 これらの文字がない場合は .Em = が指定されているものとみなされます。 .It "" 数値は C 言語の形式で指定されます。例えば .Em 13 は 10 進数、 .Em 013 は 8 進数、 .Em 0x13 は 16 進数となります。 .It "" 文字列値については、 ファイル中のバイト文字列は指定されたバイト文字列に マッチしなければなりません。 オペレータ .Em = と .Em < と .Em > ( .Em & を除く) が文字列に適用できます。 マッチングに使用される長さは マジックファイルでの文字列の引数の長さとなります。 これは .Em >\e0 とすることにより、 その行はどの文字列にもマッチすることが可能であり、 おそらくその文字列が出力されることを意味します (すべての文字列はヌル文字列より長いため)。 .It message 比較が成立したときに出力されるメッセージです。 文字列に .Xr printf 3 指定形式が含まれている場合は、ファイルから得た値 (指定されたマスクを 適用したもの) が、そのメッセージをフォーマット文字列として用いて出力さ れます。 .El .Pp いくつかのファイルフォーマットは、ファイルタイプと共に出力される追加情報 を含んでいます。文字 .Em > で始まる行は追加テストと出力されるメッセージを指定します。 その行での .Em > の数はテストのレベルを指定します。行頭に .Em > がない行はレベル 0 とみなされます。 レベル .Em n+1 の各行はマジックファイル中でその行より前にあるもっとも近いレベル .Em n の行の制御下にあります。レベル .Em n での行のテストが成功した場合、それに続く行で指定されたすべてのレベル .Em n+1 のテストが実施され、 それらのテストが成功するとメッセージが出力されます。 次のレベル .Em n の行でこれが終了します。 最後の .Em > に続く最初の文字が .Em ( であれば、その括弧の後の文字列は間接オフセットとして解釈されます。 これは括弧の後の数字がそのファイル中のオフセットとして使用されることを 意味します。そのオフセットでの値が読み込まれ、再度ファイルのオフセット として使用されます。間接オフセットは .Em (x[.[bsl]][+-][y]) の形式をとります。値 .Em x はファイル中でのオフセットとして使われます。 型指定子 .Em [bsl] によりそれぞれバイト、short もしくは long として読み込まれます。 その数字に値 .Em y が加算され、その結果はファイルの中でのオフセットとして使用されます。型 指定子がない場合は long がデフォルトの型となります。 .Pp オフセットは、その前にあるフィールドの長さに依存するため、 正確な値が分からない場合があります。 そのような場合は最後の上位レベルのフィールドの最後からの 相対的なオフセットを指定することができます。 (もちろんこれは下位レベルのテスト、すなわち .Em > で始まるテストでのみ可能です。) この場合の相対オフセットは .Em & をオフセットのプレフィックスとして使用して指定します。 .Sh バグ フォーマット .Em long , .Em belong , .Em lelong , .Em short , .Em beshort , .Em leshort , .Em date , .Em bedate , .Em ledate はシステムに依存します。 テストされるファイルは通常それらの長さが不変であるシステムのものであり、 これらはおそらくバイト数 (2B とか 4B とか) として指定すべきででょう。 .Pp 間接オフセットで使用されるエンディアンを指定したデータは (現在は) サポートされていません。 .Sh 関連項目 .Xr file 1 .\" .\" From: guy@sun.uucp (Guy Harris) .\" Newsgroups: net.bugs.usg .\" Subject: /etc/magic's format isn't well documented .\" Message-ID: <2752@sun.uucp> .\" Date: 3 Sep 85 08:19:07 GMT .\" Organization: Sun Microsystems, Inc. .\" Lines: 136 .\" .\" Here's a manual page for the format accepted by the "file" made by adding .\" the changes I posted to the S5R2 version. .\" .\" Modified for Ian Darwin's version of the file command. diff --git a/ja_JP.eucJP/man/man5/map3270.5 b/ja_JP.eucJP/man/man5/map3270.5 index de99a3655f..ca741f224d 100644 --- a/ja_JP.eucJP/man/man5/map3270.5 +++ b/ja_JP.eucJP/man/man5/map3270.5 @@ -1,338 +1,338 @@ .\" 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. .\" .\" @(#)map3270.5 8.4 (Berkeley) 6/1/94 -.\" jpman $Id: map3270.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: map3270.5,v 1.3 1998/06/13 12:33:46 horikawa Stab % .\" .\" WORD: terminal 端末 .\" WORD: caret キャレット (`^' のこと) .\" WORD: column tab カラムタブ .TH MAP3270 5 "June 1, 1994" .UC 6 .SH 名称 map3270 \- ASCII のキー入力を IBM 3270 キーにマッピングするためのデータベース .SH 書式 .B map3270 .SH 解説 IBM タイプの 3270 端末を \s-1UNIX\s0 でエミュレーションする場合 (\fItn3270\fR(1) 参照)、 ユーザが (ASCII) キーボードを押すシーケンスと 3270 で使用可能なキーの間でマッピングを行わなければなりません。 例えば、3270には .B EEOF とラベルされたキーがあり、これはカーソル位置から終わりまでの 現在のフィールドの内容を消去するものです。 この機能を実現するためには、 .B EEOF 機能を起動するためにタイプするキーについて、 端末のユーザと 3270 をエミュレートしているプログラムが 合意しておく必要があります。 .PP これらのシーケンスには以下の項目が要求されます。 .nf .ta 4n 9n .sp 1) シーケンスの最初の文字が標準の ASCII の印字可能文字でないこと。 .sp 2) どのシーケンスも他のシーケンスの最初の部分で\fIない\fRこと。 (ただしシーケンスは最初の部分を\fI共有\fRできます。) .sp .fi .SH フォーマット 本ファイルはいろいろなキーボードのエントリから成ります。 エントリの最初の部分はそのエントリを使用するキーボード名を列挙します。 これらの名称はたいていは .I /etc/termcap ( .IR termcap (5) 参照) にあるものと同じものです。 しかし、termcap の様々なエントリの端末すべてが、同じ .I map3270 のエントリを使用することがあることに注意してください。 例えば、925 と 925vb (ビジュアルベルを有する 925) はおそらく両方とも同じ .I map3270 のエントリを使用するでしょう。 さらに、端末のタイプがウィンドウマネージャを定義していることがあり、 その場合はキーボード名を (環境変数 .B KEYBD によって) エントリ名として指定する必要があります。 キーボード名の後には縦棒 (`|') で区切って、 左中括弧 (`{')、定義、そして右中括弧 (`}') が続きます。 .PP 各定義は 3270 の機能 (以下に定義するように拡張されたもの) を示す 予約語 (下のリストを参照)、等号 (`=')、この機能を生成するための 様々な方法、セミコロン (`;') の順で続きます。 各方法は .I 印字可能な ASCII 文字の文字列のシーケンスをシングルクォート (`\(aa') で括ったものであり、 様々な (別の) 方法は縦棒 (`|') で区切られています。 .PP シングルクォートではいくつかの文字は特別な扱いを受けます。 キャレット (`^') は次の文字が何であろうが ``制御'' 文字 であることを指定します。 つまり `^a' は control-a を表し、 すなわち 16 進数の 1 となります (`^A' は同じコードを生成することに注意)。 .B rubout (DEL) を生成するには `^?' を入力します。 ファイルの中で制御文字を表現するにはコントロールシーケンスを表示する ためにキャレットを使う必要があります。 ただ単に control-A をタイプするだけではうまくいきません。 注釈: control-^ シーケンス (16 進数で 1E) は `^^' (`^\e^' ではありません) として表現されます。 .PP キャレットのほかに、バックスラッシュ (`\e') に文字を続けることもできます。 これはほとんどの文字では効果はないので、 通常はこうすることは推奨されていません。 シングルクォート (`\(aa') の場合、バックスラッシュをつけると シングルクォートによって文字列は終了しません。 キャレット (`^') の場合、バックスラッシュによって キャレットは特殊な意味を持たなくなります。 文字列中にバックスラッシュを含めるには、 ファイル中に 2 つバックスラッシュ (`\e\e') を置く必要があります。 .PP これらの他に、以下の文字が特殊な意味を持ちます。 .sp .nf .in +0.5i `\eE' はエスケープ文字の意です。 `\en' は改行の意です。 `\et' はタブの意です。 `\er' は復改の意です。 .in -0.5i .fi .sp .sp 各文字は文字列中でシングルクォートで囲まれている必要はありません。 `\eE\eE\eE' は 3 つのエスケープ文字を示します。 .PP コメントは行の中でどこにでも置くことができますが、 ハッシュマーク (`#') で始まり行末で終了します。 しかし、コメントはクォートで囲まれた文字列の中で開始することはできません。 クォートで囲まれた文字列の中でのハッシュマークは特別の意味を持たなくなります。 .PP .SH サポートされている 3270 のキー 以下はこのファイルにおいてサポートされている 3270 のキーの名称のリストです。 これらのキーには、 実際には 3270 に存在しないものがあることに注意してください。 特にこのファイルの開発者は Yale University Computer Center で IBM の Series/1 のフロントエンドとして動作していた 3270 エミュレータ を使用した作業にかなり依存しています。 以下のリストは Yale のコードの開発者が彼らの製品に適用していた 機能に非常に密着したものです。 .sp .B 以下のリストで .B スター ("*") .B 印がつけられた機能は .IR tn3270 (1) .B ではサポートされていません。 サポートされていない機能がある場合、 .IR tn3270(1) はユーザの端末にベル (もしくはビジュアルベル) シーケンスを送信します。 .sp .nf 3270 キー名称 機能説明 (*)LPRT ローカルプリント DP 文字複写 FM フィールドマーク文字 CURSEL カーソル選択 CENTSIGN EBCDIC のセント (¢) 記号 RESHOW スクリーンの再描画 EINP 入力消去 EEOF フィールドの末尾まで消去 DELETE 文字削除 INSRT 挿入モードのトグル TAB フィールドタブ BTAB フィールド逆タブ COLTAB カラムタブ COLBAK カラム逆タブ INDENT 1 タブ分インデント UNDENT 1 タブ分逆インデント NL 改行 HOME カーソルをホーム位置へ UP カーソルを上へ DOWN カーソルを下へ RIGHT カーソルを右へ LEFT カーソルを左へ SETTAB カラムタブをセット DELTAB カラムタブを削除 SETMRG 左マージンをセット SETHOM ホーム位置をセット CLRTAB すべてのカラムタブストップを消去 (*)APLON apl オン (*)APLOFF apl オフ (*)APLEND 入力を ASCII として扱う (*)PCON xon/xoff オン (*)PCOFF xon/xoff オフ DISC 接続断 (サスペンド) (*)INIT 新端末タイプ (*)ALTK DVRAK キーボード FLINP 入力消去 ERASE 最後の文字を消去 WERASE 最後の単語を消去 FERASE フィールド消去 SYNCH ユーザと同期中 RESET リセットキー - キーロック解除 MASTER_RESET リセットし、ロック解除し、再表示する (*)XOFF 出力保留 (*)XON 出力促進 ESCAPE telnet コマンドモードに入る WORDTAB 次の語へタブ移動 WORDBACKTAB 現在/最後の語の最初にタブ移動 WORDEND 現在/次の語の最後にタブ移動 FIELDEND 現在/次の保護されていない (書き込み可能) フィールドの最後の空白でない位置へタブ移動 PA1 プログラムアテンション 1 PA2 プログラムアテンション 2 PA3 プログラムアテンション 3 CLEAR 3270 画面のローカルクリア TREQ テスト要求 ENTER エンターキー PFK1 プログラムファンクションキー 1 PFK2 プログラムファンクションキー 2 etc. etc. PFK36 プログラムファンクションキー 36 .SH エントリの例 以下のエントリは、ユーザ環境と /usr/share/misc/map3270 において 適切なものが見つからない場合に tn3270(1) で使用されるエントリです。 .sp .nf name { # 環境変数 TERM による実際の名前 clear = '^z'; flinp = '^x'; enter = '^m'; delete = '^d' | '^?'; # '^?' は削除 (rubout) です。 synch = '^r'; reshow = '^v'; eeof = '^e'; tab = '^i'; btab = '^b'; nl = '^n'; left = '^h'; right = '^l'; up = '^k'; down = '^j'; einp = '^w'; reset = '^t'; xoff = '^s'; xon = '^q'; escape = '^c'; ferase = '^u'; insrt = '\E '; # プログラムアテンションキー pa1 = '^p1'; pa2 = '^p2'; pa3 = '^p3'; # プログラムファンクションキー pfk1 = '\eE1'; pfk2 = '\eE2'; pfk3 = '\eE3'; pfk4 = '\eE4'; pfk5 = '\eE5'; pfk6 = '\eE6'; pfk7 = '\eE7'; pfk8 = '\eE8'; pfk9 = '\eE9'; pfk10 = '\eE0'; pfk11 = '\eE-'; pfk12 = '\eE='; pfk13 = '\eE!'; pfk14 = '\eE@'; pfk15 = '\eE#'; pfk16 = '\eE$'; pfk17 = '\eE%'; pfk18 = '\eE'; pfk19 = '\eE&'; pfk20 = '\eE*'; pfk21 = '\eE('; pfk22 = '\eE)'; pfk23 = '\eE_'; pfk24 = '\eE+'; } .fi .SH "上記の定義での IBM 3270 キー定義" .IR tn3270 (1) と .IR mset (1) が提供するデフォルトキーマッピング使用時の、 3270 の各機能をエミュレートするキーを下表に示します。 .sp .nf コマンドキー IBM 3270 キー デフォルトキー Enter RETURN Clear control-z カーソル移動キー New Line control-n もしくは Home Tab control-i Back Tab control-b Cursor Left control-h Cursor Right control-l Cursor Up control-k Cursor Down control-j もしくは LINE FEED 編集制御キー Delete Char control-d もしくは RUB Erase EOF control-e Erase Input control-w Insert Mode ESC Space End Insert ESC Space プログラムファンクションキー PF1 ESC 1 PF2 ESC 2 ... ... PF10 ESC 0 PF11 ESC - PF12 ESC = PF13 ESC ! PF14 ESC @ ... ... PF24 ESC + プログラムアテンションキー PA1 control-p 1 PA2 control-p 2 PA3 control-p 3 ローカル制御キー Reset After Error control-r Purge Input Buffer control-x .ne 1i Keyboard Unlock control-t Redisplay Screen control-v その他のキー Erase current field control-u .fi .SH 関連ファイル /usr/share/misc/map3270 .SH 関連項目 tn3270(1), mset(1), \fIYale ASCII Terminal Communication System II Program Description/Operator's Manual\fR (IBM SB30-1911) .SH 作者 Greg Minshall .SH バグ .I map3270 で提供されている機能すべてについてどのように処理すれば良いのかを、未だ .I tn3270 は理解していません。 その様な機能が要求されると .I tn3270 はビープを鳴らします。 .PP (「語消去」や「語タブ」での) 「語」の定義は実行時オプションにするべきです。 現在これはカーネルの tty ドライバでの定義のまま (空白以外の文字列) に 定義されています。"vi" での定義 (特殊文字の文字列、アルファベット数字の文字列) を使用したい人もいるでしょう。 diff --git a/ja_JP.eucJP/man/man5/modems.5 b/ja_JP.eucJP/man/man5/modems.5 index e10e7aec7b..9b1bb17589 100644 --- a/ja_JP.eucJP/man/man5/modems.5 +++ b/ja_JP.eucJP/man/man5/modems.5 @@ -1,146 +1,146 @@ .\" 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. .\" .\" @(#)modems.5 3/24/95 -.\" jpman $Id: modems.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: modems.5,v 1.3 1998/07/02 14:15:42 horikawa Stab % .\" .Dd March 24, 1995 .Dt MODEMS 5 .Os BSD 4.4 .Sh 名称 .Nm modems .Nd モデム設定データベース .Sh 解説 .Xr tip 1 によって知られるモデムとその属性は .Xr termcap 5 ファイルのような構造の .Tn ASCII ファイルに記録されます。 ファイルの各行は、1 つの .Em モデム についての記述を提供します。 フィールドはコロン (``:'') で分けられています。 \e 文字の直後に改行がある行末は、次の行へ継続されます。 .Pp 最初のエントリはモデムの (複数の) 名称です。 .\" docs7092 の内容を反映 もしモデムの名称が 1 つ以上ある場合、名称は縦棒で区切られます。 モデムの名称の後に記述フィールドが続きます。 `=' 記号が続くフィールド名は、文字型が続くことを示します。 `#' 記号が続くフィールド名は、数値が続くことを示します。 .Pp .Xr tip 1 が呼び出された時、リモートシステムに対するエントリが .\" docs7092 の内容を反映 .Pa /etc/remote データベースから検索されます。 (短縮されている) "ACU" タイプケーパビリティが含まれる場合、 .Xr tip 1 は特定のモデムを .Pa /etc/modems から検索します。 モデムエントリが見付かった場合、リモートシステムとの接続時や切断時に どのように .Xr tip 1 プログラムがモデムを扱うかの適当なケーパビリティを決定します。 .Sh ケーパビリティ ケーパビリティは、文字列 (str) ・数値 (num) ・ブーリアンフラグ (bool) のいずれかです。文字列ケーパビリティは .Em capability Ns Ar = Ns Em value のように指定されます。例えば、 ``reset_command=ATZ\\r'' のように指定 します。数値ケーパビリティは .Em capability Ns Ar # Ns Em value のように指定されます。例えば、``intercharacter_delay#50'' のように指 定します。ブーリアンケーパビリティは単にケーパビリティを記述するだけで 指定されます。 .Bl -tag -width intercharacter_delay indent .It Cm \&dial_command (str) リモートシステムにダイアルするために使われる AT コマンドです (典型的には "ATDT" でしょう)。 .It Cm \&echo_off_command (str) コマンドエコーを抑制するための ATコマンドです。 .It Cm \&escape_guard_time (num) ミリ秒で表現されたディレイです。 コマンドに戻るエスケープシーケンスフレームに使われます。 .It Cm \&escape_sequence (str) コマンドに戻るためのエスケープシーケンスです。 .It Cm \&hangup_command (str) モデムをハングアップするために使われる AT コマンドです。 .It Cm \&hw_flow_control (bool) コンピュータとモデム (DTE/DCE) の間でハードウェア (RTS/CTS) フロー制御 を行うようにします。 .It Cm \&init_string (str) ダイアル前にモデムを初期化するために使われる AT コマンドです。 .It Cm \&intercharacter_delay (num) コマンドをモデムに送る時の文字間に開けられる、ミリ秒で指定され るディレイ値です。 .It Cm \&intercommand_delay (num) モデムに発行されるコマンド間に開けられる、ミリ秒で指定される最小ディレイ 値です。 .It Cm \&lock_baud (bool) コンピュータとモデム (DTE / DCE) の間で固定のビットレートが使われます。 ビットレートは .Pa /etc/remote で指定されます。 .It Cm \&reset_command (str) モデムをリセットするための AT コマンドです。 .It Cm \&reset_delay (num) リセットし準備状態に戻るのにモデムで必要とされるミリ秒で指定される時間 です。 .Sh 関連ファイル .Bl -tag -width /etc/modems -compact .It Pa /etc/modems .Pa /etc ディレクトリにおかれた .Nm モデム 設定データベースファイルです。 .El .Sh 関連項目 .Xr tip 1 , .Xr remote 5 .Sh 歴史 .Nm ファイル書式は .Bx 4.4 から登場しました。 diff --git a/ja_JP.eucJP/man/man5/motd.5 b/ja_JP.eucJP/man/man5/motd.5 index c88b9c0542..6e5dc14785 100644 --- a/ja_JP.eucJP/man/man5/motd.5 +++ b/ja_JP.eucJP/man/man5/motd.5 @@ -1,44 +1,44 @@ .\" %NetBSD: motd.5,v 1.2 1994/12/28 18:58:53 glass Exp % .\" .\" This file is in the public domain. .\" .Dd February 13, 1997 -.\" jpman $Id: motd.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: motd.5,v 1.3 1998/06/12 15:52:50 kumano Stab % .Dt MOTD 5 .Os .Sh 名称 .Nm motd .Nd 今日のメッセージを含むファイル .Sh 解説 通常、ユーザがログインした後のシェル実行前に、 .Xr login 1 は .Pa /etc/motd ファイルを表示します。 このファイルは、一般的にはシステムに関する重要なアナウンスのために使用します。 システム起動時に、カーネルバージョン文字列を含む行が このファイルの前に付きます。 .Pp 個々のユーザはこのファイルの表示を抑制することができます。 そのためには、 .Dq Pa .hushlogin という名前のファイルをホームディレクトリに置くか、 .Xr login.conf 5 で制御します。 .Sh 関連ファイル .Bl -tag -width $HOME/.hushlogin -compact .It Pa /etc/motd 今日のメッセージ。 .It Pa $HOME/.hushlogin .Pa /etc/motd の出力を抑制。 .El .Sh 使用例 .Bd -literal FreeBSD 2.1.6.1-RELEASE (GENERIC) #0: Sun Dec 29 03:08:31 PST 1996 /home is full. Please cleanup your directories. .Ed .Sh 関連項目 .Xr login 1 , .Xr login.conf 5 diff --git a/ja_JP.eucJP/man/man5/netgroup.5 b/ja_JP.eucJP/man/man5/netgroup.5 index a3ac4b9c4c..ce4f0106e7 100644 --- a/ja_JP.eucJP/man/man5/netgroup.5 +++ b/ja_JP.eucJP/man/man5/netgroup.5 @@ -1,188 +1,188 @@ .\" Copyright (c) 1992, 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. .\" .\" @(#)netgroup.5 8.2 (Berkeley) 12/11/93 -.\" jpman $Id: netgroup.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: netgroup.5,v 1.3 1998/07/31 00:57:44 moro Stab % .\" .Dd December 11, 1993 .Dt NETGROUP 5 .Os .Sh 名称 .Nm netgroup .Nd ネットワークグループを定義する .Sh 書式 .Nm netgroup .Sh 解説 .Nm ファイルは ネットワークへの同じようなアクセス権を与えられた .Sy (host, user, domain) の形式の値の組を指定します。 .Pp このファイル中のそれぞれの行は、ネットグループ名とそれに続くネットグループの メンバリストで構成されます。 それぞれのメンバは、他のネットグループ名か、次のような値の組に する事ができます。 .Bd -literal -offset indent (host, user, domain) .Ed .Pp ここで .Sy host , .Sy user および .Sy domain は、それぞれの構成要素に対応する文字列名です。 コンマで区切られたフィールドはどれも、空にする事で ``ワイルドカード'' を、 ``-'' にする事で ``値無し'' を指定する事ができます。 メンバリストは空白またはコンマで区切る事ができ、文字 ``\e'' を行の最後 に使う事によって行を継続できます。 1 行は 1024 文字までに制限されています。 .Nm データベースにアクセスするためには、通常 .Xr getnetgrent 3 の中の関数が使われます。 .Pp # で始まる行はコメントとして扱われます。 .Sh NIS/YP の相互作用 他の多くのプラットフォームでは、 .Nm はもっぱら .Tn NIS と一緒に用いられ、ローカルの .Pa /etc/netgroup ファイルは無視されます。 .Bx Free では .Tn NIS かローカルファイルの .Nm のどちらかを使うようにする事が出来ます。しかし、 この機能は慎重に使うべきです。 現在の .Nm システムは、 .Fn innetgr 3 を用いた照会に関する部分が極めて非効率です。 これは、問い合わせのあったその場で .Nm のメンバ情報を計算するためです。 それに比べて、 .Tn NIS の .Nm データベースは .Fn innetgr 3 が素早く照会を完了させるためのキー項目を持った 3つのマップ (netgroup, netgroup.byuser そして netgroup.byhost)によって構成されています。 .Bx Free の .Nm システムは、 次の方法で .Tn NIS の .Nm マップと互いに作用し合う事が出来ます: .Bl -bullet -offset indent .It もし .Pa /etc/netgroup ファイルが存在しなかった場合、または存在しても空の場合、または存在して も .Sq + しか書かれていない場合で、これらのいずれかの場合に加えて .Tn NIS が動いている場合は、 .Nm は .Tn NIS だけを使って照会を行ないます。このとき、 .Fn innetgr 3 は、netgroup.byuser マップと netgroup.byhost マップを最大限に利用して 高速検索を行ないます (これは、SunOS とそれに類するプラットホームの 実装とほとんど同じです) 。 .It もし .Pa /etc/netgroup が存在し、かつローカルの .Nm 情報のみを含んでいる ( .Tn NIS の .Sq + がない) 場合、 そのローカルの .Nm 情報のみが使用されます ( .Tn NIS の情報は無視されます)。 .It もし、 .Pa /etc/netgroup が存在し、かつローカルの netgroup データ .Pa および .Tn NIS の .Sq + トークンの両方が含まれている場合、ローカルのデータと .Tn NIS の netgroup マップは 1 つにつながれた .Nm データベースの様に処理されます。この構成は最も柔軟ですが、 最も非効率です。特に、このデータベースが大きい場合は .Fn innetgr 3 による照会は極端に遅くなります。 .El .Sh 関連ファイル .Bl -tag -width /etc/netgroup -compact .It Pa /etc/netgroup ネットグループデータベース .El .Sh 関連項目 .Xr getnetgrent 3 , .Xr exports 5 .Sh 互換性 このファイルフォーマットは、さまざまなベンダと互換性がありますが、 すべてのベンダが同一のフォーマットを使っているわけではないようです。 .Sh バグ ネットグループのメンバの組に基づいたアクセス制限の解釈は、さまざまな ネットワークアプリケーション任せになっています。 また、ドメイン指定を .Bx 環境に適用する方法も不明確です。 .Pp .Nm データベースは逆引きスピードアップのため、 .Xr passwd 5 の様にハッシュ化された .Xr db 3 データベースに格納されるべきです。 diff --git a/ja_JP.eucJP/man/man5/networks.5 b/ja_JP.eucJP/man/man5/networks.5 index 9acb558714..4c0d3dfd3e 100644 --- a/ja_JP.eucJP/man/man5/networks.5 +++ b/ja_JP.eucJP/man/man5/networks.5 @@ -1,90 +1,90 @@ .\" 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. .\" .\" @(#)networks.5 8.1 (Berkeley) 6/5/93 .\" %Id: networks.5,v 1.2.2.2 1998/06/28 21:34:27 hoek Exp % .\" -.\" jpman $Id: networks.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: networks.5,v 1.3 1998/06/12 15:54:06 kumano Stab % .\" .Dd June 5, 1993 .Dt NETWORKS 5 .Os BSD 4.2 .Sh 名称 .Nm networks .Nd ネットワーク名のデータベース .Sh 解説 .Nm networks ファイルは、 .Tn DARPA インターネットを含む既知のネットワークの情報を保持します。 各ネットワーク毎に、以下の情報を表す 1 行が存在します。 .Bd -unfilled -offset indent 公式ネットワーク名 ネットワーク番号 別名 .Ed .Pp 各項目は任意個の空白文字やタブ文字で分けられます。 ``#'' はコメント開始を表し、 行末までの文字はファイルを検索するルーチンに解釈されません。 このファイルは通常 Network Information Control Center .Pq Tn NIC が管理する公式ネットワークデータベースから生成しますが、 非公式な別名や未知のネットワークに関する情報を最新とするために、 ローカルでの変更が必要になるかもしれません。 .Pp ネットワーク番号は、 インターネットアドレス操作ライブラリ .Xr inet 3 の .Xr inet_network 3 ルーチンが使用する、伝統的な ``.'' (ドット) 表記で指定します。 ネットワーク名は、フィールド区切り文字・改行文字・コメント文字以外の、 任意の表示可能文字からなります。 .Sh 関連ファイル .Bl -tag -width /etc/networks -compact .It Pa /etc/networks .Nm networks は .Pa /etc にあります。 .El .Sh 関連項目 .Xr getnetent 3 .Sh バグ 静的ファイルの代わりに、ネームサーバを使用すべきです。 .Sh 歴史 .Nm ファイルフォーマットは .Bx 4.2 に登場しました。 diff --git a/ja_JP.eucJP/man/man5/nologin.5 b/ja_JP.eucJP/man/man5/nologin.5 index a0b6e630aa..23c6a820b2 100644 --- a/ja_JP.eucJP/man/man5/nologin.5 +++ b/ja_JP.eucJP/man/man5/nologin.5 @@ -1,67 +1,67 @@ .\" 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 .\" %Id: nologin.5,v 1.2.2.2 1998/07/17 20:13:42 jkh Exp % .\" -.\" jpman $Id: nologin.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: nologin.5,v 1.3 1998/06/13 09:47:03 kumano Stab % .\" .Dd June 19, 1993 .Dt NOLOGIN 5 .Os FreeBSD 2.1 .Sh 名称 .Nm nologin .Nd ログインを拒否する .Sh 解説 .Nm は、 .Pa /etc/nologin ファイルがあるとログインを拒否します。 このプログラムはユーザに .Pa /etc/nologin の内容を表示し、終了します。 .Sh セキュリティ ユーザ root の .Xr login 1 では無視されます。 .Sh 関連ファイル .Bl -tag -width /etc/nologinxxx -compact .It Pa /etc/nologin .Nm ファイルは .Pa /etc にあります。 .El .Sh 関連項目 .Xr login 1 , .Xr rlogin 1 , .Xr telnet 1 , .Xr shutdown 8 diff --git a/ja_JP.eucJP/man/man5/opieaccess.5 b/ja_JP.eucJP/man/man5/opieaccess.5 index 9b06f778d8..fc76738794 100644 --- a/ja_JP.eucJP/man/man5/opieaccess.5 +++ b/ja_JP.eucJP/man/man5/opieaccess.5 @@ -1,94 +1,94 @@ .\" opieaccess.5: Manual page describing the /etc/opieaccess file. .\" .\" Portions of this software are Copyright 1995 by Randall Atkinson and Dan .\" McDonald, All Rights Reserved. All Rights under this copyright are assigned .\" to the U.S. Naval Research Laboratory (NRL). The NRL Copyright Notice and .\" License Agreement applies to this software. .\" .\" History: .\" .\" Written at NRL for OPIE 2.0. .\" .ll 6i -.\" jpman $Id: opieaccess.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: opieaccess.5,v 1.3 1998/07/21 23:15:14 jsakai Stab % .pl 10.5i .\" @(#)opieaccess.5 2.0 (NRL) 1/10/95 .\" WORD: passive attack 受動攻撃 .\" .lt 6.0i .TH OPIEACCESS 5 "January 10, 1995" .AT 3 .SH 名称 /etc/opieaccess \- 信頼できるネットワークの OPIE(One-time Password In Everything) データベース .SH 解説 .I opieaccess ファイルは、受動攻撃に対するセキュリティに関して、そのシステム が信頼しても構わないと考えられるネットワークのリストを含みます。 ここで、信頼できるネットワークからのユーザは、OPIE 応答を用いてログインする ことができますが、必ずしも OPIE 応答を使う必要はありません。一方、 信頼できないネットワークからのユーザは、必ず OPIE 応答を使う (これがデフォルトの動作) 必要があります。 "内側の" ネットワークに関しては、そのサイトに対して OPIE の使用を強制 しませんし、また、OPIE を使って自分のパスワードを保護するかどうかを ユーザが選ぶことができるので、この信頼関係により、サイトがよりスムーズに OPIE に移行することができます。 .sp OPIE システムは受動攻撃からユーザを保護するものですが、 .I opeiaccess ファイルで実装された信頼という全概念は、 それと同様の受動攻撃に対して システムのバックアップをオープンにしてしまいます。 従って、この信頼という概念は重大なセキュリティホールとなります。 本バージョンの OPIE にこのような .I opieaccess が存在するのは、ひとえに、OPIE を使いたくないユーザのせいで自分の アカウントを破られたくないユーザが OPIE を使えなくなるよりも、 このようなユーザが OPIE を使えるようにすることの方がよいと信じているためです。 どのような環境であれ、 trust 機能を活かした本バージョンの OPIE は移行のためのツールと考えるべきで、 永久に使い続けるべきではありません。 移行のためのツールとして使う必要がなくなった時点で、 .I opieaccess ファイルをサポートしないバージョンの OPIE を構築し、OPIE システムの 裏をかくための手段としてこのファイルを使おうとする攻撃者にチャンスを 与えないようにする必要があります。 .sp .I opieaccess は、以下のように空白で区切られた 3 つのフィールドからなる行から構成されます (区切りとしてタブも正しく解釈されますが、空白を代わりに使って下さい)。 .PP .nf .ta \w' 'u フィールド名 内容 action OPIEを利用しないログインを "許可" もしくは "拒否" します address 照合するネットワークのアドレスです mask 照合のためのネットワークのマスクです .fi サブネットは適切なアドレスとマスクを使うことで制御されます。 個々のホストは 255.255.255.255 のマスクと適切なアドレスを使うことで 制御されます。 どの規則も一致しない場合、デフォルトでは OPIE 無しのログインは拒否されます。 .SH 関連項目 .BR ftpd (8) .BR login (1), .BR opie (4), .BR opiekeys (5), .BR opiepasswd (1), .BR opieinfo (1), .BR su (1), .SH 作者 Bellcore の S/Key は Bellcore の Phil Karn, Neil M. Haller, John S. Walden によって書かれました。 OPIE は NRL で Randall Atkinson, Dan McDonald, Craig Metz によって作成 されました。 S/Key は Bell Communications Research (Bellcore) のトレードマークです。 .SH 連絡先 OPIE は Bellcore の "S/Key Users" メーリングリストで議論されました。 参加するためには、電子メールを以下の所に送って下さい。 .sp skey-users-request@thumper.bellcore.com diff --git a/ja_JP.eucJP/man/man5/opiekeys.5 b/ja_JP.eucJP/man/man5/opiekeys.5 index 7c317d9e84..07a5c00f76 100644 --- a/ja_JP.eucJP/man/man5/opiekeys.5 +++ b/ja_JP.eucJP/man/man5/opiekeys.5 @@ -1,67 +1,67 @@ .\" opieaccess.5: Manual page describing the /etc/opiekeys file. .\" .\" Portions of this software are Copyright 1995 by Randall Atkinson and Dan .\" McDonald, All Rights Reserved. All Rights under this copyright are assigned .\" to the U.S. Naval Research Laboratory (NRL). The NRL Copyright Notice and .\" License Agreement applies to this software. .\" .\" History: .\" .\" Written at NRL for OPIE 2.0. .\" .ll 6i -.\" jpman $Id: opiekeys.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: opiekeys.5,v 1.3 1998/07/03 09:08:53 mutoh Stab % .pl 10.5i .\" @(#)opiekeys.1 2.0 (NRL) 1/10/95 .\" .lt 6.0i .TH OPIEKEYS 1 "January 10, 1995" .AT 3 .SH 名称 /etc/opiekeys \- ユーザキー情報の OPIE(One-time Password In Everything) データベース .SH 解説 .I opiekeys ファイルには OPIE ソフトウェアがユーザ認証のために使用するユーザ情報が格納されます。 .I opiekeys ファイルは S/Key の .I /etc/skeykeys データベースファイルに対して下位互換ですが、これは ハッシングアルゴリズム (MD4 および MD5) が S/Key と OPIE で同一の 場合に限られます (すなわち、 MD5 OPIE は MD4 S/Key キーを使用できません)。 .I opiekeys ファイルは、空白 (タブは正しく解釈されますが、代りにスペースを使うべきです) で区切られた次のような 6 フィールドから成ります: .PP .nf .ta \w' 'u フィールド名 内容 name ユーザのログイン名。 sequence ユーザのシーケンス番号。 seed ユーザの種。 key ユーザの最後のレスポンス (16 進数)。 date 最後に変更された日付。 time 最後に変更された時刻。 .fi .SH 関連項目 .BR ftpd (8) .BR login (1), .BR opie (4), .BR opiekeys (5), .BR opiepasswd (1), .BR opieinfo (1), .BR su (1), .SH 作者 Bellcore の S/Key は、 Bellcore の Phil Karn, Neil M. Haller, John S. Walden が記述しました。 OPIE は NRL にて Randall Atkinson, Dan McDonald, Craig Metz が作成しました。 S/Key は Bell Communications Research (Bellcore) の商標です。 .SH 連絡先 OPIE は Bellcore の "S/Key Users" メーリングリストで議論されています。 加入要求は電子メールを下記アドレスに送ってください: .sp skey-users-request@thumper.bellcore.com diff --git a/ja_JP.eucJP/man/man5/passwd.5 b/ja_JP.eucJP/man/man5/passwd.5 index b466809d28..f3867f3da7 100644 --- a/ja_JP.eucJP/man/man5/passwd.5 +++ b/ja_JP.eucJP/man/man5/passwd.5 @@ -1,678 +1,678 @@ .\" 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. .\" .\" From: @(#)passwd.5 8.1 (Berkeley) 6/5/93 .\" %Id: passwd.5,v 1.6.2.8 1998/07/19 06:52:11 jkh Exp % .\" -.\" jpman $Id: passwd.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: passwd.5,v 1.3 1998/07/30 15:26:15 horikawa Stab % .\" .\" WORD: NIS/YP INTERACTION NIS/YP との相互作用 [yppasswd.1] .\" WORD: accounting アカウンティング (パスワード期限等の意味) .\" WORD: epoch 基準時点 .Dd September 29, 1994 .Dt PASSWD 5 .Os .Sh 名称 .Nm passwd .Nd パスワードファイルのフォーマット .Sh 解説 .Nm passwd ファイルは改行で区切られたレコードから成ります。 ユーザごとに 1 レコードが対応し、 コロン(``:'')で区切られた 10 個の欄が含まれます。 これらの欄は以下の通りです: .Pp .Bl -tag -width password -offset indent .It name ユーザのログイン名。 .It password ユーザの .Em 暗号化された パスワード。 .It uid ユーザのid。 .It gid ユーザのログイングループid。 .It class ユーザのログインクラス。 .It change パスワードの変更時間。 .It expire アカウントの有効期限。 .It gecos ユーザについての一般的な情報。 .It home_dir ユーザのホームディレクトリ。 .It shell ユーザのログインシェル。 .El .Pp 最初の空白文字でない文字がポンド記号(#)であるような行は注釈であり、無視 されます。スペース、タブ、改行だけからなる空行もまた無視されます。 .Pp .Ar name 欄はコンピュータアカウントにアクセスするのに用いられるログインであり、 .Ar uid 欄はそれに結び付けられた数字です。これらはファイルアクセスを制御するので、 両方共そのシステム(またしばしば複数のシステムにわたる1つのグループ)の中 で一意であるべきです。 .Pp 同じログイン名や同じユーザidのエントリを複数持つことは可能で すが、普通それは誤りです。これらのファイルを取り扱うルーチンはしばしばそ の複数エントリの 1 つだけを返しますし、 そしてそれはランダムな選択によるものです。 .Pp ログイン名は決してハイフン(``-'')で始めてはいけません。また、メーラを 混乱させる傾向にあるので、大文字やドット(``.'')も絶対に名前の一部にしな いことを強く推奨します。コロン(``:'')は歴史的にユーザデータベース中の欄 を分けるために用いられてきたので、いかなる欄にも含まれません。 .Pp password欄はパスワードの .Em 暗号化された 形です。 .Ar password 欄が空ならば、そのマシンへアクセスするのに何のパスワードも必要としないで しょう。これはほとんど恒常的に誤りです。これらのファイルは暗号化された ユーザパスワードを含んでいるので、 適当な権利無しにはいかなる人によっても可読であっ てはいけません。管理上のアカウントは1個のアスタリスク .Ql \&* を含むパスワード欄を有しており、これは通常のログインを許しません。 .Pp group欄はユーザがログインした上で位置付けられるグループです。このシステムは マルチグループ( .Xr groups 1 参照) をサポートしますが、この欄はユーザの1次グループを指名します。2次グループの メンバは .Pa /etc/group の中で選ばれます。 .Pp .Ar class 欄はユーザのログインクラスに対するキーです。ログインクラスは .Xr login.conf 5 の中で定義されます。 .Xr login.conf 5 は、ユーザの属性、アカウンティング、リソース、環境設定に関する .Xr termcap 5 形式のデータベースです。 .Pp .Ar change 欄は .Dv GMT における基準時点からの秒数を表したものであり、 この時までにアカウントに対するパスワードを変更する必要があります。 パスワードエージング機能をなくすには、 この欄を空欄にしておくか0をセットしておけば良いです。 .Pp .Ar expire 欄は .Dv GMT における基準時点からの秒数を表したものであり、 その時にアカウントが消滅します。 アカウント再設定機能をなくすには、 この欄を空にセットしておくか0をセットしておけば良いです。 .Pp .Ar gecos 欄はコンマ(``,'')で区切られた以下のような副欄を通常含んでいます: .Pp .Bd -unfilled -offset indent fullname ユーザのフルネーム office ユーザの職場の位置 wphone ユーザの職場の電話番号 hphone ユーザの自宅の電話番号 .Ed .Pp この情報は フィンガープログラム .Xr finger 1 によって利用され、最初の欄はシステムのメーラ によって使われます。fullname 欄内にアンパサンド文字 .Ql \&& が現われると、この欄を使うプログラムはそれをそのアカウントのログイン名の 大文字版に置き換えます。 .Pp ユーザのホームディレクトリは、ユーザがログインして位置付けられる完全な .Tn UNIX パス名です。 .Pp shell欄はユーザの好むインタプリタです。 .Ar shell 欄になにも無ければ Bourne シェル .Pq Pa /bin/sh が仮定されます。セキュリティ上の理由により、シェルがシステムへのアクセス を許さないスクリプト(例えば .Xr nologin 8 スクリプト)に設定されている場合、いかなる環境変数も渡されないように配慮さ れるべきです。 .Xr sh 1 については、これは .Fl p フラグを指定することで可能です。これが他のシェルでどのように行なわれるか は、特定のシェルの文書を調べてください。 .Sh YP/NIS との相互作用 .Ss NISパスワードデータへのアクセスを可能にする システム管理者は .Pa /etc/master.passwd ファイルに特別なレコードを付け加えることによって、パスワード情報について NIS/YPを用いるように .Tn FreeBSD を設定できます。ハッシュされたパスワードデータベースおよび .Pa /etc/passwd ファイル( .Pa /etc/passwd は絶対に手動で編集してはいけません)に変更が適切にマージされるように、 エントリは .Xr vipw 8 で付加するべきです。別の方法としては、なんらかの方法で .Pa /etc/master.passwd を修正した後、 .Xr pwd_mkdb 8 を用いてパスワードデータベースを手動で更新することができます。 .Pp NISを活性化するための最も簡単な方法は、名前欄にプラス符号(`+')だけを持つ、 以下のような空のレコードを付け加えることです。 .Bd -literal -offset indent +::::::::: .Ed `+' は、 .Tn FreeBSD の標準Cライブラリの .Xr getpwent 3 ルーチンに対し、 検索において NIS パスワードマップを使用開始するよう指示します。 .Pp 上記のエントリは .Em ワイルドカード エントリとして知られていることに注意してください。なぜなら、それは全ての ユーザと一致し (他に情報を持たない `+' は、全員に一致します)、 全 NIS パスワードデータを無変更にて引き出すことを許します。 一方、 NIS エントリで `+' の次にユーザ名やネットグループ名を指定することによって、 どのようなデータが NIS パスワードマップから展開されるのか、 およびそれがどのように解釈されるのかについて、 管理者が影響を与えることができます。 この特徴を示す、少数のレコード例を挙げます(1 つの .Pa master.passwd ファイル中には複数の NIS エントリを持つことが可能であることに注意): .Bd -literal -offset indent -mitnick::::::::: +@staff::::::::: +@permitted-users::::::::: +dennis::::::::: +ken:::::::::/bin/csh +@rejected-users::32767:32767::::::/bin/false .Ed 特定のユーザ名は明示的にリストされますが、ネットグループは `@' を前に付け て表されます。 上の例では、``staff'' および ``permitted-users'' ネットグループ のユーザは、NIS から読まれ無変更で使用されるパスワード情報を持ちます。 言い換えれば、それらのユーザはそのマシンに通常のアクセスを許される ということです。ユーザ ``ken'' および ``dennis'' は、 ネットグループを通じてではなく明示的に名前が指定されており、 NIS から読まれるパスワード情報を持ちます。 例外は、ユーザ ``ken'' のシェルが .Pa /bin/csh に再マップされることです。 これは、NISパスワードマップで指定されたシェルの値が、ローカル .Pa master.passwd ファイルの特別なNISエントリで指定された値によって上書きされることを意味します。 ユーザ ``ken'' は csh シェルを割り当てておいても良いかも知れません。 なぜなら、 政治的あるいは技術的な理由でクライアントマシンにインストールされていない 別のシェルを、彼の NIS パスワードエントリに指定されているかもしれないためです。 他方、``rejected-users''ネットグループのユーザは、そのUID、 GID、シェルが不正な値で上書きされているのでログインできなくなります。 .Pp ユーザ ``mitnick'' は、そのエントリが `+' ではなく `-' で指定されているので、 完全に無視されることになります。 マイナスエントリは、 ある NIS エントリを完全に遮断するために用いることができます。 このような方法でパスワードデータが除外されたユーザは、 システムから全く認識されません。(マイナスエントリで指定された 上書き情報は無視されます。 なぜなら、システムが最初に認識しないことにしたユーザの上書き情報を処理 することは無駄だからです。) 一般にマイナスエントリは、 ある権限のあるネットグループのメンバとなってアクセスを許されるかもしれない ユーザを特別に除外するために使用します。 例えば ``mitnick'' が ``permitted-users'' ネットグループのメンバであり、 いかなる理由があってもそのネットグループ内に留まることを許す必要がある場合 (おそらくそのドメイン内の他のマシンにアクセスすることを保証するため)、 管理者はマイナスエントリを使用することにより、 特定のシステムへのアクセスを拒否し続けるこ とができます。また、アクセスを許されたユーザおよびその残りを削除したよう なよくありそうな混み入ったユーザのリストを生成するよりは、むしろアクセスを 許されないユーザを明示的にリストする方が容易なことが多いです。 .Pp プラスおよびマイナスエントリは、先行一致優先で最初から最後の順で評価されま す。これはシステムが特定のユーザに一致する最初のエントリだけを使用するこ とを意味します。例えば、``staff'' ネットグループと ``rejected-users'' ネットグループの両方のメンバとなっているようなユーザ ``foo'' は、 上の例では ``rejected-users'' のエントリの前に ``staff'' のエントリがありますので、 システムに許可されます。もし順序が逆なら、今度はユーザ ``foo'' は ``rejected-users'' として認識され、アクセスは拒否されます。 .Pp 最後に、 .Pa /etc/master.passwd ファイルの NIS アクセスエントリで指定されたユーザまたはネットグループ のどれとも一致しないNISパスワードデータベースレコードは、(マイナスエントリ を使って指定した全てのユーザと共に)全て無視されます。先に示した例 ではリストの最後にワイルドカードエントリが無いので、 ``ken'' と ``dennis'' と ``staff'' ネットグループと ``permitted-users'' ネットグループとを除く全てのユーザを システムは権限があるユーザとして認識しないでしょう。 ``rejected-users'' ネットグループは認識されますが、 全メンバのシェルは再マップされますので、 アクセスは拒否されるでしょう。他の全てのNISパスワードレコードは無視され るでしょう。 管理者は以下のようなワイルドカードエントリをリストの最後に 付けても良いでしょう。 .Bd -literal -offset indent +:::::::::/usr/local/bin/go_away .Ed このエントリは他の全てのエントリと一致しない全てのユーザを一挙にとらえる 働きをします。 .Pa /usr/local/bin/go_away は、システムにアクセスを許可されないユーザに伝えるメッセージを出力する短か いスクリプトまたはプログラムでしょう。 必ずしもログインアクセスを許可せずに、 特定のNISドメイン内の全ユーザをシステムが認識可能であることが望ましいときには、 このテクニックが有効なことがあります。 ログインシェルとシェルスクリプトを使用するときのセキュリティに関する事柄 について、上記のシェル欄の記述を参照してください。 .Pp この .Pa 上書き 機能の主な用途は、 管理者がNISクライアント上でアクセス制限を強化可能とすることです。 単に特定のネットグループに対してユーザを追加したり削除したりするだけで、 そのユーザにあるマシン群へのアクセスを許可し、 かつ他のマシン群へのアクセスを拒否することができます。 ネットグループデータベースもまた NIS 経由でアクセスできるので、 1 個所すなわち NIS マスタサーバからアクセス制限を管理できます。 一旦ホストのアクセスリストが .Pa /etc/master.passwd に設定されると、新にネットグループが作られない限りそれは再度変更する必要 はありません。 .Sh 注釈 .Ss NIS経由のシャドウパスワード .Tn FreeBSD はシャドウパスワード法を採用しており、 ユーザの暗号化されたパスワードはスーパユーザだけが読み書き可能な .Pa /etc/master.passwd および .Pa /etc/spwd.db にのみに記憶されます。 暗号化されたパスワードをパスワード推測プログラムに通すことにより、 ユーザが他のユーザアカウントに対して不正アクセスすることを防ぐためです。 NIS にはパスワード隠蔽のための標準的な方法がありません。 これは、 パスワードデータを全てNISパスワードマップに置き換えることは、 .Tn FreeBSD のパスワード隠蔽システムのセキュリティを無効にしてしまうことを意味します。 .Pp .Tn FreeBSD にはこの問題を回避するのに役立つ少数の特別な特徴が備わっています。 .Tn FreeBSD NIS クライアントと .Tn FreeBSD NIS サーバとの間でパスワード隠蔽を実装することは可能です。 .Xr getpwent 3 ルーチンは .Pa /etc/master.passwd と同じデータを含む .Pa master.passwd.byname と .Pa master.passwd.byuid マップを検索します。マップが存在すれば .Tn FreeBSD は標準の .Pa passwd.byname および .Pa passwd.byuid マップの代りにそれらをユーザ認証に利用しようとします。 .Tn FreeBSD の .Xr ypserv 8 はまたクライアントの要求をチェックして、 クライアントの要求が特権ポートから来たことを確認します。 スーパユーザのみが特権ポートにアクセスすることが許されるので、 要求しているユーザがスーパユーザであるか否か判断可能です。 .Pa master.passwd マップにアクセスする権限の無いユーザからの全ての要求は拒否されるでしょう。 全てのユーザ認証プログラムはスーパユーザの権限で実行されるので、 ユーザの暗号化されたパスワードデータへの必要なアクセスを持ちますが、 通常ユーザはパスワード情報を含まない標準 .Pa passwd マップへのアクセスのみ許されます。 .Pp この特徴は .Tn FreeBSD 以外のシステムがある環境では利用できないことに注意してください。 また、ネットワーク に無制限にアクセスできる真に限定されたユーザは依然 .Pa master.passwd マップを危うくすることにも注意してください。 .Ss NISの上書きに伴なうUIDおよびGIDの再マップ .Tn SunOS や Sun の NIS コードを利用しているオペレーティングシステムとは異なり、 .Tn FreeBSD ではユーザがNIS .Pa passwd エントリ中の .Pa 全て の欄を上書きすることを許しています。例えば以下のような .Pa /etc/master.passwd エントリを考えてみましょう。 .Bd -literal -offset indent +@foo-users:???:666:666:0:0:0:Bogus user:/home/bogus:/bin/bogus .Ed このエントリにより、`foo-users' ネットグループ中の全てのユーザは、 UID、GID、パスワードを含めて .Pa 全て のパスワード情報を上書きされます。この結果、彼等のパスワードは不正な 値に再マップされるので、全ての `foo-users' はシステムから締め出さ れることになるでしょう。 .Pp 以下のようにNISワイルドカードエントリを使う習慣のある人が多いので、 このことは覚えておくべき重要なことです。 .Bd -literal -offset indent +:*:0:0::: .Ed これはしばしば新米の .Tn FreeBSD 管理者が以下のように .Pa master.passwd ファイルのNISエントリを選んでしまうことにつながります。 .Bd -literal -offset indent +:*:0:0:::::: .Ed 更に悪く、以下のようにしてしまうこともあります。 .Bd -literal -offset indent +::0:0:::::: .Ed .Sy Pa master.passwd .Sy ファイルには「絶対に」このようなエントリは入れないでください!! 最初のものは、 全てのパスワードを `*' に再マップし (これは誰もログインできなくします)、 全ての UID および GID を 0 に再マップする (これは皆をスーパユーザにします) ことを .Tn FreeBSD に指示します。 2 番目のものは全 UID および GID をちょうど 0 にマップします が、これは .Pa 全てのユーザがrootになってしまう ことを意味します! .Pp .Ss NIS上書き評価の互換性 Sunが最初に .Xr getpwent 3 ルーチンにNISサポートを追加したとき、 .Tn SunOS のパスワードファイル .Pa /etc/passwd はプレーン .Tn ASCII フォーマットであるということが考慮されていました。 .Tn SunOS のドキュメントによれば、パスワードファイルに '+' エントリを付け加えると、 パスワードファイル中の '+' エントリがある位置に NIS パスワードデータベースの内容が「挿入」されます。例えば 管理者が .Pa /etc/passwd の中央に +:::::: エントリを置いた場合、 NIS パスワードマップの全体の内容が パスワードファイルの中央にコピーされたかのように現われるでしょう。 管理者が +:::::: エントリを .Pa /etc/passwd の中央と最後の両方に置けばNISパスワードマップは2度現われることになるでしょ う。すなわち 1 度目はそのファイルの中央に現れ、もう 1 度は最後に現れます (単純なワイルドカードの代りに上書きエントリを用いることで、 他の組合せが可能です)。 .Pp これに対し .Tn FreeBSD では単一の .Tn ASCII パスワードファイルを持つというわけではありません。 .Tn FreeBSD ではハッシュ化されたパスワードデータベースを持ちます。このデータベースで は最初や中央や最後を容易に定義できませんので、 .Tn SunOS に 100% 互換の手法を設計することは非常に困難です。例えば .Tn FreeBSD の .Fn getpwnam 関数と .Fn getpwuid 関数は、線形検索ではなくハッシュデータベースに直接問い合わせするように設計さ れています。パスワードデータベースが大きいシステムでは、 このアプローチの方が高速です。 しかしデータベースへ直接問い合わせを利用するとき、 システムは元のパスワードファイルの順序を知り得ませんし気にしませんので、 .Tn SunOS が使用するものと同じ上書き論理は容易に適用できません。 .Pp 代りに .Tn FreeBSD では全ての NIS 上書きエントリを一緒のグループにまとめ、それらから 1 つ のフィルタを作ります。各 NIS パスワードエントリはちょうど 1 回上書きフィルタ に対して比較され、それに応じて取り扱われます。フィルタがエントリを変更せ ずに通すことを許すならエントリは変更されないものとして取り扱われ、フィルタ が欄の再マップを要求するなら欄は再マップされ、フィルタが明白な除外を要求 するなら(すなわちエントリが '-' 上書きと一致するなら)エントリは無視され、 エントリがフィルタ指定のどれとも一致しないならエントリは捨てられます。 .Pp また、NIS の '+' および '-' エントリ自身は、 .Pa /etc/master.passwd の中で指定された順序で取り扱われることに再度注意してください。 それ以外の方法で取り扱うと、予測不可能な振舞いとなってしまうからです。 .Pp 結局のところ、データベースのパラダイムを保ちつつ .Tn FreeBSD では .Tn SunOS と非常によく似た動作を行いますが、 .Xr getpwent 3 関数は .Tn SunOS のものとはいくぶん異なった振舞いをします。主な違いは以下の通りです。 .Bl -bullet -offset indent .It NIS パスワードマップの各々のレコードは、ローカルパスワード空間のパスワードに 1 度だけマップすることができます。 .It NIS の '+' および '-' のエントリの位置は、 NIS パスワードレコードがパスワード空間にマップされる場所に 必ずしも影響を与えません。 .El .Pp あらゆる .Tn FreeBSD の構成のうち99%においてはNISクライアントの振舞いは .Tn SunOS や他の同種のシステムのそれと区別できないものとなるでしょう。それでもこれ らのアーキテクチャ的な違いを知っておくことは必要です。 .Pp .Ss NIS上書きに関しネットグループの代りにグループを用いる .Tn FreeBSD はネットグループではなくユーザグループに基づいた上書き照合を行なう能力 を提供します。例えば NIS エントリが以下のように指定されたとき、 .Bd -literal -offset indent +@operator::::::::: .Ed システムはまず `operator' と呼ばれるネットグループに対してユーザを 照合しようとします。 `operator' ネットグループが存在しないとき、 システムは代りに通常の `operator' グループに対して照合しようとします。 .Ss FreeBSDの古いバージョンからの動作の変遷 .Tn FreeBSD のNIS/YPの取り扱いについてはいくつかのバグフィックスと改善がありました。 そのいくつかは動作上の変化をもたらしました。動作上の変化は一般に良い方向 にありますが、ユーザおよびシステム管理者がそれらについて知っておくことは 重要です。 .Bl -enum -offset indent .It 2.0.5 以前のバージョンでは、逆方向検索 (つまり .Fn getpwuid を用いる) には上書きは適用されませんでした。つまり、 .Fn getpwuid は .Fn getpwnam が認識しないログイン名を返すことがありました。 これは現在では .Pa /etc/master.passwd で指定された上書きを全ての .Xr getpwent 3 関数に適用することで解決されました。 .It .Fx 2.0.5 以前では、ネットグループの上書きは全く動作しませんでした。 これは主に .Tn FreeBSD が NIS を通してネットグループを読むことをサポートしなかったことが原因です。 これもまた修正され、 .Tn SunOS や同種の NIS を使用可能なシステムと全く同様に、 ネットグループを指定可能となりました。 .It .Tn FreeBSD は現在NISサーバの能力を持っており、標準第6版形式の .Pa passwd マップに加え .Pa master.passwd NIS マップの使用もサポートしています。このことは、NIS サーバとして .Tn FreeBSD システムを利用するなら、変更情報、有効期限の情報、クラス情報を指定可能であ るということを意味しています。 .El .Sh 関連ファイル .Bl -tag -width /etc/master.passwd -compact .It Pa /etc/passwd パスワードを除いた .Tn ASCII パスワードファイル .It Pa /etc/pwd.db パスワードを除いた .Xr db 3 形式のパスワードデータベース .It Pa /etc/master.passwd パスワードの入った .Tn ASCII パスワードファイル .It Pa /etc/spwd.db パスワードの入った .Xr db 3 形式のパスワードデータベース .El .Sh 関連項目 .Xr chpass 1 , .Xr login 1 , .Xr passwd 1 , .Xr getpwent 3 , .Xr login.conf 5 , .Xr login_getclass 3 , .Xr yp 4 , .Xr login.conf 5 , .Xr adduser 8 , .Xr pwd_mkdb 8 , .Xr vipw 8 , .Xr pw 8 .Sh バグ ユーザ情報は他のどこか に入れるべき(そして結局は入れることになる)でしょう。 .Pp YP/NISパスワードデータベースでは、 普通のユーザには暗号化されたパスワードが見えてしまいます。したがって .Pa master.passwd マップのシャドウパスワードおよび .Tn FreeBSD の .Xr ypserv 8 サーバを利用しないと、 簡単にパスワードクラッキングを許してしまうことになります。 .Pp .Pa master.passwd タイプのマップの使用をサポートする .Tn FreeBSD の .Xr ypserv 8 を使用しないと、 YP/NIS パスワードデータベースは 古いスタイル (第 6 版) のフォーマットになります。これは、 .Tn FreeBSD システムを標準 NIS サーバのクライアントとして利用するとき、 ユーザのログインクラスやパスワード期限等の 現在のフォーマットにある欄の値については サイトワイドな値が利用できなくなることを意味します。 .Sh 互換性 パスワードファイル形式は .Bx 4.3 以降で変更されました。以下の awk スクリプトは、古いスタイルの パスワードファイルを新しいスタイルのパスワードファイルに 変換するのに利用できます。 .Dq class , .Dq change , .Dq expire 欄が追加されましたが、デフォルトでは無効になっています。 これらの欄を設定するには .Xr vipw 8 もしくは .Xr pw 8 を使用してください。 .Bd -literal -offset indent BEGIN { FS = ":"} { print $1 ":" $2 ":" $3 ":" $4 "::0:0:" $5 ":" $6 ":" $7 } .Ed .Sh 歴史 .Nm ファイルは .At v6 で現われました。YP/NISの機能は .Tn SunOS を雛型として .Fx 1.1 で初めて現われました。上書き機能は .Fx 2.0 において新しく組込まれました。上書き機能はネットグループを適切に サポートするために .Fx 2.0.5 で更新されました。注釈のサポートは .Fx 3.0 で初めてサポートされました。 diff --git a/ja_JP.eucJP/man/man5/pbm.5 b/ja_JP.eucJP/man/man5/pbm.5 index ed4ff22a4a..3ac9ff653d 100644 --- a/ja_JP.eucJP/man/man5/pbm.5 +++ b/ja_JP.eucJP/man/man5/pbm.5 @@ -1,88 +1,88 @@ .\" .\" %Id: pbm.5,v 1.1.2.4 1998/07/19 06:52:12 jkh Exp % -.\" jpman $Id: pbm.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: pbm.5,v 1.3 1998/04/29 11:36:38 kuma Stab % .\" .\" WORD: whitespace 空白 .\" .Dd September 27, 1991 .Dt PBM 5 .Sh 名称 .Nm pbm .Nd ボータブルビットマップファイルのフォーマット .Sh 解説 ポータブルビットマップフォーマットは、 最低位の共通の白黒画像ファイルフォーマットです。 元々は、異なったタイプのマシン間で、 ビットマップ転送には適さないネットワークメーラを使用して、 ビットマップをメールで受け渡しする妥当な方法としてデザインされました。 現在は、多くのビットマップ変換フィルタ群の共通語として使用されています。 定義を以下に示します: .Pp .Bl -bullet -compact .It ファイルタイプを識別するための "マジックナンバ"。 pbm ファイルのマジックナンバは "P1" の 2 文字です。 .It 空白 (複数のブランク・TAB・CR・LF から成ります)。 .It 幅を ASCII 10 進数で表記します。 .It 空白。 .It 高さを ASCII 10 進数で表記します。 .It 空白。 .It 幅 * 高さの数のビット。各ビットは '1' または '0' で表し、 ビットマップ左上角を起点として通常の英語を読む向きに連続します。 .It 文字 '1' は黒を、'0' は白を表します。 .It ビット部の空白は無視されます。 .It \&"#" から行末までの文字列は無視されます (コメント)。 .It 長さが 70 文字を越える行は許されません。 .El .Pp 以下に、このフォーマットでの小さなビットマップの例を示します: .Bd -literal P1 # feep.pbm 24 7 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 1 1 1 0 0 1 1 1 1 0 0 1 1 1 1 0 0 1 1 1 1 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 1 0 0 1 1 1 0 0 0 1 1 1 0 0 0 1 1 1 0 0 0 1 1 1 1 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 1 1 1 0 0 1 1 1 1 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .Ed .Pp このフォーマットを読むプログラムは可能な限り寛大になるべきで、 少しでもビットマップのように見えるものはなんでも受け付けるべきです。 .Pp このフォーマットには派生形式があり、 RAWBITS オプションをコンパイル時にセットすることで利用可能です。 この派生形式は、以下の点が異なります: .Pp .Bl -bullet -compact .It \&"マジックナンバ" が "P1" ではなく "P4" です。 .It 8 ビットが 1 バイトに格納されます。上位ビットが先で下位ビットが後になります。 .It ビット部には空白は許されませんし、 高さの後には単一の空白 (通常は改行) のみが許されます。 .It ファイルは 1/8 の大きさになり、読み書きが何倍も高速になります。 .El .Sh 作者 Copyright (C) 1989, 1991 by .An Jef Poskanzer . .\" 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. This software is provided "as is" without express or .\" implied warranty. diff --git a/ja_JP.eucJP/man/man5/pccard.conf.5 b/ja_JP.eucJP/man/man5/pccard.conf.5 index 7126d2fed9..428ce09a34 100644 --- a/ja_JP.eucJP/man/man5/pccard.conf.5 +++ b/ja_JP.eucJP/man/man5/pccard.conf.5 @@ -1,189 +1,189 @@ -.\" jpman $Id: pccard.conf.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: pccard.conf.5,v 1.3 1998/07/10 15:23:53 jsakai Stab % .\" .\" 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. .\" .\" WORD: resource リソース[pccard.conf.5] .\" .Dd November 2, 1994 .Dt PCCARD.CONF 5 .Os FreeBSD .Sh 名称 .Nm pccard.conf .Nd .Xr pccardd 8 設定ファイル .Sh 解説 .Nm pccard.conf ファイルは、PC-CARD スロット管理デーモン .Xr pccardd 8 用の設定ファイルです。カードを識別し、 PC-CARD カードにドライバ (ドライバ用リソースも含む) を 対応させることが出来る情報を提供します。 .Pp 設定ファイル内には四つの基本的な要素があります。 オプションとして他のセクションに先立って .Em "リソースプール" があり、その後 1 つ以上の .Em "カード識別子" と .Em "デバイス実体" が続きます。 最後の 2 つはどんな順序で現れてもよく、 都合に応じてあちこちへ散在しても構いません。 .Pp それぞれの PC-CARD カードは、製造者やカードのバージョンを規定する 設定タプルを含んでいます。これらは、設定ファイル中でカードの仕様を 特定するのに使われ、それによって、そのカードとインタフェースをとれる ドライバを見つけます。 カードとドライバの間には、多対 1 の対応関係があります。すなわち、 単一のドライバが複数の型のカードにインタフェースをとることがあります。 この助けとして、ドライバの指定とは別に、カードの初期化や (ネットワークカードの場合なら) イーサネットアドレスの取り出し用に パラメータを指定することもできます。 .Pp ドライバは一度カードに割り当てられると、そのカードに割り当てられた ままになります。しかし、同じ型のドライバの複数の実体が設定される こともあるため、もし、同じの型のドライバが対応づけられているカードが 2 枚挿し込まれたら、同じ名前で別のドライバ実体が設定される可能性があります。 .Pp .Em insert と .Em remove コマンドは、実行可能なシェルコマンド行を指定することができます。 実行されるコマンドは、そのキーワードの後の行の残りです。 行は、バックスラッシュを使って継続することができます。 簡単なマクロ置換によって、現在のカーネルのデバイス名 .Em ( $device ) とネットワークカードのイーサネットアドレス .Em ( $ether ) をコマンド行へ入れることが可能です。 .Xr pccardd 8 は、コマンド行を実行するために .Xr system 3 サブルーチンを使います。 .Pp 数値は 8 進数、16 進数、10 進数のいずれかの表現をとります。 もし 10 進数に .Em k か .Em K が付いていれば、その値は 1024 を掛けたものになります。 名前にスペースを含める必要があるならば、 ダブルクォートで括っておくとよいでしょう。 ハッシュ文字 (#) は、その行の残りをコメントにします。 .Ss "リソースプール" この (オプションである) セクションは、ISA バスのメモリアドレス空間や I/O ポート、割込み要求番号 (IRQ) といったシステムリソースのプールを指定します。 このリソースプールは、それぞれのドライバの記述中で指定された要求に応じて、 動的にアドレス空間や割り込み番号を割り当てるのに使われます。 .Pp リソースに関する構文は以下の通りです。 .Pp .Dl io Ar start - end ... .Dl memory Ar address size ... .Dl irq Ar irq-number ... .Pp 各文では、初期化時にドライバへ割り当てるのに使える、 I/O やメモリや IRQ のブロックを定義します。 .Pp 上の文はどれも複数行にすることができ、 これで各々のリソースをかたまりに分けて定義することができます。 .Ss "カード識別子" カード識別子の構文は以下の通りです。 .Pp .Dl card Ar manufacturer version .Dl config Ar index driver interrupt [ flags ] .Dl ether Ar offset .Dl insert Ar command .Dl remove Ar command .Pp 第 1 行は必須です。あとの文はオプションであり、 どのような順序で現れても構いません。 .Em config 行は複数存在することもあります。 .Em card のパラメータには、製造者名とカードのバージョンがあり、 カードの CIS メモリから得た値との一致をみるのに使われます。 .Em config パラメータは、 カードの CIS で得られる範囲からそのカードの設定インデックスを選択し、 この設定で関連づけられたドライバを選択し、 そして (もしあれば) 割り当てられるべき割り込みレベルを選択します。 オプションとしてフラグの集合を割り当てることもできます。 .Pp オプションの .Em ether キーワードは、カードの属性メモリ内に ネットワークカードの物理イーサネットアドレスが保持されているときに使われます。 この文のパラメータは、イーサネットアドレスの属性メモリ内での オフセットを指しています。この値は、 .Em $ether マクロを使うことで、 insert/remove コマンド内でも使用できます。 .Pp .Em insert 及び .Em remove セクションでは、カードが挿入されたり取り外されたりしたときに 実行されるべきシェルコマンドを書くことができます。複数の .Em insert や .Em remove コマンドも書くことができ、その場合列挙された順に実行されます。 .Sh 使用例 典型的な設定ファイルは以下のような体裁でしょう。 .Bd -literal # # サンプル設定ファイル # # パラメータのプール # io 0x280 - 0x2F0 0x300 - 0x360 irq 5 6 8 9 10 15 memory 0xd4000 96k memory 0xc4000 32k # # カードデータベース # card "RPTI LTD." "EP400" # NE2000 clone ether 0x110 config 0x21 "ed0" 5 insert ifconfig $device physical $ether insert ifconfig $device bean remove ifconfig $device down card "XYZZY" "FAX/1.0" tty config 0x30 "sio1" 11 insert echo start getty remove echo stop getty .Ed .Sh 関連ファイル .Bl -tag -width /etc/pccard.conf -compact .It Pa /etc/pccard.conf .Xr pccardd 8 の設定ファイル。 .El .Sh 関連項目 .Xr pccardd 8 diff --git a/ja_JP.eucJP/man/man5/phones.5 b/ja_JP.eucJP/man/man5/phones.5 index dde7ae4d9d..fcab2f29bb 100644 --- a/ja_JP.eucJP/man/man5/phones.5 +++ b/ja_JP.eucJP/man/man5/phones.5 @@ -1,80 +1,80 @@ .\" 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. .\" .\" @(#)phones.5 8.1 (Berkeley) 6/5/93 -.\" jpman $Id: phones.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: phones.5,v 1.3 1998/07/21 23:07:26 jsakai Stab % .\" %Id: phones.5,v 1.1.1.1.8.1 1997/03/07 04:18:08 mpp Exp % .\" .Dd June 5, 1993 .Dt PHONES 5 .Os BSD 4.2 .Sh 名称 .Nm phones .Nd リモートホストの電話番号のデータベース .Sh 解説 ファイル .Pa /etc/phones には、 .Xr tip 1 プログラムが使用する、 システム内のプライベートな電話番号が格納されます。 このファイルは通常は読めませんので、特権情報を格納することができます。 このファイルのフォーマットは、次の形式の一連の行です: <システム名>[\ \et]*<電話番号>。 システム名は .Xr remote 5 ファイルで定義されているものの 1 つであり、 電話番号は ``,'' もしくは行末で終わる任意の文字列からなります。 ``='' および ``*'' の文字は、(交換機を通す場合) 一旦停止して次のダイアルトーンを待つように自動電話機能に指示します。 ``='' は .Tn DF02-AC にて必要ですし、``*'' は .Tn BIZCOMP 1030 にて必要です。 .Pp 1 行には 1 つの電話番号のみ記述可能です。 しかしながら、ファイル中に同じシステム名が含まれる場合、 .Xr tip 1 は接続を確立するまで順番に各番号にダイアルしようとします。 .Sh 関連ファイル .Bl -tag -width /etc/phones -compact .It Pa /etc/phones .El .Sh 関連項目 .Xr tip 1 , .Xr remote 5 .Sh 歴史 .Nm ファイルは .Bx 4.2 に登場しました。 diff --git a/ja_JP.eucJP/man/man5/printcap.5 b/ja_JP.eucJP/man/man5/printcap.5 index dc1044186e..7b2647f8d4 100644 --- a/ja_JP.eucJP/man/man5/printcap.5 +++ b/ja_JP.eucJP/man/man5/printcap.5 @@ -1,279 +1,279 @@ .\" 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. .\" .\" @(#)printcap.5 8.2 (Berkeley) 12/11/93 .\" %Id: printcap.5,v 1.5.2.5 1998/04/28 13:49:50 danny Exp % .\" -.\" jpman $Id: printcap.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: printcap.5,v 1.3 1998/07/21 23:12:17 jsakai Stab % .Dd December 11, 1993 .Dt PRINTCAP 5 .Os BSD 4.2 .Sh 名称 .Nm printcap .Nd プリンタケーパビリティデータベース .Sh 書式 .Nm printcap .Sh 解説 .Nm printcap は、 ラインプリンタの記述に使われる .Xr termcap 5 を簡略化したものです。 スプールシステムは利用のたび毎に .Nm printcap ファイルにアクセスするため、 プリンタを動的に追加したり削除することが可能です。 データベース中の各々のエントリが、1 台のプリンタを記述するのに使われます。 .Xr termcap 5 とは異なり、このデータベースは代替できません。 これは、アカウント情報がバイパスされてしまうことがあるからです。 .Pp デフォルトのプリンタは通常 .Em lp ですが、環境変数 .Ev PRINTER によって上書きすることもできます。 各スプーリングユーティリティはオプション .Fl P Ar printer をサポートし、出力先のプリンタ名を明示することが可能です。 .Pp あるプリンタに対するデータベースをセットアップする方法の詳細については、 .%T "4.3 BSD Line Printer Spooler Manual" を参照してください。 .Sh ケーパビリティ ファイルレイアウトの解説については .Xr termcap 5 を参照してください。 .Bl -column Namexxx Typexx "/var/spool/lpdxxxxx" .Sy Name Type Default Description .It "af str" Ta Dv NULL Ta No "アカウンティングファイル名" .It "br num none lp が tty の場合、ボーレートを設定 " .Pf ( Xr ioctl 2 call) .It "cf str" Ta Dv NULL Ta No "cifplot データ用フィルタ" .It "ct num 120 TCP コネクションのタイムアウト時間(秒)" .It "df str" Ta Dv NULL Ta No "tex データ用フィルタ" .Pf ( Tn DVI フォーマット) .It "ff str" Ta So Li \ef Sc Ta No "フォームフィード送信文字" .It "fo bool false デバイスオープン時にフォームフィードを印字" .It "gf str" Ta Dv NULL Ta No "グラフデータフィルタ" .Pf ( Xr plot 3 フォーマット .It "hl bool false バーストヘッダページを最後に印刷" .It "ic bool false 字下げ出力の用の(非標準の) ioctl をサポートした ドライバ" .It "if str" Ta Dv NULL Ta No "アカウンティングを行うためのテキストフィルタ名" .It "lf str" Ta Pa /dev/console Ta No "エラーロギングファイル名" .It "lo str" Ta Pa lock Ta No "ロックファイル名" .It "lp str" Ta Pa /dev/lp Ta No "出力時にオープンするデバイス名" .It "ms str" Ta Dv NULL Ta No "lp が tty の場合、コンマで区切ったリスト。" tty モード記述用の .Xr stty 1 リストに似ている。 .It "mx num 1000 最大ファイルサイズ (" .Dv BUFSIZ ブロック単位)。0 = 制限なし。 .It "nd str" Ta Dv NULL Ta No "キューのリスト用の次のディレクトリ (未実装)" .It "nf str" Ta Dv NULL Ta No "ditroff データ用フィルタ (device independent troff)" .It "of str" Ta Dv NULL Ta No "出力用フィルタリングプログラム名" .It "pc num 200 1 フィートまたは 1 ページあたりの 費用 (1/100 セント単位)" .It "pl num 66 1 ページの行数" .It "pw num 132 1 行の文字数" .It "px num 0 ピクセル単位のページ幅 (水平方向)" .It "py num 0 ピクセル単位のページ長 (垂直方向)" .It "rf str" Ta Dv NULL Ta No "" .Tn FORTRAN 形式のテキストファイル出力用フィルタ .It "rg str" Ta Dv NULL Ta No "グループ制限。許可されたグループのメンバのみアクセスが許可される" .It "rm str" Ta Dv NULL Ta No "リモートプリンタ名" .It "rp str ``lp'' リモートプリンタ名引数" .It "rs bool false ローカルにアカウントを持つリモートユーザに対する制限" .It "rw bool false 読み書き用にオープンするプリンタデバイス名" .It "sb bool false 短いバナー (1 行のみ)" .It "sc bool false 複数コピーの抑制" .It "sd str" Ta Pa /var/spool/lpd Ta No "スプール ディレクトリ" .It "sf bool false フォームフィードの抑制" .It "sh bool false バーストページヘッダの出力抑制" .It "st str" Ta Pa status Ta No "状態ファイル名" .It "tf str" Ta Dv NULL Ta No "troff データ用フィルタ (cat phototypesetter)" .It "tr str" Ta Dv NULL Ta No "キューが空の時に印刷するトレイラ文字列" .It "vf str" Ta Dv NULL Ta No "ラスタイメージ用フィルタ" .El .Pp ローカルラインプリンタのドライバが字下げをサポートしているならば、 プリンタデーモンはその使い方を理解しなければなりません。 .Sh フィルタ .Xr lpd 8 デーモンは .Em filters のパイプラインを作成し、さまざまなタイプのプリンタ用に処理を行います。 フィルタは .Xr lpr 1 へ渡されるフラグに応じて選択されます。 パイプラインは次のように設定されます。 .Bd -literal -offset indent p pr | if 通常テキスト + pr(1) none if 通常テキスト c cf cifplot d df DVI (tex) g gf plot(3) n nf ditroff f rf Fortran t tf troff v vf ラスタイメージ .Ed .Pp .Sy if フィルタは次の引数をとります。 .Bd -filled -offset indent .Cm if .Op Fl c .Fl w Ns Ar width .Fl l Ns Ar length .Fl i Ns Ar indent .Fl n Ar login .Fl h Ar host acct-file .Ed .Pp .Fl c フラグは .Fl l フラグ (コントロール文字をそのまま通過させます) が .Xr lpr 1 に指定された場合のみ渡されます。 .Ar width 機能と .Ar length 機能はページ幅とページ長を (それぞれ .Cm pw と .Cm pl によって) 文字単位で指定します。 .Fl n と .Fl h パラメータでそれぞれのジョブの所有者のログイン名とログイン先ホスト名を 指定します。 .Ar acct-file 機能は .Nm printcap の .Cm af エントリがそのまま使われます。 .Pp .Cm if が指定されなかった場合、 .Cm of が代わりに使われます。 .Cm of は .Cm if が個々のジョブ毎にオープンされるのに対して、たった 1 回だけ オープンされると言う特徴を持っています。 そのため、アカウンティングを行うには .Cm if の方が向いています。 .Cm of には、 .Ar width と .Ar length フラグのみが与えられます。 .Pp その他の全てのフィルタは次のように呼び出されます。 .Bd -filled -offset indent .Nm filter .Fl x Ns Ar width .Fl y Ns Ar length .Fl n Ar login .Fl h Ar host acct-file .Ed .Pp .Ar width と .Ar length はピクセル単位で表され、それぞれ .Cm px と .Cm py エントリで指定されます。 .Pp 全てのフィルタはファイルを .Em stdin から読み込み .Em stdout からの出力をプリンタに送られ、 .Em stderr または .Xr syslog 3 がログ出力に使われます。 フィルタは .Dv SIGINT を無視してはいけません。 .Sh ロギング ラインプリンタプログラム自身 (つまり .Xr lpd 8 とそれに関連するプログラム) が生成したエラーメッセージは、 .Xr syslog 3 の .Dv LPR ファシリティを使ってロギングされます。 フィルタの 1 つから .Em stderr に出力されたメッセージは、対応する .Cm lf で指定されたファイルに送られます。 当然、フィルタ自身もまた .Xr syslog 8 を使うことがあるかも知れません。 .Pp コンソールに送られるエラーメッセージには、ラインフィードだけではなく キャリッジリターンとラインフィードが追加されます。 .Sh 関連項目 .Xr lpq 1 , .Xr lpr 1 , .Xr lprm 1 , .Xr hosts.lpd 5 , .Xr termcap 5 , .Xr lpc 8 , .Xr lpd 8 , .Xr pac 8 .Rs .%T "4.3 BSD Line Printer Spooler Manual" .Re .Sh 歴史 .Nm ファイルフォーマットは .Bx 4.2 から登場しました。 diff --git a/ja_JP.eucJP/man/man5/procfs.5 b/ja_JP.eucJP/man/man5/procfs.5 index 41e5071e64..17230a3e05 100644 --- a/ja_JP.eucJP/man/man5/procfs.5 +++ b/ja_JP.eucJP/man/man5/procfs.5 @@ -1,216 +1,216 @@ .\" %Id: procfs.5,v 1.2.8.4 1998/06/28 21:34:27 hoek Exp % -.\" jpman $Id: procfs.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: procfs.5,v 1.3 1998/07/03 09:09:33 mutoh Stab % .\" Written by Garrett Wollman .\" This file is in the public domain. .\" .Dd August 10, 1994 .Dt PROCFS 5 .Os BSD 4.4 .Sh 名称 .Nm procfs .Nd プロセスファイルシステム .Sh 書式 .Bd -literal proc /proc procfs rw 0 0 .Ed .Sh 解説 プロセスファイルシステム、すなわち .Nm procfs はファイルシステム中でシステムプロセステーブルの閲覧を可能にします。 .Nm procfs は通常 .Pa /proc にマウントされ、 .Xr ps 1 や .Xr w 1 といったプログラムの完全な動作に必要なものです。 .Pp .Nm は以前の .Fx 1.1 .Nm での実装とは異なり、 プロセス空間に 2 つのレベルの視点を提供します。 高いレベルでは、プロセスはそれ自身が、10 進数による先頭に 0 の付かない 自分のプロセス ID によって、名前付けされます。また .Pa curproc と呼ばれる調査要求を行なったプロセスを参照する特別なノードが存在します。 .Pp それぞれのノードは以下の項目を含むディレクトリです: .Pp それぞれのディレクトリは数個のファイルを含んでいます: .Bl -tag -width status .It Pa ctl 多様な制御操作をサポートする書き込みのみのファイル。 制御コマンドは .Pa ctl ファイルに文字列として書き込まれます。 制御コマンドは: .Bl -tag -width detach -compact .It attach 対象プロセスを停止し、 送信プロセスに対してデバッグ制御プロセスとなるよう手配する。 .It detach 対象プロセスの実行を継続し、デバッグプロセスの制御下から離します (送信プロセスである必要はありません)。 .It run シグナルが届くか、ブレークポイントに達するか、または対象プロセスが 終了するまで対象プロセスを継続して動作させます。 .It step シグナルを届けずに対象プロセスをシングルステップさせます。 .It wait 対象プロセスがデバッグに適した平衡状態になるまで待ちます。 対象プロセスは他のどのコマンドが許可されるよりも前に この状態になる必要があります。 .El .Pp 文字列は、 .Dv SIG 接頭辞なしの小文字のシグナル名でも構いません。 この場合、指定したシグナルがプロセスに届けられます。 .Pf ( Xr (sigaction 2 参照)。 .It Pa etype .Pa file 項目によって参照される実行形式のタイプ。 .It Pa file プロセステキストが読まれる vnode への参照。 これはプロセスのシンボルテーブルへのアクセスを得る、 またはプロセスのもう 1 つのコピーを始めるために使われます。 .It Pa fpregs .Pa 中の .Dv "struct fpregs" で定義される浮動小数点レジスタ。 .Pa fpregs は、汎用レジスタセットと浮動小数点レジスタセットが明確に区別されたマシンにのみ 実装されています。 .It Pa map プロセスの仮想メモリのマップ。 .It Pa mem プロセスの完全な仮想メモリイメージ。 プロセス中に存在するアドレスのみがアクセスできます。 このファイルに対する読み書きはプロセスを修正します。 テキストセグメントに対する書き込みはそのプロセスのみに留まります。 .It Pa note プロセスへシグナルを送るために使われます。実装されていません。 .It Pa notepg プロセスグループへシグナルを送るために使われます。実装されていません。 .It Pa regs プロセスのレジスタセットへの読み書き手段を提供します。 このファイルは .Pa 中で定義されている .Dv "struct regs" バイナリデータ構造体を含んでいます。 .Pa regs はプロセスが停止しているときのみ書き込みできます。 .It Pa status プロセスの状態。 このファイルは読み込みのみで、空白で分けられた以下の多数のフィールドを 含んだ 1 行を返します: .Pp .Bl -bullet -compact .It コマンド名 .It プロセス ID .It 親プロセス ID .It プロセスグループ ID .It セッション ID .It 制御端末の .Ar major,minor 、またはもし制御端末がない場合には .Dv -1,-1 。 .It プロセスフラグのリスト: .Dv ctty 制御端末がある、 .Dv sldr プロセスがセッションリーダである、 .Dv noflags 他の 2 つのフラグがセットされていない。 .It コンマで区切った秒とマイクロ秒によるプロセス開始時刻 .It コンマで区切った秒とマイクロ秒によるユーザ時間 .It コンマで区切った秒とマイクロ秒によるシステム時間 .It ウェイトチャンネルメッセージ .It 実効ユーザ ID と全てコンマで区切られた グループリスト(最初の項目は実効グループ ID) から成っている プロセスクリデンシャル .El .El .Pp 対象がデバッガによって fork/exec される通常のデバッギング環境では、 デバッガが fork し、子は自分自身で止まる(例えば自分で与えた .Dv SIGSTOP ) べきです。 親は適切な .Pa ctl ファイルを通じて .Dv wait そして .Dv attach コマンドを発行するべきです。 子プロセスは exec 呼び出しが終わった直後に .Dv SIGTRAP を受け取ります .Pf ( Xr execve 2 参照)。 .Pp それぞれのノードはプロセスのユーザに所持され、 ユーザのプライマリグループに属します。 .Pa mem ノードは例外的に .Li kmem グループに属します。 .Sh 関連ファイル .Bl -tag -width /proc/curproc/XXXXXXX -compact .It Pa /proc .Nm procfs の通常のマウントポイント。 .It Pa /proc/pid プロセス .Pa pid のプロセス情報を含んだディレクトリ .It Pa /proc/curproc カレントプロセスのプロセス情報を含んだディレクトリ .It Pa /proc/curproc/ctl プロセスへの制御メッセージを送るために使われます .It Pa /proc/curproc/etype 実行形式タイプ .It Pa /proc/curproc/file 実行形式イメージ .It Pa /proc/curproc/fpregs プロセス浮動小数点レジスタセット .It Pa /proc/curproc/map プロセスの仮想メモリマップ .It Pa /proc/curproc/mem プロセスの完全な仮想アドレス空間 .It Pa /proc/curproc/note プロセスへのシグナル送信に使われます .It Pa /proc/curproc/notepg プロセスグループへのシグナル送信に使われます .It Pa /proc/curproc/regs プロセスのレジスタセット .It Pa /proc/curproc/status プロセスの現在の状態 .El .Sh 関連項目 .Xr mount 2 , .Xr sigaction 2 , .Xr unmount 2 , .Xr mount_procfs 8 .Sh 作者 このマニュアルページは Jan-Simon Pendry によって提供された記述に基づいて Garrett Wollman によって書かれ、 後に Mike Pritchard によって手直しされました。 diff --git a/ja_JP.eucJP/man/man5/protocols.5 b/ja_JP.eucJP/man/man5/protocols.5 index 380db74917..93bec4853f 100644 --- a/ja_JP.eucJP/man/man5/protocols.5 +++ b/ja_JP.eucJP/man/man5/protocols.5 @@ -1,76 +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. .\" .\" @(#)protocols.5 8.1 (Berkeley) 6/5/93 -.\" jpman $Id: protocols.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: protocols.5,v 1.3 1998/06/17 07:52:20 kumano Stab % .\" %Id: protocols.5,v 1.1.1.1.8.1 1997/03/07 04:18:09 mpp Exp % .\" .Dd June 5, 1993 .Dt PROTOCOLS 5 .Os BSD 4.2 .Sh 名称 .Nm protocols .Nd プロトコル名のデータベース .Sh 解説 .Nm protocols ファイルには .Tn DARPA インターネットで使用される既知のプロトコルの情報が格納されます。 各プロトコル毎に、以下の情報を表す 1 行が存在します。 .Bd -unfilled -offset indent 公式なプロトコル名 プロトコル番号 別名 .Ed .Pp 項目は任意個の空白文字やタブ文字で分けられます。 ``#'' はコメント開始を表し、 行末までの文字はファイルを検索するルーチンに解釈されません。 .Pp プロトコル名は、フィールド区切り文字・改行文字・コメント文字以外の、 任意の表示可能文字からなります。 .Sh 関連ファイル .Bl -tag -width /etc/protocols -compact .It Pa /etc/protocols .Nm protocols ファイルは .Pa /etc にあります。 .El .Sh 関連項目 .Xr getprotoent 3 .Sh バグ 静的ファイルの代わりに、ネームサーバを使用すべきです。 .Sh 歴史 .Nm ファイルフォーマットは .Bx 4.2 に登場しました。 diff --git a/ja_JP.eucJP/man/man5/pw.conf.5 b/ja_JP.eucJP/man/man5/pw.conf.5 index 26084e81bf..717fee09b6 100644 --- a/ja_JP.eucJP/man/man5/pw.conf.5 +++ b/ja_JP.eucJP/man/man5/pw.conf.5 @@ -1,283 +1,283 @@ .\" 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.conf.5,v 1.1.1.1.2.5 1997/12/25 09:35:59 hoek Exp % -.\" jpman $Id: pw.conf.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: pw.conf.5,v 1.3 1998/07/02 18:49:55 kumano Stab % .\" .Dd December 9, 1996 .Dt PW.CONF 5 .Os .Sh 名称 .Nm pw.conf .Nd pw.conf 設定ファイルのフォーマット .Sh 解説 ファイル .Aq Pa /etc/pw.conf には .Xr pw 8 プログラムで使用される設定データが含まれています。 .Xr pw 8 プログラムはシステムのパスワードとグループファイルのメンテナンスに使用され、 ユーザやグループを追加、削除、変更します。 このファイルは .Xr pw 8 コマンドによって .Ar useradd コマンドと .Fl D オプション を使うか、テキストエディタによって直接編集することによって変更されます。 .Pp .Aq Pa /etc/pw.conf における各行は、コメントもしくは設定データとして扱われます。 空白行と .Ql \&# 文字によって開始している行はコメントとなります。 それら以外の行はキーワードが最初に指定され、 それに対応するデータが続くものとして処理されます。 .Pp .Xr pw 8 によって認識されるキーワードには以下のものがあります。 .Bl -tag -width password_days -offset indent -compact .It defaultpasswd 新規ユーザのパスワードとなります。 .It reuseuids UID の空き番号を再使用します。 .It reusegids GID の空き番号を再使用します。 .It skeleton ホームディレクトリにコピーするデフォルトのファイルの在処です。 .It newmail 新規ユーザに送付するメールです。 .It logfile このファイルにユーザ/グループの変更のログを取ります。 .It home ホームディレクトリのルートディレクトリです。 .It shellpath シェルプログラムのパスです。 .It shells 有効なシェルのリストです (パスは含みません)。 .It defaultshell デフォルトのシェルです (パスは含みません)。 .It defaultgroup デフォルトのグループです。 .It extragroups 新規ユーザをこのグループに追加します。 .It defaultclass 新規ユーザのこのログインクラスに設定します。 .It minuid .It maxuid 有効なデフォルトユーザ ID の範囲です。 .It mingid .It maxgid 有効なデフォルトグループ ID の範囲です。 .It expire_days アカウントが期限切れとなるまでの日数です。 .It password_days パスワードが期限切れとなるまでの日数です。 .El .Pp .Ar defaultpasswd の有効な値は以下の通りです。 .Bl -tag -width password_days -offset indent -compact .It no 新規に作成したアカウントでのログインを無効にします。 .It yes パスワードをアカウント名に強制的に設定します。 .It none 強制的にパスワードをブランクにします。 .It random ランダムなパスワードを生成します。 .El .Pp 2 番目と 3 番目のオプションは安全ではなく、 一般からアクセス可能なシステムでは可能であれば避けるべきです。 最初のオプションはそのアカウントが使用される前にスーパユーザが .Xr passwd 1 を使ってパスワードを設定する必要があります。 これは管理者のアカウントを作成する場合にも便利です。 最後のオプションでは .Xr pw 8 は標準出力にランダムに生成したパスワードを出力します。 これが最も好ましく安全なオプションです。 .Xr pw 8 はファイルハンドル経由で (コマンド行による方法は安全でないためです) 新規ユーザに特定のパスワードを設定する方法も提供しています。 .Pp .Ar reuseuids と .Ar reusegids は新規のユーザ ID とグループ ID 番号の生成方法を指定します。 このフィールドで .Ql \&yes が指定されていると .Xr pw 8 は許可された範囲で 最初の使用されていないユーザ ID か グループ ID を検索します。 .Ql \&no が指定されていると 範囲中のすでに存在している他のユーザ ID もしくはグループ ID が 新規に生成された ID より必ず小さくなることを保証し、 以前にユーザもしくはグループを削除したことによって生じた グループ ID もしくはユーザ ID の空き番号を再度使用することを 避けることができます。 デフォルトグループがキーワード .Ar defaultgroup によって指定されていない場合、 .Xr pw 8 は新規ユーザに対して新規グループを生成し、 新規のユーザ ID とグループ ID に同じものを使用するように試みます。 新規ユーザのユーザ ID がすでにグループ ID として使用されている場合は、 その代わりに次に使用可能なグループ ID が選択されます。 .Pp .Ar skeleton キーワードはユーザの新規のホームディレクトリの内容を作る上での もととなるディレクトリを指定します。 デフォルトでは .Pa /usr/share/skel となっています。 .Xr pw 8 で .Fl m オプションを指定すると、ユーザのホームディレクトリが作成され、 .Ar skeleton ディレクトリに含まれるファイルがそこにコピーされます。 .Pp .Ar newmail キーワードによって送信するメッセージの本文を含むファイルの パス名を指定することによって、 新規ユーザに通知の電子メールを送信することができます。 アカウントが作成された時にメールを出さないようにするには、 このエントリを空にしておくか .Ql \&no を指定します。 .Pp .Ar logfile オプションによってパスワードファイルの変更のログを指定したログファイルに 取ることができます。 ログファイルを作成したり追加したりしないようにするには、 このフィールドを空にしておくか .Ql \&no を指定します。 .Pp .Ar home キーワードは必ず指定する必要のあるものです。 これはすべての新規ユーザのホームディレクトリが作成される ディレクトリの場所を指定するものです。 .Pp .Ar shellpath はログインシェルとして使われるプログラムが含まれる ディレクトリのリストをコロン .Ql \&: で区切って指定します。 .Pp .Ar shells キーワードはログインシェルとして使用可能なプログラムのリストを指定します。 このリストはコンマで区切られたシェル名のリストであり、パスは含みません。 これらのシェルは .Ar shellpath によって指定されているいずれかのディレクトリの中にある必要があります。 .Pp .Ar defaultshell キーワードは .Xr pw 8 のコマンド行で新規ユーザのシェルプログラムが 何も指定されていない場合のシェルプログラムを指定します。 .Pp .Ar defaultgroup キーワードは新規アカウントに使用される第 1 グループ (パスワードファイル中のグループ ID 番号) を指定します。 これが空であるか、 .Ql \&no が指定されていると各々の新規ユーザには自動的に各々のグループが 作成されます。 これはユーザによって通常使われている .Em umask に関係なく、システムの他のユーザによる不正アクセスから 各ユーザのファイルを守ることができるため、 新規にユーザを作成する場合の推奨方法となります。 .Pp .Ar extragroups によって新規ユーザを自動的に .Pa /etc/groups ファイル中のグループに登録することができます。 これはすべてのユーザがあるリソースを共有していたり、 ユーザを同じ第 1 グループに登録したい場合に便利な機能です。 .Xr pw 8 のコマンドオプションで .Fl G を使用することによって、このキーワードの効果を変更することができます。 .Pp .Ar defaultclass フィールドにより、 .Xr pw 8 によって指定されない場合に新規ユーザが割り当てられるログインクラス ( .Xr login.conf 5 参照) を指定することができます。 .Pp .Ar minuid , .Ar maxuid , .Ar mingid , .Ar maxgid の各キーワードは自動的に割り当てるユーザ ID とグループ ID 番号の 範囲を指定します。 ユーザとグループ ID のデフォルトの値は最小 1000 から最大 32000 の 範囲となります。 実際に .Xr pw 8 によってアカウントを作成する際に使用されるユーザとグループ ID は コマンド行のオプションの .Fl u と .Fl g によって変更することができます。 .Pp .Ar expire_days と .Ar password_days はそれぞれアカウントが作成された日から、 アカウントの期限が切れる日、 またはユーザがアカウントのパスワードの変更を強要される日までの 日数計算を自動的に行うために使用されます。 いずれかのフィールドで値 .Ql \&0 を指定すると、対応する (アカウントかパスワードの) 期限切れを抑止します。 .Pp .Sh 制限事項 .Pa /etc/pw.conf で 1 行は最長 1024 文字までとなります。 これより長い行についてはスキップされコメントとして扱われます。 .Sh 関連ファイル .Bl -tag -width /etc/master.passwd -compact .It Pa /etc/pw.conf .It Pa /etc/passwd .It Pa /etc/master.passwd .It Pa /etc/group .El .Sh 関連項目 .Xr passwd 1 , .Xr group 5 , .Xr login.conf 5 , .Xr passwd 5 , .Xr pw 8 diff --git a/ja_JP.eucJP/man/man5/ranlib.5 b/ja_JP.eucJP/man/man5/ranlib.5 index e21e3eb0e1..778261e603 100644 --- a/ja_JP.eucJP/man/man5/ranlib.5 +++ b/ja_JP.eucJP/man/man5/ranlib.5 @@ -1,73 +1,73 @@ .\" 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. .\" .\" @(#)ranlib.5.5 8.1 (Berkeley) 6/6/93 -.\" jpman $Id: ranlib.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: ranlib.5,v 1.3 1998/06/25 08:46:35 jsakai Stab % .\" .Dd June 6, 1993 .Dt RANLIB 5 .Os .Sh 名称 .Nm ranlib .Nd アーカイブ (ライブラリ) の目次テーブルのフォーマット .Sh 書式 .Fd #include .Sh 解説 アーカイブの目次テーブルコマンド .Nm は、オブジェクトファイルを含むアーカイブの目次テーブルを作成します。 このテーブルはリンクエディタ .Xr ld 1 が使用します。 このコマンドは、ユーティリティ .Xr ar 1 が作成したアーカイブに対して操作を行ないます。 .Pp .Nm の機能により、 3 つの部分からなる新しいファイルがアーカイブの先頭に付加されます。 最初の部分は標準のアーカイブヘッダであり、特別な名前フィールド \&"__.SYMDEF" を持ちます。 .Pp 2 番目の部分は ``long'' に ranlib 構造のリストが続きます。 long は ranlib 構造のバイトでの大きさです。 各 ranlib 構造は、 次の部分 (シンボルの文字列テーブル) への 0 を基準としたオフセットと、 シンボルを定義するアーカイブファイルへのアーカイブの先頭からのオフセット からなります。 実際の ranlib 構造の個数は、 この数値を個々の ranlib 構造の大きさで割ったものです。 .Pp 3 番目の部分は ``long'' に文字列テーブルが続きます。 long は文字列テーブルのバイト数です。 .Sh 関連項目 .Xr ar 1 , .Xr ranlib 1 diff --git a/ja_JP.eucJP/man/man5/rc.conf.5 b/ja_JP.eucJP/man/man5/rc.conf.5 index 3fe1058b7c..c8cf62d30b 100644 --- a/ja_JP.eucJP/man/man5/rc.conf.5 +++ b/ja_JP.eucJP/man/man5/rc.conf.5 @@ -1,880 +1,880 @@ .\" Copyright (c) 1995 .\" Jordan K. Hubbard .\" .\" 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 ``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: rc.conf.5,v 1.1.2.11 1998/06/27 21:23:28 steve Exp % .\" -.\" jpman $Id: rc.conf.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: rc.conf.5,v 1.3 1998/06/26 09:39:58 jsakai Stab % .\" .Dd April 26, 1997 .Dt RC.CONF 5 .Os FreeBSD 2.2.2 .Sh 名称 .Nm rc.conf .Nd ローカルコンフィギュレーションの情報 .Sh 解説 .Nm rc.conf ファイルはローカルホスト名、全ての潜在的なネットワークインタフェースに 関するコンフィギュレーションの詳細、システムの初期起動時に立ち上げるべき サービスに関する記述可能な情報を含んできます。初めてインストールする際に は、一般に .Nm rc.conf ファイルはシステムインストールユーティリティ .Pa /stand/sysinstall によって初期化されます。 .Pp ローカルホスト上で変化が生じるたびにこのファイルを適切に保守することはシ ステム管理者の仕事です。 .Sh 関連ファイル .Bl -tag -width /etc/rc.conf -compact .It Pa /etc/rc.conf .El .Sh 解説 .Nm の目的は、 コマンドの実行やシステム起動操作を直接行うことではありません。 それに代わり、 そこに見出される設定にしたがって内部操作を条件付きで制御する .Pa /etc 下のいろいろな類の起動スクリプトの一部をなしています。 .Pp 以下に示すのは .Nm ファイル中で設定可能な各変数について、 その名前と簡単な解説をリストしたものです。 .Bl -tag -width Ar .It Ar swapfile (文字列) .Ar NO にセットすると スワップファイルはインストールされません。 .Ar NO 以外の場合、その値は追加スワップ領域のために利用するファイルの 完全パス名として用いられます。 .It Ar apm_enable (ブール値) .Ar YES にセットすると .Xr apm 8 コマンドでの自動電源管理(Automatic Power Management)のサポートを有効に します。 .It Ar pccard_enable (ブール値) .Ar YES にセットすると起動時にPCCARDのサポートを有効にします。 .It Ar pccard_mem (文字列) PCCARDコントローラメモリアドレスをセットします。 .Ar DEFAULT とするとデフォルト値になります。 .It Ar pccard_ifconfig (文字列) 挿入または起動時に動的にifconfigされるべきイーサネットデバイス のリストです。 (例 .Ar "ed0 ed1 ep0 ..." ) .It Ar local_startup (文字列) 起動スクリプトファイルを検索するためのディレクトリのリストです。 .It Ar hostname (文字列) ネットワーク上でのあなたのホストの完全な形のドメイン名 (The Fully Qualified Domain Name) です。あなたがネットワークに接続されていない 場合でも、この変数は確実に何か意味のあるものに設定すべきです。 .It Ar nisdomainname (文字列) あなたのホストの NIS ドメイン名。NIS が動いてないときは .Ar NO とします。 .It Ar firewall_enable (ブール値) 起動時にロードされるファイアウォール規則を持ちたくないときには .Ar NO 、持ちたいときには .Ar YES をセットします。 .Ar YES にセットし、かつカーネルが IPFIREWALL 付きで作られなかった場合、 ipfw カーネルモジュールがロードされます。 .It Ar firewall_type (文字列) .Pa /etc/rc.firewall 中で選択されたファイアウォールのタイプまたはローカルファイアウォール規則 の組を含むファイルを名付けます。 .Pa /etc/rc.firewall 中では以下のものが選択可能です: ``open''- 無制限の IP アクセス; ``closed''- lo0 経由を除く全ての IP サービスを禁止; ``client''- ワークステーション向けの基本的な保護; ``simple''- LAN 向けの基本的な保護。 ファイル名が指定される場合には完全なパス名でなければなりません。 .It Ar firewall_quiet (ブール値) .Ar YES にセットすると起動時にコンソール上で ipfw 規則の表示を行ないません。 .It Ar natd_enable (ブール値) .Ar YES にセットすると natd を有効にします。 .Ar firewall_enable もまた .Ar YES にセットされ、 .Xr divert 4 ソケットがカーネルで有効にされている必要があります。 .It Ar natd_interface natd が実行されるパブリックインタフェースの名前です。 .Ar natd_enable が .Ar YES にセットされている場合には、これを設定する必要があります。 .It Ar natd_flags 追加の natd フラグはここに記述する必要があります。 .Fl n フラグは上記 .Ar natd_interface とともに自動的に引数として追加されます。 .It Ar tcp_extensions (ブール値) デフォルトでは .Ar YES です。これは RFC 1323 や 1644 で述べられているような ある TCP オプションを有効にします。 もしネットワークコネクションが不規則にハングアップしたり、 それに類する他の不具合がある場合には、これを .Ar NO にセットして様子をみてみるのもよいかもしれません。世間に出回っている ハードウェア/ソフトウェアの中には、これらのオプションでうまく動作しない ものがあることが知られています。 .It Ar network_interfaces (文字列) このホスト上で形成されるネットワークインタフェースのリストを 設定します。 たとえば、ループバックデバイス (標準) および SMC Elite Ultra NIC があるなら .Qq Ar "lo0 ed0" という 2 つのインタフェースを設定します。 .Em interface の各値に対して .No ifconfig_ Ns Em interface という変数が存在すると仮定されます。 1 つのインタフェースに複数の IP アドレスを登録したい場合は、 ここに IP エイリアスのエントリを追加することも可能です。 対象とするインタフェースが ed0 であると仮定すると、 .Bd -literal ifconfig_ed0_alias0="inet 127.0.0.253 netmask 0xffffffff" ifconfig_ed0_alias1="inet 127.0.0.254 netmask 0xffffffff" .Ed というようになります。 見つかった各 ifconfig__alias エントリについて、 その内容が .Xr ifconfig 8 に渡されます。最初にアクセスに失敗した時点で実行は中止されるので .Bd -literal ifconfig_ed0_alias0="inet 127.0.0.251 netmask 0xffffffff" ifconfig_ed0_alias1="inet 127.0.0.252 netmask 0xffffffff" ifconfig_ed0_alias2="inet 127.0.0.253 netmask 0xffffffff" ifconfig_ed0_alias4="inet 127.0.0.254 netmask 0xffffffff" .Ed のようにすると、alias4 は追加され\fB ない\fR ことに注意してください。これは alias3 エントリを抜かしたことで検索が中止されるからです。 .It Ar syslogd_enable (ブール値) .Ar YES にセットすると .Xr syslogd 8 デーモンを起動します。 .It Ar syslogd_flags (文字列) syslogd_enable が .Ar YES の場合、これらは .Xr syslogd 8 に渡すフラグになります。 .It Ar inetd_enable (ブール値) .Ar YES にセットすると .Xr inetd 8 デーモンを起動します。 .It Ar inetd_flags (文字列)inetd_enable が .Ar YES の場合、これらは .Xr inetd 8 へ渡すフラグとなります。 .It Ar named_enable (ブール値) .Ar YES にセットすると .Xr named 8 デーモンを起動します。 .It Ar named_program (文字列) .Xr named 8 のパス。(デフォルトは .Pa /usr/sbin/named ) .It Ar named_flags (文字列) .Ar named_enable が .Ar YES の場合、これらは .Xr named 8 に渡すフラグとなります。 .It Ar kerberos_server_enable (ブール値) ブート時に Kerberos 認証サーバを起動したい場合は .Ar YES にセットします。 .It Ar kadmind_server_enable .Xr kadmind 8 (Kerberos 管理デーモン) を実行したい場合は .Ar YES とします。スレーブサーバ上では .Ar NO にセットします。 .It Ar kerberos_stash (文字列) .Ar YES なら (唯一 .Ar kerberos_server_enable が .Ar YES にセットされ、かつ .Xr kerberos 1 および .Xr kadmind 8 の両方を用いるときにのみ) 隠されたマスタキーのプロンプト入力を行なう代りに、 そのキーを用いるよう Kerberos サーバに指示します。 .It Ar rwhod_enable (ブール値) .Ar YES にセットするとブート時に .Xr rwhod 8 デーモンを起動します。 .It Ar amd_enable (ブール値) .Ar YES にセットするとブート時に .Xr amd 8 デーモンを起動します。 .It Ar amd_flags (文字列) .Ar amd_enable が .Ar YES にセットされている場合、これらは amd に渡すフラグとなります。 詳しくは\fBinfo amd\fR コマンドを利用してください。 .It Ar nfs_client_enable (ブール値) .Ar YES にセットするとブート時に NFS クライアントデーモンを起動します。 .It Ar nfs_client_flags (文字列) .Ar nfs_client_enable が .Ar YES の場合、これらは .Xr nfsiod 8 デーモンに渡すフラグとなります。 .It Ar nfs_server_enable (ブール値) .Ar YES にセットするとブート時に NFS サーバデーモンを起動します。 .It Ar nfs_server_flags (文字列) .Ar nfs_server_enable が .Ar YES の場合、これらは .Xr nfsd 8 デーモンに渡すフラグとなります。 .It Ar weak_mountd_authentication (ブール値) .Ar YES にセットすると、権限付けられていないマウント要求を行なうために \fBPCNFSD\fR のようなサービスを許可します。 .It Ar nfs_reserved_port_only (ブール値) .Ar YES にセットすると、安全なポート上でのみ NFS サービスを提供します。 .It Ar rcp_lockd_enable (ブール値) この変数が .Ar YES にセットされ、しかも NFS サーバである場合、ブート時に .Xr rpc.lockd 8 を起動します。 .It Ar rcp_statd_enable (ブール値) この変数が .Ar YES にセットされ、しかも NFS サーバである場合、ブート時に .Xr rpc.statd 8 を起動します。 .It Ar portmap_enable (ブール値) .Ar YES の場合、ブート時に .Xr portmap 8 サービスを起動します。 .It Ar portmap_flags (文字列) .Ar portmap_enable が .Ar YES の場合、これらは .Xr portmap 8 デーモンに渡すフラグとなります。 .It Ar xtend_enable (ブール値) .Ar YES にセットすると、ブート時に .Xr xtend 8 デーモンを起動します。 .It Ar xtend_flags (文字列) .Ar xtend_enable が .Ar YES の場合、これらは .Xr xtend 8 デーモンに渡すフラグとなります。 .It Ar timed_enable (ブール値) .Ar YES なら、ブート時に .Xr timed 8 サービスを実行します。このコマンドは、全ホストについて一貫した .Qq "ネットワーク時間" が確立されなければならないマシンネットワークのためにあります。 これが有用である典型例は、 ファイルのタイムスタンプがネットワークワイドで一貫性をもつことが 期待されるような、大規模 NFS 環境です。 .It Ar timed_flags (文字列) .Ar timed_enable が .Ar YES の場合、これらは .Xr timed 8 サービスに渡すフラグとなります。 .It Ar ntpdate_enable (ブール値) .Ar YES にセットすると、システムスタートアップ時に ntpdate を実行します。 このコマンドは、ある標準的な参照先を元に、ただ .Ar 1 回 だけシステム時刻を同期させるためにあります。 また、システムを最初にインストールする際、 これを (知られているサービスのリストから) 最初にセットアップするオプションが .Pa /stand/sysinstall プログラムによって提供されます。 .It Ar ntpdate_program (文字列) .Xr ntpdate 8 のパス (デフォルトは .Pa /usr/sbin/ntpdate です)。 .It Ar ntpdate_flags (文字列) .Ar ntpdate_enable が .Ar YES の場合、これらは .Xr ntpdate 8 コマンドに渡すフラグとなります (典型的にはホスト名)。 .It Ar xntpd_enable (ブール値) .Ar YES にセットすると、ブート時に .Xr xntpd 8 コマンドが起動されます。 .It Ar xntpd_program (文字列) .Xr xntpd 8 のパス (デフォルトは .Pa /usr/sbin/xntpd です)。 .It Ar xntpd_flags (文字列) .Ar xntpd_enable が .Ar YES の場合、これらは .Xr xntpd 8 デーモンに渡すフラグとなります。 .It Ar tickadj_enable (ブール値) .Ar YES にセットすると、システムブート時に .Xr tickadj 8 コマンドを実行します。 .It Ar tickadj_flags (文字列) .Ar tickadj_enable が .Ar YES の場合、これらは .Xr tickadj 8 コマンドに渡すフラグとなります。 .It Ar nis_client_enable (ブール値) .Ar YES にセットすると、システムブート時に .Xr ypbind 8 サービスを起動します。 .It Ar nis_client_flags (文字列) .Ar nis_client_enable が .Ar YES の場合、これらは .Xr ypbind 8 サービスに渡すフラグとなります。 .It Ar nis_ypset_enable (ブール値) .Ar YES にセットすると、システムブート時に .Xr ypset 8 デーモンを起動します。 .It Ar nis_ypset_flags (文字列) .Ar nis_ypset_enable が .Ar YES の場合、これらは .Xr ypset 8 デーモンに渡すフラグとなります。 .It Ar nis_server_enable (ブール値) .Ar YES にセットすると、システムブート時に .Xr ypserv 8 デーモンを起動します。 .It Ar nis_server_flags (文字列) .Ar nis_server_enable が .Ar YES の場合、これらは .Xr ypserv 8 デーモンに渡すフラグとなります。 .It Ar nis_ypxfrd_enable (ブール値) .Ar YES にセットすると、システムブート時に .Xr ypxfrd 8 デーモンを起動します。 .It Ar nis_ypxfrd_flags (文字列) .Ar nis_ypxfrd_enable が .Ar YES の場合、これらは .Xr ypxfrd 8 デーモンに渡すフラグとなります。 .It Ar nis_yppasswdd_enable (ブール値) .Ar YES にセットすると、システムブート時に .Xr yppasswdd 8 デーモンを起動します。 .It Ar nis_yppasswdd_flags (文字列) .Ar nis_yppasswdd_enable が .Ar YES の場合、これらは .Xr yppasswdd 8 デーモンに渡すフラグとなります。 .It Ar defaultrouter (文字列) .Ar NO をセットしないと、このホスト名または IP アドレスへのデフォルトルートを 作成します (このルータがネームサーバへたどりつく必要がある 場合は IPアドレスを使用すること!)。 .It Ar static_routes (文字列) システムブート時に追加したいスタティックルートのリストを セットします。 .Ar NO 以外をセットした場合、その値を空白で区切った各要素について、 各 .Em element 毎に変数 .No route_ Ns em element が存在すると仮定され、その後、``route add'' 操作に渡されます。 .It Ar gateway_enable (ブール値) .Ar YES にセットすると、IP ルータとして動作する、 たとえばインタフェース間でパケットをフォワードするように ホストを設定します。 .It Ar router_enable (ブール値) .Ar YES にセットすると、 .Ar router および .Ar router_flags の設定に基づいて、ある種のルーティングデーモンを実行します。 .It Ar router (文字列) .Ar router_enable が .Ar YES にセットされると、これが使用するルーティングデーモン名になります。 .It Ar router_flags (文字列) .Ar router_enable が .Ar YES にセットされると、これらがルーティングデーモンへ渡すフラグとなります。 .It Ar mrouted_enable (ブール値) .Ar YES にセットすると、マルチキャストルーティングデーモン .Xr mrouted 8 を起動します。 .It Ar mrouted_flags (文字列) .Ar mrouted_enable が .Ar YES の場合、これらはマルチキャストルーティングデーモンへ渡すフラグとなります。 .It Ar ipxgateway_enable (ブール値) .Ar YES にセットすると、IPX トラフィックのルーティングを有効にします。 .It Ar ipxrouted_enable (ブール値) .Ar YES にセットすると、ブート時に .Xr ipxrouted 8 デーモンを起動します。 .It Ar ipxrouted_flags (文字列) .Ar ipxrouted_enable が .Ar YES の場合、これらは .Xr ipxrouted 8 デーモンへ渡すフラグとなります。 .It Ar arpproxy_all .Ar YES にセットするとグローバルプロキシ ARP を有効にします。 .It Ar forward_sourceroute これが .Ar YES にセットされ、更に .Ar gateway_enable もまた .Ar YES にセットされている場合、 送信元が経路指定したパケット (source routed packets) はフォワードされます。 .It Ar accept_sourceroute .Ar YES にセットすると、 システムは自分宛の送信元経路指定パケットを受け付けます。 .It Ar rarpd_enable (ブール値) .Ar YES にセットすると、システムブート時に .Xr rarpd 8 デーモンを起動します。 .It Ar rarpd_flags (文字列) .Ar rarpd_enable が .Ar YES の場合、これらは .Xr rarpd 8 デーモンへ渡すフラグとなります。 .It Ar keymap (文字列) .Ar NO にセットするとキーマップはインストールされません。それ以外の場合、 ここで指定した .Ar value がキーマップファイル .Pa /usr/share/syscons/keymaps/.kbd をインストールするのに用いられます。 .It Ar keyrate (文字列) キーボードのリピートスピードです。以下のいずれかにセットします。 .Ar slow , .Ar normal , .Ar fast デフォルト値を希望する場合は .Ar NO とします。 .It Ar keychange (文字列) .Ar NO 以外にセットすると、その値でファンクションキーをプログラムしようとします。 指定できる値は単一の文字列で, .Qq Ar " [ ]..." という形式でないといけません。 .It Ar cursor (文字列) カーソルの動作を明示的に指定する場合は .Ar normal , .Ar blink , .Ar destructive のいずれかの値にセットします。デフォルト動作を選ぶには .Ar NO とします。 .It Ar scrnmap (文字列) .Ar NO にセットすると、スクリーンマップはインストールされません。 それ以外の場合には、ここで指定した .Ar value がスクリーンマップファイル .Pa /usr/share/syscons/scrnmaps/ をインストールするのに用いられます。 .It Ar font8x16 (文字列) .Ar NO にセットするとスクリーンサイズの要求に対しデフォルトの 8x16 フォント値が 用いられます。それ以外の場合は .Pa /usr/share/syscons/fonts/ の値が用いられます。 .It Ar font8x14 (文字列) .Ar NO にセットするとスクリーンサイズの要求に対しデフォルトの 8x14 フォント値が 用いられます。それ以外の場合は .Pa /usr/share/syscons/fonts/ の値が用いられます。 .It Ar font8x8 (文字列) .Ar NO にセットすると、スクリーンサイズの要求に対しデフォルトの 8x8 フォント値が 用いられます。それ以外の場合は .Pa /usr/share/syscons/fonts/ の値が用いられます。 .It Ar blanktime (整数) .Ar NO にセットすると、デフォルトのスクリーンブランク時間間隔が用いられます。 それ以外の場合は .Ar value 秒にセットされます。 .It Ar saver (文字列) .Ar NO 以外にセットすると、これが実際に使用する スクリーンセーバ (ブランク, 蛇, デーモンなど) となります。 .It Ar moused_enable (文字列) .Ar YES にセットすると、コンソール上でのカット/ペーストセレクション用に .Xr moused 8 デーモンが起動されます。 .It Ar moused_type (文字列) 利用したいマウスのプロトコルのタイプ。 .Ar moused_enable が .Ar YES の場合、この変数は必ず設定しなければなりません。 多くの場合、 .Xr moused 8 デーモンは適切なマウスタイプを自動的に検出することができます。 デーモンにマウスを検出させるには、この変数を .Ar auto にセットします。 自動検出が失敗する場合、以下のリストから 1 つを選びます。 .Bd -literal microsoft Microsoft マウス intellimouse Microsoft IntelliMouse mousesystems Mouse system 社製のマウス mmseries MM シリーズのマウス logitech Logitech 製のマウス busmouse バスマウス mouseman Logitech の MouseMan および TrackMan glidepoint ALPS 製の GlidePoint thinkingmouse Kensignton 製の ThinkingMouse ps/2 PS/2 マウス mmhittab MM の HitTablet .Ed お使いのマウスが上記のリストにない場合でも、 リスト中のいずれかと互換性があるかも知れません。 互換性に関する情報については .Xr moused 8 のマニュアルページを参照してください。 .Pp また、 この変数が有効であるときは、(Xサーバのような) 他の全てのマウスクライアントは 仮想マウスデバイス .Pa /dev/sysmouse を通してマウスにアクセスし、 それを sysmouse タイプのマウスとして構成すべきであると いうことにも注意すべきです。これは、 .Xr moused 8 使用時は、全てのマウスデータがこの単一の標準フォーマットに変換されるためです。 クライアントプログラムが sysmouse タイプを サポートしないなら次に望ましいタイプとして mousesystems を指定してください。 .It Ar moused_port (文字列) .Ar moused_enable が .Ar YES の場合、これはマウスが接続されている実際のポートになります。 たとえば、COM1 シリアルマウスに対しては .Pa /dev/cuaa0 、PS/2 マウスに対しては .Pa /dev/psm0 、バスマウスに対しては .Pa /dev/mse0 となります。 .It Ar moused_flags (文字列) .Ar moused_type がセットされている場合、これらは .Xr moused 8 デーモンに渡す追加のフラグとなります。 .It Ar cron_enable (ブール値) .Ar YES にセットすると、システムブート時に .Xr cron 8 デーモンを起動します。 .It Ar lpd_enable (ブール値) .Ar YES にセットすると、システムブート時に .Xr lpd 8 デーモンを起動します。 .It Ar lpd_flags (文字列) .Ar lpd_enable が .Ar YES の場合、これらは .Xr lpd 8 デーモンに渡すフラグとなります。 .It Ar sendmail_enable (ブール値) .Ar YES にセットすると、システムブート時に .Xr sendmail 8 デーモンを起動します。 .It Ar sendmail_flags (文字列) .Ar sendmail_enable が .Ar YES の場合、これらは .Xr sendmail 8 デーモンに渡すフラグとなります。 .It Ar savecore_enable (ブール値) .Ar YES にセットすると、クラッシュ後システムが復旧するとき、デバッグ用にカーネル のクラッシュダンプを保存します。クラッシュイメージは通常 .Pa /var/crash ディレクトリに格納されます。 .It Ar dumpdev (文字列) .Ar NO にセットしないと、カーネルクラッシュダンプ出力先を .Em value で指定したスワップデバイスに向けます。 .It Ar check_quotas (ブール値) .Xr quotacheck 8 コマンドによってユーザディスクのクォータチェックを有効にしたいなら、 .Ar YES にセットします。 .It Ar accounting_enable (ブール値) .Xr accton 8 ファシリティでシステムアカウンティングを有効にしたいなら .Ar YES にセットします。 .It Ar ibcs2_enable (ブール値) システム初期ブート時に iBCS2 (SCO) バイナリエミュレーションを有効にしたいなら .Ar YES にセットします。 .It Ar linux_enable (ブール値) システムブート時に Linux/ELF バイナリエミュレーションを有効にしたいなら .Ar YES にセットします。 .It Ar rand_irqs (文字列) 乱数生成用に監視する IRQ のリストをセットします ( .Xr rndcontrol 8 のマニュアル参照)。 .It Ar clear_tmp_enable (ブール値) 起動時に .Pa /tmp 下を消去したいなら .Ar YES をセットします。 .It Ar ldconfig_paths (文字列) .Xr ldconfig 8 で使用する共有ライブラリのパスのリストをセットします。注意: .Pa /usr/lib は常に先頭に追加されるので、このリストに指定する必要はありません。 .Sh 関連項目 .Xr gdb 1 , .Xr info 1 , .Xr exports 5 , .Xr accton 8 , .Xr amd 8 , .Xr apm 8 , .Xr cron 8 , .Xr gated 8 , .Xr ifconfig 8 , .Xr inetd 8 , .Xr lpd 8 , .Xr moused 8 , .Xr mrouted 8 , .Xr named 8 , .Xr nfsd 8 , .Xr nfsiod 8 , .Xr ntpdate 8 , .Xr pcnfsd 8 , .Xr portmap 8 , .Xr quotacheck 8 , .Xr rc 8 , .Xr rndcontrol 8 , .Xr route 8 , .Xr routed 8 , .Xr rpc.lockd 8 , .Xr rpc.statd 8 , .Xr rwhod 8 , .Xr sendmail 8 , .Xr syslogd 8 , .Xr swapon 8 , .Xr tickadj 8 , .Xr timed 8 , .Xr vnconfig 8 , .Xr xntpd 8 , .Xr xtend 8 , .Xr ypbind 8 , .Xr ypserv 8 , .Xr ypset 8 .Sh 歴史 .Nm ファイルは .Fx 2.2.2 で登場しました。 .Sh 作者 Jordan K. Hubbard. diff --git a/ja_JP.eucJP/man/man5/rcsfile.5 b/ja_JP.eucJP/man/man5/rcsfile.5 index da1735d812..2f19c9f8e1 100644 --- a/ja_JP.eucJP/man/man5/rcsfile.5 +++ b/ja_JP.eucJP/man/man5/rcsfile.5 @@ -1,426 +1,426 @@ -.\" jpman $Id: rcsfile.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: rcsfile.5,v 1.3 1998/06/17 07:53:51 kumano Stab % .\" FreeBSD jpman project 訳語表 .\" WORD: phrase 句 .\" WORD: meta syntax メタ文法 .\" WORD: altanatives 選言 .\" WORD: trunk 幹 .\" WORD: branch 枝 .\" WORD: branch point 分岐点 .\" WORD: numebr (RCSのリビジョン番号1.1, 1.2.2.1等を意味する時は) 番号 .lf 1 ./rcsfile.5in .\" Set p to 1 if your formatter can handle pic output. .if t .nr p 1 .de Id .ds Rv \\$3 .ds Dt \\$4 .. .Id %Id: rcsfile.5,v 1.2 1995/10/28 21:50:16 peter Exp % .ds r \s-1RCS\s0 .if n .ds - \%-- .if t .ds - \(em .TH RCSFILE 5 \*(Dt GNU .SH 名称 rcsfile \- RCS ファイルの書式 .SH 解説 \*r ファイルの内容は以下の文法に基づき記述されます。 .PP テキストはフリーフォーマットであり、 文字列中のスペース、バックスペース、 タブ、改行、垂直タブ、改頁、復帰 (まとめて .IR "空白" と呼びます) は意味を持ちません。 例外として、id, num, sym 内では空白があってはならず、 \*r ファイルは改行で終わらなければなりません。 .PP 文字列は .BR @ で括られます。文字列が .BR @ 自身を含む場合、2 重化されなければならず、それ以外は任意の バイナリデータを含むことができます。 .PP 以下、簡便のためにメタ文法を用います。 `|' (縦棒) は選言を分けます。 `{' と `}' は省略可能な句を括ります。 `{' と `}*' は 0 回以上繰り返される句を括ります。 `{' と `}+' は 1 回以上繰り返される句を括ります。 終端記号は .BR 太字 で、非終端記号は .IR 斜体 で表記します。 .LP .nr w \w'\f3deltatext\fP ' .nr y \w'\f3newphrase\fP ' .if \nw<\ny .nr w \ny .nr x \w'\f3branches\fP' .nr y \w'{ \f3comment\fP' .if \nx<\ny .nr x \ny .nr y \w'\f3{ branch\fP' .if \nx<\ny .nr x \ny .ta \nwu +\w'::= 'u +\nxu+\w' 'u .fc # .nf \f2rcstext\fP ::= \f2admin\fP {\f2delta\fP}* \f2desc\fP {\f2deltatext\fP}* .LP \f2admin\fP ::= \f3head\fP {\f2num\fP}\f3;\fP { \f3branch\fP {\f2num\fP}\f3;\fP } \f3access\fP {\f2id\fP}*\f3;\fP \f3symbols\fP {\f2sym\fP \f3:\fP \f2num\fP}*\f3;\fP \f3locks\fP {\f2id\fP \f3:\fP \f2num\fP}*\f3;\fP {\f3strict ;\fP} { \f3comment\fP {\f2string\fP}\f3;\fP } { \f3expand\fP {\f2string\fP}\f3;\fP } { \f2newphrase\fP }* .LP \f2delta\fP ::= \f2num\fP \f3date\fP \f2num\fP\f3;\fP \f3author\fP \f2id\fP\f3;\fP \f3state\fP {\f2id\fP}\f3;\fP \f3branches\fP {\f2num\fP}*\f3;\fP \f3next\fP {\f2num\fP}\f3;\fP { \f2newphrase\fP }* .LP \f2desc\fP ::= \f3desc\fP \f2string\fP .LP \f2deltatext\fP ::= \f2num\fP \f3log\fP \f2string\fP { \f2newphrase\fP }* \f3text\fP \f2string\fP .LP \f2num\fP ::= {\f2digit\fP | \f3.\fP}+ .LP \f2digit\fP ::= \f30\fP | \f31\fP | \f32\fP | \f33\fP | \f34\fP | \f35\fP | \f36\fP | \f37\fP | \f38\fP | \f39\fP .LP \f2id\fP ::= {\f2num\fP} \f2idchar\fP {\f2idchar\fP | \f2num\fP}* .LP \f2sym\fP ::= {\f2digit\fP}* \f2idchar\fP {\f2idchar\fP | \f2digit\fP}* .LP \f2idchar\fP ::= \f2special\fP を除く任意の可視文字 (visible graphic character) .LP \f2special\fP ::= \f3$\fP | \f3,\fP | \f3.\fP | \f3:\fP | \f3;\fP | \f3@\fP .LP \f2string\fP ::= \f3@\fP{任意の文字、ただし \f3@\fP は 2 重化される}*\f3@\fP .LP \f2newphrase\fP ::= \f2id\fP \f2word\fP* \f3;\fP .LP \f2word\fP ::= \f2id\fP | \f2num\fP | \f2string\fP | \f3:\fP .fi .PP 識別子は大文字小文字を区別します。 キーワードは小文字のみです。 キーワードと識別子の集合は重複可能です。 ほとんどの環境では、\*r は \s-1ISO\s0 8859/1 エンコーディングを用います。 このコードでは、可視文字のコードが 041\-176 と 240\-377 で、 空白文字のコードが 010\-015 と 040 です。 .PP .B date キーワードの後に現れる日時は \f2Y\fP\f3.\fP\f2mm\fP\f3.\fP\f2dd\fP\f3.\fP\f2hh\fP\f3.\fP\f2mm\fP\f3.\fP\f2ss\fP という書式で、それぞれ .I Y が年を、 .I mm が月 (01\-12) を、 .I dd が日 (01\-31) を、 .I hh が時 (00\-23) を、 .I mm が分 (00\-59) を、 .I ss が秒 (00\-60) を表します。 .I Y は 1900 年から 1999 年までは年の最後の 2 桁で表し、それ以降は 年のすべての桁で表します。 日付はグレゴリオ暦を用い、時刻は UTC (世界標準時) で表します。 .PP 文法中の .I newphrase は \*r ファイル書式の今後の拡張のために予約されています。 すでに使われているキーワードでは .I newphrase は始まりません。 .PP 複数の .I delta ノードが集まって、木を形成します。 単一の組からなる番号のノード (例えば 2.3, 2.1, 1.3 など) は すべて幹 (trunk) であり、降順で .B next フィールドを通してリンクされています。 .I admin ノードの .B head フィールドは、このシーケンスの先頭 (head; すなわち最高位の組) を示します。 admin ノードの .B branch ノードは、 ほとんどの \*r 操作が利用するデフォルトの枝 (もしくはリビジョン) を示します。 もしこれが存在しなければ、幹の最高位の枝が用いられます。 .PP .RI 2 n 個 .RI ( n \(>=2) のフィールドからなる番号を持つ全 .I delta ノード (例えば 3.1.1.1, 2.1.2.2 など) は、次のようにリンクされます。 すなわち、先頭の .RI 2 n \-1 個のフィールドの番号が等しい全ノードは、昇順で .B next フィールドを通してリンクされます。 シーケンス中の delta ノードの番号の先頭 .RI 2 n \-2 個分と等しい番号を持つ .I delta ノードは、そのシーケンスの分岐点と呼ばれます。 ノードの .B branches フィールドは、 そのノードが分岐点となっている全シーケンスに対し、 最初のノード番号のリストを保持しています。 このリストは昇順で並べられています。 .LP 以下の図は \*r ファイルの構成の例を示しています。 .if !\np \{\ .nf .vs 12 .ne 36 .cs 1 20 .eo Head | | v / \ --------- / \ / \ / \ | | / \ / \ / \ / \ | 2.1 | / \ / \ / \ / \ | | / \ / \ /1.2.1.3\ /1.3.1.1\ | | /1.2.2.2\ /1.2.2.1.1.1\ --------- --------- --------- --------- ------------- ^ ^ | ^ ^ | | | | | | | v | | / \ | --------- / \ | / \ | \ 1.3 / / \ | / \ ---------\ / / \----------- /1.2.1.1\ \ / /1.2.2.1\ --------- \ / --------- ^ | ^ | | | | v | | --------- | | \ 1.2 / | ----------------------\ /--------- \ / \ / | | v --------- \ 1.1 / \ / \ / \ / .ec .cs 1 .vs .fi .\} .if \np \{\ .lf 232 .PS 4.250i 3.812i .\" -2.0625 -4.25 1.75 0 .\" 0.000i 4.250i 3.812i 0.000i .nr 00 \n(.u .nf .nr 0x 1 \h'3.812i' .sp -1 .lf 242 \h'2.062i-(\w'Head'u/2u)'\v'0.125i-(0v/2u)+0v+0.22m'Head .sp -1 \h'2.062i'\v'0.250i'\D'l0.000i 0.500i' .sp -1 \h'2.087i'\v'0.650i'\D'l-0.025i 0.100i' .sp -1 \h'2.062i'\v'0.750i'\D'l-0.025i -0.100i' .sp -1 \h'1.688i'\v'1.250i'\D'l0.750i 0.000i' .sp -1 \h'2.438i'\v'1.250i'\D'l0.000i -0.500i' .sp -1 \h'2.438i'\v'0.750i'\D'l-0.750i 0.000i' .sp -1 \h'1.688i'\v'0.750i'\D'l0.000i 0.500i' .sp -1 .lf 244 \h'2.062i-(\w'2.1'u/2u)'\v'1.000i-(0v/2u)+0v+0.22m'2.1 .sp -1 \h'2.062i'\v'1.250i'\D'l0.000i 0.500i' .sp -1 \h'2.087i'\v'1.650i'\D'l-0.025i 0.100i' .sp -1 \h'2.062i'\v'1.750i'\D'l-0.025i -0.100i' .sp -1 .lf 246 \h'2.062i-(\w'1.3'u/2u)'\v'2.000i-(1v/2u)+0v+0.22m'1.3 .sp -1 \h'2.062i'\v'2.250i'\D'l-0.375i -0.500i' .sp -1 \h'1.688i'\v'1.750i'\D'l0.750i 0.000i' .sp -1 \h'2.438i'\v'1.750i'\D'l-0.375i 0.500i' .sp -1 \h'1.875i'\v'2.000i'\D'~-0.500i 0.000i 0.000i -0.500i' .sp -1 \h'1.350i'\v'1.600i'\D'l0.025i -0.100i' .sp -1 \h'1.375i'\v'1.500i'\D'l0.025i 0.100i' .sp -1 .lf 249 \h'1.375i-(\w'1.3.1.1'u/2u)'\v'1.250i-(1v/2u)+1v+0.22m'1.3.1.1 .sp -1 \h'1.375i'\v'1.000i'\D'l-0.375i 0.500i' .sp -1 \h'1.000i'\v'1.500i'\D'l0.750i 0.000i' .sp -1 \h'1.750i'\v'1.500i'\D'l-0.375i -0.500i' .sp -1 \h'2.062i'\v'2.250i'\D'l0.000i 0.500i' .sp -1 \h'2.087i'\v'2.650i'\D'l-0.025i 0.100i' .sp -1 \h'2.062i'\v'2.750i'\D'l-0.025i -0.100i' .sp -1 .lf 252 \h'2.062i-(\w'1.2'u/2u)'\v'3.000i-(1v/2u)+0v+0.22m'1.2 .sp -1 \h'2.062i'\v'3.250i'\D'l-0.375i -0.500i' .sp -1 \h'1.688i'\v'2.750i'\D'l0.750i 0.000i' .sp -1 \h'2.438i'\v'2.750i'\D'l-0.375i 0.500i' .sp -1 \h'1.875i'\v'3.000i'\D'~-0.500i 0.000i -0.500i 0.000i -0.500i 0.000i 0.000i -0.500i' .sp -1 \h'0.350i'\v'2.600i'\D'l0.025i -0.100i' .sp -1 \h'0.375i'\v'2.500i'\D'l0.025i 0.100i' .sp -1 .lf 255 \h'0.375i-(\w'1.2.1.1'u/2u)'\v'2.250i-(1v/2u)+1v+0.22m'1.2.1.1 .sp -1 \h'0.375i'\v'2.000i'\D'l-0.375i 0.500i' .sp -1 \h'0.000i'\v'2.500i'\D'l0.750i 0.000i' .sp -1 \h'0.750i'\v'2.500i'\D'l-0.375i -0.500i' .sp -1 \h'0.375i'\v'2.000i'\D'l0.000i -0.500i' .sp -1 \h'0.350i'\v'1.600i'\D'l0.025i -0.100i' .sp -1 \h'0.375i'\v'1.500i'\D'l0.025i 0.100i' .sp -1 .lf 257 \h'0.375i-(\w'1.2.1.3'u/2u)'\v'1.250i-(1v/2u)+1v+0.22m'1.2.1.3 .sp -1 \h'0.375i'\v'1.000i'\D'l-0.375i 0.500i' .sp -1 \h'0.000i'\v'1.500i'\D'l0.750i 0.000i' .sp -1 \h'0.750i'\v'1.500i'\D'l-0.375i -0.500i' .sp -1 \h'2.250i'\v'3.000i'\D'~0.500i 0.000i 0.000i -0.500i' .sp -1 \h'2.725i'\v'2.600i'\D'l0.025i -0.100i' .sp -1 \h'2.750i'\v'2.500i'\D'l0.025i 0.100i' .sp -1 .lf 261 \h'2.750i-(\w'1.2.2.1'u/2u)'\v'2.250i-(1v/2u)+1v+0.22m'1.2.2.1 .sp -1 \h'2.750i'\v'2.000i'\D'l-0.375i 0.500i' .sp -1 \h'2.375i'\v'2.500i'\D'l0.750i 0.000i' .sp -1 \h'3.125i'\v'2.500i'\D'l-0.375i -0.500i' .sp -1 \h'2.938i'\v'2.250i'\D'~0.500i 0.000i 0.000i -0.500i 0.000i -0.500i' .sp -1 \h'3.413i'\v'1.350i'\D'l0.025i -0.100i' .sp -1 \h'3.438i'\v'1.250i'\D'l0.025i 0.100i' .sp -1 .lf 264 \h'3.438i-(\w'\s-21.2.2.1.1.1\s0'u/2u)'\v'1.000i-(1v/2u)+1v+0.22m'\s-21.2.2.1.1.1\s0 .sp -1 \h'3.438i'\v'0.750i'\D'l-0.375i 0.500i' .sp -1 \h'3.062i'\v'1.250i'\D'l0.750i 0.000i' .sp -1 \h'3.812i'\v'1.250i'\D'l-0.375i -0.500i' .sp -1 \h'2.750i'\v'2.000i'\D'l0.000i -0.500i' .sp -1 \h'2.725i'\v'1.600i'\D'l0.025i -0.100i' .sp -1 \h'2.750i'\v'1.500i'\D'l0.025i 0.100i' .sp -1 .lf 267 \h'2.750i-(\w'1.2.2.2'u/2u)'\v'1.250i-(1v/2u)+1v+0.22m'1.2.2.2 .sp -1 \h'2.750i'\v'1.000i'\D'l-0.375i 0.500i' .sp -1 \h'2.375i'\v'1.500i'\D'l0.750i 0.000i' .sp -1 \h'3.125i'\v'1.500i'\D'l-0.375i -0.500i' .sp -1 \h'2.062i'\v'3.250i'\D'l0.000i 0.500i' .sp -1 \h'2.087i'\v'3.650i'\D'l-0.025i 0.100i' .sp -1 \h'2.062i'\v'3.750i'\D'l-0.025i -0.100i' .sp -1 .lf 270 \h'2.062i-(\w'1.1'u/2u)'\v'4.000i-(1v/2u)+0v+0.22m'1.1 .sp -1 \h'2.062i'\v'4.250i'\D'l-0.375i -0.500i' .sp -1 \h'1.688i'\v'3.750i'\D'l0.750i 0.000i' .sp -1 \h'2.438i'\v'3.750i'\D'l-0.375i 0.500i' .sp -1 .sp 4.250i+1 .if \n(00 .fi .br .nr 0x 0 .lf 271 .PE .lf 272 .\} .PP .SH 作者 .de VL \\$2 .. Author: Walter F. Tichy, Purdue University, West Lafayette, IN, 47907. .br Manual Page Revision: \*(Rv; Release Date: \*(Dt. .br Copyright \(co 1982, 1988, 1989 Walter F. Tichy. .br Copyright \(co 1990, 1991, 1992, 1993, 1994, 1995 Paul Eggert. .SH 関連項目 rcsintro(1), ci(1), co(1), ident(1), rcs(1), rcsclean(1), rcsdiff(1), rcsmerge(1), rlog(1) .br Walter F. Tichy, \*r\*-A System for Version Control, .I "Software\*-Practice & Experience" .BR 15 , 7 (July 1985), 637-654. diff --git a/ja_JP.eucJP/man/man5/remote.5 b/ja_JP.eucJP/man/man5/remote.5 index 8d9c3fd861..e01f533a7c 100644 --- a/ja_JP.eucJP/man/man5/remote.5 +++ b/ja_JP.eucJP/man/man5/remote.5 @@ -1,193 +1,193 @@ .\" 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. .\" .\" @(#)remote.5 8.1 (Berkeley) 6/5/93 .\" %Id: remote.5,v 1.2.2.2 1998/06/28 21:34:27 hoek Exp % -.\" jpman $Id: remote.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: remote.5,v 1.3 1998/07/02 14:12:58 horikawa Stab % .\" .Dd June 5, 1993 .Dt REMOTE 5 .Os BSD 4.2 .Sh 名称 .Nm remote .Nd リモートホスト記述ファイル .Sh 解説 .Xr tip 1 によって知られるシステムとその属性は、 .Xr termcap 5 ファイルのような構造の .Tn ASCII ファイルに記録されます。 ファイルの各行は、1 つの .Em システム についての記述を提供します。 フィールドはコロン (``:'') で分けられています。 \e 文字の直後に改行がある行末は、次の行へ継続されます。 .Pp 最初のエントリはホストシステムの (複数の) 名称です。 システムの名称が 1 つ以上ある場合、名称は縦棒で区切られます。 システムの名称の後に記述フィールドが続きます。 `=' 記号が続くフィールド名は、文字列型を示します。 `#' 記号が続くフィールド名は、数値を示します。 .Pp ``tip*'' と ``cu*'' という名前が付いたエントリは、 .Xr tip 1 や、以下で述べるように .Nm tip に対するインタフェース .Xr cu 1 でデフォルトのエントリとして使われます。 .Nm tip が電話番号だけをつけて呼び出された時、 ``tip300'' の形式のエントリを探 します。 ここで、 300 は接続が張られたボーレートです。 .Nm cu インタフェースが使われた時は、 ``cu300'' という形式のエントリが使わ れます。 .Sh ケーパビリティ ケーパビリティは、文字列 (str) ・数値 (num) ・ブーリアンフラグ (bool) のいずれかです。文字列ケーパビリティは .Em capability Ns Ar = Ns Em value のように指定されます。例えば、 ``dv=/dev/harris'' のように指定します。 数値ケーパビリティは .Em capability Ns Ar # Ns Em value のように指定されます。例えば、 ``xa#99'' のように指定します。 ブーリアンケーパビリティは単にケーパビリティを記述するだけで 指定されます。 .Bl -tag -width indent .It Cm \&at (str) 自動呼び出しユニットの形式です。 .It Cm \&br (num) リモートホストと接続を確立するために使われるボーレート。 これは、10 進の数値です。デフォルトのボーレートは 300 ボーです。 .It Cm \&cm (str) リモートホストに送られる初期接続メッセージです。 例えば、ホストにポート選択器を通して到達する場合、 ここにはホストに切替えるために必要とされる適切なシーケンスが設定されて いるべきです。 .It Cm \&cu (str) 電話の呼び出しが行われる場合の呼び出しユニットです。 デフォルトは、 `dv' フィールドと同じです。 .It Cm \&di (str) ユーザによって切断が要求されている時にホストに送られる 切断メッセージです。 .It Cm \&du (bool) このホストはダイアルアップ線上にあることを示します。 .It Cm \&dv (str) 接続を確立するためにオープンする (複数の) .Tn UNIX デバイスです。このファイルが端末線を参照している場合、 .Xr tip 1 は、1 度に 1 ユーザだけがポートにアクセスすることを保証するために、 デバイスを排他的にオープンします。 .It Cm \&el (str) 行末 (end-of-line) を示す文字です。 デフォルトでは .Dv NULL 文字です。`el' 中の 1 文字もしくは復帰文字 (carriage return) の後の `~' エスケープは .Nm tip だけで認識されます。 .It Cm \&fs (str) 転送のためのフレームサイズです。 デフォルトフレームサイズは .Dv BUFSIZ と同じです。 .It Cm \&hd (bool) ホストが半 2 重通信を使い、ローカルエコーが行われることを示します。 .It Cm \&ie (str) 入力のファイル終了 (end-of-file) マークです。 デフォルトは .Dv NULL です。 .It Cm \&oe (str) 出力のファイル終了 (end-of-file) 文字列です。 デフォルトは .Dv NULL です。 .Nm tip がファイルを転送している時、この文字列はファイル終了時に送られます。 .It Cm \&pa (str) データをホストに送っている時に使われるパリティの形式です。 これは ``even'', ``odd'', ``none'', ``zero'' (いつでも 8 ビット目を 0 に設定する), ``one'' (いつでも 8 ビット目を 1 に設定する)のいずれかです。 デフォルトではイーブンパリティです。 .It Cm \&pn (str) ホストに対する (複数の) 電話番号です。 電話番号フィールドが @ 符号を含んでいる場合、 .Nm tip は電話番号の一覧を .Pa /etc/phones ファイルから検索します ( .Xr phones 5 参照)。 .It Cm \&tc (str) ケーパビリティのリストが、名前で与えられた記述に継続されることを示し ます。これは主に共通のケーパビリティ情報を共有するために使われます。 .El .Pp ここで、ケーパビリティの継続機能の利用をしめす短い例をお見せしましょう: .Bd -literal UNIX-1200:\e :dv=/dev/cau0:el=^D^U^C^S^Q^O@:du:at=ventel:ie=#$%:oe=^D:br#1200: arpavax|ax:\e :pn=7654321%:tc=UNIX-1200 .Ed .Sh 関連ファイル .Bl -tag -width /etc/remote -compact .It Pa /etc/remote .Pa /etc に置かれた .Nm リモート ホスト記述ファイル。 .El .Sh 関連項目 .Xr tip 1 , .Xr phones 5 .Sh 歴史 .Nm ファイル書式は .Bx 4.2 から登場しました。 diff --git a/ja_JP.eucJP/man/man5/resolver.5 b/ja_JP.eucJP/man/man5/resolver.5 index 9470e136ca..7449f62af3 100644 --- a/ja_JP.eucJP/man/man5/resolver.5 +++ b/ja_JP.eucJP/man/man5/resolver.5 @@ -1,137 +1,137 @@ .\" Copyright (c) 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. .\" .\" @(#)resolver.5 8.1 (Berkeley) 6/5/93 -.\" jpman $Id: resolver.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: resolver.5,v 1.3 1998/07/22 02:40:21 issei Stab % .\" %Id: resolver.5,v 1.2.2.1 1997/03/07 04:18:10 mpp Exp % .\" .Dd June 5, 1993 .Dt RESOLVER 5 .Os BSD 4 .Sh 名称 .Nm resolver .Nd リゾルバ設定ファイル .Sh 書式 .Nm resolv.conf .Sh 解説 .Xr resolver 3 はインターネットドメインネームシステムへのアクセスを提供する C ライブラリのルーチン群です。 リゾルバ設定ファイルは、はじめてリゾルバルーチンがプロセスによって呼び出 されたときに読み込まれる情報を含んでいます。 ファイルは人に可読なように設計されており、様々な種類のリゾルバ情報を 提供する、値を伴うキーワードのリストを含んでいます。 .Pp 普通に構成されたシステムでは、このファイルは必要ではありません。 問い合わせされる唯一のネームサーバはローカルマシン上にあり、ホスト名 からドメイン名が決定され、ドメインの検索パスがそのドメイン名から作成 されます。 .Pp 様々な設定オプションは以下の通りです。 .Bl -tag -width nameserver .It Sy nameserver リゾルバが問い合わせをするネームサーバのインターネットアドレス (ドット表記)です。 キーワード毎に 1 つづつ、計 .Dv MAXNS (現状では 3)台までのネームサーバが記述できます。 複数のサーバが記述されている場合、リゾルバライブラリは記述された順に 問い合わせを出します。 .Sy nameserver エントリが記述されていない場合、デフォルトではローカルマシン上のネーム サーバを使用します (ここで使われるアルゴリズムは以下のようになります。まず、あるネーム サーバに問い合わせを試みます。この問い合わせがタイムアウトになれば、 次のネームサーバに問い合わせを試み、これをネームサーバがなくなるまで 続けます。応答がない場合、この一連の問い合わせの試みをリトライ最大回 数に達するまで繰り返します)。 .It Sy domain ローカルドメイン名。 そのドメイン内での名前の問い合わせのほとんどが、ローカルドメインにおける 短い名前を使用することができます。 .Sy domain エントリが記述されていない場合、 .Xr gethostname 3 で得たローカルホスト名からドメインを決定します。 ドメイン部は最初の `.' 以降の全てとなります。 ホスト名がドメイン部を含んでいない場合、最終的にはルートドメインが使用されます。 .It Sy search ホスト名調査のための検索リスト。 通常、検索リストはローカルドメイン名から決定されます。 デフォルトでは、ローカルドメイン名から始まり、次に少なくとも 2 つの構成要素を 持つ親ドメインを検索します。 検索リストは、 .Sy search キーワードの後にスペースまたはタブで区切られたドメイン検索パス名を羅列することで 変更できます。 ほとんどのリゾルバの問い合わせは、検索パスの各構成要素を一致するエントリが 見つかるまでまで順に試します。 記述されたドメインのサーバがローカルではない場合、この処理は低速で多くの ネットワークトラフィックを発生させる可能性があることと、それらのいずれかの ドメインに関して、使用可能なサーバが 1 つも存在しない場合には問い合わせが タイムアウトすることに注意する必要があります。 .Pp 現在のところ、検索リストは 6 ドメイン、計 256 文字に制限されます。 .El .Pp .Sy domain と .Sy search キーワードは排他的です。 これらのキーワードが 1 つ以上記述されている場合、 最後のキーワードが有効になります。 .Pp キーワードと値は同一行に存在する必要があり、キーワード (例えば .Sy nameserver ) は行の先頭にある必要があります。 値はキーワードに続いて空白で区切って記述します。 .Sh 関連ファイル .Bl -tag -width /etc/resolv.conf -compact .It Pa /etc/resolv.conf .Nm resolv.conf は .Pa /etc に存在します。 .El .Sh 関連項目 .Xr gethostbyname 3 , .Xr resolver 3 , .Xr hostname 7 , .Xr named 8 .Rs .%T "Name Server Operations Guide for BIND" .Re .Sh 歴史 .Nm resolv.conf ファイルフォーマットは .Bx 4.3 から登場しました。 diff --git a/ja_JP.eucJP/man/man5/rpc.5 b/ja_JP.eucJP/man/man5/rpc.5 index ca02eab8b8..07904b0358 100644 --- a/ja_JP.eucJP/man/man5/rpc.5 +++ b/ja_JP.eucJP/man/man5/rpc.5 @@ -1,33 +1,33 @@ .\" @(#)rpc.5 2.2 88/08/03 4.0 RPCSRC; from 1.4 87/11/27 SMI; -.\" jpman $Id: rpc.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: rpc.5,v 1.3 1998/06/25 08:44:57 jsakai Stab % .Dd "September 26, 1985" .Dt RPC 5 .Sh 名称 .Nm rpc .Nd rpc プログラム番号データベース .Sh 書式 /etc/rpc .Sh 解説 .Pa /etc/rpc ファイルには、rpc プログラム番号の代わりに使用可能な、 ユーザが可読な名前が記述されています。 各行は以下の情報から成ります。 .Pp .Bl -bullet -compact .It rpc プログラムのサーバ名 .It rpc プログラム番号 .It 別名 .El .Pp 各項目は任意個の空白文字もしくはタブ文字で分けられます。 ``#'' はコメントの開始を示します。 行末までの文字はファイルを検索するルーチンには解釈されません。 .Sh 関連ファイル .Bl -tag -compact -width /etc/rpc .Pa /etc/rpc .El .Sh "関連項目" .Xr getrpcent 3 diff --git a/ja_JP.eucJP/man/man5/services.5 b/ja_JP.eucJP/man/man5/services.5 index 8fec1ad5ac..17b2ca32b7 100644 --- a/ja_JP.eucJP/man/man5/services.5 +++ b/ja_JP.eucJP/man/man5/services.5 @@ -1,88 +1,88 @@ .\" 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. .\" .\" @(#)services.5 8.1 (Berkeley) 6/5/93 -.\" jpman $Id: services.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: services.5,v 1.3 1998/06/17 07:53:27 kumano Stab % .\" %Id: services.5,v 1.3.2.1 1997/03/07 04:18:11 mpp Exp % .\" .Dd June 5, 1993 .Dt SERVICES 5 .Os BSD 4.2 .Sh 名称 .Nm services .Nd サービス名のデータベース .Sh 解説 .Nm services ファイルには .Tn DARPA インターネットで利用可能な既知のサービスの情報が格納されます。 各サービス毎に、以下の情報を表す 1 行が存在します。 .Bd -unfilled -offset indent 公式なサービス名 ポート番号 プロトコル名 別名 .Ed .Pp 項目は任意個の空白文字やタブ文字で分けられます。 ポート番号およびプロトコル名は単一の .Em 項目 とみなされ、 ``/'' を 1 つ使用してポートとプロトコルを分けます (例 ``512/tcp'')。 ``#'' はコメント開始を表し、 行末までの文字はファイルを検索するルーチンに解釈されません。 .Pp サービス名は、フィールド区切り文字・改行文字・コメント文字以外の、 任意の表示可能文字からなります。 .Sh NIS との相互作用 NIS の .Pa services.byname マップへのアクセスを有効にするには、単一の ``+'' のみからなる行を .Pa /etc/services ファイルに追加します。 こうすると、NIS のサービスマップの内容が ``+'' のある位置に挿入されます。 .Sh 関連ファイル .Bl -tag -width /etc/services -compact .It Pa /etc/services .Nm services ファイルは .Pa /etc にあります。 .El .Sh 関連項目 .Xr getservent 3 .Sh バグ 静的ファイルの代わりに、ネームサーバを使用すべきです。 .Sh 歴史 .Nm ファイルフォーマットは .Bx 4.2 に登場しました。 diff --git a/ja_JP.eucJP/man/man5/shells.5 b/ja_JP.eucJP/man/man5/shells.5 index 797b2d89e0..5bbcbc97be 100644 --- a/ja_JP.eucJP/man/man5/shells.5 +++ b/ja_JP.eucJP/man/man5/shells.5 @@ -1,64 +1,64 @@ .\" Copyright (c) 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. .\" .\" @(#)shells.5 8.1 (Berkeley) 6/5/93 -.\" jpman $Id: shells.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: shells.5,v 1.3 1998/06/25 08:44:02 jsakai Stab % .\" %Id: shells.5,v 1.1.1.1.8.1 1997/03/07 04:18:11 mpp Exp % .\" .Dd June 5, 1993 .Dt SHELLS 5 .Os BSD 4.2 .Sh 名称 .Nm shells .Nd シェルデータベース .Sh 解説 .Nm shells ファイルはシステム上のシェルのリストを格納します。 各シェルごとに 1 行ずつ、ルートからの相対でシェルのパスを記述します。 .Pp ハッシュマーク (``#'') はコメントの開始を意味します。 それ以降行末までの文字列はファイルを検索するルーチンには解釈されません。 空行もまた無視されます。 .Sh 関連ファイル .Bl -tag -width /etc/shells -compact .It Pa /etc/shells .Nm shells ファイルは .Pa /etc にあります。 .El .Sh 関連項目 .Xr getusershell 3 .Sh 歴史 .Nm ファイルフォーマットは .Bx 4.3 tahoe から登場しました。 diff --git a/ja_JP.eucJP/man/man5/skey.access.5 b/ja_JP.eucJP/man/man5/skey.access.5 index 56671a9b93..9b6e784be6 100644 --- a/ja_JP.eucJP/man/man5/skey.access.5 +++ b/ja_JP.eucJP/man/man5/skey.access.5 @@ -1,136 +1,136 @@ -.\" jpman $Id: skey.access.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: skey.access.5,v 1.3 1998/08/09 12:54:01 horikawa Stab % .TH SKEY.ACCESS 5 .SH 名称 skey.access \- S/Key パスワード制御テーブル .SH 解説 S/Key パスワード制御テーブル (\fIetc/skey.access\fR) は \fIlogin\fR のようなプログラムが使用し、 システムアクセスのために UNIX パスワードをいつ使用するかを決定します。 .IP \(bu テーブルが存在しない場合は、パスワード制限はありません。 ユーザは UNIX パスワードあるいは S/Key パスワードを入力することができます。 .IP \(bu テーブルが存在する場合は、 明白に記述されている場合のみ UNIX パスワードが許可されます。 .IP \(bu ただし、システムコンソールからは常に UNIX パスワードは許可されます。 .SH テーブルの書式 テーブルのフォーマットは 1 行当たり 1 ルールです。 ルールは順番に検索されます。 最初に条件が合うルールが見つかったとき、 またはテーブルの最後に到達したとき、検索は終了します。 .PP ルールのフォーマットは次の通りです: .sp .in +5 permit 条件\ 条件... .br deny 条件\ 条件... .in .PP .I permit と .I deny の後には 0 個以上の条件を記述可能です。 コメントは `#\' で始まり、行末までコメントになります。 空行やコメントのみの行は無視されます。 .PP すべての条件が満たされるときにルールがマッチします。 条件のないルールは常に満たされます。 例えば、最後のエントリは語 .I deny のみとなっているかもしれません。 .SH 条件 .IP "hostname wzv.win.tue.nl" wzv.win.tue.nl というホストからログインしたとき真になります。 警告の節を参照してください。 .IP "internet 131.155.210.0 255.255.255.0" 131.155.210 のネットワークからログインしたら真になります。 ネットワークアドレスとネットマスクは次の書式になります。 .sp .ti +5 internet net mask .sp mask とのビットごとの論理積が net と等しくなるインターネットアドレスを ホストが持つ場合、式は真になります。 警告の節を参照してください。 .IP "port ttya" ログインしている端末が .IR /dev/ttya ならば真になります。 UNIX パスワードはシステムコンソールからの ログインには常に許されている点は憶えておいてください。 .IP "user uucp" .IR uucp ユーザがログインしようとしたとき真になります。 .IP "group wheel" .I wheel グループとしてログインしようとしたとき真になります。 .SH 互換性 過去の互換性のために、 .I internet というキーワードはネットワークアドレスとマスクのパターンから 省略可能です。 .SH 警告 S/Key 制御テーブル (\fI/etc/skey.access\fR) が存在する場合、 S/Key パスワードを持たないユーザは、 UNIX パスワードの使用が許されるところからのみログインが許されます。 特に \fIlogin(1)\fR が擬似 tty (例えば \fIxterm(1)\fR や \fIscreen(1)\fR の中) から起動される場合、 コンソールからのログインでもなければ ネットワークからのログインでもないと扱われますので、 S/Key パスワードの使用が義務づけられます。 このような状況で起動される \fIlogin(1)\fR は、 S/Key パスワードを持たないユーザに対しては必ず失敗します。 .PP いくつかのルール型は、ネットワークを通じて与えられるホスト名やアドレス情報に 依存しています。 このことから考えられる、システムに UNIX パスワードを許させる攻撃の一覧を 示します。 .IP "ホストアドレス偽造 (ソースルーティング)" 侵入者は自分のインタフェースを信頼されているネットワーク内のアドレス として構成し、 そのソースアドレスを使用して、被害者に接続します。 誤ったクライアントアドレスを与えられると、 ホストアドレスに基づくルールもしくは アドレスから導かれるホスト名に基づくルールを元にして、 被害者は間違った結論を導きます。 .sp 対処法: (1) ネットワークからの UNIX パスワードを用いたログインを許さない。 (2) ソースルーティング情報を捨てるネットワークソフトウェアを使う (例えば、tcp wrapper)。 .PP ほとんどのネットワークサーバはクライアントのネットワークアドレスから クライアントの名前を解決します。 それゆえ、次の明らかな攻撃は以下のようになります。 .IP "ホスト名偽造 (悪い PTR レコード)" 誤ったホスト名を与えられると、 ホスト名に基づくルールもしくは ホスト名から導かれるアドレスに基づくルールを元にして、 被害者は間違った結論を導きます。 .sp 対処法: (1) ネットワークからの UNIX パスワードを用いたログインを許さない。 (2) ホスト名からクライアントのネットワークアドレスを解決できることを確認する ネットワークソフトウェアを使用する (例えば、tcp wrapper)。 .PP UNIX の login プログラムのように、 クライアントのホスト名からクライアントのネットワークアドレスを 求める必要があるアプリケーションが存在します。 今述べた攻撃に加えて、もう 1 つの可能性があります。 .IP "ホストアドレスの偽造 (余分な A レコード)" 侵入者はクライアントのホスト名について (もまた)、信頼されたアドレスとして 解決させるためにネームサーバシステムを操作します。 .sp 対処法: (1) ネットワークからの UNIX パスワードを用いたログインを許さない。 (2) skeyaccess() は他の人が属するネットワークアドレスを無視する。 .SH 診断 構文エラーは syslogd に報告されます。 エラーが見つかったらそのルールはスキップされます。 .SH 関連ファイル /etc/skey.access パスワード制御テーブル .SH 作者 .nf Wietse Venema Eindhoven University of Technology The Netherlands diff --git a/ja_JP.eucJP/man/man5/stab.5 b/ja_JP.eucJP/man/man5/stab.5 index 0c38a31aff..76b273ea70 100644 --- a/ja_JP.eucJP/man/man5/stab.5 +++ b/ja_JP.eucJP/man/man5/stab.5 @@ -1,225 +1,225 @@ .\" 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. .\" .\" @(#)stab.5 8.1 (Berkeley) 6/5/93 .\" %Id: stab.5,v 1.2.2.1 1997/03/07 04:18:12 mpp Exp % -.\" jpman $Id: stab.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: stab.5,v 1.3 1998/07/21 23:07:45 jsakai Stab % .\" WORD: symbol table シンボルテーブル .\" WORD: directive ディレクティブ(命令、指令の類) .\" .Dd June 5, 1993 .Dt STAB 5 .Os BSD 4 .Sh 名称 .Nm stab .Nd シンボルテーブルの型 .Sh 書式 .Fd #include .Sh 解説 .Aq Pa stab.h ファイルは a.out ファイルで使われる、シンボルテーブルのいくつかの .Fa n_type フィールド値の定義します。 これらは、恒久的なシンボル形式であり (つまり、ローカルなラベルなどではない)、古いデバッガである .Em sdb や Berkeley パスカルコンパイラ .Xr pc 1 で使われます。 .\" (訳注) BerkeleyパスカルコンパイラはFreeBSDディストリビューション .\" に含まれない。 .\" 1998/05/05 Takeshi MUTOH シンボルテーブルエントリは .Pa .stabs アセンブラディレクティブによって生成することができます。 ここでは、ダブルクオートで区切られた名前、シンボルの型、シンボルに ついての char 1 つと short 1 つ分の情報、 そして (通常はアドレスを示す) unsigned long の整数を指定できます。 アドレスフィールドに明示的なラベルを生成するのを避けるため、 .Pa .stabd ディレクティブを使い、現在の場所を指すようにすることができます。 もし名前が必要ない場合、 .Pa .stabn ディレクティブを使うことで、シンボルテーブルエントリを生成することができます。 ローダは、 .Pa .stab ディレクティブによって生成されたシンボルテーブルのエントリ順を変えないこと を保証します。 .Xr a.out 5 に記述されているように、シンボルテーブルの要素は以下の構造を持ちます。 .Bd -literal /* * シンボルテーブルエントリの書式 */ struct nlist { union { char *n_name; /* コア内部 (in-core) で使用 */ long n_strx; /* ファイル文字列表へのインデックス */ } n_un; unsigned char n_type; /* 型のフラグ */ char n_other; /* 使用されていない */ short n_desc; /* 以下の struct desc 参照 */ unsigned n_value; /* アドレスまたはオフセットまたは行 */ }; .Ed .Pp .Fa n_type フィールドの下位ビットは、シンボルをたかだか 1 つのセグメントに置くため に使用します。どのセグメントに置くかは .Aq Pa a.out.h 内で定義されている以下のマスクに基づきます。 これらのセグメントビットを設定しないようにすることで、シンボルをどの セグメントにも属さないようにすることができます。 .Bd -literal /* * n_type の単純な値 */ #define N_UNDF 0x0 /* 定義されていない */ #define N_ABS 0x2 /* 絶対指定 */ #define N_TEXT 0x4 /* テキスト */ #define N_DATA 0x6 /* データ */ #define N_BSS 0x8 /* bss */ #define N_EXT 01 /* 外部参照を表すビット(or して使う) */ .Ed .Pp シンボルの .Fa n_value フィールドは、リンカ .Xr ld 1 によって、正しいセグメント内のアドレスに再配置されます。 どのセグメントにも入っていないシンボルの .Fa n_value フィールドは、リンカによって変更されません。 さらに、 .Fa n_type フィールドで、以下のビットのいずれもセットされていない場合は、 リンカは自分が持っている規則にしたがって、 いくつかのシンボルを破棄します。 .Bd -literal /* * その他の永続的なシンボルテーブルエントリでは、N_STAB のいくつかのビットが * セットされています。これらは、 内に記述があります。 */ #define N_STAB 0xe0 /* もしこれらのビットのいずれかがセットされていれば破棄されません */ .Ed .Pp これで、112 (7 \(** 16) 個までのシンボルを、さまざまなセグメントで分けて 定義できるようになります。 これらのいくつかについては既に述べられています。 古いシンボリックデバッガ .Em sdb は、以下の n_type 値を使います。 .Bd -literal #define N_GSYM 0x20 /* グローバルシンボル : name,,0,type,0 */ #define N_FNAME 0x22 /* プロシジャ名 (f77 kludge): name,,0 */ #define N_FUN 0x24 /* プロシジャ: name,,0,linenumber,address */ #define N_STSYM 0x26 /* 静的シンボル: name,,0,type,address */ #define N_LCSYM 0x28 /* .lcomm シンボルl: name,,0,type,address */ #define N_RSYM 0x40 /* レジスタシンボル: name,,0,type,register */ #define N_SLINE 0x44 /* ソース行: 0,,0,linenumber,address */ #define N_SSYM 0x60 /* structure elt: name,,0,type,struct_offset */ #define N_SO 0x64 /* ソースファイル名: name,,0,0,address */ #define N_LSYM 0x80 /* ローカルシンボル: name,,0,type,offset */ #define N_SOL 0x84 /* #includeされたファイル名: name,,0,0,address */ #define N_PSYM 0xa0 /* パラメータ: name,,0,type,offset */ #define N_ENTRY 0xa4 /* 別のエントリ: name,linenumber,address */ #define N_LBRAC 0xc0 /* 左かっこ: 0,,0,nesting level,address */ #define N_RBRAC 0xe0 /* 右かっこ: 0,,0,nesting level,address */ #define N_BCOMM 0xe2 /* 共通の開始符号: name,, */ #define N_ECOMM 0xe4 /* 共通の終了符号: name,, */ #define N_ECOML 0xe8 /* (ローカル名の)共通の終了符号: ,,address */ #define N_LENG 0xfe /* 長さ情報を持った2番目の stab エントリ */ .Ed .Pp ここで、コメントには 与えられた .Fa n_type の .Fa n_name , .Fa n_other , .Fa n_desc , .Fa n_value フィールド と .Pa .stab .Fa s の典型的な利用法が書かれています。 .Em sdb は、ポータブル C コンパイラ .Xr cc 1 によって使われる形式の型の指定子を持っている .Fa n_desc フィールドを使います。これらの型の値のフォーマットの詳細はヘッダファイル .Pa pcc.h を参照して下さい。 .Pp Berkeley パスカルコンパイラ .Xr pc 1 は、以下の .Fa n_type 値をつかいます: .Bd -literal #define N_PC 0x30 /* グローバルなパスカルシンボル: name,,0,subtype,line */ .Ed .Pp と、以下のサブ型を使い、別々のコンパイルファイルにまたがる型チェックを 行います。 .Bd -unfilled -offset indent 1 ソースファイル名 2 インクルードされたファイル名 3 グローバルなラベル 4 グローバルな定数 5 グローバルな型 6 グローバルな変数 7 グローバルな関数 8 グローバルな手続き 9 外部関数 10 外部手続き 11 ライブラリ変数 12 ライブラリルーチン .Ed .Sh 関連項目 .Xr as 1 , .Xr ld 1 , .Xr a.out 5 .Sh バグ .Pp もっと基本的な形式が必要でしょう。 .Sh 歴史 .Nm stab ファイルは .Bx 4.0 から登場しました。 diff --git a/ja_JP.eucJP/man/man5/syslog.conf.5 b/ja_JP.eucJP/man/man5/syslog.conf.5 index 20befb9e4d..d3ada4ba97 100644 --- a/ja_JP.eucJP/man/man5/syslog.conf.5 +++ b/ja_JP.eucJP/man/man5/syslog.conf.5 @@ -1,340 +1,340 @@ .\" 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. .\" .\" From: @(#)syslog.conf.5 8.1 (Berkeley) 6/9/93 .\" %Id: syslog.conf.5,v 1.3.2.6 1998/07/18 11:37:22 jkh Exp % .\" -.\" jpman $Id: syslog.conf.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: syslog.conf.5,v 1.3 1998/07/16 01:34:25 yohta Stab % .\" .Dd June 9, 1993 .Dt SYSLOG.CONF 5 .Os .Sh 名称 .Nm syslog.conf .Nd .Xr syslogd 8 設定ファイル .Sh 解説 .Nm ファイルは .Xr syslogd 8 プログラムの設定ファイルです。 このファイルは .Em program 指定によって分けられた行ブロックから構成されています。 それぞれの行は 2つのフィールドを含みます。 その行が適用されるメッセージのタイプと優先度を指定する .Em selector フィールドと、 .Xr syslogd が選んだ基準とマッチしたマッチしたメッセージを受けとった場合の動作を指定する .Em action フィールドです。 .Em selector フィールドと .Em action フィールドは 1 つ以上のタブ文字で区切られています。 .Pp .Em selectors 機能は .Em facility とピリオド .Pq Dq \&. そして .Em level で符合化され、間に空白は含みません。 .Em facility と .Em level の双方とも、大文字小文字の違いはありません。 .Pp .Em facility はシステムが発するメッセージの一部を表し、次にあげるキーワード群の 1 つで表されます : auth, authpriv, cron, daemon, ftp, kern, lpr, mail, mark, news, ntp, syslog, user, uucp と local0 から local7. これらのキーワード(markを除く)は .Xr openlog 3 と .Xr syslog 3 ライブラリルーチンで指定される .Dq Dv LOG_ で始まる値と一致します。 .Pp .Em level はメッセージの重要度を表し、以下のキーワードの順に高から低になります: emerg, alert, crit, err, warning, notice, info, debug。 これらのキーワードは .Xr syslog 3 ライブラリルーチンで指定される .Dq Dv LOG_ で始まる値と一致します。 .Pp それぞれの行ブロックはタグによって前のブロックと区別されます。 タグは行の先頭が .Em #!prog または .Em !prog (前者は以前の syslogd との互換性のためのものです。 例えば syslog.conf ファイルを共有したい時などに便利です) で始まり、それぞれのブロックは syslog を呼び出す特定のプログラムと 関連付けられています。 また、タグ ``foo'' は、 ``foo: '' というプレフィックスを持つ カーネルログメッセージにもマッチします。 .Pp .Em facility と .Em level の両方のキーワードとその意味のより詳細な説明を知りたい場合は .Xr syslog 3 を見てください。 選択は .Em facility で行なう方が .Em program で行なうよりも好まれています。 なぜなら、後者はネットワーク環境の中では 簡単に変化してしまう場合があるからです。しかし、適切な .Em facility が本当に存在しない場合もあります。 .Pp もし .Em facility 指定に一致したメッセージを受けとり、なおかつそれが 指定した .Em level .Em (もしくはそれ以上の level) だった場合、またはメッセージ中の日付の後ろの最初の単語が .Em program と一致した場合、 .Em action フィールドで指定された動作が選択されます。 .Pp 複数の .Em selector を、セミコロン .Pq Dq \&; によって区切ることにより、1 つの .Em action に対して指定することができます。 しかしそれぞれの .Em selector はその前にある指定を上書き修正できてしまいますので注意してください。 .Pp 複数の .Em facility は、コンマ .Pq Dq \&, によって区切ることにより 1 つの .Em level を指定することができます。 .Pp アスタリスク .Pq Dq * は、全ての .Em facility 、全ての .Em levels 、または全ての .Em programs を指定するのに使用できます。 .Pp 特別な .Em facility である .Dq mark は、20分毎に .Dq info の優先度を持つメッセージを受け取ります ( .Xr syslogd 8 を参照 )。これは アスタリスクを含む .Em facility フィールドには適用されません。 .Pp 特別な .Em level である .Dq none は、特定の .Em facility を無効にします。 .Pp それぞれの行の .Em action フィールドは、 .Em selector フィールドに指定されたメッセージを受け取った際の動作を指定します。 動作指定には次の 5つの形式があります: .Bl -bullet .It パス名 (先頭がスラッシュで始まります)。 該当するメッセージは、そのファイルに追加されます。 .It ホスト名 ( .Pq Dq @ 文字から始まる必要があります)。 該当するメッセージは、指定されたホストの .Xr syslogd プログラムに転送されます。 .It コンマで区切られたユーザのリスト。 該当するメッセージは、指定されたユーザがログインしていれば、 そのユーザの画面に出力されます。 .It 1 つのアスタリスク。 該当するメッセージは、ログイン中の全てのユーザの画面に出力されます。 .It 垂直バー .Pq Dq \&| とそれに続くコマンド。該当したメッセージをパイプを使って コマンドに渡すことができます。 このコマンドは、 .Pa /bin/sh によって評価されるので、通常のシェルメタキャラクタや入力/出力 リダイレクトを利用できます。 (しかし実行されたコマンドからの .Xr stdio 3 バッファされた出力のリダイレクトは余計な遅延を引き起こしたり、 あるいはシグナルによってロギング中のサブプロセスが終了した場合など 出力データを失うことがあるかもしれないことに注意してください) コマンドそれ自身は .Em stdout と .Em stderr を .Pa /dev/null にリダイレクトして動作します。 .Dv SIGHUP を受け取ると、 .Nm はそのプロセスとのパイプを閉じます。もしそのプロセスが自発的に終了しない 場合は、60秒の猶予期間の後 .Dv SIGTERM を送ります。 .Pp コマンドはパイプでつながれるデータが到着した際に 1 度だけ起動されます。 その後、コマンドが終了した場合には必要に応じて再起動されます。 そのため、1行の入力だけをサブプロセスが手に入れるよう望んでいるなら、 (もし多くのメッセージが速く流れる場合には、 資源を大量に消費する可能性がありますが) 1行の入力があった後に終了する事によって達成する事ができます。 必要ならば、この効果のためにラッパスクリプトを書くこともできます。 .Pp そのコマンドが完全なパイプラインでない場合、コマンドを .Em exec で起動すると、起動したシェルプロセスがコマンドの完了を待たなくなるので 便利かもしれません。 警告: このプロセスは .Xr syslogd 8 の UID のもとで動きます。通常はスーパユーザです。 .El .Pp 空行と最初の空白でない文字がハッシュ .Pq Dq # 文字である行は無視されます。 .Sh 使用例 .Pp 設定ファイルは次のようになります: .Bd -literal # err レベル以上の全てのメッセージ、全てのレベルの kernel メッセージ、 # notice レベルの auth メッセージをコンソールに出力します。 # プライベートな認証メッセージは記録をとりません! *.err;kern.*;auth.notice;authpriv.none /dev/console # info 以上のレベルを持つ(mail を除く)全てのメッセージを記録します。 # プライベートな認証メッセージは記録をとりません! *.info;mail.none;authpriv.none /var/log/messages # authpriv ファイルはアクセス制限を持ちます。 .\" /var/log/secure の read permission を限定するということ？ .\" 2.2.6-RELEASE 対象 .\" By yohta@bres.tsukuba.ac.jp (July 8 1998) authpriv.* /var/log/secure # 全てのレベルの mail メッセージを一箇所にまとめて記録します。 mail.* /var/log/maillog # emerg(非常事態)レベルの全てのメッセージは全員が受け取ります。 *.emerg * *.emerg @arpa.berkeley.edu # alert レベル以上のメッセージを root と eric の画面に表示されます。 .\" 原文は Root and Eric get alert and higher messages を意訳 .\" 2.2.6-RELEASE 対象 .\" By yohta@bres.tsukuba.ac.jp (July 10 1998) *.alert root,eric # err レベル以上の mail と news の エラーを特別なファイルに保存します。 mail;news.err /var/log/spoolerr .\" 原文は uucp,news.crit / send-pr 予定 .\" 2.2.6-RELEASE 対象 .\" By yohta@bres.tsukuba.ac.jp (July 10 1998) # 全てのレベルの認証メッセージをフィルタにパイプします。 auth.* |exec /usr/local/sbin/authfilter # ftpd のトランザクションを mail と news にあわせて保存します。 !ftpd *.* /var/log/spoolerr # カーネルのファイヤウォールレポートを別のファイルに保存します。 !ipfw *.* /var/log/ipfw .Ed .Sh 関連ファイル .Bl -tag -width /etc/syslog.conf -compact .It Pa /etc/syslog.conf .Xr syslogd 8 設定ファイル .El .Sh バグ 複数のセレクタ指定は、時々思ったように効果を発揮しない事があります。 例えば、 .Dq mail.crit,*.err と設定すると、 .Dq mail ファシリティのメッセージのレベルは .Dq err かそれ以上となり、 .Dq crit かそれ以上のレベルにはなりません。 .Pp ネットワーク環境においては、全てのオペレーティングシステムが 同じ facility 名のセットを実装しているわけではない点に注意してください。 authpriv, cron, ftp, ntp といったこの実装において知られた facility が、 目的のシステムには存在しないかもしれません。更に悪い事に、 DEC UNIX は AdvFS ファイルシステムのログイベントに facility 番号 10 (この実装では authpriv です) を使っています。 .Sh 関連項目 .Xr syslog 3 , .Xr syslogd 8 diff --git a/ja_JP.eucJP/man/man5/term.5 b/ja_JP.eucJP/man/man5/term.5 index 7036211624..92d70d257e 100644 --- a/ja_JP.eucJP/man/man5/term.5 +++ b/ja_JP.eucJP/man/man5/term.5 @@ -1,153 +1,153 @@ .TH TERM 5 -.\" jpman $Id: term.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: term.5,v 1.3 1998/07/30 15:27:11 horikawa Stab % .\" WORD: compiled コンパイル済みの .\" WORD: linear search 線形探索(パス名から inodeを) .\" WORD: boolean value ブール値 .\" WORD: terminate 終端する .ds n 5 .ds d /usr/lib/terminfo .SH 名称 term \- コンパイル済みの term ファイルの形式 .SH 書式 .B term .SH 解説 .PP コンパイル済みの terminfo 属性記述はディレクトリ \fB\*d\fP の下にあります。 \s-1UNIX\s+1 システムの巨大なディレクトリを線形探索するのを避けるため、 \fB\*b/c/name\fP という形の 2 階層の命名規則が用いられます。 (ここで、 .I name は端末の名前で、 .I c は .I name の最初の文字です。) ですから、 .I act4 は、 \fB\*d/a/act4\fP というファイル名で見つけることができます。 同じ端末を示す同義な名前は、同じコンパイル済みファイルへの複数の リンクとして実装されています。 .PP この形式は、全てのハードウェアで同じになるように選ばれています。 1 バイトが 8 ビット以上であることは仮定していますが、バイトオーダや 符合拡張の方式については仮定していません。 .PP コンパイル済みのファイルは .I tic プログラムにより生成され、 .I setupterm ルーチンにより読み取られます。 これらのソフトウェア部品は .IR ncurses (3) の一部です。 このファイルは 6 つの部分に分割されます。すなわち、 ヘッダ、 端末の名称、 ブール値のフラグ、 数値、 文字列、および 文字列テーブルです。 .PP ヘッダセクションはファイルの冒頭にあります。 このセクションは、以下に示す形式の short 型の整数 6 個からなります。 これらの整数は (1) マジックナンバ (8 進で 0432)、 (2) 名称セクションのバイト単位での大きさ、 (3) ブール値のセクションに含まれるバイトの個数、 (4) 数値セクションに含まれる short 型整数の個数、 (5) 文字列セクションに含まれるオフセットの個数 (short 型整数)、 (6) 文字列テーブルのバイト単位での大きさ です。 .PP short 型の整数は 2 個の 8 ビットバイトに格納されています。 最初のバイトは値の最下位 8 ビットを、2 番目のバイトは最上位 8 ビットを 含みます。(すなわち、値は 256*second+first と表現されます。) 値 \-1 は 0377, 0377 で表現されますが、その他の負の値は構文違反です。 一般に、値 \-1 は、あるケーパビリティがその端末に備わっていないことを 示します。 この形式は \s-1VAX\s+1 と \s-1PDP\s+1-11 のハードウェアに 一致するものであることにご注意下さい。これに一致しないハードウェアの マシンでは、整数を 2 個のバイトとして読み込み、結果を算出します。 .PP 次に現れるのは端末名セクションです。 これは、端末のさまざまな名前を `|' 文字で区切って列挙した、 terminfo 記述の最初の行を含みます。 このセクションは 1 個の \s-1ASCII NUL\s+1 文字で終端されます。 .PP ブール型のフラグは、フラグ 1 個につき 1 バイトを占めます。 このバイトは、フラグが存在するかしないかに従って、0 か 1 となる必要があります。 ケーパビリティはファイル に含まれるのと同じ順番に並びます。 .PP 数値セクションが偶数バイト目から開始されるように、 ブール値のセクションと数値セクションの間には、 必要なら 1 個のナルバイトを挿入します。 すべての short 型整数は short 型のワード境界に揃えて配置されます。 .PP 数値セクションはフラグセクションと同様です。 各ケーパビリティは 2 バイトを占め、short 型整数として格納されます。 もし表現された値が \-1 なら、そのケーパビリティは存在しないものと 解釈されます。 .PP 文字列セクションもまた同様です。 各ケーパビリティは上記の形式に従い、2 バイトの short 型整数として 格納されます。 値 \-1 は、ケーパビリティが存在しないことを意味します。 それ以外の場合、値は、文字列テーブルの先頭からのオフセットとして 解釈されます。 ^X や \ec といった記法で示された特殊文字は、その記法を解釈した結果の形で 格納され、印刷可能表現では格納されません。 パッド情報 $ とパラメータ情報 %x は解釈を行なわずそのままの形で 格納されます。 .PP 最後のセクションは文字列テーブルです。これは文字列セクションで参照されている すべての文字列ケーパビリティの値を含みます。 各文字列はナルで終端されています。 .PP .I setupterm ルーチンでは、ファイルに実際に存在するケーパビリティ とは異なるものが予想され得ることにご注意下さい。 .I setupterm が再コンパイルされた後にデータベースが更新される (ファイルにいくつかの未知のエントリが含まれる結果になります)か、 データベースが最後にコンパイルされた後にプログラムが再コンパイルされる (存在しないエントリを生む結果になります)両方の可能性があります。 ルーチン .I setupterm は両方の可能性に備える必要があります \- これが、データ内に個数と大きさが含まれている理由です。 また、新しいケーパビリティは常に、ブール値、数値、文字列の ケーパビリティリストのそれぞれの最後に追加しなければなりません。 .PP 使用例として、 Microterm ACT 4 の記述の 8 進数ダンプをここに収めます。 .nf .sp microterm|act4|microterm act iv, cr=^M, cud1=^J, ind=^J, bel=^G, am, cub1=^H, ed=^_, el=^^, clear=^L, cup=^T%p1%c%p2%c, cols#80, lines#24, cuf1=^X, cuu1=^Z, home=^], .sp .ft CW \s-2000 032 001 \e0 025 \e0 \eb \e0 212 \e0 " \e0 m i c r 020 o t e r m | a c t 4 | m i c r o 040 t e r m a c t i v \e0 \e0 001 \e0 \e0 060 \e0 \e0 \e0 \e0 \e0 \e0 \e0 \e0 \e0 \e0 \e0 \e0 \e0 \e0 \e0 \e0 100 \e0 \e0 P \e0 377 377 030 \e0 377 377 377 377 377 377 377 377 120 377 377 377 377 \e0 \e0 002 \e0 377 377 377 377 004 \e0 006 \e0 140 \eb \e0 377 377 377 377 \en \e0 026 \e0 030 \e0 377 377 032 \e0 160 377 377 377 377 034 \e0 377 377 036 \e0 377 377 377 377 377 377 200 377 377 377 377 377 377 377 377 377 377 377 377 377 377 377 377 * 520 377 377 377 377 \e0 377 377 377 377 377 377 377 377 377 377 540 377 377 377 377 377 377 007 \e0 \er \e0 \ef \e0 036 \e0 037 \e0 560 024 % p 1 % c % p 2 % c \e0 \en \e0 035 \e0 600 \eb \e0 030 \e0 032 \e0 \en \e0\s+2 .ft R .fi .sp .PP いくつかの制限: コンパイル済みのエントリは 4096 バイトを超えることが できません。名前フィールドは 128 バイトを超えることができません。 .SH 関連ファイル \*d/*/* コンパイル済みの端末ケーパビリティデータベース .SH 関連項目 ncurses(3), terminfo(5). diff --git a/ja_JP.eucJP/man/man5/termcap.5 b/ja_JP.eucJP/man/man5/termcap.5 index ff75acdb80..589ba18120 100644 --- a/ja_JP.eucJP/man/man5/termcap.5 +++ b/ja_JP.eucJP/man/man5/termcap.5 @@ -1,2081 +1,2081 @@ .\" 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. .\" .\" @(#)termcap.5 8.3 (Berkeley) 4/16/94 .\" .\" /*************************************************************************** .\" * COPYRIGHT NOTICE * .\" **************************************************************************** .\" * ncurses is copyright (C) 1992-1995 * .\" * Zeyd M. Ben-Halim * .\" * zmbenhal@netcom.com * .\" * Eric S. Raymond * .\" * esr@snark.thyrsus.com * .\" * * .\" * Permission is hereby granted to reproduce and distribute ncurses * .\" * by any means and for any fee, whether alone or as part of a * .\" * larger distribution, in source or in binary form, PROVIDED * .\" * this notice is included with any such distribution, and is not * .\" * removed from any of its header files. Mention of ncurses in any * .\" * applications linked with it is highly appreciated. * .\" * * .\" * ncurses comes AS IS with no warranty, implied or expressed. * .\" * * .\" ***************************************************************************/ .\" .\" %Id: termcap.5,v 1.2.2.2 1998/06/23 05:31:20 hoek Exp % .\" -.\" jpman $Id: termcap.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: termcap.5,v 1.4 1998/06/13 12:34:58 horikawa Stab % .\" FreeBSD jpman project 訳語表 .\" WORD: terminal 端末 .\" WORD: text テキスト .\" WORD: convention 約束 .\" WORD: virtual terminal 仮想端末 .\" WORD: print 印字 .\" WORD: display 描画 .\" WORD: screen 画面 .\" WORD: CRT CRT .\" WORD: attribute 属性 .\" WORD: underline 下線 .\" WORD: standout 強調表示 .\" WORD: column 桁 .\" WORD: row 行 .\" WORD: carriage return キャリッジリターン .\" WORD: home など ホーム(ホームポジション)、home(home キー) .\" など、キーそのものについては英語のままとした .\" WORD: foreground color 前景色 .\" WORD: background color 背景色 .\" WORD: bottom margin 下マージン .\" WORD: top margin 上マージン .\" WORD: bold mode ボールドモード .\" WORD: scroll forward 前進スクロール .\" WORD: scroll backward 後退スクロール .\" WORD: glitch グリッチ (他の端末と不整合な機能) .\" その他 Beehive はメーカ名です(.Ss Glitches and Braindamages 参照)。 .Dd April 16, 1994 .Dt TERMCAP 5 .Os BSD 3 .Sh 名称 .Nm termcap .Nd 端末ケーパビリティのデータベース .Sh 書式 .Nm .Sh 解説 .Nm ファイルは端末に関するデータベースであり、例えば .Xr \&vi 1 や .Xr curses 3 が使用します。 .Nm には、端末が持つケーパビリティと、 操作がどのように行われるのかが記述されています。 パディングの必要性および初期化シーケンスも .Nm に記述されています。 .Pp .Nm のエントリは `:' で区切られた複数個のフィールドからなります。 各端末の最初のエントリは、`|' 文字で区切った端末名です。 最初の名前は、その端末の最も一般的な省略形です。 最後の名前は端末を完全に識別するための長い名前であり、 その他は端末名の類義語です。 最後以外の名前は小文字を使い、空白を含まないようにしてください; 最後の名前は、可読性のために大文字や空白を含んでかまいません。 .Pp 端末名 (最後の冗長なエントリを除く) は次の約束に従い選んでください。 端末を構成するハードウェアの特定の一部を、 .Dq hp2621 のように根幹の名前として選びます。 この名前はハイフンを含んではなりません。 ハードウェアのモードやユーザのプリファレンスは、 ハイフンとモード指示子を追加して示します。 ですから、132 桁モードの .Dq vt100 は .Dq vt100-w になります。可能ならば、以下の接尾辞を使用してください: .Pp .Bd -filled -offset indent .Bl -column indent "With automatic margins (usually default)xx" .Sy 接尾辞 意味 例 -w 広いモード (80 桁超) vt100-w -am 自動マージン付 (通常はデフォルト) vt100-am -nam 自動マージン無し vt100-nam .Pf \- Ar n Ta No "画面上の行数 aaa-60" -na 矢印キー無し (ローカルのままにする) concept100-na .Pf \- Ar \&np Ta No "メモリページ数 concept100-4p" -rv 反転表示 concept100-rv .El .Ed .Sh ケーパビリティ 記述フィールドに、ケーパビリティの意味を示そうとしています。 記述フィールドには次のようなコードが書いてあることがあります: .Pp .Bl -tag -width #[1-9] .It (P) パディングが指定されるかもしれないことを表します。 .It #[1-9] 記述フィールドでは、文字列が (#\fIi\fP) として与えられる引数として .Xr tparm や .Xr tgoto を介して渡されることを示します。 .It (P*) 影響を受ける行数に従いパディングが変化することを示します。 .It (#\d\fIi\fP\u) \fIi\fP 番目のパラメータを表します。 .El .Pp 以下、ブール値のケーパビリティです: .Bd -literal \fBブール値 TCap 記述\fR \fB変数 コード\fR auto_left_margin bw cursor_left は桁 0 から最後の桁に回り込む auto_right_margin am 端末は自動マージンを持つ no_esc_ctlc xb beehive (f1=escape, f2=ctrl C) ceol_standout_glitch xs 強調表示は上書きによって消去されない (hp) eat_newline_glitch xn 80 桁より後の改行は無視される (concept) erase_overstrike eo 空白を上打ちすることで消去可能 generic_type gn 一般的な行タイプ hard_copy hc ハードコピー端末 has_meta_key km メタキーを持ち、最上位ビットをセットする has_status_line hs 追加のステータス行を持つ insert_null_glitch in 挿入モードはナルを区別する memory_above da 画面より上の描画が保存される memory_below db 画面より下の描画が保存される move_insert_mode mi 挿入モードでの移動が安全 move_standout_mode ms 強調表示モードでの移動が安全 over_strike os 端末は上打ちが可能 status_line_esc_ok es ステータス行でエスケープを使用可能 dest_tabs_magic_smso xt 破壊的タブ、強調文字の奇妙な動作 (t1061) tilde_glitch hz ~ を印字できない (hazeltine) transparent_underline ul 下線文字の上打ち xon_xoff xo 端末は xon/xoff のハンドシェークを使用 needs_xon_xoff nx パディングは動作しないので xon/xoff が必要 prtr_silent 5i プリンタ出力は画面にエコーしない hard_cursor HC カーソルが見にくい non_rev_rmcup NR enter_ca_mode は exit_ca_mode を反転しない no_pad_char NP パディング文字が存在しない non_dest_scroll_region ND スクロール領域が非破壊的 can_change cc 端末は既存の色を再定義可能 back_color_erase ut 画面は背景色で消される hue_lightness_saturation hl 端末は HLS カラー表現のみ使用 (tektronix) col_addr_glitch YA 桁位置指定および micro_column_address ケーパビリティは正方向の動きのみ cr_cancels_micro_mode YB cr を使用するとマイクロモードがオフになる has_print_wheel YC オペレータが文字セットを変更する必要がある プリンタ row_addr_glitch YD row_address および micro_row_address は 正方向の動きのみ semi_auto_right_margin YE 最終桁で印字すると cr となる cpi_changes_res YF 文字ピッチを変えると解像度が変わる lpi_changes_res YG 行ピッチを変えると解像度が変わる .Ed .Pp 以下、数値のケーパビリティです: .Bd -literal \fB数値 TCap 記述\fR \fB変数 コード\fR columns co 1 行の桁数 init_tabs it タブの初期設定は # 個の空白ごと lines li 画面もしくはページの行数 lines_of_memory lm 行より大きい場合はメモリの行数、 0 の場合はさまざま .\" => は大小関係を表すのではない See .Sh その他 magic_cookie_glitch sg enter_standout_mode や exit_standout_mode が残す空白文字数 padding_baud_rate pb パディングが必要な最低ボーレート virtual_terminal vt 仮想端末番号 (CB/unix) width_status_line ws ステータス行の桁数 num_labels Nl 画面上のラベル数 label_height lh 各ラベルの行数 label_width lw 各ラベルの桁数 max_attributes ma 端末が扱える属性の最大の組み合わせ maximum_windows MW 定義可能なウィンドウ数の最大 magic_cookie_glitch_ul ug 下線により残される空白数 # # 以下は SVr4 のカラーサポートにより導入 # max_colors Co 画面上の最大色数 max_pairs pa 画面上の色の組の最大数 no_color_video NC 色付きでは使用できないビデオ属性 # # 以下の数値ケーパビリティは SVr4.0 の term 構造体に存在しますが、 # マニュアルには記述されていません。 # これらは SVr4 のプリンタサポートにより追加されました。 # buffer_capacity Ya 印字前にバッファされるバイト数 dot_vert_spacing Yb 1 インチあたりのピン数で表した垂直ピン間隔 dot_horz_spacing Yc 1 インチあたりのドット数で表した水平 ドット間隔 max_micro_address Yd micro_..._address での最大値 max_micro_jump Ye parm_..._micro での最大値 micro_char_size Yf マイクロモードでの文字サイズ micro_line_size Yg マイクロモードでの行サイズ number_of_pins Yh プリントヘッドのピン数 output_res_char Yi 行あたりのユニット数による水平解像度 output_res_line Yj 行あたりのユニット数による垂直解像度 output_res_horz_inch Yk インチあたりのユニット数による水平解像度 output_res_vert_inch Yl インチあたりのユニット数による垂直解像度 print_rate Ym 1 秒あたりの文字数による印字レート wide_char_size Yn 倍幅モードでの文字ステップサイズ buttons BT マウスのボタン数 bit_image_entwining Yo 各ビットイメージ行として渡される数 bit_image_type Yp ビットイメージデバイスのタイプ .Ed .Pp 以下、文字列ケーパビリティです: .Bd -literal \fB文字列 TCap 記述\fR \fB変数 コード\fR back_tab bt 後退タブ (P) bell bl 可聴シグナル (ベル) (P) carriage_return cr キャリッジリターン (P*) change_scroll_region cs 領域を行 #1 から行 #2 までに変更 (P) clear_all_tabs ct 全タブストップをクリア (P) clear_screen cl 画面を消去しカーソルをホームに移動 (P*) clr_eol ce 行末までクリア (P) clr_eos cd 画面末までクリア (P*) column_address ch 絶対指定での水平位置 #1 (P) command_character CC 端末がプロトタイプで設定可能なコマンド文字 cursor_address cm 行 #1 桁 #2 に移動 cursor_down do 1 行下に移動 cursor_home ho カーソルをホームに移動 cursor_invisible vi カーソルを見えなくする cursor_left le 1 つ左に移動 cursor_mem_address CM メモリ相対のカーソル位置指定 cursor_normal ve 通常のカーソル表示にする (cursor_invisible/cursor_visible の無効化) cursor_right nd 1 つ右に移動 cursor_to_ll ll 最終行の最初の桁 cursor_up up 1 行上に移動 cursor_visible vs カーソルを非常に見易くする delete_character dc 文字削除 (P*) delete_line dl 行削除 (P*) dis_status_line ds ステータス行を無効にする down_half_line hd 半行下に移動 enter_alt_charset_mode as 別の文字セット開始 (P) enter_blink_mode mb 点滅オン enter_bold_mode md ボールド (さらに明るい) モードオン enter_ca_mode ti cursor_address を使用するプログラムを開始 する文字列 enter_delete_mode dm 削除モードへ入る enter_dim_mode mh 半輝度モードオン enter_insert_mode im 挿入モードへ入る enter_secure_mode mk ブランクモードオン (文字が見えません) enter_protected_mode mp 保護モードオン enter_reverse_mode mr 反転表示モードオン enter_standout_mode so 強調表示モード開始 enter_underline_mode us 下線モード開始 erase_chars ec #1 個文字を削除 (P) exit_alt_charset_mode ae 別の文字セット終了 (P) exit_attribute_mode me 全属性をオフ exit_ca_mode te cup 使用のプログラムを終了する文字列 exit_delete_mode ed 削除モード終了 exit_insert_mode ei 挿入モードから抜ける exit_standout_mode se 強調表示モードから抜ける exit_underline_mode ue 下線モードから抜ける flash_screen vb 可視ベル (カーソルは移動しません) form_feed ff ハードコピー端末でのページ排出 (P*) from_status_line fs ステータス行からの復帰 init_1string i1 初期化文字列 init_2string is 初期化文字列 init_3string i3 初期化文字列 init_file if 初期化ファイルの名前 insert_character ic 文字挿入 (P) insert_line al 行挿入 (P*) insert_padding ip 挿入された文字の後にパディングを挿入 key_backspace kb backspace キー key_catab ka clear-all-tabs キー key_clear kC clear-screen または erase キー key_ctab kt clear-tab キー key_dc kD delete-character キー key_dl kL delete-line キー key_down kd down-arrow キー key_eic kM 挿入モードで mir や smir により送られる key_eol kE clear-to-end-of-line キー key_eos kS clear-to-end-of-screen キー key_f0 k0 F0 ファンクションキー key_f1 k1 F1 ファンクションキー key_f10 k; F10 ファンクションキー key_f2 k2 F2 ファンクションキー key_f3 k3 F3 ファンクションキー key_f4 k4 F4 ファンクションキー key_f5 k5 F5 ファンクションキー key_f6 k6 F6 ファンクションキー key_f7 k7 F7 ファンクションキー key_f8 k8 F8 ファンクションキー key_f9 k9 F9 ファンクションキー key_home kh home キー key_ic kI insert-character キー key_il kA insert-line キー key_left kl left-arrow キー key_ll kH last-line キー key_npage kN next-page キー key_ppage kP prev-page キー key_right kr right-arrow キー key_sf kF scroll-forward キー key_sr kR scroll-backward キー key_stab kT set-tab キー key_up ku up-arrow キー keypad_local ke 'キーボード送出' モードから抜ける keypad_xmit ks 'キーボード送出' モードに入る lab_f0 l0 非 f0 の時、ファンクションキー f0 のラベル lab_f1 l1 非 f1 の時、ファンクションキー f1 のラベル lab_f10 la 非 f10 の時、ファンクションキー f10 の ラベル lab_f2 l2 非 f2 の時、ファンクションキー f2 のラベル lab_f3 l3 非 f3 の時、ファンクションキー f3 のラベル lab_f4 l4 非 f4 の時、ファンクションキー f4 のラベル lab_f5 l5 非 f5 の時、ファンクションキー f5 のラベル lab_f6 l6 非 f6 の時、ファンクションキー f6 のラベル lab_f7 l7 非 f7 の時、ファンクションキー f7 のラベル lab_f8 l8 非 f8 の時、ファンクションキー f8 のラベル lab_f9 l9 非 f9 の時、ファンクションキー f9 のラベル meta_off mo メタモードオフ meta_on mm メタモードオン (8 ビット目をオン) newline nw 改行 (cr の後に lf が来たように振舞います) pad_char pc パディング文字 (ナルの代り) parm_dch DC #1 文字を削除 (P*) parm_delete_line DL #1 行を削除 (P*) parm_down_cursor DO #1 行下に移動 (P*) parm_ich IC #1 文字を挿入 (P*) parm_index SF #1 行の前進スクロール (P) parm_insert_line AL #1 行を挿入 (P*) parm_left_cursor LE #1 文字左に移動 (P) parm_right_cursor RI #1 文字右に移動 (P*) parm_rindex SR #1 行の後退スクロール (P) parm_up_cursor UP #1 行上に移動 (P*) pkey_key pk 文字列 #2 をタイプする プログラムファンクションキー #1 pkey_local pl 文字列 #2 を実行する プログラムファンクションキー #1 pkey_xmit px 文字列 #2 を転送する プログラムファンクションキー #1 print_screen ps 画面の内容を印字 prtr_off pf プリンタオフ prtr_on po プリンタオン repeat_char rp 文字 #1 を #2 回繰り返す (P*) reset_1string r1 リセット文字列 reset_2string r2 リセット文字列 reset_3string r3 リセット文字列 reset_file rf リセットファイルの名前 restore_cursor rc save_cursor の最後の位置へカーソルを戻す row_address cv 絶対指定での垂直位置 #1 (P) save_cursor sc 現在のカーソル位置を保存 (P) scroll_forward sf テキストを上にスクロール (P) scroll_reverse sr テキストを下にスクロール (P) set_attributes sa ビデオ属性 #1-#9 を定義 (PG9) set_tab st 全ての行において今いる桁にタブを設定 set_window wi 現在のウィンドウを、行 #1-#2 桁 #3-#4 に 設定 tab ta 次の 8 スペースハードウェアタブストップへ タブ to_status_line ts ステータス行へ移動 underline_char uc 文字に下線を引きその後に移動 up_half_line hu 半行上に移動 init_prog iP 初期化プログラムのパス名 key_a1 K1 キーパッドの左上キー key_a3 K3 キーパッドの右上キー key_b2 K2 キーパッドの中央キー key_c1 K4 キーパッドの左下キー key_c3 K5 キーパッドの右下キー prtr_non pO #1 バイトだけプリンタをオンする termcap_init2 i2 2 番目の初期化文字列 termcap_reset rs 端末リセット文字 # # SVr1 のケーパビリティはここまでです。 # IBM の terminfo はここまでは SVr4 と同じですが、ここから先は異なります。 # char_padding rP insert_padding と似ていますが挿入モード時 に使用 acs_chars ac 図形文字セットの組 - def=vt100 plab_norm pn プログラムラベル #1 は文字列 #2 を表示 key_btab kB back-tab キー enter_xon_mode SX xon/xoff ハンドシェークオン exit_xon_mode RX xon/xoff ハンドシェークオフ enter_am_mode SA 自動マージンオン exit_am_mode RA 自動マージンオフ xon_character XN XON 文字 xoff_character XF XOFF 文字 ena_acs eA 別の文字セットを有効にする label_on LO ソフトラベルオン label_off LF ソフトラベルオフ key_beg @1 begin キー key_cancel @2 cancel キー key_close @3 close キー key_command @4 command キー key_copy @5 copy キー key_create @6 create キー key_end @7 end キー key_enter @8 enter/send キー key_exit @9 exit キー key_find @0 find キー key_help %1 help キー key_mark %2 mark キー key_message %3 message キー key_move %4 move キー key_next %5 next キー key_open %6 open キー key_options %7 options キー key_previous %8 previous キー key_print %9 print キー key_redo %0 redo キー key_reference &1 reference キー key_refresh &2 refresh キー key_replace &3 replace キー key_restart &4 restart キー key_resume &5 resume キー key_save &6 save キー key_suspend &7 suspend キー key_undo &8 undo キー key_sbeg &9 シフト状態の begin キー key_scancel &0 シフト状態の cancel キー key_scommand *1 シフト状態の command キー key_scopy *2 シフト状態の copy キー key_screate *3 シフト状態の create キー key_sdc *4 シフト状態の delete char キー key_sdl *5 シフト状態の delete line キー key_select *6 select キー key_send *7 シフト状態の end キー key_seol *8 シフト状態の end-of-line キー key_sexit *9 シフト状態の exit キー key_sfind *0 シフト状態の find キー key_shelp #1 シフト状態の help キー key_shome #2 シフト状態の home キー key_sic #3 シフト状態の insert char キー key_sleft #4 シフト状態の left キー key_smessage %a シフト状態の message キー key_smove %b シフト状態の move キー key_snext %c シフト状態の next キー key_soptions %d シフト状態の options キー key_sprevious %e シフト状態の previous キー key_sprint %f シフト状態の print キー key_sredo %g シフト状態の redo キー key_sreplace %h シフト状態の replace キー key_sright %i シフト状態の right キー key_srsume %j シフト状態の resume キー key_ssave !1 シフト状態の save キー key_ssuspend !2 シフト状態の suspend キー key_sundo !3 シフト状態の undo キー req_for_input RF 次の入力文字を送る (pty で使用) key_f11 F1 F11 ファンクションキー key_f12 F2 F12 ファンクションキー key_f13 F3 F13 ファンクションキー key_f14 F4 F14 ファンクションキー key_f15 F5 F15 ファンクションキー key_f16 F6 F16 ファンクションキー key_f17 F7 F17 ファンクションキー key_f18 F8 F18 ファンクションキー key_f19 F9 F19 ファンクションキー key_f20 FA F20 ファンクションキー key_f21 FB F21 ファンクションキー key_f22 FC F22 ファンクションキー key_f23 FD F23 ファンクションキー key_f24 FE F24 ファンクションキー key_f25 FF F25 ファンクションキー key_f26 FG F26 ファンクションキー key_f27 FH F27 ファンクションキー key_f28 FI F28 ファンクションキー key_f29 FJ F29 ファンクションキー key_f30 FK F30 ファンクションキー key_f31 FL F31 ファンクションキー key_f32 FM F32 ファンクションキー key_f33 FN F33 ファンクションキー key_f34 FO F34 ファンクションキー key_f35 FP F35 ファンクションキー key_f36 FQ F36 ファンクションキー key_f37 FR F37 ファンクションキー key_f38 FS F38 ファンクションキー key_f39 FT F39 ファンクションキー key_f40 FU F40 ファンクションキー key_f41 FV F41 ファンクションキー key_f42 FW F42 ファンクションキー key_f43 FX F43 ファンクションキー key_f44 FY F44 ファンクションキー key_f45 FZ F45 ファンクションキー key_f46 Fa F46 ファンクションキー key_f47 Fb F47 ファンクションキー key_f48 Fc F48 ファンクションキー key_f49 Fd F49 ファンクションキー key_f50 Fe F50 ファンクションキー key_f51 Ff F51 ファンクションキー key_f52 Fg F52 ファンクションキー key_f53 Fh F53 ファンクションキー key_f54 Fi F54 ファンクションキー key_f55 Fj F55 ファンクションキー key_f56 Fk F56 ファンクションキー key_f57 Fl F57 ファンクションキー key_f58 Fm F58 ファンクションキー key_f59 Fn F59 ファンクションキー key_f60 Fo F60 ファンクションキー key_f61 Fp F61 ファンクションキー key_f62 Fq F62 ファンクションキー key_f63 Fr F63 ファンクションキー clr_bol cb 行頭までクリア clear_margins MC 左右のソフトマージンをクリア set_left_margin ML 左のソフトマージンを設定 set_right_margin MR 右のソフトマージンを設定 label_format Lf ラベルフォーマット set_clock SC 時刻を #1 時 #2 分 #3 秒に設定 display_clock DK 位置 (#1,#2) に時計を表示 remove_clock RC 時計を取り除く create_window CW ウィンドウ #1 を #2, #3 から #4, #5 までと 定義 goto_window WG ウィンドウ #1 に移動 hangup HU 電話をハングアップする dial_phone DI 番号 #1 にダイアルする quick_dial QD チェックせずに番号 #1 にダイアルする tone TO タッチトーンダイアルを選択 pulse PU パルスダイアルを選択 flash_hook fh スイッチフックをフラッシュする fixed_pause PA 2-3 秒待つ wait_tone WA ダイアルトーンを待つ user0 u0 ユーザ文字列 #0 user1 u1 ユーザ文字列 #1 user2 u2 ユーザ文字列 #2 user3 u3 ユーザ文字列 #3 user4 u4 ユーザ文字列 #4 user5 u5 ユーザ文字列 #5 user6 u6 ユーザ文字列 #6 user7 u7 ユーザ文字列 #7 user8 u8 ユーザ文字列 #8 user9 u9 ユーザ文字列 #9 # # SVr4 は以下のケーパビリティを追加してカラーをサポートしました # orig_pair op デフォルトのペアを元の値に戻す orig_colors oc 色のペア全てを元に戻す initialize_color Ic 色 #1 を (#2,#3,#4) に設定 initialize_pair Ip 色のペア #1 を fg=(#2,#3,#4), bg=(#5,#6,#7) に設定 set_color_pair sp 現在の色のペアを #1 に設定 set_foreground Sf 前景色を #1 に設定 set_background Sb 背景色を #1 に設定 # # SVr4 は以下のケーパビリティを追加してプリンタをサポートしました # change_char_pitch ZA 1 インチあたりの文字数を変更 change_line_pitch ZB 1 インチあたりの行数を変更 change_res_horz ZC 水平解像度を変更 change_res_vert ZD 垂直解像度を変更 define_char ZE 文字を定義 enter_doublewide_mode ZF 倍幅モードに入る enter_draft_quality ZG ドラフト印字モードに入る enter_italics_mode ZH イタリックモードに入る enter_leftward_mode ZI キャリッジの左向き移動開始 enter_micro_mode ZJ マイクロ移動モードに入る enter_near_letter_quality ZK NLQ 印字モードに入る enter_normal_quality ZL 通常品質印字モードに入る enter_shadow_mode ZM シャドウプリントモード開始 enter_subscript_mode ZN 下付き文字モード enter_superscript_mode ZO 上付き文字モード enter_upward_mode ZP キャリッジの上向き移動開始 exit_doublewide_mode ZQ 倍幅印字モード終了 exit_italics_mode ZR イタリックモード終了 exit_leftward_mode ZS 左向き移動モード終了 exit_micro_mode ZT マイクロ移動モード終了 exit_shadow_mode ZU シャドウプリントモード終了 exit_subscript_mode ZV 下付き文字モード終了 exit_superscript_mode ZW 上付き文字モード終了 exit_upward_mode ZX 逆向き文字移動終了 micro_column_address ZY マイクロモードの column_address micro_down ZZ マイクロモードの cursor_down micro_left Za マイクロモードの cursor_left micro_right Zb マイクロモードの cursor_right micro_row_address Zc マイクロモードの row_address micro_up Zd マイクロモードの cursor_up order_of_pins Ze ソフトウェアビットを印字ヘッドピンに あわせる .\" Match software bits to print-head pins ？ parm_down_micro Zf マイクロモードの parm_down_cursor parm_left_micro Zg マイクロモードの parm_left_cursor parm_right_micro Zh マイクロモードの parm_right_cursor parm_up_micro Zi マイクロモードの parm_up_cursor select_char_set Zj 文字セットの選択 set_bottom_margin Zk 現在の行を下マージンに設定 set_bottom_margin_parm Zl 下マージンを行 #1 または下から #2 行に設定 set_left_margin_parm Zm 左 (右) マージンを桁 #1 (#2) に設定 set_right_margin_parm Zn 右マージンを桁 #1 に設定 set_top_margin Zo 上マージンを現在の行に設定 set_top_margin_parm Zp 上 (下) マージンを行 #1 (#2) に設定 start_bit_image Zq ビットイメージグラフィクスの印刷開始 start_char_set_def Zr 文字セットの定義開始 stop_bit_image Zs ビットイメージグラフィクスの印刷停止 stop_char_set_def Zt 文字セットの定義終了 subscript_characters Zu 下付き文字となりうる文字のリスト superscript_characters Zv 上付き文字となりうる文字のリスト these_cause_cr Zw 印字すると CR となる文字 zero_motion Zx 次の文字表示では移動しない # # 以下の文字列ケーパビリティは SVr4.0 の term 構造体にありますが、 # マニュアルページには記述されていません。 # char_set_names Zy 文字セット名のリスト key_mouse Km マウスイベントが発生した mouse_info Mi マウス状態の情報 req_mouse_pos RQ マウス位置の要求 get_mouse Gm curses がボタンイベントを取得すべき set_a_foreground AF ANSI 前景色を設定 set_a_background AB ANSI 背景色を設定 pkey_plab xl 文字列 #2 をタイプし、文字列 #3 を表示する プログラムファンクションキー device_type dv 言語/コードセットサポートの表示 code_set_init ci 複数コードセットシーケンスの初期化 set0_des_seq s0 コードセット 0 へシフト (EUC セット 0, ASCII) set1_des_seq s1 コードセット 1 へシフト set2_des_seq s2 コードセット 2 へシフト set3_des_seq s3 コードセット 3 へシフト set_lr_margin ML 左右マージンをそれぞれ #1, #2 に設定 set_tb_margin MT 上下マージンをそれぞれ #1, #2 に設定 bit_image_repeat Xy ビットイメージセル #1 を #2 回繰り返す bit_image_newline Zz ビットイメージの次の行に移動 bit_image_carriage_return Yv 同一行の先頭に移動 color_names Yw 色 #1 の名前を与える define_bit_image_region Yx 長方形のビットイメージ領域を定義 end_bit_image_region Yy ビットイメージ領域の終了 set_color_band Yz 色リボン #1 に変更 set_page_length YZ ページ長を #1 行に設定 # # SVr4 は以下のケーパビリティを追加し、直接 PC クローンをサポートしました # display_pc_char S1 PC 文字を表示 enter_pc_charset_mode S2 PC 文字表示モードに入る exit_pc_charset_mode S3 PC 文字表示モード終了 enter_scancode_mode S4 PC スキャンコードモードに入る exit_scancode_mode S5 PC スキャンコードモードから抜ける pc_term_options S6 PC 端末オプション scancode_escape S7 スキャンコードエミュレーションのための エスケープ alt_scancode_esc S8 スキャンコードエミュレーションのための 別のエスケープ # # XSI curses 標準は、以下のケーパビリティを追加しました。 # enter_horizontal_hl_mode Xh 水平ハイライトモードに入る enter_left_hl_mode Xl 左ハイライトモードに入る enter_low_hl_mode Xo 下ハイライトモードに入る enter_right_hl_mode Xr 右ハイライトモードに入る enter_top_hl_mode Xt 上ハイライトモードに入る enter_vertical_hl_mode Xv 垂直ハイライトモードに入る .Pp 以下は廃れた termcap ケーパビリティです。 新しいソフトウェアはどれにも依存しないようにしてください。 .Bd -literal \fBブール値 TCap 記述\fR \fB変数 コード\fR linefeed_is_newline NL ^J で下に移動 even_parity EP 端末は偶数パリティを要求 odd_parity OP 端末は奇数パリティを要求 half_duplex HD 端末は半 2 重 lower_case_only LC 端末は小文字のみ持つ upper_case_only UC 端末は大文字のみ持つ has_hardware_tabs pt ^I で起動される 8 文字タブがある return_does_clr_eol xr リターンは行をクリアする tek_4025_insert_line xx Tektronix 4025 の insert-line グリッチ backspaces_with_bs bs 左に移動するために ^H を使用 crt_no_scrolling ns crt はスクロールできない no_correctly_working_cr nc 行頭に行く手段が無い .Ed .Bd -literal \fB数値 TCap 記述\fR \fB変数 コード\fR backspace_delay dB ^H に必要なパディング form_feed_delay dF ^L に必要なパディング horizontal_tab_delay dT ^I に必要なパディング vertical_tab_delay dV ^V に必要なパディング number_of_function_keys kn ファンクションキーの数 carriage_return_delay dC CR に必要なパディング new_line_delay dN LF に必要なパディング .Ed .Bd -literal \fB文字列 TCap 記述\fR \fB変数 コード\fR other_non_function_keys ko 自己にマップされたキーのリスト arrow_key_map ma 矢印キーを rogue(1) の移動キーにマップ memory_lock_above ml 現在の行より上の画面で見える部分のメモリを ロック memory_unlock mu 現在の行より上の画面で見える部分のメモリの ロックを解除 linefeed_if_not_lf nl 下に移動するために使用 backspace_if_not_bs bc ^H でない場合に左に移動 .Ed .Ss エントリのサンプル 以下のエントリは Concept\-100 について記述しており、 本書の中でも最も複雑なエントリの 1 つです。 .Pp .Bd -literal ca\||\|concept100\||\|c100\||\|concept\||\|c104\||\|concept100-4p\||\|HDS Concept\-100:\e :al=3*\eE^R:am:bl=^G:cd=16*\eE^C:ce=16\eE^U:cl=2*^L:cm=\eEa%+ %+ :\e :co#80:.cr=9^M:db:dc=16\eE^A:dl=3*\eE^B:do=^J:ei=\eE\e200:eo:im=\eE^P:in:\e :ip=16*:is=\eEU\eEf\eE7\eE5\eE8\eEl\eENH\eEK\eE\e200\eEo&\e200\eEo\e47\eE:k1=\eE5:\e :k2=\eE6:k3=\eE7:kb=^h:kd=\eE<:ke=\eEx:kh=\eE?:kl=\eE>:kr=\eE=:ks=\eEX:\e :ku=\eE;:le=^H:li#24:mb=\eEC:me=\eEN\e200:mh=\eEE:mi:mk=\eEH:mp=\eEI:\e :mr=\eED:nd=\eE=:pb#9600:rp=0.2*\eEr%.%+ :se=\eEd\eEe:sf=^J:so=\eEE\eED:\e :.ta=8\et:te=\eEv \e200\e200\e200\e200\e200\e200\eEp\er\en:\e :ti=\eEU\eEv 8p\eEp\er:ue=\eEg:ul:up=\eE;:us=\eEG:\e :vb=\eEk\e200\e200\e200\e200\e200\e200\e200\e200\e200\e200\e200\e200\e200\e200\eEK:\e :ve=\eEw:vs=\eEW:vt#8:xn:\e :bs:cr=^M:dC#9:dT#8:nl=^J:ta=^I:pt: .Ed .Pp 行末文字に \e を使用すれば、複数行にエントリを続けることができます。 また空のフィールドを含めて可読性を上げることもできます (ある行の最後のフィールドから次の行の最初のフィールドまでです)。 コメントは .Dq # で始まる行に含めることができます。 .Ss ケーパビリティの型 .Nm のケーパビリティには次の 3 種類があります: 特定の機能を端末が持つかどうかを示す、ブール値ケーパビリテイ; 画面の大きさや他の属性の大きさを与える、数値ケーパビリティ; そして特定の端末操作を行うために使用可能な文字列を与える、 文字列ケーパビリティです。 全てのケーバビリティが 2 文字のコードを持ちます。 例えば、Concept が .Em 自動マージン (行末に到達すると、自動的にリターンおよびラインフィードする機能) を持つという事実は、ブール値ケーパビリティ .Sy \&am で示されます。 それゆえ Concept の記述は .Sy \&am を含みます。 .Pp 数値ケーパビリティの後には文字 `#' が続き、そして値が続きます。 上の例では、画面の桁数を示す .Sy \&co は Concept に対しては値 `80' を与えます。 .Pp 最後に、文字列値のケーパビリティ、例えば .Sy \&ce (行末までクリアのシーケンス) は、2 文字のコード、単一の `='、 そして次の `:' までの文字列で与えられます。 このケーパビリティにおいては、ミリ秒指定の遅延を `=' の後に指定可能です。 この場合、残りの文字列が送られた後、パディング文字が .Xr tputs により与えられ、この遅延を発生させます。 遅延は `20' のような数値または `3*' のような `*' が続く数値です。 `*' は、 この操作により影響を受ける行数に必要なパディングが比例すること、 そして指定量は影響を受ける各行に必要なパディングであることを示します。 (insert-character の場合でも、係数は影響を受ける .Em 行 数です; ただし、端末が .Sy \&in を持っていてソフトウェアがこれを使用する場合以外は、この値は常に 1 です。) `*' が指定される時、`3.5' のような形式により 1/10 ミリ秒単位で 行あたりの遅延を指定するのが便利な場合があります。 (10 進数 1 桁分のみ許されます。) .Pp 多くのエスケープシーケンスが文字列値のケーパビリティで提供されますので、 ここでは容易に制御文字をエンコードできます。 .Sy \&\eE は .Dv ESC 文字にマップし、 .Sy \&^X は適切な X に対して control-X にマップし、シーケンス .Sy \&\en .Sy \&\er .Sy \&\et .Sy \&\eb .Sy \&\ef はそれぞれ、ラインフィード、リターン、タブ、バックスペース、フォームフィード にマップします。 最後に、文字は .Sy \&\e の後に 3 桁 8 進数として指定可能ですし、 .Sy \&^ と .Sy \&\e の文字は .Sy \&\e^ と .Sy \&\e\e として与えられます。 ケーパビリティ中に .Sy \&: を入れる必要がある場合、8 進数で .Sy \&\e072 とエスケープする必要があります。 文字列ケーパビリティ中に .Dv NUL 文字を入れる必要がある場合、 .Sy \&\e200 とエンコードする必要があります。( .Nm を扱うルーチンは C の文字列を使用し、 出力の最上位ビットをかなり遅い段階で取り除くので、 .Sy \&\e200 は .Sy \&\e000 として出力されます。) .Pp 個々のケーパビリティをコメントアウトする必要があるかもしれません。 その場合には、ケーパビリティ名の前にピリオドを付けます。 例えば、例における最初の .Sy \&cr と .Sy \&ta を見てください。 .Ss 記述の準備 端末記述を準備する最も効果的な方法は、 .Nm 中の似た端末の記述を真似し、 .Xr \&vi を使用して部分記述の正しさを確認することにより、 徐々に記述を構築するというものです。 非常に稀なことですが、端末によっては、 .Nm ファイルの記述能力不足や .Xr \&vi のバグが露呈することがありますので注意してください。 あなたが新しく作った端末記述を簡単にテストするには、 あなたのホームディレクトリに .Pa .termcap という名前のファイルとして置き、 プログラムが .Pa /usr/share/misc/termcap の前にこれを見るようにします。 環境変数 .Ev TERMPATH をあなたが作成した記述を含む絶対ファイルパス名のリスト (空白もしくはコロンで区切ります) に設定することにより、 プログラムはこれらをリスト順に検索し、他は検索しないようになります。 .Xr termcap 3 を参照してください。 .Ev TERMCAP 環境変数は、通常 .Nm エントリ自身に設定され、プログラム起動時にファイルを読むことを避けます。 .Pp 行挿入に対する適切なパディングを得るためには (端末製造元が記述しなかった場合には)、 .Xr \&vi を使用して .Pa /etc/passwd を 9600 ボーで編集し、およそ 16 行を画面中央から削除し、 それから `u' キーを何度か素早く押すという、厳しいテストを行います。 画面がぐちゃぐちゃになった場合には、 通常はより多くのパディングが必要となります。 同様のテストを文字挿入に対しても行うことが可能です。 .Ss 基本ケーパビリティ 表示の各行の桁数は .Sy \&co 数値ケーパビリティで与えられます。 表示が .Tn CRT になされる場合、画面の行数は .Sy \&li ケーパビリティで与えられます。 カーソルが右マージンに到達した時に、表示が次の行の先頭に回り込む場合には、 .Sy \&am ケーパビリティを持ちます。 端末が画面をクリア可能な場合には、そうするためのコードが .Sy \&cl 文字列ケーパビリティで与えられます。 端末が (上書きされる文字の位置をクリアするのではなく) 上打ちする場合には、 .Sy \&os ケーパビリティがあります。 端末がプリント端末でソフトコピーユニットを持たない場合、 .Sy \&hc と .Sy \&os を指定してください。 .Pf ( Sy \&os があてはまるのは Tektronix 4010 シリーズのようなストレージスコープ端末、 ハードコピー端末、そして .Tn APL 端末です。) カーソルを直ちに左端に移動するためのコードがある場合には、それを .Sy \&cr で指定します。 (通常これは復帰文字(キャリッジリターン)、すなわち .Sy \&^M です。) 可聴シグナル (ベルやビープなど) を発生するコードがある場合には、それを .Sy \&bl で指定します。 .Pp (バックスペースのように) カーソルを 1 つ左に移動するコードがある場合には、 このケーパビリテイは .Sy \&le で指定します。 同様に、右上下に移動するコードはそれぞれ .Sy \&nd , .Sy \&up , .Sy \&do で指定します。 これらの .Em ローカルなカーソル移動 は、カーソルが通過する文字を変化させてはなりません; 例えば、通常は .Dq nd=\ \& を使用してはなりません。例外は 端末が .Sy \&os ケーパビリティを持つ場合です。 この理由は、通過する文字を空白が消してしまうからです。 .Pp ここで非常に重要なポイントは、 .Nm でエンコードされるローカルなカーソル移動は、 .Tn CRT 表示の左端および上端では動作が未定義だということです。 ローカルなカーソル移動を使用している場合には、 左端においては .Sy \&bw が与えられているのでなければ、 プログラムはバックスペースを試してはなりませんし、 上端においては上への移動を試してはなりません。 .Pp テキストを上にスクロールするには、プログラムは画面左下角に移動して、 .Sy \&sf (インデックス) 文字列を送ります。 テキストを下にスクロールするには、プログラムは画面左上角に移動して、 .Sy \&sr (逆インデックス) 文字列を送ります。 期待された角以外での .Sy \&sf および .Sy \&sr 文字列の動作は未定義です。 パラメータ化したバージョンのスクロールシーケンスは .Sy \&SF および .Sy \&SR で、 .Sy \&sf および .Sy \&sr と同様の意味ですが、 1 つパラメータを取ってその行数だけスクロールさせるというところが違います。 これらもまた、画面上の適切な角以外での動作は未定義です。 .Pp .Sy \&am ケーパビリティは、画面の右端にてテキスト出力を行った時に、 カーソルがその位置に留まるか否かを示します。 しかしこれは、最後の桁での .Sy \&nd を必ずしも意味しません。 左端らかの左向きのローカル移動は、 .Sy \&bw が与えられている場合のみ定義されます; この場合、左端における .Sy \&le は、直前行の右端へ移動します。 例えば、画面の周囲に箱を描画する場合に便利です。 端末が切替選択式の自動マージンを持つ場合には、 .Nm 記述は通常この機能、 .Em すなわち .Sy \&am がオンであることを仮定します。 次行の先頭桁への移動コマンドを端末が持つ場合、このコマンドは .Sy \&nw (改行) で与えることができます。 これを使用して現在の行の残りの部分をクリアすることができますので、 正しく動作する .Tn \&CR および .Tn \&LF を持たない場合には、これらの代りに使用することができます。 .Pp これらの機能で、ハードコピー端末および .Dq ガラスの tty 端末を記述するためには十分です。 Teletype model 33 は以下のように記述されています .Bd -literal -offset indent T3\||\|tty33\||\|33\||\|tty\||\|Teletype model 33:\e :bl=^G:co#72:cr=^M:do=^J:hc:os: .Ed .Pp また Lear Siegler .Tn ADM Ns \-3 は以下のように記述されています .Bd -literal -offset indent l3\||\|adm3\||\|3\||\|LSI \s-1ADM\s0-3:\e :am:bl=^G:cl=^Z:co#80:cr=^M:do=^J:le=^H:li#24:sf=^J: .Ed .Ss パラメータ化された文字列 カーソル位置設定などのパラメータを要求する文字列は、 パラメータ化された文字列ケーパビリティで記述します。 ここでは .Xr printf 3 に似たエスケープ .Sy \&%x を使用します。その他の文字は変更されずに渡されます。 例えば、カーソル位置設定のために .Sy \&cm ケーパビリティが与えられますが、これは 2 つのパラメータを使用します: それぞれ移動先の行と桁です。 (行と桁は 0 から番号が振られ、ユーザから見える物理画面を参照します。 見えないメモリは参照しません。 端末がメモリ相対のカーソル位置設定機能を持つ場合には、 .Sy \&CM という似たケーパビリティで指定されます。) .Pp .Sy \&% エンコードは以下の意味を持ちます: .Bl -column xxxxx .It %% Ta No `%' を出力 .It "%d 値を" .Xr printf %d のように出力 .It "%2 値を" .Xr printf %2d のように出力 .It "%3 値を" .Xr printf %3d のように出力 .It "%. 値を" .Xr printf %c のように出力 .It "%+" Ns Em x Ta No 値に .Em x を加え、% を実行 .It "%>" Ns Em \&xy Ta No もし 値 \&> .Em x の場合には .Em y を加える。無出力 .It "%r 2 つのパラメータの順を逆転。無出力" .It "%i 1 増加。無出力" .It "%n 全パラメータに関した 0140 との排他的論理和 (Datamedia 2500)" .It "%B" Ta Tn BCD No "(16*(value/10)) + (value%10) を実行。無出力" .It "%D 逆コーディング (value \- 2*(value%16))。無出力 (Delta Data)" .El .Pp Hewlett-Packard 2645 において第 3 行第 12 桁に移動する場合、 .Dq \eE&a12c03Y を送って 6 ミリ秒パディングする必要があります。 行と桁の関係がここでは逆であり、行および桁は 2 桁の整数として送る ことに注意してください。 よって、この端末の .Sy \&cm ケーパビリティは .Dq Li cm=6\eE&%r%2c%2Y となります。 .Pp Datamedia 2500 は現在の行と桁を .Dq \&%. でバイナリエンコードして送る必要があります。 .Dq \&%. を使用する端末は、カーソルをバックスペース .Po Sy \&le Pc させる機能と画面上で 1 行カーソルを上に移動 .Po Sy \&up Pc する機能を持つ必要があります。 なぜなら .Sy \&\en , .Sy \&^D , .Sy \&\er を送出するのは常に安全というわけではなく、 システムがこれらに変更を加えたり捨てたりする場合があるからです。( .Nm を使用するプログラムは、タブが展開されないように端末モードを設定し、 .Sy \&\et が安全に送られるようにしなければなりません。 これは Ann Arbor 4080 において本質的です。) .Pp 最後の例は Lear Siegler .Tn ADM Ns \-3a です。この端末では行と桁は空白文字で与えますので、 .Dq Li cm=\eE=%+ %+\ となります。 .Pp 絶対値での行や桁のカーソル位置設定は、単一パラメータのケーパビリティ .Sy \&ch (水平絶対位置) および .Sy \&cv (垂直絶対位置) で与えられます。 一般的な 2 パラメータシーケンスよりもこれらを使用する方が短かいことがあり (Hewlett-Packard 2645 の場合)、 .Sy \&cm よりも好んで使用され得ます。 パラメータ化されたローカル移動 .Pf ( Em 例えば 、 .Ar n 個右に移動) の機能がある場合、 .Sy \&DO , .Sy \&LE , .Sy \&RI , .Sy \&UP として与えられます。これらは単一パラメータを取り、 いくつ移動するのかを示します。 第 1 に Tektronix 4025 のような .Sy \&cm を持たない端末で有用です。 .Ss カーソル移動 .Pp 端末が高速にカーソルをホーム (画面の左上角) に移動する方法がある場合、これは .Sy \&ho として与えられます。 同様に、高速に左下角に移動する方法は、 .Sy \&ll で与えられます; これには、ホームポジションにて .Sy \&up を使用することによる上への移動を含みますが、 プログラム自身がこれを実行してはなりません (ただし .Sy \&ll が実行する場合を除く)。 なぜならプログラムはホームポジションでの上への移動の効果を 仮定できないからです。) ホームポジションは、カーソル位置 (0,0) と同じです: 画面の左上角であり、メモリは無関係です。 (それゆえ、Hewlett-Packard 端末の .Dq \eEH シーケンスは、 .Sy \&ho としては使用できません。) .Ss 領域クリア 端末が、現在位置に留まりつつ、現在位置から行末までクリア可能である場合には、 この機能は .Sy \&ce として与えられます。 端末が、現在位置から描画終端までをクリア可能である場合には、この機能は .Sy \&cd として与えられます。 .Sy \&cd は行の最初の桁においてのみ起動可能です。(よって、真の .Sy \&cd が利用できない場合、この機能は多数の行を削除する要求にてシミュレート可能です。) .Ss 行の挿入および削除 端末が、カーソルがいる行の前に新しい空行を開けることが可能な場合、この機能は .Sy \&al として与えられます; この機能を起動するには行頭にいる必要があります。 行を開けると、カーソルは新しい空行の左端に移動します。 端末が、カーソルがいる行を削除可能な場合、この機能は .Sy \&dl として与えられます； この機能を起動するには削除する行の先頭にいる必要があります。 1 つパラメータを取ってその数だけ行を挿入および削除する .Sy \&al および .Sy \&dl の変形は、 .Sy \&AL および .Sy \&DL として与えられます。 端末が、(VT100 のように) 設定可能なスクロール領域を持つ場合、 設定コマンドは 2 つのパラメータを取る .Sy \&cs ケーパビリティとして記述されます: パラメータはスクロール領域の上端行および下端行です。 なんとしたことか、このコマンド使用後のカーソル位置は未定義です。 行挿入および行削除の効果はこのコマンドを使用することで得られます \(em .Sy \&sc および .Sy \&rc (カーソルの保存と回復) コマンドもまた有用です。 画面の上端または下端における行挿入は、 真の行挿入/削除を持たない多くの端末において、 .Sy \&sr または .Sy \&sf にて実行できます。 また、真の行挿入/削除機能を持つ端末においても、 こちらの方が高速な場合が多いです。 .Pp メモリの一部を、 全コマンドが影響するウィンドウとして定義する能力を端末が持つ場合、 これはパラメータ化された文字列 .Sy \&wi で与えられます。 4 つのパラメータは順番に、メモリにおける開始行・終了行・開始桁・終了桁です。 (この .Xr terminfo ケーパビリティは完全性のために記述しています。 .Nm を使用するプログラムはこの機能を使ってはいないでしょう。) .Pp 端末が画面より上方の表示メモリを保存する場合、 .Sy \&da ケーパビリティが与えられます; 下方の表示メモリが保存される場合、 .Sy \&db が与えられます。 これらの機能は、 行削除やスクロールにより非空白行が下から現れることや、 .Sy \&sr による後退スクロールにより非空白行が上から現れることを示します。 .Ss 文字の挿入および削除 .Nm にて記述可能な文字挿入および削除に関しては、 基本的に 2 種類のインテリジェント端末があります。 最も一般的な文字の挿入/削除操作は現在行の文字にのみ作用し、 行末までの文字を厳格にシフトします。 他の端末、Concept\-100 や Perkin Elmer Owl では、 タイプされた空白とタイプされたものではない空白を区別し、 挿入/削除に際するシフトは 画面上のタイプされたものではない空白にのみ適用されます。 タイプされたものではない空白は、削除されるか、 2 つのタイプされたものではない空白に拡張されます。 使用している端末の種類を判別するためには、 画面をクリアし、カーソル移動を含めてテキストをタイプします。例えば .Dq Li abc\ \ \ \ def を、 .Dq abc と .Dq def の間でローカルなカーソル移動 (空白ではありません) を行ってタイプします。 その後、カーソルを .Dq abc の前に移動し、端末を挿入モードにします。 そこで文字をタイプすると 行の残りの部分が厳密にシフトされ終端から出て行く場合、 あなたの端末は空白とタイプされたものではない位置とを区別しません。 もし挿入に際して、 .Dq abc が .Dq def のところまでシフトし、 それから一緒に現在の行の終端まで移動して次行に移動する場合、 あなたの端末は 2 番目の種類の端末を持っていますので、 .Dq ナル挿入 を表すケーパビリティ .Sy \&in を指定します。 これら 2 つは論理的に別の属性 (1 行 .Em 対 複数行の挿入モードでタイプされたものではない空白を特別に扱う) ですが、 挿入モードをどちらかで記述できない端末を我々は見たことがありません。 .Pp .Nm エントリは、挿入モードを持つ端末も、 単純なシーケンスを送って現在の行に空白位置を開ける端末も、両方記述可能です。 .Sy \&im は挿入モードに入るシーケンスを表します。 .Sy \&ei は挿入モードから抜けるシーケンスを表します。そして、 .Sy \&ic は、挿入する文字を送る直前に送る必要があるシーケンスを表します。 真の挿入モードを持つほとんどの端末は、 .Sy \&ic を指定しません; 一方、画面上の位置を開けるためにシーケンスを使用する端末は、 これを指定する必要があります。 (端末が両方の機能を持つ場合には、挿入モードは通常 .Sy \&ic が好まれます。実際に両機能を組み合せる必要がある端末の場合以外は、 両方を指定しないでください。) 挿入後にパディングが必要な場合、ミリ秒数にて .Sy \&ip (文字列オプション) で与えます。 1 文字挿入後に送る必要があるシーケンスもまた .Sy \&ip で指定します。`挿入モード' である必要があり、 なおかつ挿入文字の前に特別のコードを送る必要がある端末の場合、 .Sy \&im Ns / Sy \&ei と .Sy \&ic が与えられ、両方を使用します。 単一のパラメータ .Em n を取る .Sy \&IC ケーパビリティは、 .Sy \&ic の効果を .Em n 回繰り返します。 .Pp 挿入モード中で同一行の文字を削除するために、時々移動が必要になります .Pf ( Em 例えば 挿入位置の後にタブがある場合)。 挿入モード中で移動を許す端末の場合、ケーパビリティ .Sy \&mi を指定して、このような場合の挿入を高速化できます。 .Sy \&mi を省略しても速度に影響するだけです。 端末によっては (特に Datamedia のものでは)、挿入モードの動作方法の理由により、 .Sy \&mi を指定してはなりません。 .Pp 最後に、1 文字削除のために .Sy \&dc を指定可能です。 .Sy \&DC は単一パラメータ .Em n を取り .Em n 文字削除します。 そして削除モードは、 .Sy \&dm および .Sy \&ed で、削除モードの入り方および抜け方を示します (削除モードとは、 .Sy \&dc が動作するために端末がいるべきモードです)。 .Ss ハイライト・下線・可視ベル 端末が 1 つまたはそれ以上の種類の表示属性を持つ場合、 これらは様々な方法で表現されていることでしょう。 1 つの表示形式を .Em 強調表示モード として選択してください。このモードは十分高いコントラストで見易く、 エラーメッセージや注意を引く表示のハイライトに適します。 (選択可能ならば、反転表示に半分の明るさ、もしくは反転表示のみが良いでしょう。) 強調表示モードに入るシーケンスおよび出るシーケンスは、それぞれ .Sy \&so および .Sy \&se で与えられます。 .Tn TVI 912 や Teleray 1061 のように、 強調表示モードの出入りのコードが、 1 つ 2 つの空白やごみの文字を画面上に残す場合、 .Sy \&sg を指定して、何文字残されるのかを指定してください。 .Pp 下線の開始および下線の終了は、それぞれ .Sy \&us および .Sy \&ue で指定します。 下線モード変更によるごみは、 .Sy \&sg 同様 .Sy \&ug として指定します。 Microterm Mime のように、現在位置の文字に下線を引き、 カーソルをひとつ右の位置に移動するコードを端末が持つ場合、 このコードは .Sy \&uc で指定します。 .Pp その他もろもろのハイライトモードに入るケーパビリティには、 .Sy \&mb (点滅)、 .Sy \&md (ボールドまたは更に明るい)、 .Sy \&mh (暗いまたは半輝度)、 .Sy \&mk (空白または見えないテキスト)、 .Sy \&mp (保護状態)、 .Sy \&mr (反転表示)、 .Sy \&me .Pf ( Em 全て の属性モードをオフ)、 .Sy \&as (別の文字セットモードに入る) そして .Sy \&ae (別の文字セットモードから抜ける) があります。 これらのモードを単独でオンにした場合、 他のモードをオフにする場合もありますし、オフにしない場合もあります。 .Pp モードの任意の組み合わせを設定するシーケンスがある場合、 これは 9 個のパラメータを取る .Sy \&sa (属性設定) で指定します。 それぞれのパラメータは 0 または 1 であり、 対応する属性がオンまたはオフされます。 9 個のパラメータは順番に次の通りです: 強調表示・下線・反転・点滅・ 暗い・ボールド・空白・保護・別の文字セット。 全モードが .Sy \&sa によりサポートされている必要は無く、 サポートされているものに対応するコマンドが存在することのみ必要です。( .Nm を使用するプログラムはこのケーパビリティをサポートしていないでしょう。 このケーパビリティは .Xr terminfo との互換性のために定義しています。) .Pp 各文字セルに追加された属性ビットを管理するのではなく、 .Dq マジッククッキー グリッチ .Pf ( Sy \&sg および .Sy \&ug ) を持つ端末では、 描画アルゴリズムに影響するモード設定シーケンスを受信した時に、 特別な .Dq クッキー または .Dq ごみ文字 を画面に残します。 .Pp Hewlett-Packard 2621 のように、 新しい行へ移動した時やカーソル位置を設定した時に 自動的に強調表示モードから抜ける端末があります。 このような端末においては、強調表示モードを使用するプログラムは、 カーソル移動や改行送信前に強調表示モードから抜ける必要があります。 このような問題が無い端末では、 .Sy \&ms ケーパビリティが存在し、このオーバヘッドが不要であることを示します。 .Pp エラーを静かに伝えるために端末が画面をフラッシュさせる方法を持つ場合 (ベルの代りです)、これは .Sy \&vb として指定します; この機能はカーソルを移動してはなりません。 .Pp カーソルが最下行になくても、 通常時よりも見易くする必要がある場合 (例えば、点滅していない下線を、 より見付け易いブロックや点滅する下線に変更する場合)、このシーケンスは .Sy \&vs で与えます。 カーソルを完全に見えなくする方法がある場合には、これは .Sy \&vi ケーパビリティで指定します。 これらのモードの効果を打ち消すケーパビリティ .Sy \&ve も指定する必要があります。 .Pp (特別なコードを必要とせずに) 下線を引かれた文字を端末が正しく表示する場合、 しかもその機能が上打ちではない場合、 このケーパビリティを .Sy \&ul で示します。 上打ちを空白にて消去可能な場合、これは .Sy \&eo で示します。 .Ss キーパッド キーを押した時にコードを送出するキーパッドを持つ端末では、 この情報を指定することができます。 キーパッドがローカルモードにおいてのみ動作する端末は 扱うことができないことに注意してください。 (これは例えば Hewlett-Packard 2621 でシフト状態でないキーにあてはまります)。 キーコードの送出 / 非送出をキーパッドに設定できる場合は、 設定のためのコードは .Sy \&ks および .Sy \&ke で指定します。 そうでない場合はキーパッドは常にコードを送出するものと仮定されます。 left-arrow, right-arrow, up-arrow, down-arrow, home のキーで送出されるコードは それぞれ .Sy \&kl , .Sy \&kr , .Sy \&ku , .Sy \&kd , .Sy \&kh , で指定します。 f0, f1, ..., f9 のようなファンクションキーがある場合には、 これらのキーが送るコードは .Sy \&k0 , .Sy \&k1 , ..., .Sy \&k9 で指定します。 これらのキーがデフォルトの f0 から f9 以外のラベルを持つ場合、このラベルは .Sy \&l0 , .Sy \&l1 , ..., .Sy \&l9 で指定します。 その他の特殊キーで送出されるコードは次のように与えられます: .Sy \&kH (ホームダウン)、 .Sy \&kb (バックスペース)、 .Sy \&ka (全タブクリア)、 .Sy \&kt (この桁のタブストップをクリア)、 .Sy \&kC (画面クリアまたは消去)、 .Sy \&kD (文字削除)、 .Sy \&kL (行削除)、 .Sy \&kM (挿入モードから抜ける)、 .Sy \&kE (行末までクリア)、 .Sy \&kS (画面の終りまでクリア)、 .Sy \&kI (文字挿入または挿入モードに入る)、 .Sy \&kA (行挿入)、 .Sy \&kN (次のページ)、 .Sy \&kP (前のページ)、 .Sy \&kF (前進/下降スクロール)、 .Sy \&kR (後退/上昇スクロール)、 .Sy \&kT (この桁にタブストップを設定)。 更に、キーパッドが 4 つの矢印キーを含む 3 × 3 のキー配列を持つ場合、 他の 5 つのキーは .Sy \&K1 , .Sy \&K2 , .Sy \&K3 , .Sy \&K4 , .Sy \&K5 で指定します。 3 × 3 の方向パッドが必要な時、これらのキーは有用です。 以前 .Dq その他 のファンクションキーを記述するために使用された、廃れた .Sy \&ko ケーパビリティは、上記のケーパビリティにより完全に置き換えられました。 .Pp .Sy \&ma エントリはまた、 端末の矢印キーが 1 文字矢印キーであることを示すためにも使用されます。 これは廃れた方法ですが、 .Sy \&vi のバージョン 2 で未だ使用されています。 メモリ制約の理由で、このコマンドを使用しているミニコンピュータがあるでしょう。 このフィールドは .Sy \&kl , .Sy \&kr , .Sy \&ku , .Sy \&kd , .Sy \&kh と冗長関係にあります。 このフィールドは 2 文字の複数グループから構成されます。 各グループにおいては、最初の文字は矢印キーが何を送るかを表し、 2 番目の文字は対応する .Sy \&vi のコマンドを表します。 コマンドは、 .Ar h が .Sy \&kl に、 .Ar j が .Sy \&kd に、 .Ar k が .Sy \&ku に、 .Ar l が .Sy \&kr に、 .Ar H が .Sy \&kh に対応します。 例えば Mime では .Dq Li ma=^Hh^Kj^Zk^Xl となり、矢印キーの left (^H), down (^K), up (^Z), down (^X) を示します。 (Mime には home キーはありません。) .Ss タブおよび初期化 これらのケーパビリティを使用するプログラムを実行する時に 端末を特別なモードにすることが必要な場合、 このモードに入るコードおよび出るコードは .Sy \&ti と .Sy \&te で指定します。 これが関係あるのは、例えば Concept のようなメモリページを複数持つ端末です。 端末がメモリ相対のカーソル位置設定のみ持ち、 画面相対のカーソル位置設定を持たない場合には、 画面サイズのウィンドウに表示を固定し、 カーソル位置設定が正しく動作するようにする必要があります。 これは Tektronix 4025 でも使用され、 .Sy \&ti はコマンド文字を .Nm が使うように設定します。 .Pp 他のケーパビリティとしては、端末初期化文字列 .Sy \&is や、長い初期化文字列を格納するファイル名 .Sy \&if があります。 これらの文字列は、端末を .Nm 記述と矛盾がないモードに設定するものと期待されています。 これらは通常、ユーザがログインするたびに、 .Xr tset プログラムによって端末に送られます。 印字は次の順に行われます: まず .Sy \&is ; 次に .Sy \&ct と .Sy \&st によるタブ設定; そして最後に .Sy \&if です。 .Pf ( Xr terminfo では .Sy \&is の代りに .Sy \&i\&1-i2 を使用し、プログラム .Sy \&iP を実行し、他の初期化の後 .Sy "\&i\&3" を印字します。) まったくわけがわからない状態から回復するためのよりハードな リセットシーケンスの組が、類推できる名前 .Sy \&rs および .Sy \&rf で与えられます。 これらの文字列は、端末がはまった状態に陥いった時に使用される .Xr reset プログラムにより出力されます。 .Pf ( Xr terminfo は .Sy \&rs の代りに .Sy "\&r1-r3" を使用します。) これらのコマンドが画面上を騒がせ、 なおかつログイン時に必ずしも必要ではない場合に限り、 通常これらは .Sy \&rs および .Sy \&rf に格納します。 例えば、VT100 を 80 桁モードに設定するコマンドは、普通に考えると .Sy \&is の一部に入れるでしょうが、これは画面に困ったゴミを生じさせますし、 端末は普段既に 80 桁モードですので、実際は入れる必要はありません。 .Pp 端末がハードウェアタブを持つ場合、 次のタブストップまで進むコマンドは .Sy \&ta で指定します (通常は .Sy \&^I です)。 直前のタブストップへ左向きに移動する .Dq バックタブ コマンドは、 .Sy \&bt で指定します。 タブストップが端末には送られずに計算機により展開されることを 端末ドライバモードが示す場合、 .Sy \&ta や .Sy \&bt が存在するとしても、プログラムでこれらを使用しないというのが約束になって います。 なぜなら、ユーザがタブストップを正しく設定していないかもしれないからです。 端末電源オン時に各 .Ar n 位置ごとにハードウェアタブが初期設定される端末の場合、 数値パラメータ .Sy \&it を使用し、タブストップ間隔を示します。 このコマンドは通常 .Xr tset コマンドが使用し、ドライバモードをハードウェアタブ展開に設定するか否か、 およびタブストップを設定するか否かを決定します。 端末が不揮発性メモリにタブストップを保存可能な場合、 .Nm 記述はタブストップが正しく設定されるものと仮定できます。 .Pp タブストップを設定およびクリアするコマンドが存在する場合、 これらのコマンドは .Sy \&ct (全タブストップをクリア) および .Sy \&st (全ての行における現在の桁にタブストップを設定) で指定します。 タブ設定のために、ここで示した方法より複雑なシーケンスが必要な場合、 このシーケンスは .Sy \&is や .Sy \&if で指定します。 .Ss 遅延 端末ドライバのパディングを制御するケーパビリティもあります。 これらのケーパビリティは、第 1 にハードコピー端末にて必要とされ、 .Xr tset プログラムにより端末ドライバのモードを適切に設定するために使用されます。 ケーパビリティ .Sy \&cr , .Sy \&sf , .Sy \&le , .Sy \&ff , .Sy \&ta に埋め込まれる遅延は、端末ドライバの適切な遅延ビットを設定する効果があります。 .Sy \&pb (パディングボーレート) を指定した場合、 この値より低いボーレートにおいては、これらの値は無視されます。 .Bx 4.2 の .Xr tset では、遅延は別の数値ケーパビリティ .Sy \&dC , .Sy \&dN , .Sy \&dB , .Sy \&dF , .Sy \&dT で与えられます。 .Ss その他 端末が .Dv NUL (0) 文字以外のパディング文字を必要とする場合には、 .Sy \&pc で指定します。 .Sy \&pc 文字列の最初の文字のみが使用されます。 .Pp 端末がカーソル位置を保存および回復するコマンドを持つ場合には、これらは .Sy \&sc および .Sy \&rc で指定します。 .Pp 通常はソフトウェアが使用しない追加の .Dq ステータス行 を端末が持つ場合、この事実を示すことができます。 ステータス行が最下行の下に追加の行として見える場合には、ケーパビリティ .Sy \&hs を指定します。 ステータス行の位置への移動およびステータス行からの復帰のための特別な文字列は、 .Sy \&ts および .Sy \&fs で指定します。 .Pf ( Sy \&ts の前にカーソルが存在した位置に、 .Sy \&fs はカーソルを戻す必要があります。必要ならば、 .Sy \&sc および .Sy \&rc の文字列を .Sy \&ts および .Sy \&fs に含めてこの効果を得ることができます。) ケーパビリティ .Sy \&ts は、ステータス行の何桁目にカーソルが移動すべきを示すパラメータを 1 つ取ります。 エスケープシーケンスや他の特殊コマンド、 例えばタブがステータス行でも動作するならば、フラグ .Sy \&es を指定します。 ステータス行をオフにする (または内容を消去する) 文字列は、 .Sy \&ds で指定します。 通常、ステータス行の幅は画面の他の部分、 .Em すなわち .Sy \&co と同じであると仮定されます。(端末が行全体の使用を許さない等の理由で) ステータス行の幅が異なる場合には、その幅を桁数で数値パラメータ .Sy \&ws で指定します。 .Pp 端末が半行上下に移動可能な場合、 .Sy \&hu (半行上) および .Sy \&hd (半行下) で指定します。 これは、ハードコピー端末で上付き文字および下付き文字を使用するために有用です。 ハードコピー端末がページを排出して次のページに移動 (フォームフィード) する ことができる場合、これは .Sy \&ff (通常 .Sy \&^L です) で指定します 。 .Pp 指定した文字を指定した回数繰り返すコマンド (同一文字を何度も送出する時間を節約します) がある場合、 パラメータ化された文字列 .Sy \&rp で指定します。 最初のパラメータは繰り返される文字であり、2 番目のパラメータは 繰り返す回数です。(これは .Xr terminfo の機能であり、 .Nm を使用するプログラムはこの機能をサポートしていないでしょう。) .Pp Tektronix 4025 のように端末が設定可能なコマンド文字を持つ場合、 .Sy \&CC で指定します。 全ケーパビリティで使用されるプロトタイプコマンド文字が選択されます。 この文字を識別するために、この文字が .Sy \&CC ケーパビリティにより与えられます。 次の約束をサポートしている .Ux システムがあります: すなわち、 .Ev \&CC 環境変数を検査し、もし設定されている場合には、 プロトタイプ文字を環境変数で設定されているものと置き換えるという約束です。 このように .Ev \&CC 環境変数を使用することは、 .Xr make 1 との衝突が発生しますので、非常に悪い考えです。 .Pp 特定の既知の端末を表現するものではない端末記述、 .Em switch , .Em dialup , .Em patch , .Xr network では .Sy \&gn (一般) ケーパビリティを設定し、 端末に対してどのように話しかければよいのか分らないと プログラムが文句を言えるようにします。 (このケーパビリティは、エスケープシーケンスが既知である .Em 仮想 端末記述にはあてはまりません。 .Pp 端末が xoff/xon .Pq Tn DC3 Ns / Ns Tn DC1 ハンドシェークを使用してフロー制御する場合、 .Sy \&xo を指定します。 コストに関するより良い判定を可能とするために 依然としてパディング情報を指定する必要がありますが、 実際にパディング文字が送出されるということはありません。 .Pp シフトキーのように動作し、送出される文字の 8 ビット目をセットする .Dq メタキー を端末が備える場合、 .Sy \&km を設定してこの事実を示すことができます。 これが指定されない場合は、ソフトウェアは 8 ビット目はパリティであると仮定し、 通常これをクリアしてしまいます。 .Dq メタモード をオンおよびオフする文字列が存在する場合、これらは .Sy \&mm および .Sy \&mo で指定します。 .Pp 画面 1 枚分より多くのメモリ行を端末が備える場合、 メモリの行数を .Sy \&lm で指定します。 明示的に値 0 を指定すると、行数は固定ではないものの 画面分より多くのメモリがあることを示します。 .Pp .Ux システムの仮想端末プロトコルにてサポートされる端末である場合、 端末番号は .Sy \&vt で与えられます。 .Pp 端末に接続された外部プリンタを制御するメディアコピー文字列は、 次のように与えられます。すなわち .Sy \&ps : 画面内容の印字; .Sy \&pf : プリンタオフ; および .Sy \&po : プリンタオンです。 プリンタオン時には、端末に送られる全てのテキストはプリンタに送られます。 プリンタオン時に端末画面にもテキストが表示されるか否かは未定義です。 このバリエーションである .Sy \&pO は単一のパラメータを取り、 パラメータ値で指定される文字数だけプリンタをオンにし、 その後プリンタをオフにします。 このパラメータは 255 を越えてはなりません。 .Sy \&pf を含む全テキストは、 .Sy \&pO が有効である間、透過的にプリンタに渡されます。 .Pp プログラムファンクションキーへの文字列は .Sy \&pk , .Sy \&pl , .Sy \&px で指定します。 これらの文字列は次の 2 つのパラメータを取ります: それぞれ、プログラム対象のファンクションキー番号 (0 から 9 まで) と、 プログラムの文字列です。 この範囲外のファンクションキー番号を指定すると、 ここでは定義できないキーを端末依存の方式でプログラムするかもしれません。 これらのケーパビリティの差異は、 .Sy \&pk は指定したキーを押すと指定した文字列を ユーザがタイプしたものとして扱うものであり; .Sy \&pl はローカルモードの端末にて指定した文字列を実行させるものであり; .Sy \&px は指定した文字列を計算機に送出させるものである点です。 不幸なことに、 .Nm では文字列パラメータが定義されていないため、 .Xr terminfo のみがこれらのケーパビリティをサポートします。 .Ss グリッチと不良 文字 `~' を表示できない Hazeltine 端末は .Sy \&hz を指定する必要があります。 .Pp .Sy \&nc ケーパビリティは現在廃れていますが、 以前は Datamedia 端末を表すために使用していました。 この端末では、キャリッジリターンに対して .Sy \&\er \en をエコーし、続くラインフィードを無視します。 .Pp Concept のように .Sy \&am による折り返しの直後のラインフィードを無視する端末では、 .Sy \&xn を指定します。 .Pp 強調表示を取り除くために (単に通常のテキストを上書きするだけで済まず) .Sy \&ce が必要な場合、 .Sy \&xs を指定します。 .Pp タブによって移動された全ての文字が空白にされてしまう Teleray 端末では、 .Sy \&xt (破壊的なタブ) を指定する必要があります。 このグリッチは、\*(lqマジッククッキー\*(rq の先頭に カーソル位置を設定できないことと、 強調表示を消すためには行削除と行挿入が必要であることも表現します。 .Pp .Dv ESC や .Sy \&^C の文字を正しく送出できない Beehive Superbee は .Sy \&xb を指定し、 .Dq \&f\&1 キーが .Dv ESC として使用され、 .Dq \&f\&2 キーが ^C として使用されることを示します。( 特定の Superbee のみがこの問題を持ち、これは .Tn ROM に依存します。) .Pp ある特定の端末に他の問題がある場合、 .Sy x Ns Em x の形式のケーパビリティを追加することにより正しく動作するようにしても 構いません。 .Ss 似た端末 2 つの非常によく似た端末がある場合、 例外はあるもののもう一方にそっくりであると、 一方を定義することができます。 文字列ケーパビリティ .Sy \&tc には似た端末の名前を与えます。 このケーパビリティは .Em 最後 である必要があり、組み合わせたエントリの長さは 1024 を越えてはなりません。 .Sy \&tc の前に指定したケーパビリティは .Sy \&tc により呼び出される端末タイプの記述に優先します。 ケーパビリティのキャンセルのためには .Sy \&xx@ を .Sy \&tc の呼び出しの左に置きます。 .Sy \&xx はキャンセルされるケーパビリティです。 例えば、エントリ .Bd -literal -offset indent hn\||\|2621\-nl:ks@:ke@:tc=2621: .Ed .Pp は、ビジュアルモードでファンクションキーラベルをオンにしないために .Sy \&ks と .Sy \&ke のケーパビリティを持たない .Dq 2621\-nl を定義します。 端末の種々のモードやユーザの種々のプリファレンスを記述するために有用です。 .Sh 関連ファイル .Bl -tag -width /usr/share/misc/termcap.db -compact .It Pa /usr/share/misc/termcap 端末記述を格納するファイル .It Pa /usr/share/misc/termcap.db 端末記述を格納するハッシュデータベースファイル .Pf ( Xr cap_mkdb 1 を参照)。 .El .Sh 関連項目 .Xr cap_mkdb 1 , .Xr ex 1 , .Xr more 1 , .Xr tset 1 , .Xr ul 1 , .Xr vi 1 , .Xr curses 3 , .Xr printf 3 , .Xr termcap 3 , .Xr term 5 .Sh 警告およびバグ .Em 注 : .Nm の機能は .At V Release 2.0 の .Xr terminfo に置き換えられました。 .Dq 廃れた とされるケーパビリティを使用していなければ、 移行のための苦痛は比較的少ないです。 .Pp 現在、行数および桁数は、 termcap エントリに格納するものと同様に、カーネルが格納します。 現在、ほとんどのプログラムはカーネルの情報を最初に使用します; このファイルに記述されている情報は、 カーネルが情報を持たない時のみ使用されます。 .Pp .Xr \&vi 1 プログラムは文字列ケーパビリティには 256 文字しか許しませんが、 .Xr termlib 3 のルーチンはこのバッファの溢れをチェックしません。 単一エントリの総計の長さは 1024 を越えてはなりません (エスケープされた改行は除きます)。 .Pp 全てのプログラムが全てのエントリをサポートしているわけではありません。 .Sh 歴史 .Nm ファイルフォーマットは .Bx 3 に登場しました。 diff --git a/ja_JP.eucJP/man/man5/ttys.5 b/ja_JP.eucJP/man/man5/ttys.5 index 36a61a34c5..660431d84d 100644 --- a/ja_JP.eucJP/man/man5/ttys.5 +++ b/ja_JP.eucJP/man/man5/ttys.5 @@ -1,167 +1,167 @@ .\" 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. .\" .\" WORD: line 回線 .\" .\" from: @(#)ttys.5 8.1 (Berkeley) 6/4/93 -.\" jpman $Id: ttys.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: ttys.5,v 1.3 1998/06/17 07:52:43 kumano Stab % .\" %Id: ttys.5,v 1.3.2.3 1997/12/15 07:10:54 charnier Exp % .\" " .Dd November 17, 1996 .Dt TTYS 5 .Os .Sh 名称 .Nm ttys .Nd 端末初期設定情報 .Sh 解説 ファイル .Nm は端末特殊ファイルを初期化したり制御するあらゆるルーチンが使用する 情報を含んでいます。 この情報は .Xr getttyent 3 ライブラリルーチンで読まれます。 .Nm ファイルの中には 1 つのスペシャルデバイスファイルにつき 1 行の記述が あります。 フィールドはタブやスペースにより区切られます。 1 語以上からなるフィールドはダブルクォート (``"'') で括られていなければ なりません。 空行やコメントはファイル中のどこに現れても構いません。 コメントはハッシュ記号 (``#'') および改行によって区切られます。 指定されていないフィールドはデフォルトでナルです。 .Pp 最初のフィールドは .Pa /dev にあるような端末特殊ファイルの名前です。 .Pp 2 番目のフィールドはその回線に対して実行するコマンドで、 通常 .Xr getty 8 です。これは回線を初期化して開くプログラムで、スピードを設定したり、 ユーザ名を待ったり .Xr login 1 プログラムを実行します。 しかしながら、それはどんな希望するコマンド、例えばウィンドウシステム の端末エミュレータやデーモンプロセスの起動コマンドでも構いません。 そして、もしクォートで括られているのなら複数語を含む事もできます。 .Pp 3 番目のフィールドは通常その tty 回線に接続される端末のタイプで、普通 .Xr termcap 5 データベースファイル中に収められています。 環境変数 .Ev TERM は .Xr getty 8 または .Xr login 1 による値に初期化されます。 .Pp 残りのフィールドは .Fa ty_status エントリ .Xr (getttyent 3 参照) 中のフラグを指定したり、その端末回線に対して .Xr init 8 が維持するウィンドウシステムのプロセスを指定したり、 オプションで tty のタイプ (ダイアルインか、ネットワークか、またはそれ以外か) を決定したり、 またログインクラスのデータベース .Xr (login.conf 5 参照) が多くの tty をグループとして参照できるような tty グループ名を指定します。 これはグループとして tty に対して選択的にアクセスを許可または 拒否したりアカウンティング機能を可能または不可能にするためです。 .Pp フラグの値としては、文字列 ``on'' と ``off'' は .Xr init 8 が 2 番目のフィールドで与えられるコマンドを実行するか(しないか)を 指定します。一方 ``secure'' は ( ``on'' も与えられていれば) uid が 0 のユーザがこの回線にログインすることを許可します。 フラグ ``dialin'' は tty エントリがダイアルイン回線であることを 示しており、 ``network'' は tty エントリがネットワーク接続で あることを示しています。 端末タイプのフィールドには、これらの文字列のどちらかが指定できます。 文字列 ``window='' の後には .Xr init 8 が 2 番目のフィールドで指定されるコマンドを開始する .Em 前 に実行するコマンド列をクォートで括って続けます。 .Pp 文字列 ``group='' の後には、 多くの tty 回線をアクセスの許可/拒否やアカウンティング機能の 可能/不可能を決めるためのグループとして参照するために .Xr login.conf 5 で使われる、文字・数字のグループ名を続けます。 何のグループも指定されなかった場合、ttyはグループ "none" に属するように なります。 以前との互換性のために、 ``group='' は行の最後に、任意のコメントのすぐ前 に現れなければなりません。 .Sh 使用例 .Bd -literal # 1200 ボーでコンソール、root でのログイン可 console "/usr/libexec/getty std.1200" vt100 on secure # 1200 ボーでダイアルアップ、root でのログイン不可 ttyd0 "/usr/libexec/getty d1200" dialup on group=dialup # 555-1234 # Mike の端末: hp2621 ttyh0 "/usr/libexec/getty std.9600" hp2621-nl on group=dialup # 457 Evans # John の端末: vt100 ttyh1 "/usr/libexec/getty std.9600" vt100 on group=dialup # 459 Evans # 端末エミュレート/ウィンドウシステム ttyv0 "/usr/new/xterm -L :0" vs100 on window="/usr/new/Xvs100 0" # ネットワーク仮想 tty -- getty は使用しません ttyp0 none network group=pty ttyp1 none network off group=pty .Ed .\" 「使用例」1行目 `root login on ...' .\" 3行目の `no root logins' との対比であるから、 .\" 3行目の訳と対比させて「root でのログイン可」と訳した。 .\" (98/06/17 kumano@jp.freebsd.org) .Sh 関連ファイル .Bl -tag -width /etc/ttys -compact .It Pa /etc/ttys .El .Sh 関連項目 .Xr login 1 , .Xr getttyent 3 , .Xr ttyslot 3 , .Xr gettytab 5 , .Xr login.conf 5 , .Xr termcap 5 , .Xr getty 8 , .Xr init 8 .\".Xr init 8 , .\".Xr ttyflags 8 .Sh 歴史 .Nm ファイルは .At v6 で登場しました。 diff --git a/ja_JP.eucJP/man/man5/types.5 b/ja_JP.eucJP/man/man5/types.5 index 5ec2ab555e..7b82d564b0 100644 --- a/ja_JP.eucJP/man/man5/types.5 +++ b/ja_JP.eucJP/man/man5/types.5 @@ -1,196 +1,196 @@ .\" 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. .\" .\" @(#)types.5 8.1 (Berkeley) 6/5/93 -.\" jpman $Id: types.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: types.5,v 1.3 1998/07/30 15:28:11 horikawa Stab % .\" %Id: types.5,v 1.3.2.2 1997/02/28 05:53:25 mpp Exp % .\" .Dd June 5, 1993 .Dt TYPES 5 .Os BSD 4 .Sh 名称 .Nm types .Nd システムのデータ型 .Sh 書式 .Fd #include .Sh 解説 ファイル .Pa sys/types.h はカーネル内部で (ほとんどの物はシステム全体を通じて) 用いられる、 定義済みのデータ型を含みます。 .Bd -literal #ifndef _SYS_TYPES_H_ #define _SYS_TYPES_H_ /* 機種に依存するパラメータ。 */ #include #include #ifndef _POSIX_SOURCE typedef unsigned char u_char; typedef unsigned short u_short; typedef unsigned int u_int; typedef unsigned long u_long; typedef unsigned short ushort; /* Sys V との互換性 */ typedef unsigned int uint; /* Sys V との互換性 */ #endif typedef u_int64_t u_quad_t; /* quads */ typedef int64_t quad_t; typedef quad_t * qaddr_t; typedef char * caddr_t; /* コアアドレス */ typedef int32_t daddr_t; /* ディスクアドレス */ typedef u_int32_t dev_t; /* デバイス番号 */ typedef u_int32_t fixpt_t; /* 固定小数点数 */ typedef u_int32_t gid_t; /* グループ ID */ typedef u_int32_t ino_t; /* i ノード番号 */ typedef long key_t; /* IPC キー (Sys V プロセス間通信用) */ typedef u_int16_t mode_t; /* パーミッション */ typedef u_int16_t nlink_t; /* リンクカウント */ typedef _BSD_OFF_T_ off_t; /* ファイルオフセット */ typedef _BSD_PID_T_ pid_t; /* プロセス ID */ typedef int32_t segsz_t; /* セグメントサイズ */ typedef int32_t swblk_t; /* スワップオフセット */ typedef u_int32_t uid_t; /* ユーザ id */ typedef quad_t rlim_t; /* リソースリミット */ #ifdef KERNEL typedef int boolean_t; typedef struct vm_page *vm_page_t; #endif /* * これは unistd.h にあるべきですが、lseek の第 2 引数を off_t にキャスト * しているプログラムが正しい版の lseek を用いることを確実にするために * ここに置かれています。 */ #ifndef KERNEL #include __BEGIN_DECLS off_t lseek __P((int, off_t, int)); __END_DECLS #endif #ifndef _POSIX_SOURCE /* * minor() はインデックスの代わりにクッキーを与えます。これは、ビット0-15 * の意味を変更したり、ビット 16-31 をシフトして、それを使わないデバイス * にとって時間とスペースの無駄遣いになることをしたくないからです。 */ #define major(x) ((int)(((u_int)(x) >> 8)&0xff)) /* メジャー番号 */ #define minor(x) ((int)((x)&0xffff00ff)) /* マイナー番号 */ #define makedev(x,y) ((dev_t)(((x) << 8) | (y))) /* dev_t を生成する */ #endif #include #ifdef _BSD_CLOCK_T_ typedef _BSD_CLOCK_T_ clock_t; #undef _BSD_CLOCK_T_ #endif #ifdef _BSD_SIZE_T_ typedef _BSD_SIZE_T_ size_t; #undef _BSD_SIZE_T_ #endif #ifdef _BSD_SSIZE_T_ typedef _BSD_SSIZE_T_ ssize_t; #undef _BSD_SSIZE_T_ #endif #ifdef _BSD_TIME_T_ typedef _BSD_TIME_T_ time_t; #undef _BSD_TIME_T_ #endif #ifndef _POSIX_SOURCE #define NBBY 8 /* 1 バイトに含まれるビット数 */ /* * select は long 型のファイル記述子ビットマスクを用います。これらの * マクロはこの型のビットフィールドを操作します (ファイルシステムの * マクロは char 型を用います)。 * FD_SETSIZE はユーザによって定義することもできますが、ほとんどの * ユーザにとっては、ここに示すデフォルトで十分でしょう。 */ #ifndef FD_SETSIZE #define FD_SETSIZE 256 #endif typedef long fd_mask; #define NFDBITS (sizeof(fd_mask) * NBBY) /* マスクごとのビット */ #ifndef howmany #define howmany(x, y) (((x) + ((y) - 1)) / (y)) #endif typedef struct fd_set { fd_mask fds_bits[howmany(FD_SETSIZE, NFDBITS)]; } fd_set; #define FD_SET(n, p) ((p)->fds_bits[(n)/NFDBITS] |= (1 << ((n) % NFDBITS))) #define FD_CLR(n, p) ((p)->fds_bits[(n)/NFDBITS] &= ~(1 << ((n) % NFDBITS))) #define FD_ISSET(n, p) ((p)->fds_bits[(n)/NFDBITS] & (1 << ((n) % NFDBITS))) #define FD_COPY(f, t) bcopy(f, t, sizeof(*(f))) #define FD_ZERO(p) bzero(p, sizeof(*(p))) #if defined(__STDC__) && defined(KERNEL) /* * 関数プロトタイプのための構造体の先行定義。サブシステムの境界を越えて * 用いられる共通の構造体をここに含めます。その他の構造体は、ほとんど * 定義されたのと同じ場所でしか使用されません。 */ struct proc; struct pgrp; struct ucred; struct rusage; struct file; struct buf; struct tty; struct uio; #endif #endif /* !_POSIX_SOURCE */ #endif /* !_SYS_TYPES_H_ */ .Ed .Sh 関連項目 .Xr gdb 1 , .Xr lseek 2 , .Xr time 3 , .Xr fs 5 .Sh 歴史 .Nm ファイルは .At v7 から登場しました。 diff --git a/ja_JP.eucJP/man/man5/tzfile.5 b/ja_JP.eucJP/man/man5/tzfile.5 index 8be4fd0cd7..db188c3cb6 100644 --- a/ja_JP.eucJP/man/man5/tzfile.5 +++ b/ja_JP.eucJP/man/man5/tzfile.5 @@ -1,123 +1,123 @@ .Dd September 13, 1994 -.\" jpman $Id: tzfile.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: tzfile.5,v 1.3 1998/06/22 10:44:36 kumano Stab % .Dt TZFILE 5 .Os FreeBSD 2.0 .Sh 名称 .Nm tzfile .Nd タイムゾーンの情報 .Sh 書式 .Fd #include .Sh 解説 .Xr tzset 3 が使用するタイムゾーン情報ファイルは、 将来の使用のために予約されている数バイトから始まり、 4 つの .Fa long 型 4 バイト値が続きます。 これは ``標準'' バイトオーダ (上位バイトを最初に格納) で格納されます。 これらの値を順序に従い、以下に示します。 .Pp .Bl -tag -compact -width tzh_ttisstdcnt .It Li tzh_ttisstdcnt ファイルに格納された、標準/ウォール指示子の数。 .It Li tzh_leapcnt ファイルに格納された、閏秒データの数。 .It Li tzh_timecnt ファイルに格納された ``遷移時刻'' データの数。 .It Li tzh_typecnt ファイルに格納された ``ローカルタイム型'' データの数 (0 であってはなりません)。 .It Li tzh_charcnt ファイルに格納された ``タイムゾーン省略形文字列'' の文字数。 .El .Pp 上記のヘッダに続いて、 4 バイト .Fa long 型の値が .Li tzh_timecnt 個、昇順に並びます。 値は ``標準'' バイトオーダで格納されます。 それぞれ、ローカルタイム計算方法が変わる遷移時刻 ( .Xr time 3 で返される形式) として使用されます。 続いて、1 バイト .Fa "unsigned char" 型の値が .Li tzh_timecnt 個続きます。 このそれぞれは、同一インデックスの遷移時刻に、 ファイル中のどの ``ローカルタイム'' 型が対応するかを示します。 値は、このファイル中で後続する .Fa ttinfo 構造体の配列に対するインデックスです。 .\" つまり struct ttinfo が tzh_typecnt 個あるということ .\" See src/lib/libc/stdtime/tzfile.h .\" 1998/05/01 horikawa@jp.freebsd.org この構造体の定義を以下に示します。 .Pp .Bd -literal -offset indent struct ttinfo { long tt_gmtoff; int tt_isdst; unsigned int tt_abbrind; }; .Ed .Pp 各構造体は、 標準バイトオーダの 4 バイト .Fa long 型の値 .Li tt_gmtoff 、それに続く 1 バイトの値 .Li tt_isdst 、そして 1 バイトの値 .Li tt_abbrind の順に格納されます。 .Li tt_gmtoff は GMT に加えるべき秒数を、 .Li tt_isdst は .Li tm_isdst が .Xr localtime 3 により設定されるべきかどうかを、 .Li tt_abbrind はタイムゾーン省略文字列の配列に対するインデックスを意味します。 タイムゾーン省略文字列の配列は、同一ファイル中の .Li ttinfo 構造体に後続しています。 .Pp その後には標準バイトオーダで格納される 4 バイト値のペアが .Li tzh_leapcnt 個格納されています。 各ペアの最初の値は、閏秒が発生する時刻 ( .Xr time 3 で返される形式) です。 2 番目の値は、 指定された時刻以降に適用される閏秒の .Em 総計 です。 値のペアは時刻の昇順で格納されます。 .Pp 最後に、1 バイト値の標準/ウォールの指示子が .Li tzh_ttisstdcnt 個格納されています。 これらは、ローカルタイム型に関する遷移時刻が 標準時刻で指定されているのか、 それともウォールクロックの時刻で指定されているのかを示します。 この情報は、POSIX スタイルのタイムゾーン環境変数を扱う際に、 タイムゾーンファイルを使用するときに使用します。 .Pp .Li tzh_timecnt が 0 の場合もしくは時刻引数がファイル中の最初の遷移時刻以前の場合、 .Nm localtime は、ファイル中の最初の標準時間の .Li ttinfo 構造体を使用します (標準時間の構造体が無い場合には、単に最初の .Li ttinfo 構造体を使用します)。 .Sh 関連項目 .Xr ctime 3 , .Xr time2posix 3 , .Xr zic 8 .\" @(#)tzfile.5 7.2 diff --git a/ja_JP.eucJP/man/man5/utmp.5 b/ja_JP.eucJP/man/man5/utmp.5 index c73ced729f..89929ba437 100644 --- a/ja_JP.eucJP/man/man5/utmp.5 +++ b/ja_JP.eucJP/man/man5/utmp.5 @@ -1,219 +1,219 @@ .\" 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. .\" .\" @(#)utmp.5 8.2 (Berkeley) 3/17/94 .\" %Id: utmp.5,v 1.3.2.6 1998/06/28 21:34:27 hoek Exp % .\" -.\" jpman $Id: utmp.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: utmp.5,v 1.3 1998/06/17 07:53:04 kumano Stab % .Dd March 17, 1994 .Dt UTMP 5 .Os BSD 4 .Sh 名称 .Nm utmp , .Nm wtmp , .Nm lastlog .Nd ログイン記録 .Sh 書式 .Fd #include .Fd #include .Sh 解説 .Aq Pa utmp.h ファイルは、 .Nm utmp ファイルでの現在のユーザについての情報や .Nm wtmp ファイル中でのログインやログアウトの情報、 .Nm lastlog ファイル中での最終ログイン情報の記録のために使われる構造体を 宣言しています。 時刻の変更やシャットダウンおよびリブートのタイムスタンプは、同じように .Nm wtmp ファイルに記録されます。 .Pp これらのファイルは、忙しいシステムでは急速に大きくなりますので、 毎日もしくは毎週ローテションすることを推奨します。 もし、これらのファイルのどれかが存在しない場合、そのファイルは作成されません。 これらのファイルは、手動で作成されなければならず、 .Xr newsyslog 8 によって管理されます。 .Bd -literal -offset indent #define _PATH_UTMP "/var/run/utmp" #define _PATH_WTMP "/var/log/wtmp" #define _PATH_LASTLOG "/var/log/lastlog" #define UT_NAMESIZE 8 #define UT_LINESIZE 8 #define UT_HOSTSIZE 16 struct lastlog { time_t ll_time; char ll_line[UT_LINESIZE]; char ll_host[UT_HOSTSIZE]; }; struct utmp { char ut_line[UT_LINESIZE]; char ut_name[UT_NAMESIZE]; char ut_host[UT_HOSTSIZE]; long ut_time; }; .Ed .Pp ユーザがログインするたびに、 .Xr login 1 プログラムは .Nm lastlog ファイル中のユーザの .Tn UID を検索します。 もし見つかった場合、ユーザが最後にログインした時刻のタイムスタンプ、 端末線、ホスト名が標準出力に書き出されます ( ログインが .Em メッセージを表示しない ように設定されていない場合。 .Xr login 1 を参照 )。 .Nm login プログラムは、その後 .Nm lastlog ファイルに新しいログイン時刻を記録します。 .Pp 新しい .Fa lastlog への記録が書き出された後で、 .\" the .\" .Xr libutil 3 .\" routine .Nm utmp ファイルがオープンされ、ユーザに対する .Fa utmp 記録が挿入されます。 この記録は、ユーザがログアウトして削除される時まで保持されます。 .Nm utmp ファイルは、 .Xr rwho 1 , .Xr users 1 , .Xr w 1 , .Xr who 1 プログラムで使われます。 .Pp 次に、 .Xr login プログラムは .Nm wtmp ファイルをオープンし、ユーザの .Fa utmp 記録を追加します。 同じ .Fa utmp 記録が更新されたタイムスタンプ付きで、ユーザがログアウトした時に、 ファイルに追加されます ( .Xr init 8 参照)。 .Nm wtmp ファイルは、 .Xr last 1 と .Xr ac 8 プログラムで使われます。 .Pp 時刻変更やシャットダウン・リブートの際には、 以下の項目が .Nm wtmp ファイルに記録されます。 .Pp .Bl -tag -width shutdownxx -compact .It Li reboot .It Li shutdown システムのリブートやシャットダウンが開始された。 .Fa ut_line フィールドに .Ql \&~ と言う文字が、 .Fa ut_name フィールド中に .Li reboot もしくは .Li shutdown が記録されます ( .Xr shutdown 8 と .Xr reboot 8 参照)。 .Pp .It Li date システム時刻が手動もしくは自動で更新された ( .Xr date 1 参照)。 コマンド名 .Xr date がフィールド .Fa ut_name に記録されます。 .Fa ut_line フィールド中の .Ql \\*(Ba 文字は、変更前の時刻を示し、 .Ql \&{ 文字は新しい時刻を示しています。 .El .Sh 関連ファイル .Bl -tag -width /var/log/lastlog -compact .It Pa /var/run/utmp .Nm utmp ファイル。 .It Pa /var/log/wtmp .Nm wtmp ファイル。 .It Pa /var/log/lastlog .Nm lastlog ファイル。 .El .Sh 関連項目 .Xr last 1 , .Xr login 1 , .Xr w 1 , .Xr who 1 , .Xr ac 8 , .Xr init 8 .Sh 歴史 A .Nm utmp と .Nm wtmp ファイル書式は .At v6 から登場しました。 .Nm lastlog ファイル書式は .Bx 3.0 から登場しました。 diff --git a/ja_JP.eucJP/man/man5/uuencode.format.5 b/ja_JP.eucJP/man/man5/uuencode.format.5 index fe73b1a293..e5cd5f93b1 100644 --- a/ja_JP.eucJP/man/man5/uuencode.format.5 +++ b/ja_JP.eucJP/man/man5/uuencode.format.5 @@ -1,99 +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. .\" .\" @(#)uuencode.format.5 8.2 (Berkeley) 1/12/94 -.\" jpman $Id: uuencode.format.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: uuencode.format.5,v 1.3 1998/07/02 18:49:29 kumano Stab % .\" .\" WORD: trailer トレーラ .\" .Dd January 12, 1994 .Dt UUENCODE 5 .Os BSD 4 .Sh 名称 .Nm uuencode .Nd uuencode ファイルのフォーマット .Sh 解説 .Xr uuencode 1 によって出力されるファイルは、ヘッダ行、それに続く本体の行、 およびトレーラ行から構成されています。 .Xr uudecode 1 コマンドはヘッダ行の前やトレーラ行の後ろにある行を無視します。 ヘッダの前にある行は、当然ヘッダのようには見えてはいけません。 .Pp ヘッダ行は行の先頭にある 6 文字 .Dq begin\ \& (最後の空白に注意) によって識別されます。 .Em begin の後ろには (8 進数の) モード、そしてリモートファイルの名前を指定する 文字列が続きます。 空白がヘッダ行中の 3 つの要素を分けています。 .Pp 本体は、それぞれが最大 62 文字 (行末の改行を含みます) の行から 構成されています。これらは文字カウント、それに続く符合化された文字、 それに続く改行からなります。 文字カウントは印刷可能な 1 文字で、その行の残りのバイト数を整数で表して います。 その整数は常に 1 から 45 または 64 の範囲にあり、その文字から空白文字 (8 進数で 40) を引く事によって決定可能です。文字 64 は 0 のカウントを 表しています。 .Pp 3 バイトのグループが 4 文字に (訳注: 3 バイト (24 ビット) を 1 グループとしこれを 4 つに分けて 4 文字に) .\" 上記訳注は、原文の理解を助けるために追加しました。 .\" 2.2.6-RELEASE 対象 .\" By kumano@jp.freebsd.org (Jun 27 1998) 、つまり 6 ビットが 1 文字に蓄えられます。 すべての文字はいつも 1 から 64 の範囲にあり印刷可能な文字にするために 空白文字 (8 進数で 40) でかさあげされます。 文字 64 は 0 のカウントを表します。 最後の行は通常の 45 バイトより短くてもかまいません。 もしサイズが 3 の倍数でない場合、 そのことは最終行のカウントの値を見ればわかります。 文字カウントを 4 の倍数にするために、余分なゴミが含まれる事があります。 本体は、0 のカウントを持つ行で終了します。 この行は .Tn ASCII バッククォート (8 進数で 140) の 1 文字からなります。 .Pp トレーラ行は .Dq end だけの行からなります。 .Sh 関連項目 .Xr mail 1 , .Xr uucp 1 , .Xr uudecode 1 , .Xr uuencode 1 .Sh 歴史 .Nm uuencode ファイルフォーマットは .Bx 4.0 から登場しました。 .\" It was named uuencode.5 prior to 4.3 diff --git a/ja_JP.eucJP/man/man5/vgrindefs.5 b/ja_JP.eucJP/man/man5/vgrindefs.5 index a858c2d732..b3266f219f 100644 --- a/ja_JP.eucJP/man/man5/vgrindefs.5 +++ b/ja_JP.eucJP/man/man5/vgrindefs.5 @@ -1,165 +1,165 @@ .\" 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. .\" .\" @(#)vgrindefs.5 8.1 (Berkeley) 6/6/93 -.\" jpman $Id: vgrindefs.5,v 1.1.1.1 1998-08-13 01:45:30 kuriyama Exp $ +.\" jpman %Id: vgrindefs.5,v 1.3 1998/07/30 15:29:11 horikawa Stab % .\" WORD: lexical 字句上の(的な)、字句(複合語の場合) .\" WORD: optional 省略可能な .\" .Dd June 6, 1993 .Dt VGRINDEFS 5 .Os BSD 4.2 .Sh 名称 .Nm vgrindefs .Nd .Xr vgrind 1 のための言語定義データベース .Sh 書式 .Nm vgrindefs .Sh 解説 .Nm vgrindefs ファイルは .Xr vgrind 1 が用いるすべての言語定義を含んでいます。 このデータベースは .Xr termcap 5 に非常によく類似しています。 .Sh フィールド 以下の表は、各フィールドの名称と意味を解説しています。 .Pp .Bl -column Namexxx Tpexxx .Sy 名称 型 解説 .It "ab 文字列 代替コメントの始まりを示す正規表現" .It "ae 文字列 代替コメントの終りを示す正規表現" .It "pb 文字列 手続きの始まりを示す正規表現" .It "bb 文字列 字句的ブロックの始まりを示す正規表現" .It "be 文字列 字句的ブロックの終りを示す正規表現" .It "cb 文字列 コメントの始まりを示す正規表現" .It "ce 文字列 コメントの終りを示す正規表現" .It "sb 文字列 文字列の始まりを示す正規表現" .It "se 文字列 文字列の終りを示す正規表現" .It "lb 文字列 文字列定数の始まりを示す正規表現" .It "le 文字列 文字列定数の終りを示す正規表現" .It "nc 文字列 非コメントを示す正規表現 (下記参照)" .It "tl bool 指定した場合、字句上のトップレベル以外では手続きが定義されないことを意味する" .It "oc bool 指定した場合、大文字と小文字が等価であることを意味する" .It "kw 文字列 スペースで区切られたキーワードのリスト" .El .Pp 非コメントは、通常はコメントの始まりを示すシーケンスがその特殊な意味を 失うような特別な状況を記述するのに必要です。この典型的な実例は、 Perl において、通常コメントを .Ql # で始めるのに対し、文字列 .Ql $# が配列に対するオペレータである例に見ることができます。 .Sh 使用例 以下のエントリは C 言語を記述するもので、言語エントリの典型例です。 .Bd -literal C|c:\ :pb=^\ed?*?\ed?\ep\ed?\e(\ea?\e):bb={:be=}:cb=/*:ce=*/:sb=":se=\ee":\e :lb=':le=\ee':tl:\e :kw=asm auto break case char continue default do double else enum\e extern float for fortran goto if int long register return short\e sizeof static struct switch typedef union unsigned while #define\e #else #endif #if #ifdef #ifndef #include #undef # define else endif\e if ifdef ifndef include undef: .Ed .Pp 最初のフィールドは単に言語名 (とそのすべての変種) を示すに過ぎないことに 注意して下さい。この場合、C言語は "c" か "C" という名前で .Xr vgrind 1 に指定することができます。 .Pp 行の最後の文字として \e を与えることにより、 エントリは複数行に続けることができます。 .Nm vgrindefs のケーパビリティは 2 つの型に分かれます。すなわち、 言語に特定の機能が備わっていることを示すブール型のケーパビリティと、 正規表現またはキーワードのリストを示す文字列のケーパビリティです。 .Sh 正規表現 .Nm vgrindefs は .Xr ex 1 や .Xr lex 1 の正規表現に非常によく似たものを用います。 文字 `^', `$', `:' および `\e' は予約された文字なので、これらが通常の文字として含まれる場合は .Ql \e を直前に置くことによって "クォート" しなければなりません。 メタシンボルとそれらの意味は、以下のとおりです。 .Bl -tag -width indent .It $ 行末 .It \&^ 行頭 .It \ed デリミタ (スペース、タブ、改行、行の始まり) .It \ea シンボルからなるすべての文字列にマッチする (lex での .* と同じ) .It \ep すべての英数字からなる名前にマッチする。手続き定義の内部 (pb) では このシンボルにマッチする文字列が手続きの名前として用いられます。 .It () グループ化 .It \&| 選択 .It ? 直前の項目が省略可能である .It \ee 文字列の前に置くことにより、その文字列と、 先頭がエスケープ文字 (\e) である入力文字列とはマッチしなくなります。 文字列デリミタをエスケープすることにより文字列中に含むことが可能な (C のような) 言語で使用されるのが、典型的な使用法です。 .El .Pp その他のシステム内の正規表現と異なり、これらは文字単位ではなく単語単位で マッチします。ですから、 "(tramp|steamer)flies?" のような場合は "tramp", "steamer", "trampflies", または "steamerflies" にマッチします。 .Sh キーワードリスト キーワードリストは言語におけるキーワードをスペースで区切って単純に 列挙したものです。もし "oc" ブール値フラグが指定されていれば、これは 大文字と小文字が等価であることを示すので、すべてのキーワードは小文字で 指定するべきです。 .Sh 関連ファイル .Bl -tag -width /usr/share/misc/vgrindefs -compact .It Pa /usr/share/misc/vgrindefs 端末記述を含むファイル .El .Sh 関連項目 .Xr troff 1 , .Xr vgrind 1 .Sh 歴史 .Nm ファイルフォーマットは .Bx 4.2 で登場しました。 diff --git a/ja_JP.eucJP/man/man8/xntpd.8 b/ja_JP.eucJP/man/man8/xntpd.8 index b7922d7698..f418f96152 100644 --- a/ja_JP.eucJP/man/man8/xntpd.8 +++ b/ja_JP.eucJP/man/man8/xntpd.8 @@ -1,1087 +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") モードで動作するよう指示します。これは、さまざまな失敗 -の仕方によって、ローカルもしくはリモートのサーバホストのいずれかが -より良い時刻供給源となり得るようなサーバのネットワークにおいて、役立つ -ものです。 +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 このコマンドは、同期するのにふさわしい通信相手を認証する目的にとって 信用できる暗号化キー識別子を指定するのに使用されます。異なるサーバは 異なるキーを使用できますが、認証手続きにはローカルとリモート両方の サーバがこの目的のため同一のキーとキー識別子を共有することが必要です。 引数は、32 ビット符合なし整数ですが、 NTP キー 0 は固定されており周知の ものであることに注意してください。意味のある認証が行われるべきならば、 キー 0 は信用すべきではありません。 .PP .B requestkey .I # .PP このコマンドは、 .IR xntpd (8) の動作に影響を与える問題の診断と修復に役立つ .IR xntpdc (8) プログラムにより使用されるキー識別子を指定します。 .I xntpdc プログラムの動作は、 xntpd のこの固有の実装に特定されており、これ および以前のバージョンのデーモンとのみ動作すると見込まれます。ローカル サーバの状態に影響を与えるリモートの .I xntpdc プログラムからの要求は、 認証されねばなりません。そのためには、リモートプログラムとローカル サーバが共通のキーとキー識別子を共有することが必要です。このコマンドの引数は、 32 ビット符合なし整数です。設定ファイルに .B controlkey コマンドが含まれていないか、キーがマッチしないと、この要求は無視され ます。 .PP .B controlkey .I # .PP このコマンドは、 .IR xntpd (8) の動作に影響を与える問題の診断と修復に役立つ .IR ntpq (8) プログラムにより使用されるキー識別子を指定します。 .IR ntpq プログラムと .I xntpd の動作は RFC 1305 の定義を満たしています。ローカルサーバの状態に影響 を与えるリモートの .I ntpq プログラムからの要求は、認証されねばなりません。そのためには、リモート プログラムとローカルサーバが共通のキーとキー識別子を共有することが 必要です。このコマンドの引数は、32 ビット符合なし整数です。 設定ファイルに .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".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 このコマンドは、付加的なシステム変数を追加します。これらの変数は、 アクセスポリシなどの付加的な情報を配布するために使用できます。 = の形式の変数に、キーワード .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) サーバに あわせて設計されているからです。