[2833] | 1 | <!-- $Id$ --> |
---|
| 2 | |
---|
| 3 | <chapter> |
---|
| 4 | <title id="pkusers">Manage Users and Groups with pkusers</title> |
---|
| 5 | <para>Last modified on $Date$</para> |
---|
[3413] | 6 | |
---|
[2833] | 7 | <para> |
---|
| 8 | You'll use this tool to create, manage or delete users or users groups from the database. |
---|
| 9 | Before you can assign print quotas to an user or group with the <command>edpykota</command> you |
---|
| 10 | MUST add this user or group to the database using <command>pkusers</command>. |
---|
| 11 | </para> |
---|
[3413] | 12 | |
---|
[2833] | 13 | <para> |
---|
| 14 | The simplest way to add an user named <literal>jerome</literal> to the database is |
---|
| 15 | to type : |
---|
[3413] | 16 | <screen> |
---|
[2833] | 17 | $ pkusers --add jerome |
---|
| 18 | </screen> |
---|
| 19 | </para> |
---|
[3413] | 20 | |
---|
[2833] | 21 | <para> |
---|
| 22 | The commands above have created user <literal>jerome</literal> in the database. By default this |
---|
| 23 | user will be limited by page quotas, that is a maximal number of pages can be assigned to this |
---|
| 24 | user on any printer. This has to be done through the <command>edpykota</command> command line tool. |
---|
| 25 | </para> |
---|
[3413] | 26 | |
---|
[2833] | 27 | <para> |
---|
| 28 | You can apply different sorts of limitations to an user or users group, by specifying a |
---|
| 29 | different value for the <literal>--limitby</literal> command line option to <command>pkusers</command> : |
---|
| 30 | <itemizedlist> |
---|
| 31 | <listitem> |
---|
| 32 | <para> |
---|
[3413] | 33 | <literal>--limitby quota</literal> : Page quotas are defined for each user on each printer. |
---|
[2833] | 34 | This means that an user can be |
---|
| 35 | limited to print more than 20 pages on printer <literal>HP2100</literal> while still |
---|
| 36 | being allowed to print 500 pages on printer <literal>TekTro</literal>. |
---|
| 37 | This is the default. |
---|
| 38 | </para> |
---|
[3413] | 39 | </listitem> |
---|
[2833] | 40 | <listitem> |
---|
| 41 | <para> |
---|
| 42 | <literal>--limitby balance</literal> : Account balance quotas are defined once for each user. |
---|
| 43 | You give a number of credits |
---|
| 44 | to an user, and whenever he prints on any printer, his number of credits diminishes |
---|
| 45 | by the cost of the current print job, until his balance reaches 0 (or the value |
---|
| 46 | defined in the <literal>balancezero</literal> configuration directive in <filename>~pykota/pykota.conf</filename>). |
---|
| 47 | In other terms, while page quotas are specific to a particular printer for a particular |
---|
| 48 | user, account balance quotas are shared between all printers for a particular user. |
---|
| 49 | </para> |
---|
[3413] | 50 | </listitem> |
---|
[2833] | 51 | <listitem> |
---|
| 52 | <para> |
---|
| 53 | <literal>--limitby noquota</literal> : the user or group can print without any limitation, but |
---|
| 54 | accounting continues to be done. |
---|
| 55 | </para> |
---|
[3413] | 56 | </listitem> |
---|
[2833] | 57 | <listitem> |
---|
| 58 | <para> |
---|
| 59 | <literal>--limitby nochange</literal> : the user can print without any limitation, but |
---|
| 60 | accounting is not done. |
---|
| 61 | This value is not supported for users groups. |
---|
| 62 | </para> |
---|
[3413] | 63 | </listitem> |
---|
[2833] | 64 | <listitem> |
---|
| 65 | <para> |
---|
| 66 | <literal>--limitby noprint</literal> : the user can not print. |
---|
| 67 | This value is not supported for users groups. |
---|
| 68 | </para> |
---|
[3413] | 69 | </listitem> |
---|
| 70 | </itemizedlist> |
---|
[2833] | 71 | </para> |
---|
[3413] | 72 | |
---|
[2833] | 73 | <para> |
---|
| 74 | Here's an incomplete list of features : |
---|
[3413] | 75 | |
---|
[2833] | 76 | <itemizedlist> |
---|
| 77 | <listitem> |
---|
| 78 | <para> |
---|
| 79 | Add and delete users and groups ; |
---|
| 80 | </para> |
---|
| 81 | </listitem> |
---|
| 82 | <listitem> |
---|
| 83 | <para> |
---|
| 84 | Add or remove users from users groups ; |
---|
| 85 | </para> |
---|
| 86 | </listitem> |
---|
| 87 | <listitem> |
---|
| 88 | <para> |
---|
| 89 | Choose the way you will limit printing for users or groups ; |
---|
| 90 | </para> |
---|
| 91 | </listitem> |
---|
| 92 | <listitem> |
---|
| 93 | <para> |
---|
| 94 | Set users' account balances. An optional comment can be added to each payment ; |
---|
| 95 | </para> |
---|
| 96 | </listitem> |
---|
| 97 | <listitem> |
---|
| 98 | <para> |
---|
| 99 | Set users' overcharging (or undercharging) factor ; |
---|
| 100 | </para> |
---|
| 101 | </listitem> |
---|
| 102 | <listitem> |
---|
| 103 | <para> |
---|
| 104 | Sets a textual description for users or groups ; |
---|
| 105 | </para> |
---|
| 106 | </listitem> |
---|
| 107 | <listitem> |
---|
| 108 | <para> |
---|
| 109 | Sets users' email addresses (on creation only) ; |
---|
| 110 | </para> |
---|
| 111 | </listitem> |
---|
| 112 | <listitem> |
---|
| 113 | <para> |
---|
| 114 | Lists users or groups ; |
---|
| 115 | </para> |
---|
| 116 | </listitem> |
---|
| 117 | </itemizedlist> |
---|
| 118 | </para> |
---|
[3413] | 119 | |
---|
[2833] | 120 | <para> |
---|
| 121 | For more details on the use of <command>pkusers</command>, please see this command's manual |
---|
| 122 | page or help. |
---|
| 123 | </para> |
---|
[3413] | 124 | |
---|
[2833] | 125 | </chapter> |
---|
| 126 | |
---|