diff options
author | Michael R Sweet <michael.r.sweet@gmail.com> | 2019-04-26 23:10:09 -0400 |
---|---|---|
committer | Michael R Sweet <michael.r.sweet@gmail.com> | 2019-04-26 23:10:09 -0400 |
commit | 87030afb3aa8735848c66a0526d06af69d7010c6 (patch) | |
tree | 91cff9fc58fc3010481f320ec6acc37b4b2e961b /man/lpoptions.1 | |
parent | ea75e93d17738a9abb81514029949e661c730869 (diff) | |
download | cups-87030afb3aa8735848c66a0526d06af69d7010c6.tar.gz |
Greatly simplify the man page handling.
Diffstat (limited to 'man/lpoptions.1')
-rw-r--r-- | man/lpoptions.1 | 118 |
1 files changed, 118 insertions, 0 deletions
diff --git a/man/lpoptions.1 b/man/lpoptions.1 new file mode 100644 index 000000000..a34fd01dc --- /dev/null +++ b/man/lpoptions.1 @@ -0,0 +1,118 @@ +.\" +.\" 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. |