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