summaryrefslogtreecommitdiffstats
path: root/sys-utils/lscpu.1
diff options
context:
space:
mode:
authorKarel Zak2011-09-09 20:59:59 +0200
committerKarel Zak2011-09-09 23:41:01 +0200
commitba45d8c1ea4f1226033adc2c9446690bef69a806 (patch)
treea06b51321bd5618e4187525c554c1243acb6990e /sys-utils/lscpu.1
parentlscpu: use buffer for data and headers (diff)
downloadkernel-qcow2-util-linux-ba45d8c1ea4f1226033adc2c9446690bef69a806.tar.gz
kernel-qcow2-util-linux-ba45d8c1ea4f1226033adc2c9446690bef69a806.tar.xz
kernel-qcow2-util-linux-ba45d8c1ea4f1226033adc2c9446690bef69a806.zip
lscpu: add human readable extended cpu table output
Based on patch from Heiko Carstens <heiko.carstens@de.ibm.com>: lscpu currently only supports a parsable output which contains a row for each cpu and its attributes. This output contains only comas as separators and is hard to read for humans. Therefore add a new option "-e | --extended" which outputs the rows in a much more readable (and non-parsable) form. Just like for the -p option a list of columns can be specified that shall be included in the output. By default this option will print all columns that contain data. Signed-off-by: Heiko Carstens <heiko.carstens@de.ibm.com> Signed-off-by: Karel Zak <kzak@redhat.com>
Diffstat (limited to 'sys-utils/lscpu.1')
-rw-r--r--sys-utils/lscpu.129
1 files changed, 21 insertions, 8 deletions
diff --git a/sys-utils/lscpu.1 b/sys-utils/lscpu.1
index b7b4fe96c..30dfbc61f 100644
--- a/sys-utils/lscpu.1
+++ b/sys-utils/lscpu.1
@@ -6,7 +6,7 @@
lscpu \- display information on CPU architecture
.SH SYNOPSIS
.B lscpu
-.RB [ \-hpxV ]
+.RB [ \-ehpxV ]
.RB [ \-s
.IR directory ]
.SH DESCRIPTION
@@ -18,24 +18,37 @@ 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 and Address columns.
+If the \fIlist\fP argument is given then all requested columns are printed in
+the defined order.
+
.SH OPTIONS
.TP
+.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 instead of human-readable format.
+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.
-
-The \fIlist\fP argument is comma delimited list of the columns. Currently
-supported are CPU, Core, Node, Socket, Book, Cache, Polarization and Address
-columns.
-If the \fIlist\fP argument is given then always all requested columns are printed in
-the defined order. The Cache columns are separated by ':'.
+.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'.