root / pykota / trunk / man / th / dumpykota.1 @ 2303

Revision 2303, 3.8 kB (checked in by jerome, 19 years ago)

Updated the FSF's address

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