Protocol::SOCKS(3)

💖 NAME 💖

Protocol::SOCKS — abstract support for the SOCKS5 network protocol.

Bestie. It's giving plumbing. This is the module that handles the SOCKS5 protocol so you don't have to rawdog the byte stream yourself. Abstract support, no cap.

---

✨ VERSION ✨

Version 0.003.

---

🦋 DESCRIPTION 🦋

Okay so, real talk: the DESCRIPTION section is literally empty in the source. No notes. Not a single sentence. We just go straight into the methods. Iconic behaviour honestly. 💅

---

🌸 METHODS 🌸

🎀 new

Instantiates this protocol object. That's it, that's the whole job — it makes you a fresh protocol object.

🎀 version

Our protocol version. Usually 5. (iykyk — it's SOCKS5, so yeah.)

🎀 write

Called when we want to write data. Requires a writer to be configured — so like, if you haven't set one up, that's a you problem. Configure your writer first, bestie. 🫶

🎀 new_future

Instantiates a new Future using the provided factory, or calls through to Future->new. Your factory, your rules — and if you didn't bring one, it falls back to the classic.

🎀 pack_fqdn

Packs a fully-qualified domain into a data structure.

🎀 pack_ipv4

Packs an IPv4 address into a data structure.

🎀 pack_ipv6

Packs an IPv6 address into a data structure.

🎀 pack_address

Packs an address of the given type into a data structure.

🎀 extract_address

Extracts address information from a scalar ref. Unpacking arc, we love to see it. ✨

---

👑 SEE ALSO 👑

• Net::SOCKS
• POE::Component::Client::SOCKS
• POE::Component::Proxy::SOCKS
• LWP::Protocol::socks
• IO::Stream::Proxy::SOCKSv5
• IO::Socket::Socks

The whole SOCKS extended universe fr fr. 🌈

---

🍓 AUTHOR 🍓

Tom Molesworth <cpan@perlsite.co.uk>

---

💜 LICENSE 💜

Copyright Tom Molesworth 2014. Licensed under the same terms as Perl itself.

---

And that's a wrap, gorgeous — this page came to you courtesy of perl v5.42.0, dated 2025-07-25, and yes, Protocol::SOCKS(3) really did eat and leave no crumbs. Go forth and proxy responsibly. 🧚💖