Show
Ignore:
Timestamp:
01/24/09 22:38:46 (15 years ago)
Author:
jerome
Message:

Updated manual pages.

Files:
1 modified

Legend:

Unmodified
Added
Removed

  • pykota/trunk/man/fr/dumpykota.1

    r3279 r3485  
    11.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36. 
    2 .TH DUMPYKOTA "1" "janvier 2008" "C@LL - Conseil Internet & Logiciels Libres" "User Commands" 
     2.TH DUMPYKOTA "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands" 
    33.SH NOM 
    4 dumpykota \- page de manuel de dumpykota 1.27alpha3_BROKEN_unofficial 
     4dumpykota \- page de manuel de dumpykota (PyKota) 1.27alpha7_unofficial 
     5.SH SYNOPSIS 
     6.B dumpykota 
     7[\fIoptions\fR] [\fIfilterexpr\fR] 
    58.SH DESCRIPTION 
    6 dumpykota v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com 
    7 .PP 
    8 Exporte le contenu de la base de donn� de PyKota. 
    9 .PP 
    10 ligne de commande : 
     9Data Dumper for PyKota. 
     10.SH OPTIONS 
     11.TP 
     12\fB\-h\fR, \fB\-\-help\fR 
     13show this help message and exit. 
     14.TP 
     15\fB\-v\fR, \fB\-\-version\fR 
     16show the version number and exit. 
     17.TP 
     18\fB\-A\fR ARGUMENTSFILE, \fB\-\-arguments\fR=\fIARGUMENTSFILE\fR 
     19loads additional options and arguments from a file, 
     20one per line. 
     21.TP 
     22\fB\-d\fR DATA, \fB\-\-data\fR=\fIDATA\fR 
     23Select the type of datas to dump. This option is 
     24mandatory. Supported data types are : history, 
     25payments, billingcodes, users, groups, printers, 
     26upquotas, gpquotas, umembers, pmembers, and all. The 
     27\&'all' value forces the output format to XML. 
     28.TP 
     29\fB\-f\fR FORMAT, \fB\-\-format\fR=\fIFORMAT\fR 
     30Select the output format, the default being comma 
     31separated values. Supported formats are : csv, ssv, 
     32tsv, xml and cups. The 'cups' output format only works 
     33when dumping the history, and produces CUPS' page_log 
     34compatible output. 
     35.TP 
     36\fB\-o\fR OUTPUT, \fB\-\-output\fR=\fIOUTPUT\fR 
     37The name of the file the data dump will be written to. 
     38The default value is '\-', which tells dumpykota to 
     39write the dump to stdout. 
     40.TP 
     41\fB\-O\fR ORDERBY, \fB\-\-orderby\fR=\fIORDERBY\fR 
     42Change the ordering of the output based on a comma 
     43separated list of ordering statements. For example 
     44\&'\-username,+printername' would sort the output by 
     45descending order of user names and ascending order of 
     46printer names. Not all expressions are supported, and 
     47you should not use this if you don't know the internal 
     48structure of PyKota's database. 
     49.TP 
     50\fB\-s\fR, \fB\-\-sum\fR 
     51Summarize the output. Only available when dumping the 
     52printing history or the payments. 
     53.SS "filtering expressions:" 
    1154.IP 
    12 dumpykota [options] [exprfiltre] 
    13 .PP 
    14 options : 
    15 .TP 
    16 \fB\-v\fR | \fB\-\-version\fR 
    17 Affiche la version de dumpykota et quitte. 
    18 .TP 
    19 \fB\-h\fR | \fB\-\-help\fR 
    20 Affiche ce message et quitte. 
    21 .TP 
    22 \fB\-d\fR | \fB\-\-data\fR type 
    23 Exporte les donn� de type 'type'. 
    24 Les types autoris�sont : 
     55Use the filtering expressions to extract only parts of the datas. Allowed 
     56filters are of the form 'key=value'. Wildcards are not expanded as part of 
     57these filtering expressions, so you can't use them here. 
    2558.IP 
    26 \- history : exporte l'historique des travaux. 
    27 \- users : exporte les utilisateurs. 
    28 \- groups : exporte les groupes d'utilisateurs. 
    29 \- printers : exporte les imprimantes. 
    30 \- upquotas : exporte les quotas des utilisateurs. 
    31 \- gpquotas : exporte les quotas des groupes. 
    32 \- payments : exporte l'historique des paiements. 
    33 \- pmembers : exporte les membres des groupes 
     59allowed keys for now: 
    3460.IP 
    35 d'imprimantes. 
     61username : User's name 
     62groupname : Users group's name 
     63printername : Printer's name 
     64pgroupname : Printers group's name 
     65hostname : Host's name 
     66jobid : Job's id 
     67billingcode : Job's billing code 
     68start : Job's date of printing 
     69end : Job's date of printing 
    3670.IP 
    37 \- umembers : exporte les membres des groupes 
     71formatting of dates with the 'start' and 'end' filtering keys: 
    3872.IP 
    39 d'utilisateurs. 
     73YYYY : year boundaries 
     74YYYYMM : month boundaries 
     75YYYYMMDD : day boundaries 
     76YYYYMMDDhh : hour boundaries 
     77YYYYMMDDhhmm : minute boundaries 
     78YYYYMMDDhhmmss : second boundaries 
     79yesterday[+\-N] : yesterday more or less N days (e.g. : yesterday\-15) 
     80today[+\-N] : today more or less N days (e.g. : today\-15) 
     81tomorrow[+\-N] : tomorrow more or less N days (e.g. : tomorrow\-15) 
     82now[+\-N] : now more or less N days (e.g. now\-15) 
    4083.IP 
    41 \- billingcodes : exporte les codes de facturation. 
    42 \- all : exporte toutes les donn� de PyKota. 
     84\&'now' and 'today' are not exactly the same since 'today' represents the 
     85first or last second of the day depending on if it's used in a 'start=' or 
     86\&'end=' date expression. 
    4387.IP 
    44 le format de sortie est toujours XML 
    45 dans ce cas. 
     88examples: 
    4689.IP 
    47 NB : l'option de ligne de commande \fB\-d\fR | \fB\-\-data\fR est 
    48 OBLIGATOIRE. 
    49 .TP 
    50 \fB\-f\fR | \fB\-\-format\fR fmt 
    51 Exporte les donn� dans le format 'fmt' sp�fi�Si non pr�s�le format sera csv (champs s�r�par des virgules). 
    52 Toutes les donn� sont export� entre double quotes. 
    53 Les formats autoris�sont : 
     90dumpykota \fB\-\-unit\fR EURO \fB\-\-output\fR /tmp/invoices.pdf start=now\-30 
     91This would generate a PDF document containing invoices for all users 
     92who have spent some credits last month. Amounts would be in EURO and 
     93not VAT information would be included. 
    5494.IP 
    55 \- csv : donn� s�r� par des virgules 
    56 \- ssv : donn� s�r� par des point\-virgules 
    57 \- tsv : donn� s�r�par des tabulations 
    58 \- xml : donn� export� au format XML 
    59 \- cups : donn� export� au format page_log 
     95dumpykota \fB\-\-data\fR history \fB\-\-format\fR csv >myfile.csv 
     96This would dump the whole printing history to stdout in the CSV 
     97format, and redirect the output to a file. 
    6098.IP 
    61 de CUPS : DISPONIBLE SEULEMENT 
     99dumpykota \fB\-\-data\fR users \fB\-\-format\fR xml \fB\-o\fR users.xml 
     100This would dump all users into the 'users.xml' file in the XML format. 
    62101.IP 
    63 AVEC \fB\-\-data\fR history 
    64 .TP 
    65 \fB\-o\fR | \fB\-\-output\fR nomf 
    66 Toutes les donn� seront export� vers un fichier 
    67 plut�ue vers la sortie standard. Le nom sp�al '\-' 
    68 est la valeur par d�ut indiquant la sortie standard. 
    69 ATTENTION : les fichiers existants sont tronqu�! 
    70 .TP 
    71 \fB\-O\fR | \fB\-\-orderby\fR exp 
    72 Change l'ordre des r�ltats. 'exp' est une liste 
    73 s�r�par des virgules d'instructions de tri, par 
    74 exemple '\-\-orderby +username,\-printername'. Seules 
    75 certaines expressions on un sens, aussi utiliser cette 
    76 option de ligne de commande n'est pas conseill�i 
    77 vous ne connaissez pas la structure exacte de la base 
    78 de donn� de PyKota. 
    79 .TP 
    80 \fB\-s\fR | \fB\-\-sum\fR 
    81 Effectue la somme des donn� s�ctionn�. 
    82 DISPONIBLE SEULEMENT AVEC \fB\-\-data\fR history ou payments 
     102dumpykota \fB\-\-data\fR history printername=HP2100 username=jerome 
     103This would dump jerome's printing history on printer HP2100. 
    83104.IP 
    84 Utilisez les expressions de filtrage pour extraire seulement certaines 
    85 parties des donn�. Les filtres autoris�sont de la forme : 
     105dumpykota \fB\-\-data\fR history start=200503 end=20050730234615 
     106This would dump all jobs printer between March 1st 2008 at midnight 
     107and July 30th 2008 at 23 hours 46 minutes and 15 seconds, included. 
    86108.IP 
    87 cl�aleur 
     109licensing terms: 
    88110.IP 
    89 Les cl�autoris� pour l'instant sont : 
    90 .TP 
    91 username 
    92 Nom de l'utilisateur 
    93 .TP 
    94 groupname 
    95 Nom du groupe d'utilisateurs 
    96 .TP 
    97 printername 
    98 Nom de l'imprimante 
    99 .TP 
    100 pgroupname 
    101 Nom du groupe d'imprimantes 
    102 .TP 
    103 hostname 
    104 Nom d'h�de la machine cliente 
    105 .TP 
    106 jobid 
    107 Id du travail d'impression 
    108 .TP 
    109 billingcode 
    110 Code de facturation du travail d'impression 
    111 .TP 
    112 start 
    113 Date du travail d'impression 
    114 .TP 
    115 end 
    116 Date du travail d'impression 
    117 .IP 
    118 Formatage des dates avec les cl�'start' et 'end' : 
    119 .IP 
    120 AAAA : limites d'ann�AAAAMM : limites de mois 
    121 AAAAMMJJ : limites de jour 
    122 AAAAMMJJhh : limites d'heures 
    123 AAAAMMJJhhmm : limites de minutes 
    124 AAAAMMJJhhmmss : limites de secondes 
    125 yesterday[+\-NbJours] : hier plus ou moins N jours (ex : yesterday\-15) 
    126 today[+\-NbJours] : aujoud'hui plus ou moins N jours (ex : today\-15) 
    127 tomorrow[+\-NbJours] : demain plus ou moins N jours (ex : tomorrow\-15) 
    128 now[+\-NbJours] : maintenant plus ou moins N jours (ex : now\-15) 
    129 .IP 
    130 \&'now' et 'today' ne sont pas exactement identiques car today repr�nte 
    131 la premi� ou la derni� seconde du jour selon qu'il soit utilis�vec 
    132 une expression de type start= ou end=. 
    133 L'utilit�e pouvoir sp�fier une date dans le future est une question 
    134 qui reste ouverte :\-) 
    135 .IP 
    136 Contrairement aux autres outils d'administration de PyKota, les caract�s 
    137 jokers ne sont pas expans� aussi vous ne pouvez pas les utiliser. 
    138 .IP 
    139 NB : toutes les cl�ne sont pas autoris� pour chaque type de donn�, 
    140 aussi le r�ltat peut �e vide si vous utilisez une cl�ndisponible 
    141 pour un type de donn� particulier. 
    142 .PP 
    143 Exemples : 
    144 .IP 
    145 \f(CW$ dumpykota \-\-data history \-\-format csv >monfichier.csv\fR 
    146 .IP 
    147 Ceci va exporter l'historique dans un fichier �hamps s�r�par des 
    148 virgules, par exemple pour r�portation dans un tableur. 
    149 .IP 
    150 \f(CW$ dumpykota \-\-data users \-\-format xml -o util.xml\fR 
    151 .IP 
    152 Exporte toutes les donn� des utilisateurs dans le fichier util.xml 
    153 .IP 
    154 \f(CW$ dumpykota \-\-data history printername=HP2100 username=jerome\fR 
    155 .IP 
    156 Exporte l'historique des travaux de l'utilisateur jerome sur l'imprimante 
    157 HP2100 seulement. 
    158 .IP 
    159 \f(CW$ dumpykota \-\-data history start=200503 end=20050730234615\fR 
    160 .IP 
    161 Exporte tous les travaux imprim�entre le 1er Mars 2005 �inuit et 
    162 le 30 Juillet 2005 �3 heures 46 minutes et 15 secondes inclus. 
    163 .PP 
    164 (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet <alet@librelogiciel.com> 
     111(c) 2003\-2009 Jerome Alet \- alet@librelogiciel.com 
    165112This program is free software: you can redistribute it and/or modify 
    166113it under the terms of the GNU General Public License as published by 
    167 the Free Software Foundation, either version 3 of the License, or 
    168 (at your option) any later version. 
    169 .PP 
    170 This program is distributed in the hope that it will be useful, 
    171 but WITHOUT ANY WARRANTY; without even the implied warranty of 
    172 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the 
    173 GNU General Public License for more details. 
    174 .PP 
     114the Free Software Foundation, either version 3 of the License, or (at 
     115your option) any later version. 
     116.IP 
     117This program is distributed in the hope that it will be useful, but 
     118WITHOUT ANY WARRANTY; without even the implied warranty of 
     119MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU 
     120General Public License for more details. 
     121.IP 
    175122You should have received a copy of the GNU General Public License 
    176123along with this program.  If not, see <http://www.gnu.org/licenses/>. 
    177 .PP 
    178 Merci d'envoyer les rapports de bugs � Jerome Alet \- alet@librelogiciel.com