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. |