projects / thirdparty / util-linux.git / blame
| Commit | Line | Data |
|---|---|---|
| 5dd7507c CQ |
1 | .\" Process this file with |
| 2 | .\" groff -man -Tascii lscpu.1 | |
| 3 | .\" | |
| 232dc924 | 4 | .TH LSCPU 1 "February 2011" "util-linux" "User Commands" |
| 5dd7507c | 5 | .SH NAME |
| 232dc924 | 6 | lscpu \- display information on CPU architecture |
| 5dd7507c | 7 | .SH SYNOPSIS |
| e7a5546c | 8 | .B lscpu |
| 44de912c | 9 | .RB [ \-hpxV ] |
| 9b207793 BS |
10 | .RB [ \-s |
| 11 | .IR directory ] | |
| 5dd7507c CQ |
12 | .SH DESCRIPTION |
| 13 | .B lscpu | |
| 14 | gathers CPU architecture information like number of CPUs, threads, | |
| 15 | cores, sockets, NUMA nodes, information about CPU caches, CPU family, | |
| ad0ad79a | 16 | model, bogoMIPS, byte order and stepping from sysfs and /proc/cpuinfo, and prints it in |
| 9b207793 BS |
17 | a human-readable format. It supports both online and offline CPUs. |
| 18 | It can also print out in a parsable format, | |
| 19 | including how different caches are shared by different CPUs, | |
| 20 | which can be fed to other programs. | |
| 5dd7507c | 21 | .SH OPTIONS |
| e7a5546c PB |
22 | .TP |
| 23 | .BR \-h , " \-\-help" | |
| 5dd7507c | 24 | Print a help message. |
| e7a5546c | 25 | .TP |
| 477251f8 | 26 | .BR \-p , " \-\-parse " \fI[=list]\fP |
| 9b207793 | 27 | Print out in parsable instead of human-readable format. |
| 477251f8 KZ |
28 | |
| 29 | If the \fIlist\fP argument is not given then the default backwardly compatible | |
| 30 | output is printed. The backwardly compatible format uses two commas to | |
| 31 | separate CPU cache columns. If no CPU caches are identified, then the cache | |
| 32 | columns are not printed at all. | |
| 33 | ||
| 34 | The \fIlist\fP argument is comma delimited list of the columns. Currently | |
| 596b8845 HC |
35 | supported are CPU, Core, Node, Socket, Book, Cache, Polarization and Address |
| 36 | columns. | |
| 37 | If the \fIlist\fP argument is given then always all requested columns are printed in | |
| 477251f8 KZ |
38 | the defined order. The Cache columns are separated by ':'. |
| 39 | ||
| 40 | Note that the optional \fIlist\fP argument cannot be separated from the | |
| 41 | option by a space, the correct form is for example '\fB-p=cpu,node\fP' or '\fB--parse=cpu,node\fP'. | |
| 9b207793 BS |
42 | .TP |
| 43 | .BR \-s , " \-\-sysroot " \fIdirectory\fP | |
| 44 | Use the specified \fIdirectory\fP as system root. This allows you to inspect | |
| 45 | a snapshot from a different system. | |
| 4f912c6a KZ |
46 | .TP |
| 47 | .BR \-x , " \-\-hex" | |
| 9b207793 BS |
48 | Use hexadecimal masks for CPU sets (e.g. 0x3). The default is to print the sets |
| 49 | in list format (e.g. 0,1). | |
| 44de912c HC |
50 | .TP |
| 51 | .BR \-V , " \-\-version" | |
| 52 | Output version information and exit. | |
| 5dd7507c | 53 | .SH BUGS |
| 7e03f383 KZ |
54 | The basic overview about CPU family, model, etc. is always based on the first |
| 55 | CPU only. | |
| c8b64f6d | 56 | |
| 9b207793 | 57 | Sometimes in Xen Dom0 the kernel reports wrong data. |
| 5dd7507c | 58 | .SH AUTHOR |
| 7e03f383 | 59 | .nf |
| 5dd7507c | 60 | Cai Qian <qcai@redhat.com> |
| 7e03f383 KZ |
61 | Karel Zak <kzak@redhat.com> |
| 62 | .fi | |
| 0b57c6c2 HC |
63 | .SH "SEE ALSO" |
| 64 | .BR chcpu (1) | |
| 5dd7507c | 65 | .SH AVAILABILITY |
| 601d12fb KZ |
66 | The lscpu command is part of the util-linux package and is available from |
| 67 | ftp://ftp.kernel.org/pub/linux/utils/util-linux/. |