diff options
Diffstat (limited to 'inxi.1')
| -rw-r--r-- | inxi.1 | 838 |
1 files changed, 540 insertions, 298 deletions
@@ -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 "2021\-10\-11" "inxi" "inxi manual" +.TH INXI 1 "2021\-12\-13" "inxi" "inxi manual" .SH NAME inxi \- Command line system information script for console and IRC @@ -23,7 +23,7 @@ inxi \- Command line system information script for console and IRC .SH SYNOPSIS \fBinxi\fR -\fBinxi\fR [\fB\-AbBCdDEfFGhiIjJlLmMnNopPrRsSuUVwzZ\fR] +\fBinxi\fR [\fB\-AbBCdDEfFGhiIjJlLmMnNopPrRsSuUVwyYzZ\fR] \fBinxi\fR [\fB\-c NUMBER\fR] [\fB\-\-sensors\-exclude SENSORS\fR] [\fB\-\-sensors\-use SENSORS\fR] @@ -78,19 +78,37 @@ 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 avalable 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 -.B \-A\fR,\fB \-\-audio\fR +.B \-A \fR, \fB\-\-audio\fR Show Audio/sound device(s) information, including device driver. Show running sound server(s). See \fB\-xxA\fR to show all sound servers detected. .TP -.B \-b\fR,\fB \-\-basic\fR +.B \-b \fR, \fB\-\-basic\fR Show basic output, short form. Same as: \fBinxi \-v 2\fR .TP -.B \-B\fR,\fB \-\-battery\fR +.B \-B \fR, \fB\-\-battery\fR Show system battery (\fBID\-x\fR) data, charge, condition, plus extra information (if battery present). Uses \fB/sys\fR or, for BSDs without systctl battery data, use \fB\-\-dmidecode\fR to force its use. \fBdmidecode\fR does @@ -122,67 +140,35 @@ With \fB\-x\fR shows attached \fBDevice\-x\fR information (mouse, keyboard, etc.) if they are battery powered. .TP -.B \-\-bluetooth\fR \- See \fB\-E\fR +.B \-\-bluetooth\fR +.br +See \fB\-E\fR. .TP -.B \-c\fR,\fB \-\-color\fR \fR[\fB0\fR\-\fB42\fR] -Set color scheme. If no scheme number is supplied, 0 is assumed. +.B \-c \fR, \fB\-\-color\fR +.br +See \fBOUTPUT CONTROL OPTIONS\fR. .TP -.B \-c \fR[\fB94\fR\-\fB99\fR] - -These color selectors run a color selector option prior to inxi starting -which lets you set the config file value for the selection. - -NOTE: All configuration file set color values are removed when output is -piped or redirected. You must use the explicit runtime \fB\-c <color number>\fR -option if you want color codes to be present in the piped/redirected output. - -Color selectors for each type display (NOTE: IRC and global only show safe -color set): +.B \-C \fR, \fB\-\-cpu\fR +Show full CPU output (if each item available): basic CPU topology, model, type, +L2 cache, average speed of all cores (if > 1 core, otherwise speed of the core), +min/max speeds for CPU, and per CPU clock speed. More data available with +\fB\-x\fR, \fB\-xxx\fR, and \fB\-a\fR options. -.TP -.B \-c 94\fR -\- Console, out of X. +Explanation of CPU type (\fBtype: MT MCP\fR) abbreviations: -.TP -.B \-c 95\fR -\- Terminal, running in X \- like xTerm. +* \fBAMCP\fR \- Asymmetric Multi Core Processor. More than 1 core per CPU, and +more than one core type (single and multithreaded cores in the same CPU). -.TP -.B \-c 96\fR -\- GUI IRC, running in X \- like XChat, Quassel, -Konversation etc. +* \fBAMP\fR \- Asymmetric Multi Processing (more than 1 physical CPU, but not +identical in terms of core counts or min/max speeds). -.TP -.B \-c 97\fR -\- Console IRC running in X \- like irssi in xTerm. +* \fBMT\fR \- Multi/Hyper Threaded CPU (more than 1 thread per core, previously +\fBHT\fR). -.TP -.B \-c 98\fR -\- Console IRC not in X. - -.TP -.B \-c 99\fR -\- Global \- Overrides/removes all settings. - -Setting a specific color type removes the global color selection. - -.TP -.B \-C\fR,\fB \-\-cpu\fR -Show full CPU output, including per CPU clock speed and CPU max speed (if -available). If max speed data present, shows \fB(max)\fR in short output -formats (\fBinxi\fR, \fBinxi \-b\fR) if actual CPU speed matches max CPU -speed. If max CPU speed does not match actual CPU speed, shows both actual -and max speed information. See \fB\-x\fR for more options. - -For certain CPUs (some ARM, and AMD Zen family) shows CPU die count. - -The details for each CPU include a technical description e.g. \fBtype: MT -MCP\fR - -* \fBMT\fR \- Multi/Hyper Threaded CPU, more than 1 thread per core -(previously \fBHT\fR). +* \fBMST\fR \- Multi and Single Threaded CPU (a CPU with both Single and Multi +Threaded cores). * \fBMCM\fR \- Multi Chip Model (more than 1 die per CPU). @@ -194,10 +180,19 @@ MCP\fR Note that \fBmin/max:\fR speeds are not necessarily true in cases of overclocked CPUs or CPUs in turbo/boost mode. See \fB\-Ca\fR for alternate -\fBbase/boost:\fR speed data. +\fBbase/boost:\fR speed data, more granular cache data, and more. + +Sample: +.nf +\fBCPU: + Info: 2x 8\-core model: Intel Xeon E5\-2620 v4 bits: 64 type: MT MCP SMP + cache: L2: 2x 2 MiB (4 MiB) + Speed (MHz): avg: 1601 min/max: 1200/3000 cores: 1: 1280 2: 1595 3: 1416 + ... 32: 1634\fR +.fi .TP -.B \-d\fR,\fB \-\-disk\-full\fR,\fB\-\-optical\fR +.B \-d \fR, \fB\-\-disk\-full\fR,\fB\-\-optical\fR Show optical drive data as well as \fB\-D\fR hard drive data. With \fB\-x\fR, adds a feature line to the output. Also shows floppy disks if present. Note that there is no current way to get any information about the floppy device @@ -205,7 +200,7 @@ that we are aware of, so it will simply show the floppy ID without any extra data. \fB\-xx\fR adds a few more features. .TP -.B \-D\fR,\fB \-\-disk\fR +.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. Also, unmounted partitions are not counted in disk use @@ -237,7 +232,7 @@ address per device (requires \fBbt\-adapter\fR or \fBhciconfig\fR), and if available (hciconfig only) bluetooth version (\fBbt\-v\fR). See \fBExtra Data Options\fR for more. -If bluetooth shows as \fBstatus: down\fR, shows \fBbt-service:\fR\fB state +If bluetooth shows as \fBstatus: down\fR, shows \fBbt\-service:\fR\fB state and rfkill\fR software and hardware blocked states, and rfkill ID. Note that \fBReport\-ID:\fR indicates that the HCI item was not able to be @@ -259,27 +254,17 @@ or \fBrfkill unblock bluetooth\fR .TP -.B \-\-filter\fR,\fB \-\-filter\-override\fR \- See \fB\-z\fR, \fB\-Z\fR. - -.TP -.B \-\-filter\-label\fR -Filter partition label names from \fB\-j\fR, \fB\-o\fR, \fB\-p\fR, -\fB\-P\fR, and \fB\-Sa\fR (root=LABEL=...). Generally only useful in -very specialized cases. - -.TP -.B \-\-filter\-uuid\fR -Filter partition UUIDs from \fB\-j\fR, \fB\-o\fR, \fB\-p\fR, -\fB\-P\fR, and \fB\-Sa\fR (root=UUID=...). Generally only useful in -very specialized cases. +.B \-\-filter\fR, \fB\-z\fR +.br +See \fBFILTER OPTIONS\fR. .TP -.B \-f\fR,\fB \-\-flags\fR +.B \-f \fR, \fB\-\-flags\fR Show all CPU flags used, not just the short list. Not shown with \fB\-F\fR in order to avoid spamming. ARM CPUs: show \fBfeatures\fR items. .TP -.B \-F\fR,\fB \-\-full\fR +.B \-F \fR, \fB\-\-full\fR Show Full output for inxi. Includes all Upper Case line letters (except \fB\-J\fR and \fB\-W\fR) plus \fB\-\-swap\fR, \fB\-s\fR and \fB\-n\fR. Does not show extra verbose options such as \fB\-d \-f \-i -J \-l \-m \-o \-p \-r @@ -287,7 +272,7 @@ not show extra verbose options such as \fB\-d \-f \-i -J \-l \-m \-o \-p \-r \fBinxi \-Frmxx\fR .TP -.B \-G\fR,\fB \-\-graphics\fR +.B \-G \fR, \fB\-\-graphics\fR Show Graphic device(s) information, including details of device and display drivers (\fBloaded:\fR, and, if applicable: \fBunloaded:\fR, \fBfailed:\fR), display protocol (if available), display server (and/or Wayland compositor), @@ -306,21 +291,21 @@ Compositor information will show if detected using \fB\-xx\fR option or always if detected and Wayland. .TP -.B \-h\fR,\fB \-\-help\fR +.B \-h \fR, \fB\-\-help\fR The help menu. Features dynamic sizing to fit into terminal window. Set script global \fBCOLS_MAX_CONSOLE\fR if you want a different default value, or use \fB\-y <width>\fR to temporarily override the defaults or actual window width. .TP -.B \-i\fR,\fB \-\-ip\fR +.B \-i \fR, \fB\-\-ip\fR Show WAN IP address and local interfaces (latter requires \fBifconfig\fR or \fBip\fR network tool), as well as network output from \fB\-n\fR. Not shown with \fB\-F\fR for user security reasons. You shouldn't paste your local/WAN IP. Shows both IPv4 and IPv6 link IP addresses. .TP -.B \-I\fR,\fB \-\-info\fR +.B \-I \fR, \fB\-\-info\fR Show Information: processes, uptime, memory, IRC client (or shell type if run in shell, not IRC), inxi version. See \fB\-Ix\fR, \fB\-Ixx\fR, and \fB\-Ia\fR for extra information (init type/version, runlevel, packages). @@ -341,7 +326,7 @@ To show partition labels or UUIDs (when available and relevant), use with \fB\-l\fR or\fB \-u\fR. .TP -.B \-J\fR,\fB \-\-usb\fR +.B \-J \fR, \fB\-\-usb\fR Show USB data for attached Hubs and Devices. Hubs also show number of ports. Be aware that a port is not always external, some may be internal, and either used or unused (for example, a motherboard USB header connector that is not @@ -362,7 +347,7 @@ The \fBrev: 2.0\fR item refers to the USB revision number, like \fB1.0\fR or \fB3.1\fR. .TP -.B \-l\fR,\fB \-\-label\fR +.B \-l \fR, \fB\-\-label\fR Show partition labels. Use with \fB\-j\fR, \fB\-o\fR, \fB\-p\fR, and \fB\-P\fR to show partition labels. Does nothing without one of those options. @@ -375,7 +360,7 @@ 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 -doas[BSDs]/sudo/root. +doas/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 @@ -398,14 +383,13 @@ component belongs to which. 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 +\fB Device\-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 + \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 @@ -444,7 +428,7 @@ Other types of logical block handling like LUKS, bcache show as: \fBDevice\-[xx] [name/id] type: [LUKS|Crypto|bcache]:\fR .TP -.B \-m\fR,\fB \-\-memory\fR +.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 @@ -453,11 +437,11 @@ number of devices supported, and Error Correction information. Devices shows locator data (highly variable in syntax), size, speed, type (eg: \fBtype: DDR3\fR). -Note: \fB\-m\fR uses \fBdmidecode\fR, which must be run as root (or start -\fBinxi\fR with \fBsudo\fR), unless you figure out how to set up -doas[BSDs]/sudo to permit dmidecode to read \fB/dev/mem\fR as user. -\fBspeed\fR and \fBbus\-width\fR will not show if \fBNo Module Installed\fR -is found in \fBsize\fR. +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 +to permit dmidecode to read \fB/dev/mem\fR as user. \fBspeed\fR and +\fBbus\-width\fR will not show if \fBNo Module Installed\fR is found in +\fBsize\fR. Note: If \fB\-m\fR is triggered RAM total/used report will appear in this section, not in \fB\-I\fR or \fB\-tm\fR items. @@ -491,10 +475,10 @@ If the detected speed is logically absurd, like 1 MT/s or 69910 MT/s, adds: 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 + 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 + actual: 2 MT/s (1 MHz) note: check\fR .fi See \fB\-\-memory\-modules\fR and \fB\-\-memory\-short\fR if you want a @@ -512,7 +496,7 @@ Memory (RAM) data. Show a one line RAM report in Memory. See \fB\-m\fR. Sample: \fBReport: arrays: 1 slots: 4 modules: 2 type: DDR4\fR .TP -.B \-M\fR,\fB \-\-machine\fR +.B \-M \fR, \fB\-\-machine\fR Show machine data. Device, Motherboard, BIOS, and if present, System Builder (Like Lenovo). Older systems/kernels without the required \fB/sys\fR data can use \fBdmidecode\fR instead, run as root. If using \fBdmidecode\fR, may also @@ -534,17 +518,17 @@ notebook, server, blade, plus some obscure stuff that inxi is unlikely to ever run on. .TP -.B \-n\fR,\fB \-\-network\-advanced\fR +.B \-n \fR, \fB\-\-network\-advanced\fR Show Advanced Network device information in addition to that produced by \fB\-N\fR. Shows interface, speed, MAC ID, state, etc. .TP -.B \-N\fR,\fB \-\-network\fR +.B \-N \fR, \fB\-\-network\fR Show Network device(s) information, including device driver. With \fB\-x\fR, shows Bus ID, Port number. .TP -.B \-o\fR,\fB \-\-unmounted\fR +.B \-o \fR, \fB\-\-unmounted\fR Show unmounted partition information (includes UUID and LABEL if available). Shows file system type if you have \fBlsblk\fR installed (Linux only). For BSD/GNU Linux: shows file system type if \fBfile\fR is installed, and if you @@ -552,7 +536,7 @@ are root or if you have added to \fB/etc/sudoers\fR (sudo v. 1.7 or newer): .B <username> ALL = NOPASSWD: /usr/bin/file (sample) -BSD users: see \fBman doas.conf\fR for setup. +doas users: see \fBman doas.conf\fR for setup. Does not show components (partitions that create the md\-raid array) of md\-raid arrays. @@ -561,7 +545,7 @@ To show partition labels or UUIDs (when available and relevant), use with \fB\-l\fR or\fB \-u\fR. .TP -.B \-p\fR,\fB \-\-partitions\-full\fR +.B \-p \fR, \fB\-\-partitions\-full\fR Show full Partition information (\fB\-P\fR plus all other detected mounted partitions). @@ -569,7 +553,7 @@ To show partition labels or UUIDs (when available and relevant), use with \fB\-l\fR or\fB \-u\fR. .TP -.B \-P\fR,\fB \-\-partitions\fR +.B \-P \fR, \fB\-\-partitions\fR Show basic Partition information. 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). @@ -580,10 +564,12 @@ To show partition labels or UUIDs (when available and relevant), use with \fB\-l\fR or\fB \-u\fR. .TP -.B \-\-processes\fR \- See \fB\-t\fR +.B \-\-processes\fR +.br +See \fB\-t\fR. .TP -.B \-r\fR,\fB \-\-repos\fR +.B \-r \fR, \fB\-\-repos\fR Show distro repository data. Currently supported repo types: \fBAPK\fR (Alpine Linux + derived versions) @@ -628,7 +614,7 @@ See \fB\-rx\fR, \fB\-rxx\fR, and \fB\-ra\fR for installed package count information. .TP -.B \-R\fR,\fB \-\-raid\fR +.B \-R \fR, \fB\-\-raid\fR Show RAID data. Shows RAID devices, states, levels, device/array size, and components. See extra data with \fB\-x\fR / \fB\-xx\fR. @@ -652,7 +638,7 @@ Checks inxi application dependencies and recommends, as well as directories, then shows what package(s) you need to install to add support for each feature. .TP -.B \-s\fR,\fB \-\-sensors\fR +.B \-s \fR, \fB\-\-sensors\fR Show output from sensors if sensors installed/configured: Motherboard/CPU/GPU temperatures; detected fan speeds. GPU temperature when available. Nvidia shows screen number for multiple screens. IPMI sensors are also used (root required) @@ -665,17 +651,19 @@ exclude one. Show PCI slots with type, speed, and status information. .TP -.B \-\-swap\fR \- See \fB\-j\fR +.B \-\-swap\fR +.br +See \fB\-j\fR .TP -.B \-S\fR,\fB \-\-system\fR +.B \-S \fR, \fB\-\-system\fR Show System information: host name, kernel, desktop environment (if in X), distro. With \fB\-xx\fR show dm \- or startx \- (only shows if present and running if out of X), and if in X, with \fB\-xxx\fR show more desktop info, e.g. taskbar or panel. .TP -.B \-t\fR,\fB \-\-processes\fR +.B \-t \fR, \fB\-\-processes\fR [\fBc\fR|\fBm\fR|\fBcm\fR|\fBmc NUMBER\fR] Show processes. If no arguments, defaults to \fBcm\fR. If followed by a number, shows that number of processes for each type (default: \fB5\fR; if in IRC, max: \fB5\fR) @@ -699,14 +687,14 @@ system RAM used/total information. same line. .TP -.B \-u\fR,\fB \-\-uuid\fR +.B \-u \fR, \fB\-\-uuid\fR Show partition UUIDs. Use with \fB\-j\fR, \fB\-o\fR, \fB\-p\fR, and \fB\-P\fR to show partition labels. Does nothing without one of those options. Sample: \fB\-opju\fR. .TP -.B \-U\fR,\fB \-\-update\fR +.B \-U \fR, \fB\-\-update\fR Note \- Maintainer may have disabled this function. If inxi \fB\-h\fR has no listing for \fB\-U\fR then it's disabled. @@ -720,14 +708,16 @@ to that directory. See \fB\-\-man\fR or \fB\-\-no\-man\fR to force or disable man install. .TP -.B \-\-usb\fR \- See \fB\-J\fR +.B \-\-usb\fR +.br +See \fB\-J\fR. .TP .B \-V\fR, \fB\-\-version\fR inxi version information. Prints information then exits. .TP -.B \-v\fR,\fB \-\-verbosity\fR +.B \-v \fR, \fB\-\-verbosity\fR Script verbosity levels. If no verbosity level number is given, 0 is assumed. Should not be used with \fB\-b\fR or \fB\-F\fR. @@ -739,8 +729,8 @@ Supported levels: \fB0\-8\fR Examples :\fB inxi \-v 4 \fR or \fB inxi \-v4\fR .TP .B \-v 1 -\- Basic verbose, \fB\-S\fR + basic CPU (cores, type, clock speed, and min/max -speeds, if available) + \fB\-G\fR + basic Disk + \fB\-I\fR. +\- Basic verbose, \fB\-S\fR + basic CPU (cores, type, average clock speed, and +min/max speeds, if available) + \fB\-G\fR + basic Disk + \fB\-I\fR. .TP .B \-v 2 @@ -754,40 +744,39 @@ speeds, if available) + \fB\-G\fR + basic Disk + \fB\-I\fR. .TP .B \-v 4 -\- Adds partition size/used data (\fB\-P\fR) for (if present): -\fB/ /home /var/ /boot\fR. Shows full disk data (\fB\-D\fR) +\- Adds partition size/used data (\fB\-P\fR) for (if present): \fB/ /home /var/ +/boot\fR. Shows full disk data (\fB\-D\fR) .TP .B \-v 5 -\- Adds audio device (\fB\-A\fR), memory/RAM (\fB\-m\fR), -bluetooth data (\fB\-E\fR) (if present), sensors (\fB\-s\fR), -RAID data (if present), partition label (\fB\-l\fR), -UUID (\fB\-u\fR), full swap data (\fB\-j\fR), and short form of -optical drives. +\- Adds audio device (\fB\-A\fR), memory/RAM (\fB\-m\fR), bluetooth data +(\fB\-E\fR) (if present), sensors (\fB\-s\fR), RAID data (if present), partition +label (\fB\-l\fR), UUID (\fB\-u\fR), full swap data (\fB\-j\fR), and short form +of optical drives. .TP .B \-v 6 -\- Adds full mounted partition data (\fB\-p\fR), -unmounted partition data (\fB\-o\fR), optical drive data (\fB\-d\fR), -USB (\fB\-J\fR); triggers \fB\-xx\fR extra data option. +\- Adds full mounted partition data (\fB\-p\fR), unmounted partition data +(\fB\-o\fR), optical drive data (\fB\-d\fR), USB (\fB\-J\fR); triggers +\fB\-xx\fR extra data option. .TP .B \-v 7 -\- Adds network IP data (\fB\-i\fR), forced bluetooth (\fB\-E\fR), -Logical (\fB\-L\fR), RAID (\fB\-R\fR); triggers \fB\-xxx\fR +\- Adds network IP data (\fB\-i\fR), forced bluetooth (\fB\-E\fR), Logical +(\fB\-L\fR), RAID (\fB\-R\fR), full CPU flags/features (\fB\-f\fR), triggers +\fB\-xxx\fR .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 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 -Adds weather line. To get weather for an alternate location, use -\fB\-W [location]\fR. See also \fB\-x\fR, \fB\-xx\fR, \fB\-xxx\fR options. -Please note that your distribution's maintainer may chose to disable this -feature. +.B \-w \fR, \fB\-\-weather\fR +Adds weather line. To get weather for an alternate location, use \fB\-W +[location]\fR. See also \fB\-x\fR, \fB\-xx\fR, \fB\-xxx\fR options. Please note +that your distribution's maintainer may chose to disable this feature. DO NOT USE THIS FEATURE FOR AUTOMATED WEATHER UPDATES! Automated or excessive use will lead to your being blocked from any further access. This feature is not @@ -840,30 +829,239 @@ source message, it means that number has not been implemented. imperial (\fBi\fR), metric (imperial) (\fBmi\fR, default), imperial (metric) (\fBim\fR). If metric or imperial not found,sets to default value, or \fBN/A\fR. +.SH FILTER OPTIONS +The following options allow for applying various types of filtering to the +output. + .TP -.B \-y\fR,\fB \-\-width [integer]\fR -This is an absolute width override which sets the output line width max. -Overrides \fBCOLS_MAX_IRC\fR / \fBCOLS_MAX_CONSOLE\fR globals, or the -actual widths of the terminal. \fB80\fR is the minimum width supported. -\fB\-1\fR removes width limits. 1 switches to a single indented key/value -pair per line, and removes all long line wrapping (similar to -\fBdmidecode\fR output). +.B \-\-filter \fR, \fB\-\-filter\-override\fR +.br +See \fB\-z\fR, \fB\-Z\fR. -If no integer value is given, sets width to default of 80. +.TP +.B \-\-filter\-label\fR, \fB\-\-filter\-uuid\fR, \fB\-\-filter\-vulnerabilities\fR +.br +See \fB\-\-zl\fR, \fB\-\-zu\fR, \fB\-\-zv\fR. -Examples: \fBinxi \-Fxx\ \-y 130\fR or \fBinxi \-Fxxy\fR or \fBinxi \-bay1\fR +.TP +.B \-\-host\fR +Turns on hostname in System line. Overrides inxi config file value (if set): + +\fBSHOW_HOST='false'\fR \- Same as: \fBSHOW_HOST='true'\fR + +This is an absolute override, the host will always show no matter what +other switches you use. .TP -.B \-z\fR,\fB \-\-filter\fR -Adds security filters for IP addresses, serial numbers, MAC, -location (\fB\-w\fR), and user home directory name. Removes Host:. -On by default for IRC clients. +.B \-\-no\-host\fR +Turns off hostname in System line. This is default when using \fB\-z\fR, +for anonymizing inxi output for posting on forums or IRC. Overrides +configuration value (if set): + +\fBSHOW_HOST='true'\fR \- Same as: \fBSHOW_HOST='false'\fR + +This is an absolute override, the host will not show no matter what other +switches you use. + +.TP +.B \-z\fR, \fB\-\-filter\fR +Adds security filters for IP addresses, serial numbers, MAC, location +(\fB\-w\fR), and user home directory name. Removes Host:. On by default for IRC +clients. + +.TP +.B \-\-zl\fR, \fB\-\-filter\-label\fR +Filter partition label names from \fB\-j\fR, \fB\-o\fR, \fB\-p\fR, \fB\-P\fR, +and \fB\-Sa\fR (root=LABEL=...). Generally only useful in very specialized +cases. + +.TP +.B \-\-zu\fR, \fB\-\-filter\-uuid\fR +Filter partition UUIDs from \fB\-j\fR, \fB\-o\fR, \fB\-p\fR, \fB\-P\fR, and +\fB\-Sa\fR (root=UUID=...). Generally only useful in very specialized cases. .TP -.B \-Z\fR,\fB \-\-filter\-override\fR +.B \-\-zv\fR, \fB\-\-filter\-v\fR, \fB\-\-filter\-vulnerabilities\fR +Filter Vulnerabilities report from \fB\-Ca\fR. Generally only useful in very +specialized cases. + +.TP +.B \-Z \fR, \fB\-\-filter\-override \fR, \fB\-\-no\-filter\fR Absolute override for output filters. Useful for debugging networking issues in IRC for example. +.SH OUTPUT CONTROL OPTIONS +The following options allow for modifying the output in various ways. + +.TP +.B \-c \fR, \fB\-\-color\fR \fR[\fB0\fR\-\fB42\fR] +Set color scheme. If no scheme number is supplied, 0 is assumed. + +.TP +.B \-c \fR[\fB94\fR\-\fB99\fR] +These color selectors run a color selector option prior to inxi starting +which lets you set the config file value for the selection. + +NOTE: All configuration file set color values are removed when output is +piped or redirected. You must use the explicit runtime \fB\-c <color number>\fR +option if you want color codes to be present in the piped/redirected output. + +Color selectors for each type display (NOTE: IRC and global only show safe +color set): + +.TP +.B \-c 94\fR +\- Console, out of X. + +.TP +.B \-c 95\fR +\- Terminal, running in X \- like xTerm. + +.TP +.B \-c 96\fR +\- GUI IRC, running in X \- like XChat, Quassel, +Konversation etc. + +.TP +.B \-c 97\fR +\- Console IRC running in X \- like irssi in xTerm. + +.TP +.B \-c 98\fR +\- Console IRC not in X. + +.TP +.B \-c 99\fR +\- Global \- Overrides/removes all settings. + +Setting a specific color type removes the global color selection. + + +.TP +.B \-\-indent [11\-xx]\fR +Change primary wide indent width. Generally useless. Only applied if output +width is greater than max wrap width (see \fB\-\-max\-wrap\fR). Use +configuration item \fBINDENT\fR to make permanent. + +.TP +.B \-\-indents [0\-10]\fR +Change primary wrap mode, second, and -y1 level indents. First indent level only +applied if output width is less than max wrap width (see \fB\-\-max\-wrap\fR). 0 +disables all wrapped indents and all second level indents. Use configuration +item \fBINDENTS\fR to make permanent. + +.TP +.B \-\-limit [\-1 \- x]\fR +Raise or lower max output limit of IP addresses for \fB\-i\fR. \fB\-1\fR +removes limit. + +.TP +.B \-\-max\-wrap\fR, \fB\-\-wrap\-max [integer]\fR +Overrides default or configuration set line starter wrap width value. Wrap max +is the maximum width that inxi will wrap line starters (e.g. \fBInfo:\fR) to +their own lines, with data lines indented default 2 columns (use +\fB\-\-indents\fR to change). + +If terminal/console width or \fB\-\-width\fR is less than wrap width, wrapping +of line starter occurs. If \fB80\fR or less, no wrapping will occur. Overrides +internal default value (110) and user configuration value \fBMAX_WRAP\fR. + +.TP +.B \-\-output [json|screen|xml]\fR +Change data output type. Requires \-\-output\-file if not \fBscreen\fR. + +.TP +.B \-\-output\-file [full path to output file|print]\fR +The given directory path must exist. The directory path given must exist, +The \fBprint\fR options prints to stdout. +Required for non\-screen \fB\-\-output\fR formats (json|xml). + +.TP +.B \-\-partition\-sort [dev\-base|fs|id|label|percent\-used|size|uuid|used]\fR +Change default sort order of partition output. Corresponds to +\fBPARTITION_SORT\fR configuration item. These are the available sort options: + +\fBdev\-base\fR - \fB/dev\fR partition identifier, like \fB/dev/sda1\fR. +Note that it's an alphabetic sort, so \fBsda12\fR is before \fBsda2\fR. + +\fBfs\fR \- Partition filesystem. Note that sorts will be somewhat random if +all filesystems are the same. + +\fBid\fR \- Mount point of partition (default). + +\fBlabel\fR \- Label of partition. If partitions have no labels, +sort will be random. + +\fBpercent\-used\fR - Percentage of partition size used. + +\fBsize\fR \- KiB size of partition. + +\fBuuid\fR \- UUID of the partition. + +\fBused\fR \- KiB used of partition. + +.TP +.B \-\-wrap\-max [integer]\fR +.br +See \fB\-\-max-wrap\fR. + +.TP +.B \-y\fR, \fB\-\-width [integer]\fR +This is an absolute width override which sets the output line width max. +Overrides \fBCOLS_MAX_IRC\fR, \fBCOLS_MAX_NO_DISPLAY\fR, \fBCOLS_MAX_CONSOLE\fR +configuration items, or the actual widths of the terminal. + +* \fB\-y\fR \- sets default width of 80 columns. +.br +* \fB\-y [80-xxx]\fR \- sets width to given number. Must be 80 or more. +.br +* \fB\-y 1\fR \- switches to a single indented key/value pair per line, and +removes all long line wrapping (similar to \fBdmidecode\fR output). Not +recommended for use with \fB\-Y\fR; +.br +* \fB\-y \-1\fR \- removes width limits (if assigned by configuration items). + +Examples: +.br +\fBinxi \-Fxx \-y 130\fR +.br +\fBinxi \-Fxxy\fR +.br +\fBinxi \-bay1\fR + +.TP +.B \-Y\fR, \fB\-\-height\fR, \fB\-\-less [\-3\-[integer]\fR +Control output height. Useful when in console, and scrollback not available. +Breaks output flow based on values provided. + +* \fB\-Y 0\fR or \fB\-Y\fR \- Set default max height to terminal height. +.br +* \fB\-Y [1\-xxx]\fR \- set max output block height height in lines. +.br +* \fB\-Y \-1\fR \- Print out one primary data item block (like \fBCPU:\fR, +\fBSystem:\fR) at a time. Useful for very long outputs like \fB\-Fa\fR, +\fB\-v8\fR, etc. Not available for \fB\-h\fR. +.br +* \fB\-Y \-2\fR \- Do not disable output colors when redirected or piped to +another program. Useful if piping output to \fBless \-R\fR for example. This +does not limit the height otherwise since the expectation it is being piped to +another program like \fBless\fR which will handle that. +.br +* \fB\-Y \-3\fR \- Restore default unlimited output lines if \fBLINES_MAX\fR +configuration item set. + +Recommended to use the following for very clean up and down scrollable output +out of display, while retaining the color schemes, which are normally removed +with piping or redirect: + +\fBpinxi \-v8Y \-2 | less \-R\fR + +Note: since it's not possible for inxi to know how many actual terminal lines +are being used by terminal wrapped output, with \fB\-y 1\fR , it may be better +in general to use a fixed height like: + +\fB\-y 1 \-Y 20\fR instead of: \fB\-y 1 \-Y\fR + .SH EXTRA DATA OPTIONS These options can be triggered by one or more \fB\-x\fR. Alternatively, the \fB\-v\fR options trigger them in the following @@ -875,11 +1073,11 @@ data on various options. They can be added to any long form option list, e.g.: \fB\-bxx\fR or \fB\-Sxxx\fR There are 3 extra data levels: - +.br \fB\-x\fR, \fB\-xx\fR, \fB\-xxx\fR - +.br OR - +.br \fB\-\-extra 1\fR, \fB\-\-extra 2\fR, \fB\-\-extra 3\fR The following details show which lines / items display extra information for @@ -909,23 +1107,38 @@ without \fB\-x\fR. .TP .B \-x \-C\fR -\- Adds bogomips on CPU (if available) +\- Adds bogomips to CPU speed report (if available). + +\- Adds \fBL1:\fR and \fBL3:\fR cache types if either are present/available. For +BSD or legacy Linux, uses dmidecode + doas/sudo/root. Force use of dmidecode +cache values by adding \fB\-\-dmidecode\fR. This will override /sys based cache +data, which tends to be better, so in general don't do that. \- Adds \fBboost: [enabled|disabled]\fR if detected, aka \fBturbo\fR. Not all CPUs have this feature. \- Adds CPU Flags (short list). Use \fB\-f\fR to see full flag/feature list. -\- 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, model ID, -and stepping. +\- 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, model ID, and stepping. -Examples: \fBarch: Sandy Bridge rev: 2\fR, \fBarch: K8 rev.F+ rev: 2\fR +\- Adds, if smt (Simultaneous MultiThreading) is available but disabled, after +\fBtype:\fR data \fBsmt: disabled\fR. \fBtype: MT\fR means it's enabled. See +\fB\-Cxxx\fR. + +Examples: +.br +\fBarch: Sandy Bridge rev: 2\fR +.br +\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 +\- Adds CPU highest speed after \fBavg: [speed] high: [speed]\fR if greater than +1 core and cores have different speeds. Linux only. + .TP .B \-x \-d\fR \- Adds more items to \fBFeatures\fR line of optical drive; @@ -948,18 +1161,18 @@ If your \fBdrivetemp\fR module is not enabled, enable it: Once enabled, add \fBdrivetemp\fR to \fB/etc/modules\fR or \fB/etc/modules\-load.d/***.conf\fR so it starts automatically. -If you see drive temps running as regular user and you did not configure -system to use doas[BSDs]/sudo hddtemp, then your system supports this feature. -If no /sys data is found, inxi will try to use hddtemp methods instead for -that drive. Hint: if temp is /sys sourced, the temp will be to 1 decimal, -like 34.8, if hddtemp sourced, they will be integers. +If you see drive temps running as regular user and you did not configure system +to use doas/sudo hddtemp, then your system supports this feature. If no /sys +data is found, inxi will try to use hddtemp methods instead for that drive. +Hint: if temp is /sys sourced, the temp will be to 1 decimal, like 34.8, if +hddtemp sourced, they will be integers. Method 2: 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) -BSD users: see \fBman doas.conf\fR for setup. +doas users: see \fBman doas.conf\fR for setup. You can force use of \fBhddtemp\fR for all drives using \fB\-\-hddtemp\fR. @@ -1107,7 +1320,7 @@ found for each distribution system base detection. (\fB\-xt m\fR). .TP -.B \-x \-w\fR,\fB \-W\fR +.B \-x \-w \fR, \fB\-W\fR \- Adds humidity and barometric pressure. \- Adds wind speed and direction. @@ -1121,11 +1334,6 @@ found for each distribution system base detection. \- Adds serial number. .TP -.B \-xx \-C\fR -\- Adds \fBL1\-cache:\fR and \fBL3\-cache:\fR if either are available. -Requires dmidecode and doas[BSDs]/sudo/root. - -.TP .B \-xx \-D\fR \- Adds disk serial number. @@ -1270,7 +1478,7 @@ running. If none found, shows nothing. Uses a less accurate fallback tool \- Adds slot length. .TP -.B \-xx \-w\fR,\fB \-W\fR +.B \-xx \-w \fR, \fB\-W\fR \- Adds wind chill, heat index, and dew point, if available. \- Adds cloud cover, rain, snow, or precipitation (amount in previous hour @@ -1295,7 +1503,16 @@ data is simply not available as of 2018\-04\-03), location (only available from .TP .B \-xxx \-C\fR \- Adds CPU voltage and external clock speed (this is the motherboard speed). -Requires doas[BSDs]/sudo/root and \fBdmidecode\fR. +Requires doas/sudo/root and \fBdmidecode\fR. + +\- Adds, if smt (Simultaneous MultiThreading) data is available, after +\fBtype:\fR data \fBsmt: [status]\fR. +.br +\fBsmt: [status]\fR +.br +\fBMT\fR in \fBtype:\fR will show if smt is enabled in general. 3 values are +possible: [\fBenabled|disabled|<unsupported>\fR]. \fB<unsupported>\fR means the +CPU does not support SMT. .TP .B \-xxx \-D\fR @@ -1394,7 +1611,7 @@ These are the same as \fBctrl+alt+F[x]\fR numbers usually. Some systems have this, some don't, it varies. .TP -.B \-xxx \-w\fR,\fB \-W\fR +.B \-xxx \-w \fR, \fB\-W\fR \- Adds location (city state country), observation altitude (if available), weather observation time (if available), sunset/sunrise (if available). @@ -1419,34 +1636,51 @@ knows could possibly be used instead. \- Adds CPU family, model\-id, and stepping (replaces \fBrev\fR of \fB\-Cx\fR). Format is \fBhexadecimal (decimal)\fR if greater than 9, otherwise \fBhexadecimal\fR. + \- Adds CPU microcode. Format is \fBhexadecimal\fR. \- Adds socket type (for motherboard CPU socket, if available). If results doubtful will list two socket types and \fBnote: check\fR. Requires -doas[BSDs]/sudo/root and \fBdmidecode\fR. The item in parentheses may simply -be a different syntax for the same socket, but in general, check this before -trusting it. -.nf +doas/sudo/root and \fBdmidecode\fR. The item in parentheses may simply be a +different syntax for the same socket, but in general, check this before trusting +it. + Sample: \fBsocket: 775 (478) note: check\fR +.br Sample: \fBsocket: AM4\fR -.fi -\- Adds DMI CPU base and boost/turbo speeds. Requires doas[BSDs]/sudo/root and +\- Adds DMI CPU base and boost/turbo speeds. Requires doas/sudo/root and \fBdmidecode\fR. In some cases, like with overclocking or 'turbo' or 'boost' modes, voltage and external clock speeds may be increased, or short term limits -raised on max CPU speeds. These are often not reflected in /sys based -CPU \fBmin/max:\fR speed results, but often are using this source. +raised on max CPU speeds. These are often not reflected in /sys based CPU +\fBmin/max:\fR speed results, but often are using this source. Samples: -.nf +.br CPU not overclocked, with boost, like Ryzen: -\fBSpeed: 2861 MHz min/max: 1550/3400 MHz boost: enabled base/boost: 3400/3900\fR - +.nf +\fBSpeed (MHz): + avg: 2861 + high: 3250 + min/max: 1550/3400 + boost: enabled + base/boost: 3400/3900\fR +.fi Overclocked 2900 MHz CPU, with no boost available: -\fBSpeed: 2900 MHz min/max: 800/2900 MHz base/boost: 3350/3000\fR - +.nf +\fBSpeed (MHz): + avg: 2345 + high: 2900 + min/max: 800/2900 + base/boost: 3350/3000\fR +.fi Overclocked 3000 MHz CPU, with boosted max speed: -\fBSpeed: 4190 MHz min/max: 1200/3001 MHz base/boost: 3000/4000\fR +.nf +\fBSpeed (MHz): + avg: 3260 + high: 4190 + min/max: 1200/3001 + base/boost: 3000/4000\fR .fi Note that these numbers can be confusing, but basically, the \fBbase\fR @@ -1463,6 +1697,65 @@ boost/turbo mode speeds, and appear to be hard\-coded values, not dynamic real values. The \fBbase/boost:\fR values are sometimes real, and sometimes not. \fBbase\fR appears in general to be real. +\- Adds frequency \fBscaling: governor:.. driver:..\fR if found/available. + +\- Adds description of cache topology per cpu. Linux only. + +\- Creates new \fBTopology:\fR line after the \fBInfo:\fR line. Moves cache data +to this line from \fBInfo:\fR line. + +Topology line contains, if available and/or relevant: physical CPU count +(\fBcpus:\fR); per physical cpu core count (cores:\fR); threads per core, if > 1 +(\fBtpc:\fR); how many \fBthreads:\fR (if more threads than cores); \fBdies:\fR +(rarely detected, but if so, if > 1); smt status (if no smt status found, shows +\fBN/A\fR). + +If complex CPU type, like Alder lake, cores; will have a more granular breakdown +of how many mt (multi\-threaded) and how many st (single\-threaded) cores there +in the physical cpu ( \fBmt\-cores:\fR, \fBst\-cores:\fR); For complex CPU +types like ARM SoC devices with 2 CPU types, with different core counts and/or +\fBmin/max:\fR) frequencies, \fBvariant:\fR per type found, with relevant +differences shown, like \fBcores:, \fBmin/max:\fR, etc. + +.nf +\fBCPU: + Info: + model: AMD EPYC 7281 + bits: 64 + type: MT MCP MCM SMP + arch: Zen + family:0x17 (23) + model\-id:1 + stepping: 2 + microcode: 0x8001250 + Topology: + cpus: 2 + cores: 16 + tpc: 2 + threads: 32 + dies: 4 + cache: + L1: 2x 1.5 MiB (3 MiB) + desc: d\-16x32 KiB; i\-16x64 KiB + L2: 2x 8 MiB (16 MiB) + desc: 16x512 KiB + L3: 2x 32 MiB (64 MiB) + desc: 8x4 MiB + Speed (MHz): + avg: 1195 + high: 1197 + min/max: 1200/2100 + boost: enabled + scaling: + driver: acpi\-cpufreq + governor: ondemand + cores: + 1: 1195 + 2: 1196 + .... + bogomips: 267823 +.fi + \- Adds CPU Vulnerabilities (bugs) as known by your current kernel. Lists by \fBType: ... (status|mitigation): ....\fR for systems that support this feature (Linux kernel 4.14 or newer, or patched older kernels). @@ -1471,7 +1764,7 @@ values. The \fBbase/boost:\fR values are sometimes real, and sometimes not. .B \-a \-d\fR,\fB\-a \-D\fR \- Adds logical and physical block size in bytes. -Using \fBsmartctl\fR (requires doas[BSDs]/sudo/root privileges). +Using \fBsmartctl\fR (requires doas/sudo/root privileges). \- Adds device model family, like \fBCaviar Black\fR, if available. @@ -1558,15 +1851,15 @@ Sample (with both \fBxdpyinfo\fR and \fBxrandr\fR data available): .nf \fBinxi \-aG Graphics: - .... -Display: x11 server: X.Org 1.20.6 driver: loaded: modesetting -display ID: :0.0 screens: 1 -Screen\-1: 0 s\-res: 2560x1024 s\-dpi: 96 s\-size: 677x271mm (26.7x10.7") -s\-diag: 729mm (28.7") -Monitor\-1: DVI\-I\-0 res: 1280x1024 hz: 60 dpi: 96 -size: 338x270mm (13.3x10.6") diag: 433mm (17") -Monitor\-2: VGA\-0 res: 1280x1024 hz: 60 dpi: 86 -size: 376x301mm (14.8x11.9") diag: 482mm (19") + .... + Display: x11 server: X.Org 1.20.6 driver: loaded: modesetting + display ID: :0.0 screens: 1 + Screen\-1: 0 s\-res: 2560x1024 s\-dpi: 96 s\-size: 677x271mm (26.7x10.7") + s\-diag: 729mm (28.7") + Monitor\-1: DVI\-I\-0 res: 1280x1024 hz: 60 dpi: 96 + size: 338x270mm (13.3x10.6") diag: 433mm (17") + Monitor\-2: VGA\-0 res: 1280x1024 hz: 60 dpi: 86 + size: 376x301mm (14.8x11.9") diag: 482mm (19") ....\fR .fi \- Adds, if present, possible \fBalternate:\fR kernel modules capable of @@ -1584,15 +1877,15 @@ with 0 packages listed. Moves to \fBRepos\fR if \fB\-ra\fR. .nf \fBinxi \-aI Info: - .... - Init: systemd v: 245 runlevel: 5 Compilers: gcc: 9.3.0 alt: 5/6/7/8/9 - Packages: apt: 3681 lib: 2096 rpm: 0 Shell: ksh v: A_2020.0.0 default: Bash - v: 5.0.16 running\-in: kate inxi: 3.1.04\fR + .... + Init: systemd v: 245 runlevel: 5 Compilers: gcc: 9.3.0 alt: 5/6/7/8/9 + Packages: apt: 3681 lib: 2096 rpm: 0 Shell: ksh v: A_2020.0.0 default: Bash + v: 5.0.16 running\-in: kate inxi: 3.1.04\fR .fi \- Adds service control tool, tested for in the following order: \fBsystemctl -rc-service rcctl service sv /etc/rc.d /etc/init.d\fR - useful to know which -you need when using an unfamiliar machine. +rc\-service rcctl service sv /etc/rc.d /etc/init.d\fR. Can be useful to know +which you need when using an unfamiliar machine. .TP .B \-a \-j\fR, \fB\-a \-P\fR [swap], \fB\-a \-P\fR [swap] @@ -1728,12 +2021,15 @@ Shortcut, legacy. See \fB\-\-force dmidecode\fR. Force inxi to use Curl, Fetch, Perl, or Wget for downloads. .TP -.B \-\-force [dmidecode|hddtemp|lsusb|pkg|usb-sys|vmstat|wmctl]\fR +.B \-\-force [colors|dmidecode|hddtemp|lsusb|pkg|usb-sys|vmstat|wmctrl]\fR Various force options to allow users to override defaults. Values be given as a comma separated list: \fBinxi \-MJ --force dmidecode,lsusb\fR +\- \fBcolors\fR \- Same as \fB\-Y \-2\fR . Do not remove colors from piped or +redirected output. + \- \fBdmidecode\fR \- Force use of \fBdmidecode\fR. This will override \fB/sys\fR data in some lines, e.g. \fB\-M\fR or \fB\-B\fR. @@ -1758,7 +2054,7 @@ data source instead of \fBlsusb\fR (Linux only). \- \fBvmstat\fR \- Forces use of vmstat for memory data. -\- \fBwmctl\fR \- Force \fBSystem\fR item \fBwm\fR to use \fBwmctrl\fR +\- \fBwmctrl\fR \- Force \fBSystem\fR item \fBwm\fR to use \fBwmctrl\fR as data source, override default \fBps\fR source. .TP @@ -1766,26 +2062,12 @@ as data source, override default \fBps\fR source. Shortcut, legacy. See \fB\-\-force hddtemp\fR. .TP -.B \-\-host\fR -Turns on hostname in System line. Overrides inxi config file value (if set): - -\fBSHOW_HOST='false'\fR \- Same as: \fBSHOW_HOST='true'\fR - -This is an absolute override, the host will always show no matter what -other switches you use. - -.TP .B \-\-html\-wan\fR Temporary override of \fBNO_HTML_WAN\fR configuration item. Only use to test w/wo HTML downloaders for WAN IP. Restores default behavior for WAN IP, which is use HTML downloader if present and if dig failed. .TP -.B \-\-limit [\-1 \- x]\fR -Raise or lower max output limit of IP addresses for \fB\-i\fR. \fB\-1\fR -removes limit. - -.TP .B \-\-man\fR Updates / installs man page with \fB\-U\fR if \fBpinxi\fR or using \fB\-U 3\fR dev branch. (Only active if \fB\-U\fR is is not disabled by maintainers). @@ -1795,6 +2077,7 @@ dev branch. (Only active if \fB\-U\fR is is not disabled by maintainers). Overrides default use of \fBdig\fR to get WAN IP address. Allows use of normal downloader tool to get IP addresses. Only use if dig is failing, since dig is much faster and more reliable in general than other methods. + .TP .B \-\-no\-doas\fR Skips the use of doas to run certain internal features (like \fBhddtemp\fR, @@ -1806,18 +2089,6 @@ this option, or \fBNO_DOAS\fR configuration item. See \fB\-\-no\-sudo\fR if you need to disable both types. .TP -.B \-\-no\-host\fR -Turns off hostname in System line. This is default when using \fB\-z\fR, -for anonymizing inxi output for posting on forums or IRC. Overrides -configuration value (if set): -indent\-min - -\fBSHOW_HOST='true'\fR \- Same as: \fBSHOW_HOST='false'\fR - -This is an absolute override, the host will not show no matter what other -switches you use. - -.TP .B \-\-no\-html-wan\fR Overrides use of HTML downloaders to get WAN IP address. Use either only dig, or do not get wan IP. Only use if dig is failing, and the HTML downloaders are @@ -1852,40 +2123,6 @@ requires configuration to setup anyway for these options) just use this option, or \fBNO_SUDO\fR configuration item. .TP -.B \-\-output [json|screen|xml]\fR -Change data output type. Requires \-\-output\-file if not \fBscreen\fR. - -.TP -.B \-\-output\-file [full path to output file|print]\fR -The given directory path must exist. The directory path given must exist, -The \fBprint\fR options prints to stdout. -Required for non\-screen \fB\-\-output\fR formats (json|xml). - -.TP -.B \-\-partition\-sort [dev\-base|fs|id|label|percent\-used|size|uuid|used]\fR -Change default sort order of partition output. Corresponds to -\fBPARTITION_SORT\fR configuration item. These are the available sort options: - -\fBdev\-base\fR - \fB/dev\fR partition identifier, like \fB/dev/sda1\fR. -Note that it's an alphabetic sort, so \fBsda12\fR is before \fBsda2\fR. - -\fBfs\fR \- Partition filesystem. Note that sorts will be somewhat random if -all filesystems are the same. - -\fBid\fR \- Mount point of partition (default). - -\fBlabel\fR \- Label of partition. If partitions have no labels, -sort will be random. - -\fBpercent\-used\fR - Percentage of partition size used. - -\fBsize\fR \- KiB size of partition. - -\fBuuid\fR \- UUID of the partition. - -\fBused\fR \- KiB used of partition. - -.TP .B \-\-pkg\fR Shortcut. See \fB\-\-force pkg\fR. @@ -1965,6 +2202,10 @@ You can see what inxi believed started it in the \fB\-Ixxx\fR line, \fBShell:\fR or \fBClient:\fR item. Please let us know what that result was so we can add it to the parent start program whitelist. +In some cases, you may want to also use \fB\-\-no\-filter\fR/\fB\-Z\fR option if +you want to see filtered values. Filtering is turned on by default if \fBinxi\fR +believes it is running in an IRC client. + .TP .B \-\-usb\-sys\fR Shortcut, legacy. See \fB\-\-force usb\-sys\fR @@ -1989,21 +2230,7 @@ Same as configuration value (example): .B \-\-wm\fR Shortcut, legacy. See \fB\-\-force wmctl\fR. -.TP -.B \-\-wrap\-max [integer]\fR -Overrides default or configuration set line starter wrap width value. Wrap -max is the maximum width that inxi will wrap line starters (e.g. \fBInfo:\fR) -to their own lines, with data lines indented only 2 columns. If -terminal/console width or \fB\-\-width\fR is less than wrap width, wrapping -of line starter occurs. If \fB80\fR or less, no wrapping will occur. Overrides -internal default value (90) and user configuration value: - -\fBWRAP_MAX=85\fR (previously \fBINDENT_MIN\fR) - -Previously called: \fB\-\-indent\-min\fR. - .SH DEBUGGING OPTIONS - .TP .B \-\-dbg 1\fR \- Debug downloader failures. Turns off silent/quiet mode for curl, wget, and @@ -2059,7 +2286,6 @@ For alternate ftp upload locations: Example: \fBinxi \-\-ftp \fIftp.yourserver.com/incoming\fB \-\-debug 21\fR .SH DEBUGGING OPTIONS TO DEBUG DEBUGGER FAILURES - 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. @@ -2086,7 +2312,7 @@ Skip /sys debugging in case of a hang. .TP .B \-\-debug\-sys\fR -Force PowerPC debugger parsing of /sys as doas[BSDs]/sudo/root. +Force PowerPC debugger parsing of /sys as doas/sudo/root. .TP .B \-\-debug\-sys\-print\fR @@ -2178,13 +2404,14 @@ these up, and for a complete list of options: .B Basic Options Here's a brief overview of the basic options you are likely to want to use: -\fBCOLS_MAX_CONSOLE\fR The max display column width on terminal. -If terminal/console width or \fB\-\-width\fR is less than wrap width, -wrapping of line starter occurs +\fBCOLS_MAX_CONSOLE\fR The max display column width on terminal. If +terminal/console width or \fB\-\-width\fR is less than wrap width, wrapping of +line starter occurs + \fBCOLS_MAX_IRC\fR The max display column width on IRC clients. -\fBCOLS_MAX_NO_DISPLAY\fR The max display column width in console, out of GUI -desktop. +\fBCOLS_MAX_NO_DISPLAY\fR The max display column width in out of X / Wayland / +desktop / window manager. \fBCPU_SLEEP\fR Decimal value \fB0\fR or more. Default is usually around \fB0.35\fR seconds. Time that inxi will 'sleep' before getting CPU speed data, @@ -2197,9 +2424,25 @@ downloaders. \fBFILTER_STRING\fR Default \fB<filter>\fR. Any string you prefer to see instead for filtered values. +\fBINDENT\fR Change primary indent width of wide mode output. See +\fB\-\-indent\fR. + +\fBINDENTS\fR Change primary indents of narrow wrapped mode output, and second +level indents. See \fB\-\-indents\fR. + \fBLIMIT\fR Overrides default of \fB10\fR IP addresses per IF. This is only of interest to sys admins running servers with many IP addresses. +\fBLINES_MAX\fR Values: [\-2\-xxx]. See \fB\-Y\fR for explanation and values. +Use \fB\-Y \-3\fR to restore default unlimited output lines. Avoid using this in +general unless the machine is a headless system and you want the output to be +always controlled. + +\fBMAX_WRAP\fR (or \fBWRAP_MAX\fR) The maximum width where the line starter +wraps to its own line. If terminal/console width or \fB\-\-width\fR is less than +wrap width, wrapping of line starter occurs. Overrides default. See +\fB\-\-max\-wrap\fR. If \fB80\fR or less, wrap will never happen. + \fBNO_DIG\fR Set to \fB1\fR or \fBtrue\fR to disable WAN IP use of \fBdig\fR and force use of alternate downloaders. @@ -2250,11 +2493,6 @@ Values 4\-9 are not currently supported, but this can change at any time. \fBWEATHER_UNIT\fR Values: [\fBm\fR|\fBi\fR|\fBmi\fR|\fBim\fR]. Same as \fB\-\-weather\-unit\fR. -\fBWRAP_MAX\fR (previously \fBINDENT_MIN\fR) The maximum width where the line -starter wraps to its own line. If terminal/console width or \fB\-\-width\fR is -less than wrap width, wrapping of line starter occurs. Overrides default. -See \fB\-\-wrap\-max\fR. If \fB80\fR or less, wrap will never happen. - .TP .B Color Options It's best to use the \fB\-c [94\-99]\fR color selector tool to set the @@ -2337,10 +2575,14 @@ Jarett.Stevens \- \fBdmidecode \-M\fR patch for older systems with no .SH SPECIAL THANKS TO THE FOLLOWING -The nice people at irc.oftc.net channels #linux\-smokers\-club and #smxi, -who all really have to be considered to be co\-developers because of their -non\-stop enthusiasm and willingness to provide real\-time testing and -debugging of inxi development. +The nice people at irc.oftc.net channels #linux\-smokers\-club and #smxi, who +all really have to be considered to be co\-developers because of their non\-stop +enthusiasm and willingness to provide real\-time testing and debugging of inxi +development over the years. + +LinuxQuestions.org Slackware forum members, for major help with development and +debugging new or refactored features, particularly the redone CPU logic of +2021\-12. Siduction forum members, who have helped get some features working by providing a large number of datasets that have revealed possible variations, particularly |