DUMPYKOTA(1)

NOM
dumpykota - page de manuel de dumpykota 1.26_unofficial

DESCRIPTION
dumpykota v1.26_unofficial (c) 2003, 2004, 2005, 2006, 2007 Jerome Alet - alet@librelogiciel.com

Exporte le contenu de la base de données de PyKota.

ligne de commande :

    dumpykota [options] [exprfiltre]

options :

-v | --version
    Affiche la version de dumpykota et quitte.

-h | --help
    Affiche ce message et quitte.

-d | --data type
    Exporte les données de type 'type'. Les types autorisés sont :

    - 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

    d'imprimantes.

    - umembers : exporte les membres des groupes

    d'utilisateurs.

    - billingcodes : exporte les codes de facturation. - all : exporte toutes les données de PyKota.

    le format de sortie est toujours XML dans ce cas.

    NB : l'option de ligne de commande -d | --data est OBLIGATOIRE.

-f | --format fmt
    Exporte les données dans le format 'fmt' spécifié. Si non précisé, le format sera csv (champs séparés par des virgules). Toutes les données sont exportées entre double quotes. Les formats autorisés sont :

    - csv : données séparées par des virgules - ssv : données séparées par des point-virgules - tsv : données séparés par des tabulations - xml : données exportées au format XML - cups : données exportées au format page_log

    de CUPS : DISPONIBLE SEULEMENT

    AVEC --data history

-o | --output nomf
    Toutes les données seront exportées vers un fichier plutôt que vers la sortie standard. Le nom spécial '-' est la valeur par défaut indiquant la sortie standard. ATTENTION : les fichiers existants sont tronqués !

-O | --orderby exp
    Change l'ordre des résultats. 'exp' est une liste séparée 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é si vous ne connaissez pas la structure exacte de la base de données de PyKota.

-s | --sum
    Effectue la somme des données sélectionnées. DISPONIBLE SEULEMENT AVEC --data history ou payments

    Utilisez les expressions de filtrage pour extraire seulement certaines parties des données. Les filtres autorisés sont de la forme :

    clé=valeur

    Les clés autorisées pour l'instant sont :

username
    Nom de l'utilisateur

groupname
    Nom du groupe d'utilisateurs

printername
    Nom de l'imprimante

pgroupname
    Nom du groupe d'imprimantes

hostname
    Nom d'hôte de la machine cliente

jobid
    Id du travail d'impression

billingcode
    Code de facturation du travail d'impression

start
    Date du travail d'impression

end Date du travail d'impression

    Formatage des dates avec les clés 'start' et 'end' :

    AAAA : limites d'année 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)

    'now' et 'today' ne sont pas exactement identiques car today représente la première ou la dernière seconde du jour selon qu'il soit utilisé avec une expression de type start= ou end=. L'utilité de pouvoir spécifier une date dans le future est une question qui reste ouverte :-)

    Contrairement aux autres outils d'administration de PyKota, les caractères jokers ne sont pas expansés, aussi vous ne pouvez pas les utiliser.

    NB : toutes les clés ne sont pas autorisées pour chaque type de données, aussi le résultat peut être vide si vous utilisez une clé indisponible pour un type de données particulier.

Exemples :

    $ dumpykota --data history --format csv >monfichier.csv

    Ceci va exporter l'historique dans un fichier à champs séparés par des virgules, par exemple pour réimportation dans un tableur.

    $ dumpykota --data users --format xml -o util.xml

    Exporte toutes les données des utilisateurs dans le fichier util.xml

    $ dumpykota --data history printername=HP2100 username=jerome

    Exporte l'historique des travaux de l'utilisateur jerome sur l'imprimante HP2100 seulement.

    $ dumpykota --data history start=200503 end=20050730234615

    Exporte tous les travaux imprimés entre le 1er Mars 2005 à minuit et le 30 Juillet 2005 à 23 heures 46 minutes et 15 secondes inclus.

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.

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.

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.

Merci d'envoyer les rapports de bugs à : Jerome Alet - alet@librelogiciel.com