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