NAME

Apache::DumpHeaders - Watch HTTP transaction via headers

SYNOPSIS

#httpd.conf or some such
PerlLogHandler  Apache::DumpHeaders
PerlSetVar      DumpHeaders_File -
PerlSetVar      DumpHeaders_IP "1.2.3.4 1.2.3.5"
#PerlSetVar     DumpHeaders_Conditional 1
#PerlSetVar     DumpHeaders_Percent 5

DESCRIPTION

This module is used to watch an HTTP transaction, looking at the client and servers headers.

With Apache::ProxyPassThru configured, you are able to watch your browser talk to any server besides the one with this module living inside.

PARAMETERS

This module is configured with PerlSetVar's. All the "only dump if ..." options are "AND" conditions. If not all of them matches we won't dump the headers.

If you need some more complicated logic you could use the DumpHeaders_Conditional parameter alone and have another module do the "dump or dump not" logic with r->notes("DumpHeaders").

DumpHeaders_File

Required parameter to specify which file you want to dump the headers to.

DumpHeaders_IP

Optional parameter to specify which one or more IP addresses you want to dump traffic from.

DumpHeaders_Conditional

If this is set to a true value we'll only dump the headers if another module have set r->notes("DumpHeaders") to a true value.

DumpHeaders_Percent

If this is set, we'll only dump the specified percent of the requests.

SUPPORT

The latest version of this module can be found at CPAN and at http://develooper.com/code/Apache::DumpHeaders/. Send questions and suggestions to the modperl mailinglist (see http://perl.apache.org/ for information) or directly to the author (see below).

SEE ALSO

mod_perl(3), Apache(3), Apache::ProxyPassThru(3)

AUTHOR

Ask Bjoern Hansen <ask@develooper.com>.

Originally by Doug MacEachern.