doc/help/man-lpoptions.html

   1 <!DOCTYPE HTML>
   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</b>
  14 [ -E ] [ -U
  15 <i>username</i>
  16 ] [ -h
  17 <i>server[:port]</i>
  18 ] -d
  19 <i>destination[/instance]</i>
  20 [ -o
  21 <i>option[=value]</i>
  22 ] ... [ -o
  23 <i>option[=value]</i>
  24 ]
  25 <br>
  26 <b>lpoptions</b>
  27 [ -E ] [ -U
  28 <i>username</i>
  29 ] [ -h
  30 <i>server[:port]</i>
  31 ] [ -p
  32 <i>destination[/instance]</i>
  33 ] -l
  34 <br>
  35 <b>lpoptions</b>
  36 [ -E ] [ -U
  37 <i>username</i>
  38 ] [ -h
  39 <i>server[:port]</i>
  40 ] [ -o
  41 <i>option[=value]</i>
  42 ] ... [ -o
  43 <i>option[=value]</i>
  44 ] [ -p
  45 <i>destination[/instance]</i>
  46 ] -r
  47 <i>option</i>
  48 <br>
  49 <b>lpoptions</b>
  50 [ -E ] [ -U
  51 <i>username</i>
  52 ] [ -h
  53 <i>server[:port]</i>
  54 ] -x
  55 <i>destination[/instance]</i>
  56 <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 <p style="margin-left: 5.0em; text-indent: -5.0em">-E
  61 <br>
  62 <br>
  63 Enables encryption when communicating with the CUPS server.
  64 <p style="margin-left: 5.0em; text-indent: -5.0em">-U username
  65 <br>
  66 <br>
  67 Uses an alternate username.
  68 <p style="margin-left: 5.0em; text-indent: -5.0em">-d destination[/instance]
  69 <br>
  70 <br>
  71 Sets the user default printer to <i>destination</i>. If <i>instance</i>
  72 is supplied then that particular instance is used. This option
  73 overrides the system default printer for the current user.
  74 <p style="margin-left: 5.0em; text-indent: -5.0em">-h server[:port]
  75 <br>
  76 <br>
  77 Uses an alternate server.
  78 <p style="margin-left: 5.0em; text-indent: -5.0em">-l
  79 <br>
  80 <br>
  81 Lists the printer specific options and their current settings.
  82 <p style="margin-left: 5.0em; text-indent: -5.0em">-o option[=value]
  83 <br>
  84 <br>
  85 Specifies a new option for the named destination.
  86 <p style="margin-left: 5.0em; text-indent: -5.0em">-p destination[/instance]
  87 <br>
  88 <br>
  89 Sets the destination and instance, if specified, for any options
  90 that follow. If the named instance does not exist then it is
  91 created.
  92 <p style="margin-left: 5.0em; text-indent: -5.0em">-r option
  93 <br>
  94 <br>
  95 Removes the specified option for the named destination.
  96 <p style="margin-left: 5.0em; text-indent: -5.0em">-x destination[/instance]
  97 <br>
  98 <br>
  99 Removes the options for the named destination and instance, if
 100 specified. If the named instance does not exist then this does
 101 nothing.
 102 <p>If no options are specified using the <i>-o</i> option, then the
 103 current options for the named printer are reported on the
 104 standard output.
 105 <p>Options set with the <i>lpoptions</i> command are used by the
 106 <i>lp(1)</i> and <i>lpr(1)</i> commands when submitting jobs.
 107 <h2 class="title"><a name="ROOT_ACCOUNT_OPTIONS">Root Account Options</a></h2>
 108 When run by the root user, <i>lpoptions</i> gets and sets default
 109 options and instances for <i>all users</i> in the
 110 /etc/cups/lpoptions file.
 111 <h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
 112 The <i>lpoptions</i> command is unique to CUPS.
 113 <h2 class="title"><a name="FILES">Files</a></h2>
 114 ~/.cups/lpoptions - user defaults and instances created by non-root
 115 users.
 116 <br>
 117 /etc/cups/lpoptions - system-wide defaults and instances
 118 created by the root user.
 119 <h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
 120 <i>cancel(1)</i>, <i>lp(1)</i>, <i>lpadmin(8)</i>, <i>lpr(1)</i>,
 121 <br>
 122 <a href="http://localhost:631/help">http://localhost:631/help</a>
 123 <h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
 124 Copyright 2007-2013 by Apple Inc.
 125
 126 </body>
 127 </html>