Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Net::SSLGlue::FTP(3)  User Contributed Perl Documentation Net::SSLGlue::FTP(3)

NAME
       Net::SSLGlue::FTP - extend Net::FTP for FTPS (SSL) and IPv6

SYNOPSIS
	   use Net::SSLGlue::FTP;
	   # SSL right from start
	   my $ftps = Net::FTP->new( $host,
	       SSL => 1,
	       SSL_ca_path => ...
	   );

	   # SSL through upgrade of plain connection
	   my $ftp = Net::FTP->new( $host );
	   $ftp->starttls( SSL_ca_path => ... );

	   # change protection mode to unencrypted|encrypted
	   $ftp->prot('C'); # clear
	   $ftp->prot('P'); # protected

DESCRIPTION
       Net::SSLGlue::FTP extends Net::FTP so one can either start directly
       with SSL	or switch later	to SSL using starttls method (AUTH TLS
       command).  If IO::Socket::IP or IO::Socket::INET6 are installed it will
       also transparently use IPv6.

       By default it will take care to verify the certificate according	to the
       rules for FTP implemented in IO::Socket::SSL.

METHODS
       new The method "new" of Net::FTP	is now able to start directly with SSL
	   when	the argument "<SSL =" 1>> is given. One	can give the usual
	   "SSL_*" parameter of	IO::Socket::SSL	to "Net::FTP::new".

       starttls
	   If the connection is	not yet	SSLified it will issue the "AUTH TLS"
	   command and change the object, so that SSL will now be used.

       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.

       All of these methods can	take the "SSL_*" parameter from
       IO::Socket::SSL to change the behavior of the SSL connection. The
       following parameters are	especially useful:

       SSL_ca_path, SSL_ca_file
	   Specifies the path or a file	where the CAs used for checking	the
	   certificates	are located. This is typically "etc/ssl/certs" on UNIX
	   systems.

       SSL_verify_mode
	   If set to 0,	verification of	the certificate	will be	disabled. By
	   default it is set to	1 which	means that the peer certificate	is
	   checked.

       SSL_verifycn_name
	   Usually the name given as the hostname in the constructor is	used
	   to verify the identity of the certificate. If you want to check the
	   certificate against another name you	can specify it with this
	   parameter.

SEE ALSO
       IO::Socket::SSL,	Net::FTP, Net::SSLGlue::Socket

COPYRIGHT
       This module is copyright	(c) 2013, 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.32.1			  2015-10-25		  Net::SSLGlue::FTP(3)

NAME | SYNOPSIS | DESCRIPTION | METHODS | SEE ALSO | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Net::SSLGlue::FTP&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help