root / pykota / trunk / docs / warnpykota.sgml @ 1117

<!-- $Id$ -->

<chapter>
  <title>Warn users above print quota with warnpykota</title>
  <para>Last modified on $Date$</para>
  
  <para>
    Whenever a user tries to print a document, if he is over his print quota,
    then the job is refused. Depending on <application>PyKota</application>'s
    configuration, especially the <literal>mailto</literal> option, he and/or
    the administrator may eventually receive an email message which explains
    the situation and invites him to solve the problem before being allowed
    to print again.
  </para>
  
  <para>
    However this may not be sufficient, and you may want to warn users who
    have reached their print quota at
    regular intervals, like every day, for example in a <application>cron</application> job.
  </para>
  
  <para>
    This may be useful if the user has reached his print quota, and have received an email message telling him so,
    but then he doesn't print for some days and may forget to solve the problem, by buying more
    paper for example.
  </para>
  
  <para>
    The <application>warnpykota</application> command was written with this in mind. 
    If you put this command in your <filename>crontab</filename>, launching it for example
    every day, then you'll be sure that all your users who are above their print quota
    will not forget it ! Of course they may delete the messages without having read them,
    but at least they won't be able to say that they didn't received them ;-)
  </para>
  
  <para>
    When a non-root user launches this command, only him can receive a warning
    message. He can specify a printer name's filter to check his quota only
    on specific printers. If a non-root users uses the <literal>--groups</literal> command line
    argument, then for each group he is a member of in the Quota Storage, each
    group member may receive a warning message. You can take care of this if this
    becomes annoying by forbidding normal users to launch the <application>warnpykota</application>
    command.
  </para>
  
  <para>
    The <literal>root</literal> user can pass additionnal user or group names 
    (or wildcard filters) to only check the users or groups whose name matches.
  </para>  
  
  <sect1>
    <title>Reference</title>
    <para>
      <cmdsynopsis>
        <command>warnpykota</command>
        <group choice="opt"><arg>-v</arg><arg>--version</arg></group>
        <group choice="opt"><arg>-h</arg><arg>--help</arg></group>
        <group choice="opt"><arg>-u</arg><arg>--users</arg></group>
        <group choice="opt"><arg>-g</arg><arg>--groups</arg></group>
        <group choice="opt">
          <arg>-P <replaceable>printername</replaceable></arg>
          <arg>--printer <replaceable>printername</replaceable></arg>
        </group>  
        <group choice="opt">
          <arg><replaceable>name1</replaceable></arg>
          <arg><replaceable>name2</replaceable></arg>
          <arg><replaceable>...</replaceable></arg>
          <arg><replaceable>nameN</replaceable></arg>
        </group>  
      </cmdsynopsis>
    </para>
  </sect1>
</chapter>

<!--

$Log$
Revision 1.5  2003/07/25 13:10:58  jalet
Improved documentation

Revision 1.4  2003/04/24 21:09:47  jalet
Documentation slightly improved.

Revision 1.3  2003/03/25 12:30:37  jalet
Added warnpykota command synopsis

Revision 1.2  2003/03/25 09:32:06  jalet
Improved documentation.

Revision 1.1  2003/02/08 00:03:35  jalet
Documentation skeleton added

-->