foomatic-configure - the main configuration program of the foomatic printing system.
foomatic-configure -n queuename [ -N description ] [ -L location ] [ -c con-
nect ] [ -d driver ] [ -p printer ] [ -s spooler ] [ -C [ sourcespooler ] source-
queue ] [ -o option1=value1 -o option2 ... ] [ -q ] [ --oldppd ] foomatic-config-
ure -D -n queuename [ -s spooler ] [ -q ]
foomatic-configure -R -n queuename [ -s spooler ] [ -q ]
foomatic-configure -Q [ -s spooler ] [ -n queuename ] [ -r ]
foomatic-configure -P [ -s spooler ] [ -n queuename ] [ index ]
foomatic-configure -X -p printer | -d driver | -p printer -d driver
foomatic-configure is a program to establish and configure print queues, drivers, spool-
ers, etc using the foomatic database and companion filters.
It also comprises half of a programatic API for user tools: you can learn and control
everything about the static properties of print queues here. With the sister program
foomatic-printjob, you can do everything related to print queue dynamic state: submit
jobs, and query, cancel, reorder, and redirect them.
Configure this print queue
Use this proper human-readable name/description
Short phrase describing this printer's location
Printer is connected thusly (ex file:/dev/lp0)
-d driver Foomatic database name for desired printer driver
Foomatic id for printer
Explicit spooler type (cups, lpd, lprng, pdq, ppr, direct)
Set the default of option to value
-o option Turn on option by default
--oldppd Use the old CUPS-O-Matic PPD files for CUPS queues (default are the PPD-O-Matic
-D Set this queue as the default queue (just give -n queuename)
-R Remove this whole queue entirely (just give -n queuename)
-C [ sourcespooler ] sourcequeue
Copy sourcequeue from sourcespooler (or the current one if sourcespooler is not
given) into the queue given by -n queuename (of the current spooler).
-Q Query existing configuration (gives XML summary)
-r List also remotely defined queues (CUPS only)
-P [ index ]
Get Perl dump of current configuration (as a Perl array named QUEUES, the first
index is index, or zero if index is not given)
-O Print XML Overview of all known printer/drivers (this shows also the Foomatic
IDs of the printers)
-X Print XML data for -p printer and/or -d driver object
-q Run quietly
No commands, just options
/etc/printcap The systems list of configured printers.
foomatic-configure returns 0 if no errors occurred.
Manfred Wassmann <manolo@NCC-1701.B.Shuttle.de> for the foomatic project using comments
from the source.
foomatic-configure currently cannot handle printcap files in the lprng style. As lprng
can use BSD style printcaps this is not much of a problem, as long as the GUI based print
manager lprngtool is not used. The difference between those formats is, that BSD style
requires continuation lines in printer definitions to be ended with a colon and the new-
line character to be escaped with a backslash. Lprng has no such restriction.
To use a printcap file generated or edited with lprngtool with foomatic-configure it is
necessary to add :\ to the end of all but the last line of every printer definition, just
as shown below:
# primary printer name
|Example of a printer
must be converted to:
# primary printer name
|Example of a printer\
This manpage may be out of date.
Foomatic Project 2002-01-06 FOOMATIC-CONFIGURE(1)