6 | | pkusers v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com |
7 | | .PP |
8 | | Un gestionnaire d'utilisateurs et de groupes pour PyKota. |
9 | | .PP |
10 | | ligne de commande : |
| 9 | Manages PyKota users or users groups. |
| 10 | .SH OPTIONS |
| 11 | .TP |
| 12 | \fB\-h\fR, \fB\-\-help\fR |
| 13 | show this help message and exit. |
| 14 | .TP |
| 15 | \fB\-v\fR, \fB\-\-version\fR |
| 16 | show the version number and exit. |
| 17 | .TP |
| 18 | \fB\-A\fR ARGUMENTSFILE, \fB\-\-arguments\fR=\fIARGUMENTSFILE\fR |
| 19 | loads additional options and arguments from a file, |
| 20 | one per line. |
| 21 | .TP |
| 22 | \fB\-a\fR, \fB\-\-add\fR |
| 23 | Add new, or modify existing, users or groups. |
| 24 | .TP |
| 25 | \fB\-b\fR BALANCE, \fB\-\-balance\fR=\fIBALANCE\fR |
| 26 | Set an user's account balance. The value can also be |
| 27 | increased or decreased when the value is prefixed with |
| 28 | \&'+' or '\-'. Users groups don't have a real account |
| 29 | balance, instead the sum of their members' account |
| 30 | balances is used. |
| 31 | .TP |
| 32 | \fB\-C\fR COMMENT, \fB\-\-comment\fR=\fICOMMENT\fR |
| 33 | Associate a textual comment with a change in an user's |
| 34 | account balance. Only meaningful when \fB\-\-balance\fR is |
| 35 | also used. |
| 36 | .TP |
| 37 | \fB\-d\fR, \fB\-\-delete\fR |
| 38 | Delete the specified users or groups. Also purge the |
| 39 | print quota entries and printing history matching the |
| 40 | specified users or groups. |
| 41 | .TP |
| 42 | \fB\-D\fR DESCRIPTION, \fB\-\-description\fR=\fIDESCRIPTION\fR |
| 43 | Set a textual description for the specified users or |
| 44 | groups. |
| 45 | .TP |
| 46 | \fB\-e\fR EMAIL, \fB\-\-email\fR=\fIEMAIL\fR |
| 47 | Set an user's email address. If this parameter begins |
| 48 | with '@' then the username is prepended to this |
| 49 | parameter to form a valid email address. |
| 50 | .TP |
| 51 | \fB\-g\fR, \fB\-\-groups\fR |
| 52 | Manage users groups instead of users. |
| 53 | .TP |
| 54 | \fB\-i\fR INGROUPS, \fB\-\-ingroups\fR=\fIINGROUPS\fR |
| 55 | Put the specified users into the specified groups. |
| 56 | When combined with the \fB\-\-remove\fR option, users are |
| 57 | removed from the specified groups instead. |
| 58 | .TP |
| 59 | \fB\-l\fR LIMITBY, \fB\-\-limitby\fR=\fILIMITBY\fR |
| 60 | Set the limiting factor for the specified users or |
| 61 | groups. Can be any of 'quota' (limit by number of |
| 62 | pages per printer), 'balance' (limit by number of |
| 63 | credits), 'noquota' (no limit but accounting done), |
| 64 | \&'nochange' (no limit and no accounting), or 'noprint' |
| 65 | (printing is denied). The two latter ones are not |
| 66 | supported for groups. |
| 67 | .TP |
| 68 | \fB\-L\fR, \fB\-\-list\fR |
| 69 | Display detailed informations about the specified |
| 70 | users or groups. |
| 71 | .TP |
| 72 | \fB\-o\fR OVERCHARGE, \fB\-\-overcharge\fR=\fIOVERCHARGE\fR |
| 73 | Set the overcharging factor applied to the specified |
| 74 | users when computing the cost of a print job. Any |
| 75 | floating point value can be used, allowing you to |
| 76 | express your creativity... |
| 77 | .TP |
| 78 | \fB\-r\fR, \fB\-\-remove\fR |
| 79 | When combined with the \fB\-\-ingroups\fR option, remove users |
| 80 | from the specified users groups. |
| 81 | .TP |
| 82 | \fB\-s\fR, \fB\-\-skipexisting\fR |
| 83 | If \fB\-\-add\fR is used, ensure that existing users or groups |
| 84 | won't be modified. |
| 85 | .SS "examples:" |
16 | | pkusers \fB\-\-groups\fR [options] groupe1 groupe2 ... groupeN |
17 | | .PP |
18 | | options : |
19 | | .TP |
20 | | \fB\-v\fR | \fB\-\-version\fR |
21 | | Affiche le num� de version de pkusers et quitte. |
22 | | .TP |
23 | | \fB\-h\fR | \fB\-\-help\fR |
24 | | Affiche ce message et quitte. |
25 | | .TP |
26 | | \fB\-a\fR | \fB\-\-add\fR |
27 | | Ajoute des utilisateurs s'ils n'existent pas d� |
28 | | dans la base de donn�. S'ils existent, ils sont |
29 | | modifi�sauf si \fB\-s\fR|\-\-skipexisting est aussi utilis�.TP |
30 | | \fB\-d\fR | \fB\-\-delete\fR |
31 | | Efface des utilisateurs de la base de donn�. |
32 | | .TP |
33 | | \fB\-e\fR | \fB\-\-email\fR adr |
34 | | Positionne l'adresse email des utilisateurs. |
35 | | Si le param�e adr commence par @, alors |
36 | | cette valeur est pr�x�par le nom d'utilisateur |
37 | | pour former une adresse email valide. |
38 | | .HP |
39 | | \fB\-D\fR | \fB\-\-description\fR d Ajoute une description textuelle aux utilisateurs. |
40 | | .TP |
41 | | \fB\-g\fR | \fB\-\-groups\fR |
42 | | Modifie des groupes d'utilisateurs plut�ue des |
43 | | utilisateurs. |
44 | | .TP |
45 | | \fB\-o\fR | \fB\-\-overcharge\fR f |
46 | | Positionne le coefficient de surtaxe appliqu� |
47 | | l'utilisateur lors du calcul du co�un travail |
48 | | d'impression. Des valeurs flottantes positives ou |
49 | | negatives sont permises, ceci permet de faire des |
50 | | choses vraiment cr�ives comme par exemple donner |
51 | | de l'argent �n utilisateur chaque fois qu'il imprime. |
52 | | Le nombre de pages d'un travail d'impression n'est |
53 | | pas modifi�ar ce coefficient, seul le co� travail |
54 | | pour un utilisateur particulier l'est. |
55 | | Seuls les utilisateurs ont un tel coefficient. |
56 | | .TP |
57 | | \fB\-i\fR | \fB\-\-ingroups\fR g1[,g2...] |
58 | | Met les utilisateurs dans chacun des groupes |
59 | | list� separ�par des virgules. Les groupes |
60 | | doivent d� exister dans la base de donn�. |
61 | | .TP |
62 | | \fB\-L\fR | \fB\-\-list\fR |
63 | | Liste les utilisateurs ou les groupes. |
64 | | .TP |
65 | | \fB\-l\fR | \fB\-\-limitby\fR l |
66 | | Choisit si l'utilisateur/groupe est is limit�ar |
67 | | le solde de son compte ou par un quota de pages. |
68 | | La valeur par d�ut est 'quota'. Les valeurs possibles |
69 | | sont 'quota' 'balance' 'noquota' 'noprint' |
70 | | et 'nochange' : |
| 91 | pkusers \fB\-\-add\fR \fB\-\-groups\fR coders it |
| 92 | Would create two users groups named 'coders' and 'it'. |
79 | | les groupes. |
80 | | .TP |
81 | | \fB\-b\fR | \fB\-\-balance\fR b |
82 | | Positionne le solde de l'utilisateur �. |
83 | | Le solde peut �e incr�nt�u d��nt�i b |
84 | | est pr�d�'un signe + ou \-. |
85 | | ATTENTION : en d��ntant le solde, le total pay�ar l'utilisateur est �lement d��nt�Les groupes n'ont pas un v�table solde, mais la somme |
86 | | des soldes de tous leurs membres. |
87 | | .TP |
88 | | \fB\-C\fR | \fB\-\-comment\fR txt |
89 | | D�nit un texte d'information qui sera associ�vec le changement de valeur du solde de l'utilisateur. |
90 | | Seulement pris en compte si \fB\-b\fR | \fB\-\-balance\fR est utilis�.TP |
91 | | \fB\-r\fR | \fB\-\-remove\fR |
92 | | Combin�vec l'option \fB\-\-ingroups\fR ci\-dessus, enl� |
93 | | les utilisateurs des groupes sp�fi� |
94 | | .TP |
95 | | \fB\-s\fR | \fB\-\-skipexisting\fR |
96 | | Combin�vec l'option \fB\-\-add\fR ci\-dessus, indique �kusers |
97 | | de ne pas modifier les utilisateurs existants. |
| 102 | pkusers \fB\-\-balance\fR +10.0 \fB\-\-comment\fR "He paid with his blood." jerome |
| 103 | Would add 10.0 credits to 'jerome''s account and register a comment |
| 104 | associated with his payment. |
116 | | Ceci va indiquer �yKota que jerome doit �e limit�ar le solde de son |
117 | | compte lorsqu'il imprime. |
118 | | .IP |
119 | | \f(CW$ pkusers \-\-balance +10.0 \-\-comment "Il a pay�vec son sang !" jerome\fR |
120 | | .IP |
121 | | Ceci va incr�nter le solde de jerome de 10.0 (dans votre propre monnaie) |
122 | | Vous pouvez d��nter le solde en pr�dant la valeur du signe \-, |
123 | | et le positionner �ne valeur fix�sans aucun pr�xe. |
124 | | Un commentaire sera stock�our le changement de la valeur du solde. |
125 | | .IP |
126 | | \f(CW$ pkusers \-\-delete jerome rachel\fR |
127 | | .IP |
128 | | Ceci va compl�ment effacer les utilisateurs jerome et rachel de la base |
129 | | de donn�. Tous leurs quotas et travaux d'impression seront aussi effac� |
130 | | .IP |
131 | | \f(CW$ pkusers \-\-overcharge 2.5 pauvreetudiant\fR |
132 | | .IP |
133 | | Ceci va surtaxer l'utilisateur pauvreetudiant par un facteur de 2.5. |
134 | | .IP |
135 | | \f(CW$ pkusers \-\-overcharge -1 jerome\fR |
136 | | .IP |
137 | | L'utilisateur jerome va gagner de l'argent chaque fois qu'il imprimera. |
138 | | .IP |
139 | | \f(CW$ pkusers \-\-overcharge 0 patron\fR |
140 | | .IP |
141 | | L'utilisateur patron peut imprimer �olont�cela ne lui co� rien |
142 | | car le co� chaque job sera multipli�ar 0 avant de modifier le solde |
143 | | de son compte. |
144 | | .IP |
145 | | \f(CW$ pkusers \-\-email @example.com\fR |
146 | | .IP |
147 | | Ceci va fixer l'adresse email de chaque utilisateur �om@example.com |
148 | | .PP |
149 | | (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet <alet@librelogiciel.com> |
150 | | This program is free software: you can redistribute it and/or modify |
151 | | it under the terms of the GNU General Public License as published by |
152 | | the Free Software Foundation, either version 3 of the License, or |
153 | | (at your option) any later version. |
154 | | .PP |
155 | | This program is distributed in the hope that it will be useful, |
156 | | but WITHOUT ANY WARRANTY; without even the implied warranty of |
157 | | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
158 | | GNU General Public License for more details. |
159 | | .PP |
160 | | You should have received a copy of the GNU General Public License |
161 | | along with this program. If not, see <http://www.gnu.org/licenses/>. |
162 | | .PP |
163 | | Merci d'envoyer les rapports de bugs � Jerome Alet \- alet@librelogiciel.com |
| 131 | You should have received a copy of the GNU General Public License along |
| 132 | with this program. If not, see <http://www.gnu.org/licenses/>. |