home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _e36c9f740b94b650b93b3802a4af143e < prev    next >
Text File  |  2000-03-23  |  4KB  |  105 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>LWP::Debug - debug routines for the libwww-perl library</TITLE>
  5. <LINK REL="stylesheet" HREF="../../../Active.css" TYPE="text/css">
  6. <LINK REV="made" HREF="mailto:">
  7. </HEAD>
  8.  
  9. <BODY>
  10. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  11. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  12. <STRONG><P CLASS=block> LWP::Debug - debug routines for the libwww-perl library</P></STRONG>
  13. </TD></TR>
  14. </TABLE>
  15.  
  16. <A NAME="__index__"></A>
  17. <!-- INDEX BEGIN -->
  18.  
  19. <UL>
  20.  
  21.     <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
  22.  
  23.     <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
  24.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  25. </UL>
  26. <!-- INDEX END -->
  27.  
  28. <HR>
  29. <P>
  30. <H1><A NAME="name">NAME</A></H1>
  31. <P>LWP::Debug - debug routines for the libwww-perl library</P>
  32. <P>
  33. <HR>
  34. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  35. <UL>
  36. <LI>Linux</LI>
  37. <LI>Solaris</LI>
  38. <LI>Windows</LI>
  39. </UL>
  40. <HR>
  41. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  42. <PRE>
  43.  use LWP::Debug qw(+ -conns);</PRE>
  44. <PRE>
  45.  # Used internally in the library
  46.  LWP::Debug::trace('send()');
  47.  LWP::Debug::debug('url ok');
  48.  LWP::Debug::conns("read $n bytes: $data");</PRE>
  49. <P>
  50. <HR>
  51. <H1><A NAME="description">DESCRIPTION</A></H1>
  52. <P>LWP::Debug provides tracing facilities. The trace(), <A HREF="#item_debug"><CODE>debug()</CODE></A> and
  53. <A HREF="#item_conns"><CODE>conns()</CODE></A> function are called within the library and they log
  54. information at increasing levels of detail. Which level of detail is
  55. actually printed is controlled with the <A HREF="#item_level"><CODE>level()</CODE></A> function.</P>
  56. <P>The following functions are available:</P>
  57. <DL>
  58. <DT><STRONG><A NAME="item_level"><CODE>level(...)</CODE></A></STRONG><BR>
  59. <DD>
  60. The <A HREF="#item_level"><CODE>level()</CODE></A> function controls the level of detail being
  61. logged. Passing '+' or '-' indicates full and no logging
  62. respectively. Inidividual levels can switched on and of by passing the
  63. name of the level with a '+' or '-' prepended.  The levels are:
  64. <PRE>
  65.   trace   : trace function calls
  66.   debug   : print debug messages
  67.   conns   : show all data transfered over the connections</PRE>
  68. <P>The LWP::Debug module provide a special <A HREF="../../../lib/Pod/perlfunc.html#item_import"><CODE>import()</CODE></A> method that allows
  69. you to pass the <A HREF="#item_level"><CODE>level()</CODE></A> arguments with initial use statement.  If a
  70. use argument start with '+' or '-' then it is passed to the level
  71. function, else the name is exported as usual.  The following two
  72. statements are thus equivalent (if you ignore that the second pollutes
  73. your namespace):</P>
  74. <PRE>
  75.   use LWP::Debug qw(+);
  76.   use LWP::Debug qw(level); level('+');</PRE>
  77. <P></P>
  78. <DT><STRONG><A NAME="item_trace"><CODE>trace($msg)</CODE></A></STRONG><BR>
  79. <DD>
  80. The <A HREF="#item_trace"><CODE>trace()</CODE></A> function is used for tracing function
  81. calls. The package and calling subroutine name is
  82. printed along with the passed argument. This should
  83. be called at the start of every major function.
  84. <P></P>
  85. <DT><STRONG><A NAME="item_debug"><CODE>debug($msg)</CODE></A></STRONG><BR>
  86. <DD>
  87. The <A HREF="#item_debug"><CODE>debug()</CODE></A> function is used for high-granularity
  88. reporting of state in functions.
  89. <P></P>
  90. <DT><STRONG><A NAME="item_conns"><CODE>conns($msg)</CODE></A></STRONG><BR>
  91. <DD>
  92. The <A HREF="#item_conns"><CODE>conns()</CODE></A> function is used to show data being
  93. transferred over the connections. This may generate
  94. considerable output.
  95. <P></P></DL>
  96. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  97. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  98. <STRONG><P CLASS=block> LWP::Debug - debug routines for the libwww-perl library</P></STRONG>
  99. </TD></TR>
  100. </TABLE>
  101.  
  102. </BODY>
  103.  
  104. </HTML>
  105.