1 | # $Id$ |
---|
2 | |
---|
3 | PyKota - Print Quota for CUPS |
---|
4 | |
---|
5 | (c) 2003 Jerome Alet <alet@librelogiciel.com> |
---|
6 | This program is free software; you can redistribute it and/or modify |
---|
7 | it under the terms of the GNU General Public License as published by |
---|
8 | the Free Software Foundation; either version 2 of the License, or |
---|
9 | (at your option) any later version. |
---|
10 | |
---|
11 | This program is distributed in the hope that it will be useful, |
---|
12 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
---|
13 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
---|
14 | GNU General Public License for more details. |
---|
15 | |
---|
16 | You should have received a copy of the GNU General Public License |
---|
17 | along with this program; if not, write to the Free Software |
---|
18 | Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA. |
---|
19 | |
---|
20 | ============================================================ |
---|
21 | |
---|
22 | PyKota NEWS : |
---|
23 | |
---|
24 | - 1.13 : |
---|
25 | |
---|
26 | - The whole module code was passed through PyChecker and |
---|
27 | several small code inconsistencies were fixed, |
---|
28 | as well as a bug in the groups code. |
---|
29 | |
---|
30 | - 1.13alpha1 : |
---|
31 | |
---|
32 | - Bug fix wrt LDAP. |
---|
33 | |
---|
34 | - 1.12 : |
---|
35 | |
---|
36 | - More complete test added in edpykota. |
---|
37 | |
---|
38 | - 1.12alpha2 : |
---|
39 | |
---|
40 | - The previous bug fix was incomplete. This is corrected. |
---|
41 | |
---|
42 | - 1.12alpha1 : |
---|
43 | |
---|
44 | - Small bug fix. |
---|
45 | |
---|
46 | - 1.11 : |
---|
47 | |
---|
48 | - Now includes the pykotme command line tool, to produce |
---|
49 | printing quotes for users. |
---|
50 | |
---|
51 | - 1.10 : |
---|
52 | |
---|
53 | - Bug fixed wrt quota reports when print limiting is by |
---|
54 | account balance. |
---|
55 | |
---|
56 | - 1.09 : |
---|
57 | |
---|
58 | - Translations finalized. |
---|
59 | |
---|
60 | - Manpages updated. |
---|
61 | |
---|
62 | - Installation documentation improved wrt LDAP support. |
---|
63 | |
---|
64 | - 1.09beta2 : |
---|
65 | |
---|
66 | - The CGI script for quota reports works again, and |
---|
67 | is much more powerful. |
---|
68 | |
---|
69 | - 1.09beta : |
---|
70 | |
---|
71 | - edpykota finalized |
---|
72 | |
---|
73 | - 1.09alpha2 : |
---|
74 | |
---|
75 | - LDAP schema modified a bit. Please upgrade. |
---|
76 | |
---|
77 | - LDAP backend works ! |
---|
78 | |
---|
79 | - repykota and warnpykota allow the root user to pass |
---|
80 | users or groups names on the command line. Users |
---|
81 | and groups names may contain wildcards. |
---|
82 | |
---|
83 | - repykota and warnpykota only reports or warns the |
---|
84 | current user when launched by non-root users. |
---|
85 | |
---|
86 | - Minor bug fixes. |
---|
87 | |
---|
88 | - 1.09alpha1 : |
---|
89 | |
---|
90 | - More work on LDAP storage backend. Many options |
---|
91 | were added to /etc/pykota.conf to give some |
---|
92 | hints to the LDAP storage backend. |
---|
93 | |
---|
94 | - Severe database access optimizations were done by |
---|
95 | rewriting most of the Quota Storage backends drivers. |
---|
96 | |
---|
97 | - 1.08 : |
---|
98 | |
---|
99 | - Major bug fix wrt LPRng support for remote jobs. |
---|
100 | |
---|
101 | - Major bug fix wrt increase/decrease account balances. |
---|
102 | |
---|
103 | - 1.08alpha8 : |
---|
104 | |
---|
105 | - Code refactoring. |
---|
106 | |
---|
107 | - A single user/password pair is used to connect |
---|
108 | to the database backend. The storageuser configuration |
---|
109 | field, and its associated passwords storageuserpw, are |
---|
110 | not used anymore. |
---|
111 | |
---|
112 | - You can now set PyKota in debug mode, see sample configuration |
---|
113 | file for details. |
---|
114 | WARNING : only Quota Storage backend queries are logged in |
---|
115 | debug mode, for now. |
---|
116 | |
---|
117 | - 1.08alpha7 : |
---|
118 | |
---|
119 | - Very latest LDAP schema. |
---|
120 | |
---|
121 | - Code enhancement wrt easy pluggability of PyKota attributes |
---|
122 | and object classes into an existing LDAP directory. |
---|
123 | |
---|
124 | - 1.08alpha6 : |
---|
125 | |
---|
126 | - Minor bug corrections |
---|
127 | |
---|
128 | - More work on LDAP : new schema |
---|
129 | |
---|
130 | - 1.08alpha5 : |
---|
131 | |
---|
132 | - More good work on LDAP storage. |
---|
133 | repykota now works reasonably well with the sample LDAP directory. |
---|
134 | |
---|
135 | - 1.08alpha4 : |
---|
136 | |
---|
137 | - LDAP schema included. |
---|
138 | THIS IS JUST FOR PEOPLE TO DISCUSS ABOUT THIS. |
---|
139 | LDAP SUPPORT DOESN'T WORK YET, AND THE SCHEMA |
---|
140 | MAY CHANGE IN THE FUTURE. PLEASE TELL US |
---|
141 | WHAT YOU THINK ABOUT THIS SCHEMA ON THE |
---|
142 | MAILING LIST. |
---|
143 | |
---|
144 | - 1.08alpha3 : |
---|
145 | |
---|
146 | - External accounting methods were partly rewritten : |
---|
147 | |
---|
148 | - No more "broken pipe" should happen. |
---|
149 | |
---|
150 | - They now take care of the number of copies |
---|
151 | This may be unneeded though, if the postscript |
---|
152 | file already does this, because this would |
---|
153 | overcharge users (number of copies counted |
---|
154 | two times). NEEDS MORE TESTING. |
---|
155 | |
---|
156 | - The sample configuration file now contains |
---|
157 | an external accounting method example which should |
---|
158 | work with all DSC compliant Postscript files. |
---|
159 | |
---|
160 | - Some small bugs were fixed. |
---|
161 | |
---|
162 | - 1.08alpha2 : |
---|
163 | |
---|
164 | - Now works with net-snmp v5.0 and above. |
---|
165 | It already worked, but the sample configuration |
---|
166 | file didn't contain appropriate values... |
---|
167 | |
---|
168 | - 1.07 : Release of the Shame ! |
---|
169 | |
---|
170 | - The external accounting methods driver was left out of |
---|
171 | the CVS tree. Nobody could use it since it wasn't included ! |
---|
172 | |
---|
173 | - 1.06 : |
---|
174 | |
---|
175 | - Severe bug fixed : if you had a printer in |
---|
176 | power saving state which couldn't answer immediately, |
---|
177 | a bug was triggered. |
---|
178 | It was caused by a bad copy/paste which |
---|
179 | forgot to import a Python module at run time. |
---|
180 | |
---|
181 | - 1.05 : |
---|
182 | |
---|
183 | - External accounters are finally available ! |
---|
184 | This means that you can plug any page accounting |
---|
185 | method you like by setting the appropriate |
---|
186 | 'accounter' field in /etc/pykota.conf |
---|
187 | See the sample conf/pykota.conf.sample to |
---|
188 | learn how to do. |
---|
189 | |
---|
190 | NB : Both 'external' and 'stupid' accounting methods |
---|
191 | account a job size just before *this* job is |
---|
192 | sent to the printer. |
---|
193 | The original 'querying' method accounts a job |
---|
194 | size just before *the next* job is sent to |
---|
195 | the printer. |
---|
196 | |
---|
197 | - 1.05alpha3 : |
---|
198 | |
---|
199 | - A 'stupid' and unreliable accounting method was |
---|
200 | implemented to serve as an example on how to |
---|
201 | do this sort of things. This method only counts |
---|
202 | the 'showpage' statements in the input data. |
---|
203 | See sample configuration file for details. |
---|
204 | Pluggable accounting methods work, but I advise |
---|
205 | you TO NOT USE THIS ONE WHICH IS JUST AN EXAMPLE. |
---|
206 | It is not reliable enough to be used. |
---|
207 | Use the 'querying' accounting method instead. |
---|
208 | |
---|
209 | - 1.05alpha2 : |
---|
210 | |
---|
211 | - Pluggable accounting methods. |
---|
212 | |
---|
213 | - Better error handling. |
---|
214 | |
---|
215 | - 1.05alpha1 : |
---|
216 | |
---|
217 | - SECURITY file added to help improve PyKota's security. |
---|
218 | |
---|
219 | - Extracting the printer's internal page counter is now |
---|
220 | tried several times, waiting several seconds between |
---|
221 | two tries. This lets the time to warm up for some printers |
---|
222 | which don't answer when they are sleeping (my Apple |
---|
223 | LaserWriter 16/600 PS is in this case, maybe others too) |
---|
224 | |
---|
225 | - Small display bug fixed in repykota |
---|
226 | |
---|
227 | - 1.04 : |
---|
228 | |
---|
229 | - Default print policy for users/groups unknown from |
---|
230 | the print quota system is now DENY instead of ALLOW, |
---|
231 | since ALLOW can generate inaccurate results |
---|
232 | (incorrect job sizes charged to the wrong persons) |
---|
233 | |
---|
234 | - LPRng support works ! |
---|
235 | |
---|
236 | - A bug was introduced some time ago wrt printers' default |
---|
237 | policy for unknown users. It is now corrected. |
---|
238 | |
---|
239 | - repykota now displays prices per job and per page for each |
---|
240 | printer, if they are defined. |
---|
241 | |
---|
242 | - Minor display bug fixed in repykota. |
---|
243 | |
---|
244 | - Problem when running repykota with an empty database was fixed. |
---|
245 | |
---|
246 | - 1.03 : |
---|
247 | |
---|
248 | - Upgrade script included for earlier versions. |
---|
249 | Please look inside the initscripts subdirectory. |
---|
250 | THE DATABASE SCHEMA HAS CHANGED, PLEASE UPGRADE. |
---|
251 | |
---|
252 | - repykota now reports account balances too. |
---|
253 | |
---|
254 | - PyKota now has a nice logo, see the logos |
---|
255 | subdirectory. |
---|
256 | |
---|
257 | - Manual pages were finally updated. |
---|
258 | |
---|
259 | - Group quotas seem to work now ! |
---|
260 | |
---|
261 | - The new database schema allows to keep an history of all |
---|
262 | jobs as well as charge users per page and/or per job, |
---|
263 | and track users' account balance. |
---|
264 | |
---|
265 | - edpykota now accepts much more command line options to |
---|
266 | use the new functionnalities. See edpykota --help for |
---|
267 | details. |
---|
268 | |
---|
269 | - The installation script now allows to install the sample |
---|
270 | configuration file during first installation. |
---|
271 | |
---|
272 | - More group quota code works, but still not finished. |
---|
273 | |
---|
274 | - The CGI script displays a link to PyKota's website. |
---|
275 | |
---|
276 | - The job history is now kept, this will allow per-period |
---|
277 | reports in the future. |
---|
278 | |
---|
279 | - After having modified the quota for an user with edpykota, |
---|
280 | a quota check is done to eventually warn the user/admin about |
---|
281 | a quota which is too low to print. |
---|
282 | |
---|
283 | - A workaround is provided for HP Printers : their internal |
---|
284 | page counter is only saved to NVRAM in a 10 increment, so |
---|
285 | if you switch them off and then on, the reported page counter |
---|
286 | may be lower than the real number of pages printed. |
---|
287 | See http://web.mit.edu/source/third/lprng/doc/LPRng-HOWTO-15.html |
---|
288 | We unconditionnally set the last job's page count to |
---|
289 | abs(int((10 - abs(lastcounter(snmp) - lastcounter(storage)) / 2)) |
---|
290 | in this case. |
---|
291 | For a more accurate accounting, never switch your HP printers |
---|
292 | off. |
---|
293 | |
---|
294 | - A fix is provided for printers which only have a volatile |
---|
295 | page counter (reset to 0 every time you switch the printer on) |
---|
296 | This should allow PyKota to work reasonably fine with HP Laserjet |
---|
297 | 4L/5L/6L, not perfect, but better than nothing. |
---|
298 | See http://web.mit.edu/source/third/lprng/doc/LPRng-HOWTO-15.html |
---|
299 | For a more accurate accounting, never switch your HP printers |
---|
300 | off. This is untested, please report any problem. |
---|
301 | |
---|
302 | - A bug was fixed when edpykota --add was used with users who already |
---|
303 | had a quota on the specified printer. |
---|
304 | |
---|
305 | - A small display bug in repykota was introduced in preliminary |
---|
306 | 1.03 versions, and fixed later on. |
---|
307 | |
---|
308 | - Some minor bugs which happened in rare situations were fixed. |
---|
309 | |
---|
310 | - Support for AppleTalk printers was added, see sample configuration |
---|
311 | file for details. |
---|
312 | |
---|
313 | - Users and group printing can now be controlled (limited) either by |
---|
314 | print quota or by account balance. |
---|
315 | |
---|
316 | - 1.02 : |
---|
317 | |
---|
318 | - The installation script now checks for software availability |
---|
319 | and in case a software is missing asks the user if he |
---|
320 | wants to continue with the installation or abort it. |
---|
321 | |
---|
322 | - The configuration file pykota.conf is now expected to be |
---|
323 | found in /etc instead of in /etc/cups |
---|
324 | The installation script prompts the user to see if he |
---|
325 | wants to move an old configuration file to the new location |
---|
326 | if needed. |
---|
327 | |
---|
328 | - Improved documentation. |
---|
329 | |
---|
330 | - You can now set the tcp/ip port on which the Quota Storage |
---|
331 | Server is listening, see sample configuration file for details. |
---|
332 | |
---|
333 | - Better general error handling. |
---|
334 | |
---|
335 | - Upgrade script for pre 1.01 PostgreSQL database schema is now |
---|
336 | included as well. |
---|
337 | |
---|
338 | - 1.01 : |
---|
339 | |
---|
340 | - The configuration file now accepts an option |
---|
341 | to choose the recipient(s) of the email messages : |
---|
342 | |
---|
343 | - DevNull means no one will receive them. |
---|
344 | - User means only the user will receive them. |
---|
345 | - Admin means only the admin will receive them. |
---|
346 | - Both means the User and the Admin will receive them. |
---|
347 | |
---|
348 | - The configuration file now uses hard-coded default values |
---|
349 | when an option is not set. See sample configuration file |
---|
350 | for details. |
---|
351 | |
---|
352 | - Manual pages are included since 1.00, but I forgot to |
---|
353 | add this information to this file. |
---|
354 | |
---|
355 | - Redistribution terms for the official package have |
---|
356 | softened and are now fully GPL compatible : |
---|
357 | unrestricted modification is now allowed even for |
---|
358 | the version number. |
---|
359 | |
---|
360 | - 1.00 : |
---|
361 | |
---|
362 | - edpykota now accepts a --noquota option. This |
---|
363 | disable quota checking while still doing page |
---|
364 | accounting. This is really useful for people |
---|
365 | who don't want to limit their users but want |
---|
366 | to know how much pages they print. |
---|
367 | |
---|
368 | - Some untested scripts were added to retrieve |
---|
369 | the life time page counter of non-SNMP printers. |
---|
370 | |
---|
371 | - Every directory now has a specific README file. |
---|
372 | |
---|
373 | - 0.99 : |
---|
374 | |
---|
375 | - Under some circumstances while the user wasn't allowed |
---|
376 | to print, he didn't receive any email message. It is |
---|
377 | now fixed. |
---|
378 | |
---|
379 | - When an user wasn't allowed to print, the quota for |
---|
380 | the previous user wasn't updated. This is now fixed. |
---|
381 | |
---|
382 | - 0.98 : |
---|
383 | |
---|
384 | - Correctly handle the case where the printer is switched off. |
---|
385 | |
---|
386 | - Small bug wrt syslog fixed. |
---|
387 | |
---|
388 | - 0.97 : |
---|
389 | |
---|
390 | - edpykota accepts wildcards on its command line for users/groups too |
---|
391 | if the --add option is not set, e.g. : |
---|
392 | |
---|
393 | $ edpykota --printer lp --softlimit 50 --hardlimit 100 "jer*" |
---|
394 | |
---|
395 | - If no user name is passed at all, then a default wildcard of "*" |
---|
396 | which means apply the command on ALL users for this printer is used. |
---|
397 | |
---|
398 | - Small bug fixes. |
---|
399 | |
---|
400 | - 0.96 : |
---|
401 | |
---|
402 | - Options requester, policy, admin, adminmail and gracedelay can now |
---|
403 | be set either globally or per printer. The printer option has |
---|
404 | priority if both are defined. |
---|
405 | |
---|
406 | - More powerful configuration parser. |
---|
407 | |
---|
408 | - If all options are defined globally, there's no need to |
---|
409 | define a section for each printer in the configuration |
---|
410 | file anymore. Just define a [global] section and it's ok. |
---|
411 | |
---|
412 | - 0.95 : |
---|
413 | |
---|
414 | - External requesters for printers finally added. |
---|
415 | |
---|
416 | - Full internationalization (english and french are supported) |
---|
417 | |
---|
418 | - More complete quota usage report |
---|
419 | |
---|
420 | - CGI script to access to the quota usage report |
---|
421 | |
---|
422 | - Several bugs fixed. |
---|
423 | |
---|
424 | |
---|
425 | - 0.9 : |
---|
426 | |
---|
427 | - First public version |
---|