| 29 | | Deletes users/groups from the quota storage. |
| 30 | | Printers are never deleted. |
| 31 | | .TP |
| 32 | | \fB\-c\fR | \fB\-\-charge\fR p[,j] |
| 33 | | Sets the price per page and per job to charge |
| 34 | | for a particular printer. Job price is optional. |
| 35 | | If both are to be set, separate them with a comma. |
| 36 | | Floating point values are allowed. |
| 37 | | .TP |
| 38 | | \fB\-o\fR | \fB\-\-overcharge\fR f |
| 39 | | Sets the overcharging factor applied to the user |
| 40 | | when computing the cost of a print job. Positive or |
| 41 | | negative floating point values are allowed, |
| 42 | | this allows you to do some really creative |
| 43 | | things like giving money to an user whenever |
| 44 | | he prints. The number of pages in a print job |
| 45 | | is not modified by this coefficient, only the |
| 46 | | cost of the job for a particular user. |
| 47 | | Only users have a coefficient. |
| 48 | | .TP |
| 49 | | \fB\-i\fR | \fB\-\-ingroups\fR g1[,g2...] |
| 50 | | Puts the users into each of the groups |
| 51 | | listed, separated by commas. The groups |
| 52 | | must already exist in the Quota Storage. |
| 53 | | .TP |
| 54 | | \fB\-u\fR | \fB\-\-users\fR |
| 55 | | Edit users print quotas, this is the default. |
| | 29 | Deletes users or groups print quota entries. |
| | 30 | Users or groups are never deleted, you have |
| | 31 | to use the pkusers command to delete them. |
| 65 | | \fB\-G\fR | \fB\-\-pgroups\fR pg1[,pg2...] Adds the printer(s) to the printer groups |
| 66 | | pg1, pg2, etc... which must already exist. |
| 67 | | A printer group is just like a normal printer, |
| 68 | | only that it is usually unknown from the printing |
| 69 | | system. Create printer groups exactly the same |
| 70 | | way that you create printers, then add other |
| 71 | | printers to them with this option. |
| 72 | | Accounting is done on a printer and on all |
| 73 | | the printer groups it belongs to, quota checking |
| 74 | | is done on a printer and on all the printer groups |
| 75 | | it belongs to. |
| 76 | | .TP |
| 100 | | \fB\-l\fR | \fB\-\-limitby\fR l |
| 101 | | Choose if the user/group is limited in printing |
| 102 | | by its account balance or by its page quota. |
| 103 | | The default value is 'quota'. Allowed values |
| 104 | | are 'quota' 'balance' 'noquota' 'noprint' |
| 105 | | and 'nochange' : |
| 106 | | .IP |
| 107 | | \- quota : limit by number of pages per printer. |
| 108 | | \- balance : limit by number of credits in account. |
| 109 | | \- noquota : no limit, accounting still done. |
| 110 | | \- nochange : no limit, accounting not done. |
| 111 | | \- noprint : printing is denied. |
| 112 | | .IP |
| 113 | | NB : nochange and noprint are not supported for groups. |
| 114 | | .TP |
| 115 | | \fB\-b\fR | \fB\-\-balance\fR b |
| 116 | | Sets the user's account balance to b. |
| 117 | | Account balance may be increase or decreased |
| 118 | | if b is prefixed with + or \-. |
| 119 | | WARNING : when decreasing account balance, |
| 120 | | the total paid so far by the user is decreased |
| 121 | | too. |
| 122 | | Groups don't have a real balance, but the |
| 123 | | sum of their users' account balance. |
| 124 | | .TP |
| 125 | | \fB\-C\fR | \fB\-\-comment\fR txt |
| 126 | | Defines some informational text to be associated |
| 127 | | with a change to an user's account balance. |
| 128 | | Only meaningful if \fB\-b\fR | \fB\-\-balance\fR is also used. |
| 129 | | .TP |
| 141 | | \fB\-U\fR | \fB\-\-used\fR usage |
| 142 | | Sets the pagecounters for the user to usage pages; |
| 143 | | useful for migrating users from a different system |
| | 70 | \fB\-U\fR | \fB\-\-used\fR u |
| | 71 | Sets the page counters for the user u pages on |
| | 72 | the selected printers. Doesn't work for groups, since |
| | 73 | their page counters are the sum of all their members' |
| | 74 | page counters. |
| | 75 | Useful for migrating users from a different system |
| 159 | | This will add users john, paul, george and ringo to the quota |
| 160 | | database, and set their print quotas to the same values than user |
| 161 | | jerome. User jerome must already exist. |
| 162 | | User ringo's email address will also be set to 'ringo@example.com' |
| | 91 | This will create print quota entries for users john, paul, george |
| | 92 | and ringo on all printers. These print quota entries will have no |
| | 93 | limit set. |
| 167 | | of 50 pages, and a hard limit of 60 pages. If either user jerome or |
| 168 | | printer lp doesn't exist on the Quota Storage Server then nothing is done. |
| 169 | | .IP |
| 170 | | \f(CW$ edpykota --add --printer lp --ingroups coders,it -S 50 -H 60 jerome\fR |
| 171 | | .IP |
| 172 | | Same as above, but if either user jerome or printer lp doesn't exist |
| 173 | | on the Quota Storage Server they are automatically added. Also |
| 174 | | user jerome is put into the groups "coders" and "it" which must |
| 175 | | already exist in the Quota Storage. |
| | 98 | of 50 pages, and a hard limit of 60 pages. Both user jerome and |
| | 99 | printer lp have been previously created with the pkusers and pkprinters |
| | 100 | commands, respectively. |
| 199 | | This will tell PyKota to limit jerome by his account's balance |
| 200 | | when printing. |
| 201 | | .IP |
| 202 | | \f(CW$ edpykota --balance +10.0 jerome\fR |
| 203 | | .IP |
| 204 | | This will increase jerome's account balance by 10.0 (in your |
| 205 | | own currency). You can decrease the account balance with a |
| 206 | | dash prefix, and set it to a fixed amount with no prefix. |
| 207 | | .IP |
| 208 | | \f(CW$ edpykota --delete jerome rachel\fR |
| 209 | | .IP |
| 210 | | This will completely delete jerome and rachel from the Quota Storage |
| 211 | | database. All their quotas and jobs will be deleted too. |
| 212 | | .IP |
| 213 | | \f(CW$ edpykota --printer lp --charge 0.1\fR |
| 214 | | .IP |
| 215 | | This will set the page price for printer lp to 0.1. Job price |
| 216 | | will not be changed. |
| 217 | | .IP |
| 218 | | \f(CW$ edpykota --printer hplj1,hplj2 --pgroups Laser,HP\fR |
| 219 | | .IP |
| 220 | | This will put printers hplj1 and hplj2 in printers groups Laser and HP. |
| 221 | | When printing either on hplj1 or hplj2, print quota will also be |
| 222 | | checked and accounted for on virtual printers Laser and HP. |
| 223 | | .IP |
| 224 | | \f(CW$ edpykota --overcharge 2.5 poorstudent\fR |
| 225 | | .IP |
| 226 | | This will overcharge the poorstudent user by a factor of 2.5. |
| 227 | | .IP |
| 228 | | \f(CW$ edpykota --overcharge -1 jerome\fR |
| 229 | | .IP |
| 230 | | User jerome will actually earn money whenever he prints. |
| 231 | | .IP |
| 232 | | \f(CW$ edpykota --overcharge 0 boss\fR |
| 233 | | .IP |
| 234 | | User boss can print at will, it won't cost him anything because the |
| 235 | | cost of each print job will be multiplied by zero before charging |
| 236 | | his account. |
| | 124 | This will delete users jerome and rachel's print quota |
| | 125 | entries on all printers which name begin with 'HP' or |
| | 126 | \&'XER'. The jobs printed by these users on these printers |
| | 127 | will be deleted from the history. |
