1 files changed, 74 insertions, 20 deletions
diff --git a/upstream/fedora-rawhide/man8/pam_systemd.8 b/upstream/fedora-rawhide/man8/pam_systemd.8
index 21a69f0e..07843595 100644
--- a/upstream/fedora-rawhide/man8/pam_systemd.8
+++ b/upstream/fedora-rawhide/man8/pam_systemd.8
@@ -1,5 +1,5 @@
 '\" t
-.TH "PAM_SYSTEMD" "8" "" "systemd 255" "pam_systemd"
+.TH "PAM_SYSTEMD" "8" "" "systemd 256~rc3" "pam_systemd"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -136,15 +136,80 @@ The following options are understood:
 .RS 4
 Takes a string argument which sets the session class\&. The
 \fIXDG_SESSION_CLASS\fR
-environment variable (see below) takes precedence\&. One of
-"user",
-"greeter",
-"lock\-screen"
-or
-"background"\&. See
+environment variable (see below) takes precedence\&. See
 \fBsd_session_get_class\fR(3)
-for details about the session class\&.
+for a way to query the class of a session\&. The following session classes are defined:
 .sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.B Table\ \&1.\ \&Session Classes
+.TS
+allbox tab(:);
+lB lB.
+T{
+Name
+T}:T{
+Explanation
+T}
+.T&
+l l
+l l
+l l
+l l
+l l
+l l
+l l
+l l
+l l.
+T{
+\fBuser\fR
+T}:T{
+A regular interactive user session\&. This is the default class for sessions for which a TTY or X display is known at session registration time\&.
+T}
+T{
+\fBuser\-early\fR
+T}:T{
+Similar to "user" but sessions of this class are not ordered after systemd\-user\-sessions\&.service, i\&.e\&. may be started before regular sessions are allowed to be established\&. This session class is the default for sessions of the root user that would otherwise qualify for the \fBuser\fR class, see above\&. (Added in v256\&.)
+T}
+T{
+\fBuser\-incomplete\fR
+T}:T{
+Similar to "user" but for sessions which are not fully set up yet, i\&.e\&. have no home directory mounted or similar\&. This is used by \fBsystemd-homed.service\fR(8) to allow users to log in via \fBssh\fR before their home directory is mounted, delaying the mount until the user provided the unlock password\&. Sessions of this class are upgraded to the regular \fBuser\fR class once the home directory is activated\&.
+T}
+T{
+\fBgreeter\fR
+T}:T{
+Similar to "user" but for sessions that are spawned by a display manager ephemerally and which prompt the user for login credentials\&.
+T}
+T{
+\fBlock\-screen\fR
+T}:T{
+Similar to "user" but for sessions that are spawned by a display manager ephemerally and which show a lock screen that can be used to unlock locked user accounts or sessions\&.
+T}
+T{
+\fBbackground\fR
+T}:T{
+Used for background sessions, such as those invoked by \fBcron\fR and similar tools\&. This is the default class for sessions for which no TTY or X display is known at session registration time\&.
+T}
+T{
+\fBbackground\-light\fR
+T}:T{
+Similar to \fBbackground\fR, but sessions of this class will not pull in the user@\&.service of the user, and thus possibly have no services of the user running\&. (Added in v256\&.)
+T}
+T{
+\fBmanager\fR
+T}:T{
+The user@\&.service service of the user is registered under this session class\&. (Added in v256\&.)
+T}
+T{
+\fBmanager\-early\fR
+T}:T{
+Similar to \fBmanager\fR, but for the root user\&. Compare with the \fBuser\fR vs\&. \fBuser\-early\fR situation\&. (Added in v256\&.)
+T}
+.TE
+.sp 1
 Added in version 197\&.
 .RE
 .PP
@@ -397,18 +462,7 @@ session   required   pam_unix\&.so
 .\}
 .SH "SEE ALSO"
 .PP
-\fBsystemd\fR(1),
-\fBsystemd-logind.service\fR(8),
-\fBlogind.conf\fR(5),
-\fBloginctl\fR(1),
-\fBpam_systemd_home\fR(8),
-\fBpam.conf\fR(5),
-\fBpam.d\fR(5),
-\fBpam\fR(8),
-\fBpam_loginuid\fR(8),
-\fBsystemd.scope\fR(5),
-\fBsystemd.slice\fR(5),
-\fBsystemd.service\fR(5)
+\fBsystemd\fR(1), \fBsystemd-logind.service\fR(8), \fBlogind.conf\fR(5), \fBloginctl\fR(1), \fBpam_systemd_home\fR(8), \fBpam.conf\fR(5), \fBpam.d\fR(5), \fBpam\fR(8), \fBpam_loginuid\fR(8), \fBsystemd.scope\fR(5), \fBsystemd.slice\fR(5), \fBsystemd.service\fR(5)
 .SH "NOTES"
 .IP " 1." 4
 JSON User Records