aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorLibravatarUbuntuForumsCouncil <ubuntu-forums-council@lists.ubuntu.com>2015-05-02 16:55:13 +0100
committerLibravatarUbuntuForumsCouncil <ubuntu-forums-council@lists.ubuntu.com>2015-05-02 16:55:13 +0100
commit489181a67264498c34e9d1a5cf699c8df6c5b04f (patch)
treed239e9a1131825f0cf9846ebf8032afc6b139b9c /README.md
downloadwireless-info-489181a67264498c34e9d1a5cf699c8df6c5b04f.tar.bz2
wireless-info-489181a67264498c34e9d1a5cf699c8df6c5b04f.tar.xz
wireless-info-489181a67264498c34e9d1a5cf699c8df6c5b04f.tar.zst
Adding README file and wireless-info script.
Diffstat (limited to 'README.md')
-rw-r--r--README.md31
1 files changed, 31 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9d8dc11
--- /dev/null
+++ b/README.md
@@ -0,0 +1,31 @@
+# Wireless Info
+
+This script gathers the infos necessary for troubleshooting a wireless connection
+and saves them in a text file, wrapping it in an archive if it exceeds the 19.5 kB
+size limit for `.txt` attachments on the Ubuntu Forums.
+
+## Details
+
+- Creates the file `wireless-info.txt` at the location it is run from.
+- Additionally creates the archive `wireless-info.tar.gz` if the file exceeds 19.5 kB in size.
+- Masks all sensitive info, like MAC addresses and WPA/WEP keys, automatically in a meaningful way.
+- Offers to post the results to your default `pastebinit` provider if the program is installed,
+ and a sufficiently reliable internet connection is available.
+
+## Run from CLI
+
+You can either run it from the command line with these commands:
+
+ wget -N -t 5 -T 10 https://github.com/UbuntuForums/wireless-info/raw/master/wireless-info && \
+ chmod +x wireless-info && \
+ ./wireless-info
+
+This will download the script, make it executable, and run it, all in a row.
+
+## Run from GUI
+
+Or, if `zenity` or `kdialog` is installed, run it from the GUI this way:
+
+1. [Download](https://github.com/UbuntuForums/wireless-info/raw/master/wireless-info) the script
+2. Make it executable
+3. Run it from your file browser or a Run dialog