Steffen Ullrich > App-HTTP_Proxy_IMP-0.944 > App::HTTP_Proxy_IMP

Download:
App-HTTP_Proxy_IMP-0.944.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.944   Source   Latest Release: App-HTTP_Proxy_IMP-0.956

NAME ^

App::HTTP_Proxy_IMP - HTTP proxy with the ability to inspect and modify content

SYNOPSIS ^

    # only use cmdline args
    App::HTTP_Proxy_IMP->new(@ARGV)->start;             
    # only use given args
    App::HTTP_Proxy_IMP->new(\%options)->start;         
    # combine cmdline args with given defaults
    App::HTTP_Proxy_IMP->new(\%options,@ARGV)->start;   

    # short for App::HTTP_Proxy_IMP->new(...)->start;
    App::HTTP_Proxy_IMP->start(...);

    # show cmdline usage
    App::HTTP_Proxy_IMP->usage();

DESCRIPTION ^

App::HTTP_Proxy_IMP implements an HTTP proxy, which can inspect and modify the HTTP header or content before forwarding. Inspection and modification is done with plugins implementing the Net::IMP interface.

The proxy is single-threaded and non-forking, but due to the event-driven model it can still process multiple connections in parallel. It is mainly intended to be used as a platform for easy prototyping of interesting ideas using IMP plugins, but should be also fast enough to be used to enhance, secure, restrict or protocol the browsing experience for small groups.

Public Methods

Reaction to Signals

The installs some signal handlers:

SIGUSR1

Dump current state to STDERR, e.g. active connections and their state.

SIGUSR2

Toggles debugging (e.g. enable|disable).

AUTHOR ^

Steffen Ullrich <sullr@cpan.org>

COPYRIGHT ^

Copyright 2012,2013 Steffen Ullrich.

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

syntax highlighting: