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

NAME

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

SYNOPSIS

9       inxi
10
11       inxi [-AbBCdDfFGhiIlmMnNopPrRsSuUVwzZ]
12
13       inxi  [-c  NUMBER]  [-t  [c|m|cm|mc][NUMBER]] [-v NUMBER] [-W LOCATION]
14       [--weather-unit {m|i|mi|im}] [-y WIDTH] inxi [--memory-modules] [--mem‐
15       ory-short] [--recommends] [--slots] [--usb]
16
17       inxi [-x|-xx|-xxx|-a|--admin] -OPTION(s)
18
19       All  options  have  long  form  variants - see below for these and more
20       advanced options.
21
22

DESCRIPTION

24       inxi is a command line system information script built for console  and
25       IRC.  It  is  also used a debugging tool for forum technical support to
26       quickly ascertain users' system configurations and hardware. inxi shows
27       system  hardware,  CPU, drivers, Xorg, Desktop, Kernel, gcc version(s),
28       Processes, RAM usage, and a wide variety of other useful information.
29
30       inxi output varies depending on whether it is being used on CLI or IRC,
31       with  some  default filters and color options applied only for IRC use.
32       Script colors can be turned off if desired with -c 0, or changed  using
33       the -c color options listed in the STANDARD OPTIONS section below.
34
35

PRIVACY AND SECURITY

37       In order to maintain basic privacy and security, inxi used on IRC auto‐
38       matically filters out your network device MAC address, WAN and LAN  IP,
39       your /home username directory in partitions, and a few other items.
40
41       Because  inxi is often used on forums for support, you can also trigger
42       this filtering with the -z option (-Fz, for example). To  override  the
43       IRC  filter, you can use the -Z option. This can be useful in debugging
44       network connection issues online in a private chat, for example.
45
46

USING OPTIONS

48       Options can be combined if they do not conflict. You can  either  group
49       the letters together or separate them.
50
51       Letters  with  numbers  can  have  no  gap or a gap at your discretion,
52       except when using  -t.
53
54       For example: inxi -AG or inxi -A -G or inxi -c10
55
56       Note that all the short form options have long form equivalents,  which
57       are  listed  below. However, usually the short form is used in examples
58       in order to keep things simple.
59
60

STANDARD OPTIONS

