[753] | 1 | <!-- $Id$ --> |
---|
| 2 | |
---|
| 3 | <chapter> |
---|
[865] | 4 | <title>Warn users above print quota with warnpykota</title> |
---|
| 5 | <para>Last modified on $Date$</para> |
---|
[867] | 6 | |
---|
[753] | 7 | <para> |
---|
[867] | 8 | Whenever a user tries to print a document, if he is over his print quota, |
---|
| 9 | then the job is refused. Depending on <application>PyKota</application>'s |
---|
| 10 | configuration, especially the <literal>mailto</literal> option, he and/or |
---|
| 11 | the administrator may eventually receive an email message which explains |
---|
| 12 | the situation and invites him to solve the problem before being allowed |
---|
| 13 | to print again. |
---|
[753] | 14 | </para> |
---|
[867] | 15 | |
---|
| 16 | <para> |
---|
| 17 | However this may not be sufficient, and you may want to warn users who |
---|
| 18 | have reached their print quota at |
---|
| 19 | regular intervals, like every day, for example in a <application>cron</application> job. |
---|
| 20 | </para> |
---|
| 21 | |
---|
| 22 | <para> |
---|
| 23 | This may be useful if the user has reached his print quota, and have received an email message telling him so, |
---|
| 24 | but then he doesn't print for some days and may forget to solve the problem, by buying more |
---|
| 25 | paper for example. |
---|
| 26 | </para> |
---|
| 27 | |
---|
| 28 | <para> |
---|
| 29 | The <application>warnpykota</application> command was written with this in mind. |
---|
| 30 | If you put this command in your <filename>crontab</filename>, launching it for example |
---|
| 31 | every day, then you'll be sure that all your users who are above their print quota |
---|
| 32 | will not forget it ! |
---|
| 33 | </para> |
---|
| 34 | |
---|
[959] | 35 | <para> |
---|
| 36 | At the very least, try to make your best to disallow ordinary users to be able to |
---|
| 37 | launch this command, since malicious users could fill other users mailboxes |
---|
| 38 | by repeatedly running <application>warnpykota</application> : each user above |
---|
| 39 | quota would receive multiple email messages, and possibly the administrator too ! |
---|
| 40 | </para> |
---|
| 41 | |
---|
[867] | 42 | <sect1> |
---|
| 43 | <title>Command line parameters</title> |
---|
| 44 | <para> |
---|
| 45 | TODO : blah |
---|
| 46 | </para> |
---|
| 47 | </sect1> |
---|
| 48 | |
---|
| 49 | <sect1> |
---|
| 50 | <title>Examples</title> |
---|
| 51 | <para> |
---|
| 52 | TODO : blah |
---|
| 53 | </para> |
---|
| 54 | </sect1> |
---|
| 55 | |
---|
| 56 | <sect1> |
---|
| 57 | <title>Reference</title> |
---|
| 58 | <para> |
---|
| 59 | <cmdsynopsis> |
---|
| 60 | <command>warnpykota</command> |
---|
| 61 | <group choice="opt"><arg>-v</arg><arg>--version</arg></group> |
---|
| 62 | <group choice="opt"><arg>-h</arg><arg>--help</arg></group> |
---|
| 63 | <group choice="opt"><arg>-u</arg><arg>--users</arg></group> |
---|
| 64 | <group choice="opt"><arg>-g</arg><arg>--groups</arg></group> |
---|
| 65 | <group choice="opt"> |
---|
| 66 | <arg>-P <replaceable>printername</replaceable></arg> |
---|
| 67 | <arg>--printer <replaceable>printername</replaceable></arg> |
---|
| 68 | </group> |
---|
| 69 | </cmdsynopsis> |
---|
| 70 | </para> |
---|
| 71 | <para> |
---|
| 72 | TODO |
---|
| 73 | </para> |
---|
| 74 | </sect1> |
---|
[753] | 75 | </chapter> |
---|
| 76 | |
---|
| 77 | <!-- |
---|
| 78 | |
---|
| 79 | $Log$ |
---|
[959] | 80 | Revision 1.4 2003/04/24 21:09:47 jalet |
---|
| 81 | Documentation slightly improved. |
---|
| 82 | |
---|
[867] | 83 | Revision 1.3 2003/03/25 12:30:37 jalet |
---|
| 84 | Added warnpykota command synopsis |
---|
| 85 | |
---|
[865] | 86 | Revision 1.2 2003/03/25 09:32:06 jalet |
---|
| 87 | Improved documentation. |
---|
| 88 | |
---|
[753] | 89 | Revision 1.1 2003/02/08 00:03:35 jalet |
---|
| 90 | Documentation skeleton added |
---|
| 91 | |
---|
| 92 | |
---|
| 93 | --> |
---|