Man page - hostnamectl(1)

Packages contains this manual

Available languages:

en fr ro zh_TW zh_CN de

Manual

HOSTNAMECTL

NAME
SYNOPSIS
描 述
選 項
退 出 狀 態
參 見
NOTES
跋

NAME

hostnamectl - 控 制 系 統 的 主 機 名

SYNOPSIS

hostnamectl [OPTIONS...] {COMMAND}

描 述

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

1.

圖 示 命 名 規 範

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