1INXI(1) inxi manual INXI(1)
2
3
4
6 inxi - Command line system information script for console and IRC
7
8
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
2313 https://github.com/smxi/inxi
2314
2315 https://smxi.org/docs/inxi.htm
2316
2317
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
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)