root / pykota / trunk / man / edpykota.1 @ 2950

Revision 2910, 5.3 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 EDPYKOTA "1" "June 2006" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
3.SH NAME
4edpykota \- manual page for edpykota 1.25alpha5_unofficial
5.SH DESCRIPTION
6edpykota v1.25alpha5_unofficial (c) 2003, 2004, 2005, 2006 Jerome Alet \- alet@librelogiciel.com
7.PP
8A Print Quota editor for PyKota.
9.PP
10command line usage :
11.IP
12edpykota [options] user1 user2 ... userN
13.IP
14edpykota [options] group1 group2 ... groupN
15.PP
16options :
17.TP
18\fB\-v\fR | \fB\-\-version\fR
19Prints edpykota's version number then exits.
20.TP
21\fB\-h\fR | \fB\-\-help\fR
22Prints this message then exits.
23.TP
24\fB\-a\fR | \fB\-\-add\fR
25Adds users or groups print quota entries if
26they don't exist in database.
27.TP
28\fB\-d\fR | \fB\-\-delete\fR
29Deletes users or groups print quota entries.
30Users or groups are never deleted, you have
31to use the pkusers command to delete them.
32The history will be purge from all matching
33jobs, unless \fB\-g\fR | \fB\-\-groups\fR is used.
34.TP
35\fB\-P\fR | \fB\-\-printer\fR p
36Edit quotas on printer p only. Actually p can
37use wildcards characters to select only
38some printers. The default value is *, meaning
39all printers.
40You can specify several names or wildcards,
41by separating them with commas.
42.TP
43\fB\-g\fR | \fB\-\-groups\fR
44Edit groups print quota entries instead of
45users print quota entries.
46.TP
47\fB\-L\fR | \fB\-\-list\fR
48Lists users or groups print quota entries.
49.TP
50\fB\-n\fR | \fB\-\-noquota\fR
51Sets both soft and hard limits to None for users
52or groups print quota entries.
53.TP
54\fB\-r\fR | \fB\-\-reset\fR
55Resets the actual page counter for the user
56or group to zero on the specified printers.
57The life time page counter is kept unchanged.
58.TP
59\fB\-R\fR | \fB\-\-hardreset\fR
60Resets the actual and life time page counters
61for the user or group to zero on the specified
62printers. This is a shortcut for '\-\-used 0'.
63.TP
64\fB\-s\fR | \fB\-\-skipexisting\fR
65In combination with the \fB\-\-add\fR option above, tells
66edpykota to not modify existing print quota entries.
67.TP
68\fB\-S\fR | \fB\-\-softlimit\fR sl
69Sets the quota soft limit to sl pages.
70.TP
71\fB\-H\fR | \fB\-\-hardlimit\fR hl
72Sets the quota hard limit to hl pages.
73.TP
74\fB\-I\fR | \fB\-\-increase\fR v
75Increase existing Soft and Hard limits by the value
76of v. You can prefix v with + or \-, if no sign is
77used, + is assumed.
78.TP
79\fB\-U\fR | \fB\-\-used\fR u
80Sets the page counters for the user u pages on
81the selected printers. Doesn't work for groups, since
82their page counters are the sum of all their members'
83page counters.
84Useful for migrating users from a different system
85where they have already used some pages. Actual
86and Life Time page counters may be increased or decreased
87if u is prefixed with + or \-.
88WARNING : BOTH page counters are modified in all cases,
89so be careful.
90NB : if u equals '0', then the action taken is
91the same as if \fB\-\-hardreset\fR was used.
92.IP
93user1 through userN and group1 through groupN can use wildcards
94if the \fB\-\-add\fR option is not set.
95.PP
96examples :
97.IP
98\f(CW$ edpykota --add john paul george ringo\fR
99.IP
100This will create print quota entries for users john, paul, george
101and ringo on all printers. These print quota entries will have no
102limit set.
103.IP
104\f(CW$ edpykota --printer lp -S 50 -H 60 jerome\fR
105.IP
106This will set jerome's print quota on the lp printer to a soft limit
107of 50 pages, and a hard limit of 60 pages. Both user jerome and
108printer lp have been previously created with the pkusers and pkprinters
109commands, respectively.
110.IP
111\f(CW$ edpykota -g -S 500 -H 550 financial support\fR
112.IP
113This will set print quota soft limit to 500 pages and hard limit
114to 550 pages for groups financial and support on all printers.
115.IP
116\f(CW$ edpykota --reset jerome "jo*"\fR
117.IP
118This will reset jerome's page counter to zero on all printers, as
119well as every user whose name begins with 'jo'.
120Their life time page counter on each printer will be kept unchanged.
121You 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
126This will tell PyKota to not limit jerome when printing on the
127hpcolor printer. All his jobs will be allowed on this printer, but
128accounting of the pages he prints will still be kept.
129Print Quotas for jerome on other printers are unchanged.
130.IP
131\f(CW$ edpykota --delete --printer "HP*,XER*" jerome rachel\fR
132.IP
133This will delete users jerome and rachel's print quota
134entries on all printers which name begin with 'HP' or
135\&'XER'. The jobs printed by these users on these printers
136will be deleted from the history.
137.PP
138This program is free software; you can redistribute it and/or modify
139it under the terms of the GNU General Public License as published by
140the Free Software Foundation; either version 2 of the License, or
141(at your option) any later version.
142.PP
143This program is distributed in the hope that it will be useful,
144but WITHOUT ANY WARRANTY; without even the implied warranty of
145MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
146GNU General Public License for more details.
147.PP
148You should have received a copy of the GNU General Public License
149along with this program; if not, write to the Free Software
150Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301, USA.
151.PP
152Please report bugs to : Jerome Alet \- alet@librelogiciel.com
Note: See TracBrowser for help on using the browser.