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