File: Unix-lpr.htm

package info (click to toggle)
ghostscript 8.71~dfsg2-9+squeeze1
  • links: PTS, VCS
  • area: main
  • in suites: squeeze
  • size: 79,896 kB
  • ctags: 80,654
  • sloc: ansic: 501,432; sh: 25,689; python: 4,853; cpp: 3,633; perl: 3,597; tcl: 1,480; makefile: 1,187; lisp: 407; asm: 284; xml: 263; awk: 66; csh: 17; yacc: 15
file content (268 lines) | stat: -rw-r--r-- 10,435 bytes parent folder | download | duplicates (2)
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
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>Setting up a Unix lpr filter for Ghostscript</title>
<!-- $Id: Unix-lpr.htm 10732 2010-02-10 18:17:48Z giles $ -->
<!-- Originally: unix-lpr.txt -->
<link rel="stylesheet" type="text/css" href="gs.css" title="Ghostscript Style">
</head>

<body>
<!-- [1.0 begin visible header] ============================================ -->

<!-- [1.1 begin headline] ================================================== -->

<h1>Setting up a Unix <tt>lpr</tt> filter for Ghostscript</h1>

<!-- [1.1 end headline] ==================================================== -->

<!-- [1.2 begin table of contents] ========================================= -->

<h2>Table of contents</h2>

<blockquote><ul>
<li><a href="#Overview">Overview</a>
<li><a href="#What_it_can_do">What it can do</a>
<li><a href="#Setting_up">Setting it up</a>
<ul>
<li><a href="#Editing_device_list">Editing the device list <code>DEVICES</code></a>
<ul>
<li><a href="#Field_bpp">Field 1: bits per pixel</a>
<li><a href="#Field_colours">Field 2: colours</a>
<li><a href="#Field_dq">Field 3: dual queues</a>
<li><a href="#Device_example">Example definition of <code>DEVICES</code></a>
</ul>
<li><a href="#Editing_filter_list">Editing the filter list</a>
<li><a href="#Editing_printer_port">Editing the printer port and type</a>
<li><a href="#Modifying_printcap_insert">Modifying <code>printcap.insert</code></a>
<li><a href="#Multiple_queues">Single or dual queues</a>
</ul>
<li><a href="#Bugs">Bugs</a>
<li><a href="#Authors">Authors</a>
</ul></blockquote>

<!-- [1.2 end table of contents] =========================================== -->

<!-- [1.3 begin hint] ====================================================== -->

<p>For other information, see the <a href="Readme.htm">Ghostscript
overview</a> and the <a href="Use.htm">usage documentation</a>.

<!-- [1.3 end hint] ======================================================== -->

<hr>

<!-- [1.0 end visible header] ============================================== -->

<!-- [2.0 begin contents] ================================================== -->

<h2><a name="Overview"></a>Overview</h2>

<p>
"How do I set up Ghostscript to provide PostScript queues in a standard lpr
environment on Unix systems?" is a Frequently Asked Question amongst
Ghostscript users.  The two shell scripts described by this document are
designed to make this task a little easier. They are

<blockquote><dl>
<dt><code>unix-lpr.sh</code>
<dd>a flexible, multi-option print filter

<dt><code>lprsetup.sh</code>
<dd>A shell script which sets up soft links and creates a template insert
for the <code>printcap</code> file
</dl></blockquote>

<hr>

<h2><a name="What_it_can_do"></a>What it can do</h2>

<p>
The print filter resides in the Ghostscript installation directory (often
<code>/usr/local/share/ghostscript</code>, but may be something else at
your installation), together with a dummy filter directory containing
various soft links which point to the filter. It offers the following
features:

<ul>
<li>Multiple devices supported by a single filter
<li>Multiple bit-depths for the same device
<li>Multiple number of colours for the same device
<li>Direct (single-queue) and indirect (two-queue) setup
<li>Support for the standard preprocessing filters if you have the
corresponding (whatever)-to-PostScript translators
<li>Redirection of diagnostic and programmed output to a logfile in
the spooling directory
<li>Maintaining of printer accounting records of the numbers of pages
printed by each user (compatible with the <code>pac</code> command)
<li>Straightforward editing for further customisation
</ul>

<hr>

<h2><a name="Setting_up"></a>Setting it up</h2>

<p>
The <code>lprsetup.sh</code> script needs to have two lines edited
before running, to set the printer devices to use and the list of filters
available. With this information, it

<ul>
<li>creates a "<code>filt</code>" subdirectory under the
Ghostscript installation directory
<li>creates the links in this directory which enable the filter to
determine the parameters for running Ghostscript
<li>automatically generates <code>printcap</code> entries which should
need only a little editing before adding to your system
<code>printcap</code> file
</ul>

<h3><a name="Editing_device_list"></a>Editing the device list <tt>DEVICES</tt></h3>

<p>
At the top of <code>lprsetup.sh</code> is a line of the form
<code>DEVICES=</code><em>{list}</em>.  Replace the example list with
your own list of devices.  Each entry is the name of a device, followed by
three more optional fields, separated by dots "<code>.</code>".

<h4><a name="Field_bpp"></a>Field 1: bits per pixel</h4>