62       -A, --audio
63              Show Audio/sound card(s) information, including card driver.
64
65       -b, --basic
66              Show basic output, short form. Same as: inxi -v 2
67
68       -B, --battery
69              Show system battery (ID-x) data, charge, condition,  plus  extra
70              information (if battery present). Uses /sys or, for BSDs without
71              systctl battery data, dmidecode. dmidecode does  not  have  very
72              much    information,    and    none    about   current   battery
73              state/charge/voltage. Supports  multiple  batteries  when  using
74              /sys data.
75
76              Note  that  for  charge, the output shows the current charge, as
77              well as its value as a percentage  of  the  available  capacity,
78              which can be less than the original design capacity. In the fol‐
79              lowing example, the actual current  available  capacity  of  the
80              battery is 22.2 Wh.
81
82              charge: 20.1 Wh 95.4%
83
84              The  condition  item  shows  the  remaining available capacity /
85              original design capacity, and then this figure as  a  percentage
86              of original capacity available in the battery.
87
88              condition: 22.2/36.4 Wh (61%)
89
90              With  -x  shows  attached Device-x information (mouse, keyboard,
91              etc.)  if they are battery powered.
92
93
94       -c, --color [0-42]
95              Set color scheme. If no scheme number is supplied, 0 is assumed.
96
97
98       -c [94-99]
99
100              These color selectors run a color selector option  prior to inxi
101              starting which lets you set the config file value for the selec‐
102              tion.
103
104              NOTE: All configuration file set color values are  removed  when
105              output is piped or redirected. You must use the explicit runtime
106              -c <color number> option if you want color codes to  be  present
107              in the piped/redirected output.
108
109              Color selectors for each type display (NOTE: IRC and global only
110              show safe color set):
111
112       -c 94  - Console, out of X.
113
114       -c 95  - Terminal, running in X - like xTerm.
115
116       -c 96  - GUI IRC, running in X - like XChat, Quassel, Konversation etc.
117
118       -c 97  - Console IRC running in X - like irssi in xTerm.
119
120       -c 98  - Console IRC not in  X.
121
122       -c 99  - Global - Overrides/removes all settings.
123
124              Setting a specific color type removes the  global  color  selec‐
125              tion.
126
127       -C, --cpu
128              Show  full CPU output, including per CPU clock speed and CPU max
129              speed (if available).  If max speed data present, shows (max) in
130              short output formats (inxi, inxi -b) if actual CPU speed matches
131              max CPU speed. If max CPU speed does not match actual CPU speed,
132              shows  both  actual  and max speed information.  See -x for more
133              options.
134
135              For certain CPUs (some ARM, and AMD Zen family)  shows  CPU  die
136              count.
137
138              The  details  for  each CPU include a technical description e.g.
139              type: MT MCP
140
141              * MT - Multi/Hyper Threaded CPU, more than  1  thread  per  core
142              (previously HT).
143
144              * MCM - Multi Chip Model (more than 1 die per CPU).
145
146              * MCP - Multi Core Processor (more than 1 core per CPU).
147
148              * SMP - Symmetric Multi Processing (more than 1 physical CPU).
149
150              * UP - Uni (single core) Processor.
151
152
153       -d, --disk-full,--optical
154              Show  optical drive data as well as -D hard drive data. With -x,
155              adds a feature line to the output. Also shows  floppy  disks  if
156              present.  Note  that there is no current way to get any informa‐
157              tion about the floppy device that I am aware of, so it will sim‐
158              ply  show  the  floppy ID without any extra data. -xx adds a few
159              more features.
160
161       -D, --disk
162              Show Hard Disk info. Shows total disk space and used percentage.
163              The  disk  used  percentage  includes  space used by swap parti‐
164              tion(s), since those are not usable for data storage. Note  that
165              with RAID disks, the percentage will be wrong since the total is
166              computed from the disk sizes, but used is computed from  mounted
167              partition  used percentages. This small defect may get corrected
168              in the future.  Also, unmounted partitions are  not  counted  in
169              disk  use  percentages  since  inxi  has  no  access to the used
170              amount.
171
172              Also shows per disk information: Disk  ID,  type  (if  present),
173              vendor  (if  detected),  model, and size. See Extra Data Options
174              for more features.
175
176       -f, --flags
177              Show all CPU flags used, not just the short list. Not shown with
178              -F in order to avoid spamming. ARM CPUs: show features items.
179
180       -F, --full
181              Show  Full output for inxi. Includes all Upper Case line letters
182              except -W, plus -s and -n. Does not show extra  verbose  options
183              such  as  -d  -f -i -l -m -o -p -r -t -u -x unless you use those
184              arguments in the command, e.g.: inxi -Frmxx
185
186       -G, --graphics
187              Show Graphic card(s) information, including details of card  and
188              card  driver,  display  protocol  (if available), display server
189              (vendor and version number), e.g.:
190
191              Display: x11 server: Xorg 1.15.1
192
193              If protocol is not detected, shows:
194
195              Display: server: Xorg 1.15.1
196
197              Also shows screen resolution(s), OpenGL  renderer,  OpenGL  core
198              profile version/OpenGL version.
199
200              Compositor information will show if detected using -xx option.
201
202       -h, --help
203              The help menu. Features dynamic sizing to fit into terminal win‐
204              dow. Set script global COLS_MAX_CONSOLE if you want a  different
205              default  value,  or  use  -y <width> to temporarily override the
206              defaults or actual window width.
207
208       -i, --ip
209              Show WAN IP address and local interfaces (latter requires ifcon‐
210              fig or ip network tool), as well as network output from -n.  Not
211              shown with -F for user security  reasons.  You  shouldn't  paste
212              your local/WAN IP. Shows both IPv4 and IPv6 link IP addresses.
213
214
215       -I, --info
216              Show  Information:  processes,  uptime,  memory,  IRC client (or
217              shell type if run in shell, not IRC), inxi version. See  -x  and
218              -xx for extra information (init type/version, runlevel).
219
220              Note:  if  -m is used or triggered, the memory item will show in
221              the main Memory: report of -m, not in Info:.
222
223              Rasberry Pi only: uses vcgencmd  get_mem  gpu  to  get  gpu  RAM
224              amount,  if  user  is  in video group and vcgencmd is installed.
225              Uses this result  to  increase  the  Memory:  amount  and  used:
226              amounts.
227
228       -l, --label
229              Show  partition labels. Default: main partitions -P. For full -p
230              output, use: -pl.
231
232       -m, --memory
233              Memory (RAM) data. Does not display with  -b or  -F  unless  you
234              use  -m explicitly. Ordered by system board physical system mem‐
235              ory array(s) (Array-[number]),  and  individual  memory  devices
236              (Device-[number]).  Physical  memory  array   data  shows  array
237              capacity, number of  devices  supported,  and  Error  Correction
238              information. Devices shows locator data (highly variable in syn‐
239              tax), size, speed, type (eg: type: DDR3).
240
241              Note: -m uses dmidecode, which must be run  as  root  (or  start
242              inxi  with  sudo),  unless  you figure out how to set up sudo to
243              permit dmidecode to read /dev/mem as user. speed and  bus  width
244              will not show if No Module Installed is found in size.
245
246              Note:  If  -m  is triggered RAM total/used report will appear in
247              this section, not in -I or -tm items.
248
249              Because dmidecode data is extremely unreliable, inxi will try to
250              make  best  guesses.  If you see (check) after the capacity num‐
251              ber, you should check  it  with  the  specifications.  (est)  is
252              slightly  more  reliable,  but  you  should still check the real
253              specifications before buying RAM. Unfortunately there is nothing
254              inxi  can  do  to  get truly reliable data about the system RAM;
255              maybe one day the kernel devs will put this data into /sys,  and
256              make  it  real data, taken from the actual system, not dmi data.
257              For most people, the data will be right, but a significant  per‐
258              centage  of  users  will have either a wrong max module size, if
259              present, or max capacity.
260
261              See --memory-modules and --memory-short if you  want  a  shorter
262              report.
263
264       --memory-modules
265              Memory  (RAM)  data.  Show only RAM arrays and modules in Memory
266              report.  Skip empty slots. See -m.
267
268       --memory-short
269              Memory (RAM) data. Show a one line RAM report  in  Memory,  e.g.
270              Report: arrays: 1 slots: 4 modules: 2 type: DDR4 See -m.
271
272       -M, --machine
273              Show  machine  data.  Device, Motherboard, BIOS, and if present,
274              System Builder (Like Lenovo).  Older systems/kernels without the
275              required  /sys  data  can use dmidecode instead, run as root. If
276              using dmidecode, may also show BIOS/UEFI  revision  as  well  as
277              version.   --dmidecode  forces  use of dmidecode data instead of
278              /sys.  Will also attempt to show if the  system  was  booted  by
279              BIOS,  UEFI, or UEFI [Legacy], the latter being legacy BIOS boot
280              mode in a system board using UEFI.
281
282              Device information requires either /sys or dmidecode. Note  that
283              'other-vm?'   is  a  type that means it's usually a VM, but inxi
284              failed to detect which type, or positively confirm which  VM  it
285              is.  Primary  VM  identification  is via systemd-detect-virt but
286              fallback tests that should also support some BSDs are used. Less
287              commonly  used  or  harder  to  detect  VMs may not be correctly
288              detected. If you get an incorrect  output,  post  an  issue  and
289              we'll get it fixed if possible.
290
291              Due  to  unreliable vendor data, device type will show: desktop,
292              laptop, notebook, server, blade, plus some  obscure  stuff  that
293              inxi is unlikely to ever run on.
294
295       -n, --network-advanced
296              Show  Advanced Network card information in addition to that pro‐
297              duced by -N.  Shows interface, speed, MAC ID, state, etc.
298
299       -N, --network
300              Show Network card(s) information, including  card  driver.  With
301              -x, shows PCI BusID, Port number.
302
303       -o, --unmounted
304              Show unmounted partition information (includes UUID and LABEL if
305              available).  Shows file system type if you have lsblk  installed
306              (Linux  only). For BSD/GNU Linux: shows file system type if file
307              is installed, and if you are  root  or  if  you  have  added  to
308              /etc/sudoers (sudo v. 1.7 or newer):
309
310              <username> ALL = NOPASSWD: /usr/bin/file (sample)
311
312              Does  not  show  components  (partitions that create the md-raid
313              array) of md-raid arrays.
314
315       -p, --partitions-full
316              Show full Partition information  (-P  plus  all  other  detected
317              mounted partitions).
318
319       -P, --partitions
320              Show  basic  Partition information.  Shows, if detected: / /boot
321              /home /opt /tmp /usr /usr/home /var /var/tmp /var/log.   Use  -p
322              to see all mounted partitions.
323
324       -r, --repos
325              Show distro repository data. Currently supported repo types:
326
327              APK (Alpine Linux + derived versions)
328
329              APT (Debian, Ubuntu + derived versions, as well as RPM based APT
330              distros like PCLinuxOS or Alt-Linux)
331
332              CARDS (NuTyX + derived versions)
333
334              EOPKG (Solus)
335
336              PACMAN (Arch Linux, KaOS + derived versions)
337
338              PACMAN-G2 (Frugalware + derived versions)
339
340              PISI (Pardus + derived versions)
341
342              PORTAGE (Gentoo, Sabayon + derived versions)
343
344              PORTS (OpenBSD, FreeBSD, NetBSD + derived OS types)
345
346              SLACKPKG (Slackware + derived versions)
347
348              TCE (TinyCore)
349
350              URPMQ (Mandriva, Mageia + derived versions)
351
352              XBPS (Void)
353
354              YUM/ZYPP (Fedora, Red Hat, Suse + derived versions)
355
356              More will be added as distro data  is  collected.  If  yours  is
357              missing please show us how to get this information and we'll try
358              to add it.
359
360       -R, --raid
361              Show RAID data. Shows RAID devices, states,  levels  and  compo‐
362              nents, and extra data with -x / -xx.
363
364              md-raid:  If  device  is  resyncing,  also shows resync progress
365              line.
366
367              Note: Only md-raid and ZFS are currently supported. Other  soft‐
368              ware  RAID  types  could  be added, but only if users supply all
369              data required, and if the software RAID actually can be made  to
370              give the required output.
371
372              If  hardware  RAID  is detected, shows basic information. Due to
373              complexity of adding hardware RAID device disk /  RAID  reports,
374              those  will  only  be  added  if there is demand, and reasonable
375              reporting tools.
376
377
378       --recommends
379              Checks inxi application dependencies and recommends, as well  as
380              directories,  then  shows what package(s) you need to install to
381              add support for each feature.
382
383       -s, --sensors
384              Show output from sensors if sensors installed/configured:  Moth‐
385              erboard/CPU/GPU  temperatures; detected fan speeds. GPU tempera‐
386              ture when available. Nvidia shows  screen  number  for  multiple
387              screens. IPMI sensors are also used (root required) if present.
388
389       --slots
390              Show PCI slots with type, speed, and status information.
391
392       -S, --system
393              Show  System information: host name, kernel, desktop environment
394              (if in X), distro. With -xx show dm - or startx - (only shows if
395              present  and  running  if out of X), and if in X, with -xxx show
396              more desktop info, e.g. taskbar or panel.
397
398       -t, --processes
399              [c|m|cm|mc NUMBER] Show processes. If no arguments, defaults  to
400              cm.  If followed by a number, shows that number of processes for
401              each type (default: 5; if in IRC, max: 5)
402
403              Make sure that there is no space  between  letters  and  numbers
404              (e.g. write as -t cm10).
405
406       -t c   -  CPU only. With -x, also shows memory for that process on same
407              line.
408
409       -t m   - memory only. With -x, also shows CPU for that process on  same
410              line.   If the -I line is not triggered, will also show the sys‐
411              tem RAM used/total information.
412
413       -t cm  - CPU+memory. With -x, shows also CPU or memory for that process
414              on same line.
415
416
417       --usb  Show USB data for attached Hubs and Devices. Hubs also show num‐
418              ber of ports.  Be aware that a port is not always external, some
419              may be internal, and either used or unused (for example, a moth‐
420              erboard USB header connector that is not used).
421
422              Hubs and Devices are listed in order of BusID.
423
424              BusID    is     generally     in     this     format:     BusID-
425              port[.port][.port]:DeviceID
426
427              Device  ID  is a number created by the kernel, and has no neces‐
428              sary ordering or sequence connection, but can be used  to  match
429              this output to lsusb values, which generally shows BusID / Devi‐
430              ceID (except for tree view, which shows ports).
431
432              Examples: Device-3: 4-3.2.1:2 or Hub: 4-0:1
433
434              The rev: 2.0 item refers to the USB revision number, like 1.0 or
435              3.1.
436
437
438       -u, --uuid
439              Show  partition  UUIDs. Default: main partitions -P. For full -p
440              output, use: -pu.
441
442       -U, --update
443              Note - Maintainer may have disabled this function.
444
445              If inxi -h has no listing for -U then it's disabled.
446
447              Auto-update script. Note: if you installed as root, you must  be
448              root  to update, otherwise user is fine. Also installs / updates
449              this    man    page    to:     /usr/local/share/man/man1     (if
450              /usr/local/share/man/  exists  AND  there is no inxi man page in
451              /usr/share/man/man1, otherwise it goes to  /usr/share/man/man1).
452              This  requires  that you be root to write to that directory. See
453              --man or --no-man to force or disable man install.
454
455
456       -V, --version
457              inxi version information. Prints information then exits.
458
459       -v, --verbosity
460              Script verbosity levels. If no verbosity level number is  given,
461              0 is assumed.  Should not be used with -b or -F.
462
463              Supported levels: 0-8 Examples : inxi -v 4  or  inxi -v4
464
465       -v 0   - Short output, same as: inxi
466
467       -v 1   -  Basic  verbose, -S + basic CPU (cores, type, clock speed, and
468              min/max speeds, if available) + -G + basic Disk + -I.
469
470       -v 2   - Adds networking card (-N), Machine (-M) data, Battery (-B) (if
471              available). Same as: inxi -b
472
473       -v 3   -  Adds  advanced  CPU  (-C)  and network (-n) data; triggers -x
474              advanced data option.
475
476       -v 4   - Adds partition size/used data (-P) for (if present):  /  /home
477              /var/ /boot. Shows full disk data (-D)
478
479       -v 5   - Adds audio card (-A), memory/RAM (-m), sensors (-s), partition
480              label (-l), UUID (-u), and short form of optical drives.
481
482       -v 6   - Adds full mounted partition  data  (-p),  unmounted  partition
483              data  (-o),  optical  drive data (-d), USB (--usb); triggers -xx
484              extra data option.
485
486       -v 7   - Adds network IP data (-i); triggers -xxx
487
488       -v 8   -  All  system  data  available.  Adds  Repos  (-r),  PCI  slots
489              (--slots), processes (-tcm), admin (--admin). Useful for testing
490              output and to see what data you can get from your system.
491
492       -w, --weather
493              Adds weather line. To get weather for an alternate location, use
494              -W [location]. See also -x, -xx, -xxx options.  Please note that
495              your distribution's maintainer may chose to  disable  this  fea‐
496              ture.
497
498              DO  NOT USE THIS FEATURE FOR AUTOMATED WEATHER UPDATES! You will
499              be blocked from any further access. This feature  is  not  meant
500              for  widget  type  weather  monitoring, or Conky type use. It is
501              meant to get weather when you need to see it, for example, on  a
502              remote server.
503
504       -W, --weather-location <location_string>
505              Get  weather/time  for an alternate location. Accepts postal/zip
506              code[, country], city,state pair, or  latitude,longitude.  Note:
507              city/country/state names must not contain spaces. Replace spaces
508              with '+' sign. Don't place spaces around any commas. Postal code
509              is  not reliable except for North America and maybe the UK.  Try
510              postal codes with and without  country  code  added.  Note  that
511              City,State  applies only to USA, otherwise it's City,Country. If
512              country name (english) does not work, try  2  character  country
513              code (e.g. Spain: es; Great Britain: gb).
514
515              See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 for current
516              2 letter country codes.
517
518              Use only ASCII letters in city/state/country names.
519
520              Examples: -W 95623,us OR -W Boston,MA OR -W 45.5234,-122.6762 OR
521              -W new+york,ny OR -W bodo,norway.
522
523              DO  NOT  USE  THIS FEATURE FOR AUTOMATED WEATHER UPDATES! Use of
524              automated queries, will result in your access being blocked.  If
525              you  try  to work around the ban, you will be permanently banned
526              from this service.
527
528       --weather-source, --ws <unit>
529              [1-9] Switches weather data source. Possible values are 1-9. 1-4
530              will  generally  be active, and 5-9 may or may not be active, so
531              check.  1 may not support city / country names with spaces (even
532              if  you  use  the + sign instead of space). 2 offers pretty good
533              data, but may not have all small city names for -W.
534
535              Please note that the data sources are not static per value,  and
536              can  change  any  time,  or be removed, so always test to verify
537              which source is being used for each value if that  is  important
538              to  you.  Data  sources may be added or removed on occasions, so
539              try each one and see which you prefer. If  you  get  unsupported
540              source message, it means that number has not been implemented.
541
542       --weather-unit <unit>
543              [m|i|mi|im] Sets weather units to metric (m), imperial (i), met‐
544              ric (imperial) (mi, default), imperial (metric) (im). If  metric
545              or imperial not found,sets to default value, or N/A.
546
547       -y, --width <integer>
548              This  is  an  absolute width override which sets the output line
549              width max.  Overrides COLS_MAX_IRC /  COLS_MAX_CONSOLE  globals,
550              or  the  actual  widths of the terminal. 80 is the minimum width
551              supported.  -1 removes width limits. Example: inxi -Fxx -y 130
552
553       -z, --filter
554              Adds security filters for IP  addresses,  serial  numbers,  MAC,
555              location  (-w),  and user home directory name. On by default for
556              IRC clients.
557
558       -Z, --filter-override
559              Absolute override for output filters. Useful for debugging  net‐
560              working issues in IRC for example.
561

EXTRA DATA OPTIONS

563       These  options  can be triggered by one or more -x.  Alternatively, the
564       -v options trigger them in the following way: -v 3 adds -x; -v  6  adds
565       -xx; -v 7 adds -xxx
566
567       These  extra data triggers can be useful for getting more in-depth data
568       on various options. They can be added to any  long  form  option  list,
569       e.g.: -bxx or -Sxxx
570
571       There are 3 extra data levels:
572
573       -x, -xx, -xxx
574
575       OR
576
577       --extra 1, --extra 2, --extra 3
578
579       The  following  details show which lines / items display extra informa‐
580       tion for each extra data level.
581
582       -x -A  - Adds (if available and/or relevant) vendor: item, which  shows
583              specific vendor [product] information.
584
585              -  Adds  version/port(s)/driver  version (if available) for each
586              Audio device.
587
588              - Adds PCI Bus ID/USB ID number of each Audio device.
589
590       -x -B  - Adds vendor/model, battery status (if battery present).
591
592              - Adds attached battery powered  peripherals  (Device-[number]:)
593              if detected (keyboard, mouse, etc.).
594
595       -x -C  - Adds bogomips on CPU (if available)
596
597              -  Adds  CPU Flags (short list). Use -f to see full flag/feature
598              list.
599
600              - Adds CPU microarchitecture + revision (e.g. Sandy Bridge,  K8,
601              ARMv8, P6, etc.). Only shows data if detected. Newer microarchi‐
602              tectures will have to be added as they appear, and  require  the
603              CPU family ID and model ID.
604
605              Examples: arch: Sandy Bridge rev: 2, arch: K8 rev.F+ rev: 2
606
607       -x -d  -  Adds  more  items  to Features line of optical drive; dds rev
608              version to optical drive.
609
610       -x -D  - Adds HDD temperature  with  disk  data  if  you  have  hddtemp
611              installed,  if you are root or if you have added to /etc/sudoers
612              (sudo v. 1.7 or newer):
613
614              <username> ALL = NOPASSWD: /usr/sbin/hddtemp (sample)
615
616       -x -G  - Adds (if available and/or relevant) vendor: item, which  shows
617              specific vendor [product] information.
618
619              - Adds direct rendering status.
620
621              - Adds (for single GPU, nvidia driver) screen number that GPU is
622              running on.
623
624              - Adds PCI Bus ID/USB ID number of each Graphics card.
625
626       -x -i  - Adds IP v6 additional scope data, like Global, Site, Temporary
627              for each interface.
628
629              Note that there is no way I am aware of to filter out the depre‐
630              cated IP v6 scope site/global temporary addresses from the  out‐
631              put of ifconfig. The ip tool shows that clearly.
632
633              ip-v6-temporary - (ip tool only), scope global temporary.  Scope
634              global temporary deprecated is not shown
635
636              ip-v6-global - scope global (ifconfig will  show  this  for  all
637              types,  global,  global  temporary,  and global temporary depre‐
638              cated, ip shows it only for global)
639
640              ip-v6-link - scope link (ip/ifconfig) - default for -i.
641
642              ip-v6-site - scope site (ip/ifconfig). This has been  deprecated
643              in  IPv6, but still exists. ifconfig may show multiple site val‐
644              ues, as with global temporary, and global temporary deprecated.
645
646              ip-v6-unknown - unknown scope
647
648
649       -x -I  - Adds current init system (and init  rc  in  some  cases,  like
650              OpenRC).  With -xx, shows init/rc version number, if available.
651
652              -  Adds  default system gcc. With -xx, also show other installed
653              gcc versions.
654
655              - Adds current runlevel (not available with all init systems).
656
657              - If in shell (i.e. not in IRC client), adds shell version  num‐
658              ber, if available.
659
660       -x -m, --memory-modules
661              -  If  present,  adds  maximum  memory module/device size in the
662              Array line.  Only some systems will have  this  data  available.
663              Shows estimate if it can generate one.
664
665              - Adds device type in the Device line.
666
667       -x -N  -  Adds (if available and/or relevant) vendor: item, which shows
668              specific vendor [product] information.
669
670              - Adds version/port(s)/driver version (if  available)  for  each
671              Network card;
672
673              - Adds PCI Bus ID/USB ID number of each Network card.
674
675       -x -R  -  md-raid:  Adds second RAID Info line with extra data: blocks,
676              chunk size, bitmap  (if  present).  Resync  line,  shows  blocks
677              synced/total blocks.
678
679              - Hardware RAID: Adds driver version, bus ID.
680
681       -x -s  -  Adds basic voltages: 12v, 5v, 3.3v, vbat (ipmi, lm-sensors if
682              present).
683
684       -x -S  - Adds Kernel gcc version.
685
686              - Adds to Distro: base: if detected. System base  will  only  be
687              seen  on  a  subset  of  distributions.  The distro must be both
688              derived from a  parent  distro  (e.g.  Mint  from  Ubuntu),  and
689              explicitly  added  to  the supported distributions for this fea‐
690              ture. Due to  the  complexity  of  distribution  identification,
691              these  will  only be added as relatively solid methods are found
692              for each distribution system base detection.
693
694       -x -t  - Adds memory use output to CPU (-xt c), and CPU use  to  memory
695              (-xt m).
696
697       -x --usb
698              - For Devices, adds driver(s).
699
700       -x -w, -W
701              - Adds humidity and barometric pressure.
702
703              - Adds wind speed and direction.
704
705       -xx -A - Adds vendor:product ID for each Audio device.
706
707       -xx -B -  Adds  serial  number, voltage (if available). Note that volts
708              shows the data (if available)  as  the  voltage  now  /  minimum
709              design voltage.
710
711       -xx -C - Adds L1 cache: and L3 cache: if either are available. Requires
712              dmidecode and sudo/root.
713
714       -xx -D - Adds disk serial number.
715
716              - Adds disk speed (if available). This is  the  theoretical  top
717              speed of the device as reported. This speed may be restricted by
718              system board limits, eg.  a SATA 3 drive on a SATA 2  board  may
719              report  SATA  2  speeds,  but this is not completely consistent,
720              sometimes a SATA 3 device on a SATA 2 board reports  its  design
721              speed.
722
723              NVMe drives: adds lanes, and (per direction) speed is calculated
724              with lane speed * lanes * PCIe overhead. PCIe 1 and 2 have  data
725              rates  of GT/s * .8  = Gb/s (10 bits required to transfer 8 bits
726              of data).  PCIe 3 and greater transfer data at a rate of GT/s  *
727              128/130  *  lanes = Gb/s (130 bits required to transfer 128 bits
728              of data).
729
730              For a PCIe 3 NVMe drive, with speed of 8 GT/s and 4 lanes (8GT/s
731              * 128/130 * 4 = 31.6 Gb/s):
732
733              speed: 31.6 Gb/s lanes: 4
734
735       -xx -G - Adds vendor:product ID of each Graphics card.
736
737              - Adds compositor, if found (experimental).
738
739              -  For free drivers, adds OpenGL compatibility version number if
740              available.  For nonfree drivers, the core version  and  compati‐
741              bility versions are usually the same. Example:
742
743              v: 3.3 Mesa 11.2.0 compat-v: 3.0
744
745              -  If  available,  shows  alternate:  Xorg drivers. This means a
746              driver on the default list of drivers Xorg automatically  checks
747              for  the  card,  but which is not installed. For example, if you
748              have nouveau driver, nvidia would show as alternate  if  it  was
749              not  installed.  Note  that  alternate: does NOT mean you should
750              have it, it's just one of the drivers Xorg checks to see  if  is
751              present and loaded when checking the card. This can let you know
752              there are other driver options.  Note that if you  have  explic‐
753              itly  set  the  driver  in  xorg.conf, Xorg will not create this
754              automatic check driver list.
755
756
757       -xx -I - Adds init type version number (and rc if present).
758
759              - Adds other detected installed gcc versions (if present).
760
761              - Adds system  default  runlevel,  if  detected.  Supports  Sys‐
762              temd/Upstart/SysVinit type defaults.
763
764              -  Adds  parent  program (or tty) that started shell, if not IRC
765              client.
766
767       -xx -m, --memory-modules
768              - Adds memory device Manufacturer.
769
770              - Adds  memory device Part Number (part-no:). Useful for  order‐
771              ing  new  or  replacement  memory  sticks  etc. Part numbers are
772              unique, particularly if you use the word memory in the search as
773              well. With -xxx, also shows serial number.
774
775              -  Adds  single/double bank memory, if data is found. Note, this
776              may not be 100% right all of the time since it  depends  on  the
777              order that data is found in dmidecode output for type 6 and type
778              17.
779
780       -xx -M - Adds chassis information, if data  is  available.  Also  shows
781              BIOS ROM size if using dmidecode.
782
783       -xx -N - Adds vendor:product ID for each Network card.
784
785       -xx -R -  md-raid:  Adds  superblock  (if  present)  and  algorithm. If
786              resync, shows progress bar.
787
788              - Hardware RAID: Adds Chip vendor:product ID.
789
790       -xx -s - Adds DIMM/SOC voltages, if present (ipmi only).
791
792       -xx -S - Adds display manager (dm) type, if  present.  If  none,  shows
793              N/A.  Supports most known display managers, including gdm, gdm3,
794              idm, kdm, lightdm, lxdm, mdm, nodm, sddm, slim, tint,  wdm,  and
795              xdm.
796
797              -  Adds,  if  run  in X, window manager type (wm), if available.
798              Not all window managers are  supported.  Some  desktops  support
799              using more than one window manager, so this can be useful to see
800              what window manager is actually running.  If none  found,  shows
801              nothing.  Uses  a less accurate fallback tool wmctrl if ps tests
802              fail to find data.
803
804              - Adds desktop toolkit (tk), if available (Xfce/KDE/Trinity).
805
806       -xx --slots
807              - Adds slot length.
808
809       -xx --usb
810              - Adds vendor:chip id.
811
812       -xx -w, -W
813              - Adds wind chill, heat index, and dew point, if available.
814
815              - Adds cloud cover, rain, snow, or precipitation (amount in pre‐
816              vious hour to observation time), if available.
817
818       -xxx -A
819              - Adds, if present, serial number.
820
821       -xxx -B
822              -  Adds  battery  chemistry  (e.g.  Li-ion), cycles (NOTE: there
823              appears to be a problem with  the  Linux  kernel  obtaining  the
824              cycle count, so this almost always shows 0. There's nothing that
825              can be done about this glitch, the data is simply not  available
826              as  of  2018-04-03),  location  (only  available  from dmidecode
827              derived output).
828
829              - Adds attached device rechargeable: [yes|no] information.
830
831       -xxx -C
832              - Adds boost: [enabled|disabled] if detected, aka turbo. Not all
833              CPUs have this feature.
834
835       -xxx -D
836              - Adds disk firmware revision number (if available).
837
838              -  Adds disk partition scheme (in most cases), e.g. scheme: GPT.
839              Currently not able to detect all schemes, but handles  the  most
840              common, e.g. GPT or MBR.
841
842              -  Adds  disk  rotation  speed (in some but not all cases), e.g.
843              rotation: 7200 rpm.  Only appears if detected (SSD drives do not
844              have  rotation  speeds,  for  example).  If  none found, nothing
845              shows. Not all disks report this speed,  so  even  if  they  are
846              spinnning, no data will show.
847
848       -xxx -G
849              - Adds (if available) compositor: version v:.
850
851       -xxx -I
852              - For Shell: adds (su|sudo|login) to shell name if present.
853
854              -  For  running in: adds (SSH) to parent, if present. SSH detec‐
855              tion uses the who am i test.
856
857       -xxx -m, --memory-modules
858              - Adds memory bus width: primary  bus  width,  and  if  present,
859              total width. e.g.  bus width: 64 bit (total: 72 bits). Note that
860              total / data widths are mixed up sometimes in dmidecode  output,
861              so  inxi  will take the larger value as the total if present. If
862              no total width data is found, then inxi will not show that item.
863
864              - Adds device Type Detail, e.g. detail: DDR3 (Synchronous).
865
866              - Adds, if present, memory module  voltage.  Only  some  systems
867              will have this data available.
868
869              - Adds device serial number.
870
871       -xxx -N
872              - Adds, if present, serial number.
873
874       -xxx -R
875              -  md-raid:  Adds  system  mdraid support types (kernel support,
876              read ahead, RAID events)
877
878              - zfs-raid: Adds portion allocated (used) by RAID array/device.
879
880              - Hardware RAID: Adds rev, ports, and (if available and/or rele‐
881              vant) vendor: item, which shows specific vendor [product] infor‐
882              mation.
883
884       -xxx -S
885              - Adds, if in X, or with  --display,  bar/dock/panel/tray  items
886              (info).  If  none  found,  shows nothing. Supports desktop items
887              like  gnome-panel,  lxpanel,  xfce4-panel,  lxqt-panel,   tint2,
888              cairo-dock, trayer, and many others.
889
890              - Adds (if present), window manager (wm) version number.
891
892              - Adds (if present), display manager (dm) version number.
893
894       -xxx --usb
895              - Adds, if present, serial number for non hub devices.
896
897              - Adds interfaces: for non hub devices.
898
899              - Adds, if available, USB speed in Mbits/s or Gbits/s.
900
901       -xxx -w, -W
902              -  Adds  location (city state country), observation altitude (if
903              available), weather observation time (if available), sunset/sun‐
904              rise (if available).
905
906

ADMIN EXTRA DATA OPTIONS

908       These  options  are  triggered  with  --admin  or -a. Admin options are
909       advanced output options, and are more technical, and mostly of interest
910       to  system  administrators or other machine admins.  The --admin option
911       only has to be used once, and will trigger the following features.
912
913       -a -C  - Adds CPU family, model-id, and stepping (replaces rev of -Cx).
914              Format  is  hexadecimal  (decimal)  if greater than 9, otherwise
915              hexadecimal.
916
917              - Adds CPU microcode. Format is hexadecimal.
918
919              - Adds CPU Vulnerabilities (bugs) as known by your current  ker‐
920              nel.  Lists  by  Type: ... (status|mitigation): .... for systems
921              that support this  feature  (Linux  kernel  4.14  or  newer,  or
922              patched older kernels).
923
924
925       -a -d,-a -D
926              - Adds logical and physical block size in bytes.
927
928
929       -a -p,-a -P
930              -  Adds raw partition size, including file system overhead, par‐
931              tition table, e.g.
932
933              raw size: 60.00 GiB.
934
935              - Adds percent of raw size available to size: item, e.g.
936
937              size: 58.81 GiB (98.01%).
938
939              Note that used: 16.44 GiB (34.3%) percent refers to  the  avail‐
940              able size, not the raw size.
941
942              -  Adds  partition filesystem block size if found (requires root
943              and blockdev).
944
945              - For swap, adds swappiness and vfs cache pressure, and  a  mes‐
946              sage  to indicate if it is the default value or not (Linux only,
947              and only if available). If not, shows  default  value  as  well,
948              e.g.
949
950              swappiness: 60 (default) cache pressure: 90 (default 100).
951
952
953       -a -S  -  Adds  kernel boot parameters to Kernel section (if detected).
954              Support varies by OS type.
955
956

ADVANCED OPTIONS

958       --alt 40
959              Bypass  Perl  as  a  downloader  option.   Priority   is:   Perl
960              (HTTP::Tiny), Curl, Wget, Fetch, (OpenBSD only) ftp.
961
962
963       --alt 41
964              Bypass   Curl   as   a  downloader  option.  Priority  is:  Perl
965              (HTTP::Tiny), Curl, Wget, Fetch, (OpenBSD only) ftp.
966
967
968       --alt 42
969              Bypass  Fetch  as  a  downloader  option.  Priority   is:   Perl
970              (HTTP::Tiny), Curl, Wget, Fetch, (OpenBSD only) ftp.
971
972
973       --alt 43
974              Bypass   Wget   as   a  downloader  option.  Priority  is:  Perl
975              (HTTP::Tiny), Curl, Wget, Fetch, OpenBSD only: ftp
976
977
978       --alt 44
979              Bypass Curl, Fetch, and Wget as downloader options.  This  basi‐
980              cally   forces   the   downloader  selection  to  use  Perl  5.x
981              HTTP::Tiny, which is generally slower than Curl or Wget  but  it
982              may help bypass issues with downloading.
983
984
985       --display [:<integer>]
986              Will  try to get display data out of X (does not usually work as
987              root user).  Default gets display info from display :0.  If  you
988              use  the format --display :1 then it would get it from display 1
989              instead, or any display you specify.
990
991              Note that in some cases, --display will cause inxi to hang  end‐
992              lessly  when  running the option in console with Intel graphics.
993              The situation regarding other free drivers such  as  nouveau/ATI
994              is  currently  unknown.  It  may  be that this is a bug with the
995              Intel graphics driver - more information is required.
996
997              You can test this easily by running the following command out of
998              X/display server: glxinfo -display :0
999
1000              If it hangs, --display will not work.
1001
1002
1003       --dmidecode
1004              Force  use  of  dmidecode.  This will override /sys data in some
1005              lines, e.g. -M or -B.
1006
1007
1008       --downloader [curl|fetch|perl|wget]
1009              Force inxi to use Curl, Fetch, Perl, or Wget for downloads.
1010
1011
1012       --host Turns on hostname in System line.  Overrides  inxi  config  file
1013              value (if set):
1014
1015              SHOW_HOST='false'
1016
1017
1018       --indent-min [integer]
1019              Overrides  default  indent minimum value. This is the value that
1020              makes inxi change from wrapped line starters [like Info] to  non
1021              wrapped.  If  less  than  80,  no wrapping will occur. Overrides
1022              internal default value and user configuration value:
1023
1024              INDENT_MIN=85
1025
1026
1027       --limit [-1 - x]
1028              Raise or lower max output limit  of  IP  addresses  for  -i.  -1
1029              removes limit.
1030
1031
1032       --man  Updates  /  installs man page with -U if pinxi or using -U 3 dev
1033              branch.  (Only active if -U is is not disabled by maintainers).
1034
1035
1036       --no-host
1037              Turns off hostname in System line. Useful, in  combination  with
1038              -z,  for  anonymizing  inxi output for posting on forums or IRC.
1039              Same as configuration value:
1040
1041              SHOW_HOST='false'
1042
1043
1044       --no-man
1045              Disables man page install with -U for master and active develop‐
1046              ment  branches.   (Only active if -U is is not disabled by main‐
1047              tainers).
1048
1049
1050       --no-ssl
1051              Skip SSL certificate checks for all downloader actions (-U,  -w,
1052              -W,  -i).  Use if your system does not have current SSL certifi‐
1053              cate lists, or if you have problems making a connection for  any
1054              reason. Works with Wget, Curl, and Fetch only.
1055
1056
1057       --no-sudo
1058              Skips  the  use  of  sudo to run certain internal features (like
1059              hddtemp, file) with sudo. Not related  to  running  inxi  itself
1060              with sudo or super user. Some systems will register errors which
1061              will then trigger admin emails in such cases, so if you want  to
1062              disable  regular  user use of sudo (which requires configuration
1063              to setup anyway for these options)  just  use  this  option,  or
1064              NO_SUDO configuration item.
1065
1066
1067       --output [json|screen|xml]
1068              Change data output type. Requires --output-file if not screen.
1069
1070
1071       --output-file [full path to output file|print]
1072              The  given  directory  path must exist. The directory path given
1073              must exist, The print options prints to  stdout.   Required  for
1074              non-screen --output formats (json|xml).
1075
1076
1077       --partition-sort [dev-base|fs|id|label|percent-used|size|uuid|used]
1078              Change  default  sort  order of partition output. Corresponds to
1079              PARTITION_SORT configuration item. These are the available  sort
1080              options:
1081
1082              dev-base - /dev partition identifier, like /dev/sda1.  Note that
1083              it's an alphabetic sort, so sda12 is before sda2.
1084
1085              fs - Partition filesystem. Note that sorts will be somewhat ran‐
1086              dom if all filesystems are the same.
1087
1088              id - Mount point of partition (default).
1089
1090              label  -  Label of partition. If partitions have no labels, sort
1091              will be random.
1092
1093              percent-used - Percentage of partition size used.
1094
1095              size - KiB size of partition.
1096
1097              uuid - UUID of the partition.
1098
1099              used - KiB used of partition.
1100
1101
1102       --pm-type [package manager name]
1103              For distro package maintainers only, and only for non apt,  rpm,
1104              or pacman based systems.  To be used to test replacement package
1105              lists for recommends for that package manager.
1106
1107
1108       --sleep [0-x.x]
1109              Usually in decimals. Change CPU  sleep  time  for  -C  (current:
1110               .35).  Sleep is used to let the system catch up and show a more
1111              accurate CPU use. Example:
1112
1113              inxi -Cxxx --sleep 0.15
1114
1115              Overrides default internal value and user configuration value:
1116
1117              CPU_SLEEP=0.25
1118
1119
1120       --tty  Forces internal IRC flag to off. Used in unhandled  cases  where
1121              the  program running inxi may not be seen as a shell/tty, but it
1122              is not an IRC client. Put --tty first in option  list  to  avoid
1123              unexpected  errors. If you want a specific output width, use the
1124              --width option. If you want normal color codes  in  the  output,
1125              use the  -c [color ID] flag.
1126
1127              The  sign  you  need  to  use  this  is extra numbers before the
1128              key/value pairs of the output of your program.  These  are  IRC,
1129              not TTY, color codes. Please post a github issue if you find you
1130              need to use --tty (including the full -Ixxx line) so we can fig‐
1131              ure  out how to add your program to the list of whitelisted pro‐
1132              grams.
1133
1134              You can see what inxi believed started it  in  the  -Ixxx  line,
1135              Shell:  or Client: item. Please let us know what that result was
1136              so we can add it to the parent start program whitelist.
1137
1138
1139       --usb-sys
1140              Forces the USB data generator to use /sys as data source instead
1141              of lsusb.
1142
1143
1144       --usb-tool
1145              Forces the USB data generator to use lsusb as data source. Over‐
1146              rides USB_SYS in user configuration file(s).
1147
1148
1149       --wan-ip-url [URL]
1150              Force -i to use supplied URL as WAN IP source. Overrides dig  or
1151              default IP source urls. URL must start with http[s] or ftp.
1152
1153              The  IP  address  from the URL must be the last item on the last
1154              (non-empty) line of the page content source code.
1155
1156              Same as configuration value (example):
1157
1158              WAN_IP_URL='https://mysite.com/ip.php'
1159
1160
1161       --wm   Force System item wm to use  wmctrl  as  data  source,  override
1162              default ps source.
1163
1164

