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]   [--sen‐
19       sors-default] [--slots]
20
21       inxi [-x|-xx|-xxx|-a] -OPTION(s)
22
23       All short form options have long form variants - see  below  for  these
24       and more advanced options.
25
26

DESCRIPTION

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

PRIVACY AND SECURITY

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

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,
56       except  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
58       options. 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,
199              unmounted  partitions  are  not  counted in disk use percentages
200              since 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
236              example:
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
276              unless 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
302              defaults 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:
342              BusID-port[.port][.port]:DeviceID
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
438              capacity, number of  devices  supported,  and  Error  Correction
439              information. Devices shows locator data (highly variable in syn‐
440              tax), 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
518              detected. If you get an incorrect  output,  post  an  issue  and
519              we'll 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
548              array) 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
630              reporting 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
696              /usr/local/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
728              advanced 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), RAID (-R);
747              triggers -xxx
748
749
750       -v 8   - All system data available. Adds Logical (-L), Repos (-r),  PCI
751              slots  (--slots), processes (-tcm), admin (--admin).  Useful for
752              testing output and to see what data you can get from  your  sys‐
753              tem.
754
755
756       -w, --weather
757              Adds weather line. To get weather for an alternate location, use
758              -W [location]. See also -x, -xx, -xxx options.  Please note that
759              your  distribution's  maintainer  may chose to disable this fea‐
760              ture.
761
762              DO NOT USE THIS FEATURE FOR AUTOMATED WEATHER UPDATES! You  will
763              be  blocked  from  any further access. This feature is not meant
764              for widget type weather monitoring, or Conky  type  use.  It  is
765              meant  to get weather when you need to see it, for example, on a
766              remote server.
767
768
769       -W, --weather-location <location_string>
770              Get weather/time for an alternate location.  Accepts  postal/zip
771              code[,  country],  city,state pair, or latitude,longitude. Note:
772              city/country/state names must not contain spaces. Replace spaces
773              with '+' sign. Don't place spaces around any commas. Postal code
774              is not reliable except for North America and maybe the UK.   Try
775              postal  codes  with  and  without  country code added. Note that
776              City,State applies only to USA, otherwise it's City,Country.  If
777              country  name  (english)  does not work, try 2 character country
778              code (e.g. Spain: es; Great Britain: gb).
779
780              See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 for current
781              2 letter country codes.
782
783              Use only ASCII letters in city/state/country names.
784
785              Examples: -W 95623,us OR -W Boston,MA OR -W 45.5234,-122.6762 OR
786              -W new+york,ny OR -W bodo,norway.
787
788              DO NOT USE THIS FEATURE FOR AUTOMATED WEATHER  UPDATES!  Use  of
789              automated  queries, will result in your access being blocked. If
790              you try to work around the ban, you will be  permanently  banned
791              from this service.
792
793
794       --weather-source, --ws <unit>
795              [1-9] Switches weather data source. Possible values are 1-9. 1-4
796              will generally be active, and 5-9 may or may not be  active,  so
797              check.  1 may not support city / country names with spaces (even
798              if you use the + sign instead of space). 2  offers  pretty  good
799              data, but may not have all small city names for -W.
800
801              Please  note that the data sources are not static per value, and
802              can change any time, or be removed, so  always  test  to  verify
803              which  source  is being used for each value if that is important
804              to you. Data sources may be added or removed  on  occasions,  so
805              try  each  one  and see which you prefer. If you get unsupported
806              source message, it means that number has not been implemented.
807
808
809       --weather-unit <unit>
810              [m|i|mi|im] Sets weather units to metric (m), imperial (i), met‐
811              ric  (imperial) (mi, default), imperial (metric) (im). If metric
812              or imperial not found,sets to default value, or N/A.
813
814
815       -y, --width [integer]
816              This is an absolute width override which sets  the  output  line
817              width  max.   Overrides COLS_MAX_IRC / COLS_MAX_CONSOLE globals,
818              or the actual widths of the terminal. 80 is  the  minimum  width
819              supported.   -1  removes  width  limits.  1 switches to a single
820              indented key/value pair per line,  and  removes  all  long  line
821              wrapping (similar to dmidecode output).
822
823              If no integer value is given, sets width to default of 80.
824
825              Examples: inxi -Fxx -y 130 or inxi -Fxxy or inxi -bay1
826
827
828       -z, --filter
829              Adds  security  filters  for  IP addresses, serial numbers, MAC,
830              location (-w), and user home directory name. Removes Host:.   On
831              by default for IRC clients.
832
833
834       -Z, --filter-override
835              Absolute  override for output filters. Useful for debugging net‐
836              working issues in IRC for example.
837
838

EXTRA DATA OPTIONS

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

ADMIN EXTRA DATA OPTIONS

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

ADVANCED OPTIONS

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

DEBUGGING OPTIONS

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

DEBUGGING OPTIONS TO DEBUG DEBUGGER FAILURES

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

SUPPORTED IRC CLIENTS

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

RUNNING IN IRC CLIENT

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

CONFIGURATION FILE

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

CONFIGURATION OPTIONS

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

BUGS

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

HOMEPAGE

2266       https://github.com/smxi/inxi
2267
2268       https://smxi.org/docs/inxi.htm
2269
2270

AUTHOR AND CONTRIBUTORS TO CODE

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

SPECIAL THANKS TO THE FOLLOWING

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