man/lpoptions.man.in

   1 .\"
   2 .\" "$Id$"
   3 .\"
   4 .\"   lpoptions man page for CUPS.
   5 .\"
   6 .\"   Copyright 2007-2013 by Apple Inc.
   7 .\"   Copyright 1997-2006 by Easy Software Products.
   8 .\"
   9 .\"   These coded instructions, statements, and computer programs are the
  10 .\"   property of Apple Inc. and are protected by Federal copyright
  11 .\"   law.  Distribution and use rights are outlined in the file "LICENSE.txt"
  12 .\"   which should have been included with this file.  If this file is
  13 .\"   file is missing or damaged, see the license at "http://www.cups.org/".
  14 .\"
  15 .TH lpoptions 1 "CUPS" "8 July 2013" "Apple Inc."
  16 .SH NAME
  17 lpoptions \- display or set printer options and defaults
  18 .SH SYNOPSIS
  19 .B lpoptions
  20 [ -E ] [ -U
  21 .I username
  22 ] [ -h
  23 .I server[:port]
  24 ] -d
  25 .I destination[/instance]
  26 [ -o
  27 .I option[=value]
  28 ] ... [ -o
  29 .I option[=value]
  30 ]
  31 .br
  32 .B lpoptions
  33 [ -E ] [ -U
  34 .I username
  35 ] [ -h
  36 .I server[:port]
  37 ] [ -p
  38 .I destination[/instance]
  39 ] -l
  40 .br
  41 .B lpoptions
  42 [ -E ] [ -U
  43 .I username
  44 ] [ -h
  45 .I server[:port]
  46 ] [ -o
  47 .I option[=value]
  48 ] ... [ -o
  49 .I option[=value]
  50 ] [ -p
  51 .I destination[/instance]
  52 ] -r
  53 .I option
  54 .br
  55 .B lpoptions
  56 [ -E ] [ -U
  57 .I username
  58 ] [ -h
  59 .I server[:port]
  60 ] -x
  61 .I destination[/instance]
  62 .SH DESCRIPTION
  63 \fIlpoptions\fR displays or sets printer options and defaults.
  64 \fIlpoptions\fR shows the default printer options when run with no
  65 arguments. Other options include:
  66 .TP 5
  67 -E
  68 .br
  69 Enables encryption when communicating with the CUPS server.
  70 .TP 5
  71 -U username
  72 .br
  73 Uses an alternate username.
  74 .TP 5
  75 -d destination[/instance]
  76 .br
  77 Sets the user default printer to \fIdestination\fR. If \fIinstance\fR
  78 is supplied then that particular instance is used. This option
  79 overrides the system default printer for the current user.
  80 .TP 5
  81 -h server[:port]
  82 .br
  83 Uses an alternate server.
  84 .TP 5
  85 -l
  86 .br
  87 Lists the printer specific options and their current settings.
  88 .TP 5
  89 -o option[=value]
  90 .br
  91 Specifies a new option for the named destination.
  92 .TP 5
  93 -p destination[/instance]
  94 .br
  95 Sets the destination and instance, if specified, for any options
  96 that follow. If the named instance does not exist then it is
  97 created.
  98 .TP 5
  99 -r option
 100 .br
 101 Removes the specified option for the named destination.
 102 .TP 5
 103 -x destination[/instance]
 104 .br
 105 Removes the options for the named destination and instance, if
 106 specified. If the named instance does not exist then this does
 107 nothing.
 108 .LP
 109 If no options are specified using the \fI-o\fR option, then the
 110 current options for the named printer are reported on the
 111 standard output.
 112 .LP
 113 Options set with the \fIlpoptions\fR command are used by the
 114 \fIlp(1)\fR and \fIlpr(1)\fR commands when submitting jobs.
 115 .SH ROOT ACCOUNT OPTIONS
 116 When run by the root user, \fIlpoptions\fR gets and sets default
 117 options and instances for \fIall users\fR in the
 118 /etc/cups/lpoptions file.
 119 .SH COMPATIBILITY
 120 The \fIlpoptions\fR command is unique to CUPS.
 121 .SH FILES
 122 ~/.cups/lpoptions - user defaults and instances created by non-root
 123 users.
 124 .br
 125 /etc/cups/lpoptions - system-wide defaults and instances
 126 created by the root user.
 127 .SH SEE ALSO
 128 \fIcancel(1)\fR, \fIlp(1)\fR, \fIlpadmin(8)\fR, \fIlpr(1)\fR,
 129 .br
 130 http://localhost:631/help
 131 .SH COPYRIGHT
 132 Copyright 2007-2013 by Apple Inc.
 133 .\"
 134 .\" End of "$Id$".
 135 .\"