xmpp-dns(1) - A CLI tool to check XMPP SRV records.

1. xmpp-dns(1)
3. xmpp-dns(1)

## NAME

`xmpp-dns` - A CLI tool to check XMPP SRV records.

## SYNOPSIS

`xmpp-dns` [-46cfstv] [--client-dtls value] [--client-stls value] [--dot] [--force-fallback] [--help] [--no-color] [--resolver value] [--server-dtls value] [--server-stls value] [--timeout value] [--tls-version value] [--version] xmpp-server

## DESCRIPTION

A little CLI tool to check SRV records for XMPP. Beside showing the records it can also try to connect to the server and also test StartTLS and direct TLS.

## OPTIONS

`-4`
  Resolve IPv4.
`-6`
  Resolve IPv6.
`-c`, `--client`
  Show client SRV records.
`--client-dtls`=[value]
  Add an arbitrary target for C2S with direct TLS in the form domain:port. Can be invoked several times.
`--client-stls`=[value]
  Add an arbitrary target for C2S with StartTLS in the form domain:port. Can be invoked several times.
`--dot`
  Use DoT, see also `--resolver`.
`-f`, `--fallback`
  Check fallback (standard ports on A/AAAA records) if no SRV records are provided.
`--force-fallback`
  Additionally heck fallback (standard ports on A/AAAA records) even if SRV records are provided.
`--help`
  Show help.
`--no-color`
  Don't colorize output.
`--resolver`
  Custom resolver e.g. "1.1.1.1" for common DNS or "5.1.66.255#dot.ffmuc.net" for usage with "--dot".
`-s`, `--server`
  Show server SRV records.
`--server-dtls`=[value]
  Add an arbitrary target for S2S with direct TLS in the form domain:port. Can be invoked several times.
`--server-stls`=[value]
  Add an arbitrary target for S2S with StartTLS in the form domain:port. Can be invoked several times.
`-t`
  Test connection and certificates. Xmpp-dns will print [OK] for passed tests, [Not OK] for failed tests and [WARN] if all tests are passed but the certificate expires within the next 14 days.
`--timeout`=[value]
  Connection timeout in seconds. Default: 60.
`--tls-version`=[value]
  Minimal TLS version. 10 (TSLv1.0), 11 (TLSv1.1), 12 (TLSv1.2) or 13 (TLSv1.3). Default: 12.
`-v`
  Resolve IPs.
`--version`
  Show version information.

## SHELL COMPLETION

### ZSH

There are no shell completions yet (contributions welcome) but for zsh it is possible to automatically create completions from `--help` which might work good enough.

Just place the following in your `~/.zshrc` or `~/.zshrc.local`:

    compdef _gnu_generic xmpp-dns

### FISH

There are no shell completions yet, but FISH can generate them from the man page with following command:

    fish_update_completions

## CHAT

There is no dedicated chat for `xmpp-dns`, but feel free to join https://join.jabber.network/#go-sendxmpp@chat.mdosch.de?join.

## AUTHOR

Written by Martin Dosch.

## REPORTING BUGS

Report bugs at https://salsa.debian.org/mdosch/xmpp-dns/issues.

## COPYRIGHT

Copyright (c) Martin Dosch License: BSD-2-clause License

2. January 2026
3. xmpp-dns(1)