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 <dl class="man">
  61 <dt>-E
  62 <dd style="margin-left: 5.0em"><br>
  63 Enables encryption when communicating with the CUPS server.
  64 <dt>-U username
  65 <dd style="margin-left: 5.0em"><br>
  66 Uses an alternate username.
  67 <dt>-d destination[/instance]
  68 <dd style="margin-left: 5.0em"><br>
  69 Sets the user default printer to <i>destination</i>. If <i>instance</i>
  70 is supplied then that particular instance is used. This option
  71 overrides the system default printer for the current user.
  72 <dt>-h server[:port]
  73 <dd style="margin-left: 5.0em"><br>
  74 Uses an alternate server.
  75 <dt>-l
  76 <dd style="margin-left: 5.0em"><br>
  77 Lists the printer specific options and their current settings.
  78 <dt>-o option[=value]
  79 <dd style="margin-left: 5.0em"><br>
  80 Specifies a new option for the named destination.
  81 <dt>-p destination[/instance]
  82 <dd style="margin-left: 5.0em"><br>
  83 Sets the destination and instance, if specified, for any options
  84 that follow. If the named instance does not exist then it is
  85 created.
  86 <dt>-r option
  87 <dd style="margin-left: 5.0em"><br>
  88 Removes the specified option for the named destination.
  89 <dt>-x destination[/instance]
  90 <dd style="margin-left: 5.0em"><br>
  91 Removes the options for the named destination and instance, if
  92 specified. If the named instance does not exist then this does
  93 nothing.
  94 </dl>
  95 <p>If no options are specified using the <i>-o</i> option, then the
  96 current options for the named printer are reported on the
  97 standard output.
  98 <p>Options set with the <i>lpoptions</i> command are used by the
  99 <i>lp(1)</i> and <i>lpr(1)</i> commands when submitting jobs.
 100 <h2 class="title"><a name="ROOT_ACCOUNT_OPTIONS">Root Account Options</a></h2>
 101 When run by the root user, <i>lpoptions</i> gets and sets default
 102 options and instances for <i>all users</i> in the
 103 /etc/cups/lpoptions file.
 104 <h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
 105 The <i>lpoptions</i> command is unique to CUPS.
 106 <h2 class="title"><a name="FILES">Files</a></h2>
 107 ~/.cups/lpoptions - user defaults and instances created by non-root
 108 users.
 109 <br>
 110 /etc/cups/lpoptions - system-wide defaults and instances
 111 created by the root user.
 112 <h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
 113 <i>cancel(1)</i>, <i>lp(1)</i>, <i>lpadmin(8)</i>, <i>lpr(1)</i>,
 114 <br>
 115 <a href="http://localhost:631/help">http://localhost:631/help</a>
 116 <h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
 117 Copyright 2007-2013 by Apple Inc.
 118
 119 </body>
 120 </html>