diff --git a/ja_JP.eucJP/man/man1/cdcontrol.1 b/ja_JP.eucJP/man/man1/cdcontrol.1 index 84bb231c2c..d6599c5e52 100644 --- a/ja_JP.eucJP/man/man1/cdcontrol.1 +++ b/ja_JP.eucJP/man/man1/cdcontrol.1 @@ -1,189 +1,193 @@ -.\" %FreeBSD: src/usr.sbin/cdcontrol/cdcontrol.1,v 1.21.2.10 2001/08/16 15:55:42 ru Exp % +.\" %FreeBSD: src/usr.sbin/cdcontrol/cdcontrol.1,v 1.21.2.11 2002/05/17 09:40:49 maxim Exp % .\" .\" $FreeBSD$ .\" .Dd July 3, 1995 .Dt CDCONTROL 1 .Os .Sh 名称 .Nm cdcontrol .Nd コンパクトディスク制御ユーティリティ .Sh 書式 .Nm cdcontrol .Op Fl sv .Op Fl f Ar device .Op Ar command ... .Sh 解説 .Nm はオーディオ CD プレイヤーを操作するためのプログラムです。 device には .Pa cd0 や .Pa mcd0 などを指定します。 .Pp コマンドを指定しない場合、 .Nm は対話モードになり、標準入力からコマンドを読み込みます。 .Pp 以下のオプションを使用可能です。 .Bl -tag -width indent .It Fl s サイレントモード - テーブルヘッダ及び人間が可読なコメントを表示しません。 .It Fl v 冗長モード - 表示できる情報は全て表示します。 .It Fl f Ar device .Pa /dev/cd0c や .Pa mcd0 といったデバイスを指定します。 絶対パス及び .Pa /dev からの相対パスの指定が可能です。 必要ならば最後に `c' を追加します。 .El .Pp 現時点では以下のコマンドが利用できます。 コマンドをユニークに特定できるために必要な文字だけ指定する 必要があります。 語 .Cm play は省略可能であり、 .Cm next と .Cm prev の代りに文字 .Dq + と .Dq - を使用可能です。 .Bl -tag -width Cm .It Cm play first_track last_track .Ar first_track で指定されたトラックから .Ar last_track で指定されたトラックまで演奏します。最初のトラックが1番になります。 .It Cm play Xo .Ar start_m : Ns Ar start_s . Ns Ar start_f .Oo Ar end_m : Ns Ar end_s . Ns .Ar end_f Oc .Xc 絶対アドレス (MSF) を元に演奏します。演奏開始する時間は .Ar start_m に演奏開始する分を、 .Ar start_s に秒を、 .Ar start_f にはフレーム番号を指定します。演奏終了の時間は .Ar end_m に演奏終了する分を、 .Ar end_s, に秒を、 .Ar end_f にフレーム番号を指定することで指定できます。分指定で指定できる数値は 0 から 99 の範囲の値です。秒には 0 から 59 までが指定できます。フレーム 番号は 0 から 74 までの範囲で指定できます。 .It Cm play Op Ar #start_block Op length 論理ブロック .Ar start_block から .Ar length 論理ブロック分だけ演奏します。 .It Cm next Op Ar tracks 指定した数のトラックを、前向きにスキップします (デフォルト 1)。 .It Cm prev Op Ar tracks 指定した数のトラックを、後向きにスキップします (デフォルト 1)。 .It Cm pause 演奏を停止します。ディスクは停止しません。 .It Cm resume 演奏を再開します。 .Em pause で一時停止した後に使います。 .It Cm stop ディスクを停止します。 .It Cm eject ディスクを取り出します。 .It Cm close ディスクを挿入します。 .It Cm setvol left_channel right_channel 左チャネルのボリュームを .Ar left_channel にセットし、右チャネルを .Ar right_channel にセットします。指定できる値は 0 から 255 の範囲の値です。 .It Cm volume Ar mute 音を消します。 .It Cm volume Ar mono モノラルモードにします。 .It Cm volume Ar stereo ステレオモードにします。 .It Cm volume Ar left 左サブトラックを左と右の両チャネルで演奏します。 .It Cm volume Ar right 右サブトラックを左と右の両チャネルで演奏します。 .It Cm info 目次を表示します。 .It Cm status Xo .Op Ar audio | media | volume .Xc ディスクに関する以下のような情報を表示します: .Pp .Bl -tag -width "volume" -compact .It Ar audio 現在の演奏の状態と位置、 .It Ar media 現在のメディアカタログ状態、 .It Ar volume 現在の左チャネル及び右チャネルのボリューム値。 .El .It Cm cdid CD のシリアル番号を、 cddb (http://www.cddb.org/) プロジェクトが使用する方法を使用して、 表示します。 .It Cm help 利用可能なコマンドの一覧を表示します。 .It Cm debug Ar on CD デバイスドライバのデバッグモードを有効にします。 .It Cm debug Ar off ドライバのデバッグモードを無効にします。 .It Cm reset デバイスに対するハードウェアリセットを実行します。 .It Cm set Ar msf minute-second-frame ioctl モードに設定します (デフォルト)。 .It Cm set Ar lba LBA ioctl モードに設定します。 +.It Cm speed Ar s +ドライブが使用可能な最高速度を指定します。 +速度は、何倍速にするかを指定します。 +本コマンドは、現在、ATABI ドライブでのみサポートされています。 .It Cm quit プログラムを終了します。 .El .Sh 環境変数 次の環境変数が .Nm の実行に影響します: .Pp .Bl -tag -width CD_DRIVE -compact .It Ev CDROM .Fl f フラグで指定しなかった場合に使用される CD デバイス。 .Pp .It Ev CDPLAY .It Ev CD_DRIVE .It Ev DISC .It Ev MUSIC_CD .Ev CDROM が選ばれたため、これらの変数の価値は低下しています。 .El .Sh 関連ファイル .Bl -tag -width /dev/mcd0c -compact .It Pa /dev/cd0c .It Pa /dev/mcd0c .It Pa /dev/acd0c .El .Sh 作者 .An Jean-Marc Zucconi , .An Andrey A.\ Chernov , .An Serge V.\ Vakulenko .Sh 歴史 .Nm コマンドは .Fx 2.1 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/dig.1 b/ja_JP.eucJP/man/man1/dig.1 index 3dc2d3b2e2..9e3794a74b 100644 --- a/ja_JP.eucJP/man/man1/dig.1 +++ b/ja_JP.eucJP/man/man1/dig.1 @@ -1,674 +1,690 @@ -.\" %FreeBSD: src/contrib/bind/doc/man/dig.1,v 1.3 1999/11/30 02:52:54 peter Exp % +.\" %FreeBSD: src/contrib/bind/doc/man/dig.1,v 1.3.2.1 2002/05/15 19:51:23 nectar Exp % +.\" $Id: dig.1,v 1.12 2002-05-18 06:26:21 horikawa Exp $ .\" .\" ++Copyright++ 1993 .\" - .\" 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. .\" - .\" Portions Copyright (c) 1993 by Digital Equipment Corporation. .\" .\" Permission to use, copy, modify, and distribute this software for any .\" purpose with or without fee is hereby granted, provided that the above .\" copyright notice and this permission notice appear in all copies, and that .\" the name of Digital Equipment Corporation not be used in advertising or .\" publicity pertaining to distribution of the document or software without .\" specific, written prior permission. .\" .\" THE SOFTWARE IS PROVIDED "AS IS" AND DIGITAL EQUIPMENT CORP. DISCLAIMS ALL .\" WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL DIGITAL EQUIPMENT .\" CORPORATION BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL .\" DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR .\" PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS .\" ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS .\" SOFTWARE. .\" - .\" --Copyright-- .\" .\" Distributed with 'dig' version 2.0 from University of Southern .\" California Information Sciences Institute (USC-ISI). .\" .\" dig.1 2.0 (USC-ISI) 8/30/90 .\" .\" Original Regision: 1.1.1.1 -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/dig.1,v 1.10 2001/07/29 05:14:50 horikawa Exp $ +.\" $FreeBSD$ .Dd August 30, 1990 .Dt DIG 1 .Os BSD 4 .Sh 名称 dig \- ドメイン名問い合わせパケットをネームサーバに送る .Sh 書式 .Nm dig .Op Ic @ Ns Ar server .Ar domain .Op Aq Ar query-type .Op Aq Ar query-class .Op Ic + Ns Aq Ar query-option .Op Fl Aq Ar dig-option .Op Ar %comment .Sh 解説 .Ic dig (ドメイン情報手探り器; domain information groper) は、 DNS (Domain Name System) サーバから情報を集めるために使われる 柔軟なコマンドラインツールです。 .Ic dig は 2 つのモードを持っています。 これは、1 つの問い合わせを行う単純な対話的利用モードと、 いくつかの問い合わせ行のリスト中の各問い合わせを実行するバッチモードです。 すべての問い合わせオプションは、コマンドラインから利用可能です。 .Pp 普通の簡単な .Ic dig の使用法は、以下のような形式です。 .Pp .Bd -ragged -offset indent-two .Ic dig @ Ns Ar server domain query-type query-class .Ed .Pp ここで、 .Bl -tag -width Fl .It Ar server は、ドメイン名かドット表記のインターネットアドレスのどちらかです。 もし、このオプションフィールドが省略された場合、 .Ic dig は、そのマシンのデフォルトのネームサーバを利用しようとします。 .Pp -.Em 注: +.Em 注 : ドメイン名が指定された時は、ドメイン名システムリゾルバ (つまり、BIND) を使うことで解決しようとします。システムが DNS を 提供していない時は、ドット形式のアドレスを指定する必要があります。 利用できるサーバがどこかにある場合は、必要なことは .Pa /etc/resolv.conf が存在し、 .Ar server 自身が解決できるように、そのデフォルトネームサーバがどこにあるかが 記述されていることだけです。 .Pa /etc/resolv.conf についての情報は .Xr resolver 5 を参照してください。 -.Sy 警告: +.Sy 警告 : .Pa /etc/resolv.conf を変更すると、標準のリゾルバライブラリと .Pq 潜在的に それを使ういくつかのプログラムに影響を与えます。 オプションとして、ユーザは環境変数 .Ev LOCALRES を設定し、 .Pa /etc/resolv.conf の代わりに使うファイルの名前を指定できます。 .Po Ns Ev LOCALRES 変数は .Ic dig リゾルバ固有のもので、標準のリゾルバでは 参照されません .Pc 。 .Ev LOCALRES 変数が設定されていないか、 設定されたファイルが読み込めない場合は、 .Pa /etc/resolv.conf が使われます。 .It Ar domain は、あなたが情報を要求しているドメイン名です。 逆アドレスの問い合わせのための便利な方法は、 .Fl x オプションを参照してください(この節の .Sx その他のオプション の項で述べられています)。 .It Ar query-type は、あなたが要求している情報のタイプ(DNS 問い合わせタイプ)です。 省略された場合のデフォルトは、 .Dq Ar a .Pq Dv T_A = アドレス が使われます。以下のタイプが認識されます。 .Pp .Bl -hang -width "hinfo T_HINFO " -compact .It Ar a\ \ \ \ \ \ Dv T_A ネットワークアドレス .It Ar any\ \ \ \ Dv T_ANY 指定されたドメインのすべて/任意の情報 .It Ar mx\ \ \ \ \ Dv T_MX ドメインのメール交換情報 (MX) .It Ar ns\ \ \ \ \ Dv T_NS ネームサーバ .It Ar soa\ \ \ \ Dv T_SOA ゾーンの権威者を表すレコード .It Ar hinfo\ \ Dv T_HINFO ホスト情報 .It Ar axfr\ \ \ Dv T_AXFR ゾーン転送情報(権威を持ったサーバに尋ねなければなりません) .It Ar txt\ \ \ \ Dv T_TXT 任意の数の文字列 .El .Pp (完全なリストは、RFC 1035 を参照してください。) .It Ar query-class は、問い合わせで要求されるネットワーククラスです。 省略された場合のデフォルトは、 .Dq Ar in .Pq Dv C_IN = Internet です。 以下のクラスが認識されます。 .Pp .Bl -tag -width "hinfo T_HINFO " -compact .It Ar in\ \ \ \ \ Dv C_IN インターネットクラスドメイン .It Ar any\ \ \ \ Dv C_ANY すべて/任意のクラスの情報 .El .Pp (完全なリストは、RFC 1035 を参照してください。) .Pp -.Em 注: +.Em 注 : .Dq Ar any は、 .Em クラス や問い合わせの .Em タイプ を指定するために使われます。 .Ic dig は、最初に現れた .Dq Ar any を .Ar query-type = Dv T_ANY として解析します。 .Ar query-class = Dv C_ANY にするためには、 .Dq any を 2 度指定するか、 .Fl c オプション(以下参照)を利用して問い合わせクラスを 指定しなければなりません。 .El .Ss その他のオプション .Bl -tag -width Fl .It % Ns Ar ignored-comment .Dq % は、単に解析されない引数を含むために使われます。 これは、 .Ic dig をバッチモードで実行する時に有効です。 問い合わせリスト中のすべての .Ar @server-domain-name を解決する代わりに、 そのオーバヘッドを避けつつコマンドライン上にドメイン名を書くことが出来ます。 以下の例を参照。 .Pp .Bd -ragged -offset indent-two .Ic dig @128.9.0.32 %venera.isi.edu mx isi.edu .Ed .Pp .It Fl Aq Ar dig option .Dq Fl は、 .Ic dig の操作に影響を与えるオプションを指定するために 使われます。以下のオプションが現在利用可能です ( 便利であるかどうかは保証しません )。 .Bl -tag -width Fl .It Fl x Ar dot-notation-address 逆アドレス変換を指定する便利な形式です。 .Dq Ic dig 32.0.9.128.in-addr.arpa の代わりに、 .Dq Ic dig -x 128.9.0.32 と指定できます。 .It Fl f Ar file .Ic dig のバッチモードのためのファイルです。ファイルは、 つづいて実行される問い合わせの指定 ( .Ns Ic dig のコマンドライン) の リストを含んでいます。 .Sq \&; , .Sq # , .Sq \en で始まる行は無視されます。その他のオプションは、 コマンドラインで現れるものは、個々のバッチによる問い合わせでも 影響があります。 .It Fl T Ar time バッチモードで実行した時、連続した問い合わせの始まる時間間隔を秒で与え ます。2 つ以上のバッチ .Ic dig コマンドの実行を大体同期することができる ようになります。デフォルトは 0 です。 .It Fl p Ar port ポート番号です。標準でないポート番号で待つネームサーバに問い合わせます。 デフォルトは 53 です。 .It Fl p Ns Bq Ar ping-string 問い合わせからかえってきた後で、 .Xr ping 8 コマンドを応答時間の比較のために実行します。これは、美しくないのですが、 シェルを呼び出します。統計の最後の 3 行がコマンドのために 表示されます。 .Pp .Bd -ragged -offset indent-two .Ic ping Fl s server_name 56 3 .Ed .Pp オプションの .Dq Ar ping-string が存在した時は、シェルコマンドでは .Dq Ic ping Fl s を置き換えます。 .It Fl t Ar query-type 問い合わせのタイプを指定します。タイプフィールド内の整数値か、 上で述べたニーモニック表現 (つまり .Ar mx = Dv T_MX ) かで 指定することができます。 .It Fl c Ar query-class 問い合わせのクラスを指定します。クラスフィールド内の整数値か、 上で述べたニーモニック表現 (つまり in = C_IN) で 指定することができます。 .It Fl k Ar keydir:keyname ディレクトリ keydir 中の TSIG キー名 keyname で、問い合わせます。 .It Fl envsav このフラグを指定すると、すべての引数が解析された後で .Ic dig 環境 (デフォルトや表示オプション等) を デフォルト環境としてファイルに保存します。 標準のデフォルトが気に入らず、 .Ic dig を使う度にたくさんのオプションを指定することが嫌な場合は便利です。 環境は、 .Ic dig 出力 (以下参照) で詳しく述べられるフラグと同じように、 リゾルバの状態変数フラグや、タイムアウト、再試行回数からなります。 シェル環境変数 .Ev LOCALDEF がファイルの名前に設定されている場合、 これが、デフォルトの .Ic dig 環境が保存される場所となります。 そうでない場合は、ファイル .Dq DiG.env が現在の作業ディレクトリに 作成されます。 .Pp -.Em 注: +.Em 注 : .Ev LOCALDEF は、 .Ic dig のリゾルバ固有であり、 標準のリゾルバライブラリの操作には影響を与えません。 .Pp .Ic dig が実行される度に、 .Dq ./DiG.env またはシェル環境変数 .Ev LOCALDEF で指定されたファイルが探されます。そのようなファイルが 存在し読める場合は、引数を解析する前にこのファイルから環境が 読み込まれます。 .It Fl envset このフラグは、バッチ問い合わせを実行する時にだけ影響があります。 .Ic dig バッチファイル中で .Dq Fl envset が指定されていると、 この引数が解析された後の .Ic dig 環境は、バッチファイルが実行されている間もしくは、次の .Dq Fl envset が指定されるまでの間は、 デフォルトの環境となります。 .It Xo .Fl Op Cm no .Ns Cm stick .Xc このフラグは、バッチ問い合わせ実行にだけ影響を与えます。 これは、 .Ic dig 環境を .Ic dig バッチファイル中での 各問い合わせ (行) の前に (初期状態もしくは、 .Dq Fl envset で設定された) 元の状態に戻すことを指定します。 デフォルトの .Dq Fl nostick は、 .Ic dig 環境を回復しないという意味ですので、 .Ic dig バッチファイルの各行で指定されたオプションは、 後の行でもその効果が残ったままになります (つまり .Dq sticky 時のデフォルトのようには回復されません)。 .El .It Ic + Ns Aq Ar query option .Dq + はパケット問い合わせ中のオプション変更や .Ic dig 出力仕様を変更するために使われます。 これらの多くは、 .Xr nslookup 8 で受け入れられるパラメータと同じものです。 オプションが値を必要とする場合、その指定形式は以下のようになります。 .Pp .Bd -ragged -offset indent-two .Ic + .Ns Ar keyword .Ns Op = Ns Ar value .Ed .Pp ほとんどのキーワードは、省略が可能です。 .Dq + オプションの解釈は非常に単純です。 値はキーワードとスペースで区切ってはなりません。 以下のキーワードが現在利用可能です。 .Pp .Pp キーワード 省略形 意味 [デフォルト] .Pp .Bl -tag -width "[no]primary (ret) " -compact .It Xo .Op Cm no .Ns Cm debug\ \ \ \ .Pq Cm deb .Xc デバッグモードを変更 .Bq Cm deb .It Xo .Op Cm no .Ns Cm d2\ \ \ \ \ \ \ \ \ \ .Xc 追加のデバッグモードを変更 .Bq Cm nod2 .It Xo .Op Cm no .Ns Cm recurse\ \ .Pq Cm rec .Xc 再帰的探索を使うかどうか指定 .Bq Cm rec .It Xo .Cm retry= Ns Ar # .Cm \ \ \ \ \ .Pq Cm ret .Xc 再試行の回数を # に設定 .Bq 4 .It Xo .Cm time= Ns Ar # .Cm \ \ \ \ \ \ .Pq Cm ti .Xc タイムアウト時間を # 秒に設定 .Bq 4 .It Xo .Op Cm no .Ns Cm ko .Xc 繋げておくオプション(vc を暗黙指定) .Bq Cm noko .It Xo .Op Cm no .Ns Cm vc .Xc 仮想回線を使うかどうか指定 .Bq Cm novc .It Xo .Op Cm no .Ns Cm defname\ \ .Pq Cm def .Xc デフォルトドメイン名を使うかどうか指定 .Bq Cm def .It Xo .Op Cm no .Ns Cm search\ \ \ .Pq Cm sea .Xc ドメインサーチリストを使うかどうか指定 .Bq Cm sea .It Xo .Cm domain= Ns Ar NAME\ \ .Pq Cm do .Xc デフォルトドメイン名を .Ar NAME に指定 .It Xo .Op Cm no .Ns Cm ignore\ \ \ .Pq Cm i .Xc trunc. エラーを無視するかどうか指定 .Bq Cm noi .It Xo .Op Cm no .Ns Cm primary\ \ .Pq Cm pr .Xc プライマリサーバを使うかどうか指定 .Bq Cm nopr .It Xo .Op Cm no .Ns Cm aaonly\ \ \ .Pq Cm aa .Xc 権威を持った問い合わせのみのフラグ .Bq Cm noaa .It Xo .Op Cm no .Ns Cm cmd .Xc 解析された引数を表示 .Bq Cm cmd .It Xo .Op Cm no .Ns Cm stats\ \ \ \ .Pq Cm st .Xc 問い合わせの統計を表示 .Bq Cm st .It Xo .Op Cm no .Ns Cm Header\ \ \ .Pq Cm H .Xc 基本的なヘッダを表示 .Bq Cm H .It Xo .Op Cm no .Ns Cm header\ \ \ .Pq Cm he .Xc ヘッダフラグを表示 .Bq Cm he .It Xo .Op Cm no .Ns Cm ttlid\ \ \ \ .Pq Cm tt .Xc TTL を表示 .Bq Cm tt .It Xo .Op Cm no +.Ns Cm trunc\ \ \ \ +.Pq Cm tr +.Xc +名前から origin を削除 +.Bq Cm tr +.It Xo +.Op Cm no .Ns Cm cl .Xc クラス情報を表示 .Bq Cm nocl .It Xo .Op Cm no .Ns Cm qr .Xc 出て行った問い合わせを表示 .Bq Cm noqr .It Xo .Op Cm no .Ns Cm reply\ \ \ \ .Pq Cm rep .Xc 応答節を表示 .Bq Cm rep .It Xo .Op Cm no .Ns Cm ques\ \ \ \ \ .Pq Cm qu .Xc 質問節を表示 .Bq Cm qu .It Xo .Op Cm no .Ns Cm answer\ \ \ .Pq Cm an .Xc 回答節を表示 .Bq Cm an .It Xo .Op Cm no .Ns Cm author\ \ \ .Pq Cm au .Xc 権威節を表示 .Bq Cm au .It Xo .Op Cm no .Ns Cm addit\ \ \ \ .Pq Cm ad .Xc 追加節を表示 .Bq Cm ad +.It Xo +.Op Cm no +.Ns Cm dnssec\ \ \ +.Pq Cm \ddn +.Xc +OPT 擬似レコード中で DNSSEC OK ビットを設定 +.Bq Cm nodn .It Cm pfdef デフォルト表示フラグを設定 .It Cm pfmin 最小のデフォルト表示フラグを設定 .It Cm pfset= Ns Ar # 表示フラグを # に設定 (# は 16 進 /8 進/10 進が可能です) .It Cm pfand= Ns Ar # 表示フラグに # とのビット論理積 (and) 適用 .It Cm pfor= Ns Ar # 表示フラグに # とのビット論理和 (or) 適用 .El .Pp .Cm 再試行回数 と .Cm 時間 のオプションは、問い合わせデータグラムを送る際に、 リゾルバライブラリによって使われる再送戦略に影響を与えます。 アルゴリズムは以下の通りです .Pp .Bd -literal -offset indent for i = 0 to retry - 1 for j = 1 to num_servers send_query wait((time * (2**i)) / num_servers) end end .Ed .Pp (注: .Ic dig はいつも .Dq Li num_servers として値 1 を使います。) .El .Ss 詳細 .Ic dig は、かつて BINDの .Xr resolver 3 ライブラリの変更版を要求しました。 BIND のリゾルバは、(BIND 4.9のように) .Ic dig を正しく動作させるようになって来ています。本質的には、 .Ic dig は、引数の解釈と適切なパラメータ設定を(見事にではなく)卒直に行うものです。 .Ic dig はリゾルバの関数 .Fn res_init , .Fn res_mkquery , .Fn res_send を使い、また .Ft _res 構造体を操作します。 .Sh 環境変数 .Bl -tag -width "LOCALRES " -compact .It Ev LOCALRES .Pa /etc/resolv.conf の代わりに使うファイル .It Ev LOCALDEF デフォルトの環境ファイル .El .Pp 上述した .Fl envsav , .Fl envset , .Xo .Fl Op Cm no .Ns Cm stick .Xc オプションの説明も参照してください。 .Sh 関連ファイル .Bl -tag -width "/etc/resolv.conf " -compact -.It Pa /etc/resolv.conf +.It Pa /etc/resolv.conf 初期状態のドメイン名とネームサーバのアドレス .It Pa \./DiG.env デフォルトオプションを保存するデフォルトファイル .El .Sh 関連項目 .Xr named 8 , .Xr resolver 3 , .Xr resolver 5 , .Xr nslookup 8 .Sh 規格 RFC 1035 .Sh 作者 Steve Hotz hotz@isi.edu .Sh 謝辞 .Ic dig は、Andrew Cherenson によって書かれた .Xr nslookup 8 の関数を使っています。 .Sh バグ .Ic dig は "潜行性機能過多" を患っています。 これは開発中に潜在的な用途をいくつも考えていた結果です。 苛酷なダイエットをしたらきっとよくなるでしょう。 同様に、表示フラグとそれで指定できる表示項目の粗さとから、 これらがその場限りの必要性から追加されたものだということが わかるはずです。 .Pp リゾルバ中のどこかで問題が発生した時に、 .Ic dig はうまく (しかるべき終了ステータスで) 終了してくれるとは限りません。 -.Po Sy 注: +.Po +.Sy 注 : 大概のよくある終了条件はきちんと処理できます .Pc 。 これは、特にバッチモードで実行している時に頭の痛い問題です。 異常終了し (さらにそれが捕捉されなかっ) た時には、 バッチ全体が終了してしまいますが、 そのようなイベントが捕捉された時には、 .Ic dig はそのまま次の問い合わせを続けるだけです。 diff --git a/ja_JP.eucJP/man/man1/dnskeygen.1 b/ja_JP.eucJP/man/man1/dnskeygen.1 index 245c6ba5f5..f176b94308 100644 --- a/ja_JP.eucJP/man/man1/dnskeygen.1 +++ b/ja_JP.eucJP/man/man1/dnskeygen.1 @@ -1,140 +1,140 @@ .\" Copyright (c) 1996,1999 by Internet Software Consortium .\" .\" Permission to use, copy, modify, and distribute this software for any .\" purpose with or without fee is hereby granted, provided that the above .\" copyright notice and this permission notice appear in all copies. .\" .\" THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM DISCLAIMS .\" ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL INTERNET SOFTWARE .\" CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL .\" DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR .\" PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS .\" ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS .\" SOFTWARE. .\" -.\" %Id: dnskeygen.1,v 8.5 1999/02/23 05:20:18 vixie Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/dnskeygen.1,v 1.4 2001/05/14 01:07:22 horikawa Exp $ +.\" $Id: dnskeygen.1,v 1.6 2002-05-18 06:26:21 horikawa Exp $ +.\" $FreeBSD$ .\" .Dd December 2, 1998 .Dt DNSKEYGEN 1 .Os BSD 4 .Sh 名称 .Nm dnskeygen .Nd DNS セキュリティ用に、公開鍵・秘密鍵・共有秘密鍵を生成する .Sh 書式 .Nm dnskeygen -.Oo Fl -.Op Cm DHR +.Oo +.Fl Op Cm DHR .Ar size .Oc .Op Fl F -.Fl Op Cm zhu -.Op Cm Fl a -.Op Cm Fl c -.Op Cm Fl p Ar num -.Op Cm Fl s Ar num +.Op Fl Cm zhu +.Op Fl Cm a +.Op Fl Cm c +.Op Fl Cm p Ar num +.Op Fl Cm s Ar num .Fl n Ar name .Sh 解説 .Ic dnskeygen (DNS Key Generator; DNS 鍵生成器) は、DNS (Domain Name System) の枠組における DNS セキュリティ用に、 鍵の生成と維持を行うツールです。 .Nm dnskeygen は、ゾーンデータを認証するための公開鍵と秘密鍵を生成可能であり、 リクエストとトランザクションの署名に使われる共有秘密鍵を生成可能です。 .Bl -tag -width Fl .It Fl D dnskeygen は、 .Ic DSA/DSS 鍵を生成します。 .Dq size は、[512, 576, 640, 704, 768, 832, 896, 960, 1024] のいずれか ひとつである必要があります。 .It Fl H dnskeygen は、 .Ic HMAC-MD5 鍵を生成します。 .Dq size は 128 と 504 の間である必要があります。 .It Fl R dnskeygen は、単一の .Ic RSA 鍵を生成します。 .Dq size は 512 と 4096 の間である必要があります。 .It Fl F -.Ic (RSA のみ) +.Ic ( RSA のみ ) 鍵生成に大きな指数を使用します。 .It Fl z Fl h Fl u これらのフラグは、生成される鍵のタイプを定義します。 それぞれ、ゾーン (DNS 正当性確認) 鍵、ホスト (ホストまたはサービス) 鍵、 ユーザ (例えば電子メール) 鍵です。 各鍵は、対応する事柄に対してのみ使用可能です。 .It Fl a 鍵が認証に使用 .Ic 不可 であることを示します。 .It Fl c 鍵が暗号化に使用 .Ic 不可 であることを示します。 .It Fl p Ar num 鍵のプロトコルフィールドを .Ar num に設定します。デフォルトは、 .Dq Fl z または .Dq Fl h が指定された場合は .Ic 3 (DNSSEC) であり、その他の場合は .Ic 2 (EMAIL) です。 他に受理可能な値は .Ic 1 (TLS), .Ic 4 (IPSEC), .Ic 255 (ANY) です。 .It Fl s Ar num 鍵の強さのフィールドを .Ar num に設定します。デフォルトは、 .Sy 0 です。 .It Fl n Ar name 鍵の名前を .Ar name に設定します。 .El .Ss 詳細 .Ic dnskeygen は、各鍵を 2 個のファイル .Pa K++.private と .Pa K++.key に格納します。 ファイル .Pa K++.private は、可搬書式で秘密鍵を格納します。 ファイル .Pa K++.key は、下記の DNS ゾーンファイル書式で、公開鍵を格納します: .Pp .D1 Ar IN KEY .Sh 環境変数 使用される環境変数はありません。 .Sh 関連項目 .Em RFC 2065 のセキュア DNS 部分と .Em TSIG Internet Draft .Sh 作者 Olafur Gudmundsson (ogud@tis.com) .Sh 謝辞 拠所とする暗号数学は、DNSSAFE や Foundation Toolkit ライブラリに よるものです。 .Sh バグ 現在既知のものはありません。 diff --git a/ja_JP.eucJP/man/man1/dnsquery.1 b/ja_JP.eucJP/man/man1/dnsquery.1 index 22462c159e..8cc3f6e4aa 100644 --- a/ja_JP.eucJP/man/man1/dnsquery.1 +++ b/ja_JP.eucJP/man/man1/dnsquery.1 @@ -1,181 +1,181 @@ -.\" %Id: dnsquery.1,v 8.3 1999/01/08 18:54:21 vixie Exp % +.\" $Id: dnsquery.1,v 1.7 2002-05-18 06:26:21 horikawa Exp $ .\" .\"Copyright (c) 1995,1996,1999 by Internet Software Consortium .\" .\"Permission to use, copy, modify, and distribute this software for any .\"purpose with or without fee is hereby granted, provided that the above .\"copyright notice and this permission notice appear in all copies. .\" .\"THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM DISCLAIMS .\"ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES .\"OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL INTERNET SOFTWARE .\"CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL .\"DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR .\"PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS .\"ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS .\"SOFTWARE. .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/dnsquery.1,v 1.5 2001/05/14 01:07:22 horikawa Exp $ +.\" $FreeBSD$ .\" Original Revision: 1.1.1.2 .\" .Dd March 10, 1990 .Dt DNSQUERY 1 .Os BSD 4 .Sh 名称 .Nm dnsquery .Nd リゾルバを用いて DNS に問い合わせる .Sh 書式 .Nm dnsquery .Op Fl n Ar nameserver .Op Fl t Ar type .Op Fl c Ar class .Op Fl r Ar retry .Op Fl p Ar period .Op Fl d .Op Fl s .Op Fl v .Ar host .Sh 解説 .Ic dnsquery プログラムは、BIND リゾルバのライブラリ呼び出しによって ネームサーバとやりとりする一般的なインタフェースです。 本プログラムはオペコード QUERY によるネームサーバ問い合わせを サポートしています。 本プログラムは、nstest, nsquery, nslookup のようなプログラムを 置き換えるあるいは補うものとして作成されました。 .Ar host と .Ar nameserver 以外の引数は大文字小文字を区別しません。 .Sh オプション .Bl -tag -width Fl .It Fl n Ar nameserver 問い合わせに用いるネームサーバ。 ネームサーバ指定は、w.x.y.z 形式のインターネットアドレス表記でも、 ドメインネーム表記でも構いません。 (デフォルト: .Pa /etc/resolv.conf の指定。) .It Fl t Ar type 関心あるリソースレコード型。型には以下のものがあります: .Bl -tag -width "AFSDB " -compact -offset indent .It Ar A アドレス .It Ar NS ネームサーバ .It Ar CNAME 正式名 -.It Ar PTR +.It Ar PTR ドメインネームへのポインタ -.It Ar SOA +.It Ar SOA 権威の開始 (Start of Authority) -.It Ar WKS +.It Ar WKS よく知られたサービス (well-known service) .It Ar HINFO ホスト情報 .It Ar MINFO メールボックス情報 -.It Ar MX +.It Ar MX メールエクスチェンジ (mail exchange) -.It Ar RP +.It Ar RP 責任者 (responsible person) -.It Ar MG +.It Ar MG メールグループメンバ -.It Ar AFSDB +.It Ar AFSDB DCE または AFS サーバ -.It Ar ANY +.It Ar ANY ワイルドカード .El .Pp 大文字小文字どちらでも使用できます。(デフォルト: .Ar ANY )。 .It Fl c Ar class 関心あるリソースレコードのクラス。クラスには以下のものがあります: .Bl -tag -width "CHAOS " -compact -offset indent -.It Ar IN +.It Ar IN インターネット -.It Ar HS +.It Ar HS Hesiod .It Ar CHAOS Chaos -.It Ar ANY +.It Ar ANY ワイルドカード .El .Pp 大文字小文字どちらでも使用できます。(デフォルト: .Ar IN )。 .It Fl r Ar retry ネームサーバが応答しない場合のリトライ回数。(デフォルト: 4) .It Fl p Ar period .B \-p タイムアウト時間(秒)。(デフォルト: .Dv RES_TIMEOUT )。 .It Fl d デバッグ機能を有効にする。リゾルバの .Ft options フィールドの .Dv RES_DEBUG ビットをセットします。(デフォルト: デバッグ機能オフ) .It Fl s パケットではなく .Em ストリーム を用います。つまり、ネームサーバとの接続に UDP データグラムではなく、 TCP ストリームを用います。リゾルバの .Ft options フィールドの .Dv RES_USEVC ビットをセットします。(デフォルト: UDP データグラム) .It Fl v オプション .Dq Fl s と同じ意味です。 .It Ar host 関心あるホスト名(あるいはドメイン名)。 .El .Sh 関連ファイル .Bl -tag -width " " -compact .It Pa /etc/resolv.conf デフォルトのネームサーバと検索リスト -.It Pa +.It Pa 利用できる RR タイプとクラスの一覧 -.It Pa +.It Pa リゾルバのフラグ一覧 .El .Sh 診断 リゾルバが問い合わせの回答に失敗し、デバッグ機能が有効になっていない場合、 .Ic dnsquery は単に以下のようなメッセージを表示します: .Dl Query failed (rc = 1) : Unknown host .Pp リターンコードの値は .Ft h_errno から得ます。 .Sh 関連項目 .Xr nslookup 8 , .Xr nstest 1 , .Xr nsquery 1 , .Xr named 8 , .Xr resolver 5 .Sh 作者 Bryan Beecher .Sh バグ .Ar IN 以外のクラスを問い合わせると面白い結果が得られることがあります。 というのは、ネームサーバは普通、クラス .Ar IN のリソースレコードとして ルートネームサーバのリストだけしか持っていないからです。 .Pp 本コマンドは、 .Fn inet_addr を呼び出して .Dq Fl n オプションが 正しいインターネットアドレスかどうかを判断します。 残念ながら、 .Fn inet_addr は一部の(正しくない)アドレス(例えば 1.2.3.4.5)に 対してセグメンテーションフォールトを起こすことがあるようです。 diff --git a/ja_JP.eucJP/man/man1/host.1 b/ja_JP.eucJP/man/man1/host.1 index ad5986926c..9ebb583418 100644 --- a/ja_JP.eucJP/man/man1/host.1 +++ b/ja_JP.eucJP/man/man1/host.1 @@ -1,329 +1,326 @@ .\" ++Copyright++ 1993 .\" - .\" 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. .\" - .\" Portions Copyright (c) 1993 by Digital Equipment Corporation. .\" .\" Permission to use, copy, modify, and distribute this software for any .\" purpose with or without fee is hereby granted, provided that the above .\" copyright notice and this permission notice appear in all copies, and that .\" the name of Digital Equipment Corporation not be used in advertising or .\" publicity pertaining to distribution of the document or software without .\" specific, written prior permission. .\" .\" THE SOFTWARE IS PROVIDED "AS IS" AND DIGITAL EQUIPMENT CORP. DISCLAIMS ALL .\" WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL DIGITAL EQUIPMENT .\" CORPORATION BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL .\" DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR .\" PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS .\" ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS .\" SOFTWARE. .\" - .\" --Copyright-- -.\" %Id: host.1,v 8.4 2000/02/29 03:50:47 vixie Exp % -.\" %FreeBSD: src/contrib/bind/doc/man/host.1,v 1.3.2.1 2000/11/02 14:08:07 asmodai Exp % +.\" $Id: host.1,v 1.12 2002-05-18 06:26:21 horikawa Exp $ +.\" %FreeBSD: src/contrib/bind/doc/man/host.1,v 1.3.2.2 2002/05/15 19:51:23 nectar Exp % .\" .\" .\" $FreeBSD$ .Dd December 15, 1994 .Dt HOST 1 .Os BSD 4 .Sh 名称 .Nm host .Nd ドメインサーバを使ってホスト名の検索を行なう .Sh 書式 .Nm host .Op Fl adlrwv .Op Fl c Ar class .Op Fl t Ar querytype .Ar host .Op Ar server .Sh 解説 .Ic host はインターネットホストに関する情報の検索を行ないます。 情報は世界中に広がった相互に接続されたサーバ群から得ます。 デフォルトではホスト名とインターネットアドレス間の変換のみを行ないます。 .Dq Fl t や .Dq Fl a オプションとともに使うと、そのホストに関するドメインサーバによって保守 されている情報のすべてを得ることができます。 .Pp 引数にはホスト名かホスト番号のいずれかを指定できます。 本プログラムはまず引数をホスト番号として解釈を試みます。 それがうまくいかなければ、ホスト名として扱います。 ホスト番号は 128.6.4.194 のようにドットによって区切られた 4 つの 10 進数からなります。 ホスト名は topaz.rutgers.edu のようにドットで区切られた複数の名前からなります。 名前がドットで終っていなければ、ローカルドメインが自動的に末尾に 付け加えられます。たとえば Rutgers のユーザは .Pp .D1 Ic host topaz .Pp というように使うことができ、これは実際には "topaz.rutgers.edu" が検索されます。 これがうまくいかなければ、名前は変更されずに (この例では "topaz" として) 試みられます。このやりかたはメールやその他のネットワークユーティリティ でも使われています。 実際に末尾に付け加えられる接尾辞は、 .Xr hostname 1 を呼び出した結果の最初のドット以降となります。(下記の .Sx ホスト名検索のカスタマイズ の節を参照してください。) .Pp 最初の引数は検索を行なうホスト名となります。これが数字の場合、 .Dq 逆引き が実行されます。すなわちドメインシステムは数字を名前に変換するための別 のデータベース群を参照します。 .Pp 2 番目の引数は省略可能です。ここでは問い合わせを行なうサーバを指定する ことができます。この引数が指定されなければ、デフォルトのサーバ (通常は ローカルマシン) が使われます。 .Pp 名前が指定された場合、3 つの異なった種類の結果が出力されます。 以下はそれらの例です。 .Pp .D1 Ic % host sun4 .Dl sun4.rutgers.edu is a nickname for ATHOS.RUTGERS.EDU .Dl ATHOS.RUTGERS.EDU has address 128.6.5.46 .Dl ATHOS.RUTGERS.EDU has address 128.6.4.4 .Dl ATHOS.RUTGERS.EDU mail is handled by ARAMIS.RUTGERS.EDU .Pp ここでユーザはコマンド .Dq Ic host sun4 を入力しています。最初の行は名前 .Dq Li sun4.rutgers.edu は実際にはニックネームであることを示しています。 正式なホスト名は .Dq Li ATHOS.RUTGERS.EDU です。続く 2 行ではアドレスが表示 されています。もし複数のネットワークインタフェースをもつシステムであ れば、その各々は別のアドレスを持ちます。最後の行では .Li ATHOS.RUTGERS.EDU は自分に対するメールは受け取らないことを示しています。このホスト宛ての メールは .Li ARAMIS.RUTGERS.EDU によって取り込まれます。いくつかのシステム ではそのメールを扱うシステムが複数存在することがあり、その場合はこの行 のような情報がさらに出力されます。技術的にはメールを受け取ることのでき るすべてのシステムがこのようなエントリを持つと考えられます。もしシステム がそのメールを自分自身で受け取る場合、 .Pp .D1 Li XXX mail is handled by XXX .Pp のように、そのシステム自身について言及したエントリがあるはずです。しかし、 メールを自分で受け取る多くのシステムではわざわざその事実について言及し ていません。もしあるシステムに .Dq Li mail is handled by のエントリがあるのにアドレスがなければ、 それは本当はインターネットの構成員ではないが、 ネットワーク上のあるシステムがメールをそこに転送してくることを示しています。 Usenet や Bitnet やその他の多くのネットワーク上のシステムではこの種の エントリを持っています。 .Sh オプション ホスト名の前に指定できるオプションは沢山あります。これらのオプションの ほとんどはドメインデータベースを保守しているスタッフにのみ意味のあるも のです。 .Bl -tag -width Fl .It Fl a .Dq all の意。 これは .Dq Fl v Fl t Cm any と同じです。 .It Fl c Ar class 非インターネットデータを検索する .Ar class 。 .It Fl d デバッグモードとなります。ネットワークトランザクションが詳細に表示されます。 .It Fl l 完全なドメインのリストを表示します。例えば .Pp .D1 Ic host -l rutgers.edu .Pp を実行すると、rutgers.edu ドメインのすべてのホストのリストを表示します。 .Dq Fl t オプションを使うことによって表示する情報にフィルタをかけることがで きます。デフォルトでは PTR と NS レコードを含んだアドレス情報が表示さ れます。 .Pp .D1 Ic host -l -v -t any rutgers.edu .Pp このコマンドでは rutgers.edu の完全なゾーンデータを正式なマスタファイル の形式でダウンロードします。(しかし不思議な理由により SOA レコードは 2 回リストされます。) .Pp -.Sy 注: +.Sy 注 : .Dq Fl l フラグは完全なゾーン転送を行なった後、 要求した情報をフィルタリングするように実装されています。このコマンドは 絶対に必要な時に限って使うべきです。 .It Fl r 再帰的な問い合わせを行ないません。これは ネームサーバがそのサーバ自身のデータベースに所持しているデータのみを返すこ とを意味します。サーバは他のサーバに情報の問い合わせを行ないません。 .It Fl d デバッグを有効にします。 ネットワークトランザクションの詳細が表示されます。 .It Fl s 署名から親の鍵を追跡します (DNSSEC)。 .It Fl t Ar querytype 特定の .Ar querytype の情報の検索を指定することができます。 引数は .Xr named 8 の man ページにおいて定義されています。現在サポートされ ているタイプには以下のものが含まれます: .Dq Cm a , .Dq Cm ns , .Dq Cm md , .Dq Cm mf , .Dq Cm cname , .Dq Cm soa , .Dq Cm mb , .Dq Cm mg , .Dq Cm mr , .Dq Cm null , .Dq Cm wks , .Dq Cm ptr , .Dq Cm hinfo , .Dq Cm minfo , .Dq Cm mx , .Dq Cm uinfo , .Dq Cm uid , .Dq Cm gid , .Dq Cm unspec さらに、ワイルドカード (これは .Dq Cm any か .Dq Cm * として指定されます) があり、上記のすべてのタイプを指定するためにつかいます。 タイプは小文字で指定しなければなりません。 デフォルトでは最初に .Dq Cm a が検索され、次に .Dq Cm mx が検索されます。ただし、verbose オプションが指定されていると、デフォルトでは .Dq Cm a のみの検索を行ないます。オプション .Dq Fl t は .Ic host が返す情報にフィルタをかけるのに特に有効です。 それ以上の情報は下記の .Dq Fl l オプションの説明を参照してください。 .It Fl a .Dq すべて 。 .Dq Fl v Fl t Cm any と同じです。 .It Fl l 完全なドメインを列挙します。例えば .Pp .D1 Ic host -l rutgers.edu .Pp は、rutgers.edu domain 内のすべてのホストを列挙します。 .Dq Fl t オプションを使用して、どの情報を表示するかを、意図通りフィルタ可能です。 デフォルトは、アドレス情報と PTR と NS レコードです。 コマンド .Pp .D1 Ic host -l -v -t any rutgers.edu .Pp は、rutgers.edu に対するゾーンデータの完全なダウンロードを、 公式なマスタファイル書式で与えます (しかしながら、不可解な理由で、SOA レコードは 2 度表示されます)。 .Pp -.Sy 注: +.Sy 注 : .Dq Fl l の実装は、完全なゾーン転送を行い、 これに対して要求した情報をフィルタアウトすることで行われます。 このコマンドの使用は、本当に必要な場合に限るべきです。 .El .Sh ホスト名検索のカスタマイズ 一般にユーザによって指定された名前にドットが含まれていなければ、 デフォルトのドメインがその末尾に付け加えられます。このドメインは .Pa /etc/resolv.conf において定義することができますが、通常はローカルの ホスト名の最初のドット以降を取ることによって求められます。ユーザは環境変数 .Ev LOCALDOMAIN を使って異なるデフォルトドメインを指定することによって、これを オーバーライドすることができます。さらに、ユーザはホスト名の独自の略称を使うこ ともできます。略称は 1 つの略称につき 1 行からなるファイルにおいて指定 します。各行には略称、スペース、そして完全なホスト名が含まれます。この ファイルは環境変数 .Ev HOSTALIASES にてファイル名を指定します。 .Sh 環境変数 -.Bl -tag -width "/etc/resolv.conf " -compress +.Bl -tag -width "/etc/resolv.conf " -compact .It Ev HOSTALIASES .Pq Ar ホストの別名 , 完全なホスト名 のペアを含んでいるファイルのファイル名 .El .Sh 関連ファイル -.Bl -tag -width "/etc/resolv.conf " -compress +.Bl -tag -width "/etc/resolv.conf " -compact .It Pa /etc/resolv.conf .Xr resolver 5 を参照してください。 -.It Ev HOSTALIASES -.Pq Ar ホストの別名 , 完全なホスト名 -のペアを含んでいるファイルのファイル名 .El .Sh 関連項目 .Xr named 8 、 .Xr resolver 5 .Sh バグ ローカルドメインに含まれない名前を入力すると予期できない影響が起こり得 ます。名前がドットで終っていない限り、ローカルドメイン名がすべての名前の 末尾に付加されることをいつも心に留めておいてください。 ローカルドメインの補完に失敗した時のみ、名前は変更されずに使用されます。 .Pp .Dq Fl l オプションでは要求されたドメインにおいてリストされている最初の ネームサーバにのみ問い合わせを行ないます。もしこのサーバが死んでいれば、 サーバをマニュアルで指定しなければなりません。たとえば foo.edu のリストを 得るには、 .Pp .D1 Ic host -t ns foo.edu .Pp と指定して foo.edu のすべてのネームサーバ のリストを得てから、動作するものが見つかるまでリストにあるすべての ネームサーバについて .Pp .D1 Ic host -l foo.edu xxx .Pp (ここで .Dq Ic xxx はネームサーバ) を試みれば良いでしょう。 diff --git a/ja_JP.eucJP/man/man5/make.conf.5 b/ja_JP.eucJP/man/man5/make.conf.5 index 04aef1becc..501b64ec6d 100644 --- a/ja_JP.eucJP/man/man5/make.conf.5 +++ b/ja_JP.eucJP/man/man5/make.conf.5 @@ -1,818 +1,823 @@ .\" Copyright (c) 2000 .\" Mike W. Meyer .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must 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. .\" -.\" %FreeBSD: src/share/man/man5/make.conf.5,v 1.12.2.15 2002/05/06 07:35:02 dd Exp % +.\" %FreeBSD: src/share/man/man5/make.conf.5,v 1.12.2.16 2002/05/15 12:51:33 nectar Exp % .\" .\" $FreeBSD$ .\" .Dd November 3, 2000 .Dt MAKE.CONF 5 .Os .Sh 名称 .Nm make.conf .Nd システムビルド情報 .Sh 解説 .Nm ファイルには .Fx のソースや ports アプリケーションの制御に関する設定が含まれています。 通常 .Nm ファイルは、システム管理者が、 これらの値をデフォルトから変更したい場合に作成します。 .Pp .Nm の用途は、コマンド実行やコンパイル動作を直接行うことではなく、 .Pa /usr/src , .Pa /usr/ports , .Pa /usr/doc などにある様々な makefile にインクルードされることです。 そのような makefile では、 内部の動作が .Nm の与える条件によって変化するようになっているのです。 .Pp .Pa /etc/make.conf ファイルはそれぞれ適切な .Pa Makefile からインクルードされます。 各々の Makefile の中では、 利用可能なすべてのオプションに対し、デフォルトの設定が与えられています。 .Pa /etc/make.conf で指定する必要があるオプションは、 システム管理者がデフォルトから変更したいと思ったものだけです。 .Pp ビルドの手続きは、大きく 4 つの領域に分けられます。 world、カーネル、ドキュメント、ports です。 .Nm で設定された変数はこれらの領域の 1 つ、2 つ、 あるいは全てに適用されます。 変数は、特定のビルドに対して .Xr make 1 の .Fl D オプションを用いて指定することもできます。 .Pp 以下のリストでは、それぞれ指定したビルドの途中で用いることのできる 各変数の名前と簡単な説明を記述します。 .Vt bool と指定されている変数では、その値は意味を持ちません。 変数が設定されていれば (たとえ値が .Dq Li FALSE や .Dq Li NO でも)、変数が設定されているものとして扱われます。 .Pp 次のリストは、すべてのビルド (あるいはビルド以外の目的で使われる .Pa Makefile ) で用いられる変数の名前と簡単な説明です。 .Bl -tag -width Ar .It Va CFLAGS .Pq Vt str C のコードをコンパイルするときのコンパイラの設定を制御します。 .Fl O を越えた最適化レベル .Pq Fl O2 , No ... はサポートされていません。 .Va BDECFLAGS は、 .An "Bruce Evans" Aq bde@FreeBSD.org が開発や変更のテスト用に勧めている .Xr gcc 1 設定です。 これは、設定すれば、以下のように使用可能です。 .Pp .Bd -literal -offset indent CFLAGS+=${BDECFLAGS} .Ed .It Va CVS_UPDATE .Pq Vt bool .Dq Li "make update" で ports を更新するときに .Xr cvs 1 を用いる場合、設定します。 .It Va CXXFLAGS .Pq Vt str C++ のコードをコンパイルするときのコンパイラの設定を制御します。 .Va CXXFLAGS は最初は .Va CFLAGS の値に設定されます。この .Va CXXFLAGS の値に追加を行いたい場合は、 .Dq Li = ではなく .Dq Li += を用いてください。 .It Va INSTALL .Pq Vt str デフォルトのインストールコマンドです。 インストールを行う前に比較を行いたい場合は、次の例を用いてください。 .Bd -literal -offset indent INSTALL="install -C" .Ed .It Va LOCAL_DIRS .Pq Vt str この変数には .Pa /usr/src で make を行うときに入るべきディレクトリをすべてリストします。 .It Va MTREE_FOLLOWS_SYMLINKS .Pq Vt str .Xr mtree 8 にシンボリックリンクを追跡させたい場合は、 これを .Dq Fl L に設定します。 .It Va NO_DOCUPDATE .Pq Vt bool .Dq Li "make update" で doc ツリーを更新させない場合これを設定します。 .It Va NO_PORTSUPDATE .Pq Vt bool .Dq Li "make update" で ports ツリーを更新させない場合これを設定します。 .It Va SUP_UPDATE .Pq Vt bool .Dq Li "make update" による ports の更新に .Xr cvsup 1 を使う場合これを設定します。 .It Va SUP .Pq Vt str .Dq Li "make update" で用いられる .Xr cvsup 1 コマンドの置き場所です。 .It Va SUPFLAGS .Pq Vt str .Dq Li "make update" を行うとき .Xr sup 1 に与えるフラグ。デフォルトは .Op Fl g L Ar 2 です。 .It Va SUPHOST .Pq Vt str .Dq Li "make update" を行うときに用いる sup サーバのホスト名です。 .It Va SUPFILE .Pq Vt str .Dq Li "make update" を行うとき、最初に用いる .Ar supfile です。デフォルトは .Pa /usr/share/examples/cvsup/standard\-supfile です。 .It Va SUPFILE1 .Pq Vt str .Dq Li "make update" を行うとき、二番目に用いる .Ar supfile です。デフォルトは .Pa /usr/share/examples/cvsup/secure\-supfile です。 .It Va SUPFILE2 .Pq Vt str .Dq Li "make update" を行うとき、三番目に用いる .Ar supfile です。デフォルトは .Pa /usr/share/examples/cvsup/secure\-supfile です。 .It Va PORTSSUPFILE .Pq Vt str .Dq Li "make update" を行うときの ports 用の .Ar supfile です。デフォルトは .Pa /usr/share/examples/cvsup/ports\-supfile です。 .It Va DOCSUPFILE .Pq Vt str .Dq Li "make update" を行うときのドキュメント用の .Ar supfile です。デフォルトは .Pa /usr/share/examples/cvsup/doc\-supfile です。 .It Va WARNS_WERROR WARNS が有効な場合、 -Werror を .Va CFLAGS へ追加させます。 .El .Pp 次のリストは、カーネルのビルドで用いられる変数の名前と簡単な説明です。 .Bl -tag -width Ar .It Va BOOT_COMCONSOLE_PORT .Pq Vt str ブートブロックが、 キーボード/ビデオカードの代わりに シリアルコンソールを用いるよう設定された場合に、 コンソールとして用いるポートアドレスです。 .It Va BOOT_COMCONSOLE_SPEED .Pq Vt int ブートブロックが、 キーボード/ビデオカードの代わりに シリアルコンソールを用いるよう設定された場合に、 コンソールで用いるボーレートです。 .It Va BOOTWAIT .Pq Vt int カーネルがデフォルトカーネルのブートを開始する前に、 コンソールのキーが押されるのを待つ時間を制御します。 値はだいたいミリ秒単位となります。 ディスクからブートする前のキー入力の認識は BIOS が行うので、 これが 0 に設定されていた場合でも、 ユーザの選択したブートパラメータを与えることは可能です。 .It Va COPTFLAGS .Pq Vt str カーネルをコンパイルするときのコンパイラの設定を制御します。 .Op Fl O を越えた最適化レベル .Pq Op Fl O2 , No ...\& は、動作が保証されていません。 .It Va KERNCONF .Pq Vt str .Dq Li "${MAKE} buildkernel" によるビルドと .Dq Li "${MAKE} installkernel" . によるインストールとで、 どのカーネル設定を用いるかを制御します。例えば .Bd -literal -offset indent KERNCONF=MINE DEBUG GENERIC OTHERMACHINE .Ed .Pp とすると、 .Pa MINE , DEBUG , GENERIC , OTHERMACHINE といった各設定ファイルに対応するカーネルをビルドし、 .Pa MINE に対応するカーネルをインストールします。 デフォルトは .Pa GENERIC です。 .It Va NO_KERNELCONFIG .Pq Vt bool .Dq Li "${MAKE} buildkernel" の際に .Xr config 8 を実行しない場合には、これを設定します。 .It Va NO_KERNELDEPEND .Pq Vt bool .Dq Li "${MAKE} buildkernel" の際に .Dq Li "${MAKE} depend" を実行しない場合には、これを設定します。 .It Va NO_MODULES .Pq Vt bool カーネルといっしょにモジュールをビルドしない場合に設定します。 .El .Pp 次のリストは、world のビルドで用いられる変数の名前と簡単な説明です。 .Bl -tag -width Ar .It Va COMPAT1X .Pq Vt bool .Fx 1 互換ライブラリをインストールする場合に設定します。 .It Va COMPAT20 .Pq Vt bool .Fx 2.0 互換ライブラリをインストールする場合に設定します。 .It Va COMPAT21 .Pq Vt bool .Fx 2.1 互換ライブラリをインストールする場合に設定します。 .It Va COMPAT22 .Pq Vt bool .Fx 2.2 互換ライブラリをインストールする場合に設定します。 .It Va COMPAT3X .Pq Vt bool .Fx 3 互換ライブラリをインストールする場合に設定します。 .It Va COMPAT4X .Pq Vt bool .Fx 4 互換ライブラリをインストールする場合に設定します。 .It Va ENABLE_SUIDPERL .Pq Vt bool suid .Xr perl 1 バイナリのインストールを行う場合に設定します。 .It Va FETCH_CMD .Pq Vt str ファイルの取得に用いるコマンドです。 通常は .Xr fetch 1 です。 .It Va MAKE_IDEA .Pq Vt bool IDEA 暗号化コードをビルドする場合に設定します。 このコードは米国やヨーロッパの多くの国々で特許が取得されています。 合法的に IDEA を使えるかどうか決めるのは .Em あなたの責任 です。 .It Va MAKE_KERBEROS4 .Pq Vt bool KerverosIV (KTH eBones) をビルドする場合に設定します。 .It Va MAKE_KERBEROS5 .Pq Vt bool Kerveros5 (KTH Heimdal) をビルドする場合に設定します。 .Em 注意! これはまだ実験的なコードです。 安定している Kerberos5 が必要ならば、 ports を用いてください。 +.It Va ENABLE_SUID_K5SU +.Pq Vt bool +k5su ユーティリティを使用したい場合に設定します。 +設定しないと、本ユーティリティはセットユーザ ID ビットをセット +されずにインストールされます。 .It Va MODULES_WITH_WORLD .Pq Vt bool カーネルと同時にではなく、 システムと同時にモジュールをビルドする場合に設定します。 .It Va NO_CVS .Pq Vt bool CVS をビルドしない場合に設定します。 .It Va NO_BIND .Pq Vt bool BIND をビルドしない場合に設定します。 .It Va NO_FORTRAN .Pq Vt bool .Xr g77 1 と関連ライブラリをビルドしない場合に設定します。 .It Va NO_I4B .Pq Vt bool isdn4bsd パッケージをビルドしない場合に設定します。 .It Va NO_LPR .Pq Vt bool .Xr lpr 1 と関連プログラムをビルドしない場合に設定します。 .It Va NO_MAILWRAPPER .Pq Vt bool MTA セレクタである .Xr mailwrapper 8 をビルドしない場合に設定します。 .It Va NO_MAKEDEV .Pq Vt bool インストールの際に .Pa /dev で .Dq Li "MAKEDEV all" を実行しない場合に設定します。 .It Va NO_OBJC .Pq Vt bool Objective C のサポートをビルドしない場合に設定します。 .It Va NO_OPENSSH .Pq Vt bool OpenSSH をビルドしない場合に設定します。 .It Va NO_OPENSSL .Pq Vt bool OpenSSL をビルドしない場合に設定します (同時に .Va NO_OPENSSH も設定されたことになります)。 .It Va NO_SENDMAIL .Pq Vt bool .Xr sendmail 8 と関連プログラムをビルドしない場合に設定します。 .It Va NO_SHAREDOCS .Pq Vt bool .Bx 4.4 の古い文書をビルドしない場合に設定します。 .It Va NO_TCSH .Pq Vt bool .Pa /bin/csh (これは .Xr tcsh 1 です) をビルド・インストールしない場合に設定します。 .It Va NO_X .Pq Vt bool X\-Windows のサポート (例えば .Xr doscmd 1 など) をコンパイルしない場合に設定します。 .It Va NOCLEAN .Pq Vt bool .Dq Li "make buildworld" の途中で clean を行わない場合に設定します。 何をやっているかわからない人は設定すべきではありません。 .It Va NOCLEANDIR .Pq Vt bool .Dq Li "${MAKE} cleandir" の代わりに .Dq Li "${MAKE} clean" を実行する場合に設定します。 .It Va NOCRYPT .Pq Vt bool crypto コードを一切ビルドしない場合に設定します。 .It Va NOGAMES .Pq Vt bool ゲームをビルドしない場合に設定します。 .It Va NOINFO .Pq Vt bool .Xr info 5 各ファイルを作成・インストールしない場合に設定します。 .It Va NOLIBC_R .Pq Vt bool .Nm libc_r .Pf ( Nm libc のリエントラント版) をビルドしない場合に設定します。 .It Va NOMANCOMPRESS .Pq Vt bool man ページのインストールの際に圧縮を行わない場合に設定します。 .It Va NOPERL .Pq Vt bool .Xr perl 1 をビルドしない場合に設定します。 .It Va NOPROFILE .Pq Vt bool profile 版ライブラリをコンパイルしない場合に設定します。 .It Va NOSECURE .Pq Vt bool .Pa secure サブディレクトリで crypto コードをビルドしない場合に設定します。 .It Va NOSHARE .Pq Vt bool .Pa share サブディレクトリをビルドしない場合に設定します。 .It Va NOUUCP .Pq Vt bool .Xr uucp 1 と関連プログラムをビルドしない場合に設定します。 .It Va PERL_THREADED .Pq Vt bool .Xr perl 1 をスレッドサポート機能込みでビルド・インストールする場合に設定します。 .It Va PPP_NOSUID .Pq Vt bool .Xr ppp 8 を suid root プログラムとしてはインストールしない場合に設定します。 .It Va SENDMAIL_MC .Pq Vt str インストール時に用いるデフォルトの m4 設定ファイルです。 この値には .Pa .mc ファイルのフルパスを与えます。例えば .Pa /etc/mail/myconfig.mc です。 make install すると、既存の .Pa /etc/mail/sendmail.cf を上書きしてしまうので、注意して使ってください。 .Va SENDMAIL_CF はもう推奨されなくなりました。 .It Va SENDMAIL_SUBMIT_MC .Pq Vt str インストール時に用いるメール提出用デフォルト m4 設定ファイルです。 この値には .Pa .mc ファイルのフルパスを与えます。例えば .Pa /etc/mail/mysubmit.mc です。 インストールによって既存の .Pa /etc/mail/submit.cf が上書きされてしまいますので、注意して使用してください。 .It Va SENDMAIL_ADDITIONAL_MC .Pq Vt str ビルド時に .Pa .cf ファイルに変換される追加分の .Pa .mc ファイル (複数指定可) です。 値には、これらの .Pa .mc ファイルへのフルパスを与えます。 例えば .Pa /etc/mail/foo.mc .Pa /etc/mail/bar.mc など。 .It Va SENDMAIL_M4_FLAGS .Pq Vt str .Pa .mc ファイルから .Pa .cf ファイルを作成するときに m4 に渡されるフラグ。 .It Va SENDMAIL_CFLAGS .Pq Vt str .Xr sendmail 8 をビルドするときにコンパイルコマンドに渡すフラグです。 .Va SENDMAIL_* 各フラグを用いれば、 SASL サポートをその設定と共に指定できます。 例えば次のようにします。 .Bd -literal -offset indent SENDMAIL_CFLAGS=-I/usr/local/include -DSASL SENDMAIL_LDFLAGS=-L/usr/local/lib SENDMAIL_LDADD=-lsasl .Ed .It Va SENDMAIL_LDFLAGS .Pq Vt str .Xr sendmail 8 をビルドするときに .Xr ld 1 コマンドに渡すフラグです。 .It Va SENDMAIL_LDADD .Pq Vt str .Xr sendmail 8 をビルドするときに .Xr ld 1 コマンドの末尾に追加するフラグです。 .It Va SENDMAIL_DPADD .Pq Vt str .Xr sendmail 8 をビルドするときに追加する依存関係です。 .It Va SENDMAIL_SET_USER_ID .Pq Vt bool 設定すると、 .Xr sendmail 8 をセットグループ ID ではなく root にセットユーザ ID したバイナリとしてインストールし、 .Pa /etc/mail/submit.{cf,mc} をインストールしません。 このフラグの使用は推奨できません。 可能であれば、 .Pa /etc/mail/README に書かれている代りの方法を採用すべきです。 .El .Pp 次のリストは、ドキュメントのビルドで用いられる変数の名前と簡単な説明です。 .Bl -tag -width Ar .It Va DISTDIR .Pq Vt str distfiles が保存されている場所です。 通常これは .Va PORTSDIR の .Pa distfiles です。 .It Va DOC_LANG .Pq Vt str ビルド・インストール対象の言語とエンコーディングのリストです。 .It Va PRINTERDEVICE .Pq Vt str システム文書のデフォルトのフォーマットです。 プリンタに依存します。 簡単なプリンタなら .Dq Li ascii に、PostScript プリンタや グラフィックスプリンタ + ghostscript フィルタなら .Dq Li ps に設定できます。 .El .Pp 次のリストは、ports のビルドで用いられる変数の名前と簡単な説明です。 .Bl -tag -width Ar .It Va FORCE_PKG_REGISTER .Pq Vt bool 既存の package (訳注: FreeBSD の package system におけるパッケージを指す場合にこう表記します) の登録情報を上書きする場合に設定します。 .It Va HAVE_MOTIF .Pq Vt bool システムに Motif がある場合に設定します。 .It Va KRB5_HOME .Pq Vt str MIT Kerberos5 の port を .Pa /usr/local 以外にインストールしたい場合に設定します。 .\"translator: "ports" で固有単語とみなすべき？ .It Va LOCALBASE .Pq Vt str X 以外の ports をインストールする際のベースディレクトリを与えます。 これは .Pa /usr/ports でビルドを行う際に .Va PREFIX にデフォルト値として与えられます。 .It Va MASTER_SITE_AFTERSTEP .Pq Vt str AfterStep の ports のマスタサイトを変更します。 パスの最後の部分は .Dq Li /%SUBDIR%/ でなければなりません。 .It Va MASTER_SITE_BACKUP .Pq Vt str .Pa Makefile にリストされている場所が使えない場合、 ports が distfile をチェックしに行く場所を制御します。 パスの最後の部分は .Dq Li /${DIST_SUBDIR}/ でなければなりません。 .It Va MASTER_SITE_COMP_SOURCES .Pq Vt str .Pa comp.sources ports のマスタサイトの場所を制御します。 パスの最後の部分は .Dq Li %SUBDIR%/ でなければなりません。 .It Va MASTER_SITE_GNOME .Pq Vt str GNOME ports のマスタサイトの場所を制御します。 パスの最後の部分は .Dq Li %SUBDIR%/ でなければなりません。 .It Va MASTER_SITE_GNU .Pq Vt str GNU ports のマスタサイトの場所を制御します。 パスの最後の部分は .Dq Li %SUBDIR%/ でなければなりません。 .It Va MASTER_SITE_KDE .Pq Vt str KDE ports のマスタサイトの場所を制御します。 パスの最後の部分は .Dq Li %SUBDIR%/ でなければなりません。 .It Va MASTER_SITE_FREEBSD .Pq Vt bool 設定されていると、すべてのファイルをマスタの .Fx サイトから取得します。 .It Va MASTER_SITE_MOZILLA .Pq Vt str Mozilla ports のマスタサイトの場所を制御します。 パスの最後の部分は .Dq Li %SUBDIR%/ でなければなりません。 .It Va MASTER_SITE_OVERRIDE .Pq Vt str 設定されていると、ports の .Pa Makefile にリストされているサイトよりも先に、このサイトをチェックしに行きます。 次のようにすればバックアップサイトを先にチェックさせることができます。 .Bd -literal -offset indent MASTER_SITE_OVERRIDE?= ${MASTER_SITE_BACKUP} .Ed .It Va MASTER_SITE_PERL_CPAN .Pq Vt str Perl ports のマスタサイトの場所を制御します。 パスの最後の部分は .\".Bd -literal -offset indent .\" /%SUBDIR%/ .\".Ed .Dq Li /%SUBDIR%/ でなければなりません。 .\"translator: ここの .Bd .Ed はコメントアウトしました。 .It Va MASTER_SORT_REGEX .Pq Vt str ミラーセットのソート順を制御する場合に設定します。 .Pa .jp ドメインのミラーを優先的に用いたければ、以下のような設定をします。 .Bd -literal -offset indent MASTER_SORT_REGEX?= ^file: ^ftp://ftp\.FreeBSD\.org/pub/FreeBSD/ports/local-distfiles/ ://[^/]*\.jp/ ://[^/]*\.jp\. .Ed .Pp 他の国別 TLD ドメインのユーザは、 .Dq Li jp を適切なドメインに変更してください。 .It Va MASTER_SITE_RINGSERVER .Pq Vt str Ringserver ports のマスタサイトの場所を制御します。 パスの最後の部分は .Dq Li /%SUBDIR%/ でなければなりません。 .It Va MASTER_SITE_RUBY .Pq Vt str Ruby ports のマスタサイトの場所を制御します。 パスの最後の部分は .Dq Li /%SUBDIR%/ でなければなりません。 .It Va MASTER_SITE_SUNSITE .Pq Vt str Sunsite ports のマスタサイトの場所を制御します。 パスの最後の部分は .Dq Li /%SUBDIR%/ でなければなりません。 .It Va MASTER_SITE_TCLTK .Pq Vt str Tcl/Tk ports のマスタサイトの場所を制御します。 パスの最後の部分は .Dq Li /%SUBDIR%/ でなければなりません。 .It Va MASTER_SITE_TEX_CTAN .Pq Vt str TeX ports のマスタサイトの場所を制御します。 パスの最後の部分は .Dq Li /%SUBDIR%/ でなければなりません。 .It Va MASTER_SITE_WINDOWMAKER .Pq Vt str WindowMaker ports のマスタサイトの場所を制御します。 パスの最後の部分は .Dq Li /%SUBDIR%/ でなければなりません。 .It Va MASTER_SITE_XCONTRIB .Pq Vt str X contrib の ports のマスタサイトの場所を制御します。 パスの最後の部分は .Dq Li /%SUBDIR%/ でなければなりません。 .It Va MASTER_SITE_XEMACS .Pq Vt str Xemacs ports のマスタサイトの場所を制御します。 パスの最後の部分は .Dq Li /%SUBDIR%/ でなければなりません。 .It Va MASTER_SITE_XFREE .Pq Vt str XFree ports のマスタサイトの場所を制御します。 パスの最後の部分は .Dq Li /%SUBDIR%/ でなければなりません。 .It Va MOTIFLIB .Pq Vt str .Pa libXm.a と .Pa libXm.so の場所です。 .It Va MOTIF_STATIC .Pq Vt bool Motif を用いる ports を、Motif の共有ライブラリを持たない システム上でも実行させたい場合に設定します。 .It Va NOCLEANDEPENDS .Pq Vt bool .Dq Li "make clean" によって clean される他の ports から依存されている ports を clean したくない場合に設定します。 .It Va NOPORTDOCS .Pq Vt bool ports と同時に追加ドキュメントをインストールしない場合に設定します。 .It Va PACKAGES .Pq Vt str package ターゲットのみに用いられます。 package ツリーのディレクトリです。 .It Va PATCH_SITES .Pq Vt str パッチファイルの配布をしている一次サイトの場所です。 .It Va PORTSDIR .Pq Vt str ports ツリーの場所です。 .It Va USA_RESIDENT .Pq Vt bool 米国居住者は設定してください。 設定すると、米国輸出規制に従う必要がある ports が、 この規制に従うようになります。 .It Va WITHOUT_X11 .Pq Vt bool 設定すると、X11 サポート有り無しの両方で構築可能な ports を、 デフォルトで X11 サポート無しで構築するようにします。 .It Va WRKDIRPREFIX .Pq Vt str ports をビルドする際に用いる一時ファイルを作成する場所です。 .It Va X11BASE .Pq Vt str X11 ディストリビューションを .Pa /usr/X11R6 以外の場所にインストールしたい場合、その場所を設定します。 .El .Sh 関連ファイル .Bl -tag -width /etc/defaults/make.conf -compact .It Pa /etc/defaults/make.conf .It Pa /etc/make.conf .It Pa /usr/doc/Makefile .It Pa /usr/src/Makefile .It Pa /usr/src/Makefile.inc1 .It Pa /usr/ports/Mk/bsd.port.mk .It Pa /usr/ports/Mk/bsd.sites.mk .El .Sh 関連項目 .Xr gcc 1 , .Xr install 1 , .Xr make 1 , .Xr ports 7 , .Xr lpd 8 , .Xr sendmail 8 .Sh 歴史 .Nm ファイルは .Fx 4.0 以前のいつかに登場しました。 .Sh 作者 このマニュアルページは .An "Mike W. Meyer" Aq mwm@mired.org が書きました。 .Sh バグ このマニュアルページは現在の .Nm で利用できるオプションに比べると、 古くなることが時々あるかもしれません。 現在利用できる最新のオプションについては、 .Pa /etc/defaults/make.conf ファイルを調べてください。 diff --git a/ja_JP.eucJP/man/man5/named.conf.5 b/ja_JP.eucJP/man/man5/named.conf.5 index 0f79157eab..ba35df90c5 100644 --- a/ja_JP.eucJP/man/man5/named.conf.5 +++ b/ja_JP.eucJP/man/man5/named.conf.5 @@ -1,2465 +1,2224 @@ .\" Copyright (c) 1999-2000 by Internet Software Consortium .\" .\" Permission to use, copy, modify, and distribute this software for any .\" purpose with or without fee is hereby granted, provided that the above .\" copyright notice and this permission notice appear in all copies. .\" .\" THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM DISCLAIMS .\" ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL INTERNET SOFTWARE .\" CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL .\" DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR .\" PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS .\" ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS .\" SOFTWARE. .\" $FreeBSD$ - .\" WORD: inbound zone transfer 内部へのゾーン転送 [named] .\" WORD: statement ステートメント .\" WORD: listener 待機タスク .\" WORD: address match list アドレスマッチリスト [named] .\" WORD: negative answers 否定応答 .\" WORD: positive 許可 .\" WORD: prefix プレフィックス -.\" WORD: forwarder フォワードを行うサーバ [named] +.\" WORD: forwarder フォワードを行うサーバ [named] .\" WORD: octothorpe ナンバ記号 .\" WORD: severity 重大度 .\" WORD: outstanding 未解決の 処理中の .Dd January 7, 1999 .Dt NAMED.CONF 5 .Os BSD 4 - .Sh 名称 .Nm named.conf .Xr named 8 .Nd 用の設定ファイル - .Sh 概要 - BIND 8 は、以前のリリースと比べて遥かに設定可能なものになっています。 完全に新しい設定項目があります。例えばアクセス制御リストやカテゴリ別の ログなどです。以前はゾーンすべてに対して適用されていたオプションの多くが、 選択的に使えるようになっています。 こうした機能に加え、 将来必要とされる設定がどのようなものになるかをよく考えた結果、 新たに設定ファイルのフォーマットを作ることにしました。 - .Ss 一般的な文法 - BIND 8 の設定には、一般的な特徴が 2 つあります。 それは、ステートメントとコメントです。 ステートメントはすべてセミコロンで終わります。ステートメントの多くは サブステートメントを持っており、サブステートメントもセミコロンで終わります。 - .Pp 次のようなステートメントをサポートしています : -.Bl -tag -width 1 +.Bl -tag -width 0n .It Ic logging サーバが何をログに残すか、そしてどこにログメッセージを送るのかを指定します。 - .It Ic options グローバルなサーバ設定オプションを制御し、 その他のステートメントに対するデフォルトを設定します。 - .It Ic zone ゾーンを定義します。 - .It Ic acl 名前つきの IP アドレスマッチングリストを定義します。これは、アクセス制御や その他の用途に使われます。 - .It Ic key 認証と許可に使われる鍵情報を指定します。 - .It Ic trusted-keys DNSSEC 鍵を定義します。これは、事前にサーバに設定されており、暗黙のうちに 信頼します。 - .It Ic server 個々のリモートサーバ用の設定オプションを設定します。 - .It Ic controls .Nm ndc ユーティリティが使用する制御チャネルを宣言します。 - .It Ic include 他のファイルをインクルードします。 - .El - +.Pp .Ic logging および .Ic options ステートメントは、各設定につき 1 回のみ記述可能です。それに対し、 その他のステートメントは何回でも記述可能です。各ステートメントの 詳細については、次に個々のセクションで述べます。 - +.Pp コメントは、BIND 設定ファイル中でホワイトスペースが現れて良い 所ならどこでも記述可能です。いろいろなプログラマの注意を引くように、 C や C++、あるいは シェルや perl の形式のコメントを書くことができます。 - +.Pp C のスタイルのコメントは、次の 2 つの文字から始まります。 .Li /* (スラッシュと星印) そして、 .Li */ (星印とスラッシュ) で終わります。 この形式のコメントは、これらの文字で完全に区切られるものであるので、 行の一部分のみでも複数行にまたがっても使用することができます。 - +.Pp C のスタイルのコメントは入れ子にはできません。例えば、次の例は 不適切なものです。なぜなら、コメント全体が最初の .Li */ で終わってしまうからです。 .Bd -literal -offset indent /* この行はコメントの最初です。 この行もコメントの一部です。 /* この行は、間違えてコメントを入れ子にしようとしています。 */ この行は、もうコメント内部ではありません。 */ .Ed - +.Pp C++ スタイルのコメントは、次の 2 文字から始まります。 .Li // (スラッシュとスラッシュ) そして、その行の終わりまでがコメントとして 続きます。この種類のコメントは、複数行にわたって続きません。意味としては 1 つだが複数行にまたがるようなコメントを書きたい場合は、各行に .Li // を書かなくてはなりません。例えば、次のようにです : - .Bd -literal -offset indent // この行は、コメントの始まりです。次の行は、 // 新しいコメントになります。たとえ、意味としては // 前の行のコメントの一部分であってもです。 .Ed - +.Pp シェルスタイル (あるいは、お好みなら perl スタイル) のコメントは、 次の文字で始まります。 .Li # (ハッシュとかポンドとか番号とかナンバ記号とかどう呼んでも良い) そして、 C++ スタイルのコメントと同様に、その行の最後までコメントが続きます。 例えば、次のようにです : - .Bd -literal -offset indent # この行は、コメントの始まりです。次の行は、 # 新しいコメントになります。たとえ、意味としては # 前の行のコメントの一部分であってもです。 .Ed - .Em 注 : ゾーンファイルで書くように、 .Li ; (セミコロン) をコメントの始まりに使用することはできません。 セミコロンは、設定ステートメントの末尾を表すものですので、 その後ろに続く文字は、何であれ次のステートメントの先頭だと 解釈されてしまいます。 - .Ss BIND 4.9.x から変更する - -.Pp BIND 4.9.x の設定ファイルは、 .Pa src/bin/named/named-bootconf という名前の、BIND 8.2.x のソースキットに同梱されている シェルスクリプトを使用することで新しいフォーマットに変換する ことができます。 - .Sh 記述方法の定義 - 次から述べていることは、BIND 設定ファイルを記述する間使用される要素 についてです。1 つのステートメントとしか結びつかない要素は、その ステートメントについて述べているセクションにだけ記述があります。 - -.Bl -tag -width 1 +.Bl -tag -width 0n .It Va acl_name .Ic acl ステートメントで定義される .Va address_match_list の名称です。 - .It Va address_match_list .Va ip_addr , .Va ip_prefix , .Va key_id , .Va acl_name 要素が 1 つまたはそれ以上集まったリストです。これについては、 .Sx アドレスマッチリスト の項で述べます。 - .It Va dotted-decimal ドット (``.'') だけで区切られた、 1 つまたはそれ以上の数の 0 から 255 までの整数です。 例えば、 .Li 123 , .Li 45.67 , .Li 89.123.45.67 などです。 - .It Va domain_name DNS 名として使用される文字列をクォーテーションで囲んだものです。 例えば、 .Qq Li my.test.domain のようにです。 - .It Va path_name パス名として使用される文字列をクォーテーションで囲んだものです。 例えば、 .Qq Li zones/master/my.test.domain のようにです。 - .It Va ip_addr .Va dotted-decimal 表記でちょうど 4 つの要素からなる IP アドレスです。 - .It Va ip_port IP ポートを表す .Va number です。 .Va number は、 .Li 0 から .Li 65535 までの値に限定されており、そのうち 1024 以下の値は、 典型的には、所有者が root のプロセスのみに制限されています。 場合によっては、適当に大きな番号を選択するように、穴埋めとしてアスタリスク文字 (``*'') を使うことができます。 - .It Va ip_prefix .Va dotted-decimal 表記で指定された IP ネットワークです。その後に、``/'' が続き、 そしてネットマスクのビット数が続きます。 例えば、 .Li 127/8 は、 ネットワーク .Li 127.0.0.0 で、ネットマスクは .Li 255.0.0.0 です。 .Li 1.2.3.0/28 はネットワーク .Li 1.2.3.0 で、ネットマスクは .Li 255.255.255.240 です。 - .It Va key_name 共有鍵の名前を表した文字列です。 これはトランザクションセキュリティに使用します。 - .It Va number C 言語での符号つき整数 (32 ビット整数のマシンでは 2,147,483,647) の範囲全体をとる、非負整数です。 取り得る値の範囲は、 使用されるコンテキストによってさらに制限されるかもしれません。 - .It Va size_spec .Va number または単語 .Li unlimited か単語 .Li default です。 - .Pp .Va size_spec の最大値は、マシンの符号なし long 型整数の最大値になります。 .Li unlimited は、値を無制限に使用できるよう要求したり、 取り得る最大の値を要求したりするために使用します。 .Li default は、サーバが始動したときに有効だった制限が使われます。 - .Pp .Va number には、次のようなスケールファクタを続けることもできます : .Li K または .Li k はキロバイトを、 .Li M または .Li m はメガバイトを、そして .Li G または .Li g はギガバイトを表します。 これらはそれぞれ、 1024, 1024*1024, 1024*1024*1024 倍であることを表します。 - .Pp スケールファクタの変換時に、整数値の格納場所でオーバフローが発生しても、 現状では黙って無視します。 その結果、期待した結果よりも小さな値、おそらくは負の値にさえなってしまいます。 本当に大きな値を安全に設定したいなら .Li unlimited を使うのが最良の方法です。 - .It Va yes_or_no .Li yes または .Li no です。あるいは .Li true と .Li false という単語でも受け付けます。 .Li 1 と .Li 0 という番号でも同様です。 - .El - .Sh アドレスマッチリスト .Ss 文法 - .Bd -literal \fIaddress_match_list\fR = 1\&*\fIaddress_match_element\fR - +.Pp \fIaddress_match_element\fR = [ \&"!\&" ] ( \fIaddress_match_list\fR / \fIip_address\fR / \fIip_prefix\fR / \fIacl_name\fR / \&"key \&" \fIkey_id\fR ) \&";\&" .Ed - .Ss 定義と使用法 - アドレスマッチリストは、 主にいくつかのサーバの操作でのアクセス制御を決定するために使われます。 また、アドレスマッチリストは、他のネームサーバに問い合わせる際の優先順位や、 .Nm named が問い合わせを待つアドレスを決定するためにも使われます。 アドレスマッチリストを構成する要素は、次のうちのどれでもありえます : - .Bl -bullet .It .Va ip-address ( .Va dotted-decimal 表記 .It .Va ip-prefix ('/' での表記) .It .Ic key ステートメントで定義された .Va key_id .It 先に .Ic acl ステートメントで定義されたアドレスマッチリスト名 .It 別の .Va address_match_list .El - .Pp 要素は、エクスクラメーションマーク (``!'') で始めると無効にできます。 また、アドレスマッチリスト名に .Li any , .Li none , .Li localhost , .Li localnets が前もって定義されています。リスト名に関してのさらなる情報は、 .Ic acl ステートメントの説明のところにあります。 - .Pp .Ic key 節が追加されたことにより、この文法の構成要素名はある種の誤用 になってしまっています。なぜなら、ホストやネットワークアドレス に関係なく、アクセスの認証には認証鍵を使用することができるからです。 それでもまだ、このドキュメントを通して「アドレスマッチリスト」という 用語が使われています。 - .Pp 与えられた IP アドレスまたはプレフィックスがアドレスマッチリストと 比較されるときには、要素が合致するまでリストをスキャンしていきます。 合致したことをどう解釈するかは、アクセス制御、 .Ic listen-on ポート定義、またはトポロジのいずれの用途にリストを使ったか、 またその要素が無効にされていたかで決定します。 - .Pp アクセス制御リストとしてアドレスマッチリストが使われる場合、合致した要素が 無効になっていないときはアクセスを許可し、無効になっているときはアクセスを 禁止します。アドレスマッチリスト中に合致するものが 1 つもない場合には、 アクセスは禁止されます。 .Ic allow-query , .Ic allow-transfer , .Ic allow-update , .Ic allow-recursion , .Ic blackhole 節はすべてこのようにアドレスマッチリストを使用します。同様に、 .Ic listen-on オプションを使うと、リストに合致しないマシンのアドレスでの問い合わせは、 いずれもサーバが受け取らないようになります。 - .Pp .Ic topology オプションと一緒にアドレスマッチリストが使用される場合、合致した要素が 無効になっていない場合、リスト中で合致した位置に基づいた距離が返されます (合致した箇所がリストの先頭に近ければそれだけ、サーバとの間の距離は 短いことになります)。合致した要素が無効になっている場合、サーバから もっとも遠い距離が割り当てられることになるでしょう。合致するものが なかった場合は、そのアドレスには、無効になっていないリスト要素よりは 遠く、無効になっている要素よりは近い距離が返されるでしょう。 - .Pp ファーストマッチアルゴリズムを使用していますので、リスト中で 他の要素のサブセットを定義している要素のほうが、より広い範囲の定義を している要素よりも、先に定義すべきです。これは、どちらか一方の要素が無効 になっていようがいまいが関係ありません。例えば、 .Dl 1.2.3/24; !1.2.3.13 では、1.2.3.13 という要素は無意味です。なぜなら、 このアルゴリズムでは、1.2.3.13 の検索を 1.2.3/24 という要素に合致 してしまうからです。 .Dl !1.2.3.13; 1.2.3/24 を使うと、1.2.3.13 は要素が無効になっていることにより拒否されますが、 その他の 1.2.3.* のホストは素通りになりますので、この問題を回避できます。 - .Sh logging ステートメント .Ss 文法 - .Bd -literal logging { [ channel \fIchannel_name\fR { ( file \fIpath_name\fR [ versions ( \fInumber\fR | unlimited ) ] [ size \fIsize_spec\fR ] | syslog ( kern | user | mail | daemon | auth | syslog | lpr | news | uucp | cron | authpriv | ftp | local0 | local1 | local2 | local3 | local4 | local5 | local6 | local7 ) | null ); - +.Pp [ severity ( critical | error | warning | notice | info | debug [ \fIlevel\fR ] | dynamic ); ] [ print-category \fIyes_or_no\fR; ] [ print-severity \fIyes_or_no\fR; ] [ print-time \fIyes_or_no\fR; ] }; ] - +.Pp [ category \fIcategory_name\fR { \fIchannel_name\fR; [ \fIchannel_name\fR; ... ] }; ] ... }; .Ed - +.Pp .Ss 定義と使用法 - .Ic logging ステートメントは、ネームサーバに対する様々な種類のログ用オプションを 設定します。 その中の .Ic channel フレーズでは、出力方法とフォーマットオプションと重大度を 名前と結びつけます。 この名前は後で .Ic category フレーズで使用し、様々なメッセージクラスをどのようにログに落すかを選択します。 - .Pp ただ 1 つの .Ic logging ステートメントを使用して、望むだけ多くのチャネルとカテゴリを 定義できます。設定中に、複数の logging ステートメントがあった場合、 最初以外の logging ステートメントに対しては警告が出されます。 logging ステートメントが 1 個も存在しなかった場合、ログ用の設定は 次のようになるでしょう : - .Bd -literal logging { category default { default_syslog; default_debug; }; category panic { default_syslog; default_stderr; }; category packet { default_debug; }; category eventlib { default_debug; }; }; .Ed - ログ用の設定は、 .Ic logging ステートメントがパースされたらすぐに確立されます。もし、設定ファイル 全体の処理状況についてのメッセージをリダイレクトしたいのであれば、 .Ic logging ステートメントが最初に出てくるようにしなければなりません。たとえ、 設定ファイルのパース状況を表すメッセージをリダイレクトしたくなくても、 .Ic logging ステートメントはファイルの先頭に置くことを勧めます。そうすることによって、 パーサの出すメッセージを再度設定する必要が生じたときに、意識して このルールを思い出す必要がなくなります。 - .Ss チャネルフレーズ - ログの出力はすべて、1 つまたはそれ以上の「チャネル」へと渡ります。 チャネルは好きなだけ作ることができます。 - .Pp それぞれのチャネルの定義には、そのチャネル用に選択したメッセージが ファイルに落されるのか、特別な syslog ファシリティに渡されるのか、 または、捨てられるのかを指定する節が含まれていなくてはなりません。 チャネルの定義では、チャネルが受け取るメッセージの重大度を制限する こともオプションでできます (デフォルトは .Li info です)。また、 .Nm named が生成するタイムスタンプと、 カテゴリ名と、重大度を含めるかどうかを制限することもできます。 デフォルトでは、この 3 つのいずれも含めないようになっています。 - .Pp チャネルに対するログの送り先のオプションに .Li null という単語を使用すると、そのチャネルに送られるメッセージはすべて 捨てられるようになります。チャネルに対するその他のオプションは意味が ありません。 - .Pp .Ic file 節を使用すると、ログファイルがどれだけ大きくなっても良いかということと、 ログファイルがオープンされるごとに 何個のバージョンを残すのかということに関する制限を、取り込むことができます。 - .Pp ログファイルに対する .Ic size オプションは、単純にログが大きくなるのを制限する固い天井になるものです。 ログファイルが size を超えると、 ログファイルが再度オープンされるまで .Nm named はファイルに何も書き込みません。size を超えていても、自動的にはファイルは オープンされません。デフォルトでは、ログファイルのサイズ制限はありません。 - .Pp ログファイルオプションに .Ic version を使用すると、 .Nm named は、ログファイルがオープンされるときにファイルのバックアップバージョンの 名前を変更して、指定した数だけ保持します。例えば、lamers.log というファイルの 古いバージョンを 3 つ保持するように選択した場合、lamer.log がオープンされる 直前に lamers.log.1 というファイルは lamers.log.2 という名前に変更され、 lamers.log.0 というファイルは lamers.log.1 という名前に変更され、そして lamers.log というファイルが lamers.log.0 という名前に変更されます。バージョン名 が巡回するものはデフォルトでは保持されません。 すでに存在しているログファイルは、 ただ単に追加して書かれます。 .Li unlimited キーワードは、現在の BIND のリリースでは .Li 99 と同義です。size および versions オプションの使用例は次の通りです : - .Bd -literal channel an_example_level { file "lamers.log" versions 3 size 20m; print-time yes; print-category yes; }; .Ed - .Pp .Ic syslog 節の引数は、 .Xr syslog 3 マニュアルページに記述されている syslog ファシリティを表します。 .Nm syslogd がこのファシリティに送られるメッセージをどのように扱うかについては、 .Xr syslog.conf 5 マニュアルページに記述があります。 -.Fn openlog() +.Fn openlog 関数に 2 つの引数しか使用しない、とても古いバージョンの syslog を 使用しているシステムをお使いの場合は、この節は黙って無視されます。 - .Pp .Ic severity 節は、syslog の「優先度」のように働きます。ただし、syslog を 使用するかわりにファイルを直接書いても使用できるところが違います。 与えられた重大度よりも低いレベルのメッセージは、 このチャネルに対しては選択されません。与えられた重大度 よりも高いレベルのメッセージが受け取られます。 - .Pp syslog を使っている場合、 .Pa syslog.conf での優先度によっても最終的に何が通り抜けるかが決定されます。 例えば、チャネルのファシリティおよび重大度を .Li daemon および .Li debug に定義しているが、 .Pa syslog.conf では .Li daemon.warning しかログに落とさないようにしている場合、 .Li info および .Li notice の重大度を持ったメッセージは捨てられてしまいます。 状況が逆になり、 .Nm named が .Li warning かそれ以上の重大度を持ったメッセージしか書きださないように なっている場合、 .Nm syslogd は、そのチャネルから受け取ったメッセージをすべて書き出すことでしょう。 - .Pp デバッグモードになっている場合、サーバはもっと多くのデバッグ情報を 提供できます。サーバのデバッグレベルが 0 より大きくなっていれば、 デバッグモードは有効になっています。全体でのデバッグレベルは、 .Fl d フラグに正の整数値を続けて指定して .Nm named サーバを開始するか、または、動いているサーバに .Dv SIGUSR1 シグナルを送る (例えば、 .Ic ndc trace を使って) ことによって設定します。 全体でのデバッグレベルは 0 にも設定でき、このときは、デバッグモードは 無効になります。この状態には、サーバに .Dv SIGUSR2 シグナルを送る ( .Ic ndc notrace を使って) ことによってもできます。 サーバでのデバッグメッセージにはすべてデバッグレベルがあります。 そして、デバッグレベルが高いほどより詳細な出力になっています。 例えば、特定のデバッグ重大度を次のように指定したチャネル では、サーバがデバッグモードであればいつでも、レベル 3 または それ以下のレベルのデバッグ出力が得られます。 - .Bd -literal channel specific_debug_level { file \&"foo\&"; severity debug 3; }; .Ed - +.Pp それは、全体でのデバッグレベルには依りません。 .Li dynamic 重大度を指定したチャネルでは、どのメッセージを出力するかを 決めるためにサーバ全体のデバッグレベルを使用します。 - .Pp .Ic print-time がオンになっていれば、日付および時刻がログに落とされます。 .Ic print-time は、syslog チャネルに対しても指定できますが、通常は意味のないことです。 なぜなら、syslog も日付および時刻は出力するからです。 .Ic print-category が要求されている場合、メッセージのカテゴリも同様にログに落とされます。 最後に、 .Ic print-severity がオンになっていれば、メッセージの重大度がログに落とされます。 .Ic print- オプションはどういう組合せでも使うことができ、 常に次のような順番で出力されます : それは time, category, severity の順です。 次に示す例は、3 つすべての .Ic print- オプションをオンにした例です : - .Bd -literal 28-Apr-1997 15:05:32.863 default: notice: Ready to answer queries. .Ed - .Pp -.Nm named -でのデフォルトのログ取得用に使用されるチャネルには、次のような、 +デフォルトのログ取得用に使用されるチャネルには、次のような、 事前に定義された 4 つがあります。どのようにこのチャネルを使うのかに ついては次節 .Sx category フレーズ に記述があります。 - .Bd -literal channel default_syslog { syslog daemon; # syslog の daemon ファシリティに送る severity info; # 優先度が info およびそれ以上のものだけ送る }; - +.Pp channel default_debug { file \&"named.run\&"; # 作業ディレクトリ内の named.run ファイルに - # 書き込む + # 書き込む # 注 : サーバが -f オプションつきで開始されている # 場合は、\&"named.run\&" の代わりに標準エラー # 出力が使われます。 severity dynamic; # サーバの現在のデバッグレベルをログに落とす }; - +.Pp channel default_stderr { # 標準エラー出力に書き出す file \&"\&"; # ここでは、見えるように書いただけです。現在、 # 内部のファイル記述子を設定ファイルの # 文中に記述する方法はありません。 severity info; # 優先度が info およびそれ以上のものだけ送る }; - +.Pp channel null { null; # このチャネルに送られたメッセージはみなはじく }; .Ed - +.Pp いったんチャネルが定義されると、再設定はできません。そのため、組み込みの チャネルは直接変更できないわけです。しかし、定義したチャネルでのカテゴリを 指し示すことによって、デフォルトのログ用機能を変更することができます。 - .Ss category フレーズ - カテゴリはたくさんあります。そのため、見たいと思うログをどこへでも送る ことができ、見たくないログは見ないですますことができます。カテゴリに対して チャネルのリストを指定しなかった場合は、代わりに .Li default カテゴリにログが送られます。 default カテゴリを指定しなかった場合、次のような「デフォルトの default カテゴリ」が使われます : - .Bd -literal category default { default_syslog; default_debug; }; .Ed - +.Pp 例として、セキュリティのイベントをファイルにログとして落としたいが、 デフォルトのロギングの挙動は維持したいとしましょう。そうすると、次のように 指定することになるでしょう : - .Bd -literal channel my_security_channel { file \&"my_security_file\&"; severity info; }; category security { my_security_channel; default_syslog; default_debug; }; .Ed - +.Pp カテゴリ内のすべてのメッセージを捨てるには、 .Li null チャネルを指定してください : - .Bd -literal category lame-servers { null; }; category cname { null; }; .Ed - +.Pp 次のようなカテゴリが使用可能です : - -.Bl -tag -width 1 +.Bl -tag -width 0n .It Ic default すべて捕まえます。多くのメッセージがまだカテゴリ分けされておらず、 すべてここで捕まります。さらに、カテゴリに対して何のチャネルも 指定しなかった場合、代わりに default カテゴリが使われます。default カテゴリを指定しなかった場合、次のような定義が使われます : .Dl category default { default_syslog; default_debug; }; - .It Ic config ハイレベルの設定ファイル処理です。 - .It Ic parser ローレベルの設定ファイル処理です。 - .It Ic queries サーバが受け取った問い合わせそれぞれに対して、短いログメッセージを生成します。 - .It Ic lame-servers ``Lame server on ...'' というようなメッセージです。 - .It Ic statistics 統計です。 - .It Ic panic サーバ内部の問題でサーバ自体がシャットダウンしなくてはならなくなると、 問題の起きた元のカテゴリとこのカテゴリの両方に、 問題をログとして書きこみます。 panic カテゴリを定義していない場合には、次のような定義が使われます : .Dl category panic { default_syslog; default_stderr; }; - .It Ic update 動的な更新です。 - .It Ic ncache ネガティブキャッシングです。 - .It Ic xfer-in サーバが受け取っているゾーン転送です。 - .It Ic xfer-out サーバが送っているゾーン転送です。 - .It Ic db すべてのデータベースの操作です。 - .It Ic eventlib イベントシステムからのデバッグ情報です。このカテゴリには、ただ 1 つの チャネルが指定でき、そのチャネルはファイルチャネルでなくてはなりません。 eventlib カテゴリを指定しない場合は、次のような定義が使われます : .Dl category eventlib { default_debug; }; - .It Ic packet 受け取ったパケットおよび送ったパケットのダンプです。このカテゴリには、 ただ 1 つのチャネルが指定でき、そのチャネルはファイルチャネルでなくては なりません。packet カテゴリを指定しない場合は、次のような定義が使われます : .Dl category packet { default_debug; }; - .It Ic notify NOTIFY プロトコルです。 - .It Ic cname ``... points to a CNAME'' のようなメッセージです。 - .It Ic security 許可された / 許可されなかったリクエストです。 - .It Ic os オペレーティングシステムの問題です。 - .It Ic insist 内部の整合性チェックの失敗です。 - .It Ic maintenance 定期的に行われるメンテナンスのイベントです。 - .It Ic load ゾーンへのロードメッセージです。 - .It Ic response-checks 応答のチェックから発生するメッセージです。例えば、 ``Malformed response ...'', ``wrong ans. name ...'', ``unrelated additional info ...'', ``invalid RR type ...'', ``bad referral ...'' といったものです。 - .El - .Sh options ステートメント .Ss 文法 - .Bd -literal options { + [ hostname \fIhostname_string\fR; ] [ version \fIversion_string\fR; ] [ directory \fIpath_name\fR; ] [ named-xfer \fIpath_name\fR; ] [ dump-file \fIpath_name\fR; ] [ memstatistics-file \fIpath_name\fR; ] [ pid-file \fIpath_name\fR; ] [ statistics-file \fIpath_name\fR; ] [ auth-nxdomain \fIyes_or_no\fR; ] [ deallocate-on-exit \fIyes_or_no\fR; ] [ dialup \fIyes_or_no\fR; ] [ fake-iquery \fIyes_or_no\fR; ] [ fetch-glue \fIyes_or_no\fR; ] [ has-old-clients \fIyes_or_no\fR; ] [ host-statistics \fIyes_or_no\fR; ] [ host-statistics-max \fInumber\fR; ] [ multiple-cnames \fIyes_or_no\fR; ] - [ notify \fIyes_or_no\fR; ] + [ notify ( \fIyes_or_no\fR | explicit ); ] + [ suppress-initial-notify \fIyes_or_no\fR; ] [ recursion \fIyes_or_no\fR; ] [ rfc2308-type1 \fIyes_or_no\fR; ] [ use-id-pool \fIyes_or_no\fR; ] [ treat-cr-as-space \fIyes_or_no\fR; ] [ also-notify \fIyes_or_no\fR; ] [ forward ( only | first ); ] [ forwarders { [ \fIin_addr\fR ; [ \fIin_addr\fR ; ... ] ] }; ] - [ check-names ( master | slave | response ) ( warn | fail | ignore); ] + [ check-names ( master | slave | response ) ( warn | fail | ignore ); ] [ allow-query { \fIaddress_match_list\fR }; ] [ allow-recursion { \fIaddress_match_list\fR }; ] [ allow-transfer { \fIaddress_match_list\fR }; ] [ blackhole { \fIaddress_match_list\fR }; ] [ listen-on [ port \fIip_port\fR ] { \fIaddress_match_list\fR }; ] [ query-source [ address ( \fIip_addr\fR | * ) ] [ port ( \fIip_port\fR | * ) ] ; ] [ lame-ttl \fInumber\fR; ] [ max-transfer-time-in \fInumber\fR; ] [ max-ncache-ttl \fInumber\fR; ] [ min-roots \fInumber\fR; ] [ serial-queries \fInumber\fR; ] [ transfer-format ( one-answer | many-answers ); ] [ transfers-in \fInumber\fR; ] [ transfers-out \fInumber\fR; ] [ transfers-per-ns \fInumber\fR; ] [ transfer-source \fIip_addr\fR; ] [ maintain-ixfr-base \fIyes_or_no\fR; ] [ max-ixfr-log-size \fInumber\fR; ] [ coresize \fIsize_spec\fR ; ] [ datasize \fIsize_spec\fR ; ] [ files \fIsize_spec\fR ; ] [ stacksize \fIsize_spec\fR ; ] [ cleaning-interval \fInumber\fR; ] [ heartbeat-interval \fInumber\fR; ] [ interface-interval \fInumber\fR; ] [ statistics-interval \fInumber\fR; ] [ topology { \fIaddress_match_list\fR }; ] - [ sortlist { \fIaddress_match_list|fR }; ] - [ rrset-order { \fIorder_spec\fR ; [ \fIorder_spec\fR ; ... [ [ }; + [ sortlist { \fIaddress_match_list\fR }; ] + [ rrset-order { \fIorder_spec\fR ; [ \fIorder_spec\fR ; ... ] }; ] + [ preferred-glue ( A | AAAA ); ] }; .Ed - .Ss 定義および使用法 - options ステートメントは BIND で使われるグローバルオプションを 設定します。このステートメントは、設定ファイル中で 1 度だけ出現できます。 もし複数のステートメントが出現した場合は、最初に出現したステートメントが 実際に使用されるオプションを決定し、警告が行われます。options ステートメントが 存在しない場合は、各オプションがデフォルトに設定された options ブロックが 使われます。 - -.Ss パス名 - -.Bl -tag -width 1 - +.Ss サーバ情報 +.Bl -tag -width 0n +.It Ic hostname +このデフォルトは、ネームサーバを提供しているマシンのホスト名を、 +gethostname() の実行結果の形式で与えます。 +第 1 の目的は、多数のエニーキャストサーバのどれが +実際に問い合わせに答えているのかを識別できるようにすることです。 +chaos クラスの +.Pa hostname.bind +のテキスト問い合わせをエニーキャストサーバに送信し、 +一意な名前を得ることによって、これを実現します。 +in class chaos to the anycast server and geting back a unique name. +hostname を空文字列 ("") に設定すると、問い合わせの処理を無効化します。 .It Ic version ndc コマンドの問い合わせや chaos クラスの .Pa version.bind 名の問い合わせを通してサーバがレポートするべきバージョンです。 デフォルトではサーバの本当のバージョン番号になっていますが、 サーバのオペレータの中にはこの文字列の方が好みという人もいます ( .Ic もちろん冗談に決まっていますが )。 - +.El +.Ss パス名 +.Bl -tag -width 0n .It Ic directory サーバの作業ディレクトリです。設定ファイル中の絶対パスでない パス名は、どんなものでもこのディレクトリからの相対パスと受け取られます。 大部分のサーバの出力ファイル (例えば、 .Pa named.run) のデフォルトの置き場所は、このディレクトリです。もし、ディレクトリの指定が なければ、作業ディレクトリはデフォルトで -.Pa . +.Pa \&. になります。このディレクトリは、サーバが起動したディレクトリです。 指定されたディレクトリは絶対パスでなくてはいけません。 - .It Ic named-xfer 内部へのゾーン転送用にサーバが使用する named-xfer プログラムへのパス名です。 指定されていない場合のデフォルトは、システム依存です (例えば、 .Pa /usr/sbin/named-xfer です)。 - .It Ic dump-file .Dv SIGINT シグナルをサーバが受け取ったとき ( .Ic ndc dumpdb が送った場合のように) に、 データベースのダンプを落とすファイルへのパス名です。 指定されていない場合のデフォルトは、 .Pa named_dump.db です。 - .It Ic memstatistics-file .Ic deallocate-on-exit が .Li yes になっている場合に、 サーバが終了時にメモリ使用統計を書き出すファイルへのパス名です。 指定されていない場合のデフォルトは、 .Pa named.memstats です。 - .It Ic pid-file サーバが自分のプロセス ID を書き出すファイルへのパス名です。 指定されていない場合のデフォルトは、オペレーティングシステムに 依存しますが、通常は、 .Pa /var/run/named.pid あるいは .Pa /etc/named.pid です。 pid-file は、 .Nm ndc のような、動作しているネームサーバにシグナルを送りたい プログラムが使用します。 - .It Ic statistics-file サーバが .Dv SIGILL シグナルを ( .Ic ndc stats から) 受け取った場合に、統計を追加書き込みするファイルへのパス名です。 指定されていない場合のデフォルトは、 .Pa named.stats です。 .El - .Ss ブール値のオプション - -.Bl -tag -width 1 +.Bl -tag -width 0n .It Ic auth-nxdomain これが .Li yes の場合、 .Li AA ビットは、常に .Dv NXDOMAIN の応答にセットされます。たとえサーバが実際には信頼できるものでは なくてもです。 デフォルトでは、 .Li yes になっています。 古くからあるソフトウェアが嫌うので、 自分のしていることに確信が持てないでいるのであれば、 .Ic auth-nxdomain をオフにしてはいけません。 - .It Ic deallocate-on-exit これが .Li yes の場合には、サーバは、終了時に自分が確保したオブジェクトを 徹底して開放して、 .Ic memstatistics-file にメモリ使用レポートを書き出します。 デフォルトでは、 .Li no になっています。なぜなら、オペレーティングシステムにクリーンアップを やらせたほうが高速だからです。 .Ic deallocate-on-exit は、メモリリークを検出するために便利です。 - .It Ic dialup これが .Li yes の場合には、サーバは、すべてのゾーンを、 要求時ダイヤルによるダイヤルアップリンクを通して ゾーン転送を行っているかのように扱います。 このダイヤルアップリンクは、このサーバから通信が始まった場合に 立ち上げられるものです。 これは、ゾーンの種類によって異なる効果をもたらし、ゾーンの保守に 専念できるようになります。これによって、 .Ic heartbeat-interval ごとに 1 度、願わくは、1 回の呼び出しの間という短い間隔で ゾーンの保守を行えるようになります。 このオプションはまた、通常のゾーン保守にかかるトラフィックを いくらか抑えることもできます。 デフォルトは、 .Li no です。 .Ic dialup オプションは、 .Ic zone ステートメント中でも指定することができます。この場合は、 .Ic options dialup ステートメントは上書きされます。 - .Pp ゾーンが .Ic master である場合、 サーバは、すべてのスレーブに対して .Dv NOTIFY リクエストを送信するようになります。 これによって、スレーブをチェックし、呼び出しが生きている間に スレーブがゾーンを検証できるようにすることで、 ゾーンを最新のものにする契機ができます (サーバが .Dv NOTIFY をサポートする場合です)。 - .Pp ゾーンが .Ic slave もしくは .Ic stub である場合、 サーバは、通常のゾーンのアップデート問い合わせを抑制し、 .Ic heartbeat-interval が時間切れになったときだけ問い合わせるようにします。 - .It Ic fake-iquery これが .Li yes の場合、 サーバは、 .Dv IQUERY という、もう古くなって使われていない DNS 問い合わせをシミュレーション します。 デフォルトは .Li no です。 - .It Ic fetch-glue これが .Li yes の場合 (デフォルトではそうです)、サーバは、追加の応答用データセクションを 作る際には持っていない「糊」となるリソースレコードを取得します。 サーバのキャッシュが大きくなったり、破壊されたりしないようにするため (こうなると、クライアントからもっと多くの仕事を要求されるという 代償を払うことになります)、 .Ic fetch-glue no は、 .Ic recursion no と一緒に使用できます。 - .It Ic has-old-clients このオプションを .Li yes に設定することと、次の 3 つのオプションを設定することとは等価です : -.Ic auth-nxdomain yes ;, -.Ic maintain-ixfr-base yes ;, +.Ic auth-nxdomain yes ; , +.Ic maintain-ixfr-base yes ; , .Ic rfc2308-type1 no ; .Ic has-old-clients を .Ic auth-nxdomain , .Ic maintain-ixfr-base , .Ic rfc2308-type1 と一緒に使用することで起こることは、指定の順番によります。 - .It Ic host-statistics これが .Li yes である場合、 ネームサーバと相互に作用する各ホストに対して統計が保持されます。 デフォルトでは .Li no です。 .Em 注 : .Ic host-statistics をオンにすると、膨大な量のメモリを消費する可能性があります。 - -.It IC host-statistics-max -保持する最大のホストレコード数です。 -この限界に達っすると、ホストの統計情報に新規ホストは追加されません。 -0 に設定すると、限界はありません。 -デフォルト値は 0 です。 - .It Ic maintain-ixfr-base これが .Li yes の場合、すべての動的に更新されるゾーンに対して、 単一の IXFR データベースファイルが保持されます。 これを有効にすると、 ゾーン転送を非常に高速化可能な IXFR 問い合わせに、サーバは答えます。 デフォルトは .Li no です。 - .It Ic multiple-cnames これが .Li yes である場合、 1 つのドメイン名について複数の CNAME リソースレコードか許可されます。 デフォルトは .Li no です。複数の CNAME レコードを許可するということは、標準からは 外れており、推奨されることではありません。 以前のバージョンの BIND が複数の CNAME レコードを持つことを許しており、 このレコードがいくつかのサイトでは負荷のバランスを取るために 使用されていたことから、複数の CNAME のサポートを利用できるということです。 - .It Ic notify これが .Li yes である場合 (それがデフォルトです)、 変更を行うためにゾーンサーバが信頼できる場合に DNS NOTIFY メッセージを 送るようになります。 NOTIFY を使用すると、マスタサーバとそのスレーブとの間の収束が 早まります。NOTIFY メッセージを受け取り、理解するスレーブサーバは そのゾーン用にマスタサーバに接続し、ゾーン転送を行う必要があるかを 点検します。そして、必要がある場合は直ちにゾーン転送を開始します。 +.Li explicit +の場合、DNS NOTIFY メッセージは +.Ic also-notify +リスト中のアドレスに対してのみ送信されます。 .Ic notify オプションは .Ic zone ステートメント内でも指定できます。この場合は、 .Ic options notify ステートメントは上書きされます。 - +.It Ic suppress-initial-notify +これが +.Li yes +の場合、サーバが最初にロードするときの最初の通知メッセージを抑制します。 +デフォルトでは、 +.Li no +です。 .It Ic recursion これが .Li yes であり、 DNS の問い合わせが再帰処理を要求している場合、 サーバはその問い合わせに答えるために必要な仕事をすべて行おうとします。 recursion がオンになっていない場合、サーバが答えを 知らない場合は、サーバはクライアントに照会を返します。デフォルトでは、 .Li yes です。前述の .Ic fetch-glue も参照してください。 - .It Ic rfc2308-type1 これが .Li yes であれば、サーバは、否定応答用に SOA レコードと一緒に NS レコードを 送ります。もし、古い BIND サーバを持っていて、 SOA と NS の両方を含んだ否定応答を理解しないフォワード用サーバとして使用して いる場合や、古いバージョンの sendmail を持っている場合は、この オプションを no に設定する必要があります。正しい解決策は、 そういう壊れたサーバや sendmail を使用しないことです。デフォルトでは、 このオプションは .Li no です。 - .It Ic use-id-pool これが .Li yes であれば、サーバは自分自身の未解決の問い合わせ ID を追跡して、 重複を避け、ランダム性を高めるようにします。これによって、 サーバが 128 KB も多くメモリを消費するようになります。 デフォルトは .Li no です。 - .It Ic treat-cr-as-space これが .Li yes の場合、 サーバは、スペースやタブを扱うのと同じ方法で CR 文字を扱うように なります。NT あるいは DOS マシンで生成したゾーンファイルを UNIX システム上にロードするときに、このオプションは必要でしょう。 デフォルトでは、このオプションは .Li no です。 - - .El - .Ss Also-Notify - .Ic also-notify - +.Pp ゾーンの新しいコピーがロードされるときはいつでも送信された NOTIFY メッセージも受け取る IP アドレスのグローバルリストを定義します。 このオプションは、ゾーンのコピーが素早く「内密の」サーバ上で確実に収束 する助けになります。 .Ic also-notify リストが .Ic zone ステートメントで与えられた場合、 .Ic options also-notify ステートメントは上書きされます。 .Ic zone notify ステートメントが .Ic no に設定されている場合、 グローバルの .Ic also-notify リストの IP アドレスは、このゾーンに対する NOTIFY メッセージを 送信されません。デフォルトでは、このリストは空です (グローバルな notification リストはないということです)。 - .Ss フォワード - -.Pp フォワード機能は、少数のサーバ上で大きなサイト単位のキャッシュを作成する ために使用することができます。これによって、外部のネームサーバへの リンクを越えたトラフィックを軽減できます。フォワード機能は、直接 インターネットに接続できないが、ともかく外部のホスト名を見つけ出したい というサーバの問い合わせを許可するためにも使用できます。 フォワードが発生するのは、そうした問い合わせに対してサーバが 権限を持たず、キャッシュにその応答が入っていない場合だけです。 - -.Bl -tag -width 1 +.Bl -tag -width 0n .It Ic forward このオプションは、 .Ic forwarders リストが空でない場合にだけ意味があります。 .Li first という値がデフォルトですが、このときサーバは、まずフォワードを行うサーバに 問い合わせを行い、フォワードを行うサーバが要求に対して応答しない場合、 自分で応答を探します。 .Li only が指定された場合、サーバは、ただフォワードを行うサーバに問い合わせを 行うだけです。 - .It Ic forwarders フォワードを行うために使用される IP アドレスを指定します。デフォルトでは、 これは空のリストです (フォワードを行いません)。 .El - .Pp フォワード機能は、ゾーン単位をもとにして設定することもできます。 このときは、グローバルのフォワード用オプションが、さまざまな方法で 上書きできるようになります。 特定のゾーンに対し、 別のフォワード用サーバを使用したり、別の .Ic forward only/first の振るまいをもたせたり、あるいはまったくフォワードしなかったり できます。 さらなる情報については、 .Sx ゾーンステートメント のセクションを参照してください。 - .Pp BIND 8 の将来のバージョンでは、もっと強力なフォワード用システムを 提供する予定です。先に述べた文法は引き続きサポートされる予定です。 - .Ss ネームチェック - サーバは、期待するクライアントの関係に基づいてドメイン名をチェックできます。 例えば、ホスト名として使用されるドメイン名は、正当なホスト名を 定義している RFC に準拠するかという点でチェックされます。 - .Pp チェック方法には 3 通りのやり方が利用可能です : - -.Bl -tag -width 1 +.Bl -tag -width 0n .It Ic ignore 何のチェックも行われません。 - .It Ic warn 期待するクライアントの関係から名前をチェックします。不正な名前は ログに書かれますが、処理は普通に継続します。 - .It Ic fail 期待するクライアントの関係から名前をチェックします。不正な名前は ログに書かれ、ルールに合わないデータは拒否されます。 .El - .Pp サーバは、名前を 3 つのエリアでチェックできます : マスタゾーンファイル、 スレーブゾーンファイル、そして、サーバが発行した問い合わせへの応答 です。 .Ic check-names response fail が指定されており、クライアントの問い合わせに対する応答が クライアントに不正な名前を送る必要のあるものであった場合、 サーバは、 .Dv REFUSED 応答コードをクライアントに送ります。 - .Pp デフォルトは、次の通りです : - .Bd -literal check-names master fail; check-names slave warn; check-names response ignore; .Ed - .Pp .Ic check-names は、 .Ic zone ステートメントでも指定できます。この場合、 .Ic options check-names は上書きされます。 .Ic zone ステートメントで使用した場合、 エリアは指定されません (なぜなら、ゾーンの種類からエリアは推測できる からです)。 - .Ss アクセス制御 - -.Pp サーバへのアクセスは、アクセスを要求したシステムの IP アドレス または共有秘密鍵に基づいて制限することができます。 アクセス基準をどのように指定するかについての詳細は、 .Sx アドレスマッチリスト を参照してください。 - -.Bl -tag -width 1 +.Bl -tag -width 0n .It Ic allow-query どのホストが通常の問い合せをすることができるかを指定します。 .Ic allow-query は、 .Ic zone ステートメントでも指定できます。この場合、 .Ic options allow-query ステートメントを上書きします。もし、allow-query オプションが 指定されていない場合は、デフォルトは、 すべてのホストからの問い合わせを許可します。 - -.Bl -tag -width 1 +.Bl -tag -width 0n .It Ic allow-recursion どのホストが再帰的な問い合わせが可能かを指定します。 指定されていない場合は、 デフォルトでは全てのホストから再帰的な問い合わせができます。 - .It Ic allow-transfer どのホストがゾーン転送をサーバから受け取ることを許可されるかを 指定します。 .Ic allow-transfer は、 .Ic zone ステートメントでも指定できます。その場合、 .Ic options allow-transfer ステートメントは上書きされます。もし、allow-transfer オプションが 指定されていない場合は、デフォルトでは、 すべてのホストからの転送を許可します。 - .It Ic blackhole サーバが問い合わせを受け取らないようになったり、問い合わせを解決するために 使用しないようになるアドレスのリストを指定します。これらのアドレスからの 問い合わせは、応答されることはありません。 .El .El - .Ss インタフェース - -.Pp サーバが問い合わせに答えるインタフェースならびにポートは、 .Ic listen-on オプションを使って指定することができます。 .Ic listen-on は、オプションのポートおよびアドレスマッチリストを取ります。 サーバは、アドレスマッチリストで許可されたインタフェース全てで待機します。 ポートを指定しない場合は、53 番ポートが使われます。 - .Pp .Ic listen-on ステートメントが複数あっても良いです。例えば、 - .Bd -literal listen-on { 5.6.7.8; }; listen-on port 1234 { !1.2.3.4; 1.2/16; }; .Ed - +.Pp では、IP アドレスが 5.6.7.8 のマシン用にネームサーバに 53 番ポートの使用を 許可し、1234 番ポートを 1.2 のネットワークにいて、IPアドレスが 1.2.3.4 ではない マシンに使用を許可します。 - .Pp .Ic listen-on が指定されていない場合は、サーバは、すべてのインタフェース上で 53 番ポートでの 待機をします。 - .Ss 問い合わせアドレス - -.Pp サーバが問い合わせに対する答を知らない場合、そのサーバは、他の ネームサーバに問い合わせを行います。 .Ic query-source は、こうした問い合わせに使用されるアドレスおよびポートを指定します。 .Ic address が .Li * だったり、省略されている場合、ワイルドカード IP アドレス ( .Dv INADDR_ANY ) が使用されます。 .Va port が .Li * だったり、省略されている場合、特権のいらないポートがランダムに 使用されます。デフォルトでは .Dl query-source address * port *; です。 .Pp 注 : .Ic query-source は、現在 UDP 問い合わせのみ適用されます。 TCP 問い合わせには、常にワイルドカード IP アドレスとランダムに選ばれた 特権のいらないポートが使用されます。 - .Ss ゾーン転送 - -.Bl -tag -width 1 +.Bl -tag -width 0n .It Ic max-transfer-time-in ここで指定された時間より長く動作している内部へのゾーン転送 ( .Nm named-xfer プロセス) を終了します。 デフォルトでは、120 分 (2 時間) です。 - .It Ic transfer-format サーバは 2 種類のゾーン転送方法をサポートしています。 .Li one-answer 転送されるリソースレコードそれぞれについて 1 つの DNS メッセージを使用します。 .Li many-answers できるだけ多くのリソースレコードを 1 つのメッセージに押し込みます。 .Li many-answers の方が効率的ではありますが、BIND 8.1 および、パッチの当たった BIND 4.9.5 でのみ 理解されるものです。デフォルトでは、 .Li one-answer になります。 .Ic transfer-format は、 .Ic server ステートメントを使用してサーバ単位で上書きすることができます。 - .It Ic transfers-in 同時に動作させることのできる内部へのゾーン転送の最大値です。 デフォルトは 10 です。 .Ic transfers-in の数を増やすと、スレーブのゾーンの収束が早まりますが、ローカルシステムの負荷も 上がってしまう恐れがあります。 - .It Ic transfers-out このオプションは、将来、 同時に動作する外部へのゾーン転送数を制限するために使用する 予定です。現在、文法はチェックしていますが、それ以上のことは無視しています。 - .It Ic transfers-per-ns あるリモートのネームサーバから同時に実行できる内部へのゾーン転送 ( .Nm named-xfer プロセス) の最大値です。デフォルトは 2 です。 .Ic transfers-per-ns の数を増やすと、スレーブゾーンの収束は早まりますが、リモートのネームサーバの 負荷が上がってしまう恐れがあります。 .Ic transfers-per-ns は、 .Ic server ステートメントの .Ic transfers フレーズを使用してサーバ単位で上書きすることができます。 - .It Ic transfer-source .Nm transfer-source は、サーバが内部に転送するゾーンをすべて取得するために使用される TCP コネクションと どのローカルアドレスとが結びつけられるかを決定します。 これが設定されていない場合、 システムが制御しているデフォルト値に設定されます。 この値は、通常、 リモート側の終端に「最も近い」インタフェースのアドレスになります。 このアドレスは、もし指定されているのなら、リモート側の終端の転送ゾーン用の .Nm allow-transfer オプションで登場していなくてはなりません。 このステートメントは、すべてのゾーンの .Nm transfer-source を設定しますが、設定ファイル中のゾーンブロック内に .Nm transfer-source ステートメントを含めることでゾーン単位で上書きすることができます。 .El - .Ss リソースの制限 - -.Pp 多種のシステムリソースをサーバがどこまで使用してよいか制限可能です。 オペレーティングシステムによっては、 この制限をいくつかサポートしていないものもあります。 そうしたシステムでは、サポートされていない制限を使用すると警告が発生します。 また、オペレーティングシステムによっては、 リソース制限自体をサポートしていないものも あります。そうしたシステムでは、 .D1 cannot set resource limits on this system というメッセージがログに記録されます。 - .Pp リソース制限を指定する際には、スケールを変えた値を使用することができます。 例えば、1 ギガバイトの制限を指定したい場合に、 .Li 1G を .Li 1073741824 の代わりに使用することができます。 .Li unlimited は、無制限にリソースを使用する、 つまり、利用可能な最大の量のリソースを要求します。 .Li default は、サーバが開始したときに有効だった制限値を使用します。 詳細については、 .Sx 記述方法の定義 のセクションの .Va size_spec の項を参照してください。 - -.Bl -tag -width 1 +.Bl -tag -width 0n .It Ic coresize コアダンプの最大サイズです。デフォルト値は .Li default です。 - .It Ic datasize サーバが使用できるデータメモリの最大領域です。デフォルト値は .Li default です。 - .It Ic files サーバが同時にオープンできるファイルの最大数です。デフォルト値は .Li unlimited です。オペレーティングシステムによっては、unlimited という値を設定できず、 カーネルがサポートできるオープンするファイルの最大値を 決定できないものがあることに 注意してください。こうしたシステムでは、 .Li unlimited を選択すると、サーバが .Fn getrlimit RLIMIT_NOFILE から得られる .Va rlim_max の値よりも大きなファイル数を扱ってしまい、 .Fn sysconf _SC_OPEN_MAX を返してしまうことになります。 実際のカーネルの制限値がこの値よりも大きい場合は、 .Ic limit files を使用して、明示的に制限値を指定してください。 - .It Ic max-ixfr-log-size .Li max-ixfr-log-size は、将来のサーバのリリースでは、インクリメンタルゾーン転送用に保持しておく トランザクションログの大きさに制限を設けるために使用する予定です。 - .It Ic stacksize サーバが使用できるスタックメモリの最大量です。デフォルト値は .Li default です。 .El - .Ss 定期的なタスクの間隔 - -.Bl -tag -width 1 +.Bl -tag -width 0n .It Ic cleaning-interval サーバは、 .Ic cleaning-interval 分ごとに期限の切れたリソースレコードをキャッシュから削除します。 デフォルトは 60 分です。これが 0 に設定されているときは、 定期的にキャッシュがクリーニングされることはありません。 - .It Ic heartbeat-interval サーバは、この間隔が過ぎればいつでも .Ic dialup yes の印のついたゾーンすべてに対してゾーン管理タスクを実行します。 デフォルトでは 60 分です。適切な値は 1 日 (1440 分) までです。 この値が 0 に設定されている場合、 これらのゾーンに対するゾーン管理は実行されません。 - .It Ic interface-interval サーバは、 .Ic interface-interval 分ごとにネットワークインタフェースリストをスキャンします。 デフォルトでは 60 分です。 この値が 0 に設定されている場合、 インタフェースのスキャンを行うのは、設定ファイルが ロードされたときだけです。スキャンした後、待機タスク (listener) は、どの 新しいインタフェース上でも始動します (そのタスクが .Ic listen-on の設定がされていて許可されている場合です)。 取り除かれたインタフェース上で動作している待機タスクは、消去されます。 - .It Ic statistics-interval ネームサーバの統計が .Ic statistics-interval 分ごとにログに記録されます。デフォルトは 60 です。 この値が 0 に設定されている場合、 何の統計も記録されません。 .El - .Ss トポロジ - .Pp ネームサーバのリストから問い合わせ先のネームサーバをサーバが 1 つ選ぶとき、 他の点ではすべて対等である場合、このサーバは、 自分自身からトポロジ的に最も近いものを選びます。 .Ic topology ステートメントは、アドレスマッチリストをとり、 特別な方法でそのリストを解釈します。 それぞれの一番上のリスト要素は距離が割り当てられています。 無効にされていない要素は、リスト中の位置に基づいて距離を取得します。ここで、 リストの先頭にマッチした地点が近ければ近いほど、サーバと要素との距離が 近いことになります。 無効にされているマッチには、サーバからの距離の最大が割り当てられます。 マッチするものがない場合は、そのアドレスは、無効にされていないリストの要素の どれよりも遠い距離を取得します。例えば、 - .Bd -literal topology { 10/8; !1.2.3/24; { 1.2/16; 3/8; }; }; .Ed - +.Pp の場合では、ネットワーク 10 上のサーバが最も好ましいものになります。 次が、ネットワーク 1.2.0.0 (ネットマスクが 255.255.255.0) 上のホスト およびネットワーク 3 上のホストですが、 ネットワーク 1.2.3 (ネットマスクが 255.255.255.0) 上のホストは除外されます。 このネットワーク上のものは、どれよりも選ばれにくいものです。 - .Pp デフォルトのトポロジは .Dl topology { localhost; localnets; }; です。 - .Ss リソースレコードのソート - -.Pp 複数の RR (訳注: リソースレコード) が返ってくると、通常ネームサーバは、 .Ic ラウンドロビン でそれらを返します。 すなわち、各要求の後に、最初の RR がリストの最後に置かれます。 RR の順番が決まっていないので、これで問題ありません。 - +.Pp クライアントのリゾルバのコードが、これらの RR を適切に 構成しなおさなくてはなりません。すなわち、他のアドレスよりも、 ローカルネット上の任意のアドレスを優先して使用するということです。 しかしながら、すべてのリゾルバがこうすることができたり、 適切に設定されているわけではありません。 - +.Pp クライアントがローカルサーバを使用しているとき、サーバ内で、クライアントの アドレスに基づいたソートが実行できます。このソートのためには、 ただネームサーバを設定するだけでよく、すべてのクライアントを設定する 必要はありません。 - +.Pp .Ic sortlist ステートメントは、アドレスマッチリストをとり、 .Ic topology ステートメントより更に増した特別な方法でリストを解釈します。 - +.Pp ソートリスト中の各先頭のステートメントは、 それ自身、1 つまたは 2 つの要素を持った 明示的なアドレスマッチリストでなくてはなりません。各先頭のリストの最初の要素 (IP アドレス、IP のプレフィックス、ACL 名、 あるいはネストされたアドレスマッチリスト) に対し、マッチが見つかるまで、問い合わせ元のアドレスをチェックします。 - +.Pp ひとたび問い合わせ元のアドレスがマッチしたなら、 先頭のステートメントがただ 1 つの要素のみの場合、 問い合わせ元のアドレスとマッチした要素そのものが 応答のアドレスを選択するために使用され、それが応答の先頭に移動します。 ステートメントが 2 つの要素を持ったリストであった場合、2 番目の要素は、 topology ステートメントのアドレスマッチリストのように扱われます。 各先頭要素には、 距離が割り当てられており、最も短い距離を持った応答中のアドレスが、 その応答の先頭に移動されます。 - +.Pp 次の例では、ホストそれ自身のアドレスから受け取った問い合わせは、 ローカルに接続された ネットワーク上のアドレスを優先するような応答を受け取ります。 次に優先されるのが、 192.168.1/24 ネットワーク上のアドレスで、その後に、192.168.2/24 あるいは 192.168.3/24 ネットワークがきます。 最後の 2 つのネットワーク間にはどちらが優先かは示されていません。 192.168.1/24 ネットワーク上のホストから受け取った問い合わせは、 そのネットワーク上の他のアドレスを 192.168.2/24 および 192.168.3/24 ネットワークよりも優先します。 192.168.4/24 あるいは 192.168.5/24 ネットワーク上の ホストから受け取った問い合わせは、 直接接続されたネットワーク上のアドレスを優先する だけです。 - .Bd -literal sortlist { { localhost; // もし ローカルホストなら { localnets; // 次のネット上で 192.168.1/24; // 最初にフィットしたものにする { 192,168.2/24; 192.168.3/24; }; }; }; { 192.168.1/24; // もし クラス C 192.168.1 上なら { 192.168.1/24; // .1 あるいは、.2 か .3 を使用する { 192.168.2/24; 192.168.3/24; }; }; }; { 192.168.2/24; // もし クラス C 192.168.2 上なら { 192.168.2/24; // .2 あるいは、.1 か .3 を使用する { 192.168.1/24; 192.168.3/24; }; }; }; { 192.168.3/24; // もし クラス C 192.168.3 上なら { 192.168.3/24; // .3 あるいは、.1 か .2 を使用する { 192.168.1/24; 192.168.2/24; }; }; }; { { 192.168.4/24; 192.168.5/24; }; // .4 か .5 なら }; // そのネットを優先する }; .Ed - +.Pp 次の例は、ローカルホストおよび直接接続されたネットワーク上のホストに対する、 理にかなった振るまいを提供するものです。 これは、BIND 4.9.x でのアドレスのソートの振るまいと 似ています。ローカルホストからの問い合わせに対して送られた応答は、 直接接続された ネットワーク上のホストを優先します。 他の直接接続されたネットワーク上のホストからの 問い合わせに対して送られた応答は、 同じネットワーク上のアドレスを優先するでしょう。 その他の問い合わせに対する応答についてはソートされません。 - .Bd -literal sortlist { { localhost; localnets; }; { localnets; }; }; .Ed - .Ss RRset の順番付け - -.Pp 応答中に複数のレコードが返されている場合、 その応答中にレコードがどの順番で置かれるかを 設定するのが有益なことがあります。 例えば、あるゾーンに対するレコードは、ゾーンファイルで 定義された順番で常に返されるように設定されるかもしれません。 あるいは、 レコードが返されるときにランダムにシャッフルされるようにしたいということも あるでしょう。 rrset-order ステートメントを使用すると、 複数レコードが含まれる応答中のレコードの順番を 設定することができます。順番が定義されていない場合、デフォルトでは、巡回順 (ラウンドロビン) になります - +.Pp .Ic order_spec は次のように定義されています : - .Bd -literal [ \fIclass class_name\fR ][ \fItype type_name\fR ][ \fIname\fR "FQDN" ] \fIorder\fR ordering .Ed - +.Pp クラスが指定されていない場合、デフォルトは .Ic ANY です。 .Li Ictype が指定されていない場合、デフォルトは .Ic ANY です。 名前が指定されていない場合、デフォルトは "*" です。 - +.Pp .Ic ordering の正当な値には、次のようなものがあります : - -.Bd -literal -.Ic fixed - レコードは、ゾーンファイルで定義された順番で返されます。 -.Ic random - レコードは、ある種のランダムな順番で返されます。 -.Ic cyclic - レコードは、ラウンドロビンに返されます。 - +.Bl -tag -width indent +.It Ic fixed +レコードは、ゾーンファイルで定義された順番で返されます。 +.It Ic random +レコードは、ある種のランダムな順番で返されます。 +.It Ic cyclic +レコードは、ラウンドロビンに返されます。 +.El +.Pp 例えば、 - +.Bd -literal rrset-order { class IN type A name "rc.vix.com" order random; order cyclic; }; .Ed - +.Pp では、サフィックスに "rc.vix.com" を持ち、 クラス IN でタイプ A のレコードに対する 応答は、常にランダムな順番で返されます。 その他のレコードはすべて巡回順に返されます。 - +.Pp .Ic rrset-order ステートメントが複数現れた場合、ステートメントは連結されません。 最後のものが適用されます。 - +.Pp .Ic rrset-order ステートメントが指定されていない場合、デフォルトは - .Bd -literal rrset-order { class ANY type ANY name "*" order cyclic ; }; .Ed - +.Pp が使われます。 - +.Ss グルーの順序 +ルートネームサーバ実行時には、 +準備中の他のネームサーバが成功することを保証する必要がある場合があります。 +準備の問い合わせに対する答えの中に、 +ネームサーバのうち少なくとも 1 つに対するグルー (のり) の A レコードが +返されることが必要です。 +これは、 +.Ic preferred-glue A; +を設定することで実現可能であり、 +追加セクション中の他のタイプの前に A レコードを追加します。 .Ss チューニング - -.Bl -tag -width 1 +.Bl -tag -width 0n .It Ic lame-ttl 不完全なサーバの指示をキャッシュしておく秒数を設定します。 0 の場合、キャッシュしません。 デフォルトは 600 (10 分) です。最大値は 1800 (30 分) です。 .It Ic max-ncache-ttl ネットワークの負荷を軽減しパフォーマンスを上げるために、 サーバが否定応答を蓄えます。 .Ic max-ncache-ttl は、サーバで、このような応答の最大保存時間を設定するために使います。 秒単位です。 .\" for these answers in the server is seconds. のところが文になっていない。 デフォルトの .Ic max-ncache-ttl は 10800 秒 (3 時間) です。 .Ic max-ncache-ttl 通常の (肯定) 応答に対しては、最大保存時間を超えてはいけません (7 日)。 もし、この値が 7 日以上に設定されていた場合、 黙って 7 日に切り詰めてしまうでしょう。 .It Ic min-roots ルートサーバに対する要求を受け取るために必要なルートサーバの最小値です。 デフォルトは 2 です。 .El - .Sh zone ステートメント .Ss 文法 - .Bd -literal zone \fIdomain_name\fR [ ( in | hs | hesiod | chaos ) ] { type master; file \fIpath_name\fR; [ check-names ( warn | fail | ignore ); ] [ allow-update { \fIaddress_match_list\fR }; ] [ allow-query { \fIaddress_match_list\fR }; ] [ allow-transfer { \fIaddress_match_list\fR }; ] [ forward ( only | first ); ] [ forwarders { [ \fIip_addr\fR ; [ \fIip_addr\fR ; ... ] ] }; ] [ dialup \fIyes_or_no\fR; ] - [ notify \fIyes_or_no\fR; ] + [ notify ( \fIyes_or_no\fR | explicit ); ] [ also-notify { \fIip_addr\fR; [ \fIip_addr\fR; ... ] }; [ pubkey \fInumber\fR \fInumber\fR \fInumber\fR \fIstring\fR; ] }; - +.Pp zone \fIdomain_name\fR [ ( in | hs | hesiod | chaos ) ] { type ( slave | stub ); [ file \fIpath_name\fR; ] - masters [ port \fIip_port\fR ] { \fIip_addr\fR; [ \fIip_addr\fR; ... ] }; + masters [ port \fIip_port\fR ] { \fIip_addr\fR [ key \fIkey_id\fR ]; [ ... ] }; [ check-names ( warn | fail | ignore ); ] [ allow-update { \fIaddress_match_list\fR }; ] [ allow-query { \fIaddress_match_list\fR }; ] [ allow-transfer { \fIaddress_match_list\fR }; ] [ forward ( only | first ); ] [ forwarders { [ \fIip_addr\fR ; [ \fIip_addr\fR ; ... ] ] }; ] [ transfer-source \fIip_addr\fR; ] [ max-transfer-time-in \fInumber\fR; ] [ notify \fIyes_or_no\fR; ] [ also-notify { \fIip_addr\fR; [ \fIip_addr\fR; ... ] }; [ pubkey \fInumber\fR \fInumber\fR \fInumber\fR \fIstring\fR; ] }; - +.Pp zone \fIdomain_name\fR [ ( in | hs | hesiod | chaos ) ] { type forward; [ forward ( only | first ); ] [ forwarders { [ \fIip_addr\fR ; [ \fIip_addr\fR ; ... ] ] }; ] [ check-names ( warn | fail | ignore ); ] }; - +.Pp zone \&".\&" [ ( in | hs | hesiod | chaos ) ] { type hint; file \fIpath_name\fR; [ check-names ( warn | fail | ignore ); ] }; .Ed - .Ss 定義と使用法 - .Ic zone ステートメントは、 特定の DNS ゾーンがサーバにどのように管理されるかを指定するために 使われます。ゾーンには 5 つの種類があります。 - -.Bl -tag -width 1 +.Bl -tag -width 0n .It Ic master サーバは、 そのゾーン用データのマスタコピーを持っていて、ゾーンに対して信頼できる 応答を提供できます。 - .It Ic slave .Ic slave ゾーンはマスタゾーンの複製です。 .Ic masters リストは、ゾーンの複製を更新するためにスレーブサーバが通信を行う 1 つ以上の IP アドレスを指定します。 .Ic port が指定されている場合、このポートに対し、 ゾーンが現在使用されているものであることの確認と、 ゾーン転送が行われます。 .Ic file が指定されている場合、 指定されたファイルへゾーンの複製が書き出されます。 .Ic file 節を使用することを強く勧めます。 なぜなら、大体においてサーバの起動を早めますし、 通信回線を無駄に使用することを防いでくれるからです。 - .It Ic stub .Ic stub ゾーンは slave ゾーンのようなものですが、ゾーン全体を複製するのではなく、 マスタゾーンの NS レコードのみを複製するという点が違います。 - .It Ic forward .Ic forward ゾーンは、自分に向けられた問い合わせを他のサーバに振り分けるために使用します。 このことは、 .Sx option ステートメント のセクションで説明しています。これらのゾーンでのオプション仕様は、 .Ic options ステートメントで宣言されたグローバルオプションを上書きします。 - .Pp .Ic forwarders 節が zone ステートメント中に存在しないか、もしくは、 .Ic forwarders に対して空リストが与えられている場合は、 そのゾーンに対してフォワードは行われず、 .Ic options ステートメント中の .Ic forwarders は、すべて効力を失います。そのため、使用されるサーバではなく、グローバルの .Ic forward オプションの挙動を変更するためだけにこの種類のゾーンを使用したいのであれば、 グローバルの forwarders 節も指定しなおす必要があります。 - .It Ic hint ルートネームサーバの初期集合は、 .Ic hint ゾーンを使用して指定されます。サーバが起動する際に、ルートヒントを使用して ルートネームサーバを見つけ、ルートネームサーバの最新リストを取得します。 .El - .Pp 注 : 以前の BIND リリースでは、マスタゾーンに対しては .Ic primary という用語を使用し、スレーブゾーンに対しては、 .Ic secondary を、hint ゾーンに対しては .Ic cache という用語を使用していました。 - .Ss クラス - ゾーン名には、オプションでクラスを続けることができます。 もし、クラスが指定されていない場合は、 .Ic in クラス (「インターネット」用) であると仮定されます。これは、大半の場合正しいです。 - .Pp .Ic hesiod クラスは、MIT の Project Athena 由来の情報サービス用のクラスです。 このクラスは、ユーザ、グループ、プリンタなどといった、 さまざまなシステムデータベースに 関する情報を共有するために使用されます。さらなる情報は、 ftp://athena-dist.mit.edu/pub/ATHENA/usenix/athena_changes.PS から入手できます。 キーワード .Ic hs は .Ic hesiod と同義語です。 - .Pp MIT が開発したもう 1 つのものが、1970 年代半ばに作られた LAN プロトコルである CHAOSnet です。これは、LISP ステーションや AI コミュニティで使われている 他のハードウェアで、まだ時折見受けられます。CHAOSnet 用のゾーンデータは、 .Ic chaos クラスを使用して指定できます。 - .Ss オプション - -.Bl -tag -width 1 +.Bl -tag -width 0n .It Ic check-names .Sx options ステートメント の .Sx ネームチェック に関するサブセクションを参照してください。 - .It Ic allow-query .Sx options ステートメント の .Sx アクセス制御 サブセクションの中の .Ic allow-query に関する説明を参照してください。 - .It Ic allow-update どのホストが動的な DNS の更新をサーバに提出するかを指定します。デフォルトは、 どのホストからも更新を許可しないというものです。 - .It Ic allow-transfer .Sx options ステートメント の .Sx アクセス制御 サブセクションの中の .Ic allow-transfer に関する説明を参照してください。 - .It Ic transfer-source .Ic transfer-source どのローカルアドレスが、 このゾーンを取得するために使用される TCP 接続と結びつけられるかを 指定します。 これが設定されていない場合は、システムが制御する値がデフォルトになります。 この値は、通常は、リモート側の終端に「最も近い」インタフェースのアドレスです。 このアドレスは、 もし指定されているのであれば、このゾーンに対するリモート側の終端の .Ic allow-transfer オプション中に出てこなくてはなりません。 - .It Ic max-transfer-time-in .Sx options ステートメント の .Sx ゾーン転送 サブセクション中の .Ic max-transfer-time-in の説明を参照してください。 - .It Ic dialup .Sx options ステートメント の .Sx ブール値オプション サブセクション中の .Ic dialup の説明を参照してください。 - .It Ic notify .Sx options ステートメント の .Sx ブール値オプション サブセクション中の .Sx notify の説明を参照してください。 - .It Ic also-notify .Ic notify がこのゾーンに対してアクティブである場合のみ .Ic also-notify は意味を持ちます。 このゾーンに対する DNS NOTIFY メッセージを受け取るマシン群は、 そのゾーン用にリストされた すべてのネームサーバ (プライマリマスタを除く) と、 .Ic also-notify で指定された IP アドレスからなっています。 .Ic also-notify は .Ic stub ゾーンに対しては意味を持ちません。デフォルトでは、これは空のリストです。 - .It Ic forward .Ic forward は、そのゾーンが .Ic forwarders リストを持っている場合のみ意味を持ちます。 .Ic only 値は、先に .Ic forwarders を試し、応答がなかった場合に検索を失敗させます。 それに対し、 .Ic first は、通常の検索を許可します。 - .It Ic forwarders ゾーン中で .Ic forwarders オプションを使用すると、グローバルの forwarders リストが上書きされます。 .Ic forward タイプのゾーン中でこれが指定されていなかった場合は、 このゾーンに対しては .Em 何の フォワードも行いません。グローバルのオプションは使われないということです。 - .It Ic pubkey DNSSEC のフラグ、プロトコル、アルゴリズムと、 base-64 でエンコードされた鍵を表す文字列を指定します。 .El - .Sh acl ステートメント .Ss 文法 - .Bd -literal acl \fIname\fR { \fIaddress_match_list\fR }; .Ed - .Ss 定義と使用法 - .Ic acl ステートメントは、名前のついたアドレスマッチリストを生成します。 このステートメントは、プライマリで使用しているアドレスマッチリスト、つまり、 アクセス制御リスト (ACL) からその名前を取得します。 - .Pp アドレスマッチリスト名は、他のところで使用する前に .Ic acl を使用して定義しなくてはなりません。ファイルの前方への参照は許されていません。 - .Pp 次のような組み込みの ACL があります : - -.Bl -tag -width 1 +.Bl -tag -width 0n .It Ic any すべてのホストを許可します。 .It Ic none すべてのホストを拒否します。 .It Ic localhost システム上のすべてのインタフェースの IP アドレスを許可します。 .It Ic localnets システムがインタフェースを持ったネットワーク上のすべてのホストを許可します。 .El - .Sh key ステートメント .Ss 文法 - .Bd -literal key \fIkey_id\fR { algorithm \fIalgorithm_id\fR; secret \fIsecret_string\fR; }; .Ed - .Ss 定義と使用法 - .Ic key ステートメントは、鍵の ID を指定します。この ID は、 .Ic server ステートメントで使用され、単純な IP アドレスでのマッチングよりも厳格な 特定のネームサーバと認証方法とを関連づけます。 鍵の ID は、 .Ic server の定義やアドレスマッチリスト中で使用される前に .Ic key ステートメントを使用して作成されていなくてはなりません。 - .Pp .Va algorithm_id は、セキュリティ / 認証アルゴリズムを指定する文字列です。 .Va secret_string は、指定されたアルゴリズムが使用する秘密の鍵で、 base-64 でエンコードされた文字列として扱われます。 言わずとも当然のことですが、為念指摘しておくと、 .Pa named.conf 中に .Va secret_string を入れている場合、 named.conf をスーパユーザ以外の誰にも読み込み可能にしてはいけません。 - .Sh trusted-keys ステートメント .Ss 文法 - .Bd -literal trusted-keys { [ \fIdomain_name\fR \fIflags\fR \fIprotocol\fR \fIalgorithm\fR \fIkey\fR; ] }; .Ed - .Ss 定義と使用法 - .Ic trusted-keys ステートメントは、もともと、RFC 2065 で仕様が決められている DNSSEC スタイルの セキュリティとともに使用されます。DNSSEC は、 3 つの異なったサービスを提供するものです : それは、鍵の配布、データの発生元の認証、 そして、トランザクションおよび要求の認証です。DNSSEC についての完全な説明と このドキュメントの範囲を超えた使い方を知りたい場合、 そして、読者がさらなる情報に 興味がある場合は、まず、RFC2065 を読むことから始めてください。そして、 http://www.ietf.org/ids.by.wg/dnssec.html から入手できるインターネット ドラフトへと続いてください。 - .Pp 信頼された鍵はそれぞれ、ドメイン名と関連づけられています。その属性は、 非負の整数値である、 .Va flags , .Va protocol , .Va algorithm と、 .Va key を表す base-64 でエンコードされた文字列です。 - .Pp 信頼された鍵の番号はすべて指定可能です。 - .Sh server ステートメント .Ss 文法 - .Bd -literal server \fIip_addr\fR { [ bogus \fIyes_or_no\fR; ] + [ support-ixfr \fIyes_or_no\fR; ] [ transfers \fInumber\fR; ] [ transfer-format ( one-answer | many-answers ); ] [ keys { \fIkey_id\fR [ \fIkey_id\fR ... ] }; ] }; .Ed - .Ss 定義と使用法 - server ステートメントは、リモートのネームサーバに関連付けられる 特徴を定義します。 - .Pp サーバが間違ったデータを送っていることに気がついた場合、そのサーバを .Ic bogus にすることで、そのサーバへの問い合わせを抑止することができます。 .Ic bogus のデフォルト値は .Li no です。 -サーバに -.Ic bogus -の印を付けると、当該サーバのアドレスを名前で検索してマッチしたときに、 -当該サーバに対する他のアドレスもすべて -.Ic bogus -の印を付けます。 - +.Pp +サーバが IXFR をサポートする場合、 +.Ic support-ixfr +を +.Li yes +に設定することで、 +IXFR スタイルのゾーン転送を試みるよう named に指示可能です。 +.Ic support-ixfr +のデフォルト値は +.Li no +です。 .Pp サーバは、2 つのゾーン転送方式をサポートしています。1 つ目は、 .Ic one-answer であり、 これは、転送される各リソースレコードに 1 つの DNS メッセージを使用します。 .Ic many-answers は、できるだけ多くのリソースレコードを 1 つのメッセージに押し込みます。 .Ic many-answers の方が効率的ではありますが、BIND 8.1 および、 パッチの当たった BIND 4.9.5 でのみ 理解されるものです。 サーバに対してどちらの方法を使用するかは、 .Ic transfer-format オプションを使用して指定することができます。 .Ic transfer-format が指定されていない場合は、 .Ic options ステートメントで指定された .Ic transfer-format が使用されます。 - .Pp .Ic transfers は、将来のリリースでのサーバで、 指定されたサーバから同時に行われる内部へのゾーン転送数を 制限するために使用される予定です。 現在は、文法はチェックしますが、その他のことは 無視されます。 - .Pp .Ic keys 節は、 .Ic key ステートメントで定義された .Va key_id を識別するために使用されます。これは、リモートサーバと通信する際の トランザクションのセキュリティ用に使用されます。 .Ic key ステートメントは、それを参照する .Ic server ステートメントよりも先に現れなくてはなりません。 - .Pp .Ic keys ステートメントは、将来、サーバによって使用されることを期待されています。 現在は、文法はチェックされますが、その他のことは無視されます。 - .Sh controls ステートメント .Ss 文法 - .Bd -literal controls { [ inet \fIip_addr\fR port \fIip_port\fR allow { \fIaddress_match_list\fR; }; ] [ unix \fIpath_name\fR perm \fInumber\fR owner \fInumber\fR group \fInumber\fR; ] }; .Ed - +.Pp .Ss 定義と使用法 - .Ic controls ステートメントは、 システム管理者がローカルのネームサーバの操作に影響を与えるために 使用する制御チャネルを宣言します。制御チャネルは、 .Nm ndc ユーティリティが、ネームサーバにコマンドを送り、 DNS 以外の結果を受け取るために 使用します。 - .Pp .Ic unix 制御チャネルは、ファイルシステムでの FIFO です。このチャネルへのアクセスは、 通常のファイルシステムのパーミッションによって制御されます。 この制御チャネルは、 指定されたファイルモードのビット ( .Xr chmod 1 を参照) とユーザおよびグループの所有者情報を使用し、 .Nm named が作成します。 注意することは、 .Nm chmod とは違い、 .Ic perm に対して指定されるモードのビットには、通常先頭に .Li 0 がついていることです。そのため、数字は 8 進数として解釈されます。 さらに注意することは、 .Ic owner および .Ic group として指定されるユーザおよびグループの所有者情報は、数字で与えなくては ならないということです。名前ではありません。 このパーミッションは、管理者のみに制限することを勧めます。 そうしないと、このシステム上のユーザなら誰でもローカルネームサーバを 操作できてしまいます。 - .Pp .Ic inet 制御チャネルは、インターネット接続のできる TCP/IP ソケットです。 これは、指定された .Va ip_addr 上の指定された .Va ip_port にあります。 最近の .Nm telnet クライアントは、こうしたソケットと直接対話ができます。 このときの制御プロトコルは、ARPAnet 形式のテキストです。 127.0.0.1 だけを .Va ip_addr に使用することを勧めます。これは、ネームサーバを管理するために、 ローカルホスト上の特権を持たないユーザを皆信用している場合だけに限ります。 - .Sh include ステートメント .Ss 文法 - .Bd -literal include \fIpath_name\fR; .Ed - .Ss 定義と使用法 - .Ic include ステートメントは、そのステートメントが現れた地点に、指定された ファイルを挿入します。ただし、他のステートメント内で使用することは できません。ですので、 .Dl acl internal_hosts { include "internal_hosts.acl"; }; というようには使用できません。 - .Pp .Ic include を使用して、設定ファイルを簡単に管理できるかたまりに分けるように してください。例えば、次のようにです : - .Bd -literal include "/etc/security/keys.bind"; include "/etc/acls.bind"; .Ed - +.Pp この例は、任意の ACL または 認証鍵情報を取り込むために、 BIND 設定ファイルの先頭で使うことができるでしょう。 - .Pp C 言語でのプログラムでするように ``#include'' とタイプしないでください。 ``#'' はコメントの開始として使用するものだからです。 - .Sh 使用例 - 実際に使用する場面でも実用的で、最も単純な設定ファイルは、 ただ単にルートサーバファイルへのフルパスを持ったヒントゾーンを 定義したものです。 .Bd -literal zone \&".\&" in { type hint; file \&"/var/named/root.cache\&"; }; .Ed - +.Pp 次の例は、もっと実世界に即したものです。 - .Bd -literal /* * 単純な BIND 8 の設定 */ - +.Pp logging { category lame-servers { null; }; category cname { null; }; }; - +.Pp options { directory \&"/var/named\&"; }; - +.Pp controls { inet * port 52 allow { any; }; // これは良くない unix \&"/var/run/ndc\&" perm 0600 owner 0 group 0; // デフォルト }; - +.Pp zone \&"isc.org\&" in { type master; file \&"master/isc.org\&"; }; - +.Pp zone \&"vix.com\&" in { type slave; file \&"slave/vix.com\&"; masters { 10.0.0.53; }; }; - +.Pp zone \&"0.0.127.in-addr.arpa\&" in { type master; file \&"master/127.0.0\&"; }; - +.Pp zone \&".\&" in { type hint; file \&"root.cache\&"; }; .Ed - .Sh 関連ファイル -.Bl -tag -width 1 -compact +.Bl -tag -width 0n -compact .It Pa /etc/namedb/named.conf BIND 8 .Nm named 設定ファイル .El - .Sh 関連項目 .Xr named 8 , .Xr ndc 8 diff --git a/ja_JP.eucJP/man/man8/boot0cfg.8 b/ja_JP.eucJP/man/man8/boot0cfg.8 index d2f7e99c63..6b257e396f 100644 --- a/ja_JP.eucJP/man/man8/boot0cfg.8 +++ b/ja_JP.eucJP/man/man8/boot0cfg.8 @@ -1,176 +1,176 @@ .\" Copyright (c) 1999 Robert Nordier .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, .\" OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT .\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR .\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, .\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE .\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, .\" EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" %FreeBSD: src/usr.sbin/boot0cfg/boot0cfg.8,v 1.5.2.4 2001/08/16 15:55:40 ru Exp % +.\" %FreeBSD: src/usr.sbin/boot0cfg/boot0cfg.8,v 1.5.2.5 2002/05/14 23:35:36 dannyboy Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man8/boot0cfg.8,v 1.9 2001/08/18 23:48:09 horikawa Exp $ +.\" $FreeBSD$ .\" .Dd February 21, 1999 .Dt BOOT0CFG 8 .Os .Sh 名称 .Nm boot0cfg .Nd ブートマネージャのインストールと設定ユーティリティ .Sh 書式 .Nm .Op Fl Bv .Op Fl b Ar boot0 .Op Fl d Ar drive .Op Fl f Ar file .Op Fl m Ar mask .Op Fl o Ar options .Op Fl s Ar slice .Op Fl t Ar ticks .Ar disk .Sh 解説 .Fx の .Sq boot0 ブートマネージャは、 i386 マシン (PC) がどのディスクのどのスライスから起動するかを、 操作者が選択できるようにします。 .Pp ここで、 .Dq スライス と言及しているものは、 .Bx 以外の PC 関連文書においては一般的に .Dq パーティション と呼ばれることに注意してください。 典型的には、リムーバブルディスク以外のみ、スライスを持ちます。 .Pp オプションとして、 .Nm ユーティリティは .Sq boot0 ブートマネージャを指定した .Ar disk へインストールします; そして、様々に操作可能なパラメータの設定を許します。 .Pp PC では、ブートマネージャは典型的にディスクのセクタ 0 にあり、 マスタブートレコード (Master Boot Record; MBR) として知られています。 MBR は、コード (PC BIOS から制御を渡されます) と データ (定義されたスライスに関する組み込みの表) の、両方を含みます。 .Pp オプションは次の通りです: .Bl -tag -width indent .It Fl B .Sq boot0 ブートマネージャをインストールします。 このオプションは、MBR コードを交換しますが、 組み込み済のスライス表には影響しません。 .It Fl v 冗長: 定義されたスライスに関する情報などを表示します。 .It Fl b Ar boot0 どの .Sq boot0 イメージを使用するかを指定します。デフォルトは .Pa /boot/boot0 です。 .It Fl d Ar drive 指定した .Ar disk を含むドライブを参照するために PC BIOS が使用する、ドライブ番号を指定します。 典型的には、最初のハードドライブは 0x80 であり、 2 番目のハードドライブは 0x81 などとなります; 0 から 0xff までの間の任意の整数を受け付け可能です。 .It Fl f Ar file 以前あった MBR のバックアップコピーを .Ar file に書き込むべきであることを指定します。 このファイルは、存在しない場合には作成され、 -存在する場合には切り詰められます。 +存在する場合には置換されます。 .It Fl m Ar mask スライスの有効/無効を指定します。 .Ar mask は 0 (全スライスが無効) から 0xf (4 つ全部のスライスが有効) の間の整数です。 .It Fl o Ar options コンマで区切られた文字列であり、次のオプションを指定可能です (必要に応じて .Dq no を前に付けることが可能です): .Bl -tag -width indent .It packet ディスク関連 BIOS サービスにアクセスするときに、 伝統的な (CHS) インタフェースではなく、 ディスクパケット (BIOS Int 0x13 拡張) インタフェースを必要に応じて使用します。 これにより、1023 シンリンダ超からブート可能となりますが、 特定のBIOS サポートが必要です。 デフォルトは .Sq nopacket です。 .It setdrv ディスクを含むドライブの参照に、-d オプションにより 定義可能なドライブ番号を使用することを強制します。 デフォルトは .Sq nosetdrv です。 .It update ブートマネージャが MBR を更新することを許可します。(スライスを .Sq 活動 状態とするためや、スライスの選択情報を保存するために、MBR が更新されます。) これがデフォルトです; .Sq noupdate オプションを指定すると、MBR は読み込み専用で扱われます。 .El .It Fl s Ar slice デフォルトのブート選択を .Ar slice に設定します。 1 から 4 までの値は、スライスを示します。 値 5 は、2 番目のディスクからのブートを示します。 本オプションは、通常、 .Sq noupdate オプションと共に使用します。 .It Fl t Ar ticks タイムアウト値を .Ar ticks に設定します。 (1 秒あたり、およそ 18.2 ticks です。) .El .Sh 関連ファイル .Bl -tag -width /boot/boot0 -compact .It Pa /boot/boot0 デフォルトの .Sq boot0 イメージ .El .Sh 関連項目 .Xr boot 8 , .Xr fdisk 8 .Sh 診断 .Ex -std .Sh 作者 .An Robert Nordier Aq rnordier@FreeBSD.org .Sh バグ .Sq packet オプションを使用すると、 .Sq boot0 が失敗することがあります。 これは BIOS サポートの性質に依存しています。 .Pp 誤った -d オペランドとともに .Sq setdrv オプションを使用すると、MBR を誤ったディスクへ書き込むことになります。 注意してください ! diff --git a/ja_JP.eucJP/man/man8/ifconfig.8 b/ja_JP.eucJP/man/man8/ifconfig.8 index 1c5e5533c5..8391163252 100644 --- a/ja_JP.eucJP/man/man8/ifconfig.8 +++ b/ja_JP.eucJP/man/man8/ifconfig.8 @@ -1,691 +1,692 @@ .\" 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 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. .\" .\" From: @(#)ifconfig.8 8.3 (Berkeley) 1/5/94 -.\" %FreeBSD: src/sbin/ifconfig/ifconfig.8,v 1.27.2.18 2002/04/03 11:48:48 ru Exp % +.\" %FreeBSD: src/sbin/ifconfig/ifconfig.8,v 1.27.2.19 2002/05/14 17:42:38 brian Exp % .\" .\" $FreeBSD$ .\" .Dd July 2, 2001 .Dt IFCONFIG 8 .Os .Sh 名称 .Nm ifconfig .Nd ネットワークインタフェースのパラメータの設定を行なう .Sh 書式 .Nm .Op Fl L .Op Fl m .Ar interface .Op Cm create .Op Ar address_family .Oo .Ar address .Op Ar dest_address .Oc .Op Ar parameters .Nm .Ar interface .Cm destroy .Nm .Fl a .Op Fl L .Op Fl d .Op Fl m .Op Fl u .Op Ar address_family .Nm .Fl l .Op Fl d .Op Fl m .Op Fl u .Op Ar address_family .Nm .Op Fl L .Op Fl d .Op Fl u .Op Fl C .Sh 解説 .Nm は、ネットワークインタフェースに対してネットワークアドレス の割り当てを行ない、ネットワークインタフェースのパラメータの設定を行ないます。 .Nm は、システム立ち上げ 時に、マシンが備える各ネットワークインタフェースに対してネットワークアドレス を割り当てるように使用しなければなりません。また、一旦各ネットワークインタフェ ースに対し設定したネットワークアドレスを再定義したり、パラメータの設定を 変えたりすることも可能です。 .Pp 以下のオプションを使用可能です: .Bl -tag -width indent .It Ar address .Tn DARPA Ns -Internet ファミリでは、アドレスはホスト名データベース .Xr hosts 5 に登録されているホスト名であるか、もしくは インターネット標準の .Dq ドット表記 です。 .Pp CIDR 表現 (スラッシュ表現としても知られています) もまた、 ネットマスクの表現に使用可能です。 つまり、 .Li 192.168.0.1/16 のようなアドレスを指定可能です。 .Pp .Dq inet6 ファミリでは、 .Li ::1/128 のようなスラッシュ表現を使用して、プレフィックス長も指定可能です。 更なる情報については、後述の .Cm prefixlen パラメータを参照してください。 .\" ゼロックスネットワークシステム(tm)ファミリでは、 .\" アドレスは .\" .Ar net:a.b.c.d.e.f .\" という形式です。 .\" ここで .\" .Ar net .\" は割り当てるネットワーク番号(10進数)、 .\" 残りの .\" .Ar a .\" から .\" .Ar f .\" までは .\" ホスト番号を表す 6 バイトであり 16 進数で指定します。 .\" ホスト番号は IEEE 802 プロトコル (Ethernet, FDDI, Token Ring) .\" インタフェースでは省略可能です。 .\" ホスト番号指定を省略した場合には、 .\" 一番目のインタフェースのハードウェア物理アドレスを .\" すべてのインタフェースにおいて使用します。 .\" .Tn ISO .\" ファミリでは、 .\" ゼロックスファミリと同じ長さのアドレスを、 .\" 長い 16 進数の文字列で指定します。 .\" 違いは、 .\" ドットが続いた場合にはそのバイトはゼロを表すことと、 .\" ドットはオプションであることです .\" (ドットはネットワークバイトオーダの長い数字列を .\" 注意深く扱うために使用します)。 .Pp リンクレベル .Pq Dq link アドレスが、コロン区切りの 16 進数の連続で指定されます。 例えばイーサネットインタフェースに新規 MAC アドレスを 設定するために使用可能ですが、 使用される機構はイーサネットインタフェースに限ったものではありません。 本オプション指定時にインタフェースが既に up である場合、 インタフェースを一時的に down にしてから再度 up にします。 本オプション使用時にインタフェースが既に これは、下位のイーサネットハードウェアの受信フィルタが 正しくプログラムされたことを保証するためです。 .It Ar address_family 他のパラメータの解釈に影響するネットワーク アドレスファミリ を指定します。 インタフェースが異なるプロトコルの送信を異なる名前付け体系で 受けることがあるので、アドレスファミリを指定しておくことをお勧めします。 本コマンドでサポートされるプロトコルファミリは、 .Dq inet , .Dq inet6 , .Dq atalk , .Dq ipx , .\".Dq iso , .Dq link .\" .Dq ns です。 デフォルトは .Dq inet です。 .Dq ether と .Dq lladdr は .Dq link の同義語です。 .It Ar dest_address ポイントツーポイントリンクにおける他端のアドレスを指定します。 .It Ar interface インタフェースパラメータは、 .Dq name unit の形式で表現されます。 例えば .Dq Li ed0 です。 .El .Pp .Nm では以下のパラメータが利用できます: .Bl -tag -width indent .It Cm add .Cm alias パラメータの別名です。 .Bsx との互換性のために導入されました。 .It Cm alias 指定したインタフェースに、ネットワークアドレスを追加して指定します。 これはネットワーク番号を変更した際に、以前のアドレスに送られるパケットを 受けとりたい場合などに便利です。 アドレスが、 本インタフェースの最初のネットワークアドレスと同じサブネット上の場合、 -ネットマスク +衝突しないネットマスクを指定する必要があります。 +通常、 .Li 0xffffffff -を指定する必要があります。 +が最適です。 .It Fl alias 指定したネットワークアドレスを無効にします。本機能は、alias で不正なアドレスを 指定した場合や、すでに指定したアドレスが必要ない場合などに使用します。 誤った NS アドレスをホスト部分とともに指定した場合には、 NS アドレスを全て無効にすることにより再度ホスト部分を指定可能となります。 .It Cm anycast (inet6 のみ) 設定されるアドレスはエニーキャスト (anycast) アドレスであると指定します。 現在の仕様では、ルータのみがエニーキャストアドレスに設定可能です。 エニーキャストアドレスは、 出力 IPv6 パケットの送信元アドレスとしては使用されません。 .It Cm arp アドレス解決プロトコル .Pq Xr arp 4 を用いてネットワークレベルのアドレスとリンクレベル のアドレスの対応を取ることを可能にします (デフォルト)。この機能は、 .Tn DARPA インターネットアドレスと .Tn IEEE 802 の 48 ビット MAC アドレス (Ethernet, FDDI, Token Ring のアドレス) の間の対応を取るように作られています。 .It Fl arp アドレス解決プロトコル .Pq Xr arp 4 の使用を禁止します。 .It Cm broadcast ネットワークに対するブロードキャストアドレスを指定します。 ブロードキャストアドレスのデフォルト値は、 ホスト部のビットがすべて 1 になったアドレスです。 .It Cm debug ドライバ依存のデバッグモードを有効にします。 通常コンソールへのエラーログを有効にします。 .It Fl debug ドライバ依存のデバッグモードを無効にします。 .It Cm delete .Fl alias パラメータの別名です。 .It Cm down 指定したネットワークインタフェースに .Dq down とマークします。 .Dq down と マークされたインタフェースに対しては、システムはメッセージの送信を行ない ません。可能であれば、そのインタフェースは受信も不可能となるように リセットされます。この動作は、そのインタフェースを用いる ルーティングを使用しないよう自動的に設定するものではありません。 .\" .It Cm ipdst .\" リモートネットワーク向け NS パケットをカプセル化している IP パケットを .\" 受信する、インターネットホストを指定するために使用します。 .\" 外見上 point to point リンクが構成され、 .\" 指定されたアドレスは、 .\" デスティネーションの NS アドレスとネットワークアドレスとされます。 .\" .Tn CLNP .\" パケットの IP カプセル化はこれとは異なった方法で実現されます。 .It Cm media Ar type ドライバがメディア選択能力を持つ場合、 インタフェースのメディアタイプを .Ar type に設定します。 インタフェースによっては、 複数の異なった物理メディアコネクタのうちのいずれかを 排他的に使用することをサポートします。 例えば、10Mb/s Ethernet インタフェースには .Tn AUI とツイストペアコネクタをサポートするものがあります。 メディアタイプを .Dq 10base5/AUI に設定すると、AUI ポートを現在のアクティブなコネクタとします。 また .Dq 10baseT/UTP に設定すると、ツイストペアをアクティブにします。 使用可能なタイプの完全なリストは、 インタフェースドライバ固有の文書やマニュアルページを参照してください。 .It Cm mediaopt Ar opts ドライバがメディア選択能力を持つ場合、 インタフェースのメディアオプションを設定します。 .Ar opts 引数はコンマで区切ったオプションリストで、インタフェースに適用されます。 使用可能なオプションの完全なリストは、 インタフェースドライバ固有のマニュアルページを参照してください。 .It Fl mediaopt Ar opts インタフェースのメディアオプションを無効にします。 .It Cm tunnel Ar src_addr dest_addr (IP トンネルデバイスのみ) IP トンネルインタフェース .Pq Xr gif 4 用の、 物理的な始点アドレスと終点アドレスを設定します。 引数 .Ar src_addr と .Ar dest_addr は、カプセル化する IPv4/IPv6 ヘッダ用の、外部の始点/終点として解釈されます。 .It Cm deletetunnel 以前に .Cm tunnel で設定した IP トンネルインタフェースの、 物理的な始点アドレスと終点アドレスの設定を解除します。 .It Cm create 指定したネットワーク擬似デバイスを作成します。 ユニット番号無しでインタフェースが指定されると、 任意のユニット番号で新規デバイスを作成しようとします。 任意のデバイスの作成に成功すると、新規デバイス名を標準出力へ表示します。 .It Cm destroy 指定したネットワーク擬似デバイスを破壊します。 .It Cm plumb .Cm create パラメータの別名です。 .Tn Solaris との互換性のためにあります。 .It Cm unplumb .Cm destroy パラメータの別名です。 .Tn Solaris との互換性のためにあります。 .It Cm vlan Ar vlan_tag インタフェースが vlan 擬似インタフェースの場合、vlan タグ値を .Ar vlan_tag に設定します。 この値は 16 ビット数値であり、vlan インタフェースから送られるパケットの 802.1Q vlan ヘッダの作成に使用されます。 .Cm vlan と .Cm vlandev は同時に設定される必要があることに注意してください。 .It Cm vlandev Ar iface インタフェースが vlan 擬似デバイスの場合、物理インタフェース .Ar iface を関連付けます。 vlan インタフェースから送信されるパケットは、 802.1Q vlan カプセル化付きで、指定された物理インタフェース .Ar iface へ向けて転換 (divert) されます。 親インタフェースが受信した 802.1Q カプセル化付きのパケットに 正しい vlan タグが付いていた場合、 そのパケットは関連付けられた vlan 擬似インタフェースへ転換されます。 vlan インタフェースは、 親インタフェースのフラグと親のイーサネットアドレスが割り当てられます。 .Cm vlandev と .Cm vlan は同時に設定される必要があります。 vlan インタフェースが既に物理インタフェースと関連付けられている場合、 このコマンドは失敗します。 別の物理インタフェースへ関連付けを変更するには、 既存の関連付けをまずクリアする必要があります。 .Pp 注: vlan インタフェースで .Cm link0 フラグをセットした場合、vlan 擬似インタフェースの振舞いが変わります: 親インタフェースが自身の vlan タグの挿入と取り出しをサポートすること、 vlan インタフェースが親に対して無修正でパケットを渡すべきことを、 .Cm link0 は vlan インタフェースに対して通知します。 .It Fl vlandev Ar iface ドライバが vlan 擬似ドライバの場合、物理インタフェース .Ar iface とドライバとの関連付けを解除します。 これにより、vlan インタフェースとその親との間のリンクを破壊し、 vlan タグとフラグとリンクアドレスをクリアし、 インタフェースをシャットダウンします。 .It Cm metric Ar n インタフェースのルーティングメトリックを .Ar n で指定します。初期値は 0 です。 ルーティングメトリックは、ルーティングプロトコル .Pq Xr routed 8 で使用されます。 .It Cm mtu Ar n そのインタフェースの最大転送単位 (MTU) を .Ar n に設定します。デフォルト値はインタフェースに依存します。 MTU はインタフェースに送られるパケットの大きさを制限するのに用いられます。 MTU を設定できなかったり、設定出来る値の範囲に制限のある インタフェースがあります。 .It Cm netmask Ar mask .\" (inet と ISO) (inet のみ) ネットワークをサブネットワークに細分割する際に、ネットワークアドレスとして リザーブするアドレスを指定します。 mask が指定する部分は、 アドレスのネットワーク部とサブネット部です。 サブネット部はアドレスのホスト部の一部です。 mask は、 .Ql 0x ではじまる16進数、 ドット表記のインターネットアドレス形式、 ネットワークテーブル .Xr networks 5 に記述されている仮想ネットワーク名のいずれかで指定できます。 mask での 32 ビットアドレスにおける 1 であるビットの部分は、 ネットワーク部もしくはサブネット部として使用します。 0 であるビットの部分はホスト部として使用します。 mask は少なくともネットワーク部を含む必要があり、 サブネット部はネットワーク部に連続する必要があります。 .Pp ネットマスクはまた、CIDR 表現で、アドレスの後に指定可能です。 更なる情報については、前述の .Ar address オプションを参照してください。 .It Cm prefixlen Ar len (inet6 のみ) .Ar len ビットを、ネットワークからサブネットワークへの分割用に予約すると、 指定します。 .Ar len は整数であることが必要であり、 文法的な理由で 0 から 128 の間であることが必要です。 現在の IPv6 の割り当て規則では、ほぼ常に 64 です。 本パラメータを省略すると、64 が使用されます。 .Pp プレフィックスは、 アドレスの後に、スラッシュ表現を指定することでも指定可能です。 更なる情報については、前述の .Ar address オプションを参照してください。 .\" see .\" Xr eon 5 . .\" .It Cm nsellength Ar n .\" .Pf ( Tn ISO .\" のみ) .\" .Tn NSAP .\" に後続するローカル識別に使用するバイト数を指定します。 .\" この部分は .\" .Tn NET .\" (Network Entity Title) .\" として扱われます。 .\" バイト数のデフォルト値は 1 であり、US .\" .Tn GOSIP .\" 準拠です。 .\" ifconfig コマンドで設定するISO アドレスが、 .\" .Tn NSAP .\" です。 .\" 例えば .\" .Tn US GOSIP .\" では、20 文字の 16 進数を .\" .Tn ISO NSAP .\" において指定し、 .\" インタフェースに割り当てる必要があります。 .\" .Tn AFI .\" 37 タイプアドレスにおいて、数字が 1 とは異なると便利であるのは、 .\" それなりの理由があります。 .It Cm range Ar netrange Appletalk において .Ar netrange に返答するようにインタフェースを設定します。 書式は .Ar startnet Ns - Ns Ar endnet です。 Appletalk は netmask ではなくこの方法を使用しますが、 .Fx の内部においては netmask の集合として実装しています。 .It Cm remove .Fl alias パラメータの別名です。 BSD/OS との互換性のために導入されました。 .It Cm phase これに続く引数は、 インタフェースに接続された Appletalk ネットワークの バージョン (フェーズ) を指定します。 1 または 2 が許されています。 .Sm off .It Cm link Op Cm 0 No - Cm 2 .Sm on 指定したインタフェースのリンクレベルでの特殊な処理を有効にします。 3 つのオプション の実際の効果はインタフェース依存です。しかしながら、これらのオプションは、 一般的には特殊なオペレーションモードを選択するのに用いられます。この例として、 SLIP 使用時のデータ圧縮や、Ethernet カードのコネクタ選択を行います。 各ドライバごとのマニュアルページに 詳細が記してあるので、詳しくはそちらの方を参照して下さい。 .Sm off .It Fl link Op Cm 0 No - Cm 2 .Sm on 指定したインタフェースのリンクレベルでの特殊な処理を無効にします。 .It Cm up 指定したネットワークインタフェースに .Dq up とマークします。 本オプションは、 .Dq Nm Cm down を行なった後にインタフェースを有効にするのに用いられます。 最初にインタフェースにアドレスを設定した場合には、自動的に本指定はされたものと して扱います。もし、down とマークされていたインタフェースがリセットされた場合、 ハードウェアは再初期化されます。 .It Cm ssid Ar ssid IEEE 802.11 無線インタフェース用であり、 希望するサービスセット識別子 (SSID; 別名はネットワーク名) を設定します。 SSID は、32 文字までの文字列であり、 通常の文字列の形式か .Ql 0x を前に付けた 16 進数の形式で、指定可能です。 更に、SSID に .Ql - を設定することで、これを消去可能です。 .It Cm nwid Ar ssid .Cm ssid パラメータの別名。 .Nx との互換性のためにあります。 .It Cm stationname Ar name IEEE 802.11 無線インタフェース用であり、 このステーションの名前を設定します。 ステーション名は、本当は IEEE 802.11 プロトコルの一部ではないようですが、 すべてのインタフェースがこれをサポートしているようです。 そのようなものですから、 同じもしくは実際的に同じ機器にとってのみ有用であるようです。 .It Cm station Ar name .Cm stationname パラメータの別名。 .Bsx との互換性のためにあります。 .It Cm channel Ar number IEEE 802.11 無線インタフェース用であり、 希望するチャネルを設定します。 チャネルの範囲は 1 から 14 ですが、 アダプタがどの地域用に製造されたかに、利用可能な選択肢は依存します。 チャネルを 0 に設定すると、アダプタのデフォルト設定になります。 アドホックモード以外では、多くのアダプタがこの設定を無視します。 .It Cm authmode Ar mode IEEE 802.11 無線インタフェース用であり、 インフラストラクチャモードでの希望する認証モードを設定します。 すべてのアダプタがすべてのモードをサポートしているわけではありません。 正当なモードは .Dq none , .Dq open , .Dq shared です。 モードは、大文字小文字を区別しません。 .It Cm powersave IEEE 802.11 無線インタフェース用であり、省電力モードを有効にします。 .It Fl powersave IEEE 802.11 無線インタフェース用であり、省電力モードを無効にします。 .It Cm powersavesleep Ar sleep IEEE 802.11 無線インタフェース用であり、 希望する最大省電力スリープ時間をミリ秒で指定します。 .It Cm wepmode Ar mode IEEE 802.11 無線インタフェース用であり、希望する WEP モードを設定します。 すべてのアダプタがすべてのモードをサポートしているわけではありません。 正当なモードは .Dq off , .Dq on , .Dq mixed です。 .Dq mixed モードは、暗号化トラフィックと非暗号化トラフィックの両方を許す アクセスポイントとの関係を許すことを、アダプタに明示的に指定します。 両方を許すアダプタにおける .Dq on は、 アクセスポイントが暗号化接続のみを許可することが必要であることを意味します。 他のアダプタにおける .Dq on は、一般的に .Dq mixed の別名です。 モードは、大文字小文字を区別しません。 .It Cm weptxkey Ar index IEEE 802.11 無線インタフェース用であり、送信に使用する WEP 鍵を設定します。 .It Cm wepkey Ar key Ns | Ns Ar index : Ns Ar key IEEE 802.11 無線インタフェース用であり、選択された WEP 鍵を設定します。 .Ar index が指定されない場合、鍵 1 が設定されます。 WEP 鍵の長さは、5 文字または 13 文字 (40 ビットまたは 104 ビット) であり、 ローカルネットワークとアダプタの機能に依存します。 通常の文字列の形式か .Ql 0x を前に付けた 16 進数の形式で、指定可能です。 鍵は、 .Ql - を設定することで、これを消去可能です。 WEP がサポートされていれば、最低 4 個の鍵があります。 アダプタによっては 4 個を越える鍵をサポートするものもあります。 そのような場合、最初の 4 個の鍵 (1-4) が標準の一時鍵となり、 他の鍵がアダプタ固有の鍵となります。 後者は、例えば、NVRAM に格納される永続鍵です。 .It Cm wep .Cm wepmode on の別の指定方法。 .Bsx との互換性のためにあります。 .It Fl wep .Cm wepmode off の別の指定方法。 .Bsx との互換性のためにあります。 .It Cm nwkey key 以下の、別の指定方法。 .Pp .Dq Li "wepmode on weptxkey 1 wepkey 1:key wepkey 2:- wepkey 3:- wepkey 4:-" .Pp .Nx との互換性のためにあります。 .It Cm nwkey Xo .Sm off .Ar n : k1 , k2 , k3 , k4 .Sm on .Xc 以下の、別の指定方法。 .Pp .Dq Li "wepmode on weptxkey n wepkey 1:k1 wepkey 2:k2 wepkey 3:k3 wepkey 4:k4" .Pp .Nx との互換性のためにあります。 .It Fl nwkey .Cm wepmode off の別の指定方法。 .Pp .Nx との互換性のためにあります。 .El .Pp .Nm は引数としてネットワークインタフェース以外に何のオプションも与えられない場合、 ネットワークインタフェースの現在の設定状態を表示します。 プロトコルファミリが指定されている場合、 .Nm はプロトコルファミリに特有の情報についてのみ表示します。 .Pp ドライバがメディア選択をサポートする場合、 サポートされているメディアのリストが出力に含まれます。 .Pp インタフェース名の前に .Fl m フラグが渡されると、 指定したインタフェースに対してサポートされているすべてのメディアを .Nm は表示します。 オプションとして、インタフェース名の代りに .Fl L フラグを指定すると、IPv6 用のアドレスの生存時間が、 時刻オフセット文字列として表示されます .Pp .Fl a フラグを指定できます。そうすると、 .Nm はシステム上の全インタフェースを表示します。 .Fl d フラグはこれを down したインタフェースに限定し、 .Fl u フラグはこれは up したインタフェースに限定します。 引数を指定しないと、 .Fl a が暗黙的に指定されます。 .Pp .Fl l フラグを使用するとシステム上の使用可能な全インタフェースのリストを、 その他の情報は付加せずに表示します。 このフラグは他のフラグとは排他的ですが、 .Fl d (down したインタフェースのみをリスト) と .Fl u (up したインタフェースのみをリスト) は例外です。 .Pp .Fl C フラグは、システム上で利用可能なインタフェース複製者をすべて列挙します。 他の情報は表示されません。 本フラグは、他のフラグおよびコマンドと共には使用できません。 .Pp スーパユーザのみがネットワークインタフェースの設定を変更できます。 .Sh 注 メディア選択システムは比較的新しく、いくつかのドライバのみサポートしています (必要があるものも限られています)。 .Sh 診断 指定したインタフェースが存在しない、 要求したアドレスが未知のものである、 ユーザがネットワークインタフェースの設定を変更する権限を持っていない、 といったメッセージを表示します。 .Sh バグ IPv6 ノード間のいくつかの基本的な通信用に、 IPv6 リンクローカルのアドレスが必要です。 これらを .Nm で手動で削除すると、カーネルが非常に奇妙な動作を示すことがあります。 よって、このような手動削除は、強く非推奨です。 .Sh 関連項目 .Xr netstat 1 , .Xr netintro 4 , .\" .Xr eon 5 , .Xr rc 8 , .Xr routed 8 .Sh 歴史 .Nm コマンドは .Bx 4.2 から登場しました。 diff --git a/ja_JP.eucJP/man/man8/named-bootconf.8 b/ja_JP.eucJP/man/man8/named-bootconf.8 index 7f6ec45e69..eb42c4036d 100644 --- a/ja_JP.eucJP/man/man8/named-bootconf.8 +++ b/ja_JP.eucJP/man/man8/named-bootconf.8 @@ -1,71 +1,70 @@ .\" %NetBSD: named-bootconf.8,v 1.1 1998/11/19 21:11:45 tron Exp % .\" .\" Copyright (c) 1998 The NetBSD Foundation, Inc. .\" All rights reserved. .\" .\" This documentation is derived from software contributed to The NetBSD .\" Foundation by Matthias Scheler. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce 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 FOUNDATION 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. .\" .\" Copyright (c) 1999 by Internet Software Consortium .\" .\" Permission to use, copy, modify, and distribute this software for any .\" purpose with or without fee is hereby granted, provided that the above .\" copyright notice and this permission notice appear in all copies. .\" .\" THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM DISCLAIMS .\" ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL INTERNET SOFTWARE .\" CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL .\" DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR .\" PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS .\" ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS .\" SOFTWARE. .\" $FreeBSD$ - .Dd November 19, 1998 .Dt NAMED-BOOTCONF 8 .Os NetBSD .Sh 名称 .Nm named-bootconf .Nd ネームサーバの設定ファイルを変換 .Sh 書式 .Nm .Sh 解説 .Nm は named の設定ファイルを BIND 4 形式から BIND 8 形式に変換します。 .Sh 使用例 named-bootconf < named.boot > named.conf .Sh バグ ソースファイル中のコメントが 出力ファイル中の正しい位置に現れないことがあります。 .Sh 関連項目 .Xr named 8 , .Xr named.conf 5 diff --git a/ja_JP.eucJP/man/man8/named-xfer.8 b/ja_JP.eucJP/man/man8/named-xfer.8 index 829bd8f75f..ce53feaf89 100644 --- a/ja_JP.eucJP/man/man8/named-xfer.8 +++ b/ja_JP.eucJP/man/man8/named-xfer.8 @@ -1,191 +1,189 @@ .\" ++Copyright++ 1985 .\" - .\" Copyright (c) 1985 .\" The Regents of the University of California. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" - .\" Portions Copyright (c) 1993 by Digital Equipment Corporation. .\" .\" Permission to use, copy, modify, and distribute this software for any .\" purpose with or without fee is hereby granted, provided that the above .\" copyright notice and this permission notice appear in all copies, and that .\" the name of Digital Equipment Corporation not be used in advertising or .\" publicity pertaining to distribution of the document or software without .\" specific, written prior permission. .\" .\" THE SOFTWARE IS PROVIDED "AS IS" AND DIGITAL EQUIPMENT CORP. DISCLAIMS ALL .\" WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL DIGITAL EQUIPMENT .\" CORPORATION BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL .\" DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR .\" PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS .\" ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS .\" SOFTWARE. .\" - .\" Portions Copyright (c) 1999 by Check Point Software Technologies, Inc. .\" .\" Permission to use, copy, modify, and distribute this software for any .\" purpose with or without fee is hereby granted, provided that the above .\" copyright notice and this permission notice appear in all copies, and that .\" the name of Check Point Software Technologies Incorporated not be used .\" in advertising or publicity pertaining to distribution of the document .\" or software without specific, written prior permission. .\" .\" THE SOFTWARE IS PROVIDED "AS IS" AND CHECK POINT SOFTWARE TECHNOLOGIES .\" INCORPORATED DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, .\" INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. .\" IN NO EVENT SHALL CHECK POINT SOFTWARE TECHNOLOGIES INCORPRATED .\" BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR .\" ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER .\" IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT .\" OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" .\" --Copyright-- .\" .\" from named.8 6.6 (Berkeley) 2/14/89 .\" .\" $FreeBSD$ .Dd June 26, 1993 .Dt NAMED-XFER 8 .Os BSD 4 .Sh 名称 .Nm named-xfer .Nd ゾーン転送のための補助エージェント .Sh 書式 .Nm named-xfer .Fl z Ar zone_to_transfer .Fl f Ar db_file .Fl s Ar serial_no .Op Fl d Ar debuglevel .Op Fl l Ar debug_log_file .Op Fl i Ar ixfr_file .Op Fl t Ar trace_file .Op Fl p Ar port# .Op Fl S .Ar nameserver -.Op Ar [ Sy axfr -| -.Op Sy ixfr ] +.Op Sy axfr | ixfr .Sh 解説 .Nm は、 .Xr named 8 によって実行される補助プログラムです。 インターネットネームサーバから呼び出されて、ゾーン情報を受け取ります。 直接実行されることはまれであり、ゾーン転送の問題を解決するために システム管理者にいよってのみ実行されることがある程度です。 インターネットネームドメインシステムについての詳細は、 RFC 1033、1034、1035 を参照してください。 .Pp オプションとしては、以下のものがあります: .Bl -tag -width Fl .It Fl z Ar zone_to_transfer 転送されるゾーン名を指定します。 .It Fl f Ar db_file プライマリサーバーからゾーンが転送された際に、ゾーンの情報をダンプ (格納) する .Ar db_file のファイル名を指定します。 .It Fl s Ar serial_no 転送されるゾーンの情報のシリアル番号を指定します。プライマリサーバから 得た .Sy SOA RR が、このシリアル番号よりも高いシリアル番号を持たない 場合は、転送は中止されます。 .It Fl d Ar debuglevel デバッグ情報を出力します。 .Ar debuglevel 出力されるメッセージのレベルを決定します。 .It Fl l Ar debug_log_file デバッグメッセージのログファイルを指定します。デフォルトでは システムに依存しますが、通常は .Pa /var/tmp または .Pa /usr/tmp です。このオプションは .Fl d と同時に指定されたときのみ適用されますので注意してください。 .It Fl i Ar ixfr_file .Ar ixfr_file の名前を指定します。 Incremental Zone Transfer (IXFR) によりゾーン変更内容を プライマリサーバから受信すると、 このゾーン変更内容をこのファイルにダンプ (格納) します。 .It Fl t Ar trace_file ゾーン情報転送のプロトコルトレースを格納するトレースファイル .Ar trace_file を指定します。 このオプションはネームサーバそのものをデバッグする人にとってのみ 有益なのかもしれません。 .It Fl p Ar port# デフォルト以外のポート番号を使用するときに指定します。 デフォルトの標準ポートナンバーは ``domain'' サービスの .Xr getservbyname 3 の返す値になります。 .It Fl S SOA レコードと NS レコードの転送のみを許可し、 ゾーンに対して A レコードを結合します。 SOA レコードは .Xr named 8 によって読み込まれませんが、 NS レコードをいつ検証するのかを決定するのに使用されます。 詳しくは .Xr named 8 の .Dq Li stubs を参照してください。 .El .Pp 付加的な引数としてネームサーバのアドレスを、いわゆる .Dq dotted-quad 構文で .Em のみ 、とります。ネームサーバのアドレスの省略は許されません。 少なくとも一つのアドレスを指定しなくてはなりません。 ネームサーバのアドレスが複数指定されると、最初のサーバが転送を失敗すると、 順番にサーバを切り替えて転送を試みます。 ネームサーバアドレスの後の .Sy axfr または .Sy ixfr は、実行するゾーン転送タイプを指定します。 全ゾーン転送には .Sy axfr を使用し、インクリメンタルゾーン転送には .Sy ixfr を使用してください。 .Sh 関連項目 .Xr hostname 7, .Xr named 8 , .Xr resolver 3 , .Xr resolver 5 , RFC 882, RFC 883, RFC 973, RFC 974, RFC 1033, RFC 1034, RFC 1035, RFC 1123, RFC 1995 .Dq Name Server Operations Guide for Sy BIND . diff --git a/ja_JP.eucJP/man/man8/named.8 b/ja_JP.eucJP/man/man8/named.8 index f66d038397..e3f0f7681e 100644 --- a/ja_JP.eucJP/man/man8/named.8 +++ b/ja_JP.eucJP/man/man8/named.8 @@ -1,466 +1,469 @@ .\" ++Copyright++ 1985, 1996 .\" - .\" Copyright (c) 1985, 1996 .\" The Regents of the University of California. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" - .\" Portions Copyright (c) 1993 by Digital Equipment Corporation. .\" .\" Permission to use, copy, modify, and distribute this software for any .\" purpose with or without fee is hereby granted, provided that the above .\" copyright notice and this permission notice appear in all copies, and that .\" the name of Digital Equipment Corporation not be used in advertising or .\" publicity pertaining to distribution of the document or software without .\" specific, written prior permission. .\" .\" THE SOFTWARE IS PROVIDED "AS IS" AND DIGITAL EQUIPMENT CORP. DISCLAIMS ALL .\" WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL DIGITAL EQUIPMENT .\" CORPORATION BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL .\" DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR .\" PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS .\" ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS .\" SOFTWARE. .\" - .\" --Copyright-- .\" .\" @(#)named.8 6.6 (Berkeley) 2/14/89 .\" $FreeBSD$ .\" .Dd February 1, 1996 .Dt NAMED 8 .Os BSD 4 .Sh 名称 .Nm named .Nd インターネットドメインネームサーバ (DNS) .Sh 書式 .Nm .Op Fl d Ar debuglevel .Op Fl p Ar port# .Oo Fl Po .Cm b Ns \&| Ns Cm c .Pc .Ar config_file .Oc .Op Fl f q r v .Op Fl u Ar user_name .Op Fl g Ar group_name .Op Fl t Ar directory .Op Fl w Ar directory .Op Ar config_file .Sh 解説 .Nm はインターネットドメインネームサーバです。 インターネットドメインネームシステムの詳細な情報については RFC 1033, 1034, 1035 を参照してください。 パラメータがない場合は .Nm はデフォルトの設定ファイルである .Pa /etc/namedb/named.conf の初期化データを読み込み、問い合わせに対し待機します。 コマンド行の最後に与えられた .Ar config_file 引数は .Dq Fl b または .Dq Fl c フラグを使用して指定された .Ar config_file を無効にします。 .Pp -.Sy 注: +.Sy 注 : .Nm のいくつかのオプションと多くの動作は、設定ファイルの中で 制御できます。更なる情報はこの .Sy BIND 配布物に含まれる設定ファイルガイドを参照してください。 .Pp 指定できるオプションは以下の通りです。 .Bl -tag -width Fl .It Fl d Ar debuglevel デバッグ情報を出力します。 .Ar debuglevel は表示するメッセージのレベルを決定する数字です。もし負の値の場合、 .Ar debuglevel は .Dq 1 に設定されます。 .Pp -.Sy 注: +.Sy 注 : 新しいデバッグの枠組は古いバージョンの .Nm よりもかなり洗練されています。 設定ファイルの .Dq Li logging 宣言は (問い合わせや内/外への転送などの) 多くの種類にわたるイベント それぞれに対して、複数の別々なデバッグレベルを設定することができます。 これらの広範囲にわたる新しい機能に関する更なる情報は、この .Sy BIND 配布物に含まれる設定ファイルガイドを参照してください。 .It Fl p Ar port# 指定されたリモートポート番号を使用します。このポート番号は .Nm が問い合わせを送る番号です。デフォルトの値は標準のポート番号、つまり .Xr getservbyname 3 が .Dq Li domain に対して返すポート番号です。 .Pp -.Sy 注: +.Sy 注 : 以前は、 .Dq Fl p Ar port# Ns Op Ar \&/localport# という文法が使用でき、1 つ目のポートが .Em remote サーバへの接続に使用され、2 つ目のポートが .Nm の .Em local サーバに対するポート番号として使用されました。 現在の使用法は古い使用法から .Ar localport# の指定を除いたものと同等です。この機能は 設定ファイルの .Dq Li options 宣言にある .Dq Li listen-on 節で指定できます。 .It Xo Fl Po .Cm b Ns \&| Ns Cm c .Pc Ar config_file .Xc 代わりの .Ar config_file を使用します。 この引数はコマンド行の最後に指定された .Ar config_file によって上書きされます。 デフォルトの値は .Pa /etc/namedb/named.conf です。 .It Fl f このプロセスを表で動かし、 .Xr fork 2 やデーモン化をしません (デフォルトではデーモン化をします)。 .It Fl q .Nm が .Li QRYLOG を定義してコンパイルされている場合に、 すべての問い合わせのトレースを行ないます。 .Pp -.Sy 注: +.Sy 注 : 設定ファイルの .Dq Li logging 宣言で .Dq Li queries .Em logging category する方が賛成され、このオプションは反対されています。 更なる情報は、この .Sy BIND 配布物に含まれる設定ファイルガイドを参照してください。 .It Fl r 再帰的なネームサーバの問い合わせを抑止します。 問い合わせに対してはローカルゾーン (プライマリもしくはセカンダリ) からのみ 回答されます。 この指定はルートサーバにて使用することができます。 デフォルトでは再帰的な問い合わせを行ないます。 .Pp -.Sy 注: +.Sy 注 : このオプションは設定ファイルの .Dq Li options 宣言の .Dq Li recursion 節によって上書きされ、またそちらのほうが推奨されています。 .It Fl v バージョンを報告し、終了します。 .It Fl u Ar user_name ユーザを指定すると、初期化後のサーバがこのユーザで動作します。 値はユーザ名または数字のユーザ ID どちらでも構いません。 .Dq Fl g フラグが指定されていなかった場合、 指定されたユーザのプライマリグループがグループ ID として使用されます (initgroups() が呼ばれるため、ユーザの所属するすべてのグループがサーバに 渡されます)。 .Pp .It Fl g Ar group_name グループを指定すると、初期化後のサーバがこのグループで動作します。 値はグループ名または数字のグループ ID どちらでも構いません。 .Pp .It Fl t Ar directory サーバがコマンド行引数を処理したらすぐに chroot() するべき ディレクトリを指定します。 .Pp .It Fl w Ar directory サーバの作業ディレクトリを設定します。設定ファイルの .Dq Li options 宣言の .Dq Li directory 節はコマンド行で指定したあらゆる値を上書きします。 デフォルトの作業ディレクトリはカレントディレクトリ .Pq Dq \&. です。 .El .Pp それ以外の引数は上で述べたとおり、 古い実装との互換性のために、設定ファイルの名前として扱われます。この引数は .Dq Fl b または .Dq Fl c フラグを使用して指定される .Ar config_file を無効にします。 特に引数が与えられなければ、デフォルトの設定ファイルが使用されます .Pq Pa /etc/namedb/named.conf 。 .Ss マスタファイル形式 マスタファイルは制御情報とゾーン中のオブジェクトの 資源レコードのリストからなり、次の形式を取ります。 .Bd -literal -offset indent $INCLUDE $ORIGIN $TTL .Ed .Pp ここで、 .Bl -tag -width "opt_domain " .It Ar domain ルートの場合は -.Dq Li \&. +.Dq Li .\& を、現在の起点の場合は .Dq Li @ を、それら以外では通常のドメイン名を指定します。 .Ar domain が -.Dq Li \&. +.Dq Li .\& で終って .Em いない 通常のドメイン名である場合は、 現在の起点がドメインに追加されます。 ドメイン名が -.Dq Li \&. +.Dq Li .\& で終っている場合は変更されません。 .It Ar opt_domain このフィールドにはインクルードファイル中のデータの起点を定義します。 これはインクルードファイルの最初の行の前に .Li $ORIGIN 宣言を置くことと等価です。 このフィールドはオプショナルです。 .Ar opt_domain フィールドやインクルードファイル中の .Li $ORIGIN 宣言はそのファイル自身の現在の起点を変更することはありません。 .It Ar ttl 明示的な TTL (time-to-live) を持たない 将来のレコードのためのデフォルトの TTL を、整数値で指定します。 .It Ar opt_ttl このフィールドはオプションであり、 time-to-live を整数値で指定します。 設定されない場合、TTL は最後の $TTL 文から取得されます。 $TTL 文が存在しない場合、SOA の最小値が使用され、警告が生成されます。 .It Ar opt_class オブジェクトのアドレスの型を指定します。 現在は DARPA インターネットに接続するオブジェクトである .Dv IN のみがサポートされています。 .It Ar type このフィールドには以下のトークンのうちひとつが含まれます。 括弧中におのおの .Ar resource_record_data フィールドに指定すべきデータを示しています。 .Bl -tag -width "HINFO " -offset indent .It Dv A ホストアドレス (4つ組ドット IP アドレス) .It Dv NS 権威があるネームサーバ (ドメイン) .It Dv MX メールエクスチェンジャ (ドメイン) 優先順位 (0..32767) に引続き指定します。 優先順位は小さい値が優先順位の高いことを示します。 .It Dv CNAME 別名に対応した正式名 (ドメイン) .It Dv SOA オーソリティゾーンデータの開始を示します。 (ホストの属するドメイン、メンテナのドメインアドレス、 シリアル番号、その後にリフレッシュ、リトライ、有効期限、最小 TTL (RFC 883 と RFC 2308 を参照) の各値を秒で指定したパラメータが続く)。 .It Dv NULL ヌルリソースレコード (形式やデータはありません) .It Dv RP いくつかのドメイン名の責任者 (メールアドレスか参照できるテキスト) .It Dv PTR ドメイン名のポインタ (ドメイン) .It Dv HINFO ホスト情報 (CPUタイプ、OSタイプ) .El .El .Pp 通常は行末でリソースレコードは終了しますが、 左括弧と右括弧で囲まれた場合は複数行にまたがることが可能となります。 セミコロンから行末まではコメントとして扱われます。 .Pp -.Sy 注: +.Sy 注 : ここには示されていませんが、このほかのタイプのリソースレコードも存在します。 リソースレコードのすべてのタイプを知るには .Sy BIND Operations Guide .Pq Dq BOG を参照する必要があるでしょう。 新しい RFC にていくつかのリソースタイプが標準化されていますが、 このバージョンの .Sy BIND ではまだ実装されていません。 .Ss SOA レコード形式 各マスタゾーンファイルはそのゾーンの SOA レコードで始まらなければなりません。 以下に SOA レコードの例を示します。 .Bd -literal @ IN SOA ucbvax.Berkeley.EDU. rwh.ucbvax.Berkeley.EDU. ( 1989020501 ; serial 10800 ; refresh 3600 ; retry 3600000 ; expire 86400 ) ; minimum .Ed .Pp SOA ではシリアル番号 (serial) を指定します。 シリアル番号はマスタファイルを更新するたびに増加する必要があります。 シリアル番号は小数点つきの数字を指定することもできますが、 整数への変換は乗算や加算ではなく文字列としてつなげて行っているため、 .Em あまり 賢い方法とはいえません。 年月日と 0〜99 のシリアル番号を使用することで、 このフィールドのサイズである符号なしの 32 ビット以内に収まります。 (このやり方は 4294 年には考え直す必要があることは確かですが、 それについては心配する必要はないでしょう)。 .Pp セカンダリサーバは秒で指定されたリフレッシュ時間 (refresh) の間隔で シリアル番号をチェックします。 シリアル番号に変更があれば、新しいデータを読み込むために ゾーン情報が転送されます。 リフレッシュ時間が過ぎてもマスタサーバに接続できない場合は、 リトライ時間 (retry) の間隔でリフレッシュが試みられます。 期限切れ時間 (expire) が過ぎてマスタサーバに接続できない場合は、 セカンダリサーバはそのゾーンのすべてのデータを破棄します。 .Sh 注 ブートファイルでの .Dq Li domain と .Dq Li suffixes の指定は廃止され、 もっと便利なリゾルバベースの実装、すなわち部分的な形のドメイン名 (partially-qualified domain names) の接尾辞に置き変えられました。 以前のメカニズムでは多くの状況下で失敗することがあり、 特にローカルネームサーバが完全な情報を持っていない場合に失敗しました。 .Pp 以下に各シグナルを .Xr kill 1 コマンドによってサーバに送った場合の効果を示します。 .Pp .Bl -tag -width "SIGWINCH" .It Dv SIGHUP サーバは .Pa named.conf を読み、データベースをロードし直します。 サーバがコンパイルオプションの .Li FORCED_RELOAD を定義されてコンパイルされている場合は、 .Dv SIGHUP を送るとサーバはすべてのセカンダリゾーンのシリアル番号もチェックします。 通常、シリアル番号は SOA 中に指定された間隔でのみチェックされます。 .It Dv SIGINT 現在のデータベースとキャッシュの内容を .Dq Pa /var/tmp/named_dump.db または .Dv _PATH_DUMPFILE の値にダンプします。 .It Dv SIGILL サーバが -DSTATS 付きでコンパイルされていれば、 統計データを .Pa named.stats にダンプします。 統計データはこのファイルの末尾に追加されます。 .It Dv SIGSYS サーバがプロファイリング (サーバの fork, chdir と exit) を 有効にされてコンパイルされていれば、 プロファイリングデータを .Pa /var/tmp にダンプします。 .It Dv SIGTERM 更新されたデータが存在すればこれを保存し、サーバをシャットダウンします .It Dv SIGUSR1 デバッグ機能を有効にします。 .Dv SIGUSR1 が送られるたびにデバッグレベルが上がります。 -.Po Dv SIGUSR1 +.Po +.Dv SIGUSR1 がない古いシステムでは .Dv SIGEMT が使われます。 .Pc .It Dv SIGUSR2 デバッグ機能を完全に無効にします。 -.Po Dv SIGUSR2 +.Po +.Dv SIGUSR2 がない古いシステムでは .Dv SIGFPE が使われます。 .Pc .It Dv SIGWINCH すべてのサーバに入力される問い合わせの -.Xr syslog 8 +.Xr syslog 3 による ログ採取の有無を切り替えます。 (ログ採取はサーバが .Li QRYLOG オプションを指定されて コンパイルされている必要があります。) .El .Sh 関連ファイル .Bl -tag -width "/var/tmp/named_dump.db (_PATH_DUMPFILE) " -compact .It Pa /etc/namedb/named.conf デフォルトのネームサーバの設定ファイル .It Pa /var/run/named.pid Pq Dv _PATH_PIDFILE プロセス ID .It Pa /var/tmp/named_dump.db Pq Dv _PATH_DUMPFILE ネームサーバデータベースのダンプ .It Pa /var/tmp/named.run Pq file: Dv _PATH_DEBUG デバッグ出力 .It Pa /var/tmp/named.stats Pq file: Dv _PATH_STATS ネームサーバの統計データ .El .Sh 関連項目 +.Xr named.conf 5 , .Xr gethostbyname 3 , .Xr hostname 7 , .Xr kill 1 , .Xr resolver 3 , .Xr resolver 5 , -.Xr signal 2 , +.Xr signal 3 , RFC 882, RFC 883, RFC 973, RFC 974, RFC 1033, RFC 1034, RFC 1035, RFC 1123, RFC 2308 .Dq Name Server Operations Guide for Sy BIND diff --git a/ja_JP.eucJP/man/man8/ndc.8 b/ja_JP.eucJP/man/man8/ndc.8 index 69a602d29f..a00acf803b 100644 --- a/ja_JP.eucJP/man/man8/ndc.8 +++ b/ja_JP.eucJP/man/man8/ndc.8 @@ -1,137 +1,137 @@ .\" Copyright (c) 1998,1999 by Internet Software Consortium .\" .\" Permission to use, copy, modify, and distribute this software for any .\" purpose with or without fee is hereby granted, provided that the above .\" copyright notice and this permission notice appear in all copies. .\" .\" THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM DISCLAIMS .\" ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL INTERNET SOFTWARE .\" CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL .\" DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR .\" PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS .\" ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS .\" SOFTWARE. .\" .\" $FreeBSD$ .Dd December 31, 1998 .Dt NDC 8 .Os BSD 4 .Sh 名称 .Nm ndc .Nd ネームサーバデーモン制御プログラム .Sh 書式 .Nm ndc .Op Fl c Ar channel .Op Fl l Ar localsock .Op Fl p Ar pidfile .Op Fl d .Op Fl q .Op Fl s .Op Fl t .Op Ar command .Sh 解説 このコマンドを使用する事により、システム管理者はネームサーバを制御可能です。 .Ar command を指定しないと、 .Ic ndc は、EOF を読み込むまでの間コマンド入力を促します。 .Pp オプションは次の通りです: .Bl -tag -width Fl .It Fl c Ar channel 制御チャネルのランデブポイントを指定します。 デフォルトは .Pa /var/run/ndc です (UNIX ドメインソケットであり、サーバのデフォルトの制御チャネルです)。 要求する制御チャネルが TCP/IP ソケットの場合、 .Ar channel 引数の書式は .Sy ipaddr/port になります (例えば .Sy 127.0.0.1/54 は、ローカルホストの TCP ポート 54 になります。) .It Fl l Ar localsock 本オプションは、クライアント側の制御チャネルを特定のアドレスに .Xr bind 2 します。 特定のアドレス以外からの接続を拒否するように、サーバを設定可能です。 書式は .Ar channel のものと同じです (上述参照)。 .It Fl p Ar pidfile 古いネームサーバとの後方互換性のため、制御通信用に .Ic ndc は UNIX シグナルを使用可能です。 この機能は現在のネームサーバではオプションであり、いつかすべて消滅します。 使用可能な .Ar command の集合は、 シグナルによるインタフェースを使用した場合の方が狭いことに注意してください。 おそらく .Ar pidfile 引数は .Pa /var/run/named.pid のようなものです。 .It Fl d デバッグ出力を有効にします。主に開発者が興味を持つものです。 .It Fl q プロンプトと結果のテキスト出力を抑制します。 .It Fl s 致命的でないエラー出力を抑制します。 .It Fl t プロトコルとシステムのトレースを有効にします。 インストール時のデバッグに有用です。 .El .Sh コマンド いくつかのコマンドは .Ic ndc に組み込まれています。 ネームサーバがサポートする完全なコマンドセットは動的であり、これは .Ar help コマンド (後述参照) で確認できるはずです。 組み込みコマンドは次の通りです: .Bl -tag -width Fl .It Ar /help 組み込みコマンド用のヘルプを提供します。 .It Ar /exit .Ic ndc コマンドインタプリタから抜けます。 .It Ar /trace トレース機能を切り替えます (前述の .Fl t の記述を参照)。 .It Ar /debug デバッグ機能を切り替えます (前述の .Fl d の記述を参照)。 .It Ar /quiet 静寂機能を切り替えます (前述の .Fl q の記述を参照)。 .It Ar /silent 沈黙機能を切り替えます (前述の .Fl s の記述を参照)。 .El .Sh 注 .Ar pidfile モードで実行すると、 .Ar start と .Ar restart のコマンドへの引数は、新しい .Ic named に対するコマンドラインとして渡されます。 .Ar channel モードで実行すると、 .Ar start コマンドは無く、 .Ar restart コマンドは単にネームサーバに対して自己を -.Xr execvp 2 +.Xr execvp 3 するよう通知します。 .Sh 作者 Paul Vixie (Internet Software Consortium) .Sh 関連項目 .Xr named 8 diff --git a/ja_JP.eucJP/man/man8/nslookup.8 b/ja_JP.eucJP/man/man8/nslookup.8 index ac1ed6084b..e7eb2ce334 100644 --- a/ja_JP.eucJP/man/man8/nslookup.8 +++ b/ja_JP.eucJP/man/man8/nslookup.8 @@ -1,554 +1,553 @@ .\" .\" ++Copyright++ 1985, 1989 .\" - .\" Copyright (c) 1985, 1989 .\" The Regents of the University of California. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" - .\" Portions Copyright (c) 1993 by Digital Equipment Corporation. .\" .\" Permission to use, copy, modify, and distribute this software for any .\" purpose with or without fee is hereby granted, provided that the above .\" copyright notice and this permission notice appear in all copies, and that .\" the name of Digital Equipment Corporation not be used in advertising or .\" publicity pertaining to distribution of the document or software without .\" specific, written prior permission. .\" .\" THE SOFTWARE IS PROVIDED "AS IS" AND DIGITAL EQUIPMENT CORP. DISCLAIMS ALL .\" WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL DIGITAL EQUIPMENT .\" CORPORATION BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL .\" DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR .\" PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS .\" ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS .\" SOFTWARE. .\" - .\" --Copyright-- .\" .\" @(#)nslookup.8 5.3 (Berkeley) 6/24/90 -.\" %FreeBSD: src/contrib/bind/doc/man/nslookup.8,v 1.2.2.1 2000/11/02 14:08:07 asmodai Exp % +.\" %FreeBSD: src/contrib/bind/doc/man/nslookup.8,v 1.2.2.2 2002/05/15 19:51:23 nectar Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man8/nslookup.8,v 1.6 2001/07/29 05:15:29 horikawa Exp $ +.\" $FreeBSD$ .Dd June 24, 1990 .Dt NSLOOKUP 8 .Os BSD 4 .Sh 名称 .Nm nslookup .Nd インターネットネームサーバに対話的に問い合わせる .Sh 書式 .Nm nslookup .Op Fl option Ar ... .Op Ar host-to-find | Fl Op Ar server .Sh 解説 .Ic nslookup はインターネットネームサーバに問い合わせを行います。 .Ic nslookup には対話モードと非対話モードの 2 つのモードがあります。 対話モードでは、 様々なホストやドメインの情報をネームサーバに対して問い合わせたり、 あるドメイン内のホスト一覧を表示することができます。 非対話モードでは、あるホストもしくはドメインの名前および 要求した情報のみが表示されます。 .Sh 引数 次の場合は対話モードに入ります。 .Bl -tag -width "a) " .It a) -引数が与えられなかったとき(デフォルトのネームサーバを利用します)。 +引数が与えられなかったとき (デフォルトのネームサーバを利用します)。 .It b) 最初の引数がハイフン (-) であり、2 番目の引数がネームサーバの ホスト名もしくは IP アドレスであるとき。 .El .Pp 検索したいホストの名前もしくは IP アドレスが最初の引数として与えられた場合は、 非対話モードになります。 2 番目の引数はオプションで、ネームサーバのホスト名もしくは IP アドレスを 指定します。 .Pp .Dq Li set コマンドを使うオプションは、ホームディレクトリの .Pa .nslookuprc ファイルに 1 行に 1 つずつ書くことでも指定できます。 オプションはコマンドラインで指定することも可能です。その場合、 前にハイフンをつけ、引数より先に書きます。たとえば、デフォルトの問い合わせを ホスト情報に変更し、初期タイムアウトを 10 秒とするには、 .Bd -literal -offset indent nslookup -query=hinfo -timeout=10 .Ed とします。 .Sh 対話コマンド コマンドは control-C を入力することでいつでも中断できます。 終了するには、 control-D .Pq Dv EOF もしくは .Li exit を入力します。 コマンドラインの長さは 256 文字以下でなければなりません。 内部コマンドをホスト名として扱うには、 エスケープ文字 .Pq \e を頭につけます。 .Sy 注意: 解釈できないコマンドはホスト名として扱われます。 .Bl -tag -width "lserver" .It Ar host Op Ar server .Ar host についての情報を現在のデフォルトサーバ、もしくは .Ar server が指定されている場合はそのサーバに問い合わせます。 .Ar host が IP アドレスであり、問い合わせタイプが .Dv A もしくは .Dv PTR であるときは、ホスト名が返されます。 .Ar host が 名前であり、最後にピリオドがないときには、 -その後ろにデフォルトのドメイン名が付加されます(この動作は、 +その後ろにデフォルトのドメイン名が付加されます (この動作は、 .Ic set オプションの .Ic domain , srchlist , defname , search に依存します)。 .Pp 現在のドメインにないホストについて調べるときには、 名前の末尾にピリオドを付加します。 .It Ic server Ar domain .It Ic lserver Ar domain デフォルトサーバを .Ar domain に変更します。 .Ic lserver は .Ar domain についての情報を探すのに初期サーバを使い、 .Ic server は現在のデフォルトサーバを使います。 公式の答えが見つからないときには、答えを持つ可能性のある サーバ名が返されます。 .It Ic root デフォルトサーバをドメイン名空間のルートサーバに変更します。 現在のところホスト .Li ns.internic.net が使われます (このコマンドは .Dq Ic lserver ns.internic.net に同義です)。 ルートサーバ名は .Dq Ic set root コマンドで変更できます。 .It Xo Ic finger Op Ar name .Op Ic > Ar filename .Xc .It Xo Ic finger Op Ar name .Op Ic >> Ar filename .Xc 現在のホストにあるフィンガーサーバと接続します。 現在のホストは、以前の問い合わせが成功し、アドレス情報が -返されたときに定義されます( -.Dq Ic set querytype=A +返されたときに定義されます +.Dq ( Ic set querytype Ns = Ns Dv A 参照)。 .Ar name はオプションです。 .Ic > と .Ic >> は普通に出力をリダイレクトするのに使えます。 .It Xo Ic ls Op Ar option .Ar domain Op Ic > Ar filename .Xc .It Xo Ic ls Op Ar option .Ar domain Op Ic >> Ar filename .Xc .Ar domain について入手できる情報の一覧を出します。 オプションでファイル .Ar filename を作成あるいは .Ar filename に追加できます。 デフォルトの出力にはホスト名とその IP アドレスが含まれます。 .Ar option は下記のいずれかです。 .Bl -tag -width "-a " .It Fl t Ar querytype -指定したタイプの全レコードの一覧を出力します(下記の +指定したタイプの全レコードの一覧を出力します (下記の .Ar querytype 参照)。 .It Fl a そのドメイン内での、各ホストのエイリアス一覧を出力します。 .Dq Fl t Dv CNAME と同義です。 .It Fl d そのドメインの全レコードの一覧を出力します。 .Dq Fl t Dv ANY と同義です。 .It Fl h そのドメインの CPU 及び OS 情報を出力します。 .Dq Fl t Dv HINFO と同義です。 .It Fl s そのドメイン内のホストの良く知られた (well-known) サービスの一覧を出力します。 .Dq Fl t Dv WKS と同義です。 .El .Pp 出力がファイルにリダイレクトされるときには、サーバから 50 レコードを 受け取るたびにハッシュマークが表示されます。 .It Ic view Ar filename 直前の .Ic ls コマンドの出力を並べ変え、 .Xr more 1 で出力します。 .It Ic help -.It Ic ? +.It Ic ?\& コマンドの簡単な要約を表示します。 .It Ic exit プログラムを終了します。 -.It Xo Ic set Ar keyword -.Ns Op = Ns Ar value +.It Xo +.Ic set +.Ar keyword Ns Op = Ns Ar value .Xc このコマンドは探索に影響するオプションを変更するのに使われます。 有効な keyword は以下の通りです。 .Bl -tag -width "class=v" .It Ic all よく使われる .Ic set のオプションの現在の値を表示します。 現在のデフォルトサーバとホストに関する情報も表示されます。 -.It Ic class= Ns Ar value +.It Ic class Ns = Ns Ar value 問い合わせのクラスを次のいずれかに変更します。 .Bl -tag -width "HESIOD " .It Dv IN インターネットクラス。 .It Dv CHAOS chaos クラス。 .It Dv HESIOD MIT Athena Hesiod クラス。 .It Dv ANY 上記すべて。 .El .Pp クラスは情報のプロトコルグループを特定します。 .Pp (デフォルト = .Dv IN; 略記 = .Ic cl ) -.It Xo Op Ic no -.Ns Ic debug +.It Xo +.Oo Ic no Oc Ns Ic debug .Xc デバッグモードにします。サーバに送られるパケットとそれに 対する返答について、より多くの情報が表示されます。 .Pp (デフォルト = .Ic nodebug ; 略記 = -.Xo Op Ic no -.Ns Ic deb ) -.Xc -.It Xo Op Ic no -.Ns Ic d2 +.Oo Ic no Oc Ns Ic deb ) +.It Xo +.Oo Ic no Oc Ns Ic d2 .Xc 詳細なデバッグモードにします。 パケットごとに重要なすべてのフィールドが表示されます。 .Pp (デフォルト = .Ic nod2 ) -.It Ic domain= Ns Ar name +.It Ic domain Ns = Ns Ar name デフォルトドメイン名を .Ar name に変更します。 .Ic defname と .Ic search オプションの設定に応じて、 探索要求されるホスト名にデフォルトドメイン名が付加されます。 デフォルトドメイン名が 2 つ以上の要素から なるとき、ドメインサーチリストにはデフォルトドメインの親が含まれます。 たとえば、デフォルトドメイン名が CC.Berkeley.EDU であるとき、サーチリストは CC.Berkeley.EDU 及び Berkeley.EDU です。 異なるリストを指定するには、 .Dq Ic set srchlist コマンドを使います。 このリストを表示するには、 .Dq Ic set all コマンドを使います。 .Pp (デフォルト = .Xr hostname 1 から得た値, .Pa /etc/resolv.conf あるいは .Pa LOCALDOMAIN; 略記 = .Ic do ) -.It Ic srchlist= Ns Ar name1/name2/... +.It Xo +.Sm off +.Ic srchlist No = +.Ar name1 No / +.Ar name2 No / +.Ar ... +.Sm on +.Xc デフォルトドメイン名を .Ar name1 にし、ドメインサーチリストを .Ar name1 , name2 , etc. に変更します。スラッシュ (/) で区切って 最大 6 つまで指定可能です。 たとえば .Bd -literal -offset indent set srchlist=lcs.MIT.EDU/ai.MIT.EDU/MIT.EDU .Ed .Pp の場合、ドメインを lcs.MIT.EDU にし、サーチリストを上の 3 つの名前に 設定します。 このコマンドは、 .Dq Ic set domain コマンドによるデフォルトドメイン名と サーチリストを上書きします。 リストを表示するには、 .Dq Ic set all コマンドを使います。 .Pp (デフォルト = .Xr hostname 1 に基づく値, .Pa /etc/resolv.conf あるいは .Ev LOCALDOMAIN ; 略記 = .Ic srchl ) -.It Xo Op Ic no -.Ns Ic defname +.It Xo +.Oo Ic no Oc Ns Ic defname .Xc -これが設定されると、単一要素からなる問い合わせ(すなわちピリオドのないもの) +これが設定されると、単一要素からなる問い合わせ (すなわちピリオドのないもの) に対して、 指定したデフォルトドメイン名が付加されます。 .Pp (デフォルト = .Ic defname ; 略記 = -.Xo Op Ic no -.Ns Ic defname ) -.Xc -.It Xo Op Ic no -.Ns Ic search +.Oo Ic no Oc Ns Ic defname ) +.It Xo +.Oo Ic no Oc Ns Ic search .Xc 問い合わせ要求にピリオドが少なくとも 1 つ含まれているが ピリオドで終っては .Em いない 場合、 答えが受け取れるまで、ドメインサーチリスト内のドメイン名を 付加します。 .Pp (デフォルト = .Ic search ; 略記 = -.Xo Op Ic no -.Ns Ic sea ) -.Xc -.It Ic port= Ns Ar value +.Oo Ic no Oc Ns Ic sea ) +.It Ic port Ns = Ns Ar value デフォルトのネームサーバの TCP/UDP ポートを .Ar value に変更します。 .Pp (デフォルト = 53; 略記 = .Ic \&po ) -.It Ic querytype= Ns Ar value -.It Ic type= Ns Ar value +.It Ic querytype Ns = Ns Ar value +.It Ic type Ns = Ns Ar value 問い合わせる情報の種類を変更します。情報は次のうちのいずれかです。 .Bl -tag -width "HINFO " .It Dv A ホストの IP アドレス。 .It Dv CNAME 別名に対する正式名。 .It Dv HINFO ホストの CPU と OS の種類。 .It Dv MINFO メールボックスもしくは、メールリストに関する情報。 .It Dv MX メール交換ホスト。 .It Dv NS その名前空間内のネームサーバ。 .It Dv PTR 問い合わせが IP アドレスであればホスト名、そうでなければ それ以外の情報へのポインタ。 .It Dv SOA ドメインの .Dq 権威開始 (start-of-authority) 情報。 .It Dv TXT テキスト情報。 .It Dv UINFO ユーザ情報。 .It Dv WKS サポートする、よく知られたサービス。 .El .Pp 他のタイプ -.Pq Dv ANY, AXFR, MB, MD, MF, NULL +.Dv ( ANY , AXFR , MB , +.Dv MD , MF , NULL ) については、ドキュメント RFC-1035 に書かれています。 .Pp (デフォルト = .Dv A ; 略記 = .Ic q, ty ) -.It Xo Op Ic no -.Ns Ic recurse +.It Xo +.Oo Ic no Oc Ns Ic recurse .Xc サーバが情報を持っていないときに、他のサーバに問い合わせるよう 指示します。 .Pp (デフォルト = .Ic recurse ; 略記 = -.Xo Op Ic no -.Ns Ic rec ) -.Xc -.It Ic retry= Ns Ar number +.Oo Ic no Oc Ns Ic rec ) +.It Ic retry Ns = Ns Ar number リトライ回数を .Ar number 回とします。 -要求に対する返答をある時間内 ( -.Dq Ic set timeout +要求に対する返答をある時間内 +.Dq ( Ic set timeout で変更できる) に 受け取らなかったとき、タイムアウト期間は 2 倍にされ、 要求が再送されます。 retry の値は、あきらめるまでに要求を何回再送するかを決めます。 .Pp (デフォルト = 4, 略記 = .Ic ret ) -.It Ic root= Ns Ar host +.It Ic root Ns = Ns Ar host ルートネームサーバ名を .Ar host に変更します。 これは .Dq Ic root コマンドに影響します。 .Pp (デフォルト = .Ic ns.internic.net ; 略記 = .Ic ro ) -.It Ic timeout= Ns Ar number +.It Ic timeout Ns = Ns Ar number 返答を待つ初期タイムアウト間隔を .Ar number 秒に変更します。 リトライのたびにタイムアウト間隔は倍になります。 .Pp -(デフォルト = 5 seconds; 略記 = +(デフォルト = 5 秒; 略記 = .Ic ti ) -.It Xo Op Ic no -.Ns Ic vc +.It Xo +.Oo Ic no Oc Ns Ic vc .Xc サーバに要求を出すときに、常に仮想回路 (virtual circuit) を使います。 .Pp (デフォルト = .Ic novc ; 略記 = -.Xo Op Ic no -.Ns Ic v ) -.Xc -.It Xo Op Ic no -.Ns Ic ignoretc +.Oo Ic no Oc Ns Ic v ) +.It Xo +.Oo Ic no Oc Ns Ic ignoretc .Xc パケットトランケーションエラーを無視します。 .Pp (デフォルト = .Ic noignoretc ; 略記 = -.Xo Op Ic no -.Ns Ic ig ) -.Xc +.Oo Ic no Oc Ns Ic ig ) .El .El .Sh 診断 問い合わせが失敗した場合、エラーメッセージが表示されます。 エラーには次のようなものがあります。 .Bl -tag -width "Timed" .It Li Timed out -サーバに対する要求を、( -.Dq Ic set timeout= Ns Ar value -で変更できる)ある時間 -の間に( -.Dq Ic set retry= Ns Ar value -で変更できる)ある回数だけ +サーバに対する要求を、 +.Dq ( Ic set timeout Ns = Ns Ar value +で変更できる) ある時間 +の間に +.Do ( +.Ic set retry Ns = Ns Ar value +.Dc +で変更できる) ある回数だけ リトライしましたが、応答しませんでした。 .It Li \&No response from server サーバマシンでネームサーバが動いていません。 .It Li \&No records ホスト名は正しいのですが、そのホストについて現在の問い合わせに 関する情報をサーバが持っていません。 問い合わせる情報は .Dq Ic set querytype コマンドで指定できます。 .It Li Non-existent domain そのホスト名もしくはドメイン名が存在しません。 .It Li Connection refused .It Li Network is unreachable 現在のところネームサーバもしくはフィンガーサーバに対して 接続できません。 このエラーは一般に .Ic ls と .Ic finger 要求に対して起こります。 .It Li Server failure ネームサーバが内部でデータベースの矛盾を発見したため 正しい答えが返せませんでした。 .It Li Refused ネームサーバが要求に対するサービスを拒否しました。 .It Li Format error ネームサーバは要求パケットが適切なフォーマットになっていないと 判断しました。 .Nm nslookup 内にエラーがあるのかもしれません。 .El .Sh 関連ファイル .Bl -tag -width "/usr/share/misc/nslookup.helpXXX" -compact .It Pa /etc/resolv.conf ドメイン名の初期値とネームサーバのアドレスを記述するファイルです。 .It Pa $HOME/.nslookuprc ユーザ用の初期化オプションを記述するファイルです。 .It Pa /usr/share/misc/nslookup.help コマンドの要約です。 .El .Sh 環境変数 .Bl -tag -width "HOSTALIASESXXXX" -compact .It Ev HOSTALIASES ホスト名のエイリアスを記述したファイル。 .It Ev LOCALDOMAIN デフォルトドメインを上書きします。 .El .Sh 関連項目 .Xr named 8 , .Xr resolver 3 , .Xr resolver 5 ; RFC-1034, .Dq Domain Names - Concepts and Facilities ; RFC-1035, .Dq Domain Names - Implementation and Specification .Sh 作者 Andrew Cherenson diff --git a/ja_JP.eucJP/man/man8/nsupdate.8 b/ja_JP.eucJP/man/man8/nsupdate.8 index 08ad7e9da1..9ad203f9bd 100644 --- a/ja_JP.eucJP/man/man8/nsupdate.8 +++ b/ja_JP.eucJP/man/man8/nsupdate.8 @@ -1,205 +1,189 @@ -.\" %FreeBSD: src/contrib/bind/doc/man/nsupdate.8,v 1.1.1.1.4.2 2001/02/27 09:42:33 asmodai Exp % -.\" %Id: nsupdate.8,v 8.6 2000/10/30 23:06:57 cyarnell Exp % +.\" %FreeBSD: src/contrib/bind/doc/man/nsupdate.8,v 1.1.1.1.4.3 2002/05/15 19:51:23 nectar Exp % +.\" $Id: nsupdate.8,v 1.6 2002-05-18 06:26:23 horikawa Exp $ .\" .\"Copyright (c) 1999 by Internet Software Consortium .\" .\"Permission to use, copy, modify, and distribute this software for any .\"purpose with or without fee is hereby granted, provided that the above .\"copyright notice and this permission notice appear in all copies. .\" .\"THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM DISCLAIMS .\"ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES .\"OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL INTERNET SOFTWARE .\"CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL .\"DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR .\"PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS .\"ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS .\"SOFTWARE. .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man8/nsupdate.8,v 1.4 2001/05/14 01:09:53 horikawa Exp $ +.\" $FreeBSD$ .Dd March 5, 1999 .Dt NSUPDATE 8 .Os BSD 4 .Sh 名称 .Nm nsupdate .Nd 対話的に Internet ネームサーバを更新する .Sh 書式 .Nm nsupdate -.Op Fl Ar k keydir:keyname -.Op Fl Ar d -.Op Fl Ar v +.Op Fl k Ar keydir:keyname +.Op Fl d +.Op Fl v .Op Ar filename .Sh 解説 .Ic nsupdate は動的な更新をサポートした Internet ドメインネームサーバを更新する ためのプログラムです。 .Ic nsupdate は DNS のリソースレコード (RR) を追加したり削除したりする メッセージを DNS サーバ に伝えるために、DNS リゾルバライブラリを使用します。 .Ic nsupdate は入力を .Ar filename もしくは、標準入力から読み取ります。 .Sh 引数 .Bl -tag -width Fl .It Fl k TSIG を用いて更新に署名します。 .It Fl d デバッグモードを指定します。 .It Fl v バーチャルサーキット - サーバとの通信に TCP を使用します。既定値では UDP を 使用します。 .El .Sh 入力書式 .Ic nsupdate は 1 行ごとに 1 個の入力レコードを読みます。 それぞれの行は更新要求の対象になるリソースレコードです。 1 個の更新要求に含まれるすべてのドメイン名は、 同一の DNS ゾーンに含まれるものであることが必要です。 更新は、SOA MNAME フィールドで定義されるマスタサーバへ送られます。 空行は、蓄積されたレコードを 1 個の更新要求としてまとめ、ゾーンの権威を もつネームサーバへの送信を指示します。 追加レコードを続けることが可能です。 これらは、追加的な、完全に独立した更新要求になります。 最後の要求が送信されるためには、空行が入力の最後にあることが必要です。 .Pp レコードはふたつの一般的な形式のうちのどちらかの形式です。 .Em 必要条件 (prerequisite) レコードは、要求が処理される前に満たされていることが必要な条件を指示します。 .Em 更新情報 (update) レコードは、DNS データベースになされる変更を指示します。 更新要求は、0 個以上の必要条件と、1 個以上の更新情報から成ります。 それぞれの更新要求は、すべての必要条件が満たされることが確認 されたあとで、すべての更新が実行されるという順番で、原子的に処理されます。 .Pp .Ic nsupdate は次のような入力レコードの書式を理解します。 .Pp - .Bl -hang - .It Ic prereq nxdomain Va domain-name .Va domain-name で指定したドメイン内に、どのような RR もないことを要求します。 - .It Ic prereq yxdomain Va domain-name .Va domain-name で指定したドメイン内に、最低 1 個の RR が存在することを要求します。 - .It Xo .Ic prereq nxrrset Va domain-name Op class .Va type .Xc .Va domain-name で指定したドメイン内に .Va type で指定した型の RR が存在しないことを要求します。 - .It Xo .Ic prereq yxrrset .Va domain-name Op class .Va type Op data... .Xc .Va domain-name で指定したドメイン内に、 .Va type で指定した型の RR が存在することを要求します。 .Va data が指定された場合は、正確にチェックが行なわれます。 - .It Xo .Ic update delete -.Va domain-name Op class -.Va Op type Op data... +.Va domain-name Op Va class +.Op Va type Op Va data... .Xc .Va domain-name で指定したドメイン名の RR を削除します。 もし .Va type (と、可能ならば .Va data ) が指定されれば、該当されるレコードだけが削除されます。 - .It Xo .Ic update add -.Va domain-name ttl Op class +.Va domain-name ttl Op Va class .Va type data... .Xc .Va ttl , type , data で指定した RR を追加します。 - .El - .Sh 使用例 下記の例は、 .Ic nsupdate の対話的な使用例を示しています。 あるドメイン名のすべての A レコードを削除して、新しいレコードを 追加することによって、IP アドレスを変更します。 ここでは必要条件が指定されていないので、削除するレコードがなくても新しい レコードが追加されます。 後に続く空行は要求を処理させるために必要であることに注意してください。 .Bd -literal -offset indent $ nsupdate > update delete test.example.com A > update add test.example.com 3600 A 10.1.1.1 > - .Ed .Pp この例では、対象のドメインに A レコードまたは CNAME レコードがない場合に、 CNAME エイリアスがデータベースに追加されます。 .Bd -literal -offset indent $ nsupdate > prereq nxrrset www.example.com A > prereq nxrrset www.example.com CNAME > update add www.example.com 3600 CNAME test.example.com > - .Ed .Pp この例では、nsupdate はディレクトリ "/var/named/keys" に存在するキー "mykey" で署名されます。 .Bd -literal -offset indent $ nsupdate -k /var/named/keys:mykey > update add ftp.example.com 60 A 192.168.5.1 > - .Ed - .Sh 診断 .Bl -hang - .It Qq send error 一般に、権威のあるネームサーバに到達できなかったことを示します。 - .It Qq failed update packet 一般に、ネームサーバが動的更新をサポートしていないためか、認証の失敗のために、 更新を拒否したことを示します。 - .It Qq res_mkupdate: packet size = Va size (また他のメッセージが表示されないとき) 更新は正常に受信されてネームサーバに認証されました。 しかし必要条件が更新を妨げたかもしれません。更新が行なわれているか を確かめる方法は、デバッグモード .Fl ( d ) を使用して、ネームサーバからの応答フィールドを確認するしかありません。 .El .Sh 関連ファイル .Bl -hang .It Pa /etc/resolv.conf -.El ドメイン名とネームサーバのアドレスの初期設定。 +.El .Sh 関連項目 .Xr named 8 , .Xr resolver 3 , .Xr resolver 5 ; RFC-1034, .Dq Domain Names - Concepts and Facilities ; RFC-1035, .Dq Domain Names - Implementation and Specification ; RFC-2136, Dynamic Updates in the Domain Name System. .Sh 作者 Brent Baccala diff --git a/ja_JP.eucJP/man/man8/pciconf.8 b/ja_JP.eucJP/man/man8/pciconf.8 index a90cefd4b6..db0e191ca3 100644 --- a/ja_JP.eucJP/man/man8/pciconf.8 +++ b/ja_JP.eucJP/man/man8/pciconf.8 @@ -1,219 +1,219 @@ -.\" %FreeBSD: src/usr.sbin/pciconf/pciconf.8,v 1.8.2.5 2001/11/27 13:51:39 sheldonh Exp % +.\" %FreeBSD: src/usr.sbin/pciconf/pciconf.8,v 1.8.2.6 2002/05/15 19:29:56 trhodes Exp % .\" Copyright (c) 1997 .\" Stefan Esser . All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" $FreeBSD$ .Dd February 7, 1997 .Dt PCICONF 8 .Os .Sh 名称 .Nm pciconf .Nd PCI バスのための診断ユーティリティ .Sh 書式 .Nm .Fl l Op Fl v .Nm .Fl a Ar selector .Nm .Fl r Ar selector .Op Fl b | Fl h -.Ar reg Ns Op : Ns Ar reg2 +.Ar sel addr Ns Op : Ns Ar addr .Nm .Fl w Ar selector .Op Fl b | Fl h -.Ar reg value +.Ar sel addr Ns Op Ar value .Sh 解説 .Nm コマンドは、 .Pa /dev/pci の .Xr ioctl 2 インタフェースにより提供されている機能への コマンドラインインタフェースを提供します。 .Fl l オプションを付けると、ブート時のプローブにより見つかったすべてのデバイスを 以下の書式で表示します: .Bd -literal foo0@pci0:4:0: class=0x010000 card=0x00000000 chip=0x000f1000 rev=0x01 hdr=0x00 bar0@pci0:5:0: class=0x000100 card=0x00000000 chip=0x88c15333 rev=0x00 hdr=0x00 none0@pci0:6:0: class=0x020000 card=0x00000000 chip=0x802910ec rev=0x00 hdr=0x00 .Ed .Pp .Fl v オプションを指定すると、 .Nm はベンダ/デバイス情報をデータベースからの読み取りを試み、 各デバイスに対してベンダ、デバイス、クラス、サブクラスの 識別文字列を表示します。 .Pp 最初の欄は、デバイス名、ユニット番号、 .Ar セレクタ を表示します。 対象の .Tn PCI デバイスに関して、カーネル内のデバイスの設定がなされていない場合、 デバイス名は .Dq none になります。 設定されていないデバイスのユニット番号は 0 から開始し、 設定されていないデバイスに出会う度に増やされます。 .Ar セレクタ は、このコマンドの他の書式で直接使えるような形で表示されます。 2 番目の欄はクラスコードで、2 桁の 16 進数で表されるクラスバイトと サブクラスバイト、インタフェースバイトからなります。 3 番目の欄は .Tn PCI 規格のリビジョン 2.1 で導入されたサブベンダ ID レジスタの内容です。 今日のほとんどの .Tn PCI カード (2.0) ではこれは 0 となりますが、新しく開発された .Tn PCI カードではそのカード固有の識別コード (unique card identification code) が入れられます。この値は上位 2 バイトのカード ID と、 下位 2 バイトのカードベンダ ID から構成されます。 .Pp 4 番目の欄にはこのカードがどのチップに基づいているか識別する チップデバイス ID が含まれます。この値は上記と同様に二つの フィールドに分けられ、チップとベンダを識別します。 5 番目の欄はチップのリビジョンを表示します。 6 番目の欄はヘッダタイプを示します。 現在割り当てられているヘッダタイプは .Tn PCI - .Tn PCI ブリッジのチップが 1 となる以外はすべて 0 となります。 ヘッダタイプレジスタが 0 となっている .Tn PCI デバイスの最上位ビットがセットされていると、そのデバイスは .Em 多機能 (multi-function) デバイスであり、ひとつのチップにいくつかの (似たものかもしれないし、 まったく異なるものかもしれない) 機能を備えています。 .Pp .Fl l オプションは root ではないユーザが使うことのできる唯一のものです。 .Nm を他の方法で実行するには .Li pci Ns Va bus Ns \&: Ns Va device (オプションで .Li \&: Ns Va function が続きます) という形式で .Ar セレクタ を指定する必要があります。 最後にコロンを付けても構いませんが無視されますので、 .Nm .Fl l の出力の最初の欄をそのまま使うことができます。 すべての番号は 10 進数で表します。 .Pp .Fl a フラグを付けると、 .Ar selector で識別したデバイスになんらかのドライバが割り当てられているかを、 .Nm は判定します。 終了状態 0 はデバイスがドライバを持つことを意味します; 非 0 はデバイスがドライバを持たないことを意味します。 .Pp .Fl r オプションはデバイス .Ar selector のバイトオフセット .Ar reg の所のコンフィギュレーションスペースレジスタ (configuration space register) を読み取り、 その値を 16 進数で表示します。 省略可能な第 2 引数 .Ar reg2 は、読み取る範囲を指定します。 .Fl w オプションはデバイス .Ar selector のバイトオフセット .Ar reg の所のコンフィギュレーションスペースレジスタへ .Ar value を書き込みます。 この二つのオプションでは、 .Fl b フラグと .Fl h フラグで読み書きの大きさを指定できます。 .Fl b は 1 バイトの読み書きを行い、 .Fl h は 2 バイト (halfword) の読み書きを行います。 読み書きの大きさのデフォルトは 4 バイト (longword) です。 .Sh 環境変数 通常、PCI ベンダ/デバイスの情報データベースは、 .Pa /usr/share/misc/pci_vendors から読み込まれます。 環境変数 .Ev PCICONF_VENDOR_DATABASE を設定することにより、このパスを変更可能です。 .Sh 関連項目 .Xr ioctl 2 , .\" .Xr pci 4 , .Xr kldload 8 .Sh 歴史 .Nm コマンドは .Fx 2.2 で初めて登場しました。 .Fl a オプションは .Tn PCI KLD サポートのために .Fx 3.0 で追加されました。 .Sh 作者 .An -nosplit .Nm は .An Stefan Esser と .An Garrett Wollman によって書かれました。 .Sh バグ .Fl b オプションと .Fl h オプションは .Nm の内部で実装されており、 .Fn ioctl 2 に基づいているわけではありません。 .Pp root ではないユーザが .Fl a オプションと .Fl r オプションを使うことを許可することは有用かもしれませんが、 KLD ドライバでデバイスを供給するために .Nm kldload を実行できるのは root だけでしょうし、 一部の粗悪な .Tn PCI チップではコンフィギュレーションスペースレジスタの 読み込みが故障を引き起こす場合があるのです。 diff --git a/ja_JP.eucJP/man/man8/tunefs.8 b/ja_JP.eucJP/man/man8/tunefs.8 index 805df3db65..0b263d903c 100644 --- a/ja_JP.eucJP/man/man8/tunefs.8 +++ b/ja_JP.eucJP/man/man8/tunefs.8 @@ -1,159 +1,165 @@ .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" @(#)tunefs.8 8.2 (Berkeley) 12/11/93 -.\" %FreeBSD: src/sbin/tunefs/tunefs.8,v 1.11.2.4 2002/02/11 02:20:04 dd Exp % +.\" %FreeBSD: src/sbin/tunefs/tunefs.8,v 1.11.2.5 2002/05/13 16:18:14 trhodes Exp % .\" .\" $FreeBSD$ .\" .Dd December 11, 1993 .Dt TUNEFS 8 .Os .Sh 名称 .Nm tunefs .Nd 既存のファイルシステムをチューンする .Sh 書式 .Nm .Op Fl A .Op Fl a Ar maxcontig .Op Fl d Ar rotdelay .Op Fl e Ar maxbpg .Op Fl f Ar avgfilesize .Op Fl m Ar minfree .Bk -words .Op Fl n Ar enable | disable .Op Fl o Ar space | time .Op Fl p .Op Fl s Ar avgfpdir .Ek .Op Ar special | Ar filesystem .Sh 解説 .Nm は、ファイルシステムのレイアウト方針に影響する動的なパラメータを 変更するために使います。変更するパラメータは以下のフラグで指定します: .Bl -tag -width indent .It Fl A ファイルシステムはスーパブロックのバックアップをいくつか持っています。 このオプションを指定すると、全てのバックアップの内容は プライマリスーパブロックと同じく変更されます。 これはかなりの危険を秘めています。実行する時は気をつけて下さい。 .It Fl a Ar maxcontig 回転遅延 ( .Fl d を参照) が強制的に行われる前に連続して配置されるブロック数を指定します。 ほとんどのデバイスドライバはディスク転送のたびに割り込みが必要なので、 デフォルト値は 1 です。 一度の転送でいくつかのバッファをつないで転送できるデバイスドライバでは、 この値を最大の連結長にすべきです。 .It Fl d Ar rotdelay 同じディスクに対する転送完了割り込みサービスと 次の転送を開始する時間の期待値をミリ秒単位で指定します。 この値は、回転遅延によるファイル中のブロック間隔を決めるのに使います。 .It Fl e Ar maxbpg 単一のファイルが他のシリンダグループへまたがる前に、1 つのシリンダグループ から割り当てることのできる最大のブロック数を指定します。 普通は、この値にはシリンダグループのブロック数の約 1/4 が使われます。 この値は、単一のファイルが 1 つのシリンダグループのブロックを使いつくして しまうことを防ぐために指定します。 なぜなら、これによって、そのシリンダグループに続いて配置される すべてのファイルのアクセス速度を低下させてしまうからです。 この制限によって、大きなファイルに対しては 1 つのシリンダに配置するよりも、 長いシークをより頻繁に行わせることがあります。 極端に大きなファイルのあるファイルシステムに対しては、 このパラメータは大きな値にすべきです。 .It Fl f Ar avgfilezsize ファイルサイズの期待値を指定します。 .It Fl m Ar minfree 一般ユーザが利用することができない領域の割合を指定します。 これは最低限の空き領域のしきい値となります。 デフォルト値は 8% です。 この値はゼロにすることもできますが、10% のしきい値を設けた場合と比較し、 アクセスの効率が最大 3 倍まで落ちてしまいます。 5% 以下にすると常に最適化は space 優先になってしまい、 ファイル書き込みのオーバーヘッドがかなり増えます。 もしこの値を現在の空き領域より大きな値に引き上げると、 ファイルを削除してその値を満たすだけの空き領域を用意するまで、 ユーザはファイルを作成することができなくなります。 .It Fl n Ar enable | disable ソフトアップデートをオン/オフします。 ファイルシステムのアンマウントが必要です。 .It Fl o Ar space | time ファイルシステムの最適化において、 ブロック割り当てにかかる時間を最小化するか、 もしくはディスク上のフラグメントサイズを最小にするかの いずれかを選択できます。 space 優先の場合、 ファイル書き込みのオーバヘッドは大きくなります。 カーネルは通常、 ファイルシステムのフラグメントの割合に応じて自動的に優先を変化させます。 .It Fl p このオプションは、 指定されたファイルシステムにおいて現在変更可能な設定のまとめを表示します。 詳細は .Xr dumpfs 8 のマニュアルを参照してください。 .It Fl s Ar avgfpdir ディレクトリあたりのファイル数の期待値を指定します。 .El +.Sh 関連ファイル +.Bl -tag -width /etc/fstab -compact +.It Pa /etc/fstab +これを読み取ることで、 +指定されたマウントポイントに対応するデバイスファイルを決定します。 +.El .Sh 関連項目 .Xr fs 5 , .Xr dumpfs 8 , .Xr newfs 8 .Rs .%A M. McKusick .%A W. Joy .%A S. Leffler .%A R. Fabry .%T "A Fast File System for UNIX" .%J "ACM Transactions on Computer Systems 2" .%N 3 .%P pp 181-197 .%D August 1984 .%O "(reprinted in the BSD System Manager's Manual, SMM:5)" .Re .Sh バグ このプログラムは、 マウントされているファイルシステムに対しても動作すべきです。 スーパブロックはバッファキャッシュ内に保存されていないため、 実行の影響は、それをマウントされていないファイルシステムに 対して実行したときのみ現れます。 ルートファイルシステムをチューンするには、チューン後に再起動する必要が あります。 .\" Take this out and a Unix Demon will dog your steps from now until .\" the time_t's wrap around. .Pp ファイルシステムをチューンする事はできても、ファイルの中身までは チューンできません:-) .Sh 歴史 .Nm コマンドは .Bx 4.2 から登場しました。