1INXI(1) inxi manual INXI(1)
2
6 inxi - Command line system information script for console and IRC
7
10 inxi
11 inxi [-AbBCdDEfFGhiIjJlLmMnNopPrRsSuUVwyYzZ]
13 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 inxi [--edid] [--memory-modules] [--memory-short] [--recommends]
19 [--sensors-default] [--slots]
20 inxi [-x|-xx|-xxx|-a] -OPTION(s)
22 All short form options have long form variants - see below for these
24 and more advanced options.
25
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 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
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 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
52 This man page is pretty long and information packed. It is divided into
53 the following sections:
54 * USING OPTIONS How to use the command line options.
56 * STANDARD OPTIONS Primary data types trigger items.
58 * FILTER OPTIONS Apply a variety of output filters.
60 * OUTPUT CONTROL OPTIONS Change default colors, widths, heights, output
62 types, etc.
63 * EXTRA DATA OPTIONS What -x, -xx, and -xxx add to the output per pri‐
65 mary data type.
66 * ADMIN EXTRA DATA OPTIONS What -a adds to the output per primary data
68 type. These have a lot of information because this is advanced admin
69 data, which are not always intuitive or easy to understand.
70 * ADVANCED OPTIONS Modify behavior or choice of data sources, and other
72 advanced switches.
73 * DEBUGGING OPTIONS For development use mainly, or contributing
75 datasets to the project.
76 * DEBUGGING OPTIONS TO DEBUG DEBUGGER FAILURES Only for advanced users,
78 sometimes something will hang the debuggers, this shows you various
79 ways to get around those failures.
80 * SUPPORTED IRC CLIENTS List of known good IRC clients. Not checked of‐
82 ten, let us know if something is not working.
83 * RUNNING IN IRC CLIENT How to run inxi in various IRC clients.
85 * CONFIGURATION FILE Configuration file locations and priority in us‐
87 ing.
88 * CONFIGURATION OPTIONS Most of the commonly used configuration op‐
90 tions, along with sample values.
91 * BUGS How and where to report bugs.
93 * HOMEPAGE, AUTHOR AND CONTRIBUTORS TO CODE, SPECIAL THANKS TO THE FOL‐
95 LOWING These are self explanitory.
96
99 Options can be combined if they do not conflict. You can either group
100 the letters together or separate them.
101 Letters with numbers can have no gap or a gap at your discretion, ex‐
103 cept when using -t. Note that if you use an option that requires an
104 additional argument, that must be last in the short form group of op‐
105 tions. Otherwise you can use those separately as well.
106 For example: inxi -AG | inxi -A -G | inxi -b | inxi -c10 | inxi
108 -FxxzJy90 | inxi -bay
109 Note that all the short form options have long form equivalents, which
111 are listed below. However, usually the short form is used in examples
112 in order to keep things simple.
113
116 -A , --audio
117 Show Audio/sound device(s) information, including device driver.
118 Shows active sound API(s) and sound server(s).
119 Supported APIs: ALSA, OSS, sndio. Supported servers: aRts
121 (artsd), Enlightened Sound Daemon (esound, esd), JACK, NAS (Net‐
122 work Audio System, nasd), PipeWire, PulseAudio, RoarAudio,
123 sndiod.
124 Use -Ax to show all sound APIs/servers detected, including inac‐
126 tive, -Axx to see API/Server helper daemons/plugin/modules, and
127 -Aa to see API/sound server tools.
128 Audio:
130 Device-1: C-Media CMI8788 [Oxygen HD Audio] driver: snd_virtuoso
131 Device-2: AMD Cedar HDMI Audio [Radeon HD 5400/6300/7300 Series]
132 driver: snd_hda_intel
133 Device-3: AMD Family 17h HD Audio driver: snd_hda_intel
134 API: ALSA v: k5.19.0-16.2-liquorix-amd64 status: kernel-api
135 Server-1: PulseAudio v: 16.1 status: active
136 -b , --basic
138 Show basic output, short form. Same as: inxi -v 2
139 -B , --battery
142 Show system battery (ID-x) data, charge, condition, plus extra
143 information (if battery present). Uses /sys or, for BSDs without systctl
144 battery data, use --dmidecode to force its use. dmidecode does
145 not have very much information, and none about current battery
146 state/charge/voltage. Supports multiple batteries when using /sys or
147 sysctl data.
148 Note that for charge:, the output shows the current charge, as well as
150 its value as a percentage of the available capacity, which can be less than
151 the original design capacity. In the following example, the actual current
152 available capacity of the battery is 22.2 Wh.
153 charge: 20.1 Wh (95.4%)
155 The condition: item shows the remaining available capacity / original
157 design capacity, and then this figure as a percentage of original capacity
158 available in the battery.
159 condition: 22.2/36.4 Wh (61%)
161 With -x, or if voltage difference is critical, volts: item shows
163 the current voltage, and the min: voltage. Note that if the current is
164 below the minimum listed the battery is essentially dead and will not charge.
165 Test that to confirm, but that's technically how it's supposed to work.
166 volts: 12.0 min: 11.4
168 With -x shows attached Device-x information (mouse, keyboard,
170 etc.) if they are battery powered.
171 --bluetooth
174 See -E.
175 -c , --color
178 See OUTPUT CONTROL OPTIONS.
179 --config, --configuration
182 Show active configuration values, by file, and exit.
183 -C , --cpu
186 Show full CPU output (if each item available): basic CPU topology, model, type,
187 L2 cache, average speed of all cores (if > 1 core, otherwise speed of the core),
188 min/max speeds for CPU, and per CPU clock speed. More data available with
189 -x, -xxx, and -a options.
190 Explanation of CPU type (type: MT MCP) abbreviations:
192 * AMCP - Asymmetric Multi Core Processor. More than 1 core per CPU, and
194 more than one core type (single and multithreaded cores in the same CPU).
195 * AMP - Asymmetric Multi Processing (more than 1 physical CPU, but not
197 identical in terms of core counts or min/max speeds).
198 * MT - Multi/Hyper Threaded CPU (more than 1 thread per core, previously
200 HT).
201 * MST - Multi and Single Threaded CPU (a CPU with both Single and Multi
203 Threaded cores).
204 * MCM - Multi Chip Model (more than 1 die per CPU).
206 * MCP - Multi Core Processor (more than 1 core per CPU).
208 * SMP - Symmetric Multi Processing (more than 1 physical CPU).
210 * UP - Uni (single core) Processor.
212 Note that min/max: speeds are not necessarily true in cases of
214 overclocked CPUs or CPUs in turbo/boost mode. See -Ca for alternate
215 base/boost: speed data, more granular cache data, and more.
216 Sample:
218 CPU:
219 Info: 2x 8-core model: Intel Xeon E5-2620 v4 bits: 64 type: MT MCP SMP
220 cache: L2: 2x 2 MiB (4 MiB)
221 Speed (MHz): avg: 1601 min/max: 1200/3000 cores: 1: 1280 2: 1595 3: 1416
222 ... 32: 1634
223 -d , --disk-full,--optical
226 Show optical drive data as well as -D HDD/SSD drive data. With
227 -x, adds a feature line to the output. Also shows floppy disks
228 if present. Note that there is no current way to get any infor‐
229 mation about the floppy device that we are aware of, so it will
230 simply show the floppy ID without any extra data. -xx adds a few
231 more features.
232 -D , --disk
235 Show HDD/SSD drive info. Shows total drive space and used per‐
236 centage. The drive used percentage includes space used by swap
237 partition(s), since those are not usable for data storage. Also,
238 unmounted partitions are not counted in drive use percentages
239 since inxi has no access to the used amount.
240 If the system has RAID or other logical storage, and if inxi can
242 determine the size of those vs their components, you will see
243 the storage total raw and usable sizes, plus the percent used of
244 the usable size. The no argument short form of inxi will show
245 only the usable (or total if no usable) and used percent. If
246 there is no logical storage detected, only total: and used: will
247 show. Sample (with RAID logical size calculated):
248 Local Storage: total: raw: 5.49 TiB usable: 2.80 TiB used: 1.35
250 TiB (48.3%)
251 Without logical storage detected:
253 Local Storage: total: 2.89 TiB used: 1.51 TiB (52.3%)
255 Also shows per drive information: Disk ID, type (FireWire, Re‐
257 movable, USB if present), vendor (if detected), model, and size.
258 See Extra Data Options (-x options) and Admin Extra Data Options
259 (--admin options) for many more features.
260 -E, --bluetooth
263 Show bluetooth device(s), drivers. Show Report: with HCI ID,
264 state, address per device (requires btmgmt, bt-adapter, or hci‐
265 config), and if available (hciconfig, btmgmt only) bluetooth
266 version (bt-v). See Extra Data Options for more.
267 If bluetooth shows as status: down, shows bt-service: state and
269 rfkill software and hardware blocked states, and rfkill ID.
270 Note that Report-ID: indicates that the HCI item was not able to
272 be linked to a specific device, similar to IF-ID: in -n.
273 If your internal bluetooth device does not show, it's possible
275 that it has been disabled, if you try enabling it using for ex‐
276 ample:
277 hciconfig hci0 up
279 and it returns a blocked by RF-Kill error, you can do one of
281 these:
282 connmanctl enable bluetooth
284 or
286 rfkill list bluetooth
288 rfkill unblock bluetooth
290 --edid
293 Triggers full EDID data in Graphics, activates -G and -a.
294 - Adds monitor chromacity (chroma:
296 red:..green:...blue:...white:).
297 - Shows all available monitor modes if > 2 present, in comma
299 separated list.
300 - Shows EDID errors and warnings if any present.
302 --filter, -z
305 See FILTER OPTIONS.
306 -f , --flags
309 Show all CPU flags used, not just the short list. Not shown with
310 -F in order to avoid spamming. ARM CPUs: show features items.
311 -F , --full
314 Show Full output for inxi. Includes all Upper Case line letters
315 (except -J and -W) plus --swap, -s and -n. Does not show extra
316 verbose options such as -d -f -i -J -l -m -o -p -r -t -u -x un‐
317 less you use those arguments in the command, e.g.: inxi -Frmxx
318 --gpu Deprecated. See -G -a.
321 -G , --graphics
324 Show Graphic device(s) information, including details of device
325 and display drivers (X: loaded:, and, if applicable: unloaded:,
326 failed:, dri: (if X and different from loaded X drivers) driv‐
327 ers, and active gpu: drivers), display protocol (if available),
328 display server (and/or Wayland compositor), vendor and version
329 number, e.g.:
330 Display: x11 server: Xorg v: 1.15.1
332 or:
334 Display: wayland server: X.org v: 1.20.1 with: Xwayland v: 20.1
336 If protocol is not detected, shows:
338 Display: server: Xorg 1.15.1
340 Adds with: Xwayland v:... if xwayland server is installed, re‐
342 gardless of protocol.
343 Also shows screen resolution(s) (per monitor/X screen). Shows
345 graphics API information (if available). EGL: EGL version, driv‐
346 ers, acdtive platforms; OpenGL: renderer, OpenGL core profile
347 version/OpenGL version (if core/compat versions different, shows
348 that as well); Vulkan: Vulkan version, drivers, surfaces;VESA:
349 data (for Xvesa).
350 Compositor information will show if detected using -xx option or
352 always if detected and Wayland since the compositor is the
353 server with Wayland.
354 -Gxx shows monitor data as well, if detected. --edid shows ad‐
356 vanced monitor data (full modes, chroma, etc.).
357 -h , --help
360 The help menu. Features dynamic sizing to fit into terminal win‐
361 dow. Set script global COLS_MAX_CONSOLE if you want a different
362 default value, or use -y [width] to temporarily override the de‐
363 faults or actual window width.
364 -i , --ip
367 Show WAN IP address and local interfaces (latter requires ifcon‐
368 fig or ip network tool), as well as network output from -n. Not
369 shown with -F for user security reasons. You shouldn't paste
370 your local/WAN IP. Shows both IPv4 and IPv6 link IP addresses.
371 -I , --info
374 Show Information: processes, uptime, memory, IRC client (or
375 shell type if run in shell, not IRC), inxi version. See -Ix,
376 -Ixx, and -Ia for extra information (init type/version, run‐
377 level/target, packages).
378 Note: if -m or -tm are active, the memory item will show in the
380 main Memory: report of -m/-tm/, not in Info:.
381 See -m for explanation of Memory: fields and values..
383 -j, --swap
386 Shows all active swap types (partition, file, zram). When this
387 option is used, swap partition(s) will not show on the -P line
388 to avoid redundancy.
389 To show partition labels or UUIDs (when available and relevant),
391 use with -l or -u.
392 -J , --usb
395 Show USB data for attached Hubs and Devices. Hubs also show num‐
396 ber of ports. Be aware that a port is not always external, some
397 may be internal, and either used or unused (for example, a moth‐
398 erboard USB header connector that is not used).
399 Hubs and Devices are listed in order of BusID.
401 BusID is generally in this format: BusID-port[.port][.port]:De‐
403 viceID
404 Device ID is a number created by the kernel, and has no neces‐
406 sary ordering or sequence connection, but can be used to match
407 this output to lsusb values, which generally shows BusID / Devi‐
408 ceID (except for tree view, which shows ports).
409 Examples: Device-3: 4-3.2.1:2 or Hub: 4-0:1
411 The rev: 2.0 item refers to the USB revision number, like 1.0 or
413 3.1.
414 Use -Jx for basic Si base 10 bits/s speed, -Jxx for Si and IEC
416 base 2 Bytes/s speeds. -Ja adds USB mode.
417 -l , --label
420 Show partition labels. Use with -j, -o, -p, and -P to show par‐
421 tition labels. Does nothing without one of those options.
422 Sample: -ojpl.
424 -L, --logical
427 Show Logical volume information, for LVM, LUKS, bcache, etc.
428 Shows size, free space (for LVM VG). For LVM, shows Device-[xx]:
429 VG: (Volume Group) size/free, LV-[xx] (Logical Volume). LV shows
430 type, size, and components. Note that components are made up of
431 either containers (aka, logical devices), or physical devices.
432 The full report requires doas/sudo/root.
433 Logical block devices can be thought of as devices that are made
435 up out of either other logical devices, or physical devices.
436 inxi does its best to show what each logical device is made out
437 of. RAID devices form a subset of all possible Logical devices,
438 but have their own section, -R.
439 If -R is used with -Lxx, -Lxx will not show RAID information for
441 LVM RAID devices since it's redundant. If -R is not used, a sim‐
442 ple RAID line will appear for LVM RAID in -Lxx.
443 -Lxx also shows all components and devices. Note that since com‐
445 ponents can go in many levels, each level per primary component
446 is indicated by either another 'c', or ends with a 'p' device,
447 the physical device. The number of c's or p's indicates the
448 depth, so you can see which component belongs to which.
449 -L shows only the top level components/devices (like -R). -La
451 shows component/device size, maj:min ID, mapped name (if appli‐
452 cable), and puts each component/device on its own line.
453 Sample:
455 Device-10: mybackup type: LUKS dm: dm-28 size: 6.36 GiB Components:
457 c-1: md1 cc-1: dm-26 ppp-1: sdj2 cc-2: dm-27 ppp-1: sdk2
458 LV-5: lvm_raid1 type: raid1 dm: dm-16 size: 4.88 GiB
459 RAID: stripes: 2 sync: idle copied: 100% mismatches: 0
460 Components: c-1: dm-10 pp-1: sdd1 c-2: dm-11 pp-1: sdd1 c-3: dm-13
461 pp-1: sde1 c-4: dm-15 pp-1: sde1
462 It is easier to follow the flow of components and devices using
464 -y1. In this example, there is one primary component (c-1), md1,
465 which is made up of two components (cc-1,2), dm-26 and dm-27.
466 These are respectively made from physical devices (p-1) sdj2 and
467 sdk2.
468 Device-10: mybackup
470 maj-min: 254:28
471 type: LUKS
472 dm: dm-28
473 size: 6.36 GiB
474 Components:
475 c-1: md1
476 maj-min: 9:1
477 size: 6.37 GiB
478 cc-1: dm-26
479 maj-min: 254:26
480 mapped: vg5-level1a
481 size: 12.28 GiB
482 ppp-1: sdj2
483 maj-min: 8:146
484 size: 12.79 GiB
485 cc-2: dm-27
486 maj-min: 254:27
487 mapped: vg5-level1b
488 size: 6.38 GiB
489 ppp-1: sdk2
490 maj-min: 8:162
491 size: 12.79 GiB
492 Other types of logical block handling like LUKS, bcache show as:
494 Device-[xx] [name/id] type: [LUKS|Crypto|bcache]:
496 -m , --memory
499 Memory (RAM) data. Does not display with -b or -F unless you use
500 -m explicitly. Ordered by system board physical system memory
501 array(s) (Array-[number]), and individual memory devices (De‐
502 vice-[number]). Physical memory array data shows array capac‐
503 ity, number of devices supported, and Error Correction informa‐
504 tion. Devices shows locator data (highly variable in syntax),
505 type (eg: type: DDR3)size, speed.
506 Note: -m uses dmidecode, which must be run as root (or start
508 inxi with doas/sudo), unless you figure out how to set up
509 doas/sudo to permit dmidecode to read /dev/mem as user. speed
510 and bus-width will not show if No Module Installed is found in
511 size.
512 Note: If -m is triggered RAM available/used report will appear
514 in this section, not in -I or -tm items.
515 Because dmidecode data is extremely unreliable, inxi will try to
517 make best guesses. If you see (check) after the capacity number,
518 you should check it with the specifications. (est) is slightly
519 more reliable, but you should still check the real specifica‐
520 tions before buying RAM. Unfortunately there is nothing inxi can
521 do to get truly reliable data about the system RAM; maybe one
522 day the kernel devs will put this data into /sys, and make it
523 real data, taken from the actual system, not dmi data. For most
524 people, the data will be right, but a significant percentage of
525 users will have either a wrong max module size, if present, or
526 max capacity.
527 Under dmidecode, Speed: is the expected speed of the memory
529 (what is advertised on the memory spec sheet) and Configured
530 Clock Speed: is what the actual speed is now. To handle this, if
531 speed and configured speed values are different, you will see
532 this instead:
533 speed: spec: [specified speed] MT/s actual: [actual] MT/s
535 Also, if DDR, and speed in MHz, will change to: speed: [speed]
537 MT/s ([speed] MHz)
538 If the detected speed is logically absurd, like 1 MT/s or 69910
540 MT/s, adds: note: check. Sample:
541 Memory:
543 System RAM: total: 32 GiB note: est. available: 31.38 GiB
544 used: 20.65 GiB (65.8%)
545 Array-1: capacity: N/A slots: 4 note: check EC: N/A
546 Device-1: DIMM_A1 type: DDR3 size: 8 GiB speed: 1600 MT/s (800 MHz)
547 Device-2: DIMM_A2 type: DDR3 size: 8 GiB speed: spec: 1600 MT/s (800 MHz)
548 actual: 61910 MT/s (30955 MHz) note: check
549 Device-3: DIMM_B1 type: DDR3 size: 8 GiB speed: 1600 MT/s (800 MHz)
550 Device-4: DIMM_B2 type: DDR3 size: 8 GiB speed: spec: 1600 MT/s (800 MHz)
551 actual: 2 MT/s (1 MHz) note: check
552 See --memory-modules and --memory-short if you want a shorter
554 report.
555 Notes on System RAM: / Memory: report item:
557 * total: and igpu: do not show for short form.
559 * The total: can come from several possible sources:
561 - If not superuser, and if /sys/devices/system/memory exists, it
563 will estimate the total RAM based on how many RAM blocks and
564 their size. Sometimes the block count is not an exact match to
565 installed RAM, and inxi will attempt to guess the actual RAM
566 amount, except for virtual machines. When it synthesizes the ac‐
567 tual physical RAM total, it will show note: est..
568 Note that not all kernels are compiled to support generating
570 this /sys directory (kernel needs to be compiled with CON‐
571 FIG_MEMORY_HOTPLUG).
572 - For OpenBSD and not superuser, the total comes from the de‐
574 tected RAM in dboot, if available.
575 - If superuser, and if -m used, it comes from the dmidecode RAM
577 totals if available, and if not, it comes from counting up the
578 System RAM ranges in /proc/iomem (Linux only), then rounding up,
579 since that total is usually slightly under the actual physical
580 RAM total. If inxi is unsure about the total, it will show note:
581 est..
582 If no total data found, shows total: N/A.
584 * The available: item is the total installed RAM minus some re‐
586 served and kernel code RAM (and in some cases iGPU assigned main
587 system RAM) that is allocated on system boot, and thus is gener‐
588 ally less than the actual physical RAM installed. This is called
589 MemTotal in free/meminfo even though it isn't, though it is the
590 total available the kernel has to work with.
591 * The used: is the percent of the available RAM used, NOT of the
593 total physical RAM.
594 * The igpu: item either comes from Raspberry Pi gpu RAM, or from
596 /proc/iomem. The latter source is Linux + superuser only, and is
597 not guaranteed to be accurate, but sometimes is. That is for
598 iGPU system RAM used, not for standalone GPUs with their own in‐
599 ternal RAM. Not all types of internal VRAM are detectable, it
600 depends on how the hardware assigns RAM to iGPU.
601 Raspberry Pi uses vcgencmd get_mem gpu to get gpu RAM amount, if
603 user is in video group and vcgencmd is installed.
604 --memory-modules, --mm
607 Memory (RAM) data. Show only RAM arrays and modules in Memory
608 report. Skip empty slots. See -m.
609 --memory-short, --ms
612 Memory (RAM) data. Show a one line RAM report in Memory. See -m.
613 Sample: Report: arrays: 1 slots: 4 modules: 2 type: DDR4
615 -M , --machine
618 Show machine data. Device, Motherboard, BIOS, and if present,
619 System Builder (Like Lenovo). Older systems/kernels without the
620 required /sys data can use dmidecode instead, run as root. If
621 using dmidecode, may also show BIOS/UEFI revision as well as
622 version. --dmidecode forces use of dmidecode data instead of
623 /sys. Will also attempt to show if the system was booted by
624 BIOS, UEFI, or UEFI [Legacy], the latter being legacy BIOS boot
625 mode in a system board using UEFI.
626 Device information requires either /sys or dmidecode. Note that
628 other-vm? is a type that means it's usually a VM, but inxi
629 failed to detect which type, or positively confirm which VM it
630 is. Primary VM identification is via systemd-detect-virt but
631 fallback tests that should also support some BSDs are used. Less
632 commonly used or harder to detect VMs may not be correctly de‐
633 tected. If you get an incorrect output, post an issue and we'll
634 get it fixed if possible.
635 Due to unreliable vendor data, device type will show: desktop,
637 laptop, notebook, server, blade, plus some obscure stuff that
638 inxi is unlikely to ever run on.
639 -n , --network-advanced
642 Show Advanced Network device information in addition to that
643 produced by -N. Shows interface, speed, MAC ID, state, etc.
644 -N , --network
647 Show Network device(s) information, including device driver.
648 With -x, shows Bus ID, Port number.
649 --nvidia, --nv
652 Deprecated. See -Ga.
653 -o , --unmounted
656 Show unmounted partition information (includes UUID and LABEL if
657 available). Shows file system type if you have lsblk installed
658 (Linux only). For BSD/GNU Linux: shows file system type if file
659 is installed, and if you are root or if you have added to
660 /etc/sudoers (sudo v. 1.7 or newer):
661 <username> ALL = NOPASSWD: /usr/bin/file (sample)
663 doas users: see man doas.conf for setup.
665 Does not show components (partitions that create the md-raid ar‐
667 ray) of md-raid arrays.
668 To show partition labels or UUIDs (when available and relevant),
670 use with -l or -u.
671 -p , --partitions-full
674 Show full Partition information (-P plus all other detected
675 mounted partitions).
676 To show partition labels or UUIDs (when available and relevant),
678 use with -l or -u.
679 -P , --partitions
682 Show basic Partition information. Shows, if detected: / /boot
683 /boot/efi /home /opt /tmp /usr /usr/home /var /var/tmp /var/log
684 (for android, shows /cache /data /firmware /system). If --swap
685 is not used, shows active swap partitions (never shows file or
686 zram type swap). Use -p to see all mounted partitions.
687 To show partition labels or UUIDs (when available and relevant),
689 use with -l or -u.
690 --processes
693 See -t.
694 -r , --repos
697 Show distro repository data. Currently supported repo types:
698 APK (Alpine Linux + derived versions)
700 APT (Debian, Ubuntu + derived versions, as well as rpm based apt
702 distros like PCLinuxOS or Alt-Linux)
703 CARDS (NuTyX + derived versions)
705 EOPKG (Solus)
707 NETPKG (Zenwalk/Slackware)
709 NIX (NixOS + other distros as alternate package manager)
711 PACMAN (Arch Linux, KaOS + derived versions)
713 PACMAN-G2 (Frugalware + derived versions)
715 PISI (Pardus + derived versions)
717 PKG (OpenBSD, FreeBSD, NetBSD + derived OS types)
719 PORTAGE (Gentoo, Sabayon + derived versions)
721 PORTS (OpenBSD, FreeBSD, NetBSD + derived OS types)
723 SBOPKG (Slackware + derived versions)
725 SBOUI (Slackware + derived versions)
727 SCRATCHPKG (Venom + derived versions)
729 SLACKPKG (Slackware + derived versions)
731 SLAPT_GET (Slackware + derived versions)
733 SLPKG (Slackware + derived versions)
735 TCE (TinyCore)
737 URPMI (Mandriva, Mageia + derived versions)
739 XBPS (Void)
741 YUM/ZYPP (Fedora, Red Hat, Suse + derived versions)
743 More will be added as distro data is collected. If yours is
745 missing please show us how to get this information and we'll try
746 to add it.
747 See -rx, -rxx, and -ra for installed package count information.
749 -R , --raid
752 Show RAID data. Shows RAID devices, states, levels, device/array
753 size, and components. See extra data with -x / -xx.
754 md-raid: If device is resyncing, also shows resync progress
756 line.
757 Note: supported types: lvm raid, md-raid, softraid, ZFS, and
759 hardware RAID. Other software RAID types may be added, if the
760 software RAID can be made to give the required output.
761 The component ID numbers work like this: mdraid: the numerator
763 is the actual mdraid component number; lvm/softraid/ZFS: the nu‐
764 merator is auto-incremented counter only. Eg. Online: 1: sdb1
765 If hardware RAID is detected, shows basic information. Due to
767 complexity of adding hardware RAID device disk / RAID reports,
768 those will only be added if there is demand, and reasonable re‐
769 porting tools.
770 --recommends
773 Checks inxi application dependencies and recommends, as well as
774 directories, then shows what package(s) you need to install to
775 add support for each feature.
776 -s , --sensors
779 Show output from sensors if sensors installed/configured: Moth‐
780 erboard/CPU/GPU temperatures; detected fan speeds. GPU tempera‐
781 ture when available. Nvidia shows screen number for multiple
782 screens. IPMI sensors are also used (root required) if present.
783 See Advanced options --sensors-use or --sensors-exclude if you
785 want to use only a subset of all sensors, or exclude one (cur‐
786 rently only for lm-sensors and /sys sourced data).
787 For current Linux, will fallback gracefully to using
789 /sys/class/hwmon as sensor data source if lm-sensors is not in‐
790 stalled. You can compare the two by using --force sensors-sys
791 option with -s.
792 --slots
794 Show PCI slots with type, speed, and status information.
795 --swap
798 See -j
799 -S , --system
802 Show System information: host name, kernel, desktop environment
803 (if in X), distro. With -xx show dm - or startx - (only shows if
804 present and running if out of X), and if in X, with -xxx show
805 more desktop info, e.g. taskbar or panel.
806 -t , --processes
809 [c|m|cm|mc NUMBER] Show processes. If no arguments, defaults to
810 cm. If followed by a number, shows that number of processes for
811 each type (default: 5; if in IRC, max: 5)
812 Make sure that there is no space between letters and numbers
814 (e.g. write as -t cm10).
815 -t c - CPU only. With -x, also shows memory for that process on same
818 line.
819 -t m - memory only. With -x, also shows CPU for that process on same
822 line. If the -I or -m lines are not triggered, will also show
823 the system RAM used/total information.
824 See -m for explanation of System RAM: fields and values.
826 -t cm - CPU+memory. With -x, shows also CPU or memory for that process
829 on same line.
830 -u , --uuid
833 Show partition UUIDs. Use with -j, -o, -p, and -P to show parti‐
834 tion labels. Does nothing without one of those options.
835 Sample: -opju.
837 -U , --update
840 Note - Maintainer may have disabled this function.
841 If inxi -h has no listing for -U then it's disabled.
843 Auto-update inxi or pinxi. Note: if you installed as root, you
845 must be root to update, otherwise user is fine. Also installs /
846 updates current man page to: /usr/local/share/man/man1 (if
847 /usr/local/share/man/ exists AND there is no inxi man page in
848 /usr/share/man/man1, otherwise it goes to /usr/share/man/man1).
849 This requires that you be root to write to that directory. See
850 --man or --no-man to force or disable man install.
851 -U accepts the following options (inxi and pinxi):
853 No arg - Get from main git branch.
855 3 - Get the dev server (smxi.org) version. Be aware that pinxi
857 when taken from here can be very unstable during active develop‐
858 ment! The inxi version is the stable master branch version. Also
859 useful to update if you have SSL issues and --no-ssl works.
860 4 - Get the dev server (smxi.org) FTP version (same as 3 ver‐
862 sion). Use if SSL issues and --no-ssl doesn't work. For very old
863 systems with SSL 1, you will probably need to use this option,
864 which bypasses HTTP downloading, and uses straight FTP to get
865 the file from smxi.org server.
866 [http|https|ftp] - Get a version of $self_name from your own
868 server. Use the full download path, e.g.
869 inxi -U ^https://myserver.com/inxi
871 For failed downloads, use the debug option --dbg 1 in addition
873 to get more verbose failure reports.
874 --usb
877 See -J.
878 -V, --version
881 inxi full version and license information. Prints information
882 then exits.
883 --version-short, --vs
886 inxi single line version information. Prints information if not
887 short form (which shows version info already). Does not exit un‐
888 less used without any other options. Can be used with normal
889 line options.
890 -v , --verbosity
893 Script verbosity levels. If no verbosity level number is given,
894 0 is assumed. Should not be used with -b or -F.
895 Supported levels: 0-8 Examples : inxi -v 4 or inxi -v4
897 -v 0 - Short output, same as: inxi
900 -v 1 - Basic verbose, -S + basic CPU (cores, type, average clock
903 speed, and min/max speeds, if available) + -G + basic Disk + -I.
904 -v 2 - Adds networking device (-N), Machine (-M) data, Battery (-B)
907 (if available). Same as: inxi -b
908 -v 3 - Adds advanced CPU (-C) and network (-n) data; triggers -x ad‐
911 vanced data option.
912 -v 4 - Adds partition size/used data (-P) for (if present): / /home
915 /var/ /boot. Shows full drive data (-D)
916 -v 5 - Adds audio device (-A), memory/RAM (-m), bluetooth data (-E)
919 (if present), sensors (-s), RAID data (if present), partition
920 label (-l), UUID (-u), full swap data (-j), and short form of
921 optical drives.
922 -v 6 - Adds full mounted partition data (-p), unmounted partition
925 data (-o), optical drive data (-d), USB (-J); triggers -xx extra
926 data option.
927 -v 7 - Adds network IP data (-i), forced bluetooth (-E), Logical
930 (-L), RAID (-R), full CPU flags/features (-f), triggers -xxx
931 -v 8 - All system data available. Adds advanced EDID data (--edid),
934 Repos (-r), PCI slots (--slots), processes (-tcm), admin (--ad‐
935 min). Useful for testing output and to see what data you can get
936 from your system.
937 -w , --weather
940 Adds weather line. To get weather for an alternate location, use
941 -W [location]. See also -x, -xx, -xxx options. Please note that
942 your distribution's maintainer may chose to disable this fea‐
943 ture.
944 DO NOT USE THIS FEATURE FOR AUTOMATED WEATHER UPDATES! Automated
946 or excessive use will lead to your being blocked from any fur‐
947 ther access. This feature is not meant for widget type weather
948 monitoring, or Conky type use. It is meant to get weather when
949 you need to see it, for example, on a remote server. If you did
950 not type the weather option in manually, it's an automated re‐
951 quest.
952 -W, --weather-location [location_string]
955 Get weather/time for an alternate location. Accepts postal/zip
956 code[, country], city,state pair, or latitude,longitude. Note:
957 city/country/state names must not contain spaces. Replace spaces
958 with '+' sign. Don't place spaces around any commas. Postal code
959 is not reliable except for North America and maybe the UK. Try
960 postal codes with and without country code added. Note that
961 City,State applies only to USA, otherwise it's City,Country. If
962 country name (english) does not work, try 2 character country
963 code (e.g. Spain: es; Great Britain: gb).
964 See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 for current
966 2 letter country codes.
967 Use only ASCII letters in city/state/country names.
969 Examples: -W 95623,us OR -W Boston,MA OR -W 45.5234,-122.6762 OR
971 -W new+york,ny OR -W bodo,norway.
972 DO NOT USE THIS FEATURE FOR AUTOMATED WEATHER UPDATES! Automated
974 or excessive use will lead to your being blocked from any fur‐
975 ther access. This feature is not meant for widget type weather
976 monitoring, or Conky type use. It is meant to get weather when
977 you need to see it, for example, on a remote server. If you did
978 not type the weather option in manually, it's an automated re‐
979 quest.
980 --weather-source, --ws [unit]
983 [1-9] Switches weather data source. Possible values are 1-9.
984 1-4 will generally be active, and 5-9 may or may not be active,
985 so check. 1 may not support city / country names with spaces
986 (even if you use the + sign instead of space). 2 offers pretty
987 good data, but may not have all small city names for -W.
988 Please note that the data sources are not static per value, and
990 can change any time, or be removed, so always test to verify
991 which source is being used for each value if that is important
992 to you. Data sources may be added or removed on occasions, so
993 try each one and see which you prefer. If you get unsupported
994 source message, it means that number has not been implemented.
995 --weather-unit [unit]
998 [m|i|mi|im] Sets weather units to metric (m), imperial (i), met‐
999 ric (imperial) (mi, default), imperial (metric) (im). If metric
1000 or imperial not found,sets to default value, or N/A.
1001
1004 The following options allow for applying various types of filtering to
1005 the output.
1006 --filter , --filter-override
1009 See -z, -Z.
1010 --filter-label, --filter-uuid, --filter-vulnerabilities
1013 See --zl, --zu, --zv.
1014 --host Turns on hostname in System line. Overrides inxi config file
1017 value (if set):
1018 SHOW_HOST='false' - Same as: SHOW_HOST='true'
1020 This is an absolute override, the host will always show no mat‐
1022 ter what other switches you use.
1023 --no-host
1026 Turns off hostname in System line. This is default when using
1027 -z, for anonymizing inxi output for posting on forums or IRC.
1028 Overrides configuration value (if set):
1029 SHOW_HOST='true' - Same as: SHOW_HOST='false'
1031 This is an absolute override, the host will not show no matter
1033 what other switches you use.
1034 -z, --filter
1037 Adds security filters for IP addresses, serial numbers, MAC, lo‐
1038 cation (-w), and user home directory name. Removes Host:. On by
1039 default for IRC clients.
1040 --za, --filter-all
1043 Shortcut to trigger -z, --zl, --zu, --zv. All the filters, that
1044 is.
1045 --zl, --filter-label
1048 Filter partition label names from -j, -o, -p, -P, and -Sa
1049 (root=LABEL=...). Generally only useful in very specialized
1050 cases.
1051 --zu, --filter-uuid
1054 Filter partition UUIDs from -j, -o, -p, -P, and -Sa
1055 (root=UUID=...). Generally only useful in very specialized
1056 cases.
1057 --zv, --filter-v, --filter-vulnerabilities
1060 Filter Vulnerabilities report from -Ca. Generally only useful in
1061 very specialized cases.
1062 -Z , --filter-override , --no-filter
1065 Absolute override for output filters. Useful for debugging net‐
1066 working issues in IRC for example.
1067
1070 The following options allow for modifying the output in various ways.
1071 -c , --color [0-42]
1074 Set color scheme. If no scheme number is supplied, 0 is assumed.
1075 -c [94-99]
1078 These color selectors run a color selector option prior to inxi
1079 starting which lets you set the config file value for the selec‐
1080 tion.
1081 NOTE: All configuration file set color values are removed when
1083 output is piped or redirected. You must use the explicit runtime
1084 -c [color number] option if you want color codes to be present
1085 in the piped/redirected output.
1086 Color selectors for each type display (NOTE: IRC and global only
1088 show safe color set):
1089 -c 94 - Console, out of X.
1092 -c 95 - Terminal, running in X - like xTerm.
1095 -c 96 - GUI IRC, running in X - like XChat, Quassel, Konversation etc.
1098 -c 97 - Console IRC running in X - like irssi in xTerm.
1101 -c 98 - Console IRC not in X.
1104 -c 99 - Global - Overrides/removes all settings.
1107 Setting a specific color type removes the global color selec‐
1109 tion.
1110 --export [json|screen|xml]
1113 See --output.
1114 --indent [11-xx]
1117 Change primary wide indent width. Generally useless. Only ap‐
1118 plied if output width is greater than max wrap width (see
1119 --max-wrap). Use configuration item INDENT to make permanent.
1120 --indents [0-10]
1123 Change primary wrap mode, second, and -y1 level indents. First
1124 indent level only applied if output width is less than max wrap
1125 width (see --max-wrap). 0 disables all wrapped indents and all
1126 second level indents. Use configuration item INDENTS to make
1127 permanent.
1128 --limit [-1 - x]
1131 Raise or lower max output limit of IP addresses for -i. -1 re‐
1132 moves limit.
1133 --max-wrap, --wrap-max [integer]
1136 Overrides default or configuration set line starter wrap width
1137 value. Wrap max is the maximum width that inxi will wrap line
1138 starters (e.g. Info:) to their own lines, with data lines in‐
1139 dented default 2 columns (use --indents to change).
1140 If terminal/console width or --width is less than wrap width,
1142 wrapping of line starter occurs. If 80 or less, no wrapping will
1143 occur. Overrides internal default value (110) and user configu‐
1144 ration value MAX_WRAP.
1145 --output, --export [json|screen|xml]
1148 Change data output type. Requires --output-file if not screen.
1149 See this page https://smxi.org/docs/inxi-json-xml-output.htm BE‐
1151 FORE you post an issue about not understanding, or being unable
1152 to use, the output format! That gives a fairly complete explana‐
1153 tion of what the output means, and how to work with it. It is
1154 not a tutorial, and it will not teach you to program, if you
1155 don't know how to work with json/xml structures using a proper
1156 language, then this feature is not meant for you.
1157 --output-file, --export-file [full path to output file|print]
1160 The given directory path must exist. The directory path given
1161 must exist, The print options prints to stdout. Required for
1162 non-screen --output formats (json|xml).
1163 --partition-sort [dev-base|fs|id|label|percent-used|size|uuid|used]
1166 Change default sort order of partition output. Corresponds to
1167 PARTITION_SORT configuration item. These are the available sort
1168 options:
1169 dev-base - /dev partition identifier, like /dev/sda1. Note that
1171 it's an alphabetic sort, so sda12 is before sda2.
1172 fs - Partition filesystem. Note that sorts will be somewhat ran‐
1174 dom if all filesystems are the same.
1175 id - Mount point of partition (default).
1177 label - Label of partition. If partitions have no labels, sort
1179 will be random.
1180 percent-used - Percentage of partition size used.
1182 size - KiB size of partition.
1184 uuid - UUID of the partition.
1186 used - KiB used of partition.
1188 --separator, --sep [character(s)]
1191 Change the default output key: value separator : to something
1192 else. Make permanent with configuration item SEP2_CONSOLE.
1193 --wrap-max [integer]
1196 See --max-wrap.
1197 -y, --width [integer]
1200 This is an absolute width override which sets the output line
1201 width max. Overrides COLS_MAX_IRC, COLS_MAX_NO_DISPLAY,
1202 COLS_MAX_CONSOLE configuration items, or the actual widths of
1203 the terminal.
1204 * -y - sets default width of 80 columns.
1206 * -y [60-xxx] - sets width to given number. Must be 60 or more.
1207 * -y 1 - switches to a single indented key/value pair per line,
1208 and removes all long line wrapping (similar to dmidecode out‐
1209 put). Not recommended for use with -Y;
1210 * -y -1 - removes width limits (if assigned by configuration
1211 items).
1212 Examples:
1214 inxi -Fxx -y 130
1215 inxi -Fxxy
1216 inxi -bay1
1217 -Y, --height, --less [-3-[integer]
1220 Control output height. Useful when in console, and scrollback
1221 not available. Breaks output flow based on values provided.
1222 * -Y 0 or -Y - Set default max height to terminal height.
1224 * -Y [1-xxx] - set max output block height height in lines.
1225 * -Y -1 - Print out one primary data item block (like CPU:, Sys‐
1226 tem:) at a time. Useful for very long outputs like -Fa, -v8,
1227 etc. Not available for -h.
1228 * -Y -2 - Do not disable output colors when redirected or piped
1229 to another program. Useful if piping output to less -R for exam‐
1230 ple. This does not limit the height otherwise since the expecta‐
1231 tion it is being piped to another program like less which will
1232 handle that.
1233 * -Y -3 - Restore default unlimited output lines if LINES_MAX
1234 configuration item set.
1235 Recommended to use the following for very clean up and down
1237 scrollable output out of display, while retaining the color
1238 schemes, which are normally removed with piping or redirect:
1239 pinxi -v8Y -2 | less -R
1241 Note: since it's not possible for inxi to know how many actual
1243 terminal lines are being used by terminal wrapped output, with
1244 -y 1 , it may be better in general to use a fixed height like:
1245 -y 1 -Y 20 instead of: -y 1 -Y
1247
1250 These options can be triggered by one or more -x. Alternatively, the
1251 -v options trigger them in the following way: -v 3 adds -x; -v 6 adds
1252 -xx; -v 7 adds -xxx
1253 These extra data triggers can be useful for getting more in-depth data
1255 on various options. They can be added to any long form option list,
1256 e.g.: -bxx or -Sxxx
1257 There are 3 extra data levels:
1259 -x, -xx, -xxx
1260 OR
1261 --extra 1, --extra 2, --extra 3
1262 The following details show which lines / items display extra informa‐
1264 tion for each extra data level.
1265 -x -A - Adds (if available and/or relevant) vendor: item, which shows
1268 specific vendor [product] information.
1269 - Adds version/port(s)/driver version (if available) for each
1271 device.
1272 - Adds PCI/USB ID of each device.
1274 - Adds inactive sound servers/APIs, if detected.
1276 -x -B - Adds vendor/model, battery status (if battery present).
1279 - Adds attached battery powered peripherals (Device-[number]:)
1281 if detected (keyboard, mouse, etc.).
1282 - Adds battery volts:, min: voltages. Note that if difference is
1284 critical, that is current voltage is too close to minimum volt‐
1285 age, shows without -x.
1286 -x -C - Adds bogomips to CPU speed report (if available).
1289 - Adds L1: and L3: cache types if either are present/available.
1291 For BSD or legacy Linux, uses dmidecode + doas/sudo/root. Force
1292 use of dmidecode cache values by adding --dmidecode. This will
1293 override /sys based cache data, which tends to be better, so in
1294 general don't do that.
1295 - Adds boost: [enabled|disabled] if detected, aka turbo. Not all
1297 CPUs have this feature.
1298 - Adds CPU Flags (short list). Use -f to see full flag/feature
1300 list.
1301 - Adds CPU microarchitecture + revision (e.g. Sandy Bridge, K8,
1303 ARMv8, P6, etc.). Only shows data if detected. Newer microarchi‐
1304 tectures will have to be added as they appear, and require the
1305 CPU family ID, model ID, and stepping.
1306 - Adds, if smt (Simultaneous MultiThreading) is available but
1308 disabled, after type: data smt: disabled. type: MT means it's
1309 enabled. See -Cxxx.
1310 Examples:
1312 arch: Sandy Bridge rev: 2
1313 arch: K8 rev.F+ rev: 2
1314 If unable to non-ambiguosly determine architecture, will show
1316 something like: arch: Amber Lake note: check rev: 9
1317 - Adds CPU highest speed after avg: [speed] high: [speed] if
1319 greater than 1 core and cores have different speeds. Linux only.
1320 -x -d - Adds more items to Features line of optical drive; dds rev
1323 version to optical drive.
1324 -x -D - Adds drive temperature with disk data.
1327 Method 1: Systems running Linux kernels ~5.6 and newer should
1329 have drivetemp module data available. If so, drive temps will
1330 come from /sys data for each drive, and will not require root or
1331 hddtemp. This method is MUCH faster than using hddtemp. Note
1332 that NVMe drives do not require drivetemp.
1333 If your drivetemp module is not enabled, enable it:
1335 modprobe drivetemp
1337 Once enabled, add drivetemp to /etc/modules or /etc/mod‐
1339 ules-load.d/***.conf so it starts automatically.
1340 If you see drive temps running as regular user and you did not
1342 configure system to use doas/sudo hddtemp, then your system sup‐
1343 ports this feature. If no /sys data is found, inxi will try to
1344 use hddtemp methods instead for that drive. Hint: if temp is
1345 /sys sourced, the temp will be to 1 decimal, like 34.8, if hd‐
1346 dtemp sourced, they will be integers.
1347 Method 2: if you have hddtemp installed, if you are root or if
1349 you have added to /etc/sudoers (sudo v. 1.7 or newer):
1350 <username> ALL = NOPASSWD: /usr/sbin/hddtemp (sample)
1352 doas users: see man doas.conf for setup.
1354 You can force use of hddtemp for all drives using --hddtemp.
1356 - If free LVM volume group size detected (root required), show
1358 lvm-free: on Local Storage line. This is how much unused space
1359 the VGs contain, that is, space not assigned to LVs.
1360 -x -E (--bluetooth)
1363 - Adds (if available and/or relevant) vendor: item, which shows
1364 specific vendor [product] information.
1365 - Adds PCI/USB Bus ID of each device.
1367 - Adds driver version (if available) for each device.
1369 - Adds (if available, btmgmt, hciconfig only) LMP (HCI if no LMP
1371 data, and HCI if HCI/LMP versions are different) version (if
1372 available) for each HCI ID.
1373 -x -G - Adds GPU micro-architecture (if AMD/Intel/Nvidia and de‐
1376 tected).
1377 - Adds PCI/USB ID of each device.
1379 - Adds (if available and/or relevant) vendor: item, which shows
1381 specific vendor [product] information.
1382 - X.org: Adds (for single GPU, nvidia driver) screen number that
1384 GPU is running on.
1385 - Adds device temperature for each discrete device (Linux only).
1387 - For EGL, adds active/inactive platform report.
1389 - For OpenGL (X.org only) adds direct render status, GLX ver‐
1391 sion.
1392 - For Vulkan, adds device count.
1394 -x -i - Adds IP v6 additional scope data, like Global, Site, Temporary
1397 for each interface.
1398 Note that there is no way we are aware of to filter out the dep‐
1400 recated IP v6 scope site/global temporary addresses from the
1401 output of ifconfig. The ip tool shows that clearly.
1402 ip-v6-temporary - (ip tool only), scope global temporary. Scope
1404 global temporary deprecated is not shown
1405 ip-v6-global - scope global (ifconfig will show this for all
1407 types, global, global temporary, and global temporary depre‐
1408 cated, ip shows it only for global)
1409 ip-v6-link - scope link (ip/ifconfig) - default for -i.
1411 ip-v6-site - scope site (ip/ifconfig). This has been deprecated
1413 in IPv6, but still exists. ifconfig may show multiple site val‐
1414 ues, as with global temporary, and global temporary deprecated.
1415 ip-v6-unknown - unknown scope
1417 -x -I - Adds current init system (and init rc in some cases, like
1420 OpenRC). With -xx, shows init/rc version number, if available.
1421 - Adds default system gcc. With -xx, also show other installed
1423 gcc versions.
1424 - Adds current runlevel/target (not available with all init sys‐
1426 tems).
1427 - Adds total packages discovered in system. See -xx and -a for
1429 per package manager types output. Moves to Repos if -rx.
1430 If your package manager is not supported, please file an issue
1432 and we'll add it. That requires the full output of the query or
1433 method to discover all installed packages on your system, as
1434 well of course as the command or method used to discover those.
1435 - If in shell (i.e. not in IRC client), adds shell version num‐
1437 ber, if available.
1438 -x -j (--swap)
1441 Add mapper:. See -x -o.
1442 -x -J (--usb)
1445 - For Devices, adds driver(s).
1446 - Adds, if available, USB speed in base 10 bits/s (Si) units
1448 Mb/s or Gb/s (may be incorrect on BSDs due to non reliable data
1449 source). These are base 10 bits per second. This unit corre‐
1450 sponds to the standard units the USB consortium uses to indicate
1451 speeds, but not to how most of the rest of your system reports
1452 sizes. Use -Jxx to add base 2 IEC Byte/second speeds.
1453 -x -L (--logical)
1456 - Adds dm: dm-x to VG > LV and other Device types. This can help
1457 tracking down which device belongs to what.
1458 -x -m, --memory-modules
1461 - If present, adds maximum memory module/device size in the Ar‐
1462 ray line. Only some systems will have this data available.
1463 Shows estimate if it can generate one.
1464 -x -N - Adds (if available and/or relevant) vendor: item, which shows
1467 specific vendor [product] information.
1468 - Adds version/port(s)/driver version (if available) for each
1470 device;
1471 - Adds PCI/USB ID of each device.
1473 - Adds device temperature for each discrete device (Linux only).
1475 -x -o, -x -p, -x -P
1478 - Adds mapper: (the /dev/mapper/ partition ID) if mapped parti‐
1479 tion.
1480 Example: ID-4: /home ... dev: /dev/dm-6 mapped: ar0-home
1482 -x -r - Adds Package info. See -Ix
1485 -x -R - md-raid: Adds second RAID Info line with extra data: blocks,
1488 chunk size, bitmap (if present). Resync line, shows blocks
1489 synced/total blocks.
1490 - Hardware RAID: Adds driver version, Bus ID.
1492 -x -s - Adds basic voltages: 12v, 5v, 3.3v, vbat (ipmi, lm-sensors /
1495 /sys/class/hwmon if present).
1496 -x -S - Adds Kernel gcc version.
1499 - Adds to Distro: base: if detected. System base will only be
1501 seen on a subset of distributions. The distro must be both de‐
1502 rived from a parent distro (e.g. Mint from Ubuntu), and explic‐
1503 itly added to the supported distributions for this feature. Due
1504 to the complexity of distribution identification, these will
1505 only be added as relatively solid methods are found for each
1506 distribution system base detection.
1507 -x --slots
1510 - Adds slot bus-ID:, if found.
1511 -x -t (--processes)
1514 - Adds memory use output to CPU (-xt c), and CPU use to memory
1515 (-xt m).
1516 -x -w , -W
1519 - Adds humidity and barometric pressure.
1520 - Adds wind speed and direction.
1522 -xx -A - Adds vendor:product ID for each device.
1525 - Adds PCIe speed and lanes item (Linux only, if detected).
1527 - Adds for USB devices USB rev, speed, lanes (lanes Linux only).
1529 - Adds with: [item] status: [state/plugin] helper daemons/plug‐
1531 ins for the sound API/server.
1532 -xx -B - Adds current power use, in watts.
1535 - Adds serial number.
1537 -xx -D - Adds HDD/SSD drive serial number.
1540 - Adds drive speed (if available). This is the theoretical top
1542 speed of the device as reported. This speed may be restricted by
1543 system board limits, eg. a SATA 3 drive on a SATA 2 board may
1544 report SATA 2 speeds, but this is not completely consistent,
1545 sometimes a SATA 3 device on a SATA 2 board reports its design
1546 speed.
1547 NVMe drives: adds lanes, and (per direction) speed is calculated
1549 with lane speed * lanes * PCIe overhead. PCIe 1 and 2 have data
1550 rates of GT/s * .8 = Gb/s (10 bits required to transfer 8 bits
1551 of data). PCIe 3 and greater transfer data at a rate of GT/s *
1552 128/130 * lanes = Gb/s (130 bits required to transfer 128 bits
1553 of data).
1554 For a PCIe 3 NVMe drive, with speed of 8 GT/s and 4 lanes (8GT/s
1556 * 128/130 * 4 = 31.6 Gb/s):
1557 speed: 31.6 Gb/s lanes: 4
1559 - Adds HDD/SSD drive duid, if available. Some BSDs have it.
1561 - Adds for USB drives USB rev, speed, lanes (lanes Linux only).
1563 -xx -E (--bluetooth)
1566 - Adds vendor:product ID of each device.
1567 - Adds PCIe speed and lanes item (Linux only, and if PCIe blue‐
1569 tooth, which is rare).
1570 - Adds for USB devices USB rev, speed, lanes (lanes Linux only).
1572 - Adds (hciconfig only) LMP subversion (and/or HCI revision if
1574 applicable) for each device.
1575 -xx -G Triggers much more complete Screen/Monitor output.
1578 X.org: requires xdpyinfo or xrandr, and the advanced per monitor
1580 feature requires xrandr.
1581 Wayland: requires any tool capable of showing monitor and reso‐
1583 lution information. Sway has swaymsg, weston-info or way‐
1584 land-info can show Wayland information on any Wayland composi‐
1585 tor, and wlr-randr can show Wayland information for any wlroots
1586 based compositor.
1587 Further note that all references to Displays, Screens, and Moni‐
1589 tors are referring to the X or Wayland technical terms, not nor‐
1590 mal consumer usage.
1591 X.org: 1 Display runs 1 or more Screens, and 1 Screen runs 1 or
1593 more Monitors.
1594 Wayland: The Display is the primary container, and it can con‐
1596 tain 1 or more Monitors.
1597 - Adds vendor:product ID of each device.
1599 - Adds PCIe speed and lanes item (Linux only, and if PCIe device
1601 and detected).
1602 - Adds for USB devices USB rev, speed, lanes (lanes Linux only).
1604 - Adds output port IDs, active, off (connected but disabled,
1606 like a closed laptop lid) and empty. Example:
1607 ports: active: DVI-I-1,VGA-1 empty: HDMI-A-1
1609 - Adds Display ID. X.org: the Display running the Screen that
1611 runs the Monitors; Wayland: the Display that runs the monitors.
1612 - Adds compositor, if found (always shows for Wayland).
1614 - Wayland: Adds to Display d-rect: if > 1 monitors in Display.
1616 This is the size of the rectangle Wayland creates to situate the
1617 monitors in.
1618 - X.org: If available, shows alternate: Xorg drivers. This means
1620 a driver on the default list of drivers Xorg automatically
1621 checks for the device, but which is not installed. For example,
1622 if you have nouveau driver, nvidia would show as alternate if it
1623 was not installed. Note that alternate: does NOT mean you should
1624 have it, it's just one of the drivers Xorg checks to see if is
1625 present and loaded when checking the device. This can let you
1626 know there are other driver options. Note that if you have ex‐
1627 plicitly set the driver in xorg.conf, Xorg will not create this
1628 automatic check driver list.
1629 - Xorg: Adds total number of Screens listed for the current Dis‐
1631 play.
1632 - Xorg: Adds default Screen ID if Screen (not monitor!) total is
1634 greater than 1.
1635 - X.org: Adds Screen line, which includes the ID (Screen: 0)
1637 then s-res (Screen resolution), s-dpi. Remember, this is an Xorg
1638 Screen, NOT a monitor screen, and the information listed is
1639 about the Xorg Screen! It may at times be the same as a single
1640 monitor system, but usually it's different in some ways. Note
1641 that the physical monitor dpi and the Xorg dpi are not necessar‐
1642 ily the same thing, and can vary widely.
1643 - Adds Monitor lines. Monitors are a subset of a Screen (X.org)
1645 or Display (Wayland), each of which can have one or more moni‐
1646 tors. Normally a dual monitor setup is 2 monitors run by one
1647 Xorg Screen/Wayland Display.
1648 - pos: [primary,]{position string|row-col} (X.org: requires
1650 xrandr; Wayland: requires swaymsg [sway], wlr-randr [wlroots
1651 based compositors], weston-info / wayland-info [all]). Uses ei‐
1652 ther explicit primary value or +0+0 position if no primary moni‐
1653 tor value set. pos: does not show for single monitor setups, or
1654 if no position data was found.
1655 Position is text (left, center, center-l, center-r, right, top,
1657 top-left, top-center, top-right, middle, middle-c, middle-r,
1658 bottom, bottom-l, bottom-c, bottom-r) if monitors fit within the
1659 following grids: 1x2, 1x3, 1x4, 2x1, 2x2, 2x3, 3x1, 3x2, 3x3. If
1660 layout not supported in text, uses [row-nu]-[column-nu] instead
1661 to indicate the monitor's position in its grid.
1662 The position is based on the upper left corner of each monitor
1664 relative to the grid of monitors that the Xorg Screen is com‐
1665 posed of.
1666 - diag: monitor screen diagonal in mm (inches). Note that this
1668 is the real monitor size, not the Xorg full Screen diagonal
1669 size, which can be quite different.
1670 - For EGL, shows platform by specific platforms, with driver and
1672 egl version if different from the main one.
1673 - For OpenGL, adds ES version (es-v) if available. If the Dis‐
1675 play line did not find an X11 display ID, the ID (e.g. :0.0)
1676 will show here instead.
1677 - For OpenGL, Vulkan, adds device-ID, if available.
1679 - For Vulkan, adds per Device ID report (type, driver, de‐
1681 vice-ID).
1682 -xx -I - Adds init type version number (and rc if present).
1685 - Adds other detected installed gcc versions (if present).
1687 - Adds system default runlevel/target, if detected. Supports
1689 Systemd / Upstart /SysVinit type defaults.
1690 - Shows Packages: counts by discovered package manager types
1692 (pm:). In cases where only 1 pm had results, does not show to‐
1693 tal after Packages:. Does not show installed package managers
1694 with 0 packages. See -a for full output. Moves to Repos if -rxx.
1695 - Adds parent program (or pty/tty) that started shell, if not
1697 IRC client.
1698 -xx -j (--swap), -xx -p, -xx -P
1701 - Adds swap priority to each swap partition (for -P) used, and
1702 for all swap types (for -j).
1703 -xx -J (--usb)
1706 - Adds vendor:chip id.
1707 - Adds USB lanes. Uses tx (transmit) lane count for total unless
1709 rx and tx counts are different (eg: lanes: rx: 2 tx: 4). Linux
1710 only. See -Ja for sample output.
1711 -xx -L (--logical)
1714 - Adds internal LVM Logical volumes, like raid image and meta
1715 data volumes.
1716 - Adds full list of Components, sub-components, and their physi‐
1718 cal devices.
1719 - For LVM RAID, adds a RAID report line (if not -R). Read up on
1721 LVM documentation to better understand their use of the term
1722 'stripes'.
1723 -xx -m, --memory-modules
1726 - Adds memory device Manufacturer.
1727 - Adds memory device Part Number (part-no:). Useful for ordering
1729 new or replacement memory sticks etc. Part numbers are unique,
1730 particularly if you use the word memory in the search as well.
1731 With -xxx, also shows serial number.
1732 - Adds single/double bank memory, if data is found. Note, this
1734 may not be 100% right all of the time since it depends on the
1735 order that data is found in dmidecode output for type 6 and type
1736 17.
1737 - Adds, if present, memory array voltage. Only some legacy sys‐
1739 tems will have this data available.
1740 - Adds memory module current configured operating voltage, if
1742 available.
1743 -xx -M - Adds chassis information, if data is available. Also shows
1746 BIOS ROM size if using dmidecode.
1747 -xx -N - Adds vendor:product ID for each device.
1750 - Adds PCIe speed and lanes item (Linux only, and if PCIe device
1752 and detected).
1753 - Adds for USB devices USB rev, speed, lanes (lanes Linux only).
1755 -xx -r - Adds to Packages: info. See -Ixx
1758 -xx -R - md-raid: Adds superblock (if present) and algorithm. If
1761 resync, shows progress bar.
1762 - Hardware RAID: Adds Chip vendor:product ID.
1764 -xx -s - Adds DIMM/SOC voltages, if present (ipmi only).
1767 -xx -S - Adds display manager (dm) type, if present. If none, shows
1770 N/A. Supports most known display managers, including gdm, gdm3,
1771 idm, kdm, lightdm, lxdm, mdm, nodm, sddm, slim, tint, wdm, and
1772 xdm.
1773 - Adds, if run in X, window manager type (wm), if available. Not
1775 all window managers are supported. Some desktops support using
1776 more than one window manager, so this can be useful to see what
1777 window manager is actually running. If none found, shows noth‐
1778 ing. Uses a less accurate fallback tool wmctrl if ps tests fail
1779 to find data.
1780 - Adds desktop toolkit (tk), if available (Xfce/KDE/Trinity).
1782 -xx --slots
1785 - Adds slot length.
1786 - Adds slot voltage, if available.
1788 -xx -w , -W
1791 - Adds wind chill, heat index, and dew point, if available.
1792 - Adds cloud cover, rain, snow, or precipitation (amount in pre‐
1794 vious hour to observation time), if available.
1795 -xxx -A
1798 - Adds, if present, serial number.
1799 - Adds, if present, PCI/USB class ID.
1801 -xxx -B
1804 - Adds battery chemistry (e.g. Li-ion), cycles (NOTE: there ap‐
1805 pears to be a problem with the Linux kernel obtaining the cycle
1806 count, so this almost always shows 0. There's nothing that can
1807 be done about this glitch, the data is simply not available as
1808 of 2018-04-03), location (only available from dmidecode derived
1809 output).
1810 - Adds attached device rechargeable: [yes|no] information.
1812 -xxx -C
1815 - Adds CPU voltage and external clock speed (this is the mother‐
1816 board speed). Requires doas/sudo/root and dmidecode.
1817 - Adds, if smt (Simultaneous MultiThreading) data is available,
1819 after type: data smt: [status].
1820 smt: [status]
1821 MT in type: will show if smt is enabled in general. 3 values are
1822 possible: [enabled|disabled|<unsupported>]. <unsupported> means
1823 the CPU does not support SMT.
1824 -xxx -D
1827 - Adds HDD/SSD drive firmware revision number (if available).
1828 - Adds drive partition scheme (in most cases), e.g. scheme: GPT.
1830 Currently not able to detect all schemes, but handles the most
1831 common, e.g. GPT or MBR.
1832 - Adds drive tech (HDD/SSD), rotation speed (in some but not all
1834 cases), e.g. tech: HDD rpm: 7200, or tech: SSD if positive SSD
1835 identification was made. If no HDD, rotation, or positive SSD ID
1836 found, shows tech: N/A. Not all HDD spinning disks report their
1837 speed, so even if they are spinning, no rpm data will show.
1838 -xxx -E (--bluetooth)
1841 - Adds, if present, PCI/USB class ID.
1842 - Adds, if present, bluetooth device class ID.
1844 - Adds (hciconfig only) HCI version, revision.
1846 -xxx -G
1849 - Adds, if present, Device PCI/USB class ID.
1850 - Adds to Device serial: number (if found).
1852 - Xorg: Adds to Screen: s-size: and s-diag:. (Screen size data
1854 requires xdpyinfo). This is the X.org Screen dimensions, NOT the
1855 Monitor size!
1856 - Adds to Monitors (if detected) frequency (hz:).
1858 - Adds to Monitors (if detected) size (size: 277x156mm
1860 (10.9x6.1")). Note that this is the real physical monitor size,
1861 not the Xorg Screen/Wayland Display size, which can be quite
1862 different (1 Xorg Screen / Wayland Display can for instance con‐
1863 tain two or more monitors).
1864 - Adds to Monitors modes: min: max: (if detected). These are the
1866 smallest and largest monitor modes found, using an inexact
1867 method, so might not always be right.
1868 - Adds to Monitors serial: number (if detected).
1870 - Wayland: Adds to Monitors scale: (if detected).
1872 - For EGL, shows hardware based driver(s) (hw:), with the re‐
1874 lated hardware, like AMD or Intel.
1875 - For Vulkan, adds layer count, per device driver hardware ven‐
1877 dor (not displayed if device name is present with -a).
1878 -xxx -I
1881 - For Uptime: adds wakeups: to show how many times the machine
1882 has been woken from suspend state during current uptime period
1883 (if available, Linux only). 0 value means the machine has not
1884 been suspended.
1885 - For Shell: adds (su|sudo|login) to shell name if present.
1887 - For Shell: adds default: shell if different from running
1889 shell, and default shell v:, if available.
1890 - For running-in: adds (SSH) to parent, if present. SSH detec‐
1892 tion uses the whoami test.
1893 -xxx -J (--usb)
1896 - Adds, if present, serial number for non hub devices.
1897 - Adds interfaces: for non hub devices.
1899 - Adds, if present, USB class ID.
1901 - Adds, if non 0, max power in mA.
1903 -xxx -m, --memory-modules
1906 - Adds memory bus width: primary bus width, and if present, to‐
1907 tal width. e.g.
1908 width (bits): data: 64 total: 72
1910 Note that total / data widths are mixed up sometimes in dmide‐
1912 code output, so inxi will take the larger value as the total if
1913 present. Data width usually corresponds to the CPU bits. Total
1914 can reflect EEC or Dual Channel widths. If no total width data
1915 is found, shows:
1916 width: N/A
1918 - Adds device type detail, e.g. type: DDR3 detail: Synchronous.
1920 - Adds device serial number.
1922 - Adds memory module current, max, and min voltages, if they are
1924 available and different from each other. If they are the identi‐
1925 cal, displays same as -xxm voltage report. Use -ma to always see
1926 them.
1927 -xxx -N
1930 - Adds, if present, serial number.
1931 - Adds, if present, PCI/USB class ID.
1933 -xxx -R
1936 - md-raid: Adds system mdraid support types (kernel support,
1937 read ahead, RAID events)
1938 - zfs-raid: Adds portion allocated (used) by RAID array/device.
1940 - Hardware RAID: Adds rev, ports, and (if available and/or rele‐
1942 vant) vendor: item, which shows specific vendor [product] infor‐
1943 mation.
1944 -xxx -S
1947 - Adds current kernel clock source, if available (Linux only).
1948 - Adds, if in X, or with --display, bar/dock/panel/tray items
1950 (info). If none found, shows nothing. Supports desktop items
1951 like gnome-panel, lxpanel, xfce4-panel, lxqt-panel, tint2,
1952 cairo-dock, trayer, and many others.
1953 - Adds (if present), window manager (wm) version number.
1955 - Adds (if present), display manager (dm) version number.
1957 - Adds (if available, and in display), virtual terminal (vt)
1959 number. These are the same as ctrl+alt+F[x] numbers usually.
1960 Some systems have this, some don't, it varies.
1961 -xxx -w , -W
1964 - Adds location (city state country), observation altitude (if
1965 available), weather observation time (if available), sunset/sun‐
1966 rise (if available).
1967
1970 These options are triggered with --admin or -a. Admin options are ad‐
1971 vanced output options, and are more technical, and mostly of interest
1972 to system administrators or other machine admins.
1973 The --admin option sets -xxx, and only has to be used once. It will
1975 trigger the following features:
1976 -a -A - Adds, if present, possible alternate: kernel modules capable
1979 of driving each Device-x (not including the current driver:). If
1980 no non-driver modules found, shows nothing. NOTE: just because
1981 it lists a module does NOT mean it is available in the system,
1982 it's just something the kernel knows could possibly be used in‐
1983 stead.
1984 - Adds PCIe generation, and, if different than running PCIe gen‐
1986 eration, speed or lanes, link-max: gen: speed: lanes: (only
1987 items different from primary shown).
1988 - Adds list of detected audio server tools (tools: [tools]) to
1990 API/Server lines, like alsamixer, jack_control, pactl, pavuctl,
1991 pw-cli, sndioctl, etc.
1992 - Adds for USB devices USB mode (Linux only).
1994 -a -C
1997 - Adds CPU generation, process node, and built years, if de‐
1998 tected. For Intel, only will show if Core generation, otherwise
1999 the arch value is enough. For AMD, only shows Zen generation.
2000 - Adds microarchitecture level: (v1,v2,v3,v4) (64 bit Intel/AMD
2002 CPUs only). This information is used for setting compile time
2003 optimization switches in for example GCC. These levels were in‐
2004 troduced in 2020.
2005 Because this a CPU flag based test, and these levels when > 2
2007 are not always 100% based on exposed CPU flags (eg OSXSAVE), for
2008 > v2, adds note: check.
2009 - Adds CPU family, model-id, and stepping (replaces rev of -Cx).
2011 Format is hexadecimal (decimal) if greater than 9, otherwise
2012 hexadecimal.
2013 - Adds CPU microcode. Format is hexadecimal.
2015 - Adds socket type (for motherboard CPU socket, if available).
2017 If results doubtful will list two socket types and note: check.
2018 Requires doas/sudo/root and dmidecode. The item in parentheses
2019 may simply be a different syntax for the same socket, but in
2020 general, check this before trusting it.
2021 Sample: socket: 775 (478) note: check
2023 Sample: socket: AM4
2024 - Adds DMI CPU base and boost/turbo speeds. Requires
2026 doas/sudo/root and dmidecode. In some cases, like with over‐
2027 clocking or 'turbo' or 'boost' modes, voltage and external clock
2028 speeds may be increased, or short term limits raised on max CPU
2029 speeds. These are often not reflected in /sys based CPU min/max:
2030 speed results, but often are using this source.
2031 Samples:
2033 CPU not overclocked, with boost, like Ryzen:
2034 Speed (MHz):
2035 avg: 2861
2036 high: 3250
2037 min/max: 1550/3400
2038 boost: enabled
2039 base/boost: 3400/3900
2040 Overclocked 2900 MHz CPU, with no boost available:
2041 Speed (MHz):
2042 avg: 2345
2043 high: 2900
2044 min/max: 800/2900
2045 base/boost: 3350/3000
2046 Overclocked 3000 MHz CPU, with boosted max speed:
2047 Speed (MHz):
2048 avg: 3260
2049 high: 4190
2050 min/max: 1200/3001
2051 base/boost: 3000/4000
2052 Note that these numbers can be confusing, but basically, the
2054 base number is the actual normal top speed the CPU runs at with‐
2055 out boost mode, and the boost number is the max speed the CPU
2056 reports itself able to run at. The actual max speed may be
2057 higher than either value, or lower. The boost number appears to
2058 be hard-coded into the CPU DMI data, and does not seem to re‐
2059 flect actual max speeds that overclocking or other combinations
2060 of speed boosters can enable, as you can see from the example
2061 where the CPU is running at a speed faster than the min/max or
2062 base/boost values.
2063 Note that the normal min/max: speeds do NOT show actual over‐
2065 clocked OR boost/turbo mode speeds, and appear to be hard-coded
2066 values, not dynamic real values. The base/boost: values are
2067 sometimes real, and sometimes not. base appears in general to
2068 be real.
2069 - Adds frequency scaling: governor:.. driver:.. if found/avail‐
2071 able. Also adds scaling min/max speeds if different from stan‐
2072 dard CPU min/max spees (not common).
2073 - Adds description of cache topology per cpu. Linux only.
2075 - Creates new Topology: line after the Info: line. Moves cache
2077 data to this line from Info: line.
2078 Topology line contains, if available and/or relevant: physical
2080 CPU count (cpus:); per physical cpu core count (cores:); threads
2081 per core, if > 1 (tpc:); how many threads: (if more threads than
2082 cores); dies: (rarely detected, but if so, if > 1); smt status
2083 (if no smt status found, shows N/A).
2084 If complex CPU type, like Alder lake, cores; will have a more
2086 granular breakdown of how many mt (multi-threaded) and how many
2087 st (single-threaded) cores there in the physical cpu (
2088 mt-cores:, st-cores:); For complex CPU types like ARM SoC de‐
2089 vices with 2 CPU types, with different core counts and/or
2090 min/max:) frequencies, variant: per type found, with relevant
2091 differences shown, like cores:, min/max:, etc.
2092 CPU:
2094 Info:
2095 model: AMD EPYC 7281
2096 bits: 64
2097 type: MT MCP MCM SMP
2098 arch: Zen
2099 gen: 1
2100 level: v3
2101 note: check
2102 process: GF 14nm
2103 built: 2017-19
2104 family:0x17 (23)
2105 model-id:1
2106 stepping: 2
2107 microcode: 0x8001250
2108 Topology:
2109 cpus: 2
2110 cores: 16
2111 tpc: 2
2112 threads: 32
2113 dies: 4
2114 cache:
2115 L1: 2x 1.5 MiB (3 MiB)
2116 desc: d-16x32 KiB; i-16x64 KiB
2117 L2: 2x 8 MiB (16 MiB)
2118 desc: 16x512 KiB
2119 L3: 2x 32 MiB (64 MiB)
2120 desc: 8x4 MiB
2121 Speed (MHz):
2122 avg: 1195
2123 high: 1197
2124 min/max: 1200/2100
2125 boost: enabled
2126 scaling:
2127 driver: acpi-cpufreq
2128 governor: ondemand
2129 cores:
2130 1: 1195
2131 2: 1196
2132 ....
2133 bogomips: 267823
2134 - Adds CPU Vulnerabilities (bugs) as known by your current ker‐
2136 nel. Lists by Type: ... (status|mitigation): .... for systems
2137 that support this feature (Linux kernel 4.14 or newer, or
2138 patched older kernels).
2139 -a -d,-a -D
2142 - Adds logical and physical block size in bytes.
2143 Using smartctl (requires doas/sudo/root privileges).
2145 - Adds device model family, like Caviar Black, if available.
2147 - Adds SATA type (eg 1.0, 2.6, 3.0) if a SATA device.
2149 - Adds device kernel major:minor number (Linux only).
2151 - Adds SMART report line: status, enabled/disabled, health, pow‐
2153 ered on, cycles, and some error cases if out of range values.
2154 Note that for Pre-fail items, it will show the VALUE and THRESH‐
2155 OLD numbers. It will also fall back for unknown attributes that
2156 are or have been failing and print out the Attribute name,
2157 value, threshold, and failing message. This way even for unhan‐
2158 dled Attribute names, you should get a solid report for full
2159 failure cases. Other cases may show if inxi believes that the
2160 item may be approaching failure. This is a guess so make sure to
2161 check the drive and smartctl full output to verify before taking
2162 any further action.
2163 - Adds, for USB or other external drives, actual model name/se‐
2165 rial if available, and different from enclosure model/serial,
2166 and corrects block sizes if necessary.
2167 - Adds for USB drives USB mode (Linux only).
2169 - Adds in drive temperature for some drives as well, and other
2171 useful data.
2172 -a -E (--bluetooth)
2175 - Adds (hciconfig only) extra line to Report:, Info:. Includes,
2176 if available, ACL MTU, SCO MTU, Link policy, Link mode, and Ser‐
2177 vice Classes.
2178 - Adds PCIe generation, and, if different than running PCIe gen‐
2180 eration, speed or lanes, link-max: gen: speed: lanes: (only
2181 items different from primary shown. Bluetooth PCIe rare).
2182 - Adds for USB devices USB mode (Linux only).
2184 - Adds, if present, bluetooth status: discoverable, active dis‐
2186 coverable, and pairing items.
2187 -a -G - Adds, if present, possible alternate: kernel modules capable
2190 of driving each Device-x (not including the current loaded:). If
2191 no non-driver modules found, shows nothing. NOTE: just because
2192 it lists a module does NOT mean it is available in the system,
2193 it's just something the kernel knows could possibly be used in‐
2194 stead.
2195 - Adds (AMD/Intel/Nvidia, if available) process: [node] built:
2197 [years] to arch: item.
2198 - Adds (if Linux and Nvidia device) non-free support information
2200 (if available). This can be useful for forum support people to
2201 determine if the card supports current active legacy Nvidia
2202 driver branches, or if the card nonfree driver is EOL or active.
2203 Note that if card is current, shows basic series and status.
2204 Includes extended non free Nvidia legacy informatin (Linux and
2206 Nvidia only), and arch: reports (AMD/Intel/Nvidia). Useful to
2207 help diagnose driver support issues, shows extra data that can
2208 help diagnose/debug. Adds code: item if found and not the same
2209 as arch:.
2210 - Adds for USB devices USB mode (Linux only).
2212 inxi -Gaz
2214 Graphics:
2215 Device-1: NVIDIA NV34 [GeForce FX 5200] driver: nouveau v: kernel
2216 non-free: 173.14.xx status: legacy (EOL) last: kernel: 3.12 xorg: 1.15
2217 release: 173.14.39 arch: Rankine code: NV3x process: 130-150nm
2218 built: 2003-05 ports: active: VGA-1 empty: DVI-I-1,TV-1
2219 bus-ID: 01:00.0 chip-ID: 10de:0322 class-ID: 0300
2220 Display: x11 server: X.Org v: 21.1.3 driver: X: loaded: nouveau
2221 unloaded: fbdev,modesetting,vesa alternate: nv,nvidia gpu: nouveau
2222 display-ID: :0 screens: 1
2223 With -y1:
2225 inxi -Gaz -y1
2227 Graphics:
2228 Device-1: NVIDIA NV34 [GeForce FX 5200]
2229 driver: nouveau
2230 v: kernel
2231 non-free:
2232 series: 173.14.xx
2233 status: legacy (EOL)
2234 last:
2235 kernel: 3.12
2236 xorg: 1.15
2237 release: 173.14.39
2238 arch: Rankine
2239 code: NV3x
2240 process: 130-150nm
2241 built: 2003-05
2242 ports:
2243 active: VGA-1
2244 empty: DVI-I-1,TV-1
2245 bus-ID: 01:00.0
2246 chip-ID: 10de:0322
2247 class-ID: 0300
2248 - Adds PCIe generation, and, if different than running PCIe gen‐
2250 eration, speed or lanes, link-max: gen: speed: lanes: (only
2251 items different from primary shown).
2252 - Adds to Monitors built:, gamma:, ratio: (if found).
2254 - Adds to OpenGL device memory and unified status, if present.
2256 - Adds to Vulkan full device report, with full device names,
2258 ids, drivers, driver versions, surfaces.
2259 X.org sample (with both xdpyinfo and xrandr data available):
2261 inxi -aGz
2262 Graphics:
2263 Device-1: AMD Cedar [Radeon HD 5000/6000/7350/8350 Series]
2264 vendor: XFX Pine driver: radeon v: kernel alternate: amdgpu
2265 arch: TeraScale-2 code: Evergreen process: TSMC 32-40nm
2266 built: 2009-15 pcie: gen: 1 speed: 2.5 GT/s lanes: 16 link-max:
2267 gen: 2 speed: 5 GT/s ports: active: DVI-I-1,VGA-1 empty: HDMI-A-1
2268 bus-ID: 0a:00.0 chip-ID: 1002:68f9 class-ID: 0300 temp: 58.0 C
2269 Display: x11 server: X.Org v: 1.21.1.7 with: Xwayland v: 22.1.9
2270 compositor: xfwm v: 4.18.0 driver: X: loaded: modesetting dri: r600
2271 gpu: radeon display-ID: :0.0 screens: 1
2272 Screen-1: 0 s-res: 2560x1024 s-dpi: 96
2273 s-size: 677x270mm (26.65x10.63") s-diag: 729mm (28.7")
2274 Monitor-1: DVI-I-1 pos: primary,left model: Samsung SyncMaster
2275 serial: H9NX842662 built: 2004 res: 1280x1024 hz: 60 dpi: 96
2276 gamma: 1.2 size: 338x270mm (13.31x10.63") diag: 433mm (17")
2277 ratio: 5:4 modes: max: 1280x1024 min: 720x400
2278 Monitor-2: VGA-1 pos: right model: Dell 1908FP
2279 serial: G434H87HRA2D built: 2008 res: 1280x1024 hz: 60 dpi: 86
2280 gamma: 1.4 size: 376x301mm (14.8x11.85") diag: 482mm (19")
2281 ratio: 5:4 modes: max: 1280x1024 min: 720x400
2282 API: EGL v: 1.5 hw: drv: amd r600 platforms: device: 0 drv: r600
2283 device: 1 drv: swrast gbm: egl: 1.4 drv: kms_swrast surfaceless:
2284 drv: r600 x11: drv: r600 inactive: wayland
2285 API: OpenGL v: 4.5 vendor: x.org mesa v: 22.3.6 glx-v: 1.4
2286 es-v: 3.1 direct-render: yes renderer: AMD CEDAR (DRM 2.50.0 /
2287 6.4.3-1-liquorix-amd64 LLVM 15.0.6) device-ID: 1002:68f9
2288 memory: 1000 MiB unified: no
2289 API: Vulkan v: 1.3.250 layers: 3 device: 0 type: cpu
2290 name: llvmpipe (LLVM 15.0.6 256 bits) driver: mesa llvmpipe
2291 v: 22.3.6 (LLVM 15.0.6) device-ID: 10005:0000 surfaces: xcb,xlib
2292 Wayland sample, with Sway/swaymsg:
2294 inxi -aGz
2295 Graphics:
2296 Device-1: AMD Cedar [Radeon HD 5000/6000/7350/8350 Series] vendor: XFX Pine
2297 driver: radeon v: kernel alternate: amdgpu arch: TeraScale 2
2298 process: TSMC 32-40nm pcie: gen: 1 speed: 2.5 GT/s lanes: 16 link-max:
2299 gen: 2 speed: 5 GT/s ports: active: DVI-I-1,VGA-1 empty: HDMI-A-1
2300 bus-ID: 0a:00.0 chip-ID: 1002:68f9 class-ID: 0300
2301 Display: wayland server: Xwayland v: 21.1.4 compositor: sway v: 1.6.1
2302 driver: dri: r600 gpu: radeon d-rect: 2560x1024
2303 Monitor-1: DVI-I-1 pos: right model: SyncMaster serial: <filter>
2304 built: 2004 res: 1280x1024 hz: 60 dpi: 96 gamma: 1.2
2305 size: 340x270mm (13.4x10.6") diag: 434mm (17.1") ratio: 5:4 modes:
2306 max: 1280x1024 min: 720x400
2307 Monitor-2: VGA-1 pos: primary,left model: DELL 1908FP serial: <filter>
2308 res: 1280x1024 hz: 60 gamma: 1.4 dpi: 86 gamma: 1.4
2309 size: 380x300mm (15.0x11.8") diag: 484mm (19.1") ratio: 5:4 modes:
2310 max: 1280x1024 min: 720x400
2311 API: OpenGL v: 4.6 compat-v: 4.5 vendor: x.org mesa v: 22.3.6
2312 glx-v: 1.4 direct-render: yes renderer: AMD CEDAR (DRM 2.50.0 /
2313 6.4.3-1-liquorix-amd64 LLVM 15.0.6) device-ID: 1002:68f9
2314 API: EGL v: 1.5 hw: drv: amd r600 platforms: device: 0
2315 drv: r600 device: 1 drv: swrast surfaceless: drv: r600 wayland:
2316 drv: r600 inactive: gbm,x11
2317 -a -I - Adds to Packages number of lib packages detected per package
2320 manager. Also adds detected package managers with 0 packages
2321 listed. Adds package manager tools (supported: rpm, dpkg, pkg‐
2322 tool) Moves to Repos if -ra.
2323 inxi -aI
2325 Info:
2326 ....
2327 Init: systemd v: 245 target: graphical.target (5) default: graphical.target
2328 Compilers: gcc: 9.3.0 alt: 5/6/7/8/9 Packages: pm: apt pkgs: 3681 libs: 2096
2329 tools: apt, apt-get,aptitude pm: rpm pkgs: 0 Shell: ksh v: A_2020.0.0
2330 default: Bash v: 5.0.16 running-in: kate inxi: 3.1.04
2331 - Adds service control tool, tested for in the following order:
2333 systemctl rc-service rcctl service sv /etc/rc.d /etc/init.d. Can
2334 be useful to know which you need when using an unfamiliar ma‐
2335 chine.
2336 -a -j (--swap), -a -P [swap], -a -P [swap]
2339 - Adds swappiness and vfs cache pressure, and a message to indi‐
2340 cate if the value is the default value or not (Linux only, and
2341 only if available). If not the default value, shows default
2342 value as well, e.g.
2343 For -P per swap physical partition:
2345 swappiness: 60 (default) cache-pressure: 90 (default 100)
2347 For -j row 1 output:
2349 Kernel: swappiness: 60 (default) cache-pressure: 90 (default
2351 100)
2352 - Adds zswap data for row 1 output:
2354 zswap: [yes/no] compressor: [type] max-pool: xx%
2356 - Adds for zram swap type: active compression type, available
2358 compression types, and max compression streams.
2359 - Adds device kernel major:minor number (Linux only).
2361 -a -J (--usb)
2364 - Adds, if available, USB speed in IEC units MiB/s or GiB/s (may
2365 be incorrect on BSDs due to non reliable data source). These are
2366 base 2 Bytes per second.
2367 - Adds USB mode (Linux only), which is the technical terms the
2369 USB group uses to describe USB revisions. In cases where speed
2370 and rev are an unknown combination, (and probably at least one
2371 is wrong) shows message.
2372 There are no granular data sources in BSDs for accurate revi‐
2374 sion/lane/speed information, so mode cannot be determined.
2375 Sample:
2377 Hub-1: 1-0:1 info: hi-speed hub with single TT ports: 14 rev: 2.0
2378 speed: 480 Mb/s (57.2 MiB/s) lanes: 1 mode: 2.0 chip-ID: 1d6b:0002
2379 class-ID: 0900
2380 Device-1: 1-4:2 info: Wacom ET-0405A [Graphire2 (4x5)] type: mouse
2381 driver: usbhid,wacom interfaces: 1 rev: 1.1 speed: 1.5 Mb/s (183 KiB/s)
2382 lanes: 1 mode: 1.0 power: 40mA chip-ID: 056a:0011 class-ID: 0301
2383 Hub-2: 2-0:1 info: Super-speed hub ports: 8 rev: 3.1
2384 speed: 10 Gb/s (1.16 GiB/s) lanes: 1 mode: 3.2 gen-2x1 chip-ID: 1d6b:0003
2385 class-ID: 0900
2386 Device-1: 2-8:5 info: SanDisk Ultra type: mass storage driver: usb-storage
2387 interfaces: 1 rev: 3.0 speed: 5 Gb/s (596.0 MiB/s) lanes: 1 mode: 3.2 gen-1x1
2388 power: 896mA chip-ID: 0781:5581 class-ID: 0806
2389 serial: <filter>
2390 -a -L (--logical)
2393 - Expands Component report, shows size / maj-min of components
2394 and devices, and mapped name for logical components. Puts each
2395 component/device on its own line.
2396 - Adds maj-min to LV and other devices.
2398 -a -m - Expands volts to include curr/min/max values even if they are
2401 all identical.
2402 -a -n, -a -N, -a -i
2405 - Adds, if present, possible alternate: kernel modules capable
2406 of driving each Device-x (not including the current driver:). If
2407 no non-driver modules found, shows nothing. NOTE: just because
2408 it lists a module does NOT mean it is available in the system,
2409 it's just something the kernel knows could possibly be used in‐
2410 stead.
2411 - Adds PCIe generation, and, if different than running PCIe gen‐
2413 eration, speed or lanes, link-max: gen: speed: lanes: (only
2414 items different from primary shown).
2415 - Adds for USB devices USB mode (Linux only).
2417 -a -o - Adds device kernel major:minor number (Linux only).
2420 -a -p,-a -P
2423 - Adds raw partition size, including file system overhead, par‐
2424 tition table, e.g.
2425 raw-size: 60.00 GiB.
2427 - Adds percent of raw size available to size: item, e.g.
2429 size: 58.81 GiB (98.01%).
2431 Note that used: 16.44 GiB (34.3%) percent refers to the avail‐
2433 able size, not the raw size.
2434 - Adds partition filesystem block size if found (requires root
2436 and blockdev).
2437 - Adds device kernel major:minor number (Linux only).
2439 -a -r - Adds to Packages: report. See -Ia
2442 -a -R - Adds device kernel major:minor number (mdraid, Linux only).
2445 - Adds, if available, component size, major:minor number (Linux
2447 only). Turns Component report to 1 component per line.
2448 -a -S - Adds alternate kernel clock sources, if available (Linux
2451 only).
2452 - Adds kernel boot parameters to Kernel section (if detected).
2454 Support varies by OS type.
2455 -a --slots
2458 - Adds PCI children of the main slot bus ID, and their types and
2459 class IDs, recursively. Linux only, and only if detected. Sam‐
2460 ple:
2461 Slot: 0
2463 type: PCIe
2464 lanes: 16
2465 status: in use
2466 length: long
2467 volts: 3.3
2468 bus-ID: 00:03.1
2469 children:
2470 1: 07:00.0
2471 class-ID: 0300
2472 type: display
2473 2: 07:00.1
2474 class-ID: 0403
2475 type: audio
2476
2479 --alt 40
2480 Bypass Perl as a downloader option. Priority is: Perl
2481 (HTTP::Tiny), Curl, Wget, Fetch, (OpenBSD only) ftp.
2482 --alt 41
2485 Bypass Curl as a downloader option. Priority is: Perl
2486 (HTTP::Tiny), Curl, Wget, Fetch, (OpenBSD only) ftp.
2487 --alt 42
2490 Bypass Fetch as a downloader option. Priority is: Perl
2491 (HTTP::Tiny), Curl, Wget, Fetch, (OpenBSD only) ftp.
2492 --alt 43
2495 Bypass Wget as a downloader option. Priority is: Perl
2496 (HTTP::Tiny), Curl, Wget, Fetch, OpenBSD only: ftp
2497 --alt 44
2500 Bypass Curl, Fetch, and Wget as downloader options. This basi‐
2501 cally forces the downloader selection to use Perl 5.x
2502 HTTP::Tiny, which is generally slower than Curl or Wget but it
2503 may help bypass issues with downloading.
2504 --bt-tool [bt-adapter|btmgmt|hciconfig|rfkill]
2507 See --force [tool name]. Used to set -E report tool.
2508 --dig Temporary override of NO_DIG configuration item. Only use to
2511 test w/wo dig. Restores default behavior for WAN IP, which is
2512 use dig if present.
2513 --display [:<integer>]
2516 Will try to get display data out of X (does not usually work as
2517 root user). Default gets display info from display :0. If you
2518 use the format --display :1 then it would get it from display 1
2519 instead, or any display you specify.
2520 Note that in some cases, --display will cause inxi to hang end‐
2522 lessly when running the option in console with Intel graphics.
2523 The situation regarding other free drivers such as nouveau/ATI
2524 is currently unknown. It may be that this is a bug with the In‐
2525 tel graphics driver - more information is required.
2526 You can test this easily by running the following command out of
2528 X/display server: glxinfo -display :0
2529 If it hangs, --display will not work.
2531 --dmidecode
2534 Shortcut. See --force dmidecode.
2535 --downloader [curl|fetch|perl|wget]
2538 Force inxi to use Curl, Fetch, Perl, or Wget for downloads.
2539 --force [option(s)]
2542 Various force options to allow users to override defaults. Val‐
2543 ues can be given as a comma separated list:
2544 inxi -MJ --force dmidecode,lsusb
2546 - bt-adapter - Force use of bt-adapter tool in -E.
2548 - btmgmt - Force use of btmgmt tool in -E.
2550 - colors - Same as -Y -2 . Do not remove colors from piped or
2552 redirected output.
2553 - dmidecode - Force use of dmidecode. This will override /sys
2555 data in some lines, e.g. -M or -B.
2556 - hddtemp - Force use of hddtemp instead of /sys temp data for
2558 disks.
2559 - ifconfig - Force use of IF tool ifconfig for -i.
2561 - ip - Force use of IF ip tool for -i (default).
2563 - lsusb - Forces the USB data generator to use lsusb as data
2565 source (default). Overrides USB_SYS in user configuration
2566 file(s).
2567 - rfkill - Force use of rfkill tool in -E. rfkill does not sup‐
2569 port mac address data.
2570 - rpm, pkg - Force override of disabled rpm package counts on
2572 primarily rpm run systems due to unacceptably slow execution
2573 times for this command:
2574 rpm -qa --nodigest --nosignature
2576 Even on newer rpm systems, in virtual machines, running rpm
2578 package list query takes more than 0.15 seconds (compared to
2579 0.01 to 0.05 for dpkg, pacman, pkgtool etc) for just this single
2580 feature, which is north of 10% of total execution time for inxi
2581 -bar. On bare metal this can hit 1 second or more in our tests.
2582 Older systems have taken up to 30 seconds to run this command!
2583 For systems that support running rpm along with the primary
2585 package installer (dpkg/apt, pacman, and pkgtool/slackpkg),
2586 there are not going to be many rpms, if any, installed, so the
2587 command runs in those cases (if inxi can determine it is running
2588 in that type of system).
2589 - sensors-sys - Force use of /sys/class/hwmon data for sensors
2591 (excluding ipmi sensors, which are their own line if present),
2592 skip lm-sensors. Generally useful for testing since sys data is
2593 used if no lm-sensors data was found anyway, but if lm-sensors
2594 was installed, and returned no data, it's most likely if not
2595 nearly certain that /sys will also not return data.
2596 - usb-sys - Forces the USB data generator to use /sys as data
2598 source instead of lsusb (Linux only).
2599 - vmstat - Forces use of vmstat for memory data.
2601 - wayland - Forces use of Wayland, disables x tools glxinfo,
2603 xrandr, xdpyinfo.
2604 - wmctrl - Force System item wm to use wmctrl as data source,
2606 override default ps source.
2607 --hddtemp
2610 Shortcut. See --force hddtemp.
2611 --html-wan
2614 Temporary override of NO_HTML_WAN configuration item. Only use
2615 to test w/wo HTML downloaders for WAN IP. Restores default be‐
2616 havior for WAN IP, which is use HTML downloader if present and
2617 if dig failed.
2618 --ifconfig
2621 Shortcut. See --force ifconfig.
2622 --man Updates / installs man page with -U if pinxi or using -U 3 dev
2625 branch. (Only active if -U is is not disabled by maintainers).
2626 --no-dig
2629 Overrides default use of dig to get WAN IP address. Allows use
2630 of normal downloader tool to get IP addresses. Only use if dig
2631 is failing, since dig is much faster and more reliable in gen‐
2632 eral than other methods.
2633 --no-doas
2636 Skips the use of doas to run certain internal features (like hd‐
2637 dtemp, file) with doas. Not related to running inxi itself with
2638 doas/sudo or super user. Some systems will register errors which
2639 will then trigger admin emails in such cases, so if you want to
2640 disable regular user use of doas (which requires configuration
2641 to setup anyway for these options) just use this option, or
2642 NO_DOAS configuration item. See --no-sudo if you need to disable
2643 both types.
2644 --no-html-wan
2647 Overrides use of HTML downloaders to get WAN IP address. Use ei‐
2648 ther only dig, or do not get wan IP. Only use if dig is failing,
2649 and the HTML downloaders are taking too long, or are hanging or
2650 failing.
2651 Make permanent with NO_HTML_WAN='true'
2653 --no-man
2656 Disables man page install with -U for master and active develop‐
2657 ment branches. (Only active if -U is is not disabled by main‐
2658 tainers).
2659 --no-sensor-force
2662 Overrides user set SENSOR_FORCE configuration value. Restores
2663 default behavior.
2664 --no-ssl
2667 Skip SSL certificate checks for all downloader actions (-U, -w,
2668 -W, -i). Use if your system does not have current SSL certifi‐
2669 cate lists, or if you have problems making a connection for any
2670 reason. Works with Wget, Curl, Perl HTTP::Tiny and Fetch.
2671 --no-sudo
2674 Skips the use of sudo to run certain internal features (like hd‐
2675 dtemp, file) with sudo. Not related to running inxi itself with
2676 sudo or superuser. Some systems will register errors which will
2677 then trigger admin emails in such cases, so if you want to dis‐
2678 able regular user use of sudo (which requires configuration to
2679 setup anyway for these options) just use this option, or NO_SUDO
2680 configuration item.
2681 --pm-type [package manager name]
2684 For distro package maintainers only, and only for non apt, rpm,
2685 or pacman based systems. To be used to test replacement package
2686 lists for recommends for that package manager.
2687 --rpm, --pkg
2690 Shortcut. See --force rpm.
2691 --sensors-default
2694 Overrides configuration values SENSORS_USE or SENSORS_EXCLUDE on
2695 a one time basis.
2696 --sensors-exclude
2699 Linux only. Similar to --sensors-use except removes listed sen‐
2700 sors from sensor data. Make permanent with SENSORS_EXCLUDE con‐
2701 figuration item. Note that gpu, network, disk, and other spe‐
2702 cific device monitor chips are excluded by default.
2703 Example: inxi -sxx --sensors-exclude k10temp-pci-00c3
2705 --sensors-sys
2708 Shortcut. See --force sensors-sys
2709 --sensors-use
2712 Linux only. Use only the (comma separated) sensor arrays for -s
2713 output. Make permanent with SENSORS_USE configuration item.
2714 Sensor array ID value must be the exact value shown in lm-sen‐
2715 sors sensors output (lm-sensors only) or use -s --dbg 18 ('main'
2716 =>.. section) to see the sensor ID strings used internally. If
2717 you only want to exclude one (or more) sensors from the output,
2718 use --sensors-exclude.
2719 Can be useful if the default sensor data used by inxi is not
2721 from the right sensor array. Note that all other sensor data
2722 will be removed, which may lead to undesired consequences.
2723 Please be aware that this can lead to many undesirable side-ef‐
2724 fects, since default behavior is to use all the sensors arrays
2725 and select which values to use from them following a set se‐
2726 quence of rules. So if you force one to be used, you may lose
2727 data that was used from another one.
2728 Most likely best use is when one (or two) of the sensor arrays
2730 has all the sensor data you want, and you just want to make sure
2731 inxi doesn't use data from another array that has inaccurate or
2732 misleading data.
2733 Note that gpu, network, disk, and other specific device monitor
2735 chips are excluded by default, and should not be added since
2736 they do not provide cpu, board, system, etc, sensor data.
2737 Example: inxi -sxx --sensors-use nct6791-isa-0290,k10temp-
2739 pci-00c3
2740 --sleep [0-x.x]
2743 Usually in decimals. Change CPU sleep time for -C (current:
2744 .35). Sleep is used to let the system catch up and show a more
2745 accurate CPU use. Example:
2746 inxi -Cxxx --sleep 0.15
2748 Overrides default internal value and user configuration value:
2750 CPU_SLEEP=0.25
2752 --tty Forces internal IRC flag to off. Used in unhandled cases where
2755 the program running inxi may not be seen as a shell/pty/tty, but
2756 it is not an IRC client. Put --tty first in option list to
2757 avoid unexpected errors. If you want a specific output width,
2758 use the --width option. If you want normal color codes in the
2759 output, use the -c [color ID] flag.
2760 The sign you need to use this is extra numbers before the
2762 key/value pairs of the output of your program. These are IRC,
2763 not TTY, color codes. Please post a codeberg.org issue if you
2764 find you need to use --tty (including the full -Ixxx line) so we
2765 can figure out how to add your program to the list of
2766 whitelisted programs.
2767 You can see what inxi believed started it in the -Ixxx line,
2769 Shell: or Client: item. Please let us know what that result was
2770 so we can add it to the parent start program whitelist.
2771 In some cases, you may want to also use --no-filter/-Z option if
2773 you want to see filtered values. Filtering is turned on by de‐
2774 fault if inxi believes it is running in an IRC client.
2775 --usb-sys
2778 Shortcut. See --force usb-sys
2779 --usb-tool
2782 Shortcut. See --force lsusb
2783 --wan-ip-url [URL]
2786 Force -i to use supplied URL as WAN IP source. Overrides dig or
2787 default IP source urls. URL must start with http[s] or ftp.
2788 The IP address from the URL must be the last item on the last
2790 (non-empty) line of the page content source code.
2791 Same as configuration value (example):
2793 WAN_IP_URL='https://mysite.com/ip.php'
2795 --wayland, --wl
2798 Shortcut. See --force wayland.
2799 --wm Shortcut. See --force wmctl.
2802
2805 --dbg {[1-x][,[1-x]]}
2806 Accepts one or more comma separated dbg specific debugging num‐
2807 bers.
2808 1 - Debug downloader failures. Turns off silent/quiet mode for
2810 curl, wget, and fetch. Shows more downloader action information.
2811 Shows some more information for Perl downloader.
2812 1-xx - See codeberg.org inxi-perl/docs/inxi-values.txt for spe‐
2814 cific specialized debugging options. There are a lot.
2815 --debug [1-3]
2818 - On screen debugger output.
2819 --debug 10
2822 - Basic logging. Check $XDG_DATA_HOME/inxi/inxi.log or
2823 $HOME/.local/share/inxi/inxi.log or $HOME/.inxi/inxi.log.
2824 --debug 11
2827 - Full file/system info logging.
2828 --debug 20
2831 Creates a tar.gz file of system data and collects the inxi out‐
2832 put in a file.
2833 * tree traversal data file(s) read from /proc and /sys, and
2835 other system data.
2836 * xorg conf and log data, xrandr, xprop, xdpyinfo, glxinfo etc.
2838 * data from dev, disks, partitions, etc.
2840 --debug 21
2843 Automatically uploads debugger data tar.gz file to ftp.smxi.org,
2844 then removes the debug data directory, but leaves the debug
2845 tar.gz file. See --ftp for uploading to alternate locations.
2846 --debug 22
2849 Automatically uploads debugger data tar.gz file to ftp.smxi.org,
2850 then removes the debug data directory and the tar.gz file. See
2851 --ftp for uploading to alternate locations.
2852 --debug-id [string]
2855 Insert string to file name for debugger. This is helpful so you
2856 can add for instance a username to a debugger dataset to make it
2857 easy to find.
2858 Sample: --debug 22 --debug-id mrmazda
2860 --fake-data-dir
2863 Developer only: Change default location of $fake_data_dir, which
2864 is where files are for --fake {item} items.
2865 --ftp [ftp.yoursite.com/incoming]
2868 For alternate ftp upload locations: Example:
2869 inxi --ftp ftp.yourserver.com/incoming --debug 21
2871
2874 Only use the following in conjunction with --debug 2[012], and only use
2875 if you experienced a failure or hang, or were instructed to do so.
2876 --debug-proc
2879 Force debugger to parse /proc directory data when run as root.
2880 Normally this is disabled due to unpredictable data in /proc
2881 tree.
2882 --debug-proc-print
2885 Use this to locate file that /proc debugger hangs on.
2886 --debug-no-exit
2889 Skip exit on error when running debugger.
2890 --debug-no-proc
2893 Skip /proc debugging in case of a hang.
2894 --debug-no-sys
2897 Skip /sys debugging in case of a hang.
2898 --debug-sys
2901 Force PowerPC debugger parsing of /sys as doas/sudo/root.
2902 --debug-sys-print
2905 Use this to locate file that /sys debugger hangs on.
2906
2909 BitchX, Gaim/Pidgin, ircII, Irssi, Konversation, Kopete, KSirc, KVIrc,
2910 Weechat, and Xchat. Plus any others that are capable of displaying ei‐
2911 ther built-in or external script output.
2912
2915 To trigger inxi output in your IRC client, pick the appropriate method
2916 from the list below:
2917 Hexchat, XChat, Irssi
2919 (and many other IRC clients) /exec -o inxi [options] If you
2920 don't include the -o, only you will see the output on your local
2921 IRC client.
2922 Konversation
2924 /cmd inxi [options]
2925 To run inxi in Konversation as a native script if your distribu‐
2927 tion or inxi package hasn't already done this for you, create
2928 this symbolic link:
2929 KDE 4: ln -s /usr/local/bin/inxi /usr/share/kde4/apps/konversa‐
2931 tion/scripts/inxi
2932 KDE 5: ln -s /usr/local/bin/inxi /usr/share/konversa‐
2934 tion/scripts/inxi
2935 If inxi is somewhere else, change the path /usr/local/bin to
2937 wherever it is located.
2938 If you are using KDE/QT 5, then you may also need to add the
2940 following to get the Konversation /inxi command to work:
2941 ln -s /usr/share/konversation /usr/share/apps/
2943 Make sure you also have the qdbus-qt5 package (Debian/Ubuntu +
2945 derived), qt5-qttools (Fedora/RHEL/SUSE + derived), qt5-tools
2946 (Arch + derived) installed (for KDE 5/QT 5, check distros for
2947 future package names), qt5-tools (Arch + derived). Check your
2948 distro if the program is missing. Depending on the distro,
2949 /usr/lib/qt5/bin/qdbus is required, which in Debian+ is provided
2950 by the above package.
2951 Then you can start inxi directly, like this:
2953 /inxi [options]
2955 WeeChat
2957 NEW: /exec -o inxi [options]
2958 OLD: /shell -o inxi [options]
2960 Newer (2014 and later) WeeChats work pretty much the same now as
2962 other console IRC clients, with /exec -o inxi [options]. Newer
2963 WeeChats have dropped the -curses part of their program name,
2964 i.e.: weechat instead of weechat-curses.
2965
2968 inxi will read its configuration/initialization files in the following
2969 order:
2970 /etc/inxi.conf contains the default configurations. These can be over‐
2972 ridden by creating a /etc/inxi.d/inxi.conf file (global override),
2973 which will prevent distro packages from changing or overwriting your
2974 edits. This method is recommended if you are using a distro packaged
2975 inxi and want to override some global configuration items from the
2976 package's default /etc/inxi.conf file but don't want to lose your
2977 changes on a package update.
2978 You can also override, per user, with a user configuration file found
2980 in one of the following locations (inxi will store its config file us‐
2981 ing the following precedence):
2982 if $XDG_CONFIG_HOME is not empty, it will go there, else if $HOME/.con‐
2984 fig/inxi.conf exists, it will go there, and as a last default, the
2985 legacy location is used), i.e.:
2986 $XDG_CONFIG_HOME/inxi.conf > $HOME/.config/inxi.conf >
2988 $HOME/.inxi/inxi.conf > /etc/inxi.d/inxi.conf > /etc/inxi.conf
2989
2992 See the documentation page for more complete information on how to set
2993 these up, and for a complete list of options:
2994 https://smxi.org/docs/inxi-configuration.htm
2996 Basic Options
2998 Here's a brief overview of the basic options you are likely to
2999 want to use:
3000 COLS_MAX_CONSOLE The max display column width on terminal. If
3002 terminal/console width or --width is less than wrap width, wrap‐
3003 ping of line starter occurs
3004 COLS_MAX_IRC The max display column width on IRC clients.
3006 COLS_MAX_NO_DISPLAY The max display column width in out of X /
3008 Wayland / desktop / window manager.
3009 CPU_SLEEP Decimal value 0 or more. Default is usually around
3011 0.35 seconds. Time that inxi will 'sleep' before getting CPU
3012 speed data, so that it reflects actual system state.
3013 DOWNLOADER Sets default inxi downloader: curl, fetch, ftp, perl,
3015 wget. See --recommends output for more information on download‐
3016 ers and Perl downloaders.
3017 FILTER_STRING Default <filter>. Any string you prefer to see in‐
3019 stead for filtered values.
3020 INDENT Change primary indent width of wide mode output. See
3022 --indent.
3023 INDENTS Change primary indents of narrow wrapped mode output,
3025 and second level indents. See --indents.
3026 LIMIT Overrides default of 10 IP addresses per IF. This is only
3028 of interest to sys admins running servers with many IP ad‐
3029 dresses.
3030 LINES_MAX Values: [-2-xxx]. See -Y for explanation and values.
3032 Use -Y -3 to restore default unlimited output lines. Avoid using
3033 this in general unless the machine is a headless system and you
3034 want the output to be always controlled.
3035 MAX_WRAP (or WRAP_MAX) The maximum width where the line starter
3037 wraps to its own line. If terminal/console width or --width is
3038 less than wrap width, wrapping of line starter occurs. Overrides
3039 default. See --max-wrap. If 80 or less, wrap will never happen.
3040 NO_DIG Set to 1 or true to disable WAN IP use of dig and force
3042 use of alternate downloaders.
3043 NO_DOAS Set to 1 or true to disable internal use of doas.
3045 NO_HTML_WAN Set to 1 or true to disable WAN IP use of HTML Down‐
3047 loaders and force use of dig only, or nothing if dig disabled as
3048 well. Same as --no-html-wan. Only use if dig is failing, and
3049 HTML downloaders are hanging.
3050 NO_SUDO Set to 1 or true to disable internal use of sudo.
3052 PARTITION_SORT Overrides default partition output sort. See
3054 --partition-sort for options.
3055 PS_COUNT The default number of items showing per -t type, m or
3057 c. Default is 5.
3058 SENSORS_CPU_NO In cases of ambiguous temp1/temp2 (inxi can't
3060 figure out which is the CPU), forces sensors to use either value
3061 1 or 2 as CPU temperature. See the above configuration page on
3062 smxi.org for full info.
3063 SENSORS_EXCLUDE Exclude supplied sensor array[s] from sensor
3065 output. Override with --sensors-default. See --sensors-exclude.
3066 SENSORS_USE Use only supplied sensor array[s]. Override with
3068 --sensors-default. See --sensors-use.
3069 SEP2_CONSOLE Replaces default key / value separator of ':'. Test
3071 with --separator.
3072 USB_SYS Forces all USB data to use /sys instead of lsusb.
3074 WAN_IP_URL Forces -i to use supplied URL, and to not use dig
3076 (dig is generally much faster). URL must begin with http or ftp.
3077 Note that if you use this, the downloader set tests will run
3078 each time you start inxi whether a downloader feature is going
3079 to be used or not.
3080 The IP address from the URL must be the last item on the last
3082 (non-empty) line of the URL's page content source code.
3083 Same as --wan-ip-url [URL]
3085 WEATHER_SOURCE Values: [0-9]. Same as --weather-source. Values
3087 4-9 are not currently supported, but this can change at any
3088 time.
3089 WEATHER_UNIT Values: [m|i|mi|im]. Same as --weather-unit.
3091 Color Options
3094 It's best to use the -c [94-99] color selector tool to set the
3095 following values because it will correctly update the configura‐
3096 tion file and remove any invalid or conflicting items, but if
3097 you prefer to create your own configuration files, here are the
3098 options. All take the integer value from the options available
3099 in -c 94-99.
3100 NOTE: All default and configuration file set color values are
3102 removed when output is piped or redirected. You must use the ex‐
3103 plicit -c [color number] option if you want colors to be present
3104 in the piped/redirected output (creating a PDF for example).
3105 CONSOLE_COLOR_SCHEME The color scheme for console output (not in
3107 X/Wayland).
3108 GLOBAL_COLOR_SCHEME Overrides all other color schemes.
3110 IRC_COLOR_SCHEME Desktop X/Wayland IRC CLI color scheme.
3112 IRC_CONS_COLOR_SCHEME Out of X/Wayland, IRC CLI color scheme.
3114 IRC_X_TERM_COLOR_SCHEME In X/Wayland IRC client terminal color
3116 scheme.
3117 VIRT_TERM_COLOR_SCHEME Color scheme for virtual terminal output
3119 (in X/Wayland).
3120 Developer Options
3123 These are useful only for developers.
3124 FAKE_DATA_DIR - change default fake data directory location. See
3126 --fake-data-dir.
3127
3130 Please report bugs using the following resources.
3131 You may be asked to run the inxi debugger tool (see --debug 21/22),
3133 which will upload a data dump of system files for use in debugging
3134 inxi. These data dumps are very important since they provide us with
3135 all the real system data inxi uses to parse out its report.
3136 Issue Report
3138 File an issue report: https://codeberg.org/smxi/inxi/issues
3139 Forums Post on inxi forums: https://techpatterns.com/forums/fo‐
3141 rum-33.html
3142 IRC irc.oftc.net / irc.libera.chat
3144 You can also visit channel: #smxi to post issues on either net‐
3145 work.
3146
3149 https://codeberg.org/smxi/inxi
3150 - Home of the source code, and tech docs (inxi-perl/docs).
3151 https://smxi.org/docs/inxi.htm
3153 - The main docs for inxi. See inxi-perl/docs for more technical docs.
3154 https://fosstodon.org/@smxi
3156 - Follow @smxi on Mastodon!
3157
3160 inxi is a fork of locsmif's very clever infobash script.
3161 Original infobash author and copyright holder: Copyright (C) 2005-2007
3163 Michiel de Boer aka locsmif
3164 inxi version: Copyright (C) 2008-2023 Harald Hope
3166 This man page was originally created by Gordon Spencer (aka aus9) and
3168 is maintained by Harald Hope (aka h2 or TechAdmin).
3169 Initial CPU logic, konversation version logic, occasional maintenance
3171 fixes, and the initial xiin.py tool for /sys parsing (obsolete, but
3172 still very much appreciated for all the valuable debugger data it
3173 helped generate): Scott Rogers
3174 Further fixes (listed as known):
3176 Horst Tritremmel <hjt at sidux.com>
3178 Steven Barrett (aka: damentz) - USB audio patch; swap percent used
3180 patch.
3181 Jarett.Stevens - dmidecode -M patch for older systems with no /sys.
3183
3186 The nice people at irc.oftc.net channels #linux-smokers-club and #smxi,
3187 who all really have to be considered to be co-developers because of
3188 their non-stop enthusiasm and willingness to provide real-time testing
3189 and debugging of inxi development over the years.
3190 LinuxQuestions.org Slackware forum members, for major help with devel‐
3192 opment and debugging new or refactored features, particularly the re‐
3193 done CPU logic of 2021-12.
3194 Siduction forum members, who have helped get some features working by
3196 providing a large number of datasets that have revealed possible varia‐
3197 tions, particularly for the RAM -m option.
3198 AntiX users and admins, who have helped greatly with testing and debug‐
3200 ging, particularly for the 3.0.0 release.
3201 ArcherSeven (Max), Brett Bohnenkamper (aka KittyKatt), and Iotaka, who
3203 always manage to find the weirdest or most extreme hardware and setups
3204 that help make inxi much more robust.
3205 For the vastly underrated skill of output error/glitch catching, Pete
3207 Haddow. His patience and focus in going through inxi repeatedly to
3208 find errors and inconsistencies is much appreciated.
3209 For a huge boost to BSD support, Stan Vandiver, who did a lot of test‐
3211 ing and setup many remote access systems for testing and development.
3212 For testing, bug finding, suggestions, feature requests, MrMazda. He
3214 has over the years has helped shape inxi into what it is today, in par‐
3215 ticular but not limited to, the Graphics features.
3216 All the inxi package maintainers, distro support people, forum modera‐
3218 tors, and in particular, sys admins with their particular issues, which
3219 almost always help make inxi better, and any others who contribute
3220 ideas, suggestions, and patches.
3221 Without a wide range of diverse Linux kernel-based Free Desktop systems
3223 to test on, we could never have gotten inxi to be as reliable and solid
3224 as it's turning out to be.
3225 And of course, a big thanks to locsmif, who figured out a lot of the
3227 core ideas, logic, and tricks originally used in inxi Gawk/Bash.
3228inxi 2023-10-31 INXI(1)