]> git.ipfire.org Git - thirdparty/cups.git/blame - man/lpoptions.man.in
Fix 'it not'/'is not' typo in client.conf.man manpage
[thirdparty/cups.git] / man / lpoptions.man.in
CommitLineData
ef416fc2 1.\"
6e12033b 2.\" lpoptions man page for CUPS.
ef416fc2 3.\"
6e12033b
MS
4.\" Copyright 2007-2014 by Apple Inc.
5.\" Copyright 1997-2006 by Easy Software Products.
ef416fc2 6.\"
6e12033b
MS
7.\" These coded instructions, statements, and computer programs are the
8.\" property of Apple Inc. and are protected by Federal copyright
9.\" law. Distribution and use rights are outlined in the file "LICENSE.txt"
10.\" which should have been included with this file. If this file is
11.\" file is missing or damaged, see the license at "http://www.cups.org/".
ef416fc2 12.\"
6e12033b 13.TH lpoptions 1 "CUPS" "12 June 2014" "Apple Inc."
ef416fc2 14.SH NAME
15lpoptions \- display or set printer options and defaults
16.SH SYNOPSIS
17.B lpoptions
6e12033b
MS
18[
19.B \-E
20] [
21.B \-U
bd7854cb 22.I username
6e12033b
MS
23] [
24\fB\-h \fIserver\fR[\fB:\fIport\fR]
25]
26\fB\-d \fIdestination\fR[\fB/\fIinstance\fR]
27[
28.B \-l
ef416fc2 29]
30.br
31.B lpoptions
6e12033b
MS
32[
33.B \-E
34] [
35.B \-U
bd7854cb 36.I username
6e12033b
MS
37] [
38\fB\-h \fIserver\fR[\fB:\fIport\fR]
39] [
40\fB\-p \fIdestination\fR[\fB/\fIinstance\fR]
41]
42\fB\-o \fIoption\fR[\fB=\fIvalue\fR] ...
ef416fc2 43.br
44.B lpoptions
6e12033b
MS
45[
46.B \-E
47] [
48.B \-U
bd7854cb 49.I username
6e12033b
MS
50] [
51\fB\-h \fIserver\fR[\fB:\fIport\fR]
52] [
53\fB\-p \fIdestination\fR[\fB/\fIinstance\fR]
54]
55.B \-r
ef416fc2 56.I option
57.br
58.B lpoptions
6e12033b
MS
59[
60.B \-E
61] [
62.B \-U
bd7854cb 63.I username
6e12033b
MS
64] [
65\fB\-h \fIserver\fR[\fB:\fIport\fR]
66]
67\fB\-x \fIdestination\fR[\fB/\fIinstance\fR]
ef416fc2 68.SH DESCRIPTION
6e12033b
MS
69\fBlpoptions\fR displays or sets printer options and defaults.
70If no printer is specified using the \fI\-p\fR option, the default printer is used as described in
71.BR lp (1).
72.LP
73If no \fI\-l\fR, \fI\-o\fR, or \fI\-r\fR options are specified, the current options are reported on the standard output.
74.LP
75Options set with the \fBlpoptions\fR command are used by the
76.BR lp (1)
77and
78.BR lpr (1)
79commands when submitting jobs.
80.LP
81When run by the root user, \fBlpoptions\fR gets and sets default options and instances for all users in the \fI/etc/cups/lpoptions\fR file.
82Otherwise, the per-user defaults are managed in the \fI~/.cups/lpoptions\fR file.
83.SH OPTIONS
84\fBlpoptions\fR supports the following options:
ef416fc2 85.TP 5
6e12033b 86.B \-E
ef416fc2 87Enables encryption when communicating with the CUPS server.
88.TP 5
6e12033b 89\fB\-U \fIusername\fR
bd7854cb 90Uses an alternate username.
91.TP 5
6e12033b
MS
92\fB\-d \fIdestination\fR[\fB/\fIinstance\fR]
93Sets the user default printer to \fIdestination\fR.
94If \fIinstance\fR is supplied then that particular instance is used.
95This option overrides the system default printer for the current user.
ef416fc2 96.TP 5
6e12033b 97\fB\-h \fIserver\fR[\fB:\fIport\fR]
bd7854cb 98Uses an alternate server.
ef416fc2 99.TP 5
6e12033b 100.B \-l
ef416fc2 101Lists the printer specific options and their current settings.
102.TP 5
6e12033b 103\fB\-o \fIoption\fR[\fB=\fIvalue\fR]
ef416fc2 104Specifies a new option for the named destination.
105.TP 5
6e12033b
MS
106\fB\-p \fIdestination\fR[\fB/\fIinstance\fR]
107Sets the destination and instance, if specified, for any options that follow.
108If the named instance does not exist then it is created.
109Destinations can only be created using the
110.BR lpadmin (8)
111program.
ef416fc2 112.TP 5
6e12033b
MS
113\fB\-r \fIoption\fR
114Removes the specified option from the named destination.
ef416fc2 115.TP 5
6e12033b
MS
116\fB\-x \fIdestination\fR[\fB/\fIinstance\fR]
117Removes the options for the named destination and instance, if specified.
118If the named instance does not exist then this does nothing.
119Destinations can only be removed using the
120.BR lpadmin (8)
121command.
ef416fc2 122.SH FILES
6e12033b 123\fI~/.cups/lpoptions\fR - user defaults and instances created by non-root users.
ef416fc2 124.br
6e12033b
MS
125\fI/etc/cups/lpoptions\fR - system-wide defaults and instances created by the root user.
126.SH CONFORMING TO
127The \fBlpoptions\fR command is unique to CUPS.
ef416fc2 128.SH SEE ALSO
6e12033b
MS
129.BR cancel (1),
130.BR lp (1),
131.BR lpadmin (8),
132.BR lpr (1),
133.BR lprm (1),
134CUPS Online Help (http://localhost:631/help)
ef416fc2 135.SH COPYRIGHT
d58c2629 136Copyright \[co] 2007-2016 by Apple Inc.