1FOOMATIC-CONFIGURE(1) General Commands Manual FOOMATIC-CONFIGURE(1)
2
3
4
6 foomatic-configure - the main configuration program of the foomatic
7 printing system.
8
10 foomatic-configure [OPTION]...
11
12 foomatic-configure -n queuename [ -N description ] [ -L loca‐
13 tion ] [ -c con‐
14 nect ] [ -d driver ] [ -p printer ] [ --ppd ppdfile ] [ -s spooler ] [ -C [ source‐
15 spooler ] sourcequeue ] [ -o option1=value1 -o option2 ... ] [ -q ]
16 foomatic-configure -D -n queuename [ -s spooler ] [ -q ]
17
18 foomatic-configure -R -n queuename [ -s spooler ] [ -q ]
19
20 foomatic-configure -Q [ -s spooler ] [ -n queuename ] [ -r ]
21
22 foomatic-configure -P [ -s spooler ] [ -n queue‐
23 name ] [ -d driver ] [ -p printer ] [ --ppd ppdfile ] [ index ]
24
25 foomatic-configure -X -p printer | -d driver | -p printer -d driver
26
27 foomatic-configure -O
28
29 foomatic-configure -h
30
31 foomatic-configure --help
32
33
35 foomatic-configure is a program to set up and configure print queues
36 for every known spooler (CUPS, LPRng, LPD, GNUlpr, PPR, PDQ. CPS, no
37 spooler) and every valid printer/driver combo in the Foomatic database
38 or every PPD file coming with PostScript printers. As RIP filter
39 (Raster Image Processor, translation from PostScript to the native lan‐
40 guage of the printer) always foomatic-rip(1) will be used, except for
41 PPD files of PostScript printers under CUPS or PPR, they will be used
42 without RIP filter.
43
44 It also comprises half of a programatic API for user tools: you can
45 learn and control everything about the static properties of print
46 queues here. With the sister program foomatic-printjob(1), you can do
47 everything related to the print queue's dynamic state: submit jobs, and
48 query, cancel, reorder, and redirect them.
49
50
51 Options
52 -n queuename
53 Configure this print queue
54
55 -N Name/Description
56 Use this proper human-readable name/description
57
58 -L Location
59 Short phrase describing this printer's location
60
61 -c connection
62 Printer is connected thusly (ex file:/dev/lp0)
63
64 -d driver Foomatic database name for desired printer driver
65
66 -p printer
67 Foomatic id for printer
68
69 --ppd ppdfile
70 PPD file, for example the one supplied by the manufacturer of
71 a PostScript printer
72
73 -s spooler
74 Explicit spooler type (cups, lpd, lprng, pdq, ppr, direct)
75
76 -o option=value
77 Set the default of option to value
78
79 -o option Turn on option by default
80
81 -D Set this queue as the default queue (just give -n queuename)
82
83 -R Remove this whole queue entirely (just give -n queuename)
84
85 -C [ sourcespooler ] sourcequeue
86 Copy sourcequeue from sourcespooler (or the current one if
87 sourcespooler is not given) into the queue given by -n queue‐
88 name (of the current spooler).
89
90 -Q Query existing configuration (gives XML summary)
91
92 -r List also remotely defined queues (CUPS only)
93
94 -P [ index ]
95 Get Perl dump of current configuration (as a Perl array named
96 QUEUES, the first index is index, or zero if index is not
97 given)
98
99 -O Print XML Overview of all known printer/drivers (this shows
100 also the Foomatic IDs of the printers)
101
102 -X Print XML data for -p printer and/or -d driver object
103
104 -q Run quietly
105
106
107
108 Commands
109 No commands, just options
110
111
112
114 foomatic-printjob(1), foomatic-rip(1)
115
116
118 foomatic-configure returns 0 if no errors occurred.
119
120
122 Manfred Wassmann <manolo@NCC-1701.B.Shuttle.de> for the foomatic
123 project using comments from the source.
124
125
127 foomatic-configure currently cannot handle printcap files in the lprng
128 style. As lprng can use BSD style printcaps this is not much of a
129 problem, as long as the GUI based print manager lprngtool is not used.
130 The difference between those formats is, that BSD style requires con‐
131 tinuation lines in printer definitions to be ended with a colon and the
132 newline character to be escaped with a backslash. Lprng has no such
133 restriction.
134
135 To use a printcap file generated or edited with lprngtool with
136 foomatic-configure it is necessary to add :\ to the end of all but the
137 last line of every printer definition, just as shown below:
138
139 #comment
140 # primary printer name
141 lp
142 #alternate names
143 |lp2|lp3
144 |Example of a printer
145 :sd=/usr/spool/LPD/lp
146 :rw:lp=/dev/lp:mx#100
147 :
148
149
150 must be converted to:
151
152 #comment
153 # primary printer name
154 lp\
155 |lp2|lp3\
156 |Example of a printer\
157 :sd=/usr/spool/LPD/lp:\
158 :rw:lp=/dev/lp:mx#100:
159
160
161 This manpage may be out of date.
162
163
164
165Foomatic Project 2002-01-06 FOOMATIC-CONFIGURE(1)