1FOOMATIC-CONFIGURE(1)       General Commands Manual      FOOMATIC-CONFIGURE(1)
2
3
4

NAME

6       foomatic-configure  -  the  main  configuration program of the foomatic
7       printing system.
8

SYNOPSIS

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

DESCRIPTION

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

SEE ALSO

114       foomatic-printjob(1), foomatic-rip(1)
115
116

EXIT STATUS

118       foomatic-configure returns 0 if no errors occurred.
119
120

AUTHOR

122       Manfred  Wassmann  <manolo@NCC-1701.B.Shuttle.de>  for   the   foomatic
123       project using comments from the source.
124
125

BUGS

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)