DEBUGGING OPTIONS

1166       --dbg 1
1167              -  Debug  downloader  failures.  Turns off silent/quiet mode for
1168              curl, wget, and fetch. Shows more downloader action information.
1169              Shows some more information for Perl downloader.
1170
1171
1172       --debug [1-3]
1173              -  On screen debugger output. Output varies depending on current
1174              needs Usually nothing changes.
1175
1176
1177       --debug 10
1178              -   Basic   logging.   Check   $XDG_DATA_HOME/inxi/inxi.log   or
1179              $HOME/.local/share/inxi/inxi.log or $HOME/.inxi/inxi.log.
1180
1181
1182       --debug 11
1183              - Full file/system info logging.
1184
1185
1186       --debug 20
1187              Creates  a tar.gz file of system data and collects the inxi out‐
1188              put in a file.
1189
1190              * tree traversal data file(s) read  from  /proc  and  /sys,  and
1191              other system data.
1192
1193              * xorg conf and log data, xrandr, xprop, xdpyinfo, glxinfo etc.
1194
1195              * data from dev, disks, partitions, etc.
1196
1197
1198       --debug 21
1199              Automatically  uploads debugger data tar.gz file to ftp.techpat‐
1200              terns.com, then removes the debug data directory, but leaves the
1201              debug  tar.gz  file.  See --ftp for uploading to alternate loca‐
1202              tions.
1203
1204
1205       --debug 22
1206              Automatically uploads debugger data tar.gz file to  ftp.techpat‐
1207              terns.com,  then removes the debug data directory and the tar.gz
1208              file.  See --ftp for uploading to alternate locations.
1209
1210
1211       --ftp [ftp.yoursite.com/incoming]
1212              For alternate ftp upload locations: Example:
1213
1214              inxi --ftp ftp.yourserver.com/incoming --debug 21
1215
1216

