X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemctl.xml;h=9cd6e88988cb65ad883a3da970d6bb48e93928c6;hp=d842b787e37ff9199266d2730aea3b5bf06e1a35;hb=4f8f66cb4236783cd3cbee97fefc9aaa8469ac08;hpb=1290d0fc5f7ffb433e403068c6c60394033e9ba8 diff --git a/man/systemctl.xml b/man/systemctl.xml index d842b787e..9cd6e8898 100644 --- a/man/systemctl.xml +++ b/man/systemctl.xml @@ -63,19 +63,6 @@ along with systemd; If not, see . introspect and control the state of the systemd1 system and service manager. - - For unit commands, the NAME represents full name of the unit. - -systemctl start foo.service - - For unit file commands, the NAME represents the full name of the unit file, or the absolute path to the unit file. - -systemctl start /path/to/foo.service - - While working with services/service files, systemctl implicitly appends the ".service" suffix when it is missing. - -systemctl start foo - @@ -194,18 +181,6 @@ systemctl start foo - - - - - If the requested operation conflicts with a pending - unfinished job, fail the command. If this is not specified, - the requested operation will replace the pending job, if - necessary. Do not confuse with - . - - - @@ -215,27 +190,58 @@ systemctl start foo - + - Mark this transaction's jobs as irreversible. This prevents - future conflicting transactions from replacing these jobs. - The jobs can still be cancelled using the cancel - command. + When queuing a new job, control how to deal with already + queued jobs. Takes one of fail, + replace, + replace-irreversibly, + isolate, + ignore-dependencies, + ignore-requirements or + flush. Defaults to + replace, except when the + isolate command is used which implies the + isolate job mode. + + If fail is specified and a requested + operation conflicts with a pending job (more specifically: + causes an already pending start job to be reversed into a stop + job or vice versa), cause the operation to fail. + + If replace (the default) is + specified, any conflicting pending job will be replaced, as + necessary. + + If replace-irreversibly is specified, + operate like replace, but also mark the new + jobs as irreversible. This prevents future conflicting + transactions from replacing these jobs. The jobs can still be + cancelled using the cancel command. + + isolate is only valid for start + operations and causes all other units to be stopped when the + specified unit is started. This mode is always used when the + isolate command is used. + + flush will cause all queued jobs to + be canceled when the new job is enqueued. + + If ignore-dependencies is specified, + then all unit dependencies are ignored for this new job and + the operation is executed immediately. If passed, no required + units of the unit passed will be pulled in, and no ordering + dependencies will be honored. This is mostly a debugging and + rescue tool for the administrator and should not be used by + applications. + + ignore-requirements is similar to + ignore-dependencies but only causes the + requirement dependencies to be ignored, the ordering + dependencies will still be honoured. - - - - - - When enqueuing a new job, ignore all its dependencies - and execute it immediately. If passed, no required units of - the unit passed will be pulled in, and no ordering - dependencies will be honored. This is mostly a debugging and - rescue tool for the administrator and should not be used by - applications. - @@ -520,22 +526,26 @@ systemctl start foo - list-units + list-units PATTERN... List known units (subject to limitations specified - with ). + with ). If one or more + PATTERNs are specified, only + units matching one of them are shown. This is the default command. - list-sockets + list-sockets PATTERN... - List socket units ordered by the listening address. Produces output - similar to + List socket units ordered by the listening address. + If one or more PATTERNs are + specified, only socket units matching one of them are + shown. Produces output similar to LISTEN UNIT ACTIVATES /dev/initctl systemd-initctl.socket systemd-initctl.service @@ -554,6 +564,20 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service + + list-timers PATTERN... + + + List timer units ordered by the time they elapse + next. If one or more PATTERNs + are specified, only units matching one of them are shown. + + + See also the options and + . + + + start NAME... @@ -684,7 +708,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service - status [NAME...|PID...] + status NAME...|PID...] Show terse runtime status information about one or @@ -700,7 +724,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service - show [NAME...|JOB...] + show NAME...|JOB... Show properties of one or more units, jobs, or the @@ -716,7 +740,16 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service human-readable output. + + cat NAME... + + Show backing files of one or more units. Prints the + "fragment" and "drop-ins" (source files) of units. Each + file is preceded by a comment which includes the file + name. + + set-property NAME ASSIGNMENT... @@ -788,10 +821,13 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service - list-unit-files + list-unit-files PATTERN... - List installed unit files. + List installed unit files. If one or more + PATTERNs are specified, only + units whose filename (just the last component of the path) + matches one of them are shown. @@ -987,10 +1023,12 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service - list-jobs + list-jobs PATTERN... - List jobs that are in progress. + List jobs that are in progress. If one or more + PATTERNs are specified, only + jobs for units matching one of them are shown. @@ -1010,7 +1048,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service - snapshot [NAME] + snapshot NAME Create a snapshot. If a snapshot name is specified, @@ -1255,7 +1293,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service - switch-root ROOT [INIT] + switch-root ROOT INIT Switches to a different root directory and executes a @@ -1277,6 +1315,28 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service + + Parameter Syntax + + For unit commands the specified + NAME should be the full name of the + unit, or an abbreviated name which is automatically extended with + the .service suffix. + # systemctl start foo.service is equivalent to: + # systemctl start foo + Note that (absolute) paths to device nodes are automatically converted to device unit names, and other (absolute) paths to mount unit names. + # systemctl status /dev/sda +# systemctl status /home is equivalent to: + # systemctl status dev-sda.device +# systemctl status home.mount + + For unit file commands the + specified NAME should be the full name + of the unit file, or the absolute path to the unit file. + # systemctl link /path/to/foo.service + + +