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 | |
---|