DEBUGGING OPTIONS TO DEBUG DEBUGGER FAILURES

1218       Only used the following in conjunction with --debug  2[012],  and  only
1219       use if you experienced a failure or hang, or were instructed to do so.
1220
1221
1222       --debug-proc
1223              Force  debugger  to parse /proc directory data when run as root.
1224              Normally this is disabled due to  unpredictable  data  in  /proc
1225              tree.
1226
1227
1228       --debug-proc-print
1229              Use this to locate file that /proc debugger hangs on.
1230
1231
1232       --debug-no-exit
1233              Skip exit on error when running debugger.
1234
1235
1236       --debug-no-proc
1237              Skip /proc debugging in case of a hang.
1238
1239
1240       --debug-no-sys
1241              Skip /sys debugging in case of a hang.
1242
1243
1244       --debug-sys
1245              Force PowerPC debugger parsing of /sys as sudo/root.
1246
1247
1248       --debug-sys-print
1249              Use this to locate file that /sys debugger hangs on.
1250
1251

SUPPORTED IRC CLIENTS

1253       BitchX,  Gaim/Pidgin, ircII, Irssi, Konversation, Kopete, KSirc, KVIrc,
1254       Weechat, and Xchat. Plus any others  that  are  capable  of  displaying
1255       either built-in or external script output.
1256
1257

RUNNING IN IRC CLIENT

1259       To  trigger inxi output in your IRC client, pick the appropriate method
1260       from the list below:
1261
1262       Hexchat, XChat, Irssi
1263              (and many other IRC clients) /exec  -o  inxi  [options]  If  you
1264              don't include the -o, only you will see the output on your local
1265              IRC client.
1266
1267       Konversation
1268              /cmd inxi [options]
1269
1270              To run inxi in Konversation as a native script if your distribu‐
1271              tion  or  inxi  package hasn't already done this for you, create
1272              this symbolic link:
1273
1274              KDE 4: ln -s /usr/local/bin/inxi  /usr/share/kde4/apps/konversa‐
1275              tion/scripts/inxi
1276
1277              KDE    5:   ln   -s   /usr/local/bin/inxi   /usr/share/konversa‐
1278              tion/scripts/inxi
1279
1280              If inxi is somewhere else, change  the  path  /usr/local/bin  to
1281              wherever it is located.
1282
1283              If  you  are  using  KDE/QT 5, then you may also need to add the
1284              following to get the Konversation /inxi command to work:
1285
1286              ln -s /usr/share/konversation /usr/share/apps/
1287
1288              Then you can start inxi directly, like this:
1289
1290              /inxi [options]
1291
1292       WeeChat
1293              NEW: /exec -o inxi [options]
1294
1295              OLD: /shell -o inxi [options]
1296
1297              Newer (2014 and later) WeeChats work pretty much the same now as
1298              other  console  IRC clients, with /exec -o inxi [options]. Newer
1299              WeeChats have dropped the -curses part of  their  program  name,
1300              i.e.: weechat instead of weechat-curses.
1301
1302

CONFIGURATION FILE

1304       inxi  will read its configuration/initialization files in the following
1305       order:
1306
1307       /etc/inxi.conf contains the default configurations. These can be  over‐
1308       ridden  by  user configurations found in one of the following locations
1309       (inxi will store its config file using  the  following  precedence:  if
1310       $XDG_CONFIG_HOME   is   not   empty,   it   will   go  there,  else  if
1311       $HOME/.conf/inxi.conf exists, it will go there, and as a last  default,
1312       the legacy location is used), i.e.:
1313
1314       $XDG_CONFIG_HOME/inxi.conf        >       $HOME/.conf/inxi.conf       >
1315       $HOME/.inxi/inxi.conf
1316
1317

CONFIGURATION OPTIONS

