1INXI(1)                           inxi manual                          INXI(1)
2
3
4

NAME

6       inxi  - Command line system information script for console and IRC
7
8

SYNOPSIS

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

DESCRIPTION

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

PRIVACY AND SECURITY

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

USING OPTIONS

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

STANDARD OPTIONS

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

EXTRA DATA OPTIONS

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

ADMIN EXTRA DATA OPTIONS

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

ADVANCED OPTIONS

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

DEBUGGING OPTIONS

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

DEBUGGING OPTIONS TO DEBUG DEBUGGER FAILURES

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

SUPPORTED IRC CLIENTS

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

RUNNING IN IRC CLIENT

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

CONFIGURATION FILE

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

CONFIGURATION OPTIONS

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

BUGS

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

HOMEPAGE

1718       https://github.com/smxi/inxi
1719
1720       https://smxi.org/docs/inxi.htm
1721
1722

AUTHOR AND CONTRIBUTORS TO CODE

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

SPECIAL THANKS TO THE FOLLOWING

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)
Impressum