'\" t
.TH "SYSTEMD\-FIRSTBOOT" "1" "" "systemd 231" "systemd-firstboot"
.\" -----------------------------------------------------------------
.\" * 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"
systemd-firstboot, systemd-firstboot.service \- 初始化基本系統設置
.SH "SYNOPSIS"
.HP \w'\fBsystemd\-firstboot\fR\ 'u
\fBsystemd\-firstboot\fR [OPTIONS...]
.PP
systemd\-firstboot\&.service
.SH "描述"
.PP
\fBsystemd\-firstboot\fR
既可以在系統首次啓動時交互式的初始化最基本的系統設置， 也可以在創建新系統鏡像時非交互式的初始化最基本的系統設置。 這些最基本的系統設置包括：
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
本地化， 也就是
\fILANG=\fR
與
\fILC_MESSAGES\fR
兩個環境變量。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
時區
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
主機名
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
"machine ID"
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
root 用戶的密碼
.RE
.PP
所有上述設置既可以交互式的向用戶詢問， 也可以非交互式的通過命令行選項指定， 還可以從創建新系統鏡像的主機複製而來。
.PP
如果某個設置已經被初始化， 那麼將不會覆蓋已有的設置， 並且不會提示用戶設置此項。
.PP
與
\fBlocalectl\fR(1),
\fBtimedatectl\fR(1),
\fBhostnamectl\fR(1)
不同，此工具直接操作文件系統上的配置文件， 並不需要任何系統服務的支持。 因此，
\fBsystemd\-firstboot\fR
可用於設置一個已掛載(但未啓動)的系統鏡像。 不應該在運行中的系統上使用
\fBsystemd\-firstboot\fR
命令。
.SH "選項"
.PP
能夠識別的命令行選項如下：
.PP
\fB\-\-root=\fR\fB\fIroot\fR\fR
.RS 4
指定已掛載(但未啓動)的系統鏡像的根目錄位置， 所有其他路徑都將以此
\fIroot\fR
爲前綴。 僅在爲已掛載(但未啓動)的系統鏡像 初始化基本系統參數時才需要使用此選項。
.RE
.PP
\fB\-\-locale=\fR\fB\fILOCALE\fR\fR, \fB\-\-locale\-messages=\fR\fB\fILOCALE\fR\fR
.RS 4
分別設置
\fILANG=\fR
與
\fILC_MESSAGES\fR
環境變量。 例如
"zh_CN\&.utf8"
。此選項用於設置
\fBlocale.conf\fR(5)
配置文件。
.RE
.PP
\fB\-\-timezone=\fR\fB\fITIMEZONE\fR\fR
.RS 4
設置系統時區。 例如
"PRC"
(北京時間)。此選項用於設置
\fBlocaltime\fR(5)
軟連接的指向。
.RE
.PP
\fB\-\-hostname=\fR\fB\fIHOSTNAME\fR\fR
.RS 4
設置主機名。 此選項用於設置
\fBhostname\fR(5)
配置文件。
.RE
.PP
\fB\-\-machine\-id=\fR\fB\fIID\fR\fR
.RS 4
設置"machine ID"。 此選項用於設置
\fBmachine-id\fR(5)
文件。
.RE
.PP
\fB\-\-root\-password=\fR\fB\fIPASSWORD\fR\fR, \fB\-\-root\-password\-file=\fR\fB\fIPATH\fR\fR
.RS 4
設置root用戶的密碼， 同時創建
\fBshadow\fR(5)
文件。既可以通過
\fB\-\-root\-password=\fR
選項直接在命令行上指定密碼， 也可以通過
\fB\-\-root\-password\-file=\fR
選項從指定的文件中讀取密碼。 出於安全考慮， 一般不建議直接在命令行上指定密碼， 因爲其他用戶可以通過
\fBps\fR(1)
命令看到密碼。
.RE
.PP
\fB\-\-prompt\-locale\fR, \fB\-\-prompt\-timezone\fR, \fB\-\-prompt\-hostname\fR, \fB\-\-prompt\-root\-password\fR
.RS 4
以交互式對話詢問用戶特定的設置， 但不會提示已經在命令行上指定的設置(因爲它們的優先級更高)。
.RE
.PP
\fB\-\-prompt\fR
.RS 4
以交互式對話詢問用戶本地化、時區、主機名、root密碼。 相當於同時使用
\fB\-\-prompt\-locale\fR,
\fB\-\-prompt\-timezone\fR,
\fB\-\-prompt\-hostname\fR,
\fB\-\-prompt\-root\-password\fR
選項。
.RE
.PP
\fB\-\-copy\-locale\fR, \fB\-\-copy\-timezone\fR, \fB\-\-copy\-root\-password\fR
.RS 4
從主機複製特定的設置， 必須和
\fB\-\-root=\fR
選項一起使用。
.RE
.PP
\fB\-\-copy\fR
.RS 4
從主機複製本地化、時區、root密碼。 必須和
\fB\-\-root=\fR
選項一起使用。相當於同時使用
\fB\-\-copy\-locale\fR,
\fB\-\-copy\-timezone\fR,
\fB\-\-copy\-root\-password\fR
選項。
.RE
.PP
\fB\-\-setup\-machine\-id\fR
.RS 4
將"machine ID"初始化爲一個隨機值。 必須和
\fB\-\-root=\fR
選項一起使用。
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
顯示簡短的幫助信息並退出。
.RE
.PP
\fB\-\-version\fR
.RS 4
顯示簡短的版本信息並退出。
.RE
.SH "退出狀態"
.PP
返回值爲 0 表示成功， 非零返回值表示失敗代碼。
.SH "參見"
.PP
\fBsystemd\fR(1),
\fBlocale.conf\fR(5),
\fBlocaltime\fR(5),
\fBhostname\fR(5),
\fBmachine-id\fR(5),
\fBshadow\fR(5),
\fBsystemd-machine-id-setup\fR(1),
\fBlocalectl\fR(1),
\fBtimedatectl\fR(1),
\fBhostnamectl\fR(1)
.SH "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.PP
翻譯人員：金步國
.br
金步國作品集：http://www.jinbuguo.com
.br
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR