1FOOMATIC-RIP(1) General Commands Manual FOOMATIC-RIP(1)
3
7 foomatic-rip - Universal print filter/RIP wrapper
8
10 General Options:
11 foomatic-rip [-v] [-q] <spooler-specific options>
12 Spooler-less printing/CPS (older versions) filter:
15 foomatic-rip [-P <printer> | --ppd <ppdfile> ] [-J <jobtitle> ] [-o
16 <option>=<value> [...]] [<files>]
17 CUPS filter:
20 foomatic-rip <jobid> <user> <jobtitle> <numcopies> <options> [<file>]
21 LPRng filter:
24 foomatic-rip --lprng [-J<jobti‐
25 tle>][-Z<option>=<value>[,<option>=<value>[, ...]] <ppdfile>
26 foomatic-rip [-J<jobti‐
28 tle>][-Z<option>=<value>[,<option>=<value>[, ...]]
29 (printcap :pdd=<ppdfile>)
30 foomatic-rip --ppd <ppdfile>[-J<jobti‐
32 tle>] [-Z<option>=<value>[,<option>=<value>[, ...]]
33 LPD/GNUlpr filter:
36 foomatic-rip [-w <number>] [-l <number>] [-x <number>] [-y <num‐
37 ber>] [-i <number>] [-c] [-n <string>] [-h <string>] [-j|-J <jobti‐
38 tle>|<options>] <ppdfile>
39 PPR RIP:
42 foomatic-rip [<option>=<value> [...]]
43 PPR interface:
46 foomatic-rip <queue> <destaddress> <options> <jobbreak> <feed‐
47 back> <codes> <jobname> <routing> <for> <filetype> [<file>]
48 PDQ driver file generation:
51 foomatic-rip [--ppd <ppdfile>] [-o <option>=<value> [...]] --gen‐
52 pdq|--appendpdq|--genrawpdq|--appendrawpdq
53 PDQ filter:
56 foomatic-rip --pdq --ppd <ppdfile>] [-o <option>=<value> [...]] <file>
57 CPS (newer versions) filter:
60 foomatic-rip --cps -P <printer> [-J <jobti‐
61 tle>] [-o <option>=<value> [...]] [<files>]
62
65 foomatic-rip is a universal print filter which works with every known
66 free software printer spooler. It has the following features:
67 It translates PostScript and PDF (and also other file formats) from
69 standard input to the printer's native language (usually put to stan‐
70 dard output).
71 The translation is done with an external renderer, usually Ghostscript
73 (gs(1)). If no translation is needed (PostScript printer) the ren‐
74 derer's command line reduces to cat(1). The way how this translation is
75 done is described in a PPD file.
76 Printer capabilities, how to handle user options, and how to build the
78 renderer command line is always described by PPD files, these PPD files
79 usually come from Foomatic or can be the ones supplied by the manufac‐
80 turers of PostScript printers. The PPD files are the same for all
81 spoolers.
82 foomatic-rip works with every known spooler (CUPS, LPRng, LPD, GNUlpr,
84 PPR, PDQ, CPS, and without spooler). It auto-detects the spooler from
85 which it was called by the command line options and environment vari‐
86 ables which were supplied by the spooler.
87 Non-PostScript/PDF files are translated to PostScript before they are
89 passed to the renderer. This is usually done by a2ps(1), enscript(1),
90 or mpage(1). foomatic-rip auto-detects which program is installed, but
91 manual configuration is also possible.
92 foomatic-rip does not only apply option settings supplied by the user
94 through the command line of the printing command, but also searches the
95 entire job for embedded option settings (only PostScript jobs). Here
96 not only settings which affect the whole job are taken into account,
97 but also settings in the page headers, which are only valid for the
98 page where they were found, so applications which produce PostScript
99 code with page-specific printer option settings are fully supported.
100
103 Options
104 -v verbose mode for debugging. WARNING: This will create a file
105 in /tmp that contains the debugging information. This opens
106 a security loophole and should not be used in production.
107 -q quiet mode - minimal information output
110 -P <printer>
113 <printer> is the configured printer which should be used for
114 this job.
115 --ppd <ppdfile>
118 The PPD file <ppdfile> should be applied for processing this
119 job.
120 -J <jobtitle>
122 The <jobtitle> will be printed in the head line of every page
123 of a plain text job.
124 -o <option>=<value>
126 Option settings for this job, do
127 foomatic-rip -P <printer> -o docs <file>
129 (<file> can be an arbitrary existing file, as .bashrc, will
131 not be printed) to print a list of available options for the
132 specified <printer>.
133 <files> The file(s) to be printed.
135 foomatic-rip will print from standard input unless at least one file to
138 be printed is specified on the command line. If your printer PPD file
139 is stored as /etc/direct/<printer>.ppd or
140 ~/.foomatic/direct/<printer>.ppd you can use it by simply specifying
141 "-P <printer>".
142 Put a line
144 *FoomaticRIPPostPipe: "| <command>"
146 into the PPD file, right after *PPD-Adobe: "4.3", where <command> is a
148 command into which you want to re-direct the output data. Due to the
149 restrictions of PPD files <, >, and " are not allowed in the <command>,
150 replace them as follows:
151 Character Replacement
153 ---------------------
154 < <
155 > >
156 " "
157 ' '
158 & &
159 This way you can print directly to your printer, use
161 *FoomaticRIPPostPipe: "| cat > /dev/lp0"
163 or
165 *FoomaticRIPPostPipe: "| cat > /dev/usb/lp0"
167 for local parallel or USB printers. To make normal users able to print
169 this way add them to the group lp and make sure that the appropriate
170 printer device file /dev/... is group-writable for the lp group.
171 for a TCP/Socket/JetDirect printer with the host name printer listening
173 on port 9100 you need this:
174 *FoomaticRIPPostPipe: "| /usr/bin/nc -w 1 printer 9100"
176 Note the "-w 1" in the "nc" command line, it makes "nc" exiting
178 immediately after the data is transferred to the printer.
179 *FoomaticRIPPostPipe: "| rlpr -Plp@printserver"
181 directs your jobs to the LPD printer queue lp on the machine named
183 printserver.
184 See also http://www.openprinting.org/direct-doc.html
186
189 See the documentation on the OpenPrinting Web site:
190 http://www.openprinting.org/
191
194 The file /etc/foomatic/filter.conf is read whenever foomatic-rip is
195 executed. It allows to configure the behavior of foomatic-rip as
196 follows (lines beginning with # are comments and therefore get
197 ignored):
198 textfilter: <command>
201 Selects the filter for input files which are not PostScript
202 or PDF. <command> is one of a2ps, enscript, or mpage.
203 foomatic-rip automatically selects the needed command line
204 options.
205 debug: 0|1
208 Turns on (1) or off (0) the debug mode. This is equivalent to
209 supplying the --debug command line option. Default setting is
210 0.
211 ps_accounting: 0|1
214 Turns on (1) or off (0) inserting PostScript code for page
215 accounting into PostScript jobs. The inserted PostScript code
216 makes Ghostscript generating accounting output on stderr and
217 CUPS can this way log each page which got printed. The code
218 will only be inserted if CUPS is the spooler. Default setting
219 is 1.
220 echo: [<path>/]<executable>
223 Sets the path to an echo(1) executable which supports -n.
224 gspath: [<path>/]<executable>
227 Sets the path to the Ghostscript (gs(1)) executable. To be
228 used if Ghostscript is at a non-standard location or if an
229 alternative Ghostscript should be used.
230 execpath: <path>[:<path>]...
233 Sets the $PATH variable to be used by foomatic-rip.
234 cupsfilterpath: <path>[:<path>]...
237 Sets the directories (colon-separated) in which foomatic-rip
238 searches for CUPS filters.
239 preferred_shell: [<path>/]<executable>
242 Sets the preferred shell to use when executing
243 FoomaticRIPCommandLine and friends. Several PPD files use
244 shell constructs that require a more modern shell like bash,
245 zsh, or ksh.
246
250 /etc/cups/ppd/<printer>.ppd
251 /etc/lpd/<printer>.ppd
252 /etc/ppr/<printer>.ppd
253 /etc/pdq/<printer>.ppd
254 /etc/direct/<printer>.ppd
255 The PPD files of the currently defined printers
257 /etc/foomatic/filter.conf
259 Configuration file for foomatic-rip
261
265 foomatic-rip returns 0 unless something unexpected happens.
266
268 Till Kamppeter <till.kamppeter@gmail.com> with parts of Manfred
269 Wassmanns's <manolo@NCC-1701.B.Shuttle.de> man pages for the Foomatic
270 2.0.x filters.
271
273 None so far.
274 Please send bug reports to the Foomatic mailing list:
276 http://lists.freestandards.org/mailman/listinfo/printing-foomatic
278Foomatic Project 2002-11-26 FOOMATIC-RIP(1)