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

NAME

6       Net::SSL - support for Secure Sockets Layer
7

METHODS

9       new Creates a new "Net::SSL" object.
10
11       configure
12           Configures a "Net::SSL" socket for operation.
13
14       configure_certs
15           Sets up a certificate file to use for communicating with on the
16           socket.
17
18       connect
19       die_with_error
20       get_cipher
21       get_lwp_object
22           Walks up the caller stack and looks for something blessed into the
23           "LWP::UserAgent" namespace and returns it. Vaguely deprecated.
24
25       get_peer_certificate
26           Gets the peer certificate from the underlying "Crypt::SSLeay::Conn"
27           object.
28
29       get_peer_verify
30       get_shared_ciphers
31       getchunk
32           Attempts to read up to 32KiB of data from the socket. Returns
33           "undef" if nothing was read, otherwise returns the data as a
34           scalar.
35
36       pending
37           Provides access to OpenSSL's "pending" attribute on the SSL
38           connection object.
39
40       getline
41           Reads one character at a time until a newline is encountered, and
42           returns the line, including the newline. Grossly inefficient.
43
44       print
45           Concatenates the input parameters and writes them to the socket.
46           Does not honour $, nor $/. Returns the number of bytes written.
47
48       printf
49           Performs a "sprintf" of the input parameters (thus, the first
50           parameter must be the format), and writes the result to the socket.
51           Returns the number of bytes written.
52
53       proxy
54           Returns the hostname of an https proxy server, as specified by the
55           "HTTPS_PROXY" environment variable.
56
57       proxy_connect_helper
58           Helps set up a connection through a proxy.
59
60       read
61           Performs a read on the socket and returns the result.
62
63       ssl_context
64       sysread
65           Is an alias of "read".
66
67       timeout
68           Returns the timeout value of the socket as defined by the
69           implementing class or 60 seconds by default.
70
71       blocking
72           Returns a boolean indicating whether the underlying socket is in
73           blocking mode. By default, Net::SSL sockets are in blocking mode.
74
75               $sock->blocking(0); # set to non-blocking mode
76
77           This method simply calls the underlying "blocking" method of the
78           IO::Socket object.
79
80       write
81           Writes the parameters passed in (thus, a list) to the socket.
82           Returns the number of bytes written.
83
84       syswrite
85           Is an alias of "write".
86
87       accept
88           Not yet implemented. Will die if called.
89
90       getc
91           Not yet implemented. Will die if called.
92
93       getlines
94           Not yet implemented. Will die if called.
95
96       ungetc
97           Not yet implemented. Will die if called.
98
99       send_useragent_to_proxy
100           By default (as of version 2.80 of "Net::SSL" in the 0.54
101           distribution of Crypt::SSLeay), the user agent string is no longer
102           sent to the proxy (but will continue to be sent to the remote
103           host).
104
105           The previous behaviour was of marginal benefit, and could cause
106           fatal errors in certain scenarios (see CPAN bug #4759) and so no
107           longer happens by default.
108
109           To reinstate the old behaviour, call
110           "Net::SSL::send_useragent_to_proxy" with a true value (usually 1).
111

DIAGNOSTICS

113         "no port given for proxy server <proxy>"
114
115       A proxy was specified for configuring a socket, but no port number was
116       given. Ensure that the proxy is specified as a host:port pair, such as
117       "proxy.example.com:8086".
118
119         "configure certs failed: <contents of $@>; <contents of $!>"
120
121         "proxy connect failed: <contents of $@>; <contents of $!>"
122
123         "Connect failed: <contents of $@>; <contents of $!>"
124
125       During connect().
126
127   SEE ALSO
128       IO::Socket::INET
129           "Net::SSL" is implemented by subclassing "IO::Socket::INET", hence
130           methods not specifically overridden are defined by that package.
131
132       Net::SSLeay
133           A package that provides a Perl-level interface to the "openssl"
134           secure sockets layer library.
135
136
137
138perl v5.32.0                      2020-07-28                       Net::SSL(3)