summaryrefslogtreecommitdiffstats
path: root/upstream/fedora-rawhide/man1/userdbctl.1
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/fedora-rawhide/man1/userdbctl.1')
-rw-r--r--upstream/fedora-rawhide/man1/userdbctl.148
1 files changed, 32 insertions, 16 deletions
diff --git a/upstream/fedora-rawhide/man1/userdbctl.1 b/upstream/fedora-rawhide/man1/userdbctl.1
index a5445353..b77cbec6 100644
--- a/upstream/fedora-rawhide/man1/userdbctl.1
+++ b/upstream/fedora-rawhide/man1/userdbctl.1
@@ -1,5 +1,5 @@
'\" t
-.TH "USERDBCTL" "1" "" "systemd 255" "userdbctl"
+.TH "USERDBCTL" "1" "" "systemd 256~rc3" "userdbctl"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -41,7 +41,7 @@ definitions), and classic UNIX NSS/glibc user and group records\&. This tool is
.PP
The following options are understood:
.PP
-\fB\-\-output=\fR\fIMODE\fR
+\fB\-\-output=\fR\fB\fIMODE\fR\fR
.RS 4
Choose the output mode, takes one of
"classic",
@@ -75,7 +75,7 @@ to view all fields, including any authentication fields\&.
Added in version 245\&.
.RE
.PP
-\fB\-\-json=\fR\fIFORMAT\fR
+\fB\-\-json=\fR\fB\fIFORMAT\fR\fR
.RS 4
Selects JSON output mode (like
\fB\-\-output=json\fR) and selects the precise display mode\&. Takes one of
@@ -88,7 +88,7 @@ or
Added in version 250\&.
.RE
.PP
-\fB\-\-service=\fR\fISERVICE\fR[:\fISERVICE\&...\fR], \fB\-s\fR \fISERVICE\fR:\fISERVICE\&...\fR
+\fB\-\-service=\fR\fB\fISERVICE\fR\fR\fB[:\fISERVICE\&...\fR]\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\&.
@@ -96,7 +96,7 @@ Controls which services to query for users/groups\&. Takes a list of one or more
Added in version 245\&.
.RE
.PP
-\fB\-\-with\-nss=\fR\fIBOOL\fR
+\fB\-\-with\-nss=\fR\fB\fIBOOL\fR\fR
.RS 4
Controls whether to include classic glibc/NSS user/group lookups in the output\&. If
\fB\-\-with\-nss=no\fR
@@ -107,7 +107,7 @@ is specified such users/groups are included in the output (which is the default)
Added in version 245\&.
.RE
.PP
-\fB\-\-with\-varlink=\fR\fIBOOL\fR
+\fB\-\-with\-varlink=\fR\fB\fIBOOL\fR\fR
.RS 4
Controls whether to include Varlink user/group lookups in the output, i\&.e\&. those done via the
\m[blue]\fBUser/Group Record Lookup API via Varlink\fR\m[]\&\s-2\u[3]\d\s+2\&. If
@@ -119,7 +119,7 @@ is specified such users/groups are included in the output (which is the default)
Added in version 249\&.
.RE
.PP
-\fB\-\-with\-dropin=\fR\fIBOOL\fR
+\fB\-\-with\-dropin=\fR\fB\fIBOOL\fR\fR
.RS 4
Controls whether to include user/group lookups in the output that are defined using drop\-in files in
/etc/userdb/,
@@ -134,7 +134,7 @@ is specified such users/groups are included in the output (which is the default)
Added in version 249\&.
.RE
.PP
-\fB\-\-synthesize=\fR\fIBOOL\fR
+\fB\-\-synthesize=\fR\fB\fIBOOL\fR\fR
.RS 4
Controls whether to synthesize records for the root and nobody users/groups if they aren\*(Aqt defined otherwise\&. By default (or
"yes") such records are implicitly synthesized if otherwise missing since they have special significance to the OS\&. When
@@ -153,7 +153,7 @@ This option is short for
Added in version 245\&.
.RE
.PP
-\fB\-\-multiplexer=\fR\fIBOOL\fR
+\fB\-\-multiplexer=\fR\fB\fIBOOL\fR\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
@@ -377,7 +377,7 @@ On success, 0 is returned, a non\-zero failure code otherwise\&.
.PP
\fI$SYSTEMD_LOG_LEVEL\fR
.RS 4
-The maximum log level of emitted messages (messages with a higher log level, i\&.e\&. less important ones, will be suppressed)\&. Either one of (in order of decreasing importance)
+The maximum log level of emitted messages (messages with a higher log level, i\&.e\&. less important ones, will be suppressed)\&. Takes a comma\-separated list of values\&. A value may be either one of (in order of decreasing importance)
\fBemerg\fR,
\fBalert\fR,
\fBcrit\fR,
@@ -387,7 +387,15 @@ The maximum log level of emitted messages (messages with a higher log level, i\&
\fBinfo\fR,
\fBdebug\fR, or an integer in the range 0\&...7\&. See
\fBsyslog\fR(3)
-for more information\&.
+for more information\&. Each value may optionally be prefixed with one of
+\fBconsole\fR,
+\fBsyslog\fR,
+\fBkmsg\fR
+or
+\fBjournal\fR
+followed by a colon to set the maximum log level for that specific log target (e\&.g\&.
+\fBSYSTEMD_LOG_LEVEL=debug,console:info\fR
+specifies to log at debug level except when logging to the console which should be at info level)\&. Note that the global maximum log level takes priority over any per target maximum log levels\&.
.RE
.PP
\fI$SYSTEMD_LOG_COLOR\fR
@@ -506,6 +514,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\&.
@@ -517,6 +531,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
@@ -572,11 +592,7 @@ and other conditions\&.
.RE
.SH "SEE ALSO"
.PP
-\fBsystemd\fR(1),
-\fBsystemd-userdbd.service\fR(8),
-\fBsystemd-homed.service\fR(8),
-\fBnss-systemd\fR(8),
-\fBgetent\fR(1)
+\fBsystemd\fR(1), \fBsystemd-userdbd.service\fR(8), \fBsystemd-homed.service\fR(8), \fBnss-systemd\fR(8), \fBgetent\fR(1)
.SH "NOTES"
.IP " 1." 4
JSON User Records