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

NAME

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

SYNOPSIS

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

DESCRIPTION

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

PRIVACY AND SECURITY

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

USING OPTIONS

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

STANDARD OPTIONS

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

EXTRA DATA OPTIONS

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

ADMIN EXTRA DATA OPTIONS

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

ADVANCED OPTIONS

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

DEBUGGING OPTIONS

2011       --dbg 1
2012              - Debug downloader failures. Turns  off  silent/quiet  mode  for
2013              curl, wget, and fetch. Shows more downloader action information.
2014              Shows some more information for Perl downloader.
2015
2016
2017       --dbg [2-xx]
2018              - See github inxi-perl/docs/inxi-values.txt  for  specific  spe‐
2019              cialized debugging options.
2020
2021
2022       --debug [1-3]
2023              - On screen debugger output.
2024
2025
2026       --debug 10
2027              -   Basic   logging.   Check   $XDG_DATA_HOME/inxi/inxi.log   or
2028              $HOME/.local/share/inxi/inxi.log or $HOME/.inxi/inxi.log.
2029
2030
2031       --debug 11
2032              - Full file/system info logging.
2033
2034
2035       --debug 20
2036              Creates a tar.gz file of system data and collects the inxi  out‐
2037              put in a file.
2038
2039              *  tree  traversal  data  file(s)  read from /proc and /sys, and
2040              other system data.
2041
2042              * xorg conf and log data, xrandr, xprop, xdpyinfo, glxinfo etc.
2043
2044              * data from dev, disks, partitions, etc.
2045
2046
2047       --debug 21
2048              Automatically uploads debugger data tar.gz file to ftp.smxi.org,
2049              then  removes  the  debug  data  directory, but leaves the debug
2050              tar.gz file.  See --ftp for uploading to alternate locations.
2051
2052
2053       --debug 22
2054              Automatically uploads debugger data tar.gz file to ftp.smxi.org,
2055              then  removes the debug data directory and the tar.gz file.  See
2056              --ftp for uploading to alternate locations.
2057
2058
2059       --ftp [ftp.yoursite.com/incoming]
2060              For alternate ftp upload locations: Example:
2061
2062              inxi --ftp ftp.yourserver.com/incoming --debug 21
2063
2064

DEBUGGING OPTIONS TO DEBUG DEBUGGER FAILURES

2066       Only use the following in conjunction with --debug 2[012], and only use
2067       if you experienced a failure or hang, or were instructed to do so.
2068
2069
2070       --debug-proc
2071              Force  debugger  to parse /proc directory data when run as root.
2072              Normally this is disabled due to  unpredictable  data  in  /proc
2073              tree.
2074
2075
2076       --debug-proc-print
2077              Use this to locate file that /proc debugger hangs on.
2078
2079
2080       --debug-no-exit
2081              Skip exit on error when running debugger.
2082
2083
2084       --debug-no-proc
2085              Skip /proc debugging in case of a hang.
2086
2087
2088       --debug-no-sys
2089              Skip /sys debugging in case of a hang.
2090
2091
2092       --debug-sys
2093              Force PowerPC debugger parsing of /sys as doas[BSDs]/sudo/root.
2094
2095
2096       --debug-sys-print
2097              Use this to locate file that /sys debugger hangs on.
2098
2099

SUPPORTED IRC CLIENTS

2101       BitchX,  Gaim/Pidgin, ircII, Irssi, Konversation, Kopete, KSirc, KVIrc,
2102       Weechat, and Xchat. Plus any others that are capable of displaying  ei‐
2103       ther built-in or external script output.
2104
2105

RUNNING IN IRC CLIENT

2107       To  trigger inxi output in your IRC client, pick the appropriate method
2108       from the list below:
2109
2110       Hexchat, XChat, Irssi
2111              (and many other IRC clients) /exec  -o  inxi  [options]  If  you
2112              don't include the -o, only you will see the output on your local
2113              IRC client.
2114
2115       Konversation
2116              /cmd inxi [options]
2117
2118              To run inxi in Konversation as a native script if your distribu‐
2119              tion  or  inxi  package hasn't already done this for you, create
2120              this symbolic link:
2121
2122              KDE 4: ln -s /usr/local/bin/inxi  /usr/share/kde4/apps/konversa‐
2123              tion/scripts/inxi
2124
2125              KDE    5:   ln   -s   /usr/local/bin/inxi   /usr/share/konversa‐
2126              tion/scripts/inxi
2127
2128              If inxi is somewhere else, change  the  path  /usr/local/bin  to
2129              wherever it is located.
2130
2131              If  you  are  using  KDE/QT 5, then you may also need to add the
2132              following to get the Konversation /inxi command to work:
2133
2134              ln -s /usr/share/konversation /usr/share/apps/
2135
2136              Then you can start inxi directly, like this:
2137
2138              /inxi [options]
2139
2140       WeeChat
2141              NEW: /exec -o inxi [options]
2142
2143              OLD: /shell -o inxi [options]
2144
2145              Newer (2014 and later) WeeChats work pretty much the same now as
2146              other  console  IRC clients, with /exec -o inxi [options]. Newer
2147              WeeChats have dropped the -curses part of  their  program  name,
2148              i.e.: weechat instead of weechat-curses.
2149
2150

