[ANNOUNCE] Apache-HTTunnel 0.02

[prev] [thread] [next] [Date index for 2005/01/27]

Hi all,

A couple weeks back I mentionned I was working on a HTTP tunnel
project that uses mod_perl. Well I finally got around to document and
publish it so it's off to CPAN
at this very moment.

As usual all feedback is welcome.

Note: I just realized the README says mod_perl 1.9919 is required, but
it's actually
1.999021. At least the Makefile.PL has it ok :)

Patrick


=3D=3D=3D=3D=3D README =3D=3D=3D=3D=3D

Apache-HTTunnel
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D

Apache::HTTunnel is a universal HTTP tunnel that allows the transport
of any TCP/IP protocol over HTTP. It is designed to allow people
behind firewalls/proxies to access non-HTTP services.

It is loaded into the Apache web server using mod_perl. The client
module (HTTunnel::Client) or script (/usr/bin/httunnel) can then be
used to setup the actual tunnel(s). See Client/README for more information
on using the client components.

Note: Apache::HTTunnel works only on UNIX-type platforms, more specifically
those that support the sendmsg(2)/recvmsg(2) API.



INSTALLATION

- To install this module type the following:

     % perl Makefile.PL
     % make
     % make test
     % make install

     Note 1: Apache::Test is used in the test suite. If the test suite cann=
ot=20
             find your Apache web server, you may want to try one of the=20
             following (see the Apache::TestMM documentation for more detai=
ls):

                % perl Makefile.PL -apxs /path/to/apxs
                % perl Makefile.PL -httpd /path/to/httpd

- Generate the sample configuration file (see the Apache::HTTunnel document=
ation
  for more information on the available configuration file options):

     % perl -MApache::HTTunnel=3Dsample_config >
/etc/httpd/conf/perl_httunnel.conf

- Restart Apache (see the HTTunnel::Client documentation for more informati=
on
  on using the client components to setup a tunnel):

     % service httpd restart

- To install only the client portion, see Client/README.



DEPENDENCIES

This module requires these other modules and libraries:

- mod_perl 1.999021
- File::FDkeeper (which in turn will require File::FDpasser)


COPYRIGHT AND LICENCE

Copyright (C) 2005 Patrick LeBoutillier <patl@xxxx.xxx>

This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself, either Perl version 5.8.5 or,
at your option, any later version of Perl 5 you may have available.

--=20
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
Patrick LeBoutllier
Laval, Qu=E9bec, Canada