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 [-AbBCdDEfFGhiIjJlLmMnNopPrRsSuUVwzZ]
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 [--memory-modules] [--memory-short] [--recommends]  [--sensors-de‐
19       fault] [--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

USING OPTIONS

52       Options  can  be combined if they do not conflict. You can either group
53       the letters together or separate them.
54
55       Letters with numbers can have no gap or a gap at your  discretion,  ex‐
56       cept  when  using   -t. Note that if you use an option that requires an
57       additional argument, that must be last in the short form group  of  op‐
58       tions. Otherwise you can use those separately as well.
59
60       For  example:  inxi  -AG  |  inxi  -A  -G  | inxi -b | inxi -c10 | inxi
61       -FxxzJy90 | inxi -bay
62
63       Note that all the short form options have long form equivalents,  which
64       are  listed  below. However, usually the short form is used in examples
65       in order to keep things simple.
66
67

STANDARD OPTIONS

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

EXTRA DATA OPTIONS

839       These  options  can be triggered by one or more -x.  Alternatively, the
840       -v options trigger them in the following way: -v 3 adds -x; -v  6  adds
841       -xx; -v 7 adds -xxx
842
843       These  extra data triggers can be useful for getting more in-depth data
844       on various options. They can be added to any  long  form  option  list,
845       e.g.: -bxx or -Sxxx
846
847       There are 3 extra data levels:
848
849       -x, -xx, -xxx
850
851       OR
852
853       --extra 1, --extra 2, --extra 3
854
855       The  following  details show which lines / items display extra informa‐
856       tion for each extra data level.
857
858
859       -x -A  - Adds (if available and/or relevant) vendor: item, which  shows
860              specific vendor [product] information.
861
862              -  Adds  version/port(s)/driver  version (if available) for each
863              device.
864
865              - Adds PCI/USB ID of each device.
866
867              - Adds non-running sound servers, if detected.
868
869
870       -x -B  - Adds vendor/model, battery status (if battery present).
871
872              - Adds attached battery powered  peripherals  (Device-[number]:)
873              if detected (keyboard, mouse, etc.).
874
875              - Adds battery volts:, min: voltages. Note that if difference is
876              critical, that is current voltage is too close to minimum  volt‐
877              age, shows without -x.
878
879
880       -x -C  - Adds bogomips on CPU (if available)
881
882              - Adds boost: [enabled|disabled] if detected, aka turbo. Not all
883              CPUs have this feature.
884
885              - Adds CPU Flags (short list). Use -f to see  full  flag/feature
886              list.
887
888              -  Adds CPU microarchitecture + revision (e.g. Sandy Bridge, K8,
889              ARMv8, P6, etc.). Only shows data if detected. Newer microarchi‐
890              tectures  will  have to be added as they appear, and require the
891              CPU family ID, model ID, and stepping.
892
893              Examples: arch: Sandy Bridge rev: 2, arch: K8 rev.F+ rev: 2
894
895              If unable to non-ambiguosly determine  architecture,  will  show
896              something like: arch: Amber Lake note: check rev: 9
897
898
899       -x -d  -  Adds  more  items  to Features line of optical drive; dds rev
900              version to optical drive.
901
902
903       -x -D  - Adds HDD temperature with disk data.
904
905              Method 1: Systems running Linux kernels ~5.6  and  newer  should
906              have  drivetemp  module  data available. If so, drive temps will
907              come from /sys data for each drive, and will not require root or
908              hddtemp.  This  method  is MUCH faster than using hddtemp.  Note
909              that NVMe drives do not require drivetemp.
910
911              If your drivetemp module is not enabled, enable it:
912
913              modprobe drivetemp
914
915              Once  enabled,  add  drivetemp  to  /etc/modules  or   /etc/mod‐
916              ules-load.d/***.conf so it starts automatically.
917
918              If  you  see drive temps running as regular user and you did not
919              configure system to use doas[BSDs]/sudo hddtemp, then your  sys‐
920              tem  supports  this feature. If no /sys data is found, inxi will
921              try to use hddtemp methods instead for  that  drive.   Hint:  if
922              temp  is /sys sourced, the temp will be to 1 decimal, like 34.8,
923              if hddtemp sourced, they will be integers.
924
925              Method 2: if you have hddtemp installed, if you are root  or  if
926              you have added to /etc/sudoers (sudo v. 1.7 or newer):
927
928              <username> ALL = NOPASSWD: /usr/sbin/hddtemp (sample)
929
930              BSD users: see man doas.conf for setup.
931
932              You can force use of hddtemp for all drives using --hddtemp.
933
934              -  If  free LVM volume group size detected (root required), show
935              lvm-free: on Local Storage line. This is how much  unused  space
936              the VGs contain, that is, space not assigned to LVs.
937
938
939       -x -E (--bluetooth)
940              -  Adds (if available and/or relevant) vendor: item, which shows
941              specific vendor [product] information.
942
943              - Adds PCI/USB Bus ID of each device.
944
945              - Adds driver version (if available) for each device.
946
947              - Adds (if available, and hciconfig only) LMP  (HCI  if  no  LMP
948              data,  and  HCI  if  HCI/LMP versions are different) version (if
949              available) for each HCI ID.
950
951
952       -x -G  - Adds (if available and/or relevant) vendor: item, which  shows
953              specific vendor [product] information.
954
955              - Adds direct rendering status.
956
957              - Adds (for single GPU, nvidia driver) screen number that GPU is
958              running on.
959
960              - Adds PCI/USB ID of each device.
961
962
963       -x -i  - Adds IP v6 additional scope data, like Global, Site, Temporary
964              for each interface.
965
966              Note that there is no way we are aware of to filter out the dep‐
967              recated IP v6 scope site/global  temporary  addresses  from  the
968              output of ifconfig. The ip tool shows that clearly.
969
970              ip-v6-temporary - (ip tool only), scope global temporary.  Scope
971              global temporary deprecated is not shown
972
973              ip-v6-global - scope global (ifconfig will  show  this  for  all
974              types,  global,  global  temporary,  and global temporary depre‐
975              cated, ip shows it only for global)
976
977              ip-v6-link - scope link (ip/ifconfig) - default for -i.
978
979              ip-v6-site - scope site (ip/ifconfig). This has been  deprecated
980              in  IPv6, but still exists. ifconfig may show multiple site val‐
981              ues, as with global temporary, and global temporary deprecated.
982
983              ip-v6-unknown - unknown scope
984
985
986       -x -I  - Adds current init system (and init  rc  in  some  cases,  like
987              OpenRC).  With -xx, shows init/rc version number, if available.
988
989              -  Adds  default system gcc. With -xx, also show other installed
990              gcc versions.
991
992              - Adds current runlevel (not available with all init systems).
993
994              - Adds total packages discovered in system. See -xx and  -a  for
995              per package manager types output. Moves to Repos if -rx.
996
997              If  your  package manager is not supported, please file an issue
998              and we'll add it.  That requires the full output of the query or
999              method  to  discover  all  installed packages on your system, as
1000              well of course as the command or method used to discover those.
1001
1002              - If in shell (i.e. not in IRC client), adds shell version  num‐
1003              ber, if available.
1004
1005
1006       -x -j, -x --swap
1007              Add mapper:. See -x -o.
1008
1009
1010       -x -J (--usb)
1011              - For Devices, adds driver(s).
1012
1013
1014       -x -L, -x --logical
1015              - Adds dm: dm-x to VG > LV and other Device types. This can help
1016              tracking down which device belongs to what.
1017
1018
1019       -x -m, --memory-modules
1020              - If present, adds maximum memory module/device size in the  Ar‐
1021              ray  line.   Only  some  systems  will have this data available.
1022              Shows estimate if it can generate one.
1023
1024              - Adds device type in the Device line.
1025
1026
1027       -x -N  - Adds (if available and/or relevant) vendor: item, which  shows
1028              specific vendor [product] information.
1029
1030              -  Adds  version/port(s)/driver  version (if available) for each
1031              device;
1032
1033              - Adds PCI/USB ID of each device.
1034
1035
1036       -x -o, -x -p, -x -P
1037              - Adds mapper: (the /dev/mapper/ partitioni ID) if mapped parti‐
1038              tion.
1039
1040              Example: ID-4: /home ... dev: /dev/dm-6 mapped: ar0-home
1041
1042
1043       -x -r  - Adds Package info. See -Ix
1044
1045
1046       -x -R  -  md-raid:  Adds second RAID Info line with extra data: blocks,
1047              chunk size, bitmap  (if  present).  Resync  line,  shows  blocks
1048              synced/total blocks.
1049
1050              - Hardware RAID: Adds driver version, Bus ID.
1051
1052
1053       -x -s  -  Adds basic voltages: 12v, 5v, 3.3v, vbat (ipmi, lm-sensors if
1054              present).
1055
1056
1057       -x -S  - Adds Kernel gcc version.
1058
1059              - Adds to Distro: base: if detected. System base  will  only  be
1060              seen  on  a subset of distributions. The distro must be both de‐
1061              rived from a parent distro (e.g. Mint from Ubuntu), and  explic‐
1062              itly  added to the supported distributions for this feature. Due
1063              to the complexity of  distribution  identification,  these  will
1064              only  be  added  as  relatively solid methods are found for each
1065              distribution system base detection.
1066
1067
1068       -x -t (--processes)
1069              - Adds memory use output to CPU (-xt c), and CPU use  to  memory
1070              (-xt m).
1071
1072
1073       -x -w, -W
1074              - Adds humidity and barometric pressure.
1075
1076              - Adds wind speed and direction.
1077
1078
1079       -xx -A - Adds vendor:product ID for each device.
1080
1081
1082       -xx -B - Adds serial number.
1083
1084
1085       -xx -C - Adds L1-cache: and L3-cache: if either are available. Requires
1086              dmidecode and doas[BSDs]/sudo/root.
1087
1088
1089       -xx -D - Adds disk serial number.
1090
1091              - Adds disk speed (if available). This is  the  theoretical  top
1092              speed of the device as reported. This speed may be restricted by
1093              system board limits, eg.  a SATA 3 drive on a SATA 2  board  may
1094              report  SATA  2  speeds,  but this is not completely consistent,
1095              sometimes a SATA 3 device on a SATA 2 board reports  its  design
1096              speed.
1097
1098              NVMe drives: adds lanes, and (per direction) speed is calculated
1099              with lane speed * lanes * PCIe overhead. PCIe 1 and 2 have  data
1100              rates  of GT/s * .8  = Gb/s (10 bits required to transfer 8 bits
1101              of data).  PCIe 3 and greater transfer data at a rate of GT/s  *
1102              128/130  *  lanes = Gb/s (130 bits required to transfer 128 bits
1103              of data).
1104
1105              For a PCIe 3 NVMe drive, with speed of 8 GT/s and 4 lanes (8GT/s
1106              * 128/130 * 4 = 31.6 Gb/s):
1107
1108              speed: 31.6 Gb/s lanes: 4
1109
1110
1111       -xx -E (--bluetooth)
1112              - Adds vendor:product ID of each device.
1113
1114              -  Adds  (hciconfig only) LMP subversion (and/or HCI revision if
1115              applicable) for each device.
1116
1117
1118       -xx -G - Adds vendor:product ID of each device.
1119
1120              - Adds Xorg compositor, if found (always shows for Wayland  sys‐
1121              tems).
1122
1123              -  For free drivers, adds OpenGL compatibility version number if
1124              available.  For nonfree drivers, the core version  and  compati‐
1125              bility versions are usually the same. Example:
1126
1127              v: 3.3 Mesa 11.2.0 compat-v: 3.0
1128
1129              -  If  available,  shows  alternate:  Xorg drivers. This means a
1130              driver on the default list of drivers Xorg automatically  checks
1131              for  the device, but which is not installed. For example, if you
1132              have nouveau driver, nvidia would show as alternate  if  it  was
1133              not  installed.  Note  that  alternate: does NOT mean you should
1134              have it, it's just one of the drivers Xorg checks to see  if  is
1135              present  and  loaded  when checking the device. This can let you
1136              know there are other driver options.  Note that if you have  ex‐
1137              plicitly  set the driver in xorg.conf, Xorg will not create this
1138              automatic check driver list.
1139
1140              - If available, shows Xorg dpi  (s-dpi:)  for  the  active  Xorg
1141              Screen  (not  physical  monitor). Note that the physical monitor
1142              dpi and the Xorg dpi are not necessarily the same thing, and can
1143              vary widely.
1144
1145
1146       -xx -I - Adds init type version number (and rc if present).
1147
1148              - Adds other detected installed gcc versions (if present).
1149
1150              -  Adds  system  default  runlevel,  if  detected. Supports Sys‐
1151              temd/Upstart/SysVinit type defaults.
1152
1153              - Shows Packages: counts by discovered package manager types. In
1154              cases  where  only 1 type had results, does not show total after
1155              Packages:. Does not show installed package managers wtih 0 pack‐
1156              ages. See -a for full output.  Moves to Repos if -rxx.
1157
1158              -  Adds  parent  program (or tty) that started shell, if not IRC
1159              client.
1160
1161
1162       -xx -j (--swap), -xx -p, -xx -P
1163              - Adds swap priority to each swap partition (for -P)  used,  and
1164              for all swap types (for -j).
1165
1166
1167       -xx -J (--usb)
1168              - Adds vendor:chip id.
1169
1170
1171       -xx -L, -xx --logical
1172              -  Adds  internal  LVM Logical volumes, like raid image and meta
1173              data volumes.
1174
1175              - Adds full list of Components, sub-components, and their physi‐
1176              cal devices.
1177
1178              -  For LVM RAID, adds a RAID report line (if not -R). Read up on
1179              LVM documentation to better understand their  use  of  the  term
1180              'stripes'.
1181
1182
1183       -xx -m, --memory-modules
1184              - Adds memory device Manufacturer.
1185
1186              -  Adds  memory device Part Number (part-no:). Useful for order‐
1187              ing new or replacement  memory  sticks  etc.  Part  numbers  are
1188              unique, particularly if you use the word memory in the search as
1189              well. With -xxx, also shows serial number.
1190
1191              - Adds single/double bank memory, if data is found.  Note,  this
1192              may  not  be  100% right all of the time since it depends on the
1193              order that data is found in dmidecode output for type 6 and type
1194              17.
1195
1196
1197       -xx -M -  Adds  chassis  information,  if data is available. Also shows
1198              BIOS ROM size if using dmidecode.
1199
1200
1201       -xx -N - Adds vendor:product ID for each device.
1202
1203
1204       -xx -r - Adds Packages info. See -Ixx
1205
1206
1207       -xx -R - md-raid:  Adds  superblock  (if  present)  and  algorithm.  If
1208              resync, shows progress bar.
1209
1210              - Hardware RAID: Adds Chip vendor:product ID.
1211
1212
1213       -xx -s - Adds DIMM/SOC voltages, if present (ipmi only).
1214
1215
1216       -xx -S -  Adds  display  manager  (dm) type, if present. If none, shows
1217              N/A.  Supports most known display managers, including gdm, gdm3,
1218              idm,  kdm,  lightdm, lxdm, mdm, nodm, sddm, slim, tint, wdm, and
1219              xdm.
1220
1221              - Adds, if run in X, window manager  type  (wm),  if  available.
1222              Not all window managers are supported. Some desktops support us‐
1223              ing more than one window manager, so this can be useful  to  see
1224              what  window  manager is actually running.  If none found, shows
1225              nothing. Uses a less accurate fallback tool wmctrl if  ps  tests
1226              fail to find data.
1227
1228              - Adds desktop toolkit (tk), if available (Xfce/KDE/Trinity).
1229
1230
1231       -xx --slots
1232              - Adds slot length.
1233
1234
1235       -xx -w, -W
1236              - Adds wind chill, heat index, and dew point, if available.
1237
1238              - Adds cloud cover, rain, snow, or precipitation (amount in pre‐
1239              vious hour to observation time), if available.
1240
1241
1242       -xxx -A
1243              - Adds, if present, serial number.
1244
1245              - Adds, if present, PCI/USB class ID.
1246
1247
1248       -xxx -B
1249              - Adds battery chemistry (e.g. Li-ion), cycles (NOTE: there  ap‐
1250              pears  to be a problem with the Linux kernel obtaining the cycle
1251              count, so this almost always shows 0. There's nothing  that  can
1252              be  done  about this glitch, the data is simply not available as
1253              of 2018-04-03), location (only available from dmidecode  derived
1254              output).
1255
1256              - Adds attached device rechargeable: [yes|no] information.
1257
1258
1259       -xxx -C
1260              - Adds CPU voltage and external clock speed (this is the mother‐
1261              board speed).  Requires doas[BSDs]/sudo/root and dmidecode.
1262
1263
1264       -xxx -D
1265              - Adds disk firmware revision number (if available).
1266
1267              - Adds disk partition scheme (in most cases), e.g. scheme:  GPT.
1268              Currently  not  able to detect all schemes, but handles the most
1269              common, e.g. GPT or MBR.
1270
1271              - Adds disk rotation speed (in some but not all cases), e.g. ro‐
1272              tation: 7200 rpm or rotation: SSD if positive SSD identification
1273              was made. If no rotation  or  positive  SSD  ID  found,  nothing
1274              shows.  Not  all  disks  report  this speed, so even if they are
1275              spinnning, no data will show.
1276
1277
1278       -xxx -E (--bluetooth)
1279              - Adds, if present, PCI/USB class ID.
1280
1281              - Adds (hciconfig only) HCI version, revision.
1282
1283
1284       -xxx -G
1285              - Adds, if present, PCI/USB class ID.
1286
1287
1288       -xxx -I
1289              - For Uptime: adds wakeups: to show how many times  the  machine
1290              has  been  woken from suspend state during current uptime period
1291              (if available, Linux only). 0 value means the  machine  has  not
1292              been suspended.
1293
1294              - For Shell: adds (su|sudo|login) to shell name if present.
1295
1296              -  For  Shell:  adds  default:  shell  if different from running
1297              shell, and default shell v:, if available.
1298
1299              - For running-in: adds (SSH) to parent, if present.  SSH  detec‐
1300              tion uses the whoami test.
1301
1302
1303       -xxx -J (--usb)
1304              - Adds, if present, serial number for non hub devices.
1305
1306              - Adds interfaces: for non hub devices.
1307
1308              - Adds, if available, USB speed in Mbits/s or Gbits/s.
1309
1310              - Adds, if present, USB class ID.
1311
1312              - Adds, if non 0, max power in mA.
1313
1314
1315       -xxx -m, --memory-modules
1316              -  Adds memory bus width: primary bus width, and if present, to‐
1317              tal width. e.g.  bus width: 64 bit (total: 72 bits).  Note  that
1318              total  / data widths are mixed up sometimes in dmidecode output,
1319              so inxi will take the larger value as the total if  present.  If
1320              no total width data is found, then inxi will not show that item.
1321
1322              - Adds device Type Detail, e.g. detail: DDR3 (Synchronous).
1323
1324              -  Adds,  if  present,  memory module voltage. Only some systems
1325              will have this data available.
1326
1327              - Adds device serial number.
1328
1329
1330       -xxx -N
1331              - Adds, if present, serial number.
1332
1333              - Adds, if present, PCI/USB class ID.
1334
1335
1336       -xxx -R
1337              - md-raid: Adds system mdraid  support  types  (kernel  support,
1338              read ahead, RAID events)
1339
1340              - zfs-raid: Adds portion allocated (used) by RAID array/device.
1341
1342              - Hardware RAID: Adds rev, ports, and (if available and/or rele‐
1343              vant) vendor: item, which shows specific vendor [product] infor‐
1344              mation.
1345
1346
1347       -xxx -S
1348              -  Adds,  if  in X, or with --display, bar/dock/panel/tray items
1349              (info). If none found, shows  nothing.  Supports  desktop  items
1350              like   gnome-panel,  lxpanel,  xfce4-panel,  lxqt-panel,  tint2,
1351              cairo-dock, trayer, and many others.
1352
1353              - Adds (if present), window manager (wm) version number.
1354
1355              - Adds (if present), display manager (dm) version number.
1356
1357              - Adds (if available, and in  display),  virtual  terminal  (vt)
1358              number.   These  are  the same as ctrl+alt+F[x] numbers usually.
1359              Some systems have this, some don't, it varies.
1360
1361
1362       -xxx -w, -W
1363              - Adds location (city state country), observation  altitude  (if
1364              available), weather observation time (if available), sunset/sun‐
1365              rise (if available).
1366
1367

ADMIN EXTRA DATA OPTIONS

1369       These options are triggered with --admin or -a. Admin options  are  ad‐
1370       vanced  output  options, and are more technical, and mostly of interest
1371       to system administrators or other machine admins.
1372
1373       The --admin option sets -xxx, and only has to be used  once.   It  will
1374       trigger the following features:
1375
1376
1377       -a -A  -  Adds,  if present, possible alternate: kernel modules capable
1378              of driving each Device-x (not including the current driver:). If
1379              no  non-driver  modules found, shows nothing. NOTE: just because
1380              it lists a module does NOT mean it is available in  the  system,
1381              it's  just something the kernel knows could possibly be used in‐
1382              stead.
1383
1384
1385       -a -C  - Adds CPU family, model-id, and stepping (replaces rev of -Cx).
1386              Format  is  hexadecimal  (decimal)  if greater than 9, otherwise
1387              hexadecimal.
1388
1389              - Adds CPU microcode. Format is hexadecimal.
1390
1391              - Adds socket type (for motherboard CPU socket,  if  available).
1392              If  results doubtful will list two socket types and note: check.
1393              Requires doas[BSDs]/sudo/root and dmidecode. The item in  paren‐
1394              theses may simply be a different syntax for the same socket, but
1395              in general, check this before trusting it.
1396              Sample: socket: 775 (478) note: check
1397              Sample: socket: AM4
1398
1399              -  Adds  DMI  CPU  base   and   boost/turbo   speeds.   Requires
1400              doas[BSDs]/sudo/root  and  dmidecode.  In  some cases, like with
1401              overclocking or 'turbo' or 'boost' modes, voltage  and  external
1402              clock  speeds  may  be increased, or short term limits raised on
1403              max CPU speeds. These are often not reflected in /sys based  CPU
1404              min/max: speed results, but often are using this source.
1405
1406              Samples:
1407              CPU not overclocked, with boost, like Ryzen:
1408              Speed: 2861 MHz min/max: 1550/3400 MHz boost: enabled base/boost: 3400/3900
1409
1410              Overclocked 2900 MHz CPU, with no boost available:
1411              Speed: 2900 MHz min/max: 800/2900 MHz base/boost: 3350/3000
1412
1413              Overclocked 3000 MHz CPU, with boosted max speed:
1414              Speed: 4190 MHz min/max: 1200/3001 MHz base/boost: 3000/4000
1415
1416              Note  that  these  numbers  can be confusing, but basically, the
1417              base number is the actual normal top speed the CPU runs at with‐
1418              out  boost  mode,  and the boost number is the max speed the CPU
1419              reports itself able to run at.  The  actual  max  speed  may  be
1420              higher than either value, or lower.  The boost number appears to
1421              be hard-coded into the CPU DMI data, and does not  seem  to  re‐
1422              flect  actual max speeds that overclocking or other combinations
1423              of speed boosters can enable, as you can see  from  the  example
1424              where  the  CPU is running at a speed faster than the min/max or
1425              base/boost values.
1426
1427              Note that the normal min/max: speeds do NOT  show  actual  over‐
1428              clocked  OR boost/turbo mode speeds, and appear to be hard-coded
1429              values, not dynamic real  values.  The  base/boost:  values  are
1430              sometimes  real,  and sometimes not.  base appears in general to
1431              be real.
1432
1433              - Adds CPU Vulnerabilities (bugs) as known by your current  ker‐
1434              nel.  Lists  by  Type: ... (status|mitigation): .... for systems
1435              that support this  feature  (Linux  kernel  4.14  or  newer,  or
1436              patched older kernels).
1437
1438
1439       -a -d,-a -D
1440              - Adds logical and physical block size in bytes.
1441
1442              Using smartctl (requires doas[BSDs]/sudo/root privileges).
1443
1444              - Adds device model family, like Caviar Black, if available.
1445
1446              - Adds SATA type (eg 1.0, 2.6, 3.0) if a SATA device.
1447
1448              - Adds device kernel major:minor number (Linux only).
1449
1450              - Adds SMART report line: status, enabled/disabled, health, pow‐
1451              ered on, cycles, and some error cases if out  of  range  values.
1452              Note that for Pre-fail items, it will show the VALUE and THRESH‐
1453              OLD numbers. It will also fall back for unknown attributes  that
1454              are  or  have  been  failing  and  print out the Attribute name,
1455              value, threshold, and failing message. This way even for  unhan‐
1456              dled  Attribute  names,  you  should get a solid report for full
1457              failure cases. Other cases may show if inxi  believes  that  the
1458              item may be approaching failure. This is a guess so make sure to
1459              check the drive and smartctl full output to verify before taking
1460              any further action.
1461
1462              -  Adds, for USB or other external drives, actual model name/se‐
1463              rial if available, and different  from  enclosure  model/serial,
1464              and corrects block sizes if necessary. Adds in drive temperature
1465              for some drives as well, and other useful data.
1466
1467
1468       -a -E (--bluetooth)
1469              - Adds (hciconfig only) extra line to Report:, Info:.  Includes,
1470              if available, ACL MTU, SCO MTU, Link policy, Link mode, and Ser‐
1471              vice Classes.
1472
1473
1474       -a -G  Triggers a much more complete Screen/Monitor output on the  Dis‐
1475              play: line of -G. Note that the basic feature requires xdpyinfo,
1476              and the advanced per monitor feature requires xrandr.
1477
1478              No support currently exists for Wayland since we so far can find
1479              no  documentation  or  easy  methods to extract this information
1480              from Wayland compositors. This unfortunate situation may  change
1481              in  the  future,  hopefully.  However, most Wayland systems also
1482              come with xwayland, which should supply the tools necessary  for
1483              the time being.
1484
1485              Further note that all references to Displays, Screens, and Moni‐
1486              tors are referring to the X technical terms, not normal consumer
1487              usage.  1 Display runs 1 or more Screens, and a Screen runs 1 or
1488              more Monitors.
1489
1490              - Adds Display ID, for the Display running the Screen that  runs
1491              the Monitors.
1492
1493              - Adds total number of Screens listed for the current Display.
1494
1495              -  Adds  default  Screen  ID  if  Screen (not monitor!) total is
1496              greater than 1.
1497
1498              - Adds Screen line, which includes the ID (Screen: 0) then s-res
1499              (Screen resolution), s-dpi, s-size and s-diag. Remember, this is
1500              an Xorg Screen, NOT a monitor screen, and the information listed
1501              is  about the Xorg Screen! It may at times be the same as a sin‐
1502              gle monitor system, but usually it's different in some ways.
1503
1504              - Adds Monitor ID(s). Monitors are a subset of a Screen, each of
1505              which  can  have  one  or more monitors. Normally a dual monitor
1506              setup is 2 monitors run by one Xorg Screen. Each monitor has the
1507              following data, if available:
1508
1509              -  res:  resolution  in pixels. This is the individual monitor's
1510              reported pixel dimensions.
1511
1512              - hz: frequency in Herz, as reported to Xorg.  Note  that  there
1513              have  been  and may continue to be bugs with how Xorg treats > 1
1514              monitor frequencies.
1515
1516              - dpi: dpi (dots per inch), aka, ppi (pixels per inch). This  is
1517              the  physical  screen  dpi, which is calculated using the screen
1518              dimensions and its resolution.
1519
1520              - size: size in mm (inches). Note that this is the real  monitor
1521              size,  not the Xorg Screen size, which can be quite different (1
1522              Xorg Screen can for instance contain two or more monitors).
1523
1524              - diag: monitor screen diagonal in mm (inches). Note  that  this
1525              is  the  real  monitor  size,  not the Xorg full Screen diagonal
1526              size, which can be quite different.
1527
1528              Sample (with both xdpyinfo and xrandr data available):
1529              inxi -aG
1530              Graphics:
1531               ....
1532              Display: x11 server: X.Org 1.20.6 driver: loaded: modesetting
1533              display ID: :0.0 screens: 1
1534              Screen-1: 0 s-res: 2560x1024 s-dpi: 96 s-size: 677x271mm (26.7x10.7")
1535              s-diag: 729mm (28.7")
1536              Monitor-1: DVI-I-0 res: 1280x1024 hz: 60 dpi: 96
1537              size: 338x270mm (13.3x10.6") diag: 433mm (17")
1538              Monitor-2: VGA-0 res: 1280x1024 hz: 60 dpi: 86
1539              size: 376x301mm (14.8x11.9") diag: 482mm (19")
1540               ....
1541              - Adds, if present, possible alternate: kernel  modules  capable
1542              of driving each Device-x (not including the current loaded:). If
1543              no non-driver modules found, shows nothing. NOTE:  just  because
1544              it  lists  a module does NOT mean it is available in the system,
1545              it's just something the kernel knows could possibly be used  in‐
1546              stead.
1547
1548
1549       -a -I  -  Adds Packages, totals, per package manager totals, and number
1550              of lib packages detected per package manager. Also adds detected
1551              package managers with 0 packages listed. Moves to Repos if -ra.
1552
1553              inxi -aI
1554              Info:
1555               ....
1556               Init: systemd v: 245 runlevel: 5 Compilers: gcc: 9.3.0 alt: 5/6/7/8/9
1557               Packages: apt: 3681 lib: 2096 rpm: 0 Shell: ksh v: A_2020.0.0 default: Bash
1558               v: 5.0.16 running-in: kate inxi: 3.1.04
1559
1560              -  Adds service control tool, tested for in the following order:
1561              systemctl rc-service service sv /etc/rc.d /etc/init.d  -  useful
1562              to know which you need when using an unfamiliar machine.
1563
1564
1565       -a -j, -a -P [swap], -a -P [swap]
1566              - Adds swappiness and vfs cache pressure, and a message to indi‐
1567              cate if the value is the default value or not (Linux  only,  and
1568              only  if  available).   If  not the default value, shows default
1569              value as well, e.g.
1570
1571              For -P per swap physical partition:
1572
1573              swappiness: 60 (default) cache-pressure: 90 (default 100)
1574
1575              For -j row 1 output:
1576
1577              Kernel: swappiness: 60  (default)  cache-pressure:  90  (default
1578              100)
1579
1580              - Adds device kernel major:minor number (Linux only).
1581
1582
1583       -a -L  -  Expands  Component report, shows size / maj-min of components
1584              and devices, and mapped name for logical components.  Puts  each
1585              component/device on its own line.
1586
1587              - Adds maj-min to LV and other devices.
1588
1589
1590       -a -n, -a -N, -a -i
1591              -  Adds,  if present, possible alternate: kernel modules capable
1592              of driving each Device-x (not including the current driver:). If
1593              no  non-driver  modules found, shows nothing. NOTE: just because
1594              it lists a module does NOT mean it is available in  the  system,
1595              it's  just something the kernel knows could possibly be used in‐
1596              stead.
1597
1598
1599       -a -o  - Adds device kernel major:minor number (Linux only).
1600
1601
1602       -a -p,-a -P
1603              - Adds raw partition size, including file system overhead,  par‐
1604              tition table, e.g.
1605
1606              raw-size: 60.00 GiB.
1607
1608              - Adds percent of raw size available to size: item, e.g.
1609
1610              size: 58.81 GiB (98.01%).
1611
1612              Note  that  used: 16.44 GiB (34.3%) percent refers to the avail‐
1613              able size, not the raw size.
1614
1615              - Adds partition filesystem block size if found  (requires  root
1616              and blockdev).
1617
1618              - Adds device kernel major:minor number (Linux only).
1619
1620
1621       -a -r  - Adds Packages. See -Ia
1622
1623
1624       -a -R  - Adds device kernel major:minor number (mdraid, Linux only).
1625
1626              -  Adds, if available, component size, major:minor number, state
1627              (Linux only).  Turns Component report to 1 component per line if
1628              size and major:minor present.
1629
1630
1631       -a -S  -  Adds  kernel boot parameters to Kernel section (if detected).
1632              Support varies by OS type.
1633
1634

ADVANCED OPTIONS

1636       --alt 40
1637              Bypass  Perl  as  a  downloader  option.   Priority   is:   Perl
1638              (HTTP::Tiny), Curl, Wget, Fetch, (OpenBSD only) ftp.
1639
1640
1641       --alt 41
1642              Bypass   Curl   as   a  downloader  option.  Priority  is:  Perl
1643              (HTTP::Tiny), Curl, Wget, Fetch, (OpenBSD only) ftp.
1644
1645
1646       --alt 42
1647              Bypass  Fetch  as  a  downloader  option.  Priority   is:   Perl
1648              (HTTP::Tiny), Curl, Wget, Fetch, (OpenBSD only) ftp.
1649
1650
1651       --alt 43
1652              Bypass   Wget   as   a  downloader  option.  Priority  is:  Perl
1653              (HTTP::Tiny), Curl, Wget, Fetch, OpenBSD only: ftp
1654
1655
1656       --alt 44
1657              Bypass Curl, Fetch, and Wget as downloader options.  This  basi‐
1658              cally   forces   the   downloader  selection  to  use  Perl  5.x
1659              HTTP::Tiny, which is generally slower than Curl or Wget  but  it
1660              may help bypass issues with downloading.
1661
1662
1663       --bt-tool [bt-adapter|hciconfig]
1664              Force the use of the given tool for bluetooth report (-E).
1665
1666
1667       --dig  Temporary  override  of  NO_DIG  configuration item. Only use to
1668              test w/wo dig.  Restores default behavior for WAN IP,  which  is
1669              use dig if present.
1670
1671
1672       --display [:<integer>]
1673              Will  try to get display data out of X (does not usually work as
1674              root user).  Default gets display info from display :0.  If  you
1675              use  the format --display :1 then it would get it from display 1
1676              instead, or any display you specify.
1677
1678              Note that in some cases, --display will cause inxi to hang  end‐
1679              lessly  when  running the option in console with Intel graphics.
1680              The situation regarding other free drivers such  as  nouveau/ATI
1681              is  currently unknown. It may be that this is a bug with the In‐
1682              tel graphics driver - more information is required.
1683
1684              You can test this easily by running the following command out of
1685              X/display server: glxinfo -display :0
1686
1687              If it hangs, --display will not work.
1688
1689
1690       --dmidecode
1691              Shortcut, legacy. See --force dmidecode.
1692
1693
1694       --downloader [curl|fetch|perl|wget]
1695              Force inxi to use Curl, Fetch, Perl, or Wget for downloads.
1696
1697
1698       --force [dmidecode|hddtemp|lsusb|usb-sys|vmstat|wmctl]
1699              Various  force options to allow users to override defaults. Val‐
1700              ues be given as a comma separated list:
1701
1702              inxi -MJ --force dmidecode,lsusb
1703
1704              - dmidecode - Force use of dmidecode. This  will  override  /sys
1705              data in some lines, e.g. -M or -B.
1706
1707              -  hddtemp  - Force use of hddtemp instead of /sys temp data for
1708              disks.
1709
1710              - lsusb - Forces the USB data generator to  use  lsusb  as  data
1711              source   (default).  Overrides  USB_SYS  in  user  configuration
1712              file(s).
1713
1714              - usb-sys - Forces the USB data generator to use  /sys  as  data
1715              source instead of lsusb (Linux only).
1716
1717              - vmstat - Forces use of vmstat for memory data.
1718
1719              -  wmctl  -  Force  System item wm to use wmctrl as data source,
1720              override default ps source.
1721
1722
1723       --hddtemp
1724              Shortcut, legacy. See --force hddtemp.
1725
1726
1727       --host Turns on hostname in System line.  Overrides  inxi  config  file
1728              value (if set):
1729
1730              SHOW_HOST='false' - Same as: SHOW_HOST='true'
1731
1732              This  is an absolute override, the host will always show no mat‐
1733              ter what other switches you use.
1734
1735
1736       --html-wan
1737              Temporary override of NO_HTML_WAN configuration item.  Only  use
1738              to  test  w/wo HTML downloaders for WAN IP. Restores default be‐
1739              havior for WAN IP, which is use HTML downloader if  present  and
1740              if dig failed.
1741
1742
1743       --limit [-1 - x]
1744              Raise  or  lower max output limit of IP addresses for -i. -1 re‐
1745              moves limit.
1746
1747
1748       --man  Updates / installs man page with -U if pinxi or using -U  3  dev
1749              branch.  (Only active if -U is is not disabled by maintainers).
1750
1751
1752       --no-dig
1753              Overrides  default  use of dig to get WAN IP address. Allows use
1754              of normal downloader tool to get IP addresses. Only use  if  dig
1755              is  failing,  since dig is much faster and more reliable in gen‐
1756              eral than other methods.
1757
1758
1759       --no-doas
1760              Skips the use of doas to run certain internal features (like hd‐
1761              dtemp,  file) with doas. Not related to running inxi itself with
1762              doas/sudo or super user.   Some  systems  will  register  errors
1763              which  will  then  trigger admin emails in such cases, so if you
1764              want to disable regular user use of doas (which requires config‐
1765              uration to setup anyway for these options) just use this option,
1766              or NO_DOAS configuration item.  See --no-sudo  if  you  need  to
1767              disable both types.
1768
1769
1770       --no-host
1771              Turns  off  hostname  in System line. This is default when using
1772              -z, for anonymizing inxi output for posting on  forums  or  IRC.
1773              Overrides    configuration    value    (if    set):   indent-min
1774              SHOW_HOST='true' - Same as: SHOW_HOST='false'
1775
1776              This is an absolute override, the host will not show  no  matter
1777              what other switches you use.
1778
1779
1780       --no-html-wan
1781              Overrides use of HTML downloaders to get WAN IP address. Use ei‐
1782              ther only dig, or do not get wan IP. Only use if dig is failing,
1783              and  the HTML downloaders are taking too long, or are hanging or
1784              failing.  Make permanent with NO_HTML_WAN='true'
1785
1786
1787       --no-man
1788              Disables man page install with -U for master and active develop‐
1789              ment  branches.   (Only active if -U is is not disabled by main‐
1790              tainers).
1791
1792
1793       --no-sensor-force
1794              Overrides user set SENSOR_FORCE  configuration  value.  Restores
1795              default behavior.
1796
1797
1798       --no-ssl
1799              Skip  SSL certificate checks for all downloader actions (-U, -w,
1800              -W, -i). Use if your system does not have current  SSL  certifi‐
1801              cate  lists, or if you have problems making a connection for any
1802              reason. Works with Wget, Curl, Perl HTTP::Tiny and Fetch.
1803
1804
1805       --no-sudo
1806              Skips the use of sudo to run certain internal features (like hd‐
1807              dtemp,  file) with sudo. Not related to running inxi itself with
1808              sudo or super user.  Some systems  will  register  errors  which
1809              will  then trigger admin emails in such cases, so if you want to
1810              disable regular user use of sudo (which  requires  configuration
1811              to  setup  anyway  for  these  options) just use this option, or
1812              NO_SUDO configuration item.
1813
1814
1815       --output [json|screen|xml]
1816              Change data output type. Requires --output-file if not screen.
1817
1818
1819       --output-file [full path to output file|print]
1820              The given directory path must exist. The  directory  path  given
1821              must  exist,  The  print options prints to stdout.  Required for
1822              non-screen --output formats (json|xml).
1823
1824
1825       --partition-sort [dev-base|fs|id|label|percent-used|size|uuid|used]
1826              Change default sort order of partition  output.  Corresponds  to
1827              PARTITION_SORT  configuration item. These are the available sort
1828              options:
1829
1830              dev-base - /dev partition identifier, like /dev/sda1.  Note that
1831              it's an alphabetic sort, so sda12 is before sda2.
1832
1833              fs - Partition filesystem. Note that sorts will be somewhat ran‐
1834              dom if all filesystems are the same.
1835
1836              id - Mount point of partition (default).
1837
1838              label - Label of partition. If partitions have no  labels,  sort
1839              will be random.
1840
1841              percent-used - Percentage of partition size used.
1842
1843              size - KiB size of partition.
1844
1845              uuid - UUID of the partition.
1846
1847              used - KiB used of partition.
1848
1849
1850       --pm-type [package manager name]
1851              For  distro package maintainers only, and only for non apt, rpm,
1852              or pacman based systems.  To be used to test replacement package
1853              lists for recommends for that package manager.
1854
1855
1856       --sensors-default
1857              Overrides configuration values SENSORS_USE or SENSORS_EXCLUDE on
1858              a one time basis.
1859
1860
1861       --sensors-exclude
1862              Similar to --sensors-use except removes listed sensors from sen‐
1863              sor  data.   Make  permanent  with SENSORS_EXCLUDE configuration
1864              item. Note that gpu, network, disk, and  other  specific  device
1865              monitor chips are excluded by default.
1866
1867              Example: inxi -sxx --sensors-exclude k10temp-pci-00c3
1868
1869
1870       --sensors-use
1871              Use  only  the   (comma  separated) sensor arrays for -s output.
1872              Make permanent with SENSORS_USE configuration item. Sensor array
1873              ID  value  must  be  the exact value shown in lm-sensors sensors
1874              output (Linux/lm-sensors only). If you only want to exclude  one
1875              (or more) sensors from the output, use --sensors-exlude.
1876
1877              Can  be  useful  if  the default sensor data used by inxi is not
1878              from the right sensor array. Note that  all  other  sensor  data
1879              will  be  removed,  which  may  lead  to undesired consequences.
1880              Please be aware that this can lead to many undesirable  side-ef‐
1881              fects,  since  default behavior is to use all the sensors arrays
1882              and select which values to use from them  following  a  set  se‐
1883              quence  of  rules.  So if you force one to be used, you may lose
1884              data that was used from another one.
1885
1886              Most likely best use is when one (or two) of the  sensor  arrays
1887              has all the sensor data you want, and you just want to make sure
1888              inxi doesn't use data from another array that has  inacurate  or
1889              misleading data.
1890
1891              Note  that gpu, network, disk, and other specific device monitor
1892              chips are excluded by default, and should  not  be  added  since
1893              they do not provide cpu, board, system, etc, sensor data.
1894
1895              Example:   inxi   -sxx  --sensors-use  nct6791-isa-0290,k10temp-
1896              pci-00c3
1897
1898
1899       --sleep [0-x.x]
1900              Usually in decimals. Change CPU  sleep  time  for  -C  (current:
1901               .35).  Sleep is used to let the system catch up and show a more
1902              accurate CPU use. Example:
1903
1904              inxi -Cxxx --sleep 0.15
1905
1906              Overrides default internal value and user configuration value:
1907
1908              CPU_SLEEP=0.25
1909
1910
1911       --tty  Forces internal IRC flag to off. Used in unhandled  cases  where
1912              the  program running inxi may not be seen as a shell/tty, but it
1913              is not an IRC client. Put --tty first in option  list  to  avoid
1914              unexpected  errors. If you want a specific output width, use the
1915              --width option. If you want normal color codes  in  the  output,
1916              use the  -c [color ID] flag.
1917
1918              The  sign  you  need  to  use  this  is extra numbers before the
1919              key/value pairs of the output of your program.  These  are  IRC,
1920              not TTY, color codes. Please post a github issue if you find you
1921              need to use --tty (including the full -Ixxx line) so we can fig‐
1922              ure  out how to add your program to the list of whitelisted pro‐
1923              grams.
1924
1925              You can see what inxi believed started it  in  the  -Ixxx  line,
1926              Shell:  or Client: item. Please let us know what that result was
1927              so we can add it to the parent start program whitelist.
1928
1929
1930       --usb-sys
1931              Shortcut, legacy. See --force usb-sys
1932
1933
1934       --usb-tool
1935              Shortcut, legacy. See --force lsusb
1936
1937
1938       --wan-ip-url [URL]
1939              Force -i to use supplied URL as WAN IP source. Overrides dig  or
1940              default IP source urls. URL must start with http[s] or ftp.
1941
1942              The  IP  address  from the URL must be the last item on the last
1943              (non-empty) line of the page content source code.
1944
1945              Same as configuration value (example):
1946
1947              WAN_IP_URL='https://mysite.com/ip.php'
1948
1949
1950       --wm   Shortcut, legacy. See --force wmctl.
1951
1952
1953       --wrap-max [integer]
1954              Overrides default or configuration set line starter  wrap  width
1955              value.   Wrap  max is the maximum width that inxi will wrap line
1956              starters (e.g. Info:) to their own lines, with  data  lines  in‐
1957              dented  only  2 columns. If terminal/console width or --width is
1958              less than wrap width, wrapping of line starter occurs.  If 80 or
1959              less,  no wrapping will occur.  Overrides internal default value
1960              (90) and user configuration value:
1961
1962              WRAP_MAX=85 (previously INDENT_MIN)
1963
1964              Previously called: --indent-min.
1965
1966

DEBUGGING OPTIONS

1968       --dbg 1
1969              - Debug downloader failures. Turns  off  silent/quiet  mode  for
1970              curl, wget, and fetch. Shows more downloader action information.
1971              Shows some more information for Perl downloader.
1972
1973
1974       --dbg [2-xx]
1975              - See github inxi-perl/docs/inxi-values.txt  for  specific  spe‐
1976              cialized  debugging  options.  These  can  vary  but tend to not
1977              change much, though they are added as needed.
1978
1979
1980       --debug [1-3]
1981              - On screen debugger output. Output varies depending on  current
1982              needs Usually nothing changes.
1983
1984
1985       --debug 10
1986              -   Basic   logging.   Check   $XDG_DATA_HOME/inxi/inxi.log   or
1987              $HOME/.local/share/inxi/inxi.log or $HOME/.inxi/inxi.log.
1988
1989
1990       --debug 11
1991              - Full file/system info logging.
1992
1993
1994       --debug 20
1995              Creates a tar.gz file of system data and collects the inxi  out‐
1996              put in a file.
1997
1998              *  tree  traversal  data  file(s)  read from /proc and /sys, and
1999              other system data.
2000
2001              * xorg conf and log data, xrandr, xprop, xdpyinfo, glxinfo etc.
2002
2003              * data from dev, disks, partitions, etc.
2004
2005
2006       --debug 21
2007              Automatically uploads debugger data tar.gz file to ftp.smxi.org,
2008              then  removes  the  debug  data  directory, but leaves the debug
2009              tar.gz file.  See --ftp for uploading to alternate locations.
2010
2011
2012       --debug 22
2013              Automatically uploads debugger data tar.gz file to ftp.smxi.org,
2014              then  removes the debug data directory and the tar.gz file.  See
2015              --ftp for uploading to alternate locations.
2016
2017
2018       --ftp [ftp.yoursite.com/incoming]
2019              For alternate ftp upload locations: Example:
2020
2021              inxi --ftp ftp.yourserver.com/incoming --debug 21
2022
2023

DEBUGGING OPTIONS TO DEBUG DEBUGGER FAILURES

2025       Only use the following in conjunction with --debug 2[012], and only use
2026       if you experienced a failure or hang, or were instructed to do so.
2027
2028
2029       --debug-proc
2030              Force  debugger  to parse /proc directory data when run as root.
2031              Normally this is disabled due to  unpredictable  data  in  /proc
2032              tree.
2033
2034
2035       --debug-proc-print
2036              Use this to locate file that /proc debugger hangs on.
2037
2038
2039       --debug-no-exit
2040              Skip exit on error when running debugger.
2041
2042
2043       --debug-no-proc
2044              Skip /proc debugging in case of a hang.
2045
2046
2047       --debug-no-sys
2048              Skip /sys debugging in case of a hang.
2049
2050
2051       --debug-sys
2052              Force PowerPC debugger parsing of /sys as doas[BSDs]/sudo/root.
2053
2054
2055       --debug-sys-print
2056              Use this to locate file that /sys debugger hangs on.
2057
2058

SUPPORTED IRC CLIENTS

2060       BitchX,  Gaim/Pidgin, ircII, Irssi, Konversation, Kopete, KSirc, KVIrc,
2061       Weechat, and Xchat. Plus any others that are capable of displaying  ei‐
2062       ther built-in or external script output.
2063
2064

RUNNING IN IRC CLIENT

2066       To  trigger inxi output in your IRC client, pick the appropriate method
2067       from the list below:
2068
2069       Hexchat, XChat, Irssi
2070              (and many other IRC clients) /exec  -o  inxi  [options]  If  you
2071              don't include the -o, only you will see the output on your local
2072              IRC client.
2073
2074       Konversation
2075              /cmd inxi [options]
2076
2077              To run inxi in Konversation as a native script if your distribu‐
2078              tion  or  inxi  package hasn't already done this for you, create
2079              this symbolic link:
2080
2081              KDE 4: ln -s /usr/local/bin/inxi  /usr/share/kde4/apps/konversa‐
2082              tion/scripts/inxi
2083
2084              KDE    5:   ln   -s   /usr/local/bin/inxi   /usr/share/konversa‐
2085              tion/scripts/inxi
2086
2087              If inxi is somewhere else, change  the  path  /usr/local/bin  to
2088              wherever it is located.
2089
2090              If  you  are  using  KDE/QT 5, then you may also need to add the
2091              following to get the Konversation /inxi command to work:
2092
2093              ln -s /usr/share/konversation /usr/share/apps/
2094
2095              Then you can start inxi directly, like this:
2096
2097              /inxi [options]
2098
2099       WeeChat
2100              NEW: /exec -o inxi [options]
2101
2102              OLD: /shell -o inxi [options]
2103
2104              Newer (2014 and later) WeeChats work pretty much the same now as
2105              other  console  IRC clients, with /exec -o inxi [options]. Newer
2106              WeeChats have dropped the -curses part of  their  program  name,
2107              i.e.: weechat instead of weechat-curses.
2108
2109

CONFIGURATION FILE

2111       inxi  will read its configuration/initialization files in the following
2112       order:
2113
2114       /etc/inxi.conf contains the default configurations. These can be  over‐
2115       ridden  by  user configurations found in one of the following locations
2116       (inxi will store its config file using  the  following  precedence:  if
2117       $XDG_CONFIG_HOME   is   not   empty,   it   will   go  there,  else  if
2118       $HOME/.conf/inxi.conf exists, it will go there, and as a last  default,
2119       the legacy location is used), i.e.:
2120
2121       $XDG_CONFIG_HOME/inxi.conf        >       $HOME/.conf/inxi.conf       >
2122       $HOME/.inxi/inxi.conf
2123
2124

CONFIGURATION OPTIONS

2126       See the documentation page for more complete information on how to  set
2127       these up, and for a complete list of options:
2128
2129       https://smxi.org/docs/inxi-configuration.htm
2130
2131       Basic Options
2132              Here's  a  brief overview of the basic options you are likely to
2133              want to use:
2134
2135              COLS_MAX_CONSOLE The max display column width on  terminal.   If
2136              terminal/console width or --width is less than wrap width, wrap‐
2137              ping of line starter occurs COLS_MAX_IRC The max display  column
2138              width on IRC clients.
2139
2140              COLS_MAX_NO_DISPLAY The max display column width in console, out
2141              of GUI desktop.
2142
2143              CPU_SLEEP Decimal value 0 or more.  Default  is  usually  around
2144              0.35  seconds.  Time  that  inxi will 'sleep' before getting CPU
2145              speed data, so that it reflects actual system state.
2146
2147              DOWNLOADER Sets default inxi downloader: curl, fetch, ftp, perl,
2148              wget.  See --recommends output for more information on download‐
2149              ers and Perl downloaders.
2150
2151              FILTER_STRING Default <filter>. Any string you prefer to see in‐
2152              stead for filtered values.
2153
2154              LIMIT  Overrides default of 10 IP addresses per IF. This is only
2155              of interest to sys admins  running  servers  with  many  IP  ad‐
2156              dresses.
2157
2158              NO_DIG  Set  to 1 or true to disable WAN IP use of dig and force
2159              use of alternate downloaders.
2160
2161              NO_DOAS Set to 1 or true to disable internal use of doas.
2162
2163              NO_HTML_WAN Set to 1 or true to disable WAN IP use of HTML Down‐
2164              loaders and force use of dig only, or nothing if dig disabled as
2165              well. Same as --no-html-wan. Only use if  dig  is  failing,  and
2166              HTML downloaders are hanging.
2167
2168              NO_SUDO Set to 1 or true to disable internal use of sudo.
2169
2170              PARTITION_SORT  Overrides  default  partition  output  sort. See
2171              --partition-sort for options.
2172
2173              PS_COUNT The default number of items showing per -t type,  m  or
2174              c. Default is 5.
2175
2176              SENSORS_CPU_NO  In  cases  of  ambiguous temp1/temp2 (inxi can't
2177              figure out which is the CPU),  forces  sensors  to  use   either
2178              value  1  or  2  as CPU temperature. See the above configuration
2179              page on smxi.org for full info.
2180
2181              SENSORS_EXCLUDE Exclude supplied  sensor  array[s]  from  sensor
2182              output. Override with --sensors-default. See --sensors-exclude.
2183
2184              SENSORS_USE  Use  only  supplied  sensor array[s]. Override with
2185              --sensors-default. See --sensors-use.
2186
2187              SEP2_CONSOLE Replaces default key / value separator of ':'.
2188
2189              USB_SYS Forces all USB data to use /sys instead of lsusb.
2190
2191              WAN_IP_URL Forces -i to use supplied URL, and  to  not  use  dig
2192              (dig is generally much faster). URL must begin with http or ftp.
2193              Note that if you use this, the downloader  set  tests  will  run
2194              each  time  you start inxi whether a downloader feature is going
2195              to be used or not.
2196
2197              The IP address from the URL must be the last item  on  the  last
2198              (non-empty) line of the URL's page content source code.
2199
2200              Same as --wan-ip-url [URL]
2201
2202              WEATHER_SOURCE  Values:  [0-9]. Same as --weather-source. Values
2203              4-9 are not currently supported, but  this  can  change  at  any
2204              time.
2205
2206              WEATHER_UNIT Values: [m|i|mi|im]. Same as --weather-unit.
2207
2208              WRAP_MAX  (previously  INDENT_MIN)  The  maximum width where the
2209              line starter wraps to its own line. If terminal/console width or
2210              --width  is  less  than wrap width, wrapping of line starter oc‐
2211              curs. Overrides default. See --wrap-max.  If 80  or  less,  wrap
2212              will never happen.
2213
2214
2215       Color Options
2216              It's  best  to use the -c [94-99] color selector tool to set the
2217              following values because it will correctly update the configura‐
2218              tion  file  and  remove any invalid or conflicting items, but if
2219              you prefer to create your own configuration files, here are  the
2220              options.  All  take the integer value from the options available
2221              in -c 94-99.
2222
2223              NOTE: All default and configuration file set  color  values  are
2224              removed when output is piped or redirected. You must use the ex‐
2225              plicit -c <color number> option if you want colors to be present
2226              in the piped/redirected output (creating a PDF for example).
2227
2228              CONSOLE_COLOR_SCHEME The color scheme for console output (not in
2229              X/Wayland).
2230
2231              GLOBAL_COLOR_SCHEME Overrides all other color schemes.
2232
2233              IRC_COLOR_SCHEME Desktop X/Wayland IRC CLI color scheme.
2234
2235              IRC_CONS_COLOR_SCHEME Out of X/Wayland, IRC CLI color scheme.
2236
2237              IRC_X_TERM_COLOR_SCHEME In X/Wayland IRC client  terminal  color
2238              scheme.
2239
2240              VIRT_TERM_COLOR_SCHEME  Color scheme for virtual terminal output
2241              (in X/Wayland).
2242
2243

BUGS

2245       Please report bugs using the following resources.
2246
2247       You may be asked to run the inxi debugger  tool  (see  --debug  21/22),
2248       which  will  upload  a  data  dump of system files for use in debugging
2249       inxi. These data dumps are very important since they  provide  us  with
2250       all the real system data inxi uses to parse out its report.
2251
2252       Issue Report
2253              File an issue report: https://github.com/smxi/inxi/issues
2254
2255       Forums Post   on   inxi   forums:   https://techpatterns.com/forums/fo
2256              rum-33.html
2257
2258       IRC irc.oftc.net#smxi
2259              You can also visit irc.oftc.net channel: #smxi to post issues.
2260
2261

HOMEPAGE

2263       https://github.com/smxi/inxi
2264
2265       https://smxi.org/docs/inxi.htm
2266
2267

AUTHOR AND CONTRIBUTORS TO CODE

2269       inxi is a fork of locsmif's very clever infobash script.
2270
2271       Original infobash author and copyright holder: Copyright (C)  2005-2007
2272       Michiel de Boer aka locsmif
2273
2274       inxi version: Copyright (C) 2008-2021 Harald Hope
2275
2276       This  man  page was originally created by Gordon Spencer (aka aus9) and
2277       is maintained by Harald Hope (aka h2 or TechAdmin).
2278
2279       Initial CPU logic, konversation version logic,  occasional  maintenance
2280       fixes,  and  the  initial  xiin.py tool for /sys parsing (obsolete, but
2281       still very much appreciated for  all  the  valuable  debugger  data  it
2282       helped generate): Scott Rogers
2283
2284       Further fixes (listed as known):
2285
2286       Horst Tritremmel <hjt at sidux.com>
2287
2288       Steven  Barrett  (aka:  damentz)  -  USB audio patch; swap percent used
2289       patch.
2290
2291       Jarett.Stevens - dmidecode -M patch for older systems with no /sys.
2292
2293

SPECIAL THANKS TO THE FOLLOWING

2295       The nice people at irc.oftc.net channels #linux-smokers-club and #smxi,
2296       who   all  really  have to be considered to be co-developers because of
2297       their non-stop enthusiasm and willingness to provide real-time  testing
2298       and debugging of inxi development.
2299
2300       Siduction  forum  members, who have helped get some features working by
2301       providing a large number of datasets that have revealed possible varia‐
2302       tions, particularly for the RAM -m option.
2303
2304       AntiX users and admins, who have helped greatly with testing and debug‐
2305       ging, particularly for the 3.0.0 release.
2306
2307       ArcherSeven (Max), Brett Bohnenkamper (aka KittyKatt), and Iotaka,  who
2308       always  manage to find the weirdest or most extreme hardware and setups
2309       that help make inxi much more robust.
2310
2311       For the vastly underrated skill of output error/glitch  catching,  Pete
2312       Haddow. His patience and focus in going through inxi repeatedly to find
2313       errors and inconsistencies is much appreciated.
2314
2315       All the inxi package maintainers, distro support people, forum  modera‐
2316       tors, and in particular, sys admins with their particular issues, which
2317       almost always help make inxi better,  and  any  others  who  contribute
2318       ideas, suggestions, and patches.
2319
2320       Without a wide range of diverse Linux kernel-based Free Desktop systems
2321       to test on, we could never have gotten inxi to be as reliable and solid
2322       as it's turning out to be.
2323
2324       And  of  course,  a big thanks to locsmif, who figured out a lot of the
2325       core methods, logic, and tricks originally used in inxi Gawk/Bash.
2326
2327
2328
2329
2330inxi                              2021-03-17                           INXI(1)
Impressum