.\"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
.Sh "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR