1INXI(1) inxi manual INXI(1)
2
3
4
6 inxi - Command line system information script for console and IRC
7
8
10 inxi
11
12 inxi [-AbBCdDfFGhijJIlmMnNopPrRsSuUVwzZ]
13
14 inxi [-c NUMBER] [-t [c|m|cm|mc][NUMBER]] [-v NUMBER] [-W LOCATION]
15 [--weather-unit {m|i|mi|im}] [-y WIDTH]
16
17 inxi [--memory-modules] [--memory-short] [--recommends] [--slots]
18
19 inxi [-x|-xx|-xxx|-a] -OPTION(s)
20
21 All short form options have long form variants - see below for these
22 and more advanced options.
23
24
26 inxi is a command line system information script built for console and
27 IRC. It is also used a debugging tool for forum technical support to
28 quickly ascertain users' system configurations and hardware. inxi shows
29 system hardware, CPU, drivers, Xorg, Desktop, Kernel, gcc version(s),
30 Processes, RAM usage, and a wide variety of other useful information.
31
32 inxi output varies depending on whether it is being used on CLI or IRC,
33 with some default filters and color options applied only for IRC use.
34 Script colors can be turned off if desired with -c 0, or changed using
35 the -c color options listed in the STANDARD OPTIONS section below.
36
37
39 In order to maintain basic privacy and security, inxi used on IRC auto‐
40 matically filters out your network device MAC address, WAN and LAN IP,
41 your /home username directory in partitions, and a few other items.
42
43 Because inxi is often used on forums for support, you can also trigger
44 this filtering with the -z option (-Fz, for example). To override the
45 IRC filter, you can use the -Z option. This can be useful in debugging
46 network connection issues online in a private chat, for example.
47
48
50 Options can be combined if they do not conflict. You can either group
51 the letters together or separate them.
52
53 Letters with numbers can have no gap or a gap at your discretion,
54 except when using -t. Note that if you use an option that requires an
55 additional argument, that must be last in the short form group of
56 options. Otherwise you can use those separately as well.
57
58 For example: inxi -AG | inxi -A -G | inxi -b | inxi -c10 | inxi
59 -FxxzJy80
60
61 Note that all the short form options have long form equivalents, which
62 are listed below. However, usually the short form is used in examples
63 in order to keep things simple.
64
65
67 -A, --audio
68 Show Audio/sound card(s) information, including card driver.
69
70
71 -b, --basic
72 Show basic output, short form. Same as: inxi -v 2
73
74
75 -B, --battery
76 Show system battery (ID-x) data, charge, condition, plus extra
77 information (if battery present). Uses /sys or, for BSDs without
78 systctl battery data, dmidecode. dmidecode does not have very
79 much information, and none about current battery
80 state/charge/voltage. Supports multiple batteries when using
81 /sys data.
82
83 Note that for charge, the output shows the current charge, as
84 well as its value as a percentage of the available capacity,
85 which can be less than the original design capacity. In the fol‐
86 lowing example, the actual current available capacity of the
87 battery is 22.2 Wh.
88
89 charge: 20.1 Wh 95.4%
90
91 The condition item shows the remaining available capacity /
92 original design capacity, and then this figure as a percentage
93 of original capacity available in the battery.
94
95 condition: 22.2/36.4 Wh (61%)
96
97 With -x shows attached Device-x information (mouse, keyboard,
98 etc.) if they are battery powered.
99
100
101 -c, --color [0-42]
102 Set color scheme. If no scheme number is supplied, 0 is assumed.
103
104
105 -c [94-99]
106
107 These color selectors run a color selector option prior to inxi
108 starting which lets you set the config file value for the selec‐
109 tion.
110
111 NOTE: All configuration file set color values are removed when
112 output is piped or redirected. You must use the explicit runtime
113 -c <color number> option if you want color codes to be present
114 in the piped/redirected output.
115
116 Color selectors for each type display (NOTE: IRC and global only
117 show safe color set):
118
119
120 -c 94 - Console, out of X.
121
122
123 -c 95 - Terminal, running in X - like xTerm.
124
125
126 -c 96 - GUI IRC, running in X - like XChat, Quassel, Konversation etc.
127
128
129 -c 97 - Console IRC running in X - like irssi in xTerm.
130
131
132 -c 98 - Console IRC not in X.
133
134
135 -c 99 - Global - Overrides/removes all settings.
136
137 Setting a specific color type removes the global color selec‐
138 tion.
139
140
141 -C, --cpu
142 Show full CPU output, including per CPU clock speed and CPU max
143 speed (if available). If max speed data present, shows (max) in
144 short output formats (inxi, inxi -b) if actual CPU speed matches
145 max CPU speed. If max CPU speed does not match actual CPU speed,
146 shows both actual and max speed information. See -x for more
147 options.
148
149 For certain CPUs (some ARM, and AMD Zen family) shows CPU die
150 count.
151
152 The details for each CPU include a technical description e.g.
153 type: MT MCP
154
155 * MT - Multi/Hyper Threaded CPU, more than 1 thread per core
156 (previously HT).
157
158 * MCM - Multi Chip Model (more than 1 die per CPU).
159
160 * MCP - Multi Core Processor (more than 1 core per CPU).
161
162 * SMP - Symmetric Multi Processing (more than 1 physical CPU).
163
164 * UP - Uni (single core) Processor.
165
166
167 -d, --disk-full,--optical
168 Show optical drive data as well as -D hard drive data. With -x,
169 adds a feature line to the output. Also shows floppy disks if
170 present. Note that there is no current way to get any informa‐
171 tion about the floppy device that we are aware of, so it will
172 simply show the floppy ID without any extra data. -xx adds a few
173 more features.
174
175
176 -D, --disk
177 Show Hard Disk info. Shows total disk space and used percentage.
178 The disk used percentage includes space used by swap parti‐
179 tion(s), since those are not usable for data storage. Note that
180 with RAID disks, the percentage will be wrong since the total is
181 computed from the disk sizes, but used is computed from mounted
182 partition used percentages. This small defect may get corrected
183 in the future. Also, unmounted partitions are not counted in
184 disk use percentages since inxi has no access to the used
185 amount.
186
187 Also shows per disk information: Disk ID, type (if present),
188 vendor (if detected), model, and size. See Extra Data Options
189 (-x options) and Admin Extra Data Options (--admin options) for
190 many more features.
191
192
193 --filter, --filter-override - See -z, -Z.
194
195
196 --filter-label
197 Filter partition label names from -j, -o, -p, -P, and -Sa
198 (root=LABEL=...). Generally only useful in very specialized
199 cases.
200
201
202 --filter-uuid
203 Filter partition UUIDs from -j, -o, -p, -P, and -Sa
204 (root=UUID=...). Generally only useful in very specialized
205 cases.
206
207
208 -f, --flags
209 Show all CPU flags used, not just the short list. Not shown with
210 -F in order to avoid spamming. ARM CPUs: show features items.
211
212
213 -F, --full
214 Show Full output for inxi. Includes all Upper Case line letters
215 except -W, plus --swap, -s and -n. Does not show extra verbose
216 options such as -d -f -i -l -m -o -p -r -t -u -x unless you use
217 those arguments in the command, e.g.: inxi -Frmxx
218
219
220 -G, --graphics
221 Show Graphic card(s) information, including details of card and
222 card driver, display protocol (if available), display server
223 (and/or Wayland compositor), vendor and version number, e.g.:
224
225 Display: x11 server: Xorg 1.15.1
226
227 If protocol is not detected, shows:
228
229 Display: server: Xorg 1.15.1
230
231 Also shows screen resolution(s) (per monitor/X screen), OpenGL
232 renderer, OpenGL core profile version/OpenGL version.
233
234 Compositor information will show if detected using -xx option or
235 always if detected and Wayland.
236
237
238 -h, --help
239 The help menu. Features dynamic sizing to fit into terminal win‐
240 dow. Set script global COLS_MAX_CONSOLE if you want a different
241 default value, or use -y <width> to temporarily override the
242 defaults or actual window width.
243
244
245 -i, --ip
246 Show WAN IP address and local interfaces (latter requires ifcon‐
247 fig or ip network tool), as well as network output from -n. Not
248 shown with -F for user security reasons. You shouldn't paste
249 your local/WAN IP. Shows both IPv4 and IPv6 link IP addresses.
250
251
252 -I, --info
253 Show Information: processes, uptime, memory, IRC client (or
254 shell type if run in shell, not IRC), inxi version. See -x and
255 -xx for extra information (init type/version, runlevel).
256
257 Note: if -m is used or triggered, the memory item will show in
258 the main Memory: report of -m, not in Info:.
259
260 Rasberry Pi only: uses vcgencmd get_mem gpu to get gpu RAM
261 amount, if user is in video group and vcgencmd is installed.
262 Uses this result to increase the Memory: amount and used:
263 amounts.
264
265
266 -j, --swap
267 Shows all active swap types (partition, file, zram). When this
268 option is used, swap partition(s) will not show on the -P line
269 to avoid redundancy.
270
271
272 -J, --usb
273 Show USB data for attached Hubs and Devices. Hubs also show num‐
274 ber of ports. Be aware that a port is not always external, some
275 may be internal, and either used or unused (for example, a moth‐
276 erboard USB header connector that is not used).
277
278 Hubs and Devices are listed in order of BusID.
279
280 BusID is generally in this format:
281 BusID-port[.port][.port]:DeviceID
282
283 Device ID is a number created by the kernel, and has no neces‐
284 sary ordering or sequence connection, but can be used to match
285 this output to lsusb values, which generally shows BusID / Devi‐
286 ceID (except for tree view, which shows ports).
287
288 Examples: Device-3: 4-3.2.1:2 or Hub: 4-0:1
289
290 The rev: 2.0 item refers to the USB revision number, like 1.0 or
291 3.1.
292
293
294 -l, --label
295 Show partition labels. Default: main partitions -P. For full -p
296 output, use: -pl.
297
298
299 -m, --memory
300 Memory (RAM) data. Does not display with -b or -F unless you
301 use -m explicitly. Ordered by system board physical system mem‐
302 ory array(s) (Array-[number]), and individual memory devices
303 (Device-[number]). Physical memory array data shows array
304 capacity, number of devices supported, and Error Correction
305 information. Devices shows locator data (highly variable in syn‐
306 tax), size, speed, type (eg: type: DDR3).
307
308 Note: -m uses dmidecode, which must be run as root (or start
309 inxi with sudo), unless you figure out how to set up sudo to
310 permit dmidecode to read /dev/mem as user. speed and bus width
311 will not show if No Module Installed is found in size.
312
313 Note: If -m is triggered RAM total/used report will appear in
314 this section, not in -I or -tm items.
315
316 Because dmidecode data is extremely unreliable, inxi will try to
317 make best guesses. If you see (check) after the capacity num‐
318 ber, you should check it with the specifications. (est) is
319 slightly more reliable, but you should still check the real
320 specifications before buying RAM. Unfortunately there is nothing
321 inxi can do to get truly reliable data about the system RAM;
322 maybe one day the kernel devs will put this data into /sys, and
323 make it real data, taken from the actual system, not dmi data.
324 For most people, the data will be right, but a significant per‐
325 centage of users will have either a wrong max module size, if
326 present, or max capacity.
327
328 See --memory-modules and --memory-short if you want a shorter
329 report.
330
331
332 --memory-modules
333 Memory (RAM) data. Show only RAM arrays and modules in Memory
334 report. Skip empty slots. See -m.
335
336
337 --memory-short
338 Memory (RAM) data. Show a one line RAM report in Memory. See -m.
339
340 Sample: Report: arrays: 1 slots: 4 modules: 2 type: DDR4
341
342
343 -M, --machine
344 Show machine data. Device, Motherboard, BIOS, and if present,
345 System Builder (Like Lenovo). Older systems/kernels without the
346 required /sys data can use dmidecode instead, run as root. If
347 using dmidecode, may also show BIOS/UEFI revision as well as
348 version. --dmidecode forces use of dmidecode data instead of
349 /sys. Will also attempt to show if the system was booted by
350 BIOS, UEFI, or UEFI [Legacy], the latter being legacy BIOS boot
351 mode in a system board using UEFI.
352
353 Device information requires either /sys or dmidecode. Note that
354 'other-vm?' is a type that means it's usually a VM, but inxi
355 failed to detect which type, or positively confirm which VM it
356 is. Primary VM identification is via systemd-detect-virt but
357 fallback tests that should also support some BSDs are used. Less
358 commonly used or harder to detect VMs may not be correctly
359 detected. If you get an incorrect output, post an issue and
360 we'll get it fixed if possible.
361
362 Due to unreliable vendor data, device type will show: desktop,
363 laptop, notebook, server, blade, plus some obscure stuff that
364 inxi is unlikely to ever run on.
365
366
367 -n, --network-advanced
368 Show Advanced Network card information in addition to that pro‐
369 duced by -N. Shows interface, speed, MAC ID, state, etc.
370
371
372 -N, --network
373 Show Network card(s) information, including card driver. With
374 -x, shows PCI BusID, Port number.
375
376
377 -o, --unmounted
378 Show unmounted partition information (includes UUID and LABEL if
379 available). Shows file system type if you have lsblk installed
380 (Linux only). For BSD/GNU Linux: shows file system type if file
381 is installed, and if you are root or if you have added to
382 /etc/sudoers (sudo v. 1.7 or newer):
383
384 <username> ALL = NOPASSWD: /usr/bin/file (sample)
385
386 Does not show components (partitions that create the md-raid
387 array) of md-raid arrays.
388
389
390 -p, --partitions-full
391 Show full Partition information (-P plus all other detected
392 mounted partitions).
393
394
395 -P, --partitions
396 Show basic Partition information. Shows, if detected: / /boot
397 /home /opt /tmp /usr /usr/home /var /var/tmp /var/log. If
398 --swap is not used, shows active swap partitions (never shows
399 file or zram type swap). Use -p to see all mounted partitions.
400
401
402 --processes - See -t
403
404
405 -r, --repos
406 Show distro repository data. Currently supported repo types:
407
408 APK (Alpine Linux + derived versions)
409
410 APT (Debian, Ubuntu + derived versions, as well as RPM based APT
411 distros like PCLinuxOS or Alt-Linux)
412
413 CARDS (NuTyX + derived versions)
414
415 EOPKG (Solus)
416
417 PACMAN (Arch Linux, KaOS + derived versions)
418
419 PACMAN-G2 (Frugalware + derived versions)
420
421 PISI (Pardus + derived versions)
422
423 PORTAGE (Gentoo, Sabayon + derived versions)
424
425 PORTS (OpenBSD, FreeBSD, NetBSD + derived OS types)
426
427 SLACKPKG (Slackware + derived versions)
428
429 TCE (TinyCore)
430
431 URPMQ (Mandriva, Mageia + derived versions)
432
433 XBPS (Void)
434
435 YUM/ZYPP (Fedora, Red Hat, Suse + derived versions)
436
437 More will be added as distro data is collected. If yours is
438 missing please show us how to get this information and we'll try
439 to add it.
440
441
442 -R, --raid
443 Show RAID data. Shows RAID devices, states, levels and compo‐
444 nents, and extra data with -x / -xx.
445
446 md-raid: If device is resyncing, also shows resync progress
447 line.
448
449 Note: Only md-raid and ZFS are currently supported. Other soft‐
450 ware RAID types could be added, but only if users supply all
451 data required, and if the software RAID actually can be made to
452 give the required output.
453
454 If hardware RAID is detected, shows basic information. Due to
455 complexity of adding hardware RAID device disk / RAID reports,
456 those will only be added if there is demand, and reasonable
457 reporting tools.
458
459
460 --recommends
461 Checks inxi application dependencies and recommends, as well as
462 directories, then shows what package(s) you need to install to
463 add support for each feature.
464
465
466 -s, --sensors
467 Show output from sensors if sensors installed/configured: Moth‐
468 erboard/CPU/GPU temperatures; detected fan speeds. GPU tempera‐
469 ture when available. Nvidia shows screen number for multiple
470 screens. IPMI sensors are also used (root required) if present.
471
472 --slots
473 Show PCI slots with type, speed, and status information.
474
475
476 --swap - See -j
477
478
479 -S, --system
480 Show System information: host name, kernel, desktop environment
481 (if in X), distro. With -xx show dm - or startx - (only shows if
482 present and running if out of X), and if in X, with -xxx show
483 more desktop info, e.g. taskbar or panel.
484
485
486 -t, --processes
487 [c|m|cm|mc NUMBER] Show processes. If no arguments, defaults to
488 cm. If followed by a number, shows that number of processes for
489 each type (default: 5; if in IRC, max: 5)
490
491 Make sure that there is no space between letters and numbers
492 (e.g. write as -t cm10).
493
494
495 -t c - CPU only. With -x, also shows memory for that process on same
496 line.
497
498
499 -t m - memory only. With -x, also shows CPU for that process on same
500 line. If the -I line is not triggered, will also show the sys‐
501 tem RAM used/total information.
502
503
504 -t cm - CPU+memory. With -x, shows also CPU or memory for that process
505 on same line.
506
507
508 -u, --uuid
509 Show partition UUIDs. Default: main partitions -P. For full -p
510 output, use: -pu.
511
512
513 -U, --update
514 Note - Maintainer may have disabled this function.
515
516 If inxi -h has no listing for -U then it's disabled.
517
518 Auto-update script. Note: if you installed as root, you must be
519 root to update, otherwise user is fine. Also installs / updates
520 this man page to: /usr/local/share/man/man1 (if
521 /usr/local/share/man/ exists AND there is no inxi man page in
522 /usr/share/man/man1, otherwise it goes to /usr/share/man/man1).
523 This requires that you be root to write to that directory. See
524 --man or --no-man to force or disable man install.
525
526
527 --usb - See -J
528
529
530 -V, --version
531 inxi version information. Prints information then exits.
532
533
534 -v, --verbosity
535 Script verbosity levels. If no verbosity level number is given,
536 0 is assumed. Should not be used with -b or -F.
537
538 Supported levels: 0-8 Examples : inxi -v 4 or inxi -v4
539
540
541 -v 0 - Short output, same as: inxi
542
543
544 -v 1 - Basic verbose, -S + basic CPU (cores, type, clock speed, and
545 min/max speeds, if available) + -G + basic Disk + -I.
546
547
548 -v 2 - Adds networking card (-N), Machine (-M) data, Battery (-B) (if
549 available). Same as: inxi -b
550
551
552 -v 3 - Adds advanced CPU (-C) and network (-n) data; triggers -x
553 advanced data option.
554
555
556 -v 4 - Adds partition size/used data (-P) for (if present): / /home
557 /var/ /boot. Shows full disk data (-D)
558
559
560 -v 5 - Adds audio card (-A), memory/RAM (-m), sensors (-s), partition
561 label (-l), UUID (-u), full swap data (-j), and short form of
562 optical drives.
563
564
565 -v 6 - Adds full mounted partition data (-p), unmounted partition
566 data (-o), optical drive data (-d), USB (-J); triggers -xx extra
567 data option.
568
569
570 -v 7 - Adds network IP data (-i); triggers -xxx
571
572
573 -v 8 - All system data available. Adds Repos (-r), PCI slots
574 (--slots), processes (-tcm), admin (--admin). Useful for testing
575 output and to see what data you can get from your system.
576
577
578 -w, --weather
579 Adds weather line. To get weather for an alternate location, use
580 -W [location]. See also -x, -xx, -xxx options. Please note that
581 your distribution's maintainer may chose to disable this fea‐
582 ture.
583
584 DO NOT USE THIS FEATURE FOR AUTOMATED WEATHER UPDATES! You will
585 be blocked from any further access. This feature is not meant
586 for widget type weather monitoring, or Conky type use. It is
587 meant to get weather when you need to see it, for example, on a
588 remote server.
589
590
591 -W, --weather-location <location_string>
592 Get weather/time for an alternate location. Accepts postal/zip
593 code[, country], city,state pair, or latitude,longitude. Note:
594 city/country/state names must not contain spaces. Replace spaces
595 with '+' sign. Don't place spaces around any commas. Postal code
596 is not reliable except for North America and maybe the UK. Try
597 postal codes with and without country code added. Note that
598 City,State applies only to USA, otherwise it's City,Country. If
599 country name (english) does not work, try 2 character country
600 code (e.g. Spain: es; Great Britain: gb).
601
602 See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 for current
603 2 letter country codes.
604
605 Use only ASCII letters in city/state/country names.
606
607 Examples: -W 95623,us OR -W Boston,MA OR -W 45.5234,-122.6762 OR
608 -W new+york,ny OR -W bodo,norway.
609
610 DO NOT USE THIS FEATURE FOR AUTOMATED WEATHER UPDATES! Use of
611 automated queries, will result in your access being blocked. If
612 you try to work around the ban, you will be permanently banned
613 from this service.
614
615
616 --weather-source, --ws <unit>
617 [1-9] Switches weather data source. Possible values are 1-9. 1-4
618 will generally be active, and 5-9 may or may not be active, so
619 check. 1 may not support city / country names with spaces (even
620 if you use the + sign instead of space). 2 offers pretty good
621 data, but may not have all small city names for -W.
622
623 Please note that the data sources are not static per value, and
624 can change any time, or be removed, so always test to verify
625 which source is being used for each value if that is important
626 to you. Data sources may be added or removed on occasions, so
627 try each one and see which you prefer. If you get unsupported
628 source message, it means that number has not been implemented.
629
630
631 --weather-unit <unit>
632 [m|i|mi|im] Sets weather units to metric (m), imperial (i), met‐
633 ric (imperial) (mi, default), imperial (metric) (im). If metric
634 or imperial not found,sets to default value, or N/A.
635
636
637 -y, --width <integer>
638 This is an absolute width override which sets the output line
639 width max. Overrides COLS_MAX_IRC / COLS_MAX_CONSOLE globals,
640 or the actual widths of the terminal. 80 is the minimum width
641 supported. -1 removes width limits. Example: inxi -Fxx -y 130
642
643
644 -z, --filter
645 Adds security filters for IP addresses, serial numbers, MAC,
646 location (-w), and user home directory name. Removes Host:. On
647 by default for IRC clients.
648
649
650 -Z, --filter-override
651 Absolute override for output filters. Useful for debugging net‐
652 working issues in IRC for example.
653
654
656 These options can be triggered by one or more -x. Alternatively, the
657 -v options trigger them in the following way: -v 3 adds -x; -v 6 adds
658 -xx; -v 7 adds -xxx
659
660 These extra data triggers can be useful for getting more in-depth data
661 on various options. They can be added to any long form option list,
662 e.g.: -bxx or -Sxxx
663
664 There are 3 extra data levels:
665
666 -x, -xx, -xxx
667
668 OR
669
670 --extra 1, --extra 2, --extra 3
671
672 The following details show which lines / items display extra informa‐
673 tion for each extra data level.
674
675
676 -x -A - Adds (if available and/or relevant) vendor: item, which shows
677 specific vendor [product] information.
678
679 - Adds version/port(s)/driver version (if available) for each
680 Audio device.
681
682 - Adds PCI Bus ID/USB ID number of each Audio device.
683
684
685 -x -B - Adds vendor/model, battery status (if battery present).
686
687 - Adds attached battery powered peripherals (Device-[number]:)
688 if detected (keyboard, mouse, etc.).
689
690
691 -x -C - Adds bogomips on CPU (if available)
692
693 - Adds CPU Flags (short list). Use -f to see full flag/feature
694 list.
695
696 - Adds CPU microarchitecture + revision (e.g. Sandy Bridge, K8,
697 ARMv8, P6, etc.). Only shows data if detected. Newer microarchi‐
698 tectures will have to be added as they appear, and require the
699 CPU family ID and model ID.
700
701 Examples: arch: Sandy Bridge rev: 2, arch: K8 rev.F+ rev: 2
702
703
704 -x -d - Adds more items to Features line of optical drive; dds rev
705 version to optical drive.
706
707
708 -x -D - Adds HDD temperature with disk data if you have hddtemp
709 installed, if you are root or if you have added to /etc/sudoers
710 (sudo v. 1.7 or newer):
711
712 <username> ALL = NOPASSWD: /usr/sbin/hddtemp (sample)
713
714
715 -x -G - Adds (if available and/or relevant) vendor: item, which shows
716 specific vendor [product] information.
717
718 - Adds direct rendering status.
719
720 - Adds (for single GPU, nvidia driver) screen number that GPU is
721 running on.
722
723 - Adds PCI Bus ID/USB ID number of each Graphics card.
724
725
726 -x -i - Adds IP v6 additional scope data, like Global, Site, Temporary
727 for each interface.
728
729 Note that there is no way we are aware of to filter out the dep‐
730 recated IP v6 scope site/global temporary addresses from the
731 output of ifconfig. The ip tool shows that clearly.
732
733 ip-v6-temporary - (ip tool only), scope global temporary. Scope
734 global temporary deprecated is not shown
735
736 ip-v6-global - scope global (ifconfig will show this for all
737 types, global, global temporary, and global temporary depre‐
738 cated, ip shows it only for global)
739
740 ip-v6-link - scope link (ip/ifconfig) - default for -i.
741
742 ip-v6-site - scope site (ip/ifconfig). This has been deprecated
743 in IPv6, but still exists. ifconfig may show multiple site val‐
744 ues, as with global temporary, and global temporary deprecated.
745
746 ip-v6-unknown - unknown scope
747
748
749 -x -I - Adds current init system (and init rc in some cases, like
750 OpenRC). With -xx, shows init/rc version number, if available.
751
752 - Adds default system gcc. With -xx, also show other installed
753 gcc versions.
754
755 - Adds current runlevel (not available with all init systems).
756
757 - If in shell (i.e. not in IRC client), adds shell version num‐
758 ber, if available.
759
760
761 -x -J (--usb)
762 - For Devices, adds driver(s).
763
764
765 -x -m, --memory-modules
766 - If present, adds maximum memory module/device size in the
767 Array line. Only some systems will have this data available.
768 Shows estimate if it can generate one.
769
770 - Adds device type in the Device line.
771
772
773 -x -N - Adds (if available and/or relevant) vendor: item, which shows
774 specific vendor [product] information.
775
776 - Adds version/port(s)/driver version (if available) for each
777 Network card;
778
779 - Adds PCI Bus ID/USB ID number of each Network card.
780
781
782 -x -R - md-raid: Adds second RAID Info line with extra data: blocks,
783 chunk size, bitmap (if present). Resync line, shows blocks
784 synced/total blocks.
785
786 - Hardware RAID: Adds driver version, bus ID.
787
788
789 -x -s - Adds basic voltages: 12v, 5v, 3.3v, vbat (ipmi, lm-sensors if
790 present).
791
792
793 -x -S - Adds Kernel gcc version.
794
795 - Adds to Distro: base: if detected. System base will only be
796 seen on a subset of distributions. The distro must be both
797 derived from a parent distro (e.g. Mint from Ubuntu), and
798 explicitly added to the supported distributions for this fea‐
799 ture. Due to the complexity of distribution identification,
800 these will only be added as relatively solid methods are found
801 for each distribution system base detection.
802
803
804 -x -t (--processes)
805 - Adds memory use output to CPU (-xt c), and CPU use to memory
806 (-xt m).
807
808
809 -x -w, -W
810 - Adds humidity and barometric pressure.
811
812 - Adds wind speed and direction.
813
814
815 -xx -A - Adds vendor:product ID for each Audio device.
816
817
818 -xx -B - Adds serial number, voltage (if available). Note that volts
819 shows the data (if available) as the voltage now / minimum
820 design voltage.
821
822
823 -xx -C - Adds L1 cache: and L3 cache: if either are available. Requires
824 dmidecode and sudo/root.
825
826
827 -xx -D - Adds disk serial number.
828
829 - Adds disk speed (if available). This is the theoretical top
830 speed of the device as reported. This speed may be restricted by
831 system board limits, eg. a SATA 3 drive on a SATA 2 board may
832 report SATA 2 speeds, but this is not completely consistent,
833 sometimes a SATA 3 device on a SATA 2 board reports its design
834 speed.
835
836 NVMe drives: adds lanes, and (per direction) speed is calculated
837 with lane speed * lanes * PCIe overhead. PCIe 1 and 2 have data
838 rates of GT/s * .8 = Gb/s (10 bits required to transfer 8 bits
839 of data). PCIe 3 and greater transfer data at a rate of GT/s *
840 128/130 * lanes = Gb/s (130 bits required to transfer 128 bits
841 of data).
842
843 For a PCIe 3 NVMe drive, with speed of 8 GT/s and 4 lanes (8GT/s
844 * 128/130 * 4 = 31.6 Gb/s):
845
846 speed: 31.6 Gb/s lanes: 4
847
848
849 -xx -G - Adds vendor:product ID of each Graphics card.
850
851 - Adds Xorg compositor, if found (always shows for Wayland sys‐
852 tems).
853
854 - For free drivers, adds OpenGL compatibility version number if
855 available. For nonfree drivers, the core version and compati‐
856 bility versions are usually the same. Example:
857
858 v: 3.3 Mesa 11.2.0 compat-v: 3.0
859
860 - If available, shows alternate: Xorg drivers. This means a
861 driver on the default list of drivers Xorg automatically checks
862 for the card, but which is not installed. For example, if you
863 have nouveau driver, nvidia would show as alternate if it was
864 not installed. Note that alternate: does NOT mean you should
865 have it, it's just one of the drivers Xorg checks to see if is
866 present and loaded when checking the card. This can let you know
867 there are other driver options. Note that if you have explic‐
868 itly set the driver in xorg.conf, Xorg will not create this
869 automatic check driver list.
870
871 - If available, shows Xorg dpi (s-dpi:) for the active Xorg
872 Screen (not physical monitor). Note that the physical monitor
873 dpi and the Xorg dpi are not necessarily the same thing, and can
874 vary widely.
875
876
877 -xx -I - Adds init type version number (and rc if present).
878
879 - Adds other detected installed gcc versions (if present).
880
881 - Adds system default runlevel, if detected. Supports Sys‐
882 temd/Upstart/SysVinit type defaults.
883
884 - Adds parent program (or tty) that started shell, if not IRC
885 client.
886
887
888 -xx -j (--swap), -xx -p, -xx -P
889 - Adds swap priority to each swap partition (for -P) used, and
890 for all swap types (for -j).
891
892
893 -xx -J (--usb)
894 - Adds vendor:chip id.
895
896
897 -xx -m, --memory-modules
898 - Adds memory device Manufacturer.
899
900 - Adds memory device Part Number (part-no:). Useful for order‐
901 ing new or replacement memory sticks etc. Part numbers are
902 unique, particularly if you use the word memory in the search as
903 well. With -xxx, also shows serial number.
904
905 - Adds single/double bank memory, if data is found. Note, this
906 may not be 100% right all of the time since it depends on the
907 order that data is found in dmidecode output for type 6 and type
908 17.
909
910
911 -xx -M - Adds chassis information, if data is available. Also shows
912 BIOS ROM size if using dmidecode.
913
914
915 -xx -N - Adds vendor:product ID for each Network card.
916
917
918 -xx -R - md-raid: Adds superblock (if present) and algorithm. If
919 resync, shows progress bar.
920
921 - Hardware RAID: Adds Chip vendor:product ID.
922
923
924 -xx -s - Adds DIMM/SOC voltages, if present (ipmi only).
925
926
927 -xx -S - Adds display manager (dm) type, if present. If none, shows
928 N/A. Supports most known display managers, including gdm, gdm3,
929 idm, kdm, lightdm, lxdm, mdm, nodm, sddm, slim, tint, wdm, and
930 xdm.
931
932 - Adds, if run in X, window manager type (wm), if available.
933 Not all window managers are supported. Some desktops support
934 using more than one window manager, so this can be useful to see
935 what window manager is actually running. If none found, shows
936 nothing. Uses a less accurate fallback tool wmctrl if ps tests
937 fail to find data.
938
939 - Adds desktop toolkit (tk), if available (Xfce/KDE/Trinity).
940
941
942 -xx --slots
943 - Adds slot length.
944
945
946 -xx -w, -W
947 - Adds wind chill, heat index, and dew point, if available.
948
949 - Adds cloud cover, rain, snow, or precipitation (amount in pre‐
950 vious hour to observation time), if available.
951
952
953 -xxx -A
954 - Adds, if present, serial number.
955
956
957 -xxx -B
958 - Adds battery chemistry (e.g. Li-ion), cycles (NOTE: there
959 appears to be a problem with the Linux kernel obtaining the
960 cycle count, so this almost always shows 0. There's nothing that
961 can be done about this glitch, the data is simply not available
962 as of 2018-04-03), location (only available from dmidecode
963 derived output).
964
965 - Adds attached device rechargeable: [yes|no] information.
966
967
968 -xxx -C
969 - Adds boost: [enabled|disabled] if detected, aka turbo. Not all
970 CPUs have this feature.
971
972
973 -xxx -D
974 - Adds disk firmware revision number (if available).
975
976 - Adds disk partition scheme (in most cases), e.g. scheme: GPT.
977 Currently not able to detect all schemes, but handles the most
978 common, e.g. GPT or MBR.
979
980 - Adds disk rotation speed (in some but not all cases), e.g.
981 rotation: 7200 rpm. Only appears if detected (SSD drives do not
982 have rotation speeds, for example). If none found, nothing
983 shows. Not all disks report this speed, so even if they are
984 spinnning, no data will show.
985
986
987 -xxx -G
988 - Adds (if available) Xorg compositor: version v: (always shows
989 if found for Wayland systems).
990
991
992 -xxx -I
993 - For Shell: adds (su|sudo|login) to shell name if present.
994
995 - For running in: adds (SSH) to parent, if present. SSH detec‐
996 tion uses the who am i test.
997
998
999 -xxx -J (--usb)
1000 - Adds, if present, serial number for non hub devices.
1001
1002 - Adds interfaces: for non hub devices.
1003
1004 - Adds, if available, USB speed in Mbits/s or Gbits/s.
1005
1006
1007 -xxx -m, --memory-modules
1008 - Adds memory bus width: primary bus width, and if present,
1009 total width. e.g. bus width: 64 bit (total: 72 bits). Note that
1010 total / data widths are mixed up sometimes in dmidecode output,
1011 so inxi will take the larger value as the total if present. If
1012 no total width data is found, then inxi will not show that item.
1013
1014 - Adds device Type Detail, e.g. detail: DDR3 (Synchronous).
1015
1016 - Adds, if present, memory module voltage. Only some systems
1017 will have this data available.
1018
1019 - Adds device serial number.
1020
1021
1022 -xxx -N
1023 - Adds, if present, serial number.
1024
1025
1026 -xxx -R
1027 - md-raid: Adds system mdraid support types (kernel support,
1028 read ahead, RAID events)
1029
1030 - zfs-raid: Adds portion allocated (used) by RAID array/device.
1031
1032 - Hardware RAID: Adds rev, ports, and (if available and/or rele‐
1033 vant) vendor: item, which shows specific vendor [product] infor‐
1034 mation.
1035
1036
1037 -xxx -S
1038 - Adds, if in X, or with --display, bar/dock/panel/tray items
1039 (info). If none found, shows nothing. Supports desktop items
1040 like gnome-panel, lxpanel, xfce4-panel, lxqt-panel, tint2,
1041 cairo-dock, trayer, and many others.
1042
1043 - Adds (if present), window manager (wm) version number.
1044
1045 - Adds (if present), display manager (dm) version number.
1046
1047
1048 -xxx -w, -W
1049 - Adds location (city state country), observation altitude (if
1050 available), weather observation time (if available), sunset/sun‐
1051 rise (if available).
1052
1053
1055 These options are triggered with --admin or -a. Admin options are
1056 advanced output options, and are more technical, and mostly of interest
1057 to system administrators or other machine admins.
1058
1059 The --admin option sets -xxx, and only has to be used once. It will
1060 trigger the following features:
1061
1062
1063 -a -C - Adds CPU family, model-id, and stepping (replaces rev of -Cx).
1064 Format is hexadecimal (decimal) if greater than 9, otherwise
1065 hexadecimal.
1066
1067 - Adds CPU microcode. Format is hexadecimal.
1068
1069 - Adds CPU Vulnerabilities (bugs) as known by your current ker‐
1070 nel. Lists by Type: ... (status|mitigation): .... for systems
1071 that support this feature (Linux kernel 4.14 or newer, or
1072 patched older kernels).
1073
1074
1075 -a -d,-a -D
1076 - Adds logical and physical block size in bytes.
1077
1078 Using smartctl (requires sudo/root privileges).
1079
1080 - Adds device model family, like Caviar Black, if available.
1081
1082 - Adds SATA type (eg 1.0, 2.6, 3.0) if a SATA device.
1083
1084 - Adds SMART report line: status, enabled/disabled, health, pow‐
1085 ered on, cycles, and some error cases if out of range values.
1086 Note that for Pre-fail items, it will show the VALUE and THRESH‐
1087 OLD numbers. It will also fall back for unknown attributes that
1088 are or have been failing and print out the Attribute name,
1089 value, threshold, and failing message. This way even for unhan‐
1090 dled Attribute names, you should get a solid report for full
1091 failure cases. Other cases may show if inxi believes that the
1092 item may be approaching failure. This is a guess so make sure to
1093 check the drive and smartctl full output to verify before taking
1094 any further action.
1095
1096 - Adds, for USB or other external drives, actual model
1097 name/serial if available, and different from enclosure
1098 model/serial, and corrects block sizes if necessary. Adds in
1099 drive temperature for some drives as well, and other useful
1100 data.
1101
1102
1103 -a -G Triggers a much more complete Screen/Monitor output on the Dis‐
1104 play: line of -G. Note that the basic feature requires xdpyinfo,
1105 and the advanced per monitor feature requires xrandr.
1106
1107 No support currently exists for Wayland since we so far can find
1108 no documentation or easy methods to extract this information
1109 from Wayland compositors. This unfortunate situation may change
1110 in the future, hopefully. However, most Wayland systems also
1111 come with xwayland, which should supply the tools necessary for
1112 the time being.
1113
1114 Further note that all references to Displays, Screens, and Moni‐
1115 tors are referring to the X technical terms, not normal consumer
1116 usage. 1 Display runs 1 or more Screens, and a Screen runs 1 or
1117 more Monitors.
1118
1119 - Adds Display ID, for the Display running the Screen that runs
1120 the Monitors.
1121
1122 - Adds total number of Screens listed for the current Display.
1123
1124 - Adds default Screen ID if Screen (not monitor!) total is
1125 greater than 1.
1126
1127 - Adds Screen line, which includes the ID (Screen: 0) then s-res
1128 (Screen resolution), s-dpi, s-size and s-diag. Remember, this is
1129 an Xorg Screen, NOT a monitor screen, and the information listed
1130 is about the Xorg Screen! It may at times be the same as a sin‐
1131 gle monitor system, but usually it's different in some ways.
1132
1133 - Adds Monitor ID(s). Monitors are a subset of a Screen, each of
1134 which can have one or more monitors. Normally a dual monitor
1135 setup is 2 monitors run by one Xorg Screen. Each monitor has the
1136 following data, if available:
1137
1138 - res: resolution in pixels. This is the individual monitor's
1139 reported pixel dimensions.
1140
1141 - hz: frequency in Herz, as reported to Xorg. Note that there
1142 have been and may continue to be bugs with how Xorg treats > 1
1143 monitor frequencies.
1144
1145 - dpi: dpi (dots per inch), aka, ppi (pixels per inch). This is
1146 the physical screen dpi, which is calculated using the screen
1147 dimensions and its resolution.
1148
1149 - size: size in mm (inches). Note that this is the real monitor
1150 size, not the Xorg Screen size, which can be quite different (1
1151 Xorg Screen can for instance contain two or more monitors).
1152
1153 - diag: monitor screen diagonal in mm (inches). Note that this
1154 is the real monitor size, not the Xorg full Screen diagonal
1155 size, which can be quite different.
1156
1157 Sample (with both xdpyinfo and xrandr data available):
1158 inxi -aG
1159 Graphics:
1160 ....
1161 Display: x11 server: X.Org 1.20.6 driver: modesetting
1162 display ID: :0.0 screens: 1
1163 Screen-1: 0 s-res: 2560x1024 s-dpi: 96 s-size: 677x271mm (26.7x10.7")
1164 s-diag: 729mm (28.7")
1165 Monitor-1: DVI-I-0 res: 1280x1024 hz: 60 dpi: 96
1166 size: 338x270mm (13.3x10.6") diag: 433mm (17")
1167 Monitor-2: VGA-0 res: 1280x1024 hz: 60 dpi: 86
1168 size: 376x301mm (14.8x11.9") diag: 482mm (19")
1169 ....
1170
1171
1172 -a -j, -a -P , -a -P
1173 - Adds swappiness and vfs cache pressure, and a message to indi‐
1174 cate if the value is the default value or not (Linux only, and
1175 only if available). If not the default value, shows default
1176 value as well, e.g.
1177
1178 For -P per swap physical partition:
1179
1180 swappiness: 60 (default) cache pressure: 90 (default 100)
1181
1182 For -j row 1 output:
1183
1184 Kernel: swappiness: 60 (default) cache pressure: 90 (default
1185 100)
1186
1187
1188 -a -p,-a -P
1189 - Adds raw partition size, including file system overhead, par‐
1190 tition table, e.g.
1191
1192 raw size: 60.00 GiB.
1193
1194 - Adds percent of raw size available to size: item, e.g.
1195
1196 size: 58.81 GiB (98.01%).
1197
1198 Note that used: 16.44 GiB (34.3%) percent refers to the avail‐
1199 able size, not the raw size.
1200
1201 - Adds partition filesystem block size if found (requires root
1202 and blockdev).
1203
1204
1205 -a -S - Adds kernel boot parameters to Kernel section (if detected).
1206 Support varies by OS type.
1207
1208
1210 --alt 40
1211 Bypass Perl as a downloader option. Priority is: Perl
1212 (HTTP::Tiny), Curl, Wget, Fetch, (OpenBSD only) ftp.
1213
1214
1215 --alt 41
1216 Bypass Curl as a downloader option. Priority is: Perl
1217 (HTTP::Tiny), Curl, Wget, Fetch, (OpenBSD only) ftp.
1218
1219
1220 --alt 42
1221 Bypass Fetch as a downloader option. Priority is: Perl
1222 (HTTP::Tiny), Curl, Wget, Fetch, (OpenBSD only) ftp.
1223
1224
1225 --alt 43
1226 Bypass Wget as a downloader option. Priority is: Perl
1227 (HTTP::Tiny), Curl, Wget, Fetch, OpenBSD only: ftp
1228
1229
1230 --alt 44
1231 Bypass Curl, Fetch, and Wget as downloader options. This basi‐
1232 cally forces the downloader selection to use Perl 5.x
1233 HTTP::Tiny, which is generally slower than Curl or Wget but it
1234 may help bypass issues with downloading.
1235
1236
1237 --dig Temporary override of NO_DIG configuration item. Only use to
1238 test w/wo dig. Restores default behavior for WAN IP, which is
1239 use dig if present.
1240
1241
1242 --display [:<integer>]
1243 Will try to get display data out of X (does not usually work as
1244 root user). Default gets display info from display :0. If you
1245 use the format --display :1 then it would get it from display 1
1246 instead, or any display you specify.
1247
1248 Note that in some cases, --display will cause inxi to hang end‐
1249 lessly when running the option in console with Intel graphics.
1250 The situation regarding other free drivers such as nouveau/ATI
1251 is currently unknown. It may be that this is a bug with the
1252 Intel graphics driver - more information is required.
1253
1254 You can test this easily by running the following command out of
1255 X/display server: glxinfo -display :0
1256
1257 If it hangs, --display will not work.
1258
1259
1260 --dmidecode
1261 Force use of dmidecode. This will override /sys data in some
1262 lines, e.g. -M or -B.
1263
1264
1265 --downloader [curl|fetch|perl|wget]
1266 Force inxi to use Curl, Fetch, Perl, or Wget for downloads.
1267
1268
1269 --host Turns on hostname in System line. Overrides inxi config file
1270 value (if set):
1271
1272 SHOW_HOST='false' - Same as: SHOW_HOST='true'
1273
1274 This is an absolute override, the host will always show no mat‐
1275 ter what other switches you use.
1276
1277
1278 --indent-min [integer]
1279 Overrides default indent minimum value. This is the value that
1280 makes inxi change from wrapped line starters [like Info] to non
1281 wrapped. If less than 80, no wrapping will occur. Overrides
1282 internal default value and user configuration value:
1283
1284 INDENT_MIN=85
1285
1286
1287 --limit [-1 - x]
1288 Raise or lower max output limit of IP addresses for -i. -1
1289 removes limit.
1290
1291
1292 --man Updates / installs man page with -U if pinxi or using -U 3 dev
1293 branch. (Only active if -U is is not disabled by maintainers).
1294
1295
1296 --no-dig
1297 Overrides default use of dig to get WAN IP address. Allows use
1298 of normal downloader tool to get IP addresses. Only use if dig
1299 is failing, since dig is much faster and more reliable in gen‐
1300 eral than other methods.
1301
1302
1303 --no-host
1304 Turns off hostname in System line. This is default when using
1305 -z, for anonymizing inxi output for posting on forums or IRC.
1306 Overrides configuration value (if set):
1307
1308 SHOW_HOST='true' - Same as: SHOW_HOST='false'
1309
1310 This is an absolute override, the host will not show no matter
1311 what other switches you use.
1312
1313
1314 --no-man
1315 Disables man page install with -U for master and active develop‐
1316 ment branches. (Only active if -U is is not disabled by main‐
1317 tainers).
1318
1319
1320 --no-ssl
1321 Skip SSL certificate checks for all downloader actions (-U, -w,
1322 -W, -i). Use if your system does not have current SSL certifi‐
1323 cate lists, or if you have problems making a connection for any
1324 reason. Works with Wget, Curl, Perl HTTP::Tinyand Fetch.
1325
1326
1327 --no-sudo
1328 Skips the use of sudo to run certain internal features (like
1329 hddtemp, file) with sudo. Not related to running inxi itself
1330 with sudo or super user. Some systems will register errors which
1331 will then trigger admin emails in such cases, so if you want to
1332 disable regular user use of sudo (which requires configuration
1333 to setup anyway for these options) just use this option, or
1334 NO_SUDO configuration item.
1335
1336
1337 --output [json|screen|xml]
1338 Change data output type. Requires --output-file if not screen.
1339
1340
1341 --output-file [full path to output file|print]
1342 The given directory path must exist. The directory path given
1343 must exist, The print options prints to stdout. Required for
1344 non-screen --output formats (json|xml).
1345
1346
1347 --partition-sort [dev-base|fs|id|label|percent-used|size|uuid|used]
1348 Change default sort order of partition output. Corresponds to
1349 PARTITION_SORT configuration item. These are the available sort
1350 options:
1351
1352 dev-base - /dev partition identifier, like /dev/sda1. Note that
1353 it's an alphabetic sort, so sda12 is before sda2.
1354
1355 fs - Partition filesystem. Note that sorts will be somewhat ran‐
1356 dom if all filesystems are the same.
1357
1358 id - Mount point of partition (default).
1359
1360 label - Label of partition. If partitions have no labels, sort
1361 will be random.
1362
1363 percent-used - Percentage of partition size used.
1364
1365 size - KiB size of partition.
1366
1367 uuid - UUID of the partition.
1368
1369 used - KiB used of partition.
1370
1371
1372 --pm-type [package manager name]
1373 For distro package maintainers only, and only for non apt, rpm,
1374 or pacman based systems. To be used to test replacement package
1375 lists for recommends for that package manager.
1376
1377
1378 --sleep [0-x.x]
1379 Usually in decimals. Change CPU sleep time for -C (current:
1380 .35). Sleep is used to let the system catch up and show a more
1381 accurate CPU use. Example:
1382
1383 inxi -Cxxx --sleep 0.15
1384
1385 Overrides default internal value and user configuration value:
1386
1387 CPU_SLEEP=0.25
1388
1389
1390 --tty Forces internal IRC flag to off. Used in unhandled cases where
1391 the program running inxi may not be seen as a shell/tty, but it
1392 is not an IRC client. Put --tty first in option list to avoid
1393 unexpected errors. If you want a specific output width, use the
1394 --width option. If you want normal color codes in the output,
1395 use the -c [color ID] flag.
1396
1397 The sign you need to use this is extra numbers before the
1398 key/value pairs of the output of your program. These are IRC,
1399 not TTY, color codes. Please post a github issue if you find you
1400 need to use --tty (including the full -Ixxx line) so we can fig‐
1401 ure out how to add your program to the list of whitelisted pro‐
1402 grams.
1403
1404 You can see what inxi believed started it in the -Ixxx line,
1405 Shell: or Client: item. Please let us know what that result was
1406 so we can add it to the parent start program whitelist.
1407
1408
1409 --usb-sys
1410 Forces the USB data generator to use /sys as data source instead
1411 of lsusb.
1412
1413
1414 --usb-tool
1415 Forces the USB data generator to use lsusb as data source. Over‐
1416 rides USB_SYS in user configuration file(s).
1417
1418
1419 --wan-ip-url [URL]
1420 Force -i to use supplied URL as WAN IP source. Overrides dig or
1421 default IP source urls. URL must start with http[s] or ftp.
1422
1423 The IP address from the URL must be the last item on the last
1424 (non-empty) line of the page content source code.
1425
1426 Same as configuration value (example):
1427
1428 WAN_IP_URL='https://mysite.com/ip.php'
1429
1430
1431 --wm Force System item wm to use wmctrl as data source, override
1432 default ps source.
1433
1434
1436 --dbg 1
1437 - Debug downloader failures. Turns off silent/quiet mode for
1438 curl, wget, and fetch. Shows more downloader action information.
1439 Shows some more information for Perl downloader.
1440
1441
1442 --dbg [2-xx]
1443 - See github inxi-perl/docs/inxi-values.txt for specific spe‐
1444 cialized debugging options. These can vary but tend to not
1445 change much, though they are added as needed.
1446
1447
1448 --debug [1-3]
1449 - On screen debugger output. Output varies depending on current
1450 needs Usually nothing changes.
1451
1452
1453 --debug 10
1454 - Basic logging. Check $XDG_DATA_HOME/inxi/inxi.log or
1455 $HOME/.local/share/inxi/inxi.log or $HOME/.inxi/inxi.log.
1456
1457
1458 --debug 11
1459 - Full file/system info logging.
1460
1461
1462 --debug 20
1463 Creates a tar.gz file of system data and collects the inxi out‐
1464 put in a file.
1465
1466 * tree traversal data file(s) read from /proc and /sys, and
1467 other system data.
1468
1469 * xorg conf and log data, xrandr, xprop, xdpyinfo, glxinfo etc.
1470
1471 * data from dev, disks, partitions, etc.
1472
1473
1474 --debug 21
1475 Automatically uploads debugger data tar.gz file to ftp.techpat‐
1476 terns.com, then removes the debug data directory, but leaves the
1477 debug tar.gz file. See --ftp for uploading to alternate loca‐
1478 tions.
1479
1480
1481 --debug 22
1482 Automatically uploads debugger data tar.gz file to ftp.techpat‐
1483 terns.com, then removes the debug data directory and the tar.gz
1484 file. See --ftp for uploading to alternate locations.
1485
1486
1487 --ftp [ftp.yoursite.com/incoming]
1488 For alternate ftp upload locations: Example:
1489
1490 inxi --ftp ftp.yourserver.com/incoming --debug 21
1491
1492
1494 Only used the following in conjunction with --debug 2[012], and only
1495 use if you experienced a failure or hang, or were instructed to do so.
1496
1497
1498 --debug-proc
1499 Force debugger to parse /proc directory data when run as root.
1500 Normally this is disabled due to unpredictable data in /proc
1501 tree.
1502
1503
1504 --debug-proc-print
1505 Use this to locate file that /proc debugger hangs on.
1506
1507
1508 --debug-no-exit
1509 Skip exit on error when running debugger.
1510
1511
1512 --debug-no-proc
1513 Skip /proc debugging in case of a hang.
1514
1515
1516 --debug-no-sys
1517 Skip /sys debugging in case of a hang.
1518
1519
1520 --debug-sys
1521 Force PowerPC debugger parsing of /sys as sudo/root.
1522
1523
1524 --debug-sys-print
1525 Use this to locate file that /sys debugger hangs on.
1526
1527
1529 BitchX, Gaim/Pidgin, ircII, Irssi, Konversation, Kopete, KSirc, KVIrc,
1530 Weechat, and Xchat. Plus any others that are capable of displaying
1531 either built-in or external script output.
1532
1533
1535 To trigger inxi output in your IRC client, pick the appropriate method
1536 from the list below:
1537
1538 Hexchat, XChat, Irssi
1539 (and many other IRC clients) /exec -o inxi [options] If you
1540 don't include the -o, only you will see the output on your local
1541 IRC client.
1542
1543 Konversation
1544 /cmd inxi [options]
1545
1546 To run inxi in Konversation as a native script if your distribu‐
1547 tion or inxi package hasn't already done this for you, create
1548 this symbolic link:
1549
1550 KDE 4: ln -s /usr/local/bin/inxi /usr/share/kde4/apps/konversa‐
1551 tion/scripts/inxi
1552
1553 KDE 5: ln -s /usr/local/bin/inxi /usr/share/konversa‐
1554 tion/scripts/inxi
1555
1556 If inxi is somewhere else, change the path /usr/local/bin to
1557 wherever it is located.
1558
1559 If you are using KDE/QT 5, then you may also need to add the
1560 following to get the Konversation /inxi command to work:
1561
1562 ln -s /usr/share/konversation /usr/share/apps/
1563
1564 Then you can start inxi directly, like this:
1565
1566 /inxi [options]
1567
1568 WeeChat
1569 NEW: /exec -o inxi [options]
1570
1571 OLD: /shell -o inxi [options]
1572
1573 Newer (2014 and later) WeeChats work pretty much the same now as
1574 other console IRC clients, with /exec -o inxi [options]. Newer
1575 WeeChats have dropped the -curses part of their program name,
1576 i.e.: weechat instead of weechat-curses.
1577
1578
1580 inxi will read its configuration/initialization files in the following
1581 order:
1582
1583 /etc/inxi.conf contains the default configurations. These can be over‐
1584 ridden by user configurations found in one of the following locations
1585 (inxi will store its config file using the following precedence: if
1586 $XDG_CONFIG_HOME is not empty, it will go there, else if
1587 $HOME/.conf/inxi.conf exists, it will go there, and as a last default,
1588 the legacy location is used), i.e.:
1589
1590 $XDG_CONFIG_HOME/inxi.conf > $HOME/.conf/inxi.conf >
1591 $HOME/.inxi/inxi.conf
1592
1593
1595 See the documentation page for more complete information on how to set
1596 these up, and for a complete list of options:
1597
1598 https://smxi.org/docs/inxi-configuration.htm
1599
1600 Basic Options
1601 Here's a brief overview of the basic options you are likely to
1602 want to use:
1603
1604 COLS_MAX_CONSOLE The max display column width on terminal.
1605
1606 COLS_MAX_IRC The max display column width on IRC clients.
1607
1608 COLS_MAX_NO_DISPLAY The max display column width in console, out
1609 of GUI desktop.
1610
1611 CPU_SLEEP Decimal value 0 or more. Default is usually around
1612 0.35 seconds. Time that inxi will 'sleep' before getting CPU
1613 speed data, so that it reflects actual system state.
1614
1615 DOWNLOADER Sets default inxi downloader: curl, fetch, ftp, perl,
1616 wget. See --recommends output for more information on download‐
1617 ers and Perl downloaders.
1618
1619 FILTER_STRING Default <filter>. Any string you prefer to see
1620 instead for filtered values.
1621
1622 INDENT_MIN The point where the line starter wrapping to its own
1623 line happens. Overrides default. See --indent-min. If 80 or
1624 less, wrap will never happen.
1625
1626 LIMIT Overrides default of 10 IP addresses per IF. This is only
1627 of interest to sys admins running servers with many IP
1628 addresses.
1629
1630 NO_DIG Set to 1 or true to disable WAN IP use of dig and force
1631 use of alternate downloaders.
1632
1633 NO_SUDO Set to 1 or true to disable internal use of sudo.
1634
1635 PARTITION_SORT Overrides default partition output sort. See
1636 --partition-sort for options.
1637
1638 PS_COUNT The default number of items showing per -t type, m or
1639 c. Default is 5.
1640
1641 SENSORS_CPU_NO In cases of ambiguous temp1/temp2 (inxi can't
1642 figure out which is the CPU), forces sensors to use either
1643 value 1 or 2 as CPU temperature. See the above configuration
1644 page on smxi.org for full info.
1645
1646 SEP2_CONSOLE Replaces default key / value separator of ':'.
1647
1648 USB_SYS Forces all USB data to use /sys instead of lsusb.
1649
1650 WAN_IP_URL Forces -i to use supplied URL, and to not use dig
1651 (dig is generally much faster). URL must begin with http or ftp.
1652 Note that if you use this, the downloader set tests will run
1653 each time you start inxi whether a downloader feature is going
1654 to be used or not.
1655
1656 The IP address from the URL must be the last item on the last
1657 (non-empty) line of the URL's page content source code.
1658
1659 Same as --wan-ip-url [URL]
1660
1661 WEATHER_SOURCE Values: [0-9]. Same as --weather-source. Values
1662 4-9 are not currently supported, but this can change at any
1663 time.
1664
1665 WEATHER_UNIT Values: [c|f|cf|fc]. Same as --weather-unit.
1666
1667
1668 Color Options
1669 It's best to use the -c [94-99] color selector tool to set the
1670 following values because it will correctly update the configura‐
1671 tion file and remove any invalid or conflicting items, but if
1672 you prefer to create your own configuration files, here are the
1673 options. All take the integer value from the options available
1674 in -c 94-99.
1675
1676 NOTE: All default and configuration file set color values are
1677 removed when output is piped or redirected. You must use the
1678 explicit -c <color number> option if you want colors to be
1679 present in the piped/redirected output (creating a PDF for exam‐
1680 ple).
1681
1682 CONSOLE_COLOR_SCHEME The color scheme for console output (not in
1683 X/Wayland).
1684
1685 GLOBAL_COLOR_SCHEME Overrides all other color schemes.
1686
1687 IRC_COLOR_SCHEME Desktop X/Wayland IRC CLI color scheme.
1688
1689 IRC_CONS_COLOR_SCHEME Out of X/Wayland, IRC CLI color scheme.
1690
1691 IRC_X_TERM_COLOR_SCHEME In X/Wayland IRC client terminal color
1692 scheme.
1693
1694 VIRT_TERM_COLOR_SCHEME Color scheme for virtual terminal output
1695 (in X/Wayland).
1696
1697
1699 Please report bugs using the following resources.
1700
1701 You may be asked to run the inxi debugger tool (see --debug 21/22),
1702 which will upload a data dump of system files for use in debugging
1703 inxi. These data dumps are very important since they provide us with
1704 all the real system data inxi uses to parse out its report.
1705
1706 Issue Report
1707 File an issue report: https://github.com/smxi/inxi/issues
1708
1709 Developer Forums
1710 Post on inxi developer forums: https://techpat‐
1711 terns.com/forums/forum-32.html
1712
1713 IRC irc.oftc.net#smxi
1714 You can also visit irc.oftc.net channel: #smxi to post issues.
1715
1716
1718 https://github.com/smxi/inxi
1719
1720 https://smxi.org/docs/inxi.htm
1721
1722
1724 inxi is a fork of locsmif's very clever infobash script.
1725
1726 Original infobash author and copyright holder: Copyright (C) 2005-2007
1727 Michiel de Boer aka locsmif
1728
1729 inxi version: Copyright (C) 2008-20 Harald Hope
1730
1731 This man page was originally created by Gordon Spencer (aka aus9) and
1732 is maintained by Harald Hope (aka h2 or TechAdmin).
1733
1734 Initial CPU logic, konversation version logic, occasional maintenance
1735 fixes, and the initial xiin.py tool for /sys parsing (obsolete, but
1736 still very much appreciated for all the valuable debugger data it
1737 helped generate): Scott Rogers
1738
1739 Further fixes (listed as known):
1740
1741 Horst Tritremmel <hjt at sidux.com>
1742
1743 Steven Barrett (aka: damentz) - USB audio patch; swap percent used
1744 patch.
1745
1746 Jarett.Stevens - dmidecode -M patch for older systems with no /sys.
1747
1748
1750 The nice people at irc.oftc.net channels #linux-smokers-club and #smxi,
1751 who all really have to be considered to be co-developers because of
1752 their non-stop enthusiasm and willingness to provide real-time testing
1753 and debugging of inxi development.
1754
1755 Siduction forum members, who have helped get some features working by
1756 providing a large number of datasets that have revealed possible varia‐
1757 tions, particularly for the RAM -m option.
1758
1759 AntiX users and admins, who have helped greatly with testing and debug‐
1760 ging, particularly for the 3.0.0 release.
1761
1762 ArcherSeven (Max), Brett Bohnenkamper (aka KittyKatt), and Iotaka, who
1763 always manage to find the weirdest or most extreme hardware and setups
1764 that help make inxi much more robust.
1765
1766 For the vastly underrated skill of output error/glitch catching, Pete
1767 Haddow. His patience and focus in going through inxi repeatedly to find
1768 errors and inconsistencies is much appreciated.
1769
1770 All the inxi package maintainers, distro support people, forum modera‐
1771 tors, and in particular, sys admins with their particular issues, which
1772 almost always help make inxi better, and any others who contribute
1773 ideas, suggestions, and patches.
1774
1775 Without a wide range of diverse Linux kernel-based Free Desktop systems
1776 to test on, we could never have gotten inxi to be as reliable and solid
1777 as it's turning out to be.
1778
1779 And of course, a big thanks to locsmif, who figured out a lot of the
1780 core methods, logic, and tricks originally used in inxi Gawk/Bash.
1781
1782
1783
1784inxi 2020-04-22 INXI(1)