diff options
Diffstat (limited to '')
| -rw-r--r-- | upstream/opensuse-tumbleweed/man1/systemctl.1 | 257 |
1 files changed, 249 insertions, 8 deletions
diff --git a/upstream/opensuse-tumbleweed/man1/systemctl.1 b/upstream/opensuse-tumbleweed/man1/systemctl.1 index e885512c..f5ce9dce 100644 --- a/upstream/opensuse-tumbleweed/man1/systemctl.1 +++ b/upstream/opensuse-tumbleweed/man1/systemctl.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMCTL" "1" "" "systemd 254" "systemctl" +.TH "SYSTEMCTL" "1" "" "systemd 255" "systemctl" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -136,6 +136,8 @@ Also see \fB\-\-show\-types\fR, \fB\-\-all\fR, and \fB\-\-state=\fR\&. +.sp +Added in version 252\&. .RE .PP \fBlist\-paths\fR [\fIPATTERN\fR\&...] @@ -162,6 +164,8 @@ Also see \fB\-\-show\-types\fR, \fB\-\-all\fR, and \fB\-\-state=\fR\&. +.sp +Added in version 254\&. .RE .PP \fBlist\-sockets\fR [\fIPATTERN\fR\&...] @@ -191,6 +195,8 @@ Also see \fB\-\-show\-types\fR, \fB\-\-all\fR, and \fB\-\-state=\fR\&. +.sp +Added in version 202\&. .RE .PP \fBlist\-timers\fR [\fIPATTERN\fR\&...] @@ -235,6 +241,8 @@ Also see \fB\-\-all\fR and \fB\-\-state=\fR\&. +.sp +Added in version 209\&. .RE .PP \fBis\-active \fR\fB\fIPATTERN\fR\fR\fB\&...\fR @@ -246,13 +254,18 @@ if at least one is active, or non\-zero otherwise\&. Unless is specified, this will also print the current unit state to standard output\&. .RE .PP -\fBis\-failed \fR\fB\fIPATTERN\fR\fR\fB\&...\fR +\fBis\-failed \fR\fB[\fIPATTERN\fR\&...]\fR .RS 4 -Check whether any of the specified units are in a "failed" state\&. Returns an exit code +Check whether any of the specified units is in the "failed" state\&. If no unit is specified, check whether there are any failed units, which corresponds to the +"degraded" +state returned by +\fBis\-system\-running\fR\&. Returns an exit code \fB0\fR if at least one has failed, non\-zero otherwise\&. Unless \fB\-\-quiet\fR -is specified, this will also print the current unit state to standard output\&. +is specified, this will also print the current unit or system state to standard output\&. +.sp +Added in version 197\&. .RE .PP \fBstatus\fR [\fIPATTERN\fR\&...|\fIPID\fR\&...]] @@ -384,11 +397,15 @@ For details about many of these properties, see the documentation of the D\-Bus Show backing files of one or more units\&. Prints the "fragment" and "drop\-ins" (source files) of units\&. Each file is preceded by a comment which includes the file name\&. Note that this shows the contents of the backing files on disk, which may not match the system manager\*(Aqs understanding of these units if any unit files were updated on disk and the \fBdaemon\-reload\fR command wasn\*(Aqt issued since\&. +.sp +Added in version 209\&. .RE .PP \fBhelp \fR\fB\fIPATTERN\fR\fR\fB\&...|\fR\fB\fIPID\fR\fR\fB\&...\fR .RS 4 Show manual pages for one or more units, if available\&. If a PID is given, the manual pages for the unit the process belongs to are shown\&. +.sp +Added in version 185\&. .RE .PP \fBlist\-dependencies\fR [\fIUNIT\fR\&.\&.\&.] @@ -423,6 +440,8 @@ Options may be used to change what types of dependencies are shown\&. .sp Note that this command only lists units currently loaded into memory by the service manager\&. In particular, this command is not suitable to get a comprehensive list at all reverse dependencies on a specific unit, as it won\*(Aqt list the dependencies declared by units currently not loaded\&. +.sp +Added in version 198\&. .RE .PP \fBstart \fR\fB\fIPATTERN\fR\fR\fB\&...\fR @@ -498,6 +517,8 @@ Reload one or more units if they support it\&. If not, stop and then start them \fBtry\-reload\-or\-restart \fR\fB\fIPATTERN\fR\fR\fB\&...\fR .RS 4 Reload one or more units if they support it\&. If not, stop and then start them instead\&. This does nothing if the units are not running\&. +.sp +Added in version 229\&. .RE .PP \fBisolate \fR\fB\fIUNIT\fR\fR @@ -552,6 +573,8 @@ is selected, see \fBsystemd.timer\fR(5)\&. This command only applies to units that use either of these settings\&. If \fB\-\-what=\fR is not specified, the cache and runtime data as well as the file descriptor store are removed (as these three types of resources are generally redundant and reproducible on the next invocation of the unit)\&. Note that the specified units must be stopped to invoke this operation\&. +.sp +Added in version 243\&. .RE .PP \fBfreeze \fR\fB\fIPATTERN\fR\fR\fB\&...\fR @@ -559,6 +582,8 @@ is not specified, the cache and runtime data as well as the file descriptor stor Freeze one or more units specified on the command line using cgroup freezer .sp Freezing the unit will cause all processes contained within the cgroup corresponding to the unit to be suspended\&. Being suspended means that unit\*(Aqs processes won\*(Aqt be scheduled to run on CPU until thawed\&. Note that this command is supported only on systems that use unified cgroup hierarchy\&. Unit is automatically thawed just before we execute a job against the unit, e\&.g\&. before the unit is stopped\&. +.sp +Added in version 246\&. .RE .PP \fBthaw \fR\fB\fIPATTERN\fR\fR\fB\&...\fR @@ -568,6 +593,8 @@ Thaw (unfreeze) one or more units specified on the command line\&. This is the inverse operation to the \fBfreeze\fR command and resumes the execution of processes in the unit\*(Aqs cgroup\&. +.sp +Added in version 246\&. .RE .PP \fBset\-property \fR\fB\fIUNIT\fR\fR\fB \fR\fB\fIPROPERTY\fR\fR\fB=\fR\fB\fIVALUE\fR\fR\fB\&...\fR @@ -591,6 +618,8 @@ Like with unit file configuration settings, assigning an empty setting usually r .sp Example: \fBsystemctl set\-property avahi\-daemon\&.service IPAddressDeny=\fR +.sp +Added in version 206\&. .RE .PP \fBbind\fR \fIUNIT\fR \fIPATH\fR [\fIPATH\fR] @@ -608,6 +637,10 @@ Note that this option is currently only supported for units that run within a mo socket nodes, as well as FIFOs\&. The bind mount is ephemeral, and it is undone as soon as the current unit process exists\&. Note that the namespace mentioned here, where the bind mount will be added to, is the one where the main service process runs\&. Other processes (those exececuted by \fBExecReload=\fR, \fBExecStartPre=\fR, etc\&.) run in distinct namespaces\&. +.sp +If supported by the kernel, any prior mount on the selected target will be replaced by the new mount\&. If not supported, any prior mount will be over\-mounted, but remain pinned and inaccessible\&. +.sp +Added in version 248\&. .RE .PP \fBmount\-image\fR \fIUNIT\fR \fIIMAGE\fR [\fIPATH\fR [\fIPARTITION_NAME\fR:\fIMOUNT_OPTIONS\fR]] @@ -627,6 +660,8 @@ Note that this option is currently only supported for units that run within a mo \fBExecReload=\fR, \fBExecStartPre=\fR, etc\&.) run in distinct namespaces\&. .sp +If supported by the kernel, any prior mount on the selected target will be replaced by the new mount\&. If not supported, any prior mount will be over\-mounted, but remain pinned and inaccessible\&. +.sp Example: .sp .if n \{\ @@ -651,6 +686,7 @@ systemctl mount\-image \-\-mkdir bar\&.service /tmp/img\&.raw /var/lib/baz/img .RE .\} .sp +Added in version 248\&. .RE .PP \fBservice\-log\-level\fR \fISERVICE\fR [\fILEVEL\fR] @@ -684,6 +720,8 @@ will use the generic D\-Bus protocol to access the org\&.freedesktop\&.LogControl1\&.LogLevel interface for the D\-Bus name \fIdestination\fR\&.) +.sp +Added in version 247\&. .RE .PP \fBservice\-log\-target\fR \fISERVICE\fR [\fITARGET\fR] @@ -733,6 +771,8 @@ will use the generic D\-Bus protocol to access the org\&.freedesktop\&.LogControl1\&.LogLevel interface for the D\-Bus name \fIdestination\fR\&.) +.sp +Added in version 247\&. .RE .PP \fBreset\-failed [\fR\fB\fIPATTERN\fR\fR\fB\&...]\fR @@ -754,6 +794,8 @@ state of a unit it also resets various other per\-unit properties: the start rat Returns the units the processes referenced by the given PIDs belong to (one per line)\&. If no PID is specified returns the unit the \fBsystemctl\fR command is invoked in\&. +.sp +Added in version 254\&. .RE .SS "Unit File Commands" .PP @@ -766,6 +808,8 @@ List unit files installed on the system, in combination with their enablement st Unlike \fBlist\-units\fR this command will list template units in addition to explicitly instantiated units\&. +.sp +Added in version 233\&. .RE .PP \fBenable \fR\fB\fIUNIT\fR\fR\fB\&...\fR, \fBenable \fR\fB\fIPATH\fR\fR\fB\&...\fR @@ -865,6 +909,8 @@ and \fB\-\-no\-warn\fR in a similar way as \fBenable\fR\&. +.sp +Added in version 238\&. .RE .PP \fBreenable \fR\fB\fIUNIT\fR\fR\fB\&...\fR @@ -874,6 +920,8 @@ Reenable one or more units, as specified on the command line\&. This is a combin and \fBenable\fR and is useful to reset the symlinks a unit file is enabled with to the defaults configured in its [Install] section\&. This command expects a unit name only, it does not accept paths to unit files\&. +.sp +Added in version 238\&. .RE .PP \fBpreset \fR\fB\fIUNIT\fR\fR\fB\&...\fR @@ -893,6 +941,8 @@ must be the real unit name, any alias names are ignored silently\&. .sp For more information on the preset policy format, see \fBsystemd.preset\fR(5)\&. +.sp +Added in version 238\&. .RE .PP \fBpreset\-all\fR @@ -902,6 +952,8 @@ Resets all installed unit files to the defaults configured in the preset policy Use \fB\-\-preset\-mode=\fR to control whether units shall be enabled and disabled, or only enabled, or only disabled\&. +.sp +Added in version 215\&. .RE .PP \fBis\-enabled \fR\fB\fIUNIT\fR\fR\fB\&...\fR @@ -1029,6 +1081,7 @@ T}:T{ T} .TE .sp 1 +Added in version 238\&. .RE .PP \fBmask \fR\fB\fIUNIT\fR\fR\fB\&...\fR @@ -1058,12 +1111,16 @@ mode, in which case the directories are below the user\*(Aqs home directory howe If a unit gets masked but its triggering units are still active, a warning containing the names of the triggering units is shown\&. \fB\-\-no\-warn\fR can be used to suppress the warning\&. +.sp +Added in version 238\&. .RE .PP \fBunmask \fR\fB\fIUNIT\fR\fR\fB\&...\fR .RS 4 Unmask one or more unit files, as specified on the command line\&. This will undo the effect of \fBmask\fR\&. This command expects valid unit names only, it does not accept unit file paths\&. +.sp +Added in version 238\&. .RE .PP \fBlink \fR\fB\fIPATH\fR\fR\fB\&...\fR @@ -1075,6 +1132,8 @@ Link a unit file that is not in the unit file search path into the unit file sea or /var/ is not allowed, unless those directories are located on the root file system)\&. +.sp +Added in version 233\&. .RE .PP \fBrevert \fR\fB\fIUNIT\fR\fR\fB\&...\fR @@ -1099,6 +1158,8 @@ Effectively, this command may be used to undo all changes made with and \fBsystemctl mask\fR and puts the original unit file with its settings back in effect\&. +.sp +Added in version 230\&. .RE .PP \fBadd\-wants \fR\fB\fITARGET\fR\fR\fB \fR\fB\fIUNIT\fR\fR\fB\&...\fR, \fBadd\-requires \fR\fB\fITARGET\fR\fR\fB \fR\fB\fIUNIT\fR\fR\fB\&...\fR @@ -1119,6 +1180,8 @@ and \fB\-\-global\fR in a way similar to \fBenable\fR\&. +.sp +Added in version 217\&. .RE .PP \fBedit \fR\fB\fIUNIT\fR\fR\fB\&...\fR @@ -1161,6 +1224,8 @@ After the units have been edited, systemd configuration is reloaded (in a way th Note that this command cannot be used to remotely edit units and that you cannot temporarily edit units which are in /etc/, since they take precedence over /run/\&. +.sp +Added in version 218\&. .RE .PP \fBget\-default\fR @@ -1168,6 +1233,8 @@ Note that this command cannot be used to remotely edit units and that you cannot Return the default target to boot into\&. This returns the target unit name default\&.target is aliased (symlinked) to\&. +.sp +Added in version 205\&. .RE .PP \fBset\-default \fR\fB\fITARGET\fR\fR @@ -1175,6 +1242,8 @@ is aliased (symlinked) to\&. Set the default target to boot into\&. This sets (symlinks) the default\&.target alias to the given target unit\&. +.sp +Added in version 205\&. .RE .SS "Machine Commands" .PP @@ -1182,6 +1251,8 @@ alias to the given target unit\&. .RS 4 List the host and all running local containers with their state\&. If one or more \fIPATTERN\fRs are specified, only containers matching one of them are shown\&. +.sp +Added in version 212\&. .RE .SS "Job Commands" .PP @@ -1195,11 +1266,15 @@ When combined with or \fB\-\-before\fR the list is augmented with information on which other job each job is waiting for, and which other jobs are waiting for it, see above\&. +.sp +Added in version 233\&. .RE .PP \fBcancel \fR\fB[\fIJOB\fR\&...]\fR .RS 4 Cancel one or more jobs specified on the command line by their numeric job IDs\&. If no job ID is specified, cancel all pending jobs\&. +.sp +Added in version 233\&. .RE .SS "Environment Commands" .PP @@ -1224,16 +1299,34 @@ Dump the systemd manager environment block\&. This is the environment block that \fBdash\fR(1) or \fBfish\fR(1)\&. +.sp +Note that this shows the +\fIeffective\fR +block, i\&.e\&. the combination of environment variables configured via configuration files, environment generators and via IPC (i\&.e\&. via the +\fBset\-environment\fR +described below)\&. At the moment a unit process is forked off this combined environment block will be further combined with per\-unit environment variables, which are not visible in this command\&. .RE .PP \fBset\-environment \fR\fB\fIVARIABLE=VALUE\fR\fR\fB\&...\fR .RS 4 -Set one or more systemd manager environment variables, as specified on the command line\&. This command will fail if variable names and values do not conform to the rules listed above\&. +Set one or more service manager environment variables, as specified on the command line\&. This command will fail if variable names and values do not conform to the rules listed above\&. +.sp +Note that this operates on an environment block separate from the environment block configured from service manager configuration and environment generators\&. Whenever a process is invoked the two blocks are combined (also incorporating any per\-service environment variables), and passed to it\&. The +\fBshow\-environment\fR +verb will show the combination of the blocks, see above\&. +.sp +Added in version 233\&. .RE .PP \fBunset\-environment \fR\fB\fIVARIABLE\fR\fR\fB\&...\fR .RS 4 Unset one or more systemd manager environment variables\&. If only a variable name is specified, it will be removed regardless of its value\&. If a variable and a value are specified, the variable is only removed if it has the specified value\&. +.sp +Note that this operates on an environment block separate from the environment block configured from service manager configuration and environment generators\&. Whenever a process is invoked the two blocks are combined (also incorporating any per\-service environment variables), and passed to it\&. The +\fBshow\-environment\fR +verb will show the combination of the blocks, see above\&. Note that this means this command cannot be used to unset environment variables defined in the service manager configuration files or via generators\&. +.sp +Added in version 233\&. .RE .PP \fBimport\-environment\fR \fIVARIABLE\&...\fR @@ -1243,6 +1336,8 @@ Import all, one or more environment variables set on the client into the systemd process is imported\&. In this mode, any inherited invalid environment variables are quietly ignored\&. .sp Importing of the full inherited environment block (calling this command without any arguments) is deprecated\&. A shell will set dozens of variables which only make sense locally and are only meant for processes which are descendants of the shell\&. Such variables in the global environment block are confusing to other processes\&. +.sp +Added in version 209\&. .RE .SS "Manager State Commands" .PP @@ -1272,6 +1367,8 @@ is provided, then the command changes the current log level of the manager to \fB\-\-log\-level=\fR described in \fBsystemd\fR(1))\&. +.sp +Added in version 244\&. .RE .PP \fBlog\-target\fR [\fITARGET\fR] @@ -1283,6 +1380,8 @@ is provided, then the command changes the current log target of the manager to (accepts the same values as \fB\-\-log\-target=\fR, described in \fBsystemd\fR(1))\&. +.sp +Added in version 244\&. .RE .PP \fBservice\-watchdogs\fR [yes|no] @@ -1292,6 +1391,8 @@ If no argument is given, print the current state of service runtime watchdogs of or \fBStartLimitAction=\fR); see \fBsystemd.service\fR(5)\&. The hardware watchdog is not affected by this setting\&. +.sp +Added in version 244\&. .RE .SS "System Commands" .PP @@ -1400,6 +1501,7 @@ T}:T{ T} .TE .sp 1 +Added in version 215\&. .RE .PP \fBdefault\fR @@ -1488,12 +1590,26 @@ and \fB\-\-when=\fR in a similar way as \fBhalt\fR\&. +.sp +If a new kernel has been loaded via +\fBkexec \-\-load\fR, a +\fBkexec\fR +will be performed instead of a reboot, unless +"SYSTEMCTL_SKIP_AUTO_KEXEC=1" +has been set\&. If a new root file system has been set up on +"/run/nextroot/", a +\fBsoft\-reboot\fR +will be performed instead of a reboot, unless +"SYSTEMCTL_SKIP_AUTO_SOFT_REBOOT=1" +has been set\&. +.sp +Added in version 246\&. .RE .PP \fBkexec\fR .RS 4 Shut down and reboot the system via -\fBkexec\fR\&. This command will load a kexec kernel if one wasn\*(Aqt loaded yet or fail\&. A kernel may be loaded earlier by a separate step, this is particularly useful if a custom initrd or additional kernel commandline options are desired\&. The +\fBkexec\fR\&. This command will load a kexec kernel if one wasn\*(Aqt loaded yet or fail\&. A kernel may be loaded earlier by a separate step, this is particularly useful if a custom initrd or additional kernel command line options are desired\&. The \fB\-\-force\fR can be used to continue without a kexec kernel, i\&.e\&. to perform a normal reboot\&. The final reboot step is equivalent to \fBsystemctl start kexec\&.target \-\-job\-mode=replace\-irreversibly \-\-no\-block\fR\&. @@ -1512,6 +1628,15 @@ and \fB\-\-when=\fR similarly to \fBhalt\fR\&. +.sp +If a new kernel has been loaded via +\fBkexec \-\-load\fR, a +\fBkexec\fR +will be performed when +\fBreboot\fR +is invoked, unless +"SYSTEMCTL_SKIP_AUTO_KEXEC=1" +has been set\&. .RE .PP \fBsoft\-reboot\fR @@ -1529,6 +1654,17 @@ in a similar way as This operation only reboots userspace, leaving the kernel running\&. See \fBsystemd-soft-reboot.service\fR(8) for details\&. +.sp +If a new root file system has been set up on +"/run/nextroot/", a +\fBsoft\-reboot\fR +will be performed when +\fBreboot\fR +is invoked, unless +"SYSTEMCTL_SKIP_AUTO_SOFT_REBOOT=1" +has been set\&. +.sp +Added in version 254\&. .RE .PP \fBexit\fR [\fIEXIT_CODE\fR] @@ -1542,12 +1678,16 @@ otherwise\&. This command is asynchronous; it will return after the exit operati The service manager will exit with the specified exit code, if \fIEXIT_CODE\fR is passed\&. +.sp +Added in version 227\&. .RE .PP \fBswitch\-root\fR [\fIROOT\fR [\fIINIT\fR]] .RS 4 Switches to a different root directory and executes a new system manager process below it\&. This is intended for use in the initrd, and will transition from the initrd\*(Aqs system manager process (a\&.k\&.a\&. "init" process, PID 1) to the main system manager process which is loaded from the actual host root files system\&. This call takes two arguments: the directory that is to become the new root directory, and the path to the new system manager binary below it to execute as PID 1\&. If both are omitted or the former is an empty string it defaults to /sysroot/\&. If the latter is omitted or is an empty string, a systemd binary will automatically be searched for and used as service manager\&. If the system manager path is omitted, equal to the empty string or identical to the path to the systemd binary, the state of the initrd\*(Aqs system manager process is passed to the main system manager, which allows later introspection of the state of the services involved in the initrd boot phase\&. +.sp +Added in version 209\&. .RE .PP \fBsuspend\fR @@ -1566,6 +1706,8 @@ hibernate\&.target\&. This command is asynchronous, and will return after the hi .RS 4 Hibernate and suspend the system\&. This will trigger activation of the special target unit hybrid\-sleep\&.target\&. This command is asynchronous, and will return after the hybrid sleep operation is successfully enqueued\&. It will not wait for the sleep/wake\-up cycle to complete\&. +.sp +Added in version 196\&. .RE .PP \fBsuspend\-then\-hibernate\fR @@ -1573,6 +1715,8 @@ hybrid\-sleep\&.target\&. This command is asynchronous, and will return after th Suspend the system and hibernate it after the delay specified in systemd\-sleep\&.conf\&. This will trigger activation of the special target unit suspend\-then\-hibernate\&.target\&. This command is asynchronous, and will return after the hybrid sleep operation is successfully enqueued\&. It will not wait for the sleep/wake\-up or hibernate/thaw cycle to complete\&. +.sp +Added in version 240\&. .RE .SS "Parameter Syntax" .PP @@ -1739,6 +1883,8 @@ to show only failed units\&. .sp As a special case, if one of the arguments is \fBhelp\fR, a list of allowed values will be printed and the program will exit\&. +.sp +Added in version 206\&. .RE .PP \fB\-p\fR, \fB\-\-property=\fR @@ -1768,6 +1914,8 @@ Equivalent to \fB\-P\fR once will also affect all properties listed with \fB\-p\fR/\fB\-\-property=\fR\&. +.sp +Added in version 246\&. .RE .PP \fB\-a\fR, \fB\-\-all\fR @@ -1789,6 +1937,8 @@ When used with \fB\-r\fR, \fB\-\-recursive\fR .RS 4 When listing units, also show units of local containers\&. Units of local containers will be prefixed with the container name, separated by a single colon character (":")\&. +.sp +Added in version 212\&. .RE .PP \fB\-\-reverse\fR @@ -1802,6 +1952,8 @@ Show reverse dependencies between units with \fIBoundBy=\fR, instead of \fIWants=\fR and similar\&. +.sp +Added in version 203\&. .RE .PP \fB\-\-after\fR @@ -1827,6 +1979,8 @@ When passed to the command, for each printed job show which other jobs are waiting for it\&. May be combined with \fB\-\-before\fR to show both the jobs waiting for each job as well as all jobs each job is waiting for\&. +.sp +Added in version 203\&. .RE .PP \fB\-\-before\fR @@ -1841,6 +1995,8 @@ When passed to the command, for each printed job show which other jobs it is waiting for\&. May be combined with \fB\-\-after\fR to show both the jobs waiting for each job as well as all jobs each job is waiting for\&. +.sp +Added in version 212\&. .RE .PP \fB\-\-with\-dependencies\fR @@ -1856,6 +2012,8 @@ Options \fB\-\-after\fR, \fB\-\-before\fR may be used to change what types of dependencies are shown\&. +.sp +Added in version 245\&. .RE .PP \fB\-l\fR, \fB\-\-full\fR @@ -1877,11 +2035,15 @@ When printing properties with "="\&. Also see option \fB\-P\fR above\&. +.sp +Added in version 230\&. .RE .PP \fB\-\-show\-types\fR .RS 4 When showing sockets, show the type of the socket\&. +.sp +Added in version 202\&. .RE .PP \fB\-\-job\-mode=\fR @@ -1945,6 +2107,8 @@ for more information about triggering units\&. "restart\-dependencies" may only be used with \fBsystemctl start\fR\&. In this mode, dependencies of the specified unit will receive restart propagation, as if a restart job had been enqueued for the unit\&. +.sp +Added in version 209\&. .RE .PP \fB\-T\fR, \fB\-\-show\-transaction\fR @@ -1952,6 +2116,8 @@ may only be used with When enqueuing a unit job (for example as effect of a \fBsystemctl start\fR invocation or similar), show brief information about all jobs enqueued, covering both the requested job and any added because of unit dependencies\&. Note that the output will only include jobs immediately part of the transaction requested\&. It is possible that service start\-up program code run as effect of the enqueued jobs might request further jobs to be pulled in\&. This means that completion of the listed jobs might ultimately entail more jobs than the listed ones\&. +.sp +Added in version 242\&. .RE .PP \fB\-\-fail\fR @@ -1962,6 +2128,8 @@ Shorthand for When used with the \fBkill\fR command, if no units were killed, the operation results in an error\&. +.sp +Added in version 227\&. .RE .PP \fB\-\-check\-inhibitors=\fR @@ -1990,12 +2158,16 @@ is specified on a non\-interactive requests, the operation will be attempted\&. Option \fB\-\-force\fR provides another way to override inhibitors\&. +.sp +Added in version 248\&. .RE .PP \fB\-i\fR .RS 4 Shortcut for \fB\-\-check\-inhibitors=no\fR\&. +.sp +Added in version 198\&. .RE .PP \fB\-\-dry\-run\fR @@ -2013,6 +2185,8 @@ Just print what would be done\&. Currently supported by verbs \fBrescue\fR, \fBemergency\fR, and \fBexit\fR\&. +.sp +Added in version 236\&. .RE .PP \fB\-q\fR, \fB\-\-quiet\fR @@ -2083,6 +2257,7 @@ when a \fBmask\fR\-ed unit still has active triggering units\&. .RE .sp +Added in version 253\&. .RE .PP \fB\-\-no\-block\fR @@ -2101,6 +2276,8 @@ Synchronously wait for started units to terminate again\&. This option may not b .sp When used with \fBis\-system\-running\fR, wait until the boot process is completed before returning\&. +.sp +Added in version 232\&. .RE .PP \fB\-\-user\fR @@ -2117,6 +2294,8 @@ Talk to the service manager of the system\&. This is the implied default\&. .RS 4 List units in failed state\&. This is equivalent to \fB\-\-state=failed\fR\&. +.sp +Added in version 233\&. .RE .PP \fB\-\-no\-wall\fR @@ -2172,6 +2351,8 @@ is always the main process itself\&. A service unit consists of zero or one main and /usr/bin/umount), but no main process is defined\&. If omitted, defaults to \fBall\fR\&. +.sp +Added in version 252\&. .RE .PP \fB\-\-kill\-value=\fR\fIINT\fR @@ -2192,6 +2373,8 @@ system call, rather than If this option is used the signal will only be enqueued on the control or main process of the unit, never on other processes belonging to the unit, i\&.e\&. \fB\-\-kill\-whom=all\fR will only affect main and control processes but no other processes\&. +.sp +Added in version 254\&. .RE .PP \fB\-s\fR, \fB\-\-signal=\fR @@ -2233,6 +2416,8 @@ and resource type is only useful if the \fIFileDescriptorStorePreserve=\fR option is enabled, since the file descriptor store is otherwise cleaned automatically when the unit is stopped\&. +.sp +Added in version 243\&. .RE .PP \fB\-f\fR, \fB\-\-force\fR @@ -2267,6 +2452,8 @@ When used with \fBpoweroff\fR or \fBreboot\fR, set a short message explaining the reason for the operation\&. The message will be logged together with the default shutdown message\&. +.sp +Added in version 225\&. .RE .PP \fB\-\-now\fR @@ -2276,6 +2463,8 @@ When used with \fBdisable\fR or \fBmask\fR, the units will also be stopped\&. The start or stop operation is only carried out when the respective enable or disable operation has been successful\&. +.sp +Added in version 220\&. .RE .PP \fB\-\-root=\fR @@ -2295,6 +2484,8 @@ Takes a path to a disk image file or block device node\&. If specified, all oper \fB\-\-root=\fR, but operates on file systems stored in disk images or block devices\&. The disk image should either contain just a file system or a set of file systems within a GPT partition table, following the \m[blue]\fBDiscoverable Partitions Specification\fR\m[]\&\s-2\u[2]\d\s+2\&. For further information on supported disk images, see \fBsystemd-nspawn\fR(1)\*(Aqs switch of the same name\&. +.sp +Added in version 252\&. .RE .PP \fB\-\-image\-policy=\fR\fB\fIpolicy\fR\fR @@ -2331,6 +2522,8 @@ Takes one of or \fBpreset\-all\fR commands, controls whether units shall be disabled and enabled according to the preset rules, or only enabled, or only disabled\&. +.sp +Added in version 215\&. .RE .PP \fB\-n\fR, \fB\-\-lines=\fR @@ -2354,6 +2547,8 @@ When used with the \fBpoweroff\fR, or \fBhalt\fR command, indicate to the system\*(Aqs firmware to reboot into the firmware setup interface for the next boot\&. Note that this functionality is not available on all systems\&. +.sp +Added in version 220\&. .RE .PP \fB\-\-boot\-loader\-menu=\fR\fB\fItimeout\fR\fR @@ -2363,6 +2558,8 @@ When used with the \fBpoweroff\fR, or \fBhalt\fR command, indicate to the system\*(Aqs boot loader to show the boot loader menu on the following boot\&. Takes a time value as parameter \(em indicating the menu timeout\&. Pass zero in order to disable the menu timeout\&. Note that not all boot loaders support this functionality\&. +.sp +Added in version 242\&. .RE .PP \fB\-\-boot\-loader\-entry=\fR\fB\fIID\fR\fR @@ -2374,6 +2571,8 @@ When used with the command, indicate to the system\*(Aqs boot loader to boot into a specific boot loader entry on the following boot\&. Takes a boot loader entry identifier as argument, or "help" in order to list available entries\&. Note that not all boot loaders support this functionality\&. +.sp +Added in version 242\&. .RE .PP \fB\-\-reboot\-argument=\fR @@ -2386,6 +2585,8 @@ might be used to trigger system recovery, and might be used to trigger a \(lqfirmware over the air\(rq update\&. +.sp +Added in version 246\&. .RE .PP \fB\-\-plain\fR @@ -2395,6 +2596,8 @@ When used with \fBlist\-units\fR or \fBlist\-machines\fR, the output is printed as a list instead of a tree, and the bullet circles are omitted\&. +.sp +Added in version 203\&. .RE .PP \fB\-\-timestamp=\fR @@ -2404,33 +2607,47 @@ Change the format of printed timestamps\&. The following values may be used: \fBpretty\fR (this is the default) .RS 4 "Day YYYY\-MM\-DD HH:MM:SS TZ" +.sp +Added in version 248\&. .RE .PP \fBunix\fR .RS 4 "@seconds\-since\-the\-epoch" +.sp +Added in version 251\&. .RE .PP \fBus\fR, \fBμs\fR .RS 4 "Day YYYY\-MM\-DD HH:MM:SS\&.UUUUUU TZ" +.sp +Added in version 248\&. .RE .PP \fButc\fR .RS 4 "Day YYYY\-MM\-DD HH:MM:SS UTC" +.sp +Added in version 248\&. .RE .PP \fBus+utc\fR, \fBμs+utc\fR .RS 4 "Day YYYY\-MM\-DD HH:MM:SS\&.UUUUUU UTC" +.sp +Added in version 248\&. .RE +.sp +Added in version 247\&. .RE .PP \fB\-\-mkdir\fR .RS 4 When used with \fBbind\fR, creates the destination file or directory before applying the bind mount\&. Note that even though the name of this option suggests that it is suitable only for directories, this option also creates the destination file node to mount over if the object to mount is not a directory, but a regular file, device node, socket or FIFO\&. +.sp +Added in version 248\&. .RE .PP \fB\-\-marked\fR @@ -2448,19 +2665,27 @@ Unless is used, \fBsystemctl\fR will wait for the queued jobs to finish\&. +.sp +Added in version 248\&. .RE .PP \fB\-\-read\-only\fR .RS 4 When used with \fBbind\fR, creates a read\-only bind mount\&. +.sp +Added in version 248\&. .RE .PP -\fB\-\-drop\-in=\fR +\fB\-\-drop\-in=\fR\fINAME\fR .RS 4 When used with -\fBedit\fR, use the given drop\-in file name instead of +\fBedit\fR, use +\fINAME\fR +as the drop\-in file name instead of override\&.conf\&. +.sp +Added in version 253\&. .RE .PP \fB\-\-when=\fR @@ -2476,6 +2701,8 @@ section "PARSING TIMESTAMPS"\&. Specially, if "show" is given, the currently scheduled action will be shown, which can be canceled by passing an empty string or "cancel"\&. +.sp +Added in version 254\&. .RE .PP \fB\-H\fR, \fB\-\-host=\fR @@ -2610,6 +2837,8 @@ are present or if it is set to an empty string or if their execution failed, sys \fBnano\fR(1), \fBvim\fR(1), \fBvi\fR(1)\&. +.sp +Added in version 218\&. .RE .PP \fI$SYSTEMD_LOG_LEVEL\fR @@ -2730,6 +2959,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\&. @@ -2741,6 +2976,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 |