Arch manual pages

LOGINCTL(1) loginctl LOGINCTL(1)

loginctl - 控制 systemd 登錄管理器

loginctl [OPTIONS...] {COMMAND} [NAME...]

loginctl 可用於內省與控制 systemd(1) 登錄管理服務 systemd-logind.service(8)

能夠識別的命令行選項如下:

--no-ask-password

在執行特權操作時不向用戶索要密碼。

-p, --property=

在顯示 session/user/seat 屬性時, 僅顯示此處指定的屬性。 若未指定,則顯示全部屬性。 參數必須是屬性名(例如"Sessions")。 可以多次使用此選項以指定多個屬性。

--value

在使用 show 顯示屬性時, 僅顯示屬性值,而不顯示屬性名及等號。

-a, --all

在顯示 session/user/seat 屬性時, 顯示全部屬性,無論這些屬性是否已經被設置。

-l, --full

在顯示進程樹的時候,不對超長行進行截斷。

--kill-who=

kill-session 連用,指定殺死哪個進程。 leader 表示僅殺死會話的領導進程; all 表示殺死會話的所有進程。 默認值爲 all

-s, --signal=

kill-sessionkill-user 連用, 指定向選中的進程發送什麼信號。 必須設爲衆所周知的信號名稱,例如 SIGTERM(默認值), SIGINT, SIGSTOP 之類

-n, --lines=

user-statussession-status 連用, 控制顯示多少行日誌(從最新的一條日誌開始計算)。 必須設爲一個正整數,默認值是"10"。

-o, --output=

user-statussession-status 連用, 控制日誌的輸出格式。 可用值參見 journalctl(1) 手冊。 默認爲 "short"

-H, --host=

操作指定的遠程主機。可以僅指定一個主機名(hostname), 也可以使用 "username@hostname" 格式。 hostname 後面還可以加上容器名(以冒號分隔), 也就是形如 "hostname:container" 的格式, 以表示直接連接到指定主機的指定容器內。 操作將通過SSH協議進行,以確保安全。 可以通過 machinectl -H HOST 命令列出遠程主機上的所有容器名稱。

-M, --machine=

在本地容器內執行操作。 必須明確指定容器的名稱。

--no-pager

不將程序的輸出內容管道(pipe)給分頁程序。

--no-legend

不輸出列標題, 也就是不在輸出列表的頭部和尾部顯示字段的名稱。

-h, --help

顯示簡短的幫助信息並退出。

--version

顯示簡短的版本信息並退出。

能夠識別的命令如下:

list-sessions
列出當前所有的會話。這是默認命令。

session-status [ID...]

顯示簡潔的會話狀態信息,後跟最近的日誌。 如果指定了會話ID,那麼僅顯示指定的會話, 否則顯示當前調用者的會話。 此命令主要用於輸出人類易讀的信息, 如果你想輸出易於程序分析的信息, 那麼應該使用 show-session 命令

show-session [ID...]

如果指定了會話ID,那麼顯示指定會話的各項屬性值, 否則顯示登陸管理器自身的各項屬性值。 除非使用了 --all 選項, 否則空屬性將被忽略。 還可以使用 --property= 選項指定僅顯示個別屬性。 此命令主要用於輸出易於程序分析的信息, 如果你想輸出人類易讀的信息, 那麼應該使用 session-status 命令。

activate [ID]

激活會話。 也就是將處於後臺的會話切換到前臺(如果同席位的另一個會話正處於前臺)。 如果指定了會話ID, 那麼將激活指定的會話, 否則將激活當前調用者的會話。

lock-session [ID...], unlock-session [ID...]

鎖定/解鎖會話(如果會話支持屏幕鎖)。 如果指定了會話ID,那麼將鎖定/解鎖指定的會話, 否則將鎖定/解鎖當前調用者的會話。

lock-sessions, unlock-sessions

鎖定/解鎖所有支持屏幕鎖的會話。

terminate-session ID...

結束指定的會話。 也就是殺死指定會話的所有進程、釋放所有與此會話相關的資源。

kill-session ID...

向指定的會話進程發送信號。 使用 --kill-who= 指定目標進程, 使用 --signal= 指定要發送的信號。

list-users
列出當前登錄的用戶

user-status [USER...]

顯示簡潔的已登錄用戶信息,後跟最近的日誌。 如果指定了用戶名或UID, 那麼僅顯示指定的用戶, 否則顯示當前調用者的用戶。 此命令主要用於輸出人類易讀的信息, 如果你想輸出易於程序分析的信息, 那麼應該使用 show-user 命令。

