1INXI(1)                           inxi manual                          INXI(1)
2
3
4

NAME

6       inxi - Command line system information script for console and IRC
7
8

SYNOPSIS

10       inxi
11
12       inxi [-AbBCdDEfFGhiIjJlLmMnNopPrRsSuUVwyYzZ]
13
14       inxi  [-c  -NUMBER] [--sensors-exclude SENSORS] [--sensors-use SENSORS]
15       [-t [c|m|cm|mc][NUMBER]]  [-v  NUMBER]  [-W  LOCATION]  [--weather-unit
16       {m|i|mi|im}] [-y WIDTH]
17
18       inxi   [--edid]   [--memory-modules]   [--memory-short]  [--recommends]
19       [--sensors-default] [--slots]
20
21       inxi [-x|-xx|-xxx|-a] -OPTION(s)
22
23       All short form options have long form variants - see  below  for  these
24       and more advanced options.
25
26

DESCRIPTION

28       inxi  is a command line system information script built for console and
29       IRC. It is also used a debugging tool for forum  technical  support  to
30       quickly ascertain users' system configurations and hardware. inxi shows
31       system hardware, CPU, drivers, Xorg, Desktop, Kernel,  gcc  version(s),
32       Processes, RAM usage, and a wide variety of other useful information.
33
34       inxi output varies depending on whether it is being used on CLI or IRC,
35       with some default filters and color options applied only for  IRC  use.
36       Script  colors can be turned off if desired with -c 0, or changed using
37       the -c color options listed in the STANDARD OPTIONS section below.
38
39

PRIVACY AND SECURITY

41       In order to maintain basic privacy and security, inxi used on IRC auto‐
42       matically  filters out your network device MAC address, WAN and LAN IP,
43       your /home username directory in partitions, and a few other items.
44
45       Because inxi is often used on forums for support, you can also  trigger
46       this  filtering  with the -z option (-Fz, for example). To override the
47       IRC filter, you can use the -Z option. This can be useful in  debugging
48       network connection issues online in a private chat, for example.
49
50

TABLE OF CONTENTS

52       This man page is pretty long and information packed. It is divided into
53       the following sections:
54
55       * USING OPTIONS How to use the command line options.
56
57       * STANDARD OPTIONS Primary data types trigger items.
58
59       * FILTER OPTIONS Apply a variety of output filters.
60
61       * OUTPUT CONTROL OPTIONS Change default colors, widths, heights, output
62       types, etc.
63
64       *  EXTRA DATA OPTIONS What -x, -xx, and -xxx add to the output per pri‐
65       mary data type.
66
67       * ADMIN EXTRA DATA OPTIONS What -a adds to the output per primary  data
68       type.  These  have  a lot of information because this is advanced admin
69       data, which are not always intuitive or easy to understand.
70
71       * ADVANCED OPTIONS Modify behavior or choice of data sources, and other
72       advanced switches.
73
74       *  DEBUGGING  OPTIONS  For  development  use  mainly,  or  contributing
75       datasets to the project.
76
77       * DEBUGGING OPTIONS TO DEBUG DEBUGGER FAILURES Only for advanced users,
78       sometimes  something  will  hang  the debuggers, this shows you various
79       ways to get around those failures.
80
81       * SUPPORTED IRC CLIENTS List of known good IRC clients. Not checked of‐
82       ten, let us know if something is not working.
83
84       * RUNNING IN IRC CLIENT How to run inxi in various IRC clients.
85
86       *  CONFIGURATION  FILE Configuration file locations and priority in us‐
87       ing.
88
89       * CONFIGURATION OPTIONS Most of the  commonly  used  configuration  op‐
90       tions, along with sample values.
91
92       * BUGS How and where to report bugs.
93
94       * HOMEPAGE, AUTHOR AND CONTRIBUTORS TO CODE, SPECIAL THANKS TO THE FOL‐
95       LOWING These are self explanitory.
96
97

USING OPTIONS

99       Options can be combined if they do not conflict. You can  either  group
100       the letters together or separate them.
101
102       Letters  with  numbers can have no gap or a gap at your discretion, ex‐
103       cept when using  -t. Note that if you use an option  that  requires  an
104       additional  argument,  that must be last in the short form group of op‐
105       tions. Otherwise you can use those separately as well.
106
107       For example: inxi -AG | inxi -A -G  |  inxi  -b  |  inxi  -c10  |  inxi
108       -FxxzJy90 | inxi -bay
109
110       Note  that all the short form options have long form equivalents, which
111       are listed below. However, usually the short form is used  in  examples
112       in order to keep things simple.
113
114

STANDARD OPTIONS

