xref: /aosp_15_r20/external/libcups/doc/help/man-lpoptions.html (revision 5e7646d21f1134fb0638875d812ef646c12ab91e)
1*5e7646d2SAndroid Build Coastguard Worker<!DOCTYPE HTML>
2*5e7646d2SAndroid Build Coastguard Worker<html>
3*5e7646d2SAndroid Build Coastguard Worker<!-- SECTION: Man Pages -->
4*5e7646d2SAndroid Build Coastguard Worker<head>
5*5e7646d2SAndroid Build Coastguard Worker	<link rel="stylesheet" type="text/css" href="../cups-printable.css">
6*5e7646d2SAndroid Build Coastguard Worker	<title>lpoptions(1)</title>
7*5e7646d2SAndroid Build Coastguard Worker</head>
8*5e7646d2SAndroid Build Coastguard Worker<body>
9*5e7646d2SAndroid Build Coastguard Worker<h1 class="title">lpoptions(1)</h1>
10*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="NAME">Name</a></h2>
11*5e7646d2SAndroid Build Coastguard Workerlpoptions - display or set printer options and defaults
12*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
13*5e7646d2SAndroid Build Coastguard Worker<b>lpoptions</b>
14*5e7646d2SAndroid Build Coastguard Worker[
15*5e7646d2SAndroid Build Coastguard Worker<b>-E</b>
16*5e7646d2SAndroid Build Coastguard Worker] [
17*5e7646d2SAndroid Build Coastguard Worker<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
18*5e7646d2SAndroid Build Coastguard Worker]
19*5e7646d2SAndroid Build Coastguard Worker<b>-d </b><i>destination</i>[<b>/</b><i>instance</i>]
20*5e7646d2SAndroid Build Coastguard Worker[
21*5e7646d2SAndroid Build Coastguard Worker<b>-l</b>
22*5e7646d2SAndroid Build Coastguard Worker]
23*5e7646d2SAndroid Build Coastguard Worker<br>
24*5e7646d2SAndroid Build Coastguard Worker<b>lpoptions</b>
25*5e7646d2SAndroid Build Coastguard Worker[
26*5e7646d2SAndroid Build Coastguard Worker<b>-E</b>
27*5e7646d2SAndroid Build Coastguard Worker] [
28*5e7646d2SAndroid Build Coastguard Worker<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
29*5e7646d2SAndroid Build Coastguard Worker] [
30*5e7646d2SAndroid Build Coastguard Worker<b>-p </b><i>destination</i>[<b>/</b><i>instance</i>]
31*5e7646d2SAndroid Build Coastguard Worker]
32*5e7646d2SAndroid Build Coastguard Worker<b>-o </b><i>option</i>[<b>=</b><i>value</i>] ...
33*5e7646d2SAndroid Build Coastguard Worker<br>
34*5e7646d2SAndroid Build Coastguard Worker<b>lpoptions</b>
35*5e7646d2SAndroid Build Coastguard Worker[
36*5e7646d2SAndroid Build Coastguard Worker<b>-E</b>
37*5e7646d2SAndroid Build Coastguard Worker] [
38*5e7646d2SAndroid Build Coastguard Worker<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
39*5e7646d2SAndroid Build Coastguard Worker] [
40*5e7646d2SAndroid Build Coastguard Worker<b>-p </b><i>destination</i>[<b>/</b><i>instance</i>]
41*5e7646d2SAndroid Build Coastguard Worker]
42*5e7646d2SAndroid Build Coastguard Worker<b>-r</b>
43*5e7646d2SAndroid Build Coastguard Worker<i>option</i>
44*5e7646d2SAndroid Build Coastguard Worker<br>
45*5e7646d2SAndroid Build Coastguard Worker<b>lpoptions</b>
46*5e7646d2SAndroid Build Coastguard Worker[
47*5e7646d2SAndroid Build Coastguard Worker<b>-E</b>
48*5e7646d2SAndroid Build Coastguard Worker] [
49*5e7646d2SAndroid Build Coastguard Worker<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
50*5e7646d2SAndroid Build Coastguard Worker]
51*5e7646d2SAndroid Build Coastguard Worker<b>-x </b><i>destination</i>[<b>/</b><i>instance</i>]
52*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
53*5e7646d2SAndroid Build Coastguard Worker<b>lpoptions</b> displays or sets printer options and defaults.
54*5e7646d2SAndroid Build Coastguard WorkerIf no printer is specified using the <i>-p</i> option, the default printer is used as described in
55*5e7646d2SAndroid Build Coastguard Worker<b>lp</b>(1).
56*5e7646d2SAndroid Build Coastguard Worker<p>If no <i>-l</i>, <i>-o</i>, or <i>-r</i> options are specified, the current options are reported on the standard output.
57*5e7646d2SAndroid Build Coastguard Worker<p>Options set with the <b>lpoptions</b> command are used by the
58*5e7646d2SAndroid Build Coastguard Worker<b>lp</b>(1)
59*5e7646d2SAndroid Build Coastguard Workerand
60*5e7646d2SAndroid Build Coastguard Worker<b>lpr</b>(1)
61*5e7646d2SAndroid Build Coastguard Workercommands when submitting jobs.
62*5e7646d2SAndroid Build Coastguard Worker<p>When run by the root user, <b>lpoptions</b> gets and sets default options and instances for all users in the <i>/etc/cups/lpoptions</i> file.
63*5e7646d2SAndroid Build Coastguard WorkerOtherwise, the per-user defaults are managed in the <i>~/.cups/lpoptions</i> file.
64*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="OPTIONS">Options</a></h2>
65*5e7646d2SAndroid Build Coastguard Worker<b>lpoptions</b> supports the following options:
66*5e7646d2SAndroid Build Coastguard Worker<dl class="man">
67*5e7646d2SAndroid Build Coastguard Worker<dt><b>-E</b>
68*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Enables encryption when communicating with the CUPS server.
69*5e7646d2SAndroid Build Coastguard Worker<dt><b>-d </b><i>destination</i>[<b>/</b><i>instance</i>]
70*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Sets the user default printer to <i>destination</i>.
71*5e7646d2SAndroid Build Coastguard WorkerIf <i>instance</i> is supplied then that particular instance is used.
72*5e7646d2SAndroid Build Coastguard WorkerThis option overrides the system default printer for the current user.
73*5e7646d2SAndroid Build Coastguard Worker<dt><b>-h </b><i>server</i>[<b>:</b><i>port</i>]
74*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Uses an alternate server.
75*5e7646d2SAndroid Build Coastguard Worker<dt><b>-l</b>
76*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Lists the printer specific options and their current settings.
77*5e7646d2SAndroid Build Coastguard Worker<dt><b>-o </b><i>option</i>[<b>=</b><i>value</i>]
78*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies a new option for the named destination.
79*5e7646d2SAndroid Build Coastguard Worker<dt><b>-p </b><i>destination</i>[<b>/</b><i>instance</i>]
80*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Sets the destination and instance, if specified, for any options that follow.
81*5e7646d2SAndroid Build Coastguard WorkerIf the named instance does not exist then it is created.
82*5e7646d2SAndroid Build Coastguard WorkerDestinations can only be created using the
83*5e7646d2SAndroid Build Coastguard Worker<b>lpadmin</b>(8)
84*5e7646d2SAndroid Build Coastguard Workerprogram.
85*5e7646d2SAndroid Build Coastguard Worker<dt><b>-r </b><i>option</i>
86*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Removes the specified option from the named destination.
87*5e7646d2SAndroid Build Coastguard Worker<dt><b>-x </b><i>destination</i>[<b>/</b><i>instance</i>]
88*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Removes the options for the named destination and instance, if specified.
89*5e7646d2SAndroid Build Coastguard WorkerIf the named instance does not exist then this does nothing.
90*5e7646d2SAndroid Build Coastguard WorkerDestinations can only be removed using the
91*5e7646d2SAndroid Build Coastguard Worker<b>lpadmin</b>(8)
92*5e7646d2SAndroid Build Coastguard Workercommand.
93*5e7646d2SAndroid Build Coastguard Worker</dl>
94*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="FILES">Files</a></h2>
95*5e7646d2SAndroid Build Coastguard Worker<i>~/.cups/lpoptions</i> - user defaults and instances created by non-root users.
96*5e7646d2SAndroid Build Coastguard Worker<br>
97*5e7646d2SAndroid Build Coastguard Worker<i>/etc/cups/lpoptions</i> - system-wide defaults and instances created by the root user.
98*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
99*5e7646d2SAndroid Build Coastguard WorkerThe <b>lpoptions</b> command is unique to CUPS.
100*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
101*5e7646d2SAndroid Build Coastguard Worker<b>cancel</b>(1),
102*5e7646d2SAndroid Build Coastguard Worker<b>lp</b>(1),
103*5e7646d2SAndroid Build Coastguard Worker<b>lpadmin</b>(8),
104*5e7646d2SAndroid Build Coastguard Worker<b>lpr</b>(1),
105*5e7646d2SAndroid Build Coastguard Worker<b>lprm</b>(1),
106*5e7646d2SAndroid Build Coastguard WorkerCUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
107*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
108*5e7646d2SAndroid Build Coastguard WorkerCopyright &copy; 2007-2019 by Apple Inc.
109*5e7646d2SAndroid Build Coastguard Worker
110*5e7646d2SAndroid Build Coastguard Worker</body>
111*5e7646d2SAndroid Build Coastguard Worker</html>
112