[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 |
---|
[2115] | 19 | regular intervals, like every day, for example from a <application>cron</application> job. |
---|
[867] | 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, |
---|
[2115] | 24 | but then he doesn't print for some days and may forget to fix the problem, by buying more |
---|
[867] | 25 | paper for example. |
---|
| 26 | </para> |
---|
| 27 | |
---|
| 28 | <para> |
---|
[2115] | 29 | The <command>warnpykota</command> command was written with this in mind. |
---|
[867] | 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 |
---|
[1101] | 32 | will not forget it ! Of course they may delete the messages without having read them, |
---|
[2115] | 33 | but at least they won't be able to say that they didn't receive them ;-) |
---|
[867] | 34 | </para> |
---|
| 35 | |
---|
[959] | 36 | <para> |
---|
[1783] | 37 | When an user who is not a <application>PyKota</application> administrator launches this command, only him can receive a warning |
---|
[1101] | 38 | message. He can specify a printer name's filter to check his quota only |
---|
[1783] | 39 | on specific printers. If a normal user uses the <literal>--groups</literal> command line |
---|
[1101] | 40 | argument, then for each group he is a member of in the Quota Storage, each |
---|
| 41 | group member may receive a warning message. You can take care of this if this |
---|
[2115] | 42 | becomes annoying by forbidding normal users to launch the <command>warnpykota</command> |
---|
[1101] | 43 | command. |
---|
[959] | 44 | </para> |
---|
| 45 | |
---|
[1101] | 46 | <para> |
---|
[1783] | 47 | <application>PyKota</application> administrators can pass additionnal user or group names |
---|
[1101] | 48 | (or wildcard filters) to only check the users or groups whose name matches. |
---|
| 49 | </para> |
---|
[867] | 50 | |
---|
| 51 | <sect1> |
---|
| 52 | <title>Reference</title> |
---|
| 53 | <para> |
---|
| 54 | <cmdsynopsis> |
---|
| 55 | <command>warnpykota</command> |
---|
| 56 | <group choice="opt"><arg>-v</arg><arg>--version</arg></group> |
---|
| 57 | <group choice="opt"><arg>-h</arg><arg>--help</arg></group> |
---|
| 58 | <group choice="opt"><arg>-u</arg><arg>--users</arg></group> |
---|
| 59 | <group choice="opt"><arg>-g</arg><arg>--groups</arg></group> |
---|
| 60 | <group choice="opt"> |
---|
| 61 | <arg>-P <replaceable>printername</replaceable></arg> |
---|
| 62 | <arg>--printer <replaceable>printername</replaceable></arg> |
---|
| 63 | </group> |
---|
[1101] | 64 | <group choice="opt"> |
---|
| 65 | <arg><replaceable>name1</replaceable></arg> |
---|
| 66 | <arg><replaceable>name2</replaceable></arg> |
---|
| 67 | <arg><replaceable>...</replaceable></arg> |
---|
| 68 | <arg><replaceable>nameN</replaceable></arg> |
---|
| 69 | </group> |
---|
[867] | 70 | </cmdsynopsis> |
---|
| 71 | </para> |
---|
| 72 | </sect1> |
---|
[753] | 73 | </chapter> |
---|
| 74 | |
---|
| 75 | <!-- |
---|
| 76 | |
---|
| 77 | $Log$ |
---|
[2115] | 78 | Revision 1.7 2005/02/28 00:07:37 jalet |
---|
| 79 | Added pkmail's doc. |
---|
| 80 | Used the <command> tag instead of <application> for commands. |
---|
| 81 | Fixed some typos. |
---|
| 82 | Added some missing command line options in the commands reference. |
---|
| 83 | |
---|
[1783] | 84 | Revision 1.6 2004/10/06 10:03:16 jalet |
---|
| 85 | Improved documentation |
---|
| 86 | |
---|
[1101] | 87 | Revision 1.5 2003/07/25 13:10:58 jalet |
---|
| 88 | Improved documentation |
---|
| 89 | |
---|
[959] | 90 | Revision 1.4 2003/04/24 21:09:47 jalet |
---|
| 91 | Documentation slightly improved. |
---|
| 92 | |
---|
[867] | 93 | Revision 1.3 2003/03/25 12:30:37 jalet |
---|
| 94 | Added warnpykota command synopsis |
---|
| 95 | |
---|
[865] | 96 | Revision 1.2 2003/03/25 09:32:06 jalet |
---|
| 97 | Improved documentation. |
---|
| 98 | |
---|
[753] | 99 | Revision 1.1 2003/02/08 00:03:35 jalet |
---|
| 100 | Documentation skeleton added |
---|
| 101 | |
---|
| 102 | --> |
---|