.\"
-.\" "$Id: lpadmin.man 177 2006-06-21 00:20:03Z jlovell $"
+.\" "$Id: lpadmin.man 11022 2013-06-06 22:14:09Z msweet $"
.\"
-.\" lpadmin man page for the Common UNIX Printing System (CUPS).
+.\" lpadmin man page for CUPS.
.\"
+.\" Copyright 2007-2013 by Apple Inc.
.\" Copyright 1997-2006 by Easy Software Products.
.\"
.\" These coded instructions, statements, and computer programs are the
-.\" property of Easy Software Products and are protected by Federal
-.\" copyright law. Distribution and use rights are outlined in the file
-.\" "LICENSE.txt" which should have been included with this file. If this
-.\" file is missing or damaged please contact Easy Software Products
-.\" at:
+.\" property of Apple Inc. and are protected by Federal copyright
+.\" law. Distribution and use rights are outlined in the file "LICENSE.txt"
+.\" which should have been included with this file. If this file is
+.\" file is missing or damaged, see the license at "http://www.cups.org/".
.\"
-.\" Attn: CUPS Licensing Information
-.\" Easy Software Products
-.\" 44141 Airport View Drive, Suite 204
-.\" Hollywood, Maryland 20636 USA
-.\"
-.\" Voice: (301) 373-9600
-.\" EMail: cups-info@cups.org
-.\" WWW: http://www.cups.org
-.\"
-.TH lpadmin 8 "Common UNIX Printing System" "23 March 2006" "Easy Software Products"
+.TH lpadmin 8 "CUPS" "16 July 2012" "Apple Inc."
.SH NAME
lpadmin \- configure cups printers and classes
.SH SYNOPSIS
] [ -h
.I server[:port]
] -p
-.I printer option(s)
+.I destination
+[ -R
+.I name-default
+]
+.I option(s)
.br
.B lpadmin
[ -E ] [-U
\fIlpoptions(1)\fR command.
.LP
The second form of the command (\fI-p\fR) configures the named
-printer. The additional options are described below.
+printer or class. The additional options are described below.
.LP
The third form of the command (\fI-x\fR) deletes the printer or
class \fIdestination\fR. Any jobs that are pending for the
.TP 5
-m model
.br
-Sets a standard System V interface script or PPD file from the
-\fImodel\fR directory.
+Sets a standard System V interface script or PPD file for the printer from the
+\fImodel\fR directory or using one of the driver interfaces. Use the \fI-m\fR
+option with the \fIlpinfo(8)\fR command to get a list of supported models.
.TP 5
--o name=value
+-o cupsIPPSupplies=true
+.TP 5
+-o cupsIPPSupplies=false
.br
-Sets a PPD or server option for the printer. PPD options can be
-listed using the \fI-l\fR option with the \fIlpoptions(1)\fR
-command.
+Specifies whether IPP supply level values should be reported.
+.TP 5
+-o cupsSNMPSupplies=true
+.TP 5
+-o cupsSNMPSupplies=false
+.br
+Specifies whether SNMP supply level (RFC 3805) values should be reported.
.TP 5
-o job-k-limit=value
.br
.br
Sets the default banner page(s) to use for print jobs.
.TP 5
+-o name=value
+.br
+Sets a PPD option for the printer. PPD options can be listed using the \fI-l\fR
+option with the \fIlpoptions(1)\fR command.
+.TP 5
+-o name-default=value
+.br
+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.
+.TP 5
-o port-monitor=name
.br
Sets the binary communications program to use when printing,
-"none", "bcp", or "tbcp". The default program is "none".
+"none", "bcp", or "tbcp". The default program is "none". The
+specified port monitor must be listed in the printer's PPD file.
+.TP 5
+-o printer-error-policy=name
+.br
+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.
+.TP 5
+-o printer-is-shared=true/false
+.br
+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
+\fBcupsd.conf\fR, while unshared/unpublished destinations are not
+announced. The default value is "true".
+.TP 5
+-o printer-op-policy=name
+.br
+Sets the IPP operation policy associated with the destination. The
+name must be defined in the \fBcupsd.conf\fR in a Policy section.
+The default operation policy is "default".
+.TP 5
+-R name-default
+.br
+Deletes the named option from \fIprinter\fR.
.TP 5
-r class
.br
.TP 5
-u deny:none
.br
-Sets user-level access control on a printer. Names starting with
+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.
.TP 5
-v "device-uri"
.br
-Sets the \fIdevice-uri\fR attribute of the printer queue. If
-\fIdevice-uri\fR is a filename it is automatically converted to
-the form \fIfile:///file/name\fR.
+Sets the \fIdevice-uri\fR attribute of the printer queue. Use the \fI-v\fR
+option with the \fIlpinfo(8)\fR command to get a list of supported device URIs
+and schemes.
.TP 5
-D "info"
.br
-Provides a textual description of the printer.
+Provides a textual description of the destination.
.TP 5
-E
.br
-Enables the printer and accepts jobs; this is the same as running the
-\fIaccept(8)\fR and \fIcupsenable(8)\fR programs on the printer.
+Enables the destination and accepts jobs; this is the same as running the
+\fIcupsaccept(8)\fR and \fIcupsenable(8)\fR programs on the destination.
.TP 5
-L "location"
.br
-Provides a textual location of the printer.
+Provides a textual location of the destination.
.TP 5
-P ppd-file
.br
The CUPS version of \fIlpadmin\fR does not support all of the
System V or Solaris printing system configuration options.
.SH SEE ALSO
-\fIaccept(8)\fR, \fIcupsenable(8)\fR, \fIlpoptions(1)\fR,
+\fIcupsaccept(8)\fR, \fIcupsenable(8)\fR, \fIlpinfo(8)\fR,
+\fIlpoptions(1)\fR,
.br
http://localhost:631/help
.SH COPYRIGHT
-Copyright 1997-2006 by Easy Software Products, All Rights Reserved.
+Copyright 2007-2013 by Apple Inc.
.\"
-.\" End of "$Id: lpadmin.man 177 2006-06-21 00:20:03Z jlovell $".
+.\" End of "$Id: lpadmin.man 11022 2013-06-06 22:14:09Z msweet $".
.\"
projects / thirdparty / cups.git / blobdiff