<h2 class="title"><a name="CONFIGURATION_OPTIONS">Configuration Options</a></h2>
The following options are recognized when configuring a printer
queue:
-<p style="margin-left: 5.0em; text-indent: -5.0em">-c class
-<br>
-<br>
+<dl class="man">
+<dt>-c class
+<dd style="margin-left: 5.0em"><br>
Adds the named <i>printer</i> to <i>class</i>. If <i>class</i> does
not exist it is created automatically.
-<p style="margin-left: 5.0em; text-indent: -5.0em">-i interface
-<br>
-<br>
+<dt>-i interface
+<dd style="margin-left: 5.0em"><br>
Sets a System V style interface script for the printer. This
option cannot be specified with the <i>-P</i> option (PPD file)
and is intended for providing support for legacy printer drivers.
-<p style="margin-left: 5.0em; text-indent: -5.0em">-m model
-<br>
-<br>
+<dt>-m model
+<dd style="margin-left: 5.0em"><br>
Sets a standard System V interface script or PPD file for the printer from the
<i>model</i> directory or using one of the driver interfaces. Use the <i>-m</i>
option with the <i>lpinfo(8)</i> command to get a list of supported models.
-<p style="margin-left: 5.0em; text-indent: -5.0em">-o cupsIPPSupplies=true
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em">-o cupsIPPSupplies=false
-<br>
-<br>
+<dt>-o cupsIPPSupplies=true
+<dd style="margin-left: 5.0em"><dt>-o cupsIPPSupplies=false
+<dd style="margin-left: 5.0em"><br>
Specifies whether IPP supply level values should be reported.
-<p style="margin-left: 5.0em; text-indent: -5.0em">-o cupsSNMPSupplies=true
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em">-o cupsSNMPSupplies=false
-<br>
-<br>
+<dt>-o cupsSNMPSupplies=true
+<dd style="margin-left: 5.0em"><dt>-o cupsSNMPSupplies=false
+<dd style="margin-left: 5.0em"><br>
Specifies whether SNMP supply level (RFC 3805) values should be reported.
-<p style="margin-left: 5.0em; text-indent: -5.0em">-o job-k-limit=value
-<br>
-<br>
+<dt>-o job-k-limit=value
+<dd style="margin-left: 5.0em"><br>
Sets the kilobyte limit for per-user quotas. The value is an
integer number of kilobytes; one kilobyte is 1024 bytes.
-<p style="margin-left: 5.0em; text-indent: -5.0em">-o job-page-limit=value
-<br>
-<br>
+<dt>-o job-page-limit=value
+<dd style="margin-left: 5.0em"><br>
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.
-<p style="margin-left: 5.0em; text-indent: -5.0em">-o job-quota-period=value
-<br>
-<br>
+<dt>-o job-quota-period=value
+<dd style="margin-left: 5.0em"><br>
Sets the accounting period for per-user quotas. The value is an
integer number of seconds; 86,400 seconds are in one day.
-<p style="margin-left: 5.0em; text-indent: -5.0em">-o job-sheets-default=banner
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em">-o job-sheets-default=banner,banner
-<br>
-<br>
+<dt>-o job-sheets-default=banner
+<dd style="margin-left: 5.0em"><dt>-o job-sheets-default=banner,banner
+<dd style="margin-left: 5.0em"><br>
Sets the default banner page(s) to use for print jobs.
-<p style="margin-left: 5.0em; text-indent: -5.0em">-o name=value
-<br>
-<br>
+<dt>-o name=value
+<dd style="margin-left: 5.0em"><br>
Sets a PPD option for the printer. PPD options can be listed using the <i>-l</i>
option with the <i>lpoptions(1)</i> command.
-<p style="margin-left: 5.0em; text-indent: -5.0em">-o name-default=value
-<br>
-<br>
+<dt>-o name-default=value
+<dd style="margin-left: 5.0em"><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.
-<p style="margin-left: 5.0em; text-indent: -5.0em">-o port-monitor=name
-<br>
-<br>
+<dt>-o port-monitor=name
+<dd style="margin-left: 5.0em"><br>
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.
-<p style="margin-left: 5.0em; text-indent: -5.0em">-o printer-error-policy=name
-<br>
-<br>
+<dt>-o printer-error-policy=name
+<dd style="margin-left: 5.0em"><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.
-<p style="margin-left: 5.0em; text-indent: -5.0em">-o printer-is-shared=true/false
-<br>
-<br>
+<dt>-o printer-is-shared=true/false
+<dd style="margin-left: 5.0em"><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
<b>cupsd.conf</b>, while unshared/unpublished destinations are not
announced. The default value is "true".
-<p style="margin-left: 5.0em; text-indent: -5.0em">-o printer-op-policy=name
-<br>
-<br>
+<dt>-o printer-op-policy=name
+<dd style="margin-left: 5.0em"><br>
Sets the IPP operation policy associated with the destination. The
name must be defined in the <b>cupsd.conf</b> in a Policy section.
The default operation policy is "default".
-<p style="margin-left: 5.0em; text-indent: -5.0em">-R name-default
-<br>
-<br>
+<dt>-R name-default
+<dd style="margin-left: 5.0em"><br>
Deletes the named option from <i>printer</i>.
-<p style="margin-left: 5.0em; text-indent: -5.0em">-r class
-<br>
-<br>
+<dt>-r class
+<dd style="margin-left: 5.0em"><br>
Removes the named <i>printer</i> from <i>class</i>. If the
resulting class becomes empty it is removed.
-<p style="margin-left: 5.0em; text-indent: -5.0em">-u allow:user,user,@group
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em">-u deny:user,user,@group
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em">-u allow:all
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em">-u deny:none
-<br>
-<br>
+<dt>-u allow:user,user,@group
+<dd style="margin-left: 5.0em"><dt>-u deny:user,user,@group
+<dd style="margin-left: 5.0em"><dt>-u allow:all
+<dd style="margin-left: 5.0em"><dt>-u deny:none
+<dd style="margin-left: 5.0em"><br>
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.
-<p style="margin-left: 5.0em; text-indent: -5.0em">-v "device-uri"
-<br>
-<br>
+<dt>-v "device-uri"
+<dd style="margin-left: 5.0em"><br>
Sets the <i>device-uri</i> attribute of the printer queue. Use the <i>-v</i>
option with the <i>lpinfo(8)</i> command to get a list of supported device URIs
and schemes.
-<p style="margin-left: 5.0em; text-indent: -5.0em">-D "info"
-<br>
-<br>
+<dt>-D "info"
+<dd style="margin-left: 5.0em"><br>
Provides a textual description of the destination.
-<p style="margin-left: 5.0em; text-indent: -5.0em">-E
-<br>
-<br>
+<dt>-E
+<dd style="margin-left: 5.0em"><br>
Enables the destination and accepts jobs; this is the same as running the
<i>cupsaccept(8)</i> and <i>cupsenable(8)</i> programs on the destination.
-<p style="margin-left: 5.0em; text-indent: -5.0em">-L "location"
-<br>
-<br>
+<dt>-L "location"
+<dd style="margin-left: 5.0em"><br>
Provides a textual location of the destination.
-<p style="margin-left: 5.0em; text-indent: -5.0em">-P ppd-file
-<br>
-<br>
+<dt>-P ppd-file
+<dd style="margin-left: 5.0em"><br>
Specifies a PostScript Printer Description file to use with the
printer. If specified, this option overrides the <i>-i</i> option
(interface script).
+</dl>
<h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
Unlike the System V printing system, CUPS allows printer names to
contain any printable character except SPACE, TAB, "/", or "#".