'\" t
.TH "LOGINCTL" "1" "" "systemd 231" "loginctl"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
loginctl \- 控制 systemd 登錄管理器
.SH "SYNOPSIS"
.HP \w'\fBloginctl\fR\ 'u
\fBloginctl\fR [OPTIONS...] {COMMAND} [NAME...]
.SH "描述"
.PP
\fBloginctl\fR
可用於內省與控制
\fBsystemd\fR(1)
登錄管理服務
\fBsystemd-logind.service\fR(8)
.SH "選項"
.PP
能夠識別的命令行選項如下：
.PP
\fB\-\-no\-ask\-password\fR
.RS 4
在執行特權操作時不向用戶索要密碼。
.RE
.PP
\fB\-p\fR, \fB\-\-property=\fR
.RS 4
在顯示 session/user/seat 屬性時， 僅顯示此處指定的屬性。 若未指定，則顯示全部屬性。 參數必須是屬性名(例如"Sessions")。 可以多次使用此選項以指定多個屬性。
.RE
.PP
\fB\-\-value\fR
.RS 4
在使用
\fBshow\fR
顯示屬性時， 僅顯示屬性值，而不顯示屬性名及等號。
.RE
.PP
\fB\-a\fR, \fB\-\-all\fR
.RS 4
在顯示 session/user/seat 屬性時， 顯示全部屬性，無論這些屬性是否已經被設置。
.RE
.PP
\fB\-l\fR, \fB\-\-full\fR
.RS 4
在顯示進程樹的時候，不對超長行進行截斷。
.RE
.PP
\fB\-\-kill\-who=\fR
.RS 4
與
\fBkill\-session\fR
連用，指定殺死哪個進程。
\fBleader\fR
表示僅殺死會話的領導進程；
\fBall\fR
表示殺死會話的所有進程。 默認值爲
\fBall\fR
.RE
.PP
\fB\-s\fR, \fB\-\-signal=\fR
.RS 4
與
\fBkill\-session\fR
或
\fBkill\-user\fR
連用， 指定向選中的進程發送什麼信號。 必須設爲衆所周知的信號名稱，例如
\fBSIGTERM\fR(默認值),
\fBSIGINT\fR,
\fBSIGSTOP\fR
之類
.RE
.PP
\fB\-n\fR, \fB\-\-lines=\fR
.RS 4
與
\fBuser\-status\fR
或
\fBsession\-status\fR
連用， 控制顯示多少行日誌(從最新的一條日誌開始計算)。 必須設爲一個正整數，默認值是"10"。
.RE
.PP
\fB\-o\fR, \fB\-\-output=\fR
.RS 4
與
\fBuser\-status\fR
或
\fBsession\-status\fR
連用， 控制日誌的輸出格式。 可用值參見
\fBjournalctl\fR(1)
手冊。 默認爲
"short"
.RE
.PP
\fB\-H\fR, \fB\-\-host=\fR
.RS 4
操作指定的遠程主機。可以僅指定一個主機名(hostname)， 也可以使用
"username@hostname"
格式。 hostname 後面還可以加上容器名(以冒號分隔)， 也就是形如
"hostname:container"
的格式， 以表示直接連接到指定主機的指定容器內。 操作將通過SSH協議進行，以確保安全。 可以通過
\fBmachinectl \-H \fR\fB\fIHOST\fR\fR
命令列出遠程主機上的所有容器名稱。
.RE
.PP
\fB\-M\fR, \fB\-\-machine=\fR
.RS 4
在本地容器內執行操作。 必須明確指定容器的名稱。
.RE
.PP
\fB\-\-no\-pager\fR
.RS 4
不將程序的輸出內容管道(pipe)給分頁程序。
.RE
.PP
\fB\-\-no\-legend\fR
.RS 4
不輸出列標題， 也就是不在輸出列表的頭部和尾部顯示字段的名稱。
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
顯示簡短的幫助信息並退出。
.RE
.PP
\fB\-\-version\fR
.RS 4
顯示簡短的版本信息並退出。
.RE
.SH "命令"
.PP
能夠識別的命令如下：
.SS "會話命令"
.PP
\fBlist\-sessions\fR
.RS 4
列出當前所有的會話。這是默認命令。
.RE
.PP
\fBsession\-status\fR [\fIID\fR\&.\&.\&.]
.RS 4
顯示簡潔的會話狀態信息，後跟最近的日誌。 如果指定了會話ID，那麼僅顯示指定的會話， 否則顯示當前調用者的會話。 此命令主要用於輸出人類易讀的信息， 如果你想輸出易於程序分析的信息， 那麼應該使用
\fBshow\-session\fR
命令
.RE
.PP
\fBshow\-session\fR [\fIID\fR\&.\&.\&.]
.RS 4
如果指定了會話ID，那麼顯示指定會話的各項屬性值， 否則顯示登陸管理器自身的各項屬性值。 除非使用了
\fB\-\-all\fR
選項， 否則空屬性將被忽略。 還可以使用
\fB\-\-property=\fR
選項指定僅顯示個別屬性。 此命令主要用於輸出易於程序分析的信息， 如果你想輸出人類易讀的信息， 那麼應該使用
\fBsession\-status\fR
命令。
.RE
.PP
\fBactivate\fR [\fIID\fR]
.RS 4
激活會話。 也就是將處於後臺的會話切換到前臺(如果同席位的另一個會話正處於前臺)。 如果指定了會話ID， 那麼將激活指定的會話， 否則將激活當前調用者的會話。
.RE
.PP
\fBlock\-session\fR [\fIID\fR\&.\&.\&.], \fBunlock\-session\fR [\fIID\fR\&.\&.\&.]
.RS 4
鎖定/解鎖會話(如果會話支持屏幕鎖)。 如果指定了會話ID，那麼將鎖定/解鎖指定的會話， 否則將鎖定/解鎖當前調用者的會話。
.RE
.PP
\fBlock\-sessions\fR, \fBunlock\-sessions\fR
.RS 4
鎖定/解鎖所有支持屏幕鎖的會話。
.RE
.PP
\fBterminate\-session\fR \fIID\fR\&.\&.\&.
.RS 4
結束指定的會話。 也就是殺死指定會話的所有進程、釋放所有與此會話相關的資源。
.RE
.PP
\fBkill\-session\fR \fIID\fR\&.\&.\&.
.RS 4
向指定的會話進程發送信號。 使用
\fB\-\-kill\-who=\fR
指定目標進程， 使用
\fB\-\-signal=\fR
指定要發送的信號。
.RE
.SS "用戶命令"
.PP
\fBlist\-users\fR
.RS 4
列出當前登錄的用戶
.RE
.PP
\fBuser\-status\fR [\fIUSER\fR\&.\&.\&.]
.RS 4
顯示簡潔的已登錄用戶信息，後跟最近的日誌。 如果指定了用戶名或UID， 那麼僅顯示指定的用戶， 否則顯示當前調用者的用戶。 此命令主要用於輸出人類易讀的信息， 如果你想輸出易於程序分析的信息， 那麼應該使用
\fBshow\-user\fR
命令。
.RE
.PP
\fBshow\-user\fR [\fIUSER\fR\&.\&.\&.]
.RS 4
如果指定了用戶名或UID，那麼顯示指定用戶的各項屬性值， 否則顯示登陸管理器自身的各項屬性值。 除非使用了
\fB\-\-all\fR
選項， 否則空屬性將被忽略。 還可以使用
\fB\-\-property=\fR
選項來顯示指定的屬性。 此命令主要用於輸出易於程序分析的信息， 如果你想輸出人類易讀的信息， 那麼應該使用
\fBuser\-status\fR
命令。
.RE
.PP
\fBenable\-linger\fR [\fIUSER\fR\&.\&.\&.], \fBdisable\-linger\fR [\fIUSER\fR\&.\&.\&.]
.RS 4
啓用/禁止用戶逗留(相當於保持登錄狀態)。 如果指定了用戶名或UID， 那麼系統將會在啓動時自動爲這些用戶派生出用戶管理器， 並且在用戶登出後繼續保持運行。 這樣就可以允許未登錄的用戶在後臺運行持續時間很長的服務。 如果沒有指定任何參數， 那麼將作用於當前調用者的用戶。
.sp
參見
\fBlogind.conf\fR(5)
中的
\fIKillUserProcesses=\fR
指令。
.RE
.PP
\fBterminate\-user\fR \fIUSER\fR\&.\&.\&.
.RS 4
結束指定用戶的所有會話。 這將殺死該用戶的所有會話中的所有進程， 同時釋放與此用戶有關的所有資源。
.RE
.PP
\fBkill\-user\fR \fIUSER\fR\&.\&.\&.
.RS 4
向指定用戶的所有進程發送
\fB\-\-signal=\fR
選項指定的信號。
.RE
.SS "席位命令"
.PP
\fBlist\-seats\fR
.RS 4
列出當前本機上的所有可用席位
.RE
.PP
\fBseat\-status\fR [\fINAME\fR\&.\&.\&.]
.RS 4
顯示簡潔的席位信息，後跟最近的日誌。 如果指定了席位名，那麼僅顯示指定的席位， 否則顯示當前調用者會話所屬的席位。 此命令主要用於輸出人類易讀的信息， 如果你想輸出易於程序分析的信息， 那麼應該使用
\fBshow\-seat\fR
命令。
.RE
.PP
\fBshow\-seat\fR [\fINAME\fR\&.\&.\&.]
.RS 4
如果指定了席位名，那麼顯示指定席位的各項屬性值， 否則顯示登陸管理器自身的各項屬性值。 除非使用了
\fB\-\-all\fR
選項， 否則空屬性將被忽略。 還可以使用
\fB\-\-property=\fR
選項來顯示指定的屬性。 此命令主要用於輸出易於程序分析的信息， 如果你想輸出人類易讀的信息， 那麼應該使用
\fBseat\-status\fR
命令。
.RE
.PP
\fBattach\fR \fINAME\fR \fIDEVICE\fR\&.\&.\&.
.RS 4
將指定的設備(DEVICE)持久的連接到指定的席位(NAME)上。 設備可以用相對於
/sys
文件系統的設備路徑表示。 要創建一個新席位，至少需要連接一個顯卡。 席位名稱必須以
"seat"
開頭， 後跟 a\(enz, A\(enZ, 0\(en9, "\-", "_" 字符。 要想從席位上刪除一個設備， 可以將此設備連接到另一個席位， 或者使用
\fBflush\-devices\fR
命令。
.RE
.PP
\fBflush\-devices\fR
.RS 4
刪除所有先前用
\fBattach\fR
命令連接的設備(同時也刪除了所有先前用
\fBattach\fR
命令創建的席位)。 調用此命令之後，所有自動生成的席位將會被保留， 同時所有席位設備將會連接到自動生成的席位上。
.RE
.PP
\fBterminate\-seat\fR \fINAME\fR\&.\&.\&.
.RS 4
結束指定席位上的所有會話。 這將殺死指定席位上的所有會話進程， 同時釋放與之關聯的所有資源。
.RE
.SH "退出狀態"
.PP
返回值爲 0 表示成功， 非零返回值表示失敗代碼。
.SH "例子"
.PP
\fBExample\ \&1.\ \&查詢用戶狀態\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ 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
.fi
.if n \{\
.RE
.\}
.PP
有 3 與 5 兩個會話。會話 3 是一個圖形會話， 以星號(*)標記。同時還顯示了兩個對應的 scope 單元中的進程樹。
.SH "環境變量"
.PP
\fI$SYSTEMD_PAGER\fR
.RS 4
指定分頁程序。僅在未指定
\fB\-\-no\-pager\fR
選項時有意義。 此變量會覆蓋
\fI$PAGER\fR
的值。 將此變量設爲空字符串或
"cat"
等價於使用
\fB\-\-no\-pager\fR
選項。
.RE
.PP
\fI$SYSTEMD_LESS\fR
.RS 4
用於覆蓋 默認傳遞給
\fBless\fR
程序的命令行選項 ("FRSXMK")。
.RE
.SH "參見"
.PP
\fBsystemd\fR(1),
\fBsystemctl\fR(1),
\fBsystemd-logind.service\fR(8),
\fBlogind.conf\fR(5)
.SH "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.PP
翻譯人員：金步國
.br
金步國作品集：http://www.jinbuguo.com
.br
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR