1 .TH CHCPU 8 "July 2014" "util-linux" "System Administration"
3 chcpu \- configure CPUs
6 .BR \-c | \-d | \-e | \-g
16 can modify the state of CPUs. It can enable or disable CPUs, scan for new
17 CPUs, change the CPU dispatching
19 of the underlying hypervisor, and request CPUs from the hypervisor
20 (configure) or return CPUs to the hypervisor (deconfigure).
24 argument. Use this argument to specify a comma-separated list of CPUs. The
25 list can contain individual CPU addresses or ranges of addresses. For
28 makes the command applicable to the CPUs with the addresses 0, 5, 7, 9, 10,
32 .BR \-c , " \-\-configure " \fIcpu-list\fP
33 Configure the specified CPUs. Configuring a CPU means that the hypervisor
34 takes a CPU from the CPU pool and assigns it to the virtual hardware on which
37 .BR \-d , " \-\-disable " \fIcpu-list\fP
38 Disable the specified CPUs. Disabling a CPU means that the kernel sets it
41 .BR \-e , " \-\-enable " \fIcpu-list\fP
42 Enable the specified CPUs. Enabling a CPU means that the kernel sets it
43 online. A CPU must be configured, see \fB\-c\fR, before it can be enabled.
45 .BR \-g , " \-\-deconfigure " \fIcpu-list\fP
46 Deconfigure the specified CPUs. Deconfiguring a CPU means that the
47 hypervisor removes the CPU from the virtual hardware on which the Linux
48 instance runs and returns it to the CPU pool. A CPU must be offline, see
49 \fB\-d\fR, before it can be deconfigured.
51 .BR \-p , " \-\-dispatch " \fImode\fP
52 Set the CPU dispatching
54 (polarization). This option has an effect only if your hardware architecture
55 and hypervisor support CPU polarization. Available
62 The workload is spread across all available CPUs.
65 The workload is concentrated on few CPUs.
69 .BR \-r , " \-\-rescan"
70 Trigger a rescan of CPUs. After a rescan, the Linux kernel recognizes
71 the new CPUs. Use this option on systems that do not
72 automatically detect newly attached CPUs.
74 .BR \-V , " \-\-version"
75 Display version information and exit.
78 Display help text and exit.
82 has the following return codes:
93 .MT heiko.carstens@de.ibm.com
97 Copyright IBM Corp. 2011
102 The chcpu command is part of the util-linux package and is available from
103 .UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/