lpadmin
(1m)
名称
lpadmin - configure cups printers and classes
用法概要
lpadmin [ -E ] [-U username ] [ -h server[:port] ] -d desti-
nation
lpadmin [ -E ] [-U username ] [ -h server[:port] ] -p desti-
nation option(s)
lpadmin [ -E ] [-U username ] [ -h server[:port] ] -x desti-
nation
描述
Apple Inc. lpadmin(8)
NAME
lpadmin - configure cups printers and classes
SYNOPSIS
lpadmin [ -E ] [-U username ] [ -h server[:port] ] -d desti-
nation
lpadmin [ -E ] [-U username ] [ -h server[:port] ] -p desti-
nation option(s)
lpadmin [ -E ] [-U username ] [ -h server[:port] ] -x desti-
nation
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 desti-
nation 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
for the printer from the model directory or using one
of the driver interfaces. Use the -m option with the
1 September 2010 Last change: CUPS 1
Apple Inc. lpadmin(8)
lpinfo(8) command to get a list of supported models.
-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; dou-
ble-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) com-
mand.
-o name-default=value
Sets a default server-side option for the destination.
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 back-
end is unable to send the job to the printer. The name
must be one of "abort-job", "retry-job", "retry-cur-
rent-job", or "stop-printer". The default error policy
is "stop-printer" for printers and "retry-current-job"
for classes.
-o printer-is-shared=true/false
Sets the destination to shared/published or
unshared/unpublished. Shared/published destinations
are publically announced by the server on the LAN based
on the browsing configuration in cupsd.conf, while
1 September 2010 Last change: CUPS 2
Apple Inc. lpadmin(8)
unshared/unpublished destinations are not announced.
The default value is "true".
-o printer-op-policy=name
Sets the IPP operation policy associated with the des-
tination. 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 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. If
device-uri is a filename it is automatically converted
to the form file:///file/name. 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).
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
1 September 2010 Last change: CUPS 3
Apple Inc. lpadmin(8)
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 Sys-
tem V or Solaris printing system configuration options.
ATTRIBUTES
See attributes(5) for descriptions of the following
attributes:
+---------------+------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------+
|Availability | print/cups |
+---------------+------------------+
|Stability | Volatile |
+---------------+------------------+
SEE ALSO
cupsaccept(8), cupsenable(8), lpinfo(8), lpoptions(1),
http://localhost:631/help
COPYRIGHT
Copyright 2007-2010 by Apple Inc.
NOTES
This software was built from source available at
https://java.net/projects/solaris-userland. The original
community source was downloaded from
http://ftp.easysw.com/pub/cups/1.4.5/cups-1.4.5-source.tar.bz2
Further information about this software can be found on the
open source community website at http://www.cups.org/.
1 September 2010 Last change: CUPS 4