Update upstream source from tag 'upstream/3.3.15-1'

Update to upstream version '3.3.15-1'
with Debian dir f399cc483433aaa6a5d5614379e6f7597a44161f

1 files changed, 104 insertions, 42 deletions

diff --git a/inxi.1 b/inxi.1
index 7e37418..aa69d3d 100644
--- a/inxi.1
+++ b/inxi.1
@@ -1,5 +1,5 @@
 .\"  inxi.1 - manpage for inxi system information tool
-.\"  Copyright (C) 2021 Harald Hope
+.\"  Copyright (C) 2022 Harald Hope
 .\"
 .\"  This program is free software; you can redistribute it and/or modify
 .\"  it under the terms of the GNU General Public License as published by
@@ -15,7 +15,7 @@
 .\"  with this program; if not, write to the Free Software Foundation, Inc.,
 .\"  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 .\"  
-.TH INXI 1 "2022\-03\-24" "inxi" "inxi manual"
+.TH INXI 1 "2022\-04\-08" "inxi" "inxi manual"
 
 .SH NAME
 inxi  \- Command line system information script for console and IRC
@@ -62,6 +62,51 @@ filtering with the \fB\-z\fR option (\fB\-Fz\fR, for example). To override
 the IRC filter, you can use the \fB\-Z\fR option. This can be useful in 
 debugging network connection issues online in a private chat, for example.
 
+.SH TABLE OF CONTENTS
+This man page is pretty long and information packed. It is divided into the 
+following sections:
+
+* \fBUSING OPTIONS\fR How to use the command line options.
+
+* \fBSTANDARD OPTIONS\fR Primary data types trigger items.
+
+* \fBFILTER OPTIONS\fR Apply a variety of output filters.
+
+* \fBOUTPUT CONTROL OPTIONS\fR Change default colors, widths, heights, output 
+types, etc.
+
+* \fBEXTRA DATA OPTIONS\fR What \fB\-x\fR, \fB\-xx\fR, and \fB\-xxx\fR add to 
+the output per primary data type. 
+
+* \fBADMIN EXTRA DATA OPTIONS\fR What \fB\-a\fR adds to the output per primary
+data type. These have a lot of information because this is advanced admin data,
+which are not always intuitive or easy to understand.
+
+* \fBADVANCED OPTIONS\fR Modify behavior or choice of data sources, and other 
+advanced switches.
+
+* \fBDEBUGGING OPTIONS\fR For development use mainly, or contributing datasets 
+to the project.
+
+* \fBDEBUGGING OPTIONS TO DEBUG DEBUGGER FAILURES\fR Only for advanced users,
+sometimes something will hang the debuggers, this shows you various ways to get
+around those failures.
+
+* \fBSUPPORTED IRC CLIENTS\fR List of known good IRC clients. Not checked often,
+let us know if something is not working.
+
+* \fBRUNNING IN IRC CLIENT\fR How to run inxi in various IRC clients.
+
+* \fBCONFIGURATION FILE\fR Configuration file locations and priority in using.
+
+* \fBCONFIGURATION OPTIONS\fR Most of the commonly used configuration options,
+along with sample values.
+
+* \fBBUGS\fR How and where to report bugs.
+
+* \fBHOMEPAGE\fR, \fBAUTHOR AND CONTRIBUTORS TO CODE\fR, \fBSPECIAL THANKS TO 
+THE FOLLOWING\fR These are self explanitory.
+
 .SH USING OPTIONS
 Options can be combined if they do not conflict. You can either group the 
 letters together or separate them.
@@ -79,24 +124,6 @@ Note that all the short form options have long form equivalents, which are
 listed below. However, usually the short form is used in examples in order to
 keep things simple.
 
