| | 10 | </para> |
| | 11 | |
| | 12 | <para> |
| | 13 | You'll use this tool to create, manage or delete print quota entries for users |
| | 14 | or users groups on printers or printers groups. |
| | 15 | </para> |
| | 16 | |
| | 17 | <para> |
| | 18 | By default, before being allowed to print through <application>PyKota</application>, |
| | 19 | an user must exist in the database and have a print quota entry on every printer |
| | 20 | he should be allowed to use. The simplest way to add an user named <literal>jerome</literal> to the database is |
| | 21 | to type : |
| | 22 | <screen> |
| | 23 | $ edpykota --add --noquota jerome |
| | 24 | </screen> |
| | 25 | </para> |
| | 26 | |
| | 27 | <para> |
| | 28 | The command above has created user <literal>jerome</literal> in the database, and has automatically |
| | 29 | created print quota entries with no limit for this user on all existing printers. This means |
| | 30 | that user <literal>jerome</literal> is allowed to print without limitation, but that full accounting |
| | 31 | will still be done for this user : you'll know whenever he prints and how much. |
| | 32 | </para> |
| | 33 | |
| | 34 | <para> |
| | 35 | You can apply two sorts of print quotas to users : page quotas, and account balance quotas. |
| | 36 | <itemizedlist> |
| | 37 | <listitem> |
| | 38 | <para> |
| | 39 | Page quotas are defined for each user on each printer. This means that an user can be |
| | 40 | limited to print more than 20 pages on printer <literal>HP2100</literal> while still |
| | 41 | being allowed to print 500 pages on printer <literal>TekTro</literal>. |
| | 42 | </para> |
| | 43 | </listitem> |
| | 44 | <listitem> |
| | 45 | <para> |
| | 46 | Account balance quotas are defined once for each user. You give a number of credits |
| | 47 | to an user, and whenever he prints on any printer, his number of credits diminishes |
| | 48 | by the cost of the current print job, until his balance reaches 0. |
| | 49 | In other terms, while page quotas are specific to a particular printer for a particular |
| | 50 | user, account balance quotas are shared between all printers for a particular user. |
| | 51 | </para> |
| | 52 | </listitem> |
| | 53 | </itemizedlist> |
| | 54 | This means that you have to choose which type of quota you want for each user. |
| | 55 | The default mode is page quotas, but if you pass <literal>--limitby balance</literal> |
| | 56 | as command line options to <command>edpykota</command>, the users onto which the command |
| | 57 | will apply will be limited by the value of their account instead of by a number of |
| | 58 | pages. |
