.\" ++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
.\"
.Dd 1990年8月30日
.Dt DIG 1
.Os BSD 4
.Sh NAME(名稱)
.Nm dig
.Nd 發送域名查詢信息包到域名服務器
.Sh SYNOPSIS(總覽)
.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 DESCRIPTION(描述)
.Ic Dig
(domain information groper 域名信息搜索)是一個靈活的
命令行工具,
它可以用來從域名系統服務器中收集信息.
.Ic Dig
有兩種模式:簡單交互模式
用於簡單的查詢,而批處理模式則可以對
包含多個查詢條目的列表執行查詢.
所有查詢選項都可以從命令行輸入.
.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
可爲域名或者以點分隔的Internet地址.
如果省略該可選字段,
.Ic dig
會嘗試使用你機器的默認域名服務器.
.sp 1
.Em 注意:
如果指定了一個域名,那麼將使用域名系統解析程序
(即BIND)來進行解析.
如果你的系統不支持DNS,那麼可能
.Em 必須
指定一個以點分隔的地址.另外一種選擇是,
如果在你配置的某個地方有一臺這樣的服務器,
那麼你所要做的就是建立
.Pa /etc/resolv.conf
並在其中指明默認域名服務器的位置,這樣
.Ar server
自身就可以解析了.參看
.Xr resolver 5
以獲得
.Pa /etc/resolv.conf
相關的信息.
.Sy 警告:
修改
.Pa /etc/resolv.conf
同樣會對標準的解析程序庫產生影響,而
.Pq 潛在地
某些程序會要用到它.
作爲一種選擇,用戶可設置環境變量
.Ev LOCALRES
爲指定的文件,這將用來取代
.Pa /etc/resolv.conf
.Po Ns Ev LOCALRES
是特定針對
.Ic dig
解析程序的,並不會牽涉到標準解析程序
.Pc .
如果
.Ev LOCALRES
變量未設置或者指定的文件不能讀,那麼就使用
.Pa /etc/resolf.conf .
.It Ar domain
是指一個你請求信息的域名.
參看
.Fl x
選項(在該部分的
.Sx OTHER OPTIONS
節中有介紹)以獲知指定反向地址查詢的便捷方法.
.It Ar query-type
是指你所請求的信息類型(DNS查詢類型).
如果省略,默認爲
.Dq Ar a
.Pq Dv T_A = Ar address .
以下類型是可識別的:
.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
該域的郵件網關
.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 = Ar Internet .
以下的等級是可識別的:
.Pp
.Bl -tag -width "hinfo  T_HINFO   " -compact
.It Ar in\ \ \ \ \  Dv C_IN
Internet等級的域
.It Ar any\ \ \ \  Dv C_ANY
所有/任何等級的信息
.El
.Pp
(參看RFC 1035以獲得完整的列表.)
.Pp
.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
兩次,或者使用
.Fl c
選項(見下面)設置
.Ar query-class .
.El
.Ss OTHER OPTIONS(其它選項)
.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
當運行於批處理模式下時,兩次接着的查詢之間的
時間間隔,以秒計.
可以用來保持兩個或多個批處理
.Ic dig
命令大致同步運行.默認爲零.
.It Fl p Ar port
端口號.通過監聽非標準端口號來查詢
域名服務器.默認爲53.
.It Fl P Ns Bq Ar ping-string
在查詢返回之後,執行一次
.Xr ping 8
命令以獲得響應時間的對照關係.這在調用shell上
顯得不那麼自然.
該命令顯示的最後三行統計信息爲:
.Pp
.Bd -ragged -offset indent-two
.Ic ping Fl s server_name 56 3
.Ed 
.Pp
如果可選的
.Dq Ar ping_string
存在,那麼
會覆蓋shell命令中的
.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
用TSIG密鑰指定的的密鑰名來簽署這次查詢,
該密鑰名在目錄keydir下.
.It Fl envsav
該標識指定
.Ic dig
的環境變量
(默認的,顯示選項,等等.),在所有參數都解釋了之後,
應保存它們到
一個文件中以使之成爲默認的環境變量.
如果你不喜歡默認的標準設置而又不想在每次使用
.Ic dig
時帶大量的選項,那麼這很有用.
環境變量包括解析程序狀態變量標識,超時和重試次數
以及詳細控制
.Ic dig
輸出的標識(見下面).
如果shell環境變量
.Ev LOCALDEF
設置爲一個文件的名字,那麼此即爲默認的
.Ic dig
環境變量所保存的地方.如果沒有,那麼會在當前
工作目錄下創建
.Dq Pa DiG.env .
.Pp
.Em 注意:
.Ev LOCALDEF
是特定針對
.Ic dig
解析程序,
而它不會影響標準解析程序庫的操作.
.Pp
每當
.Ic dig
執行時,它會查找
.Dq Pa ./DiG.env
或者在shell環境變量
.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
環境變量(通過
.Dq Fl envset
開關變量初始化讀入或設置)會在
.Ic dig
批處理文件每次查詢(行)之前重建.
默認的
.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 +
選項的解釋是非常直白的 \(em 值與它的關鍵字之間
千萬不能用空格分隔.
當前可用的關鍵字有:
.Pp
Keyword      Abbrev.  Meaning [default]
.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
保留公開的選項(keep open options)(隱含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
重複(echo)解釋的參數
.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
顯示TTLs(Time to Live)
.Bq Cm tt
.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 Cm pfdef 
設置爲默認顯示位
.It Cm pfmin
設置爲最小的默認顯示位
.It Cm pfset= Ns Ar # 
設置顯示位爲#
(#可以爲十六進制/八進制/十進制)
.It Cm pfand= Ns Ar #
位和顯示位設爲#(bitwise and print flags with #)
.It Cm pfor= Ns Ar #
位或顯示位設爲#(bitwise or print flags with #)
.El
.Pp
當發送數據報查詢時,
.Cm retry
和
.Cm time
選項會影響解析程序庫的重傳策略.其算法如下:
.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 DETAILS(細節)
.Ic Dig
以前要求BIND的
.Xr resolver 3
庫的版本作一些細微的修改.
從BIND 4.9起,BIND的解析程序已經修補好
並可以正常地與
.Ic dig
一起工作.
實質上,
.Ic dig
在解釋參數和設置適合的參數時是
直來直去的
(雖然並不巧妙)
.Ic Dig
會用到
.Xr resolver 3
的例程
.Fn res_init , 
.Fn res_mkquery ,
.Fn res_send 
以及訪問
.Ft _res
結構.
.Sh ENVIRONMENT(環境變量)
.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 FILES(相關文件)
.Bl -tag -width "/etc/resolv.conf  " -compact
.It Pa /etc/resolv.conf	
初始化的域名和域名服務器地址
.It Pa \./DiG.env
默認的保存默認選項的文件
.El
.Sh SEE ALSO(另見)
.Xr named 8 , 
.Xr resolver 3 , 
.Xr resolver 5 ,  
.Xr nslookup 8 . 
.Sh STANDARDS(標準)
RFC 1035.
.Sh AUTHOR(作者)
Steve Hotz 
hotz@isi.edu
.Sh ACKNOWLEDGMENTS(致謝)
.Ic Dig
使用了源自
.Xr nslookup 8
的函數,
其作者爲Andrew Cherenson.
.Sh BUGS
.Ic Dig
是蠕變特色("creeping featurism")的一個
典型實例 -- 這是因在其開發
過程中就考慮到了一些潛在應用而導致的結果.
它可能會從這種嚴格的限定中受益.同樣,
他們設立的顯示位以及條目的間隔尺寸
很明顯地也是一種十分特別的創意.
.Pp
當問題出在解析程序身上時,
.Ic Dig
不會總是能夠正常地退出(在適合的狀況下)
.Po Sy 注意:
絕大多數一般的exit情況是能夠處理的
.Pc .
當運行於批處理模式下時尤其惱火.
如果不能正常退出(又無法俘獲)的話,
那麼整個批處理將終止;如果俘獲了這樣的事件,
.Ic dig
就只是繼續下一個查詢罷了.
.Sh [中文版維護人]
riser <boomer@ccidnet.com>
.Sh [中文版最新更新]
2001/7/19
.Sh "《中國Linux論壇man手冊頁翻譯計劃》"
http://cmpp.linuxforum.net
.Sh "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR