Man Linux: Main Page and Category List


       foomatic-configure  -  the  main  configuration program of the foomatic
       printing system.


       foomatic-configure [OPTION]...

       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 ]

       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


       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.

       -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

       -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


       foomatic-printjob(1), foomatic-rip(1)


       foomatic-configure returns 0 if no errors occurred.


       Manfred   Wassmann   <>  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  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:

       # primary printer name
       #alternate names
        |Example of a printer

       must be converted to:

       # primary printer name
        |Example of a printer\

       This manpage may be out of date.