'\" t
.TH "HOSTNAMECTL" "1" "" "systemd 231" "hostnamectl"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
hostnamectl \- 控制系統的主機名
.SH "SYNOPSIS"
.HP \w'\fBhostnamectl\fR\ 'u
\fBhostnamectl\fR [OPTIONS...] {COMMAND}
.SH "描述"
.PP
\fBhostnamectl\fR
可用於查詢與修改系統主機名以及其他相關設定。 所謂"主機名"，其實有三種不同的含義：
.PP
"pretty"主機名，僅供人類閱讀，可以包含各種特殊字元， 例如"Lennart\*(Aqs Laptop"(必須是UTF\-8編碼)。 pretty(易讀主機名)、chassis(裝置型別)、icon(圖示名稱)儲存在
/etc/machine\-info
檔案中， 詳見
\fBmachine-info\fR(5)
手冊。
.PP
"static"主機名，用於在系統啟動時設定核心的主機名，僅可包含 "\-","a\-z","0\-9" 字元，例如"lennarts\-laptop"。 此種主機名就是通常所說的"主機名"，儲存在
/etc/hostname
檔案中， 詳見
\fBhostname\fR(5)
手冊。
.PP
"transient"主機名，是從網路配置中獲得的 fallback 主機名， 同樣僅可包含 "\-","a\-z","0\-9" 字元。 如果存在"static"主機名且不等於"localhost"， 那麼將忽略"transient"主機名。
.PP
可以使用
\fBsystemd-firstboot\fR(1)
初始化已掛載(但未啟動)的系統映象的主機名(hostname)。
.SH "選項"
.PP
能夠識別的命令列選項如下：
.PP
\fB\-\-no\-ask\-password\fR
.RS 4
在執行特權操作時不向使用者索要密碼。
.RE
.PP
\fB\-\-static\fR, \fB\-\-transient\fR, \fB\-\-pretty\fR
.RS 4
與預設的
\fBstatus\fR
命令一起使用， 表示僅顯示特定的主機名(不可同時使用多個選項)。
.sp
與
\fBset\-hostname\fR
命令一起使用， 表示僅更新特定的主機名(可以同時使用多個選項)。
.RE
.PP
\fB\-H\fR, \fB\-\-host=\fR
.RS 4
操作指定的遠端主機。可以僅指定一個主機名(hostname)， 也可以使用
"username@hostname"
格式。 hostname 後面還可以加上容器名(以冒號分隔)， 也就是形如
"hostname:container"
的格式， 以表示直接連線到指定主機的指定容器內。 操作將透過SSH協議進行，以確保安全。 可以透過
\fBmachinectl \-H \fR\fB\fIHOST\fR\fR
命令列出遠端主機上的所有容器名稱。
.RE
.PP
\fB\-M\fR, \fB\-\-machine=\fR
.RS 4
在本地容器內執行操作。 必須明確指定容器的名稱。
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
顯示簡短的幫助資訊並退出。
.RE
.PP
\fB\-\-version\fR
.RS 4
顯示簡短的版本資訊並退出。
.RE
.PP
能夠識別的命令如下：
.PP
\fBstatus\fR
.RS 4
顯示當前的主機名及其他相關資訊。 這是預設命令。
.RE
.PP
\fBset\-hostname \fR\fB\fINAME\fR\fR
.RS 4
將系統的主機名設為
\fINAME\fR
。 如果使用了
\fB\-\-static\fR,
\fB\-\-transient\fR,
\fB\-\-pretty\fR
選項， 那麼只更新指定的主機名， 否則同時更新 pretty, static, transient 三個主機名。 如果在設定 pretty 主機名的同時也設定 static/transient 主機名， 那麼 static/transient 主機名將根據如下規則從 pretty 主機名派生而來： 首先將空格替換為
"\-"
， 然後將大寫字母轉換為小寫字母， 最後刪除不在"\-","a\-z","0\-9"範圍內的字元。 這樣可以確保 static/transient 主機名始終保持與 pretty 主機名一致， 同時又不違反自身的命名規則。 如果僅設定 static/transient 主機名， 則不會對 pretty 主機名產生任何影響。
.sp
注意，若設為空字串， 則表示將主機名重置為預設值(通常是
"localhost")。
.RE
.PP
\fBset\-icon\-name \fR\fB\fINAME\fR\fR
.RS 4
將系統的圖示名設為
\fINAME\fR
， 某些圖形介面的應用程式會根據此設定給主機配上適當的圖示。 此名稱必須遵守
\m[blue]\fB圖示命名規範\fR\m[]\&\s-2\u[1]\d\s+2。
.sp
注意，若設為空字串， 則表示將圖示名重置為預設值(通常由"裝置型別"決定)。
.RE
.PP
\fBset\-chassis \fR\fB\fITYPE\fR\fR
.RS 4
將系統的裝置型別設為
\fITYPE\fR， 某些圖形介面的應用程式 會根據此設定切換到合適的人機介面之類。 取值範圍如下：
"desktop"(桌上型電腦),
"laptop"(筆記本),
"server"(伺服器),
"tablet"(平板電腦),
"handset"(智慧手機),
"watch"(智慧手錶),
"embedded"(嵌入式裝置),
"vm"(虛擬機器),
"container"(容器)。
.sp
注意，若設為空字串， 則表示將裝置型別重置為預設值(通常由主機板韌體決定)。
.RE
.PP
\fBset\-deployment \fR\fB\fIENVIRONMENT\fR\fR
.RS 4
將系統的部署環境設為
\fIENVIRONMENT\fR
。 必須設為一個單獨的單詞且禁止包含任何特殊字元。 建議設為下列單詞中的一個：
"development"(開發),
"integration"(綜合),
"staging"(階段),
"production"(生產)
.sp
注意，若設為空字串，則表示將部署環境重置為預設值(同樣是空字串)。
.RE
.PP
\fBset\-location \fR\fB\fILOCATION\fR\fR
.RS 4
將系統的地理位置設為
\fILOCATION\fR
。 必須設為一個人類易讀字串， 準確的描述出主機所在的物理位置。 例如：
"XX資料中心3樓E23機櫃U7"
.sp
注意，若設為空字串，則表示將地理位置重置為預設值(同樣是空字串)。
.RE
.SH "退出狀態"
.PP
返回值為 0 表示成功， 非零返回值表示失敗程式碼。
.SH "參見"
.PP
\fBsystemd\fR(1),
\fBhostname\fR(1),
\fBhostname\fR(5),
\fBmachine-info\fR(5),
\fBsystemctl\fR(1),
\fBsystemd-hostnamed.service\fR(8),
\fBsystemd-firstboot\fR(1)
.SH "NOTES"
.IP " 1." 4
圖示命名規範
.RS 4
\%http://standards.freedesktop.org/icon-naming-spec/icon-naming-spec-latest.html
.RE
.SH "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.PP
翻譯人員：金步國
.br
金步國作品集：http://www.jinbuguo.com
.br
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR