From ba45d8c1ea4f1226033adc2c9446690bef69a806 Mon Sep 17 00:00:00 2001 From: Karel Zak Date: Fri, 9 Sep 2011 20:59:59 +0200 Subject: lscpu: add human readable extended cpu table output Based on patch from Heiko Carstens : 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 Signed-off-by: Karel Zak --- sys-utils/lscpu.1 | 29 +++++++++++++++++++++-------- 1 file changed, 21 insertions(+), 8 deletions(-) (limited to 'sys-utils/lscpu.1') 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'. -- cgit v1.2.3-55-g7522