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

<!DOCTYPE HTML>
<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:
<p style="margin-left: 5.0em; text-indent: -5.0em">-E
<br>
<br>
Enables encryption when communicating with the CUPS server.
<p style="margin-left: 5.0em; text-indent: -5.0em">-U username
<br>
<br>
Uses an alternate username.
<p style="margin-left: 5.0em; text-indent: -5.0em">-d destination[/instance]
<br>
<br>
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.
<p style="margin-left: 5.0em; text-indent: -5.0em">-h server[:port]
<br>
<br>
Uses an alternate server.
<p style="margin-left: 5.0em; text-indent: -5.0em">-l
<br>
<br>
Lists the printer specific options and their current settings.
<p style="margin-left: 5.0em; text-indent: -5.0em">-o option[=value]
<br>
<br>
Specifies a new option for the named destination.
<p style="margin-left: 5.0em; text-indent: -5.0em">-p destination[/instance]
<br>
<br>
Sets the destination and instance, if specified, for any options
that follow. If the named instance does not exist then it is
created.
<p style="margin-left: 5.0em; text-indent: -5.0em">-r option
<br>
<br>
Removes the specified option for the named destination.
<p style="margin-left: 5.0em; text-indent: -5.0em">-x destination[/instance]
<br>
<br>
Removes the options for the named destination and instance, if
specified. If the named instance does not exist then this does
nothing.
<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
<i>lp(1)</i> and <i>lpr(1)</i> 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
/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>
/etc/cups/lpoptions - system-wide defaults and instances
created by the root user.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
<i>cancel(1)</i>, <i>lp(1)</i>, <i>lpadmin(8)</i>, <i>lpr(1)</i>,
<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
c277f98c	1	<!DOCTYPE HTML>
94436c5a MS	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>
c277f98c MS	13	<b>lpoptions</b>
	14	[ -E ] [ -U
	15	<i>username</i>
	16	] [ -h
	17	<i>server[:port]</i>
	18	] -d
	19	<i>destination[/instance]</i>
	20	[ -o
	21	<i>option[=value]</i>
	22	] ... [ -o
	23	<i>option[=value]</i>
	24	]
	25	<br>
	26	<b>lpoptions</b>
	27	[ -E ] [ -U
	28	<i>username</i>
	29	] [ -h
	30	<i>server[:port]</i>
	31	] [ -p
	32	<i>destination[/instance]</i>
	33	] -l
	34	<br>
	35	<b>lpoptions</b>
	36	[ -E ] [ -U
	37	<i>username</i>
	38	] [ -h
	39	<i>server[:port]</i>
	40	] [ -o
	41	<i>option[=value]</i>
	42	] ... [ -o
	43	<i>option[=value]</i>
	44	] [ -p
	45	<i>destination[/instance]</i>
	46	] -r
	47	<i>option</i>
	48	<br>
	49	<b>lpoptions</b>
	50	[ -E ] [ -U
	51	<i>username</i>
	52	] [ -h
	53	<i>server[:port]</i>
	54	] -x
	55	<i>destination[/instance]</i>
	56	<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
94436c5a MS	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:
c277f98c MS	60	<p style="margin-left: 5.0em; text-indent: -5.0em">-E
	61	<br>
	62	<br>
	63	Enables encryption when communicating with the CUPS server.
	64	<p style="margin-left: 5.0em; text-indent: -5.0em">-U username
	65	<br>
	66	<br>
	67	Uses an alternate username.
	68	<p style="margin-left: 5.0em; text-indent: -5.0em">-d destination[/instance]
	69	<br>
	70	<br>
	71	Sets the user default printer to <i>destination</i>. If <i>instance</i>
94436c5a MS	72	is supplied then that particular instance is used. This option
94436c5a MS	73	overrides the system default printer for the current user.
c277f98c MS	74	<p style="margin-left: 5.0em; text-indent: -5.0em">-h server[:port]
	75	<br>
	76	<br>
	77	Uses an alternate server.
	78	<p style="margin-left: 5.0em; text-indent: -5.0em">-l
	79	<br>
	80	<br>
	81	Lists the printer specific options and their current settings.
	82	<p style="margin-left: 5.0em; text-indent: -5.0em">-o option[=value]
	83	<br>
	84	<br>
	85	Specifies a new option for the named destination.
	86	<p style="margin-left: 5.0em; text-indent: -5.0em">-p destination[/instance]
	87	<br>
	88	<br>
	89	Sets the destination and instance, if specified, for any options
94436c5a MS	90	that follow. If the named instance does not exist then it is
94436c5a MS	91	created.
c277f98c MS	92	<p style="margin-left: 5.0em; text-indent: -5.0em">-r option
	93	<br>
	94	<br>
	95	Removes the specified option for the named destination.
	96	<p style="margin-left: 5.0em; text-indent: -5.0em">-x destination[/instance]
	97	<br>
	98	<br>
	99	Removes the options for the named destination and instance, if
94436c5a MS	100	specified. If the named instance does not exist then this does
94436c5a MS	101	nothing.
94436c5a MS	102	<p>If no options are specified using the <i>-o</i> option, then the
	103	current options for the named printer are reported on the
	104	standard output.
	105	<p>Options set with the <i>lpoptions</i> command are used by the
c277f98c	106	<i>lp(1)</i> and <i>lpr(1)</i> commands when submitting jobs.
94436c5a MS	107	<h2 class="title"><a name="ROOT_ACCOUNT_OPTIONS">Root Account Options</a></h2>
	108	When run by the root user, <i>lpoptions</i> gets and sets default
	109	options and instances for <i>all users</i> in the
ffa2ca90	110	/etc/cups/lpoptions file.
94436c5a MS	111	<h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
	112	The <i>lpoptions</i> command is unique to CUPS.
	113	<h2 class="title"><a name="FILES">Files</a></h2>
	114	~/.cups/lpoptions - user defaults and instances created by non-root
	115	users.
	116	<br>
ffa2ca90	117	/etc/cups/lpoptions - system-wide defaults and instances
94436c5a MS	118	created by the root user.
94436c5a MS	119	<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
c277f98c	120	<i>cancel(1)</i>, <i>lp(1)</i>, <i>lpadmin(8)</i>, <i>lpr(1)</i>,
94436c5a	121	<br>
c277f98c	122	<a href="http://localhost:631/help">http://localhost:631/help</a>
94436c5a MS	123	<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
	124	Copyright 2007-2013 by Apple Inc.
	125
	126	</body>
	127	</html>