1319       See the documentation page for more complete information on how to  set
1320       these up, and for a complete list of options:
1321
1322       https://smxi.org/docs/inxi-configuration.htm
1323
1324       Basic Options
1325              Here's  a  brief overview of the basic options you are likely to
1326              want to use:
1327
1328              COLS_MAX_CONSOLE The max display column width on terminal.
1329
1330              COLS_MAX_IRC The max display column width on IRC clients.
1331
1332              COLS_MAX_NO_DISPLAY The max display column width in console, out
1333              of GUI desktop.
1334
1335              CPU_SLEEP  Decimal  value  0  or more. Default is usually around
1336              0.35 seconds. Time that inxi will  'sleep'  before  getting  CPU
1337              speed data, so that it reflects actual system state.
1338
1339              DOWNLOADER Sets default inxi downloader: curl, fetch, ftp, perl,
1340              wget.  See --recommends output for more information on download‐
1341              ers and Perl downloaders.
1342
1343              FILTER_STRING  Default  <filter>.  Any  string you prefer to see
1344              instead for filtered values.
1345
1346              INDENT_MIN The point where the line starter wrapping to its  own
1347              line  happens.   Overrides  default.  See --indent-min. If 80 or
1348              less, wrap will never happen.
1349
1350              LIMIT Overrides default of 10 IP addresses per IF. This is  only
1351              of   interest  to  sys  admins  running  servers  with  many  IP
1352              addresses.
1353
1354              NO_SUDO Set to 1 or true to disable internal use of sudo.
1355
1356              PARTITION_SORT Overrides  default  partition  output  sort.  See
1357              --partition-sort for options.
1358
1359              PS_COUNT  The  default number of items showing per -t type, m or
1360              c. Default is 5.
1361
1362              SENSORS_CPU_NO In cases of  ambiguous  temp1/temp2  (inxi  can't
1363              figure  out  which  is  the  CPU), forces sensors to use  either
1364              value 1 or 2 as CPU temperature.  See  the  above  configuration
1365              page on smxi.org for full info.
1366
1367              SEP2_CONSOLE Replaces default key / value separator of ':'.
1368
1369              USB_SYS Forces all USB data to use /sys instead of lsusb.
1370
1371              WAN_IP_URL  Forces  -i  to  use supplied URL, and to not use dig
1372              (dig is generally much faster). URL must begin with http or ftp.
1373              Note  that  if  you  use this, the downloader set tests will run
1374              each time you start inxi whether a downloader feature  is  going
1375              to be used or not.
1376
1377              The  IP  address  from the URL must be the last item on the last
1378              (non-empty) line of the URL's page content source code.
1379
1380              Same as --wan-ip-url [URL]
1381
1382              WEATHER_SOURCE Values: [0-9]. Same as  --weather-source.  Values
1383              4-9  are  not  currently  supported,  but this can change at any
1384              time.
1385
1386              WEATHER_UNIT Values: [c|f|cf|fc]. Same as --weather-unit.
1387
1388
1389       Color Options
1390              It's best to use the -c [94-99] color selector tool to  set  the
1391              following values because it will correctly update the configura‐
1392              tion file and remove any invalid or conflicting  items,  but  if
1393              you  prefer to create your own configuration files, here are the
1394              options. All take the integer value from the  options  available
1395              in -c 94-99.
1396
1397              NOTE:  All  default  and configuration file set color values are
1398              removed when output is piped or redirected.  You  must  use  the
1399              explicit  -c  <color  number>  option  if  you want colors to be
1400              present in the piped/redirected output (creating a PDF for exam‐
1401              ple).
1402
1403              CONSOLE_COLOR_SCHEME The color scheme for console output (not in
1404              X/Wayland).
1405
1406              GLOBAL_COLOR_SCHEME Overrides all other color schemes.
1407
1408              IRC_COLOR_SCHEME Desktop X/Wayland IRC CLI color scheme.
1409
1410              IRC_CONS_COLOR_SCHEME Out of X/Wayland, IRC CLI color scheme.
1411
1412              IRC_X_TERM_COLOR_SCHEME In X/Wayland IRC client  terminal  color
1413              scheme.
1414
1415              VIRT_TERM_COLOR_SCHEME  Color scheme for virtual terminal output
1416              (in X/Wayland).
1417
1418

BUGS

1420       Please report bugs using the following resources.
1421
1422       You may be asked to run the inxi debugger  tool  (see  --debug  21/22),
1423       which  will  upload  a  data  dump of system files for use in debugging
1424       inxi. These data dumps are very important since they  provide  us  with
1425       all the real system data inxi uses to parse out its report.
1426
1427       Issue Report
1428              File an issue report: https://github.com/smxi/inxi/issues
1429
1430       Developer Forums
1431              Post     on     inxi    developer    forums:    https://techpat
1432              terns.com/forums/forum-32.html
1433
1434       IRC irc.oftc.net#smxi
1435              You can also visit irc.oftc.net channel: #smxi to post issues.
1436
1437

HOMEPAGE

1439       https://github.com/smxi/inxi
1440
1441       https://smxi.org/docs/inxi.htm
1442
1443

AUTHOR AND CONTRIBUTORS TO CODE

1445       inxi is a fork of locsmif's very clever infobash script.
1446
1447       Original infobash author and copyright holder: Copyright (C)  2005-2007
1448       Michiel de Boer aka locsmif
1449
1450       inxi version: Copyright (C) 2008-18 Harald Hope
1451
1452       This  man  page was originally created by Gordon Spencer (aka aus9) and
1453       is maintained by Harald Hope (aka h2 or TechAdmin).
1454
1455       Initial CPU logic, konversation version logic,  occasional  maintenance
1456       fixes,  and  the  initial  xiin.py tool for /sys parsing (obsolete, but
1457       still very much appreciated for  all  the  valuable  debugger  data  it
1458       helped generate): Scott Rogers
1459
1460       Further fixes (listed as known):
1461
1462       Horst Tritremmel <hjt at sidux.com>
1463
1464       Steven  Barrett  (aka:  damentz)  -  USB audio patch; swap percent used
1465       patch.
1466
1467       Jarett.Stevens - dmidecode -M patch for older systems with no /sys.
1468
1469

SPECIAL THANKS TO THE FOLLOWING

1471       The nice people at irc.oftc.net channels #linux-smokers-club and #smxi,
1472       who   all  really  have to be considered to be co-developers because of
1473       their non-stop enthusiasm and willingness to provide real-time  testing
1474       and debugging of inxi development.
1475
1476       Siduction  forum  members, who have helped get some features working by
1477       providing a large number of datasets that have revealed possible varia‐
1478       tions, particularly for the RAM -m option.
1479
1480       AntiX users and admins, who have helped greatly with testing and debug‐
1481       ging, particularly for the 3.0.0 release.
1482
1483       ArcherSeven (Max), Brett Bohnenkamper (aka KittyKatt), and Iotaka,  who
1484       always  manage to find the weirdest or most extreme hardware and setups
1485       that help make inxi much more robust.
1486
1487       For the vastly underrated skill of output error/glitch  catching,  Pete
1488       Haddow. His patience and focus in going through inxi repeatedly to find
1489       errors and inconsistencies is much appreciated.
1490
1491       All the inxi package maintainers, distro support people, forum  modera‐
1492       tors, and in particular, sys admins with their particular issues, which
1493       almost always help make inxi better,  and  any  others  who  contribute
1494       ideas, suggestions, and patches.
1495
1496       Without a wide range of diverse Linux kernel-based Free Desktop systems
1497       to test on, we could never have gotten inxi to be as reliable and solid
1498       as it's turning out to be.
1499
1500       And  of  course,  a big thanks to locsmif, who figured out a lot of the
1501       core methods, logic, and tricks originally used in inxi Gawk/Bash.
1502
1503
1504
1505inxi                              2019-11-19                           INXI(1)
Impressum