Manpages

NAME

hostnamectl - 控 制 系 统 的 主 机 名

SYNOPSIS

描 述

hostnamectl 可 用 于 查 询 与 修 改 系 统 主 机 名 以 及 其 他 相 关 设 置 。 所 谓 "主 机 名 "， 其 实 有 三 种 不 同 的 含 义 ：

"pretty"主 机 名 ， 仅 供 人 类 阅 读 ， 可 以 包 含 各 种 特 殊 字 符 ， 例 如 "Lennart's Laptop"(必 须 是 UTF-8编 码 )。 pretty(易 读 主 机 名 )、 chassis(设 备 类 型 )、 icon(图 标 名 称 )存 储 在 /etc/machine-info 文 件 中 ， 详 见 machine-info(5) 手 册 。

"static"主 机 名 ， 用 于 在 系 统 启 动 时 设 置 内 核 的 主 机 名 ， 仅 可 包 含 "-","a-z","0-9" 字 符 ， 例 如 "lennarts-laptop"。 此 种 主 机 名 就 是 通 常 所 说 的 "主 机 名 "， 存 储 在 /etc/hostname 文 件 中 ， 详 见 hostname(5) 手 册 。

"transient"主 机 名 ， 是 从 网 络 配 置 中 获 得 的 fallback 主 机 名 ， 同 样 仅 可 包 含 "-","a-z","0-9" 字 符 。 如 果 存 在 "static"主 机 名 且 不 等 于 "localhost"， 那 么 将 忽 略 "transient"主 机 名 。 可 以 使 用 systemd-firstboot(1) 初 始 化 已 挂 载 (但 未 启 动 )的 系 统 镜 像 的 主 机 名 (hostname)。

选 项

能 够 识 别 的 命 令 行 选 项 如 下 ：

--no-ask-password 在 执 行 特 权 操 作 时 不 向 用 户 索 要 密 码 。

--static, --transient, --pretty 与 默 认 的 status 命 令 一 起 使 用 ， 表 示 仅 显 示 特 定 的 主 机 名 (不 可 同 时 使 用 多 个 选 项 )。 与 set-hostname 命 令 一 起 使 用 ， 表 示 仅 更 新 特 定 的 主 机 名 (可 以 同 时 使 用 多 个 选 项 )。

-H, --host= 操 作 指 定 的 远 程 主 机 。 可 以 仅 指 定 一 个 主 机 名 (hostname)， 也 可 以 使 用 "username@hostname" 格 式 。 hostname 后 面 还 可 以 加 上 容 器 名 (以 冒 号 分 隔 )， 也 就 是 形 如 "hostname:container" 的 格 式 ， 以 表 示 直 接 连 接 到 指 定 主 机 的 指 定 容 器 内 。 操 作 将 通 过 SSH协 议 进 行 ， 以 确 保 安 全 。 可 以 通 过 machinectl -H HOST 命 令 列 出 远 程 主 机 上 的 所 有 容 器 名 称 。

-M, --machine= 在 本 地 容 器 内 执 行 操 作 。 必 须 明 确 指 定 容 器 的 名 称 。

-h, --help 显 示 简 短 的 帮 助 信 息 并 退 出 。

--version 显 示 简 短 的 版 本 信 息 并 退 出 。 能 够 识 别 的 命 令 如 下 ：

status 显 示 当 前 的 主 机 名 及 其 他 相 关 信 息 。 这 是 默 认 命 令 。

