Manpages

NAME

localectl - 控 制 系 统 的 本 地 化 与 键 盘 布 局

SYNOPSIS

描 述

localectl 可 用 于 查 询 与 修 改 系 统 的 本 地 化 (locale)与 键 盘 布 局 的 设 置 。 它 通 过 与 systemd-localed.service(8) 通 信 来 修 改 例 如 /etc/locale.conf 与 /etc/vconsole.conf 之 类 的 配 置 文 件 。 本 地 化 设 置 控 制 着 用 户 界 面 的 语 言 、 字 符 类 型 与 字 符 编 码 、 日 期 时 间 与 货 币 符 号 的 表 达 方 式 等 许 多 细 节 。 键 盘 布 局 控 制 着 键 盘 上 每 个 按 键 及 组 合 键 的 含 义 。 注 意 ， 为 了 使 此 工 具 所 做 的 修 改 在 系 统 启 动 的 早 期 就 能 生 效 ， 可 能 需 要 重 新 制 作 initramfs ， 因 为 localectl 并 不 会 自 动 更 新 initramfs 。 可 以 使 用 systemd-firstboot(1) 初 始 化 已 挂 载 (但 未 启 动 )的 系 统 镜 像 的 本 地 化 (locale)设 置 。

选 项

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

--no-ask-password 在 执 行 特 权 操 作 时 不 向 用 户 索 要 密 码 。

--no-convert 与 set-keymap 或 set-x11-keymap 命 令 连 用 ， 表 示 不 同 时 设 置 X11与 控 制 台 的 键 盘 映 射 ， 也 就 是 不 强 迫 保 持 两 者 一 致 。

-H, --host= 操 作 指 定 的 远 程 主 机 。 可 以 仅 指 定 一 个 主 机 名 (hostname)， 也 可 以 使 用 "username@hostname" 格 式 。 hostname 后 面 还 可 以 加 上 容 器 名 (以 冒 号 分 隔 )， 也 就 是 形 如 "hostname:container" 的 格 式 ， 以 表 示 直 接 连 接 到 指 定 主 机 的 指 定 容 器 内 。 操 作 将 通 过 SSH协 议 进 行 ， 以 确 保 安 全 。 可 以 通 过 machinectl -H HOST 命 令 列 出 远 程 主 机 上 的 所 有 容 器 名 称 。

-h, --help 显 示 简 短 的 帮 助 信 息 并 退 出 。

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

--no-pager 不 将 程 序 的 输 出 内 容 管 道 (pipe)给 分 页 程 序 。 能 够 识 别 的 命 令 如 下 ：

status 显 示 当 前 的 本 地 化 设 置 与 键 盘 映 射 。 这 是 默 认 命 令 。

set-locale LOCALE... 设 置 系 统 的 本 地 化 环 境 变 量 (可 以 一 次 设 置 多 个 )， 例 如 "LANG=zh_CN.utf8", "LC_MESSAGES=en_US.utf8" 等 等 。 参 见 locale(7) 以 了 解 可 用 的 环 境 变 量 及 其 含 义 。 使 用 list-locales 命 令 列 出 所 有 可 用 的 locale (见 下 文 )。

list-locales 列 出 所 有 可 用 的 locale ， 以 帮 助 正 确 使 用 set-locale 命 令 。

set-keymap MAP [TOGGLEMAP] 设 置 控 制 台 的 键 盘 映 射 (中 国 人 应 设 为 "us")。 可 选 的 [TOGGLEMAP]用 于 设 置 第 二 切 换 键 盘 映 射 。 除 非 明 确 设 置 了 --no-convert 选 项 ， 否 则 此 命 令 也 会 同 时 设 置 默 认 的 X11键 盘 布 局 (将 "MAP"自 动 转 化 为 最 接 近 的 X11键 盘 布 局 )。 使 用 list-keymaps 命 令 列 出 所 有 可 用 的 键 盘 映 射 (见 下 文 )。

list-keymaps 列 出 所 有 可 用 的 控 制 台 键 盘 映 射 ， 以 帮 助 正 确 使 用 set-keymap 命 令 。

set-x11-keymap LAYOUT [MODEL [VARIANT [OPTIONS]]] 设 置 默 认 的 X11键 盘 布 局 (中 国 人 应 设 为 "us")。 可 选 的 ， 还 可 以 设 置 Model, Variant, Options 三 项 (无 默 认 值 )。 "MODEL"一 般 设 为 "pc104"， "VARIANT"与 "OPTIONS"一 般 直 接 忽 略 ， 详 见 kbd(4) 手 册 。 除 非 明 确 设 置 了 --no-convert 选 项 ， 否 则 此 命 令 也 会 同 时 设 置 控 制 台 的 键 盘 映 射 ， 也 就 是 将 "LAYOUT"自 动 转 化 为 最 接 近 的 控 制 台 键 盘 映 射 。

list-x11-keymap-models, list-x11-keymap-layouts, list-x11-keymap-variants [LAYOUT], list-x11-keymap-options 分 别 列 出 所 有 可 用 的 X11键 盘 的 Layout, Model, Variant, Options 以 帮 助 正 确 使 用 set-x11-keymap 命 令 。 list-x11-keymap-variants 命 令 有 个 可 选 的 "LAYOUT"参 数 用 于 过 滤 出 仅 适 合 于 特 定 键 盘 布 局 的 变 种 。

退 出 状 态

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

环 境 变 量

$SYSTEMD_PAGER 指 定 分 页 程 序 。 仅 在 未 指 定 --no-pager 选 项 时 有 意 义 。 此 变 量 会 覆 盖 $PAGER 的 值 。 将 此 变 量 设 为 空 字 符 串 或 "cat" 等 价 于 使 用 --no-pager 选 项 。

$SYSTEMD_LESS 用 于 覆 盖 默 认 传 递 给 less 程 序 的 命 令 行 选 项 ("FRSXMK")。

参 见

systemd(1), locale(7), locale.conf(5), vconsole.conf(5), loadkeys(1), kbd(4), The XKB Configuration Guide [1] , systemctl(1), systemd-localed.service(8), systemd-firstboot(1), mkinitrd(8)

NOTES

http://www.x.org/releases/current/doc/xorg-docs/input/XKB-Config.html

跋

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