.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
.TH PKPRINTERS "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
.SH NOM
pkprinters \- page de manuel de pkprinters (PyKota) 1.27alpha7_unofficial
.SH SYNOPSIS
.B pkprinters
[\fIoptions\fR] \fIprinter1 printer2 \fR... \fIprinterN\fR
.SH DESCRIPTION
Manages PyKota printers.
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
show this help message and exit.
.TP
\fB\-v\fR, \fB\-\-version\fR
show the version number and exit.
.TP
\fB\-A\fR ARGUMENTSFILE, \fB\-\-arguments\fR=\fIARGUMENTSFILE\fR
loads additional options and arguments from a file,
one per line.
.TP
\fB\-a\fR, \fB\-\-add\fR
Add new, or modify existing, printers.
.TP
\fB\-c\fR CHARGE, \fB\-\-charge\fR=\fICHARGE\fR
Set the cost per page, and optionally per job, for
printing to the specified printers. If both are to be
set, separate them with a comma. Floating point and
negative values are allowed.
.TP
\fB\-C\fR, \fB\-\-cups\fR
Tell CUPS to either start or stop managing the
specified printers with PyKota.
.TP
\fB\-d\fR, \fB\-\-delete\fR
Delete the specified printers. Also purge the print
quota entries and printing history matching the
specified printers.
.TP
\fB\-D\fR DESCRIPTION, \fB\-\-description\fR=\fIDESCRIPTION\fR
Set a textual description for the specified printers.
.TP
\fB\-g\fR GROUPS, \fB\-\-groups\fR=\fIGROUPS\fR
If the \fB\-\-remove\fR option is not used, the default action
is to add the specified printers to the specified
printers groups. Otherwise they are removed from these
groups. The specified printers groups must already
exist, and should be created beforehand just like
normal printers with this very command.
.TP
\fB\-l\fR, \fB\-\-list\fR
Display detailed informations about the specified
printers.
.TP
\fB\-m\fR MAXJOBSIZE, \fB\-\-maxjobsize\fR=\fIMAXJOBSIZE\fR
Set the maximum job size in pages allowed on the
specified printers.
.TP
\fB\-n\fR, \fB\-\-nopassthrough\fR
Deactivate passthrough mode for the specified
printers. This is the normal mode of operations, in
which print jobs are accounted for, and are checked
against printing quotas and available credits.
.TP
\fB\-p\fR, \fB\-\-passthrough\fR
Activate passthrough mode for the specified printers.
In this mode, jobs sent to these printers are not
accounted for. This can be useful for exams during
which no user should be charged for his printouts.
.TP
\fB\-r\fR, \fB\-\-remove\fR
When combined with the \fB\-\-groups\fR option, remove
printers from the specified printers groups.
.TP
\fB\-s\fR, \fB\-\-skipexisting\fR
If \fB\-\-add\fR is used, ensure that existing printers won't
be modified.
.SS "examples:"
.IP
pkprinters \fB\-\-add\fR \fB\-\-cups\fR \fB\-D\fR "HP Printer" \fB\-\-charge\fR 0.05,0.1 hp2100 hp2200
Would create three printers named 'hp2100', and 'hp2200' in PyKota's
database, while telling CUPS to route all print jobs through PyKota for
these printers. Each of them would have 'HP Printer' as its description.
Printing to any of them would cost 0.05 credit per page, plus 0.1 credit
for each job.
.IP
pkprinters \fB\-\-delete\fR "*"
Would delete all existing printers and matching print quota entries and
printing history from PyKota's database. USE WITH CARE.
.IP
pkprinters \fB\-\-groups\fR Laser,HP "hp*"
Would add all printers which name begins with 'hp' to the 'Laser' and 'HP'
printers groups, which must already exist.
.IP
pkprinters \fB\-\-groups\fR Lexmark \fB\-\-remove\fR hp2200
Would remove printer 'hp2200' from the 'Lexmark' printers group.
.SS "licensing terms:"
.IP
(c) 2003\-2009 Jerome Alet \- alet@librelogiciel.com
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 3 of the License, or (at your option)
any later version.
.IP
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.
.IP
You should have received a copy of the GNU General Public License along
with this program.  If not, see <http://www.gnu.org/licenses/>.