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.