]> git.ipfire.org Git - thirdparty/util-linux.git/blob - sys-utils/lscpu.1
lscpu: add description of --sysroot option to man page, plus grammar touches
[thirdparty/util-linux.git] / sys-utils / lscpu.1
1 .\" Process this file with
2 .\" groff -man -Tascii lscpu.1
3 .\"
4 .TH LSCPU 1 "February 2011" Linux "User Manuals"
5 .SH NAME
6 lscpu \- CPU architecture information helper
7 .SH SYNOPSIS
8 .B lscpu
9 .RB [ \-hpx ]
10 .RB [ \-s
11 .IR directory ]
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,
16 model, bogoMIPS, byte order and stepping from sysfs and /proc/cpuinfo, and prints it in
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.
21 .SH OPTIONS
22 .TP
23 .BR \-h , " \-\-help"
24 Print a help message.
25 .TP
26 .BR \-p , " \-\-parse"
27 Print out in parsable instead of human-readable format.
28 .TP
29 .BR \-s , " \-\-sysroot " \fIdirectory\fP
30 Use the specified \fIdirectory\fP as system root. This allows you to inspect
31 a snapshot from a different system.
32 .TP
33 .BR \-x , " \-\-hex"
34 Use hexadecimal masks for CPU sets (e.g. 0x3). The default is to print the sets
35 in list format (e.g. 0,1).
36 .SH BUGS
37 The basic overview about CPU family, model, etc. is always based on the first
38 CPU only.
39
40 Sometimes in Xen Dom0 the kernel reports wrong data.
41 .SH AUTHOR
42 .nf
43 Cai Qian <qcai@redhat.com>
44 Karel Zak <kzak@redhat.com>
45 .fi
46 .SH AVAILABILITY
47 The lscpu command is part of the util-linux package and is available from
48 ftp://ftp.kernel.org/pub/linux/utils/util-linux/.