lpadmin(8) Apple Inc. lpadmin(8)
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 spec-ifies specifies
ifies 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 pend-ing pending
ing 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 name=value
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 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 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 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 automati-cally automatically
cally converted to the form file:///file/name. Use the lpinfo(8) command to get a list of sup-ported supported
ported 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 accept(8) and cupsen-able(8) cupsenable(8)
able(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 con-figuration. configuration.
figuration. This differs from the System V version which requires the root user to execute this com-mand. command.
mand.
LIMITATIONS
The CUPS version of lpadmin does not support all of the System V or Solaris printing system configu-ration configuration
ration options.
SEE ALSO
accept(8), cupsenable(8), lpinfo(8), lpoptions(1),
http://localhost:631/help
COPYRIGHT
Copyright 2007 by Apple Inc.
13 July 2006 Common UNIX Printing System lpadmin(8)
|