LWP::Debug

LWP::Debug(3)	     User Contributed Perl Documentation	LWP::Debug(3)



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() and
       conns() function are called within the library and they log informa-
       tion at increasing levels of detail. Which level of detail is actually
       printed is controlled with the "level()" function.

       The following functions are available:

       level(...)
	   The "level()" function controls the level of detail being logged.
	   Passing ’+’ or ’-’ indicates full and no logging respectively.
	   Individual 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 state-
	   ment.  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::Debug qw(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.

       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.



perl v5.8.8			  2008-04-07			LWP::Debug(3)