convert documentation to markdown

This commit is contained in:
Jan Dittberner 2015-02-11 22:48:33 +01:00
parent e215567b31
commit 22eecd2616
3 changed files with 59 additions and 59 deletions

1
.gitignore vendored
View file

@ -1,3 +1,4 @@
.*.swp .*.swp
.ropeproject/ .ropeproject/
README.html README.html
changes.html

103
README.md
View file

@ -1,9 +1,7 @@
=========================================== # check_xmppng - check plugin for XMPP
check_xmppng - nagios/icinga check for XMPP
===========================================
This program implements a nagios check plugin for XMPP servers implementing the This program implements a nagios check plugin for XMPP servers implementing the
XMPP protocol as specified in `RFC 6120 <http://tools.ietf.org/html/rfc6120>`_. XMPP protocol as specified in [RFC 6120](http://tools.ietf.org/html/rfc6120).
The program implements the following features: The program implements the following features:
@ -13,24 +11,22 @@ The program implements the following features:
* check the validity of the server certificate presented by the XMPP server * check the validity of the server certificate presented by the XMPP server
The plugin has been implemented because of insufficiencies in check_ssl_cert The plugin has been implemented because of insufficiencies in check_ssl_cert
and the existing `check_xmpp and the existing [check_xmpp](https://exchange.icinga.org/exchange/check_xmpp).
<https://exchange.icinga.org/exchange/check_xmpp>`_.
Maximum acceptable timeouts as well as minimum acceptable number of days the Maximum acceptable timeouts as well as minimum acceptable number of days the
server certificate needs to be valid can be specified as command line server certificate needs to be valid can be specified as command line
parameters. For a full list of parameters see the *Usage* section below. parameters. For a full list of parameters see the *Usage* section below.
Dependencies ## Dependencies
------------
The program is implemented in Python 3 and uses the following libraries besides The program is implemented in Python 3 and uses the following libraries besides
the Python standard library: the Python standard library:
* `defusedxml <https://pypi.python.org/pypi/defusedxml/>`_ to sanitize XML from * [defusedxml](https://pypi.python.org/pypi/defusedxml/) to sanitize XML from
the XMPP server the XMPP server
* `nagiosplugin <https://pypi.python.org/pypi/nagiosplugin>`_ to take care of * [nagiosplugin](https://pypi.python.org/pypi/nagiosplugin) to take care of the
the nagios plugin interface boilerplate code nagios plugin interface boilerplate code
The software has been developed and tested with the following versions: The software has been developed and tested with the following versions:
@ -39,8 +35,7 @@ The software has been developed and tested with the following versions:
* nagiosplugin 1.2.2 * nagiosplugin 1.2.2
License ## License
-------
check_xmppng is free software: you can redistribute it and/or modify it under check_xmppng is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software the terms of the GNU General Public License as published by the Free Software
@ -52,55 +47,53 @@ WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details. PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with You should have received a copy of the GNU General Public License along with
this program in the file ``COPYING``. If not, see this program in the file `COPYING`. If not, see
<http://www.gnu.org/licenses/>. http://www.gnu.org/licenses/.
Usage ## Usage
-----
.. code:: ```
usage: check_xmpp [-h] -H HOST_ADDRESS [-p PORT] [--s2s | --c2s] [-4 | -6]
[--servername SERVERNAME] [--starttls] [-w SECONDS]
[-c SECONDS] [--no-check-certificates] [-r CAROOTS]
[--warn-days WARNDAYS] [--crit-days CRITDAYS] [-v]
usage: check_xmpp [-h] -H HOST_ADDRESS [-p PORT] [--s2s | --c2s] [-4 | -6] Check XMPP services
[--servername SERVERNAME] [--starttls] [-w SECONDS]
[-c SECONDS] [--no-check-certificates] [-r CAROOTS]
[--warn-days WARNDAYS] [--crit-days CRITDAYS] [-v]
Check XMPP services optional arguments:
-h, --help show this help message and exit
optional arguments: -H HOST_ADDRESS, --host-address HOST_ADDRESS
-h, --help show this help message and exit host address
-H HOST_ADDRESS, --host-address HOST_ADDRESS -p PORT, --port PORT port
host address --s2s server to server (s2s)
-p PORT, --port PORT port --c2s client to server (c2s)
--s2s server to server (s2s) -4, --ipv4 enforce IPv4
--c2s client to server (c2s) -6, --ipv6 enforce IPv6
-4, --ipv4 enforce IPv4 --servername SERVERNAME
-6, --ipv6 enforce IPv6 server name to be used
--servername SERVERNAME --starttls check whether the service allows starttls
server name to be used -w SECONDS, --warning SECONDS
--starttls check whether the service allows starttls return warning if connection setup takes longer than
-w SECONDS, --warning SECONDS SECONDS
return warning if connection setup takes longer than -c SECONDS, --critical SECONDS
SECONDS return critical if connection setup takes longer than
-c SECONDS, --critical SECONDS SECONDS
return critical if connection setup takes longer than --no-check-certificates
SECONDS do not check whether the XMPP server's certificate is
--no-check-certificates valid
do not check whether the XMPP server's certificate is -r CAROOTS, --ca-roots CAROOTS
valid path to a file or directory where CA certifcates can
-r CAROOTS, --ca-roots CAROOTS be found
path to a file or directory where CA certifcates can --warn-days WARNDAYS set state to WARN if the certificate is valid for not
be found more than the given number of days
--warn-days WARNDAYS set state to WARN if the certificate is valid for not --crit-days CRITDAYS set state to CRITICAL if the certificate is valid for
more than the given number of days not more than the given number of days
--crit-days CRITDAYS set state to CRITICAL if the certificate is valid for -v, --verbose
not more than the given number of days ```
-v, --verbose
Contact ## Contact
-------
If you want to provide feedback or bug reports please send me a mail to If you want to provide feedback or bug reports please send me a mail to
jan (at) dittberner [dot] info. jan (at) dittberner [dot] info.

View file

@ -1,12 +1,18 @@
version 0.1.1 2015-02-11 # change log
------------------------
## version 0.1.2 2015-02-11
* first icinga exchange release
* convert documentation to markdown
* add icingaexchange.yml
## version 0.1.1 2015-02-11
* rename to xmpp_checkng to avoid clash with existing xmpp_check on Icinga * rename to xmpp_checkng to avoid clash with existing xmpp_check on Icinga
exchange exchange
* add proper documentation * add proper documentation
version 0.1 2015-02-11 ## version 0.1 2015-02-11
----------------------
* support S2S and C2S checks * support S2S and C2S checks
* support STARTTLS handling * support STARTTLS handling