foomatic-configure
(1)
Name
foomatic-configure - the main configuration program of the
foomatic printing system.
Synopsis
foomatic-configure [OPTION]...
foomatic-configure -n queuename [ -N description ] [ -L
foomatic-configure -D -n queuename [ -s spooler ] [ -q ]
foomatic-configure -R -n queuename [ -s spooler ] [ -q ]
foomatic-configure -Q [ -s spooler ] [ -n queue-
name ] [ -r ]
foomatic-configure -P [ -s spooler ] [ -n queuename ] [ -d
foomatic-configure -X -p printer | -d driver |
-p printer -d driver
foomatic-configure -O
foomatic-configure -h
foomatic-configure --help
Description
User Commands FOOMATIC-CONFIGURE(1)
NAME
foomatic-configure - the main configuration program of the
foomatic printing system.
SYNOPSIS
foomatic-configure [OPTION]...
foomatic-configure -n queuename [ -N description ] [ -L
foomatic-configure -D -n queuename [ -s spooler ] [ -q ]
foomatic-configure -R -n queuename [ -s spooler ] [ -q ]
foomatic-configure -Q [ -s spooler ] [ -n queue-
name ] [ -r ]
foomatic-configure -P [ -s spooler ] [ -n queuename ] [ -d
foomatic-configure -X -p printer | -d driver |
-p printer -d driver
foomatic-configure -O
foomatic-configure -h
foomatic-configure --help
DESCRIPTION
foomatic-configure is a program to set up and configure
print queues for every known spooler (CUPS, LPRng, LPD,
GNUlpr, PPR, PDQ. CPS, no spooler) and every valid
printer/driver combo in the Foomatic database or every PPD
file coming with PostScript printers. As RIP filter (Raster
Image Processor, translation from PostScript to the native
language of the printer) always foomatic-rip(1) will be
used, except for PPD files of PostScript printers under CUPS
or PPR, they will be used without RIP filter.
It also comprises half of a programatic API for user tools:
you can learn and control everything about the static prop-
erties of print queues here. With the sister program
foomatic-printjob(1), you can do everything related to the
print queue's dynamic state: submit jobs, and query, cancel,
reorder, and redirect them.
Options
-n queuename
Configure this print queue
-N Name/Description
Use this proper human-readable name/description
Foomatic Project Last change: 2002-01-06 1
User Commands FOOMATIC-CONFIGURE(1)
-L Location
Short phrase describing this printer's location
-c connection
Printer is connected thusly (ex file:/dev/lp0)
-d driver Foomatic database name for desired printer driver
-p printer
Foomatic id for printer
--ppd ppdfile
PPD file, for example the one supplied by the man-
ufacturer of a PostScript printer
-s spooler
Explicit spooler type (cups, lpd, lprng, pdq, ppr,
direct)
-o option=value
Set the default of option to value
-o option Turn on option by default
-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 cur-
rent 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
Foomatic Project Last change: 2002-01-06 2
User Commands FOOMATIC-CONFIGURE(1)
Commands
No commands, just options
ATTRIBUTES
See attributes(5) for descriptions of the following
attributes:
+---------------+--------------------------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+--------------------------------------+
|Availability | print/cups/filter/foomatic-db-engine |
+---------------+--------------------------------------+
|Stability | Volatile |
+---------------+--------------------------------------+
SEE ALSO
foomatic-printjob(1), foomatic-rip(1)
EXIT STATUS
foomatic-configure returns 0 if no errors occurred.
AUTHOR
Manfred Wassmann <manolo@NCC-1701.B.Shuttle.de> for the
foomatic project using comments from the source.
BUGS
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 newline
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:
#comment
# primary printer name
lp
#alternate names
|lp2|lp3
|Example of a printer
:sd=/usr/spool/LPD/lp
Foomatic Project Last change: 2002-01-06 3
User Commands FOOMATIC-CONFIGURE(1)
:rw:lp=/dev/lp:mx#100
:
must be converted to:
#comment
# primary printer name
lp\
|lp2|lp3\
|Example of a printer\
:sd=/usr/spool/LPD/lp:\
:rw:lp=/dev/lp:mx#100:
This manpage may be out of date.
NOTES
This software was built from source available at
https://java.net/projects/solaris-userland. The original
community source was downloaded from /foomatic-db-
engine-3.0-20080903.tar.gz
Further information about this software can be found on the
open source community website at http://www.linuxfounda-
tion.org/collaborate/workgroups/openprinting/data-
base/foomatic/.
Foomatic Project Last change: 2002-01-06 4