6 | | pkprinters v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com |
7 | | .PP |
8 | | A Printers Manager for PyKota. |
9 | | .PP |
10 | | command line usage : |
| 9 | Manages PyKota printers. |
| 10 | .SH OPTIONS |
| 11 | .TP |
| 12 | \fB\-h\fR, \fB\-\-help\fR |
| 13 | show this help message and exit. |
| 14 | .TP |
| 15 | \fB\-v\fR, \fB\-\-version\fR |
| 16 | show the version number and exit. |
| 17 | .TP |
| 18 | \fB\-A\fR ARGUMENTSFILE, \fB\-\-arguments\fR=\fIARGUMENTSFILE\fR |
| 19 | loads additional options and arguments from a file, |
| 20 | one per line. |
| 21 | .TP |
| 22 | \fB\-a\fR, \fB\-\-add\fR |
| 23 | Add new, or modify existing, printers. |
| 24 | .TP |
| 25 | \fB\-c\fR CHARGE, \fB\-\-charge\fR=\fICHARGE\fR |
| 26 | Set the cost per page, and optionally per job, for |
| 27 | printing to the specified printers. If both are to be |
| 28 | set, separate them with a comma. Floating point and |
| 29 | negative values are allowed. |
| 30 | .TP |
| 31 | \fB\-C\fR, \fB\-\-cups\fR |
| 32 | Tell CUPS to either start or stop managing the |
| 33 | specified printers with PyKota. |
| 34 | .TP |
| 35 | \fB\-d\fR, \fB\-\-delete\fR |
| 36 | Delete the specified printers. Also purge the print |
| 37 | quota entries and printing history matching the |
| 38 | specified printers. |
| 39 | .TP |
| 40 | \fB\-D\fR DESCRIPTION, \fB\-\-description\fR=\fIDESCRIPTION\fR |
| 41 | Set a textual description for the specified printers. |
| 42 | .TP |
| 43 | \fB\-g\fR GROUPS, \fB\-\-groups\fR=\fIGROUPS\fR |
| 44 | If the \fB\-\-remove\fR option is not used, the default action |
| 45 | is to add the specified printers to the specified |
| 46 | printers groups. Otherwise they are removed from these |
| 47 | groups. The specified printers groups must already |
| 48 | exist, and should be created beforehand just like |
| 49 | normal printers with this very command. |
| 50 | .TP |
| 51 | \fB\-l\fR, \fB\-\-list\fR |
| 52 | Display detailed informations about the specified |
| 53 | printers. |
| 54 | .TP |
| 55 | \fB\-m\fR MAXJOBSIZE, \fB\-\-maxjobsize\fR=\fIMAXJOBSIZE\fR |
| 56 | Set the maximum job size in pages allowed on the |
| 57 | specified printers. |
| 58 | .TP |
| 59 | \fB\-n\fR, \fB\-\-nopassthrough\fR |
| 60 | Deactivate passthrough mode for the specified |
| 61 | printers. This is the normal mode of operations, in |
| 62 | which print jobs are accounted for, and are checked |
| 63 | against printing quotas and available credits. |
| 64 | .TP |
| 65 | \fB\-p\fR, \fB\-\-passthrough\fR |
| 66 | Activate passthrough mode for the specified printers. |
| 67 | In this mode, jobs sent to these printers are not |
| 68 | accounted for. This can be useful for exams during |
| 69 | which no user should be charged for his printouts. |
| 70 | .TP |
| 71 | \fB\-r\fR, \fB\-\-remove\fR |
| 72 | When combined with the \fB\-\-groups\fR option, remove |
| 73 | printers from the specified printers groups. |
| 74 | .TP |
| 75 | \fB\-s\fR, \fB\-\-skipexisting\fR |
| 76 | If \fB\-\-add\fR is used, ensure that existing printers won't |
| 77 | be modified. |
| 78 | .SS "examples:" |
12 | | pkprinters [options] printer1 printer2 printer3 ... printerN |
13 | | .PP |
14 | | options : |
15 | | .TP |
16 | | \fB\-v\fR | \fB\-\-version\fR |
17 | | Prints pkprinters's version number then exits. |
18 | | .TP |
19 | | \fB\-h\fR | \fB\-\-help\fR |
20 | | Prints this message then exits. |
21 | | .TP |
22 | | \fB\-a\fR | \fB\-\-add\fR |
23 | | Adds printers if they don't exist on the Quota |
24 | | Storage Server. If they exist, they are modified |
25 | | unless \fB\-s\fR|\-\-skipexisting is also used. |
26 | | .TP |
27 | | \fB\-d\fR | \fB\-\-delete\fR |
28 | | Deletes 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 |
33 | | Also modifies the DeviceURI in CUPS' printers.conf |
34 | | .TP |
35 | | \fB\-c\fR | \fB\-\-charge\fR p[,j] |
36 | | Sets the price per page and per job to charge. |
37 | | Job price is optional. |
38 | | If both are to be set, separate them with a comma. |
39 | | Floating 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 |
42 | | groups pg1, pg2, etc... which must already exist. |
43 | | A printer group is just like a normal printer, |
44 | | only that it is usually unknown from the printing |
45 | | system. Create printer groups exactly the same |
46 | | way that you create printers, then add other |
47 | | printers to them with this option. |
48 | | Accounting is done on a printer and on all |
49 | | the printer groups it belongs to, quota checking |
50 | | is done on a printer and on all the printer groups |
51 | | it belongs to. |
52 | | If the \fB\-\-remove\fR option below is not used, the |
53 | | default action is to add printers to the specified |
54 | | printer groups. |
55 | | .TP |
56 | | \fB\-l\fR | \fB\-\-list\fR |
57 | | List informations about the printer(s) and the |
58 | | printers groups it is a member of. |
59 | | .TP |
60 | | \fB\-r\fR | \fB\-\-remove\fR |
61 | | In combination with the \fB\-\-groups\fR option above, |
62 | | remove printers from the specified printers groups. |
63 | | .TP |
64 | | \fB\-s\fR | \fB\-\-skipexisting\fR |
65 | | In combination with the \fB\-\-add\fR option above, tells |
66 | | pkprinters to not modify existing printers. |
67 | | .TP |
68 | | \fB\-m\fR | \fB\-\-maxjobsize\fR s |
69 | | Sets the maximum job size allowed on the printer |
70 | | to s pages. |
71 | | .TP |
72 | | \fB\-p\fR | \fB\-\-passthrough\fR |
73 | | Activate passthrough mode for the printer. In this |
74 | | mode, users are allowed to print without any impact |
75 | | on their quota or account balance. |
76 | | .TP |
77 | | \fB\-n\fR | \fB\-\-nopassthrough\fR Deactivate passthrough mode for the printer. |
78 | | Without \fB\-p\fR or \fB\-n\fR, printers are created in |
79 | | normal mode, i.e. no passthrough. |
| 80 | pkprinters \fB\-\-add\fR \fB\-\-cups\fR \fB\-D\fR "HP Printer" \fB\-\-charge\fR 0.05,0.1 hp2100 hp2200 |
| 81 | Would create three printers named 'hp2100', and 'hp2200' in PyKota's |
| 82 | database, while telling CUPS to route all print jobs through PyKota for |
| 83 | these printers. Each of them would have 'HP Printer' as its description. |
| 84 | Printing to any of them would cost 0.05 credit per page, plus 0.1 credit |
| 85 | for each job. |
101 | | \f(CW$ pkprinters \-\-groups Laser,HP "hp*"\fR |
102 | | .IP |
103 | | This will put all printers which name matches "hp*" into printers groups |
104 | | Laser and HP, which MUST already exist. |
105 | | .IP |
106 | | \f(CW$ pkprinters \-\-groups LexMark \-\-remove hp2200\fR |
107 | | .IP |
108 | | This will remove the hp2200 printer from the LexMark printer group. |
109 | | .PP |
110 | | (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet <alet@librelogiciel.com> |
111 | | This program is free software: you can redistribute it and/or modify |
112 | | it under the terms of the GNU General Public License as published by |
113 | | the Free Software Foundation, either version 3 of the License, or |
114 | | (at your option) any later version. |
115 | | .PP |
116 | | This program is distributed in the hope that it will be useful, |
117 | | but WITHOUT ANY WARRANTY; without even the implied warranty of |
118 | | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
119 | | GNU General Public License for more details. |
120 | | .PP |
121 | | You should have received a copy of the GNU General Public License |
122 | | along with this program. If not, see <http://www.gnu.org/licenses/>. |
123 | | .PP |
124 | | Please report bugs to : Jerome Alet \- alet@librelogiciel.com |
| 110 | You should have received a copy of the GNU General Public License along |
| 111 | with this program. If not, see <http://www.gnu.org/licenses/>. |