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