Man page - systemd-firstboot.service(1)

Packages contains this manual

Available languages:

en zh_TW zh_CN de

Manual

SYSTEMD-FIRSTBOOT

NAME
SYNOPSIS
描 述
选 项
退 出 状 态
参 见
跋

NAME

systemd-firstboot, systemd-firstboot.service - 初 始 化 基 本 系 统 设 置

SYNOPSIS

systemd-firstboot [OPTIONS...]

systemd-firstboot.service

描 述

systemd-firstboot 既 可 以 在 系 统 首 次 启 动 时 交 互 式 的 初 始 化 最 基 本 的 系 统 设 置 ， 也 可 以 在 创 建 新 系 统 镜 像 时 非 交 互 式 的 初 始 化 最 基 本 的 系 统 设 置 。 这 些 最 基 本 的 系 统 设 置 包 括 ：

• 本 地 化 ， 也 就 是 LANG= 与 LC_MESSAGES 两 个 环 境 变 量 。

• 时 区

• 主 机 名

• "machine ID"

• root 用 户 的 密 码

所 有 上 述 设 置 既 可 以 交 互 式 的 向 用 户 询 问 ， 也 可 以 非 交 互 式 的 通 过 命 令 行 选 项 指 定 ， 还 可 以 从 创 建 新 系 统 镜 像 的 主 机 复 制 而 来 。

如 果 某 个 设 置 已 经 被 初 始 化 ， 那 么 将 不 会 覆 盖 已 有 的 设 置 ， 并 且 不 会 提 示 用 户 设 置 此 项 。

与 localectl (1), timedatectl (1), hostnamectl (1) 不 同 ， 此 工 具 直 接 操 作 文 件 系 统 上 的 配 置 文 件 ， 并 不 需 要 任 何 系 统 服 务 的 支 持 。 因 此 ， systemd-firstboot 可 用 于 设 置 一 个 已 挂 载 (但 未 启 动 )的 系 统 镜 像 。 不 应 该 在 运 行 中 的 系 统 上 使 用 systemd-firstboot 命 令 。

选 项

能 够 识 别 的 命 令 行 选 项 如 下 ：

--root= root

指 定 已 挂 载 (但 未 启 动 )的 系 统 镜 像 的 根 目 录 位 置 ， 所 有 其 他 路 径 都 将 以 此 root 为 前 缀 。 仅 在 为 已 挂 载 (但 未 启 动 )的 系 统 镜 像 初 始 化 基 本 系 统 参 数 时 才 需 要 使 用 此 选 项 。

--locale= LOCALE , --locale-messages= LOCALE

分 别 设 置 LANG= 与 LC_MESSAGES 环 境 变 量 。 例 如 "zh_CN.utf8" 。 此 选 项 用 于 设 置 locale.conf (5) 配 置 文 件 。

--timezone= TIMEZONE

设 置 系 统 时 区 。 例 如 "PRC" (北 京 时 间 )。 此 选 项 用 于 设 置 localtime (5) 软 连 接 的 指 向 。

--hostname= HOSTNAME

设 置 主 机 名 。 此 选 项 用 于 设 置 hostname (5) 配 置 文 件 。

--machine-id= ID

设 置 "machine ID"。 此 选 项 用 于 设 置 machine-id (5) 文 件 。

--root-password= PASSWORD , --root-password-file= PATH

设 置 root用 户 的 密 码 ， 同 时 创 建 shadow (5) 文 件 。 既 可 以 通 过 --root-password= 选 项 直 接 在 命 令 行 上 指 定 密 码 ， 也 可 以 通 过 --root-password-file= 选 项 从 指 定 的 文 件 中 读 取 密 码 。 出 于 安 全 考 虑 ， 一 般 不 建 议 直 接 在 命 令 行 上 指 定 密 码 ， 因 为 其 他 用 户 可 以 通 过 ps (1) 命 令 看 到 密 码 。

--prompt-locale , --prompt-timezone , --prompt-hostname , --prompt-root-password

以 交 互 式 对 话 询 问 用 户 特 定 的 设 置 ， 但 不 会 提 示 已 经 在 命 令 行 上 指 定 的 设 置 (因 为 它 们 的 优 先 级 更 高 )。

--prompt

以 交 互 式 对 话 询 问 用 户 本 地 化 、 时 区 、 主 机 名 、 root密 码 。 相 当 于 同 时 使 用 --prompt-locale , --prompt-timezone , --prompt-hostname , --prompt-root-password 选 项 。

--copy-locale , --copy-timezone , --copy-root-password

从 主 机 复 制 特 定 的 设 置 ， 必 须 和 --root= 选 项 一 起 使 用 。

--copy

从 主 机 复 制 本 地 化 、 时 区 、 root密 码 。 必 须 和 --root= 选 项 一 起 使 用 。 相 当 于 同 时 使 用 --copy-locale , --copy-timezone , --copy-root-password 选 项 。

--setup-machine-id

将 "machine ID"初 始 化 为 一 个 随 机 值 。 必 须 和 --root= 选 项 一 起 使 用 。

-h , --help

显 示 简 短 的 帮 助 信 息 并 退 出 。

--version

显 示 简 短 的 版 本 信 息 并 退 出 。

退 出 状 态

返 回 值 为 0 表 示 成 功 ， 非 零 返 回 值 表 示 失 败 代 码 。

参 见

systemd (1), locale.conf (5), localtime (5), hostname (5), machine-id (5), shadow (5), systemd-machine-id-setup (1), localectl (1), timedatectl (1), hostnamectl (1)

跋

本 页 面 中 文 版 由 中 文 man 手 册 页 计 划 提 供 。

翻 译 人 员 ： 金 步 国
金 步 国 作 品 集 ： http://www.jinbuguo.com
中 文 man 手 册 页 计 划 ： https://github.com/man-pages-zh/manpages-zh