X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemctl.xml;h=42682b7874e8bed07e0450aa101a1540852464c1;hb=992f87e192673d74cbdc4a50c27b8169401c6720;hp=e3a07d5d033f744f782cf17b1b1b47a4a60428a4;hpb=225fdfd3dda82220537ae699895fffe99ce4ba34;p=elogind.git
diff --git a/man/systemctl.xml b/man/systemctl.xml
index e3a07d5d0..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.
@@ -164,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...]
@@ -225,13 +219,6 @@
specified on the command
line.
-
- restart [NAME...]
-
- Restart one or more
- units specified on the command
- line.
- reload [NAME...]
@@ -258,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]
@@ -278,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
@@ -299,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]
@@ -345,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
@@ -465,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.