X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemctl.xml;h=a7065f98ae569a3e7217b5775a5b728b03405f5e;hp=2ffc87df2b2ada7eb72ddd78d2bb10de1973d697;hb=1e001f52d20a4685c9e8cf3cfa690021ca05c9e7;hpb=436c44a5d64ef136ead64e9b03c8c05cc573a61b diff --git a/man/systemctl.xml b/man/systemctl.xml index 2ffc87df2..a7065f98a 100644 --- a/man/systemctl.xml +++ b/man/systemctl.xml @@ -70,7 +70,7 @@ - + Prints a short help text and exits. @@ -78,6 +78,7 @@ + When listing units, limit display to certain unit @@ -89,13 +90,29 @@ 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. @@ -125,11 +142,24 @@ - + + + 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. + + + + - Synchronously wait for - the requested operation to - finish. + Suppress output to + STDOUT for snapshot + and + check. @@ -149,53 +179,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...] @@ -251,6 +234,86 @@ dependencies and stop all others. + + check [NAME...] + + Check whether any of + the specified units is active + (i.e. running). Returns 0 if at least + one is active, non-zero + otherwise. Unless + is specified + 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 @@ -276,12 +339,14 @@ snapshot [NAME] Create a snapshot. If - a snapshot name is specified the new + a snapshot name is specified, the new snapshot will be named after it. If none is specified an automatic snapshot name is generated. In either - case the snapshot name used is printed - to STDOUT. + case, the snapshot name used is + printed to STDOUT, unless + is + specified. A snapshot refers to a saved state of the systemd manager. It is @@ -301,6 +366,13 @@ state. Snapshots are dynamic and lost on reboot. + + delete [NAME...] + + Remove a snapshot + previously created with + snapshot. + daemon-reload @@ -308,7 +380,7 @@ configuration. This will reload all unit files and recreate the entire dependency tree. While the daemon is - reloaded all sockets systemd listens + reloaded, all sockets systemd listens on on behalf of user configuration will stay accessible. This command should not be confused with