<dt><a name="SMBConfigFile"></a><b>SMBConfigFile </b><i>filename</i>
<dd style="margin-left: 5.0em">Specifies the SMB service configuration file to update.
</dl>
+<h2 class="title"><a name="NOTES">Notes</a></h2>
+The scheduler MUST be restarted manually after making changes to the <b>cups-files.conf</b> file.
+On Linux this is typically done using the
+<b>systemctl</b>(8)
+command, while on macOS the
+<b>launchctl</b>(8)
+command is used instead.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
<a href="man-classes.conf.html?TOPIC=Man+Pages"><b>classes.conf</b>(5),</a>
<a href="man-cups.html?TOPIC=Man+Pages"><b>cups</b>(1),</a>
<dd style="margin-left: 5.0em">Specifies the community name to use.
Only a single community name may be specified.
The default community name is "public".
+If no name is specified, all SNMP functions are disabled.
<dt><b>DebugLevel </b><i>number</i>
<dd style="margin-left: 5.0em">Specifies the logging level from 0 (none) to 3 (everything).
Typically only used for debugging (thus the name).
<b>--include-schemes</b>
snmp
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-The CUPS SNMP backend provides legacy discovery and identification of network printers using SNMPv1.
+The <b>DEPRECATED</b> CUPS SNMP backend provides legacy discovery and identification of network printers using SNMPv1.
When used for discovery through the scheduler, the backend will list all printers that respond to a broadcast SNMPv1 query with the "public" community name.
Additional queries are then sent to printers that respond in order to determine the correct device URI, make and model, and other information needed for printing.
<p>In the first form, the SNMP backend is run directly by the user to look up the device URI and other information when you have an IP address or hostname.
The SNMP backend reads the <i>/etc/cups/snmp.conf</i> configuration file, if
present, to set the default broadcast address, community name, and logging
level.
+<h2 class="title"><a name="NOTES">Notes</a></h2>
+The CUPS SNMP backend is deprecated and will no longer be supported in a future
+version of CUPS.
<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
The CUPS SNMP backend uses the information from the Host, Printer, and Port Monitor MIBs along with some vendor private MIBs and intelligent port probes to determine the correct device URI and make and model for each printer.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
It is normally located in the
<i>/etc/cups</i>
directory.
-<b>Note:</b> File, directory, and user configuration directives that used to be allowed in the <b>cupsd.conf</b> file are now stored in the
-<a href="man-cups-files.conf.html?TOPIC=Man+Pages"><b>cups-files.conf</b>(5)</a>
-file instead in order to prevent certain types of privilege escalation attacks.
-<p>Each line in the file can be a configuration directive, a blank line, or a comment.
+Each line in the file can be a configuration directive, a blank line, or a comment.
Configuration directives typically consist of a name and zero or more values separated by whitespace.
The configuration directive name and values are case-insensitive.
Comment lines start with the # character.
<dd style="margin-left: 5.0em">Specifies the maximum amount of memory to use when converting documents into bitmaps for a printer.
The default is "128m".
</dl>
+<h2 class="title"><a name="NOTES">Notes</a></h2>
+File, directory, and user configuration directives that used to be allowed in the <b>cupsd.conf</b> file are now stored in the
+<a href="man-cups-files.conf.html?TOPIC=Man+Pages"><b>cups-files.conf</b>(5)</a>
+file instead in order to prevent certain types of privilege escalation attacks.
+<p>The scheduler MUST be restarted manually after making changes to the <b>cupsd.conf</b> file.
+On Linux this is typically done using the
+<b>systemctl</b>(8)
+command, while on macOS the
+<b>launchctl</b>(8)
+command is used instead.
<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
The <b>cupsd.conf</b> file format is based on the Apache HTTP Server configuration file format.
<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
<a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1)</a>
command, the following generic options are available:
<dl class="man">
-<dt><b>-o collate=true</b>
-<dd style="margin-left: 5.0em">Prints collated copies.
-<dt><b>-o fit-to-page</b>
-<dd style="margin-left: 5.0em">Scales the print file to fit on the page.
-<dt><b>-o job-hold-until=</b><i>when</i>
-<dd style="margin-left: 5.0em">Holds the job until the specified local time.
-"when" can be "indefinite" to hold the until released, "day-time" to print the job between 6am and 6pm local time, "night" to print the job between 6pm and 6am local time, "second-shift" to print the job between 4pm and 12am local time, "third-shift" to print the job between 12am and 8am local time, or "weekend" to print the job on Saturday or Sunday.
-<dt><b>-o job-hold-until=</b><i>hh:mm</i>
-<dd style="margin-left: 5.0em">Holds the job until the specified time in hours and minutes UTC.
-<dt><b>-o job-priority=</b><i>priority</i>
-<dd style="margin-left: 5.0em">Set the priority to a value from 1 (lowest) to 100 (highest), which influences when a job is scheduled for printing.
-The default priority is typically 50.
<dt><b>-o job-sheets=</b><i>name</i>
<dd style="margin-left: 5.0em">Prints a cover page (banner) with the document.
The "name" can be "classified", "confidential", "secret", "standard", "topsecret", or "unclassified".
-<dt><b>-o job-sheets=</b><i>start-name,end-name</i>
-<dd style="margin-left: 5.0em">Prints cover pages (banners) with the document.
<dt><b>-o media=</b><i>size</i>
<dd style="margin-left: 5.0em">Sets the page size to <i>size</i>. Most printers support at least the size names "a4", "letter", and "legal".
-<dt><b>-o mirror</b>
-<dd style="margin-left: 5.0em">Mirrors each page.
<dt><b>-o number-up=</b>{<i>2|4|6|9|16</i>}
<dd style="margin-left: 5.0em">Prints 2, 4, 6, 9, or 16 document (input) pages on each output page.
-<dt><b>-o number-up-layout=</b><i>layout</i>
-<dd style="margin-left: 5.0em">Specifies the layout of pages with the "number-up" option.
-The "layout" string can be "btlr", "btrl", "lrbt", "lrtb", "rlbt", "rltb", "tblr", or "tbrl" - the first two letters determine the column order while the second two letters determine the row order.
-"bt" is bottom-to-top, "lr" is left-to-right, "rl" is right-to-left, and "tb" is top-to-bottom.
<dt><b>-o orientation-requested=4</b>
<dd style="margin-left: 5.0em">Prints the job in landscape (rotated 90 degrees counter-clockwise).
<dt><b>-o orientation-requested=5</b>
<dd style="margin-left: 5.0em">Prints the job in landscape (rotated 90 degrees clockwise).
<dt><b>-o orientation-requested=6</b>
<dd style="margin-left: 5.0em">Prints the job in reverse portrait (rotated 180 degrees).
-<dt><b>-o outputorder=reverse</b>
-<dd style="margin-left: 5.0em">Prints pages in reverse order.
-<dt><b>-o page-border=</b><i>border</i>
-<dd style="margin-left: 5.0em">Prints a border around each document page.
-"border" is "double", "double-thick", "single", or "single-thick".
-<dt><b>-o page-ranges=</b><i>page-list</i>
-<dd style="margin-left: 5.0em">Specifies which pages to print in the document.
-The list can contain a list of numbers and ranges (#-#) separated by commas, e.g., "1,3-5,16".
-The page numbers refer to the output pages and not the document's original pages - options like "number-up" can affect the numbering of the pages.
+<dt><b>-o print-quality=3</b>
+<dd style="margin-left: 5.0em"><dt><b>-o print-quality=4</b>
+<dd style="margin-left: 5.0em"><dt><b>-o print-quality=5</b>
+<dd style="margin-left: 5.0em">Specifies the output quality - draft (3), normal (4), or best (5).
<dt><b>-o sides=one-sided</b>
<dd style="margin-left: 5.0em">Prints on one side of the paper.
<dt><b>-o sides=two-sided-long-edge</b>
lp -d foo -o media=legal -o sides=two-sided-long-edge filename
</pre>
-Print a presentation document 2-up to a printer called "foo":
+Print a presentation document 2-up to a printer called "bar":
<pre class="man">
- lp -d foo -o number-up=2 filename
+ lp -d bar -o number-up=2 filename
</pre>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
<a href="man-cancel.html?TOPIC=Man+Pages"><b>cancel</b>(1),</a>
The default program is "none".
The specified port monitor must be listed in the printer's PPD file.
<dt><b>-o printer-error-policy=</b><i>name</i>
-<dd style="margin-left: 5.0em">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".
+<dd style="margin-left: 5.0em">Sets the policy for errors such as printers that cannot be found or accessed, don't support the format being printed, fail during submission of the print data, or cause one or more filters to crash.
+The name must be one of "abort-job" (abort the job on error), "retry-job" (retry the job at a future time), "retry-current-job" (retry the current job immediately), or "stop-printer" (stop the printer on error).
The default error policy is "stop-printer" for printers and "retry-current-job" for
classes.
<dt><b>-o printer-is-shared=true</b>
<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
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 <i>not</i> case-sensitive.
-Finally, the CUPS version of <b>lpadmin</b> may ask the user for an access password depending on the printing system configuration.
+<p>Finally, the CUPS version of <b>lpadmin</b> 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.
<h2 class="title"><a name="NOTES">Notes</a></h2>
The CUPS version of <b>lpadmin</b> does not support all of the System V or Solaris printing system configuration options.
-Interface scripts are not supported for security reasons.
+<p>Interface scripts are not supported for security reasons.
<p>The double meaning of the <b>-E</b> option is an unfortunate historical oddity.
+<p>The <b>lpadmin</b> command communicates with the scheduler (<b>cupsd</b>) to make changes to the printing system configuration.
+This configuration information is stored in several files including <i>printers.conf</i> and <i>classes.conf</i>.
+These files should not be edited directly and are an implementation detail of CUPS that is subject to change at any time.
<h2 class="title"><a name="EXAMPLE">Example</a></h2>
Create an IPP Everywhere print queue:
<pre class="man">
<a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1)</a>
command, the following generic options are available:
<dl class="man">
-<dt><b>-o collate=true</b>
-<dd style="margin-left: 5.0em">Prints collated copies.
-<dt><b>-o fit-to-page</b>
-<dd style="margin-left: 5.0em">Scales the print file to fit on the page.
-<dt><b>-o job-hold-until=</b><i>when</i>
-<dd style="margin-left: 5.0em">Holds the job until the specified local time.
-"when" can be "indefinite" to hold the until released, "day-time" to print the job between 6am and 6pm local time, "night" to print the job between 6pm and 6am local time, "second-shift" to print the job between 4pm and 12am local time, "third-shift" to print the job between 12am and 8am local time, or "weekend" to print the job on Saturday or Sunday.
-<dt><b>-o job-hold-until=</b><i>hh:mm</i>
-<dd style="margin-left: 5.0em">Holds the job until the specified time in hours and minutes UTC.
-<dt><b>-o job-priority=</b><i>priority</i>
-<dd style="margin-left: 5.0em">Set the priority to a value from 1 (lowest) to 100 (highest), which influences when a job is scheduled for printing.
-The default priority is typically 50.
<dt><b>-o job-sheets=</b><i>name</i>
<dd style="margin-left: 5.0em">Prints a cover page (banner) with the document.
The "name" can be "classified", "confidential", "secret", "standard", "topsecret", or "unclassified".
-<dt><b>-o job-sheets=</b><i>start-name,end-name</i>
-<dd style="margin-left: 5.0em">Prints cover pages (banners) with the document.
<dt><b>-o media=</b><i>size</i>
<dd style="margin-left: 5.0em">Sets the page size to <i>size</i>. Most printers support at least the size names "a4", "letter", and "legal".
-<dt><b>-o mirror</b>
-<dd style="margin-left: 5.0em">Mirrors each page.
<dt><b>-o number-up=</b>{<i>2|4|6|9|16</i>}
<dd style="margin-left: 5.0em">Prints 2, 4, 6, 9, or 16 document (input) pages on each output page.
-<dt><b>-o number-up-layout=</b><i>layout</i>
-<dd style="margin-left: 5.0em">Specifies the layout of pages with the "number-up" option.
-The "layout" string can be "btlr", "btrl", "lrbt", "lrtb", "rlbt", "rltb", "tblr", or "tbrl" - the first two letters determine the column order while the second two letters determine the row order.
-"bt" is bottom-to-top, "lr" is left-to-right, "rl" is right-to-left, and "tb" is top-to-bottom.
<dt><b>-o orientation-requested=4</b>
<dd style="margin-left: 5.0em">Prints the job in landscape (rotated 90 degrees counter-clockwise).
<dt><b>-o orientation-requested=5</b>
<dd style="margin-left: 5.0em">Prints the job in landscape (rotated 90 degrees clockwise).
<dt><b>-o orientation-requested=6</b>
<dd style="margin-left: 5.0em">Prints the job in reverse portrait (rotated 180 degrees).
-<dt><b>-o outputorder=reverse</b>
-<dd style="margin-left: 5.0em">Prints pages in reverse order.
-<dt><b>-o page-border=</b><i>border</i>
-<dd style="margin-left: 5.0em">Prints a border around each document page.
-"border" is "double", "double-thick", "single", or "single-thick".
-<dt><b>-o page-ranges=</b><i>page-list</i>
-<dd style="margin-left: 5.0em">Specifies which pages to print in the document.
-The list can contain a list of numbers and ranges (#-#) separated by commas, e.g., "1,3-5,16".
-The page numbers refer to the output pages and not the document's original pages - options like "number-up" can affect the numbering of the pages.
+<dt><b>-o print-quality=3</b>
+<dd style="margin-left: 5.0em"><dt><b>-o print-quality=4</b>
+<dd style="margin-left: 5.0em"><dt><b>-o print-quality=5</b>
+<dd style="margin-left: 5.0em">Specifies the output quality - draft (3), normal (4), or best (5).
<dt><b>-o sides=one-sided</b>
<dd style="margin-left: 5.0em">Prints on one side of the paper.
<dt><b>-o sides=two-sided-long-edge</b>
projects / thirdparty / cups.git / commitdiff
