Net::SSL(3pm) - phpMan

Net::SSL(3)                    User Contributed Perl Documentation                    Net::SSL(3)



NAME
       Net::SSL - support for Secure Sockets Layer

METHODS
       new Creates a new "Net::SSL" object.

       configure
           Configures a "Net::SSL" socket for operation.

       configure_certs
           Sets up a certificate file to use for communicating with on the socket.

       connect
       die_with_error
       get_cipher
       get_lwp_object
           Walks up the caller stack and looks for something blessed into the "LWP::UserAgent"
           namespace and returns it. Vaguely deprecated.

       get_peer_certificate
           Gets the peer certificate from the underlying "Crypt::SSLeay::Conn" object.

       get_peer_verify
       get_shared_ciphers
       getchunk
           Attempts to read up to 32KiB of data from the socket. Returns "undef" if nothing was
           read, otherwise returns the data as a scalar.

       getline
           Reads one character at a time until a newline is encountered, and returns the line,
           including the newline. Grossly inefficient.

       print
           Concatenates the input parameters and writes them to the socket.  Does not honour $,
           nor $/. Returns the number of bytes written.

       printf
           Performs a "sprintf" of the input parameters (thus, the first parameter must be the
           format), and writes the result to the socket.  Returns the number of bytes written.

       proxy
           Returns the hostname of an https proxy server, as specified by the "HTTPS_PROXY"
           environment variable.

       proxy_connect_helper
           Helps set up a connection through a proxy.

       read
           Performs a read on the socket and returns the result.

       ssl_context
       sysread
           Is an alias of "read".

       timeout
           Returns the timeout value of the socket as defined by the implementing class or 60
           seconds by default.

       blocking
           Returns a boolean indicating whether the underlying socket is in blocking mode. By
           default, Net::SSL sockets are in blocking mode.

               $sock->blocking(0); # set to non-blocking mode

           This method simply calls the underlying "blocking" method of the IO::Socket object.

       write
           Writes the parameters passed in (thus, a list) to the socket. Returns the number of
           bytes written.

       syswrite
           Is an alias of "write".

       accept
           Not yet implemented. Will die if called.

       getc
           Not yet implemented. Will die if called.

       getlines
           Not yet implemented. Will die if called.

       ungetc
           Not yet implemented. Will die if called.

       send_useragent_to_proxy
           By default (as of version 2.80 of "Net::SSL" in the 0.54 distribution of
           Crypt::SSLeay), the user agent string is no longer sent to the proxy (but will
           continue to be sent to the remote host).

           The previous behaviour was of marginal benefit, and could cause fatal errors in
           certain scenarios (see CPAN bug #4759) and so no longer happens by default.

           To reinstate the old behaviour, call "Net::SSL::send_useragent_to_proxy" with a true
           value (usually 1).

DIAGNOSTICS
         "no port given for proxy server <proxy>"

       A proxy was specified for configuring a socket, but no port number was given. Ensure that
       the proxy is specified as a host:port pair, such as "proxy.example.com:8086".

         "configure certs failed: <contents of $@>; <contents of $!>"

         "proxy connect failed: <contents of $@>; <contents of $!>"

         "Connect failed: <contents of $@>; <contents of $!>"

       During connect().

   SEE ALSO
       IO::Socket::INET
           "Net::SSL" is implemented by subclassing "IO::Socket::INET", hence methods not
           specifically overridden are defined by that package.

       Net::SSLeay
           A package that provides a Perl-level interface to the "openssl" secure sockets layer
           library.



perl v5.16.3                                2012-07-30                                Net::SSL(3)

Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2024-04-24 16:30 @18.219.236.62 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)