1Net::POP3S(3)         User Contributed Perl Documentation        Net::POP3S(3)
2
3
4

NAME

6       Net::POP3S - SSL/STARTTLS support for Net::POP3
7

SYNOPSYS

9           use Net::POP3S;
10
11           my $ssl = 'ssl';   # 'ssl' / 'starttls'|'stls' / undef
12
13           my $pop3 = Net::POP3S->new("pop.example.com", Port => 995, doSSL => $ssl);
14

DESCRIPTION

16       This module implements a wrapper for Net::POP3, enabling
17       over-SSL/STARTTLS support.  This module inherits all the methods from
18       Net::POP3. You may use all the friendly options that came bundled with
19       Net::POP3.  You can control the SSL usage with the options of new()
20       constructor method.  'doSSL' option is the switch, and, If you would
21       like to control detailed SSL settings, you can set SSL_* options that
22       are brought from IO::Socket::SSL. Please see the document of
23       IO::Socket::SSL about these options detail.
24
25       Just one method difference from the Net::POP3, you may select POP AUTH
26       mechanism as the third option of auth() method.
27
28       As of Version 3.10 of Net::POP3(libnet) includes SSL/STARTTLS
29       capabilities, so this wrapper module's significance disappareing.
30

CONSTRUCTOR

32       new ( [ HOST ] [, OPTIONS ] )
33           A few options added to Net::POP3(2.X).
34
35           doSSL { "ssl" | "starttls" | undef } - to specify SSL connection
36           type.  "ssl" makes connection wrapped with SSL, "starttls" uses
37           POP3 command "STLS".
38

METHODS

40       Most of all methods of Net::POP3 are inherited as is, except auth().
41
42       auth ( USERNAME, PASSWORD [, AUTHMETHOD])
43           Attempt SASL authentication through Authen::SASL module. AUTHMETHOD
44           is your required method of authentication, like 'CRAM-MD5',
45           'LOGIN', ... etc. the default is 'CRAM-MD5'.
46
47       starttls ( SSLARGS )
48           Upgrade existing plain connection to SSL.
49

SEE ALSO

51       Net::POP3, IO::Socket::SSL, Authen::SASL
52

AUTHOR

54       Tomo.M <tomo at cpan org>
55
57       Copyright (C) 2020 by Tomo.M
58
59       This library is free software; you can redistribute it and/or modify it
60       under the same terms as Perl itself, either Perl version 5.8.8 or, at
61       your option, any later version of Perl 5 you may have available.
62
63
64
65perl v5.36.0                      2022-07-22                     Net::POP3S(3)
Impressum