'\" 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