Show
Ignore:
Timestamp:
01/24/09 22:38:46 (15 years ago)
Author:
jerome
Message:

Updated manual pages.

Files:
1 modified

Legend:

Unmodified
Added
Removed

  • pykota/trunk/man/tr/pkturnkey.1

    r3279 r3485  
    11.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36. 
    2 .TH PKTURNKEY "1" "janvier 2008" "C@LL - Conseil Internet & Logiciels Libres" "User Commands" 
     2.TH PKTURNKEY "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands" 
    33.SH NOM 
    4 pkturnkey \- page de manuel de pkturnkey 1.27alpha3_BROKEN_unofficial 
     4pkturnkey \- page de manuel de pkturnkey (PyKota) 1.27alpha7_unofficial 
     5.SH SYNOPSIS 
     6.B pkturnkey 
     7[\fIoptions\fR] \fIprinter1 printer2 \fR... \fIprinterN\fR 
    58.SH DESCRIPTION 
    6 pkturnkey v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com 
    7 .PP 
    89A turn key tool for PyKota. When launched, this command will initialize 
    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 : 
     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:" 
    1566.IP 
    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 : 
     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'. 
    7272.IP 
    73 \f(CW$ pkturnkey \-\-dousers \-\-uidmin jerome\fR 
     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. 
    7476.IP 
    75 Will simulate the initialization of PyKota's database will all existing 
    76 printers and print accounts for all users whose uid is greater than 
    77 or equal to jerome's one. Won't manage any users group. 
     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:" 
    7882.IP 
    79 To REALLY initialize the database instead of simulating it, please 
    80 use the \fB\-f\fR | \fB\-\-force\fR command line switch. 
     83(c) 2003\-2009 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. 
    8188.IP 
    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 
     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/>.