]>
Commit | Line | Data |
---|---|---|
c372860d | 1 | .TH CHCPU 8 "July 2014" "util-linux" "System Administration" |
0b57c6c2 | 2 | .SH NAME |
5f2ce404 | 3 | chcpu \- configure CPUs |
0b57c6c2 | 4 | .SH SYNOPSIS |
c372860d BS |
5 | .B chcpu |
6 | .BR \-c | \-d | \-e | \-g | |
7 | .I cpu-list | |
0b57c6c2 | 8 | .br |
c372860d BS |
9 | .B chcpu \-p |
10 | .I mode | |
0b57c6c2 | 11 | .br |
c372860d BS |
12 | .B chcpu |
13 | .BR \-r | \-h | \-V | |
0b57c6c2 HC |
14 | .SH DESCRIPTION |
15 | .B chcpu | |
a6210872 SK |
16 | can modify the state of CPUs. It can enable or disable CPUs, scan for new |
17 | CPUs, change the CPU dispatching | |
18 | .I mode | |
19 | of the underlying hypervisor, and request CPUs from the hypervisor | |
20 | (configure) or return CPUs to the hypervisor (deconfigure). | |
21 | .PP | |
22 | Some options have a | |
23 | .I cpu-list | |
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 | |
26 | example, | |
27 | .B 0,5,7,9-11 | |
28 | makes the command applicable to the CPUs with the addresses 0, 5, 7, 9, 10, | |
29 | and 11. | |
0b57c6c2 | 30 | .SH OPTIONS |
0b57c6c2 | 31 | .TP |
5f2ce404 | 32 | .BR \-c , " \-\-configure " \fIcpu-list\fP |
c372860d | 33 | Configure the specified CPUs. Configuring a CPU means that the hypervisor |
a6210872 SK |
34 | takes a CPU from the CPU pool and assigns it to the virtual hardware on which |
35 | your kernel runs. | |
0b57c6c2 | 36 | .TP |
c372860d BS |
37 | .BR \-d , " \-\-disable " \fIcpu-list\fP |
38 | Disable the specified CPUs. Disabling a CPU means that the kernel sets it | |
39 | offline. | |
40 | .TP | |
5f2ce404 | 41 | .BR \-e , " \-\-enable " \fIcpu-list\fP |
c372860d BS |
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. | |
44 | .TP | |
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. | |
0b57c6c2 | 50 | .TP |
5f2ce404 | 51 | .BR \-p , " \-\-dispatch " \fImode\fP |
a6210872 SK |
52 | Set the CPU dispatching |
53 | .I mode | |
54 | (polarization). This option has an effect only if your hardware architecture | |
55 | and hypervisor support CPU polarization. Available | |
56 | .I modes | |
57 | are: | |
58 | .RS 14 | |
5f2ce404 | 59 | .TP 12 |
a6210872 | 60 | .PD 0 |
5f2ce404 HC |
61 | .B horizontal |
62 | The workload is spread across all available CPUs. | |
63 | .TP 12 | |
64 | .B vertical | |
65 | The workload is concentrated on few CPUs. | |
66 | .RE | |
a6210872 | 67 | .PD 1 |
0b57c6c2 | 68 | .TP |
c372860d BS |
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. | |
0b57c6c2 | 73 | .TP |
c372860d BS |
74 | .BR \-V , " \-\-version" |
75 | Display version information and exit. | |
0b57c6c2 | 76 | .TP |
5f2ce404 | 77 | .BR \-h , " \-\-help" |
b4362b6f | 78 | Display help text and exit. |
48fc00c1 KZ |
79 | |
80 | .SH RETURN CODES | |
81 | .B chcpu | |
82 | has the following return codes: | |
83 | .TP | |
0bb7e904 | 84 | .B 0 |
48fc00c1 KZ |
85 | success |
86 | .TP | |
0bb7e904 | 87 | .B 1 |
48fc00c1 KZ |
88 | failure |
89 | .TP | |
0bb7e904 | 90 | .B 64 |
48fc00c1 | 91 | partial success |
0b57c6c2 | 92 | .SH AUTHOR |
a6210872 SK |
93 | .MT heiko.carstens@de.ibm.com |
94 | Heiko Carstens | |
95 | .ME | |
0b57c6c2 HC |
96 | .SH COPYRIGHT |
97 | Copyright IBM Corp. 2011 | |
98 | .br | |
99 | .SH "SEE ALSO" | |
100 | .BR lscpu (1) | |
101 | .SH AVAILABILITY | |
102 | The chcpu command is part of the util-linux package and is available from | |
d673b74e | 103 | .UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/ |
a6210872 SK |
104 | Linux Kernel Archive |
105 | .UE . |