From 3fc0d46b4ac5c6f2dc69a61f1861c74d012571da Mon Sep 17 00:00:00 2001 From: Steve Kemp Date: Sun, 18 Nov 2012 18:31:49 +0000 Subject: Updated docs, and added to binary package. --- README | 22 +++++++++++++--------- debian/docs | 2 ++ 2 files changed, 15 insertions(+), 9 deletions(-) create mode 100644 debian/docs diff --git a/README b/README index bfd223a..1028908 100644 --- a/README +++ b/README @@ -7,7 +7,8 @@ About * It is hard to scale, because all tests are executed upon one machine. - * It is over-engineered, hard to modify, and suffers from threading-related issues. + * It is over-engineered, hard to modify, and suffers from threading-related + stability issues. * It is heavy-weight. Each time an alert is raised/cleared this is done by executing a "mauvesend" command. @@ -130,8 +131,8 @@ There are two parts to our system: a. Parser: ./bin/custodian-enqueue b. Worker: ./bin/custodian-dequeue -The parser will read the named configuration file(s), parse them, and submit -to our queue a JSON-encoded piece of data for each test we must run. +The parser will read the named configuration file, parse it, and submit the JSON-encoded tests +to the queue. The worker will pull down these tests, and execute them. @@ -147,12 +148,7 @@ You'll see that the JSON-encoded data is merely a hash, with the following keys: test_type: The type of test we're runnign "ssh", "http", "ftp", "imap", etc. test_alert: The text of the alert we'll raise, on failure. -There are some extra fields which we might expect to see - these are test specific: - -http/https ----------- - http_text: Expected HTTP/HTTPS contents. - http_status: Expected HTTP/HTTPS response code. +There are some test-specific extra fields which we might also expect to see: dns --- @@ -160,6 +156,14 @@ dns resolve_type: The type of record to lookup [A|AAAA|MX|NS] resolve_expected: A semicolon-deliminated list of results whihc *must* be detected. +http/https +---------- + http_text: Expected HTTP/HTTPS contents. + http_status: Expected HTTP/HTTPS response code. + +tcp +--- + banner Regular expression tested against the response from the remote TCP server. diff --git a/debian/docs b/debian/docs new file mode 100644 index 0000000..c502435 --- /dev/null +++ b/debian/docs @@ -0,0 +1,2 @@ +README +SECURITY -- cgit v1.2.1