| 11 | |
| 12 | <para> |
| 13 | For now its functionnalities are fairly limited, but it can : |
| 14 | <itemizedlist> |
| 15 | <listitem> |
| 16 | <para> |
| 17 | Import existing print queues into <application>PyKota</application>'s database. |
| 18 | </para> |
| 19 | </listitem> |
| 20 | <listitem> |
| 21 | <para> |
| 22 | Import existing users into <application>PyKota</application>'s database. |
| 23 | </para> |
| 24 | </listitem> |
| 25 | <listitem> |
| 26 | <para> |
| 27 | Import existing users groups into <application>PyKota</application>'s database. |
| 28 | </para> |
| 29 | </listitem> |
| 30 | <listitem> |
| 31 | <para> |
| 32 | Tell you which accounting method is the best for your printers. |
| 33 | </para> |
| 34 | </listitem> |
| 35 | </itemizedlist> |
| 36 | </para> |
| 37 | |
| 38 | <para> |
| 39 | In the future, it is possible that this command will entirely generate configuration |
| 40 | files for you, and do a bunch of other things to ease the installation and |
| 41 | configuration of <application>PyKota</application> |
| 42 | </para> |
| 43 | |
| 44 | <para> |
| 45 | One very important thing to remember is that, by default, <command>pkturnkey</command> |
| 46 | doesn't modify anything, unless you tell it to really do so by using its |
| 47 | <literal>--force</literal> (or <literal>-f</literal>) command line switch. |
| 48 | This lets you familiarize with what would happen before doing it for real, |
| 49 | especially because <command>pkturnkey</command> displays the other commands |
| 50 | it would launch. |
| 51 | </para> |
| 52 | |
| 53 | <para> |
| 54 | You can restrict the datas you want to import into the database by using the |
| 55 | appropriate command line switches, or by passing printers' names as non-option |
| 56 | arguments at the end of the command line. |
| 57 | </para> |
| 58 | |
| 59 | <para> |
| 60 | The following example will import all existing print queues, as well as all |
| 61 | users whose uid is comprised between 1000 and 50000 and all groups whose |
| 62 | gid is comprised between 5000 and 6000 : |
| 63 | <screen> |
| 64 | $ pkturnkey --force --uidmin 1000 --dousers --uidmax 50000 --dogroups --gidmin 5000 --gidmax 6000 |
| 65 | </screen> |
| 66 | </para> |
| 75 | <group choice="opt"><arg>-f</arg><arg>--force</arg></group> |
| 76 | <group choice="opt"><arg>-d</arg><arg>--dousers</arg></group> |
| 77 | <group choice="opt"><arg>-D</arg><arg>--dogroups</arg></group> |
| 78 | <group choice="opt"> |
| 79 | <arg>-u <replaceable>uid</replaceable></arg> |
| 80 | <arg>--uidmin <replaceable>uid</replaceable></arg> |
| 81 | </group> |
| 82 | <group choice="opt"> |
| 83 | <arg>-U <replaceable>uid</replaceable></arg> |
| 84 | <arg>--uidmax <replaceable>uid</replaceable></arg> |
| 85 | </group> |
| 86 | <group choice="opt"> |
| 87 | <arg>-g <replaceable>gid</replaceable></arg> |
| 88 | <arg>--gidmin <replaceable>gid</replaceable></arg> |
| 89 | </group> |
| 90 | <group choice="opt"> |
| 91 | <arg>-G <replaceable>gid</replaceable></arg> |
| 92 | <arg>--gidmax <replaceable>gid</replaceable></arg> |
| 93 | </group> |