| 1 | <!-- $Id$ --> |
|---|
| 2 | |
|---|
| 3 | <chapter> |
|---|
| 4 | <title>Automate user account creation with autopykota</title> |
|---|
| 5 | <para>Last modified on $Date$</para> |
|---|
| 6 | |
|---|
| 7 | <para> |
|---|
| 8 | If you want to automate the users account and quota entries creation on first print, |
|---|
| 9 | you can do this easily with the <literal>policy: external( your command here )</literal> |
|---|
| 10 | directive in <filename>pykota.conf</filename>. |
|---|
| 11 | You just have to put your command of choice there. |
|---|
| 12 | </para> |
|---|
| 13 | |
|---|
| 14 | <para> |
|---|
| 15 | <command>autopykota</command> was designed to automatically set |
|---|
| 16 | an initial account balance value to newly added users, while taking |
|---|
| 17 | care of not resetting the balance value if the user already exists |
|---|
| 18 | but doesn't have a quota entry on the current printer. |
|---|
| 19 | </para> |
|---|
| 20 | |
|---|
| 21 | <para> |
|---|
| 22 | If you want to limit your users by page quota then you must not use |
|---|
| 23 | this command. Just use some form of the <command>edpykota</command> |
|---|
| 24 | command and it will work just fine. On the other hand, if you want |
|---|
| 25 | to limit your users by their account balance, this command was |
|---|
| 26 | made to ease your life : you don't have to design a complex shell |
|---|
| 27 | script to check if user already exists or have a quota entry on |
|---|
| 28 | the current printer before deciding if you have to set the initial |
|---|
| 29 | balance value or not : <command>autopykota</command> takes |
|---|
| 30 | care of all this automagically. |
|---|
| 31 | </para> |
|---|
| 32 | |
|---|
| 33 | <sect1> |
|---|
| 34 | <title>Reference</title> |
|---|
| 35 | <para> |
|---|
| 36 | <cmdsynopsis> |
|---|
| 37 | <command>autopykota</command> |
|---|
| 38 | <group choice="opt"><arg>-v</arg><arg>--version</arg></group> |
|---|
| 39 | <group choice="opt"><arg>-h</arg><arg>--help</arg></group> |
|---|
| 40 | <group choice="opt"> |
|---|
| 41 | <arg>-i <replaceable>value</replaceable></arg> |
|---|
| 42 | <arg>--initbalance <replaceable>value</replaceable></arg> |
|---|
| 43 | </group> |
|---|
| 44 | </cmdsynopsis> |
|---|
| 45 | </para> |
|---|
| 46 | </sect1> |
|---|
| 47 | </chapter> |
|---|
| 48 | |
|---|
| 49 | <!-- |
|---|
| 50 | |
|---|
| 51 | $Log$ |
|---|
| 52 | Revision 1.2 2005/02/28 00:07:37 jalet |
|---|
| 53 | Added pkmail's doc. |
|---|
| 54 | Used the <command> tag instead of <application> for commands. |
|---|
| 55 | Fixed some typos. |
|---|
| 56 | Added some missing command line options in the commands reference. |
|---|
| 57 | |
|---|
| 58 | Revision 1.1 2004/10/06 10:03:16 jalet |
|---|
| 59 | Improved documentation |
|---|
| 60 | |
|---|
| 61 | --> |
|---|
