Merging upstream version 4.23.0.

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 57 insertions, 1 deletions

diff --git a/upstream/opensuse-tumbleweed/man1/userdbctl.1 b/upstream/opensuse-tumbleweed/man1/userdbctl.1
index 874c9445..d4a0813f 100644
--- a/upstream/opensuse-tumbleweed/man1/userdbctl.1
+++ b/upstream/opensuse-tumbleweed/man1/userdbctl.1
@@ -1,5 +1,5 @@
 '\" t
-.TH "USERDBCTL" "1" "" "systemd 254" "userdbctl"
+.TH "USERDBCTL" "1" "" "systemd 255" "userdbctl"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -71,6 +71,8 @@ and
 show only the most important fields\&. Various modes also do not show password hashes\&. Use
 "json"
 to view all fields, including any authentication fields\&.
+.sp
+Added in version 245\&.
 .RE
 .PP
 \fB\-\-json=\fR\fIFORMAT\fR
@@ -82,12 +84,16 @@ or
 "short"\&. If
 "pretty", human\-friendly whitespace and newlines are inserted in the output to make the JSON data more readable\&. If
 "short", all superfluous whitespace is suppressed\&.
+.sp
+Added in version 250\&.
 .RE
 .PP
 \fB\-\-service=\fR\fISERVICE\fR[:\fISERVICE\&...\fR], \fB\-s\fR \fISERVICE\fR:\fISERVICE\&...\fR
 .RS 4
 Controls which services to query for users/groups\&. Takes a list of one or more service names, separated by
 ":"\&. See below for a list of well\-known service names\&. If not specified all available services are queried at once\&.
+.sp
+Added in version 245\&.
 .RE
 .PP
 \fB\-\-with\-nss=\fR\fIBOOL\fR
@@ -97,6 +103,8 @@ Controls whether to include classic glibc/NSS user/group lookups in the output\&
 is used any attempts to resolve or enumerate users/groups provided only via glibc NSS is suppressed\&. If
 \fB\-\-with\-nss=yes\fR
 is specified such users/groups are included in the output (which is the default)\&.
+.sp
+Added in version 245\&.
 .RE
 .PP
 \fB\-\-with\-varlink=\fR\fIBOOL\fR
@@ -107,6 +115,8 @@ Controls whether to include Varlink user/group lookups in the output, i\&.e\&. t
 is used any attempts to resolve or enumerate users/groups provided only via Varlink are suppressed\&. If
 \fB\-\-with\-varlink=yes\fR
 is specified such users/groups are included in the output (which is the default)\&.
+.sp
+Added in version 249\&.
 .RE
 .PP
 \fB\-\-with\-dropin=\fR\fIBOOL\fR
@@ -120,6 +130,8 @@ Controls whether to include user/group lookups in the output that are defined us
 is used these records are suppressed\&. If
 \fB\-\-with\-dropin=yes\fR
 is specified such users/groups are included in the output (which is the default)\&.
+.sp
+Added in version 249\&.
 .RE
 .PP
 \fB\-\-synthesize=\fR\fIBOOL\fR
@@ -128,6 +140,8 @@ Controls whether to synthesize records for the root and nobody users/groups if t
 "yes") such records are implicitly synthesized if otherwise missing since they have special significance to the OS\&. When
 "no"
 this synthesizing is turned off\&.
+.sp
+Added in version 245\&.
 .RE
 .PP
 \fB\-N\fR
@@ -135,11 +149,15 @@ this synthesizing is turned off\&.
 This option is short for
 \fB\-\-with\-nss=no\fR
 \fB\-\-synthesize=no\fR\&. Use this option to show only records that are natively defined as JSON user or group records, with all NSS/glibc compatibility and all implicit synthesis turned off\&.
+.sp
+Added in version 245\&.
 .RE
 .PP
 \fB\-\-multiplexer=\fR\fIBOOL\fR
 .RS 4
 Controls whether to do lookups via the multiplexer service (if specified as true, the default) or do lookups in the client (if specified as false)\&. Using the multiplexer service is typically preferable, since it runs in a locked down sandbox\&.
+.sp
+Added in version 250\&.
 .RE
 .PP
 \fB\-\-chain\fR
