X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemctl.xml;h=567f39839c5a8a4d6cb987a418c2b1cbb867ce2d;hp=1642a47273c0958b5e3411a7104ad4c5054139ed;hb=07504d6b152084040e48f7657b0f56f364003334;hpb=27722f964361a7da2532cf0a2d57a2f0dd0a09f2 diff --git a/man/systemctl.xml b/man/systemctl.xml index 1642a4727..567f39839 100644 --- a/man/systemctl.xml +++ b/man/systemctl.xml @@ -174,25 +174,13 @@ along with systemd; If not, see . - Do not ellipsize unit names, cgroup members, and + Do not ellipsize unit names, process tree entries, and truncate unit descriptions in the output of list-units and list-jobs. - - - - - If the requested operation conflicts with a pending - unfinished job, fail the command. If this is not specified, - the requested operation will replace the pending job, if - necessary. Do not confuse with - . - - - @@ -202,27 +190,58 @@ along with systemd; If not, see . - + - Mark this transaction's jobs as irreversible. This prevents - future conflicting transactions from replacing these jobs. - The jobs can still be cancelled using the cancel - command. + When queuing a new job, control how to deal with already + queued jobs. Takes one of fail, + replace, + replace-irreversibly, + isolate, + ignore-dependencies, + ignore-requirements or + flush. Defaults to + replace, except when the + isolate command is used which implies the + isolate job mode. + + If fail is specified and a requested + operation conflicts with a pending job (more specifically: + causes an already pending start job to be reversed into a stop + job or vice versa), cause the operation to fail. + + If replace (the default) is + specified, any conflicting pending job will be replaced, as + necessary. + + If replace-irreversibly is specified, + operate like replace, but also mark the new + jobs as irreversible. This prevents future conflicting + transactions from replacing these jobs. The jobs can still be + cancelled using the cancel command. + + isolate is only valid for start + operations and causes all other units to be stopped when the + specified unit is started. This mode is always used when the + isolate command is used. + + flush will cause all queued jobs to + be canceled when the new job is enqueued. + + If ignore-dependencies is specified, + then all unit dependencies are ignored for this new job and + the operation is executed immediately. If passed, no required + units of the unit passed will be pulled in, and no ordering + dependencies will be honored. This is mostly a debugging and + rescue tool for the administrator and should not be used by + applications. + + ignore-requirements is similar to + ignore-dependencies but only causes the + requirement dependencies to be ignored, the ordering + dependencies will still be honoured. - - - - - - When enqueuing a new job, ignore all its dependencies - and execute it immediately. If passed, no required units of - the unit passed will be pulled in, and no ordering - dependencies will be honored. This is mostly a debugging and - rescue tool for the administrator and should not be used by - applications. - @@ -444,21 +463,20 @@ along with systemd; If not, see . - Execute operation remotely. Specify a hostname, or - username and hostname separated by @, to connect to. This - will use SSH to talk to the remote systemd + Execute the operation remotely. Specify a hostname, or + username and hostname separated by @, to + connect to. This will use SSH to talk to the remote systemd instance. - - + + - - Acquire privileges via PolicyKit before executing the - operation. - + Execute the operation on a local + container. Specify a container name to connect + to. @@ -542,6 +560,17 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service + + list-timers + + + List timer units ordered by the time they elapse next. + + See also the options and + . + + + start NAME... @@ -566,7 +595,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service their configuration. Note that this will reload the service-specific configuration, not the unit configuration file of systemd. If you want systemd to reload the - configuration file of a unit use the + configuration file of a unit, use the daemon-reload command. In other words: for the example case of Apache, this will reload Apache's httpd.conf in the web server, not the @@ -692,12 +721,12 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service Show properties of one or more units, jobs, or the - manager itself. If no argument is specified properties of - the manager will be shown. If a unit name is specified + manager itself. If no argument is specified, properties of + the manager will be shown. If a unit name is specified, properties of the unit is shown, and if a job id is - specified properties of the job is shown. By default, empty + specified, properties of the job is shown. By default, empty properties are suppressed. Use to - show those too. To select specific properties to show use + show those too. To select specific properties to show, use . This command is intended to be used whenever computer-parsable output is required. Use status if you are looking for formatted @@ -711,14 +740,14 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service Set the specified unit properties at runtime where this is supported. This allows changing configuration - parameter properties such as resource management controls at + parameter properties such as resource control settings at runtime. Not all properties may be changed at runtime, but - many resource management settings (primarily those in - systemd.cgroup5) + many resource control settings (primarily those in + systemd.resource-control5) may. The changes are applied instantly, and stored on disk for future boots, unless is - passed, in which case the settings only apply until the next - reboot. The syntax of the property assignment follows + passed, in which case the settings only apply until the + next reboot. The syntax of the property assignment follows closely the syntax of assignments in unit files. Example: systemctl set-property foobar.service CPUShares=777 @@ -830,10 +859,11 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service case of socket units), and so on. Depending on whether , - or is - specified, this enables the unit for the system, for the - calling user only or for all future logins of all - users. Note that in the last case, no systemd daemon + , , + or is specified, this enables the unit + for the system, for the calling user only, for only this boot of + the system, or for all future logins of all users, or only this + boot. Note that in the last case, no systemd daemon configuration is reloaded. @@ -860,8 +890,9 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service This command honors , - , in a - similar way as enable. + , and + in a similar way as + enable. @@ -918,7 +949,9 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service start them. This is a stronger version of disable, since it prohibits all kinds of activation of the unit, including manual activation. Use - this option with care. + this option with care. This honors the + option to only mask temporarily + until the next reoobt of the system. @@ -1075,7 +1108,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service Reload systemd manager configuration. This will reload all unit files and recreate the entire dependency - tree. While the daemon is reloaded, all sockets systemd + tree. While the daemon is being reloaded, all sockets systemd listens on on behalf of user configuration will stay accessible. This command should not be confused with the load or @@ -1089,9 +1122,9 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service Reexecute the systemd manager. This will serialize the manager state, reexecute the process and deserialize the state again. This command is of little use except for - debugging and package upgrades. Sometimes it might be + debugging and package upgrades. Sometimes, it might be helpful as a heavy-weight daemon-reload. - While the daemon is reexecuted, all sockets systemd listening + While the daemon is being reexecuted, all sockets systemd listening on behalf of user configuration will stay accessible. @@ -1162,7 +1195,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service - reboot + reboot arg Shut down and reboot the system. This is mostly @@ -1175,6 +1208,16 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service specified twice, the operation is immediately executed without terminating any processes or unmounting any file systems. This may result in data loss. + + If the optional argument + arg is given, it will be passed + as the optional argument to the + reboot2 + system call. The value is architecture and firmware + specific. As an example, recovery might + be used to trigger system recovery, and + fota might be used to trigger a + firmware over the air update. @@ -1251,6 +1294,28 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service + + Parameter Syntax + + For unit commands the specified + NAME should be the full name of the + unit, or an abbreviated name which is automatically extended with + the .service suffix. + # systemctl start foo.service is equivalent to: + # systemctl start foo + Note that (absolute) paths to device nodes are automatically converted to device unit names, and other (absolute) paths to mount unit names. + # systemctl status /dev/sda +# systemctl status /home is equivalent to: + # systemctl status dev-sda.device +# systemctl status home.mount + + For unit file commands the + specified NAME should be the full name + of the unit file, or the absolute path to the unit file. + # systemctl link /path/to/foo.service + + + @@ -1286,7 +1351,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service journalctl1, loginctl1, systemd.unit5, - systemd.cgroup5, + systemd.resource-management5, systemd.special7, wall1, systemd.preset5