-.TH LSCPU 1 "November 2015" "util-linux" "User Commands"
+.TH LSCPU 1 "March 2019" "util-linux" "User Commands"
.SH NAME
lscpu \- display information about the CPU architecture
.SH SYNOPSIS
.B lscpu
-.RB [ \-a | \-b | \-c | \-J "] [" \-x "] [" \-y "] [" \-s " \fIdirectory\fP] [" \-e [=\fIlist\fP]| \-p [=\fIlist\fP]]
-.br
-.B lscpu
-.BR \-h | \-V
+[options]
.SH DESCRIPTION
.B lscpu
gathers CPU architecture information from sysfs, /proc/cpuinfo and any
.sp
Not all columns are supported on all architectures. If an unsupported column is
specified, \fBlscpu\fP prints the column but does not provide any data for it.
-
+.sp
+The default output formatting on terminal maybe optimized for better
+readability. The output for non-terminals (e.g. pipes) is never affected by
+this optimization and it is always in "Field: data\\n" format.
.SS COLUMNS
Note that topology elements (core, socket, etc.) use a sequential unique ID
starting from zero, but CPU logical numbers follow the kernel where there is
Include lines for online and offline CPUs in the output (default for \fB-e\fR).
This option may only be specified together with option \fB-e\fR or \fB-p\fR.
.TP
+.BR \-B , " \-\-bytes"
+Print the sizes in bytes rather than in a human-readable format.
+.TP
.BR \-b , " \-\-online"
Limit the output to online CPUs (default for \fB-p\fR).
This option may only be specified together with option \fB-e\fR or \fB-p\fR.
.TP
+.BR \-C , " \-\-caches" [=\fIlist\fP]
+Display details about CPU caches. For details about available information see \fB\-\-help\fR
+output.
+
+If the \fIlist\fP argument is omitted, all columns for which data is available
+are included in the command output.
+
+When specifying the \fIlist\fP argument, the string of option, equal sign (=), and
+\fIlist\fP must not contain any blanks or other whitespace.
+Examples: '\fB-C=NAME,ONE-SIZE\fP' or '\fB--caches=NAME,ONE-SIZE\fP'.
+.TP
.BR \-c , " \-\-offline"
Limit the output to offline CPUs.
This option may only be specified together with option \fB-e\fR or \fB-p\fR.
.TP
.BR \-J , " \-\-json"
Use JSON output format for the default summary or extended output (see \fB\-\-extended\fP).
-.BR
.TP
.BR \-p , " \-\-parse" [=\fIlist\fP]
Optimize the command output for easy parsing.
of the Linux instance to be inspected.
.TP
.BR \-x , " \-\-hex"
-Use hexadecimal masks for CPU sets (for example 0x3). The default is to print
-the sets in list format (for example 0,1).
+Use hexadecimal masks for CPU sets (for example "ff"). The default is to print
+the sets in list format (for example 0,1). Note that before version 2.30 the mask
+has been printed with 0x prefix.
.TP
.BR \-y , " \-\-physical"
Display physical IDs for all columns with topology elements (core, socket, etc.).
.TP
.B \-\-output\-all
Output all available columns. This option must be combined with either
-.BR \-\-extended " or " \-\-parse .
+.BR \-\-extended ", " \-\-parse " or " \-\-caches .
.SH BUGS
The basic overview of CPU family, model, etc. is always based on the first
CPU only.