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       getline
37           Reads one character at a time until a newline is encountered, and
38           returns the line, including the newline. Grossly inefficient.
39
40       print
41           Concatenates the input parameters and writes them to the socket.
42           Does not honour $, nor $/. Returns the number of bytes written.
43
44       printf
45           Performs a "sprintf" of the input parameters (thus, the first
46           parameter must be the format), and writes the result to the socket.
47           Returns the number of bytes written.
48
49       proxy
50           Returns the hostname of an https proxy server, as specified by the
51           "HTTPS_PROXY" environment variable.
52
53       proxy_connect_helper
54           Helps set up a connection through a proxy.
55
56       read
57           Performs a read on the socket and returns the result.
58
59       ssl_context
60       sysread
61           Is an alias of "read".
62
63       timeout
64           Returns the timeout value of the socket as defined by the imple‐
65           menting class or 60 seconds by default.
66
67       blocking
68           Returns a boolean indicating whether the underlying socket is in
69           blocking mode. By default, Net::SSL sockets are in blocking mode.
70
71               $sock->blocking(0); # set to non-blocking mode
72
73           This method simply calls the underlying "blocking" method of the
74           IO::Socket object.
75
76       write
77           Writes the parameters passed in (thus, a list) to the socket.
78           Returns the number of bytes written.
79
80       syswrite
81           Is an alias of "write".
82
83       accept
84           Not yet implemented. Will die if called.
85
86       getc
87           Not yet implemented. Will die if called.
88
89       getlines
90           Not yet implemented. Will die if called.
91
92       ungetc
93           Not yet implemented. Will die if called.
94
95       send_useragent_to_proxy
96           By default (as of version 2.80 of "Net::SSL" in the 0.54 distribu‐
97           tion of Crypt::SSLeay), the user agent string is no longer sent to
98           the proxy (but will continue to be sent to the remote host).
99
100           The previous behaviour was of marginal benefit, and could cause
101           fatal errors in certain scenarios (see CPAN bug #4759) and so no
102           longer happens by default.
103
104           To reinstate the old behaviour, call "Net::SSL::send_usera‐
105           gent_to_proxy" with a true value (usually 1).
106

DIAGNOSTICS

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