]>
Commit | Line | Data |
---|---|---|
295b3979 | 1 | //po4a: entry man manual |
6d5b6948 MB |
2 | = chcpu(8) |
3 | :doctype: manpage | |
a09649ca | 4 | :man manual: System Administration |
6d5b6948 MB |
5 | :man source: util-linux {release-version} |
6 | :page-layout: base | |
7 | :command: chcpu | |
8 | ||
9 | == NAME | |
10 | ||
11 | chcpu - configure CPUs | |
12 | ||
13 | == SYNOPSIS | |
14 | ||
15 | *chcpu* *-c*|*-d*|*-e*|*-g* _cpu-list_ | |
16 | ||
17 | *chcpu* *-p* _mode_ | |
18 | ||
19 | *chcpu* *-r*|*-h*|*-V* | |
20 | ||
21 | == DESCRIPTION | |
22 | ||
23 | *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). | |
24 | ||
25 | 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. | |
26 | ||
27 | == OPTIONS | |
28 | ||
29 | *-c*, *--configure* _cpu-list_:: | |
68860732 | 30 | 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. |
6d5b6948 MB |
31 | |
32 | *-d*, *--disable* _cpu-list_:: | |
68860732 | 33 | Disable the specified CPUs. Disabling a CPU means that the kernel sets it offline. |
6d5b6948 MB |
34 | |
35 | *-e*, *--enable* _cpu-list_:: | |
68860732 | 36 | 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. |
6d5b6948 MB |
37 | |
38 | *-g*, *--deconfigure* _cpu-list_:: | |
68860732 | 39 | 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. |
6d5b6948 MB |
40 | |
41 | *-p*, *--dispatch* _mode_:: | |
68860732 | 42 | Set the CPU dispatching _mode_ (polarization). This option has an effect only if your hardware architecture and hypervisor support CPU polarization. Available _modes_ are: |
e08e3d58 | 43 | |
68860732 MB |
44 | *horizontal*;; |
45 | The workload is spread across all available CPUs. | |
e08e3d58 | 46 | |
68860732 MB |
47 | *vertical*;; |
48 | The workload is concentrated on few CPUs. | |
6d5b6948 MB |
49 | |
50 | *-r*, *--rescan*:: | |
68860732 | 51 | 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. |
6d5b6948 | 52 | |
68860732 MB |
53 | *-V*, *--version*:: |
54 | Display version information and exit. | |
6d5b6948 MB |
55 | |
56 | *-h*, *--help*:: | |
68860732 | 57 | Display help text and exit. |
6d5b6948 MB |
58 | |
59 | == EXIT STATUS | |
60 | ||
61 | *chcpu* has the following exit status values: | |
62 | ||
63 | *0*:: | |
68860732 | 64 | success |
6d5b6948 MB |
65 | |
66 | *1*:: | |
68860732 | 67 | failure |
6d5b6948 MB |
68 | |
69 | *64*:: | |
68860732 | 70 | partial success |
6d5b6948 MB |
71 | |
72 | == AUTHORS | |
73 | ||
74 | mailto:heiko.carstens@de.ibm.com[Heiko Carstens] | |
75 | ||
76 | == COPYRIGHT | |
77 | ||
78 | Copyright IBM Corp. 2011 | |
79 | ||
80 | == SEE ALSO | |
81 | ||
82 | *lscpu*(1) | |
83 | ||
625e9c61 | 84 | include::man-common/bugreports.adoc[] |
6d5b6948 | 85 | |
625e9c61 | 86 | include::man-common/footer.adoc[] |
6d5b6948 MB |
87 | |
88 | ifdef::translation[] | |
625e9c61 | 89 | include::man-common/translation.adoc[] |
6d5b6948 | 90 | endif::[] |