net::proxy::connector::connect(3pm) [debian man page]
Net::Proxy::Connector::connect(3pm) User Contributed Perl Documentation Net::Proxy::Connector::connect(3pm) NAME
Net::Proxy::Connector::connect - Create CONNECT tunnels through HTTP proxies SYNOPSIS
# sample proxy using Net::Proxy::Connector::tcp # and Net::Proxy::Connector::connect use Net::Proxy; # listen on localhost:6789 # and proxy to remotehost:9876 through proxy.company.com:8080 # using the given credentials my $proxy = Net::Proxy->new( in => { type => 'tcp', port => '6789' }, out => { type => 'connect', host => 'remotehost', port => '9876', proxy_host => 'proxy.company.com', proxy_port => '8080', proxy_user => 'jrandom', proxy_pass => 's3kr3t', proxy_agent => 'Mozilla/4.04 (X11; I; SunOS 5.4 sun4m)', }, ); $proxy->register(); Net::Proxy->mainloop(); DESCRIPTION
"Net::Proxy::Connecter::connect" is a "Net::Proxy::Connector" that uses the HTTP CONNECT method to ask the proxy to create a tunnel to an outside server. Be aware that some proxies are set up to deny the creation of some outside tunnels (either to ports other than 443 or outside a specified set of outside hosts). This connector is only an "out" connector. CONNECTOR OPTIONS
"Net::Proxy::Connector::connect" accepts the following options: "out" o host The destination host. o port The destination port. o proxy_host The web proxy name or address. o proxy_port The web proxy port. o proxy_user The authentication username for the proxy. o proxy_pass The authentication password for the proxy. o proxy_agent The user-agent string to use when connecting to the proxy. AUTHOR
Philippe 'BooK' Bruhat, "<book@cpan.org>". BUGS
All the authentication schemes supported by "LWP::UserAgent" should be supported (we use an "LWP::UserAgent" internally to contact the proxy). This means we should also support NTLM, since it is supported as from "libwww-perl" 5.66. "Net::Proxy::Connector::connect" has not been actually tested with NTLM, though. Any report of success or failure with a NTLM proxy will be appreciated. HISTORY
This module is based on my script "connect-tunnel", that provided a command-line interface to create tunnels though HTTP proxies. It was first published on CPAN on March 2003. A better version of "connect-tunnel" (using "Net::Proxy") is provided this distribution. COPYRIGHT
Copyright 2006 Philippe 'BooK' Bruhat, All Rights Reserved. LICENSE
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. perl v5.10.1 2009-10-18 Net::Proxy::Connector::connect(3pm)
Check Out this Related Man Page
Net::Proxy::Connector(3pm) User Contributed Perl Documentation Net::Proxy::Connector(3pm) NAME
Net::Proxy::Connector - Base class for Net::Proxy protocols SYNOPSIS
# # template for the zlonk connector # package Net::Proxy::Connector::zlonk; use strict; use Net::Proxy::Connector; our @ISA = qw( Net::Proxy::Connector ); # here are the methods you need to write for your connector # if it can be used as an 'in' connector sub listen { } sub accept_from { } # if it can be used as an 'out' connector sub connect { } # to process data sub read_from { } sub write_to { } 1; DESCRIPTION
"Net::Proxy::Connector" is the base class for all specialised protocols used by "Net::Proxy". METHODS
Class methods The base class provides the following methods: new() Instance methods set_proxy( $proxy ) Define the proxy that "owns" the connector. get_proxy() Return the "Net::Proxy" object that "owns" the connector. is_in() Return a boolean value indicating if the "Net::Proxy::Connector" object is the "in" connector of its proxy. is_out() Return a boolean value indicating if the "Net::Proxy::Connector" object is the "out" connector of its proxy. new_connection_on( $socket ) This method is called by "Net::Proxy" to handle incoming connections, and in turn call "accept_from()" on the 'in' connector and "connect()" on the 'out' connector. raw_read_from( $socket ) This method can be used by "Net::Proxy::Connector" subclasses in their "read_from()" methods, to fetch raw data on a socket. raw_write_to( $socket, $data ) This method can be used by "Net::Proxy::Connector" subclasses in their "write_to()" methods, to send raw data on a socket. raw_listen( ) This method can be used by "Net::Proxy::Connector" subclasses in their "listen()" methods, to create a listening socket on their "host" and "port" parameters. raw_accept_from( $socket ) This method can be used internaly by "Net::Proxy::Connector" subclasses in their "accept_from()" methods, to accept a newly connected socket. Subclass methods The following methods should be defined in "Net::Proxy::Connector" subclasses: Initialisation init() This method initalise the connector. Processing incoming/outgoing data read_from( $socket ) Return the data that was possibly decapsulated by the connector. write_to( $socket, $data ) Write $data to the given $socket, according to the connector scheme. "in" connector listen() Initiate listening sockets and return them. This method can use the "raw_listen()" method to do the low-level listen call. accept_from( $socket ) $socket is a listening socket created by "listen()". This method returns the connected socket. This method can use the "raw_accept_from()" method to do the low-level accept call. "out" connector connect() Return a socket connected to the remote server. AUTHOR
Philippe 'BooK' Bruhat, "<book@cpan.org>". COPYRIGHT
Copyright 2006 Philippe 'BooK' Bruhat, All Rights Reserved. LICENSE
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. perl v5.10.1 2009-10-18 Net::Proxy::Connector(3pm)