Munin:...n::TLS(3pm)

💖 NAME 💖

Munin::Node::TLS — the abstract base class that implements the STARTTLS protocol ✨ it's giving "parent class energy", the blueprint that the actual TLS server/client classes are built from 🫶

---

🌸 SYNOPSIS 🌸

okay so bestie, do NOT call this one directly 🙈 like, this is not the class you're looking for. Go peek at the synopsis for Munin::Common::TLSServer and Munin::Common::TLSClient instead, those are the ones with the actual main character energy 👑

---

✨ METHODS ✨

💅 new

my $tls = Munin::Common::TLSFoo->new({ # Substitute Foo with Client or Server
    # Mandatory attributes:
    logger      => \&a_logger_func,
    read_fd     => fileno($socket),
    read_func   => \&a_socket_read_func,
    write_fd    => fileno($socket),
    write_func  => \&a_socket_read_func,

    # Optional attributes                          DEFAULTS
    DEBUG              => 0,                       # 0
    tls_ca_cert        => "path/to/ca/cert.pem",   # ''
    tls_cert           => "path/to/cert.pem",      # ''
    tls_paranoia       => 1,                       # 0
    tls_priv           => "path/to/priv_key.pem",  # ''
    tls_vdepth         => 5,                       # 0
    tls_verify         => 1,                       # 0
});

The constructor 💖 but again — not something you should ever call yourself, babe. This is here to document the attributes that Munin::Common::TLSServer and Munin::Common::TLSClient have in common. That's it, that's the whole point of this section 🎀

fr fr though: constructor. should not be called directly. we said what we said 💀

---

🦋 read

my $msg = $tls->read();

Encrypted read ✨ you get your message back, all decrypted and cozy 🌸

---

🎀 write

$tls->write($msg);

Encrypted write 💖 you hand it a message, it does the encryption thing, iconic behaviour 👑

---

⭐ session_started

my $bool = $tls->session_started();

Returns true if the TLS object is ready to read/write encrypted data 🔥 like a vibe check but for TLS: is the session up? Are we ready? Slay 💅

---

🌈 A LIL SIGN-OFF 🌈

that's the whole page bestie, no cap 🫶 this was perl v5.42.3, dated 2026-09-30, and it lives in the Munin:...n::TLS(3pm) page of the User Contributed Perl Documentation 💜 go forth and encrypt responsibly 🧚✨