Manpages

NAME

loginctl - 控 制 systemd 登 錄 管 理 器

SYNOPSIS

描 述

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-session 或 kill-user 連 用 ， 指 定 向 選 中 的 進 程 發 送 什 麼 信 號 。 必 須 設 爲 衆 所 周 知 的 信 號 名 稱 ， 例 如 SIGTERM(默 認 值 ), SIGINT, SIGSTOP 之 類

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

-o, --output= 與 user-status 或 session-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 [AT] 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