|
|
.\"
|
|
|
.\" lpoptions man page for CUPS.
|
|
|
.\"
|
|
|
.\" Copyright © 2007-2019 by Apple Inc.
|
|
|
.\" Copyright © 1997-2006 by Easy Software Products.
|
|
|
.\"
|
|
|
.\" Licensed under Apache License v2.0. See the file "LICENSE" for more
|
|
|
.\" information.
|
|
|
.\"
|
|
|
.TH lpoptions 1 "CUPS" "26 April 2019" "Apple Inc."
|
|
|
.SH NAME
|
|
|
lpoptions \- display or set printer options and defaults
|
|
|
.SH SYNOPSIS
|
|
|
.B lpoptions
|
|
|
[
|
|
|
.B \-E
|
|
|
] [
|
|
|
\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
|
|
]
|
|
|
\fB\-d \fIdestination\fR[\fB/\fIinstance\fR]
|
|
|
[
|
|
|
.B \-l
|
|
|
]
|
|
|
.br
|
|
|
.B lpoptions
|
|
|
[
|
|
|
.B \-E
|
|
|
] [
|
|
|
\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
|
|
] [
|
|
|
\fB\-p \fIdestination\fR[\fB/\fIinstance\fR]
|
|
|
]
|
|
|
\fB\-o \fIoption\fR[\fB=\fIvalue\fR] ...
|
|
|
.br
|
|
|
.B lpoptions
|
|
|
[
|
|
|
.B \-E
|
|
|
] [
|
|
|
\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
|
|
] [
|
|
|
\fB\-p \fIdestination\fR[\fB/\fIinstance\fR]
|
|
|
]
|
|
|
.B \-r
|
|
|
.I option
|
|
|
.br
|
|
|
.B lpoptions
|
|
|
[
|
|
|
.B \-E
|
|
|
] [
|
|
|
\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
|
|
]
|
|
|
\fB\-x \fIdestination\fR[\fB/\fIinstance\fR]
|
|
|
.SH DESCRIPTION
|
|
|
\fBlpoptions\fR displays or sets printer options and defaults.
|
|
|
If no printer is specified using the \fI\-p\fR option, the default printer is used as described in
|
|
|
.BR lp (1).
|
|
|
.LP
|
|
|
If no \fI\-l\fR, \fI\-o\fR, or \fI\-r\fR options are specified, the current options are reported on the standard output.
|
|
|
.LP
|
|
|
Options set with the \fBlpoptions\fR command are used by the
|
|
|
.BR lp (1)
|
|
|
and
|
|
|
.BR lpr (1)
|
|
|
commands when submitting jobs.
|
|
|
.LP
|
|
|
When 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.
|
|
|
Otherwise, the per-user defaults are managed in the \fI~/.cups/lpoptions\fR file.
|
|
|
.SH OPTIONS
|
|
|
\fBlpoptions\fR supports the following options:
|
|
|
.TP 5
|
|
|
.B \-E
|
|
|
Enables encryption when communicating with the CUPS server.
|
|
|
.TP 5
|
|
|
\fB\-d \fIdestination\fR[\fB/\fIinstance\fR]
|
|
|
Sets the user default printer to \fIdestination\fR.
|
|
|
If \fIinstance\fR is supplied then that particular instance is used.
|
|
|
This option overrides the system default printer for the current user.
|
|
|
.TP 5
|
|
|
\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
|
|
Uses an alternate server.
|
|
|
.TP 5
|
|
|
.B \-l
|
|
|
Lists the printer specific options and their current settings.
|
|
|
.TP 5
|
|
|
\fB\-o \fIoption\fR[\fB=\fIvalue\fR]
|
|
|
Specifies a new option for the named destination.
|
|
|
.TP 5
|
|
|
\fB\-p \fIdestination\fR[\fB/\fIinstance\fR]
|
|
|
Sets the destination and instance, if specified, for any options that follow.
|
|
|
If the named instance does not exist then it is created.
|
|
|
Destinations can only be created using the
|
|
|
.BR lpadmin (8)
|
|
|
program.
|
|
|
.TP 5
|
|
|
\fB\-r \fIoption\fR
|
|
|
Removes the specified option from the named destination.
|
|
|
.TP 5
|
|
|
\fB\-x \fIdestination\fR[\fB/\fIinstance\fR]
|
|
|
Removes the options for the named destination and instance, if specified.
|
|
|
If the named instance does not exist then this does nothing.
|
|
|
Destinations can only be removed using the
|
|
|
.BR lpadmin (8)
|
|
|
command.
|
|
|
.SH FILES
|
|
|
\fI~/.cups/lpoptions\fR - user defaults and instances created by non-root users.
|
|
|
.br
|
|
|
\fI/etc/cups/lpoptions\fR - system-wide defaults and instances created by the root user.
|
|
|
.SH CONFORMING TO
|
|
|
The \fBlpoptions\fR command is unique to CUPS.
|
|
|
.SH SEE ALSO
|
|
|
.BR cancel (1),
|
|
|
.BR lp (1),
|
|
|
.BR lpadmin (8),
|
|
|
.BR lpr (1),
|
|
|
.BR lprm (1),
|
|
|
CUPS Online Help (http://localhost:631/help)
|
|
|
.SH COPYRIGHT
|
|
|
Copyright \[co] 2007-2019 by Apple Inc.
|
