Man page - loginctl(1)

Packages contains this manual

Available languages:

en ro zh_TW zh_CN de

Manual

LOGINCTL

NAME
SYNOPSIS
描 述
選 項
命 令
會 話 命 令
使 用 者 命 令
席 位 命 令
退 出 狀 態
例 子
環 境 變 數
參 見
跋

NAME

loginctl - 控 制 systemd 登 入 管 理 器

SYNOPSIS

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-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@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