LWP::DebugFile man page on aLinux

Man page or keyword search:  
man Server   7435 pages
apropos Keyword Search (all sections)
Output format
aLinux logo
[printable version]

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

NAME
       LWP::DebugFile - routines for tracing/debugging LWP

SYNOPSIS
       If you want to see just what LWP is doing when your program calls it,
       add this to the beginning of your program's source:

	 use LWP::DebugFile;

       For even more verbose debug output, do this instead:

	 use LWP::DebugFile ('+');

DESCRIPTION
       This module is like LWP::Debug in that it allows you to see what your
       calls to LWP are doing behind the scenes.  But it is unlike LWP::Debug
       in that it sends the output to a file, instead of to STDERR (as
       LWP::Debug does).

OPTIONS
       The options you can use in "use LWP::DebugFile (options)" are the same
       as the non-exporting options available from "use LWP::Debug (options)".
       That is, you can do things like this:

	 use LWP::DebugFile qw(+);
	 use LWP::Debug qw(+ -conns);
	 use LWP::Debug qw(trace);

       The meanings of these are explained in the documentation for
       LWP::Debug.  The only differences are that by default, LWP::DebugFile
       has "cons" debugging on, ad that (as mentioned earlier), only
       "non-exporting" options are available.  That is, you can't do this:

	 use LWP::DebugFile qw(trace); # wrong

       You might expect that to export LWP::Debug's "trace()" function, but it
       doesn't work -- it's a compile-time error.

OUTPUT FILE NAMING
       If you don't do anything, the output file (where all the LWP
       debug/trace output goes) will be in the current directory, and will be
       named like lwp_3db7aede_b93.log, where 3db7aede is $^T expressed in
       hex, and "b93" is $$ expressed in hex.  Presumably this is a unique-
       for-all-time filename!

       If you don't want the files to go in the current directory, you can set
       $LWP::DebugFile::outpath before you load the LWP::DebugFile module:

	 BEGIN { $LWP::DebugFile::outpath = '/tmp/crunk/' }
	 use LWP::DebugFile;

       Note that you must end the value with a path separator ("/" in this
       case -- under MacPerl it would be ":").	With that set, you will have
       output files named like /tmp/crunk/lwp_3db7aede_b93.log.

       If you want the LWP::DebugFile output to go a specific filespec
       (instead of just a uniquely named file, in whatever directory), instead
       set the variable $LWP::DebugFile::outname, like so:

	 BEGIN { $LWP::DebugFile::outname = '/home/mojojojo/lwp.log' }
	 use LWP::DebugFile;

       In that case, $LWP::DebugFile::outpath isn't consulted at all, and
       output is always written to the file /home/mojojojo/lwp.log.

       Note that the value of $LWP::DebugFile::outname doesn't need to be an
       absolute filespec.  You can do this:

	 BEGIN { $LWP::DebugFile::outname = 'lwp.log' }
	 use LWP::DebugFile;

       In that case, output goes to a file named lwp.log in the current
       directory -- specifically, whatever directory is current when
       LWP::DebugFile is first loaded. $LWP::DebugFile::outpath is still not
       consulted -- its value is used only if $LWP::DebugFile::outname isn't
       set.

ENVIRONMENT
       If you set the environment variables "LWPDEBUGPATH" or "LWPDEBUGFILE",
       their values will be used in initializing the values of
       $LWP::DebugFile::outpath and $LWP::DebugFile::outname.

       That is, if you have "LWPDEBUGFILE" set to /home/mojojojo/lwp.log, then
       you can just start out your program with:

	 use LWP::DebugFile;

       and it will act as if you had started it like this:

	 BEGIN { $LWP::DebugFile::outname = '/home/mojojojo/lwp.log' }
	 use LWP::DebugFile;

IMPLEMENTATION NOTES
       This module works by subclassing "LWP::Debug", (notably inheriting its
       "import"). It also redefines &LWP::Debug::conns and &LWP::Debug::_log
       to make for output that is a little more verbose, and friendlier for
       when you're looking at it later in a log file.

SEE ALSO
       LWP::Debug

COPYRIGHT AND DISCLAIMERS
       Copyright (c) 2002 Sean M. Burke.

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

       This program is distributed in the hope that it will be useful, but
       without any warranty; without even the implied warranty of
       merchantability or fitness for a particular purpose.

AUTHOR
       Sean M. Burke "sburke@cpan.org"

perl v5.10.0			  2003-10-23		     LWP::DebugFile(3)
[top]

List of man pages available for aLinux

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net