root / pykota / trunk / man / th / pkturnkey.1 @ 3561

Revision 3561, 3.6 kB (checked in by jerome, 11 years ago)

Changed copyright years.

Line 
1.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.41.1.
2.TH PKTURNKEY "1" "janvier 2013" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
3.SH NOM
4pkturnkey \- page de manuel de pkturnkey (PyKota) 1.27alpha14_unofficial
5.SH SYNOPSIS
6.B pkturnkey
7[\fIoptions\fR] \fIprinter1 printer2 \fR... \fIprinterN\fR
8.SH DESCRIPTION
9A turn key tool for PyKota. When launched, this command will initialize
10PyKota's database with all existing print queues and some or all users. For
11now, no prices or limits are set, so printing is fully accounted for, but not
12limited. That's why you'll probably want to also use edpykota once the
13database has been initialized.
14.SH OPTIONS
15.TP
16\fB\-h\fR, \fB\-\-help\fR
17show this help message and exit.
18.TP
19\fB\-v\fR, \fB\-\-version\fR
20show the version number and exit.
21.TP
22\fB\-A\fR ARGUMENTSFILE, \fB\-\-arguments\fR=\fIARGUMENTSFILE\fR
23loads additional options and arguments from a file,
24one per line.
25.TP
26\fB\-c\fR, \fB\-\-doconf\fR
27Try to autodetect the best print accounting settings
28for existing CUPS printers. All printers must be
29switched ON beforehand.
30.TP
31\fB\-d\fR, \fB\-\-dousers\fR
32Create accounts for users, and allocate print quota
33entries for them.
34.TP
35\fB\-D\fR, \fB\-\-dogroups\fR
36Create accounts for users groups, and allocate print
37quota entries for them.
38.TP
39\fB\-e\fR, \fB\-\-emptygroups\fR
40Also include groups which don't have any member.
41.TP
42\fB\-f\fR, \fB\-\-force\fR
43Modifies PyKota's database content for real, instead
44of faking it (for safety reasons).
45.TP
46\fB\-u\fR UIDMIN, \fB\-\-uidmin\fR=\fIUIDMIN\fR
47Only include users whose uid is greater than or equal
48to this parameter. If you pass an username instead,
49his uid will be used automatically.
50.TP
51\fB\-U\fR UIDMAX, \fB\-\-uidmax\fR=\fIUIDMAX\fR
52Only include users whose uid is lesser than or equal
53to this parameter. If you pass an username instead,
54his uid will be used automatically.
55.TP
56\fB\-g\fR GIDMIN, \fB\-\-gidmin\fR=\fIGIDMIN\fR
57Only include users groups whose gid is greater than or
58equal to this parameter. If you pass a groupname
59instead, its gid will be used automatically.
60.TP
61\fB\-G\fR GIDMAX, \fB\-\-gidmax\fR=\fIGIDMAX\fR
62Only include users groups whose gid is lesser than or
63equal to this parameter. If you pass a groupname
64instead, its gid will be used automatically.
65.SS "examples:"
66.IP
67pkturnkey \fB\-\-dousers\fR \fB\-\-uidmin\fR jerome HPLASER1 HPLASER2
68Would simulate the creation in PyKota's database of the printing accounts
69for all users whose uid is greater than or equal to 'jerome''s. Each of
70them would be given a print quota entry on printers 'HPLASER1' and
71\&'HPLASER2'.
72.IP
73pkturnkey \fB\-\-force\fR \fB\-\-dousers\fR \fB\-\-uidmin\fR jerome HPLASER1 HPLASER2
74Would do the same as the example above, but for real. Please take great
75care when using the \fB\-\-force\fR command line option.
76.IP
77pkturnkey \fB\-\-doconf\fR
78Would try to automatically detect the best print accounting settings for
79all active printers, and generate some lines for you to add into your
80pykota.conf
81.SS "licensing terms:"
82.IP
83(c) 2003\-2013 Jerome Alet \- alet@librelogiciel.com
84This program is free software: you can redistribute it and/or modify it
85under the terms of the GNU General Public License as published by the Free
86Software Foundation, either version 3 of the License, or (at your option)
87any later version.
88.IP
89This program is distributed in the hope that it will be useful, but
90WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
91or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
92for more details.
93.IP
94You should have received a copy of the GNU General Public License along
95with this program.  If not, see <http://www.gnu.org/licenses/>.
Note: See TracBrowser for help on using the browser.