draft/man5/host.conf.5

   1 .\" Copyright (c) 1997 Martin Schulze (joey@infodrom.north.de)
   2 .\"
   3 .\" This is free documentation; you can redistribute it and/or
   4 .\" modify it under the terms of the GNU General Public License as
   5 .\" published by the Free Software Foundation; either version 2 of
   6 .\" the License, or (at your option) any later version.
   7 .\"
   8 .\" The GNU General Public License's references to "object code"
   9 .\" and "executables" are to be interpreted as the output of any
  10 .\" document formatting or typesetting system, including
  11 .\" intermediate and printed output.
  12 .\"
  13 .\" This manual is distributed in the hope that it will be useful,
  14 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  15 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16 .\" GNU General Public License for more details.
  17 .\"
  18 .\" You should have received a copy of the GNU General Public
  19 .\" License along with this manual; if not, write to the Free
  20 .\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
  21 .\" USA.
  22 .\"
  23 .\" Much of the text is copied from the manpage of resolv+(8).
  24 .\"
  25 .\" 2003-08-23 Martin Schulze <joey@infodrom.org> Updated according to glibc 2.3.2
  26 .\"
  27 .\" Japanese Version Copyright (c) 2000-2003 Yuichi SATO
  28 .\"         all rights reserved.
  29 .\" Translated Sun Sep 24 06:18:14 JST 2000
  30 .\"         by Yuichi SATO <sato@complex.eng.hokudai.ac.jp>
  31 .\" Updated & Modified Sun Sep  7 17:51:03 JST 2003
  32 .\"         by Yuichi SATO <ysato444@yahoo.co.jp>
  33 .\"
  34 .\"WORD:        method          方式
  35 .\"WORD:        trim            取り去る
  36 .\"WORD:        spoofing        偽装
  37 .\"
  38 .TH HOST.CONF 5 2003-08-23 "Linux" "Linux System Administration"
  39 .\"O .SH NAME
  40 .SH 名前
  41 .\"O host.conf \- resolver configuration file
  42 host.conf \- レゾルバ設定ファイル
  43 .\"O .SH DESCRIPTION
  44 .SH 説明
  45 .\"O The file
  46 .\"O .I /etc/host.conf
  47 .\"O contains configuration information specific to the resolver library.
  48 .\"O It should contain one configuration keyword per line, followed by
  49 .\"O appropriate configuration information.
  50 .\"O The keywords recognized are
  51 .\"O .IR order ", " trim ", " multi ", " nospoof ", " spoof ", and " reorder .
  52 .\"O These keywords are described below.
  53 ファイル
  54 .I /etc/host.conf
  55 には、レゾルバライブラリの詳細な設定情報が含まれている。
  56 このファイルには、1 行毎に 1 つの設定キーワードと
  57 それに続く適切な設定情報がなければならない。
  58 認識されるキーワードは
  59 .IR order ", " trim ", " multi ", " nospoof ", " spoof ", " reorder
  60 である。
  61 各キーワードを、以下で説明する。
  62 .TP
  63 .I order
  64 .\"O This keyword specifies how host lookups are to be performed.
  65 .\"O It should be followed by one or more lookup methods, separated by commas.
  66 .\"O Valid methods are
  67 .\"O .IR bind ", " hosts ", and " nis .
  68 このキーワードは、ホストのルックアップ方式を指定する。
  69 このキーワードの後には、コンマで分けた
  70 1 つ以上のルックアップ方式が続かなくてはならない。
  71 使用可能な方式は
  72 .IR bind ", " hosts ", " nis
  73 である。
  74 .TP
  75 .I trim
  76 .\"O This keyword may be listed more than once.
  77 .\"O Each time it should be
  78 .\"O followed by a list of domains, separated by colons (\(aq:\(aq), semicolons
  79 .\"O (\(aq;\(aq) or commas (\(aq,\(aq), with the leading dot.
  80 .\"O When set, the
  81 .\"O resolv+ library will automatically trim the given domain name from the
  82 .\"O end of any hostname resolved via DNS.
  83 .\"O This is intended for use with
  84 .\"O local hosts and domains.
  85 .\"O (Related note: trim will not affect hostnames
  86 .\"O gathered via NIS or the hosts file.
  87 .\"O Care should be taken to
  88 .\"O ensure that the first hostname for each entry in the hosts file is
  89 .\"O fully qualified or unqualified, as appropriate for the local
  90 .\"O installation.)
  91 このキーワードは、2 回以上リストすることができる。
  92 毎回、このキーワードの後には、
  93 ドットではじまる 1 つ以上のドメイン名のリストを続けなければならない。
  94 ドメイン名はコロン (\(aq:\(aq)、セミコロン (\(aq;\(aq)、コンマ (\(aq,\(aq)
  95 で区切る。
  96 このキーワードが設定されると、resolv+ ライブラリは DNS でレゾルブされた
  97 すべてのホスト名の後ろから与えられたドメイン名を自動的に取り去る。
  98 このキーワードはローカルなホストとドメインで使用することを意図している。
  99 (関連した注意 : NIS または hosts ファイルで集められたホスト名に
 100 trim は影響しない。
 101 hosts ファイルの各エントリの最初のホスト名を、
 102 完全なドメイン名付きのものにするかしないかは、
 103 ホストごとのインストールポリシーにあわせて
 104 適切に選択する必要がある。注意すること。)
 105 .TP
 106 .I multi
 107 .\"O Valid values are
 108 .\"O .IR on " and " off .
 109 .\"O If set to
 110 .\"O .IR on ,
 111 .\"O the resolv+ library will return all valid addresses for a host that
 112 .\"O appears in the
 113 .\"O .I /etc/hosts
 114 .\"O file,
 115 .\"O instead of only the first.
 116 .\"O This is
 117 .\"O .I off
 118 .\"O by default, as it may cause a substantial performance loss at sites
 119 .\"O with large hosts files.
 120 有効な値は
 121 .IR on " と " off
 122 である。
 123 .I on
 124 に設定された場合、最初のエントリのみを例外として、
 125 resolv+ ライブラリは
 126 .I /etc/hosts
 127 ファイルに現れるホストに対して全ての有効なアドレスを返そうとする。
 128 大きな hosts ファイルを持つサイトでは、
 129 この設定は非常な性能の低下を招くので、
 130 デフォルトでは
 131 .I off
 132 である。
 133 .TP
 134 .I nospoof
 135 .\"O Valid values are
 136 .\"O .IR on " and " off .
 137 .\"O If set to
 138 .\"O .IR on ,
 139 .\"O the resolv+ library will attempt to prevent hostname spoofing to
 140 .\"O enhance the security of
 141 .\"O .BR rlogin " and " rsh .
 142 .\"O It works as follows: after performing a host address lookup, resolv+
 143 .\"O will perform a hostname lookup for that address.
 144 .\"O If the two hostnames
 145 .\"O do not match, the query will fail.
 146 有効な値は
 147 .IR on " と " off
 148 である。
 149 .I on
 150 に設定された場合、resolv+ ライブラリは
 151 .BR rlogin " と " rsh
 152 のセキュリティを向上させるためホスト名の偽装を防止しようとする。
 153 これは、「ホストアドレスのルックアップを行った後、
 154 resolv+ はそのアドレスに対してホスト名のルックアップを行い、
 155 もし 2 つのホスト名が一致しなかった場合は、クエリーは失敗する。」
 156 というように動作する。
 157 .\"O The default value is
 158 .\"O .IR off .
 159 デフォルトの値は
 160 .I off
 161 である。
 162 .TP
 163 .I spoofalert
 164 .\"O Valid values are
 165 .\"O .IR on " and " off .
 166 有効な値は
 167 .IR on " と " off
 168 である。
 169 .\"O If this option is set to
 170 .\"O .I on
 171 .\"O and the
 172 .\"O .I nospoof
 173 .\"O option is also set, resolv+ will log a warning of the error via the
 174 .\"O syslog facility.
 175 .\"O The default value is
 176 .\"O .IR off .
 177 このオプションが
 178 .I on
 179 に設定されていて、
 180 .I nospoof
 181 オプションも (on に) 設定されている場合、
 182 resolv+ は syslog 機能を通じてエラーに関する警告のログをとる。
 183 デフォルトの値は
 184 .I off
 185 である。
 186 .TP
 187 .I spoof
 188 .\"O Valid values are
 189 .\"O .IR off ", " nowarn " and " warn .
 190 有効な値は
 191 .IR off ", " nowarn ", " warn
 192 である。
 193 .\"O If this option is set to
 194 .\"O .IR off ,
 195 .\"O spoofed addresses are permitted and no warnings will be emitted
 196 .\"O via the syslog facility.
 197 このオプションを
 198 .I off
 199 に設定すると、偽装されたアドレスを許可して、
 200 syslog 機能を通じた警告を発しない。
 201 .\"O If this option is set to
 202 .\"O .IR warn ,
 203 .\"O resolv+ will attempt to prevent hostname spoofing to
 204 .\"O enhance the security and log a warning of the error via the syslog
 205 .\"O facility.
 206 このオプションを
 207 .I warn
 208 に設定すると、resolv+ はセキュリティを高めるためにホスト名の偽装を防止し、
 209 syslog 機能を通じてエラーに関する警告のログをとる。
 210 .\"O If this option is set to
 211 .\"O .IR nowarn ,
 212 .\"O the resolv+ library will attempt to prevent hostname spoofing to
 213 .\"O enhance the security but not emit warnings via the syslog facility.
 214 このオプションを
 215 .I nowarn
 216 に設定すると、resolv+ はセキュリティを高めるためにホスト名の偽装を防止するが、
 217 syslog 機能を通じた警告は発しない。
 218 .\"O Setting this option to anything else is equal to setting it to
 219 .\"O .IR nowarn .
 220 このオプションを何も設定しない場合は、
 221 .I nowarn
 222 を設定したのと同じになる。
 223 .TP
 224 .I reorder
 225 .\"O Valid values are
 226 .\"O .IR on " and " off .
 227 .\"O If set to
 228 .\"O .IR on ,
 229 .\"O resolv+ will attempt to reorder host addresses so that local addresses
 230 .\"O (i.e., on the same subnet) are listed first when a
 231 .\"O .BR gethostbyname (3)
 232 .\"O is performed.
 233 .\"O Reordering is done for all lookup methods.
 234 .\"O The default
 235 .\"O value is
 236 .\"O .IR off .
 237 有効な値は
 238 .IR on " と " off
 239 である。
 240 .I on
 241 に設定されると、
 242 .B gethostbyname (3)
 243 が実行されるとき、resolv+ ライブラリは、ローカルな
 244 (つまり、同じサブネットにある) アドレスが最初にリストされるように
 245 ホストアドレスを並べ変える。
 246 すべてのルックアップ方式に対して並べ変えが行われる。
 247 デフォルトの値は、
 248 .I off
 249 である。
 250 .\"O .SH ENVIRONMENT
 251 .SH 環境変数
 252 .\"O There are six environment variables that can be used to allow users to
 253 .\"O override the behavior which is configured in
 254 .\"O .IR /etc/host.conf .
 255 .I /etc/host.conf
 256 で設定されている動作を、ユーザが上書きできる 6 つの環境変数がある。
 257 .TP
 258 .B RESOLV_HOST_CONF
 259 .\"O If set this variable points to a file that should be read instead of
 260 .\"O .IR /etc/host.conf .
 261 この変数を設定すると、
 262 .I /etc/host.conf
 263 の代りに読み込むファイルを設定できる。
 264 .TP
 265 .B RESOLV_SERV_ORDER
 266 .\"O Overrides the
 267 .\"O .I order
 268 .\"O command.
 269 .I order
 270 コマンドを上書きする。
 271 .TP
 272 .B RESOLV_SPOOF_CHECK
 273 .\"O Overrides the
 274 .\"O .IR nospoof ", " spoofalert " and " spoof
 275 .\"O commands in the same way as the
 276 .\"O .I spoof
 277 .\"O command is parsed.
 278 .\"O Valid values are
 279 .\"O .IR off ", " nowarn " and " warn .
 280 .I spoof
 281 コマンドを解析するのと同じ方式で、
 282 .IR nospoof ", " spoofalert ", " spoof
 283 コマンドを上書きできる。
 284 有効な値は
 285 .IR off ", " nowarn ", " warn
 286 である。
 287 .TP
 288 .B RESOLV_MULTI
 289 .\"O Overrides the
 290 .\"O .I multi
 291 .\"O command.
 292 .I multi
 293 コマンドを上書きする。
 294 .TP
 295 .B RESOLV_REORDER
 296 .\"O Overrides the
 297 .\"O .I reorder
 298 .\"O command.
 299 .I reorder
 300 コマンドを上書きする。
 301 .TP
 302 .B RESOLV_ADD_TRIM_DOMAINS
 303 .\"O A list of domains,  separated by colons (\(aq:\(aq), semicolons (\(aq;\(aq) or
 304 .\"O commas (\(aq,\(aq), with the leading dot, which will be added to the list of
 305 .\"O domains that should be trimmed.
 306 コロン (\(aq:\(aq)、セミコロン (\(aq;\(aq)、コンマ (\(aq,\(aq) で区切った
 307 ドット (\(aq.\(aq) で始まるドメイン名のリスト。
 308 ホスト名から取り去るドメイン名のリストに追加する。
 309 .TP
 310 .B RESOLV_OVERRIDE_TRIM_DOMAINS
 311 .\"O A list of domains,  separated by colons (\(aq:\(aq), semicolons (\(aq;\(aq) or
 312 .\"O commas (\(aq,\(aq), with the leading dot, which will replace the list of
 313 .\"O domains that should be trimmed.
 314 .\"O Overrides the
 315 .\"O .I trim
 316 .\"O command.
 317 コロン (\(aq:\(aq)、セミコロン (\(aq;\(aq)、コンマ (\(aq,\(aq) で区切った
 318 ドット (\(aq.\(aq) で始まるドメイン名のリスト。
 319 ホスト名から取り去るドメイン名のリストを上書きする。
 320 .I trim
 321 コマンドを上書きする。
 322 .\"O .SH FILES
 323 .SH ファイル
 324 .TP
 325 .I /etc/host.conf
 326 .\"O Resolver configuration file
 327 リゾルバ設定ファイル
 328 .TP
 329 .I /etc/resolv.conf
 330 .\"O Resolver configuration file
 331 リゾルバ設定ファイル
 332 .TP
 333 .I /etc/hosts
 334 .\"O Local hosts database
 335 ローカルの hosts データベース
 336 .\"O .SH NOTES
 337 .SH 注意
 338 .\"O The following differences exist compared to the original implementation.
 339 元々の実装に比べて以下のような違いがある。
 340 .\"O A new command
 341 .\"O .I spoof
 342 .\"O and a new environment variable
 343 .\"O .B RESOLV_SPOOF_CHECK
 344 .\"O can take arguments like
 345 .\"O .IR off ", " nowarn " and " warn .
 346 新しいコマンド
 347 .I spoof
 348 と新しい環境変数
 349 .B RESOLV_SPOOF_CHECK
 350 は、引き数
 351 .IR off ", " nowarn ", " warn
 352 をとる。
 353 .\"O Line comments can appear anywhere and not only at the beginning of a line.
 354 コメントは行頭だけではなく、どこに書いてもよい。
 355 .\"O .SH SEE ALSO
 356 .SH 関連項目
 357 .BR gethostbyname (3),
 358 .BR hostname (7),
 359 .BR named (8),
 360 .BR resolv+ (8)