File: normalterm.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 (213 lines) | stat: -rw-r--r-- 7,040 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
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <meta name="generator" content="HTML Tidy, see www.w3.org">
    <title>Normal Termination</title>
    <meta name="GENERATOR" content=
    "Modular DocBook HTML Stylesheet Version 1.71 ">
    <link rel="HOME" title=" LPRng-HOWTO" href="index.htm">
    <link rel="UP" title="Job Processing" href="jobsteps.htm">
    <link rel="PREVIOUS" title="Printing Banner At End of Job "
    href="x7309.htm">
    <link rel="NEXT" title="Abnormal Termination " href=
    "abnormalterm.htm">
  </head>

  <body class="SECT1" 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=
          "x7309.htm" accesskey="P">Prev</a></td>

          <td width="80%" align="center" valign="bottom">Chapter
          15. Job Processing</td>

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

    <div class="SECT1">
      <h1 class="SECT1"><a name="NORMALTERM">15.8. Normal
      Termination</a></h1>

      <p>Options used:</p>

      <ul>
        <li>
          <p><tt class="LITERAL">fq</tt> FLAG <i class=
          "EMPHASIS">Form Feed on Close</i></p>
        </li>

        <li>
          <p><tt class="LITERAL">la</tt> FLAG <i class=
          "EMPHASIS">Local Printer Accounting</i></p>
        </li>

        <li>
          <p><tt class="LITERAL">tr=</tt><i class=
          "EMPHASIS">Trailer on Close</i></p>
        </li>

        <li>
          <p><tt class="LITERAL">ae=</tt><i class=
          "EMPHASIS">Accounting at end</i></p>
        </li>

        <li>
          <p><tt class="LITERAL">save_when_done</tt> FLAG <i class=
          "EMPHASIS">Save when done</i></p>
        </li>

        <li>
          <p><tt class="LITERAL">save_on_error</tt> FLAG <i class=
          "EMPHASIS">Do not delete on error</i></p>
        </li>

        <li>
          <p><tt class="LITERAL">done_jobs=N</tt><i class=
          "EMPHASIS">Save status of last N jobs</i></p>
        </li>

        <li>
          <p><tt class="LITERAL">wait_for_eof</tt> FLAG <i class=
          "EMPHASIS">Wait for EOF before closing device</i></p>
        </li>

        <li>
          <p><tt class="LITERAL">socket_linger</tt><i class=
          "EMPHASIS">socket linger timeout</i></p>
        </li>

        <li>
          <p><tt class="LITERAL">half_close</tt> FLAG <i class=
          "EMPHASIS">use shutdown() and not close()</i></p>
        </li>
      </ul>
      <br>
      <br>

      <p>Sequence of Operations:</p>

      <ol type="1">
        <li>
          <p>If we are printing and the <tt class="LITERAL">fq</tt>
          flag is set and the <tt class="LITERAL">sf</tt> (suppress
          interfile FF) flag is set, then the <tt class=
          "LITERAL">ff</tt> (form feed) string will be interpreted
          and sent to the of_fd.</p>
        </li>

        <li>
          <p>If we are printing, the <tt class="LITERAL">tr</tt>
          (trailer) string will be interpreted and sent to the
          of_fd.</p>
        </li>

        <li>
          <p>If printing and the <tt class="LITERAL">la</tt> (local
          printer accounting) flag is set or transferring a job and
          the <tt class="LITERAL">ar</tt> (remote accounting) flag
          is set, the <tt class="LITERAL">ae</tt> is examined and
          accounting is done as described for the <i class=
          "EMPHASIS"><a href="opendevice.htm#ACCOUNTSTART">as</a>
          field.</i></p>
        </li>

        <li>
          <p>If the <tt class="LITERAL">:of</tt> filter is present,
          its <span class="ACRONYM">STDIN</span> is closed, and the
          <b class="APPLICATION">lpd</b> server waits for it to
          exit. The exit status is used as described above.</p>
        </li>

        <li>
          <p>If the device is a socket or network connection, the
          socket linger time is set to <tt class=
          "LITERAL">socket_linger</tt> value if nonzero.</p>
        </li>

        <li>
          <p>If the <tt class="LITERAL">half_shut</tt> flag is set,
          then a <tt class="LITERAL">shutdown(fd,WR_DONE)</tt> will
          be done on the connection. This tells the TCP/IP stack
          that all data transmission has been completed. Errors or
          other information can still be read from the connection.
          If the <tt class="LITERAL">half_shut</tt> flag is clear,
          then a <tt class="LITERAL">close(fd)</tt> will be done
          and no errors or other information will be read.</p>
        </li>

        <li>
          <p>If the <tt class="LITERAL">wait_for_eof</tt> option is
          true (default) then a read is done on the connection
          until an EOF is found. The device (io_fd) is then
          closed.</p>
        </li>

        <li>
          <p>The job is marked as completed in the spool queue.</p>
        </li>

        <li>
          <p>If the <tt class="LITERAL">save_when_done</tt> flag is
          clear and the <tt class="LITERAL">done_jobs</tt> and <tt
          class="LITERAL">done_jobs_max_age</tt> values are zero
          (0), the job is removed.</p>
        </li>

        <li>
          <p>If the <tt class="LITERAL">done_jobs</tt> or <tt
          class="LITERAL">done_jobs_max_age</tt> values are
          nonzero, the spool queue is periodically checked and for
          an excess number of jobs or jobs with old status. This
          action is suppressed if either the <tt class=
          "LITERAL">save_when_done</tt> or <tt class=
          "LITERAL">save_on_error</tt> flag is set.</p>
        </li>
      </ol>
      <br>
      <br>
    </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=
          "x7309.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=
          "abnormalterm.htm" accesskey="N">Next</a></td>
        </tr>

        <tr>
          <td width="33%" align="left" valign="top">Printing Banner
          At End of Job</td>

          <td width="34%" align="center" valign="top"><a href=
          "jobsteps.htm" accesskey="U">Up</a></td>

          <td width="33%" align="right" valign="top">Abnormal
          Termination</td>
        </tr>
      </table>
    </div>
  </body>
</html>