X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemctl.xml;h=0afb0cc626c318ff3506a5c301f4235ff10bee8b;hp=1a55522b12d1d88c8344251f76984637900586c2;hb=d2bbca6855b174fb7ea90b4767a886bb88bd2400;hpb=4a6022f01cfe092d018db52186d6af1fe28f3421 diff --git a/man/systemctl.xml b/man/systemctl.xml index 1a55522b1..0afb0cc62 100644 --- a/man/systemctl.xml +++ b/man/systemctl.xml @@ -92,21 +92,22 @@ along with systemd; If not, see . - The argument should be a unit type name such as - and , or a - unit load state such as and - . - - - If the argument is a unit type, when listing units, - limit display to certain unit types. If not specified units + The argument should be a comma separated list of unit + types such as and + , or unit load states such as + and + (types and states can be mixed). + + If one of the arguments is a unit type, when listing + units, limit display to certain unit types. Otherwise units of all types will be shown. - If the argument is a unit load state, when listing - units, limit display to certain unit types. If not specified - units of in all load states will be shown. + If one of the arguments is a unit load state, when + listing units, limit display to certain unit + types. Otherwise units of in all load states will be + shown. - As a special case, if the argument is + As a special case, if one of the arguments is , a list of allowed values will be printed and the program will exit. @@ -117,13 +118,13 @@ along with systemd; If not, see . - When showing unit/job/manager properties, limit - display to certain properties as specified as argument. If - not specified all set properties are shown. The argument - should be a property name, such as + When showing unit/job/manager properties with the + show command, limit display to certain + properties as specified as argument. If not specified all + set properties are shown. The argument should be a + comma-separated list of property names, such as MainPID. If specified more than once all - properties with the specified names are - shown. + properties with the specified names are shown. @@ -132,10 +133,35 @@ along with systemd; If not, see . - When listing units, show all units, regardless of - their state, including inactive units. When showing + When listing units, show all loaded units, regardless + of their state, including inactive units. When showing unit/job/manager properties, show all properties regardless whether they are set or not. + To list all units installed on the system, use the + list-unit-files command instead. + + + + + + + + Show reverse dependencies between units with + list-dependencies, i.e. units with + dependencies of type Wants= or + Requires= on the given unit. + + + + + + + + + + Show which units are started after, resp. before + with list-dependencies. + @@ -171,6 +197,25 @@ along with systemd; If not, see . + + + + + When showing sockets, show the type of the socket. + + + + + + + + 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. + + + @@ -196,7 +241,7 @@ along with systemd; If not, see . sleep state. Any user may take these locks and privileged users may override these locks. If any locks are taken, shutdown and sleep state requests will normally fail - (regardless if privileged or not) and list of active locks + (regardless if privileged or not) and a list of active locks is printed. However if is specified the locks are ignored and not printed, and the operation attempted anyway, possibly requiring additional @@ -382,14 +427,22 @@ along with systemd; If not, see . - When used with - enable/disable/is-enabled + When used with enable, + disable, is-enabled (and related commands), make changes only temporarily, so - that they are dropped on the next reboot. This will have the + that they are lost on the next reboot. This will have the effect that changes are not made in subdirectories of /etc but in /run, with identical immediate effects, however, since the latter is lost on reboot, the changes are lost too. + + Similar, when used with + set-cgroup-attr, + unset-cgroup-attr, + set-cgroup and + unset-cgroup, make changes only + temporarily, so that they are lost on the next + reboot. @@ -440,6 +493,15 @@ along with systemd; If not, see . + + + + + When used with list-dependencies + the output is printed as a list instead of a tree. + + + @@ -459,6 +521,31 @@ along with systemd; If not, see . This is the default command. + + + list-sockets + + + List socket units ordered by the listening address. Produces output + similar to + +LISTEN UNIT ACTIVATES +/dev/initctl systemd-initctl.socket systemd-initctl.service +... +[::]:22 sshd.socket sshd.service +kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service + +5 sockets listed. + + Note: because the addresses might contains spaces, this output + is not suitable for programatic consumption. + + + See also the options , + , and . + + + start NAME... @@ -621,6 +708,98 @@ along with systemd; If not, see . human-readable output. + + + get-cgroup-attr NAME ATTRIBUTE... + + + Retrieve the specified control group attributes of the + specified unit. Takes a unit name and one or more attribute + names such as cpu.shares. This will + output the current values of the specified attributes, + separated by new-lines. For attributes that take list of + items the output will be new-line separated, too. This + operation will always try to retrieve the data in question + from the kernel first, and if that is not available use the + configured values instead. Instead of low-level control + group attribute names high-level pretty names may be used, + as used for unit execution environment configuration, see + systemd.exec5 + for details. For example, passing + memory.limit_in_bytes and + MemoryLimit is equivalent. + + + + + set-cgroup-attr NAME ATTRIBUTE VALUE... + + + Set the specified control group attribute of the + specified unit to the specified value. Takes a unit + name and an attribute name such as + cpu.shares, plus one or more values + (multiple values may only be used for attributes that take + multiple values). This operation will immediately update the + kernel attribute for this unit and persistently store this + setting for later reboots (unless + is passed, in which case the setting is not saved + persistently and only valid until the next reboot.) Instead + of low-level control group attribute names high-level pretty + names may be used, as used for unit execution environment + configuration, see + systemd.exec5 + for details. For example, passing + memory.limit_in_bytes and + MemoryLimit is equivalent. This operation + will implicitly create a control group for the unit in the + controller the attribute belongs to, if needed. For + attributes that take multiple values, this operation will + append the specified values to the previously set values + list (use unset-cgroup-attr to reset the + list explicitly). For attributes that take a single value + only the list will be reset implicitly. + + + + + unset-cgroup-attr NAME ATTRIBUTE... + + Unset the specified control group attributes + of the specified unit. Takes a unit name and one or more + attribut names such as cpu.shares. This + operation might or might not have an immediate effect on the + current kernel attribute value. This will remove any + persistently stored configuration values for this attribute + (as set with set-cgroup-attr before), + unless is passed, in which case the + configuration is reset only until the next reboot. Again, + high-level control group attributes may be used instead of the + low-level kernel ones. For attributes which take multiple + values, all currently set values are reset. + + + + + set-cgroup NAME CGROUP... + unset-cgroup NAME CGROUP... + + Add or remove a unit to/from a specific + control group hierarchy and/or control group path. Takes a + unit name, plus a control group specification in the syntax + CONTROLLER:PATH + or CONTROLLER. In the latter syntax + (where the path is omitted) the default unit control group + path is implied. Examples: cpu or + cpu:/foo/bar. If a unit is removed from a + control group hierarchy all its processes will be moved to the + root group of the hierarchy and all control group attributes + will be reset. These operations are immediately reflected in + the kernel hierarchy, and stored persistently to disk (unless + is passed). + + + help NAME...|PID... @@ -631,6 +810,7 @@ along with systemd; If not, see . shown. + reset-failed [NAME...] @@ -971,7 +1151,7 @@ along with systemd; If not, see . Enter default mode. This is mostly equivalent to - start default.target. + isolate default.target. @@ -996,8 +1176,8 @@ along with systemd; If not, see . halt - Shut down and halt the system. This is mostly - equivalent to start halt.target but also + Shut down and halt the system. This is mostly equivalent to + start halt.target --irreversible but also prints a wall message to all users. If combined with shutdown of all running services is skipped, however all processes are killed and all file @@ -1013,8 +1193,8 @@ along with systemd; If not, see . Shut down and power-off the system. This is mostly - equivalent to start poweroff.target but - also prints a wall message to all users. If combined with + equivalent to start poweroff.target --irreversible + but also prints a wall message to all users. If combined with shutdown of all running services is skipped, however all processes are killed and all file systems are unmounted or mounted read-only, immediately @@ -1029,8 +1209,8 @@ along with systemd; If not, see . Shut down and reboot the system. This is mostly - equivalent to start reboot.target but - also prints a wall message to all users. If combined with + equivalent to start reboot.target --irreversible + but also prints a wall message to all users. If combined with shutdown of all running services is skipped, however all processes are killed and all file systems are unmounted or mounted read-only, immediately @@ -1045,7 +1225,7 @@ along with systemd; If not, see . Shut down and reboot the system via kexec. This is - mostly equivalent to start kexec.target + mostly equivalent to start kexec.target --irreversible but also prints a wall message to all users. If combined with shutdown of all running services is skipped, however all processes are killed and