NAME

       Net::SSLGlue::Socket - socket which can be either SSL or plain IP (IPv4/IPv6)

SYNOPSIS

           use Net::SSLGlue::Socket;
           # SSL right from start
           my $ssl = Net::SSLGlue::Socket->new(
               PeerHost => ...,  # IPv4|IPv6 address
               PeerPort => ...,
               SSL => 1,
               SSL_ca_path => ...
           );

           # SSL through upgrade of plain connection
           my $plain = Net::SSLGlue::Socket->new(...);
           $plain->start_SSL( SSL_ca_path => ... );
           ...
           $plain->stop_SSL

DESCRIPTION

       First, it is recommended to use IO::Socket::SSL directly instead of this module, since this kind of
       functionality is available in IO::Socket::SSL since version 1.994.

       Net::SSLGlue::Socket implements a socket which can be either plain or SSL.  If IO::Socket::IP or
       IO::Socket::INET6 are installed it will also transparently handle IPv6 connections.

       A socket can be either start directly with SSL or it can be start plain and later be upgraded to SSL
       (because of a STARTTLS commando or similar) and also downgraded again.

       It is possible but not recommended to use the socket in non-blocking mode, because in this case special
       care must be taken with SSL (see documentation of IO::Socket::SSL).

       Additionally to the usual socket methods the following methods are defined or extended:

METHODS

       new The  method  "new" of Net::SSLGlue::Socket can have the argument SSL. If this is true the SSL upgrade
           will be done immediately. If not set any SSL_* args will still be saved and used at a later start_SSL
           call.

       start_SSL
           This will upgrade the plain socket to SSL. See IO::Socket::SSL  for  arguments  to  "start_SSL".  Any
           SSL_* arguments given to new will be applied here too.

       stop_SSL
           This will downgrade the socket from SSL to plain.

       peer_certificate ...
           Once  the  SSL  connection  is  established  you  can  use  this  method to get information about the
           certificate. See the IO::Socket::SSL documentation.

       can_read(timeout)
           This will check for available data. For a plain socket this will  only  use  "select"  to  check  the
           socket,  but for SSL it will check if there are any pending data before trying a select.  Because SSL
           needs to read the whole frame before decryption can be done, a successful return of  can_read  is  no
           guarantee  that  data  can  be  read  immediately,  only that new data are either available or in the
           process of arriving.

SEE ALSO

       IO::Socket::SSL

COPYRIGHT

       This module is copyright (c) 2013..2015, Steffen Ullrich.  All Rights  Reserved.   This  module  is  free
       software. It may be used, redistributed and/or modified under the same terms as Perl itself.

perl v5.36.0                                       2022-12-06                          Net::SSLGlue::Socket(3pm)