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
65           implementing 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
97           distribution of Crypt::SSLeay), the user agent string is no longer
98           sent to the proxy (but will continue to be sent to the remote
99           host).
100
101           The previous behaviour was of marginal benefit, and could cause
102           fatal errors in certain scenarios (see CPAN bug #4759) and so no
103           longer happens by default.
104
105           To reinstate the old behaviour, call
106           "Net::SSL::send_useragent_to_proxy" with a true value (usually 1).
107

DIAGNOSTICS

109         "no port given for proxy server <proxy>"
110
111       A proxy was specified for configuring a socket, but no port number was
112       given. Ensure that the proxy is specified as a host:port pair, such as
113       "proxy.example.com:8086".
114
115         "configure certs failed: <contents of $@>; <contents of $!>"
116
117         "proxy connect failed: <contents of $@>; <contents of $!>"
118
119         "Connect failed: <contents of $@>; <contents of $!>"
120
121       During connect().
122
123   SEE ALSO
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.10.1                      2007-09-17                       Net::SSL(3)
Impressum