Provided by: cups-client_2.1.3-4_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 destination [ -R
       name-default ] 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 or
       class.  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.

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 for the
            printer from the model  directory  or  using  one  of  the  driver
            interfaces.  Use the -m option with the lpinfo(8) command to get a
            list of supported models.  The model  "raw"  clears  any  existing
            interface  script  or  PPD file and the model "everywhere" queries
            the printer referred to by the specified IPP device-uri.

       -o cupsIPPSupplies=true

       -o cupsIPPSupplies=false
            Specifies whether IPP supply level values should be reported.

       -o cupsSNMPSupplies=true

       -o cupsSNMPSupplies=false
            Specifies whether SNMP supply level (RFC 3805)  values  should  be
            reported.

       -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 destination.  Any print-
            time  option  can  be defaulted, e.g., "-o number-up-default=2" to
            set the default "number-up" option value to 2.

       -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", "retry-current-job", or  "stop-printer".
            The  default  error  policy  is  "stop-printer"  for  printers and
            "retry-current-job" for classes.

       -o printer-is-shared=true

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

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

       -R name-default
            Deletes the named option from printer.

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

       -u allow:{user|@group}{,user|,@group}*

       -u deny:{user|@group}{,user|,@group}*

       -u allow:all

       -u deny:none
            Sets  user-level  access control on a destination.  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.  Use the -v
            option with the lpinfo(8) command  to  get  a  list  of  supported
            device URIs and schemes.

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

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

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

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

CONFORMING TO

       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.

NOTES

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

EXAMPLE

       Create an IPP Everywhere print queue:

           lpadmin -p myprinter -E -v ipp://myprinter.local/ipp/print -m everywhere

SEE ALSO

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

COPYRIGHT

       Copyright © 2007-2015 by Apple Inc.