'\" 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