New upstream version 3.2.00-1.upstream/3.2.00-1

1 files changed, 216 insertions, 23 deletions

diff --git a/inxi.1 b/inxi.1
index efda382..f4937d9 100644
--- a/inxi.1
+++ b/inxi.1
@@ -1,4 +1,4 @@
-.TH INXI 1 "2020\-11\-11" inxi "inxi manual"
+.TH INXI 1 "2020\-12\-15" inxi "inxi manual"
 
 .SH NAME
 inxi  \- Command line system information script for console and IRC
@@ -6,7 +6,7 @@ inxi  \- Command line system information script for console and IRC
 .SH SYNOPSIS
 \fBinxi\fR
 
-\fBinxi\fR [\fB\-AbBCdDfFGhijJIlmMnNopPrRsSuUVwzZ\fR]
+\fBinxi\fR [\fB\-AbBCdDfFGhiIjJlLmMnNopPrRsSuUVwzZ\fR]
 
 \fBinxi\fR [\fB\-c NUMBER\fR]
 [\fB\-\-sensors\-exclude SENSORS\fR] [\fB\-\-sensors\-use SENSORS\fR] 
@@ -173,11 +173,21 @@ few more features.
 .B \-D\fR,\fB \-\-disk\fR
 Show Hard Disk info. Shows total disk space and used percentage. The disk used 
 percentage includes space used by swap partition(s), since those are not usable 
-for data storage. Note that with RAID disks, the percentage will be wrong since 
-the total is computed from the disk sizes, but used is computed from mounted 
-partition used percentages. This small defect may get corrected in the future. 
-Also, unmounted partitions are not counted in disk use percentages since inxi 
-has no access to the used amount.
+for data storage. Also, unmounted partitions are not counted in disk use percentages 
+since inxi has no access to the used amount.
+
+If the system has RAID or other logical storage, and if inxi can determine 
+the size of those vs their components, you will see the storage total raw and usable 
+sizes, plus the percent used of the usable size. The no argument short form
+of inxi will show only the usable (or total if no usable) and used percent.
+If there is no logical storage detected, only \fBtotal:\fR and \fBused:\fR will
+show. Sample (with RAID logical size calculated):
+
+\fBLocal Storage: total: raw: 5.49 TiB usable: 2.80 TiB used: 1.35 TiB (48.3%)\fR
+
+Without logical storage detected:
+
+\fBLocal Storage: total: 2.89 TiB used: 1.51 TiB (52.3%)\fR
 
 Also shows per disk information: Disk ID, type (if present), vendor (if detected), 
 model, and size. See \fBExtra Data Options\fR (\fB\-x\fR options) and 
@@ -285,6 +295,81 @@ Show partition labels. Default: main partitions \fB\-P\fR. For full \fB\-p\fR ou
 use: \fB\-pl\fR.
 
 .TP
+.B \-L\fR, \fB\-\-logical\fR
+Show Logical volume information, for LVM, LUKS, bcache, MultiPath, etc. Shows
+size, free space (for LVM VG). For LVM, shows \fBDevice\-[xx]: VG:\fR 
+(Volume Group) size/free, \fBLV\-[xx]\fR (Logical Volume). LV shows type, 
+size, and components. Note that components are made up of either containers
+(aka, logical devices), or physical devices. The full report requires sudo/root.
+
+Logical block devices can be thought of as devices that are made up out
+of either other logical devices, or physical devices. inxi does its best 
+to show what each logical device is made out of. RAID devices form a subset
+of all possible Logical devices, but have their own section, \fB\-R\fR. 
+
+If \fB\-R\fR is used with \fB\-Lxx\fR, \fB\-Lxx\fR will not show RAID 
+information for LVM RAID devices since it's redundant. If \fB\-R\fR is
+not used, a simple RAID line will appear for LVM RAID in \fB\-Lxx\fR.
+
+\fB\-Lxx\fR also shows all components and devices. Note that since
+components can go in many levels, each level per primary component is
+indicated by either another 'c', or ends with a 'p' device, the physical
+device. The number of c's or p's indicates the depth, so you can see which
+component belongs to which.
+
+\fB\-L\fR shows only the top level components/devices (like \fB\-R\fR).
+\fB\-La\fR shows component/device size, maj:min ID, mapped name
+(if applicable), and puts each component/device on its own line.
+
+Sample:
+
+\fBDevice\-10: mybackup type: LUKS dm: dm\-28 size: 6.36 GiB Components: c\-1: md1 
+cc\-1: dm\-26 ppp\-1: sdj2 cc\-2: dm\-27 ppp\-1: sdk2\fR
+
+.nf
+\fBLV-5: lvm_raid1 type: raid1 dm: dm\-16 size: 4.88 GiB 
+RAID: stripes: 2 sync: idle copied: 100% mismatches: 0 
+Components: c\-1: dm\-10 pp\-1: sdd1 c\-2: dm\-11 pp\-1: sdd1 c\-3: dm\-13 
+pp\-1: sde1 c\-4: dm\-15 pp\-1: sde1\fR
+.fi
+
+It is easier to follow the flow of components and devices using \fB\-y1\fR. In
+this example, there is one primary component (c\-1), md1, which is made up of two
+components (cc\-1,2), dm\-26 and dm\-27. These are respectively made from physical
+devices (p\-1) sdj2 and sdk2.
+
+.nf
+\fBDevice-10: mybackup
+  maj-min: 254:28
+  type: LUKS
+  dm: dm-28
+  size: 6.36 GiB
+  Components: 
+    c\-1: md1
+    maj\-min: 9:1
+    size: 6.37 GiB
+    cc-1: dm\-26
+      maj-min: 254:26
+      mapped: vg5\-level1a
+      size: 12.28 GiB
+      ppp\-1: sdj2
+        maj\-min: 8:146
+        size: 12.79 GiB
+    cc\-2: dm\-27
+      maj\-min: 254:27
+      mapped: vg5\-level1b
+      size: 6.38 GiB
+      ppp-1: sdk2
+        maj\-min: 8:162
+        size: 12.79 GiB\fR
+.fi
+
+Other types of logical block handling like LUKS, bcache, multipath, 
+show as:
+
+\fBDevice\-[xx] [name/id] type: [LUKS|Crypto|bcache|MultiPath]:\fR
+
+.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),
@@ -310,6 +395,30 @@ will put this data into \fB/sys\fR, and make it real data, taken from the actual
 not dmi data. For most people, the data will be right, but a significant percentage of
 users will have either a wrong max module size, if present, or max capacity.
 
+Under dmidecode, \fBSpeed:\fR is the expected speed of the memory 
+(what is advertised on the memory spec sheet) and \fBConfigured Clock Speed:\fR
+is what the actual speed is now. To handle this, if speed and configured speed values
+are different, you will see this instead:
+
+\fBspeed: spec: [specified speed] MT/S actual: [actual] MT/S\fR
+
+Also, if DDR, and speed in MHz, will change to: \fBspeed: [speed] MT/S ([speed] MHz\fR
+
+If the detected speed is logically absurd, like 1 MT/s or 69910 MT/s, adds: 
+\fBnote: check\fR. Sample:
+
+.nf
+\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) 
+  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) 
+  actual: 2 MT/s (1 MHz) note: check\fR
+.fi
+
 See \fB\-\-memory\-modules\fR and \fB\-\-memory\-short\fR if you want a shorter report.
 
 .TP
@@ -370,9 +479,10 @@ Show full Partition information (\fB\-P\fR plus all other detected mounted parti
 .TP
 .B \-P\fR,\fB \-\-partitions\fR
 Show basic Partition information.
-Shows, if detected: \fB/ /boot /home /opt /tmp /usr /usr/home /var /var/tmp /var/log\fR.
+Shows, if detected: \fB/ /boot /boot/efi /home /opt /tmp /usr /usr/home /var /var/tmp 
+/var/log\fR (for android, shows \fB/cache /data /firmware /system\fR).
 If \fB\-\-swap\fR is not used, shows active swap partitions (never shows file or 
-zram type swap).
+zram type swap). 
 Use \fB\-p\fR to see all mounted partitions.
 
 .TP
@@ -418,15 +528,19 @@ See \fB\-rx\fR, \fB\-rxx\fR, and \fB\-ra\fR for installed package count informat
 
 .TP
 .B \-R\fR,\fB \-\-raid\fR
-Show RAID data. Shows RAID devices, states, levels and components, and
-extra data with \fB\-x\fR / \fB\-xx\fR.
+Show RAID data. Shows RAID devices, states, levels, device/array size,
+and components. See extra data with \fB\-x\fR / \fB\-xx\fR.
 
 md\-raid: If device is resyncing, also shows resync progress line.
 
-Note: Only md\-raid and ZFS are currently supported. Other software RAID types could
-be added, but only if users supply all data required, and if the software
+Note: Only md\-raid, ZFS and hardware RAID are currently supported. 
+Other software RAID types may be added, if the software
 RAID actually can be made to give the required output.
 
+The component ID numbers work like this: mdraid: the numerator
+is the actual mdraid component number; ZFS: the numerator is
+auto-incremented counter only. Eg. \fBOnline: 1: sdb1\fR
+
 If hardware RAID is detected, shows basic information. Due to complexity
 of adding hardware RAID device disk / RAID reports, those will only be added 
 if there is demand, and reasonable reporting tools. 
