lpadmin(8)                 Apple Inc.                  lpadmin(8)


     lpadmin - configure cups printers and classes


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


     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)

     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 desti-
     nation will be removed and any job that is currently printed
     will be aborted.


     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 name=value

13 July 2006Last change: Common UNIX Printing System            1

lpadmin(8)                 Apple Inc.                  lpadmin(8)

          Sets a PPD  or  server  option  for  the  printer.  PPD
          options  can  be  listed  using  the -l option with the
          lpoptions(1) command.

     -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

     -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 port-monitor=name
          Sets the binary  communications  program  to  use  when
          printing, "none", "bcp", or "tbcp". The default program
          is "none".

     -o printer-error-policy=name
          Sets the error policy to be used when the printer back-
          end  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

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

13 July 2006Last change: Common UNIX Printing System            2

lpadmin(8)                 Apple Inc.                  lpadmin(8)

     -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)  com-
          mand  to  get  a  list  of  supported  device  URIs and

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

          Enables the printer and accepts jobs; this is the  same
          as  running the accept(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).


     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.


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


     accept(8), cupsenable(8), lpinfo(8), lpoptions(1),

13 July 2006Last change: Common UNIX Printing System            3

lpadmin(8)                 Apple Inc.                  lpadmin(8)


     Copyright 2007 by Apple Inc.

13 July 2006Last change: Common UNIX Printing System            4

Man(1) output converted with man2html