summaryrefslogtreecommitdiffstats
path: root/sys-utils/chcpu.8.adoc
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 14:30:35 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 14:30:35 +0000
commit378c18e5f024ac5a8aef4cb40d7c9aa9633d144c (patch)
tree44dfb6ca500d32cabd450649b322a42e70a30683 /sys-utils/chcpu.8.adoc
parentInitial commit. (diff)
downloadutil-linux-378c18e5f024ac5a8aef4cb40d7c9aa9633d144c.tar.xz
util-linux-378c18e5f024ac5a8aef4cb40d7c9aa9633d144c.zip
Adding upstream version 2.38.1.upstream/2.38.1upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'sys-utils/chcpu.8.adoc')
-rw-r--r--sys-utils/chcpu.8.adoc86
1 files changed, 86 insertions, 0 deletions
diff --git a/sys-utils/chcpu.8.adoc b/sys-utils/chcpu.8.adoc
new file mode 100644
index 0000000..c5797df
--- /dev/null
+++ b/sys-utils/chcpu.8.adoc
@@ -0,0 +1,86 @@
+//po4a: entry man manual
+= chcpu(8)
+:doctype: manpage
+:man manual: System Administration
+:man source: util-linux {release-version}
+:page-layout: base
+:command: chcpu
+
+== NAME
+
+chcpu - configure CPUs
+
+== SYNOPSIS
+
+*chcpu* *-c*|*-d*|*-e*|*-g* _cpu-list_
+
+*chcpu* *-p* _mode_
+
+*chcpu* *-r*|*-h*|*-V*
+
+== DESCRIPTION
+
+*chcpu* can modify the state of CPUs. It can enable or disable CPUs, scan for new CPUs, change the CPU dispatching _mode_ of the underlying hypervisor, and request CPUs from the hypervisor (configure) or return CPUs to the hypervisor (deconfigure).
+
+Some options have a _cpu-list_ argument. Use this argument to specify a comma-separated list of CPUs. The list can contain individual CPU addresses or ranges of addresses. For example, *0,5,7,9-11* makes the command applicable to the CPUs with the addresses 0, 5, 7, 9, 10, and 11.
+
+== OPTIONS
+
+*-c*, *--configure* _cpu-list_::
+Configure the specified CPUs. Configuring a CPU means that the hypervisor takes a CPU from the CPU pool and assigns it to the virtual hardware on which your kernel runs.
+
+*-d*, *--disable* _cpu-list_::
+Disable the specified CPUs. Disabling a CPU means that the kernel sets it offline.
+
+*-e*, *--enable* _cpu-list_::
+Enable the specified CPUs. Enabling a CPU means that the kernel sets it online. A CPU must be configured, see *-c*, before it can be enabled.
+
+*-g*, *--deconfigure* _cpu-list_::
+Deconfigure the specified CPUs. Deconfiguring a CPU means that the hypervisor removes the CPU from the virtual hardware on which the Linux instance runs and returns it to the CPU pool. A CPU must be offline, see *-d*, before it can be deconfigured.
+
+*-p*, *--dispatch* _mode_::
+Set the CPU dispatching _mode_ (polarization). This option has an effect only if your hardware architecture and hypervisor support CPU polarization. Available _modes_ are:
+
+*horizontal*;;
+The workload is spread across all available CPUs.
+
+*vertical*;;
+The workload is concentrated on few CPUs.
+
+*-r*, *--rescan*::
+Trigger a rescan of CPUs. After a rescan, the Linux kernel recognizes the new CPUs. Use this option on systems that do not automatically detect newly attached CPUs.
+
+include::man-common/help-version.adoc[]
+
+== EXIT STATUS
+
+*chcpu* has the following exit status values:
+
+*0*::
+success
+
+*1*::
+failure
+
+*64*::
+partial success
+
+== AUTHORS
+
+mailto:heiko.carstens@de.ibm.com[Heiko Carstens]
+
+== COPYRIGHT
+
+Copyright IBM Corp. 2011
+
+== SEE ALSO
+
+*lscpu*(1)
+
+include::man-common/bugreports.adoc[]
+
+include::man-common/footer.adoc[]
+
+ifdef::translation[]
+include::man-common/translation.adoc[]
+endif::[]