@@ -474,8 +588,8 @@ Make sure that there is no space between letters and numbers (e.g. write as \fB\
 .TP
 .B \-t m\fR
 \- memory only. With \fB\-x\fR, also shows CPU for that process on same line.
-If the \-I line is not triggered, will also show the system RAM used/total
-information.
+If the \fB\-I\fR or \fB\-m\fR lines are not triggered, will also show the 
+system RAM used/total information.
 
 .TP
 .B \-t cm\fR
@@ -557,9 +671,9 @@ USB (\fB\-J\fR); triggers \fB\-xx\fR extra data option.
 
 .TP
 .B \-v 8
-\- All system data available. Adds Repos (\fB\-r\fR), PCI slots (\fB\-\-slots\fR), 
-processes (\fB\-tcm\fR), admin (\fB\-\-admin\fR). Useful for testing output and to 
-see what data you can get from your system.
+\- All system data available. Adds Logical (\fB\-L\fR), Repos (\fB\-r\fR), 
+PCI slots (\fB\-\-slots\fR), processes (\fB\-tcm\fR), admin (\fB\-\-admin\fR). 
+Useful for testing output and to see what data you can get from your system.
 
 .TP
 .B \-w\fR,\fB \-\-weather\fR
@@ -687,10 +801,14 @@ have this feature.
 
 \- Adds CPU microarchitecture + revision (e.g. Sandy Bridge, K8, ARMv8, P6,
 etc.). Only shows data if detected. Newer microarchitectures will have
-to be added as they appear, and require the CPU family ID and model ID.
+to be added as they appear, and require the CPU family ID, model ID,
+and stepping.
 
 Examples: \fBarch: Sandy Bridge rev: 2\fR, \fBarch: K8 rev.F+ rev: 2\fR
 
+If unable to non\-ambiguosly determine architecture, will show something like:
+\fBarch: Amber Lake note: check rev: 9\fR
+
 .TP
 .B \-x \-d\fR
 \- Adds more items to \fBFeatures\fR line of optical drive; 
@@ -698,11 +816,33 @@ dds rev version to optical drive.
 
 .TP
 .B \-x \-D\fR
-\- Adds HDD temperature with disk data if you have hddtemp installed, if you are root
+\- Adds HDD temperature with disk data.
+
+Method 1: if you have hddtemp installed, if you are root
 or if you have added to \fB/etc/sudoers\fR (sudo v. 1.7 or newer):
 
 .B <username> ALL = NOPASSWD: /usr/sbin/hddtemp (sample)
 
+Method 2: systems running Linux kernels ~5.8 and newer may have drive temp data
+available from /sys. If your system has /sys hwmon drive data, the temps 
+will come from /sys data for each drive with that data, and will not require 
+root or hddtemp!! This method is MUCH faster than using hddtemp!
+
+If you see drive temps running as regular user and you did not configure system 
+to use sudo hddtemp, then your system supports this feature. Sometimes one type 
+of drive will have the /sys temp data, and another won't, it varies widely.
+If no /sys data is found, inxi will try to use hddtemp methods instead
+for that drive. 
+
+Hint: is /sys sourced, the temps will be to 1 decimal, like 34.8, if hddtemp 
+sourced, they will be integers.
+
+You can force use of \fBhddtemp\fR for all drives using \fB\-\-hddtemp\fR. 
+
+\- If free LVM volume group size detected (root required), show \fBlvm-free:\fR
+on Local Storage line. This is how much unused space the VGs contain, that is,
+space not assigned to LVs.
+
 .TP
 .B \-x \-G\fR
 \- Adds (if available and/or relevant) \fBvendor:\fR item, which shows 
@@ -760,10 +900,19 @@ discover those.
 \- If in shell (i.e. not in IRC client), adds shell version number, if available.
 
 .TP
+.B \-x \-j\fR, \fB\-x \-\-swap\fR
+Add \fBmapper:\fR. See \fB\-x \-o\fR.
+
+.TP
 .B \-x \-J\fR (\fB\-\-usb\fR)
 \- For Devices, adds driver(s).
 
 .TP
+.B \-x \-L\fR, \fB\-x \-\-logical\fR
+\- Adds \fBdm: dm-x\fR to VG > LV and other Device types. This can help tracking 
+down which device belongs to what.
+
+.TP
 .B \-x \-m\fR, \fB\-\-memory\-modules\fR
 \- If present, adds maximum memory module/device size in the Array line.
 Only some systems will have this data available. Shows estimate if it can
@@ -781,6 +930,13 @@ specific vendor [product] information.
 \- Adds PCI Bus ID/USB ID number of each Network card.
 
 .TP
+.B \-x \-o\fR, \fB\-x \-p\fR, \fB\-x \-P\fR
+\- Adds \fBmapper:\fR (the \fB/dev/mapper/\fR partitioni ID) 
+if mapped partition. 
+
+Example: \fBID-4: /home ... dev: /dev/dm-6 mapped: ar0-home\fR
+
+.TP
 .B \-x \-r\fR
 \- Adds Package info. See \fB\-Ix\fR
 
@@ -902,6 +1058,15 @@ swap types (for \fB\-j\fR).
 \- Adds vendor:chip id.
 
 .TP
+.B \-xx \-L\fR, \fB\-xx \-\-logical\fR
+\- Adds internal LVM Logical volumes, like raid image and meta data volumes. 
+
+\- Adds full list of Components, sub\-components, and their physical devices.
+
+\- For LVM RAID, adds a RAID report line (if not \fB\-R\fR). Read up on LVM
+documentation to better understand their use of the term 'stripes'.
+
+.TP
 .B \-xx \-m\fR, \fB\-\-memory\-modules\fR
 \- Adds memory device Manufacturer.
 
@@ -1137,6 +1302,8 @@ Using \fBsmartctl\fR (requires sudo/root privileges).
 
 \- Adds SATA type (eg 1.0, 2.6, 3.0) if a SATA device.
 
+\- Adds device kernel major:minor number (Linux only).
+
 \- Adds SMART report line: status, enabled/disabled, health, powered on,
 cycles, and some error cases if out of range values. Note that for Pre\-fail items,
 it will show the VALUE and THRESHOLD numbers. It will also fall back for unknown
@@ -1241,7 +1408,7 @@ Info:
 .fi
 
 .TP
-.B \-a \-j\fR, \fB\-a \-P\fR , \fB\-a \-P\fR
+.B \-a \-j\fR, \fB\-a \-P\fR [swap], \fB\-a \-P\fR [swap]
 \- Adds swappiness and vfs cache pressure, and a message to indicate 
 if the value is the default value or not (Linux only, and only if available). 
 If not the default value, shows default value as well, e.g. 
@@ -1254,6 +1421,15 @@ For \fB\-j\fR row 1 output:
 
 \fBKernel: swappiness: 60 (default) cache pressure: 90 (default 100)\fR
 
+\- Adds device kernel major:minor number (Linux only).
+
+.TP
+.B \-a \-L\fR
+\- Expands Component report, shows size / maj-min of components and devices, and
+mapped name for logical components. Puts each component/device on its own line.
+
+\- Adds maj-min to LV and other devices.
+
 .TP
 .B \-a \-n\fR, \fB\-a \-N\fR, \fB\-a \-i\fR
 \- Adds, if present, possible \fBalternate:\fR kernel modules capable of driving 
@@ -1263,6 +1439,10 @@ available in the system, it's just something the kernel knows could possibly be
 instead. 
 
 .TP
+.B \-a \-o\fR
+\- Adds device kernel major:minor number (Linux only).
+
+.TP
 .B \-a \-p\fR,\fB\-a \-P\fR
 \- Adds raw partition size, including file system overhead, partition table, e.g.  
 
@@ -1277,11 +1457,20 @@ not the raw size.
 
 \- Adds partition filesystem block size if found (requires root and blockdev). 
 
+\- Adds device kernel major:minor number (Linux only).
+
 .TP
 .B \-a \-r\fR
 \- Adds Packages. See \fB\-Ia\fR
 
 .TP
+.B \-a \-R\fR
+\- Adds device kernel major:minor number (mdraid, Linux only).
+
+\- Adds, if available, component size, major:minor number, state (Linux only).
+Turns Component report to 1 component per line if size and major:minor present.
+
+.TP
 .B \-a \-S\fR
 \- Adds kernel boot parameters to \fBKernel\fR section (if detected). Support 
 varies by OS type.
@@ -1347,6 +1536,10 @@ e.g. \fB\-M\fR or \fB\-B\fR.
 Force inxi to use Curl, Fetch, Perl, or Wget for downloads.
 
 .TP
+.B \-\-hddtemp\fR
+Force use of hddtemp instead of /sys temp data for disks.
+
+.TP
 .B \-\-host\fR
 Turns on hostname in System line. Overrides inxi config file value (if set):
 
@@ -1416,7 +1609,7 @@ Overrides user set \fBSENSOR_FORCE\fR configuration value. Restores default beha
 Skip SSL certificate checks for all downloader actions (\fB\-U\fR, \fB\-w\fR,
 \fB\-W\fR, \fB\-i\fR). Use if your system does not have current SSL certificate
 lists, or if you have problems making a connection for any reason. Works with
-\fBWget\fR, \fBCurl\fR, \fBPerl HTTP::Tiny\fRand \fBFetch\fR.
+\fBWget\fR, \fBCurl\fR, \fBPerl HTTP::Tiny\fR and \fBFetch\fR.
 
 .TP
 .B \-\-no\-sudo\fR
@@ -1618,7 +1811,7 @@ For alternate ftp upload locations: Example:
 
 .SH DEBUGGING OPTIONS TO DEBUG DEBUGGER FAILURES
 
-Only used the following in conjunction with \fB\-\-debug 2[012]\fR, and only 
+Only use the following in conjunction with \fB\-\-debug 2[012]\fR, and only 
 use if you experienced a failure or hang, or were instructed to do so.
 
 .TP