Net::POP3S(3)

💖 Net::POP3S 💖

okay so bestie, we're looking at a page from the User Contributed Perl Documentation and it's literally called Net::POP3S(3). yes the name is the same as the command, that's just how perl docs roll. let's get into it 🫶

---

✨ NAME ✨

Net::POP3S — SSL/STARTTLS support for Net::POP3

---

🌸 SYNOPSYS 🌸

(not me keeping the typo, it's in the original and I refuse to gaslight you 💅)

use Net::POP3S;

my $ssl = 'ssl';   # 'ssl' / 'starttls'|'stls' / undef

my $pop3 = Net::POP3S->new("pop.example.com", Port => 995, doSSL => $ssl);

---

🦋 DESCRIPTION 🦋

So basically this module is a little wrapper around Net::POP3 that adds over-SSL/STARTTLS support. it inherits all the methods from Net::POP3, so every single friendly option that came bundled with Net::POP3? yeah you get all of those, no cap. 👑

You control the SSL usage with options on the new() constructor method. the doSSL option is the switch — that's the main character here. and if you wanna control detailed SSL settings, you can set SSL_* options that are brought from IO::Socket::SSL. for the deets on those, go read the IO::Socket::SSL documentation. iykyk 📚

There's literally just one method difference from Net::POP3: you can select the POP AUTH mechanism as the third option of the auth() method. that's it, that's the whole glow-up.

⚠️ important lore: as of Version 3.10 of Net::POP3 (libnet) includes SSL/STARTTLS capabilities, so this wrapper module's significance is disappareing. (their spelling, not mine 🫣) so like... it ate, but its era is kinda ending bestie.

---

🎀 CONSTRUCTOR 🎀

new ( [ HOST ] [, OPTIONS ] )

A few options added to Net::POP3(2.X). 💫

• doSSL { "ssl" | "starttls" | undef } — this one specifies the SSL connection type. "ssl" makes the connection wrapped with SSL, and "starttls" uses the POP3 command "STLS". pick your fighter 💅

---

💜 METHODS 💜

Most of all methods of Net::POP3 are inherited as is — except auth(). the one diva that does its own thing. 🙈

auth ( USERNAME, PASSWORD [, AUTHMETHOD])

Attempt SASL authentication through the Authen::SASL module. AUTHMETHOD is your required method of authentication, like 'CRAM-MD5', 'LOGIN', ... etc. the default is 'CRAM-MD5'. ✨

starttls ( SSLARGS )

Upgrade an existing plain connection to SSL. glow-up in real time, no surgery needed 🌈

---

🔥 SEE ALSO 🔥

• Net::POP3
• IO::Socket::SSL
• Authen::SASL

---

👑 AUTHOR 👑

Tomo.M <tomo at cpan org>

---

🌸 COPYRIGHT AND LICENSE 🌸

Copyright (C) 2020 by Tomo.M

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.

---

and that's the whole page bestie 💖 this was Net::POP3S(3) from the User Contributed Perl Documentation, brought to you by perl v5.42.0, dated 2025-07-25. slay, stay encrypted, and don't forget your doSSL ✨🎀🦋