root / pykota / branches / 1.26_fixes / docs / edpykota.sgml @ 3500

Revision 2833, 2.2 kB (checked in by jerome, 19 years ago)

Improved documentation a bit. More will follow.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
Line 
1<!-- $Id$ -->
2
3<chapter>
4  <title id="edpykota">Manage Print Quotas with edpykota</title>
5  <para>Last modified on $Date$</para>
6 
7  <para>
8    You'll use this tool to create, manage or delete print quota entries for users
9    or users groups on printers or printers groups.
10  </para>
11 
12  <para>
13    By default, before being allowed to print through <application>PyKota</application>,
14    an user must exist in the database and have a print quota entry on every printer
15    he should be allowed to use. As seen in the previous chapter, the simplest way to add an user named <literal>jerome</literal> to the database is
16    to type :
17<screen>    
18$ pkusers --add jerome
19</screen>
20
21    But this is not sufficient to allow user <literal>jerome</literal> to print. You have to create a print quota entry for <literal>jerome</literal> on all printers
22    he is allowed to print to. The easiest way to do so is to type :
23<screen>    
24$ edpykota --add jerome
25</screen>
26  </para>
27 
28  <para>
29    The commands above have created user <literal>jerome</literal> in the database, and have automatically
30    created print quota entries with no limit for this user on all existing printers. This means
31    that user <literal>jerome</literal> is allowed to print without limitation, but that full accounting
32    will still be done for this user : you'll know whenever he prints and how much.
33  </para>
34 
35  <para>
36    Here's an incomplete list of features :
37   
38    <itemizedlist>
39      <listitem>
40        <para>
41          Add and delete users and groups print quota entries ;
42        </para>
43      </listitem>
44      <listitem>
45        <para>
46          Define, increase or decrease hard and soft page limits for users ou users groups, on a per printer basis ;
47        </para>
48      </listitem>
49      <listitem>
50        <para>
51          Reset or modify page counters for users or groups, on a per printer basis ;
52        </para>
53      </listitem>
54      <listitem>
55        <para>
56          List print quota entries ;
57        </para>
58      </listitem>
59    </itemizedlist>
60  </para>
61 
62  <para>
63    For more details on the use of <command>edpykota</command>, please see this command's manual
64    page or help.
65  </para>
66 
67</chapter>
68
Note: See TracBrowser for help on using the browser.