[thirdparty/cups.git] / doc / help / man-lpoptions.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- SECTION: Man Pages -->
<head>
	<link rel="stylesheet" type="text/css" href="../cups-printable.css">
	<title>lpoptions(1)</title>
</head>
<body>
<h1 class="title">lpoptions(1)</h1>
<h2 class="title"><a name="NAME">Name</a></h2>
lpoptions - display or set printer options and defaults
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
<b>lpoptions
</b>[ -E ] [ -U
<i>username
</i>] [ -h
<i>server[:port]
</i>] -d
<i>destination[/instance]
</i>[ -o
<i>option[=value]
</i>] ... [ -o
<i>option[=value]
</i>]
<br>
<b>lpoptions
</b>[ -E ] [ -U
<i>username
</i>] [ -h
<i>server[:port]
</i>] [ -p
<i>destination[/instance]
</i>] -l
<br>
<b>lpoptions
</b>[ -E ] [ -U
<i>username
</i>] [ -h
<i>server[:port]
</i>] [ -o
<i>option[=value]
</i>] ... [ -o
<i>option[=value]
</i>] [ -p
<i>destination[/instance]
</i>] -r
<i>option
</i><br>
<b>lpoptions
</b>[ -E ] [ -U
<i>username
</i>] [ -h
<i>server[:port]
</i>] -x
<i>destination[/instance]
</i><h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>lpoptions</i> displays or sets printer options and defaults.
<i>lpoptions</i> shows the default printer options when run with no
arguments. Other options include:
<dl>
<dt>-E
</dt>
<dd></dd>
<dd>Enables encryption when communicating with the CUPS server.
</dd>
<dt>-U username
</dt>
<dd></dd>
<dd>Uses an alternate username.
</dd>
<dt>-d destination[/instance]
</dt>
<dd></dd>
<dd>Sets the user default printer to <i>destination</i>. If <i>instance</i>
is supplied then that particular instance is used. This option
overrides the system default printer for the current user.
</dd>
<dt>-h server[:port]
</dt>
<dd></dd>
<dd>Uses an alternate server.
</dd>
<dt>-l
</dt>
<dd></dd>
<dd>Lists the printer specific options and their current settings.
</dd>
<dt>-o option[=value]
</dt>
<dd></dd>
<dd>Specifies a new option for the named destination.
</dd>
<dt>-p destination[/instance]
</dt>
<dd></dd>
<dd>Sets the destination and instance, if specified, for any options
that follow. If the named instance does not exist then it is
created.
</dd>
<dt>-r option
</dt>
<dd></dd>
<dd>Removes the specified option for the named destination.
</dd>
<dt>-x destination[/instance]
</dt>
<dd></dd>
<dd>Removes the options for the named destination and instance, if
specified. If the named instance does not exist then this does
nothing.
</dd>
</dl>
<p>If no options are specified using the <i>-o</i> option, then the
current options for the named printer are reported on the
standard output.
<p>Options set with the <i>lpoptions</i> command are used by the
<a href='man-lp.html?TOPIC=Man+Pages'>lp(1)</a> and <a href='man-lpr.html?TOPIC=Man+Pages'>lpr(1)</a> commands when submitting jobs.
<h2 class="title"><a name="ROOT_ACCOUNT_OPTIONS">Root Account Options</a></h2>
When run by the root user, <i>lpoptions</i> gets and sets default
options and instances for <i>all users</i> in the
/private/etc/cups/lpoptions file.
<h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
The <i>lpoptions</i> command is unique to CUPS.
<h2 class="title"><a name="FILES">Files</a></h2>
~/.cups/lpoptions - user defaults and instances created by non-root
users.
<br>
/private/etc/cups/lpoptions - system-wide defaults and instances
created by the root user.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
<a href='man-cancel.html?TOPIC=Man+Pages'>cancel(1)</a>, <a href='man-lp.html?TOPIC=Man+Pages'>lp(1)</a>, <a href='man-lpadmin.html?TOPIC=Man+Pages'>lpadmin(8)</a>, <a href='man-lpr.html?TOPIC=Man+Pages'>lpr(1)</a>,
<br>
<a href='http://localhost:631/help'>http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.

