2 .\" "$Id: lpadmin.man 5969 2006-09-19 20:09:24Z mike $"
4 .\" lpadmin man page for the Common UNIX Printing System (CUPS).
6 .\" Copyright 1997-2006 by Easy Software Products.
8 .\" These coded instructions, statements, and computer programs are the
9 .\" property of Easy Software Products and are protected by Federal
10 .\" copyright law. Distribution and use rights are outlined in the file
11 .\" "LICENSE.txt" which should have been included with this file. If this
12 .\" file is missing or damaged please contact Easy Software Products
15 .\" Attn: CUPS Licensing Information
16 .\" Easy Software Products
17 .\" 44141 Airport View Drive, Suite 204
18 .\" Hollywood, Maryland 20636 USA
20 .\" Voice: (301) 373-9600
21 .\" EMail: cups-info@cups.org
22 .\" WWW: http://www.cups.org
24 .TH lpadmin 8 "Common UNIX Printing System" "13 July 2006" "Easy Software Products"
26 lpadmin \- configure cups printers and classes
52 \fIlpadmin\fR configures printer and class queues provided by
53 CUPS. It can also be used to set the server default printer or
56 When specified before the \fI-d\fR, \fI-p\fR, or \fI-x\fR
57 options, the \fI-E\fR option forces encryption when connecting to
60 The first form of the command (\fI-d\fR) sets the default printer
61 or class to \fIdestination\fR. Subsequent print jobs submitted
62 via the \fIlp(1)\fR or \fIlpr(1)\fR commands will use this
63 destination unless the user specifies otherwise with the
64 \fIlpoptions(1)\fR command.
66 The second form of the command (\fI-p\fR) configures the named
67 printer. The additional options are described below.
69 The third form of the command (\fI-x\fR) deletes the printer or
70 class \fIdestination\fR. Any jobs that are pending for the
71 destination will be removed and any job that is currently printed
73 .SH CONFIGURATION OPTIONS
74 The following options are recognized when configuring a printer
79 Adds the named \fIprinter\fR to \fIclass\fR. If \fIclass\fR does
80 not exist it is created automatically.
84 Sets a System V style interface script for the printer. This
85 option cannot be specified with the \fI-P\fR option (PPD file)
86 and is intended for providing support for legacy printer drivers.
90 Sets a standard System V interface script or PPD file from the
91 \fImodel\fR directory.
95 Sets a PPD or server option for the printer. PPD options can be
96 listed using the \fI-l\fR option with the \fIlpoptions(1)\fR
101 Sets the kilobyte limit for per-user quotas. The value is an
102 integer number of kilobytes; one kilobyte is 1024 bytes.
104 -o job-page-limit=value
106 Sets the page limit for per-user quotas. The value is the integer
107 number of pages that can be printed; double-sided pages are
108 counted as two pages.
110 -o job-quota-period=value
112 Sets the accounting period for per-user quotas. The value is an
113 integer number of seconds; 86,400 seconds are in one day.
115 -o job-sheets-default=banner
117 -o job-sheets-default=banner,banner
119 Sets the default banner page(s) to use for print jobs.
123 Sets the binary communications program to use when printing,
124 "none", "bcp", or "tbcp". The default program is "none".
126 -o printer-error-policy=name
128 Sets the error policy to be used when the printer backend is
129 unable to send the job to the printer. The name must be one of
130 "abort-job", "retry-job" or "stop-printer". The default error
131 policy is "stop-printer".
133 -o printer-is-shared=true/false
135 Sets the printer to shared/published or unshared/unpublished.
136 Shared/published printers are publically announced by the server
137 on the LAN based on the browsing configuration in
138 \fBcupsd.conf\fR, while unshared/unpublished printers are not
139 announced. The default value is "true".
141 -o printer-op-policy=name
143 Sets the IPP operation policy associated with the printer. The
144 name must be defined in the \fBcupsd.conf\fR in a Policy section.
145 The default operation policy is "default".
149 Removes the named \fIprinter\fR from \fIclass\fR. If the
150 resulting class becomes empty it is removed.
152 -u allow:user,user,@group
154 -u deny:user,user,@group
160 Sets user-level access control on a printer. Names starting with
161 "@" are interpreted as UNIX groups. The latter two forms turn
162 user-level access control off.
166 Sets the \fIdevice-uri\fR attribute of the printer queue. If
167 \fIdevice-uri\fR is a filename it is automatically converted to
168 the form \fIfile:///file/name\fR. Use the \fIlpinfo(8)\fR command
169 to get a list of supported device URIs and schemes.
173 Provides a textual description of the printer.
177 Enables the printer and accepts jobs; this is the same as running the
178 \fIaccept(8)\fR and \fIcupsenable(8)\fR programs on the printer.
182 Provides a textual location of the printer.
186 Specifies a PostScript Printer Description file to use with the
187 printer. If specified, this option overrides the \fI-i\fR option
190 Unlike the System V printing system, CUPS allows printer names to
191 contain any printable character except SPACE, TAB, "/", or "#".
192 Also, printer and class names are \fInot\fR case-sensitive.
193 Finally, the CUPS version of \fIlpadmin\fR may ask the user for
194 an access password depending on the printing system
195 configuration. This differs from the System V version which
196 requires the root user to execute this command.
198 The CUPS version of \fIlpadmin\fR does not support all of the
199 System V or Solaris printing system configuration options.
201 \fIaccept(8)\fR, \fIcupsenable(8)\fR, \fIlpinfo(8)\fR,
204 http://localhost:631/help
206 Copyright 1997-2006 by Easy Software Products, All Rights Reserved.
208 .\" End of "$Id: lpadmin.man 5969 2006-09-19 20:09:24Z mike $".