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.