</body>
</html>
Commit	Line	Data
62b97abe	1	<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
	2	<html>
	3	<!-- SECTION: Man Pages -->
	4	<head>
	5	<link rel="stylesheet" type="text/css" href="../cups-printable.css">
	6	<title>lpoptions(1)</title>
	7	</head>
	8	<body>
	9	<h1 class="title">lpoptions(1)</h1>
	10	<h2 class="title"><a name="NAME">Name</a></h2>
	11	lpoptions - display or set printer options and defaults
	12	<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
	13	<b>lpoptions
	14	</b>[ -E ] [ -U
	15	<i>username
	16	</i>] [ -h
	17	<i>server[:port]
	18	</i>] -d
	19	<i>destination[/instance]
	20	</i>[ -o
	21	<i>option[=value]
	22	</i>] ... [ -o
	23	<i>option[=value]
	24	</i>]
	25	<br>
	26	<b>lpoptions
	27	</b>[ -E ] [ -U
	28	<i>username
	29	</i>] [ -h
	30	<i>server[:port]
	31	</i>] [ -p
	32	<i>destination[/instance]
	33	</i>] -l
	34	<br>
	35	<b>lpoptions
	36	</b>[ -E ] [ -U
	37	<i>username
	38	</i>] [ -h
	39	<i>server[:port]
	40	</i>] [ -o
	41	<i>option[=value]
	42	</i>] ... [ -o
	43	<i>option[=value]
	44	</i>] [ -p
	45	<i>destination[/instance]
	46	</i>] -r
	47	<i>option
	48	</i><br>
	49	<b>lpoptions
	50	</b>[ -E ] [ -U
	51	<i>username
	52	</i>] [ -h
	53	<i>server[:port]
	54	</i>] -x
	55	<i>destination[/instance]
	56	</i><h2 class="title"><a name="DESCRIPTION">Description</a></h2>
	57	<i>lpoptions</i> displays or sets printer options and defaults.
	58	<i>lpoptions</i> shows the default printer options when run with no
	59	arguments. Other options include:
	60	<dl>
	61	<dt>-E
	62	</dt>
	63	<dd></dd>
	64	<dd>Enables encryption when communicating with the CUPS server.
65	</dd>
66	<dt>-U username
67	</dt>
68	<dd></dd>
69	<dd>Uses an alternate username.
70	</dd>
71	<dt>-d destination[/instance]
72	</dt>
73	<dd></dd>
74	<dd>Sets the user default printer to <i>destination</i>. If <i>instance</i>
75	is supplied then that particular instance is used. This option
76	overrides the system default printer for the current user.
77	</dd>
78	<dt>-h server[:port]
79	</dt>
80	<dd></dd>
81	<dd>Uses an alternate server.
82	</dd>
83	<dt>-l
84	</dt>
85	<dd></dd>
86	<dd>Lists the printer specific options and their current settings.
87	</dd>
88	<dt>-o option[=value]
89	</dt>
90	<dd></dd>
91	<dd>Specifies a new option for the named destination.
92	</dd>
93	<dt>-p destination[/instance]
94	</dt>
95	<dd></dd>
96	<dd>Sets the destination and instance, if specified, for any options
97	that follow. If the named instance does not exist then it is
98	created.
99	</dd>
100	<dt>-r option
101	</dt>
102	<dd></dd>
103	<dd>Removes the specified option for the named destination.
104	</dd>
105	<dt>-x destination[/instance]
106	</dt>
107	<dd></dd>
108	<dd>Removes the options for the named destination and instance, if
109	specified. If the named instance does not exist then this does
110	nothing.
111	</dd>
112	</dl>
113	<p>If no options are specified using the <i>-o</i> option, then the
114	current options for the named printer are reported on the
115	standard output.
116	<p>Options set with the <i>lpoptions</i> command are used by the
117	<a href='man-lp.html?TOPIC=Man+Pages'>lp(1)</a> and <a href='man-lpr.html?TOPIC=Man+Pages'>lpr(1)</a> commands when submitting jobs.
118	<h2 class="title"><a name="ROOT_ACCOUNT_OPTIONS">Root Account Options</a></h2>
119	When run by the root user, <i>lpoptions</i> gets and sets default
120	options and instances for <i>all users</i> in the
579b6de1	121	/private/etc/cups/lpoptions file.
62b97abe	122	<h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
	123	The <i>lpoptions</i> command is unique to CUPS.
	124	<h2 class="title"><a name="FILES">Files</a></h2>
	125	~/.cups/lpoptions - user defaults and instances created by non-root
	126	users.
	127	<br>
579b6de1	128	/private/etc/cups/lpoptions - system-wide defaults and instances
62b97abe	129	created by the root user.
	130	<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
	131	<a href='man-cancel.html?TOPIC=Man+Pages'>cancel(1)</a>, <a href='man-lp.html?TOPIC=Man+Pages'>lp(1)</a>, <a href='man-lpadmin.html?TOPIC=Man+Pages'>lpadmin(8)</a>, <a href='man-lpr.html?TOPIC=Man+Pages'>lpr(1)</a>,
	132	<br>
	133	<a href='http://localhost:631/help'>http://localhost:631/help</a>
	134	<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
	135	Copyright 2007-2013 by Apple Inc.
	136
	137	</body>
	138	</html>