lib::LWP::DebugUser Contributed Perl Documentatlib::LWP::Debug(3)NAMELWP::Debug - debug routines for the libwww-perl library
SYNOPSIS
use LWP::Debug qw(+ -conns);
# Used internally in the library
LWP::Debug::trace('send()');
LWP::Debug::debug('url ok');
LWP::Debug::conns("read $n bytes: $data");
DESCRIPTIONLWP::Debug provides tracing facilities. The trace(),
debug() and conns() function are called within the library
and they log information at increasing levels of detail.
Which level of detail is actually printed is controlled
with the level() function.
FUNCTIONS
level(...)
The level() function controls the level of detail being
logged. Passing '+' or '-' indicates full and no logging
respectively. Inidividual levels can switched on and of by
passing the name of the level with a '+' or '-' prepended.
The levels are:
trace : trace function calls
debug : print debug messages
conns : show all data transfered over the connections
The LWP::Debug module provide a special import() method
that allows you to pass the level() arguments with initial
use statement. If a use argument start with '+' or '-'
then it is passed to the level function, else the name is
exported as usual. The following two statements are thus
equivalent (if you ignore that the second pollutes your
namespace):
use LWP::Debug qw(+);
use LWP::Debugqw(level); level('+');
trace($msg)
The trace() function is used for tracing function calls.
The package and calling subroutine name is printed along
with the passed argument. This should be called at the
start of every major function.
24/Aug/1997 perl 5.005, patch 03 1
lib::LWP::DebugUser Contributed Perl Documentatlib::LWP::Debug(3)
debug($msg)
The debug() function is used for high-granularity
reporting of state in functions.
conns($msg)
The conns() function is used to show data being
transferred over the connections. This may generate
considerable output.
24/Aug/1997 perl 5.005, patch 03 2