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

Revision 1869, 3.9 kB (checked in by jalet, 20 years ago)

Updated manual pages (version number)

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