X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemctl.xml;h=42682b7874e8bed07e0450aa101a1540852464c1;hp=80f355491fa8aa9cd4ca591ce163f3766677c868;hb=0009d2a63339af1ee9b6f18ab6cf42d68d089148;hpb=7594fb250ba5f5a82a578065c5d9fe524ef706bb
diff --git a/man/systemctl.xml b/man/systemctl.xml
index 80f355491..42682b787 100644
--- a/man/systemctl.xml
+++ b/man/systemctl.xml
@@ -90,26 +90,67 @@
similar.
+
+
+
+
+ When showing
+ unit/job/manager information, limit
+ display to certain property names. If
+ not specified all set properties are
+ shown. The argument should be a
+ property name, such as
+ MainPID.
+
+
When listing units,
show all units, regardless of their
- state, including inactive
- units.
+ state, including inactive units. When
+ showing unit/job/manager information,
+ show all properties regardless whether
+ they are set or not.
-
+ If the requested
operation conflicts with an existing
- unfinished operation, replace the
- existing operation by the requested
- operation. If this is not specified
- the requested operation will
- fail.
+ unfinished operation, fail the
+ command. If this is not specified the
+ requested operation will replace the
+ pending job if
+ necessary.
+
+
+
+
+
+
+ When used in
+ conjunction with the
+ dot command (see
+ below), selects which dependencies are
+ shown in the dependency graph. If
+ is passed
+ only dependencies of type
+ After= or
+ Before= are
+ shown. If
+ is passed only dependencies of type
+ Requires=,
+ RequiresOverridable=,
+ Requisite=,
+ RequisiteOverridable=,
+ Wants= and
+ Conflicts= are
+ shown. If neither is passed, shows
+ dependencies of all these
+ types.
@@ -129,14 +170,13 @@
- Do no synchronously
- wait for the requested operation to
- finish. If this is not specified the
- job will be verified, enqueued and
- wait until it is complete. By passing
- this argument it is only verified and
- enqueued.
-
+ Do not synchronously wait for
+ the requested operation to finish. If this is
+ not specified the job will be verified,
+ enqueued and systemctl will
+ wait until it is completed. By passing this
+ argument it is only verified and
+ enqueued.
@@ -165,53 +205,6 @@
List known units.
-
- list-jobs
-
- List jobs that are in progress.
-
-
- clear-jobs
-
- Cancel all jobs that are in progress.
-
-
- load [NAME...]
-
- Load one or more units
- specified on the command line. This
- will simply load their configuration
- from disk, but not start them. To
- start them you need to use the
- start command which
- will implicitly load a unit that has
- not been loaded yet. Note that systemd
- garbage collects loaded units that are
- not active or referenced by an active
- unit. This means that units loaded
- this way will usually not stay loaded
- for long. Also note that this command
- cannot be used to reload unit
- configuration. Use the
- daemon-reload
- command for that. All in all, this
- command is of little use except for
- debugging.
- This command should not be
- confused with the
- daemon-reload or
- reload
- commands.
-
-
-
- cancel [JOB...]
-
- Cancel one or more
- jobs specified on the command line by
- their numeric job
- IDs.
- start [NAME...]
@@ -226,13 +219,6 @@
specified on the command
line.
-
- restart [NAME...]
-
- Restart one or more
- units specified on the command
- line.
- reload [NAME...]
@@ -259,6 +245,33 @@
commands.
+
+ restart [NAME...]
+
+ Restart one or more
+ units specified on the command
+ line. If the units are not running yet
+ they will be
+ started.
+
+
+ try-restart [NAME...]
+
+ Restart one or more
+ units specified on the command
+ line. If the units are not running yet
+ the operation will
+ fail.
+
+
+ reload-or-restart [NAME...]
+ reload-or-try-restart [NAME...]
+
+ Reload one or more
+ units if they support it. If not
+ restart them
+ instead.
+ isolate [NAME]
@@ -279,6 +292,74 @@
this will also print the current unit
state to STDOUT.
+
+ status [NAME...]
+
+ Show short status
+ information about one or more
+ units. This shows terse runtime
+ information about
+ units.
+
+
+ show [NAME...|JOB...]
+
+ 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
+ properties of the unit is shown,
+ and if a job id is specified
+ properties of the job is
+ shown.
+
+
+ load [NAME...]
+
+ Load one or more units
+ specified on the command line. This
+ will simply load their configuration
+ from disk, but not start them. To
+ start them you need to use the
+ start command which
+ will implicitly load a unit that has
+ not been loaded yet. Note that systemd
+ garbage collects loaded units that are
+ not active or referenced by an active
+ unit. This means that units loaded
+ this way will usually not stay loaded
+ for long. Also note that this command
+ cannot be used to reload unit
+ configuration. Use the
+ daemon-reload
+ command for that. All in all, this
+ command is of little use except for
+ debugging.
+ This command should not be
+ confused with the
+ daemon-reload or
+ reload
+ commands.
+
+
+ list-jobs
+
+ List jobs that are in progress.
+
+
+ cancel [JOB...]
+
+ Cancel one or more
+ jobs specified on the command line by
+ their numeric job
+ IDs.
+
+
+ clear-jobs
+
+ Cancel all jobs that are in progress.
+ monitor
@@ -300,6 +381,24 @@
be parsed by
applications.
+
+ dot
+
+ Generate textual
+ dependency graph description in dot
+ format for further processing with the
+ GraphViz
+ dot1
+ tool. Use a command line like
+ systemctl dot | dot -Tsvg >
+ systemd.svg to generate a
+ graphical dependency tree. Unless
+ or
+ is passed
+ the generated graph will show both
+ ordering and requirement
+ dependencies.
+ snapshot [NAME]
@@ -331,6 +430,13 @@
state. Snapshots are dynamic and lost
on reboot.
+
+ delete [NAME...]
+
+ Remove a snapshot
+ previously created with
+ snapshot.
+ daemon-reload
@@ -339,7 +445,7 @@
unit files and recreate the entire
dependency tree. While the daemon is
reloaded, all sockets systemd listens
- on on behalf of user configuration, will
+ on on behalf of user configuration will
stay accessible. This
command should not be confused with
the load or
@@ -459,7 +565,7 @@
Enter emergency
mode. This is mostly equivalent to
isolate
- emergency.service but also
+ emergency.target but also
prints a wall message to all
users.