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=9f00324eb131c6f69b0e80ab27a50ceefc16c7b1;hb=55096547212928b0ba83fca2595cae0d66d3c0b0;hpb=af62c704053b5d34672497eb5bdc4764ebbb5f4f diff --git a/man/systemctl.xml b/man/systemctl.xml index 9f00324eb..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 @@ -280,8 +343,10 @@ 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 @@ -309,7 +381,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