lwp::protocol::socks4(3pm) [debian man page]

LWP::Protocol::socks4(3pm)				User Contributed Perl Documentation				LWP::Protocol::socks4(3pm)

NAME

       LWP::Protocol::socks - adds support for the socks protocol and proxy facility

SYNOPSIS

       use LWP::Protocol::socks;

DESCRIPTION

       Use this package when you wish to use a socks proxy for your connections.

       It provides some essential hooks into the LWP system to implement a socks "scheme" similar to http for describing your socks connection,
       and can be used to proxy either http or https connections.

       The use case is to use LWP::UserAgent's proxy method to register your socks proxy like so:

	$ua->proxy([qw(http https)] => 'socks://socks.yahoo.com:1080');

       Then just use your $ua object as usual!

EXAMPLES

	#!/usr/local/bin/perl
	use strict;
	use LWP::UserAgent;

	my $ua = new LWP::UserAgent(agent => 'Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.0.5) Gecko/20060719 Firefox/1.5.0.5');
	$ua->proxy([qw(http https)] => 'socks://socks.yahoo.com:1080');
	my $response = $ua->get("http://www.freebsd.org");
	print $response->code,' ', $response->message,"
";
	my $response = $ua->get("https://www.microsoft.com");
	print $response->code,' ', $response->message,"
";

SEE ALSO

       URI::socks4

       LWP::Protocol::socks

AUTHORS

       Oleg G <oleg@cpan.org>

perl v5.14.2							    2012-02-12						LWP::Protocol::socks4(3pm)

LWP::Protocol::https(3) 				User Contributed Perl Documentation				   LWP::Protocol::https(3)

NAME

       LWP::Protocol::https - Provide https support for LWP::UserAgent

SYNOPSIS

	 use LWP::UserAgent;

	 $ua = LWP::UserAgent->new(ssl_opts => { verify_hostname => 1 });
	 $res = $ua->get("https://www.example.com");

DESCRIPTION

       The LWP::Protocol::https module provides support for using https schemed URLs with LWP.	This module is a plug-in to the LWP protocol
       handling, so you don't use it directly.	Once the module is installed LWP is able to access sites using HTTP over SSL/TLS.

       If hostname verification is requested by LWP::UserAgent's "ssl_opts", and neither "SSL_ca_file" nor "SSL_ca_path" is set, then
       "SSL_ca_file" is implied to be the one provided by Mozilla::CA.	If the Mozilla::CA module isn't available SSL requests will fail.  Either
       install this module, set up an alternative "SSL_ca_file" or disable hostname verification.

       This module used to be bundled with the libwww-perl, but it was unbundled in v6.02 in order to be able to declare its dependencies properly
       for the CPAN tool-chain.  Applications that need https support can just declare their dependency on LWP::Protocol::https and will no longer
       need to know what underlying modules to install.

SEE ALSO

       IO::Socket::SSL, Crypt::SSLeay, Mozilla::CA

COPYRIGHT

       Copyright 1997-2011 Gisle Aas.

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.16.2							    2012-02-18						   LWP::Protocol::https(3)