116       -A , --audio
117              Show Audio/sound device(s) information, including device driver.
118              Show running sound server(s). See -xxA to show all sound servers
119              detected.
120
121
122       -b , --basic
123              Show basic output, short form. Same as: inxi -v 2
124
125
126       -B , --battery
127              Show  system  battery (ID-x) data, charge, condition, plus extra
128              information (if battery present). Uses /sys or, for BSDs without
129              systctl  battery  data, use --dmidecode to force its use. dmide‐
130              code does not have very much information, and none about current
131              battery  state/charge/voltage.  Supports multiple batteries when
132              using /sys or sysctl data.
133
134              Note that for charge:, the output shows the current  charge,  as
135              well  as  its  value  as a percentage of the available capacity,
136              which can be less than the original design capacity. In the fol‐
137              lowing  example,  the  actual  current available capacity of the
138              battery is 22.2 Wh.
139
140              charge: 20.1 Wh (95.4%)
141
142              The condition: item shows the  remaining  available  capacity  /
143              original  design  capacity, and then this figure as a percentage
144              of original capacity available in the battery.
145
146              condition: 22.2/36.4 Wh (61%)
147
148              With -x, or if voltage difference is critical, volts: item shows
149              the current voltage, and the min: voltage. Note that if the cur‐
150              rent is below the minimum listed the battery is essentially dead
151              and  will  not charge.  Test that to confirm, but that's techni‐
152              cally how it's supposed to work.
153
154              volts: 12.0 min: 11.4
155
156              With -x shows attached Device-x  information  (mouse,  keyboard,
157              etc.) if they are battery powered.
158
159
160       --bluetooth
161              See -E.
162
163
164       -c , --color
165              See OUTPUT CONTROL OPTIONS.
166
167
168       -C , --cpu
169              Show  full CPU output (if each item available): basic CPU topol‐
170              ogy, model, type, L2 cache, average speed of all cores (if  >  1
171              core,  otherwise speed of the core), min/max speeds for CPU, and
172              per CPU clock speed. More data available with -x, -xxx,  and  -a
173              options.
174
175              Explanation of CPU type (type: MT MCP) abbreviations:
176
177              *  AMCP  - Asymmetric Multi Core Processor. More than 1 core per
178              CPU, and more than one core type (single and multithreaded cores
179              in the same CPU).
180
181              *  AMP  - Asymmetric Multi Processing (more than 1 physical CPU,
182              but not identical in terms of core counts or min/max speeds).
183
184              * MT - Multi/Hyper Threaded CPU (more than 1  thread  per  core,
185              previously HT).
186
187              *  MST  -  Multi and Single Threaded CPU (a CPU with both Single
188              and Multi Threaded cores).
189
190              * MCM - Multi Chip Model (more than 1 die per CPU).
191
192              * MCP - Multi Core Processor (more than 1 core per CPU).
193
194              * SMP - Symmetric Multi Processing (more than 1 physical CPU).
195
196              * UP - Uni (single core) Processor.
197
198              Note that min/max: speeds are not necessarily true in  cases  of
199              overclocked CPUs or CPUs in turbo/boost mode. See -Ca for alter‐
200              nate base/boost: speed data, more granular cache data, and more.
201
202              Sample:
203              CPU:
204                Info: 2x 8-core model: Intel Xeon E5-2620 v4 bits: 64 type: MT MCP SMP
205                  cache: L2: 2x 2 MiB (4 MiB)
206                Speed (MHz): avg: 1601 min/max: 1200/3000 cores: 1: 1280 2: 1595 3: 1416
207                  ... 32: 1634
208
209
210       -d , --disk-full,--optical
211              Show optical drive data as well as -D hard drive data. With  -x,
212              adds  a  feature  line to the output. Also shows floppy disks if
213              present. Note that there is no current way to get  any  informa‐
214              tion  about  the  floppy device that we are aware of, so it will
215              simply show the floppy ID without any extra data. -xx adds a few
216              more features.
217
218
219       -D , --disk
220              Show Hard Disk info. Shows total disk space and used percentage.
221              The disk used percentage includes  space  used  by  swap  parti‐
222              tion(s),  since those are not usable for data storage. Also, un‐
223              mounted partitions are not counted in disk use percentages since
224              inxi has no access to the used amount.
225
226              If the system has RAID or other logical storage, and if inxi can
227              determine the size of those vs their components,  you  will  see
228              the storage total raw and usable sizes, plus the percent used of
229              the usable size. The no argument short form of  inxi  will  show
230              only  the  usable  (or  total if no usable) and used percent. If
231              there is no logical storage detected, only total: and used: will
232              show. Sample (with RAID logical size calculated):
233
234              Local  Storage: total: raw: 5.49 TiB usable: 2.80 TiB used: 1.35
235              TiB (48.3%)
236
237              Without logical storage detected:
238
239              Local Storage: total: 2.89 TiB used: 1.51 TiB (52.3%)
240
241              Also shows per disk information: Disk  ID,  type  (if  present),
242              vendor  (if  detected),  model, and size. See Extra Data Options
243              (-x options) and Admin Extra Data Options (--admin options)  for
244              many more features.
245
246
247       -E, --bluetooth
248              Show  bluetooth  device(s),  drivers.  Show Report: with HCI ID,
249              state, address per device (requires  bt-adapter  or  hciconfig),
250              and if available (hciconfig only) bluetooth version (bt-v).  See
251              Extra Data Options for more.
252
253              If bluetooth shows as status: down, shows bt-service: state  and
254              rfkill software and hardware blocked states, and rfkill ID.
255
256              Note that Report-ID: indicates that the HCI item was not able to
257              be linked to a specific device, similar to IF-ID: in -n.
258
259              If your internal bluetooth device does not show,  it's  possible
260              that  it has been disabled, if you try enabling it using for ex‐
261              ample:
262
263              hciconfig hci0 up
264
265              and it returns a blocked by RF-Kill error, you  can  do  one  of
266              these:
267
268              connmanctl enable bluetooth
269
270              or
271
272              rfkill list bluetooth
273
274              rfkill unblock bluetooth
275
276
277       --edid
278              Triggers full EDID data in Graphics, activates -G and -a.
279
280              -         Adds         monitor        chromacity        (chroma:
281              red:..green:...blue:...white:).
282
283              - Shows all available monitor modes if >  2  present,  in  comma
284              separated list.
285
286              - Shows EDID errors and warnings if any present.
287
288
289       --filter, -z
290              See FILTER OPTIONS.
291
292
293       -f , --flags
294              Show all CPU flags used, not just the short list. Not shown with
295              -F in order to avoid spamming. ARM CPUs: show features items.
296
297
298       -F , --full
299              Show Full output for inxi. Includes all Upper Case line  letters
300              (except  -J  and -W) plus --swap, -s and -n. Does not show extra
301              verbose options such as -d -f -i -J -l -m -o -p -r -t -u -x  un‐
302              less you use those arguments in the command, e.g.: inxi -Frmxx
303
304
305       --gpu  Deprecated. See -G -a.
306
307
308       -G , --graphics
309              Show  Graphic device(s) information, including details of device
310              and display drivers (X: loaded:, and, if applicable:  unloaded:,
311              failed:,  dri:  (if X and different from loaded X drivers) driv‐
312              ers, and active gpu: drivers), display protocol (if  available),
313              display  server  (and/or Wayland compositor), vendor and version
314              number, e.g.:
315
316              Display: x11 server: Xorg v: 1.15.1
317
318              or
319
320              Display: wayland server: X.org v: 1.20.1 with: Xwayland v: 20.1
321
322              If protocol is not detected, shows:
323
324              Display: server: Xorg 1.15.1
325
326              Also shows screen resolution(s) (per  monitor/X  screen).  Shows
327              graphics  API  used,  like  OpenGL.  For X.org: OpenGL renderer,
328              OpenGL core profile version/OpenGL version; for VESA: data  (for
329              Xvesa); for Wayland: GBM/EGL data (not implemented).
330
331              Compositor information will show if detected using -xx option or
332              always if detected and  Wayland  since  the  compositor  is  the
333              server with Wayland.
334
335              -Gxx  shows  monitor data as well, if detected. --edid shows ad‐
336              vanced monitor data (full modes, chroma, etc.).
337
338
339       -h , --help
340              The help menu. Features dynamic sizing to fit into terminal win‐
341              dow.  Set script global COLS_MAX_CONSOLE if you want a different
342              default value, or use -y <width> to temporarily override the de‐
343              faults or actual window width.
344
345
346       -i , --ip
347              Show WAN IP address and local interfaces (latter requires ifcon‐
348              fig or ip network tool), as well as network output from -n.  Not
349              shown  with  -F  for  user security reasons. You shouldn't paste
350              your local/WAN IP.  Shows both IPv4 and IPv6 link IP addresses.
351
352
353       -I , --info
354              Show Information: processes,  uptime,  memory,  IRC  client  (or
355              shell  type  if  run  in shell, not IRC), inxi version. See -Ix,
356              -Ixx, and -Ia for extra  information  (init  type/version,  run‐
357              level/target, packages).
358
359              Note:  if  -m is used or triggered, the memory item will show in
360              the main Memory: report of -m, not in Info:.
361
362              Raspberry Pi only: uses vcgencmd get_mem  gpu  to  get  gpu  RAM
363              amount,  if  user  is  in video group and vcgencmd is installed.
364              Uses this result  to  increase  the  Memory:  amount  and  used:
365              amounts.
366
367
368       -j, --swap
369              Shows  all  active swap types (partition, file, zram). When this
370              option is used, swap partition(s) will not show on the  -P  line
371              to avoid redundancy.
372
373              To show partition labels or UUIDs (when available and relevant),
374              use with -l or -u.
375
376
377       -J , --usb
378              Show USB data for attached Hubs and Devices. Hubs also show num‐
379              ber  of ports. Be aware that a port is not always external, some
380              may be internal, and either used or unused (for example, a moth‐
381              erboard USB header connector that is not used).
382
383              Hubs and Devices are listed in order of BusID.
384
385              BusID  is generally in this format: BusID-port[.port][.port]:De‐
386              viceID
387
388              Device ID is a number created by the kernel, and has  no  neces‐
389              sary  ordering  or sequence connection, but can be used to match
390              this output to lsusb values, which generally shows BusID / Devi‐
391              ceID (except for tree view, which shows ports).
392
393              Examples: Device-3: 4-3.2.1:2 or Hub: 4-0:1
394
395              The rev: 2.0 item refers to the USB revision number, like 1.0 or
396              3.1.
397
398
399       -l , --label
400              Show partition labels. Use with -j, -o, -p, and -P to show  par‐
401              tition labels. Does nothing without one of those options.
402
403              Sample: -ojpl.
404
405
406       -L, --logical
407              Show  Logical  volume  information,  for LVM, LUKS, bcache, etc.
408              Shows size, free space (for LVM VG). For LVM, shows Device-[xx]:
409              VG: (Volume Group) size/free, LV-[xx] (Logical Volume). LV shows
410              type, size, and components.  Note that components are made up of
411              either  containers  (aka, logical devices), or physical devices.
412              The full report requires doas/sudo/root.
413
414              Logical block devices can be thought of as devices that are made
415              up  out  of  either  other logical devices, or physical devices.
416              inxi does its best to show what each logical device is made  out
417              of.  RAID devices form a subset of all possible Logical devices,
418              but have their own section, -R.
419
420              If -R is used with -Lxx, -Lxx will not show RAID information for
421              LVM RAID devices since it's redundant. If -R is not used, a sim‐
422              ple RAID line will appear for LVM RAID in -Lxx.
423
424              -Lxx also shows all components and devices. Note that since com‐
425              ponents  can go in many levels, each level per primary component
426              is indicated by either another 'c', or ends with a  'p'  device,
427              the  physical  device.  The  number  of c's or p's indicates the
428              depth, so you can see which component belongs to which.
429
430              -L shows only the top level components/devices (like  -R).   -La
431              shows  component/device size, maj:min ID, mapped name (if appli‐
432              cable), and puts each component/device on its own line.
433
434              Sample:
435
436                Device-10: mybackup type: LUKS dm: dm-28 size: 6.36 GiB Components:
437                  c-1: md1 cc-1: dm-26 ppp-1: sdj2 cc-2: dm-27 ppp-1: sdk2
438                LV-5: lvm_raid1 type: raid1 dm: dm-16 size: 4.88 GiB
439                  RAID: stripes: 2 sync: idle copied: 100% mismatches: 0
440                Components: c-1: dm-10 pp-1: sdd1 c-2: dm-11 pp-1: sdd1 c-3: dm-13
441                  pp-1: sde1 c-4: dm-15 pp-1: sde1
442
443              It is easier to follow the flow of components and devices  using
444              -y1. In this example, there is one primary component (c-1), md1,
445              which is made up of two components (cc-1,2),  dm-26  and  dm-27.
446              These are respectively made from physical devices (p-1) sdj2 and
447              sdk2.
448
449              Device-10: mybackup
450                maj-min: 254:28
451                type: LUKS
452                dm: dm-28
453                size: 6.36 GiB
454                Components:
455                  c-1: md1
456                  maj-min: 9:1
457                  size: 6.37 GiB
458                  cc-1: dm-26
459                    maj-min: 254:26
460                    mapped: vg5-level1a
461                    size: 12.28 GiB
462                    ppp-1: sdj2
463                      maj-min: 8:146
464                      size: 12.79 GiB
465                  cc-2: dm-27
466                    maj-min: 254:27
467                    mapped: vg5-level1b
468                    size: 6.38 GiB
469                    ppp-1: sdk2
470                      maj-min: 8:162
471                      size: 12.79 GiB
472
473              Other types of logical block handling like LUKS, bcache show as:
474
475              Device-[xx] [name/id] type: [LUKS|Crypto|bcache]:
476
477
478       -m , --memory
479              Memory (RAM) data. Does not display with -b or -F unless you use
480              -m  explicitly.  Ordered  by system board physical system memory
481              array(s) (Array-[number]), and individual  memory  devices  (De‐
482              vice-[number]).   Physical  memory array data shows array capac‐
483              ity, number of devices supported, and Error Correction  informa‐
484              tion.  Devices  shows  locator data (highly variable in syntax),
485              type (eg: type: DDR3)size, speed.
486
487              Note: -m uses dmidecode, which must be run  as  root  (or  start
488              inxi  with  doas/sudo),  unless  you  figure  out  how to set up
489              doas/sudo to permit dmidecode to read /dev/mem  as  user.  speed
490              and  bus-width  will not show if No Module Installed is found in
491              size.
492
493              Note: If -m is triggered RAM total/used report  will  appear  in
494              this section, not in -I or -tm items.
495
496              Because dmidecode data is extremely unreliable, inxi will try to
497              make best guesses. If you see (check) after the capacity number,
498              you  should  check it with the specifications. (est) is slightly
499              more reliable, but you should still check  the  real  specifica‐
500              tions before buying RAM. Unfortunately there is nothing inxi can
501              do to get truly reliable data about the system  RAM;  maybe  one
502              day  the  kernel  devs will put this data into /sys, and make it
503              real data, taken from the actual system, not dmi data. For  most
504              people,  the data will be right, but a significant percentage of
505              users will have either a wrong max module size, if  present,  or
506              max capacity.
507
508              Under  dmidecode,  Speed:  is  the  expected speed of the memory
509              (what is advertised on the memory  spec  sheet)  and  Configured
510              Clock Speed: is what the actual speed is now. To handle this, if
511              speed and configured speed values are different,  you  will  see
512              this instead:
513
514              speed: spec: [specified speed] MT/S actual: [actual] MT/S
515
516              Also,  if  DDR, and speed in MHz, will change to: speed: [speed]
517              MT/S ([speed] MHz)
518
519              If the detected speed is logically absurd, like 1 MT/s or  69910
520              MT/s, adds: note: check. Sample:
521
522              Memory:
523                RAM: total: 31.38 GiB used: 20.65 GiB (65.8%)
524                Array-1: capacity: N/A slots: 4 note: check EC: N/A
525                Device-1: DIMM_A1 type: DDR3 size: 8 GiB speed: 1600 MT/s (800 MHz)
526                Device-2: DIMM_A2 type: DDR3 size: 8 GiB speed: spec: 1600 MT/s (800 MHz)
527                  actual: 61910 MT/s (30955 MHz) note: check
528                Device-3: DIMM_B1 type: DDR3 size: 8 GiB speed: 1600 MT/s (800 MHz)
529                Device-4: DIMM_B2 type: DDR3 size: 8 GiB speed: spec: 1600 MT/s (800 MHz)
530                  actual: 2 MT/s (1 MHz) note: check
531
532              See  --memory-modules  and  --memory-short if you want a shorter
533              report.
534
535
536       --memory-modules, --mm
537              Memory (RAM) data. Show only RAM arrays and  modules  in  Memory
538              report.  Skip empty slots. See -m.
539
540
541       --memory-short, --ms
542              Memory (RAM) data. Show a one line RAM report in Memory. See -m.
543
544              Sample: Report: arrays: 1 slots: 4 modules: 2 type: DDR4
545
546
547       -M , --machine
548              Show  machine  data.  Device, Motherboard, BIOS, and if present,
549              System Builder (Like Lenovo). Older systems/kernels without  the
550              required  /sys  data  can use dmidecode instead, run as root. If
551              using dmidecode, may also show BIOS/UEFI  revision  as  well  as
552              version.  --dmidecode  forces  use  of dmidecode data instead of
553              /sys. Will also attempt to show if  the  system  was  booted  by
554              BIOS,  UEFI, or UEFI [Legacy], the latter being legacy BIOS boot
555              mode in a system board using UEFI.
556
557              Device information requires either /sys or dmidecode. Note  that
558              other-vm?  is  a  type  that  means  it's usually a VM, but inxi
559              failed to detect which type, or positively confirm which  VM  it
560              is.  Primary  VM  identification  is via systemd-detect-virt but
561              fallback tests that should also support some BSDs are used. Less
562              commonly  used  or harder to detect VMs may not be correctly de‐
563              tected. If you get an incorrect output, post an issue and  we'll
564              get it fixed if possible.
565
566              Due  to  unreliable vendor data, device type will show: desktop,
567              laptop, notebook, server, blade, plus some  obscure  stuff  that
568              inxi is unlikely to ever run on.
569
570
571       -n , --network-advanced
572              Show  Advanced  Network  device  information in addition to that
573              produced by -N. Shows interface, speed, MAC ID, state, etc.
574
575
576       -N , --network
577              Show Network device(s)  information,  including  device  driver.
578              With -x, shows Bus ID, Port number.
579
580
581       --nvidia, --nv
582              Deprecated. See -Ga.
583
584
585       -o , --unmounted
586              Show unmounted partition information (includes UUID and LABEL if
587              available).  Shows file system type if you have lsblk  installed
588              (Linux  only). For BSD/GNU Linux: shows file system type if file
589              is installed, and if you are  root  or  if  you  have  added  to
590              /etc/sudoers (sudo v. 1.7 or newer):
591
592              <username> ALL = NOPASSWD: /usr/bin/file (sample)
593
594              doas users: see man doas.conf for setup.
595
596              Does not show components (partitions that create the md-raid ar‐
597              ray) of md-raid arrays.
598
599              To show partition labels or UUIDs (when available and relevant),
600              use with -l or -u.
601
602
603       -p , --partitions-full
604              Show  full  Partition  information  (-P  plus all other detected
605              mounted partitions).
606
607              To show partition labels or UUIDs (when available and relevant),
608              use with -l or -u.
609
610
611       -P , --partitions
612              Show  basic  Partition information.  Shows, if detected: / /boot
613              /boot/efi /home /opt /tmp /usr /usr/home /var /var/tmp  /var/log
614              (for  android, shows /cache /data /firmware /system).  If --swap
615              is not used, shows active swap partitions (never shows  file  or
616              zram type swap). Use -p to see all mounted partitions.
617
618              To show partition labels or UUIDs (when available and relevant),
619              use with -l or -u.
620
621
622       --processes
623              See -t.
624
625
626       -r , --repos
627              Show distro repository data. Currently supported repo types:
628
629              APK (Alpine Linux + derived versions)
630
631              APT (Debian, Ubuntu + derived versions, as well as RPM based APT
632              distros like PCLinuxOS or Alt-Linux)
633
634              CARDS (NuTyX + derived versions)
635
636              EOPKG (Solus)
637
638              NIX (NixOS + other distros as alternate package manager)
639
640              PACMAN (Arch Linux, KaOS + derived versions)
641
642              PACMAN-G2 (Frugalware + derived versions)
643
644              PISI (Pardus + derived versions)
645
646              PKG (OpenBSD, FreeBSD, NetBSD + derived OS types)
647
648              PORTAGE (Gentoo, Sabayon + derived versions)
649
650              PORTS (OpenBSD, FreeBSD, NetBSD + derived OS types)
651
652              SCRATCHPKG (Venom + derived versions)
653
654              SLACKPKG (Slackware + derived versions)
655
656              TCE (TinyCore)
657
658              URPMI (Mandriva, Mageia + derived versions)
659
660              XBPS (Void)
661
662              YUM/ZYPP (Fedora, Red Hat, Suse + derived versions)
663
664              More  will  be  added  as  distro data is collected. If yours is
665              missing please show us how to get this information and we'll try
666              to add it.
667
668              See -rx, -rxx, and -ra for installed package count information.
669
670
671       -R , --raid
672              Show RAID data. Shows RAID devices, states, levels, device/array
673              size, and components. See extra data with -x / -xx.
674
675              md-raid: If device is  resyncing,  also  shows  resync  progress
676              line.
677
678              Note:  supported  types:  lvm  raid, md-raid, softraid, ZFS, and
679              hardware RAID.  Other software RAID types may be added,  if  the
680              software RAID can be made to give the required output.
681
682              The  component  ID numbers work like this: mdraid: the numerator
683              is the actual mdraid component number; lvm/softraid/ZFS: the nu‐
684              merator is auto-incremented counter only. Eg. Online: 1: sdb1
685
686              If  hardware  RAID  is detected, shows basic information. Due to
687              complexity of adding hardware RAID device disk /  RAID  reports,
688              those  will only be added if there is demand, and reasonable re‐
689              porting tools.
690
691
692       --recommends
693              Checks inxi application dependencies and recommends, as well  as
694              directories,  then  shows what package(s) you need to install to
695              add support for each feature.
696
697
698       -s , --sensors
699              Show output from sensors if sensors installed/configured:  Moth‐
700              erboard/CPU/GPU  temperatures; detected fan speeds. GPU tempera‐
701              ture when available. Nvidia shows  screen  number  for  multiple
702              screens. IPMI sensors are also used (root required) if present.
703
704              See  Advanced  options --sensors-use or --sensors-exclude if you
705              want to use only a subset of all sensors, or exclude  one  (cur‐
706              rently only for lm-sensors and /sys sourced data).
707
708              For   current   Linux,   will   fallback   gracefully  to  using
709              /sys/class/hwmon as sensor data source if lm-sensors is not  in‐
710              stalled.  You  can  compare the two by using --force sensors-sys
711              option with -s.
712
713       --slots
714              Show PCI slots with type, speed, and status information.
715
716
717       --swap
718              See -j
719
720
721       -S , --system
722              Show System information: host name, kernel, desktop  environment
723              (if in X), distro. With -xx show dm - or startx - (only shows if
724              present and running if out of X), and if in X,  with  -xxx  show
725              more desktop info, e.g. taskbar or panel.
726
727
728       -t , --processes
729              [c|m|cm|mc  NUMBER] Show processes. If no arguments, defaults to
730              cm. If followed by a number, shows that number of processes  for
731              each type (default: 5; if in IRC, max: 5)
732
733              Make  sure  that  there  is no space between letters and numbers
734              (e.g. write as -t cm10).
735
736
737       -t c   - CPU only. With -x, also shows memory for that process on  same
738              line.
739
740
741       -t m   -  memory only. With -x, also shows CPU for that process on same
742              line.  If the -I or -m lines are not triggered, will  also  show
743              the system RAM used/total information.
744
745
746       -t cm  - CPU+memory. With -x, shows also CPU or memory for that process
747              on same line.
748
749
750       -u , --uuid
751              Show partition UUIDs. Use with -j, -o, -p, and -P to show parti‐
752              tion labels. Does nothing without one of those options.
753
754              Sample: -opju.
755
756
757       -U , --update
758              Note - Maintainer may have disabled this function.
759
760              If inxi -h has no listing for -U then it's disabled.
761
762              Auto-update  script. Note: if you installed as root, you must be
763              root to update, otherwise user is fine. Also installs /  updates
764              this   man   page  to:  /usr/local/share/man/man1  (if  /usr/lo‐
765              cal/share/man/  exists  AND  there  is  no  inxi  man  page   in
766              /usr/share/man/man1,  otherwise it goes to /usr/share/man/man1).
767              This requires that you be root to write to that  directory.  See
768              --man or --no-man to force or disable man install.
769
770
771       --usb
772              See -J.
773
774
775       -V, --version
776              inxi  full  version  and license information. Prints information
777              then exits.
778
779
780       --version-short, --vs
781              inxi single line version information. Prints information if  not
782              short form (which shows version info already). Does not exit un‐
783              less used without any other options. Can  be  used  with  normal
784              line options.
785
786
787       -v , --verbosity
788              Script  verbosity levels. If no verbosity level number is given,
789              0 is assumed.  Should not be used with -b or -F.
790
791              Supported levels: 0-8 Examples : inxi -v 4  or  inxi -v4
792
793
794       -v 0   - Short output, same as: inxi
795
796
797       -v 1   - Basic verbose, -S + basic  CPU  (cores,  type,  average  clock
798              speed, and min/max speeds, if available) + -G + basic Disk + -I.
799
800
801       -v 2   -  Adds  networking device (-N), Machine (-M) data, Battery (-B)
802              (if available). Same as: inxi -b
803
804
805       -v 3   - Adds advanced CPU (-C) and network (-n) data; triggers -x  ad‐
806              vanced data option.
807
808
809       -v 4   -  Adds  partition size/used data (-P) for (if present): / /home
810              /var/ /boot. Shows full disk data (-D)
811
812
813       -v 5   - Adds audio device (-A), memory/RAM (-m), bluetooth  data  (-E)
814              (if  present),  sensors  (-s), RAID data (if present), partition
815              label (-l), UUID (-u), full swap data (-j), and  short  form  of
816              optical drives.
817
818
819       -v 6   -  Adds  full  mounted  partition data (-p), unmounted partition
820              data (-o), optical drive data (-d), USB (-J); triggers -xx extra
821              data option.
822
823
824       -v 7   -  Adds  network  IP  data  (-i), forced bluetooth (-E), Logical
825              (-L), RAID (-R), full CPU flags/features (-f),  triggers -xxx
826
827
828       -v 8   - All system data available. Adds advanced EDID  data  (--edid),
829              Repos  (-r), PCI slots (--slots), processes (-tcm), admin (--ad‐
830              min). Useful for testing output and to see what data you can get
831              from your system.
832
833
834       -w , --weather
835              Adds weather line. To get weather for an alternate location, use
836              -W [location]. See also -x, -xx, -xxx options. Please note  that
837              your  distribution's  maintainer  may chose to disable this fea‐
838              ture.
839
840              DO NOT USE THIS FEATURE FOR AUTOMATED WEATHER UPDATES! Automated
841              or  excessive  use will lead to your being blocked from any fur‐
842              ther access. This feature is not meant for widget  type  weather
843              monitoring,  or  Conky type use. It is meant to get weather when
844              you need to see it, for example, on a remote server. If you  did
845              not  type  the weather option in manually, it's an automated re‐
846              quest.
847
848
849       -W, --weather-location <location_string>
850              Get weather/time for an alternate location.  Accepts  postal/zip
851              code[,  country],  city,state pair, or latitude,longitude. Note:
852              city/country/state names must not contain spaces. Replace spaces
853              with '+' sign. Don't place spaces around any commas. Postal code
854              is not reliable except for North America and maybe the  UK.  Try
855              postal  codes  with  and  without  country code added. Note that
856              City,State applies only to USA, otherwise it's City,Country.  If
857              country  name  (english)  does not work, try 2 character country
858              code (e.g. Spain: es; Great Britain: gb).
859
860              See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 for current
861              2 letter country codes.
862
863              Use only ASCII letters in city/state/country names.
864
865              Examples: -W 95623,us OR -W Boston,MA OR -W 45.5234,-122.6762 OR
866              -W new+york,ny OR -W bodo,norway.
867
868              DO NOT USE THIS FEATURE FOR AUTOMATED WEATHER UPDATES! Automated
869              or  excessive  use will lead to your being blocked from any fur‐
870              ther access. This feature is not meant for widget  type  weather
871              monitoring,  or  Conky type use. It is meant to get weather when
872              you need to see it, for example, on a remote server. If you  did
873              not  type  the weather option in manually, it's an automated re‐
874              quest.
875
876
877       --weather-source, --ws <unit>
878              [1-9] Switches weather data source.  Possible  values  are  1-9.
879              1-4  will generally be active, and 5-9 may or may not be active,
880              so check. 1 may not support city /  country  names  with  spaces
881              (even  if  you use the + sign instead of space). 2 offers pretty
882              good data, but may not have all small city names for -W.
883
884              Please note that the data sources are not static per value,  and
885              can  change  any  time,  or be removed, so always test to verify
886              which source is being used for each value if that  is  important
887              to  you.  Data  sources may be added or removed on occasions, so
888              try each one and see which you prefer. If  you  get  unsupported
889              source message, it means that number has not been implemented.
890
891
892       --weather-unit <unit>
893              [m|i|mi|im] Sets weather units to metric (m), imperial (i), met‐
894              ric (imperial) (mi, default), imperial (metric) (im). If  metric
895              or imperial not found,sets to default value, or N/A.
896
897

