2 .\" "$Id: lpadmin.man 5099 2006-02-13 02:46:10Z 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" "12 February 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".
128 Removes the named \fIprinter\fR from \fIclass\fR. If the
129 resulting class becomes empty it is removed.
131 -u allow:user,user,@group
132 -u deny:user,user,@group
136 Sets user-level access control on a printer. Names starting with
137 "@" are interpreted as UNIX groups. The latter two forms turn
138 user-level access control off.
142 Sets the \fIdevice-uri\fR attribute of the printer queue. If
143 \fIdevice-uri\fR is a filename it is automatically converted to
144 the form \fIfile:///file/name\fR.
148 Provides a textual description of the printer.
152 Enables the printer and accepts jobs; this is the same as running the
153 \fIaccept(8)\fR and \fIcupsenable(8)\fR programs on the printer.
157 Provides a textual location of the printer.
161 Specifies a PostScript Printer Description file to use with the
162 printer. If specified, this option overrides the \fI-i\fR option
165 Unlike the System V printing system, CUPS allows printer names to
166 contain any printable character except SPACE, TAB, "/", or "#".
167 Also, printer and class names are \fInot\fR case-sensitive.
168 Finally, the CUPS version of \fIlpadmin\fR may ask the user for
169 an access password depending on the printing system
170 configuration. This differs from the System V version which
171 requires the root user to execute this command.
173 The CUPS version of \fIlpadmin\fR does not support all of the
174 System V or Solaris printing system configuration options.
176 \fIaccept(8)\fR, \fIcupsenable(8)\fR, \fIlpoptions(1)\fR,
178 http://localhost:631/help
180 Copyright 1997-2006 by Easy Software Products, All Rights Reserved.
182 .\" End of "$Id: lpadmin.man 5099 2006-02-13 02:46:10Z mike $".