File: testing.htm

package info (click to toggle)
lprng 3.8.10-1.2
  • links: PTS
  • area: main
  • in suites: woody
  • size: 13,076 kB
  • ctags: 4,348
  • sloc: ansic: 35,394; sh: 10,756; perl: 2,210; makefile: 1,046
file content (132 lines) | stat: -rw-r--r-- 4,759 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <meta name="generator" content="HTML Tidy, see www.w3.org">
    <title>Testing and Diagnostic Facilities</title>
    <meta name="GENERATOR" content=
    "Modular DocBook HTML Stylesheet Version 1.71 ">
    <link rel="HOME" title=" LPRng-HOWTO" href="index.htm">
    <link rel="PREVIOUS" title="License" href="license.htm">
    <link rel="NEXT" title=
    "Setting Up The Test Version Spool Queues" href="x11439.htm">
  </head>

  <body class="APPENDIX" bgcolor="#FFFFFF" text="#000000" link=
  "#0000FF" vlink="#840084" alink="#0000FF">
    <div class="NAVHEADER">
      <table summary="Header navigation table" width="100%" border=
      "0" cellpadding="0" cellspacing="0">
        <tr>
          <th colspan="3" align="center">LPRng-HOWTO: 1 Apr 2002
          (For LPRng-3.8.10)</th>
        </tr>

        <tr>
          <td width="10%" align="left" valign="bottom"><a href=
          "license.htm" accesskey="P">Prev</a></td>

          <td width="80%" align="center" valign="bottom">
          </td>

          <td width="10%" align="right" valign="bottom"><a href=
          "x11439.htm" accesskey="N">Next</a></td>
        </tr>
      </table>
      <hr align="LEFT" width="100%">
    </div>

    <div class="APPENDIX">
      <h1><a name="TESTING">Appendix C. Testing and Diagnostic
      Facilities</a></h1>

      <div class="TOC">
        <dl>
          <dt><b>Table of Contents</b></dt>

          <dt>C.1. <a href="testing.htm#AEN11432">Compiling the
          Test Version</a></dt>

          <dt>C.2. <a href="x11439.htm">Setting Up The Test Version
          Spool Queues</a></dt>

          <dt>C.3. <a href="x11467.htm">Running the Test Version
          Software</a></dt>
        </dl>
      </div>

      <p>The <b class="APPLICATION">LPRng</b> code has the ability
      to run as non-setuid software, and to use the non-default
      TCP/IP ports for communication. This facility allows a <i
      class="EMPHASIS">Test Version</i> to be run in parallel with
      the normal <b class="APPLICATION">LPRng</b> software.</p>

      <p>To simplify testing and portability issues, a simple test
      version of the spool queues and jobs has been supplied with
      the <b class="APPLICATION">LPRng</b> distribution. These
      queues can be placed in a suitable location (<tt class=
      "FILENAME">/tmp</tt> is common) and the <b class=
      "APPLICATION">LPRng</b> software tested.</p>

      <p>The test version of the software will use the <tt class=
      "LITERAL">LPD_CONF</tt> environment variable to specify the
      location of the configuration file. It will read this
      configuration file on startup and use the values to override
      the normal defaults. Since a user could maliciously set up
      their own configuration files with values that could
      compromise system security, it is strongly recommended that
      the test version is not made SETUID root. In fact, the <b
      class="APPLICATION">LPRng</b> code will chatter messages when
      the LPD_CONF ability is enabled and it is run as root.</p>

      <div class="SECT1">
        <h1 class="SECT1"><a name="AEN11432">C.1. Compiling the
        Test Version</a></h1>

        <p>Edit <tt class="FILENAME">src/Makefile</tt>, and
        uncomment the indicated line. Then run <tt class=
        "LITERAL">make</tt> to regenerate the distribution.</p>

        <div class="INFORMALEXAMPLE">
          <a name="AEN11437"></a>
<pre class="SCREEN">
    #### ****** TESTING AND SECURITY LOOPHOLE ******************************
    # Define GETENV to allow the LPD_CONFIG environment
    #  variable to be used as the name of a configuration file.  In non-testing
    #  systems,  this is a security loophole.
    #CF := $(CF) -DGETENV
</pre>
        </div>
        <br>
        <br>
      </div>
    </div>

    <div class="NAVFOOTER">
      <hr align="LEFT" width="100%">

      <table summary="Footer navigation table" width="100%" border=
      "0" cellpadding="0" cellspacing="0">
        <tr>
          <td width="33%" align="left" valign="top"><a href=
          "license.htm" accesskey="P">Prev</a></td>

          <td width="34%" align="center" valign="top"><a href=
          "index.htm" accesskey="H">Home</a></td>

          <td width="33%" align="right" valign="top"><a href=
          "x11439.htm" accesskey="N">Next</a></td>
        </tr>

        <tr>
          <td width="33%" align="left" valign="top">License</td>

          <td width="34%" align="center" valign="top">&nbsp;</td>

          <td width="33%" align="right" valign="top">Setting Up The
          Test Version Spool Queues</td>
        </tr>
      </table>
    </div>
  </body>
</html>