FILTER OPTIONS

899       The  following options allow for applying various types of filtering to
900       the output.
901
902
903       --filter , --filter-override
904              See -z, -Z.
905
906
907       --filter-label, --filter-uuid, --filter-vulnerabilities
908              See --zl, --zu, --zv.
909
910
911       --host Turns on hostname in System line.  Overrides  inxi  config  file
912              value (if set):
913
914              SHOW_HOST='false' - Same as: SHOW_HOST='true'
915
916              This  is an absolute override, the host will always show no mat‐
917              ter what other switches you use.
918
919
920       --no-host
921              Turns off hostname in System line. This is  default  when  using
922              -z,  for  anonymizing  inxi output for posting on forums or IRC.
923              Overrides configuration value (if set):
924
925              SHOW_HOST='true' - Same as: SHOW_HOST='false'
926
927              This is an absolute override, the host will not show  no  matter
928              what other switches you use.
929
930
931       -z, --filter
932              Adds security filters for IP addresses, serial numbers, MAC, lo‐
933              cation (-w), and user home directory name. Removes Host:. On  by
934              default for IRC clients.
935
936
937       --za, --filter-all
938              Shortcut  to trigger -z, --zl, --zu, --zv. All the filters, that
939              is.
940
941
942       --zl, --filter-label
943              Filter partition label names  from  -j,  -o,  -p,  -P,  and  -Sa
944              (root=LABEL=...).  Generally  only  useful  in  very specialized
945              cases.
946
947
948       --zu, --filter-uuid
949              Filter  partition  UUIDs  from  -j,  -o,   -p,   -P,   and   -Sa
950              (root=UUID=...).  Generally  only  useful  in  very  specialized
951              cases.
952
953
954       --zv, --filter-v, --filter-vulnerabilities
955              Filter Vulnerabilities report from -Ca. Generally only useful in
956              very specialized cases.
957
958
959       -Z , --filter-override , --no-filter
960              Absolute  override for output filters. Useful for debugging net‐
961              working issues in IRC for example.
962
963

OUTPUT CONTROL OPTIONS

