go-xmpp/cmd/xmpp-check/README.md

# XMPP Check

XMPP check is a tool to check TLS certificate on a remote server.

## Installation

To install `xmpp-check` in your Go path:

```
$ go get -u gosrc.io/xmpp/cmd/xmpp-check
```

## Usage

```
$ xmpp-check --help
Usage:
  xmpp-check <host[:port]> [flags]

Examples:
xmpp-check chat.sum7.eu:5222 --domain meckerspace.de

Flags:
  -d, --domain string   domain if host handle multiple domains
  -h, --help            help for xmpp-check
```

If you server is on standard port and XMPP domains matches the hostname you can simply use:

```
$ xmpp-check chat.sum7.eu
 info All checks passed
   ⇢  address="chat.sum7.eu" domain=""
   ⇢  main.go:43 main.runCheck
   ⇢  2019-07-16T22:01:39.765+02:00
```

You can also pass the port and the XMPP domain if different from the server hostname:

```
$ xmpp-check chat.sum7.eu:5222 --domain meckerspace.de
 info All checks passed
   ⇢  address="chat.sum7.eu:5222" domain="meckerspace.de"
   ⇢  main.go:43 main.runCheck
   ⇢  2019-07-16T22:01:33.270+02:00
```

Error code will be non-zero in case of error. You can thus use it directly with your usual 
monitoring scripts.