CONFIGURATION FILE

2152       inxi  will read its configuration/initialization files in the following
2153       order:
2154
2155       /etc/inxi.conf contains the default configurations. These can be  over‐
2156       ridden by creating a /etc/inxi.d/inxi.conf file (global override, which
2157       will prevent distro packages from changing or overwriting  your  edits.
2158       This  method is recommended if you are using a distro packaged inxi and
2159       want to override some configuration items from  the  package's  default
2160       /etc/inxi.conf  file  but  don't want to lose your changes on a package
2161       update.
2162
2163       You can old override, per user, with a user configuration file found in
2164       one  of  the following locations (inxi will store its config file using
2165       the following precedence:
2166
2167       if  $XDG_CONFIG_HOME  is  not  empty,  it  will  go  there,   else   if
2168       $HOME/.conf/inxi.conf  exists, it will go there, and as a last default,
2169       the legacy location is used), i.e.:
2170
2171       $XDG_CONFIG_HOME/inxi.conf       >       $HOME/.conf/inxi.conf        >
2172       $HOME/.inxi/inxi.conf
2173
2174

CONFIGURATION OPTIONS

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

BUGS

2295       Please report bugs using the following resources.
2296
2297       You  may  be  asked  to run the inxi debugger tool (see --debug 21/22),
2298       which will upload a data dump of system  files  for  use  in  debugging
2299       inxi.  These  data  dumps are very important since they provide us with
2300       all the real system data inxi uses to parse out its report.
2301
2302       Issue Report
2303              File an issue report: https://github.com/smxi/inxi/issues
2304
2305       Forums Post   on   inxi   forums:   https://techpatterns.com/forums/fo
2306              rum-33.html
2307
2308       IRC irc.oftc.net#smxi
2309              You can also visit irc.oftc.net channel: #smxi to post issues.
2310
2311

HOMEPAGE

2313       https://github.com/smxi/inxi
2314
2315       https://smxi.org/docs/inxi.htm
2316
2317

AUTHOR AND CONTRIBUTORS TO CODE

2319       inxi is a fork of locsmif's very clever infobash script.
2320
2321       Original  infobash author and copyright holder: Copyright (C) 2005-2007
2322       Michiel de Boer aka locsmif
2323
2324       inxi version: Copyright (C) 2008-2021 Harald Hope
2325
2326       This man page was originally created by Gordon Spencer (aka  aus9)  and
2327       is maintained by Harald Hope (aka h2 or TechAdmin).
2328
2329       Initial  CPU  logic, konversation version logic, occasional maintenance
2330       fixes, and the initial xiin.py tool for  /sys  parsing  (obsolete,  but
2331       still  very  much  appreciated  for  all  the valuable debugger data it
2332       helped generate): Scott Rogers
2333
2334       Further fixes (listed as known):
2335
2336       Horst Tritremmel <hjt at sidux.com>
2337
2338       Steven Barrett (aka: damentz) - USB  audio  patch;  swap  percent  used
2339       patch.
2340
2341       Jarett.Stevens - dmidecode -M patch for older systems with no /sys.
2342
2343

SPECIAL THANKS TO THE FOLLOWING

2345       The nice people at irc.oftc.net channels #linux-smokers-club and #smxi,
2346       who all really have to be considered to  be  co-developers  because  of
2347       their  non-stop enthusiasm and willingness to provide real-time testing
2348       and debugging of inxi development.
2349
2350       Siduction forum members, who have helped get some features  working  by
2351       providing a large number of datasets that have revealed possible varia‐
2352       tions, particularly for the RAM -m option.
2353
2354       AntiX users and admins, who have helped greatly with testing and debug‐
2355       ging, particularly for the 3.0.0 release.
2356
2357       ArcherSeven  (Max), Brett Bohnenkamper (aka KittyKatt), and Iotaka, who
2358       always manage to find the weirdest or most extreme hardware and  setups
2359       that help make inxi much more robust.
2360
2361       For  the  vastly underrated skill of output error/glitch catching, Pete
2362       Haddow.  His patience and focus in going  through  inxi  repeatedly  to
2363       find errors and inconsistencies is much appreciated.
2364
2365       For  a huge boost to BSD support, Stan Vandiver, who did a lot of test‐
2366       ing and setup many remote access systems for testing and development.
2367
2368       All the inxi package maintainers, distro support people, forum  modera‐
2369       tors, and in particular, sys admins with their particular issues, which
2370       almost always help make inxi better,  and  any  others  who  contribute
2371       ideas, suggestions, and patches.
2372
2373       Without a wide range of diverse Linux kernel-based Free Desktop systems
2374       to test on, we could never have gotten inxi to be as reliable and solid
2375       as it's turning out to be.
2376
2377       And  of  course,  a big thanks to locsmif, who figured out a lot of the
2378       core ideas, logic, and tricks originally used in inxi Gawk/Bash.
2379
2380
2381
2382
2383inxi                              2021-11-22                           INXI(1)
Impressum