FOOMATIC-PRINTJOB(1) General Commands Manual FOOMATIC-PRINTJOB(1)NAME
foomatic-printjob - manage printer jobs in a spooler-independent fashion
SYNOPSIS
foomatic-printjob [ -s spooler ] [ -P queuename ] [ -o option1=value1 -o option2 ... ] [ -i ] [ file1 file2 ... ]
foomatic-printjob -Q [ -s spooler ] [ -P queuename ] [ -i ] [ -a ] [ user1 user2 ... ]
foomatic-printjob -R [ -s spooler ] [ -P queuename ] [ -i ] [ - | jobid1 jobid2 ... ]
foomatic-printjob -C [ -s spooler ] [ -i ] command [ arguments ]
foomatic-printjob -S [ -s spooler ] [ -i ]
foomatic-printjob -h [ -s spooler ] [ -P queuename ] [ -i ]
DESCRIPTION
foomatic-printjob provides a spooler-independent interface to creating and managing printer jobs and print queues. Note that the first
argument changes the mode of the command, as it combines the functionality of several System V-style printing commands.
OPTIONS
-sspooler Explicit spooler type.
-Pqueuename
Any commands specified should apply to this queue instead of the default.
-ooption=value
Set option to value
-ooption Set the switch option
-#n Print n copies
file1 file2 ...
Files to be printed, when no file is given, standard input will be printed
-Q Query the jobs in a queue. If a list of users is specified, only those users' jobs will be queried.
-Q -a Query the jobs in all queues. If a list of users is specified, only those users' jobs will be queried.
-R [ - | jobid1 jobid2 ... ]
Remove a job from a queue. Using - will remove all jobs.
-C command [ arguments ]
Execute control commands for queue/job manipulation. The commands are the ones of the BSD "lpc" utility. Use the control command
"help" to get a list of supported commands. Note: the amount of commands varies with the spooler, but the same commands given
under different spoolers do the same thing.
-i Interactive mode: You will be asked if foomatic-printjob is in doubt about something. Otherwise foomatic-printjob uses auto-
detection or quits with an error.
-S Save the chosen spooler as the default spooler
-h Show this message or show a list of available options if a queue is specified
SEE ALSO foomatic-configure(1) and the documentation for your print spooler.
AUTHOR
Manfred Wassmann <manolo@NCC-1701.B.Shuttle.de> and Chris Lawrence <lawrencc@debian.org> for the foomatic project using output from the
associated binary.
BUGS
This manpage still needs some editing.
Foomatic Project 2001-01-06 FOOMATIC-PRINTJOB(1)
Check Out this Related Man Page
FOOMATIC-CONFIGURE(1) General Commands Manual 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 location ] [ -c con-
nect ] [ -d driver ] [ -p printer ] [ --ppd ppdfile ] [ -s spooler ] [ -C [ sourcespooler ] source-
queue ] [ -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.
Foomatic Project 2002-01-06 FOOMATIC-CONFIGURE(1)