.\" ++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