[3550] | 1 | .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.38.2. |
---|
| 2 | .TH PKTURNKEY "1" "août 2010" "C@LL - Conseil Internet & Logiciels Libres" "User Commands" |
---|
[2433] | 3 | .SH NOM |
---|
[3550] | 4 | pkturnkey \- page de manuel de pkturnkey (PyKota) 1.27alpha13_unofficial |
---|
[3485] | 5 | .SH SYNOPSIS |
---|
| 6 | .B pkturnkey |
---|
| 7 | [\fIoptions\fR] \fIprinter1 printer2 \fR... \fIprinterN\fR |
---|
[2433] | 8 | .SH DESCRIPTION |
---|
| 9 | A turn key tool for PyKota. When launched, this command will initialize |
---|
[3485] | 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 |
---|
[2433] | 15 | .TP |
---|
[3485] | 16 | \fB\-h\fR, \fB\-\-help\fR |
---|
| 17 | show this help message and exit. |
---|
[2433] | 18 | .TP |
---|
[3485] | 19 | \fB\-v\fR, \fB\-\-version\fR |
---|
| 20 | show the version number and exit. |
---|
[2433] | 21 | .TP |
---|
[3485] | 22 | \fB\-A\fR ARGUMENTSFILE, \fB\-\-arguments\fR=\fIARGUMENTSFILE\fR |
---|
| 23 | loads additional options and arguments from a file, |
---|
| 24 | one per line. |
---|
[2467] | 25 | .TP |
---|
[3485] | 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. |
---|
[2435] | 30 | .TP |
---|
[3485] | 31 | \fB\-d\fR, \fB\-\-dousers\fR |
---|
| 32 | Create accounts for users, and allocate print quota |
---|
| 33 | entries for them. |
---|
[2435] | 34 | .TP |
---|
[3485] | 35 | \fB\-D\fR, \fB\-\-dogroups\fR |
---|
| 36 | Create accounts for users groups, and allocate print |
---|
| 37 | quota entries for them. |
---|
[2435] | 38 | .TP |
---|
[3485] | 39 | \fB\-e\fR, \fB\-\-emptygroups\fR |
---|
| 40 | Also include groups which don't have any member. |
---|
[2433] | 41 | .TP |
---|
[3485] | 42 | \fB\-f\fR, \fB\-\-force\fR |
---|
| 43 | Modifies PyKota's database content for real, instead |
---|
| 44 | of faking it (for safety reasons). |
---|
[2433] | 45 | .TP |
---|
[3485] | 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. |
---|
[2435] | 50 | .TP |
---|
[3485] | 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. |
---|
[2435] | 55 | .TP |
---|
[3485] | 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:" |
---|
[2433] | 66 | .IP |
---|
[3485] | 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'. |
---|
[2433] | 72 | .IP |
---|
[3485] | 73 | pkturnkey \fB\-\-force\fR \fB\-\-dousers\fR \fB\-\-uidmin\fR jerome HPLASER1 HPLASER2 |
---|
| 74 | Would do the same as the example above, but for real. Please take great |
---|
| 75 | care when using the \fB\-\-force\fR command line option. |
---|
[2435] | 76 | .IP |
---|
[3485] | 77 | pkturnkey \fB\-\-doconf\fR |
---|
| 78 | Would try to automatically detect the best print accounting settings for |
---|
| 79 | all active printers, and generate some lines for you to add into your |
---|
| 80 | pykota.conf |
---|
| 81 | .SS "licensing terms:" |
---|
[2466] | 82 | .IP |
---|
[3550] | 83 | (c) 2003\-2010 Jerome Alet \- alet@librelogiciel.com |
---|
[3485] | 84 | This program is free software: you can redistribute it and/or modify it |
---|
| 85 | under the terms of the GNU General Public License as published by the Free |
---|
| 86 | Software Foundation, either version 3 of the License, or (at your option) |
---|
| 87 | any later version. |
---|
| 88 | .IP |
---|
| 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/>. |
---|