| 1 | <!-- $Id$ --> |
|---|
| 2 | |
|---|
| 3 | <chapter> |
|---|
| 4 | <title>Warn users above print quota with warnpykota</title> |
|---|
| 5 | <para>Last modified on $Date$</para> |
|---|
| 6 | |
|---|
| 7 | <para> |
|---|
| 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. |
|---|
| 14 | </para> |
|---|
| 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 | |
|---|
| 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 | |
|---|
| 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> |
|---|
| 75 | </chapter> |
|---|
| 76 | |
|---|
| 77 | <!-- |
|---|
| 78 | |
|---|
| 79 | $Log$ |
|---|
| 80 | Revision 1.4 2003/04/24 21:09:47 jalet |
|---|
| 81 | Documentation slightly improved. |
|---|
| 82 | |
|---|
| 83 | Revision 1.3 2003/03/25 12:30:37 jalet |
|---|
| 84 | Added warnpykota command synopsis |
|---|
| 85 | |
|---|
| 86 | Revision 1.2 2003/03/25 09:32:06 jalet |
|---|
| 87 | Improved documentation. |
|---|
| 88 | |
|---|
| 89 | Revision 1.1 2003/02/08 00:03:35 jalet |
|---|
| 90 | Documentation skeleton added |
|---|
| 91 | |
|---|
| 92 | |
|---|
| 93 | --> |
|---|
