root / pykota / trunk / man / zh_TW / dumpykota.1 @ 2270

Revision 2267, 3.7 kB (checked in by jerome, 19 years ago)

Moved the copyright strings out of the docstrings

  • 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" "mai 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
3.SH NOM
4dumpykota \- page de manuel de dumpykota 1.23alpha4_unofficial
5.SH DESCRIPTION
6dumpykota v1.23alpha4_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.IP
58Use the filter expressions to extract only parts of the
59datas. Allowed filters are of the form :
60.IP
61key=value
62.IP
63Allowed keys for now are :
64.TP
65username
66User's name
67.TP
68groupname
69Users group's name
70.TP
71printername
72Printer's name
73.TP
74pgroupname
75Printers group's name
76.TP
77hostname
78Client's hostname
79.TP
80billingcode
81Job's billing code
82.TP
83start
84Job's date of printing
85.TP
86end
87Job's date of printing
88.IP
89Contrary to other PyKota management tools, wildcard characters are not
90expanded, so you can't use them.
91.IP
92NB : not all keys are allowed for each data type, so the result may be
93empty if you use a key not available for a particular data type.
94.PP
95Examples :
96.IP
97\f(CW$ dumpykota --data history --format csv >myfile.csv\fR
98.IP
99This dumps the history in a comma separated values file, for possible
100use in a spreadsheet.
101.IP
102\f(CW$ dumpykota --data users --format xml -o users.xml\fR
103.IP
104Dumps all users datas to the users.xml file.
105.IP
106\f(CW$ dumpykota --data history printername=HP2100 username=jerome\fR
107.IP
108Dumps the job history for user jerome on printer HP2100 only.
109.IP
110\f(CW$ dumpykota --data history start=200503 end=20050730234615\fR
111.IP
112Dumps all jobs printed between March 1st 2005 at midnight and
113July 30th 2005 at 23 hours 46 minutes and 15 secondes included.
114.PP
115This program is free software; you can redistribute it and/or modify
116it under the terms of the GNU General Public License as published by
117the Free Software Foundation; either version 2 of the License, or
118(at your option) any later version.
119.PP
120This program is distributed in the hope that it will be useful,
121but WITHOUT ANY WARRANTY; without even the implied warranty of
122MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
123GNU General Public License for more details.
124.PP
125You should have received a copy of the GNU General Public License
126along with this program; if not, write to the Free Software
127Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
128.PP
129Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Note: See TracBrowser for help on using the browser.