summaryrefslogtreecommitdiffstats
path: root/sys-utils/lscpu.1
diff options
context:
space:
mode:
authorHeiko Carstens2016-07-29 14:13:32 +0200
committerKarel Zak2016-08-03 13:35:05 +0200
commit0d2b5d2a72bc6619229a4d7456fbb70eda561825 (patch)
tree22fa1ec7b68f122a54f8995e453ec579eba7810d /sys-utils/lscpu.1
parenttests: remove unnecessary file (diff)
downloadkernel-qcow2-util-linux-0d2b5d2a72bc6619229a4d7456fbb70eda561825.tar.gz
kernel-qcow2-util-linux-0d2b5d2a72bc6619229a4d7456fbb70eda561825.tar.xz
kernel-qcow2-util-linux-0d2b5d2a72bc6619229a4d7456fbb70eda561825.zip
lscpu: add --physical option
With the --physical option lscpu will use the IDs that are reported by the kernel (e.g. core id for the CORE column) instead of calculating them on it's own. This has the advantage that it is possible to tell on which physical hardware CPUs a Linux instance runs. The logical IDs that lscpu generates on it own are based on comparing of CPU masks and may or may not be identical with the physical IDs. If the kernel was unable to retrieve an ID for a topology element then the corresponding sysfs file will normally contain "-1". In the extended and parsable output a dash "-" will be displayed for such cases. Signed-off-by: Heiko Carstens <heiko.carstens@de.ibm.com>
Diffstat (limited to 'sys-utils/lscpu.1')
-rw-r--r--sys-utils/lscpu.112
1 files changed, 11 insertions, 1 deletions
diff --git a/sys-utils/lscpu.1 b/sys-utils/lscpu.1
index ffe18db63..72065d611 100644
--- a/sys-utils/lscpu.1
+++ b/sys-utils/lscpu.1
@@ -3,7 +3,7 @@
lscpu \- display information about the CPU architecture
.SH SYNOPSIS
.B lscpu
-.RB [ \-a | \-b | \-c "] [" \-x "] [" \-s " \fIdirectory\fP] [" \-e [=\fIlist\fP]| \-p [=\fIlist\fP]]
+.RB [ \-a | \-b | \-c "] [" \-x "] [" \-y "] [" \-s " \fIdirectory\fP] [" \-e [=\fIlist\fP]| \-p [=\fIlist\fP]]
.br
.B lscpu
.BR \-h | \-V
@@ -145,6 +145,16 @@ of the Linux instance to be inspected.
Use hexadecimal masks for CPU sets (for example 0x3). The default is to print
the sets in list format (for example 0,1).
.TP
+.BR \-y , " \-\-physical"
+Display physical IDs for all columns with topology elements (core, socket, etc.).
+Other than logical IDs, which are assigned by \fBlscpu\fP, physical IDs are
+platform-specific values that are provided by the kernel. Physical IDs are not
+necessarily unique and they might not be arranged sequentially.
+If the kernel could not retrieve a physical ID for an element \fBlscpu\fP prints
+the dash (-) character.
+
+The CPU logical numbers are not affected by this option.
+.TP
.BR \-V , " \-\-version"
Display version information and exit.
.SH BUGS