projects / thirdparty / util-linux.git / blame
| Commit | Line | Data |
|---|---|---|
| 5dd7507c CQ |
1 | .\" Process this file with |
| 2 | .\" groff -man -Tascii lscpu.1 | |
| 3 | .\" | |
| 9b207793 | 4 | .TH LSCPU 1 "February 2011" Linux "User Manuals" |
| 5dd7507c CQ |
5 | .SH NAME |
| 6 | lscpu \- CPU architecture information helper | |
| 7 | .SH SYNOPSIS | |
| e7a5546c | 8 | .B lscpu |
| 9b207793 BS |
9 | .RB [ \-hpx ] |
| 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 | |
| 35 | supported are CPU, Core, Node, Socket, Book and Cache columns. If the | |
| 36 | \fIlist\fP argument is given then always all requested columns are printed in | |
| 37 | the defined order. The Cache columns are separated by ':'. | |
| 38 | ||
| 39 | Note that the optional \fIlist\fP argument cannot be separated from the | |
| 40 | option by a space, the correct form is for example '\fB-p=cpu,node\fP' or '\fB--parse=cpu,node\fP'. | |
| 9b207793 BS |
41 | .TP |
| 42 | .BR \-s , " \-\-sysroot " \fIdirectory\fP | |
| 43 | Use the specified \fIdirectory\fP as system root. This allows you to inspect | |
| 44 | a snapshot from a different system. | |
| 4f912c6a KZ |
45 | .TP |
| 46 | .BR \-x , " \-\-hex" | |
| 9b207793 BS |
47 | Use hexadecimal masks for CPU sets (e.g. 0x3). The default is to print the sets |
| 48 | in list format (e.g. 0,1). | |
| 5dd7507c | 49 | .SH BUGS |
| 7e03f383 KZ |
50 | The basic overview about CPU family, model, etc. is always based on the first |
| 51 | CPU only. | |
| c8b64f6d | 52 | |
| 9b207793 | 53 | Sometimes in Xen Dom0 the kernel reports wrong data. |
| 5dd7507c | 54 | .SH AUTHOR |
| 7e03f383 | 55 | .nf |
| 5dd7507c | 56 | Cai Qian <qcai@redhat.com> |
| 7e03f383 KZ |
57 | Karel Zak <kzak@redhat.com> |
| 58 | .fi | |
| 5dd7507c | 59 | .SH AVAILABILITY |
| 601d12fb KZ |
60 | The lscpu command is part of the util-linux package and is available from |
| 61 | ftp://ftp.kernel.org/pub/linux/utils/util-linux/. |