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