.\"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.
.\"
.Dd 1990年3月10日
.Dt DNSQUERY 1
.Os BSD 4
.Sh NAME(名稱)
.Nm dnsquery
.Nd 使用解析程式查詢域名伺服器
.Sh SYNOPSIS(總覽)
.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 DESCRIPTION(描述)
.Ic dnsquery
程式是一個通過BIND解析程式庫調用到域名伺服器的通用接口.
該程式支持使用一些查詢操作碼來查詢域名伺服器.
該程式意在作為程式如nstest,nsquery和nslookup的替換或補充.
所有參數,除了
.Ar host
和
.Ar nameserver
之外都是不區分大小寫的.
.Sh OPTIONS(選項)
.Bl -tag -width Fl
.It Fl n Ar nameserver
查詢中使用的域名伺服器.域名伺服器可以表示為
Internet地址格式
.Ar 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 SOA
起始授權記錄
.It Ar WKS
眾所周知的服務
.It Ar HINFO
主機信息
.It Ar MINFO
郵箱信息
.It Ar MX
郵件網關
.It Ar RP
負責人信息
.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
Internet等級
.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
超時等待的時間周期.(預設情況:
.Dv RES_TIMEOUT . )
.It Fl d
打開調試環境.這會設置
解析程式的
.Ft options
字段的
.Dv RES_DEBUG
位.(預設情況:不作調試.)
.It Fl s
使用
.Em 信息流
而不是信息包的形式.這將對名字伺服器使用TCP流連接,而不是
UDP數據報連接.
它會設置
解析程式的
.Ft options
字段的
.Dv RES_USEVC
位.(預設情況:UDP數據報.)
.It Fl v
與
.Dq Fl s
標識同義.
.It Ar host
所關心的主機(或域)的名字.
.El
.Sh FILES(相關檔案)
.Bl -tag -width "<arpa/nameser.h>  " -compact
.It Pa /etc/resolv.conf 
用來獲取預設的域名伺服器以及搜索列表
.It Pa <arpa/nameser.h>
可用的RR(資源紀錄)的類型和等級的列表
.It Pa <resolv.h>
解析程式標識的列表
.El
.Sh DIAGNOSTICS(診斷)
如果解析程式不能響應查詢,並且調試環境又沒有打開,那麼
.Ic dnsquery
會簡單地顯示如下信息:
.Dl Query failed (rc = 1) : Unknown host
.Pp
返回代碼的值由
.Ft h_errno
提供.
.Sh SEE ALSO(另見)
.Xr nslookup 8 , 
.Xr nstest 1 , 
.Xr nsquery 1 , 
.Xr named 8 , 
.Xr resolver 5 .
.Sh AUTHOR(作者)
Bryan Beecher
.Sh BUGS
除了等級
.Ar IN
之外的查詢會得到有趣的結果,
因為通常名字伺服器只會有針對等級為
.Ar IN
的資源記錄的一組根域名伺服器.
.Pp
.Ic Dnsquery
通過調用
.Fn inet_addr
來確定針對
.Dq Fl n
選項的參數是否為有效的
Internet地址.不幸的是,
.Fn inet_addr
可能會在判別一些(錯誤的)IP地址(如1.2.3.4.5)時引發segmentation(分段)
錯誤.
.Sh "[中文版維護人]"
riser <boomer@ccidnet.com>
.Sh "[中文版最新更新]"
2001/7/13
.Sh "《中國Linux論壇man手冊頁翻譯計劃》"
http://cmpp.linuxforum.net