| 1 | .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. |
|---|
| 2 | .TH PKREFUND "1" "novembre 2006" "C@LL - Conseil Internet & Logiciels Libres" "User Commands" |
|---|
| 3 | .SH NOM |
|---|
| 4 | pkrefund \- page de manuel de pkrefund 1.25alpha16_unofficial |
|---|
| 5 | .SH DESCRIPTION |
|---|
| 6 | pkrefund v1.25alpha16_unofficial (c) 2003, 2004, 2005, 2006 Jerome Alet \- alet@librelogiciel.com |
|---|
| 7 | .PP |
|---|
| 8 | Refunds jobs. |
|---|
| 9 | .PP |
|---|
| 10 | command line usage : |
|---|
| 11 | .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 | .IP |
|---|
| 28 | Use the filter expressions to extract only parts of the |
|---|
| 29 | datas. Allowed filters are of the form : |
|---|
| 30 | .IP |
|---|
| 31 | key=value |
|---|
| 32 | .IP |
|---|
| 33 | Allowed keys for now are : |
|---|
| 34 | .TP |
|---|
| 35 | username |
|---|
| 36 | User's name |
|---|
| 37 | .TP |
|---|
| 38 | printername |
|---|
| 39 | Printer's name |
|---|
| 40 | .TP |
|---|
| 41 | hostname |
|---|
| 42 | Client's hostname |
|---|
| 43 | .TP |
|---|
| 44 | jobid |
|---|
| 45 | Job's Id |
|---|
| 46 | .TP |
|---|
| 47 | billingcode |
|---|
| 48 | Job's billing code |
|---|
| 49 | .TP |
|---|
| 50 | start |
|---|
| 51 | Job's date of printing |
|---|
| 52 | .TP |
|---|
| 53 | end |
|---|
| 54 | Job's date of printing |
|---|
| 55 | .IP |
|---|
| 56 | Contrary to other PyKota management tools, wildcard characters are not |
|---|
| 57 | expanded, so you can't use them. |
|---|
| 58 | .PP |
|---|
| 59 | Examples : |
|---|
| 60 | .IP |
|---|
| 61 | \f(CW$ pkrefund jobid=503\fR |
|---|
| 62 | .IP |
|---|
| 63 | This will refund all jobs which Id is 503. BEWARE : installing CUPS |
|---|
| 64 | afresh will reset the first job id at 1. So you probably want to use |
|---|
| 65 | a more precise filter as explained below |
|---|
| 66 | .IP |
|---|
| 67 | \f(CW$ pkrefund --reason "Hardware problem" jobid=503 start=today-7\fR |
|---|
| 68 | .IP |
|---|
| 69 | Refunds all jobs which id is 503 but which were printed during the |
|---|
| 70 | past week. The reason will be marked as being an hardware problem. |
|---|
| 71 | .IP |
|---|
| 72 | \f(CW$ pkrefund --force username=jerome printername=HP2100\fR |
|---|
| 73 | .IP |
|---|
| 74 | Refunds all jobs printed by user jerome on printer HP2100. No |
|---|
| 75 | confirmation will be asked. |
|---|
| 76 | .IP |
|---|
| 77 | \f(CW$ pkrefund --force printername=HP2100 start=200602 end=yesterday\fR |
|---|
| 78 | .IP |
|---|
| 79 | Refunds all jobs printed on printer HP2100 between February 1st 2006 |
|---|
| 80 | and yesterday. No confirmation will be asked. |
|---|
| 81 | .PP |
|---|
| 82 | This program is free software; you can redistribute it and/or modify |
|---|
| 83 | it under the terms of the GNU General Public License as published by |
|---|
| 84 | the Free Software Foundation; either version 2 of the License, or |
|---|
| 85 | (at your option) any later version. |
|---|
| 86 | .PP |
|---|
| 87 | This program is distributed in the hope that it will be useful, |
|---|
| 88 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
|---|
| 89 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
|---|
| 90 | GNU General Public License for more details. |
|---|
| 91 | .PP |
|---|
| 92 | You should have received a copy of the GNU General Public License |
|---|
| 93 | along with this program; if not, write to the Free Software |
|---|
| 94 | Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301, USA. |
|---|
| 95 | .PP |
|---|
| 96 | Please report bugs to : Jerome Alet \- alet@librelogiciel.com |
|---|