show-user [USER...]

如果指定了用戶名或UID,那麼顯示指定用戶的各項屬性值, 否則顯示登陸管理器自身的各項屬性值。 除非使用了 --all 選項, 否則空屬性將被忽略。 還可以使用 --property= 選項來顯示指定的屬性。 此命令主要用於輸出易於程序分析的信息, 如果你想輸出人類易讀的信息, 那麼應該使用 user-status 命令。

enable-linger [USER...], disable-linger [USER...]

啓用/禁止用戶逗留(相當於保持登錄狀態)。 如果指定了用戶名或UID, 那麼系統將會在啓動時自動爲這些用戶派生出用戶管理器, 並且在用戶登出後繼續保持運行。 這樣就可以允許未登錄的用戶在後臺運行持續時間很長的服務。 如果沒有指定任何參數, 那麼將作用於當前調用者的用戶。

參見 logind.conf(5) 中的 KillUserProcesses= 指令。

terminate-user USER...

結束指定用戶的所有會話。 這將殺死該用戶的所有會話中的所有進程, 同時釋放與此用戶有關的所有資源。

kill-user USER...

向指定用戶的所有進程發送 --signal= 選項指定的信號。

list-seats
列出當前本機上的所有可用席位

seat-status [NAME...]

顯示簡潔的席位信息,後跟最近的日誌。 如果指定了席位名,那麼僅顯示指定的席位, 否則顯示當前調用者會話所屬的席位。 此命令主要用於輸出人類易讀的信息, 如果你想輸出易於程序分析的信息, 那麼應該使用 show-seat 命令。

show-seat [NAME...]

如果指定了席位名,那麼顯示指定席位的各項屬性值, 否則顯示登陸管理器自身的各項屬性值。 除非使用了 --all 選項, 否則空屬性將被忽略。 還可以使用 --property= 選項來顯示指定的屬性。 此命令主要用於輸出易於程序分析的信息, 如果你想輸出人類易讀的信息, 那麼應該使用 seat-status 命令。

attach NAME DEVICE...

將指定的設備(DEVICE)持久的連接到指定的席位(NAME)上。 設備可以用相對於 /sys 文件系統的設備路徑表示。 要創建一個新席位,至少需要連接一個顯卡。 席位名稱必須以 "seat" 開頭, 後跟 a–z, A–Z, 0–9, "-", "_" 字符。 要想從席位上刪除一個設備, 可以將此設備連接到另一個席位, 或者使用 flush-devices 命令。

flush-devices

刪除所有先前用 attach 命令連接的設備(同時也刪除了所有先前用 attach 命令創建的席位)。 調用此命令之後,所有自動生成的席位將會被保留, 同時所有席位設備將會連接到自動生成的席位上。

terminate-seat NAME...

結束指定席位上的所有會話。 這將殺死指定席位上的所有會話進程, 同時釋放與之關聯的所有資源。

返回值爲 0 表示成功, 非零返回值表示失敗代碼。

Example 1. 查詢用戶狀態

$ loginctl user-status
fatima (1005)
           Since: Sat 2016-04-09 14:23:31 EDT; 54min ago
           State: active
        Sessions: 5 *3
            Unit: user-1005.slice
                  ├─user@1005.service
                    ...
                  ├─session-3.scope
                    ...
                  └─session-5.scope
                    ├─3473 login -- fatima
                    └─3515 -zsh
Apr 09 14:40:30 laptop login[2325]: pam_unix(login:session):
                       session opened for user fatima by LOGIN(uid=0)
Apr 09 14:40:30 laptop login[2325]: LOGIN ON tty3 BY fatima

有 3 與 5 兩個會話。會話 3 是一個圖形會話, 以星號(*)標記。同時還顯示了兩個對應的 scope 單元中的進程樹。

$SYSTEMD_PAGER
指定分頁程序。僅在未指定 --no-pager 選項時有意義。 此變量會覆蓋 $PAGER 的值。 將此變量設爲空字符串或 "cat" 等價於使用 --no-pager 選項。

$SYSTEMD_LESS

用於覆蓋 默認傳遞給 less 程序的命令行選項 ("FRSXMK")。

systemd(1), systemctl(1), systemd-logind.service(8), logind.conf(5)

本頁面中文版由中文 man 手冊頁計劃提供。

翻譯人員:金步國
金步國作品集:http://www.jinbuguo.com
中文 man 手冊頁計劃:https://github.com/man-pages-zh/manpages-zh

systemd 231