doc/help/man-lpoptions.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   2 <html>
   3 <!-- SECTION: Man Pages -->
   4 <head>
   5         <link rel="stylesheet" type="text/css" href="../cups-printable.css">
   6         <title>lpoptions(1)</title>
   7 </head>
   8 <body>
   9 <h1 class="title">lpoptions(1)</h1>
  10 <h2 class="title"><a name="NAME">Name</a></h2>
  11 lpoptions - display or set printer options and defaults
  12 <h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
  13 <b>lpoptions
  14 </b>[ -E ] [ -U
  15 <i>username
  16 </i>] [ -h
  17 <i>server[:port]
  18 </i>] -d
  19 <i>destination[/instance]
  20 </i>[ -o
  21 <i>option[=value]
  22 </i>] ... [ -o
  23 <i>option[=value]
  24 </i>]
  25 <br>
  26 <b>lpoptions
  27 </b>[ -E ] [ -U
  28 <i>username
  29 </i>] [ -h
  30 <i>server[:port]
  31 </i>] [ -p
  32 <i>destination[/instance]
  33 </i>] -l
  34 <br>
  35 <b>lpoptions
  36 </b>[ -E ] [ -U
  37 <i>username
  38 </i>] [ -h
  39 <i>server[:port]
  40 </i>] [ -o
  41 <i>option[=value]
  42 </i>] ... [ -o
  43 <i>option[=value]
  44 </i>] [ -p
  45 <i>destination[/instance]
  46 </i>] -r
  47 <i>option
  48 </i><br>
  49 <b>lpoptions
  50 </b>[ -E ] [ -U
  51 <i>username
  52 </i>] [ -h
  53 <i>server[:port]
  54 </i>] -x
  55 <i>destination[/instance]
  56 </i><h2 class="title"><a name="DESCRIPTION">Description</a></h2>
  57 <i>lpoptions</i> displays or sets printer options and defaults.
  58 <i>lpoptions</i> shows the default printer options when run with no
  59 arguments. Other options include:
  60 <dl>
  61 <dt>-E
  62 </dt>
  63 <dd></dd>
  64 <dd>Enables encryption when communicating with the CUPS server.
  65 </dd>
  66 <dt>-U username
  67 </dt>
  68 <dd></dd>
  69 <dd>Uses an alternate username.
  70 </dd>
  71 <dt>-d destination[/instance]
  72 </dt>
  73 <dd></dd>
  74 <dd>Sets the user default printer to <i>destination</i>. If <i>instance</i>
  75 is supplied then that particular instance is used. This option
  76 overrides the system default printer for the current user.
  77 </dd>
  78 <dt>-h server[:port]
  79 </dt>
  80 <dd></dd>
  81 <dd>Uses an alternate server.
  82 </dd>
  83 <dt>-l
  84 </dt>
  85 <dd></dd>
  86 <dd>Lists the printer specific options and their current settings.
  87 </dd>
  88 <dt>-o option[=value]
  89 </dt>
  90 <dd></dd>
  91 <dd>Specifies a new option for the named destination.
  92 </dd>
  93 <dt>-p destination[/instance]
  94 </dt>
  95 <dd></dd>
  96 <dd>Sets the destination and instance, if specified, for any options
  97 that follow. If the named instance does not exist then it is
  98 created.
  99 </dd>
 100 <dt>-r option
 101 </dt>
 102 <dd></dd>
 103 <dd>Removes the specified option for the named destination.
 104 </dd>
 105 <dt>-x destination[/instance]
 106 </dt>
 107 <dd></dd>
 108 <dd>Removes the options for the named destination and instance, if
 109 specified. If the named instance does not exist then this does
 110 nothing.
 111 </dd>
 112 </dl>
 113 <p>If no options are specified using the <i>-o</i> option, then the
 114 current options for the named printer are reported on the
 115 standard output.
 116 <p>Options set with the <i>lpoptions</i> command are used by the
 117 <a href='man-lp.html?TOPIC=Man+Pages'>lp(1)</a> and <a href='man-lpr.html?TOPIC=Man+Pages'>lpr(1)</a> commands when submitting jobs.
 118 <h2 class="title"><a name="ROOT_ACCOUNT_OPTIONS">Root Account Options</a></h2>
 119 When run by the root user, <i>lpoptions</i> gets and sets default
 120 options and instances for <i>all users</i> in the
 121 /etc/cups/lpoptions file.
 122 <h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
 123 The <i>lpoptions</i> command is unique to CUPS.
 124 <h2 class="title"><a name="FILES">Files</a></h2>
 125 ~/.cups/lpoptions - user defaults and instances created by non-root
 126 users.
 127 <br>
 128 /etc/cups/lpoptions - system-wide defaults and instances
 129 created by the root user.
 130 <h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
 131 <a href='man-cancel.html?TOPIC=Man+Pages'>cancel(1)</a>, <a href='man-lp.html?TOPIC=Man+Pages'>lp(1)</a>, <a href='man-lpadmin.html?TOPIC=Man+Pages'>lpadmin(8)</a>, <a href='man-lpr.html?TOPIC=Man+Pages'>lpr(1)</a>,
 132 <br>
 133 <a href='http://localhost:631/help'>http://localhost:631/help</a>
 134 <h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
 135 Copyright 2007-2013 by Apple Inc.
 136
 137 </body>
 138 </html>