1LSCPU(1) User Commands LSCPU(1)
2
6 lscpu - display information about the CPU architecture
7
9 lscpu [-a|-b|-c] [-x] [-s directory] [-e [=list]|-p [=list]]
10 lscpu -h|-V
11
13 lscpu gathers CPU architecture information from sysfs and
14 /proc/cpuinfo. The command output can be optimized for parsing or for
15 easy readability by humans.
16 The information includes, for example, the number of CPUs, threads,
17 cores, sockets, and Non-Uniform Memory Access (NUMA) nodes. There is
18 also information about the CPU caches and cache sharing, family, model,
19 bogoMIPS, byte order, and stepping.
20 Options that result in an output table have a list argument. Use this
22 argument to customize the command output. Specify a comma-separated
23 list of column labels to limit the output table to only the specified
24 columns, arranged in the specified order. See COLUMNS for a list of
25 valid column labels. The column labels are not case sensitive.
26 Not all columns are supported on all architectures. If an unsupported
28 column is specified, lscpu prints the column but does not provide any
29 data for it.
30 COLUMNS
33 CPU The logical CPU number of a CPU as used by the Linux kernel.
34 CORE The logical core number. A core can contain several CPUs.
36 SOCKET The logical socket number. A socket can contain several cores.
38 BOOK The logical book number. A book can contain several sockets.
40 NODE The logical NUMA node number. A node may contain several books.
42 CACHE Information about how caches are shared between CPUs.
44 ADDRESS
46 The physical address of a CPU.
47 ONLINE Indicator that shows whether the Linux instance currently makes
49 use of the CPU.
50 CONFIGURED
52 Indicator that shows if the hypervisor has allocated the CPU to
53 the virtual hardware on which the Linux instance runs. CPUs that
54 are configured can be set online by the Linux instance. This
55 column contains data only if your hardware system and hypervisor
56 support dynamic CPU resource allocation.
57 POLARIZATION
59 This column contains data for Linux instances that run on vir‐
60 tual hardware with a hypervisor that can switch the CPU dis‐
61 patching mode (polarization). The polarization can be:
62 horizontal The workload is spread across all available CPUs.
64 vertical The workload is concentrated on few CPUs.
66 For vertical polarization, the column also shows the degree of
68 concentration, high, medium, or low. This column contains data
69 only if your hardware system and hypervisor support CPU polar‐
70 ization.
71
73 -a, --all
74 Include lines for online and offline CPUs in the output (default
75 for -e). This option may only specified together with option -e
76 or -p.
77 -b, --online
79 Limit the output to online CPUs (default for -p). This option
80 may only be specified together with option -e or -p.
81 -c, --offline
83 Limit the output to offline CPUs. This option may only be speci‐
84 fied together with option -e or -p.
85 -e, --extended [=list]
87 Display the CPU information in human readable format.
88 If the list argument is omitted, all columns for which data is
90 available are included in the command output.
91 When specifying the list argument, the string of option, equal
93 sign (=), and list must not contain any blanks or other white
94 space. Examples: '-e=cpu,node' or '--extended=cpu,node'.
95 -h, --help
97 Display help information and exit.
98 -p, --parse [=list]
100 Optimize the command output for easy parsing.
101 If the list argument is omitted, the command output is compati‐
103 ble with earlier versions of lscpu. In this compatible format,
104 two commas are used to separate CPU cache columns. If no CPU
105 caches are identified the cache column is omitted.
106 If the list argument is used, cache columns are separated with a
107 colon (:).
108 When specifying the list argument, the string of option, equal
110 sign (=), and list must not contain any blanks or other white
111 space. Examples: '-p=cpu,node' or '--parse=cpu,node'.
112 -s, --sysroot directory
114 Gather CPU data for a Linux instance other than the instance
115 from which the lscpu command is issued. The specified directory
116 is the system root of the Linux instance to be inspected.
117 -x, --hex
119 Use hexadecimal masks for CPU sets (for example 0x3). The
120 default is to print the sets in list format (for example 0,1).
121 -V, --version
123 Display version information and exit.
124
126 The basic overview about CPU family, model, etc. is always based on the
127 first CPU only.
128 Sometimes in Xen Dom0 the kernel reports wrong data.
130 On virtual hardware the number of cores per socket, etc. can be wrong.
132
134 Cai Qian <qcai@redhat.com>
135 Karel Zak <kzak@redhat.com>
136 Heiko Carstens <heiko.carstens@de.ibm.com>
137
139 chcpu(8)
140
142 The lscpu command is part of the util-linux package and is available
143 from ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
144util-linux February 2011 LSCPU(1)