NAME¶
foomatic-configure - the main configuration program of the foomatic printing
system.
SYNOPSIS¶
foomatic-configure [
OPTION]...
foomatic-configure -n queuename [ -N description ]
[ -L location ] [ -c connect
] [ -d driver ] [ -p
printer ] [ --ppd ppdfile ]
[ -s spooler ]
[ -C
[ sourcespooler ]
sourcequeue ] [ -o
option1=value1 -o
option2
... ] [ -q ]
foomatic-configure -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 ]
[ -d driver ]
[ -p printer ]
[ --ppd ppdfile ]
[ index ]
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 properties 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
- -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 manufacturer 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 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
Commands¶
No commands, just options
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
: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.