Changeset 3485 for pykota/trunk/man/de
- Timestamp:
- 01/24/09 22:38:46 (15 years ago)
- Location:
- pykota/trunk/man/de
- Files:
-
- 15 modified
Legend:
- Unmodified
- Added
- Removed
-
pykota/trunk/man/de/autopykota.1
r3279 r3485 1 1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. 2 .TH AUTOPYKOTA "1" "janvier 200 8" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"2 .TH AUTOPYKOTA "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands" 3 3 .SH NOM 4 autopykota \- page de manuel de autopykota 1.27alpha3_BROKEN_unofficial 4 autopykota \- page de manuel de autopykota (PyKota) 1.27alpha7_unofficial 5 .SH SYNOPSIS 6 .B autopykota 7 \fI{ -i | \-\-initbalance value } \fR[\fIoptions\fR] 5 8 .SH DESCRIPTION 6 autopykota v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com 7 .PP 8 A tool to automate user account creation and initial balance setting. 9 .PP 10 THIS TOOL MUST NOT BE USED IF YOU WANT TO LIMIT YOUR USERS BY PAGE QUOTA ! 11 .PP 12 command line usage : 9 A tool to automate user account creation and initial balance setting. THIS 10 TOOL MUST NOT BE USED FROM THE COMMAND LINE BUT ONLY AS PART OF AN external 11 policy IN pykota.conf, AND MUST NOT BE USED IF YOU WANT TO LIMIT YOUR USERS BY 12 PAGE QUOTA ! 13 .SH OPTIONS 14 .TP 15 \fB\-h\fR, \fB\-\-help\fR 16 show this help message and exit. 17 .TP 18 \fB\-v\fR, \fB\-\-version\fR 19 show the version number and exit. 20 .TP 21 \fB\-A\fR ARGUMENTSFILE, \fB\-\-arguments\fR=\fIARGUMENTSFILE\fR 22 loads additional options and arguments from a file, 23 one per line. 24 .TP 25 \fB\-i\fR INITBALANCE, \fB\-\-initbalance\fR=\fIINITBALANCE\fR 26 Set the user's initial account balance value. If the 27 user already exists, actual balance is left unchanged. 28 If unset, the default value is 0.0. 29 .TP 30 \fB\-e\fR EMAIL, \fB\-\-email\fR=\fIEMAIL\fR 31 Set the user's email address. 32 .SS "examples:" 13 33 .IP 14 THIS TOOL MUST NOT BE USED FROM THE COMMAND LINE BUT ONLY AS PART 15 OF AN external policy IN pykota.conf 34 autopykota \fB\-\-email=\fR"@example.com" \fB\-\-initbalance\fR=\fI10\fR.0 35 This would set the current user's email address to 36 $PYKOTAUSERNAME@example.com, and would set the initial value of his 37 account balance to 10.0 credits. 38 .SS "licensing terms:" 16 39 .IP 17 autopykota { \fB\-i\fR | \fB\-\-initbalance\fR value } 18 .PP 19 options : 20 .TP 21 \fB\-v\fR | \fB\-\-version\fR 22 Prints autopykota's version number then exits. 23 .TP 24 \fB\-h\fR | \fB\-\-help\fR 25 Prints this message then exits. 26 .TP 27 \fB\-i\fR | \fB\-\-initbalance\fR b Sets the user's account initial balance value to b. 28 If the user already exists, actual balance is left 29 unmodified. If unset, the default value is 0. 30 .TP 31 \fB\-e\fR | \fB\-\-email\fR addr 32 Sets the user's e\-mail address. 33 .PP 34 (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet <alet@librelogiciel.com> 35 This program is free software: you can redistribute it and/or modify 36 it under the terms of the GNU General Public License as published by 37 the Free Software Foundation, either version 3 of the License, or 38 (at your option) any later version. 39 .PP 40 This program is distributed in the hope that it will be useful, 41 but WITHOUT ANY WARRANTY; without even the implied warranty of 42 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 43 GNU General Public License for more details. 44 .PP 45 You should have received a copy of the GNU General Public License 46 along with this program. If not, see <http://www.gnu.org/licenses/>. 47 .PP 48 Please report bugs to : Jerome Alet \- alet@librelogiciel.com 40 (c) 2003\-2009 Jerome Alet \- alet@librelogiciel.com 41 This program is free software: you can redistribute it and/or modify it 42 under the terms of the GNU General Public License as published by the Free 43 Software Foundation, either version 3 of the License, or (at your option) 44 any later version. 45 .IP 46 This program is distributed in the hope that it will be useful, but 47 WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 48 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 49 for more details. 50 .IP 51 You should have received a copy of the GNU General Public License along 52 with this program. If not, see <http://www.gnu.org/licenses/>. -
pykota/trunk/man/de/dumpykota.1
r3279 r3485 1 1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. 2 .TH DUMPYKOTA "1" "janvier 200 8" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"2 .TH DUMPYKOTA "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands" 3 3 .SH NOM 4 dumpykota \- page de manuel de dumpykota 1.27alpha3_BROKEN_unofficial 4 dumpykota \- page de manuel de dumpykota (PyKota) 1.27alpha7_unofficial 5 .SH SYNOPSIS 6 .B dumpykota 7 [\fIoptions\fR] [\fIfilterexpr\fR] 5 8 .SH DESCRIPTION 6 dumpykota v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com 7 .PP 8 Dumps PyKota database's content. 9 .PP 10 command line usage : 9 Data Dumper for PyKota. 10 .SH OPTIONS 11 .TP 12 \fB\-h\fR, \fB\-\-help\fR 13 show this help message and exit. 14 .TP 15 \fB\-v\fR, \fB\-\-version\fR 16 show the version number and exit. 17 .TP 18 \fB\-A\fR ARGUMENTSFILE, \fB\-\-arguments\fR=\fIARGUMENTSFILE\fR 19 loads additional options and arguments from a file, 20 one per line. 21 .TP 22 \fB\-d\fR DATA, \fB\-\-data\fR=\fIDATA\fR 23 Select the type of datas to dump. This option is 24 mandatory. Supported data types are : history, 25 payments, billingcodes, users, groups, printers, 26 upquotas, gpquotas, umembers, pmembers, and all. The 27 \&'all' value forces the output format to XML. 28 .TP 29 \fB\-f\fR FORMAT, \fB\-\-format\fR=\fIFORMAT\fR 30 Select the output format, the default being comma 31 separated values. Supported formats are : csv, ssv, 32 tsv, xml and cups. The 'cups' output format only works 33 when dumping the history, and produces CUPS' page_log 34 compatible output. 35 .TP 36 \fB\-o\fR OUTPUT, \fB\-\-output\fR=\fIOUTPUT\fR 37 The name of the file the data dump will be written to. 38 The default value is '\-', which tells dumpykota to 39 write the dump to stdout. 40 .TP 41 \fB\-O\fR ORDERBY, \fB\-\-orderby\fR=\fIORDERBY\fR 42 Change the ordering of the output based on a comma 43 separated list of ordering statements. For example 44 \&'\-username,+printername' would sort the output by 45 descending order of user names and ascending order of 46 printer names. Not all expressions are supported, and 47 you should not use this if you don't know the internal 48 structure of PyKota's database. 49 .TP 50 \fB\-s\fR, \fB\-\-sum\fR 51 Summarize the output. Only available when dumping the 52 printing history or the payments. 53 .SS "filtering expressions:" 11 54 .IP 12 dumpykota [options] [filterexpr] 13 .PP 14 options : 15 .TP 16 \fB\-v\fR | \fB\-\-version\fR 17 Prints dumpykota's version number then exits. 18 .TP 19 \fB\-h\fR | \fB\-\-help\fR 20 Prints this message then exits. 21 .TP 22 \fB\-d\fR | \fB\-\-data\fR type 23 Dumps 'type' datas. Allowed types are : 55 Use the filtering expressions to extract only parts of the datas. Allowed 56 filters are of the form 'key=value'. Wildcards are not expanded as part of 57 these filtering expressions, so you can't use them here. 24 58 .IP 25 \- history : dumps the jobs history. 26 \- users : dumps users. 27 \- groups : dumps user groups. 28 \- printers : dump printers. 29 \- upquotas : dump user quotas. 30 \- gpquotas : dump user groups quotas. 31 \- payments : dumps user payments. 32 \- pmembers : dumps printer groups members. 33 \- umembers : dumps user groups members. 34 \- billingcodes : dumps billing codes. 35 \- all : dumps all PyKota datas. The output format 59 allowed keys for now: 36 60 .IP 37 is always XML in this case. 61 username : User's name 62 groupname : Users group's name 63 printername : Printer's name 64 pgroupname : Printers group's name 65 hostname : Host's name 66 jobid : Job's id 67 billingcode : Job's billing code 68 start : Job's date of printing 69 end : Job's date of printing 38 70 .IP 39 NB : the \fB\-d\fR | \fB\-\-data\fR command line option 40 is MANDATORY. 41 .TP 42 \fB\-f\fR | \fB\-\-format\fR fmt 43 Dumps datas in the 'fmt' format. When not specified, 44 the format is to dump datas in the csv format (comma 45 separated values). All data dumped is between double 46 quotes. Allowed formats are : 47 .IP 48 \- csv : separate datas with commas 49 \- ssv : separate datas with semicolons 50 \- tsv : separate datas with tabs 51 \- xml : dump data as XML 52 \- cups : dump datas in CUPS' page_log format : 53 .IP 54 ONLY AVAILABLE WITH \fB\-\-data\fR history 55 .TP 56 \fB\-o\fR | \fB\-\-output\fR fname 57 All datas will be dumped to the file instead of 58 to the standard output. The special '\-' filename 59 is the default value and means stdout. 60 WARNING : existing files are truncated ! 61 .TP 62 \fB\-O\fR | \fB\-\-orderby\fR exp 63 Change the ordering or result. 'exp' is a comma 64 separated list of ordering statements, for example 65 \&'\-\-orderby +username,\-printername'. Not all expression 66 values are meaningful, so using this command line 67 switch is not recommanded if you don't know the 68 exact layout of PyKota's database schema. 69 .TP 70 \fB\-s\fR | \fB\-\-sum\fR 71 Summarize the selected datas. 72 ONLY AVAILABLE WITH \fB\-\-data\fR history or payments 73 .IP 74 Use the filter expressions to extract only parts of the 75 datas. Allowed filters are of the form : 76 .IP 77 key=value 78 .IP 79 Allowed keys for now are : 80 .TP 81 username 82 User's name 83 .TP 84 groupname 85 Users group's name 86 .TP 87 printername 88 Printer's name 89 .TP 90 pgroupname 91 Printers group's name 92 .TP 93 hostname 94 Client's hostname 95 .TP 96 jobid 97 Job's Id 98 .TP 99 billingcode 100 Job's billing code 101 .TP 102 start 103 Job's date of printing 104 .TP 105 end 106 Job's date of printing 107 .IP 108 Dates formatting with 'start' and 'end' filter keys : 71 formatting of dates with the 'start' and 'end' filtering keys: 109 72 .IP 110 73 YYYY : year boundaries … … 114 77 YYYYMMDDhhmm : minute boundaries 115 78 YYYYMMDDhhmmss : second boundaries 116 yesterday[+\-N bDays] : yesterday more or less N days (e.g. : yesterday\-15)117 today[+\-N bDays] : today more or less N days (e.g. : today\-15)118 tomorrow[+\-N bDays] : tomorrow more or less N days (e.g. : tomorrow\-15)119 now[+\-N bDays] : now more or less N days (e.g. now\-15)79 yesterday[+\-N] : yesterday more or less N days (e.g. : yesterday\-15) 80 today[+\-N] : today more or less N days (e.g. : today\-15) 81 tomorrow[+\-N] : tomorrow more or less N days (e.g. : tomorrow\-15) 82 now[+\-N] : now more or less N days (e.g. now\-15) 120 83 .IP 121 \&'now' and 'today' are not exactly the same since today represents the first 122 or last second of the day depending on if it's used in a start= or end= 123 date expression. The utility to be able to specify dates in the future is 124 a question which remains to be answered :\-) 84 \&'now' and 'today' are not exactly the same since 'today' represents the 85 first or last second of the day depending on if it's used in a 'start=' or 86 \&'end=' date expression. 125 87 .IP 126 Contrary to other PyKota management tools, wildcard characters are not 127 expanded, so you can't use them. 88 examples: 128 89 .IP 129 NB : not all keys are allowed for each data type, so the result may be 130 empty if you use a key not available for a particular data type. 131 .PP 132 Examples : 90 dumpykota \fB\-\-unit\fR EURO \fB\-\-output\fR /tmp/invoices.pdf start=now\-30 91 This would generate a PDF document containing invoices for all users 92 who have spent some credits last month. Amounts would be in EURO and 93 not VAT information would be included. 133 94 .IP 134 \f(CW$ dumpykota \-\-data history \-\-format csv >myfile.csv\fR 95 dumpykota \fB\-\-data\fR history \fB\-\-format\fR csv >myfile.csv 96 This would dump the whole printing history to stdout in the CSV 97 format, and redirect the output to a file. 135 98 .IP 136 This dumps the history in a comma separated values file, for possible 137 use in a spreadsheet.99 dumpykota \fB\-\-data\fR users \fB\-\-format\fR xml \fB\-o\fR users.xml 100 This would dump all users into the 'users.xml' file in the XML format. 138 101 .IP 139 \f(CW$ dumpykota \-\-data users \-\-format xml -o users.xml\fR 102 dumpykota \fB\-\-data\fR history printername=HP2100 username=jerome 103 This would dump jerome's printing history on printer HP2100. 140 104 .IP 141 Dumps all users datas to the users.xml file. 105 dumpykota \fB\-\-data\fR history start=200503 end=20050730234615 106 This would dump all jobs printer between March 1st 2008 at midnight 107 and July 30th 2008 at 23 hours 46 minutes and 15 seconds, included. 142 108 .IP 143 \f(CW$ dumpykota \-\-data history printername=HP2100 username=jerome\fR 109 licensing terms: 144 110 .IP 145 Dumps the job history for user jerome on printer HP2100 only. 146 .IP 147 \f(CW$ dumpykota \-\-data history start=200503 end=20050730234615\fR 148 .IP 149 Dumps all jobs printed between March 1st 2005 at midnight and 150 July 30th 2005 at 23 hours 46 minutes and 15 secondes included. 151 .PP 152 (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet <alet@librelogiciel.com> 111 (c) 2003\-2009 Jerome Alet \- alet@librelogiciel.com 153 112 This program is free software: you can redistribute it and/or modify 154 113 it under the terms of the GNU General Public License as published by 155 the Free Software Foundation, either version 3 of the License, or 156 (atyour option) any later version.157 . PP158 This program is distributed in the hope that it will be useful, 159 butWITHOUT ANY WARRANTY; without even the implied warranty of160 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 161 G NU General Public License for more details.162 . PP114 the Free Software Foundation, either version 3 of the License, or (at 115 your option) any later version. 116 .IP 117 This program is distributed in the hope that it will be useful, but 118 WITHOUT ANY WARRANTY; without even the implied warranty of 119 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 120 General Public License for more details. 121 .IP 163 122 You should have received a copy of the GNU General Public License 164 123 along with this program. If not, see <http://www.gnu.org/licenses/>. 165 .PP166 Please report bugs to : Jerome Alet \- alet@librelogiciel.com -
pykota/trunk/man/de/edpykota.1
r3279 r3485 1 1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. 2 .TH EDPYKOTA "1" "janvier 200 8" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"2 .TH EDPYKOTA "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands" 3 3 .SH NOM 4 edpykota \- page de manuel de edpykota 1.27alpha3_BROKEN_unofficial 4 edpykota \- page de manuel de edpykota (PyKota) 1.27alpha7_unofficial 5 .SH SYNOPSIS 6 .B edpykota 7 [\fIoptions\fR] [\fIusernames|groupnames\fR] 5 8 .SH DESCRIPTION 6 edpykota v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com 7 .PP 8 A Print Quota editor for PyKota. 9 .PP 10 command line usage : 9 Manages PyKota print quota entries for users or users groups. A print quota 10 entry is related to both an user and a printer, or to both a group and a 11 printer, meaning that for example different users can have different page 12 count limits on the same printer. If an user doesn't have a print quota entry 13 on a particular printer, he won't be allowed to print to it. 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\-a\fR, \fB\-\-add\fR 27 Add new, or modify existing, users or groups print 28 quota entries. 29 .TP 30 \fB\-d\fR, \fB\-\-delete\fR 31 Delete the specified users or groups print quota 32 entries. When deleting users print quota entries, the 33 matching jobs are also deleted from the printing 34 history. 35 .TP 36 \fB\-S\fR SOFTLIMIT, \fB\-\-softlimit\fR=\fISOFTLIMIT\fR 37 Set the soft page count limit for the specified print 38 quota entries. Users can print over this limit for a 39 number of days specified in the 'gracedelay' directive 40 in pykota.conf 41 .TP 42 \fB\-H\fR HARDLIMIT, \fB\-\-hardlimit\fR=\fIHARDLIMIT\fR 43 Set the hard page count limit for the specified print 44 quota entries. Users are never allowed to print over 45 this limit. 46 .TP 47 \fB\-g\fR, \fB\-\-groups\fR 48 Manage groups print quota entries instead of users 49 print quota entries. 50 .TP 51 \fB\-I\fR INCREASE, \fB\-\-increase\fR=\fIINCREASE\fR 52 Increase the existing soft and hard page count limits 53 for the specified print quota entries. You can 54 decrease the values instead by prefixing this 55 parameter with a negative sign. 56 .TP 57 \fB\-L\fR, \fB\-\-list\fR 58 Display detailed informations about the specified 59 users or groups print quota entries. 60 .TP 61 \fB\-n\fR, \fB\-\-noquota\fR 62 Set no limit for both soft and hard page counts for 63 the specified users or groups print quota entries. 64 .TP 65 \fB\-P\fR PRINTER, \fB\-\-printer\fR=\fIPRINTER\fR 66 Specify a comma separated list of printers you want to 67 manage print quota entries on. The default is '*', 68 meaning all printers. 69 .TP 70 \fB\-r\fR, \fB\-\-reset\fR 71 Reset the actual page counter for the specified users 72 print quota entries (doesn't work for groups print 73 quota entries). The life time page counter is left 74 unchanged. 75 .TP 76 \fB\-R\fR, \fB\-\-hardreset\fR 77 Reset the actual and life time page counters for the 78 specified users print quota entries (doesn't work for 79 groups print quota entries). This is a shortcut for 80 \fB\-\-used\fR 0. 81 .TP 82 \fB\-s\fR, \fB\-\-skipexisting\fR 83 If \fB\-\-add\fR is used, ensure that existing users or groups 84 print quota entries won't be modified. 85 .TP 86 \fB\-U\fR USED, \fB\-\-used\fR=\fIUSED\fR 87 Set the values of both the actual and life time page 88 counters for the specified users print quota entries 89 (doesn't work for groups print quota entries). This 90 can be useful when migrating from a different print 91 quota software. The values can also be increased or 92 decreased by prefixing this parameter with either a 93 positive or negative sign. 94 .SS "examples:" 11 95 .IP 12 edpykota [options] user1 user2 ... userN 96 edpykota \fB\-\-add\fR john paul george ringo 97 Would create print quota entries with no page count limits for these four 98 users on all existing printers. 13 99 .IP 14 edpykota [options] group1 group2 ... groupN 15 .PP 16 options : 17 .TP 18 \fB\-v\fR | \fB\-\-version\fR 19 Prints edpykota's version number then exits. 20 .TP 21 \fB\-h\fR | \fB\-\-help\fR 22 Prints this message then exits. 23 .TP 24 \fB\-a\fR | \fB\-\-add\fR 25 Adds users or groups print quota entries if 26 they don't exist in database. 27 .TP 28 \fB\-d\fR | \fB\-\-delete\fR 29 Deletes users or groups print quota entries. 30 Users or groups are never deleted, you have 31 to use the pkusers command to delete them. 32 The history will be purge from all matching 33 jobs, unless \fB\-g\fR | \fB\-\-groups\fR is used. 34 .TP 35 \fB\-P\fR | \fB\-\-printer\fR p 36 Edit quotas on printer p only. Actually p can 37 use wildcards characters to select only 38 some printers. The default value is *, meaning 39 all printers. 40 You can specify several names or wildcards, 41 by separating them with commas. 42 .TP 43 \fB\-g\fR | \fB\-\-groups\fR 44 Edit groups print quota entries instead of 45 users print quota entries. 46 .TP 47 \fB\-L\fR | \fB\-\-list\fR 48 Lists users or groups print quota entries. 49 .TP 50 \fB\-n\fR | \fB\-\-noquota\fR 51 Sets both soft and hard limits to None for users 52 or groups print quota entries. 53 .TP 54 \fB\-r\fR | \fB\-\-reset\fR 55 Resets the actual page counter for the user 56 or group to zero on the specified printers. 57 The life time page counter is kept unchanged. 58 .TP 59 \fB\-R\fR | \fB\-\-hardreset\fR 60 Resets the actual and life time page counters 61 for the user or group to zero on the specified 62 printers. This is a shortcut for '\-\-used 0'. 63 .TP 64 \fB\-s\fR | \fB\-\-skipexisting\fR 65 In combination with the \fB\-\-add\fR option above, tells 66 edpykota to not modify existing print quota entries. 67 .TP 68 \fB\-S\fR | \fB\-\-softlimit\fR sl 69 Sets the quota soft limit to sl pages. 70 .TP 71 \fB\-H\fR | \fB\-\-hardlimit\fR hl 72 Sets the quota hard limit to hl pages. 73 .TP 74 \fB\-I\fR | \fB\-\-increase\fR v 75 Increase existing Soft and Hard limits by the value 76 of v. You can prefix v with + or \-, if no sign is 77 used, + is assumed. 78 .TP 79 \fB\-U\fR | \fB\-\-used\fR u 80 Sets the page counters for the user u pages on 81 the selected printers. Doesn't work for groups, since 82 their page counters are the sum of all their members' 83 page counters. 84 Useful for migrating users from a different system 85 where they have already used some pages. Actual 86 and Life Time page counters may be increased or decreased 87 if u is prefixed with + or \-. 88 WARNING : BOTH page counters are modified in all cases, 89 so be careful. 90 NB : if u equals '0', then the action taken is 91 the same as if \fB\-\-hardreset\fR was used. 100 edpykota \fB\-\-printer\fR HP \fB\-\-softlimit\fR 50 \fB\-\-hardlimit\fR 60 jerome 101 Would allow user 'jerome' to print up to 60 pages on printer 'HP'. This 102 user would be warned when he would have reached 50 pages on this printer. 103 Both the user and printer must have been created previously using the 104 pkusers and pkprinters commands, respectively. 92 105 .IP 93 user1 through userN and group1 through groupN can use wildcards 94 if the \fB\-\-add\fR option is not set. 95 .PP 96 examples : 106 edpykota \fB\-\-groups\fR \fB\-\-softlimit\fR 500 \fB\-\-hardlimit\fR 600 support financial 107 Would set soft and hard page count limits on any printer for groups 108 \&'support' and 'financial'. 97 109 .IP 98 \f(CW$ edpykota \-\-add john paul george ringo\fR 110 edpykota \fB\-\-reset\fR \fB\-\-printer\fR HP jerome "jo*" 111 Would reset the actual page counter for users 'jerome' and all users whose 112 name begins with 'jo' on printer 'HP'. 99 113 .IP 100 This will create print quota entries for users john, paul, george 101 and ringo on all printers. These print quota entries will have no 102 limit set. 114 edpykota \fB\-\-printer\fR HPCOLOR \fB\-\-noquota\fR jerome 115 Would allow this user to print without any page limit on printer 116 \&'HPCOLOR'. Depending on how this user is limited, he may still be subject 117 to being limited by the number of available credits in his account. 103 118 .IP 104 \f(CW$ edpykota \-\-printer lp -S 50 -H 60 jerome\fR 119 edpykota \fB\-\-add\fR \fB\-\-skipexisting\fR 120 Would create a print quota entry for each user on each printer for which 121 none already existed. You'll most likely want to use this command at least 122 once after initial setup. 123 .SS "licensing terms:" 105 124 .IP 106 This will set jerome's print quota on the lp printer to a soft limit 107 of 50 pages, and a hard limit of 60 pages. Both user jerome and 108 printer lp have been previously created with the pkusers and pkprinters 109 commands, respectively. 125 (c) 2003\-2009 Jerome Alet \- alet@librelogiciel.com 126 This program is free software: you can redistribute it and/or modify it 127 under the terms of the GNU General Public License as published by the Free 128 Software Foundation, either version 3 of the License, or (at your option) 129 any later version. 110 130 .IP 111 \f(CW$ edpykota -g -S 500 -H 550 financial support\fR 131 This program is distributed in the hope that it will be useful, but 132 WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 133 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 134 for more details. 112 135 .IP 113 This will set print quota soft limit to 500 pages and hard limit 114 to 550 pages for groups financial and support on all printers. 115 .IP 116 \f(CW$ edpykota \-\-reset jerome "jo*"\fR 117 .IP 118 This will reset jerome's page counter to zero on all printers, as 119 well as every user whose name begins with 'jo'. 120 Their life time page counter on each printer will be kept unchanged. 121 You can also reset the life time page counters by using the 122 \fB\-\-hardreset\fR | \fB\-R\fR command line option. 123 .IP 124 \f(CW$ edpykota \-\-printer hpcolor \-\-noquota jerome\fR 125 .IP 126 This will tell PyKota to not limit jerome when printing on the 127 hpcolor printer. All his jobs will be allowed on this printer, but 128 accounting of the pages he prints will still be kept. 129 Print Quotas for jerome on other printers are unchanged. 130 .IP 131 \f(CW$ edpykota \-\-delete \-\-printer "HP*,XER*" jerome rachel\fR 132 .IP 133 This will delete users jerome and rachel's print quota 134 entries on all printers which name begin with 'HP' or 135 \&'XER'. The jobs printed by these users on these printers 136 will be deleted from the history. 137 .PP 138 (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet <alet@librelogiciel.com> 139 This program is free software: you can redistribute it and/or modify 140 it under the terms of the GNU General Public License as published by 141 the Free Software Foundation, either version 3 of the License, or 142 (at your option) any later version. 143 .PP 144 This program is distributed in the hope that it will be useful, 145 but WITHOUT ANY WARRANTY; without even the implied warranty of 146 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 147 GNU General Public License for more details. 148 .PP 149 You should have received a copy of the GNU General Public License 150 along with this program. If not, see <http://www.gnu.org/licenses/>. 151 .PP 152 Please report bugs to : Jerome Alet \- alet@librelogiciel.com 136 You should have received a copy of the GNU General Public License along 137 with this program. If not, see <http://www.gnu.org/licenses/>. -
pykota/trunk/man/de/pkbanner.1
r3279 r3485 1 1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. 2 .TH PKBANNER "1" "janvier 200 8" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"2 .TH PKBANNER "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands" 3 3 .SH NOM 4 pkbanner \- page de manuel de pkbanner 1.27alpha3_BROKEN_unofficial 4 pkbanner \- page de manuel de pkbanner (PyKota) 1.27alpha7_unofficial 5 .SH SYNOPSIS 6 .B pkbanner 7 [\fIoptions\fR] 5 8 .SH DESCRIPTION 6 pkbanner v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com 7 .PP 8 Generates banners. 9 .PP 10 command line usage : 9 Banner generator for PyKota. 10 .SH OPTIONS 11 11 .TP 12 pkbanner 13 [options] [more info] 14 .PP 15 options : 12 \fB\-h\fR, \fB\-\-help\fR 13 show this help message and exit. 16 14 .TP 17 \fB\-v\fR |\fB\-\-version\fR18 Prints pkbanner's version number then exits.15 \fB\-v\fR, \fB\-\-version\fR 16 show the version number and exit. 19 17 .TP 20 \fB\-h\fR | \fB\-\-help\fR 21 Prints this message then exits. 18 \fB\-A\fR ARGUMENTSFILE, \fB\-\-arguments\fR=\fIARGUMENTSFILE\fR 19 loads additional options and arguments from a file, 20 one per line. 22 21 .TP 23 \fB\-l\fR | \fB\-\-logo\fR img24 Use the image as the banner's logo. The logo will 25 be drawn at the center top of the page. The default 26 logo is /usr/share/pykota/logos/pykota.jpeg 22 \fB\-l\fR LOGO, \fB\-\-logo\fR=\fILOGO\fR 23 The image to use as a logo. The logo will be drawn at 24 the center top of the page. The default logo is 25 /usr/share/pykota/logos/pykota.jpeg. 27 26 .TP 28 \fB\-p\fR | \fB\-\-pagesize\fR sz29 Set s sz as the page size. Most well known30 page sizes are recognized, like 'A4' or 'Letter' 31 to name a few. The defaultsize is A4.27 \fB\-p\fR PAGESIZE, \fB\-\-pagesize\fR=\fIPAGESIZE\fR 28 Set the size of the page. Most well known page sizes 29 are recognized, like 'A4' or 'Letter' to name a few. 30 The default page size is A4. 32 31 .TP 33 \fB\-s\fR | \fB\-\-savetoner\fR s34 Set s the text luminosity factor to s%. This can be35 used to save toner. The default value is 0 , which32 \fB\-s\fR SAVETONER, \fB\-\-savetoner\fR=\fISAVETONER\fR 33 Set the text luminosity to this percent. This can be 34 used to save toner. The default value is 0.0, which 36 35 means that no toner saving will be done. 37 36 .TP 38 \fB\-u\fR | \fB\-\-url\fR u 39 Uses u as an url to be written at the bottom of 40 the banner page. The default url is : 41 http://www.pykota.com/ 42 .PP 43 examples : 37 \fB\-u\fR URL, \fB\-\-url\fR=\fIURL\fR 38 Set the url to write at the bottom of the banner page. 39 The default url is http://www.pykota.com. 40 .SS "examples:" 44 41 .IP 45 Using pkbanner directly from the command line is not recommended, 46 excepted for testing purposes. You should use pkbanner in the 47 \&'startingbanner' or 'endingbanner' directives in pykota.conf 42 pkbanner \fB\-\-logo=\fR"" \fB\-\-savetoner\fR=\fI75\fR 43 This would generate a banner in the default page size, with no logo, and 44 text luminosity would be increased by 75%. 45 .SS "licensing terms:" 48 46 .IP 49 startingbanner: /usr/bin/pkbanner \fB\-\-logo=\fR"" \fB\-\-savetoner\fR=\fI75\fR 47 (c) 2003\-2009 Jerome Alet \- alet@librelogiciel.com 48 This program is free software: you can redistribute it and/or modify it 49 under the terms of the GNU General Public License as published by the Free 50 Software Foundation, either version 3 of the License, or (at your option) 51 any later version. 50 52 .IP 51 With such a setting in pykota.conf, all print jobs will be 52 prefixed with an A4 banner with no logo, and text luminosity will 53 be increased by 75%. The PostScript output will be directly sent 54 to your printer.53 This program is distributed in the hope that it will be useful, but 54 WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 55 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 56 for more details. 55 57 .IP 56 You'll find more examples in the sample configuration file included 57 in PyKota. 58 .PP 59 (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet <alet@librelogiciel.com> 60 This program is free software: you can redistribute it and/or modify 61 it under the terms of the GNU General Public License as published by 62 the Free Software Foundation, either version 3 of the License, or 63 (at your option) any later version. 64 .PP 65 This program is distributed in the hope that it will be useful, 66 but WITHOUT ANY WARRANTY; without even the implied warranty of 67 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 68 GNU General Public License for more details. 69 .PP 70 You should have received a copy of the GNU General Public License 71 along with this program. If not, see <http://www.gnu.org/licenses/>. 72 .PP 73 Please report bugs to : Jerome Alet \- alet@librelogiciel.com 58 You should have received a copy of the GNU General Public License along 59 with this program. If not, see <http://www.gnu.org/licenses/>. -
pykota/trunk/man/de/pkbcodes.1
r3279 r3485 1 1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. 2 .TH PKBCODES "1" "janvier 200 8" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"2 .TH PKBCODES "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands" 3 3 .SH NOM 4 pkbcodes \- page de manuel de pkbcodes 1.27alpha3_BROKEN_unofficial 4 pkbcodes \- page de manuel de pkbcodes (PyKota) 1.27alpha7_unofficial 5 .SH SYNOPSIS 6 .B pkbcodes 7 [\fIoptions\fR] \fIcode1 code2 \fR... \fIcodeN\fR 5 8 .SH DESCRIPTION 6 pkbcodes v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com 7 .PP 8 A billing codes Manager for PyKota. 9 .PP 10 command line usage : 9 A billing codes manager for PyKota. 10 .SH OPTIONS 11 .TP 12 \fB\-h\fR, \fB\-\-help\fR 13 show this help message and exit. 14 .TP 15 \fB\-v\fR, \fB\-\-version\fR 16 show the version number and exit. 17 .TP 18 \fB\-A\fR ARGUMENTSFILE, \fB\-\-arguments\fR=\fIARGUMENTSFILE\fR 19 loads additional options and arguments from a file, 20 one per line. 21 .TP 22 \fB\-a\fR, \fB\-\-add\fR 23 Add new, or modify existing, billing codes. 24 .TP 25 \fB\-d\fR, \fB\-\-delete\fR 26 Deletes billing codes. Matching entries in the 27 printing history are not deleted, on purpose. 28 .TP 29 \fB\-D\fR DESCRIPTION, \fB\-\-description\fR=\fIDESCRIPTION\fR 30 Set a textual description for the specified billing 31 codes. 32 .TP 33 \fB\-l\fR, \fB\-\-list\fR 34 Display detailed informations about the specified 35 billing codes. 36 .TP 37 \fB\-r\fR, \fB\-\-reset\fR 38 Reset the page count and amount spent for the 39 specified billing codes. 40 .TP 41 \fB\-s\fR, \fB\-\-skipexisting\fR 42 If \fB\-\-add\fR is used, ensure that existing billing codes 43 won't be modified. 44 .SS "examples:" 11 45 .IP 12 pkbcodes [options] code1 code2 code3 ... codeN 13 .PP 14 options : 15 .TP 16 \fB\-v\fR | \fB\-\-version\fR 17 Prints pkbcodes version number then exits. 18 .TP 19 \fB\-h\fR | \fB\-\-help\fR 20 Prints this message then exits. 21 .TP 22 \fB\-a\fR | \fB\-\-add\fR 23 Adds billing codes if they don't exist in PyKota's 24 database. If they exist, they are modified 25 unless \fB\-s\fR|\-\-skipexisting is also used. 26 .TP 27 \fB\-d\fR | \fB\-\-delete\fR 28 Deletes billing codes from PyKota's database. 29 NB : the history entries with this billing code 30 are not deleted, voluntarily. 31 .HP 32 \fB\-D\fR | \fB\-\-description\fR d Adds a textual description to billing codes. 33 .TP 34 \fB\-l\fR | \fB\-\-list\fR 35 List informations about the billing codes. 36 .TP 37 \fB\-r\fR | \fB\-\-reset\fR 38 Resets the billing codes' balance and page counters 39 to 0. 40 .TP 41 \fB\-s\fR | \fB\-\-skipexisting\fR 42 In combination with the \fB\-\-add\fR option above, tells 43 pkbcodes to not modify existing billing codes. 46 pkbcodes \fB\-D\fR "Financial Department" financial 47 Would create a billing code labelled 'financial' with the specified 48 textual description. 44 49 .IP 45 code1 through codeN can contain wildcards if the \fB\-\-add\fR option 46 is not set. 47 .PP 48 examples : 50 pkbcodes \fB\-\-delete\fR "fin*" 51 Would delete all billing codes which label begins with 'fin'. Matching 52 jobs in the printing history wouldn't be deleted though. 49 53 .IP 50 \f(CW$ pkbcodes \-\-add -D "My project" myproj\fR 54 pkbcodes \fB\-\-list\fR 55 Would display details about all existing billing codes. 56 .SS "licensing terms:" 51 57 .IP 52 Will create the myproj billing code with "My project" 53 as the description. 58 (c) 2003\-2009 Jerome Alet \- alet@librelogiciel.com 59 This program is free software: you can redistribute it and/or modify it 60 under the terms of the GNU General Public License as published by the Free 61 Software Foundation, either version 3 of the License, or (at your option) 62 any later version. 54 63 .IP 55 \f(CW$ pkbcodes \-\-delete "*"\fR 64 This program is distributed in the hope that it will be useful, but 65 WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 66 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 67 for more details. 56 68 .IP 57 This will completely delete all the billing codes, but without 58 removing any matching job from the history. USE WITH CARE ANYWAY ! 59 .IP 60 \f(CW$ pkbcodes \-\-list "my*"\fR 61 .IP 62 This will list all billing codes which name begins with 'my'. 63 .PP 64 (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet <alet@librelogiciel.com> 65 This program is free software: you can redistribute it and/or modify 66 it under the terms of the GNU General Public License as published by 67 the Free Software Foundation, either version 3 of the License, or 68 (at your option) any later version. 69 .PP 70 This program is distributed in the hope that it will be useful, 71 but WITHOUT ANY WARRANTY; without even the implied warranty of 72 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 73 GNU General Public License for more details. 74 .PP 75 You should have received a copy of the GNU General Public License 76 along with this program. If not, see <http://www.gnu.org/licenses/>. 77 .PP 78 Please report bugs to : Jerome Alet \- alet@librelogiciel.com 69 You should have received a copy of the GNU General Public License along 70 with this program. If not, see <http://www.gnu.org/licenses/>. -
pykota/trunk/man/de/pkinvoice.1
r3279 r3485 1 1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. 2 .TH PKINVOICE "1" "janvier 200 8" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"2 .TH PKINVOICE "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands" 3 3 .SH NOM 4 pkinvoice \- page de manuel de pkinvoice 1.27alpha3_BROKEN_unofficial 4 pkinvoice \- page de manuel de pkinvoice (PyKota) 1.27alpha7_unofficial 5 .SH SYNOPSIS 6 .B pkinvoice 7 [\fIoptions\fR] [\fIfilterexpr\fR] 5 8 .SH DESCRIPTION 6 pkinvoice v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com 7 .PP 8 An invoice generator for PyKota. 9 .PP 10 command line usage : 9 Invoice generator for PyKota. 10 .SH OPTIONS 11 .TP 12 \fB\-h\fR, \fB\-\-help\fR 13 show this help message and exit. 14 .TP 15 \fB\-v\fR, \fB\-\-version\fR 16 show the version number and exit. 17 .TP 18 \fB\-A\fR ARGUMENTSFILE, \fB\-\-arguments\fR=\fIARGUMENTSFILE\fR 19 loads additional options and arguments from a file, 20 one per line. 21 .TP 22 \fB\-l\fR LOGO, \fB\-\-logo\fR=\fILOGO\fR 23 The image to use as a logo. The logo will be drawn at 24 the center top of the page. The default logo is 25 /usr/share/pykota/logos/pykota.jpeg. 26 .TP 27 \fB\-p\fR PAGESIZE, \fB\-\-pagesize\fR=\fIPAGESIZE\fR 28 Set the size of the page. Most well known page sizes 29 are recognized, like 'A4' or 'Letter' to name a few. 30 The default page size is A4. 31 .TP 32 \fB\-n\fR NUMBER, \fB\-\-number\fR=\fINUMBER\fR 33 Set the number of the first invoice. This number will 34 automatically be incremented for each invoice. The 35 default value is 1. 36 .TP 37 \fB\-o\fR OUTPUT, \fB\-\-output\fR=\fIOUTPUT\fR 38 The name of the file to which the PDF invoices will be 39 written. If not set or set to '\-', the PDF document 40 will be sent to the standard output. 41 .TP 42 \fB\-u\fR UNIT, \fB\-\-unit\fR=\fIUNIT\fR 43 The name of the unit to use on the invoices. The 44 default value is 'Credits' or its locale translation. 45 .TP 46 \fB\-V\fR VAT, \fB\-\-vat\fR=\fIVAT\fR 47 The value in percent of the applicable VAT to be 48 exposed. The default is 0.0, meaning no VAT. 49 .SS "filtering expressions:" 11 50 .IP 12 pkinvoice [options] [filterexpr] 13 .PP 14 options : 15 .TP 16 \fB\-v\fR | \fB\-\-version\fR 17 Prints pkinvoice's version number then exits. 18 .TP 19 \fB\-h\fR | \fB\-\-help\fR 20 Prints this message then exits. 21 .TP 22 \fB\-l\fR | \fB\-\-logo\fR img 23 Use the image as the invoice's logo. The logo will 24 be drawn at the center top of the page. The default 25 logo is /usr/share/pykota/logos/pykota.jpeg 26 .TP 27 \fB\-p\fR | \fB\-\-pagesize\fR sz 28 Sets sz as the page size. Most well known 29 page sizes are recognized, like 'A4' or 'Letter' 30 to name a few. The default size is A4. 31 .TP 32 \fB\-n\fR | \fB\-\-number\fR N 33 Sets the number of the first invoice. This number 34 will automatically be incremented for each invoice. 35 .TP 36 \fB\-o\fR | \fB\-\-output\fR f.pdf 37 Defines the name of the invoice file which will 38 be generated as a PDF document. If not set or 39 set to '\-', the PDF document is sent to standard 40 output. 41 .TP 42 \fB\-u\fR | \fB\-\-unit\fR u 43 Defines the name of the unit to use on the invoice. 44 The default unit is 'Credits', optionally translated 45 to your native language if it is supported by PyKota. 46 .TP 47 \fB\-V\fR | \fB\-\-vat\fR p 48 Sets the percent value of the applicable VAT to be 49 exposed. The default is 0.0, meaning no VAT 50 information will be included. 51 Use the filtering expressions to extract only parts of the datas. Allowed 52 filters are of the form 'key=value'. Wildcards are not expanded as part of 53 these filtering expressions, so you can't use them here. 51 54 .IP 52 Use the filter expressions to extract only parts of the 53 datas. Allowed filters are of the form : 55 allowed keys for now: 54 56 .IP 55 key=value 57 username : User's name 58 printername : Printer's name 59 hostname : Host's name 60 jobid : Job's id 61 billingcode : Job's billing code 62 start : Job's date of printing 63 end : Job's date of printing 56 64 .IP 57 Allowed keys for now are : 58 .TP 59 username 60 User's name 61 .TP 62 printername 63 Printer's name 64 .TP 65 hostname 66 Client's hostname 67 .TP 68 jobid 69 Job's Id 70 .TP 71 billingcode 72 Job's billing code 73 .TP 74 start 75 Job's date of printing 76 .TP 77 end 78 Job's date of printing 79 .IP 80 Dates formatting with 'start' and 'end' filter keys : 65 formatting of dates with the 'start' and 'end' filtering keys: 81 66 .IP 82 67 YYYY : year boundaries … … 86 71 YYYYMMDDhhmm : minute boundaries 87 72 YYYYMMDDhhmmss : second boundaries 88 yesterday[+\-N bDays] : yesterday more or less N days (e.g. : yesterday\-15)89 today[+\-N bDays] : today more or less N days (e.g. : today\-15)90 tomorrow[+\-N bDays] : tomorrow more or less N days (e.g. : tomorrow\-15)91 now[+\-N bDays] : now more or less N days (e.g. now\-15)73 yesterday[+\-N] : yesterday more or less N days (e.g. : yesterday\-15) 74 today[+\-N] : today more or less N days (e.g. : today\-15) 75 tomorrow[+\-N] : tomorrow more or less N days (e.g. : tomorrow\-15) 76 now[+\-N] : now more or less N days (e.g. now\-15) 92 77 .IP 93 \&'now' and 'today' are not exactly the same since today represents the first 94 or last second of the day depending on if it's used in a start= or end= 95 date expression. The utility to be able to specify dates in the future is 96 a question which remains to be answered :\-) 78 \&'now' and 'today' are not exactly the same since 'today' represents the 79 first or last second of the day depending on if it's used in a 'start=' or 80 \&'end=' date expression. 97 81 .IP 98 Contrary to other PyKota management tools, wildcard characters are not 99 expanded, so you can't use them. 100 .PP 101 examples : 82 examples: 102 83 .IP 103 \f(CW$ pkinvoice \-\-unit EURO \-\-output /tmp/invoices.pdf start=now-30\fR 84 pkinvoice \fB\-\-unit\fR EURO \fB\-\-output\fR /tmp/invoices.pdf start=now\-30 85 This would generate a PDF document containing invoices for all users 86 who have spent some credits last month. Amounts would be in EURO and 87 not VAT information would be included. 104 88 .IP 105 Will generate a PDF document containing invoices for all users 106 who have spent some credits last month. Invoices will be done in 107 EURO. No VAT information will be included. 108 .PP 109 (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet <alet@librelogiciel.com> 89 licensing terms: 90 .IP 91 (c) 2003\-2009 Jerome Alet \- alet@librelogiciel.com 110 92 This program is free software: you can redistribute it and/or modify 111 93 it under the terms of the GNU General Public License as published by 112 the Free Software Foundation, either version 3 of the License, or 113 (atyour option) any later version.114 . PP115 This program is distributed in the hope that it will be useful, 116 butWITHOUT ANY WARRANTY; without even the implied warranty of117 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 118 G NU General Public License for more details.119 . PP94 the Free Software Foundation, either version 3 of the License, or (at 95 your option) any later version. 96 .IP 97 This program is distributed in the hope that it will be useful, but 98 WITHOUT ANY WARRANTY; without even the implied warranty of 99 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 100 General Public License for more details. 101 .IP 120 102 You should have received a copy of the GNU General Public License 121 103 along with this program. If not, see <http://www.gnu.org/licenses/>. 122 .PP123 Please report bugs to : Jerome Alet \- alet@librelogiciel.com -
pykota/trunk/man/de/pkprinters.1
r3279 r3485 1 1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. 2 .TH PKPRINTERS "1" "janvier 200 8" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"2 .TH PKPRINTERS "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands" 3 3 .SH NOM 4 pkprinters \- page de manuel de pkprinters 1.27alpha3_BROKEN_unofficial 4 pkprinters \- page de manuel de pkprinters (PyKota) 1.27alpha7_unofficial 5 .SH SYNOPSIS 6 .B pkprinters 7 [\fIoptions\fR] \fIprinter1 printer2 \fR... \fIprinterN\fR 5 8 .SH DESCRIPTION 6 pkprinters v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com 7 .PP 8 A Printers Manager for PyKota. 9 .PP 10 command line usage : 9 Manages PyKota printers. 10 .SH OPTIONS 11 .TP 12 \fB\-h\fR, \fB\-\-help\fR 13 show this help message and exit. 14 .TP 15 \fB\-v\fR, \fB\-\-version\fR 16 show the version number and exit. 17 .TP 18 \fB\-A\fR ARGUMENTSFILE, \fB\-\-arguments\fR=\fIARGUMENTSFILE\fR 19 loads additional options and arguments from a file, 20 one per line. 21 .TP 22 \fB\-a\fR, \fB\-\-add\fR 23 Add new, or modify existing, printers. 24 .TP 25 \fB\-c\fR CHARGE, \fB\-\-charge\fR=\fICHARGE\fR 26 Set the cost per page, and optionally per job, for 27 printing to the specified printers. If both are to be 28 set, separate them with a comma. Floating point and 29 negative values are allowed. 30 .TP 31 \fB\-C\fR, \fB\-\-cups\fR 32 Tell CUPS to either start or stop managing the 33 specified printers with PyKota. 34 .TP 35 \fB\-d\fR, \fB\-\-delete\fR 36 Delete the specified printers. Also purge the print 37 quota entries and printing history matching the 38 specified printers. 39 .TP 40 \fB\-D\fR DESCRIPTION, \fB\-\-description\fR=\fIDESCRIPTION\fR 41 Set a textual description for the specified printers. 42 .TP 43 \fB\-g\fR GROUPS, \fB\-\-groups\fR=\fIGROUPS\fR 44 If the \fB\-\-remove\fR option is not used, the default action 45 is to add the specified printers to the specified 46 printers groups. Otherwise they are removed from these 47 groups. The specified printers groups must already 48 exist, and should be created beforehand just like 49 normal printers with this very command. 50 .TP 51 \fB\-l\fR, \fB\-\-list\fR 52 Display detailed informations about the specified 53 printers. 54 .TP 55 \fB\-m\fR MAXJOBSIZE, \fB\-\-maxjobsize\fR=\fIMAXJOBSIZE\fR 56 Set the maximum job size in pages allowed on the 57 specified printers. 58 .TP 59 \fB\-n\fR, \fB\-\-nopassthrough\fR 60 Deactivate passthrough mode for the specified 61 printers. This is the normal mode of operations, in 62 which print jobs are accounted for, and are checked 63 against printing quotas and available credits. 64 .TP 65 \fB\-p\fR, \fB\-\-passthrough\fR 66 Activate passthrough mode for the specified printers. 67 In this mode, jobs sent to these printers are not 68 accounted for. This can be useful for exams during 69 which no user should be charged for his printouts. 70 .TP 71 \fB\-r\fR, \fB\-\-remove\fR 72 When combined with the \fB\-\-groups\fR option, remove 73 printers from the specified printers groups. 74 .TP 75 \fB\-s\fR, \fB\-\-skipexisting\fR 76 If \fB\-\-add\fR is used, ensure that existing printers won't 77 be modified. 78 .SS "examples:" 11 79 .IP 12 pkprinters [options] printer1 printer2 printer3 ... printerN 13 .PP 14 options : 15 .TP 16 \fB\-v\fR | \fB\-\-version\fR 17 Prints pkprinters's version number then exits. 18 .TP 19 \fB\-h\fR | \fB\-\-help\fR 20 Prints this message then exits. 21 .TP 22 \fB\-a\fR | \fB\-\-add\fR 23 Adds printers if they don't exist on the Quota 24 Storage Server. If they exist, they are modified 25 unless \fB\-s\fR|\-\-skipexisting is also used. 26 .TP 27 \fB\-d\fR | \fB\-\-delete\fR 28 Deletes printers from the quota storage. 29 .HP 30 \fB\-D\fR | \fB\-\-description\fR d Adds a textual description to printers. 31 .TP 32 \fB\-C\fR | \fB\-\-cups\fR 33 Also modifies the DeviceURI in CUPS' printers.conf 34 .TP 35 \fB\-c\fR | \fB\-\-charge\fR p[,j] 36 Sets the price per page and per job to charge. 37 Job price is optional. 38 If both are to be set, separate them with a comma. 39 Floating point and negative values are allowed. 40 .TP 41 \fB\-g\fR | \fB\-\-groups\fR pg1[,pg2...] Adds or Remove the printer(s) to the printer 42 groups pg1, pg2, etc... which must already exist. 43 A printer group is just like a normal printer, 44 only that it is usually unknown from the printing 45 system. Create printer groups exactly the same 46 way that you create printers, then add other 47 printers to them with this option. 48 Accounting is done on a printer and on all 49 the printer groups it belongs to, quota checking 50 is done on a printer and on all the printer groups 51 it belongs to. 52 If the \fB\-\-remove\fR option below is not used, the 53 default action is to add printers to the specified 54 printer groups. 55 .TP 56 \fB\-l\fR | \fB\-\-list\fR 57 List informations about the printer(s) and the 58 printers groups it is a member of. 59 .TP 60 \fB\-r\fR | \fB\-\-remove\fR 61 In combination with the \fB\-\-groups\fR option above, 62 remove printers from the specified printers groups. 63 .TP 64 \fB\-s\fR | \fB\-\-skipexisting\fR 65 In combination with the \fB\-\-add\fR option above, tells 66 pkprinters to not modify existing printers. 67 .TP 68 \fB\-m\fR | \fB\-\-maxjobsize\fR s 69 Sets the maximum job size allowed on the printer 70 to s pages. 71 .TP 72 \fB\-p\fR | \fB\-\-passthrough\fR 73 Activate passthrough mode for the printer. In this 74 mode, users are allowed to print without any impact 75 on their quota or account balance. 76 .TP 77 \fB\-n\fR | \fB\-\-nopassthrough\fR Deactivate passthrough mode for the printer. 78 Without \fB\-p\fR or \fB\-n\fR, printers are created in 79 normal mode, i.e. no passthrough. 80 pkprinters \fB\-\-add\fR \fB\-\-cups\fR \fB\-D\fR "HP Printer" \fB\-\-charge\fR 0.05,0.1 hp2100 hp2200 81 Would create three printers named 'hp2100', and 'hp2200' in PyKota's 82 database, while telling CUPS to route all print jobs through PyKota for 83 these printers. Each of them would have 'HP Printer' as its description. 84 Printing to any of them would cost 0.05 credit per page, plus 0.1 credit 85 for each job. 80 86 .IP 81 printer1 through printerN can contain wildcards if the \fB\-\-add\fR option 82 is not set. 83 .PP 84 examples : 87 pkprinters \fB\-\-delete\fR "*" 88 Would delete all existing printers and matching print quota entries and 89 printing history from PyKota's database. USE WITH CARE. 85 90 .IP 86 \f(CW$ pkprinters \-\-add -D "HP Printer" \-\-charge 0.05,0.1 hp2100 hp2200 hp8000\fR 91 pkprinters \fB\-\-groups\fR Laser,HP "hp*" 92 Would add all printers which name begins with 'hp' to the 'Laser' and 'HP' 93 printers groups, which must already exist. 87 94 .IP 88 Will create three printers named hp2100, hp2200 and hp8000. 89 Their price per page will be set at 0.05 unit, and their price 90 per job will be set at 0.1 unit. Units are in your own currency, 91 or whatever you want them to mean. 92 All of their descriptions will be set to the string "HP Printer". 93 If any of these printers already exists, it will also be modified 94 unless the \fB\-s\fR|\-\-skipexisting command line option is also used. 95 pkprinters \fB\-\-groups\fR Lexmark \fB\-\-remove\fR hp2200 96 Would remove printer 'hp2200' from the 'Lexmark' printers group. 97 .SS "licensing terms:" 95 98 .IP 96 \f(CW$ pkprinters \-\-delete "*"\fR 99 (c) 2003\-2009 Jerome Alet \- alet@librelogiciel.com 100 This program is free software: you can redistribute it and/or modify it 101 under the terms of the GNU General Public License as published by the Free 102 Software Foundation, either version 3 of the License, or (at your option) 103 any later version. 97 104 .IP 98 This will completely delete all printers and associated quota information, 99 as well as their job history. USE WITH CARE ! 105 This program is distributed in the hope that it will be useful, but 106 WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 107 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 108 for more details. 100 109 .IP 101 \f(CW$ pkprinters \-\-groups Laser,HP "hp*"\fR 102 .IP 103 This will put all printers which name matches "hp*" into printers groups 104 Laser and HP, which MUST already exist. 105 .IP 106 \f(CW$ pkprinters \-\-groups LexMark \-\-remove hp2200\fR 107 .IP 108 This will remove the hp2200 printer from the LexMark printer group. 109 .PP 110 (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet <alet@librelogiciel.com> 111 This program is free software: you can redistribute it and/or modify 112 it under the terms of the GNU General Public License as published by 113 the Free Software Foundation, either version 3 of the License, or 114 (at your option) any later version. 115 .PP 116 This program is distributed in the hope that it will be useful, 117 but WITHOUT ANY WARRANTY; without even the implied warranty of 118 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 119 GNU General Public License for more details. 120 .PP 121 You should have received a copy of the GNU General Public License 122 along with this program. If not, see <http://www.gnu.org/licenses/>. 123 .PP 124 Please report bugs to : Jerome Alet \- alet@librelogiciel.com 110 You should have received a copy of the GNU General Public License along 111 with this program. If not, see <http://www.gnu.org/licenses/>. -
pykota/trunk/man/de/pkrefund.1
r3279 r3485 1 1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. 2 .TH PKREFUND "1" "janvier 200 8" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"2 .TH PKREFUND "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands" 3 3 .SH NOM 4 pkrefund \- page de manuel de pkrefund 1.27alpha3_BROKEN_unofficial 4 pkrefund \- page de manuel de pkrefund (PyKota) 1.27alpha7_unofficial 5 .SH SYNOPSIS 6 .B pkrefund 7 [\fIoptions\fR] [\fIfilterexpr\fR] 5 8 .SH DESCRIPTION 6 pkrefund v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com 7 .PP 8 Refunds jobs. 9 .PP 10 command line usage : 9 Refunding tool for PyKota. 10 .SH OPTIONS 11 .TP 12 \fB\-h\fR, \fB\-\-help\fR 13 show this help message and exit. 14 .TP 15 \fB\-v\fR, \fB\-\-version\fR 16 show the version number and exit. 17 .TP 18 \fB\-A\fR ARGUMENTSFILE, \fB\-\-arguments\fR=\fIARGUMENTSFILE\fR 19 loads additional options and arguments from a file, 20 one per line. 21 .TP 22 \fB\-f\fR, \fB\-\-force\fR 23 Doesn't ask for confirmation before refunding. Only 24 needed if you specify a filename for the PDF receipts. 25 If you send such receipts to stdout, \fB\-\-force\fR is 26 assumed to be set. 27 .TP 28 \fB\-i\fR INFO, \fB\-\-info\fR=\fIINFO\fR 29 The informations to be prepended to the refunding 30 reason, which can include some of Python's string 31 interpolations to access to certain internal values. 32 If you don't want such information, set this 33 explicitely to an empty string. The default is 34 \&'''Refunded %(nbpages)i pages and %(nbcredits).3f 35 credits by %(effectiveuser)s (%(loginname)s) on 36 %(date)s''' 37 .TP 38 \fB\-l\fR LOGO, \fB\-\-logo\fR=\fILOGO\fR 39 The image to use as a logo. The logo will be drawn at 40 the center top of the page. The default logo is 41 /usr/share/pykota/logos/pykota.jpeg. 42 .TP 43 \fB\-n\fR NUMBER, \fB\-\-number\fR=\fINUMBER\fR 44 Sets the number of the first receipt. This number will 45 automatically be incremented for each receipt. The 46 default value is 1. 47 .TP 48 \fB\-o\fR OUTPUT, \fB\-\-output\fR=\fIOUTPUT\fR 49 The name of the file to which the PDF receipts will be 50 written. If not set or set to '\-', the PDF document 51 will be sent to the standard output, and \fB\-\-force\fR will 52 be assumed to be set. 53 .TP 54 \fB\-p\fR PAGESIZE, \fB\-\-pagesize\fR=\fIPAGESIZE\fR 55 Set the size of the page. Most well known page sizes 56 are recognized, like 'A4' or 'Letter' to name a few. 57 The default page size is A4. 58 .TP 59 \fB\-r\fR REASON, \fB\-\-reason\fR=\fIREASON\fR 60 The reason why there was a refund. 61 .TP 62 \fB\-u\fR UNIT, \fB\-\-unit\fR=\fIUNIT\fR 63 The name of the unit to use on the receipts. The 64 default value is 'Credits' or its locale translation. 65 .SS "filtering expressions:" 11 66 .IP 12 pkrefund [options] [filterexpr] 13 .PP 14 options : 15 .TP 16 \fB\-v\fR | \fB\-\-version\fR 17 Prints pkrefund's version number then exits. 18 .TP 19 \fB\-h\fR | \fB\-\-help\fR 20 Prints this message then exits. 21 .TP 22 \fB\-f\fR | \fB\-\-force\fR 23 Doesn't ask for confirmation before refunding jobs. 24 .TP 25 \fB\-r\fR | \fB\-\-reason\fR txt 26 Sets textual information to explain the refunding. 27 .TP 28 \fB\-l\fR | \fB\-\-logo\fR img 29 Use the image as the receipt's logo. The logo will 30 be drawn at the center top of the page. The default 31 logo is /usr/share/pykota/logos/pykota.jpeg 32 .TP 33 \fB\-p\fR | \fB\-\-pagesize\fR sz 34 Sets sz as the page size. Most well known 35 page sizes are recognized, like 'A4' or 'Letter' 36 to name a few. The default size is A4. 37 .TP 38 \fB\-n\fR | \fB\-\-number\fR N 39 Sets the number of the first receipt. This number 40 will automatically be incremented for each receipt. 41 .TP 42 \fB\-o\fR | \fB\-\-output\fR f.pdf 43 Defines the name of the PDF file which will contain 44 the receipts. If not set, then no PDF file will 45 be created. If set to '\-', then \fB\-\-force\fR is assumed, 46 and the PDF document is sent to standard output. 47 .TP 48 \fB\-u\fR | \fB\-\-unit\fR u 49 Defines the name of the unit to use on the receipts. 50 The default unit is 'Credits', optionally translated 51 to your native language if it is supported by PyKota. 67 Use the filtering expressions to extract only parts of the datas. Allowed 68 filters are of the form 'key=value'. Wildcards are not expanded as part of 69 these filtering expressions, so you can't use them here. 52 70 .IP 53 Use the filter expressions to extract only parts of the 54 datas. Allowed filters are of the form : 71 allowed keys for now: 55 72 .IP 56 key=value 73 username : User's name 74 printername : Printer's name 75 hostname : Host's name 76 jobid : Job's id 77 billingcode : Job's billing code 78 start : Job's date of printing 79 end : Job's date of printing 57 80 .IP 58 Allowed keys for now are : 59 .TP 60 username 61 User's name 62 .TP 63 printername 64 Printer's name 65 .TP 66 hostname 67 Client's hostname 68 .TP 69 jobid 70 Job's Id 71 .TP 72 billingcode 73 Job's billing code 74 .TP 75 start 76 Job's date of printing 77 .TP 78 end 79 Job's date of printing 80 .IP 81 Dates formatting with 'start' and 'end' filter keys : 81 formatting of dates with the 'start' and 'end' filtering keys: 82 82 .IP 83 83 YYYY : year boundaries … … 87 87 YYYYMMDDhhmm : minute boundaries 88 88 YYYYMMDDhhmmss : second boundaries 89 yesterday[+\-N bDays] : yesterday more or less N days (e.g. : yesterday\-15)90 today[+\-N bDays] : today more or less N days (e.g. : today\-15)91 tomorrow[+\-N bDays] : tomorrow more or less N days (e.g. : tomorrow\-15)92 now[+\-N bDays] : now more or less N days (e.g. now\-15)89 yesterday[+\-N] : yesterday more or less N days (e.g. : yesterday\-15) 90 today[+\-N] : today more or less N days (e.g. : today\-15) 91 tomorrow[+\-N] : tomorrow more or less N days (e.g. : tomorrow\-15) 92 now[+\-N] : now more or less N days (e.g. now\-15) 93 93 .IP 94 \&'now' and 'today' are not exactly the same since today represents the first 95 or last second of the day depending on if it's used in a start= or end= 96 date expression. The utility to be able to specify dates in the future is 97 a question which remains to be answered :\-) 94 \&'now' and 'today' are not exactly the same since 'today' represents the 95 first or last second of the day depending on if it's used in a 'start=' or 96 \&'end=' date expression. 98 97 .IP 99 Contrary to other PyKota management tools, wildcard characters are not 100 expanded, so you can't use them. 101 .PP 102 Examples : 98 examples: 103 99 .IP 104 \f(CW$ pkrefund \-\-output /tmp/receipts.pdf jobid=503\fR 100 pkrefund \fB\-\-output\fR /tmp/receipts.pdf jobid=503 101 This would refund all jobs which Id is 503. A confirmation would be 102 asked for each job to refund, and a PDF file named /tmp/receipts.pdf 103 would be created containing printable receipts. BEWARE of job ids 104 rolling over if you reset CUPS' history. 105 105 .IP 106 This will refund all jobs which Id is 503. BEWARE : installing CUPS 107 afresh will reset the first job id at 1, so you probably want to use 108 a more precise filter as explained below. A confirmation will 109 be asked for each job to refund, and a PDF file named /tmp/receipts.pdf 110 will be created which will contain printable receipts. 106 pkrefund \fB\-\-reason\fR "Hardware problem" jobid=503 start=today\-7 107 This would refund all jobs which id is 503 but which would have been 108 printed during the past week. The reason would be marked as being an 109 hardware problem. 111 110 .IP 112 \f(CW$ pkrefund \-\-reason "Hardware problem" jobid=503 start=today-7\fR 111 pkrefund \fB\-\-force\fR username=jerome printername=HP2100 112 This would refund all jobs printed by user jerome on printer HP2100. 113 No confirmation would be asked. 113 114 .IP 114 Refunds all jobs which id is 503 but which were printed during the 115 past week. The reason will be marked as being an hardware problem. 115 pkrefund \fB\-\-force\fR printername=HP2100 start=200602 end=yesterday 116 This would refund all jobs printed on printer HP2100 between February 117 1st 2006 and yesterday. No confirmation would be asked. 116 118 .IP 117 \f(CW$ pkrefund \-\-force username=jerome printername=HP2100\fR 119 licensing terms: 118 120 .IP 119 Refunds all jobs printed by user jerome on printer HP2100. No 120 confirmation will be asked. 121 .IP 122 \f(CW$ pkrefund \-\-force printername=HP2100 start=200602 end=yesterday\fR 123 .IP 124 Refunds all jobs printed on printer HP2100 between February 1st 2006 125 and yesterday. No confirmation will be asked. 126 .PP 127 (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet <alet@librelogiciel.com> 121 (c) 2003\-2009 Jerome Alet \- alet@librelogiciel.com 128 122 This program is free software: you can redistribute it and/or modify 129 123 it under the terms of the GNU General Public License as published by 130 the Free Software Foundation, either version 3 of the License, or 131 (atyour option) any later version.132 . PP133 This program is distributed in the hope that it will be useful, 134 butWITHOUT ANY WARRANTY; without even the implied warranty of135 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 136 G NU General Public License for more details.137 . PP124 the Free Software Foundation, either version 3 of the License, or (at 125 your option) any later version. 126 .IP 127 This program is distributed in the hope that it will be useful, but 128 WITHOUT ANY WARRANTY; without even the implied warranty of 129 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 130 General Public License for more details. 131 .IP 138 132 You should have received a copy of the GNU General Public License 139 133 along with this program. If not, see <http://www.gnu.org/licenses/>. 140 .PP141 Please report bugs to : Jerome Alet \- alet@librelogiciel.com -
pykota/trunk/man/de/pksetup.1
r3279 r3485 1 1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. 2 .TH PKSETUP "1" "janvier 200 8" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"2 .TH PKSETUP "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands" 3 3 .SH NOM 4 4 pksetup \- page de manuel de pksetup 0.1 -
pykota/trunk/man/de/pkturnkey.1
r3279 r3485 1 1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. 2 .TH PKTURNKEY "1" "janvier 200 8" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"2 .TH PKTURNKEY "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands" 3 3 .SH NOM 4 pkturnkey \- page de manuel de pkturnkey 1.27alpha3_BROKEN_unofficial 4 pkturnkey \- page de manuel de pkturnkey (PyKota) 1.27alpha7_unofficial 5 .SH SYNOPSIS 6 .B pkturnkey 7 [\fIoptions\fR] \fIprinter1 printer2 \fR... \fIprinterN\fR 5 8 .SH DESCRIPTION 6 pkturnkey v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com7 .PP8 9 A 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 : 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:" 15 66 .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 : 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'. 72 72 .IP 73 \f(CW$ pkturnkey \-\-dousers \-\-uidmin jerome\fR 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. 74 76 .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. 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:" 78 82 .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 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. 81 88 .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 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/>. -
pykota/trunk/man/de/pkusers.1
r3279 r3485 1 1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. 2 .TH PKUSERS "1" "janvier 200 8" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"2 .TH PKUSERS "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands" 3 3 .SH NOM 4 pkusers \- page de manuel de pkusers 1.27alpha3_BROKEN_unofficial 4 pkusers \- page de manuel de pkusers (PyKota) 1.27alpha7_unofficial 5 .SH SYNOPSIS 6 .B pkusers 7 [\fIoptions\fR] [\fIusernames|groupnames\fR] 5 8 .SH DESCRIPTION 6 pkusers v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com 7 .PP 8 An Users and Groups Manager for PyKota. 9 .PP 10 command line usage : 9 Manages PyKota users or users groups. 10 .SH OPTIONS 11 .TP 12 \fB\-h\fR, \fB\-\-help\fR 13 show this help message and exit. 14 .TP 15 \fB\-v\fR, \fB\-\-version\fR 16 show the version number and exit. 17 .TP 18 \fB\-A\fR ARGUMENTSFILE, \fB\-\-arguments\fR=\fIARGUMENTSFILE\fR 19 loads additional options and arguments from a file, 20 one per line. 21 .TP 22 \fB\-a\fR, \fB\-\-add\fR 23 Add new, or modify existing, users or groups. 24 .TP 25 \fB\-b\fR BALANCE, \fB\-\-balance\fR=\fIBALANCE\fR 26 Set an user's account balance. The value can also be 27 increased or decreased when the value is prefixed with 28 \&'+' or '\-'. Users groups don't have a real account 29 balance, instead the sum of their members' account 30 balances is used. 31 .TP 32 \fB\-C\fR COMMENT, \fB\-\-comment\fR=\fICOMMENT\fR 33 Associate a textual comment with a change in an user's 34 account balance. Only meaningful when \fB\-\-balance\fR is 35 also used. 36 .TP 37 \fB\-d\fR, \fB\-\-delete\fR 38 Delete the specified users or groups. Also purge the 39 print quota entries and printing history matching the 40 specified users or groups. 41 .TP 42 \fB\-D\fR DESCRIPTION, \fB\-\-description\fR=\fIDESCRIPTION\fR 43 Set a textual description for the specified users or 44 groups. 45 .TP 46 \fB\-e\fR EMAIL, \fB\-\-email\fR=\fIEMAIL\fR 47 Set an user's email address. If this parameter begins 48 with '@' then the username is prepended to this 49 parameter to form a valid email address. 50 .TP 51 \fB\-g\fR, \fB\-\-groups\fR 52 Manage users groups instead of users. 53 .TP 54 \fB\-i\fR INGROUPS, \fB\-\-ingroups\fR=\fIINGROUPS\fR 55 Put the specified users into the specified groups. 56 When combined with the \fB\-\-remove\fR option, users are 57 removed from the specified groups instead. 58 .TP 59 \fB\-l\fR LIMITBY, \fB\-\-limitby\fR=\fILIMITBY\fR 60 Set the limiting factor for the specified users or 61 groups. Can be any of 'quota' (limit by number of 62 pages per printer), 'balance' (limit by number of 63 credits), 'noquota' (no limit but accounting done), 64 \&'nochange' (no limit and no accounting), or 'noprint' 65 (printing is denied). The two latter ones are not 66 supported for groups. 67 .TP 68 \fB\-L\fR, \fB\-\-list\fR 69 Display detailed informations about the specified 70 users or groups. 71 .TP 72 \fB\-o\fR OVERCHARGE, \fB\-\-overcharge\fR=\fIOVERCHARGE\fR 73 Set the overcharging factor applied to the specified 74 users when computing the cost of a print job. Any 75 floating point value can be used, allowing you to 76 express your creativity... 77 .TP 78 \fB\-r\fR, \fB\-\-remove\fR 79 When combined with the \fB\-\-ingroups\fR option, remove users 80 from the specified users groups. 81 .TP 82 \fB\-s\fR, \fB\-\-skipexisting\fR 83 If \fB\-\-add\fR is used, ensure that existing users or groups 84 won't be modified. 85 .SS "examples:" 11 86 .IP 12 pkusers [options] user1 user2 user3 ... userN13 .PP 14 or : 87 pkusers \fB\-\-add\fR john paul george ringo/ringo@example.com 88 Would make users 'john', 'paul', 'george' and 'ringo' be known to PyKota. 89 User 'ringo''s email address would be set to 'ringo@example.com'. 15 90 .IP 16 pkusers \fB\-\-groups\fR [options] group1 group2 group3 ... groupN 17 .PP 18 options : 19 .TP 20 \fB\-v\fR | \fB\-\-version\fR 21 Prints pkusers's version number then exits. 22 .TP 23 \fB\-h\fR | \fB\-\-help\fR 24 Prints this message then exits. 25 .TP 26 \fB\-a\fR | \fB\-\-add\fR 27 Adds users if they don't exist on the database. 28 If they exist, they are modified unless 29 \fB\-s\fR|\-\-skipexisting is also used. 30 .TP 31 \fB\-d\fR | \fB\-\-delete\fR 32 Deletes users from the quota storage. 33 .TP 34 \fB\-e\fR | \fB\-\-email\fR addr 35 Sets the email address for the users. 36 If the addr parameter begins with @, then 37 the username is prepended to addr to form 38 a valid email address. 39 .HP 40 \fB\-D\fR | \fB\-\-description\fR d Adds a textual description to users or groups. 41 .TP 42 \fB\-g\fR | \fB\-\-groups\fR 43 Edit users groups instead of users. 44 .TP 45 \fB\-o\fR | \fB\-\-overcharge\fR f 46 Sets the overcharging factor applied to the user 47 when computing the cost of a print job. Positive or 48 negative floating point values are allowed, 49 this allows you to do some really creative 50 things like giving money to an user whenever 51 he prints. The number of pages in a print job 52 is not modified by this coefficient, only the 53 cost of the job for a particular user. 54 Only users have such a coefficient. 55 .TP 56 \fB\-i\fR | \fB\-\-ingroups\fR g1[,g2...] 57 Puts the users into each of the groups 58 listed, separated by commas. The groups 59 must already exist in the Quota Storage. 60 .TP 61 \fB\-L\fR | \fB\-\-list\fR 62 Lists users or groups. 63 .TP 64 \fB\-l\fR | \fB\-\-limitby\fR l 65 Choose if the user/group is limited in printing 66 by its account balance or by its page quota. 67 The default value is 'quota'. Allowed values 68 are 'quota' 'balance' 'noquota' 'noprint' 69 and 'nochange' : 91 pkusers \fB\-\-add\fR \fB\-\-groups\fR coders it 92 Would create two users groups named 'coders' and 'it'. 70 93 .IP 71 \- quota : limit by number of pages per printer. 72 \- balance : limit by number of credits in account. 73 \- noquota : no limit, accounting still done. 74 \- nochange : no limit, accounting not done. 75 \- noprint : printing is denied. 94 pkusers \fB\-\-add\fR \fB\-\-ingroups\fR coders,it jerome 95 Would add user 'jerome' and put him into the 'coders' and 'it' groups. 96 Both groups would have to be existing. 76 97 .IP 77 NB : nochange and noprint are not supported for groups. 78 .TP 79 \fB\-b\fR | \fB\-\-balance\fR b 80 Sets the user's account balance to b. 81 Account balance may be increase or decreased 82 if b is prefixed with + or \-. 83 WARNING : when decreasing account balance, 84 the total paid so far by the user is decreased 85 too. 86 Groups don't have a real balance, but the 87 sum of their users' account balance. 88 .TP 89 \fB\-C\fR | \fB\-\-comment\fR txt 90 Defines some informational text to be associated 91 with a change to an user's account balance. 92 Only meaningful if \fB\-b\fR | \fB\-\-balance\fR is also used. 93 .TP 94 \fB\-r\fR | \fB\-\-remove\fR 95 In combination with the \fB\-\-ingroups\fR option above, 96 remove users from the specified users groups. 97 .TP 98 \fB\-s\fR | \fB\-\-skipexisting\fR 99 In combination with the \fB\-\-add\fR option above, tells 100 pkusers to not modify existing users. 98 pkusers \fB\-\-limitby\fR balance \fB\-\-balance\fR 10.0 john 99 Would give 10.0 credits to 'john' and make his printing be limited by his 100 account balance. 101 101 .IP 102 user1 through userN and group1 through groupN can use wildcards 103 if the \fB\-\-add\fR option is not set. 104 .PP 105 examples : 102 pkusers \fB\-\-balance\fR +10.0 \fB\-\-comment\fR "He paid with his blood." jerome 103 Would add 10.0 credits to 'jerome''s account and register a comment 104 associated with his payment. 106 105 .IP 107 \f(CW$ pkusers \-\-add john paul george ringo/ringo@example.com\fR 106 pkusers \fB\-\-delete\fR "jer*" "rach*" 107 Would delete all user accounts whose names begin with either 'jer' or 108 \&'rach'. 108 109 .IP 109 This will add users john, paul, george and ringo to the quota 110 database. User ringo's email address will also be set to 111 \&'ringo@example.com' 110 pkusers \fB\-\-overcharge\fR \fB\-1\fR.50 theboss 111 Would make the boss earn money whenever he prints. 112 112 .IP 113 \f(CW$ pkusers \-\-ingroups coders,it jerome\fR 113 pkusers \fB\-\-email\fR @example.com 114 Would set the email address for each existing user to username@example.com 114 115 .IP 115 User jerome is put into the groups "coders" and "it" which must 116 already exist in the quota database. 116 pkusers \fB\-\-list\fR 117 Would list all users. 118 .SS "licensing terms:" 117 119 .IP 118 \f(CW$ pkusers \-\-limitby balance jerome\fR 120 (c) 2003\-2009 Jerome Alet \- alet@librelogiciel.com 121 This program is free software: you can redistribute it and/or modify it 122 under the terms of the GNU General Public License as published by the Free 123 Software Foundation, either version 3 of the License, or (at your option) 124 any later version. 119 125 .IP 120 This will tell PyKota to limit jerome by his account's balance 121 when printing. 126 This program is distributed in the hope that it will be useful, but 127 WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 128 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 129 for more details. 122 130 .IP 123 \f(CW$ pkusers \-\-balance +10.0 \-\-comment "He paid with his blood !" jerome\fR 124 .IP 125 This will increase jerome's account balance by 10.0 (in your 126 own currency). You can decrease the account balance with a 127 dash prefix, and set it to a fixed amount with no prefix. 128 A comment will be stored for this balance change. 129 .IP 130 \f(CW$ pkusers \-\-delete jerome rachel\fR 131 .IP 132 This will completely delete jerome and rachel from the quota 133 database. All their quotas and jobs will be deleted too. 134 .IP 135 \f(CW$ pkusers \-\-overcharge 2.5 poorstudent\fR 136 .IP 137 This will overcharge the poorstudent user by a factor of 2.5. 138 .IP 139 \f(CW$ pkusers \-\-overcharge -1 jerome\fR 140 .IP 141 User jerome will actually earn money whenever he prints. 142 .IP 143 \f(CW$ pkusers \-\-overcharge 0 boss\fR 144 .IP 145 User boss can print at will, it won't cost him anything because the 146 cost of each print job will be multiplied by zero before charging 147 his account. 148 .IP 149 \f(CW$ pkusers \-\-email @example.com\fR 150 .IP 151 This will set the email address for each user to username@example.com 152 .PP 153 (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet <alet@librelogiciel.com> 154 This program is free software: you can redistribute it and/or modify 155 it under the terms of the GNU General Public License as published by 156 the Free Software Foundation, either version 3 of the License, or 157 (at your option) any later version. 158 .PP 159 This program is distributed in the hope that it will be useful, 160 but WITHOUT ANY WARRANTY; without even the implied warranty of 161 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 162 GNU General Public License for more details. 163 .PP 164 You should have received a copy of the GNU General Public License 165 along with this program. If not, see <http://www.gnu.org/licenses/>. 166 .PP 167 Please report bugs to : Jerome Alet \- alet@librelogiciel.com 131 You should have received a copy of the GNU General Public License along 132 with this program. If not, see <http://www.gnu.org/licenses/>. -
pykota/trunk/man/de/pykosd.1
r3279 r3485 1 1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. 2 .TH PYKOSD "1" "janvier 200 8" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"2 .TH PYKOSD "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands" 3 3 .SH NOM 4 pykosd \- page de manuel de pykosd 1.27alpha3_BROKEN_unofficial 4 pykosd \- page de manuel de pykosd (PyKota) 1.27alpha7_unofficial 5 .SH SYNOPSIS 6 .B pykosd 7 [\fIoptions\fR] 5 8 .SH DESCRIPTION 6 pykosd v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com 7 .PP 8 An OSD quota monitor for PyKota. 9 .PP 10 command line usage : 11 .IP 12 pykosd [options] 13 .PP 14 options : 9 An On Screen Display (OSD) monitor for PyKota's end users. 10 .SH OPTIONS 15 11 .TP 16 \fB\- v\fR | \fB\-\-version\fR17 Prints pykosd's version number then exits.12 \fB\-h\fR, \fB\-\-help\fR 13 show this help message and exit. 18 14 .TP 19 \fB\- h\fR | \fB\-\-help\fR20 Prints this message then exits.15 \fB\-v\fR, \fB\-\-version\fR 16 show the version number and exit. 21 17 .TP 22 \fB\- c\fR | \fB\-\-color\fR #rrggbb Sets the color to use for display as an hexadecimal23 triplet, for example #FF0000 is 100% red. 24 Defaults to 100% green (#00FF00).18 \fB\-A\fR ARGUMENTSFILE, \fB\-\-arguments\fR=\fIARGUMENTSFILE\fR 19 loads additional options and arguments from a file, 20 one per line. 25 21 .TP 26 \fB\-d\fR | \fB\-\-duration\fR d 27 Sets the duration of the display in seconds. 28 Defaults to 3 seconds. 22 \fB\-c\fR COLOR, \fB\-\-color\fR=\fICOLOR\fR, \fB\-\-colour\fR=\fICOLOR\fR 23 Set the color that will be used for display, as an 24 hexadecimal triplet. For example #FF0000 is 100% red. 25 The default is 100% green (#00FF00). 29 26 .TP 30 \fB\- f\fR | \fB\-\-font\fR f31 Set s the font to use for display.32 Defaults to the Python OSD library's default.27 \fB\-d\fR DURATION, \fB\-\-duration\fR=\fIDURATION\fR 28 Set the time in seconds during which the message will 29 be displayed. Defaults to 3 seconds. 33 30 .TP 34 \fB\-l\fR | \fB\-\-loop\fR n 35 Sets the number of times the info will be displayed. 31 \fB\-f\fR FONT, \fB\-\-font\fR=\fIFONT\fR 32 Set the font to use. Defaults to \-*\-helveticamedium\-r\-normal\-*\-*\-360\-*\-*\-p\-*\-*\-*. 33 .TP 34 \fB\-l\fR LOOP, \fB\-\-loop\fR=\fILOOP\fR 35 Set the number of times the info will be displayed. 36 36 Defaults to 0, which means loop forever. 37 37 .TP 38 \fB\-s\fR | \fB\-\-sleep\fR s 39 Sets the sleeping duration between two displays 40 in seconds. Defaults to 180 seconds (3 minutes). 41 .PP 42 examples : 38 \fB\-s\fR SLEEP, \fB\-\-sleep\fR=\fISLEEP\fR 39 Set the sleeping time in seconds between two 40 refreshes. Defaults to 180 seconds. 41 .SS "examples:" 43 42 .IP 44 \f(CW$ pykosd -s 60 \-\-loop 5\fR 43 pykosd \fB\-s\fR 60 \fB\-\-loop\fR 5 44 This would tell pykosd to display the current user's status for 3 seconds 45 (the default) every 60 seconds, and exit after 5 iterations. 46 .SS "licensing terms:" 45 47 .IP 46 Will launch pykosd. Display will be refreshed every 60 seconds, 47 and will last for 3 seconds (the default) each time. After five 48 iterations, the program will exit. 49 .PP 50 (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet <alet@librelogiciel.com> 51 This program is free software: you can redistribute it and/or modify 52 it under the terms of the GNU General Public License as published by 53 the Free Software Foundation, either version 3 of the License, or 54 (at your option) any later version. 55 .PP 56 This program is distributed in the hope that it will be useful, 57 but WITHOUT ANY WARRANTY; without even the implied warranty of 58 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 59 GNU General Public License for more details. 60 .PP 61 You should have received a copy of the GNU General Public License 62 along with this program. If not, see <http://www.gnu.org/licenses/>. 63 .PP 64 Please report bugs to : Jerome Alet \- alet@librelogiciel.com 48 (c) 2003\-2009 Jerome Alet \- alet@librelogiciel.com 49 This program is free software: you can redistribute it and/or modify it 50 under the terms of the GNU General Public License as published by the Free 51 Software Foundation, either version 3 of the License, or (at your option) 52 any later version. 53 .IP 54 This program is distributed in the hope that it will be useful, but 55 WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 56 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 57 for more details. 58 .IP 59 You should have received a copy of the GNU General Public License along 60 with this program. If not, see <http://www.gnu.org/licenses/>. -
pykota/trunk/man/de/pykotme.1
r3279 r3485 1 1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. 2 .TH PYKOTME "1" "janvier 200 8" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"2 .TH PYKOTME "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands" 3 3 .SH NOM 4 pykotme \- page de manuel de pykotme 1.27alpha3_BROKEN_unofficial 4 pykotme \- page de manuel de pykotme (PyKota) 1.27alpha7_unofficial 5 .SH SYNOPSIS 6 .B pykotme 7 [\fIoptions\fR] [\fIfiles\fR] 5 8 .SH DESCRIPTION 6 pykotme v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com 7 .PP 8 Gives print quotes to users. 9 .PP 10 command line usage : 9 Generates print quotes for end users. 10 .SH OPTIONS 11 11 .TP 12 pykotme 13 [options] [files] 14 .PP 15 options : 12 \fB\-h\fR, \fB\-\-help\fR 13 show this help message and exit. 16 14 .TP 17 \fB\-v\fR |\fB\-\-version\fR18 Prints pykotme's version number then exits.15 \fB\-v\fR, \fB\-\-version\fR 16 show the version number and exit. 19 17 .TP 20 \fB\-h\fR | \fB\-\-help\fR 21 Prints this message then exits. 18 \fB\-A\fR ARGUMENTSFILE, \fB\-\-arguments\fR=\fIARGUMENTSFILE\fR 19 loads additional options and arguments from a file, 20 one per line. 22 21 .TP 23 \fB\-P\fR | \fB\-\-printer\fR p 24 Gives a quote for this printer only. Actually p can 25 use wildcards characters to select only 26 some printers. The default value is *, meaning 27 all printers. 28 You can specify several names or wildcards, 29 by separating them with commas. 30 .PP 31 examples : 22 \fB\-P\fR PRINTER, \fB\-\-printer\fR=\fIPRINTER\fR 23 Acts on this printer only. You can specify several 24 printer names by separating them with commas. The 25 default value is '*', which means all printers. 26 .TP 27 \fB\-u\fR USER, \fB\-\-user\fR=\fIUSER\fR 28 Acts on this user only. Only one username can be 29 specified this way. The default value is the name of 30 the user who launched this command. This option is 31 ignored when the command is not launched by a PyKota 32 Administrator. 33 .SS "examples:" 32 34 .IP 33 \f(CW$ pykotme \-\-printer apple file1.ps file2.ps\fR 35 pykotme \fB\-\-printer\fR apple file1.ps <file2.pclxl 36 This would show the number of pages needed to print these two files, as 37 well as the cost of printing them to the 'apple' printer for the user who 38 launched this command. 34 39 .IP 35 This will give a print quote to the current user. The quote will show 36 the price and size of a job consisting in file1.ps and file2.ps 37 which would be sent to the apple printer. 40 pykotme \fB\-\-user\fR john 41 This would show the number of pages needed to print the content of the 42 standard input, and the cost of printing this on all printers for user 43 \&'john'. 44 .SS "licensing terms:" 38 45 .IP 39 \f(CW$ pykotme \-\-printer apple,hplaser <file1.ps\fR 46 (c) 2003\-2009 Jerome Alet \- alet@librelogiciel.com 47 This program is free software: you can redistribute it and/or modify it 48 under the terms of the GNU General Public License as published by the Free 49 Software Foundation, either version 3 of the License, or (at your option) 50 any later version. 40 51 .IP 41 This will give a print quote to the current user. The quote will show42 the price and size of a job consisting in file1.ps as read from 43 standard input, which would be sent to the apple or hplaser 44 printer.52 This program is distributed in the hope that it will be useful, but 53 WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 54 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 55 for more details. 45 56 .IP 46 \f(CW$ pykotme\fR 47 .IP 48 This will give a quote for a job consisting of what is on standard 49 input. The quote will list the job size, and the price the job 50 would cost on each printer. 51 .PP 52 (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet <alet@librelogiciel.com> 53 This program is free software: you can redistribute it and/or modify 54 it under the terms of the GNU General Public License as published by 55 the Free Software Foundation, either version 3 of the License, or 56 (at your option) any later version. 57 .PP 58 This program is distributed in the hope that it will be useful, 59 but WITHOUT ANY WARRANTY; without even the implied warranty of 60 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 61 GNU General Public License for more details. 62 .PP 63 You should have received a copy of the GNU General Public License 64 along with this program. If not, see <http://www.gnu.org/licenses/>. 65 .PP 66 Please report bugs to : Jerome Alet \- alet@librelogiciel.com 57 You should have received a copy of the GNU General Public License along 58 with this program. If not, see <http://www.gnu.org/licenses/>. -
pykota/trunk/man/de/repykota.1
r3279 r3485 1 1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. 2 .TH REPYKOTA "1" "janvier 200 8" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"2 .TH REPYKOTA "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands" 3 3 .SH NOM 4 repykota \- page de manuel de repykota 1.27alpha3_BROKEN_unofficial 4 repykota \- page de manuel de repykota (PyKota) 1.27alpha7_unofficial 5 .SH SYNOPSIS 6 .B repykota 7 [\fIoptions\fR] [\fIusernames|groupnames\fR] 5 8 .SH DESCRIPTION 6 repykota v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com 7 .PP 8 Generates print quota reports. 9 .PP 10 command line usage : 9 Minimalist print accounting reports for PyKota. If not launched by a PyKota 10 administrator, additionnal arguments representing users or groups names are 11 ignored, limiting the scope of the reports to the current user. 12 .SH OPTIONS 13 .TP 14 \fB\-h\fR, \fB\-\-help\fR 15 show this help message and exit. 16 .TP 17 \fB\-v\fR, \fB\-\-version\fR 18 show the version number and exit. 19 .TP 20 \fB\-A\fR ARGUMENTSFILE, \fB\-\-arguments\fR=\fIARGUMENTSFILE\fR 21 loads additional options and arguments from a file, 22 one per line. 23 .TP 24 \fB\-g\fR, \fB\-\-groups\fR 25 Generate group print quota reports instead of user 26 print quota reports. 27 .TP 28 \fB\-i\fR INGROUPS, \fB\-\-ingroups\fR=\fIINGROUPS\fR 29 Only report users who are members of the specified 30 groups. This option is reserved to PyKota 31 administrators. 32 .TP 33 \fB\-P\fR PRINTER, \fB\-\-printer\fR=\fIPRINTER\fR 34 Acts on this printer only. You can specify several 35 printer names by separating them with commas. The 36 default value is '*', which means all printers. 37 .SS "examples:" 11 38 .IP 12 repykota [options] 13 .PP 14 options : 15 .TP 16 \fB\-v\fR | \fB\-\-version\fR 17 Prints repykota's version number then exits. 18 .TP 19 \fB\-h\fR | \fB\-\-help\fR 20 Prints this message then exits. 21 .TP 22 \fB\-u\fR | \fB\-\-users\fR 23 Generates a report on users quota, this is 24 the default. 25 .TP 26 \fB\-g\fR | \fB\-\-groups\fR 27 Generates a report on group quota instead of users. 28 .TP 29 \fB\-i\fR | \fB\-\-ingroups\fR g1[,g2...] 30 Only lists users who are members of these 31 groups. Reserved to PyKota Administrators. 32 .TP 33 \fB\-P\fR | \fB\-\-printer\fR p 34 Report quotas on this printer only. Actually p can 35 use wildcards characters to select only 36 some printers. The default value is *, meaning 37 all printers. 38 You can specify several names or wildcards, 39 by separating them with commas. 40 .PP 41 examples : 39 repykota 40 This would generate a report for all users on all printers. 42 41 .IP 43 \f(CW$ repykota \-\-printer lp\fR 42 repykota \fB\-\-printer\fR HP2100 43 This would generate a report for all users who print to printer 'HP2100'. 44 44 .IP 45 This will print the quota status for all users who use the lp printer. 45 repykota \fB\-\-printer\fR "laser*,*pson" jerome "jo*" 46 This would generate a report for all users named 'jerome' or whose name 47 begins with 'jo', on all printers which name begins with 'laser' or ends 48 with 'pson'. 49 .SS "licensing terms:" 46 50 .IP 47 \f(CW$ repykota\fR 51 (c) 2003\-2009 Jerome Alet \- alet@librelogiciel.com 52 This program is free software: you can redistribute it and/or modify it 53 under the terms of the GNU General Public License as published by the Free 54 Software Foundation, either version 3 of the License, or (at your option) 55 any later version. 48 56 .IP 49 This will print the quota status for all users on all printers. 57 This program is distributed in the hope that it will be useful, but 58 WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 59 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 60 for more details. 50 61 .IP 51 \f(CW$ repykota \-\-printer "laser*,*pson" jerome "jo*"\fR 52 .IP 53 This will print the quota status for user jerome and all users 54 whose name begins with "jo" on all printers which name begins 55 with "laser" or ends with "pson". 56 .IP 57 If launched by an user who is not a PyKota administrator, additionnal 58 arguments representing users or groups names are ignored, and only the 59 current user/group is reported. 60 .PP 61 (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet <alet@librelogiciel.com> 62 This program is free software: you can redistribute it and/or modify 63 it under the terms of the GNU General Public License as published by 64 the Free Software Foundation, either version 3 of the License, or 65 (at your option) any later version. 66 .PP 67 This program is distributed in the hope that it will be useful, 68 but WITHOUT ANY WARRANTY; without even the implied warranty of 69 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 70 GNU General Public License for more details. 71 .PP 72 You should have received a copy of the GNU General Public License 73 along with this program. If not, see <http://www.gnu.org/licenses/>. 74 .PP 75 Please report bugs to : Jerome Alet \- alet@librelogiciel.com 62 You should have received a copy of the GNU General Public License along 63 with this program. If not, see <http://www.gnu.org/licenses/>. -
pykota/trunk/man/de/warnpykota.1
r3279 r3485 1 1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. 2 .TH WARNPYKOTA "1" "janvier 200 8" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"2 .TH WARNPYKOTA "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands" 3 3 .SH NOM 4 warnpykota \- page de manuel de warnpykota 1.27alpha3_BROKEN_unofficial 4 warnpykota \- page de manuel de warnpykota (PyKota) 1.27alpha7_unofficial 5 .SH SYNOPSIS 6 .B warnpykota 7 [\fIoptions\fR] [\fIusernames|groupnames\fR] 5 8 .SH DESCRIPTION 6 warnpykota v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com 7 .PP 8 Sends mail to users over print quota. 9 .PP 10 command line usage : 9 A tool to warn users and groups who have reached the limit of their printing 10 quota. 11 .SH OPTIONS 11 12 .TP 13 \fB\-h\fR, \fB\-\-help\fR 14 show this help message and exit. 15 .TP 16 \fB\-v\fR, \fB\-\-version\fR 17 show the version number and exit. 18 .TP 19 \fB\-A\fR ARGUMENTSFILE, \fB\-\-arguments\fR=\fIARGUMENTSFILE\fR 20 loads additional options and arguments from a file, 21 one per line. 22 .TP 23 \fB\-g\fR, \fB\-\-groups\fR 24 Notify all members for all the named groups which have 25 reached the limit of their printing quota. Without 26 this option, individual users are notified instead of 27 users groups. 28 .TP 29 \fB\-P\fR PRINTER, \fB\-\-printer\fR=\fIPRINTER\fR 30 Acts on this printer only. You can specify several 31 printer names by separating them with commas. The 32 default value is '*', which means all printers. 33 .SS "examples:" 34 .IP 12 35 warnpykota 13 [options] [names] 14 .PP 15 options : 16 .TP 17 \fB\-v\fR | \fB\-\-version\fR 18 Prints warnpykota's version number then exits. 19 .TP 20 \fB\-h\fR | \fB\-\-help\fR 21 Prints this message then exits. 22 .TP 23 \fB\-u\fR | \fB\-\-users\fR 24 Warns users over their print quota, this is the 25 default. 26 .TP 27 \fB\-g\fR | \fB\-\-groups\fR 28 Warns users whose groups quota are over limit. 29 .TP 30 \fB\-P\fR | \fB\-\-printer\fR p 31 Verify quotas on this printer only. Actually p can 32 use wildcards characters to select only 33 some printers. The default value is *, meaning 34 all printers. 35 You can specify several names or wildcards, 36 by separating them with commas. 37 .PP 38 examples : 36 This would notify all users who have reached the limit of their printing 37 quota on any printer. 39 38 .IP 40 \f(CW$ warnpykota \-\-printer lp\fR 39 warnpykota \fB\-\-printer\fR HP2100 40 This would notify all users who have reached the limit of their printing 41 quota on printer 'HP2100'. 41 42 .IP 42 This will warn all users of the lp printer who have exceeded their 43 print quota. 43 warnpykota \fB\-\-groups\fR \fB\-\-printer\fR "HP*,XER*" "dev*" 44 This would notify all users of the groups whose name begins with 'dev' and 45 for which the printing quota limit is reached on any printer whose name 46 begins with 'HP' or 'XER'. 47 .SS "licensing terms:" 44 48 .IP 45 \f(CW$ warnpykota\fR 46 .TP 47 This will warn all users 48 who have exceeded their print quota on 49 (c) 2003\-2009 Jerome Alet \- alet@librelogiciel.com 50 This program is free software: you can redistribute it and/or modify it 51 under the terms of the GNU General Public License as published by the Free 52 Software Foundation, either version 3 of the License, or (at your option) 53 any later version. 49 54 .IP 50 any printer. 55 This program is distributed in the hope that it will be useful, but 56 WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 57 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 58 for more details. 51 59 .IP 52 \f(CW$ warnpykota \-\-groups \-\-printer "laserjet*" "dev*"\fR 53 .IP 54 This will warn all users of groups which names begins with "dev" and 55 who have exceeded their print quota on any printer which name begins 56 with "laserjet" 57 .IP 58 If launched by an user who is not a PyKota administrator, additionnal 59 arguments representing users or groups names are ignored, and only the 60 current user/group is reported. 61 .PP 62 (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet <alet@librelogiciel.com> 63 This program is free software: you can redistribute it and/or modify 64 it under the terms of the GNU General Public License as published by 65 the Free Software Foundation, either version 3 of the License, or 66 (at your option) any later version. 67 .PP 68 This program is distributed in the hope that it will be useful, 69 but WITHOUT ANY WARRANTY; without even the implied warranty of 70 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 71 GNU General Public License for more details. 72 .PP 73 You should have received a copy of the GNU General Public License 74 along with this program. If not, see <http://www.gnu.org/licenses/>. 75 .PP 76 Please report bugs to : Jerome Alet \- alet@librelogiciel.com 60 You should have received a copy of the GNU General Public License along 61 with this program. If not, see <http://www.gnu.org/licenses/>.