[1167] | 1 | .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.33. |
---|
[1414] | 2 | .TH EDPYKOTA "1" "March 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands" |
---|
[837] | 3 | .SH NAME |
---|
[1414] | 4 | edpykota \- manual page for edpykota 1.18_unofficial |
---|
[837] | 5 | .SH DESCRIPTION |
---|
[1414] | 6 | edpykota v1.18_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres |
---|
[837] | 7 | A Print Quota editor for PyKota. |
---|
| 8 | .PP |
---|
| 9 | command line usage : |
---|
| 10 | .IP |
---|
| 11 | edpykota [options] user1 user2 ... userN |
---|
[937] | 12 | .IP |
---|
[837] | 13 | edpykota [options] group1 group2 ... groupN |
---|
| 14 | .PP |
---|
| 15 | options : |
---|
| 16 | .TP |
---|
| 17 | \fB\-v\fR | \fB\-\-version\fR |
---|
| 18 | Prints edpykota's version number then exits. |
---|
| 19 | .TP |
---|
| 20 | \fB\-h\fR | \fB\-\-help\fR |
---|
| 21 | Prints this message then exits. |
---|
| 22 | .TP |
---|
| 23 | \fB\-a\fR | \fB\-\-add\fR |
---|
| 24 | Adds users and/or printers if they don't |
---|
| 25 | exist on the Quota Storage Server. |
---|
| 26 | .TP |
---|
[935] | 27 | \fB\-d\fR | \fB\-\-delete\fR |
---|
| 28 | Deletes users/groups from the quota storage. |
---|
| 29 | Printers are never deleted. |
---|
| 30 | .TP |
---|
| 31 | \fB\-c\fR | \fB\-\-charge\fR p[,j] |
---|
| 32 | Sets the price per page and per job to charge |
---|
| 33 | for a particular printer. Job price is optional. |
---|
| 34 | If both are to be set, separate them with a comma. |
---|
| 35 | Floating point values are allowed. |
---|
| 36 | .TP |
---|
| 37 | \fB\-i\fR | \fB\-\-ingroups\fR g1[,g2...] |
---|
| 38 | Puts the users into each of the groups |
---|
| 39 | listed, separated by commas. The groups |
---|
| 40 | must already exist in the Quota Storage. |
---|
| 41 | .TP |
---|
[837] | 42 | \fB\-u\fR | \fB\-\-users\fR |
---|
| 43 | Edit users print quotas, this is the default. |
---|
| 44 | .TP |
---|
| 45 | \fB\-P\fR | \fB\-\-printer\fR p |
---|
| 46 | Edit quotas on printer p only. Actually p can |
---|
| 47 | use wildcards characters to select only |
---|
| 48 | some printers. The default value is *, meaning |
---|
| 49 | all printers. |
---|
[1167] | 50 | You can specify several names or wildcards, |
---|
| 51 | by separating them with commas. |
---|
[837] | 52 | .TP |
---|
[1287] | 53 | \fB\-G\fR | \fB\-\-pgroups\fR pg1[,pg2...] Adds the printer(s) to the printer groups |
---|
| 54 | pg1, pg2, etc... which must already exist. |
---|
| 55 | A printer group is just like a normal printer, |
---|
| 56 | only that it is usually unknown from the printing |
---|
| 57 | system. Create printer groups exactly the same |
---|
| 58 | way that you create printers, then add other |
---|
| 59 | printers to them with this option. |
---|
| 60 | Accounting is done on a printer and on all |
---|
| 61 | the printer groups it belongs to, quota checking |
---|
| 62 | is done on a printer and on all the printer groups |
---|
| 63 | it belongs to. |
---|
| 64 | .TP |
---|
[837] | 65 | \fB\-g\fR | \fB\-\-groups\fR |
---|
[1287] | 66 | Edit users groups print quotas instead of users. |
---|
[837] | 67 | .TP |
---|
| 68 | \fB\-p\fR | \fB\-\-prototype\fR u|g Uses user u or group g as a prototype to set |
---|
| 69 | print quotas |
---|
| 70 | .TP |
---|
[935] | 71 | \fB\-n\fR | \fB\-\-noquota\fR |
---|
| 72 | Doesn't set a quota but only does accounting. |
---|
| 73 | .TP |
---|
[837] | 74 | \fB\-r\fR | \fB\-\-reset\fR |
---|
| 75 | Resets the printed page counter for the user |
---|
| 76 | or group to zero. The life time page counter |
---|
| 77 | is kept unchanged. |
---|
| 78 | .TP |
---|
[935] | 79 | \fB\-l\fR | \fB\-\-limitby\fR l |
---|
| 80 | Choose if the user/group is limited in printing |
---|
| 81 | by its account balance or by its page quota. |
---|
| 82 | The default value is 'quota'. Allowed values |
---|
| 83 | are 'quota' and 'balance'. |
---|
| 84 | .TP |
---|
| 85 | \fB\-b\fR | \fB\-\-balance\fR b |
---|
| 86 | Sets the user's account balance to b. |
---|
| 87 | Account balance may be increase or decreased |
---|
| 88 | if b is prefixed with + or -. |
---|
| 89 | WARNING : when decreasing account balance, |
---|
| 90 | the total paid so far by the user is decreased |
---|
| 91 | too. |
---|
| 92 | Groups don't have a real balance, but the |
---|
| 93 | sum of their users' account balance. |
---|
| 94 | .TP |
---|
[837] | 95 | \fB\-S\fR | \fB\-\-softlimit\fR sl |
---|
| 96 | Sets the quota soft limit to sl pages. |
---|
| 97 | .TP |
---|
| 98 | \fB\-H\fR | \fB\-\-hardlimit\fR hl |
---|
| 99 | Sets the quota hard limit to hl pages. |
---|
| 100 | .IP |
---|
| 101 | user1 through userN and group1 through groupN can use wildcards |
---|
| 102 | if the \fB\-\-add\fR option is not set. |
---|
| 103 | .PP |
---|
| 104 | examples : |
---|
| 105 | .IP |
---|
[1355] | 106 | \f(CW$ edpykota --add -p jerome john paul george ringo/ringo@example.com\fR |
---|
[837] | 107 | .IP |
---|
[1287] | 108 | This will add users john, paul, george and ringo to the quota |
---|
| 109 | database, and set their print quotas to the same values than user |
---|
| 110 | jerome. User jerome must already exist. |
---|
[1355] | 111 | User ringo's email address will also be set to 'ringo@example.com' |
---|
[837] | 112 | .IP |
---|
| 113 | \f(CW$ edpykota --printer lp -S 50 -H 60 jerome\fR |
---|
| 114 | .IP |
---|
| 115 | This will set jerome's print quota on the lp printer to a soft limit |
---|
| 116 | of 50 pages, and a hard limit of 60 pages. If either user jerome or |
---|
| 117 | printer lp doesn't exist on the Quota Storage Server then nothing is done. |
---|
| 118 | .IP |
---|
[935] | 119 | \f(CW$ edpykota --add --printer lp --ingroups coders,it -S 50 -H 60 jerome\fR |
---|
[837] | 120 | .IP |
---|
| 121 | Same as above, but if either user jerome or printer lp doesn't exist |
---|
[935] | 122 | on the Quota Storage Server they are automatically added. Also |
---|
| 123 | user jerome is put into the groups "coders" and "it" which must |
---|
| 124 | already exist in the Quota Storage. |
---|
[837] | 125 | .IP |
---|
| 126 | \f(CW$ edpykota -g -S 500 -H 550 financial support\fR |
---|
| 127 | .IP |
---|
| 128 | This will set print quota soft limit to 500 pages and hard limit |
---|
| 129 | to 550 pages for groups financial and support on all printers. |
---|
| 130 | .IP |
---|
| 131 | \f(CW$ edpykota --reset jerome "jo*"\fR |
---|
| 132 | .IP |
---|
| 133 | This will reset jerome's page counter to zero on all printers, as |
---|
| 134 | well as every user whose name begins with 'jo'. |
---|
| 135 | Their life time page counter on each printer will be kept unchanged. |
---|
[935] | 136 | .IP |
---|
| 137 | \f(CW$ edpykota --printer hpcolor --noquota jerome\fR |
---|
| 138 | .IP |
---|
| 139 | This will tell PyKota to not limit jerome when printing on the |
---|
| 140 | hpcolor printer. All his jobs will be allowed on this printer, but |
---|
| 141 | accounting of the pages he prints will still be kept. |
---|
| 142 | Print Quotas for jerome on other printers are unchanged. |
---|
| 143 | .IP |
---|
| 144 | \f(CW$ edpykota --limitby balance jerome\fR |
---|
| 145 | .IP |
---|
| 146 | This will tell PyKota to limit jerome by his account's balance |
---|
| 147 | when printing. |
---|
| 148 | .IP |
---|
| 149 | \f(CW$ edpykota --balance +10.0 jerome\fR |
---|
| 150 | .IP |
---|
| 151 | This will increase jerome's account balance by 10.0 (in your |
---|
| 152 | own currency). You can decrease the account balance with a |
---|
| 153 | dash prefix, and set it to a fixed amount with no prefix. |
---|
| 154 | .IP |
---|
| 155 | \f(CW$ edpykota --delete jerome rachel\fR |
---|
| 156 | .IP |
---|
| 157 | This will completely delete jerome and rachel from the Quota Storage |
---|
| 158 | database. All their quotas and jobs will be deleted too. |
---|
| 159 | .IP |
---|
| 160 | \f(CW$ edpykota --printer lp --charge 0.1\fR |
---|
| 161 | .IP |
---|
| 162 | This will set the page price for printer lp to 0.1. Job price |
---|
| 163 | will not be changed. |
---|
[1287] | 164 | .IP |
---|
| 165 | \f(CW$ edpykota --printer hplj1,hplj2 --pgroups Laser,HP\fR |
---|
| 166 | .IP |
---|
| 167 | This will put printers hplj1 and hplj2 in printers groups Laser and HP. |
---|
| 168 | When printing either on hplj1 or hplj2, print quota will also be |
---|
| 169 | checked and accounted for on virtual printers Laser and HP. |
---|
[837] | 170 | .PP |
---|
| 171 | This program is free software; you can redistribute it and/or modify |
---|
| 172 | it under the terms of the GNU General Public License as published by |
---|
| 173 | the Free Software Foundation; either version 2 of the License, or |
---|
| 174 | (at your option) any later version. |
---|
| 175 | .PP |
---|
| 176 | This program is distributed in the hope that it will be useful, |
---|
| 177 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
---|
| 178 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
---|
| 179 | GNU General Public License for more details. |
---|
| 180 | .PP |
---|
| 181 | You should have received a copy of the GNU General Public License |
---|
| 182 | along with this program; if not, write to the Free Software |
---|
| 183 | Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA. |
---|
| 184 | .PP |
---|
| 185 | Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com |
---|