diff options
Diffstat (limited to 'upstream/opensuse-tumbleweed/man1/systemd.1')
| -rw-r--r-- | upstream/opensuse-tumbleweed/man1/systemd.1 | 92 |
1 files changed, 91 insertions, 1 deletions
diff --git a/upstream/opensuse-tumbleweed/man1/systemd.1 b/upstream/opensuse-tumbleweed/man1/systemd.1 index f187d58f..fe96f7e2 100644 --- a/upstream/opensuse-tumbleweed/man1/systemd.1 +++ b/upstream/opensuse-tumbleweed/man1/systemd.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD" "1" "" "systemd 254" "systemd" +.TH "SYSTEMD" "1" "" "systemd 255" "systemd" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -517,6 +517,8 @@ Reboots userspace, starts the soft\-reboot\&.target unit\&. This is mostly equivalent to \fBsystemctl start soft\-reboot\&.target \-\-job\-mode=replace\-irreversibly\fR\&. +.sp +Added in version 254\&. .RE .PP \fBSIGRTMIN+13\fR @@ -542,6 +544,8 @@ Immediately reboots the machine with kexec\&. \fBSIGRTMIN+17\fR .RS 4 Immediately reboots the userspace\&. +.sp +Added in version 254\&. .RE .PP \fBSIGRTMIN+20\fR @@ -574,11 +578,15 @@ on the kernel command line, or the value specified with \fBLogLevel=\fR in the configuration file, or the built\-in default of "info"\&. +.sp +Added in version 239\&. .RE .PP \fBSIGRTMIN+24\fR .RS 4 Immediately exits the manager (only available for \-\-user instances)\&. +.sp +Added in version 195\&. .RE .PP \fBSIGRTMIN+25\fR @@ -589,6 +597,8 @@ except that it will be done asynchronously\&. .sp The systemd system manager treats this signal the same way as \fBSIGTERM\fR\&. +.sp +Added in version 250\&. .RE .PP \fBSIGRTMIN+26\fR @@ -598,6 +608,8 @@ Restores the log target to its configured value\&. The configured value is deriv on the kernel command line, or the value specified with \fBLogTarget=\fR in the configuration file, or the built\-in default\&. +.sp +Added in version 239\&. .RE .PP \fBSIGRTMIN+27\fR, \fBSIGRTMIN+28\fR @@ -615,6 +627,8 @@ on \fIsystemd\&.log_target=kmsg\fR on \fBSIGRTMIN+28\fR) on the kernel command line\&. +.sp +Added in version 239\&. .RE .SH "ENVIRONMENT" .PP @@ -673,6 +687,8 @@ A boolean\&. If true, console log messages will be prefixed with a timestamp\&. .sp This can be overridden with \fB\-\-log\-time=\fR\&. +.sp +Added in version 246\&. .RE .PP \fI$SYSTEMD_LOG_LOCATION\fR @@ -686,6 +702,8 @@ This can be overridden with \fI$SYSTEMD_LOG_TID\fR .RS 4 A boolean\&. If true, messages will be prefixed with the current numerical thread ID (TID)\&. +.sp +Added in version 247\&. .RE .PP \fI$SYSTEMD_LOG_TARGET\fR @@ -715,6 +733,8 @@ This can be overridden with .RS 4 Whether to ratelimit kmsg or not\&. Takes a boolean\&. Defaults to "true"\&. If disabled, systemd will not ratelimit messages written to kmsg\&. +.sp +Added in version 254\&. .RE .PP \fI$XDG_CONFIG_HOME\fR, \fI$XDG_CONFIG_DIRS\fR, \fI$XDG_DATA_HOME\fR, \fI$XDG_DATA_DIRS\fR @@ -789,6 +809,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\&. @@ -800,6 +826,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 @@ -902,22 +934,30 @@ is honored only in the initrd, while the one that is not prefixed only in the ma \fIsystemd\&.dump_core\fR .RS 4 Takes a boolean argument or enables the option if specified without an argument\&. If enabled, the systemd manager (PID 1) dumps core when it crashes\&. Otherwise, no core dump is created\&. Defaults to enabled\&. +.sp +Added in version 233\&. .RE .PP \fIsystemd\&.crash_chvt\fR .RS 4 Takes a positive integer, or a boolean argument\&. Can be also specified without an argument, with the same effect as a positive boolean\&. If a positive integer (in the range 1\(en63) is specified, the system manager (PID 1) will activate the specified virtual terminal when it crashes\&. Defaults to disabled, meaning that no such switch is attempted\&. If set to enabled, the virtual terminal the kernel messages are written to is used instead\&. +.sp +Added in version 233\&. .RE .PP \fIsystemd\&.crash_shell\fR .RS 4 Takes a boolean argument or enables the option if specified without an argument\&. If enabled, the system manager (PID 1) spawns a shell when it crashes, after a 10s delay\&. Otherwise, no shell is spawned\&. Defaults to disabled, for security reasons, as the shell is not protected by password authentication\&. +.sp +Added in version 233\&. .RE .PP \fIsystemd\&.crash_reboot\fR .RS 4 Takes a boolean argument or enables the option if specified without an argument\&. If enabled, the system manager (PID 1) will reboot the machine automatically when it crashes, after a 10s delay\&. Otherwise, the system will hang indefinitely\&. Defaults to disabled, in order to avoid a reboot loop\&. If combined with \fIsystemd\&.crash_shell\fR, the system is rebooted after the shell exits\&. +.sp +Added in version 227\&. .RE .PP \fIsystemd\&.confirm_spawn\fR @@ -925,6 +965,8 @@ Takes a boolean argument or enables the option if specified without an argument\ Takes a boolean argument or a path to the virtual console where the confirmation messages should be emitted\&. Can be also specified without an argument, with the same effect as a positive boolean\&. If enabled, the system manager (PID 1) asks for confirmation when spawning processes using \fB/dev/console\fR\&. If a path or a console name (such as "ttyS0") is provided, the virtual console pointed to by this path or described by the give name will be used instead\&. Defaults to disabled\&. +.sp +Added in version 233\&. .RE .PP \fIsystemd\&.service_watchdogs=\fR @@ -934,6 +976,8 @@ Takes a boolean argument\&. If disabled, all service runtime watchdogs (\fBWatch or \fBStartLimitAction=\fR) are ignored by the system manager (PID 1); see \fBsystemd.service\fR(5)\&. Defaults to enabled, i\&.e\&. watchdogs and failure actions are processed normally\&. The hardware watchdog is not affected by this option\&. +.sp +Added in version 237\&. .RE .PP \fIsystemd\&.show_status\fR @@ -952,6 +996,8 @@ is passed as kernel command line option, in which case it defaults to \fBerror\fR\&. If specified overrides the system manager configuration file option \fBShowStatus=\fR, see \fBsystemd-system.conf\fR(5)\&. +.sp +Added in version 233\&. .RE .PP \fIsystemd\&.status_unit_format=\fR @@ -966,6 +1012,8 @@ as the value\&. If \fBcombined\fR, the system manager will use unit names and description in status messages\&. When specified, overrides the system manager configuration file option \fBStatusUnitFormat=\fR, see \fBsystemd-system.conf\fR(5)\&. +.sp +Added in version 243\&. .RE .PP \fIsystemd\&.log_color\fR, \fIsystemd\&.log_level=\fR, \fIsystemd\&.log_location\fR, \fIsystemd\&.log_target=\fR, \fIsystemd\&.log_time\fR, \fIsystemd\&.log_tid\fR, \fIsystemd\&.log_ratelimit_kmsg\fR @@ -1022,6 +1070,8 @@ Takes a string argument in the form VARIABLE=VALUE\&. May be used to set default \fIsystemd\&.machine_id=\fR .RS 4 Takes a 32 character hex value to be used for setting the machine\-id\&. Intended mostly for network booting where the same machine\-id is desired for every boot\&. +.sp +Added in version 229\&. .RE .PP \fIsystemd\&.set_credential=\fR, \fIsystemd\&.set_credential_binary=\fR @@ -1042,11 +1092,15 @@ parameter takes binary data encoded in Base64\&. Note that the kernel command li For further information see \m[blue]\fBSystem and Service Credentials\fR\m[]\&\s-2\u[8]\d\s+2 documentation\&. +.sp +Added in version 251\&. .RE .PP \fIsystemd\&.import_credentials=\fR .RS 4 Takes a boolean argument\&. If false disables importing credentials from the kernel command line, the DMI/SMBIOS OEM string table, the qemu_fw_cfg subsystem or the EFI kernel stub\&. +.sp +Added in version 251\&. .RE .PP \fIquiet\fR @@ -1054,12 +1108,16 @@ Takes a boolean argument\&. If false disables importing credentials from the ker Turn off status output at boot, much like \fIsystemd\&.show_status=no\fR would\&. Note that this option is also read by the kernel itself and disables kernel log output\&. Passing this option hence turns off the usual output from both the system manager and the kernel\&. +.sp +Added in version 186\&. .RE .PP \fIdebug\fR .RS 4 Turn on debugging output\&. This is equivalent to \fIsystemd\&.log_level=debug\fR\&. Note that this option is also read by the kernel itself and enables kernel debug output\&. Passing this option hence turns on the debug output from both the system manager and the kernel\&. +.sp +Added in version 205\&. .RE .PP \fIemergency\fR, \fIrd\&.emergency\fR, \fI\-b\fR @@ -1068,6 +1126,8 @@ Boot into emergency mode\&. This is equivalent to \fIsystemd\&.unit=emergency\&.target\fR or \fIrd\&.systemd\&.unit=emergency\&.target\fR, respectively, and provided for compatibility reasons and to be easier to type\&. +.sp +Added in version 186\&. .RE .PP \fIrescue\fR, \fIrd\&.rescue\fR, \fIsingle\fR, \fIs\fR, \fIS\fR, \fI1\fR @@ -1076,6 +1136,8 @@ Boot into rescue mode\&. This is equivalent to \fIsystemd\&.unit=rescue\&.target\fR or \fIrd\&.systemd\&.unit=rescue\&.target\fR, respectively, and provided for compatibility reasons and to be easier to type\&. +.sp +Added in version 186\&. .RE .PP \fI2\fR, \fI3\fR, \fI4\fR, \fI5\fR @@ -1085,6 +1147,8 @@ Boot into the specified legacy SysV runlevel\&. These are equivalent to \fIsystemd\&.unit=runlevel3\&.target\fR, \fIsystemd\&.unit=runlevel4\&.target\fR, and \fIsystemd\&.unit=runlevel5\&.target\fR, respectively, and provided for compatibility reasons and to be easier to type\&. +.sp +Added in version 186\&. .RE .PP \fIlocale\&.LANG=\fR, \fIlocale\&.LANGUAGE=\fR, \fIlocale\&.LC_CTYPE=\fR, \fIlocale\&.LC_NUMERIC=\fR, \fIlocale\&.LC_TIME=\fR, \fIlocale\&.LC_COLLATE=\fR, \fIlocale\&.LC_MONETARY=\fR, \fIlocale\&.LC_MESSAGES=\fR, \fIlocale\&.LC_PAPER=\fR, \fIlocale\&.LC_NAME=\fR, \fIlocale\&.LC_ADDRESS=\fR, \fIlocale\&.LC_TELEPHONE=\fR, \fIlocale\&.LC_MEASUREMENT=\fR, \fIlocale\&.LC_IDENTIFICATION=\fR @@ -1094,6 +1158,8 @@ Set the system locale to use\&. This overrides the settings in \fBlocale.conf\fR(5) and \fBlocale\fR(7)\&. +.sp +Added in version 186\&. .RE .PP For other kernel command line parameters understood by components of the core OS, please refer to @@ -1206,6 +1272,8 @@ should be in the form "vsock:CID:PORT"\&. .sp This feature is useful for hypervisors/VMMs or other processes on the host to receive a notification via VSOCK when a virtual machine has finished booting\&. +.sp +Added in version 254\&. .RE .PP \fIsystem\&.machine_id\fR @@ -1215,6 +1283,8 @@ Takes a 128bit hexadecimal ID to initialize from, if the file is not set up yet\&. See \fBmachine-id\fR(5) for details\&. +.sp +Added in version 254\&. .RE .SH "OPTIONS" .PP @@ -1238,6 +1308,8 @@ Dump understood unit configuration items\&. This outputs a terse but complete li \fB\-\-dump\-bus\-properties\fR .RS 4 Dump exposed bus properties\&. This outputs a terse but complete list of properties exposed on D\-Bus\&. +.sp +Added in version 239\&. .RE .PP \fB\-\-test\fR @@ -1300,6 +1372,8 @@ above\&. Switch to a specific virtual console (VT) on crash\&. This switch has no effect when running as user instance\&. Same as \fIsystemd\&.crash_chvt=\fR above (but not the different spelling!)\&. +.sp +Added in version 227\&. .RE .PP \fB\-\-crash\-shell\fR @@ -1314,6 +1388,8 @@ above\&. Automatically reboot the system on crash\&. This switch has no effect when running as user instance\&. See \fIsystemd\&.crash_reboot\fR above\&. +.sp +Added in version 227\&. .RE .PP \fB\-\-confirm\-spawn\fR @@ -1328,6 +1404,8 @@ above\&. Show terse unit status information on the console during boot\-up and shutdown\&. See \fIsystemd\&.show_status\fR above\&. +.sp +Added in version 244\&. .RE .PP \fB\-\-log\-color\fR @@ -1335,6 +1413,8 @@ above\&. Highlight important log messages\&. See \fIsystemd\&.log_color\fR above\&. +.sp +Added in version 244\&. .RE .PP \fB\-\-log\-level=\fR @@ -1349,6 +1429,8 @@ above\&. Include code location in log messages\&. See \fIsystemd\&.log_location\fR above\&. +.sp +Added in version 244\&. .RE .PP \fB\-\-log\-target=\fR @@ -1363,6 +1445,8 @@ above\&. Prefix console messages with timestamp\&. See \fIsystemd\&.log_time\fR above\&. +.sp +Added in version 246\&. .RE .PP \fB\-\-machine\-id=\fR @@ -1370,6 +1454,8 @@ above\&. Override the machine\-id set on the hard drive\&. See \fIsystemd\&.machine_id=\fR above\&. +.sp +Added in version 229\&. .RE .PP \fB\-\-service\-watchdogs\fR @@ -1377,6 +1463,8 @@ above\&. Globally enable/disable all service watchdog timeouts and emergency actions\&. See \fIsystemd\&.service_watchdogs\fR above\&. +.sp +Added in version 237\&. .RE .PP \fB\-\-default\-standard\-output=\fR, \fB\-\-default\-standard\-error=\fR @@ -1421,6 +1509,8 @@ Kernel command\-line arguments and \fIsystemd\&.legacy_systemd_cgroup_controller\fR were deprecated\&. Please switch to the unified cgroup hierarchy\&. +.sp +Added in version 252\&. .RE .SH "SEE ALSO" .PP |