965       The following options allow for modifying the output in various ways.
966
967
968       -c , --color [0-42]
969              Set color scheme. If no scheme number is supplied, 0 is assumed.
970
971
972       -c [94-99]
973              These color selectors run a color selector option prior to  inxi
974              starting which lets you set the config file value for the selec‐
975              tion.
976
977              NOTE: All configuration file set color values are  removed  when
978              output is piped or redirected. You must use the explicit runtime
979              -c <color number> option if you want color codes to  be  present
980              in the piped/redirected output.
981
982              Color selectors for each type display (NOTE: IRC and global only
983              show safe color set):
984
985
986       -c 94  - Console, out of X.
987
988
989       -c 95  - Terminal, running in X - like xTerm.
990
991
992       -c 96  - GUI IRC, running in X - like XChat, Quassel, Konversation etc.
993
994
995       -c 97  - Console IRC running in X - like irssi in xTerm.
996
997
998       -c 98  - Console IRC not in X.
999
1000
1001       -c 99  - Global - Overrides/removes all settings.
1002
1003              Setting a specific color type removes the  global  color  selec‐
1004              tion.
1005
1006
1007       --indent [11-xx]
1008              Change  primary  wide  indent width. Generally useless. Only ap‐
1009              plied if output width  is  greater  than  max  wrap  width  (see
1010              --max-wrap). Use configuration item INDENT to make permanent.
1011
1012
1013       --indents [0-10]
1014              Change  primary  wrap mode, second, and -y1 level indents. First
1015              indent level only applied if output width is less than max  wrap
1016              width  (see  --max-wrap). 0 disables all wrapped indents and all
1017              second level indents. Use configuration  item  INDENTS  to  make
1018              permanent.
1019
1020
1021       --limit [-1 - x]
1022              Raise  or  lower max output limit of IP addresses for -i. -1 re‐
1023              moves limit.
1024
1025
1026       --max-wrap, --wrap-max [integer]
1027              Overrides default or configuration set line starter  wrap  width
1028              value.  Wrap  max  is the maximum width that inxi will wrap line
1029              starters (e.g. Info:) to their own lines, with  data  lines  in‐
1030              dented default 2 columns (use --indents to change).
1031
1032              If  terminal/console  width  or --width is less than wrap width,
1033              wrapping of line starter occurs. If 80 or less, no wrapping will
1034              occur.  Overrides internal default value (110) and user configu‐
1035              ration value MAX_WRAP.
1036
1037
1038       --output [json|screen|xml]
1039              Change data output type. Requires --output-file if not screen.
1040
1041
1042       --output-file [full path to output file|print]
1043              The given directory path must exist. The  directory  path  given
1044              must  exist,  The  print options prints to stdout.  Required for
1045              non-screen --output formats (json|xml).
1046
1047
1048       --partition-sort [dev-base|fs|id|label|percent-used|size|uuid|used]
1049              Change default sort order of partition  output.  Corresponds  to
1050              PARTITION_SORT  configuration item. These are the available sort
1051              options:
1052
1053              dev-base - /dev partition identifier, like /dev/sda1.  Note that
1054              it's an alphabetic sort, so sda12 is before sda2.
1055
1056              fs - Partition filesystem. Note that sorts will be somewhat ran‐
1057              dom if all filesystems are the same.
1058
1059              id - Mount point of partition (default).
1060
1061              label - Label of partition. If partitions have no  labels,  sort
1062              will be random.
1063
1064              percent-used - Percentage of partition size used.
1065
1066              size - KiB size of partition.
1067
1068              uuid - UUID of the partition.
1069
1070              used - KiB used of partition.
1071
1072
1073       --wrap-max [integer]
1074              See --max-wrap.
1075
1076
1077       -y, --width [integer]
1078              This  is  an  absolute width override which sets the output line
1079              width   max.    Overrides   COLS_MAX_IRC,   COLS_MAX_NO_DISPLAY,
1080              COLS_MAX_CONSOLE  configuration  items,  or the actual widths of
1081              the terminal.
1082
1083              * -y - sets default width of 80 columns.
1084              * -y [60-xxx] - sets width to given number. Must be 60 or more.
1085              * -y 1 -  switches to a single indented key/value pair per line,
1086              and  removes  all  long line wrapping (similar to dmidecode out‐
1087              put). Not recommended for use with -Y;
1088              * -y -1 - removes width limits  (if  assigned  by  configuration
1089              items).
1090
1091              Examples:
1092              inxi -Fxx -y 130
1093              inxi -Fxxy
1094              inxi -bay1
1095
1096
1097       -Y, --height, --less [-3-[integer]
1098              Control  output  height.  Useful when in console, and scrollback
1099              not available.  Breaks output flow based on values provided.
1100
1101              * -Y 0 or -Y - Set default max height to terminal height.
1102              * -Y [1-xxx] - set max output block height height in lines.
1103              * -Y -1 - Print out one primary data item block (like CPU:, Sys‐
1104              tem:)  at  a  time.  Useful for very long outputs like -Fa, -v8,
1105              etc. Not available for -h.
1106              * -Y -2 - Do not disable output colors when redirected or  piped
1107              to another program. Useful if piping output to less -R for exam‐
1108              ple. This does not limit the height otherwise since the expecta‐
1109              tion  it  is being piped to another program like less which will
1110              handle that.
1111              * -Y -3 - Restore default unlimited output  lines  if  LINES_MAX
1112              configuration item set.
1113
1114              Recommended  to  use  the  following  for very clean up and down
1115              scrollable output out of  display,  while  retaining  the  color
1116              schemes, which are normally removed with piping or redirect:
1117
1118              pinxi -v8Y -2 | less -R
1119
1120              Note:  since  it's not possible for inxi to know how many actual
1121              terminal lines are being used by terminal wrapped  output,  with
1122              -y 1 , it may be better in general to use a fixed height like:
1123
1124              -y 1 -Y 20 instead of: -y 1 -Y
1125
1126

EXTRA DATA OPTIONS

1128       These  options  can be triggered by one or more -x.  Alternatively, the
1129       -v options trigger them in the following way: -v 3 adds -x; -v  6  adds
1130       -xx; -v 7 adds -xxx
1131
1132       These  extra data triggers can be useful for getting more in-depth data
1133       on various options. They can be added to any  long  form  option  list,
1134       e.g.: -bxx or -Sxxx
1135
1136       There are 3 extra data levels:
1137       -x, -xx, -xxx
1138       OR
1139       --extra 1, --extra 2, --extra 3
1140
1141       The  following  details show which lines / items display extra informa‐
1142       tion for each extra data level.
1143
1144
1145       -x -A  - Adds (if available and/or relevant) vendor: item, which  shows
1146              specific vendor [product] information.
1147
1148              -  Adds  version/port(s)/driver  version (if available) for each
1149              device.
1150
1151              - Adds PCI/USB ID of each device.
1152
1153              - Adds non-running sound servers, if detected.
1154
1155
1156       -x -B  - Adds vendor/model, battery status (if battery present).
1157
1158              - Adds attached battery powered  peripherals  (Device-[number]:)
1159              if detected (keyboard, mouse, etc.).
1160
1161              - Adds battery volts:, min: voltages. Note that if difference is
1162              critical, that is current voltage is too close to minimum  volt‐
1163              age, shows without -x.
1164
1165
1166       -x -C  - Adds bogomips to CPU speed report (if available).
1167
1168              -  Adds L1: and L3: cache types if either are present/available.
1169              For BSD or legacy Linux, uses dmidecode + doas/sudo/root.  Force
1170              use  of  dmidecode cache values by adding --dmidecode. This will
1171              override /sys based cache data, which tends to be better, so  in
1172              general don't do that.
1173
1174              - Adds boost: [enabled|disabled] if detected, aka turbo. Not all
1175              CPUs have this feature.
1176
1177              - Adds CPU Flags (short list). Use -f to see  full  flag/feature
1178              list.
1179
1180              -  Adds CPU microarchitecture + revision (e.g. Sandy Bridge, K8,
1181              ARMv8, P6, etc.). Only shows data if detected. Newer microarchi‐
1182              tectures  will  have to be added as they appear, and require the
1183              CPU family ID, model ID, and stepping.
1184
1185              - Adds, if smt (Simultaneous MultiThreading)  is  available  but
1186              disabled,  after  type:  data smt: disabled. type: MT means it's
1187              enabled. See -Cxxx.
1188
1189              Examples:
1190              arch: Sandy Bridge rev: 2
1191              arch: K8 rev.F+ rev: 2
1192
1193              If unable to non-ambiguosly determine  architecture,  will  show
1194              something like: arch: Amber Lake note: check rev: 9
1195
1196              -  Adds  CPU  highest  speed after avg: [speed] high: [speed] if
1197              greater than 1 core and cores have different speeds. Linux only.
1198
1199
1200       -x -d  - Adds more items to Features line of  optical  drive;  dds  rev
1201              version to optical drive.
1202
1203
1204       -x -D  - Adds drive temperature with disk data.
1205
1206              Method  1:  Systems  running Linux kernels ~5.6 and newer should
1207              have drivetemp module data available. If so,  drive  temps  will
1208              come from /sys data for each drive, and will not require root or
1209              hddtemp. This method is MUCH faster  than  using  hddtemp.  Note
1210              that NVMe drives do not require drivetemp.
1211
1212              If your drivetemp module is not enabled, enable it:
1213
1214              modprobe drivetemp
1215
1216              Once   enabled,  add  drivetemp  to  /etc/modules  or  /etc/mod‐
1217              ules-load.d/***.conf so it starts automatically.
1218
1219              If you see drive temps running as regular user and you  did  not
1220              configure system to use doas/sudo hddtemp, then your system sup‐
1221              ports this feature. If no /sys data is found, inxi will  try  to
1222              use  hddtemp  methods  instead for that drive.  Hint: if temp is
1223              /sys sourced, the temp will be to 1 decimal, like 34.8,  if  hd‐
1224              dtemp sourced, they will be integers.
1225
1226              Method  2:  if you have hddtemp installed, if you are root or if
1227              you have added to /etc/sudoers (sudo v. 1.7 or newer):
1228
1229              <username> ALL = NOPASSWD: /usr/sbin/hddtemp (sample)
1230
1231              doas users: see man doas.conf for setup.
1232
1233              You can force use of hddtemp for all drives using --hddtemp.
1234
1235              - If free LVM volume group size detected (root  required),  show
1236              lvm-free:  on  Local Storage line. This is how much unused space
1237              the VGs contain, that is, space not assigned to LVs.
1238
1239
1240       -x -E (--bluetooth)
1241              - Adds (if available and/or relevant) vendor: item, which  shows
1242              specific vendor [product] information.
1243
1244              - Adds PCI/USB Bus ID of each device.
1245
1246              - Adds driver version (if available) for each device.
1247
1248              -  Adds  (if  available,  and hciconfig only) LMP (HCI if no LMP
1249              data, and HCI if HCI/LMP versions  are  different)  version  (if
1250              available) for each HCI ID.
1251
1252
1253       -x -G  -  Adds  GPU  micro-architecture  (if  AMD/Intel/Nvidia  and de‐
1254              tected).
1255
1256              - Adds PCI/USB ID of each device.
1257
1258              - Adds (if available and/or relevant) vendor: item, which  shows
1259              specific vendor [product] information.
1260
1261              - X.org: Adds direct rendering status.
1262
1263              - X.org: Adds (for single GPU, nvidia driver) screen number that
1264              GPU is running on.
1265
1266              - Adds device temperature for each discrete device (Linux only).
1267
1268
1269       -x -i  - Adds IP v6 additional scope data, like Global, Site, Temporary
1270              for each interface.
1271
1272              Note that there is no way we are aware of to filter out the dep‐
1273              recated IP v6 scope site/global  temporary  addresses  from  the
1274              output of ifconfig. The ip tool shows that clearly.
1275
1276              ip-v6-temporary - (ip tool only), scope global temporary.  Scope
1277              global temporary deprecated is not shown
1278
1279              ip-v6-global - scope global (ifconfig will  show  this  for  all
1280              types,  global,  global  temporary,  and global temporary depre‐
1281              cated, ip shows it only for global)
1282
1283              ip-v6-link - scope link (ip/ifconfig) - default for -i.
1284
1285              ip-v6-site - scope site (ip/ifconfig). This has been  deprecated
1286              in  IPv6, but still exists. ifconfig may show multiple site val‐
1287              ues, as with global temporary, and global temporary deprecated.
1288
1289              ip-v6-unknown - unknown scope
1290
1291
1292       -x -I  - Adds current init system (and init  rc  in  some  cases,  like
1293              OpenRC).  With -xx, shows init/rc version number, if available.
1294
1295              -  Adds  default system gcc. With -xx, also show other installed
1296              gcc versions.
1297
1298              - Adds current runlevel/target (not available with all init sys‐
1299              tems).
1300
1301              -  Adds  total packages discovered in system. See -xx and -a for
1302              per package manager types output. Moves to Repos if -rx.
1303
1304              If your package manager is not supported, please file  an  issue
1305              and we'll add it.  That requires the full output of the query or
1306              method to discover all installed packages  on  your  system,  as
1307              well of course as the command or method used to discover those.
1308
1309              -  If in shell (i.e. not in IRC client), adds shell version num‐
1310              ber, if available.
1311
1312
1313       -x -j, -x --swap
1314              Add mapper:. See -x -o.
1315
1316
1317       -x -J (--usb)
1318              - For Devices, adds driver(s).
1319
1320
1321       -x -L, -x --logical
1322              - Adds dm: dm-x to VG > LV and other Device types. This can help
1323              tracking down which device belongs to what.
1324
1325
1326       -x -m, --memory-modules
1327              -  If present, adds maximum memory module/device size in the Ar‐
1328              ray line.  Only some systems  will  have  this  data  available.
1329              Shows estimate if it can generate one.
1330
1331
1332       -x -N  -  Adds (if available and/or relevant) vendor: item, which shows
1333              specific vendor [product] information.
1334
1335              - Adds version/port(s)/driver version (if  available)  for  each
1336              device;
1337
1338              - Adds PCI/USB ID of each device.
1339
1340              - Adds device temperature for each discrete device (Linux only).
1341
1342
1343       -x -o, -x -p, -x -P
1344              -  Adds mapper: (the /dev/mapper/ partition ID) if mapped parti‐
1345              tion.
1346
1347              Example: ID-4: /home ... dev: /dev/dm-6 mapped: ar0-home
1348
1349
1350       -x -r  - Adds Package info. See -Ix
1351
1352
1353       -x -R  - md-raid: Adds second RAID Info line with extra  data:  blocks,
1354              chunk  size,  bitmap  (if  present).  Resync  line, shows blocks
1355              synced/total blocks.
1356
1357              - Hardware RAID: Adds driver version, Bus ID.
1358
1359
1360       -x -s  - Adds basic voltages: 12v, 5v, 3.3v, vbat (ipmi,  lm-sensors  /
1361              /sys/class/hwmon if present).
1362
1363
1364       -x -S  - Adds Kernel gcc version.
1365
1366              -  Adds  to  Distro: base: if detected. System base will only be
1367              seen on a subset of distributions. The distro must be  both  de‐
1368              rived  from a parent distro (e.g. Mint from Ubuntu), and explic‐
1369              itly added to the supported distributions for this feature.  Due
1370              to  the  complexity  of  distribution identification, these will
1371              only be added as relatively solid methods  are  found  for  each
1372              distribution system base detection.
1373
1374
1375       -x --slots
1376              - Adds slot bus-ID:, if found.
1377
1378
1379       -x -t (--processes)
1380              -  Adds  memory use output to CPU (-xt c), and CPU use to memory
1381              (-xt m).
1382
1383
1384       -x -w , -W
1385              - Adds humidity and barometric pressure.
1386
1387              - Adds wind speed and direction.
1388
1389
1390       -xx -A - Adds vendor:product ID for each device.
1391
1392              - Adds PCIe speed and lanes item (Linux only, if detected).
1393
1394
1395       -xx -B - Adds serial number.
1396
1397
1398       -xx -D - Adds disk serial number.
1399
1400              - Adds disk speed (if available). This is  the  theoretical  top
1401              speed of the device as reported. This speed may be restricted by
1402              system board limits, eg. a SATA 3 drive on a SATA  2  board  may
1403              report  SATA  2  speeds,  but this is not completely consistent,
1404              sometimes a SATA 3 device on a SATA 2 board reports  its  design
1405              speed.
1406
1407              NVMe drives: adds lanes, and (per direction) speed is calculated
1408              with lane speed * lanes * PCIe overhead. PCIe 1 and 2 have  data
1409              rates  of  GT/s * .8 = Gb/s (10 bits required to transfer 8 bits
1410              of data).  PCIe 3 and greater transfer data at a rate of GT/s  *
1411              128/130  *  lanes = Gb/s (130 bits required to transfer 128 bits
1412              of data).
1413
1414              For a PCIe 3 NVMe drive, with speed of 8 GT/s and 4 lanes (8GT/s
1415              * 128/130 * 4 = 31.6 Gb/s):
1416
1417              speed: 31.6 Gb/s lanes: 4
1418
1419              - Adds disk duid, if available. Some BSDs have it.
1420
1421
1422       -xx -E (--bluetooth)
1423              - Adds vendor:product ID of each device.
1424
1425              -  Adds  (hciconfig only) LMP subversion (and/or HCI revision if
1426              applicable) for each device.
1427
1428              - Adds PCIe speed and lanes item (Linux only, and if PCIe  blue‐
1429              tooth, which is rare).
1430
1431
1432       -xx -G Triggers much more complete Screen/Monitor output.
1433
1434              X.org: requires xdpyinfo or xrandr, and the advanced per monitor
1435              feature requires xrandr.
1436
1437              Wayland: requires any tool capable of showing monitor and  reso‐
1438              lution  information.  Sway  has  swaymsg,  weston-info  or  way‐
1439              land-info can show Wayland information on any  Wayland  composi‐
1440              tor,  and wlr-randr can show Wayland information for any wlroots
1441              based compositor.
1442
1443              Further note that all references to Displays, Screens, and Moni‐
1444              tors are referring to the X or Wayland technical terms, not nor‐
1445              mal consumer usage.
1446
1447              X.org: 1 Display runs 1 or more Screens, and 1 Screen runs 1  or
1448              more Monitors.
1449
1450              Wayland:  The  Display is the primary container, and it can con‐
1451              tain 1 or more Monitors.
1452
1453              - Adds vendor:product ID of each device.
1454
1455              - Adds PCIe speed and lanes item (Linux only, and if PCIe device
1456              and detected).
1457
1458              -  Adds  output  port  IDs, active, off (connected but disabled,
1459              like a closed laptop lid) and empty. Example:
1460
1461              ports: active: DVI-I-1,VGA-1 empty: HDMI-A-1
1462
1463              - Adds Display ID. X.org: the Display running  the  Screen  that
1464              runs the Monitors; Wayland: the Display that runs the monitors.
1465
1466              - Adds compositor, if found (always shows for Wayland).
1467
1468              -  Wayland: Adds to  Display d-rect: if > 1 monitors in Display.
1469              This is the size of the rectangle Wayland creates to situate the
1470              monitors in.
1471
1472              - X.org: If available, shows alternate: Xorg drivers. This means
1473              a driver on the  default  list  of  drivers  Xorg  automatically
1474              checks  for the device, but which is not installed. For example,
1475              if you have nouveau driver, nvidia would show as alternate if it
1476              was not installed. Note that alternate: does NOT mean you should
1477              have it, it's just one of the drivers Xorg checks to see  if  is
1478              present  and  loaded  when checking the device. This can let you
1479              know there are other driver options. Note that if you  have  ex‐
1480              plicitly  set the driver in xorg.conf, Xorg will not create this
1481              automatic check driver list.
1482
1483              - Xorg: Adds total number of Screens listed for the current Dis‐
1484              play.
1485
1486              - Xorg: Adds default Screen ID if Screen (not monitor!) total is
1487              greater than 1.
1488
1489              - X.org: Adds Screen line, which includes  the  ID  (Screen:  0)
1490              then s-res (Screen resolution), s-dpi. Remember, this is an Xorg
1491              Screen, NOT a monitor screen,  and  the  information  listed  is
1492              about  the  Xorg Screen! It may at times be the same as a single
1493              monitor system, but usually it's different in  some  ways.  Note
1494              that the physical monitor dpi and the Xorg dpi are not necessar‐
1495              ily the same thing, and can vary widely.
1496
1497              - Adds Monitor lines. Monitors are a subset of a Screen  (X.org)
1498              or  Display  (Wayland), each of which can have one or more moni‐
1499              tors. Normally a dual monitor setup is 2  monitors  run  by  one
1500              Xorg Screen/Wayland Display.
1501
1502              -  pos:  [primary,]{position  string|row-col}  (X.org:  requires
1503              xrandr; Wayland: requires  swaymsg  [sway],  wlr-randr  [wlroots
1504              based  compositors], weston-info / wayland-info [all]). Uses ei‐
1505              ther explicit primary value or +0+0 position if no primary moni‐
1506              tor value set.  pos: does not show for single monitor setups, or
1507              if no position data was found.
1508
1509              Position is text (left, center, center-l, center-r, right,  top,
1510              top-left,  top-center,  top-right,  middle,  middle-c, middle-r,
1511              bottom, bottom-l, bottom-c, bottom-r) if monitors fit within the
1512              following grids: 1x2, 1x3, 1x4, 2x1, 2x2, 2x3, 3x1, 3x2, 3x3. If
1513              layout not supported in text, uses [row-nu]-[column-nu]  instead
1514              to indicate the monitor's position in its grid.
1515
1516              The  position  is based on the upper left corner of each monitor
1517              relative to the grid of monitors that the Xorg  Screen  is  com‐
1518              posed of.
1519
1520              -  diag:  monitor screen diagonal in mm (inches). Note that this
1521              is the real monitor size, not  the  Xorg  full  Screen  diagonal
1522              size, which can be quite different.
1523
1524              -  For free drivers, adds OpenGL compatibility version number if
1525              available. For nonfree drivers, the core version and compatibil‐
1526              ity versions are usually the same. Example:
1527
1528              v: 3.3 Mesa 11.2.0 compat-v: 3.0
1529
1530
1531       -xx -I - Adds init type version number (and rc if present).
1532
1533              - Adds other detected installed gcc versions (if present).
1534
1535              -  Adds  system  default  runlevel/target, if detected. Supports
1536              Systemd / Upstart /SysVinit type defaults.
1537
1538              - Shows Packages: counts by  discovered  package  manager  types
1539              (pm:).   In cases where only 1 pm had results, does not show to‐
1540              tal after Packages:.  Does not show installed  package  managers
1541              with 0 packages. See -a for full output. Moves to Repos if -rxx.
1542
1543              -  Adds  parent  program (or pty/tty) that started shell, if not
1544              IRC client.
1545
1546
1547       -xx -j (--swap), -xx -p, -xx -P
1548              - Adds swap priority to each swap partition (for -P)  used,  and
1549              for all swap types (for -j).
1550
1551
1552       -xx -J (--usb)
1553              - Adds vendor:chip id.
1554
1555
1556       -xx -L, -xx --logical
1557              -  Adds  internal  LVM Logical volumes, like raid image and meta
1558              data volumes.
1559
1560              - Adds full list of Components, sub-components, and their physi‐
1561              cal devices.
1562
1563              -  For LVM RAID, adds a RAID report line (if not -R). Read up on
1564              LVM documentation to better understand their  use  of  the  term
1565              'stripes'.
1566
1567
1568       -xx -m, --memory-modules
1569              - Adds memory device Manufacturer.
1570
1571              - Adds memory device Part Number (part-no:). Useful for ordering
1572              new or replacement memory sticks etc. Part numbers  are  unique,
1573              particularly  if  you use the word memory in the search as well.
1574              With -xxx, also shows serial number.
1575
1576              - Adds single/double bank memory, if data is found.  Note,  this
1577              may  not  be  100% right all of the time since it depends on the
1578              order that data is found in dmidecode output for type 6 and type
1579              17.
1580
1581              -  Adds, if present, memory array voltage. Only some legacy sys‐
1582              tems will have this data available.
1583
1584              - Adds memory module current configured  operating  voltage,  if
1585              available.
1586
1587
1588       -xx -M -  Adds  chassis  information,  if data is available. Also shows
1589              BIOS ROM size if using dmidecode.
1590
1591
1592       -xx -N - Adds vendor:product ID for each device.
1593
1594              - Adds PCIe speed and lanes item (Linux only, and if PCIe device
1595              and detected).
1596
1597
1598       -xx -r - Adds to Packages: info. See -Ixx
1599
1600
1601       -xx -R -  md-raid:  Adds  superblock  (if  present)  and  algorithm. If
1602              resync, shows progress bar.
1603
1604              - Hardware RAID: Adds Chip vendor:product ID.
1605
1606
1607       -xx -s - Adds DIMM/SOC voltages, if present (ipmi only).
1608
1609
1610       -xx -S - Adds display manager (dm) type, if  present.  If  none,  shows
1611              N/A.  Supports most known display managers, including gdm, gdm3,
1612              idm, kdm, lightdm, lxdm, mdm, nodm, sddm, slim, tint,  wdm,  and
1613              xdm.
1614
1615              - Adds, if run in X, window manager type (wm), if available. Not
1616              all window managers are supported. Some desktops  support  using
1617              more  than one window manager, so this can be useful to see what
1618              window manager is actually running. If none found,  shows  noth‐
1619              ing.  Uses a less accurate fallback tool wmctrl if ps tests fail
1620              to find data.
1621
1622              - Adds desktop toolkit (tk), if available (Xfce/KDE/Trinity).
1623
1624
1625       -xx --slots
1626              - Adds slot length.
1627
1628              - Adds slot voltage, if available.
1629
1630
1631       -xx -w , -W
1632              - Adds wind chill, heat index, and dew point, if available.
1633
1634              - Adds cloud cover, rain, snow, or precipitation (amount in pre‐
1635              vious hour to observation time), if available.
1636
1637
1638       -xxx -A
1639              - Adds, if present, serial number.
1640
1641              - Adds, if present, PCI/USB class ID.
1642
1643
1644       -xxx -B
1645              -  Adds battery chemistry (e.g. Li-ion), cycles (NOTE: there ap‐
1646              pears to be a problem with the Linux kernel obtaining the  cycle
1647              count,  so  this almost always shows 0. There's nothing that can
1648              be done about this glitch, the data is simply not  available  as
1649              of  2018-04-03), location (only available from dmidecode derived
1650              output).
1651
1652              - Adds attached device rechargeable: [yes|no] information.
1653
1654
1655       -xxx -C
1656              - Adds CPU voltage and external clock speed (this is the mother‐
1657              board speed).  Requires doas/sudo/root and dmidecode.
1658
1659              -  Adds, if smt (Simultaneous MultiThreading) data is available,
1660              after type: data smt: [status].
1661              smt: [status]
1662              MT in type: will show if smt is enabled in general. 3 values are
1663              possible:  [enabled|disabled|<unsupported>]. <unsupported> means
1664              the CPU does not support SMT.
1665
1666
1667       -xxx -D
1668              - Adds disk firmware revision number (if available).
1669
1670              - Adds disk partition scheme (in most cases), e.g. scheme:  GPT.
1671              Currently  not  able to detect all schemes, but handles the most
1672              common, e.g.  GPT or MBR.
1673
1674              - Adds disk type (HDD/SSD), rotation speed (in some but not  all
1675              cases),  e.g.  type: HDD rpm: 7200, or type: SSD if positive SSD
1676              identification was made. If no HDD, rotation, or positive SSD ID
1677              found,  shows type: N/A. Not all HDD spinning disks report their
1678              speed, so even if they are spinning, no rpm data will show.
1679
1680
1681       -xxx -E (--bluetooth)
1682              - Adds, if present, PCI/USB class ID.
1683
1684              - Adds (hciconfig only) HCI version, revision.
1685
1686
1687       -xxx -G
1688              - Adds, if present, Device PCI/USB class ID.
1689
1690              - Adds to Device serial: number (if found).
1691
1692              - Xorg: Adds to Screen: s-size: and s-diag:. (Screen  size  data
1693              requires xdpyinfo). This is the X.org Screen dimensions, NOT the
1694              Monitor size!
1695
1696              - Adds to Monitors (if detected) frequency (hz:).
1697
1698              -  Adds  to  Monitors  (if  detected)  size   (size:   277x156mm
1699              (10.9x6.1")).  Note that this is the real physical monitor size,
1700              not the Xorg Screen/Wayland Display size,  which  can  be  quite
1701              different (1 Xorg Screen / Wayland Display can for instance con‐
1702              tain two or more monitors).
1703
1704              - Adds to Monitors modes: min: max: (if detected). These are the
1705              smallest  and  largest  monitor  modes  found,  using an inexact
1706              method, so might not always be right.
1707
1708              - Adds to Monitors serial: number (if detected).
1709
1710              - Wayland: Adds to Monitors scale: (if detected).
1711
1712
1713       -xxx -I
1714              - For Uptime: adds wakeups: to show how many times  the  machine
1715              has  been  woken from suspend state during current uptime period
1716              (if available, Linux only). 0 value means the  machine  has  not
1717              been suspended.
1718
1719              - For Shell: adds (su|sudo|login) to shell name if present.
1720
1721              -  For  Shell:  adds  default:  shell  if different from running
1722              shell, and default shell v:, if available.
1723
1724              - For running-in: adds (SSH) to parent, if present.  SSH  detec‐
1725              tion uses the whoami test.
1726
1727
1728       -xxx -J (--usb)
1729              - Adds, if present, serial number for non hub devices.
1730
1731              - Adds interfaces: for non hub devices.
1732
1733              - Adds, if available, USB speed in Mbits/s or Gbits/s.
1734
1735              - Adds, if present, USB class ID.
1736
1737              - Adds, if non 0, max power in mA.
1738
1739
1740       -xxx -m, --memory-modules
1741              -  Adds memory bus width: primary bus width, and if present, to‐
1742              tal width. e.g.
1743
1744              width (bits): data: 64 total: 72
1745
1746              Note that total / data widths are mixed up sometimes  in  dmide‐
1747              code  output, so inxi will take the larger value as the total if
1748              present. Data width usually corresponds to the CPU  bits.  Total
1749              can  reflect  EEC or Dual Channel widths. If no total width data
1750              is found, shows:
1751
1752              width: N/A
1753
1754              - Adds device type detail, e.g. type: DDR3 detail: Synchronous.
1755
1756              - Adds device serial number.
1757
1758              - Adds memory module current, max, and min voltages, if they are
1759              available and different from each other. If they are the identi‐
1760              cal, displays same as -xxm voltage report. Use -ma to always see
1761              them.
1762
1763
1764       -xxx -N
1765              - Adds, if present, serial number.
1766
1767              - Adds, if present, PCI/USB class ID.
1768
1769
1770       -xxx -R
1771              -  md-raid:  Adds  system  mdraid support types (kernel support,
1772              read ahead, RAID events)
1773
1774              - zfs-raid: Adds portion allocated (used) by RAID array/device.
1775
1776              - Hardware RAID: Adds rev, ports, and (if available and/or rele‐
1777              vant) vendor: item, which shows specific vendor [product] infor‐
1778              mation.
1779
1780
1781       -xxx -S
1782              - Adds, if in X, or with  --display,  bar/dock/panel/tray  items
1783              (info).  If  none  found,  shows nothing. Supports desktop items
1784              like  gnome-panel,  lxpanel,  xfce4-panel,  lxqt-panel,   tint2,
1785              cairo-dock, trayer, and many others.
1786
1787              - Adds (if present), window manager (wm) version number.
1788
1789              - Adds (if present), display manager (dm) version number.
1790
1791              -  Adds  (if  available,  and in display), virtual terminal (vt)
1792              number.  These are the same as  ctrl+alt+F[x]  numbers  usually.
1793              Some systems have this, some don't, it varies.
1794
1795
1796       -xxx -w , -W
1797              -  Adds  location (city state country), observation altitude (if
1798              available), weather observation time (if available), sunset/sun‐
1799              rise (if available).
1800
1801

ADMIN EXTRA DATA OPTIONS

1803       These  options  are triggered with --admin or -a. Admin options are ad‐
1804       vanced output options, and are more technical, and mostly  of  interest
1805       to system administrators or other machine admins.
1806
1807       The  --admin  option  sets -xxx, and only has to be used once.  It will
1808       trigger the following features:
1809
1810
1811       -a -A  - Adds, if present, possible alternate: kernel  modules  capable
1812              of driving each Device-x (not including the current driver:). If
1813              no non-driver modules found, shows nothing. NOTE:  just  because
1814              it  lists  a module does NOT mean it is available in the system,
1815              it's just something the kernel knows could possibly be used  in‐
1816              stead.
1817
1818              - Adds PCIe generation, and, if different than running PCIe gen‐
1819              eration, speed or lanes,  link-max:  gen:  speed:  lanes:  (only
1820              items different from primary shown).
1821
1822
1823       -a -C
1824              -  Adds  CPU  generation,  process node, and built years, if de‐
1825              tected. For Intel, only will show if Core generation,  otherwise
1826              the arch value is enough. For AMD, only shows Zen generation.
1827
1828              -  Adds microarchitecture level: (v1,v2,v3,v4) (64 bit Intel/AMD
1829              CPUs only). This information is used for  setting  compile  time
1830              optimization  switches in for example GCC. These levels were in‐
1831              troduced in 2020.
1832
1833              Because this a CPU flag based test, and these levels  when  >  2
1834              are not always 100% based on exposed CPU flags (eg OSXSAVE), for
1835              > v2, adds note: check.
1836
1837              - Adds CPU family, model-id, and stepping (replaces rev of -Cx).
1838              Format  is  hexadecimal  (decimal)  if greater than 9, otherwise
1839              hexadecimal.
1840
1841              - Adds CPU microcode. Format is hexadecimal.
1842
1843              - Adds socket type (for motherboard CPU socket,  if  available).
1844              If  results doubtful will list two socket types and note: check.
1845              Requires doas/sudo/root and dmidecode. The item  in  parentheses
1846              may  simply  be  a  different syntax for the same socket, but in
1847              general, check this before trusting it.
1848
1849              Sample: socket: 775 (478) note: check
1850              Sample: socket: AM4
1851
1852              -  Adds  DMI  CPU  base   and   boost/turbo   speeds.   Requires
1853              doas/sudo/root  and  dmidecode.  In  some cases, like with over‐
1854              clocking or 'turbo' or 'boost' modes, voltage and external clock
1855              speeds  may be increased, or short term limits raised on max CPU
1856              speeds. These are often not reflected in /sys based CPU min/max:
1857              speed results, but often are using this source.
1858
1859              Samples:
1860              CPU not overclocked, with boost, like Ryzen:
1861              Speed (MHz):
1862                avg: 2861
1863                high: 3250
1864                min/max: 1550/3400
1865                boost: enabled
1866                base/boost: 3400/3900
1867              Overclocked 2900 MHz CPU, with no boost available:
1868              Speed (MHz):
1869                avg: 2345
1870                high: 2900
1871                min/max: 800/2900
1872                base/boost: 3350/3000
1873              Overclocked 3000 MHz CPU, with boosted max speed:
1874              Speed (MHz):
1875                avg: 3260
1876                high: 4190
1877                min/max: 1200/3001
1878                base/boost: 3000/4000
1879
1880              Note  that  these  numbers  can be confusing, but basically, the
1881              base number is the actual normal top speed the CPU runs at with‐
1882              out  boost  mode,  and the boost number is the max speed the CPU
1883              reports itself able to run at.  The  actual  max  speed  may  be
1884              higher  than either value, or lower. The boost number appears to
1885              be hard-coded into the CPU DMI data, and does not  seem  to  re‐
1886              flect  actual max speeds that overclocking or other combinations
1887              of speed boosters can enable, as you can see  from  the  example
1888              where  the  CPU is running at a speed faster than the min/max or
1889              base/boost values.
1890
1891              Note that the normal min/max: speeds do NOT  show  actual  over‐
1892              clocked  OR boost/turbo mode speeds, and appear to be hard-coded
1893              values, not dynamic real  values.  The  base/boost:  values  are
1894              sometimes  real,  and sometimes not.  base appears in general to
1895              be real.
1896
1897              - Adds frequency scaling: governor:.. driver:.. if  found/avail‐
1898              able.  Also  adds scaling min/max speeds if different from stan‐
1899              dard CPU min/max spees (not common).
1900
1901              - Adds description of cache topology per cpu. Linux only.
1902
1903              - Creates new Topology: line after the Info: line.  Moves  cache
1904              data to this line from Info: line.
1905
1906              Topology  line  contains, if available and/or relevant: physical
1907              CPU count (cpus:); per physical cpu core count (cores:); threads
1908              per core, if > 1 (tpc:); how many threads: (if more threads than
1909              cores); dies: (rarely detected, but if so, if > 1);  smt  status
1910              (if no smt status found, shows N/A).
1911
1912              If  complex  CPU  type, like Alder lake, cores; will have a more
1913              granular breakdown of how many mt (multi-threaded) and how  many
1914              st   (single-threaded)   cores  there  in  the  physical  cpu  (
1915              mt-cores:, st-cores:);  For complex CPU types like ARM  SoC  de‐
1916              vices  with  2  CPU  types,  with  different  core counts and/or
1917              min/max:) frequencies, variant: per type  found,  with  relevant
1918              differences shown, like cores:, min/max:, etc.
1919
1920              CPU:
1921                Info:
1922                  model: AMD EPYC 7281
1923                  bits: 64
1924                  type: MT MCP MCM SMP
1925                  arch: Zen
1926                    gen: 1
1927                  level: v3
1928                    note: check
1929                  process: GF 14nm
1930                  built: 2017-19
1931                  family:0x17 (23)
1932                  model-id:1
1933                  stepping: 2
1934                  microcode: 0x8001250
1935                Topology:
1936                  cpus: 2
1937                    cores: 16
1938                      tpc: 2
1939                    threads: 32
1940                    dies: 4
1941                 cache:
1942                   L1: 2x 1.5 MiB (3 MiB)
1943                     desc: d-16x32 KiB; i-16x64 KiB
1944                   L2: 2x 8 MiB (16 MiB)
1945                     desc: 16x512 KiB
1946                   L3: 2x 32 MiB (64 MiB)
1947                     desc: 8x4 MiB
1948                Speed (MHz):
1949                  avg: 1195
1950                  high: 1197
1951                  min/max: 1200/2100
1952                  boost: enabled
1953                  scaling:
1954                    driver: acpi-cpufreq
1955                    governor: ondemand
1956                  cores:
1957                    1: 1195
1958                    2: 1196
1959                    ....
1960                  bogomips: 267823
1961
1962              -  Adds CPU Vulnerabilities (bugs) as known by your current ker‐
1963              nel. Lists by Type: ... (status|mitigation):  ....  for  systems
1964              that  support  this  feature  (Linux  kernel  4.14  or newer, or
1965              patched older kernels).
1966
1967
1968       -a -d,-a -D
1969              - Adds logical and physical block size in bytes.
1970
1971              Using smartctl (requires doas/sudo/root privileges).
1972
1973              - Adds device model family, like Caviar Black, if available.
1974
1975              - Adds SATA type (eg 1.0, 2.6, 3.0) if a SATA device.
1976
1977              - Adds device kernel major:minor number (Linux only).
1978
1979              - Adds SMART report line: status, enabled/disabled, health, pow‐
1980              ered  on,  cycles,  and some error cases if out of range values.
1981              Note that for Pre-fail items, it will show the VALUE and THRESH‐
1982              OLD  numbers. It will also fall back for unknown attributes that
1983              are or have been failing  and  print  out  the  Attribute  name,
1984              value,  threshold, and failing message. This way even for unhan‐
1985              dled Attribute names, you should get a  solid  report  for  full
1986              failure  cases.  Other  cases may show if inxi believes that the
1987              item may be approaching failure. This is a guess so make sure to
1988              check the drive and smartctl full output to verify before taking
1989              any further action.
1990
1991              - Adds, for USB or other external drives, actual model  name/se‐
1992              rial  if  available,  and different from enclosure model/serial,
1993              and corrects block sizes if necessary. Adds in drive temperature
1994              for some drives as well, and other useful data.
1995
1996
1997       -a -E (--bluetooth)
1998              - Adds (hciconfig only) extra line to Report:, Info:.  Includes,
1999              if available, ACL MTU, SCO MTU, Link policy, Link mode, and Ser‐
2000              vice Classes.
2001
2002              - Adds PCIe generation, and, if different than running PCIe gen‐
2003              eration, speed or lanes,  link-max:  gen:  speed:  lanes:  (only
2004              items different from primary shown. Bluetooth PCIe rare).
2005
2006
2007       -a -G  -  Adds,  if present, possible alternate: kernel modules capable
2008              of driving each Device-x (not including the current loaded:). If
2009              no  non-driver  modules found, shows nothing. NOTE: just because
2010              it lists a module does NOT mean it is available in  the  system,
2011              it's  just something the kernel knows could possibly be used in‐
2012              stead.
2013
2014              - Adds (AMD/Intel/Nvidia, if available) process:  [node]  built:
2015              [years] to arch: item.
2016
2017              - Adds (if Linux and Nvidia device) non-free support information
2018              (if available). This can be useful for forum support  people  to
2019              determine  if  the  card  supports  current active legacy Nvidia
2020              driver branches, or if the card nonfree driver is EOL or active.
2021              Note that if card is current, shows basic series and status.
2022
2023              Includes  extended  non free Nvidia legacy informatin (Linux and
2024              Nvidia only), and arch: reports  (AMD/Intel/Nvidia).  Useful  to
2025              help  diagnose  driver support issues, shows extra data that can
2026              help diagnose/debug. Adds code: item if found and not  the  same
2027              as arch:.
2028
2029              inxi -Gaz
2030              Graphics:
2031                Device-1: NVIDIA NV34 [GeForce FX 5200] driver: nouveau v: kernel
2032                  non-free: 173.14.xx status: legacy (EOL) last: kernel: 3.12 xorg: 1.15
2033                  release: 173.14.39 arch: Rankine code: NV3x process: 130-150nm
2034                  built: 2003-05 ports: active: VGA-1 empty: DVI-I-1,TV-1
2035                  bus-ID: 01:00.0 chip-ID: 10de:0322 class-ID: 0300
2036                Display: x11 server: X.Org v: 21.1.3 driver: X: loaded: nouveau
2037                  unloaded: fbdev,modesetting,vesa alternate: nv,nvidia gpu: nouveau
2038                  display-ID: :0 screens: 1
2039
2040              With -y1:
2041
2042              inxi -Gaz -y1
2043              Graphics:
2044                Device-1: NVIDIA NV34 [GeForce FX 5200]
2045                  driver: nouveau
2046                    v: kernel
2047                    non-free:
2048                      series: 173.14.xx
2049                      status: legacy (EOL)
2050                      last:
2051                        kernel: 3.12
2052                        xorg: 1.15
2053                        release: 173.14.39
2054                  arch: Rankine
2055                    code: NV3x
2056                    process: 130-150nm
2057                    built: 2003-05
2058                  ports:
2059                    active: VGA-1
2060                    empty: DVI-I-1,TV-1
2061                  bus-ID: 01:00.0
2062                  chip-ID: 10de:0322
2063                  class-ID: 0300
2064
2065              - Adds PCIe generation, and, if different than running PCIe gen‐
2066              eration, speed or lanes,  link-max:  gen:  speed:  lanes:  (only
2067              items different from primary shown).
2068
2069              - Adds to Monitors built:, gamma:, ratio: (if found).
2070
2071              X.org sample (with both xdpyinfo and xrandr data available):
2072              inxi -aGz
2073              Graphics:
2074                Device-1: AMD Cedar [Radeon HD 5000/6000/7350/8350 Series] vendor: XFX Pine
2075                  driver: radeon v: kernel alternate: amdgpu arch: TeraScale-2
2076                  code: Evergreen process: TSMC 32-40nm built: 2009-15 pcie: gen: 1
2077                  speed: 2.5 GT/s lanes: 16 link-max: gen: 2 speed: 5 GT/s ports:
2078                  active: DVI-I-1,VGA-1 empty: HDMI-A-1 bus-ID: 0a:00.0
2079                  chip-ID: 1002:68f9 class-ID: 0300
2080                Display: x11 server: X.Org v: 1.21.1.3 with: Xwayland v: 22.1.0
2081                  compositor: xfwm v: 4.16.1 driver: X: loaded: modesetting dri: r600
2082                  gpu: radeon display-ID: :0.0 screens: 1
2083                Screen-1: 0 s-res: 2560x1024 s-dpi: 96 s-size: 677x270mm (26.65x10.63")
2084                  s-diag: 729mm (28.7")
2085                Monitor-1: DVI-I-1 pos: primary,left model: Samsung SyncMaster
2086                  serial: <filter> built: 2004 res: 1280x1024 hz: 60 dpi: 96 gamma: 1.2
2087                  size: 338x270mm (13.31x10.63") diag: 433mm (17") ratio: 5:4 modes:
2088                  max: 1280x1024 min: 720x400
2089                Monitor-2: VGA-1 pos: right model: Dell 1908FP serial: <filter>
2090                  built: 2008 res: 1280x1024 hz: 60 dpi: 86 gamma: 1.4
2091                  size: 376x301mm (14.8x11.85") diag: 482mm (19") ratio: 5:4 modes:
2092                  max: 1280x1024 min: 720x400
2093                API: OpenGL renderer: AMD CEDAR (DRM 2.50.0 / 5.16.0-11.1-liquorix-amd64 LLVM
2094                  12.0.1) v: 3.3 Mesa 21.2.6 compat-v: 3.1 direct render: Yes
2095               ....
2096              Wayland sample, with Sway/swaymsg:
2097              inxi -aGz
2098              Graphics:
2099                Device-1: AMD Cedar [Radeon HD 5000/6000/7350/8350 Series] vendor: XFX Pine
2100                  driver: radeon v: kernel alternate: amdgpu arch: TeraScale 2
2101                  process: TSMC 32-40nm pcie: gen: 1 speed: 2.5 GT/s lanes: 16 link-max:
2102                  gen: 2 speed: 5 GT/s ports: active: DVI-I-1,VGA-1 empty: HDMI-A-1
2103                  bus-ID: 0a:00.0 chip-ID: 1002:68f9 class-ID: 0300
2104                Display: wayland server: Xwayland v: 21.1.4 compositor: sway v: 1.6.1
2105                  driver: gpu: radeon d-rect: 2560x1024
2106                Monitor-1: DVI-I-1 pos: right model: SyncMaster serial: <filter>
2107                  built: 2004 res: 1280x1024 hz: 60 dpi: 96 gamma: 1.2
2108                  size: 340x270mm (13.4x10.6") diag: 434mm (17.1") ratio: 5:4 modes:
2109                  max: 1280x1024 min: 720x400
2110                Monitor-2: VGA-1 pos: primary,left model: DELL 1908FP serial: <filter>
2111                  res: 1280x1024 hz: 60 gamma: 1.4 dpi: 86 gamma: 1.4
2112                  size: 380x300mm (15.0x11.8") diag: 484mm (19.1") ratio: 5:4 modes:
2113                  max: 1280x1024 min: 720x400
2114                API: GBM/EGL
2115                  Message: Wayland GBM/EGL data currently not available.
2116
2117       -a -I  -  Adds  to Packages number of lib packages detected per package
2118              manager. Also adds detected package  managers  with  0  packages
2119              listed.  Adds  package manager tools (supported: rpm, dpkg, pkg‐
2120              tool) Moves to Repos if -ra.
2121
2122              inxi -aI
2123              Info:
2124                ....
2125                Init: systemd v: 245 target: graphical.target (5) default: graphical.target
2126                Compilers: gcc: 9.3.0 alt: 5/6/7/8/9 Packages: pm: apt pkgs: 3681 libs: 2096
2127                tools: apt, apt-get,aptitude pm: rpm pkgs: 0 Shell: ksh v: A_2020.0.0
2128                default: Bash v: 5.0.16 running-in: kate inxi: 3.1.04
2129
2130              - Adds service control tool, tested for in the following  order:
2131              systemctl rc-service rcctl service sv /etc/rc.d /etc/init.d. Can
2132              be useful to know which you need when using  an  unfamiliar  ma‐
2133              chine.
2134
2135
2136       -a -j, -a -P [swap], -a -P [swap]
2137              - Adds swappiness and vfs cache pressure, and a message to indi‐
2138              cate if the value is the default value or not (Linux  only,  and
2139              only  if  available).  If  not  the default value, shows default
2140              value as well, e.g.
2141
2142              For -P per swap physical partition:
2143
2144              swappiness: 60 (default) cache-pressure: 90 (default 100)
2145
2146              For -j row 1 output:
2147
2148              Kernel: swappiness: 60  (default)  cache-pressure:  90  (default
2149              100)
2150
2151              - Adds device kernel major:minor number (Linux only).
2152
2153
2154       -a -L  -  Expands  Component report, shows size / maj-min of components
2155              and devices, and mapped name for logical components.  Puts  each
2156              component/device on its own line.
2157
2158              - Adds maj-min to LV and other devices.
2159
2160
2161       -a -m  -  Expands volts to include curr/min/max values even if they are
2162              all identical.
2163
2164
2165       -a -n, -a -N, -a -i
2166              - Adds, if present, possible alternate: kernel  modules  capable
2167              of driving each Device-x (not including the current driver:). If
2168              no non-driver modules found, shows nothing. NOTE:  just  because
2169              it  lists  a module does NOT mean it is available in the system,
2170              it's just something the kernel knows could possibly be used  in‐
2171              stead.
2172
2173              - Adds PCIe generation, and, if different than running PCIe gen‐
2174              eration, speed or lanes,  link-max:  gen:  speed:  lanes:  (only
2175              items different from primary shown).
2176
2177
2178       -a -o  - Adds device kernel major:minor number (Linux only).
2179
2180
2181       -a -p,-a -P
2182              -  Adds raw partition size, including file system overhead, par‐
2183              tition table, e.g.
2184
2185              raw-size: 60.00 GiB.
2186
2187              - Adds percent of raw size available to size: item, e.g.
2188
2189              size: 58.81 GiB (98.01%).
2190
2191              Note that used: 16.44 GiB (34.3%) percent refers to  the  avail‐
2192              able size, not the raw size.
2193
2194              -  Adds  partition filesystem block size if found (requires root
2195              and blockdev).
2196
2197              - Adds device kernel major:minor number (Linux only).
2198
2199
2200       -a -r  - Adds to Packages: report. See -Ia
2201
2202
2203       -a -R  - Adds device kernel major:minor number (mdraid, Linux only).
2204
2205              - Adds, if available, component size, major:minor number  (Linux
2206              only). Turns Component report to 1 component per line.
2207
2208
2209       -a -S  -  Adds  kernel boot parameters to Kernel section (if detected).
2210              Support varies by OS type.
2211
2212
2213       -a --slots
2214              - Adds PCI children of the main slot bus ID, and their types and
2215              class  IDs,  recursively. Linux only, and only if detected. Sam‐
2216              ple:
2217
2218              Slot: 0
2219                type: PCIe
2220                lanes: 16
2221                status: in use
2222                length: long
2223                volts: 3.3
2224                bus-ID: 00:03.1
2225                  children:
2226                    1: 07:00.0
2227                      class-ID: 0300
2228                      type: display
2229                    2: 07:00.1
2230                      class-ID: 0403
2231                      type: audio
2232
2233

ADVANCED OPTIONS

2235       --alt 40
2236              Bypass  Perl  as  a  downloader  option.   Priority   is:   Perl
2237              (HTTP::Tiny), Curl, Wget, Fetch, (OpenBSD only) ftp.
2238
2239
2240       --alt 41
2241              Bypass   Curl   as   a  downloader  option.  Priority  is:  Perl
2242              (HTTP::Tiny), Curl, Wget, Fetch, (OpenBSD only) ftp.
2243
2244
2245       --alt 42
2246              Bypass  Fetch  as  a  downloader  option.  Priority   is:   Perl
2247              (HTTP::Tiny), Curl, Wget, Fetch, (OpenBSD only) ftp.
2248
2249
2250       --alt 43
2251              Bypass   Wget   as   a  downloader  option.  Priority  is:  Perl
2252              (HTTP::Tiny), Curl, Wget, Fetch, OpenBSD only: ftp
2253
2254
2255       --alt 44
2256              Bypass Curl, Fetch, and Wget as downloader options.  This  basi‐
2257              cally   forces   the   downloader  selection  to  use  Perl  5.x
2258              HTTP::Tiny, which is generally slower than Curl or Wget  but  it
2259              may help bypass issues with downloading.
2260
2261
2262       --bt-tool [bt-adapter|hciconfig|rfkill]
2263              Force  the  use  of  the  given  tool for bluetooth report (-E).
2264              rfkill does not support mac address data.
2265
2266
2267       --dig  Temporary override of NO_DIG configuration  item.  Only  use  to
2268              test  w/wo  dig.  Restores default behavior for WAN IP, which is
2269              use dig if present.
2270
2271
2272       --display [:<integer>]
2273              Will try to get display data out of X (does not usually work  as
2274              root  user).   Default gets display info from display :0. If you
2275              use the format --display :1 then it would get it from display  1
2276              instead, or any display you specify.
2277
2278              Note  that in some cases, --display will cause inxi to hang end‐
2279              lessly when running the option in console with  Intel  graphics.
2280              The  situation  regarding other free drivers such as nouveau/ATI
2281              is currently unknown. It may be that this is a bug with the  In‐
2282              tel graphics driver - more information is required.
2283
2284              You can test this easily by running the following command out of
2285              X/display server: glxinfo -display :0
2286
2287              If it hangs, --display will not work.
2288
2289
2290       --dmidecode
2291              Shortcut. See --force dmidecode.
2292
2293
2294       --downloader [curl|fetch|perl|wget]
2295              Force inxi to use Curl, Fetch, Perl, or Wget for downloads.
2296
2297
2298       --force [option(s)]
2299              Various force options to allow users to override defaults.  Val‐
2300              ues can be given as a comma separated list:
2301
2302              inxi -MJ --force dmidecode,lsusb
2303
2304              -  colors  -  Same as -Y -2 . Do not remove colors from piped or
2305              redirected output.
2306
2307              - dmidecode - Force use of dmidecode. This  will  override  /sys
2308              data in some lines, e.g. -M or -B.
2309
2310              -  hddtemp  - Force use of hddtemp instead of /sys temp data for
2311              disks.
2312
2313              - lsusb - Forces the USB data generator to  use  lsusb  as  data
2314              source   (default).  Overrides  USB_SYS  in  user  configuration
2315              file(s).
2316
2317              - rpm, pkg - Force override of disabled RPM  package  counts  on
2318              primarily  RPM  run  systems  due to unacceptably slow execution
2319              times for this command:
2320
2321              rpm -qa --nodigest --nosignature
2322
2323              Even on newer RPM systems,  in  virtual  machines,  running  rpm
2324              package  list  query  takes  more than 0.15 seconds (compared to
2325              0.01 to 0.05 for dpkg, pacman, pkgtool etc) for just this single
2326              feature,  which is north of 10% of total execution time for inxi
2327              -bar. On bare metal this can hit 1 second or more in our  tests.
2328              Older systems have taken up to 30 seconds to run this command!
2329
2330              For  systems  that  support  running  rpm along with the primary
2331              package  installer  (dpkg/apt,  pacman,  and  pkgtool/slackpkg),
2332              there  are  not going to be many rpms, if any, installed, so the
2333              command runs in those cases (if inxi can determine it is running
2334              in that type of system).
2335
2336              -  sensors-sys  - Force use of /sys/class/hwmon data for sensors
2337              (excluding ipmi sensors, which are their own line  if  present),
2338              skip  lm-sensors. Generally useful for testing since sys data is
2339              used if no lm-sensors data was found anyway, but  if  lm-sensors
2340              was  installed,  and  returned  no data, it's most likely if not
2341              nearly certain that /sys will also not return data.
2342
2343              - usb-sys - Forces the USB data generator to use  /sys  as  data
2344              source instead of lsusb (Linux only).
2345
2346              - vmstat - Forces use of vmstat for memory data.
2347
2348              -  wayland  -  Forces  use of Wayland, disables x tools glxinfo,
2349              xrandr, xdpyinfo.
2350
2351              - wmctrl - Force System item wm to use wmctrl  as  data  source,
2352              override default ps source.
2353
2354
2355       --hddtemp
2356              Shortcut. See --force hddtemp.
2357
2358
2359       --html-wan
2360              Temporary  override  of NO_HTML_WAN configuration item. Only use
2361              to test w/wo HTML downloaders for WAN IP. Restores  default  be‐
2362              havior  for  WAN IP, which is use HTML downloader if present and
2363              if dig failed.
2364
2365
2366       --man  Updates / installs man page with -U if pinxi or using -U  3  dev
2367              branch. (Only active if -U is is not disabled by maintainers).
2368
2369
2370       --no-dig
2371              Overrides  default  use of dig to get WAN IP address. Allows use
2372              of normal downloader tool to get IP addresses. Only use  if  dig
2373              is  failing,  since dig is much faster and more reliable in gen‐
2374              eral than other methods.
2375
2376
2377       --no-doas
2378              Skips the use of doas to run certain internal features (like hd‐
2379              dtemp,  file) with doas. Not related to running inxi itself with
2380              doas/sudo or super user. Some systems will register errors which
2381              will  then trigger admin emails in such cases, so if you want to
2382              disable regular user use of doas (which  requires  configuration
2383              to  setup  anyway  for  these  options) just use this option, or
2384              NO_DOAS configuration item. See --no-sudo if you need to disable
2385              both types.
2386
2387
2388       --no-html-wan
2389              Overrides use of HTML downloaders to get WAN IP address. Use ei‐
2390              ther only dig, or do not get wan IP. Only use if dig is failing,
2391              and  the HTML downloaders are taking too long, or are hanging or
2392              failing.
2393
2394              Make permanent with NO_HTML_WAN='true'
2395
2396
2397       --no-man
2398              Disables man page install with -U for master and active develop‐
2399              ment  branches.  (Only  active if -U is is not disabled by main‐
2400              tainers).
2401
2402
2403       --no-sensor-force
2404              Overrides user set SENSOR_FORCE  configuration  value.  Restores
2405              default behavior.
2406
2407
2408       --no-ssl
2409              Skip  SSL certificate checks for all downloader actions (-U, -w,
2410              -W, -i). Use if your system does not have current  SSL  certifi‐
2411              cate  lists, or if you have problems making a connection for any
2412              reason. Works with Wget, Curl, Perl HTTP::Tiny and Fetch.
2413
2414
2415       --no-sudo
2416              Skips the use of sudo to run certain internal features (like hd‐
2417              dtemp,  file) with sudo. Not related to running inxi itself with
2418              sudo or superuser. Some systems will register errors which  will
2419              then  trigger admin emails in such cases, so if you want to dis‐
2420              able regular user use of sudo (which requires  configuration  to
2421              setup anyway for these options) just use this option, or NO_SUDO
2422              configuration item.
2423
2424
2425       --pm-type [package manager name]
2426              For distro package maintainers only, and only for non apt,  rpm,
2427              or  pacman based systems. To be used to test replacement package
2428              lists for recommends for that package manager.
2429
2430
2431       --rpm, --pkg
2432              Shortcut. See --force rpm.
2433
2434
2435       --sensors-default
2436              Overrides configuration values SENSORS_USE or SENSORS_EXCLUDE on
2437              a one time basis.
2438
2439
2440       --sensors-exclude
2441              Linux  only. Similar to --sensors-use except removes listed sen‐
2442              sors from sensor data. Make permanent with SENSORS_EXCLUDE  con‐
2443              figuration  item.  Note  that gpu, network, disk, and other spe‐
2444              cific device monitor chips are excluded by default.
2445
2446              Example: inxi -sxx --sensors-exclude k10temp-pci-00c3
2447
2448
2449       --sensors-sys
2450              Shortcut. See --force sensors-sys
2451
2452
2453       --sensors-use
2454              Linux only. Use only the (comma separated) sensor arrays for  -s
2455              output.   Make  permanent  with  SENSORS_USE configuration item.
2456              Sensor array ID value must be the exact value shown  in  lm-sen‐
2457              sors sensors output (lm-sensors only) or use -s --dbg 18 ('main'
2458              =>.. section) to see the sensor ID strings used  internally.  If
2459              you  only want to exclude one (or more) sensors from the output,
2460              use --sensors-exclude.
2461
2462              Can be useful if the default sensor data used  by  inxi  is  not
2463              from  the  right  sensor  array. Note that all other sensor data
2464              will be removed,  which  may  lead  to  undesired  consequences.
2465              Please  be aware that this can lead to many undesirable side-ef‐
2466              fects, since default behavior is to use all the  sensors  arrays
2467              and  select  which  values  to use from them following a set se‐
2468              quence of rules. So if you force one to be used,  you  may  lose
2469              data that was used from another one.
2470
2471              Most  likely  best use is when one (or two) of the sensor arrays
2472              has all the sensor data you want, and you just want to make sure
2473              inxi  doesn't use data from another array that has inaccurate or
2474              misleading data.
2475
2476              Note that gpu, network, disk, and other specific device  monitor
2477              chips  are  excluded  by  default, and should not be added since
2478              they do not provide cpu, board, system, etc, sensor data.
2479
2480              Example:  inxi  -sxx   --sensors-use   nct6791-isa-0290,k10temp-
2481              pci-00c3
2482
2483
2484       --sleep [0-x.x]
2485              Usually  in  decimals.  Change  CPU  sleep time for -C (current:
2486               .35).  Sleep is used to let the system catch up and show a more
2487              accurate CPU use.  Example:
2488
2489              inxi -Cxxx --sleep 0.15
2490
2491              Overrides default internal value and user configuration value:
2492
2493              CPU_SLEEP=0.25
2494
2495
2496       --tty  Forces  internal  IRC flag to off. Used in unhandled cases where
2497              the program running inxi may not be seen as a shell/pty/tty, but
2498              it  is  not  an  IRC  client.  Put --tty first in option list to
2499              avoid unexpected errors. If you want a  specific  output  width,
2500              use  the  --width  option. If you want normal color codes in the
2501              output, use the -c [color ID] flag.
2502
2503              The sign you need to  use  this  is  extra  numbers  before  the
2504              key/value  pairs  of  the output of your program. These are IRC,
2505              not TTY, color codes. Please post a github issue if you find you
2506              need to use --tty (including the full -Ixxx line) so we can fig‐
2507              ure out how to add your program to the list of whitelisted  pro‐
2508              grams.
2509
2510              You  can  see  what  inxi believed started it in the -Ixxx line,
2511              Shell: or Client: item. Please let us know what that result  was
2512              so we can add it to the parent start program whitelist.
2513
2514              In some cases, you may want to also use --no-filter/-Z option if
2515              you want to see filtered values. Filtering is turned on  by  de‐
2516              fault if inxi believes it is running in an IRC client.
2517
2518
2519       --usb-sys
2520              Shortcut. See --force usb-sys
2521
2522
2523       --usb-tool
2524              Shortcut. See --force lsusb
2525
2526
2527       --wan-ip-url [URL]
2528              Force  -i to use supplied URL as WAN IP source. Overrides dig or
2529              default IP source urls. URL must start with http[s] or ftp.
2530
2531              The IP address from the URL must be the last item  on  the  last
2532              (non-empty) line of the page content source code.
2533
2534              Same as configuration value (example):
2535
2536              WAN_IP_URL='https://mysite.com/ip.php'
2537
2538
2539       --wayland, --wl
2540              Shortcut. See --force wayland.
2541
2542
2543       --wm   Shortcut. See --force wmctl.
2544
2545

DEBUGGING OPTIONS

2547       --dbg {[1-x][,[1-x]]}
2548              Accepts  one or more comma separated dbg specific debugging num‐
2549              bers.
2550
2551              1 - Debug downloader failures. Turns off silent/quiet  mode  for
2552              curl, wget, and fetch. Shows more downloader action information.
2553              Shows some more information for Perl downloader.
2554
2555              1-xx - See github  inxi-perl/docs/inxi-values.txt  for  specific
2556              specialized debugging options. There are a lot.
2557
2558
2559       --debug [1-3]
2560              - On screen debugger output.
2561
2562
2563       --debug 10
2564              -   Basic   logging.   Check   $XDG_DATA_HOME/inxi/inxi.log   or
2565              $HOME/.local/share/inxi/inxi.log or $HOME/.inxi/inxi.log.
2566
2567
2568       --debug 11
2569              - Full file/system info logging.
2570
2571
2572       --debug 20
2573              Creates a tar.gz file of system data and collects the inxi  out‐
2574              put in a file.
2575
2576              *  tree  traversal  data  file(s)  read from /proc and /sys, and
2577              other system data.
2578
2579              * xorg conf and log data, xrandr, xprop, xdpyinfo, glxinfo etc.
2580
2581              * data from dev, disks, partitions, etc.
2582
2583
2584       --debug 21
2585              Automatically uploads debugger data tar.gz file to ftp.smxi.org,
2586              then  removes  the  debug  data  directory, but leaves the debug
2587              tar.gz file.  See --ftp for uploading to alternate locations.
2588
2589
2590       --debug 22
2591              Automatically uploads debugger data tar.gz file to ftp.smxi.org,
2592              then  removes the debug data directory and the tar.gz file.  See
2593              --ftp for uploading to alternate locations.
2594
2595
2596       --fake-data-dir
2597              Developer only: Change default location of $fake_data_dir, which
2598              is where files are for --fake {item} items.
2599
2600
2601       --ftp [ftp.yoursite.com/incoming]
2602              For alternate ftp upload locations: Example:
2603
2604              inxi --ftp ftp.yourserver.com/incoming --debug 21
2605
2606

DEBUGGING OPTIONS TO DEBUG DEBUGGER FAILURES

2608       Only use the following in conjunction with --debug 2[012], and only use
2609       if you experienced a failure or hang, or were instructed to do so.
2610
2611
2612       --debug-proc
2613              Force debugger to parse /proc directory data when run  as  root.
2614              Normally  this  is  disabled  due to unpredictable data in /proc
2615              tree.
2616
2617
2618       --debug-proc-print
2619              Use this to locate file that /proc debugger hangs on.
2620
2621
2622       --debug-no-exit
2623              Skip exit on error when running debugger.
2624
2625
2626       --debug-no-proc
2627              Skip /proc debugging in case of a hang.
2628
2629
2630       --debug-no-sys
2631              Skip /sys debugging in case of a hang.
2632
2633
2634       --debug-sys
2635              Force PowerPC debugger parsing of /sys as doas/sudo/root.
2636
2637
2638       --debug-sys-print
2639              Use this to locate file that /sys debugger hangs on.
2640
2641

SUPPORTED IRC CLIENTS

2643       BitchX, Gaim/Pidgin, ircII, Irssi, Konversation, Kopete, KSirc,  KVIrc,
2644       Weechat,  and Xchat. Plus any others that are capable of displaying ei‐
2645       ther built-in or external script output.
2646
2647

RUNNING IN IRC CLIENT

2649       To trigger inxi output in your IRC client, pick the appropriate  method
2650       from the list below:
2651
2652       Hexchat, XChat, Irssi
2653              (and  many  other  IRC  clients)  /exec -o inxi [options] If you
2654              don't include the -o, only you will see the output on your local
2655              IRC client.
2656
2657       Konversation
2658              /cmd inxi [options]
2659
2660              To run inxi in Konversation as a native script if your distribu‐
2661              tion or inxi package hasn't already done this  for  you,  create
2662              this symbolic link:
2663
2664              KDE  4: ln -s /usr/local/bin/inxi /usr/share/kde4/apps/konversa‐
2665              tion/scripts/inxi
2666
2667              KDE   5:   ln   -s   /usr/local/bin/inxi    /usr/share/konversa‐
2668              tion/scripts/inxi
2669
2670              If  inxi  is  somewhere  else, change the path /usr/local/bin to
2671              wherever it is located.
2672
2673              If you are using KDE/QT 5, then you may also  need  to  add  the
2674              following to get the Konversation /inxi command to work:
2675
2676              ln -s /usr/share/konversation /usr/share/apps/
2677
2678              Make  sure  you also have the qdbus-qt5 package (Debian/Ubuntu +
2679              derived), qt5-qttools (Fedora/RHEL/SUSE +  derived),   qt5-tools
2680              (Arch  +  derived)  installed (for KDE 5/QT 5, check distros for
2681              future package names), qt5-tools (Arch +  derived).  Check  your
2682              distro  if  the  program  is  missing.  Depending on the distro,
2683              /usr/lib/qt5/bin/qdbus is required, which in Debian+ is provided
2684              by the above package.
2685
2686              Then you can start inxi directly, like this:
2687
2688              /inxi [options]
2689
2690       WeeChat
2691              NEW: /exec -o inxi [options]
2692
2693              OLD: /shell -o inxi [options]
2694
2695              Newer (2014 and later) WeeChats work pretty much the same now as
2696              other console IRC clients, with /exec -o inxi  [options].  Newer
2697              WeeChats  have  dropped  the -curses part of their program name,
2698              i.e.: weechat instead of weechat-curses.
2699
2700

CONFIGURATION FILE

2702       inxi will read its configuration/initialization files in the  following
2703       order:
2704
2705       /etc/inxi.conf  contains the default configurations. These can be over‐
2706       ridden by creating a /etc/inxi.d/inxi.conf file (global override, which
2707       will  prevent  distro packages from changing or overwriting your edits.
2708       This method is recommended if you are using a distro packaged inxi  and
2709       want  to  override  some configuration items from the package's default
2710       /etc/inxi.conf file but don't want to lose your changes  on  a  package
2711       update.
2712
2713       You can old override, per user, with a user configuration file found in
2714       one of the following locations (inxi will store its config  file  using
2715       the following precedence:
2716
2717       if   $XDG_CONFIG_HOME   is  not  empty,  it  will  go  there,  else  if
2718       $HOME/.conf/inxi.conf exists, it will go there, and as a last  default,
2719       the legacy location is used), i.e.:
2720
2721       $XDG_CONFIG_HOME/inxi.conf        >       $HOME/.conf/inxi.conf       >
2722       $HOME/.inxi/inxi.conf
2723
2724

CONFIGURATION OPTIONS

2726       See the documentation page for more complete information on how to  set
2727       these up, and for a complete list of options:
2728
2729       https://smxi.org/docs/inxi-configuration.htm
2730
2731       Basic Options
2732              Here's  a  brief overview of the basic options you are likely to
2733              want to use:
2734
2735              COLS_MAX_CONSOLE The max display column width  on  terminal.  If
2736              terminal/console width or --width is less than wrap width, wrap‐
2737              ping of line starter occurs
2738
2739              COLS_MAX_IRC The max display column width on IRC clients.
2740
2741              COLS_MAX_NO_DISPLAY The max display column width in out of  X  /
2742              Wayland / desktop / window manager.
2743
2744              CPU_SLEEP  Decimal  value  0  or more. Default is usually around
2745              0.35 seconds. Time that inxi will  'sleep'  before  getting  CPU
2746              speed data, so that it reflects actual system state.
2747
2748              DOWNLOADER Sets default inxi downloader: curl, fetch, ftp, perl,
2749              wget.  See --recommends output for more information on download‐
2750              ers and Perl downloaders.
2751
2752              FILTER_STRING Default <filter>. Any string you prefer to see in‐
2753              stead for filtered values.
2754
2755              INDENT Change primary indent width  of  wide  mode  output.  See
2756              --indent.
2757
2758              INDENTS  Change  primary  indents of narrow wrapped mode output,
2759              and second level indents. See --indents.
2760
2761              LIMIT Overrides default of 10 IP addresses per IF. This is  only
2762              of  interest  to  sys  admins  running  servers with many IP ad‐
2763              dresses.
2764
2765              LINES_MAX Values: [-2-xxx]. See -Y for explanation  and  values.
2766              Use -Y -3 to restore default unlimited output lines. Avoid using
2767              this in general unless the machine is a headless system and  you
2768              want the output to be always controlled.
2769
2770              MAX_WRAP  (or WRAP_MAX) The maximum width where the line starter
2771              wraps to its own line. If terminal/console width or  --width  is
2772              less than wrap width, wrapping of line starter occurs. Overrides
2773              default. See --max-wrap. If 80 or less, wrap will never happen.
2774
2775              NO_DIG Set to 1 or true to disable WAN IP use of dig  and  force
2776              use of alternate downloaders.
2777
2778              NO_DOAS Set to 1 or true to disable internal use of doas.
2779
2780              NO_HTML_WAN Set to 1 or true to disable WAN IP use of HTML Down‐
2781              loaders and force use of dig only, or nothing if dig disabled as
2782              well.  Same  as  --no-html-wan.  Only use if dig is failing, and
2783              HTML downloaders are hanging.
2784
2785              NO_SUDO Set to 1 or true to disable internal use of sudo.
2786
2787              PARTITION_SORT Overrides  default  partition  output  sort.  See
2788              --partition-sort for options.
2789
2790              PS_COUNT  The  default number of items showing per -t type, m or
2791              c. Default is 5.
2792
2793              SENSORS_CPU_NO In cases of  ambiguous  temp1/temp2  (inxi  can't
2794              figure out which is the CPU), forces sensors to use either value
2795              1 or 2 as CPU temperature. See the above configuration  page  on
2796              smxi.org for full info.
2797
2798              SENSORS_EXCLUDE  Exclude  supplied  sensor  array[s] from sensor
2799              output.  Override with --sensors-default. See --sensors-exclude.
2800
2801              SENSORS_USE Use only supplied  sensor  array[s].  Override  with
2802              --sensors-default. See --sensors-use.
2803
2804              SEP2_CONSOLE Replaces default key / value separator of ':'.
2805
2806              USB_SYS Forces all USB data to use /sys instead of lsusb.
2807
2808              WAN_IP_URL  Forces  -i  to  use supplied URL, and to not use dig
2809              (dig is generally much faster). URL must begin with http or ftp.
2810              Note  that  if  you  use this, the downloader set tests will run
2811              each time you start inxi whether a downloader feature  is  going
2812              to be used or not.
2813
2814              The  IP  address  from the URL must be the last item on the last
2815              (non-empty) line of the URL's page content source code.
2816
2817              Same as --wan-ip-url [URL]
2818
2819              WEATHER_SOURCE Values: [0-9]. Same as --weather-source.   Values
2820              4-9  are  not  currently  supported,  but this can change at any
2821              time.
2822
2823              WEATHER_UNIT Values: [m|i|mi|im]. Same as --weather-unit.
2824
2825
2826       Color Options
2827              It's best to use the -c [94-99] color selector tool to  set  the
2828              following values because it will correctly update the configura‐
2829              tion file and remove any invalid or conflicting  items,  but  if
2830              you  prefer to create your own configuration files, here are the
2831              options. All take the integer value from the  options  available
2832              in -c 94-99.
2833
2834              NOTE:  All  default  and configuration file set color values are
2835              removed when output is piped or redirected. You must use the ex‐
2836              plicit -c <color number> option if you want colors to be present
2837              in the piped/redirected output (creating a PDF for example).
2838
2839              CONSOLE_COLOR_SCHEME The color scheme for console output (not in
2840              X/Wayland).
2841
2842              GLOBAL_COLOR_SCHEME Overrides all other color schemes.
2843
2844              IRC_COLOR_SCHEME Desktop X/Wayland IRC CLI color scheme.
2845
2846              IRC_CONS_COLOR_SCHEME Out of X/Wayland, IRC CLI color scheme.
2847
2848              IRC_X_TERM_COLOR_SCHEME  In  X/Wayland IRC client terminal color
2849              scheme.
2850
2851              VIRT_TERM_COLOR_SCHEME Color scheme for virtual terminal  output
2852              (in X/Wayland).
2853
2854
2855       Developer Options
2856              These are useful only for developers.
2857
2858              FAKE_DATA_DIR - change default fake data directory location. See
2859              --fake-data-dir.
2860
2861

BUGS

2863       Please report bugs using the following resources.
2864
2865       You may be asked to run the inxi debugger  tool  (see  --debug  21/22),
2866       which  will  upload  a  data  dump of system files for use in debugging
2867       inxi. These data dumps are very important since they  provide  us  with
2868       all the real system data inxi uses to parse out its report.
2869
2870       Issue Report
2871              File an issue report: https://github.com/smxi/inxi/issues
2872
2873       Forums Post   on   inxi   forums:   https://techpatterns.com/forums/fo
2874              rum-33.html
2875
2876       IRC irc.oftc.net / irc.libera.chat
2877              You can also visit channel: #smxi to post issues on either  net‐
2878              work.
2879
2880

HOMEPAGE

2882       https://github.com/smxi/inxi  -  Home of the source code, and tech docs
2883       (inxi-perl/docs).
2884
2885       https://smxi.org/docs/inxi.htm  -  The  main   docs   for   inxi.   See
2886       inxi-perl/docs for more technical docs.
2887
2888       https://fosstodon.org/@smxi - Follow @smxi on Mastodon!
2889
2890

AUTHOR AND CONTRIBUTORS TO CODE

2892       inxi is a fork of locsmif's very clever infobash script.
2893
2894       Original  infobash author and copyright holder: Copyright (C) 2005-2007
2895       Michiel de Boer aka locsmif
2896
2897       inxi version: Copyright (C) 2008-2021 Harald Hope
2898
2899       This man page was originally created by Gordon Spencer (aka  aus9)  and
2900       is maintained by Harald Hope (aka h2 or TechAdmin).
2901
2902       Initial  CPU  logic, konversation version logic, occasional maintenance
2903       fixes, and the initial xiin.py tool for  /sys  parsing  (obsolete,  but
2904       still  very  much  appreciated  for  all  the valuable debugger data it
2905       helped generate): Scott Rogers
2906
2907       Further fixes (listed as known):
2908
2909       Horst Tritremmel <hjt at sidux.com>
2910
2911       Steven Barrett (aka: damentz) - USB  audio  patch;  swap  percent  used
2912       patch.
2913
2914       Jarett.Stevens - dmidecode -M patch for older systems with no /sys.
2915
2916

SPECIAL THANKS TO THE FOLLOWING

2918       The nice people at irc.oftc.net channels #linux-smokers-club and #smxi,
2919       who all really have to be considered to  be  co-developers  because  of
2920       their  non-stop enthusiasm and willingness to provide real-time testing
2921       and debugging of inxi development over the years.
2922
2923       LinuxQuestions.org Slackware forum members, for major help with  devel‐
2924       opment  and  debugging new or refactored features, particularly the re‐
2925       done CPU logic of 2021-12.
2926
2927       Siduction forum members, who have helped get some features  working  by
2928       providing a large number of datasets that have revealed possible varia‐
2929       tions, particularly for the RAM -m option.
2930
2931       AntiX users and admins, who have helped greatly with testing and debug‐
2932       ging, particularly for the 3.0.0 release.
2933
2934       ArcherSeven  (Max), Brett Bohnenkamper (aka KittyKatt), and Iotaka, who
2935       always manage to find the weirdest or most extreme hardware and  setups
2936       that help make inxi much more robust.
2937
2938       For  the  vastly underrated skill of output error/glitch catching, Pete
2939       Haddow.  His patience and focus in going  through  inxi  repeatedly  to
2940       find errors and inconsistencies is much appreciated.
2941
2942       For  a huge boost to BSD support, Stan Vandiver, who did a lot of test‐
2943       ing and setup many remote access systems for testing and development.
2944
2945       For testing, bug finding, suggestions, feature  requests,  MrMazda.  He
2946       has over the years has helped shape inxi into what it is today, in par‐
2947       ticular but not limited to, the Graphics features.
2948
2949       All the inxi package maintainers, distro support people, forum  modera‐
2950       tors, and in particular, sys admins with their particular issues, which
2951       almost always help make inxi better,  and  any  others  who  contribute
2952       ideas, suggestions, and patches.
2953
2954       Without a wide range of diverse Linux kernel-based Free Desktop systems
2955       to test on, we could never have gotten inxi to be as reliable and solid
2956       as it's turning out to be.
2957
2958       And  of  course,  a big thanks to locsmif, who figured out a lot of the
2959       core ideas, logic, and tricks originally used in inxi Gawk/Bash.
2960
2961
2962
2963
2964inxi                              2022-11-02                           INXI(1)
Impressum