root / pykota / trunk / man / fr / dumpykota.1 @ 3201

.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
.TH DUMPYKOTA "1" "juillet 2007" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
.SH NOM
dumpykota \- page de manuel de dumpykota 1.26beta_unofficial
.SH DESCRIPTION
dumpykota v1.26beta_unofficial (c) 2003, 2004, 2005, 2006, 2007 Jerome Alet \- alet@librelogiciel.com
.PP
Exporte le contenu de la base de donn� de PyKota.
.PP
ligne de commande :
.IP
dumpykota [options] [exprfiltre]
.PP
options :
.TP
\fB\-v\fR | \fB\-\-version\fR
Affiche la version de dumpykota et quitte.
.TP
\fB\-h\fR | \fB\-\-help\fR
Affiche ce message et quitte.
.TP
\fB\-d\fR | \fB\-\-data\fR type
Exporte les donn� de type 'type'.
Les types autoris�sont :
.IP
\- history : exporte l'historique des travaux.
\- users : exporte les utilisateurs.
\- groups : exporte les groupes d'utilisateurs.
\- printers : exporte les imprimantes.
\- upquotas : exporte les quotas des utilisateurs.
\- gpquotas : exporte les quotas des groupes.
\- payments : exporte l'historique des paiements.
\- pmembers : exporte les membres des groupes
.IP
d'imprimantes.
.IP
\- umembers : exporte les membres des groupes
.IP
d'utilisateurs.
.IP
\- billingcodes : exporte les codes de facturation.
\- all : exporte toutes les donn� de PyKota.
.IP
le format de sortie est toujours XML
dans ce cas.
.IP
NB : l'option de ligne de commande \fB\-d\fR | \fB\-\-data\fR est
OBLIGATOIRE.
.TP
\fB\-f\fR | \fB\-\-format\fR fmt
Exporte les donn� dans le format 'fmt' sp�fi�Si non pr�s�le format sera csv (champs s�r�par des virgules).
Toutes les donn� sont export� entre double quotes.
Les formats autoris�sont :
.IP
\- csv : donn� s�r� par des virgules
\- ssv : donn� s�r� par des point\-virgules
\- tsv : donn� s�r�par des tabulations
\- xml : donn� export� au format XML
\- cups : donn� export� au format page_log
.IP
de CUPS : DISPONIBLE SEULEMENT
.IP
AVEC \fB\-\-data\fR history
.TP
\fB\-o\fR | \fB\-\-output\fR nomf
Toutes les donn� seront export� vers un fichier
plut�ue vers la sortie standard. Le nom sp�al '\-'
est la valeur par d�ut indiquant la sortie standard.
ATTENTION : les fichiers existants sont tronqu�!
.TP
\fB\-O\fR | \fB\-\-orderby\fR exp
Change l'ordre des r�ltats. 'exp' est une liste
s�r�par des virgules d'instructions de tri, par
exemple '\-\-orderby +username,\-printername'. Seules
certaines expressions on un sens, aussi utiliser cette
option de ligne de commande n'est pas conseill�i
vous ne connaissez pas la structure exacte de la base
de donn� de PyKota.
.TP
\fB\-s\fR | \fB\-\-sum\fR
Effectue la somme des donn� s�ctionn�.
DISPONIBLE SEULEMENT AVEC \fB\-\-data\fR history ou payments
.IP
Utilisez les expressions de filtrage pour extraire seulement certaines
parties des donn�. Les filtres autoris�sont de la forme :
.IP
cl�aleur
.IP
Les cl�autoris� pour l'instant sont :
.TP
username
Nom de l'utilisateur
.TP
groupname
Nom du groupe d'utilisateurs
.TP
printername
Nom de l'imprimante
.TP
pgroupname
Nom du groupe d'imprimantes
.TP
hostname
Nom d'h�de la machine cliente
.TP
jobid
Id du travail d'impression
.TP
billingcode
Code de facturation du travail d'impression
.TP
start
Date du travail d'impression
.TP
end
Date du travail d'impression
.IP
Formatage des dates avec les cl�'start' et 'end' :
.IP
AAAA : limites d'ann�AAAAMM : limites de mois
AAAAMMJJ : limites de jour
AAAAMMJJhh : limites d'heures
AAAAMMJJhhmm : limites de minutes
AAAAMMJJhhmmss : limites de secondes
yesterday[+\-NbJours] : hier plus ou moins N jours (ex : yesterday\-15)
today[+\-NbJours] : aujoud'hui plus ou moins N jours (ex : today\-15)
tomorrow[+\-NbJours] : demain plus ou moins N jours (ex : tomorrow\-15)
now[+\-NbJours] : maintenant plus ou moins N jours (ex : now\-15)
.IP
\&'now' et 'today' ne sont pas exactement identiques car today repr�nte
la premi� ou la derni� seconde du jour selon qu'il soit utilis�vec
une expression de type start= ou end=.
L'utilit�e pouvoir sp�fier une date dans le future est une question
qui reste ouverte :\-)
.IP
Contrairement aux autres outils d'administration de PyKota, les caract�s
jokers ne sont pas expans� aussi vous ne pouvez pas les utiliser.
.IP
NB : toutes les cl�ne sont pas autoris� pour chaque type de donn�,
aussi le r�ltat peut �e vide si vous utilisez une cl�ndisponible
pour un type de donn� particulier.
.PP
Exemples :
.IP
\f(CW$ dumpykota --data history --format csv >monfichier.csv\fR
.IP
Ceci va exporter l'historique dans un fichier �hamps s�r�par des
virgules, par exemple pour r�portation dans un tableur.
.IP
\f(CW$ dumpykota --data users --format xml -o util.xml\fR
.IP
Exporte toutes les donn� des utilisateurs dans le fichier util.xml
.IP
\f(CW$ dumpykota --data history printername=HP2100 username=jerome\fR
.IP
Exporte l'historique des travaux de l'utilisateur jerome sur l'imprimante
HP2100 seulement.
.IP
\f(CW$ dumpykota --data history start=200503 end=20050730234615\fR
.IP
Exporte tous les travaux imprim�entre le 1er Mars 2005 �inuit et
le 30 Juillet 2005 �3 heures 46 minutes et 15 secondes inclus.
.PP
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
.PP
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
.PP
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301, USA.
.PP
Merci d'envoyer les rapports de bugs � Jerome Alet \- alet@librelogiciel.com