1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2 3<html> 4 <head> 5 <meta name="generator" content="HTML Tidy, see www.w3.org"> 6 <title>Debugging</title> 7 <meta name="GENERATOR" content= 8 "Modular DocBook HTML Stylesheet Version 1.7"> 9 <link rel="HOME" title=" LPRng Reference Manual" href= 10 "index.htm"> 11 <link rel="UP" title="Job Processing" href="jobsteps.htm"> 12 <link rel="PREVIOUS" title="Forwarding Jobs" href="bk.htm"> 13 <link rel="NEXT" title="Filters " href="filters.htm"> 14 </head> 15 16 <body class="SECT1" bgcolor="#FFFFFF" text="#000000" link= 17 "#0000FF" vlink="#840084" alink="#0000FF"> 18 <div class="NAVHEADER"> 19 <table summary="Header navigation table" width="100%" border= 20 "0" cellpadding="0" cellspacing="0"> 21 <tr> 22 <th colspan="3" align="center">LPRng Reference Manual: 5 23 Sep 2003 (For LPRng-3.8.22)</th> 24 </tr> 25 26 <tr> 27 <td width="10%" align="left" valign="bottom"><a href= 28 "bk.htm" accesskey="P">Prev</a></td> 29 30 <td width="80%" align="center" valign="bottom">Chapter 31 15. Job Processing</td> 32 33 <td width="10%" align="right" valign="bottom"><a href= 34 "filters.htm" accesskey="N">Next</a></td> 35 </tr> 36 </table> 37 <hr align="LEFT" width="100%"> 38 </div> 39 40 <div class="SECT1"> 41 <h1 class="SECT1"><a name="DEBUGGING">15.12. 42 Debugging</a></h1> 43 44 <p>Options used:</p> 45 46 <ul> 47 <li> 48 <p><var class="LITERAL">debugging=</var><span class= 49 "emphasis"><i class="EMPHASIS">debugging 50 options</i></span></p> 51 </li> 52 53 <li> 54 <p><var class="LITERAL">full_time</var> FLAG <span class= 55 "emphasis"><i class="EMPHASIS">full or extended time 56 format</i></span></p> 57 </li> 58 59 <li> 60 <p><var class="LITERAL">ms_time_resolution</var> FLAG 61 <span class="emphasis"><i class="EMPHASIS">millisecond 62 time resolution</i></span></p> 63 </li> 64 65 <li> 66 <p><var class="LITERAL">syslog_device=</var><span class= 67 "emphasis"><i class="EMPHASIS">syslog alternative 68 device</i></span></p> 69 </li> 70 71 <li> 72 <p><var class="LITERAL">use_info_cache</var> FLAG <span 73 class="emphasis"><i class="EMPHASIS">cache printcap and 74 other information</i></span></p> 75 </li> 76 </ul> 77 <br> 78 <br> 79 80 <p>The <b class="APPLICATION">LPRng</b> software has a very 81 powerful debugging capability. Since most printing problems 82 occur on remote systems where it is impossible to run 83 debuggers, and since most systems do not do core dumps of 84 SETUID ROOT programs, the <b class="APPLICATION">LPRng</b> 85 software provides a very verbose set of log file trace 86 messages.</p> 87 88 <p>First, serious errors or other information are logged 89 using the <code class="FUNCTION">syslog()</code> facilities. 90 If these are not present on a system, then the messages are 91 logged to the device specified by <var class= 92 "LITERAL">syslog_device</var>.</p> 93 94 <p>For client programs, the debugging options are specified 95 on the command line and output is directed to <acronym class= 96 "ACRONYM">STDERR</acronym>. For the <b class= 97 "APPLICATION">lpd</b> server, debugging commands can be 98 specified on the command line OR as the <var class= 99 "LITERAL">db=options</var> printcap value. Output is directed 100 to the log file (<var class="LITERAL">lf</var> option value, 101 default log).</p> 102 103 <p>A typical debug entry has the format <var class= 104 "LITERAL">2,network+1,database</var>. This sets the general 105 debugging level to 2, network debugging to 1 and the database 106 debugging level to the default. The following debugging 107 options and levels are supported.</p> 108 109 <ul> 110 <li> 111 <p>nnn - general purpose debugging level</p> 112 </li> 113 114 <li> 115 <p>network - network debugging</p> 116 </li> 117 118 <li> 119 <p>database - database debugging</p> 120 </li> 121 122 <li> 123 <p>receive - job or command reception debugging</p> 124 </li> 125 126 <li> 127 <p>print - detailed job printing debugging</p> 128 </li> 129 </ul> 130 <br> 131 <br> 132 133 <p>The <var class="LITERAL">full_time</var> flag forces the 134 logging and other information which has timestamps to have a 135 full (year, month, day, etc.) timestamp. The <var class= 136 "LITERAL">ms_time_resolution</var> flag forces millisecond 137 time resolution in the time stamp.</p> 138 139 <p>The <var class="LITERAL">use_info_cache</var> (default ON) 140 causes <b class="APPLICATION">lpd</b> to cache printcap and 141 configuration information. This is desirable except when 142 trying to change values in printcap files and test the 143 results. By using <var class="LITERAL">use_info_cache@</var> 144 in the configuration information, you can get immediate 145 responses. Also, see <a href="lpcreread.htm">lpc reread</a> 146 for another method.</p> 147 </div> 148 149 <div class="NAVFOOTER"> 150 <hr align="LEFT" width="100%"> 151 152 <table summary="Footer navigation table" width="100%" border= 153 "0" cellpadding="0" cellspacing="0"> 154 <tr> 155 <td width="33%" align="left" valign="top"><a href= 156 "bk.htm" accesskey="P">Prev</a></td> 157 158 <td width="34%" align="center" valign="top"><a href= 159 "index.htm" accesskey="H">Home</a></td> 160 161 <td width="33%" align="right" valign="top"><a href= 162 "filters.htm" accesskey="N">Next</a></td> 163 </tr> 164 165 <tr> 166 <td width="33%" align="left" valign="top">Forwarding 167 Jobs</td> 168 169 <td width="34%" align="center" valign="top"><a href= 170 "jobsteps.htm" accesskey="U">Up</a></td> 171 172 <td width="33%" align="right" valign="top">Filters</td> 173 </tr> 174 </table> 175 </div> 176 </body> 177</html> 178 179