root / pykota / trunk / man / pkprinters.1 @ 2910

Revision 2910, 4.4 kB (checked in by jerome, 18 years ago)

Updated URLs in manual pages too.

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