root / pykota / tags / 1.26beta / man / pkprinters.1

Revision 3201, 4.5 kB (checked in by jerome, 17 years ago)

v1.26beta is out

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
Line 
1.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
2.TH PKPRINTERS "1" "July 2007" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
3.SH NAME
4pkprinters \- manual page for pkprinters 1.26beta_unofficial
5.SH DESCRIPTION
6pkprinters v1.26beta_unofficial (c) 2003, 2004, 2005, 2006, 2007 Jerome Alet \- alet@librelogiciel.com
7.PP
8A Printers Manager for PyKota.
9.PP
10command line usage :
11.IP
12pkprinters [options] printer1 printer2 printer3 ... printerN
13.PP
14options :
15.TP
16\fB\-v\fR | \fB\-\-version\fR
17Prints pkprinters's version number then exits.
18.TP
19\fB\-h\fR | \fB\-\-help\fR
20Prints this message then exits.
21.TP
22\fB\-a\fR | \fB\-\-add\fR
23Adds printers if they don't exist on the Quota
24Storage Server. If they exist, they are modified
25unless \fB\-s\fR|\-\-skipexisting is also used.
26.TP
27\fB\-d\fR | \fB\-\-delete\fR
28Deletes printers from the quota storage.
29.HP
30\fB\-D\fR | \fB\-\-description\fR d Adds a textual description to printers.
31.TP
32\fB\-C\fR | \fB\-\-cups\fR
33Also modifies the DeviceURI in CUPS' printers.conf
34.TP
35\fB\-c\fR | \fB\-\-charge\fR p[,j]
36Sets the price per page and per job to charge.
37Job price is optional.
38If both are to be set, separate them with a comma.
39Floating point and negative values are allowed.
40.TP
41\fB\-g\fR | \fB\-\-groups\fR pg1[,pg2...] Adds or Remove the printer(s) to the printer
42groups pg1, pg2, etc... which must already exist.
43A printer group is just like a normal printer,
44only that it is usually unknown from the printing
45system. Create printer groups exactly the same
46way that you create printers, then add other
47printers to them with this option.
48Accounting is done on a printer and on all
49the printer groups it belongs to, quota checking
50is done on a printer and on all the printer groups
51it belongs to.
52If the \fB\-\-remove\fR option below is not used, the
53default action is to add printers to the specified
54printer groups.
55.TP
56\fB\-l\fR | \fB\-\-list\fR
57List informations about the printer(s) and the
58printers groups it is a member of.
59.TP
60\fB\-r\fR | \fB\-\-remove\fR
61In combination with the \fB\-\-groups\fR option above,
62remove printers from the specified printers groups.
63.TP
64\fB\-s\fR | \fB\-\-skipexisting\fR
65In combination with the \fB\-\-add\fR option above, tells
66pkprinters to not modify existing printers.
67.TP
68\fB\-m\fR | \fB\-\-maxjobsize\fR s
69Sets the maximum job size allowed on the printer
70to s pages.
71.TP
72\fB\-p\fR | \fB\-\-passthrough\fR
73Activate passthrough mode for the printer. In this
74mode, users are allowed to print without any impact
75on their quota or account balance.
76.TP
77\fB\-n\fR | \fB\-\-nopassthrough\fR Deactivate passthrough mode for the printer.
78Without \fB\-p\fR or \fB\-n\fR, printers are created in
79normal mode, i.e. no passthrough.
80.IP
81printer1 through printerN can contain wildcards if the \fB\-\-add\fR option
82is not set.
83.PP
84examples :
85.IP
86\f(CW$ pkprinters --add -D "HP Printer" --charge 0.05,0.1 hp2100 hp2200 hp8000\fR
87.IP
88Will create three printers named hp2100, hp2200 and hp8000.
89Their price per page will be set at 0.05 unit, and their price
90per job will be set at 0.1 unit. Units are in your own currency,
91or whatever you want them to mean.
92All of their descriptions will be set to the string "HP Printer".
93If any of these printers already exists, it will also be modified
94unless the \fB\-s\fR|\-\-skipexisting command line option is also used.
95.IP
96\f(CW$ pkprinters --delete "*"\fR
97.IP
98This will completely delete all printers and associated quota information,
99as well as their job history. USE WITH CARE !
100.IP
101\f(CW$ pkprinters --groups Laser,HP "hp*"\fR
102.IP
103This will put all printers which name matches "hp*" into printers groups
104Laser and HP, which MUST already exist.
105.IP
106\f(CW$ pkprinters --groups LexMark --remove hp2200\fR
107.IP
108This will remove the hp2200 printer from the LexMark printer group.
109.PP
110This program is free software; you can redistribute it and/or modify
111it under the terms of the GNU General Public License as published by
112the Free Software Foundation; either version 2 of the License, or
113(at your option) any later version.
114.PP
115This program is distributed in the hope that it will be useful,
116but WITHOUT ANY WARRANTY; without even the implied warranty of
117MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
118GNU General Public License for more details.
119.PP
120You should have received a copy of the GNU General Public License
121along with this program; if not, write to the Free Software
122Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301, USA.
123.PP
124Please report bugs to : Jerome Alet \- alet@librelogiciel.com
Note: See TracBrowser for help on using the browser.