Man page - localectl(1)

Packages contains this manual

Available languages:

en fr pt_BR ro zh_TW zh_CN de

Manual

LOCALECTL

NAME
SYNOPSIS
描 述
选 项
退 出 状 态
环 境 变 量
参 见
NOTES
跋

NAME

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

SYNOPSIS

localectl [OPTIONS...] {COMMAND}

描 述

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

1.

The XKB Configuration Guide

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