Man page - systemd-resolve(1)
Manual
SYSTEMD-RESOLVE
NAMESYNOPSIS
描 述
選 項
例 子
參 見
NOTES
跋
NAME
systemd-resolve - 解 析 主 機 名 、 IP地 址 、 域 名 、 DNS資 源 記 錄 、 服 務
SYNOPSIS
|
systemd-resolve [OPTIONS...] HOSTNAME ... |
||
|
systemd-resolve [OPTIONS...] ADDRESS ... |
||
|
systemd-resolve [OPTIONS...] --type= TYPE DOMAIN ... |
||
|
systemd-resolve [OPTIONS...] --service [[ NAME ] TYPE ] DOMAIN |
||
|
systemd-resolve [OPTIONS...] --openpgp USER@DOMAIN |
||
|
systemd-resolve [OPTIONS...] --tlsa DOMAIN[:PORT] |
||
|
systemd-resolve [OPTIONS...] --statistics |
||
|
systemd-resolve [OPTIONS...] --reset-statistics |
描 述
systemd-resolve 利 用 systemd-resolved.service (8) 系 統 服 務 解 析 主 機 名 、 IP地 址 、 域 名 、 DNS資 源 記 錄 、 服 務 。 預 設 情 況 下 ， 引 數 列 表 將 被 視 為 域 名 /主 機 名 的 列 表 ， 程 式 的 輸 出 將 是 它 們 所 對 應 的 IPv4 或 IPv6 地 址 。 如 果 引 數 符 合 IPv4 或 IPv6 格 式 ， 那 麼 表 示 反 解 析 IP地 址 所 對 應 的 主 機 名 。
程 式 的 輸 出 包 括 查 詢 所 使 用 的 協 議 與 網 路 介 面 ， 還 包 括 查 詢 到 的 資 訊 是 否 是 可 靠 的 。 所 有 透 過 DNSSEC 認 證 的 資 訊 將 被 視 為 是 可 靠 的 ， 所 有 從 本 地 可 信 源 獲 取 的 資 訊 也 被 視 為 是 可 靠 的 ， 包 括 對 本 機 主 機 名 的 解 析 、 特 殊 的 "localhost" 主 機 名 、 所 有 來 自 /etc/hosts 中 的 結 果 。
--type= 用 於 指 定 僅 查 詢 特 定 型 別 的 DNS資 源 記 錄 (A, AAAA, SOA, MX, ...)， 而 不 是 預 設 的 地 址 解 析 /反 解 析 。 特 殊 值 "help" 可 用 於 列 出 所 有 可 用 的 記 錄 型 別 。
--service 用 於 解 析 SRV [1] 與 DNS-SD [2] 服 務 (見 下 文 )。 需 要 一 至 三 個 引 數 。 如 果 指 定 了 三 個 引 數 ， 那 麼 第 一 個 是 DNS-SD 服 務 名 ， 第 二 個 是 SRV 服 務 型 別 ， 第 三 個 是 要 查 詢 的 域 。 在 這 種 情 況 下 ， 將 會 執 行 一 次 完 整 的 DNS-SD 風 格 的 SRV 與 TXT 查 詢 。 如 果 只 指 定 了 二 個 引 數 ， 那 麼 第 一 個 是 SRV 服 務 型 別 ， 第 二 個 是 要 查 詢 的 域 。 在 這 種 情 況 下 ， 將 省 略 TXT 查 詢 。 最 後 ， 如 果 只 指 定 了 一 個 引 數 ， 那 麼 該 引 數 將 被 視 為 域 名 ， 並 且 已 經 加 上 了 SRV 型 別 字 首 。 在 這 種 情 況 下 ， 將 會 執 行 一 個 SRV 查 詢 (不 含 TXT)
--openpgp 用 於 查 詢 儲 存 在 DNS的 OPENPGPKEY [3] 型 別 的 資 源 記 錄 中 的 PGP 公 鑰 。 需 要 指 定 至 少 一 個 Email地 址 。
--tlsa 用 於 查 詢 儲 存 在 DNS的 TLSA [4] 型 別 的 資 源 記 錄 中 的 TLS 公 鑰 。 需 要 指 定 至 少 一 個 域 名 。
--statistics 用 於 顯 示 解 析 統 計 ， 包 括 DNSSEC 驗 證 成 功 與 失 敗 的 數 量 。
--reset-statistics 用 於 重 置 各 種 解 析 統 計 的 計 數 器 ， 包 括 所 有 --statistics 輸 出 的 統 計 資 料 。 此 操 作 需 要 超 級 使 用 者 許 可 權 。
選 項
-4 , -6
在 解 析 主 機 名 時 ， 默 認 同 時 查 詢 IPv4 與 IPv6 地 址 。 使 用 -4 表 示 僅 查 詢 IPv4 地 址 ， 使 用 -6 表 示 僅 查 詢 IPv6 地 址 。
-i INTERFACE , --interface= INTERFACE
指 定 使 用 哪 個 網 路 介 面 。 可 以 使 用 網 絡 卡 的 數 字 序 號 ， 也 可 以 使 用 例 如 "en0" 這 樣 的 網 絡 卡 名 稱 。 注 意 ， 在 使 用 全 域 性 DNS(位 於 /etc/resolv.conf 與 /etc/systemd/resolve.conf) 的 時 候 ， 此 選 項 沒 有 效 果 。
-p PROTOCOL , --protocol= PROTOCOL
指 定 查 詢 所 用 的 協 議 。 可 以 設 為 下 列 四 個 值 之 一 ： "dns"(經 典 的 單 播 DNS)、 "llmnr"( Link-Local Multicast Name Resolution [5] )、 "llmnr-ipv4" 、 "llmnr-ipv6" 。 預 設 使 用 所 有 適 合 的 協 議 。 可 以 多 次 使 用 此 選 項 以 指 定 多 個 查 詢 協 議 。 注 意 ： (1)設 定 "llmnr" 等 價 於 同 時 設 定 "llmnr-ipv4" 與 "llmnr-ipv6" 。 (2)此 選 項 並 不 強 制 systemd-resolved.service (8) 必 須 使 用 指 定 的 查 詢 協 議 ， 因 為 某 個 必 需 的 網 路 介 面 與 相 應 的 配 置 可 能 不 存 在 。 (3)特 殊 值 "help" 可 用 於 列 出 所 有 可 用 的 協 議 。
-t TYPE , --type= TYPE , -c CLASS , --class= CLASS
指 定 查 詢 的 DNS資 源 記 錄 的 type(A, AAAA, MX, ...) 與 class(IN, ANY, ...)。 如 果 使 用 了 此 選 項 ， 那 麼 僅 查 詢 與 指 定 的 type/class 匹 配 的 DNS資 源 記 錄 。 如 果 僅 指 定 了 type 的 話 ， 那 麼 class 的 預 設 值 是 "IN"。 特 殊 值 "help" 可 用 於 列 出 所 有 可 用 的 值 。
--service
根 據 指 定 的 引 數 列 表 ， 開 啟 DNS-SD 與 簡 單 SRV 服 務 解 析 。 詳 見 前 文 。
--service-address= BOOL
預 設 值 yes 表 示 在 使 用 --service 查 詢 服 務 時 ， 同 時 也 解 析 包 含 在 SRV 資 源 記 錄 內 的 主 機 名 。
--service-txt= BOOL
預 設 值 yes 表 示 在 使 用 --service 查 詢 DNS-SD 服 務 時 ， 同 時 也 解 析 TXT 服 務 元 資 料 記 錄 。
--openpgp
查 詢 儲 存 在 DNS的 OPENPGPKEY 型 別 的 資 源 記 錄 中 的 PGP 公 鑰 (參 見 前 文 )。 指 定 的 Email地 址 將 被 轉 換 為 對 應 的 DNS域 名 ， 並 打 印 出 所 有 OPENPGPKEY 公 鑰 。
--tlsa
為 每 一 個 帶 有 port 與 family 字 首 的 名 字 ("_ port ._ family . domain ") 查 詢 儲 存 在 DNS的 TLSA 型 別 的 資 源 記 錄 中 的 TLS 公 鑰 (參 見 前 文 )。 埠 號 可 以 明 確 的 寫 在 冒 號 (:)之 後 ， 否 則 將 使 用 預 設 的 443 埠 。 family 可 以 作 為 --tlsa 的 引 數 指 定 ， 否 則 將 使 用 預 設 值 tcp 。
--cname= BOOL
預 設 值 yes 表 示 追 蹤 DNS 的 CNAME 或 DNAME 重 定 向 。 否 則 ， 在 接 收 到 CNAME 或 DNAME 應 答 後 ， 直 接 返 回 錯 誤 。
--search= BOOL
預 設 值 yes 表 示 所 有 不 含 "."的 主 機 名 都 將 在 搜 尋 域 列 表 (若 非 空 )中 進 行 搜 尋 。
--raw [=payload|packet]
以 原 始 的 二 進 位 制 格 式 顯 示 應 答 的 資 料 。 "payload"(預 設 值 )表 示 匯 出 資 料 包 的 荷 載 。 "packet" 表 示 匯 出 原 始 的 資 料 幀 ， 並 在 前 面 加 上 一 個 小 端 序 形 式 表 示 的 64位 整 數 。 此 選 項 僅 用 於 除 錯 目 的 。
--legend= BOOL
預 設 值 yes 表 示 顯 示 應 答 內 容 的 標 題 頭 與 元 資 料 。
--statistics
顯 示 解 析 統 計 ， 包 括 DNSSEC 是 否 可 用 ， 以 及 DNSSEC 驗 證 成 功 與 失 敗 的 數 量 。
--reset-statistics
重 置 各 種 解 析 統 計 的 計 數 器 ， 包 括 所 有 --statistics 輸 出 的 統 計 資 料 。 此 操 作 需 要 超 級 使 用 者 許 可 權 。
--flush-caches
重 新 整 理 本 地 DNS資 源 記 錄 快 取 。
--status
顯 示 全 域 性 DNS設 定 、 以 及 針 對 每 個 連 線 的 DNS設 定 。
-h , --help
顯 示 簡 短 的 幫 助 資 訊 並 退 出 。
--version
顯 示 簡 短 的 版 本 資 訊 並 退 出 。
--no-pager
不 將 程 式 的 輸 出 內 容 管 道 (pipe)給 分 頁 程 式 。
例 子
Example 1. 解 析 "www.0pointer.net" 域 名 所 對 應 的 地 址
$
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
Example 2. 反 解 析 "85.214.157.71" 地 址 所 對 應 的 域 名
$
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
Example 3. 查 詢 "0pointer.net" 域 名 的 MX 記 錄
$
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
Example 4. 查 詢 一 個 SRV 服 務
$
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
...
Example 5. 查 詢 一 個 PGP 公 鑰
$
systemd-resolve --openpgp zbyszek@fedoraproject.org
d08ee310438ca124a6149ea5cc21b6313b390dce485576eff96f8722._openpgpkey.fedoraproject.org.
IN OPENPGPKEY
mQINBFBHPMsBEACeInGYJCb+7TurKfb6wGyTottCDtiSJB310i37/6ZYoeIay/5soJjlMyf
MFQ9T2XNT/0LM6gTa0MpC1st9LnzYTMsT6tzRly1D1UbVI6xw0g0vE5y2Cjk3xUwAynCsSs
...
Example 6. 查 詢 一 個 TLS 公 鑰 (可 以 省 略 "=tcp" 與 ":443")
$
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
參 見
systemd (1), systemd-resolved.service (8)
NOTES
|
1. |
SRV |
https://tools.ietf.org/html/rfc2782
|
2. |
DNS-SD |
https://tools.ietf.org/html/rfc6763
|
3. |
OPENPGPKEY |
https://tools.ietf.org/html/draft-wouters-dane-openpgp-02
|
4. |
TLSA |
https://tools.ietf.org/html/rfc6698
|
5. |
Link-Local Multicast Name Resolution |
https://tools.ietf.org/html/rfc4795
跋
本 頁 面 中 文 版 由 中 文 man 手 冊 頁 計 劃 提 供 。
翻
譯 人 員 ： 金 步
國
金 步 國 作 品 集
： http://www.jinbuguo.com
中 文 man 手 冊 頁 計
劃 ：
https://github.com/man-pages-zh/manpages-zh