X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fpam_systemd.xml;h=4e5cdf248b2e0823c0d6c128e79e4e558cf78541;hp=c07b46bab24a386a31ba36899bf15b2ddb6c89e8;hb=9c33d34fe4cd0bc58ea12e5258e595647c9e0b29;hpb=19c5f19d69bb5f520fa7213239490c55de06d99d
diff --git a/man/pam_systemd.xml b/man/pam_systemd.xml
index c07b46bab..4e5cdf248 100644
--- a/man/pam_systemd.xml
+++ b/man/pam_systemd.xml
@@ -8,20 +8,20 @@
Copyright 2010 Lennart Poettering
systemd is free software; you can redistribute it and/or modify it
- under the terms of the GNU General Public License as published by
- the Free Software Foundation; either version 2 of the License, or
+ under the terms of the GNU Lesser General Public License as published by
+ the Free Software Foundation; either version 2.1 of the License, or
(at your option) any later version.
systemd is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- General Public License for more details.
+ Lesser General Public License for more details.
- You should have received a copy of the GNU General Public License
+ You should have received a copy of the GNU Lesser General Public License
along with systemd; If not, see .
-->
-
+pam_systemd
@@ -44,21 +44,20 @@
pam_systemd
- Register user sessions in the systemd control group hierarchy
+ Register user sessions in the systemd login manager
-
- pam_systemd.so
-
+ pam_systemd.soDescriptionpam_systemd registers user
- sessions in the systemd control group
- hierarchy.
+ sessions in the systemd login manager
+ systemd-logind.service8,
+ and hence the systemd control group hierarchy.
On login, this module ensures the following:
@@ -98,7 +97,7 @@
control group are killed and the control group
is removed.
- If last subgroup of the
+ If the last subgroup of the
/user/$USER control group
was removed the
$XDG_RUNTIME_DIR directory
@@ -117,7 +116,7 @@
The following options are understood:
-
+
@@ -132,13 +131,13 @@
- Takes a comma
- separated list of user names or
- numeric user ids as argument. If this
- option is used the effect of the
+ Takes a comma-separated
+ list of usernames or
+ numeric user IDs as argument. If this
+ option is used, the effect of the
options
will apply only to the listed
- users. If this option is not used the
+ users. If this option is not used, the
option applies to all local
users. Note that
@@ -150,13 +149,13 @@
- Takes a comma
- separated list of user names or
- numeric user ids as argument. Users
+ Takes a comma-separated
+ list of usernames or
+ numeric user IDs as argument. Users
listed in this argument will not be
subject to the effect of
- . Note
- that that this option takes precedence
+ .
+ Note that this option takes precedence
over
, and
hence whatever is listed for
@@ -170,8 +169,8 @@
- Takes a comma
- separated list of control group
+ Takes a comma-separated
+ list of control group
controllers in which hierarchies a
user/session control group will be
created by default for each user
@@ -184,14 +183,23 @@
- Takes a comma
- separated list of control group
+ Takes a comma-separated
+ list of control group
controllers in which hierarchies the
logged in processes will be reset to
the root control
group.
+
+
+
+ Takes a string
+ argument which sets the session class.
+ The XDG_SESSION_CLASS environmental variable
+ takes precedence.
+
+
@@ -214,7 +222,7 @@
configured system-wide in
logind.conf5. The
former kills processes of a session as soon as it
- ends, the latter kills processes as soon as the last
+ ends; the latter kills processes as soon as the last
session of the user ends.If the options are omitted they default to
@@ -237,12 +245,12 @@
The following environment variables are set for the processes of the user's session:
-
+ $XDG_SESSION_IDA session identifier,
- suitable to be used in file names. The
+ suitable to be used in filenames. The
string itself should be considered
opaque, although often it is just the
audit session ID as reported by
@@ -271,13 +279,13 @@
in again, the directory contents will
have been lost in between, but
applications should not rely on this
- behaviour and must be able to deal with
+ behavior and must be able to deal with
stale files. To store session-private
- data in this directory the user should
+ data in this directory, the user should
include the value of $XDG_SESSION_ID
in the filename. This directory shall
be used for runtime file system
- objects such as AF_UNIX sockets,
+ objects such as AF_UNIX sockets,
FIFOs, PID files and similar. It is
guaranteed that this directory is
local and offers the greatest possible
@@ -304,12 +312,14 @@ session required pam_systemd.so kill-session-processes=1
See Also
+ systemd1,
+ systemd-logind.service8,
+ logind.conf5,
+ loginctl1,
pam.conf5,
pam.d5,
pam8,
- pam_loginuid8,
- logind.conf5,
- systemd1
+ pam_loginuid8