root / pykota / trunk / man / it / dumpykota.1 @ 2910

Revision 2910, 3.9 kB (checked in by jerome, 18 years ago)

Updated URLs in manual pages too.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
Line 
1.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
2.TH DUMPYKOTA "1" "juin 2006" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
3.SH NOM
4dumpykota \- page de manuel de dumpykota 1.25alpha5_unofficial
5.SH DESCRIPTION
6dumpykota v1.25alpha5_unofficial (c) 2003, 2004, 2005, 2006 Jerome Alet \- alet@librelogiciel.com
7.PP
8Dumps PyKota database's content.
9.PP
10command line usage :
11.IP
12dumpykota [options] [filterexpr]
13.PP
14options :
15.TP
16\fB\-v\fR | \fB\-\-version\fR
17Prints dumpykota's version number then exits.
18.TP
19\fB\-h\fR | \fB\-\-help\fR
20Prints this message then exits.
21.TP
22\fB\-d\fR | \fB\-\-data\fR type
23Dumps 'type' datas. Allowed types are :
24.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
36.IP
37is always XML in this case.
38.IP
39NB : the \fB\-d\fR | \fB\-\-data\fR command line option
40is MANDATORY.
41.TP
42\fB\-f\fR | \fB\-\-format\fR fmt
43Dumps datas in the 'fmt' format. When not specified,
44the format is to dump datas in the csv format (comma
45separated values). All data dumped is between double
46quotes. 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
54ONLY AVAILABLE WITH \fB\-\-data\fR history
55.TP
56\fB\-o\fR | \fB\-\-output\fR fname
57All datas will be dumped to the file instead of
58to the standard output. The special '\-' filename
59is the default value and means stdout.
60WARNING : existing files are truncated !
61.TP
62\fB\-s\fR | \fB\-\-sum\fR
63Summarize the selected datas.
64ONLY AVAILABLE WITH \fB\-\-data\fR history or payments
65.IP
66Use the filter expressions to extract only parts of the
67datas. Allowed filters are of the form :
68.IP
69key=value
70.IP
71Allowed keys for now are :
72.TP
73username
74User's name
75.TP
76groupname
77Users group's name
78.TP
79printername
80Printer's name
81.TP
82pgroupname
83Printers group's name
84.TP
85hostname
86Client's hostname
87.TP
88billingcode
89Job's billing code
90.TP
91start
92Job's date of printing
93.TP
94end
95Job's date of printing
96.IP
97Contrary to other PyKota management tools, wildcard characters are not
98expanded, so you can't use them.
99.IP
100NB : not all keys are allowed for each data type, so the result may be
101empty if you use a key not available for a particular data type.
102.PP
103Examples :
104.IP
105\f(CW$ dumpykota --data history --format csv >myfile.csv\fR
106.IP
107This dumps the history in a comma separated values file, for possible
108use in a spreadsheet.
109.IP
110\f(CW$ dumpykota --data users --format xml -o users.xml\fR
111.IP
112Dumps all users datas to the users.xml file.
113.IP
114\f(CW$ dumpykota --data history printername=HP2100 username=jerome\fR
115.IP
116Dumps the job history for user jerome on printer HP2100 only.
117.IP
118\f(CW$ dumpykota --data history start=200503 end=20050730234615\fR
119.IP
120Dumps all jobs printed between March 1st 2005 at midnight and
121July 30th 2005 at 23 hours 46 minutes and 15 secondes included.
122.PP
123This program is free software; you can redistribute it and/or modify
124it under the terms of the GNU General Public License as published by
125the Free Software Foundation; either version 2 of the License, or
126(at your option) any later version.
127.PP
128This program is distributed in the hope that it will be useful,
129but WITHOUT ANY WARRANTY; without even the implied warranty of
130MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
131GNU General Public License for more details.
132.PP
133You should have received a copy of the GNU General Public License
134along with this program; if not, write to the Free Software
135Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301, USA.
136.PP
137Please report bugs to : Jerome Alet \- alet@librelogiciel.com
Note: See TracBrowser for help on using the browser.