.\" Process this file with
.\" groff -man -Tascii lscpu.1
.\"
.TH LSCPU 1 "February 2011" "util-linux" "User Commands"
.SH NAME
lscpu \- display information on CPU architecture
.SH SYNOPSIS
.B lscpu
.RB [ \-aehpxV ]
.RB [ \-s
.IR directory ]
.SH DESCRIPTION
.B lscpu
gathers CPU architecture information like number of CPUs, threads,
cores, sockets, NUMA nodes, information about CPU caches, CPU family,
model, bogoMIPS, byte order and stepping from sysfs and /proc/cpuinfo, and prints it in
a human-readable format. It supports both online and offline CPUs.
It can also print out in a parsable format,
including how different caches are shared by different CPUs,
which can be fed to other programs.
Some options have a \fIlist\fP argument. The \fIlist\fP argument is a comma
delimited list of the columns. Currently supported are CPU, Core, Node, Socket,
Book, Cache, Polarization, Address, Configured and Online columns.
If the \fIlist\fP argument is given then all requested columns are printed in
the defined order.
.SH OPTIONS
.TP
.BR \-a , " \-\-all"
Include online and offline CPUs in output (default for -e)
.TP
.BR \-b , " \-\-online"
Include only online CPUs in output (default for -p)
.TP
.BR \-e , " \-\-extended " \fI[=list]\fP
Print CPU list out in human-readable format.
If the \fIlist\fP argument is not given then all columns where data is
available will be printed.
Note that the optional \fIlist\fP argument cannot be separated from the
option by a space, the correct form is for example '\fB-e=cpu,node\fP' or '\fB--extended=cpu,node\fP'.
.TP
.BR \-h , " \-\-help"
Print a help message.
.TP
.BR \-p , " \-\-parse " \fI[=list]\fP
Print out in parsable format.
If the \fIlist\fP argument is not given then the default backwardly compatible
output is printed. The backwardly compatible format uses two commas to
separate CPU cache columns. If no CPU caches are identified, then the cache
columns are not printed at all.
.br
If the \fIlist\fP argument is given then the cache columns are separated by ':'.
Note that the optional \fIlist\fP argument cannot be separated from the
option by a space, the correct form is for example '\fB-p=cpu,node\fP' or '\fB--parse=cpu,node\fP'.
.TP
.BR \-s , " \-\-sysroot " \fIdirectory\fP
Use the specified \fIdirectory\fP as system root. This allows you to inspect
a snapshot from a different system.
.TP
.BR \-x , " \-\-hex"
Use hexadecimal masks for CPU sets (e.g. 0x3). The default is to print the sets
in list format (e.g. 0,1).
.TP
.BR \-V , " \-\-version"
Output version information and exit.
.SH BUGS
The basic overview about CPU family, model, etc. is always based on the first
CPU only.
Sometimes in Xen Dom0 the kernel reports wrong data.
.SH AUTHOR
.nf
Cai Qian <qcai@redhat.com>
Karel Zak <kzak@redhat.com>
.fi
.SH "SEE ALSO"
.BR chcpu (1)
.SH AVAILABILITY
The lscpu command is part of the util-linux package and is available from
ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
