[1827] | 1 | .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.33. |
---|
| 2 | .TH EDPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands" |
---|
| 3 | .SH NOM |
---|
[1857] | 4 | edpykota \- page de manuel de edpykota 1.20alpha26_unofficial |
---|
[1827] | 5 | .SH DESCRIPTION |
---|
[1857] | 6 | edpykota v1.20alpha26_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres |
---|
[1827] | 7 | A Print Quota editor for PyKota. |
---|
| 8 | .PP |
---|
| 9 | command line usage : |
---|
| 10 | .IP |
---|
| 11 | edpykota [options] user1 user2 ... userN |
---|
| 12 | .IP |
---|
| 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 |
---|
| 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 |
---|
| 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. |
---|
| 50 | You can specify several names or wildcards, |
---|
| 51 | by separating them with commas. |
---|
| 52 | .TP |
---|
| 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 |
---|
| 65 | \fB\-g\fR | \fB\-\-groups\fR |
---|
| 66 | Edit users groups print quotas instead of users. |
---|
| 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 |
---|
| 71 | \fB\-n\fR | \fB\-\-noquota\fR |
---|
| 72 | Doesn't set a quota but only does accounting. |
---|
| 73 | .TP |
---|
| 74 | \fB\-r\fR | \fB\-\-reset\fR |
---|
| 75 | Resets the actual page counter for the user |
---|
| 76 | or group to zero on the specified printers. |
---|
| 77 | The life time page counter is kept unchanged. |
---|
| 78 | .TP |
---|
| 79 | \fB\-R\fR | \fB\-\-hardreset\fR |
---|
| 80 | Resets the actual and life time page counters |
---|
| 81 | for the user or group to zero on the specified |
---|
| 82 | printers. |
---|
| 83 | .TP |
---|
| 84 | \fB\-l\fR | \fB\-\-limitby\fR l |
---|
| 85 | Choose if the user/group is limited in printing |
---|
| 86 | by its account balance or by its page quota. |
---|
| 87 | The default value is 'quota'. Allowed values |
---|
| 88 | are 'quota' 'balance' 'quota-then-balance' and |
---|
| 89 | \&'balance-then-quota'. |
---|
| 90 | WARNING : quota-then-balance and balance-then-quota |
---|
| 91 | are not yet implemented. |
---|
| 92 | .TP |
---|
| 93 | \fB\-b\fR | \fB\-\-balance\fR b |
---|
| 94 | Sets the user's account balance to b. |
---|
| 95 | Account balance may be increase or decreased |
---|
| 96 | if b is prefixed with + or -. |
---|
| 97 | WARNING : when decreasing account balance, |
---|
| 98 | the total paid so far by the user is decreased |
---|
| 99 | too. |
---|
| 100 | Groups don't have a real balance, but the |
---|
| 101 | sum of their users' account balance. |
---|
| 102 | .TP |
---|
| 103 | \fB\-S\fR | \fB\-\-softlimit\fR sl |
---|
| 104 | Sets the quota soft limit to sl pages. |
---|
| 105 | .TP |
---|
| 106 | \fB\-H\fR | \fB\-\-hardlimit\fR hl |
---|
| 107 | Sets the quota hard limit to hl pages. |
---|
| 108 | .IP |
---|
| 109 | user1 through userN and group1 through groupN can use wildcards |
---|
| 110 | if the \fB\-\-add\fR option is not set. |
---|
| 111 | .PP |
---|
| 112 | examples : |
---|
| 113 | .IP |
---|
| 114 | \f(CW$ edpykota --add -p jerome john paul george ringo/ringo@example.com\fR |
---|
| 115 | .IP |
---|
| 116 | This will add users john, paul, george and ringo to the quota |
---|
| 117 | database, and set their print quotas to the same values than user |
---|
| 118 | jerome. User jerome must already exist. |
---|
| 119 | User ringo's email address will also be set to 'ringo@example.com' |
---|
| 120 | .IP |
---|
| 121 | \f(CW$ edpykota --printer lp -S 50 -H 60 jerome\fR |
---|
| 122 | .IP |
---|
| 123 | This will set jerome's print quota on the lp printer to a soft limit |
---|
| 124 | of 50 pages, and a hard limit of 60 pages. If either user jerome or |
---|
| 125 | printer lp doesn't exist on the Quota Storage Server then nothing is done. |
---|
| 126 | .IP |
---|
| 127 | \f(CW$ edpykota --add --printer lp --ingroups coders,it -S 50 -H 60 jerome\fR |
---|
| 128 | .IP |
---|
| 129 | Same as above, but if either user jerome or printer lp doesn't exist |
---|
| 130 | on the Quota Storage Server they are automatically added. Also |
---|
| 131 | user jerome is put into the groups "coders" and "it" which must |
---|
| 132 | already exist in the Quota Storage. |
---|
| 133 | .IP |
---|
| 134 | \f(CW$ edpykota -g -S 500 -H 550 financial support\fR |
---|
| 135 | .IP |
---|
| 136 | This will set print quota soft limit to 500 pages and hard limit |
---|
| 137 | to 550 pages for groups financial and support on all printers. |
---|
| 138 | .IP |
---|
| 139 | \f(CW$ edpykota --reset jerome "jo*"\fR |
---|
| 140 | .IP |
---|
| 141 | This will reset jerome's page counter to zero on all printers, as |
---|
| 142 | well as every user whose name begins with 'jo'. |
---|
| 143 | Their life time page counter on each printer will be kept unchanged. |
---|
| 144 | You can also reset the life time page counters by using the |
---|
| 145 | \fB\-\-hardreset\fR | \fB\-R\fR command line option. |
---|
| 146 | .IP |
---|
| 147 | \f(CW$ edpykota --printer hpcolor --noquota jerome\fR |
---|
| 148 | .IP |
---|
| 149 | This will tell PyKota to not limit jerome when printing on the |
---|
| 150 | hpcolor printer. All his jobs will be allowed on this printer, but |
---|
| 151 | accounting of the pages he prints will still be kept. |
---|
| 152 | Print Quotas for jerome on other printers are unchanged. |
---|
| 153 | .IP |
---|
| 154 | \f(CW$ edpykota --limitby balance jerome\fR |
---|
| 155 | .IP |
---|
| 156 | This will tell PyKota to limit jerome by his account's balance |
---|
| 157 | when printing. |
---|
| 158 | .IP |
---|
| 159 | \f(CW$ edpykota --balance +10.0 jerome\fR |
---|
| 160 | .IP |
---|
| 161 | This will increase jerome's account balance by 10.0 (in your |
---|
| 162 | own currency). You can decrease the account balance with a |
---|
| 163 | dash prefix, and set it to a fixed amount with no prefix. |
---|
| 164 | .IP |
---|
| 165 | \f(CW$ edpykota --delete jerome rachel\fR |
---|
| 166 | .IP |
---|
| 167 | This will completely delete jerome and rachel from the Quota Storage |
---|
| 168 | database. All their quotas and jobs will be deleted too. |
---|
| 169 | .IP |
---|
| 170 | \f(CW$ edpykota --printer lp --charge 0.1\fR |
---|
| 171 | .IP |
---|
| 172 | This will set the page price for printer lp to 0.1. Job price |
---|
| 173 | will not be changed. |
---|
| 174 | .IP |
---|
| 175 | \f(CW$ edpykota --printer hplj1,hplj2 --pgroups Laser,HP\fR |
---|
| 176 | .IP |
---|
| 177 | This will put printers hplj1 and hplj2 in printers groups Laser and HP. |
---|
| 178 | When printing either on hplj1 or hplj2, print quota will also be |
---|
| 179 | checked and accounted for on virtual printers Laser and HP. |
---|
| 180 | .PP |
---|
| 181 | This program is free software; you can redistribute it and/or modify |
---|
| 182 | it under the terms of the GNU General Public License as published by |
---|
| 183 | the Free Software Foundation; either version 2 of the License, or |
---|
| 184 | (at your option) any later version. |
---|
| 185 | .PP |
---|
| 186 | This program is distributed in the hope that it will be useful, |
---|
| 187 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
---|
| 188 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
---|
| 189 | GNU General Public License for more details. |
---|
| 190 | .PP |
---|
| 191 | You should have received a copy of the GNU General Public License |
---|
| 192 | along with this program; if not, write to the Free Software |
---|
| 193 | Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA. |
---|
| 194 | .PP |
---|
| 195 | Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com |
---|