proxmox-mirrors/pve-docs
1
0
Fork 0
mirror of https://git.proxmox.com/git/pve-docs synced 2025-06-24 20:29:05 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

fix #3593: add affinity to docs

Browse Source 
Added affinity to the resource limiting info in qm.adoc.
Added affinity to the qemu conf spec in qm.conf.5-opts.adoc.

Signed-off-by: Daniel Bowder <daniel@bowdernet.com>
This commit is contained in:
Daniel Bowder 2022-06-30 17:09:46 -07:00 committed by Wolfgang Bumiller
parent f211eb8c20
commit 1e6b30b556
2 changed files with 19 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
qm.adoc
View File

@ -328,6 +328,21 @@ For more information see `man systemd.resource-control`, here `CPUQuota`
corresponds to `cpulimit` and `CPUShares` corresponds to our `cpuunits`
setting, visit its Notes section for references and implementation details.
The third CPU resource limiting setting, *affinity*, controls what host cores
the virtual machine will be permitted to execute on. E.g., if an affinity value
of `0-3,8-11` is provided, the virtual machine will be restricted to using the
host cores `0,1,2,3,8,9,10,` and `11`. Valid *affinity* values are written in
cpuset `List Format`. List Format is a comma-separated list of CPU numbers and
ranges of numbers, in ASCII decimal.
NOTE: CPU *affinity* uses the `taskset` command to restrict virtual machines to
a given set of cores. This restriction will not take effect for some types of
processes that may be created for IO. *CPU affinity is not a security feature.*
For more information regarding *affinity* see `man cpuset`. Here the
`List Format` corresponds to valid *affinity* values. Visit its `Formats`
section for more examples.
CPU Type
^^^^^^^^

4
qm.conf.5-opts.adoc
View File

@ -155,6 +155,10 @@ Limit of CPU usage.
+
NOTE: If the computer has 2 CPUs, it has total of '2' CPU time. Value '0' indicates no CPU limit.
`affinity`: `<string>`::
Set of CPU cores to pin the virtual machine processes to. This is a comma sepparated list of numbers or ranges in list format as defined by the Linux man page for cpuset. ( e.g `0,4-6,9` )
`cpuunits`: `<integer> (1 - 262144)` ('default =' `cgroup v1: 1024, cgroup v2: 100`)::
CPU weight for a VM. Argument is used in the kernel fair scheduler. The larger the number is, the more CPU time this VM gets. Number is relative to weights of all the other running VMs.