aboutsummaryrefslogtreecommitdiffstats
path: root/inxi.1
diff options
context:
space:
mode:
Diffstat (limited to 'inxi.1')
-rw-r--r--inxi.176
1 files changed, 63 insertions, 13 deletions
diff --git a/inxi.1 b/inxi.1
index 2380dcd..5429073 100644
--- a/inxi.1
+++ b/inxi.1
@@ -1,4 +1,4 @@
-.TH INXI 1 "2018\-12\-31" inxi "inxi manual"
+.TH INXI 1 "2019\-02\-07" inxi "inxi manual"
.SH NAME
inxi \- Command line system information script for console and IRC
.SH SYNOPSIS
@@ -446,15 +446,16 @@ 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\-\-usb\fR); triggers \fB\-xx\fR extra data option.
+optical drive data (\fB\-d\fR), USB (\fB\-\-usb\fR); triggers \fB\-xx\fR extra data
+option.
.TP
.B \-v 7
\- Adds network IP data (\fB\-i\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. Note, this depends on an unreliable API so it may not always
@@ -462,14 +463,28 @@ be working in the future. To get weather for an alternate location, use
\fB\-W\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.
.TP
-.B \-W\fR,\fB \-\-weather\-location <location_string>\fR
-Get weather/time for an alternate location. Accepts postal/zip code,
+.B \-W\fR, \fB\-\-weather\-location <location_string>\fR
+Get weather/time for an alternate location. Accepts postal/zip code[, country],
city,state pair, or latitude,longitude. Note: city/country/state names must not
-contain spaces. Replace spaces with '\fB+\fR' sign. Don't place spaces around any commas.
-Use only ASCII letters in city/state/country names, sorry.
+contain spaces. Replace spaces with '\fB+\fR' sign. Don't place spaces around
+any commas. Postal code is not reliable except for North America and maybe the UK.
+Try postal codes with and without country code added.
-Examples: \fB\-W 95623\fR OR \fB\-W Boston,MA\fR OR \fB\-W45.5234,\-122.6762\fR
-OR \fB\-W new+york,ny\fR OR \fB\-W bodo,norway\fR.
+Use only ASCII letters in city/state/country names.
+
+Examples: \fB\-W 95623,us\fR OR \fB\-W Boston,MA\fR OR
+\fB\-W 45.5234,\-122.6762\fR OR \fB\-W new+york,ny\fR OR \fB\-W bodo,norway\fR.
+.TP
+.B \-\-weather\-source\fR, \fB\-\-ws <unit>\fR
+[\fB0\-9\fR] Switches weather data source. 0 uses a legacy source which may vanish
+any day. \fB1\-9\fR use different remote sources. \fB2\fR may not support city /
+country names with spaces (even if you use the \fB+\fR sign instead of space).
+\fB3\fR offers pretty good data, but may not have all small city names for
+\fB\-W\fR.
+
+More data sources will be added as time permits, so try each one and
+see which you prefer. If you get unsupported source message, it means that number
+has not been implemented.
.TP
.B \-\-weather\-unit <unit>\fR
[\fBm\fR|\fBi\fR|\fBmi\fR|\fBim\fR] Sets weather units to metric (\fBm\fR), imperial (\fBi\fR),
@@ -747,7 +762,10 @@ if \fBps\fR tests fail to find data.
\- Adds vendor:chip id.
.TP
.B \-xx \-w\fR,\fB \-W\fR
-\- Adds wind chill, heat index, and dew point if any of these are available.
+\- Adds wind chill, heat index, and dew point, if available.
+
+\- Adds cloud cover, rain, snow, or precipitation (amount in previous hour
+to observation time), if available.
.TP
.B \-xxx \-A\fR
\- Adds, if present, serial number.
@@ -826,7 +844,8 @@ lxpanel, xfce4\-panel, lxqt\-panel, tint2, cairo-dock, trayer, and many others.
\- Adds, if available, USB speed in \fBMbits/s\fR or \fBGbits/s\fR.
.TP
.B \-xxx \-w\fR,\fB \-W\fR
-\- Adds location (city state country), altitude, weather observation time.
+\- Adds location (city state country), observation altitude (if available),
+weather observation time (if available), sunset/sunrise (if available).
.SH ADMIN EXTRA DATA OPTIONS
These options are triggered with \fB\-\-admin\fR or \fB\-a\fR. Admin options are
@@ -1041,6 +1060,18 @@ Forces the USB data generator to use \fBlsusb\fR as data source. Overrides
\fBUSB_SYS\fR in user configuration file(s).
.TP
+.B \-\-wan\-ip\-url [URL]\fR
+Force \fB\-i\fR to use supplied URL as WAN IP source. Overrides dig or
+default IP source urls. URL must start with http[s] or ftp.
+
+The IP address from the URL must be the last item on the last (non-empty) line
+of the page content source code.
+
+Same as configuration value (example):
+
+\fBWAN_IP_URL='https://mysite.com/ip.php'\fR
+
+.TP
.B \-\-wm\fR
Force \fBSystem\fR item \fBwm\fR to use \fBwmctrl\fR as data source,
override default \fBps\fR source.
@@ -1048,6 +1079,12 @@ override default \fBps\fR source.
.SH DEBUGGING OPTIONS
.TP
+.B \-\-dbg 1\fR
+\- Debug downloader failures. Turns off silent/quiet mode for curl, wget, and
+fetch. Shows more downloader action information. Shows some more information
+for Perl downloader.
+
+.TP
.B \-\-debug [1\-3]\fR
\- On screen debugger output. Output varies depending on current needs
Usually nothing changes.
@@ -1238,6 +1275,19 @@ above configuration page on smxi.org for full info.
\fBUSB_SYS\fR Forces all USB data to use \fB/sys\fR instead of \fBlsusb\fR.
+\fBWAN_IP_URL\fR Forces \fB\-i\fR to use supplied URL, and to not use dig (dig is
+generally much faster). URL must begin with http or ftp. Note that if you use this,
+the downloader set tests will run each time you start inxi whether a downloader feature
+is going to be used or not.
+
+The IP address from the URL must be the last item on the last (non-empty) line of
+the URL's page content source code.
+
+Same as \fB\-\-wan\-ip\-url [URL]\fR
+
+\fBWEATHER_SOURCE\fR Values: [\fB0-9\fR]. Same as \fB\-\-weather\-source\fR. Values
+4-9 are not currently supported, but this can change at any time.
+
\fBWEATHER_UNIT\fR Values: [\fBc\fR|\fBf\fR|\fBcf\fR|\fBfc\fR]. Same as \fB\-\-weather\-unit\fR.
.TP