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=7f1e98f5c5472f84095b345514ffd417b03481d1;hb=07504d6b152084040e48f7657b0f56f364003334;hpb=37185ec80ad372907a2a9388735655a7334babb6
diff --git a/man/systemctl.xml b/man/systemctl.xml
index 7f1e98f5c..567f39839 100644
--- a/man/systemctl.xml
+++ b/man/systemctl.xml
@@ -63,19 +63,6 @@ along with systemd; If not, see .
introspect and control the state of the
systemd1
system and service manager.
-
- For unit commands, the NAME represents full name of the unit.
-
-systemctl start foo.service
-
- For unit file commands, the NAME represents the full name of the unit file, or the absolute path to the unit file.
-
-systemctl start /path/to/foo.service
-
- While working with services/service files, systemctl implicitly appends the ".service" suffix when it is missing.
-
-systemctl start foo
-
@@ -194,18 +181,6 @@ systemctl start foo
-
-
-
-
- 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
- .
-
-
-
@@ -215,27 +190,58 @@ systemctl start foo
-
+
- 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.
-
@@ -458,20 +464,19 @@ systemctl start foo
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
+ 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.
@@ -555,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...
@@ -1278,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
+
+
+