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