-These are available options sections:
-
-* \fBSTANDARD OPTIONS\fR Primary data types trigger items.
-
-* \fBFILTER OPTIONS\fR Apply a variety of output filters.
-
-* \fBOUTPUT CONTROL OPTIONS\fR Change default colors, widths, heights, output 
-types, etc.
-
-* \fBEXTRA DATA OPTIONS\fR What \fB\-x\fR, \fB\-xx\fR, \fB\-xxx\fR, and \fB\-a\fR 
-add to the output. 
-
-* \fBADVANCED OPTIONS\fR Modify behavior or choice of data sources, and other 
-advanced switches.
-
-* \fBDEBUGGING OPTIONS\fR For development use mainly, or contributing datasets to
-the project.
-
 .SH STANDARD OPTIONS
 
 .TP
@@ -444,13 +471,12 @@ Other types of logical block handling like LUKS, bcache show as:
 
 .TP
 .B \-m \fR, \fB\-\-memory\fR
-Memory (RAM) data. Does not display with \fB\-b\fR or \fB\-F\fR unless you 
-use \fB\-m\fR explicitly. Ordered by system board physical system memory 
-array(s) (\fBArray\-[number]\fR), and individual memory devices 
-(\fBDevice\-[number]\fR). Physical memory array data shows array capacity, 
-number of devices supported, and Error Correction information. Devices shows 
-locator data (highly variable in syntax), size, speed, type 
-(eg: \fBtype: DDR3\fR).
+Memory (RAM) data. Does not display with \fB\-b\fR or \fB\-F\fR unless you use 
+\fB\-m\fR explicitly. Ordered by system board physical system memory array(s) 
+(\fBArray\-[number]\fR), and individual memory devices (\fBDevice\-[number]\fR). 
+Physical memory array data shows array capacity, number of devices supported, 
+and Error Correction information. Devices shows locator data (highly variable in 
+syntax), type (eg: \fBtype: DDR3\fR)size, speed.
 
 Note: \fB\-m\fR uses \fBdmidecode\fR, which must be run as root (or start 
 \fBinxi\fR with \fBdoas/sudo\fR), unless you figure out how to set up doas/sudo 
@@ -488,11 +514,11 @@ If the detected speed is logically absurd, like 1 MT/s or 69910 MT/s, adds:
 \fBMemory:
   RAM: total: 31.38 GiB used: 20.65 GiB (65.8%) 
   Array\-1: capacity: N/A slots: 4 note: check EC: N/A 
-  Device\-1: DIMM_A1 size: 8 GiB speed: 1600 MT/s (800 MHz) 
-  Device\-2: DIMM_A2 size: 8 GiB speed: spec: 1600 MT/s (800 MHz) 
+  Device\-1: DIMM_A1 type: DDR3 size: 8 GiB speed: 1600 MT/s (800 MHz) 
+  Device\-2: DIMM_A2 type: DDR3 size: 8 GiB speed: spec: 1600 MT/s (800 MHz) 
     actual: 61910 MT/s (30955 MHz) note: check 
-  Device\-3: DIMM_B1 size: 8 GiB speed: 1600 MT/s (800 MHz) 
-  Device\-4: DIMM_B2 size: 8 GiB speed: spec: 1600 MT/s (800 MHz) 
+  Device\-3: DIMM_B1 type: DDR3 size: 8 GiB speed: 1600 MT/s (800 MHz) 
+  Device\-4: DIMM_B2 type: DDR3 size: 8 GiB speed: spec: 1600 MT/s (800 MHz) 
     actual: 2 MT/s (1 MHz) note: check\fR
 .fi
 
@@ -1286,8 +1312,6 @@ tracking down which device belongs to what.
 Only some systems will have this data available. Shows estimate if it can
 generate one.
 
-\- Adds device type in the Device line.
-
 .TP
 .B \-x \-N\fR
 \- Adds (if available and/or relevant) \fBvendor:\fR item, which shows 
@@ -1333,8 +1357,7 @@ found for each distribution system base detection.
 
 .TP
 .B \-x \-\-slots\fR
