FreeBSD Manual Pages
FOOMATIC-CONFIGURE(1) General Commands Manual FOOMATIC-CONFIGURE(1) NAME foomatic-configure - the main configuration program of the foomatic print- ing system. SYNOPSIS foomatic-configure [OPTION]... foomatic-configure -n queuename [ -N description ] [ -L loca- tion ] [ -c con- nect ] [ -d dri- ver ] [ -p printer ] [ --ppd ppdfile ] [ -s spooler ] [ -C [ source- spooler ] 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 dri- ver ] [ -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 Proces- sor, translation from PostScript to the native language of the printer) al- ways 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, re- order, 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 differ- ence 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)
NAME | SYNOPSIS | DESCRIPTION | SEE ALSO | EXIT STATUS | AUTHOR | BUGS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=foomatic-configure&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>