From f5de212c5f71857b4278c453a099f0d73b152dca Mon Sep 17 00:00:00 2001 From: Christian Goeschel Ndjomouo Date: Thu, 4 Sep 2025 16:46:25 -0400 Subject: [PATCH] lscpu: (man) add description of the --list-columns option Signed-off-by: Christian Goeschel Ndjomouo --- sys-utils/lscpu.1.adoc | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/sys-utils/lscpu.1.adoc b/sys-utils/lscpu.1.adoc index ce48b9ff4..d87f13792 100644 --- a/sys-utils/lscpu.1.adoc +++ b/sys-utils/lscpu.1.adoc @@ -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 -- 2.47.3