2 .\" "$Id: lpoptions.man.in 177 2006-06-21 00:20:03Z jlovell $"
4 .\" lpoptions man page for the Common UNIX Printing System (CUPS).
6 .\" Copyright 1997-2006 by Easy Software Products.
8 .\" These coded instructions, statements, and computer programs are the
9 .\" property of Easy Software Products and are protected by Federal
10 .\" copyright law. Distribution and use rights are outlined in the file
11 .\" "LICENSE.txt" which should have been included with this file. If this
12 .\" file is missing or damaged please contact Easy Software Products
15 .\" Attn: CUPS Licensing Information
16 .\" Easy Software Products
17 .\" 44141 Airport View Drive, Suite 204
18 .\" Hollywood, Maryland 20636 USA
20 .\" Voice: (301) 373-9600
21 .\" EMail: cups-info@cups.org
22 .\" WWW: http://www.cups.org
24 .TH lpoptions 1 "Common UNIX Printing System" "20 March 2006" "Easy Software Products"
26 lpoptions \- display or set printer options and defaults
34 .I destination[/instance]
47 .I destination[/instance]
60 .I destination[/instance]
70 .I destination[/instance]
72 \fIlpoptions\fR displays or sets printer options and defaults.
73 \fIlpoptions\fR shows the default printer options when run with no
74 arguments. Other options include:
78 Enables encryption when communicating with the CUPS server.
82 Uses an alternate username.
84 -d destination[/instance]
86 Sets the default printer to \fIdestination\fR. If \fIinstance\fR
87 is supplied then that particular instance is used. This option
88 overrides the system default printer for the current user.
92 Uses an alternate server.
96 Lists the printer specific options and their current settings.
100 Specifies a new option for the named destination.
102 -p destination[/instance]
104 Sets the destination and instance, if specified, for any options
105 that follow. If the named instance does not exist then it is
110 Removes the specified option for the named destination.
112 -x destination[/instance]
114 Removes the options for the named destination and instance, if
115 specified. If the named instance does not exist then this does
118 If no options are specified using the \fI-o\fR option, then the
119 current options for the named printer are reported on the
122 Options set with the \fIlpoptions\fR command are used by the
123 \fIlp(1)\fR and \fIlpr(1)\fR commands when submitting jobs.
124 .SH ROOT ACCOUNT OPTIONS
125 When run by the root user, \fIlpoptions\fR gets and sets default
126 options and instances for \fIall users\fR in the
127 @CUPS_SERVERROOT@/lpoptions file.
129 The \fIlpoptions\fR command is unique to CUPS.
131 ~/.cups/lpoptions - user defaults and instances created by non-root
134 @CUPS_SERVERROOT@/lpoptions - system-wide defaults and instances
135 created by the root user.
137 \fIcancel(1)\fR, \fIlp(1)\fR, \fIlpr(1)\fR,
139 http://localhost:631/help
141 Copyright 1997-2006 by Easy Software Products, All Rights Reserved.
143 .\" End of "$Id: lpoptions.man.in 177 2006-06-21 00:20:03Z jlovell $".