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]  [--gpu]  [--memory-modules]  [--memory-short] [--recom‐
19       mends] [--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  Show  advanced gpu data. Triggers -G and -a as well. Expands ex‐
306              isting non-free: driver (Linux and Nvidia only), and  arch:  re‐
307              ports (AMD/Intel/Nvidia). Useful to help diagnose driver support
308              issues, shows extra data  that  can  help  diagnose/debug.  Adds
309              code: item if found and not the same as arch:.
310              inxi --gpu -y1
311              Graphics:
312                Device-1: NVIDIA NV34 [GeForce FX 5200]
313                  driver: nouveau
314                    v: kernel
315                    non-free:
316                      series: 173.14.xx
317                      status: legacy (EOL)
318                      last:
319                        kernel: 3.12
320                        xorg: 1.15
321                        release: 173.14.39
322                  arch: Rankine
323                    code: NV3x
324                    process: 130-150nm
325                    built: 2003-05
326                  ports:
327                    active: VGA-1
328                    empty: DVI-I-1,TV-1
329                  bus-ID: 01:00.0
330                  chip-ID: 10de:0322
331                  class-ID: 0300
332
333
334       -G , --graphics
335              Show  Graphic device(s) information, including details of device
336              and display drivers (X: loaded:, and, if applicable:  unloaded:,
337              failed:,  and  active gpu: drivers), display protocol (if avail‐
338              able), display server (and/or Wayland  compositor),  vendor  and
339              version number, e.g.:
340
341              Display: x11 server: Xorg v: 1.15.1
342
343              or
344
345              Display: wayland server: X.org v: 1.20.1 with: Xwayland v: 20.1
346
347              If protocol is not detected, shows:
348
349              Display: server: Xorg 1.15.1
350
351              Also  shows  screen  resolution(s)  (per  monitor/X screen). For
352              X.org: OpenGL renderer, OpenGL core profile version/OpenGL  ver‐
353              sion;  for  VESA:  data  (for Xvesa); for Wayland:  GBM/EGL data
354              (not implemented).
355
356              Compositor information will show if detected using -xx option or
357              always  if  detected  and  Wayland  since  the compositor is the
358              server with Wayland.
359
360              -Gxx shows monitor data as well, if detected. --edid  shows  ad‐
361              vanced monitor data (full modes, chroma, etc.).
362
363
364       -h , --help
365              The help menu. Features dynamic sizing to fit into terminal win‐
366              dow. Set script global COLS_MAX_CONSOLE if you want a  different
367              default value, or use -y <width> to temporarily override the de‐
368              faults or actual window width.
369
370
371       -i , --ip
372              Show WAN IP address and local interfaces (latter requires ifcon‐
373              fig  or ip network tool), as well as network output from -n. Not
374              shown with -F for user security  reasons.  You  shouldn't  paste
375              your local/WAN IP.  Shows both IPv4 and IPv6 link IP addresses.
376
377
378       -I , --info
379              Show  Information:  processes,  uptime,  memory,  IRC client (or
380              shell type if run in shell, not IRC),  inxi  version.  See  -Ix,
381              -Ixx,  and  -Ia  for  extra information (init type/version, run‐
382              level/target, packages).
383
384              Note: if -m is used or triggered, the memory item will  show  in
385              the main Memory: report of -m, not in Info:.
386
387              Raspberry  Pi  only:  uses  vcgencmd  get_mem gpu to get gpu RAM
388              amount, if user is in video group  and  vcgencmd  is  installed.
389              Uses  this  result  to  increase  the  Memory:  amount and used:
390              amounts.
391
392
393       -j, --swap
394              Shows all active swap types (partition, file, zram).  When  this
395              option  is  used, swap partition(s) will not show on the -P line
396              to avoid redundancy.
397
398              To show partition labels or UUIDs (when available and relevant),
399              use with -l or -u.
400
401
402       -J , --usb
403              Show USB data for attached Hubs and Devices. Hubs also show num‐
404              ber of ports. Be aware that a port is not always external,  some
405              may be internal, and either used or unused (for example, a moth‐
406              erboard USB header connector that is not used).
407
408              Hubs and Devices are listed in order of BusID.
409
410              BusID is generally in this format:  BusID-port[.port][.port]:De‐
411              viceID
412
413              Device  ID  is a number created by the kernel, and has no neces‐
414              sary ordering or sequence connection, but can be used  to  match
415              this output to lsusb values, which generally shows BusID / Devi‐
416              ceID (except for tree view, which shows ports).
417
418              Examples: Device-3: 4-3.2.1:2 or Hub: 4-0:1
419
420              The rev: 2.0 item refers to the USB revision number, like 1.0 or
421              3.1.
422
423
424       -l , --label
425              Show  partition labels. Use with -j, -o, -p, and -P to show par‐
426              tition labels. Does nothing without one of those options.
427
428              Sample: -ojpl.
429
430
431       -L, --logical
432              Show Logical volume information, for  LVM,  LUKS,  bcache,  etc.
433              Shows size, free space (for LVM VG). For LVM, shows Device-[xx]:
434              VG: (Volume Group) size/free, LV-[xx] (Logical Volume). LV shows
435              type, size, and components.  Note that components are made up of
436              either containers (aka, logical devices), or  physical  devices.
437              The full report requires doas/sudo/root.
438
439              Logical block devices can be thought of as devices that are made
440              up out of either other logical  devices,  or  physical  devices.
441              inxi  does its best to show what each logical device is made out
442              of. RAID devices form a subset of all possible Logical  devices,
443              but have their own section, -R.
444
445              If -R is used with -Lxx, -Lxx will not show RAID information for
446              LVM RAID devices since it's redundant. If -R is not used, a sim‐
447              ple RAID line will appear for LVM RAID in -Lxx.
448
449              -Lxx also shows all components and devices. Note that since com‐
450              ponents can go in many levels, each level per primary  component
451              is  indicated  by either another 'c', or ends with a 'p' device,
452              the physical device. The number of  c's  or  p's  indicates  the
453              depth, so you can see which component belongs to which.
454
455              -L  shows  only the top level components/devices (like -R).  -La
456              shows component/device size, maj:min ID, mapped name (if  appli‐
457              cable), and puts each component/device on its own line.
458
459              Sample:
460
461                Device-10: mybackup type: LUKS dm: dm-28 size: 6.36 GiB Components:
462                  c-1: md1 cc-1: dm-26 ppp-1: sdj2 cc-2: dm-27 ppp-1: sdk2
463                LV-5: lvm_raid1 type: raid1 dm: dm-16 size: 4.88 GiB
464                  RAID: stripes: 2 sync: idle copied: 100% mismatches: 0
465                Components: c-1: dm-10 pp-1: sdd1 c-2: dm-11 pp-1: sdd1 c-3: dm-13
466                  pp-1: sde1 c-4: dm-15 pp-1: sde1
467
468              It  is easier to follow the flow of components and devices using
469              -y1. In this example, there is one primary component (c-1), md1,
470              which  is  made  up of two components (cc-1,2), dm-26 and dm-27.
471              These are respectively made from physical devices (p-1) sdj2 and
472              sdk2.
473
474              Device-10: mybackup
475                maj-min: 254:28
476                type: LUKS
477                dm: dm-28
478                size: 6.36 GiB
479                Components:
480                  c-1: md1
481                  maj-min: 9:1
482                  size: 6.37 GiB
483                  cc-1: dm-26
484                    maj-min: 254:26
485                    mapped: vg5-level1a
486                    size: 12.28 GiB
487                    ppp-1: sdj2
488                      maj-min: 8:146
489                      size: 12.79 GiB
490                  cc-2: dm-27
491                    maj-min: 254:27
492                    mapped: vg5-level1b
493                    size: 6.38 GiB
494                    ppp-1: sdk2
495                      maj-min: 8:162
496                      size: 12.79 GiB
497
498              Other types of logical block handling like LUKS, bcache show as:
499
500              Device-[xx] [name/id] type: [LUKS|Crypto|bcache]:
501
502
503       -m , --memory
504              Memory (RAM) data. Does not display with -b or -F unless you use
505              -m explicitly. Ordered by system board  physical  system  memory
506              array(s)  (Array-[number]),  and  individual memory devices (De‐
507              vice-[number]).  Physical memory array data shows  array  capac‐
508              ity,  number of devices supported, and Error Correction informa‐
509              tion. Devices shows locator data (highly  variable  in  syntax),
510              type (eg: type: DDR3)size, speed.
511
512              Note:  -m  uses  dmidecode,  which must be run as root (or start
513              inxi with doas/sudo), unless  you  figure  out  how  to  set  up
514              doas/sudo  to  permit  dmidecode to read /dev/mem as user. speed
515              and bus-width will not show if No Module Installed is  found  in
516              size.
517
518              Note:  If  -m  is triggered RAM total/used report will appear in
519              this section, not in -I or -tm items.
520
521              Because dmidecode data is extremely unreliable, inxi will try to
522              make best guesses. If you see (check) after the capacity number,
523              you should check it with the specifications. (est)  is  slightly
524              more  reliable,  but  you should still check the real specifica‐
525              tions before buying RAM. Unfortunately there is nothing inxi can
526              do  to  get  truly reliable data about the system RAM; maybe one
527              day the kernel devs will put this data into /sys,  and  make  it
528              real  data, taken from the actual system, not dmi data. For most
529              people, the data will be right, but a significant percentage  of
530              users  will  have either a wrong max module size, if present, or
531              max capacity.
532
533              Under dmidecode, Speed: is the  expected  speed  of  the  memory
534              (what  is  advertised  on  the memory spec sheet) and Configured
535              Clock Speed: is what the actual speed is now. To handle this, if
536              speed  and  configured  speed values are different, you will see
537              this instead:
538
539              speed: spec: [specified speed] MT/S actual: [actual] MT/S
540
541              Also, if DDR, and speed in MHz, will change to:  speed:  [speed]
542              MT/S ([speed] MHz)
543
544              If  the detected speed is logically absurd, like 1 MT/s or 69910
545              MT/s, adds: note: check. Sample:
546
547              Memory:
548                RAM: total: 31.38 GiB used: 20.65 GiB (65.8%)
549                Array-1: capacity: N/A slots: 4 note: check EC: N/A
550                Device-1: DIMM_A1 type: DDR3 size: 8 GiB speed: 1600 MT/s (800 MHz)
551                Device-2: DIMM_A2 type: DDR3 size: 8 GiB speed: spec: 1600 MT/s (800 MHz)
552                  actual: 61910 MT/s (30955 MHz) note: check
553                Device-3: DIMM_B1 type: DDR3 size: 8 GiB speed: 1600 MT/s (800 MHz)
554                Device-4: DIMM_B2 type: DDR3 size: 8 GiB speed: spec: 1600 MT/s (800 MHz)
555                  actual: 2 MT/s (1 MHz) note: check
556
557              See --memory-modules and --memory-short if you  want  a  shorter
558              report.
559
560
561       --memory-modules, --mm
562              Memory  (RAM)  data.  Show only RAM arrays and modules in Memory
563              report.  Skip empty slots. See -m.
564
565
566       --memory-short, --ms
567              Memory (RAM) data. Show a one line RAM report in Memory. See -m.
568
569              Sample: Report: arrays: 1 slots: 4 modules: 2 type: DDR4
570
571
572       -M , --machine
573              Show machine data. Device, Motherboard, BIOS,  and  if  present,
574              System  Builder (Like Lenovo). Older systems/kernels without the
575              required /sys data can use dmidecode instead, run  as  root.  If
576              using  dmidecode,  may  also  show BIOS/UEFI revision as well as
577              version. --dmidecode forces use of  dmidecode  data  instead  of
578              /sys.  Will  also  attempt  to  show if the system was booted by
579              BIOS, UEFI, or UEFI [Legacy], the latter being legacy BIOS  boot
580              mode in a system board using UEFI.
581
582              Device  information requires either /sys or dmidecode. Note that
583              other-vm? is a type that means  it's  usually  a  VM,  but  inxi
584              failed  to  detect which type, or positively confirm which VM it
585              is. Primary VM identification  is  via  systemd-detect-virt  but
586              fallback tests that should also support some BSDs are used. Less
587              commonly used or harder to detect VMs may not be  correctly  de‐
588              tected.  If you get an incorrect output, post an issue and we'll
589              get it fixed if possible.
590
591              Due to unreliable vendor data, device type will  show:  desktop,
592              laptop,  notebook,  server,  blade, plus some obscure stuff that
593              inxi is unlikely to ever run on.
594
595
596       -n , --network-advanced
597              Show Advanced Network device information  in  addition  to  that
598              produced by -N. Shows interface, speed, MAC ID, state, etc.
599
600
601       -N , --network
602              Show  Network  device(s)  information,  including device driver.
603              With -x, shows Bus ID, Port number.
604
605
606       --nvidia, --nv
607              See --gpu.
608
609
610       -o , --unmounted
611              Show unmounted partition information (includes UUID and LABEL if
612              available).   Shows file system type if you have lsblk installed
613              (Linux only). For BSD/GNU Linux: shows file system type if  file
614              is  installed,  and  if  you  are  root  or if you have added to
615              /etc/sudoers (sudo v. 1.7 or newer):
616
617              <username> ALL = NOPASSWD: /usr/bin/file (sample)
618
619              doas users: see man doas.conf for setup.
620
621              Does not show components (partitions that create the md-raid ar‐
622              ray) of md-raid arrays.
623
624              To show partition labels or UUIDs (when available and relevant),
625              use with -l or -u.
626
627
628       -p , --partitions-full
629              Show full Partition information  (-P  plus  all  other  detected
630              mounted partitions).
631
632              To show partition labels or UUIDs (when available and relevant),
633              use with -l or -u.
634
635
636       -P , --partitions
637              Show basic Partition information.  Shows, if detected:  /  /boot
638              /boot/efi  /home /opt /tmp /usr /usr/home /var /var/tmp /var/log
639              (for android, shows /cache /data /firmware /system).  If  --swap
640              is  not  used, shows active swap partitions (never shows file or
641              zram type swap). Use -p to see all mounted partitions.
642
643              To show partition labels or UUIDs (when available and relevant),
644              use with -l or -u.
645
646
647       --processes
648              See -t.
649
650
651       -r , --repos
652              Show distro repository data. Currently supported repo types:
653
654              APK (Alpine Linux + derived versions)
655
656              APT (Debian, Ubuntu + derived versions, as well as RPM based APT
657              distros like PCLinuxOS or Alt-Linux)
658
659              CARDS (NuTyX + derived versions)
660
661              EOPKG (Solus)
662
663              NIX (NixOS + other distros as alternate package manager)
664
665              PACMAN (Arch Linux, KaOS + derived versions)
666
667              PACMAN-G2 (Frugalware + derived versions)
668
669              PISI (Pardus + derived versions)
670
671              PKG (OpenBSD, FreeBSD, NetBSD + derived OS types)
672
673              PORTAGE (Gentoo, Sabayon + derived versions)
674
675              PORTS (OpenBSD, FreeBSD, NetBSD + derived OS types)
676
677              SCRATCHPKG (Venom + derived versions)
678
679              SLACKPKG (Slackware + derived versions)
680
681              TCE (TinyCore)
682
683              URPMI (Mandriva, Mageia + derived versions)
684
685              XBPS (Void)
686
687              YUM/ZYPP (Fedora, Red Hat, Suse + derived versions)
688
689              More will be added as distro data  is  collected.  If  yours  is
690              missing please show us how to get this information and we'll try
691              to add it.
692
693              See -rx, -rxx, and -ra for installed package count information.
694
695
696       -R , --raid
697              Show RAID data. Shows RAID devices, states, levels, device/array
698              size, and components. See extra data with -x / -xx.
699
700              md-raid:  If  device  is  resyncing,  also shows resync progress
701              line.
702
703              Note: supported types: lvm raid,  md-raid,  softraid,  ZFS,  and
704              hardware  RAID.   Other software RAID types may be added, if the
705              software RAID can be made to give the required output.
706
707              The component ID numbers work like this: mdraid:  the  numerator
708              is the actual mdraid component number; lvm/softraid/ZFS: the nu‐
709              merator is auto-incremented counter only. Eg. Online: 1: sdb1
710
711              If hardware RAID is detected, shows basic  information.  Due  to
712              complexity  of  adding hardware RAID device disk / RAID reports,
713              those will only be added if there is demand, and reasonable  re‐
714              porting tools.
715
716
717       --recommends
718              Checks  inxi application dependencies and recommends, as well as
719              directories, then shows what package(s) you need to  install  to
720              add support for each feature.
721
722
723       -s , --sensors
724              Show  output from sensors if sensors installed/configured: Moth‐
725              erboard/CPU/GPU temperatures; detected fan speeds. GPU  tempera‐
726              ture  when  available.  Nvidia  shows screen number for multiple
727              screens. IPMI sensors are also used (root required) if  present.
728              See  Advanced  options --sensors-use or --sensors-exclude if you
729              want to use only a subset of all sensors, or exclude one.
730
731       --slots
732              Show PCI slots with type, speed, and status information.
733
734
735       --swap
736              See -j
737
738
739       -S , --system
740              Show System information: host name, kernel, desktop  environment
741              (if in X), distro. With -xx show dm - or startx - (only shows if
742              present and running if out of X), and if in X,  with  -xxx  show
743              more desktop info, e.g. taskbar or panel.
744
745
746       -t , --processes
747              [c|m|cm|mc  NUMBER] Show processes. If no arguments, defaults to
748              cm. If followed by a number, shows that number of processes  for
749              each type (default: 5; if in IRC, max: 5)
750
751              Make  sure  that  there  is no space between letters and numbers
752              (e.g. write as -t cm10).
753
754
755       -t c   - CPU only. With -x, also shows memory for that process on  same
756              line.
757
758
759       -t m   -  memory only. With -x, also shows CPU for that process on same
760              line.  If the -I or -m lines are not triggered, will  also  show
761              the system RAM used/total information.
762
763
764       -t cm  - CPU+memory. With -x, shows also CPU or memory for that process
765              on same line.
766
767
768       -u , --uuid
769              Show partition UUIDs. Use with -j, -o, -p, and -P to show parti‐
770              tion labels. Does nothing without one of those options.
771
772              Sample: -opju.
773
774
775       -U , --update
776              Note - Maintainer may have disabled this function.
777
778              If inxi -h has no listing for -U then it's disabled.
779
780              Auto-update  script. Note: if you installed as root, you must be
781              root to update, otherwise user is fine. Also installs /  updates
782              this   man   page  to:  /usr/local/share/man/man1  (if  /usr/lo‐
783              cal/share/man/  exists  AND  there  is  no  inxi  man  page   in
784              /usr/share/man/man1,  otherwise it goes to /usr/share/man/man1).
785              This requires that you be root to write to that  directory.  See
786              --man or --no-man to force or disable man install.
787
788
789       --usb
790              See -J.
791
792
793       -V, --version
794              inxi  full  version  and license information. Prints information
795              then exits.
796
797
798       --version-short, --vs
799              inxi single line version information. Prints information if  not
800              short form (which shows version info already). Does not exit un‐
801              less used without any other options. Can  be  used  with  normal
802              line options.
803
804
805       -v , --verbosity
806              Script  verbosity levels. If no verbosity level number is given,
807              0 is assumed.  Should not be used with -b or -F.
808
809              Supported levels: 0-8 Examples : inxi -v 4  or  inxi -v4
810
811
812       -v 0   - Short output, same as: inxi
813
814
815       -v 1   - Basic verbose, -S + basic  CPU  (cores,  type,  average  clock
816              speed, and min/max speeds, if available) + -G + basic Disk + -I.
817
818
819       -v 2   -  Adds  networking device (-N), Machine (-M) data, Battery (-B)
820              (if available). Same as: inxi -b
821
822
823       -v 3   - Adds advanced CPU (-C) and network (-n) data; triggers -x  ad‐
824              vanced data option.
825
826
827       -v 4   -  Adds  partition size/used data (-P) for (if present): / /home
828              /var/ /boot. Shows full disk data (-D)
829
830
831       -v 5   - Adds audio device (-A), memory/RAM (-m), bluetooth  data  (-E)
832              (if  present),  sensors  (-s), RAID data (if present), partition
833              label (-l), UUID (-u), full swap data (-j), and  short  form  of
834              optical drives.
835
836
837       -v 6   -  Adds  full  mounted  partition data (-p), unmounted partition
838              data (-o), optical drive data (-d), USB (-J); triggers -xx extra
839              data option.
840
841
842       -v 7   -  Adds  network  IP  data  (-i), forced bluetooth (-E), Logical
843              (-L), RAID (-R), full CPU flags/features (-f),  triggers -xxx
844
845
846       -v 8   - All system data available. Adds extra gpu  data  (--gpu),  ad‐
847              vanced EDID data (--edid), Repos (-r), PCI slots (--slots), pro‐
848              cesses (-tcm), admin (--admin). Useful for testing output and to
849              see what data you can get from your system.
850
851
852       -w , --weather
853              Adds weather line. To get weather for an alternate location, use
854              -W [location]. See also -x, -xx, -xxx options. Please note  that
855              your  distribution's  maintainer  may chose to disable this fea‐
856              ture.
857
858              DO NOT USE THIS FEATURE FOR AUTOMATED WEATHER UPDATES! Automated
859              or  excessive  use will lead to your being blocked from any fur‐
860              ther access. This feature is not meant for widget  type  weather
861              monitoring,  or  Conky type use. It is meant to get weather when
862              you need to see it, for example, on a remote server. If you  did
863              not  type  the weather option in manually, it's an automated re‐
864              quest.
865
866
867       -W, --weather-location <location_string>
868              Get weather/time for an alternate location.  Accepts  postal/zip
869              code[,  country],  city,state pair, or latitude,longitude. Note:
870              city/country/state names must not contain spaces. Replace spaces
871              with '+' sign. Don't place spaces around any commas. Postal code
872              is not reliable except for North America and maybe the  UK.  Try
873              postal  codes  with  and  without  country code added. Note that
874              City,State applies only to USA, otherwise it's City,Country.  If
875              country  name  (english)  does not work, try 2 character country
876              code (e.g. Spain: es; Great Britain: gb).
877
878              See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 for current
879              2 letter country codes.
880
881              Use only ASCII letters in city/state/country names.
882
883              Examples: -W 95623,us OR -W Boston,MA OR -W 45.5234,-122.6762 OR
884              -W new+york,ny OR -W bodo,norway.
885
886              DO NOT USE THIS FEATURE FOR AUTOMATED WEATHER UPDATES! Automated
887              or  excessive  use will lead to your being blocked from any fur‐
888              ther access. This feature is not meant for widget  type  weather
889              monitoring,  or  Conky type use. It is meant to get weather when
890              you need to see it, for example, on a remote server. If you  did
891              not  type  the weather option in manually, it's an automated re‐
892              quest.
893
894
895       --weather-source, --ws <unit>
896              [1-9] Switches weather data source.  Possible  values  are  1-9.
897              1-4  will generally be active, and 5-9 may or may not be active,
898              so check. 1 may not support city /  country  names  with  spaces
899              (even  if  you use the + sign instead of space). 2 offers pretty
900              good data, but may not have all small city names for -W.
901
902              Please note that the data sources are not static per value,  and
903              can  change  any  time,  or be removed, so always test to verify
904              which source is being used for each value if that  is  important
905              to  you.  Data  sources may be added or removed on occasions, so
906              try each one and see which you prefer. If  you  get  unsupported
907              source message, it means that number has not been implemented.
908
909
910       --weather-unit <unit>
911              [m|i|mi|im] Sets weather units to metric (m), imperial (i), met‐
912              ric (imperial) (mi, default), imperial (metric) (im). If  metric
913              or imperial not found,sets to default value, or N/A.
914
915

FILTER OPTIONS

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

OUTPUT CONTROL OPTIONS

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

EXTRA DATA OPTIONS

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

ADMIN EXTRA DATA OPTIONS

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

ADVANCED OPTIONS

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

DEBUGGING OPTIONS

2487       --dbg {[1-x][,[1-x]]}
2488              Accepts  one or more comma separated dbg specific debugging num‐
2489              bers.
2490
2491              1 - Debug downloader failures. Turns off silent/quiet  mode  for
2492              curl, wget, and fetch. Shows more downloader action information.
2493              Shows some more information for Perl downloader.
2494
2495              1-xx - See github  inxi-perl/docs/inxi-values.txt  for  specific
2496              specialized debugging options. There are a lot.
2497
2498
2499       --debug [1-3]
2500              - On screen debugger output.
2501
2502
2503       --debug 10
2504              -   Basic   logging.   Check   $XDG_DATA_HOME/inxi/inxi.log   or
2505              $HOME/.local/share/inxi/inxi.log or $HOME/.inxi/inxi.log.
2506
2507
2508       --debug 11
2509              - Full file/system info logging.
2510
2511
2512       --debug 20
2513              Creates a tar.gz file of system data and collects the inxi  out‐
2514              put in a file.
2515
2516              *  tree  traversal  data  file(s)  read from /proc and /sys, and
2517              other system data.
2518
2519              * xorg conf and log data, xrandr, xprop, xdpyinfo, glxinfo etc.
2520
2521              * data from dev, disks, partitions, etc.
2522
2523
2524       --debug 21
2525              Automatically uploads debugger data tar.gz file to ftp.smxi.org,
2526              then  removes  the  debug  data  directory, but leaves the debug
2527              tar.gz file.  See --ftp for uploading to alternate locations.
2528
2529
2530       --debug 22
2531              Automatically uploads debugger data tar.gz file to ftp.smxi.org,
2532              then  removes the debug data directory and the tar.gz file.  See
2533              --ftp for uploading to alternate locations.
2534
2535
2536       --fake-data-dir
2537              Developer only: Change default location of $fake_data_dir, which
2538              is where files are for --fake {item} items.
2539
2540
2541       --ftp [ftp.yoursite.com/incoming]
2542              For alternate ftp upload locations: Example:
2543
2544              inxi --ftp ftp.yourserver.com/incoming --debug 21
2545
2546

DEBUGGING OPTIONS TO DEBUG DEBUGGER FAILURES

2548       Only use the following in conjunction with --debug 2[012], and only use
2549       if you experienced a failure or hang, or were instructed to do so.
2550
2551
2552       --debug-proc
2553              Force debugger to parse /proc directory data when run  as  root.
2554              Normally  this  is  disabled  due to unpredictable data in /proc
2555              tree.
2556
2557
2558       --debug-proc-print
2559              Use this to locate file that /proc debugger hangs on.
2560
2561
2562       --debug-no-exit
2563              Skip exit on error when running debugger.
2564
2565
2566       --debug-no-proc
2567              Skip /proc debugging in case of a hang.
2568
2569
2570       --debug-no-sys
2571              Skip /sys debugging in case of a hang.
2572
2573
2574       --debug-sys
2575              Force PowerPC debugger parsing of /sys as doas/sudo/root.
2576
2577
2578       --debug-sys-print
2579              Use this to locate file that /sys debugger hangs on.
2580
2581

SUPPORTED IRC CLIENTS

2583       BitchX, Gaim/Pidgin, ircII, Irssi, Konversation, Kopete, KSirc,  KVIrc,
2584       Weechat,  and Xchat. Plus any others that are capable of displaying ei‐
2585       ther built-in or external script output.
2586
2587

RUNNING IN IRC CLIENT

2589       To trigger inxi output in your IRC client, pick the appropriate  method
2590       from the list below:
2591
2592       Hexchat, XChat, Irssi
2593              (and  many  other  IRC  clients)  /exec -o inxi [options] If you
2594              don't include the -o, only you will see the output on your local
2595              IRC client.
2596
2597       Konversation
2598              /cmd inxi [options]
2599
2600              To run inxi in Konversation as a native script if your distribu‐
2601              tion or inxi package hasn't already done this  for  you,  create
2602              this symbolic link:
2603
2604              KDE  4: ln -s /usr/local/bin/inxi /usr/share/kde4/apps/konversa‐
2605              tion/scripts/inxi
2606
2607              KDE   5:   ln   -s   /usr/local/bin/inxi    /usr/share/konversa‐
2608              tion/scripts/inxi
2609
2610              If  inxi  is  somewhere  else, change the path /usr/local/bin to
2611              wherever it is located.
2612
2613              If you are using KDE/QT 5, then you may also  need  to  add  the
2614              following to get the Konversation /inxi command to work:
2615
2616              ln -s /usr/share/konversation /usr/share/apps/
2617
2618              Then you can start inxi directly, like this:
2619
2620              /inxi [options]
2621
2622       WeeChat
2623              NEW: /exec -o inxi [options]
2624
2625              OLD: /shell -o inxi [options]
2626
2627              Newer (2014 and later) WeeChats work pretty much the same now as
2628              other console IRC clients, with /exec -o inxi  [options].  Newer
2629              WeeChats  have  dropped  the -curses part of their program name,
2630              i.e.: weechat instead of weechat-curses.
2631
2632

CONFIGURATION FILE

2634       inxi will read its configuration/initialization files in the  following
2635       order:
2636
2637       /etc/inxi.conf  contains the default configurations. These can be over‐
2638       ridden by creating a /etc/inxi.d/inxi.conf file (global override, which
2639       will  prevent  distro packages from changing or overwriting your edits.
2640       This method is recommended if you are using a distro packaged inxi  and
2641       want  to  override  some configuration items from the package's default
2642       /etc/inxi.conf file but don't want to lose your changes  on  a  package
2643       update.
2644
2645       You can old override, per user, with a user configuration file found in
2646       one of the following locations (inxi will store its config  file  using
2647       the following precedence:
2648
2649       if   $XDG_CONFIG_HOME   is  not  empty,  it  will  go  there,  else  if
2650       $HOME/.conf/inxi.conf exists, it will go there, and as a last  default,
2651       the legacy location is used), i.e.:
2652
2653       $XDG_CONFIG_HOME/inxi.conf        >       $HOME/.conf/inxi.conf       >
2654       $HOME/.inxi/inxi.conf
2655
2656

CONFIGURATION OPTIONS

2658       See the documentation page for more complete information on how to  set
2659       these up, and for a complete list of options:
2660
2661       https://smxi.org/docs/inxi-configuration.htm
2662
2663       Basic Options
2664              Here's  a  brief overview of the basic options you are likely to
2665              want to use:
2666
2667              COLS_MAX_CONSOLE The max display column width  on  terminal.  If
2668              terminal/console width or --width is less than wrap width, wrap‐
2669              ping of line starter occurs
2670
2671              COLS_MAX_IRC The max display column width on IRC clients.
2672
2673              COLS_MAX_NO_DISPLAY The max display column width in out of  X  /
2674              Wayland / desktop / window manager.
2675
2676              CPU_SLEEP  Decimal  value  0  or more. Default is usually around
2677              0.35 seconds. Time that inxi will  'sleep'  before  getting  CPU
2678              speed data, so that it reflects actual system state.
2679
2680              DOWNLOADER Sets default inxi downloader: curl, fetch, ftp, perl,
2681              wget.  See --recommends output for more information on download‐
2682              ers and Perl downloaders.
2683
2684              FILTER_STRING Default <filter>. Any string you prefer to see in‐
2685              stead for filtered values.
2686
2687              INDENT Change primary indent width  of  wide  mode  output.  See
2688              --indent.
2689
2690              INDENTS  Change  primary  indents of narrow wrapped mode output,
2691              and second level indents. See --indents.
2692
2693              LIMIT Overrides default of 10 IP addresses per IF. This is  only
2694              of  interest  to  sys  admins  running  servers with many IP ad‐
2695              dresses.
2696
2697              LINES_MAX Values: [-2-xxx]. See -Y for explanation  and  values.
2698              Use -Y -3 to restore default unlimited output lines. Avoid using
2699              this in general unless the machine is a headless system and  you
2700              want the output to be always controlled.
2701
2702              MAX_WRAP  (or WRAP_MAX) The maximum width where the line starter
2703              wraps to its own line. If terminal/console width or  --width  is
2704              less than wrap width, wrapping of line starter occurs. Overrides
2705              default. See --max-wrap. If 80 or less, wrap will never happen.
2706
2707              NO_DIG Set to 1 or true to disable WAN IP use of dig  and  force
2708              use of alternate downloaders.
2709
2710              NO_DOAS Set to 1 or true to disable internal use of doas.
2711
2712              NO_HTML_WAN Set to 1 or true to disable WAN IP use of HTML Down‐
2713              loaders and force use of dig only, or nothing if dig disabled as
2714              well.  Same  as  --no-html-wan.  Only use if dig is failing, and
2715              HTML downloaders are hanging.
2716
2717              NO_SUDO Set to 1 or true to disable internal use of sudo.
2718
2719              PARTITION_SORT Overrides  default  partition  output  sort.  See
2720              --partition-sort for options.
2721
2722              PS_COUNT  The  default number of items showing per -t type, m or
2723              c. Default is 5.
2724
2725              SENSORS_CPU_NO In cases of  ambiguous  temp1/temp2  (inxi  can't
2726              figure out which is the CPU), forces sensors to use either value
2727              1 or 2 as CPU temperature. See the above configuration  page  on
2728              smxi.org for full info.
2729
2730              SENSORS_EXCLUDE  Exclude  supplied  sensor  array[s] from sensor
2731              output.  Override with --sensors-default. See --sensors-exclude.
2732
2733              SENSORS_USE Use only supplied  sensor  array[s].  Override  with
2734              --sensors-default. See --sensors-use.
2735
2736              SEP2_CONSOLE Replaces default key / value separator of ':'.
2737
2738              USB_SYS Forces all USB data to use /sys instead of lsusb.
2739
2740              WAN_IP_URL  Forces  -i  to  use supplied URL, and to not use dig
2741              (dig is generally much faster). URL must begin with http or ftp.
2742              Note  that  if  you  use this, the downloader set tests will run
2743              each time you start inxi whether a downloader feature  is  going
2744              to be used or not.
2745
2746              The  IP  address  from the URL must be the last item on the last
2747              (non-empty) line of the URL's page content source code.
2748
2749              Same as --wan-ip-url [URL]
2750
2751              WEATHER_SOURCE Values: [0-9]. Same as --weather-source.   Values
2752              4-9  are  not  currently  supported,  but this can change at any
2753              time.
2754
2755              WEATHER_UNIT Values: [m|i|mi|im]. Same as --weather-unit.
2756
2757
2758       Color Options
2759              It's best to use the -c [94-99] color selector tool to  set  the
2760              following values because it will correctly update the configura‐
2761              tion file and remove any invalid or conflicting  items,  but  if
2762              you  prefer to create your own configuration files, here are the
2763              options. All take the integer value from the  options  available
2764              in -c 94-99.
2765
2766              NOTE:  All  default  and configuration file set color values are
2767              removed when output is piped or redirected. You must use the ex‐
2768              plicit -c <color number> option if you want colors to be present
2769              in the piped/redirected output (creating a PDF for example).
2770
2771              CONSOLE_COLOR_SCHEME The color scheme for console output (not in
2772              X/Wayland).
2773
2774              GLOBAL_COLOR_SCHEME Overrides all other color schemes.
2775
2776              IRC_COLOR_SCHEME Desktop X/Wayland IRC CLI color scheme.
2777
2778              IRC_CONS_COLOR_SCHEME Out of X/Wayland, IRC CLI color scheme.
2779
2780              IRC_X_TERM_COLOR_SCHEME  In  X/Wayland IRC client terminal color
2781              scheme.
2782
2783              VIRT_TERM_COLOR_SCHEME Color scheme for virtual terminal  output
2784              (in X/Wayland).
2785
2786
2787       Developer Options
2788              These are useful only for developers.
2789
2790              FAKE_DATA_DIR - change default fake data directory location. See
2791              --fake-data-dir.
2792
2793

BUGS

2795       Please report bugs using the following resources.
2796
2797       You may be asked to run the inxi debugger  tool  (see  --debug  21/22),
2798       which  will  upload  a  data  dump of system files for use in debugging
2799       inxi. These data dumps are very important since they  provide  us  with
2800       all the real system data inxi uses to parse out its report.
2801
2802       Issue Report
2803              File an issue report: https://github.com/smxi/inxi/issues
2804
2805       Forums Post   on   inxi   forums:   https://techpatterns.com/forums/fo
2806              rum-33.html
2807
2808       IRC irc.oftc.net#smxi
2809              You can also visit irc.oftc.net channel: #smxi to post issues.
2810
2811

HOMEPAGE

2813       https://github.com/smxi/inxi
2814
2815       https://smxi.org/docs/inxi.htm
2816
2817

AUTHOR AND CONTRIBUTORS TO CODE

2819       inxi is a fork of locsmif's very clever infobash script.
2820
2821       Original infobash author and copyright holder: Copyright (C)  2005-2007
2822       Michiel de Boer aka locsmif
2823
2824       inxi version: Copyright (C) 2008-2021 Harald Hope
2825
2826       This  man  page was originally created by Gordon Spencer (aka aus9) and
2827       is maintained by Harald Hope (aka h2 or TechAdmin).
2828
2829       Initial CPU logic, konversation version logic,  occasional  maintenance
2830       fixes,  and  the  initial  xiin.py tool for /sys parsing (obsolete, but
2831       still very much appreciated for  all  the  valuable  debugger  data  it
2832       helped generate): Scott Rogers
2833
2834       Further fixes (listed as known):
2835
2836       Horst Tritremmel <hjt at sidux.com>
2837
2838       Steven  Barrett  (aka:  damentz)  -  USB audio patch; swap percent used
2839       patch.
2840
2841       Jarett.Stevens - dmidecode -M patch for older systems with no /sys.
2842
2843

SPECIAL THANKS TO THE FOLLOWING

2845       The nice people at irc.oftc.net channels #linux-smokers-club and #smxi,
2846       who  all  really  have  to be considered to be co-developers because of
2847       their non-stop enthusiasm and willingness to provide real-time  testing
2848       and debugging of inxi development over the years.
2849
2850       LinuxQuestions.org  Slackware forum members, for major help with devel‐
2851       opment and debugging new or refactored features, particularly  the  re‐
2852       done CPU logic of 2021-12.
2853
2854       Siduction  forum  members, who have helped get some features working by
2855       providing a large number of datasets that have revealed possible varia‐
2856       tions, particularly for the RAM -m option.
2857
2858       AntiX users and admins, who have helped greatly with testing and debug‐
2859       ging, particularly for the 3.0.0 release.
2860
2861       ArcherSeven (Max), Brett Bohnenkamper (aka KittyKatt), and Iotaka,  who
2862       always  manage to find the weirdest or most extreme hardware and setups
2863       that help make inxi much more robust.
2864
2865       For the vastly underrated skill of output error/glitch  catching,  Pete
2866       Haddow.   His  patience  and  focus in going through inxi repeatedly to
2867       find errors and inconsistencies is much appreciated.
2868
2869       For a huge boost to BSD support, Stan Vandiver, who did a lot of  test‐
2870       ing and setup many remote access systems for testing and development.
2871
2872       All  the inxi package maintainers, distro support people, forum modera‐
2873       tors, and in particular, sys admins with their particular issues, which
2874       almost  always  help  make  inxi  better, and any others who contribute
2875       ideas, suggestions, and patches.
2876
2877       Without a wide range of diverse Linux kernel-based Free Desktop systems
2878       to test on, we could never have gotten inxi to be as reliable and solid
2879       as it's turning out to be.
2880
2881       And of course, a big thanks to locsmif, who figured out a  lot  of  the
2882       core ideas, logic, and tricks originally used in inxi Gawk/Bash.
2883
2884
2885
2886
2887inxi                              2022-06-16                           INXI(1)
Impressum