89 lines
3.0 KiB
Groff
89 lines
3.0 KiB
Groff
.\" 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 [ \-abcehpxV ]
|
|
.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 \-c , " \-\-offline"
|
|
Include only offline CPUs in output.
|
|
.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/.
|