'\" t
.TH "SYSTEMD\-RESOLVE" "1" "" "systemd 231" "systemd-resolve"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
systemd-resolve \- 解析主機名、IP地址、域名、DNS資源記錄、服務
.SH "SYNOPSIS"
.HP \w'\fBsystemd\-resolve\fR\ 'u
\fBsystemd\-resolve\fR [OPTIONS...] \fIHOSTNAME\fR...
.HP \w'\fBsystemd\-resolve\fR\ 'u
\fBsystemd\-resolve\fR [OPTIONS...] \fIADDRESS\fR...
.HP \w'\fBsystemd\-resolve\fR\ 'u
\fBsystemd\-resolve\fR [OPTIONS...] \-\-type=\fITYPE\fR \fIDOMAIN\fR...
.HP \w'\fBsystemd\-resolve\fR\ 'u
\fBsystemd\-resolve\fR [OPTIONS...] \-\-service [[\fINAME\fR]\ \fITYPE\fR]\ \fIDOMAIN\fR 
.HP \w'\fBsystemd\-resolve\fR\ 'u
\fBsystemd\-resolve\fR [OPTIONS...] \-\-openpgp \fIUSER@DOMAIN\fR
.HP \w'\fBsystemd\-resolve\fR\ 'u
\fBsystemd\-resolve\fR [OPTIONS...] \-\-tlsa \fIDOMAIN\fR\fI[:PORT]\fR
.HP \w'\fBsystemd\-resolve\fR\ 'u
\fBsystemd\-resolve\fR [OPTIONS...] \-\-statistics
.HP \w'\fBsystemd\-resolve\fR\ 'u
\fBsystemd\-resolve\fR [OPTIONS...] \-\-reset\-statistics
.SH "描述"
.PP
\fBsystemd\-resolve\fR
利用
\fBsystemd-resolved.service\fR(8)
系統服務解析主機名、IP地址、域名、DNS資源記錄、服務。 預設情況下，引數列表將被視為域名/主機名的列表，程式的輸出將是它們所對應的 IPv4 或 IPv6 地址。 如果引數符合 IPv4 或 IPv6 格式，那麼表示反解析IP地址所對應的主機名。
.PP
程式的輸出包括查詢所使用的協議與網路介面， 還包括查詢到的資訊是否是可靠的。 所有透過 DNSSEC 認證的資訊將被視為是可靠的， 所有從本地可信源獲取的資訊也被視為是可靠的， 包括對本機主機名的解析、特殊的
"localhost"
主機名、所有來自
/etc/hosts
中的結果。
.PP
\fB\-\-type=\fR
用於指定僅查詢特定型別的DNS資源記錄(A, AAAA, SOA, MX, \&.\&.\&.)， 而不是預設的地址解析/反解析。 特殊值
"help"
可用於列出所有可用的記錄型別。
.PP
\fB\-\-service\fR
用於解析
\m[blue]\fBSRV\fR\m[]\&\s-2\u[1]\d\s+2
與
\m[blue]\fBDNS\-SD\fR\m[]\&\s-2\u[2]\d\s+2
服務(見下文)。 需要一至三個引數。如果指定了三個引數，那麼第一個是 DNS\-SD 服務名， 第二個是 SRV 服務型別，第三個是要查詢的域。在這種情況下，將會執行一次完整的 DNS\-SD 風格的 SRV 與 TXT 查詢。 如果只指定了二個引數，那麼第一個是 SRV 服務型別， 第二個是要查詢的域。在這種情況下，將省略 TXT 查詢。最後，如果只指定了一個引數， 那麼該引數將被視為域名，並且已經加上了 SRV 型別字首。在這種情況下，將會執行一個 SRV 查詢(不含 TXT)
.PP
\fB\-\-openpgp\fR
用於查詢儲存在DNS的
\m[blue]\fBOPENPGPKEY\fR\m[]\&\s-2\u[3]\d\s+2
型別的資源記錄中的 PGP 公鑰。 需要指定至少一個Email地址。
.PP
\fB\-\-tlsa\fR
用於查詢儲存在DNS的
\m[blue]\fBTLSA\fR\m[]\&\s-2\u[4]\d\s+2
型別的資源記錄中的 TLS 公鑰。 需要指定至少一個域名。
.PP
\fB\-\-statistics\fR
用於顯示解析統計， 包括 DNSSEC 驗證成功與失敗的數量。
.PP
\fB\-\-reset\-statistics\fR
用於重置各種解析統計的計數器， 包括所有
\fB\-\-statistics\fR
輸出的統計資料。此操作需要超級使用者許可權。
.SH "選項"
.PP
\fB\-4\fR, \fB\-6\fR
.RS 4
在解析主機名時，默認同時查詢 IPv4 與 IPv6 地址。 使用
\fB\-4\fR
表示僅查詢 IPv4 地址， 使用
\fB\-6\fR
表示僅查詢 IPv6 地址。
.RE
.PP
\fB\-i\fR \fIINTERFACE\fR, \fB\-\-interface=\fR\fIINTERFACE\fR
.RS 4
指定使用哪個網路介面。 可以使用網絡卡的數字序號，也可以使用例如
"en0"
這樣的網絡卡名稱。 注意，在使用全域性DNS(位於
/etc/resolv\&.conf
與
/etc/systemd/resolve\&.conf) 的時候，此選項沒有效果。
.RE
.PP
\fB\-p\fR \fIPROTOCOL\fR, \fB\-\-protocol=\fR\fIPROTOCOL\fR
.RS 4
指定查詢所用的協議。可以設為下列四個值之一：
"dns"(經典的單播DNS)、
"llmnr"(\m[blue]\fBLink\-Local Multicast Name Resolution\fR\m[]\&\s-2\u[5]\d\s+2)、
"llmnr\-ipv4"
、
"llmnr\-ipv6"
。 預設使用所有適合的協議。 可以多次使用此選項以指定多個查詢協議。 注意：(1)設定
"llmnr"
等價於同時設定
"llmnr\-ipv4"
與
"llmnr\-ipv6"
。(2)此選項並不強制
\fBsystemd-resolved.service\fR(8)
必須使用指定的查詢協議，因為某個必需的網路介面與相應的配置可能不存在。 (3)特殊值
"help"
可用於列出所有可用的協議。
.RE
.PP
\fB\-t\fR \fITYPE\fR, \fB\-\-type=\fR\fITYPE\fR, \fB\-c\fR \fICLASS\fR, \fB\-\-class=\fR\fICLASS\fR
.RS 4
指定查詢的DNS資源記錄的 type(A, AAAA, MX, \&...) 與 class(IN, ANY, \&...)。 如果使用了此選項，那麼僅查詢與指定的 type/class 匹配的DNS資源記錄。 如果僅指定了 type 的話，那麼 class 的預設值是"IN"。 特殊值
"help"
可用於列出所有可用的值。
.RE
.PP
\fB\-\-service\fR
.RS 4
根據指定的引數列表，開啟 DNS\-SD 與 簡單 SRV 服務解析。 詳見前文。
.RE
.PP
\fB\-\-service\-address=\fR\fIBOOL\fR
.RS 4
預設值 yes 表示在使用
\fB\-\-service\fR
查詢服務時，同時也解析包含在 SRV 資源記錄內的主機名。
.RE
.PP
\fB\-\-service\-txt=\fR\fIBOOL\fR
.RS 4
預設值 yes 表示在使用
\fB\-\-service\fR
查詢 DNS\-SD 服務時，同時也解析 TXT 服務元資料記錄。
.RE
.PP
\fB\-\-openpgp\fR
.RS 4
查詢儲存在DNS的 OPENPGPKEY 型別的資源記錄中的 PGP 公鑰(參見前文)。 指定的Email地址將被轉換為對應的DNS域名，並打印出所有 OPENPGPKEY 公鑰。
.RE
.PP
\fB\-\-tlsa\fR
.RS 4
為每一個帶有 port 與 family 字首的名字 ("_\fIport\fR\&._\fIfamily\fR\&.\fIdomain\fR") 查詢儲存在DNS的 TLSA 型別的資源記錄中的 TLS 公鑰(參見前文)。 埠號可以明確的寫在冒號(:)之後， 否則將使用預設的
\fB443\fR
埠。 family 可以作為
\fB\-\-tlsa\fR
的引數指定，否則將使用預設值
\fBtcp\fR
。
.RE
.PP
\fB\-\-cname=\fR\fIBOOL\fR
.RS 4
預設值 yes 表示追蹤 DNS 的 CNAME 或 DNAME 重定向。 否則，在接收到 CNAME 或 DNAME 應答後，直接返回錯誤。
.RE
.PP
\fB\-\-search=\fR\fIBOOL\fR
.RS 4
預設值 yes 表示所有不含"\&."的主機名都將在搜尋域列表(若非空)中進行搜尋。
.RE
.PP
\fB\-\-raw\fR[=payload|packet]
.RS 4
以原始的二進位制格式顯示應答的資料。
"payload"(預設值)表示匯出資料包的荷載。
"packet"
表示匯出原始的資料幀，並在前面加上一個小端序形式表示的64位整數。 此選項僅用於除錯目的。
.RE
.PP
\fB\-\-legend=\fR\fIBOOL\fR
.RS 4
預設值 yes 表示顯示應答內容的標題頭與元資料。
.RE
.PP
\fB\-\-statistics\fR
.RS 4
顯示解析統計，包括 DNSSEC 是否可用， 以及 DNSSEC 驗證成功與失敗的數量。
.RE
.PP
\fB\-\-reset\-statistics\fR
.RS 4
重置各種解析統計的計數器，包括所有
\fB\-\-statistics\fR
輸出的統計資料。此操作需要超級使用者許可權。
.RE
.PP
\fB\-\-flush\-caches\fR
.RS 4
重新整理本地DNS資源記錄快取。
.RE
.PP
\fB\-\-status\fR
.RS 4
顯示全域性DNS設定、以及針對每個連線的DNS設定。
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
顯示簡短的幫助資訊並退出。
.RE
.PP
\fB\-\-version\fR
.RS 4
顯示簡短的版本資訊並退出。
.RE
.PP
\fB\-\-no\-pager\fR
.RS 4
不將程式的輸出內容管道(pipe)給分頁程式。
.RE
.SH "例子"
.PP
\fBExample\ \&1.\ \&解析 "www\&.0pointer\&.net" 域名所對應的地址\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ systemd\-resolve www\&.0pointer\&.net
www\&.0pointer\&.net: 2a01:238:43ed:c300:10c3:bcf3:3266:da74
                  85\&.214\&.157\&.71

