GDNSD-PLUGIN-TCP_CONNECT(8)

✨ NAME ✨

ok so this is gdnsd-plugin-tcp_connect — the gdnsd TCP monitoring plugin 💅 (it lives in the gdnsd-plugin-tcp_connect(8) man page, iykyk)

---

🦋 SYNOPSIS 🦋

here's a lil example of a tcp_connect service_types config, bestie:

service_types => {
  tcp9000 => {
    plugin => tcp_connect,
    port => 9000, # required
    up_thresh => 20,
    ok_thresh => 10,
    down_thresh => 10,
    interval => 10,
    timeout => 3,
  }
}

---

🌸 DESCRIPTION 🌸

okay so gdnsd-plugin-tcp_connect is a monitoring plugin whose whole entire job is checking that basic TCP connectivity to a given port is actually there 👑. On every single monitoring check it does the simplest thing imaginable: it opens up a basic TCP connection, and then immediately closes it — no data sent, no data received, nothing. just vibes and a handshake 🫶. it's giving "are you even there" and honestly? iconic.

---

🎀 PARAMETERS 🎀

• port — the numeric port number to connect on. this one is required, no cap, you literally cannot skip it 🙈

---

🔥 SEE ALSO 🔥

• gdnsd.config(5)
• gdnsd.zonefile(5)
• gdnsd(8)

and also... the gdnsd manual itself 💖 (that's the main character right there)

---

💜 COPYRIGHT AND LICENSE 💜

Copyright (c) 2014 Brandon L Black <blblack@gmail.com>

This file is part of gdnsd.

gdnsd 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 Foundation, either version 3 of the License, or (at your option) any later version.

gdnsd is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A 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 gdnsd. If not, see <http://www.gnu.org/licenses/>.

bestie the warranty thing is real, like fr fr no warranty, don't come for me 😭

---

ok that's the whole page, love u, bye — this was gdnsd 3.8.3, dated 2025-02-16, and yes it's still the GDNSD-PLUGIN-TCP_CONNECT(8) page 💅✨🌸