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

LWP::Protocol::socks(3pm)				User Contributed Perl Documentation				 LWP::Protocol::socks(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');
	# for socks5, use socks like so:
	$ua->proxy([qw(http https)] => 'socks://socks.yahoo.com:1080');
	# for socks4, use socks4 like so:
	$ua->proxy([qw(http https)] => 'socks4://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,"
";

NOTES

       I don't have much time to contribute to this.  If you'd like to contribute, please fork https://github.com/scr/cpan and send me a pull
       request.

AUTHORS

       Sheridan C Rawlins <sheridan.rawlins@yahoo.com>

       Oleg G <oleg@cpan.org>

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

ssh-socks5-proxy-connect(1)					   User Commands				       ssh-socks5-proxy-connect(1)

NAME

       ssh-socks5-proxy-connect - Secure Shell proxy for SOCKS5

SYNOPSIS

       /usr/lib/ssh/ssh-socks5-proxy-connect
	    [-h socks5_proxy_host]
	    [-p socks5_proxy_port] connect_host connect_port

DESCRIPTION

       A proxy command for ssh(1) that uses SOCKS5 (RFC 1928). Typical use is where connections external to a network are only allowed via a socks
       gateway server.

       This proxy command does not provide any of the SOCKS5 authentication mechanisms defined in RFC 1928. Only anonymous connections are  possi-
       ble.

OPTIONS

       The following options are supported:

       -h socks5_proxy_host    Specifies the proxy web server through which to connect. Overrides the SOCKS5_SERVER environment variable.

       -p socks5_proxy_port    Specifies  the  port  on  which	the  proxy  web  server  runs. If not specified, port 80 is assumed. Overrides the
			       SOCKS5_PORT environment variable.

OPERANDS

       The following operands are supported:

       socks5_proxy_host    The host name or IP address (IPv4 or IPv6) of the proxy.

       socks5_proxy_port    The numeric port number to connect to on socks5_proxy_host.

       connect_host	    The name of the remote host to which the socks gateway is to connect you.

       connect_port	    The numeric port number of the socks gateway to connect you to on connect_host.

EXAMPLES

       The recommended way to use a proxy connection command is to configure the ProxyCommand in ssh_config(4) (see  Example  1  and  Example  2).
       Example 3 shows how the proxy command can be specified on the command line when running ssh(1).

       Example 1 Setting the proxy from the environment

       The following example uses ssh-socks5-proxy-connect in ssh_config(4) when the proxy is set from the environment:

	 Host playtime.foo.com
	     ProxyCommand /usr/lib/ssh/ssh-socks5-proxy-connect 
		 playtime.foo.com 22

       Example 2 Overriding proxy environment variables

       The following example uses ssh-socks5-proxy-connect in ssh_config(4) to override (or if not set) proxy environment variables:

	 Host playtime.foo.com
	     ProxyCommand /usr/lib/ssh/ssh-socks5-proxy-connect -h socks-gw 
		 -p 1080 playtime.foo.com 22

       Example 3 Using the command line

       The following example uses ssh-socks5-proxy-connect from the ssh(1) command line:

	 example$ ssh -o'ProxyCommand=/usr/lib/ssh/ssh-socks5-proxy-connect 
	     -h socks-gw -p 1080 playtime.foo.com 22' playtime.foo.com

ENVIRONMENT VARIABLES

       SOCKS5_SERVER	Takes socks5_proxy_host operand to specify the default proxy host.

       SOCKS5_PORT	Takes socks5_proxy_port  operand to specify the default proxy port.

EXIT STATUS

       The following exit values are returned:

       0     Successful completion.

       1     An error occurred.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWsshu			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Stable			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       ssh(1), ssh-http-proxy-connect(1), ssh_config(4), attributes(5)

SunOS 5.11							    30 Oct 2002 				       ssh-socks5-proxy-connect(1)