9 | | PyKota's database with all existing print queues and some or all users. |
10 | | For now, no prices or limits are set, so printing is fully accounted |
11 | | for, but not limited. That's why you'll probably want to also use |
12 | | edpykota once the database has been initialized. |
13 | | .PP |
14 | | command line usage : |
| 10 | PyKota's database with all existing print queues and some or all users. For |
| 11 | now, no prices or limits are set, so printing is fully accounted for, but not |
| 12 | limited. That's why you'll probably want to also use edpykota once the |
| 13 | database has been initialized. |
| 14 | .SH OPTIONS |
| 15 | .TP |
| 16 | \fB\-h\fR, \fB\-\-help\fR |
| 17 | show this help message and exit. |
| 18 | .TP |
| 19 | \fB\-v\fR, \fB\-\-version\fR |
| 20 | show the version number and exit. |
| 21 | .TP |
| 22 | \fB\-A\fR ARGUMENTSFILE, \fB\-\-arguments\fR=\fIARGUMENTSFILE\fR |
| 23 | loads additional options and arguments from a file, |
| 24 | one per line. |
| 25 | .TP |
| 26 | \fB\-c\fR, \fB\-\-doconf\fR |
| 27 | Try to autodetect the best print accounting settings |
| 28 | for existing CUPS printers. All printers must be |
| 29 | switched ON beforehand. |
| 30 | .TP |
| 31 | \fB\-d\fR, \fB\-\-dousers\fR |
| 32 | Create accounts for users, and allocate print quota |
| 33 | entries for them. |
| 34 | .TP |
| 35 | \fB\-D\fR, \fB\-\-dogroups\fR |
| 36 | Create accounts for users groups, and allocate print |
| 37 | quota entries for them. |
| 38 | .TP |
| 39 | \fB\-e\fR, \fB\-\-emptygroups\fR |
| 40 | Also include groups which don't have any member. |
| 41 | .TP |
| 42 | \fB\-f\fR, \fB\-\-force\fR |
| 43 | Modifies PyKota's database content for real, instead |
| 44 | of faking it (for safety reasons). |
| 45 | .TP |
| 46 | \fB\-u\fR UIDMIN, \fB\-\-uidmin\fR=\fIUIDMIN\fR |
| 47 | Only include users whose uid is greater than or equal |
| 48 | to this parameter. If you pass an username instead, |
| 49 | his uid will be used automatically. |
| 50 | .TP |
| 51 | \fB\-U\fR UIDMAX, \fB\-\-uidmax\fR=\fIUIDMAX\fR |
| 52 | Only include users whose uid is lesser than or equal |
| 53 | to this parameter. If you pass an username instead, |
| 54 | his uid will be used automatically. |
| 55 | .TP |
| 56 | \fB\-g\fR GIDMIN, \fB\-\-gidmin\fR=\fIGIDMIN\fR |
| 57 | Only include users groups whose gid is greater than or |
| 58 | equal to this parameter. If you pass a groupname |
| 59 | instead, its gid will be used automatically. |
| 60 | .TP |
| 61 | \fB\-G\fR GIDMAX, \fB\-\-gidmax\fR=\fIGIDMAX\fR |
| 62 | Only include users groups whose gid is lesser than or |
| 63 | equal to this parameter. If you pass a groupname |
| 64 | instead, its gid will be used automatically. |
| 65 | .SS "examples:" |
16 | | pkturnkey [options] [printqueues names] |
17 | | .PP |
18 | | options : |
19 | | .TP |
20 | | \fB\-v\fR | \fB\-\-version\fR |
21 | | Prints pkturnkey version number then exits. |
22 | | .TP |
23 | | \fB\-h\fR | \fB\-\-help\fR |
24 | | Prints this message then exits. |
25 | | .TP |
26 | | \fB\-c\fR | \fB\-\-doconf\fR |
27 | | Give hints about what to put into pykota.conf |
28 | | .TP |
29 | | \fB\-d\fR | \fB\-\-dousers\fR |
30 | | Manages users accounts as well. |
31 | | .TP |
32 | | \fB\-D\fR | \fB\-\-dogroups\fR |
33 | | Manages users groups as well. |
34 | | Implies \fB\-d\fR | \fB\-\-dousers\fR. |
35 | | .TP |
36 | | \fB\-e\fR | \fB\-\-emptygroups\fR |
37 | | Includes empty groups. |
38 | | .TP |
39 | | \fB\-f\fR | \fB\-\-force\fR |
40 | | Modifies the database instead of printing what |
41 | | it would do. |
42 | | .TP |
43 | | \fB\-u\fR | \fB\-\-uidmin\fR uid |
44 | | Only adds users whose uid is greater than or equal to |
45 | | uid. You can pass an username there as well, and its |
46 | | uid will be used automatically. |
47 | | If not set, 0 will be used automatically. |
48 | | Implies \fB\-d\fR | \fB\-\-dousers\fR. |
49 | | .TP |
50 | | \fB\-U\fR | \fB\-\-uidmax\fR uid |
51 | | Only adds users whose uid is lesser than or equal to |
52 | | uid. You can pass an username there as well, and its |
53 | | uid will be used automatically. |
54 | | If not set, a large value will be used automatically. |
55 | | Implies \fB\-d\fR | \fB\-\-dousers\fR. |
56 | | .TP |
57 | | \fB\-g\fR | \fB\-\-gidmin\fR gid |
58 | | Only adds groups whose gid is greater than or equal to |
59 | | gid. You can pass a groupname there as well, and its |
60 | | gid will be used automatically. |
61 | | If not set, 0 will be used automatically. |
62 | | Implies \fB\-D\fR | \fB\-\-dogroups\fR. |
63 | | .TP |
64 | | \fB\-G\fR | \fB\-\-gidmax\fR gid |
65 | | Only adds groups whose gid is lesser than or equal to |
66 | | gid. You can pass a groupname there as well, and its |
67 | | gid will be used automatically. |
68 | | If not set, a large value will be used automatically. |
69 | | Implies \fB\-D\fR | \fB\-\-dogroups\fR. |
70 | | .PP |
71 | | examples : |
| 67 | pkturnkey \fB\-\-dousers\fR \fB\-\-uidmin\fR jerome HPLASER1 HPLASER2 |
| 68 | Would simulate the creation in PyKota's database of the printing accounts |
| 69 | for all users whose uid is greater than or equal to 'jerome''s. Each of |
| 70 | them would be given a print quota entry on printers 'HPLASER1' and |
| 71 | \&'HPLASER2'. |
82 | | You can limit the initialization to only a subset of the existing |
83 | | printers, by passing their names at the end of the command line. |
84 | | .PP |
85 | | (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet <alet@librelogiciel.com> |
86 | | This program is free software: you can redistribute it and/or modify |
87 | | it under the terms of the GNU General Public License as published by |
88 | | the Free Software Foundation, either version 3 of the License, or |
89 | | (at your option) any later version. |
90 | | .PP |
91 | | This program is distributed in the hope that it will be useful, |
92 | | but WITHOUT ANY WARRANTY; without even the implied warranty of |
93 | | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
94 | | GNU General Public License for more details. |
95 | | .PP |
96 | | You should have received a copy of the GNU General Public License |
97 | | along with this program. If not, see <http://www.gnu.org/licenses/>. |
98 | | .PP |
99 | | Please report bugs to : Jerome Alet \- alet@librelogiciel.com |
| 89 | This program is distributed in the hope that it will be useful, but |
| 90 | WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY |
| 91 | or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
| 92 | for more details. |
| 93 | .IP |
| 94 | You should have received a copy of the GNU General Public License along |
| 95 | with this program. If not, see <http://www.gnu.org/licenses/>. |