diff options
Diffstat (limited to 'upstream/fedora-rawhide/man1/userdbctl.1')
-rw-r--r-- | upstream/fedora-rawhide/man1/userdbctl.1 | 48 |
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 |