]> git.ipfire.org Git - thirdparty/util-linux.git/commitdiff
lscpu: (man) add description of the --list-columns option
authorChristian Goeschel Ndjomouo <cgoesc2@wgu.edu>
Thu, 4 Sep 2025 20:46:25 +0000 (16:46 -0400)
committerChristian Goeschel Ndjomouo <cgoesc2@wgu.edu>
Thu, 4 Sep 2025 20:46:25 +0000 (16:46 -0400)
Signed-off-by: Christian Goeschel Ndjomouo <cgoesc2@wgu.edu>
sys-utils/lscpu.1.adoc

index ce48b9ff45d205cea69f75413a98cdc6b5d18e72..d87f137928d1ae60705c42532a6c10fa48a89f76 100644 (file)
@@ -16,7 +16,7 @@ lscpu - display information about the CPU architecture
 
 == DESCRIPTION
 
-*lscpu* gathers CPU architecture information from _sysfs_, _/proc/cpuinfo_ and any applicable architecture-specific libraries (e.g. *librtas* on Powerpc). The command output can be optimized for parsing or for easy readability by humans. The information includes, for example, the number of CPUs, threads, cores, sockets, and Non-Uniform Memory Access (NUMA) nodes. There is also information about the CPU caches and cache sharing, family, model, bogoMIPS, byte order, stepping and microcode.
+*lscpu* gathers CPU architecture information from _sysfs_, _/proc/cpuinfo_ and any applicable architecture-specific libraries (e.g. *librtas* on Powerpc). The command output can be optimized for parsing or for easy readability by humans. The information includes, for example, the number of CPUs, threads, cores, sockets, and Non-Uniform Memory Access (NUMA) nodes. There is also information about the CPU caches and cache sharing, family, model, bogoMIPS, byte order, stepping and microcode version.
 
 The default output formatting on a terminal is subject to change and may be 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. Use for example "*lscpu | less*" to see the default output without optimizations.
 
@@ -43,7 +43,7 @@ include::man-common/in-bytes.adoc[]
 Limit the output to online CPUs (default for *-p*). This option may only be specified together with option *-e* or *-p*.
 
 *-C*, *--caches*[**=**_list_]::
-Display details about CPU caches. For details about available information see *--help* output.
+Display details about CPU caches. For details about available information see *--list-columns* output.
 +
 If the _list_ argument is omitted, all columns for which data is available are included in the command output.
 +
@@ -67,6 +67,10 @@ Examples: *-e=cpu,node* or *--extended=cpu,node*.
 +
 The default list of columns may be extended if list is specified in the format +list (e.g., lscpu -e=+MHZ).
 
+*-H*, *--list-columns*::
+List the columns that can be specified with the *--extended*, *--parse* and *--caches* options.
+Can be used with *--json* or *--raw* to get the list in a machine-readable format.
+
 *--hierarchic*[**=**_when_]::
 Use subsections in summary output. For backward compatibility, the default is to use subsections only when output on a terminal, and to use flattened output on a non-terminal. The optional argument _when_ can be *never*, *always*, or *auto*. If the _when_ argument is omitted, it defaults to *always*.
 
@@ -136,7 +140,8 @@ On virtual hardware the number of cores per socket, etc. can be wrong.
 
 mailto:qcai@redhat.com[Cai Qian],
 mailto:kzak@redhat.com[Karel Zak],
-mailto:heiko.carstens@de.ibm.com[Heiko Carstens]
+mailto:heiko.carstens@de.ibm.com[Heiko Carstens],
+mailto:cgoesc2@wgu.edu[Christian Goeschel Ndjomouo]
 
 == SEE ALSO