-\- Adds \fBbus\-ID:\fR. Note that this bus ID does not unfortunately appear to
-be readily detected as the source bus ID for any particular device bus ID.
+\- Adds slot \fBbus\-ID:\fR, if found. 
 
 .TP
 .B \-x \-t\fR (\fB\-\-processes\fR)
@@ -1531,6 +1554,11 @@ serial number.
 100% right all of the time since it depends on the order that data is found
 in \fBdmidecode\fR output for \fBtype 6\fR and \fBtype 17\fR.
 
+\- Adds, if present, memory array voltage. Only some legacy systems will have 
+this data available.
+
+\- Adds memory module current configured operating voltage, if available.
+
 .TP
 .B \-xx \-M\fR
 \- Adds chassis information, if data is available. Also shows BIOS
@@ -1575,6 +1603,8 @@ running. If none found, shows nothing. Uses a less accurate fallback tool
 .B \-xx \-\-slots\fR
 \- Adds slot length.
 
+\- Adds slot voltage, if available.
+
 .TP
 .B \-xx \-w \fR, \fB\-W\fR
 \- Adds wind chill, heat index, and dew point, if available.
@@ -1686,18 +1716,24 @@ uses the \fBwhoami\fR test.
 .TP
 .B \-xxx \-m\fR, \fB\-\-memory\-modules\fR
 \- Adds memory bus width: primary bus width, and if present, total width. e.g.
-\fBbus width: 64 bit (total: 72 bits)\fR. Note that total / data widths are 
-mixed up sometimes in dmidecode output, so inxi will take the larger value as 
-the total if present. If no total width data is found, then inxi will not show 
-that item.
 
-\- Adds device Type Detail, e.g. \fBdetail: DDR3 (Synchronous)\fR.
+\fBwidth (bits): data: 64 total: 72\fR
+
+Note that total / data widths are mixed up sometimes in dmidecode output, so 
+inxi will take the larger value as the total if present. \fBData\fR width 
+usually corresponds to the CPU bits. \fBTotal\fR can reflect EEC or Dual Channel 
+widths. If no total width data is found, shows:
 
-\- Adds, if present, memory module voltage. Only some systems will have this
-data available.
+\fBwidth: N/A\fR
+
+\- Adds device type detail, e.g. \fBtype: DDR3 detail: Synchronous\fR.
 
 \- Adds device serial number.
 
+\- Adds memory module current, max, and min voltages, if they are available and 
+different from each other. If they are the identical, displays same as 
+\fB\-xxm\fR voltage report. Use \fB\-ma\fR to always see them.
+
 .TP
 .B \-xxx \-N\fR
 \- Adds, if present, serial number.
@@ -2022,6 +2058,10 @@ mapped name for logical components. Puts each component/device on its own line.
 \- Adds maj-min to LV and other devices.
 
 .TP
+.B \-a \-m\fR
+\- Expands volts to include curr/min/max values even if they are all identical.
+
+.TP
 .B \-a \-n\fR, \fB\-a \-N\fR, \fB\-a \-i\fR
 \- Adds, if present, possible \fBalternate:\fR kernel modules capable of driving 
 each \fBDevice\-x\fR (not including the current \fBdriver:\fR). If no 
@@ -2071,6 +2111,28 @@ Component report to 1 component per line.
 \- Adds kernel boot parameters to \fBKernel\fR section (if detected). Support 
 varies by OS type.
 
+.TP
+.B \-a \-\-slots\fR
+\- Adds PCI children of the main slot bus ID, and their types and class IDs, 
+recursively. Linux only, and only if detected. Sample:
+
+.nf
+\fBSlot: 0
+  type: PCIe
+  lanes: 16
+  status: in use
+  length: long
+  volts: 3.3
+  bus\-ID: 00:03.1
+    children:
+      1: 07:00.0
+        class\-ID: 0300
+        type: display
+      2: 07:00.1
+        class\-ID: 0403
+        type: audio\fR
+.fi
+
 .SH ADVANCED OPTIONS
 
 .TP