root / pykota / trunk / man / pkturnkey.1 @ 3162

.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
.TH PKTURNKEY "1" "December 2006" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
.SH NAME
pkturnkey \- manual page for pkturnkey 1.25_unofficial
.SH DESCRIPTION
pkturnkey v1.25_unofficial (c) 2003, 2004, 2005, 2006, 2007 Jerome Alet \- alet@librelogiciel.com
.PP
A turn key tool for PyKota. When launched, this command will initialize
PyKota's database with all existing print queues and some or all users.
For now, no prices or limits are set, so printing is fully accounted
for, but not limited. That's why you'll probably want to also use
edpykota once the database has been initialized.
.PP
command line usage :
.IP
pkturnkey [options] [printqueues names]
.PP
options :
.TP
\fB\-v\fR | \fB\-\-version\fR
Prints pkturnkey version number then exits.
.TP
\fB\-h\fR | \fB\-\-help\fR
Prints this message then exits.
.TP
\fB\-c\fR | \fB\-\-doconf\fR
Give hints about what to put into pykota.conf
.TP
\fB\-d\fR | \fB\-\-dousers\fR
Manages users accounts as well.
.TP
\fB\-D\fR | \fB\-\-dogroups\fR
Manages users groups as well.
Implies \fB\-d\fR | \fB\-\-dousers\fR.
.TP
\fB\-e\fR | \fB\-\-emptygroups\fR
Includes empty groups.
.TP
\fB\-f\fR | \fB\-\-force\fR
Modifies the database instead of printing what
it would do.
.TP
\fB\-u\fR | \fB\-\-uidmin\fR uid
Only adds users whose uid is greater than or equal to
uid. You can pass an username there as well, and its
uid will be used automatically.
If not set, 0 will be used automatically.
Implies \fB\-d\fR | \fB\-\-dousers\fR.
.TP
\fB\-U\fR | \fB\-\-uidmax\fR uid
Only adds users whose uid is lesser than or equal to
uid. You can pass an username there as well, and its
uid will be used automatically.
If not set, a large value will be used automatically.
Implies \fB\-d\fR | \fB\-\-dousers\fR.
.TP
\fB\-g\fR | \fB\-\-gidmin\fR gid
Only adds groups whose gid is greater than or equal to
gid. You can pass a groupname there as well, and its
gid will be used automatically.
If not set, 0 will be used automatically.
Implies \fB\-D\fR | \fB\-\-dogroups\fR.
.TP
\fB\-G\fR | \fB\-\-gidmax\fR gid
Only adds groups whose gid is lesser than or equal to
gid. You can pass a groupname there as well, and its
gid will be used automatically.
If not set, a large value will be used automatically.
Implies \fB\-D\fR | \fB\-\-dogroups\fR.
.PP
examples :
.IP
\f(CW$ pkturnkey --dousers --uidmin jerome\fR
.IP
Will simulate the initialization of PyKota's database will all existing
printers and print accounts for all users whose uid is greater than
or equal to jerome's one. Won't manage any users group.
.IP
To REALLY initialize the database instead of simulating it, please
use the \fB\-f\fR | \fB\-\-force\fR command line switch.
.IP
You can limit the initialization to only a subset of the existing
printers, by passing their names at the end of the command line.
.PP
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
.PP
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
.PP
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301, USA.
.PP
Please report bugs to : Jerome Alet \- alet@librelogiciel.com