sys-utils/lscpu.1

   1 .\" Process this file with
   2 .\" groff -man -Tascii lscpu.1
   3 .\"
   4 .TH LSCPU 1 "February 2011" "util-linux" "User Commands"
   5 .SH NAME
   6 lscpu \- display information on CPU architecture
   7 .SH SYNOPSIS
   8 .B lscpu
   9 .RB [ \-hpxV ]
  10 .RB [ \-s
  11 .IR directory ]
  12 .SH DESCRIPTION
  13 .B lscpu
  14 gathers CPU architecture information like number of CPUs, threads,
  15 cores, sockets, NUMA nodes, information about CPU caches, CPU family,
  16 model, bogoMIPS, byte order and stepping from sysfs and /proc/cpuinfo, and prints it in
  17 a human-readable format.  It supports both online and offline CPUs.
  18 It can also print out in a parsable format,
  19 including how different caches are shared by different CPUs,
  20 which can be fed to other programs.
  21 .SH OPTIONS
  22 .TP
  23 .BR \-h , " \-\-help"
  24 Print a help message.
  25 .TP
  26 .BR \-p , " \-\-parse " \fI[=list]\fP
  27 Print out in parsable instead of human-readable format.
  28
  29 If the \fIlist\fP argument is not given then the default backwardly compatible
  30 output is printed.  The backwardly compatible format uses two commas to
  31 separate CPU cache columns. If no CPU caches are identified, then the cache
  32 columns are not printed at all.
  33
  34 The \fIlist\fP argument is comma delimited list of the columns. Currently
  35 supported are CPU, Core, Node, Socket, Book, Cache, Polarization and Address
  36 columns.
  37 If the \fIlist\fP argument is given then always all requested columns are printed in
  38 the defined order. The Cache columns are separated by ':'.
  39
  40 Note that the optional \fIlist\fP argument cannot be separated from the
  41 option by a space, the correct form is for example '\fB-p=cpu,node\fP' or '\fB--parse=cpu,node\fP'.
  42 .TP
  43 .BR \-s , " \-\-sysroot " \fIdirectory\fP
  44 Use the specified \fIdirectory\fP as system root.  This allows you to inspect
  45 a snapshot from a different system.
  46 .TP
  47 .BR \-x , " \-\-hex"
  48 Use hexadecimal masks for CPU sets (e.g. 0x3).  The default is to print the sets
  49 in list format (e.g. 0,1).
  50 .TP
  51 .BR \-V , " \-\-version"
  52 Output version information and exit.
  53 .SH BUGS
  54 The basic overview about CPU family, model, etc. is always based on the first
  55 CPU only.
  56
  57 Sometimes in Xen Dom0 the kernel reports wrong data.
  58 .SH AUTHOR
  59 .nf
  60 Cai Qian <qcai@redhat.com>
  61 Karel Zak <kzak@redhat.com>
  62 .fi
  63 .SH "SEE ALSO"
  64 .BR chcpu (1)
  65 .SH AVAILABILITY
  66 The lscpu command is part of the util-linux package and is available from
  67 ftp://ftp.kernel.org/pub/linux/utils/util-linux/.