MAN page from Other LWP.pm-5.48-2.i386.rpm

lib::LWP::Debug

Section: User Contributed Perl Documentation (3)
Updated: libwww-perl-5.48
Index

NAME

LWP::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");

DESCRIPTION

LWP::Debug provides tracing facilities. The trace(), debug() andconns() function are called within the library and they loginformation at increasing levels of detail. Which level of detail isactually printed is controlled with the level() function.

The following functions are available:

level(...)

The level() function controls the level of detail beinglogged. Passing `+' or `-' indicates full and no loggingrespectively. Inidividual levels can switched on and of by passing thename 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 allowsyou to pass the level() arguments with initial use statement. If ause argument start with `+' or `-' then it is passed to the levelfunction, else the name is exported as usual. The following twostatements are thus equivalent (if you ignore that the second pollutesyour namespace):

  use LWP::Debug qw(+);  use LWP::Debug qw(level); level('+');

trace($msg)

The trace() function is used for tracing functioncalls. The package and calling subroutine name isprinted along with the passed argument. This shouldbe called at the start of every major function.

debug($msg)

The debug() function is used for high-granularityreporting of state in functions.

conns($msg)

The conns() function is used to show data beingtransferred over the connections. This may generateconsiderable output.

This document was created byman2html,using the manual pages.