summaryrefslogtreecommitdiff
path: root/man/systemd.resource-control.xml
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2014-04-25 13:27:25 +0200
committerLennart Poettering <lennart@poettering.net>2014-04-25 13:27:25 +0200
commitb2f8b02ec27dfec9cbd23573f47aba494f2e9b5f (patch)
tree56ca4d6015fa5bd06f473d7836ef3fc797f35f64 /man/systemd.resource-control.xml
parent3051f1871ea2d9a36b423207221e461cc27e577c (diff)
core: expose CFS CPU time quota as high-level unit properties
Diffstat (limited to 'man/systemd.resource-control.xml')
-rw-r--r--man/systemd.resource-control.xml52
1 files changed, 47 insertions, 5 deletions
diff --git a/man/systemd.resource-control.xml b/man/systemd.resource-control.xml
index a51e600ebb..5a996fd6df 100644
--- a/man/systemd.resource-control.xml
+++ b/man/systemd.resource-control.xml
@@ -117,11 +117,53 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
<term><varname>CPUShares=<replaceable>weight</replaceable></varname></term>
<listitem>
- <para>Assign the specified overall CPU time share weight to
- the processes executed. Takes an integer value. This
- controls the <literal>cpu.shares</literal> control group
- attribute, which defaults to 1024. For details about this
- control group attribute, see <ulink
+ <para>Assign the specified CPU time share weight to the
+ processes executed. Takes an integer value. This controls
+ the <literal>cpu.shares</literal> control group attribute,
+ which defaults to 1024. For details about this control group
+ attribute, see <ulink
+ url="https://www.kernel.org/doc/Documentation/scheduler/sched-design-CFS.txt">sched-design-CFS.txt</ulink>
+ The available CPU time is split up among all units within a
+ slice relative to their CPU time share weight.</para>
+
+ <para>Implies <literal>CPUAccounting=true</literal>.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><varname>CPUQuota=</varname></term>
+
+ <listitem>
+ <para>Assign the specified CPU time quota to the processes
+ executed. Takes a percentage value (suffixed with "%") or an
+ absolute time (suffixed by one of the common time units, us,
+ ms, s, ...). The percentage specifies how much CPU time the
+ unit shall get at maximum, relative to the total CPU time
+ available on one CPU. Use values > 100% for alloting CPU
+ time on more than one CPU. If an absolute time is specified
+ the processes of this unit will get this much absolute time
+ within each quota period, at maximum. This controls the
+ <literal>cpu.cfs_quota_us</literal> control group
+ attribute. For details about this control group attribute,
+ see <ulink
+ url="https://www.kernel.org/doc/Documentation/scheduler/sched-design-CFS.txt">sched-design-CFS.txt</ulink>.</para>
+
+ <para>Example: <varname>CPUShares=20%</varname> ensures that
+ the executed processes will never get more than 20% CPU time
+ on one CPU.</para>
+
+ <para>Implies <literal>CPUAccounting=true</literal>.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><varname>CPUQuotaPeriodSec=</varname></term>
+
+ <listitem>
+ <para>Specify the CPU quota period to use. Defaults to
+ 100ms. This controls the <literal>cpu.cfs_period_us</literal>
+ control group attribute. For details about this control
+ group attribute, see <ulink
url="https://www.kernel.org/doc/Documentation/scheduler/sched-design-CFS.txt">sched-design-CFS.txt</ulink>.</para>
<para>Implies <literal>CPUAccounting=true</literal>.</para>