X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemctl.xml;h=2a23655cfe9663f08fd212bf3cdd1bf498218a9d;hp=982051778ed835b117c051aa97e3d8ff37bbffc5;hb=223ab9345d70e2ea8498b96ff07ee73c25ad18b4;hpb=9b9b3d36b8ffe5b41c1455bffd44a9d11efc8aee diff --git a/man/systemctl.xml b/man/systemctl.xml index 982051778..2a23655cf 100644 --- a/man/systemctl.xml +++ b/man/systemctl.xml @@ -111,8 +111,8 @@ along with systemd; If not, see . - Argument should be a comma-separated list of unit LOAD - or SUB or ACTIVE states. When listing units show only those + The argument should be a comma-separated list of unit LOAD + or SUB or ACTIVE states. When listing units, show only those with specified LOAD or SUB or ACTIVE state. @@ -433,10 +433,7 @@ along with systemd; If not, see . 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 + set-property, make changes only temporarily, so that they are lost on the next reboot. @@ -542,19 +539,6 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service - - set-log-level LEVEL - - - Change current log level of the - systemd daemon to - LEVEL (accepts the same values - as described in - systemd1). - - - - start NAME... @@ -719,93 +703,28 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service - get-cgroup-attr NAME ATTRIBUTE... + set-property NAME ASSIGNMENT... - 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 a list of - items, the output will be newline-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 the specified unit properties at runtime where + this is supported. This allows changing configuration + parameter properties such as resource management controls at + runtime. Not all properties may be changed at runtime, but + many resource management settings (primarily those in + systemd.cgroup5) + may. The changes are applied instantly, and stored on disk + for future boots, unless is + passed, in which case the settings only apply until the next + reboot. The syntax of the property assignment follows + closely the syntax of assignments in unit files. - - set-cgroup-attr NAME ATTRIBUTE VALUE... + Example: systemctl set-property foobar.service CPUShares=777 - - 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). + Note that this command allows changing multiple + properties at the same time, which is preferable over + setting them individually. Like unit file configuration + settings, assigning the empty list to list parameters will + reset the list. @@ -1023,28 +942,6 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service - - 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. - - list-jobs @@ -1061,16 +958,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service all pending jobs. - - dump - - Dump server status. This will output a (usually very - long) human readable manager status dump. Its format is - subject to change without notice and should not be parsed by - applications. - - list-dependencies NAME @@ -1354,6 +1242,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service journalctl1, loginctl1, systemd.unit5, + systemd.cgroupq5, systemd.special7, wall1, systemd.preset5