From 22fc09cfd2305850063d2bbdd3af76237caf2e73 Mon Sep 17 00:00:00 2001
From: onefang
Date: Tue, 25 Jun 2019 15:08:34 +1000
Subject: Add the actual source code, and the basic documentation.

Still need to write the help output.
---
 README.md | 95 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 95 insertions(+)
 create mode 100644 README.md

(limited to 'README.md')

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..415025c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,95 @@
+Lua script for checking the health of Devuan Linux package mirrors.
+
+This is currently under development, not everything has been written yet.
+
+mirror-checker-lua is a Lua script used by the Devuan mirror admins
+(maybe, if they like it) to check the health of Devuan Linux package
+mirrors.  Originally there was bash scripts for this job, then Evilham
+wrote some Python scripts, now onefang has written it in Lua.  We all
+have different tastes in languages.  lol
+
+The main difference is that this Lua version tries to do everything, and
+will be maintained.  Currently the shell scripts and Python scripts are
+actually being used I think.  Evilham asked me to write this, after I
+badgered him about his Python scripts.
+
+The source code is at https://sledjhamr.org/cgit/mirror-checker-lua/
+
+The issue tracker is at https://sledjhamr.org/mantisbt/project_page.php?project_id=13
+
+
+Installation.
+-------------
+
+Download the source.  You may want to put the actual mirror-checker.lua
+in someplace liku /usr/local/bin and make sure it is executable.
+
+It should run on any recent Linux, you'll need to have the following
+installed -
+
+Luajit
+
+wget
+
+dig, part of BIND.  On Debian based systems it'll be in the dnsutils
+package.
+
+LuaSocket, on Debian based systems it'll be in the lua-socket package.
+
+ionice, on Debian based systems it'll be in the util-linux package.
+
+
+Using it.
+---------
+
+These examples assume you are running it from the source code directory. 
+A directory will be created called results, it'll be full of log files
+and any files that get downloaded.  There will also be results/email and
+results/web directories, with the notification email and web pages with
+the easy to read emails (once I write that bit).
+
+Note that unlike typical commands, you can't run single character options
+together, so this is wrong -
+
+./mirror-checker.lua -vvv
+
+Instead do this -
+
+./mirror-checker.lua -v -v -v
+
+Just run the script to do all of the tests -
+
+./mirror-checker.lua
+
+Which will print any errors.  If you don't want to see errors -
+
+./mirror-checker.lua -q
+
+If you want to see warnings to (as usual, the more -v options, the more
+details) -
+
+./mirror-checker.lua -v
+
+Or use the usual options for the help and version number -
+
+./mirror-checker.lua -h 
+./mirror-checker.lua --help
+./mirror-checker.lua --version
+
+To run the tests on a specific mirror, for example pkgmaster.devuan.org -
+
+./mirror-checker.lua pkgmaster.devuan.org
+
+You can use the --tests option to tune which tests are run, for example
+to stop IPv6 tests, coz you don't have IPv6 -
+
+./mirror-checker.lua --tests=-IPv6
+
+To do the same, but not run the HTTPS tests either -
+
+./mirror-checker.lua --tests=-IPv6,-https
+
+To only run the http integrity tests, only on IPv6 -
+
+./mirror-checker.lua --tests=http,Integrity,IPv6
+
-- 
cgit v1.1