<p>
The first field is required only if the printer device understands the <a
href="Devices.htm#deskjet_parameters"><code>-dBitsPerPixel=</code>
switch</a>, which applies only to colour devices. For a particular number
<b><em>N</em></b> of bits per pixel, add the suffix <b><em>.N</em></b> to
the device name, for instance <code>cdj500.3</code>,
<code>cdj500.24</code>, etc.

<h4><a name="Field_colours"></a>Field 2: colours</h4>

<p>
The second field is required only if the printer device understands the
setting of the <code>Colors</code> device parameter (as in
<code>-dColors=</code>), which applies only to colour devices (and at
present is only supported by the <code>bjc</code>* family of drivers).
For a particular number <b><em>N</em></b> of colours, suffix
<b><em>.N</em></b> to the device name, such as <code>bjc600.24.3</code>,
<code>bjc600.8.1</code> etc.

<h4><a name="Field_dq"></a>Field 3: dual queues</h4>

<p>
The third field is required in order to use two separate queues for the
device, a "raw" queue and a PostScript queue (see
"<a href="#Multiple_queues">Single or dual queues</a>" below).  If you want
dual queues, add the suffix <code>.dq</code> ("dual queue") to the name,
whether or not a <a href="#Field_bpp">bits-per-pixel suffix</a> has already
been added.

<h4><a name="Device_example"></a>Example definition of
<tt>DEVICES</tt></h4>

<p>
Thus the following list supports a <code>cdj550</code> device at three
different bit depths (24 bpp, 3 bpp and 1 bpp), with a dual queue (that is,
a separate queue for the raw data); a monochrome <code>deskjet</code>
device with a single queue; and a <code>djet500</code> device using a
separate queue:

<blockquote><code>
DEVICES="cdj550.24.dq&nbsp;cdj550.3.dq&nbsp;cdj550.1.dq&nbsp;deskjet&nbsp;djet500.dq"
</code></blockquote>

<h3><a name="Editing_filter_list"></a>Editing the filter list</h3>

<p>
The standard list contains only the generic "<code>if</code>" filter,
but a commented-out list shows other filters which may be available.  If
you wish to use the support for these filters, you may need to edit the
<code>bsd-if</code> file to add to the <b><tt>PATH</tt></b> the
directories where the translators are stored, or to change the names of the
filters if yours are different.  The <code>bsd-if</code> script is
supplied with an example setup using Transcript (a commercial package from
Adobe), and PBMPLUS, a freeware package by Jef Poskanzer and others.

<h3><a name="Editing_printer_port"></a>Editing the printer port and
type</h3>

<p>
You can set the port and port type (parallel or printer) for an attached
printer, but for remote printers you'll have to modify the
<tt>printcap.insert</tt> file yourself.

<h3><a name="Modifying_printcap_insert"></a>Modifying
<tt>printcap.insert</tt></h3>

<p>
Running <code>lprsetup.sh</code> generates a file
<code>printcap.insert</code> which has a template setup for your
printer queues.  It cannot guarantee to do the whole job, and you will
probably need to consult your system documentation and edit this file
before you add it to your <code>printcap</code> file.  The file has good
defaults for serial printers, as these often cause problems in getting
binary data to the printer.  However, you may need to change the baud rate,
or the handshaking method.  Only a small change is required in the
<code>printcap</code> file to use a networked remote printer instead of
an attached printer, and an example is given in
<code>printcap.insert</code>.

<h3><a name="Multiple_queues"></a>Single or dual queues</h3>

<p>
If you wish to provide a PostScript-only queue (for example, so that all
pages printed go through accounting), and the printer port is local to the
host machine, a single queue is appropriate -- Ghostscript simply converts
PostScript into the printer's native data format and sends it to the
port.  But if the printer is on a remote networked machine, or if you need to
send raw printer data to the printer, you must use two queues.  Simply
specify the <a href="#Field_dq">"<code>.dq</code>" option</a> above.

<hr>

<h2><a name="Bugs"></a>Bugs</h2>

<p>
You must have write access to the Ghostscript installation directory for
<code>lprsetup.sh</code> to create the filter directory and soft links.

<p>
If you have several different values of bits per pixel for the same device,
you must list all instances of that device as adjacent items in the
<a href="#Editing_device_list"><code>DEVICES</code></a> device
list.  If you do not, <code>printcap.insert</code> will contain multiple
entries for the same device, which is not supported.

<hr>

<h2><a name="Authors"></a>Authors</h2>

<p>
This material was contributed by George Cameron.  Yves Arrouye
&lt;<a href="mailto:yves.arrouye@usa.net">yves.arrouye@usa.net</a>&gt;
is responsible for the number-of-colours part of the script.

<!-- [2.0 end contents] ==================================================== -->

<!-- [3.0 begin visible trailer] =========================================== -->
<hr>

<p>
<small>Copyright &copy; 2000-2006 Artifex Software, Inc.  All rights reserved.</small>

<p>
This software is provided AS-IS with no warranty, either express or
implied.

This software is distributed under license and may not be copied, modified
or distributed except as expressly authorized under the terms of that
license.  Refer to licensing information at http://www.artifex.com/
or contact Artifex Software, Inc.,  7 Mt. Lassen Drive - Suite A-134,
San Rafael, CA  94903, U.S.A., +1(415)492-9861, for further information.

<p>
<small>Ghostscript version 8.71, 10 February 2010

<!-- [3.0 end visible trailer] ============================================= -->

</body>
</html>