@@ -147,6 +165,8 @@ Controls whether to do lookups via the multiplexer service (if specified as true
 When used with the
 \fBssh\-authorized\-keys\fR
 command, this will allow passing an additional command line after the user name that is chain executed after the lookup completed\&. This allows chaining multiple tools that show SSH authorized keys\&.
+.sp
+Added in version 250\&.
 .RE
 .PP
 \fB\-\-no\-pager\fR
@@ -177,6 +197,8 @@ The following commands are understood:
 List all known users records or show details of one or more specified user records\&. Use
 \fB\-\-output=\fR
 to tweak output mode\&.
+.sp
+Added in version 245\&.
 .RE
 .PP
 \fBgroup\fR [\fIGROUP\fR\&...]
@@ -184,6 +206,8 @@ to tweak output mode\&.
 List all known group records or show details of one or more specified group records\&. Use
 \fB\-\-output=\fR
 to tweak output mode\&.
+.sp
+Added in version 245\&.
 .RE
 .PP
 \fBusers\-in\-group\fR [\fIGROUP\fR\&...]
@@ -191,6 +215,8 @@ to tweak output mode\&.
 List users that are members of the specified groups\&. If no groups are specified list all user/group memberships defined\&. Use
 \fB\-\-output=\fR
 to tweak output mode\&.
+.sp
+Added in version 245\&.
 .RE
 .PP
 \fBgroups\-of\-user\fR [\fIUSER\fR\&...]
@@ -202,16 +228,22 @@ and
 are equivalent)\&. Use
 \fB\-\-output=\fR
 to tweak output mode\&.
+.sp
+Added in version 245\&.
 .RE
 .PP
 \fBservices\fR
 .RS 4
 List all services currently providing user/group definitions to the system\&. See below for a list of well\-known services providing user information\&.
+.sp
+Added in version 245\&.
 .RE
 .PP
 \fBssh\-authorized\-keys\fR
 .RS 4
 Show SSH authorized keys for this account\&. This command is intended to be used to allow the SSH daemon to pick up authorized keys from user records, see below\&.
+.sp
+Added in version 245\&.
 .RE
 .SH "WELL\-KNOWN SERVICES"
 .PP
@@ -226,6 +258,8 @@ This service is provided by the system service manager itself (i\&.e\&. PID 1) a
 setting in service unit files available to the system (see
 \fBsystemd.exec\fR(5)
 for details about this setting)\&.
+.sp
+Added in version 245\&.
 .RE
 .PP
 \fBio\&.systemd\&.Home\fR
@@ -233,6 +267,8 @@ for details about this setting)\&.
 This service is provided by
 \fBsystemd-homed.service\fR(8)
 and makes all users (and their groups) belonging to home directories managed by that service available to the system\&.
+.sp
+Added in version 245\&.
 .RE
 .PP
 \fBio\&.systemd\&.Machine\fR
@@ -240,6 +276,8 @@ and makes all users (and their groups) belonging to home directories managed by
 This service is provided by
 \fBsystemd-machined.service\fR(8)
 and synthesizes records for all users/groups used by a container that employs user namespacing\&.
+.sp
+Added in version 246\&.
 .RE
 .PP
 \fBio\&.systemd\&.Multiplexer\fR
@@ -253,6 +291,8 @@ uses this service preferably, too, unless
 or
 \fB\-\-service=\fR
 are used, in which case finer control over the services to talk to is required\&.
+.sp
+Added in version 245\&.
 .RE
 .PP
 \fBio\&.systemd\&.NameServiceSwitch\fR
@@ -264,6 +304,8 @@ and converts classic NSS/glibc user and group records to JSON user/group records
 to disable this compatibility, see above\&. Note that compatibility is actually provided in both directions:
 \fBnss-systemd\fR(8)
 will automatically synthesize classic NSS/glibc user/group records from all JSON user/group records provided to the system, thus using both APIs is mostly equivalent and provides access to the same data, however the NSS/glibc APIs necessarily expose a more reduced set of fields only\&.
+.sp
+Added in version 245\&.
 .RE
 .PP
 \fBio\&.systemd\&.DropIn\fR
@@ -275,6 +317,8 @@ and picks up JSON user/group records from
 /run/userdb/,
 /run/host/userdb/,
 /usr/lib/userdb/\&.
+.sp
+Added in version 249\&.
 .RE
 .PP
 Note that
@@ -462,6 +506,12 @@ will be ignored by the executable, and needs to be handled by the pager\&.
 This option instructs the pager to not send termcap initialization and deinitialization strings to the terminal\&. It is set by default to allow command output to remain visible in the terminal even after the pager exits\&. Nevertheless, this prevents some pager functionality from working, in particular paged output cannot be scrolled with the mouse\&.
 .RE
 .sp
+Note that setting the regular
+\fI$LESS\fR
+environment variable has no effect for
+\fBless\fR
+invocations by systemd tools\&.
+.sp
 See
 \fBless\fR(1)
 for more discussion\&.
@@ -473,6 +523,12 @@ Override the charset passed to
 \fBless\fR
 (by default
 "utf\-8", if the invoking terminal is determined to be UTF\-8 compatible)\&.
+.sp
+Note that setting the regular
+\fI$LESSCHARSET\fR
+environment variable has no effect for
+\fBless\fR
+invocations by systemd tools\&.
 .RE
 .PP
 \fI$SYSTEMD_PAGERSECURE\fR