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 NAMEATTRIBUTE...
+ set-property NAMEASSIGNMENT...
- 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 NAMEATTRIBUTEVALUE...
+ 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 NAMEATTRIBUTE...
-
- 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 NAMECGROUP...
- unset-cgroup NAMECGROUP...
-
- 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