\-\- Information acquired via protocol DNS in 611\&.6ms\&.
\-\- Data is authenticated: no
.fi
.if n \{\
.RE
.\}
.PP
\fBExample\ \&2.\ \&反解析 "85\&.214\&.157\&.71" 地址所對應的域名\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ systemd\-resolve 85\&.214\&.157\&.71
85\&.214\&.157\&.71: gardel\&.0pointer\&.net

\-\- Information acquired via protocol DNS in 1\&.2997s\&.
\-\- Data is authenticated: no
.fi
.if n \{\
.RE
.\}
.PP
\fBExample\ \&3.\ \&查詢 "0pointer\&.net" 域名的 MX 記錄\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ systemd\-resolve \-t MX yahoo\&.com \-\-legend=no
yahoo\&.com\&. IN MX    1 mta7\&.am0\&.yahoodns\&.net
yahoo\&.com\&. IN MX    1 mta6\&.am0\&.yahoodns\&.net
yahoo\&.com\&. IN MX    1 mta5\&.am0\&.yahoodns\&.net
.fi
.if n \{\
.RE
.\}
.PP
\fBExample\ \&4.\ \&查詢一個 SRV 服務\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ systemd\-resolve \-\-service _xmpp\-server\&._tcp gmail\&.com
_xmpp\-server\&._tcp/gmail\&.com: alt1\&.xmpp\-server\&.l\&.google\&.com:5269 [priority=20, weight=0]
                             173\&.194\&.210\&.125
                             alt4\&.xmpp\-server\&.l\&.google\&.com:5269 [priority=20, weight=0]
                             173\&.194\&.65\&.125
                             \&.\&.\&.
