man-pages/man1/lpoptions.1.html
2021-03-31 01:06:50 +01:00

180 lines
4.7 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of lpoptions</TITLE>
</HEAD><BODY>
<H1>lpoptions</H1>
Section: Apple Inc. (1)<BR>Updated: CUPS<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
lpoptions - display or set printer options and defaults
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>lpoptions</B>
[
<B>-E</B>
] [
<B>-h </B><I>server</I>[<B>:</B><I>port</I>]
]
<B>-d </B><I>destination</I>[<B>/</B><I>instance</I>]
[
<B>-l</B>
]
<BR>
<B>lpoptions</B>
[
<B>-E</B>
] [
<B>-h </B><I>server</I>[<B>:</B><I>port</I>]
] [
<B>-p </B><I>destination</I>[<B>/</B><I>instance</I>]
]
<B>-o </B><I>option</I>[<B>=</B><I>value</I>] ...
<BR>
<B>lpoptions</B>
[
<B>-E</B>
] [
<B>-h </B><I>server</I>[<B>:</B><I>port</I>]
] [
<B>-p </B><I>destination</I>[<B>/</B><I>instance</I>]
]
<B>-r</B>
<I>option</I>
<BR>
<B>lpoptions</B>
[
<B>-E</B>
] [
<B>-h </B><I>server</I>[<B>:</B><I>port</I>]
]
<B>-x </B><I>destination</I>[<B>/</B><I>instance</I>]
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<B>lpoptions</B> displays or sets printer options and defaults.
If no printer is specified using the <I>-p</I> option, the default printer is used as described in
<B><A HREF="/cgi-bin/man/man2html?1+lp">lp</A></B>(1).
<P>
If no <I>-l</I>, <I>-o</I>, or <I>-r</I> options are specified, the current options are reported on the standard output.
<P>
Options set with the <B>lpoptions</B> command are used by the
<B><A HREF="/cgi-bin/man/man2html?1+lp">lp</A></B>(1)
and
<B><A HREF="/cgi-bin/man/man2html?1+lpr">lpr</A></B>(1)
commands when submitting jobs.
<P>
When run by the root user, <B>lpoptions</B> gets and sets default options and instances for all users in the <I>/etc/cups/lpoptions</I> file.
Otherwise, the per-user defaults are managed in the <I>~/.cups/lpoptions</I> file.
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<B>lpoptions</B> supports the following options:
<DL COMPACT>
<DT id="1"><B>-E</B>
<DD>
Enables encryption when communicating with the CUPS server.
<DT id="2"><B>-d </B><I>destination</I>[<B>/</B><I>instance</I>]<DD>
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.
<DT id="3"><B>-h </B><I>server</I>[<B>:</B><I>port</I>]<DD>
Uses an alternate server.
<DT id="4"><B>-l</B>
<DD>
Lists the printer specific options and their current settings.
<DT id="5"><B>-o </B><I>option</I>[<B>=</B><I>value</I>]<DD>
Specifies a new option for the named destination.
<DT id="6"><B>-p </B><I>destination</I>[<B>/</B><I>instance</I>]<DD>
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
<B><A HREF="/cgi-bin/man/man2html?8+lpadmin">lpadmin</A></B>(8)
program.
<DT id="7"><B>-r </B><I>option</I><DD>
Removes the specified option from the named destination.
<DT id="8"><B>-x </B><I>destination</I>[<B>/</B><I>instance</I>]<DD>
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
<B><A HREF="/cgi-bin/man/man2html?8+lpadmin">lpadmin</A></B>(8)
command.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>FILES</H2>
<I>~/.cups/lpoptions</I> - user defaults and instances created by non-root users.
<BR>
<I>/etc/cups/lpoptions</I> - system-wide defaults and instances created by the root user.
<A NAME="lbAG">&nbsp;</A>
<H2>CONFORMING TO</H2>
The <B>lpoptions</B> command is unique to CUPS.
<A NAME="lbAH">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?1+cancel">cancel</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?1+lp">lp</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?8+lpadmin">lpadmin</A></B>(8),
<B><A HREF="/cgi-bin/man/man2html?1+lpr">lpr</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?1+lprm">lprm</A></B>(1),
CUPS Online Help (<A HREF="http://localhost:631/help)">http://localhost:631/help)</A>
<A NAME="lbAI">&nbsp;</A>
<H2>COPYRIGHT</H2>
Copyright &#169; 2007-2019 by Apple Inc.
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="9"><A HREF="#lbAB">NAME</A><DD>
<DT id="10"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="11"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="12"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="13"><A HREF="#lbAF">FILES</A><DD>
<DT id="14"><A HREF="#lbAG">CONFORMING TO</A><DD>
<DT id="15"><A HREF="#lbAH">SEE ALSO</A><DD>
<DT id="16"><A HREF="#lbAI">COPYRIGHT</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:18 GMT, March 31, 2021
</BODY>
</HTML>