aboutsummaryrefslogtreecommitdiff
path: root/ja_JP.eucJP/man/man1/dnsquery.1
blob: 37f00f5d4186e739ed4e8b1db969dfdfbe9b122c (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
.\" %Id: dnsquery.1,v 8.3 1999/01/08 18:54:21 vixie 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.
.\"
.\" jpman %Id: dnsquery.1,v 1.3 1997/08/20 12:21:56 horikawa Stab %
.\"
.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 SOA	
権威の開始 (Start of Authority)
.It Ar WKS	
よく知られたサービス (well-known service)
.It Ar HINFO
ホスト情報
.It Ar MINFO
メールボックス情報
.It Ar MX	
メールエクスチェンジ (mail exchange)
.It Ar RP	
責任者 (responsible person)
.It Ar MG	
メールグループメンバ
.It Ar AFSDB	
DCE または AFS サーバ
.It Ar ANY	
ワイルドカード
.El
.Pp
大文字小文字どちらでも使用できます。(デフォルト: 
.Ar ANY
)。
.It Fl c Ar class
関心あるリソースレコードのクラス。クラスには以下のものがあります:
.Bl -tag -width "CHAOS  " -compact -offset indent
.It Ar IN	
インターネット
.It Ar HS	
Hesiod
.It Ar CHAOS
Chaos
.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 "<arpa/nameser.h>  " -compact
.It Pa /etc/resolv.conf
デフォルトのネームサーバと検索リスト
.It Pa <arpa/nameser.h> 	
利用できる RR タイプとクラスの一覧
.It Pa <resolv.h>		
リゾルバのフラグ一覧
.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)に
対してセグメンテーションフォールトを起こすことがあるようです。