.fi
.if n \{\
.RE
.\}
.PP
\fBExample\ \&5.\ \&查詢一個 PGP 公鑰\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ systemd\-resolve \-\-openpgp zbyszek@fedoraproject\&.org
d08ee310438ca124a6149ea5cc21b6313b390dce485576eff96f8722\&._openpgpkey\&.fedoraproject\&.org\&. IN OPENPGPKEY
        mQINBFBHPMsBEACeInGYJCb+7TurKfb6wGyTottCDtiSJB310i37/6ZYoeIay/5soJjlMyf
        MFQ9T2XNT/0LM6gTa0MpC1st9LnzYTMsT6tzRly1D1UbVI6xw0g0vE5y2Cjk3xUwAynCsSs
        \&.\&.\&.
.fi
.if n \{\
.RE
.\}
.PP
\fBExample\ \&6.\ \&查詢一個 TLS 公鑰 (可以省略 "=tcp" 與 ":443")\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ systemd\-resolve \-\-tlsa=tcp fedoraproject\&.org:443
_443\&._tcp\&.fedoraproject\&.org IN TLSA 0 0 1 19400be5b7a31fb733917700789d2f0a2471c0c9d506c0e504c06c16d7cb17c0
        \-\- Cert\&. usage: CA constraint
        \-\- Selector: Full Certificate
        \-\- Matching type: SHA\-256
.fi
.if n \{\
.RE
.\}
.SH "參見"
.PP
\fBsystemd\fR(1),
\fBsystemd-resolved.service\fR(8)
.SH "NOTES"
.IP " 1." 4
SRV
.RS 4
\%https://tools.ietf.org/html/rfc2782
.RE
.IP " 2." 4
DNS-SD
.RS 4
\%https://tools.ietf.org/html/rfc6763
.RE
.IP " 3." 4
OPENPGPKEY
.RS 4
\%https://tools.ietf.org/html/draft-wouters-dane-openpgp-02
.RE
.IP " 4." 4
TLSA
.RS 4
\%https://tools.ietf.org/html/rfc6698
.RE
.IP " 5." 4
Link-Local Multicast Name Resolution
.RS 4
\%https://tools.ietf.org/html/rfc4795
.RE
.SH "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.PP
翻譯人員：金步國
.br
金步國作品集：http://www.jinbuguo.com
.br
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR