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, dmidecode. dmidecode does not have very
83 much information, and none about current battery
84 state/charge/voltage. Supports multiple batteries when using
85 /sys data.
86
87 Note that for charge:, the output shows the current charge, as
88 well as its value as a percentage of the available capacity,
89 which can be less than the original design capacity. In the fol‐
90 lowing example, the actual current available capacity of the
91 battery is 22.2 Wh.
92
93 charge: 20.1 Wh (95.4%)
94
95 The condition: item shows the remaining available capacity /
96 original design capacity, and then this figure as a percentage
97 of original capacity available in the battery.
98
99 condition: 22.2/36.4 Wh (61%)
100
101 With -x, or if voltage difference is critical, volts: item shows
102 the current voltage, and the min: voltage. Note that if the cur‐
103 rent is below the minimum listed the battery is essentially dead
104 and will not charge. Test that to confirm, but that's techni‐
105 cally how it's supposed to work.
106
107 volts: 12.0 min: 11.4
108
109 With -x shows attached Device-x information (mouse, keyboard,
110 etc.) if they are battery powered.
111
112
113 --bluetooth - See -E
114
115
116 -c, --color [0-42]
117 Set color scheme. If no scheme number is supplied, 0 is assumed.
118
119
120 -c [94-99]
121
122 These color selectors run a color selector option prior to inxi
123 starting which lets you set the config file value for the selec‐
124 tion.
125
126 NOTE: All configuration file set color values are removed when
127 output is piped or redirected. You must use the explicit runtime
128 -c <color number> option if you want color codes to be present
129 in the piped/redirected output.
130
131 Color selectors for each type display (NOTE: IRC and global only
132 show safe color set):
133
134
135 -c 94 - Console, out of X.
136
137
138 -c 95 - Terminal, running in X - like xTerm.
139
140
141 -c 96 - GUI IRC, running in X - like XChat, Quassel, Konversation etc.
142
143
144 -c 97 - Console IRC running in X - like irssi in xTerm.
145
146
147 -c 98 - Console IRC not in X.
148
149
150 -c 99 - Global - Overrides/removes all settings.
151
152 Setting a specific color type removes the global color selec‐
153 tion.
154
155
156 -C, --cpu
157 Show full CPU output, including per CPU clock speed and CPU max
158 speed (if available). If max speed data present, shows (max) in
159 short output formats (inxi, inxi -b) if actual CPU speed matches
160 max CPU speed. If max CPU speed does not match actual CPU speed,
161 shows both actual and max speed information. See -x for more
162 options.
163
164 For certain CPUs (some ARM, and AMD Zen family) shows CPU die
165 count.
166
167 The details for each CPU include a technical description e.g.
168 type: MT MCP
169
170 * MT - Multi/Hyper Threaded CPU, more than 1 thread per core
171 (previously HT).
172
173 * MCM - Multi Chip Model (more than 1 die per CPU).
174
175 * MCP - Multi Core Processor (more than 1 core per CPU).
176
177 * SMP - Symmetric Multi Processing (more than 1 physical CPU).
178
179 * UP - Uni (single core) Processor.
180
181 Note that min/max: speeds are not necessarily true in cases of
182 overclocked CPUs or CPUs in turbo/boost mode. See -Ca for alter‐
183 nate base/boost: speed data.
184
185
186 -d, --disk-full,--optical
187 Show optical drive data as well as -D hard drive data. With -x,
188 adds a feature line to the output. Also shows floppy disks if
189 present. Note that there is no current way to get any informa‐
190 tion about the floppy device that we are aware of, so it will
191 simply show the floppy ID without any extra data. -xx adds a few
192 more features.
193
194
195 -D, --disk
196 Show Hard Disk info. Shows total disk space and used percentage.
197 The disk used percentage includes space used by swap parti‐
198 tion(s), since those are not usable for data storage. Also, un‐
199 mounted partitions are not counted in disk use percentages since
200 inxi has no access to the used amount.
201
202 If the system has RAID or other logical storage, and if inxi can
203 determine the size of those vs their components, you will see
204 the storage total raw and usable sizes, plus the percent used of
205 the usable size. The no argument short form of inxi will show
206 only the usable (or total if no usable) and used percent. If
207 there is no logical storage detected, only total: and used: will
208 show. Sample (with RAID logical size calculated):
209
210 Local Storage: total: raw: 5.49 TiB usable: 2.80 TiB used: 1.35
211 TiB (48.3%)
212
213 Without logical storage detected:
214
215 Local Storage: total: 2.89 TiB used: 1.51 TiB (52.3%)
216
217 Also shows per disk information: Disk ID, type (if present),
218 vendor (if detected), model, and size. See Extra Data Options
219 (-x options) and Admin Extra Data Options (--admin options) for
220 many more features.
221
222
223 -E, --bluetooth
224 Show bluetooth device(s), drivers. Show Report: (requires
225 bt-adapter or hciconfig) with HCI ID, state, address per device,
226 and if available (hciconfig only) bluetooth version (bt-v). See
227 Extra Data Options for more.
228
229 If bluetooth service is down or disabled, will show message.
230
231 Note that Report-ID: indicates that the HCI item was not able to
232 be linked to a specific device, similar to IF-ID: in -n.
233
234 If your internal bluetooth device does not show, it's possible
235 that it has been disabled, if you try enabling it using for ex‐
236 ample:
237
238 hciconfig hci0 up
239
240 and it returns a blocked by RF-Kill error, you can do one of
241 these:
242
243 connmanctl enable bluetooth
244
245 or
246
247 rfkill list bluetooth
248
249 rfkill unblock bluetooth
250
251
252 --filter, --filter-override - See -z, -Z.
253
254
255 --filter-label
256 Filter partition label names from -j, -o, -p, -P, and -Sa
257 (root=LABEL=...). Generally only useful in very specialized
258 cases.
259
260
261 --filter-uuid
262 Filter partition UUIDs from -j, -o, -p, -P, and -Sa
263 (root=UUID=...). Generally only useful in very specialized
264 cases.
265
266
267 -f, --flags
268 Show all CPU flags used, not just the short list. Not shown with
269 -F in order to avoid spamming. ARM CPUs: show features items.
270
271
272 -F, --full
273 Show Full output for inxi. Includes all Upper Case line letters
274 (except -J and -W) plus --swap, -s and -n. Does not show extra
275 verbose options such as -d -f -i -J -l -m -o -p -r -t -u -x un‐
276 less you use those arguments in the command, e.g.: inxi -Frmxx
277
278
279 -G, --graphics
280 Show Graphic device(s) information, including details of device
281 and display drivers (loaded:, and, if applicable: unloaded:,
282 failed:), display protocol (if available), display server
283 (and/or Wayland compositor), vendor and version number, e.g.:
284
285 Display: x11 server: Xorg 1.15.1
286
287 If protocol is not detected, shows:
288
289 Display: server: Xorg 1.15.1
290
291 Also shows screen resolution(s) (per monitor/X screen), OpenGL
292 renderer, OpenGL core profile version/OpenGL version.
293
294 Compositor information will show if detected using -xx option or
295 always if detected and Wayland.
296
297
298 -h, --help
299 The help menu. Features dynamic sizing to fit into terminal win‐
300 dow. Set script global COLS_MAX_CONSOLE if you want a different
301 default value, or use -y <width> to temporarily override the de‐
302 faults or actual window width.
303
304
305 -i, --ip
306 Show WAN IP address and local interfaces (latter requires ifcon‐
307 fig or ip network tool), as well as network output from -n. Not
308 shown with -F for user security reasons. You shouldn't paste
309 your local/WAN IP. Shows both IPv4 and IPv6 link IP addresses.
310
311
312 -I, --info
313 Show Information: processes, uptime, memory, IRC client (or
314 shell type if run in shell, not IRC), inxi version. See -Ix,
315 -Ixx, and -Ia for extra information (init type/version, run‐
316 level, packages).
317
318 Note: if -m is used or triggered, the memory item will show in
319 the main Memory: report of -m, not in Info:.
320
321 Rasberry Pi only: uses vcgencmd get_mem gpu to get gpu RAM
322 amount, if user is in video group and vcgencmd is installed.
323 Uses this result to increase the Memory: amount and used:
324 amounts.
325
326
327 -j, --swap
328 Shows all active swap types (partition, file, zram). When this
329 option is used, swap partition(s) will not show on the -P line
330 to avoid redundancy.
331
332
333 -J, --usb
334 Show USB data for attached Hubs and Devices. Hubs also show num‐
335 ber of ports. Be aware that a port is not always external, some
336 may be internal, and either used or unused (for example, a moth‐
337 erboard USB header connector that is not used).
338
339 Hubs and Devices are listed in order of BusID.
340
341 BusID is generally in this format: BusID-port[.port][.port]:De‐
342 viceID
343
344 Device ID is a number created by the kernel, and has no neces‐
345 sary ordering or sequence connection, but can be used to match
346 this output to lsusb values, which generally shows BusID / Devi‐
347 ceID (except for tree view, which shows ports).
348
349 Examples: Device-3: 4-3.2.1:2 or Hub: 4-0:1
350
351 The rev: 2.0 item refers to the USB revision number, like 1.0 or
352 3.1.
353
354
355 -l, --label
356 Show partition labels. Default: main partitions -P. For full -p
357 output, use: -pl.
358
359
360 -L, --logical
361 Show Logical volume information, for LVM, LUKS, bcache, etc.
362 Shows size, free space (for LVM VG). For LVM, shows Device-[xx]:
363 VG: (Volume Group) size/free, LV-[xx] (Logical Volume). LV shows
364 type, size, and components. Note that components are made up of
365 either containers (aka, logical devices), or physical devices.
366 The full report requires doas[BSDs]/sudo/root.
367
368 Logical block devices can be thought of as devices that are made
369 up out of either other logical devices, or physical devices.
370 inxi does its best to show what each logical device is made out
371 of. RAID devices form a subset of all possible Logical devices,
372 but have their own section, -R.
373
374 If -R is used with -Lxx, -Lxx will not show RAID information for
375 LVM RAID devices since it's redundant. If -R is not used, a sim‐
376 ple RAID line will appear for LVM RAID in -Lxx.
377
378 -Lxx also shows all components and devices. Note that since com‐
379 ponents can go in many levels, each level per primary component
380 is indicated by either another 'c', or ends with a 'p' device,
381 the physical device. The number of c's or p's indicates the
382 depth, so you can see which component belongs to which.
383
384 -L shows only the top level components/devices (like -R). -La
385 shows component/device size, maj:min ID, mapped name (if appli‐
386 cable), and puts each component/device on its own line.
387
388 Sample:
389
390 Device-10: mybackup type: LUKS dm: dm-28 size: 6.36 GiB Compo‐
391 nents: c-1: md1 cc-1: dm-26 ppp-1: sdj2 cc-2: dm-27 ppp-1: sdk2
392
393 LV-5: lvm_raid1 type: raid1 dm: dm-16 size: 4.88 GiB
394 RAID: stripes: 2 sync: idle copied: 100% mismatches: 0
395 Components: c-1: dm-10 pp-1: sdd1 c-2: dm-11 pp-1: sdd1 c-3: dm-13
396 pp-1: sde1 c-4: dm-15 pp-1: sde1
397
398 It is easier to follow the flow of components and devices using
399 -y1. In this example, there is one primary component (c-1), md1,
400 which is made up of two components (cc-1,2), dm-26 and dm-27.
401 These are respectively made from physical devices (p-1) sdj2 and
402 sdk2.
403
404 Device-10: mybackup
405 maj-min: 254:28
406 type: LUKS
407 dm: dm-28
408 size: 6.36 GiB
409 Components:
410 c-1: md1
411 maj-min: 9:1
412 size: 6.37 GiB
413 cc-1: dm-26
414 maj-min: 254:26
415 mapped: vg5-level1a
416 size: 12.28 GiB
417 ppp-1: sdj2
418 maj-min: 8:146
419 size: 12.79 GiB
420 cc-2: dm-27
421 maj-min: 254:27
422 mapped: vg5-level1b
423 size: 6.38 GiB
424 ppp-1: sdk2
425 maj-min: 8:162
426 size: 12.79 GiB
427
428 Other types of logical block handling like LUKS, bcache show as:
429
430 Device-[xx] [name/id] type: [LUKS|Crypto|bcache]:
431
432
433 -m, --memory
434 Memory (RAM) data. Does not display with -b or -F unless you
435 use -m explicitly. Ordered by system board physical system mem‐
436 ory array(s) (Array-[number]), and individual memory devices
437 (Device-[number]). Physical memory array data shows array ca‐
438 pacity, number of devices supported, and Error Correction infor‐
439 mation. Devices shows locator data (highly variable in syntax),
440 size, speed, type (eg: type: DDR3).
441
442 Note: -m uses dmidecode, which must be run as root (or start
443 inxi with sudo), unless you figure out how to set up
444 doas[BSDs]/sudo to permit dmidecode to read /dev/mem as user.
445 speed and bus-width will not show if No Module Installed is
446 found in size.
447
448 Note: If -m is triggered RAM total/used report will appear in
449 this section, not in -I or -tm items.
450
451 Because dmidecode data is extremely unreliable, inxi will try to
452 make best guesses. If you see (check) after the capacity num‐
453 ber, you should check it with the specifications. (est) is
454 slightly more reliable, but you should still check the real
455 specifications before buying RAM. Unfortunately there is nothing
456 inxi can do to get truly reliable data about the system RAM;
457 maybe one day the kernel devs will put this data into /sys, and
458 make it real data, taken from the actual system, not dmi data.
459 For most people, the data will be right, but a significant per‐
460 centage of users will have either a wrong max module size, if
461 present, or max capacity.
462
463 Under dmidecode, Speed: is the expected speed of the memory
464 (what is advertised on the memory spec sheet) and Configured
465 Clock Speed: is what the actual speed is now. To handle this, if
466 speed and configured speed values are different, you will see
467 this instead:
468
469 speed: spec: [specified speed] MT/S actual: [actual] MT/S
470
471 Also, if DDR, and speed in MHz, will change to: speed: [speed]
472 MT/S ([speed] MHz)
473
474 If the detected speed is logically absurd, like 1 MT/s or 69910
475 MT/s, adds: note: check. Sample:
476
477 Memory:
478 RAM: total: 31.38 GiB used: 20.65 GiB (65.8%)
479 Array-1: capacity: N/A slots: 4 note: check EC: N/A
480 Device-1: DIMM_A1 size: 8 GiB speed: 1600 MT/s (800 MHz)
481 Device-2: DIMM_A2 size: 8 GiB speed: spec: 1600 MT/s (800 MHz)
482 actual: 61910 MT/s (30955 MHz) note: check
483 Device-3: DIMM_B1 size: 8 GiB speed: 1600 MT/s (800 MHz)
484 Device-4: DIMM_B2 size: 8 GiB speed: spec: 1600 MT/s (800 MHz)
485 actual: 2 MT/s (1 MHz) note: check
486
487 See --memory-modules and --memory-short if you want a shorter
488 report.
489
490
491 --memory-modules
492 Memory (RAM) data. Show only RAM arrays and modules in Memory
493 report. Skip empty slots. See -m.
494
495
496 --memory-short
497 Memory (RAM) data. Show a one line RAM report in Memory. See -m.
498
499 Sample: Report: arrays: 1 slots: 4 modules: 2 type: DDR4
500
501
502 -M, --machine
503 Show machine data. Device, Motherboard, BIOS, and if present,
504 System Builder (Like Lenovo). Older systems/kernels without the
505 required /sys data can use dmidecode instead, run as root. If
506 using dmidecode, may also show BIOS/UEFI revision as well as
507 version. --dmidecode forces use of dmidecode data instead of
508 /sys. Will also attempt to show if the system was booted by
509 BIOS, UEFI, or UEFI [Legacy], the latter being legacy BIOS boot
510 mode in a system board using UEFI.
511
512 Device information requires either /sys or dmidecode. Note that
513 'other-vm?' is a type that means it's usually a VM, but inxi
514 failed to detect which type, or positively confirm which VM it
515 is. Primary VM identification is via systemd-detect-virt but
516 fallback tests that should also support some BSDs are used. Less
517 commonly used or harder to detect VMs may not be correctly de‐
518 tected. If you get an incorrect output, post an issue and we'll
519 get it fixed if possible.
520
521 Due to unreliable vendor data, device type will show: desktop,
522 laptop, notebook, server, blade, plus some obscure stuff that
523 inxi is unlikely to ever run on.
524
525
526 -n, --network-advanced
527 Show Advanced Network device information in addition to that
528 produced by -N. Shows interface, speed, MAC ID, state, etc.
529
530
531 -N, --network
532 Show Network device(s) information, including device driver.
533 With -x, shows Bus ID, Port number.
534
535
536 -o, --unmounted
537 Show unmounted partition information (includes UUID and LABEL if
538 available). Shows file system type if you have lsblk installed
539 (Linux only). For BSD/GNU Linux: shows file system type if file
540 is installed, and if you are root or if you have added to
541 /etc/sudoers (sudo v. 1.7 or newer):
542
543 <username> ALL = NOPASSWD: /usr/bin/file (sample)
544
545 BSD users: see man doas.conf for setup.
546
547 Does not show components (partitions that create the md-raid ar‐
548 ray) of md-raid arrays.
549
550
551 -p, --partitions-full
552 Show full Partition information (-P plus all other detected
553 mounted partitions).
554
555
556 -P, --partitions
557 Show basic Partition information. Shows, if detected: / /boot
558 /boot/efi /home /opt /tmp /usr /usr/home /var /var/tmp /var/log
559 (for android, shows /cache /data /firmware /system). If --swap
560 is not used, shows active swap partitions (never shows file or
561 zram type swap). Use -p to see all mounted partitions.
562
563
564 --processes - See -t
565
566
567 -r, --repos
568 Show distro repository data. Currently supported repo types:
569
570 APK (Alpine Linux + derived versions)
571
572 APT (Debian, Ubuntu + derived versions, as well as RPM based APT
573 distros like PCLinuxOS or Alt-Linux)
574
575 CARDS (NuTyX + derived versions)
576
577 EOPKG (Solus)
578
579 NIX (NixOS + other distros as alternate package manager)
580
581 PACMAN (Arch Linux, KaOS + derived versions)
582
583 PACMAN-G2 (Frugalware + derived versions)
584
585 PISI (Pardus + derived versions)
586
587 PKG (OpenBSD, FreeBSD, NetBSD + derived OS types)
588
589 PORTAGE (Gentoo, Sabayon + derived versions)
590
591 PORTS (OpenBSD, FreeBSD, NetBSD + derived OS types)
592
593 SCRATCHPKG (Venom + derived versions)
594
595 SLACKPKG (Slackware + derived versions)
596
597 TCE (TinyCore)
598
599 URPMI (Mandriva, Mageia + derived versions)
600
601 XBPS (Void)
602
603 YUM/ZYPP (Fedora, Red Hat, Suse + derived versions)
604
605 More will be added as distro data is collected. If yours is
606 missing please show us how to get this information and we'll try
607 to add it.
608
609 See -rx, -rxx, and -ra for installed package count information.
610
611
612 -R, --raid
613 Show RAID data. Shows RAID devices, states, levels, device/array
614 size, and components. See extra data with -x / -xx.
615
616 md-raid: If device is resyncing, also shows resync progress
617 line.
618
619 Note: Only md-raid, ZFS and hardware RAID are currently sup‐
620 ported. Other software RAID types may be added, if the software
621 RAID actually can be made to give the required output.
622
623 The component ID numbers work like this: mdraid: the numerator
624 is the actual mdraid component number; ZFS: the numerator is
625 auto-incremented counter only. Eg. Online: 1: sdb1
626
627 If hardware RAID is detected, shows basic information. Due to
628 complexity of adding hardware RAID device disk / RAID reports,
629 those will only be added if there is demand, and reasonable re‐
630 porting tools.
631
632
633 --recommends
634 Checks inxi application dependencies and recommends, as well as
635 directories, then shows what package(s) you need to install to
636 add support for each feature.
637
638
639 -s, --sensors
640 Show output from sensors if sensors installed/configured: Moth‐
641 erboard/CPU/GPU temperatures; detected fan speeds. GPU tempera‐
642 ture when available. Nvidia shows screen number for multiple
643 screens. IPMI sensors are also used (root required) if present.
644 See Advanced options --sensors-use or --sensors-exclude if you
645 want to use only a subset of all sensors, or exclude one.
646
647 --slots
648 Show PCI slots with type, speed, and status information.
649
650
651 --swap - See -j
652
653
654 -S, --system
655 Show System information: host name, kernel, desktop environment
656 (if in X), distro. With -xx show dm - or startx - (only shows if
657 present and running if out of X), and if in X, with -xxx show
658 more desktop info, e.g. taskbar or panel.
659
660
661 -t, --processes
662 [c|m|cm|mc NUMBER] Show processes. If no arguments, defaults to
663 cm. If followed by a number, shows that number of processes for
664 each type (default: 5; if in IRC, max: 5)
665
666 Make sure that there is no space between letters and numbers
667 (e.g. write as -t cm10).
668
669
670 -t c - CPU only. With -x, also shows memory for that process on same
671 line.
672
673
674 -t m - memory only. With -x, also shows CPU for that process on same
675 line. If the -I or -m lines are not triggered, will also show
676 the system RAM used/total information.
677
678
679 -t cm - CPU+memory. With -x, shows also CPU or memory for that process
680 on same line.
681
682
683 -u, --uuid
684 Show partition UUIDs. Default: main partitions -P. For full -p
685 output, use: -pu.
686
687
688 -U, --update
689 Note - Maintainer may have disabled this function.
690
691 If inxi -h has no listing for -U then it's disabled.
692
693 Auto-update script. Note: if you installed as root, you must be
694 root to update, otherwise user is fine. Also installs / updates
695 this man page to: /usr/local/share/man/man1 (if /usr/lo‐
696 cal/share/man/ exists AND there is no inxi man page in
697 /usr/share/man/man1, otherwise it goes to /usr/share/man/man1).
698 This requires that you be root to write to that directory. See
699 --man or --no-man to force or disable man install.
700
701
702 --usb - See -J
703
704
705 -V, --version
706 inxi version information. Prints information then exits.
707
708
709 -v, --verbosity
710 Script verbosity levels. If no verbosity level number is given,
711 0 is assumed. Should not be used with -b or -F.
712
713 Supported levels: 0-8 Examples : inxi -v 4 or inxi -v4
714
715
716 -v 0 - Short output, same as: inxi
717
718
719 -v 1 - Basic verbose, -S + basic CPU (cores, type, clock speed, and
720 min/max speeds, if available) + -G + basic Disk + -I.
721
722
723 -v 2 - Adds networking device (-N), Machine (-M) data, Battery (-B)
724 (if available). Same as: inxi -b
725
726
727 -v 3 - Adds advanced CPU (-C) and network (-n) data; triggers -x ad‐
728 vanced data option.
729
730
731 -v 4 - Adds partition size/used data (-P) for (if present): / /home
732 /var/ /boot. Shows full disk data (-D)
733
734
735 -v 5 - Adds audio device (-A), memory/RAM (-m), bluetooth data (-E)
736 (if present), sensors (-s), RAID data (if present), partition
737 label (-l), UUID (-u), full swap data (-j), and short form of
738 optical drives.
739
740
741 -v 6 - Adds full mounted partition data (-p), unmounted partition
742 data (-o), optical drive data (-d), USB (-J); triggers -xx extra
743 data option.
744
745
746 -v 7 - Adds network IP data (-i), forced bluetooth (-E), Logical
747 (-L), RAID (-R); triggers -xxx
748
749
750 -v 8 - All system data available. Adds Repos (-r), PCI slots
751 (--slots), processes (-tcm), admin (--admin). Useful for test‐
752 ing output and to see what data you can get from your system.
753
754
755 -w, --weather
756 Adds weather line. To get weather for an alternate location, use
757 -W [location]. See also -x, -xx, -xxx options. Please note that
758 your distribution's maintainer may chose to disable this fea‐
759 ture.
760
761 DO NOT USE THIS FEATURE FOR AUTOMATED WEATHER UPDATES! You will
762 be blocked from any further access. This feature is not meant
763 for widget type weather monitoring, or Conky type use. It is
764 meant to get weather when you need to see it, for example, on a
765 remote server.
766
767
768 -W, --weather-location <location_string>
769 Get weather/time for an alternate location. Accepts postal/zip
770 code[, country], city,state pair, or latitude,longitude. Note:
771 city/country/state names must not contain spaces. Replace spaces
772 with '+' sign. Don't place spaces around any commas. Postal code
773 is not reliable except for North America and maybe the UK. Try
774 postal codes with and without country code added. Note that
775 City,State applies only to USA, otherwise it's City,Country. If
776 country name (english) does not work, try 2 character country
777 code (e.g. Spain: es; Great Britain: gb).
778
779 See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 for current
780 2 letter country codes.
781
782 Use only ASCII letters in city/state/country names.
783
784 Examples: -W 95623,us OR -W Boston,MA OR -W 45.5234,-122.6762 OR
785 -W new+york,ny OR -W bodo,norway.
786
787 DO NOT USE THIS FEATURE FOR AUTOMATED WEATHER UPDATES! Use of
788 automated queries, will result in your access being blocked. If
789 you try to work around the ban, you will be permanently banned
790 from this service.
791
792
793 --weather-source, --ws <unit>
794 [1-9] Switches weather data source. Possible values are 1-9. 1-4
795 will generally be active, and 5-9 may or may not be active, so
796 check. 1 may not support city / country names with spaces (even
797 if you use the + sign instead of space). 2 offers pretty good
798 data, but may not have all small city names for -W.
799
800 Please note that the data sources are not static per value, and
801 can change any time, or be removed, so always test to verify
802 which source is being used for each value if that is important
803 to you. Data sources may be added or removed on occasions, so
804 try each one and see which you prefer. If you get unsupported
805 source message, it means that number has not been implemented.
806
807
808 --weather-unit <unit>
809 [m|i|mi|im] Sets weather units to metric (m), imperial (i), met‐
810 ric (imperial) (mi, default), imperial (metric) (im). If metric
811 or imperial not found,sets to default value, or N/A.
812
813
814 -y, --width [integer]
815 This is an absolute width override which sets the output line
816 width max. Overrides COLS_MAX_IRC / COLS_MAX_CONSOLE globals,
817 or the actual widths of the terminal. 80 is the minimum width
818 supported. -1 removes width limits. 1 switches to a single in‐
819 dented key/value pair per line, and removes all long line wrap‐
820 ping (similar to dmidecode output).
821
822 If no integer value is given, sets width to default of 80.
823
824 Examples: inxi -Fxx -y 130 or inxi -Fxxy or inxi -bay1
825
826
827 -z, --filter
828 Adds security filters for IP addresses, serial numbers, MAC, lo‐
829 cation (-w), and user home directory name. Removes Host:. On by
830 default for IRC clients.
831
832
833 -Z, --filter-override
834 Absolute override for output filters. Useful for debugging net‐
835 working issues in IRC for example.
836
837
839 These options can be triggered by one or more -x. Alternatively, the
840 -v options trigger them in the following way: -v 3 adds -x; -v 6 adds
841 -xx; -v 7 adds -xxx
842
843 These extra data triggers can be useful for getting more in-depth data
844 on various options. They can be added to any long form option list,
845 e.g.: -bxx or -Sxxx
846
847 There are 3 extra data levels:
848
849 -x, -xx, -xxx
850
851 OR
852
853 --extra 1, --extra 2, --extra 3
854
855 The following details show which lines / items display extra informa‐
856 tion for each extra data level.
857
858
859 -x -A - Adds (if available and/or relevant) vendor: item, which shows
860 specific vendor [product] information.
861
862 - Adds version/port(s)/driver version (if available) for each
863 device.
864
865 - Adds PCI/USB ID of each device.
866
867 - Adds non-running sound servers, if detected.
868
869
870 -x -B - Adds vendor/model, battery status (if battery present).
871
872 - Adds attached battery powered peripherals (Device-[number]:)
873 if detected (keyboard, mouse, etc.).
874
875 - Adds battery volts:, min: voltages. Note that if difference is
876 critical, that is current voltage is too close to minimum volt‐
877 age, shows without -x.
878
879
880 -x -C - Adds bogomips on CPU (if available)
881
882 - Adds boost: [enabled|disabled] if detected, aka turbo. Not all
883 CPUs have this feature.
884
885 - Adds CPU Flags (short list). Use -f to see full flag/feature
886 list.
887
888 - Adds CPU microarchitecture + revision (e.g. Sandy Bridge, K8,
889 ARMv8, P6, etc.). Only shows data if detected. Newer microarchi‐
890 tectures will have to be added as they appear, and require the
891 CPU family ID, model ID, and stepping.
892
893 Examples: arch: Sandy Bridge rev: 2, arch: K8 rev.F+ rev: 2
894
895 If unable to non-ambiguosly determine architecture, will show
896 something like: arch: Amber Lake note: check rev: 9
897
898
899 -x -d - Adds more items to Features line of optical drive; dds rev
900 version to optical drive.
901
902
903 -x -D - Adds HDD temperature with disk data.
904
905 Method 1: Systems running Linux kernels ~5.6 and newer should
906 have drivetemp module data available. If so, drive temps will
907 come from /sys data for each drive, and will not require root or
908 hddtemp. This method is MUCH faster than using hddtemp. Note
909 that NVMe drives do not require drivetemp.
910
911 If your drivetemp module is not enabled, enable it:
912
913 modprobe drivetemp
914
915 Once enabled, add drivetemp to /etc/modules or /etc/mod‐
916 ules-load.d/***.conf so it starts automatically.
917
918 If you see drive temps running as regular user and you did not
919 configure system to use doas[BSDs]/sudo hddtemp, then your sys‐
920 tem supports this feature. If no /sys data is found, inxi will
921 try to use hddtemp methods instead for that drive. Hint: if
922 temp is /sys sourced, the temp will be to 1 decimal, like 34.8,
923 if hddtemp sourced, they will be integers.
924
925 Method 2: if you have hddtemp installed, if you are root or if
926 you have added to /etc/sudoers (sudo v. 1.7 or newer):
927
928 <username> ALL = NOPASSWD: /usr/sbin/hddtemp (sample)
929
930 BSD users: see man doas.conf for setup.
931
932 You can force use of hddtemp for all drives using --hddtemp.
933
934 - If free LVM volume group size detected (root required), show
935 lvm-free: on Local Storage line. This is how much unused space
936 the VGs contain, that is, space not assigned to LVs.
937
938
939 -x -E (--bluetooth)
940 - Adds (if available and/or relevant) vendor: item, which shows
941 specific vendor [product] information.
942
943 - Adds PCI/USB Bus ID of each device.
944
945 - Adds driver version (if available) for each device.
946
947 - Adds (if available, and hciconfig only) LMP (HCI if no LMP
948 data, and HCI if HCI/LMP versions are different) version (if
949 available) for each HCI ID.
950
951
952 -x -G - Adds (if available and/or relevant) vendor: item, which shows
953 specific vendor [product] information.
954
955 - Adds direct rendering status.
956
957 - Adds (for single GPU, nvidia driver) screen number that GPU is
958 running on.
959
960 - Adds PCI/USB ID of each device.
961
962
963 -x -i - Adds IP v6 additional scope data, like Global, Site, Temporary
964 for each interface.
965
966 Note that there is no way we are aware of to filter out the dep‐
967 recated IP v6 scope site/global temporary addresses from the
968 output of ifconfig. The ip tool shows that clearly.
969
970 ip-v6-temporary - (ip tool only), scope global temporary. Scope
971 global temporary deprecated is not shown
972
973 ip-v6-global - scope global (ifconfig will show this for all
974 types, global, global temporary, and global temporary depre‐
975 cated, ip shows it only for global)
976
977 ip-v6-link - scope link (ip/ifconfig) - default for -i.
978
979 ip-v6-site - scope site (ip/ifconfig). This has been deprecated
980 in IPv6, but still exists. ifconfig may show multiple site val‐
981 ues, as with global temporary, and global temporary deprecated.
982
983 ip-v6-unknown - unknown scope
984
985
986 -x -I - Adds current init system (and init rc in some cases, like
987 OpenRC). With -xx, shows init/rc version number, if available.
988
989 - Adds default system gcc. With -xx, also show other installed
990 gcc versions.
991
992 - Adds current runlevel (not available with all init systems).
993
994 - Adds total packages discovered in system. See -xx and -a for
995 per package manager types output. Moves to Repos if -rx.
996
997 If your package manager is not supported, please file an issue
998 and we'll add it. That requires the full output of the query or
999 method to discover all installed packages on your system, as
1000 well of course as the command or method used to discover those.
1001
1002 - If in shell (i.e. not in IRC client), adds shell version num‐
1003 ber, if available.
1004
1005
1006 -x -j, -x --swap
1007 Add mapper:. See -x -o.
1008
1009
1010 -x -J (--usb)
1011 - For Devices, adds driver(s).
1012
1013
1014 -x -L, -x --logical
1015 - Adds dm: dm-x to VG > LV and other Device types. This can help
1016 tracking down which device belongs to what.
1017
1018
1019 -x -m, --memory-modules
1020 - If present, adds maximum memory module/device size in the Ar‐
1021 ray line. Only some systems will have this data available.
1022 Shows estimate if it can generate one.
1023
1024 - Adds device type in the Device line.
1025
1026
1027 -x -N - Adds (if available and/or relevant) vendor: item, which shows
1028 specific vendor [product] information.
1029
1030 - Adds version/port(s)/driver version (if available) for each
1031 device;
1032
1033 - Adds PCI/USB ID of each device.
1034
1035
1036 -x -o, -x -p, -x -P
1037 - Adds mapper: (the /dev/mapper/ partitioni ID) if mapped parti‐
1038 tion.
1039
1040 Example: ID-4: /home ... dev: /dev/dm-6 mapped: ar0-home
1041
1042
1043 -x -r - Adds Package info. See -Ix
1044
1045
1046 -x -R - md-raid: Adds second RAID Info line with extra data: blocks,
1047 chunk size, bitmap (if present). Resync line, shows blocks
1048 synced/total blocks.
1049
1050 - Hardware RAID: Adds driver version, Bus ID.
1051
1052
1053 -x -s - Adds basic voltages: 12v, 5v, 3.3v, vbat (ipmi, lm-sensors if
1054 present).
1055
1056
1057 -x -S - Adds Kernel gcc version.
1058
1059 - Adds to Distro: base: if detected. System base will only be
1060 seen on a subset of distributions. The distro must be both de‐
1061 rived from a parent distro (e.g. Mint from Ubuntu), and explic‐
1062 itly added to the supported distributions for this feature. Due
1063 to the complexity of distribution identification, these will
1064 only be added as relatively solid methods are found for each
1065 distribution system base detection.
1066
1067
1068 -x -t (--processes)
1069 - Adds memory use output to CPU (-xt c), and CPU use to memory
1070 (-xt m).
1071
1072
1073 -x -w, -W
1074 - Adds humidity and barometric pressure.
1075
1076 - Adds wind speed and direction.
1077
1078
1079 -xx -A - Adds vendor:product ID for each device.
1080
1081
1082 -xx -B - Adds serial number.
1083
1084
1085 -xx -C - Adds L1-cache: and L3-cache: if either are available. Requires
1086 dmidecode and doas[BSDs]/sudo/root.
1087
1088
1089 -xx -D - Adds disk serial number.
1090
1091 - Adds disk speed (if available). This is the theoretical top
1092 speed of the device as reported. This speed may be restricted by
1093 system board limits, eg. a SATA 3 drive on a SATA 2 board may
1094 report SATA 2 speeds, but this is not completely consistent,
1095 sometimes a SATA 3 device on a SATA 2 board reports its design
1096 speed.
1097
1098 NVMe drives: adds lanes, and (per direction) speed is calculated
1099 with lane speed * lanes * PCIe overhead. PCIe 1 and 2 have data
1100 rates of GT/s * .8 = Gb/s (10 bits required to transfer 8 bits
1101 of data). PCIe 3 and greater transfer data at a rate of GT/s *
1102 128/130 * lanes = Gb/s (130 bits required to transfer 128 bits
1103 of data).
1104
1105 For a PCIe 3 NVMe drive, with speed of 8 GT/s and 4 lanes (8GT/s
1106 * 128/130 * 4 = 31.6 Gb/s):
1107
1108 speed: 31.6 Gb/s lanes: 4
1109
1110
1111 -xx -E (--bluetooth)
1112 - Adds vendor:product ID of each device.
1113
1114 - Adds (hciconfig only) LMP subversion (and/or HCI revision if
1115 applicable) for each device.
1116
1117
1118 -xx -G - Adds vendor:product ID of each device.
1119
1120 - Adds Xorg compositor, if found (always shows for Wayland sys‐
1121 tems).
1122
1123 - For free drivers, adds OpenGL compatibility version number if
1124 available. For nonfree drivers, the core version and compati‐
1125 bility versions are usually the same. Example:
1126
1127 v: 3.3 Mesa 11.2.0 compat-v: 3.0
1128
1129 - If available, shows alternate: Xorg drivers. This means a
1130 driver on the default list of drivers Xorg automatically checks
1131 for the device, but which is not installed. For example, if you
1132 have nouveau driver, nvidia would show as alternate if it was
1133 not installed. Note that alternate: does NOT mean you should
1134 have it, it's just one of the drivers Xorg checks to see if is
1135 present and loaded when checking the device. This can let you
1136 know there are other driver options. Note that if you have ex‐
1137 plicitly set the driver in xorg.conf, Xorg will not create this
1138 automatic check driver list.
1139
1140 - If available, shows Xorg dpi (s-dpi:) for the active Xorg
1141 Screen (not physical monitor). Note that the physical monitor
1142 dpi and the Xorg dpi are not necessarily the same thing, and can
1143 vary widely.
1144
1145
1146 -xx -I - Adds init type version number (and rc if present).
1147
1148 - Adds other detected installed gcc versions (if present).
1149
1150 - Adds system default runlevel, if detected. Supports Sys‐
1151 temd/Upstart/SysVinit type defaults.
1152
1153 - Shows Packages: counts by discovered package manager types. In
1154 cases where only 1 type had results, does not show total after
1155 Packages:. Does not show installed package managers wtih 0 pack‐
1156 ages. See -a for full output. Moves to Repos if -rxx.
1157
1158 - Adds parent program (or tty) that started shell, if not IRC
1159 client.
1160
1161
1162 -xx -j (--swap), -xx -p, -xx -P
1163 - Adds swap priority to each swap partition (for -P) used, and
1164 for all swap types (for -j).
1165
1166
1167 -xx -J (--usb)
1168 - Adds vendor:chip id.
1169
1170
1171 -xx -L, -xx --logical
1172 - Adds internal LVM Logical volumes, like raid image and meta
1173 data volumes.
1174
1175 - Adds full list of Components, sub-components, and their physi‐
1176 cal devices.
1177
1178 - For LVM RAID, adds a RAID report line (if not -R). Read up on
1179 LVM documentation to better understand their use of the term
1180 'stripes'.
1181
1182
1183 -xx -m, --memory-modules
1184 - Adds memory device Manufacturer.
1185
1186 - Adds memory device Part Number (part-no:). Useful for order‐
1187 ing new or replacement memory sticks etc. Part numbers are
1188 unique, particularly if you use the word memory in the search as
1189 well. With -xxx, also shows serial number.
1190
1191 - Adds single/double bank memory, if data is found. Note, this
1192 may not be 100% right all of the time since it depends on the
1193 order that data is found in dmidecode output for type 6 and type
1194 17.
1195
1196
1197 -xx -M - Adds chassis information, if data is available. Also shows
1198 BIOS ROM size if using dmidecode.
1199
1200
1201 -xx -N - Adds vendor:product ID for each device.
1202
1203
1204 -xx -r - Adds Packages info. See -Ixx
1205
1206
1207 -xx -R - md-raid: Adds superblock (if present) and algorithm. If
1208 resync, shows progress bar.
1209
1210 - Hardware RAID: Adds Chip vendor:product ID.
1211
1212
1213 -xx -s - Adds DIMM/SOC voltages, if present (ipmi only).
1214
1215
1216 -xx -S - Adds display manager (dm) type, if present. If none, shows
1217 N/A. Supports most known display managers, including gdm, gdm3,
1218 idm, kdm, lightdm, lxdm, mdm, nodm, sddm, slim, tint, wdm, and
1219 xdm.
1220
1221 - Adds, if run in X, window manager type (wm), if available.
1222 Not all window managers are supported. Some desktops support us‐
1223 ing more than one window manager, so this can be useful to see
1224 what window manager is actually running. If none found, shows
1225 nothing. Uses a less accurate fallback tool wmctrl if ps tests
1226 fail to find data.
1227
1228 - Adds desktop toolkit (tk), if available (Xfce/KDE/Trinity).
1229
1230
1231 -xx --slots
1232 - Adds slot length.
1233
1234
1235 -xx -w, -W
1236 - Adds wind chill, heat index, and dew point, if available.
1237
1238 - Adds cloud cover, rain, snow, or precipitation (amount in pre‐
1239 vious hour to observation time), if available.
1240
1241
1242 -xxx -A
1243 - Adds, if present, serial number.
1244
1245 - Adds, if present, PCI/USB class ID.
1246
1247
1248 -xxx -B
1249 - Adds battery chemistry (e.g. Li-ion), cycles (NOTE: there ap‐
1250 pears to be a problem with the Linux kernel obtaining the cycle
1251 count, so this almost always shows 0. There's nothing that can
1252 be done about this glitch, the data is simply not available as
1253 of 2018-04-03), location (only available from dmidecode derived
1254 output).
1255
1256 - Adds attached device rechargeable: [yes|no] information.
1257
1258
1259 -xxx -C
1260 - Adds CPU voltage and external clock speed (this is the mother‐
1261 board speed). Requires doas[BSDs]/sudo/root and dmidecode.
1262
1263
1264 -xxx -D
1265 - Adds disk firmware revision number (if available).
1266
1267 - Adds disk partition scheme (in most cases), e.g. scheme: GPT.
1268 Currently not able to detect all schemes, but handles the most
1269 common, e.g. GPT or MBR.
1270
1271 - Adds disk rotation speed (in some but not all cases), e.g. ro‐
1272 tation: 7200 rpm or rotation: SSD if positive SSD identification
1273 was made. If no rotation or positive SSD ID found, nothing
1274 shows. Not all disks report this speed, so even if they are
1275 spinnning, no data will show.
1276
1277
1278 -xxx -E (--bluetooth)
1279 - Adds, if present, PCI/USB class ID.
1280
1281 - Adds (hciconfig only) HCI version, revision.
1282
1283
1284 -xxx -G
1285 - Adds, if present, PCI/USB class ID.
1286
1287
1288 -xxx -I
1289 - For Uptime: adds wakeups: to show how many times the machine
1290 has been woken from suspend state during current uptime period
1291 (if available, Linux only). 0 value means the machine has not
1292 been suspended.
1293
1294 - For Shell: adds (su|sudo|login) to shell name if present.
1295
1296 - For Shell: adds default: shell if different from running
1297 shell, and default shell v:, if available.
1298
1299 - For running-in: adds (SSH) to parent, if present. SSH detec‐
1300 tion uses the whoami test.
1301
1302
1303 -xxx -J (--usb)
1304 - Adds, if present, serial number for non hub devices.
1305
1306 - Adds interfaces: for non hub devices.
1307
1308 - Adds, if available, USB speed in Mbits/s or Gbits/s.
1309
1310 - Adds, if present, USB class ID.
1311
1312 - Adds, if non 0, max power in mA.
1313
1314
1315 -xxx -m, --memory-modules
1316 - Adds memory bus width: primary bus width, and if present, to‐
1317 tal width. e.g. bus width: 64 bit (total: 72 bits). Note that
1318 total / data widths are mixed up sometimes in dmidecode output,
1319 so inxi will take the larger value as the total if present. If
1320 no total width data is found, then inxi will not show that item.
1321
1322 - Adds device Type Detail, e.g. detail: DDR3 (Synchronous).
1323
1324 - Adds, if present, memory module voltage. Only some systems
1325 will have this data available.
1326
1327 - Adds device serial number.
1328
1329
1330 -xxx -N
1331 - Adds, if present, serial number.
1332
1333 - Adds, if present, PCI/USB class ID.
1334
1335
1336 -xxx -R
1337 - md-raid: Adds system mdraid support types (kernel support,
1338 read ahead, RAID events)
1339
1340 - zfs-raid: Adds portion allocated (used) by RAID array/device.
1341
1342 - Hardware RAID: Adds rev, ports, and (if available and/or rele‐
1343 vant) vendor: item, which shows specific vendor [product] infor‐
1344 mation.
1345
1346
1347 -xxx -S
1348 - Adds, if in X, or with --display, bar/dock/panel/tray items
1349 (info). If none found, shows nothing. Supports desktop items
1350 like gnome-panel, lxpanel, xfce4-panel, lxqt-panel, tint2,
1351 cairo-dock, trayer, and many others.
1352
1353 - Adds (if present), window manager (wm) version number.
1354
1355 - Adds (if present), display manager (dm) version number.
1356
1357 - Adds (if available, and in display), virtual terminal (vt)
1358 number. These are the same as ctrl+alt+F[x] numbers usually.
1359 Some systems have this, some don't, it varies.
1360
1361
1362 -xxx -w, -W
1363 - Adds location (city state country), observation altitude (if
1364 available), weather observation time (if available), sunset/sun‐
1365 rise (if available).
1366
1367
1369 These options are triggered with --admin or -a. Admin options are ad‐
1370 vanced output options, and are more technical, and mostly of interest
1371 to system administrators or other machine admins.
1372
1373 The --admin option sets -xxx, and only has to be used once. It will
1374 trigger the following features:
1375
1376
1377 -a -A - Adds, if present, possible alternate: kernel modules capable
1378 of driving each Device-x (not including the current driver:). If
1379 no non-driver modules found, shows nothing. NOTE: just because
1380 it lists a module does NOT mean it is available in the system,
1381 it's just something the kernel knows could possibly be used in‐
1382 stead.
1383
1384
1385 -a -C - Adds CPU family, model-id, and stepping (replaces rev of -Cx).
1386 Format is hexadecimal (decimal) if greater than 9, otherwise
1387 hexadecimal.
1388
1389 - Adds CPU microcode. Format is hexadecimal.
1390
1391 - Adds socket type (for motherboard CPU socket, if available).
1392 If results doubtful will list two socket types and note: check.
1393 Requires doas[BSDs]/sudo/root and dmidecode. The item in paren‐
1394 theses may simply be a different syntax for the same socket, but
1395 in general, check this before trusting it.
1396 Sample: socket: 775 (478) note: check
1397 Sample: socket: AM4
1398
1399 - Adds DMI CPU base and boost/turbo speeds. Requires
1400 doas[BSDs]/sudo/root and dmidecode. In some cases, like with
1401 overclocking or 'turbo' or 'boost' modes, voltage and external
1402 clock speeds may be increased, or short term limits raised on
1403 max CPU speeds. These are often not reflected in /sys based CPU
1404 min/max: speed results, but often are using this source.
1405
1406 Samples:
1407 CPU not overclocked, with boost, like Ryzen:
1408 Speed: 2861 MHz min/max: 1550/3400 MHz boost: enabled base/boost: 3400/3900
1409
1410 Overclocked 2900 MHz CPU, with no boost available:
1411 Speed: 2900 MHz min/max: 800/2900 MHz base/boost: 3350/3000
1412
1413 Overclocked 3000 MHz CPU, with boosted max speed:
1414 Speed: 4190 MHz min/max: 1200/3001 MHz base/boost: 3000/4000
1415
1416 Note that these numbers can be confusing, but basically, the
1417 base number is the actual normal top speed the CPU runs at with‐
1418 out boost mode, and the boost number is the max speed the CPU
1419 reports itself able to run at. The actual max speed may be
1420 higher than either value, or lower. The boost number appears to
1421 be hard-coded into the CPU DMI data, and does not seem to re‐
1422 flect actual max speeds that overclocking or other combinations
1423 of speed boosters can enable, as you can see from the example
1424 where the CPU is running at a speed faster than the min/max or
1425 base/boost values.
1426
1427 Note that the normal min/max: speeds do NOT show actual over‐
1428 clocked OR boost/turbo mode speeds, and appear to be hard-coded
1429 values, not dynamic real values. The base/boost: values are
1430 sometimes real, and sometimes not. base appears in general to
1431 be real.
1432
1433 - Adds CPU Vulnerabilities (bugs) as known by your current ker‐
1434 nel. Lists by Type: ... (status|mitigation): .... for systems
1435 that support this feature (Linux kernel 4.14 or newer, or
1436 patched older kernels).
1437
1438
1439 -a -d,-a -D
1440 - Adds logical and physical block size in bytes.
1441
1442 Using smartctl (requires doas[BSDs]/sudo/root privileges).
1443
1444 - Adds device model family, like Caviar Black, if available.
1445
1446 - Adds SATA type (eg 1.0, 2.6, 3.0) if a SATA device.
1447
1448 - Adds device kernel major:minor number (Linux only).
1449
1450 - Adds SMART report line: status, enabled/disabled, health, pow‐
1451 ered on, cycles, and some error cases if out of range values.
1452 Note that for Pre-fail items, it will show the VALUE and THRESH‐
1453 OLD numbers. It will also fall back for unknown attributes that
1454 are or have been failing and print out the Attribute name,
1455 value, threshold, and failing message. This way even for unhan‐
1456 dled Attribute names, you should get a solid report for full
1457 failure cases. Other cases may show if inxi believes that the
1458 item may be approaching failure. This is a guess so make sure to
1459 check the drive and smartctl full output to verify before taking
1460 any further action.
1461
1462 - Adds, for USB or other external drives, actual model name/se‐
1463 rial if available, and different from enclosure model/serial,
1464 and corrects block sizes if necessary. Adds in drive temperature
1465 for some drives as well, and other useful data.
1466
1467
1468 -a -E (--bluetooth)
1469 - Adds (hciconfig only) extra line to Report:, Info:. Includes,
1470 if available, ACL MTU, SCO MTU, Link policy, Link mode, and Ser‐
1471 vice Classes.
1472
1473
1474 -a -G Triggers a much more complete Screen/Monitor output on the Dis‐
1475 play: line of -G. Note that the basic feature requires xdpyinfo,
1476 and the advanced per monitor feature requires xrandr.
1477
1478 No support currently exists for Wayland since we so far can find
1479 no documentation or easy methods to extract this information
1480 from Wayland compositors. This unfortunate situation may change
1481 in the future, hopefully. However, most Wayland systems also
1482 come with xwayland, which should supply the tools necessary for
1483 the time being.
1484
1485 Further note that all references to Displays, Screens, and Moni‐
1486 tors are referring to the X technical terms, not normal consumer
1487 usage. 1 Display runs 1 or more Screens, and a Screen runs 1 or
1488 more Monitors.
1489
1490 - Adds Display ID, for the Display running the Screen that runs
1491 the Monitors.
1492
1493 - Adds total number of Screens listed for the current Display.
1494
1495 - Adds default Screen ID if Screen (not monitor!) total is
1496 greater than 1.
1497
1498 - Adds Screen line, which includes the ID (Screen: 0) then s-res
1499 (Screen resolution), s-dpi, s-size and s-diag. Remember, this is
1500 an Xorg Screen, NOT a monitor screen, and the information listed
1501 is about the Xorg Screen! It may at times be the same as a sin‐
1502 gle monitor system, but usually it's different in some ways.
1503
1504 - Adds Monitor ID(s). Monitors are a subset of a Screen, each of
1505 which can have one or more monitors. Normally a dual monitor
1506 setup is 2 monitors run by one Xorg Screen. Each monitor has the
1507 following data, if available:
1508
1509 - res: resolution in pixels. This is the individual monitor's
1510 reported pixel dimensions.
1511
1512 - hz: frequency in Herz, as reported to Xorg. Note that there
1513 have been and may continue to be bugs with how Xorg treats > 1
1514 monitor frequencies.
1515
1516 - dpi: dpi (dots per inch), aka, ppi (pixels per inch). This is
1517 the physical screen dpi, which is calculated using the screen
1518 dimensions and its resolution.
1519
1520 - size: size in mm (inches). Note that this is the real monitor
1521 size, not the Xorg Screen size, which can be quite different (1
1522 Xorg Screen can for instance contain two or more monitors).
1523
1524 - diag: monitor screen diagonal in mm (inches). Note that this
1525 is the real monitor size, not the Xorg full Screen diagonal
1526 size, which can be quite different.
1527
1528 Sample (with both xdpyinfo and xrandr data available):
1529 inxi -aG
1530 Graphics:
1531 ....
1532 Display: x11 server: X.Org 1.20.6 driver: loaded: modesetting
1533 display ID: :0.0 screens: 1
1534 Screen-1: 0 s-res: 2560x1024 s-dpi: 96 s-size: 677x271mm (26.7x10.7")
1535 s-diag: 729mm (28.7")
1536 Monitor-1: DVI-I-0 res: 1280x1024 hz: 60 dpi: 96
1537 size: 338x270mm (13.3x10.6") diag: 433mm (17")
1538 Monitor-2: VGA-0 res: 1280x1024 hz: 60 dpi: 86
1539 size: 376x301mm (14.8x11.9") diag: 482mm (19")
1540 ....
1541 - Adds, if present, possible alternate: kernel modules capable
1542 of driving each Device-x (not including the current loaded:). If
1543 no non-driver modules found, shows nothing. NOTE: just because
1544 it lists a module does NOT mean it is available in the system,
1545 it's just something the kernel knows could possibly be used in‐
1546 stead.
1547
1548
1549 -a -I - Adds Packages, totals, per package manager totals, and number
1550 of lib packages detected per package manager. Also adds detected
1551 package managers with 0 packages listed. Moves to Repos if -ra.
1552
1553 inxi -aI
1554 Info:
1555 ....
1556 Init: systemd v: 245 runlevel: 5 Compilers: gcc: 9.3.0 alt: 5/6/7/8/9
1557 Packages: apt: 3681 lib: 2096 rpm: 0 Shell: ksh v: A_2020.0.0 default: Bash
1558 v: 5.0.16 running-in: kate inxi: 3.1.04
1559
1560 - Adds service control tool, tested for in the following order:
1561 systemctl rc-service service sv /etc/rc.d /etc/init.d - useful
1562 to know which you need when using an unfamiliar machine.
1563
1564
1565 -a -j, -a -P [swap], -a -P [swap]
1566 - Adds swappiness and vfs cache pressure, and a message to indi‐
1567 cate if the value is the default value or not (Linux only, and
1568 only if available). If not the default value, shows default
1569 value as well, e.g.
1570
1571 For -P per swap physical partition:
1572
1573 swappiness: 60 (default) cache-pressure: 90 (default 100)
1574
1575 For -j row 1 output:
1576
1577 Kernel: swappiness: 60 (default) cache-pressure: 90 (default
1578 100)
1579
1580 - Adds device kernel major:minor number (Linux only).
1581
1582
1583 -a -L - Expands Component report, shows size / maj-min of components
1584 and devices, and mapped name for logical components. Puts each
1585 component/device on its own line.
1586
1587 - Adds maj-min to LV and other devices.
1588
1589
1590 -a -n, -a -N, -a -i
1591 - Adds, if present, possible alternate: kernel modules capable
1592 of driving each Device-x (not including the current driver:). If
1593 no non-driver modules found, shows nothing. NOTE: just because
1594 it lists a module does NOT mean it is available in the system,
1595 it's just something the kernel knows could possibly be used in‐
1596 stead.
1597
1598
1599 -a -o - Adds device kernel major:minor number (Linux only).
1600
1601
1602 -a -p,-a -P
1603 - Adds raw partition size, including file system overhead, par‐
1604 tition table, e.g.
1605
1606 raw-size: 60.00 GiB.
1607
1608 - Adds percent of raw size available to size: item, e.g.
1609
1610 size: 58.81 GiB (98.01%).
1611
1612 Note that used: 16.44 GiB (34.3%) percent refers to the avail‐
1613 able size, not the raw size.
1614
1615 - Adds partition filesystem block size if found (requires root
1616 and blockdev).
1617
1618 - Adds device kernel major:minor number (Linux only).
1619
1620
1621 -a -r - Adds Packages. See -Ia
1622
1623
1624 -a -R - Adds device kernel major:minor number (mdraid, Linux only).
1625
1626 - Adds, if available, component size, major:minor number, state
1627 (Linux only). Turns Component report to 1 component per line if
1628 size and major:minor present.
1629
1630
1631 -a -S - Adds kernel boot parameters to Kernel section (if detected).
1632 Support varies by OS type.
1633
1634
1636 --alt 40
1637 Bypass Perl as a downloader option. Priority is: Perl
1638 (HTTP::Tiny), Curl, Wget, Fetch, (OpenBSD only) ftp.
1639
1640
1641 --alt 41
1642 Bypass Curl as a downloader option. Priority is: Perl
1643 (HTTP::Tiny), Curl, Wget, Fetch, (OpenBSD only) ftp.
1644
1645
1646 --alt 42
1647 Bypass Fetch as a downloader option. Priority is: Perl
1648 (HTTP::Tiny), Curl, Wget, Fetch, (OpenBSD only) ftp.
1649
1650
1651 --alt 43
1652 Bypass Wget as a downloader option. Priority is: Perl
1653 (HTTP::Tiny), Curl, Wget, Fetch, OpenBSD only: ftp
1654
1655
1656 --alt 44
1657 Bypass Curl, Fetch, and Wget as downloader options. This basi‐
1658 cally forces the downloader selection to use Perl 5.x
1659 HTTP::Tiny, which is generally slower than Curl or Wget but it
1660 may help bypass issues with downloading.
1661
1662
1663 --bt-tool [bt-adapter|hciconfig]
1664 Force the use of the given tool for bluetooth report (-E).
1665
1666
1667 --dig Temporary override of NO_DIG configuration item. Only use to
1668 test w/wo dig. Restores default behavior for WAN IP, which is
1669 use dig if present.
1670
1671
1672 --display [:<integer>]
1673 Will try to get display data out of X (does not usually work as
1674 root user). Default gets display info from display :0. If you
1675 use the format --display :1 then it would get it from display 1
1676 instead, or any display you specify.
1677
1678 Note that in some cases, --display will cause inxi to hang end‐
1679 lessly when running the option in console with Intel graphics.
1680 The situation regarding other free drivers such as nouveau/ATI
1681 is currently unknown. It may be that this is a bug with the In‐
1682 tel graphics driver - more information is required.
1683
1684 You can test this easily by running the following command out of
1685 X/display server: glxinfo -display :0
1686
1687 If it hangs, --display will not work.
1688
1689
1690 --dmidecode
1691 Shortcut, legacy. See --force dmidecode.
1692
1693
1694 --downloader [curl|fetch|perl|wget]
1695 Force inxi to use Curl, Fetch, Perl, or Wget for downloads.
1696
1697
1698 --force [dmidecode|hddtemp|lsusb|usb-sys|vmstat|wmctl]
1699 Various force options to allow users to override defaults. Val‐
1700 ues be given as a comma separated list:
1701
1702 inxi -MJ --force dmidecode,lsusb
1703
1704 - dmidecode - Force use of dmidecode. This will override /sys
1705 data in some lines, e.g. -M or -B.
1706
1707 - hddtemp - Force use of hddtemp instead of /sys temp data for
1708 disks.
1709
1710 - lsusb - Forces the USB data generator to use lsusb as data
1711 source (default). Overrides USB_SYS in user configuration
1712 file(s).
1713
1714 - usb-sys - Forces the USB data generator to use /sys as data
1715 source instead of lsusb (Linux only).
1716
1717 - vmstat - Forces use of vmstat for memory data.
1718
1719 - wmctl - Force System item wm to use wmctrl as data source,
1720 override default ps source.
1721
1722
1723 --hddtemp
1724 Shortcut, legacy. See --force hddtemp.
1725
1726
1727 --host Turns on hostname in System line. Overrides inxi config file
1728 value (if set):
1729
1730 SHOW_HOST='false' - Same as: SHOW_HOST='true'
1731
1732 This is an absolute override, the host will always show no mat‐
1733 ter what other switches you use.
1734
1735
1736 --html-wan
1737 Temporary override of NO_HTML_WAN configuration item. Only use
1738 to test w/wo HTML downloaders for WAN IP. Restores default be‐
1739 havior for WAN IP, which is use HTML downloader if present and
1740 if dig failed.
1741
1742
1743 --limit [-1 - x]
1744 Raise or lower max output limit of IP addresses for -i. -1 re‐
1745 moves limit.
1746
1747
1748 --man Updates / installs man page with -U if pinxi or using -U 3 dev
1749 branch. (Only active if -U is is not disabled by maintainers).
1750
1751
1752 --no-dig
1753 Overrides default use of dig to get WAN IP address. Allows use
1754 of normal downloader tool to get IP addresses. Only use if dig
1755 is failing, since dig is much faster and more reliable in gen‐
1756 eral than other methods.
1757
1758
1759 --no-doas
1760 Skips the use of doas to run certain internal features (like hd‐
1761 dtemp, file) with doas. Not related to running inxi itself with
1762 doas/sudo or super user. Some systems will register errors
1763 which will then trigger admin emails in such cases, so if you
1764 want to disable regular user use of doas (which requires config‐
1765 uration to setup anyway for these options) just use this option,
1766 or NO_DOAS configuration item. See --no-sudo if you need to
1767 disable both types.
1768
1769
1770 --no-host
1771 Turns off hostname in System line. This is default when using
1772 -z, for anonymizing inxi output for posting on forums or IRC.
1773 Overrides configuration value (if set): indent-min
1774 SHOW_HOST='true' - Same as: SHOW_HOST='false'
1775
1776 This is an absolute override, the host will not show no matter
1777 what other switches you use.
1778
1779
1780 --no-html-wan
1781 Overrides use of HTML downloaders to get WAN IP address. Use ei‐
1782 ther only dig, or do not get wan IP. Only use if dig is failing,
1783 and the HTML downloaders are taking too long, or are hanging or
1784 failing. Make permanent with NO_HTML_WAN='true'
1785
1786
1787 --no-man
1788 Disables man page install with -U for master and active develop‐
1789 ment branches. (Only active if -U is is not disabled by main‐
1790 tainers).
1791
1792
1793 --no-sensor-force
1794 Overrides user set SENSOR_FORCE configuration value. Restores
1795 default behavior.
1796
1797
1798 --no-ssl
1799 Skip SSL certificate checks for all downloader actions (-U, -w,
1800 -W, -i). Use if your system does not have current SSL certifi‐
1801 cate lists, or if you have problems making a connection for any
1802 reason. Works with Wget, Curl, Perl HTTP::Tiny and Fetch.
1803
1804
1805 --no-sudo
1806 Skips the use of sudo to run certain internal features (like hd‐
1807 dtemp, file) with sudo. Not related to running inxi itself with
1808 sudo or super user. Some systems will register errors which
1809 will then trigger admin emails in such cases, so if you want to
1810 disable regular user use of sudo (which requires configuration
1811 to setup anyway for these options) just use this option, or
1812 NO_SUDO configuration item.
1813
1814
1815 --output [json|screen|xml]
1816 Change data output type. Requires --output-file if not screen.
1817
1818
1819 --output-file [full path to output file|print]
1820 The given directory path must exist. The directory path given
1821 must exist, The print options prints to stdout. Required for
1822 non-screen --output formats (json|xml).
1823
1824
1825 --partition-sort [dev-base|fs|id|label|percent-used|size|uuid|used]
1826 Change default sort order of partition output. Corresponds to
1827 PARTITION_SORT configuration item. These are the available sort
1828 options:
1829
1830 dev-base - /dev partition identifier, like /dev/sda1. Note that
1831 it's an alphabetic sort, so sda12 is before sda2.
1832
1833 fs - Partition filesystem. Note that sorts will be somewhat ran‐
1834 dom if all filesystems are the same.
1835
1836 id - Mount point of partition (default).
1837
1838 label - Label of partition. If partitions have no labels, sort
1839 will be random.
1840
1841 percent-used - Percentage of partition size used.
1842
1843 size - KiB size of partition.
1844
1845 uuid - UUID of the partition.
1846
1847 used - KiB used of partition.
1848
1849
1850 --pm-type [package manager name]
1851 For distro package maintainers only, and only for non apt, rpm,
1852 or pacman based systems. To be used to test replacement package
1853 lists for recommends for that package manager.
1854
1855
1856 --sensors-default
1857 Overrides configuration values SENSORS_USE or SENSORS_EXCLUDE on
1858 a one time basis.
1859
1860
1861 --sensors-exclude
1862 Similar to --sensors-use except removes listed sensors from sen‐
1863 sor data. Make permanent with SENSORS_EXCLUDE configuration
1864 item. Note that gpu, network, disk, and other specific device
1865 monitor chips are excluded by default.
1866
1867 Example: inxi -sxx --sensors-exclude k10temp-pci-00c3
1868
1869
1870 --sensors-use
1871 Use only the (comma separated) sensor arrays for -s output.
1872 Make permanent with SENSORS_USE configuration item. Sensor array
1873 ID value must be the exact value shown in lm-sensors sensors
1874 output (Linux/lm-sensors only). If you only want to exclude one
1875 (or more) sensors from the output, use --sensors-exlude.
1876
1877 Can be useful if the default sensor data used by inxi is not
1878 from the right sensor array. Note that all other sensor data
1879 will be removed, which may lead to undesired consequences.
1880 Please be aware that this can lead to many undesirable side-ef‐
1881 fects, since default behavior is to use all the sensors arrays
1882 and select which values to use from them following a set se‐
1883 quence of rules. So if you force one to be used, you may lose
1884 data that was used from another one.
1885
1886 Most likely best use is when one (or two) of the sensor arrays
1887 has all the sensor data you want, and you just want to make sure
1888 inxi doesn't use data from another array that has inacurate or
1889 misleading data.
1890
1891 Note that gpu, network, disk, and other specific device monitor
1892 chips are excluded by default, and should not be added since
1893 they do not provide cpu, board, system, etc, sensor data.
1894
1895 Example: inxi -sxx --sensors-use nct6791-isa-0290,k10temp-
1896 pci-00c3
1897
1898
1899 --sleep [0-x.x]
1900 Usually in decimals. Change CPU sleep time for -C (current:
1901 .35). Sleep is used to let the system catch up and show a more
1902 accurate CPU use. Example:
1903
1904 inxi -Cxxx --sleep 0.15
1905
1906 Overrides default internal value and user configuration value:
1907
1908 CPU_SLEEP=0.25
1909
1910
1911 --tty Forces internal IRC flag to off. Used in unhandled cases where
1912 the program running inxi may not be seen as a shell/tty, but it
1913 is not an IRC client. Put --tty first in option list to avoid
1914 unexpected errors. If you want a specific output width, use the
1915 --width option. If you want normal color codes in the output,
1916 use the -c [color ID] flag.
1917
1918 The sign you need to use this is extra numbers before the
1919 key/value pairs of the output of your program. These are IRC,
1920 not TTY, color codes. Please post a github issue if you find you
1921 need to use --tty (including the full -Ixxx line) so we can fig‐
1922 ure out how to add your program to the list of whitelisted pro‐
1923 grams.
1924
1925 You can see what inxi believed started it in the -Ixxx line,
1926 Shell: or Client: item. Please let us know what that result was
1927 so we can add it to the parent start program whitelist.
1928
1929
1930 --usb-sys
1931 Shortcut, legacy. See --force usb-sys
1932
1933
1934 --usb-tool
1935 Shortcut, legacy. See --force lsusb
1936
1937
1938 --wan-ip-url [URL]
1939 Force -i to use supplied URL as WAN IP source. Overrides dig or
1940 default IP source urls. URL must start with http[s] or ftp.
1941
1942 The IP address from the URL must be the last item on the last
1943 (non-empty) line of the page content source code.
1944
1945 Same as configuration value (example):
1946
1947 WAN_IP_URL='https://mysite.com/ip.php'
1948
1949
1950 --wm Shortcut, legacy. See --force wmctl.
1951
1952
1953 --wrap-max [integer]
1954 Overrides default or configuration set line starter wrap width
1955 value. Wrap max is the maximum width that inxi will wrap line
1956 starters (e.g. Info:) to their own lines, with data lines in‐
1957 dented only 2 columns. If terminal/console width or --width is
1958 less than wrap width, wrapping of line starter occurs. If 80 or
1959 less, no wrapping will occur. Overrides internal default value
1960 (90) and user configuration value:
1961
1962 WRAP_MAX=85 (previously INDENT_MIN)
1963
1964 Previously called: --indent-min.
1965
1966
1968 --dbg 1
1969 - Debug downloader failures. Turns off silent/quiet mode for
1970 curl, wget, and fetch. Shows more downloader action information.
1971 Shows some more information for Perl downloader.
1972
1973
1974 --dbg [2-xx]
1975 - See github inxi-perl/docs/inxi-values.txt for specific spe‐
1976 cialized debugging options. These can vary but tend to not
1977 change much, though they are added as needed.
1978
1979
1980 --debug [1-3]
1981 - On screen debugger output. Output varies depending on current
1982 needs Usually nothing changes.
1983
1984
1985 --debug 10
1986 - Basic logging. Check $XDG_DATA_HOME/inxi/inxi.log or
1987 $HOME/.local/share/inxi/inxi.log or $HOME/.inxi/inxi.log.
1988
1989
1990 --debug 11
1991 - Full file/system info logging.
1992
1993
1994 --debug 20
1995 Creates a tar.gz file of system data and collects the inxi out‐
1996 put in a file.
1997
1998 * tree traversal data file(s) read from /proc and /sys, and
1999 other system data.
2000
2001 * xorg conf and log data, xrandr, xprop, xdpyinfo, glxinfo etc.
2002
2003 * data from dev, disks, partitions, etc.
2004
2005
2006 --debug 21
2007 Automatically uploads debugger data tar.gz file to ftp.smxi.org,
2008 then removes the debug data directory, but leaves the debug
2009 tar.gz file. See --ftp for uploading to alternate locations.
2010
2011
2012 --debug 22
2013 Automatically uploads debugger data tar.gz file to ftp.smxi.org,
2014 then removes the debug data directory and the tar.gz file. See
2015 --ftp for uploading to alternate locations.
2016
2017
2018 --ftp [ftp.yoursite.com/incoming]
2019 For alternate ftp upload locations: Example:
2020
2021 inxi --ftp ftp.yourserver.com/incoming --debug 21
2022
2023
2025 Only use the following in conjunction with --debug 2[012], and only use
2026 if you experienced a failure or hang, or were instructed to do so.
2027
2028
2029 --debug-proc
2030 Force debugger to parse /proc directory data when run as root.
2031 Normally this is disabled due to unpredictable data in /proc
2032 tree.
2033
2034
2035 --debug-proc-print
2036 Use this to locate file that /proc debugger hangs on.
2037
2038
2039 --debug-no-exit
2040 Skip exit on error when running debugger.
2041
2042
2043 --debug-no-proc
2044 Skip /proc debugging in case of a hang.
2045
2046
2047 --debug-no-sys
2048 Skip /sys debugging in case of a hang.
2049
2050
2051 --debug-sys
2052 Force PowerPC debugger parsing of /sys as doas[BSDs]/sudo/root.
2053
2054
2055 --debug-sys-print
2056 Use this to locate file that /sys debugger hangs on.
2057
2058
2060 BitchX, Gaim/Pidgin, ircII, Irssi, Konversation, Kopete, KSirc, KVIrc,
2061 Weechat, and Xchat. Plus any others that are capable of displaying ei‐
2062 ther built-in or external script output.
2063
2064
2066 To trigger inxi output in your IRC client, pick the appropriate method
2067 from the list below:
2068
2069 Hexchat, XChat, Irssi
2070 (and many other IRC clients) /exec -o inxi [options] If you
2071 don't include the -o, only you will see the output on your local
2072 IRC client.
2073
2074 Konversation
2075 /cmd inxi [options]
2076
2077 To run inxi in Konversation as a native script if your distribu‐
2078 tion or inxi package hasn't already done this for you, create
2079 this symbolic link:
2080
2081 KDE 4: ln -s /usr/local/bin/inxi /usr/share/kde4/apps/konversa‐
2082 tion/scripts/inxi
2083
2084 KDE 5: ln -s /usr/local/bin/inxi /usr/share/konversa‐
2085 tion/scripts/inxi
2086
2087 If inxi is somewhere else, change the path /usr/local/bin to
2088 wherever it is located.
2089
2090 If you are using KDE/QT 5, then you may also need to add the
2091 following to get the Konversation /inxi command to work:
2092
2093 ln -s /usr/share/konversation /usr/share/apps/
2094
2095 Then you can start inxi directly, like this:
2096
2097 /inxi [options]
2098
2099 WeeChat
2100 NEW: /exec -o inxi [options]
2101
2102 OLD: /shell -o inxi [options]
2103
2104 Newer (2014 and later) WeeChats work pretty much the same now as
2105 other console IRC clients, with /exec -o inxi [options]. Newer
2106 WeeChats have dropped the -curses part of their program name,
2107 i.e.: weechat instead of weechat-curses.
2108
2109
2111 inxi will read its configuration/initialization files in the following
2112 order:
2113
2114 /etc/inxi.conf contains the default configurations. These can be over‐
2115 ridden by user configurations found in one of the following locations
2116 (inxi will store its config file using the following precedence: if
2117 $XDG_CONFIG_HOME is not empty, it will go there, else if
2118 $HOME/.conf/inxi.conf exists, it will go there, and as a last default,
2119 the legacy location is used), i.e.:
2120
2121 $XDG_CONFIG_HOME/inxi.conf > $HOME/.conf/inxi.conf >
2122 $HOME/.inxi/inxi.conf
2123
2124
2126 See the documentation page for more complete information on how to set
2127 these up, and for a complete list of options:
2128
2129 https://smxi.org/docs/inxi-configuration.htm
2130
2131 Basic Options
2132 Here's a brief overview of the basic options you are likely to
2133 want to use:
2134
2135 COLS_MAX_CONSOLE The max display column width on terminal. If
2136 terminal/console width or --width is less than wrap width, wrap‐
2137 ping of line starter occurs COLS_MAX_IRC The max display column
2138 width on IRC clients.
2139
2140 COLS_MAX_NO_DISPLAY The max display column width in console, out
2141 of GUI desktop.
2142
2143 CPU_SLEEP Decimal value 0 or more. Default is usually around
2144 0.35 seconds. Time that inxi will 'sleep' before getting CPU
2145 speed data, so that it reflects actual system state.
2146
2147 DOWNLOADER Sets default inxi downloader: curl, fetch, ftp, perl,
2148 wget. See --recommends output for more information on download‐
2149 ers and Perl downloaders.
2150
2151 FILTER_STRING Default <filter>. Any string you prefer to see in‐
2152 stead for filtered values.
2153
2154 LIMIT Overrides default of 10 IP addresses per IF. This is only
2155 of interest to sys admins running servers with many IP ad‐
2156 dresses.
2157
2158 NO_DIG Set to 1 or true to disable WAN IP use of dig and force
2159 use of alternate downloaders.
2160
2161 NO_DOAS Set to 1 or true to disable internal use of doas.
2162
2163 NO_HTML_WAN Set to 1 or true to disable WAN IP use of HTML Down‐
2164 loaders and force use of dig only, or nothing if dig disabled as
2165 well. Same as --no-html-wan. Only use if dig is failing, and
2166 HTML downloaders are hanging.
2167
2168 NO_SUDO Set to 1 or true to disable internal use of sudo.
2169
2170 PARTITION_SORT Overrides default partition output sort. See
2171 --partition-sort for options.
2172
2173 PS_COUNT The default number of items showing per -t type, m or
2174 c. Default is 5.
2175
2176 SENSORS_CPU_NO In cases of ambiguous temp1/temp2 (inxi can't
2177 figure out which is the CPU), forces sensors to use either
2178 value 1 or 2 as CPU temperature. See the above configuration
2179 page on smxi.org for full info.
2180
2181 SENSORS_EXCLUDE Exclude supplied sensor array[s] from sensor
2182 output. Override with --sensors-default. See --sensors-exclude.
2183
2184 SENSORS_USE Use only supplied sensor array[s]. Override with
2185 --sensors-default. See --sensors-use.
2186
2187 SEP2_CONSOLE Replaces default key / value separator of ':'.
2188
2189 USB_SYS Forces all USB data to use /sys instead of lsusb.
2190
2191 WAN_IP_URL Forces -i to use supplied URL, and to not use dig
2192 (dig is generally much faster). URL must begin with http or ftp.
2193 Note that if you use this, the downloader set tests will run
2194 each time you start inxi whether a downloader feature is going
2195 to be used or not.
2196
2197 The IP address from the URL must be the last item on the last
2198 (non-empty) line of the URL's page content source code.
2199
2200 Same as --wan-ip-url [URL]
2201
2202 WEATHER_SOURCE Values: [0-9]. Same as --weather-source. Values
2203 4-9 are not currently supported, but this can change at any
2204 time.
2205
2206 WEATHER_UNIT Values: [m|i|mi|im]. Same as --weather-unit.
2207
2208 WRAP_MAX (previously INDENT_MIN) The maximum width where the
2209 line starter wraps to its own line. If terminal/console width or
2210 --width is less than wrap width, wrapping of line starter oc‐
2211 curs. Overrides default. See --wrap-max. If 80 or less, wrap
2212 will never happen.
2213
2214
2215 Color Options
2216 It's best to use the -c [94-99] color selector tool to set the
2217 following values because it will correctly update the configura‐
2218 tion file and remove any invalid or conflicting items, but if
2219 you prefer to create your own configuration files, here are the
2220 options. All take the integer value from the options available
2221 in -c 94-99.
2222
2223 NOTE: All default and configuration file set color values are
2224 removed when output is piped or redirected. You must use the ex‐
2225 plicit -c <color number> option if you want colors to be present
2226 in the piped/redirected output (creating a PDF for example).
2227
2228 CONSOLE_COLOR_SCHEME The color scheme for console output (not in
2229 X/Wayland).
2230
2231 GLOBAL_COLOR_SCHEME Overrides all other color schemes.
2232
2233 IRC_COLOR_SCHEME Desktop X/Wayland IRC CLI color scheme.
2234
2235 IRC_CONS_COLOR_SCHEME Out of X/Wayland, IRC CLI color scheme.
2236
2237 IRC_X_TERM_COLOR_SCHEME In X/Wayland IRC client terminal color
2238 scheme.
2239
2240 VIRT_TERM_COLOR_SCHEME Color scheme for virtual terminal output
2241 (in X/Wayland).
2242
2243
2245 Please report bugs using the following resources.
2246
2247 You may be asked to run the inxi debugger tool (see --debug 21/22),
2248 which will upload a data dump of system files for use in debugging
2249 inxi. These data dumps are very important since they provide us with
2250 all the real system data inxi uses to parse out its report.
2251
2252 Issue Report
2253 File an issue report: https://github.com/smxi/inxi/issues
2254
2255 Forums Post on inxi forums: https://techpatterns.com/forums/fo‐
2256 rum-33.html
2257
2258 IRC irc.oftc.net#smxi
2259 You can also visit irc.oftc.net channel: #smxi to post issues.
2260
2261
2263 https://github.com/smxi/inxi
2264
2265 https://smxi.org/docs/inxi.htm
2266
2267
2269 inxi is a fork of locsmif's very clever infobash script.
2270
2271 Original infobash author and copyright holder: Copyright (C) 2005-2007
2272 Michiel de Boer aka locsmif
2273
2274 inxi version: Copyright (C) 2008-2021 Harald Hope
2275
2276 This man page was originally created by Gordon Spencer (aka aus9) and
2277 is maintained by Harald Hope (aka h2 or TechAdmin).
2278
2279 Initial CPU logic, konversation version logic, occasional maintenance
2280 fixes, and the initial xiin.py tool for /sys parsing (obsolete, but
2281 still very much appreciated for all the valuable debugger data it
2282 helped generate): Scott Rogers
2283
2284 Further fixes (listed as known):
2285
2286 Horst Tritremmel <hjt at sidux.com>
2287
2288 Steven Barrett (aka: damentz) - USB audio patch; swap percent used
2289 patch.
2290
2291 Jarett.Stevens - dmidecode -M patch for older systems with no /sys.
2292
2293
2295 The nice people at irc.oftc.net channels #linux-smokers-club and #smxi,
2296 who all really have to be considered to be co-developers because of
2297 their non-stop enthusiasm and willingness to provide real-time testing
2298 and debugging of inxi development.
2299
2300 Siduction forum members, who have helped get some features working by
2301 providing a large number of datasets that have revealed possible varia‐
2302 tions, particularly for the RAM -m option.
2303
2304 AntiX users and admins, who have helped greatly with testing and debug‐
2305 ging, particularly for the 3.0.0 release.
2306
2307 ArcherSeven (Max), Brett Bohnenkamper (aka KittyKatt), and Iotaka, who
2308 always manage to find the weirdest or most extreme hardware and setups
2309 that help make inxi much more robust.
2310
2311 For the vastly underrated skill of output error/glitch catching, Pete
2312 Haddow. His patience and focus in going through inxi repeatedly to find
2313 errors and inconsistencies is much appreciated.
2314
2315 All the inxi package maintainers, distro support people, forum modera‐
2316 tors, and in particular, sys admins with their particular issues, which
2317 almost always help make inxi better, and any others who contribute
2318 ideas, suggestions, and patches.
2319
2320 Without a wide range of diverse Linux kernel-based Free Desktop systems
2321 to test on, we could never have gotten inxi to be as reliable and solid
2322 as it's turning out to be.
2323
2324 And of course, a big thanks to locsmif, who figured out a lot of the
2325 core methods, logic, and tricks originally used in inxi Gawk/Bash.
2326
2327
2328
2329
2330inxi 2021-03-17 INXI(1)