set-hostname NAME 将 系 统 的 主 机 名 设 为 NAME 。 如 果 使 用 了 --static, --transient, --pretty 选 项 ， 那 么 只 更 新 指 定 的 主 机 名 ， 否 则 同 时 更 新 pretty, static, transient 三 个 主 机 名 。 如 果 在 设 置 pretty 主 机 名 的 同 时 也 设 置 static/transient 主 机 名 ， 那 么 static/transient 主 机 名 将 根 据 如 下 规 则 从 pretty 主 机 名 派 生 而 来 ： 首 先 将 空 格 替 换 为 "-" ， 然 后 将 大 写 字 母 转 换 为 小 写 字 母 ， 最 后 删 除 不 在 "-","a-z","0-9"范 围 内 的 字 符 。 这 样 可 以 确 保 static/transient 主 机 名 始 终 保 持 与 pretty 主 机 名 一 致 ， 同 时 又 不 违 反 自 身 的 命 名 规 则 。 如 果 仅 设 置 static/transient 主 机 名 ， 则 不 会 对 pretty 主 机 名 产 生 任 何 影 响 。 注 意 ， 若 设 为 空 字 符 串 ， 则 表 示 将 主 机 名 重 置 为 默 认 值 (通 常 是 "localhost")。

set-icon-name NAME 将 系 统 的 图 标 名 设 为 NAME ， 某 些 图 形 界 面 的 应 用 程 序 会 根 据 此 设 置 给 主 机 配 上 适 当 的 图 标 。 此 名 称 必 须 遵 守 图 标 命 名 规 范 [1] 。 注 意 ， 若 设 为 空 字 符 串 ， 则 表 示 将 图 标 名 重 置 为 默 认 值 (通 常 由 "设 备 类 型 "决 定 )。

set-chassis TYPE 将 系 统 的 设 备 类 型 设 为 TYPE， 某 些 图 形 界 面 的 应 用 程 序 会 根 据 此 设 置 切 换 到 合 适 的 人 机 界 面 之 类 。 取 值 范 围 如 下 ： "desktop"(台 式 机 ), "laptop"(笔 记 本 ), "server"(服 务 器 ), "tablet"(平 板 电 脑 ), "handset"(智 能 手 机 ), "watch"(智 能 手 表 ), "embedded"(嵌 入 式 设 备 ), "vm"(虚 拟 机 ), "container"(容 器 )。 注 意 ， 若 设 为 空 字 符 串 ， 则 表 示 将 设 备 类 型 重 置 为 默 认 值 (通 常 由 主 板 固 件 决 定 )。

set-deployment ENVIRONMENT 将 系 统 的 部 署 环 境 设 为 ENVIRONMENT 。 必 须 设 为 一 个 单 独 的 单 词 且 禁 止 包 含 任 何 特 殊 字 符 。 建 议 设 为 下 列 单 词 中 的 一 个 ： "development"(开 发 ), "integration"(综 合 ), "staging"(阶 段 ), "production"(生 产 ) 注 意 ， 若 设 为 空 字 符 串 ， 则 表 示 将 部 署 环 境 重 置 为 默 认 值 (同 样 是 空 字 符 串 )。

set-location LOCATION 将 系 统 的 地 理 位 置 设 为 LOCATION 。 必 须 设 为 一 个 人 类 易 读 字 符 串 ， 准 确 的 描 述 出 主 机 所 在 的 物 理 位 置 。 例 如 ： "XX数 据 中 心 3楼 E23机 柜 U7" 注 意 ， 若 设 为 空 字 符 串 ， 则 表 示 将 地 理 位 置 重 置 为 默 认 值 (同 样 是 空 字 符 串 )。

退 出 状 态

返 回 值 为 0 表 示 成 功 ， 非 零 返 回 值 表 示 失 败 代 码 。

参 见

systemd(1), hostname(1), hostname(5), machine-info(5), systemctl(1), systemd-hostnamed.service(8), systemd-firstboot(1)

NOTES

http://standards.freedesktop.org/icon-naming-spec/icon-naming-spec-latest.html

跋

本 页 面 中 文 版 由 中 文 man 手 册 页 计 划 提 供 。 翻 译 人 员 ： 金 步 国 金 步 国 作 品 集 ： http://www.jinbuguo.com 中 文 man 手 册 页 计 划 ： https://github.com/man-pages-zh/manpages-zh