XMPP-DNS(1)

πŸ’– XMPP-DNS πŸ’–

okay bestie, welcome to the xmpp-dns(1) page β€” it's a General Commands Manual situation and honestly? it's giving "tiny tool, big energy" πŸŽ€


✨ NAME ✨

xmpp-dns β€” a CLI tool to check XMPP SRV records. that's it, that's the whole vibe πŸ’…


🌸 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 πŸ¦‹

so it's literally a little CLI tool that checks SRV records for XMPP πŸ‘‘ and no cap, it does more than just show you the records β€” it can also try to connect to the server, and even test StartTLS and direct TLS for you. obsessed fr fr ✨


πŸ’… 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. you can invoke it several times, go off 🌈
  • --client-stls=[value] β€” add an arbitrary target for C2S with StartTLS, in the form domain:port. also invokable 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 check fallback (standard ports on A/AAAA records) even if SRV records ARE provided. forceful. main character energy πŸ”₯
  • --help β€” show help πŸŽ€
  • --no-color β€” don't colorize output (sad but valid) πŸ™ˆ
  • --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 😭 (we love a warning)
  • --timeout=[value] β€” connection timeout in seconds. Default: 60 ⏱️
  • --tls-version=[value] β€” minimal TLS version. 10 (TLSv1.0), 11 (TLSv1.1), 12 (TLSv1.2) or 13 (TLSv1.3). Default: 12 πŸ”
  • -v β€” resolve IPs 🌐
  • --version β€” show version information πŸ‘‘

🐚 SHELL COMPLETION 🐚

πŸ’œ ZSH

bestie. there are no shell completions yet (contributions welcome, fr fr πŸ₯Ί) but for zsh you can 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 either, but FISH can generate them from the man page with the following command:

fish_update_completions

πŸ’¬ CHAT πŸ’¬

there is no dedicated chat for xmpp-dns, but feel free to join us: https://join.jabber.network/#go-sendxmpp@chat.mdosch.de?join 🫢 come hang out, it's giving community πŸŽ€


πŸ‘‘ AUTHOR πŸ‘‘

written by Martin Dosch. icon behavior, honestly πŸ’…


πŸ› REPORTING BUGS πŸ›

report bugs at https://salsa.debian.org/mdosch/xmpp-dns/issues β€” do NOT suffer in silence, bestie, we wanna know 😭


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


okay that's the whole page, you ATE that read πŸ“ no cap, go check those SRV records, bestie πŸ’– this was the XMPP-DNS(1) manual, General Commands Manual, and the page is dated August 2026 β€” so like, future-coded of us 🌈 periodt ✨

πŸ“¦ where this page comes from