LOCALECTL(1)

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