root / pykota / branches / 1.26_fixes / man / pkprinters.1 @ 3431

.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
.TH PKPRINTERS "1" "July 2007" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
.SH NAME
pkprinters \- manual page for pkprinters 1.26_unofficial
.SH DESCRIPTION
pkprinters v1.26_unofficial (c) 2003, 2004, 2005, 2006, 2007 Jerome Alet \- alet@librelogiciel.com
.PP
A Printers Manager for PyKota.
.PP
command line usage :
.IP
pkprinters [options] printer1 printer2 printer3 ... printerN
.PP
options :
.TP
\fB\-v\fR | \fB\-\-version\fR
Prints pkprinters's version number then exits.
.TP
\fB\-h\fR | \fB\-\-help\fR
Prints this message then exits.
.TP
\fB\-a\fR | \fB\-\-add\fR
Adds printers if they don't exist on the Quota
Storage Server. If they exist, they are modified
unless \fB\-s\fR|\-\-skipexisting is also used.
.TP
\fB\-d\fR | \fB\-\-delete\fR
Deletes printers from the quota storage.
.HP
\fB\-D\fR | \fB\-\-description\fR d Adds a textual description to printers.
.TP
\fB\-C\fR | \fB\-\-cups\fR
Also modifies the DeviceURI in CUPS' printers.conf
.TP
\fB\-c\fR | \fB\-\-charge\fR p[,j]
Sets the price per page and per job to charge.
Job price is optional.
If both are to be set, separate them with a comma.
Floating point and negative values are allowed.
.TP
\fB\-g\fR | \fB\-\-groups\fR pg1[,pg2...] Adds or Remove the printer(s) to the printer
groups pg1, pg2, etc... which must already exist.
A printer group is just like a normal printer,
only that it is usually unknown from the printing
system. Create printer groups exactly the same
way that you create printers, then add other
printers to them with this option.
Accounting is done on a printer and on all
the printer groups it belongs to, quota checking
is done on a printer and on all the printer groups
it belongs to.
If the \fB\-\-remove\fR option below is not used, the
default action is to add printers to the specified
printer groups.
.TP
\fB\-l\fR | \fB\-\-list\fR
List informations about the printer(s) and the
printers groups it is a member of.
.TP
\fB\-r\fR | \fB\-\-remove\fR
In combination with the \fB\-\-groups\fR option above,
remove printers from the specified printers groups.
.TP
\fB\-s\fR | \fB\-\-skipexisting\fR
In combination with the \fB\-\-add\fR option above, tells
pkprinters to not modify existing printers.
.TP
\fB\-m\fR | \fB\-\-maxjobsize\fR s
Sets the maximum job size allowed on the printer
to s pages.
.TP
\fB\-p\fR | \fB\-\-passthrough\fR
Activate passthrough mode for the printer. In this
mode, users are allowed to print without any impact
on their quota or account balance.
.TP
\fB\-n\fR | \fB\-\-nopassthrough\fR Deactivate passthrough mode for the printer.
Without \fB\-p\fR or \fB\-n\fR, printers are created in
normal mode, i.e. no passthrough.
.IP
printer1 through printerN can contain wildcards if the \fB\-\-add\fR option
is not set.
.PP
examples :
.IP
\f(CW$ pkprinters --add -D "HP Printer" --charge 0.05,0.1 hp2100 hp2200 hp8000\fR
.IP
Will create three printers named hp2100, hp2200 and hp8000.
Their price per page will be set at 0.05 unit, and their price
per job will be set at 0.1 unit. Units are in your own currency,
or whatever you want them to mean.
All of their descriptions will be set to the string "HP Printer".
If any of these printers already exists, it will also be modified
unless the \fB\-s\fR|\-\-skipexisting command line option is also used.
.IP
\f(CW$ pkprinters --delete "*"\fR
.IP
This will completely delete all printers and associated quota information,
as well as their job history. USE WITH CARE !
.IP
\f(CW$ pkprinters --groups Laser,HP "hp*"\fR
.IP
This will put all printers which name matches "hp*" into printers groups
Laser and HP, which MUST already exist.
.IP
\f(CW$ pkprinters --groups LexMark --remove hp2200\fR
.IP
This will remove the hp2200 printer from the LexMark printer group.
.PP
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
.PP
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
.PP
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301, USA.
.PP
Please report bugs to : Jerome Alet \- alet@librelogiciel.com