Provided by: cups-client_1.4.4-6ubuntu2_i386 bug

NAME

       lpadmin - configure cups printers and classes

SYNOPSIS

       lpadmin [ -E ] [-U username ] [ -h server[:port] ] -d destination
       lpadmin [ -E ] [-U username ] [ -h server[:port] ] -p printer option(s)
       lpadmin [ -E ] [-U username ] [ -h server[:port] ] -x destination

DESCRIPTION

       lpadmin  configures  printer  and class queues provided by CUPS. It can
       also be used to set the server default printer or class.

       When specified before the -d, -p, or -x options, the -E  option  forces
       encryption when connecting to the server.

       The first form of the command (-d) sets the default printer or class to
       destination.  Subsequent print jobs submitted via the lp(1)  or  lpr(1)
       commands  will use this destination unless the user specifies otherwise
       with the lpoptions(1) command.

       The second form of the command (-p) configures the named printer.   The
       additional options are described below.

       The  third  form  of  the  command  (-x)  deletes  the printer or class
       destination. Any jobs that are pending  for  the  destination  will  be
       removed and any job that is currently printed will be aborted.

CONFIGURATION OPTIONS

       The following options are recognized when configuring a printer queue:

       -c class
            Adds  the  named  printer to class.  If class does not exist it is
            created automatically.

       -i interface
            Sets a System V style  interface  script  for  the  printer.  This
            option  cannot  be  specified with the -P option (PPD file) and is
            intended for providing support for legacy printer drivers.

       -m model
            Sets a standard System V interface script or  PPD  file  from  the
            model directory.

       -o job-k-limit=value
            Sets  the  kilobyte  limit  for  per-user  quotas. The value is an
            integer number of kilobytes; one kilobyte is 1024 bytes.

       -o job-page-limit=value
            Sets the page limit for per-user quotas. The value is the  integer
            number  of  pages  that  can  be  printed;  double-sided pages are
            counted as two pages.

       -o job-quota-period=value
            Sets the accounting period for per-user quotas. The  value  is  an
            integer number of seconds; 86,400 seconds are in one day.

       -o job-sheets-default=banner

       -o job-sheets-default=banner,banner
            Sets the default banner page(s) to use for print jobs.

       -o name=value
            Sets a PPD option for the printer. PPD options can be listed using
            the -l option with the lpoptions(1) command.

       -o name-default=value
            Sets a default server-side option for the printer. Any  print-time
            option  can  be  defaulted,  e.g.  "-o  cpi-default=17" to set the
            default "cpi" option value to 17.

       -o port-monitor=name
            Sets the binary  communications  program  to  use  when  printing,
            "none",  "bcp",  or  "tbcp".  The  default  program is "none". The
            specified port monitor must be listed in the printer's PPD file.

       -o printer-error-policy=name
            Sets the error policy to be  used  when  the  printer  backend  is
            unable  to  send  the  job to the printer. The name must be one of
            "abort-job", "retry-job"  or  "stop-printer".  The  default  error
            policy is "stop-printer".

       -o printer-is-shared=true/false
            Sets  the  printer  to  shared/published  or unshared/unpublished.
            Shared/published printers are publically announced by  the  server
            on  the  LAN  based  on  the browsing configuration in cupsd.conf,
            while unshared/unpublished printers are not announced. The default
            value is "true".

       -o printer-op-policy=name
            Sets  the  IPP  operation  policy associated with the printer. The
            name must be defined in the cupsd.conf in a Policy  section.   The
            default operation policy is "default".

       -r class
            Removes  the  named  printer  from  class.  If the resulting class
            becomes empty it is removed.

       -u allow:user,user,@group

       -u deny:user,user,@group

       -u allow:all

       -u deny:none
            Sets user-level access control on a printer. Names  starting  with
            "@"  are  interpreted  as  UNIX  groups. The latter two forms turn
            user-level access control off.

       -v "device-uri"
            Sets the device-uri attribute of the printer queue.  If device-uri
            is   a   filename  it  is  automatically  converted  to  the  form
            file:///file/name. Use the lpinfo(8) command  to  get  a  list  of
            supported device URIs and schemes.

       -D "info"
            Provides a textual description of the printer.

       -E
            Enables  the printer and accepts jobs; this is the same as running
            the cupsaccept(8) and cupsenable(8) programs on the printer.

       -L "location"
            Provides a textual location of the printer.

       -P ppd-file
            Specifies a PostScript Printer Description file to  use  with  the
            printer.  If  specified,  this  option  overrides  the  -i  option
            (interface script).

COMPATIBILITY

       Unlike the System V printing  system,  CUPS  allows  printer  names  to
       contain  any printable character except SPACE, TAB, "/", or "#".  Also,
       printer and class names are  not  case-sensitive.   Finally,  the  CUPS
       version of lpadmin may ask the user for an access password depending on
       the printing system configuration.  This  differs  from  the  System  V
       version which requires the root user to execute this command.

LIMITATIONS

       The  CUPS  version  of  lpadmin does not support all of the System V or
       Solaris printing system configuration options.

SEE ALSO

       cupsaccept(8), cupsenable(8), lpinfo(8), lpoptions(1),
       http://localhost:631/help

COPYRIGHT

       Copyright 2007-2009 by Apple Inc.