KlugyTools/DumpGDBM/dumpgdbm.1

111 lines
2.9 KiB
Groff

.TH DumpGDBM 1 "Fevrier 2003" "GNU/Linux" "Oulala tools"
.SH NAME
dumpgdbm \- Dumpeur de fichiers GDBM
.SH SYNOPSYS
\fBdumpgdbm\fP -V
.br
\fBdumpgdbm\fP -h
.br
\fBdumpgdbm\fP [-vxoa8] [-m 42] [-i] fichier.gdbm
.SH DESCRIPTION
Les fichiers GDBM permettent de stocker des 'tables associatives'
sur mémoire permanente. La rapidité de lecture de ces tables est
impressionante. Mais leur utilisation est parfois surprenante.
Par exemple, la présence ou non d'un '\\0' en fin de chaine...
.br
\fBdumpgdbm\fP affiche en ascii, en octal, ou en hexadécimal les
couples (clef/valeur) contenus dans un fichier GDBM.
Il devrait contenir bientôt (ymmv) un mécanisme de détection des clefs nulles,
réputées pour créer des problèmes dans des langages à typage faible,
comme Perl ou PHP. Suggestions attendues...
.SH OPTIONS
.B -V
pour connaitre la version du machin-bidule.
.br
.B -x
affichage des octets en hexadecimal.
.br
.B -o
affichage en octal (pdp11 roulaize).
.br
.B -a
affichage en ascii (voir aussi -8)
.br
.B -v
pour avoir du bavardage (fmbl roulaize)
.br
.B -h
ah, il y a un peu de l'aide.
.br
.B -8
C'est OK pour afficher les caractères dont le code ascii > 128.
.br
.B -m 42
détermine le nombre maximum d'octets affichés.
.br
.B -i
démarrage en mode interactif.
Les options -x, -a et -o sont exclusives et c'est la dernière rencontrée
sur la ligne de commande qui a la priorité.
L'option -8 n'a de sens qu'en mode ascii.
.SH INTERACTIF
Pour le mettre en oeuvre, c'est l'option
.B -i
au lancement, et ensuite, au prompt, un
.B ?
pour une liste abrégée des commandes. Puis taper:
.B help command
ou
.B listcom
pour en savoir un peu plus. Désolé, mais mon interpréteur de commandes n'est
pas (encore) parfait. Il utilise readline, mais ne sauvegarde pas (encore)
l'historique des commandes.
Les commandes de recherche,
.B ds
et
.B ks
, utilisent les expressions régulières POSIX.
.SH SEE ALSO
.BR gdbm (3)
.BR GDBM_File (3pm)
.BR cleargdbm (1)
.BR regex(3)
.SH BUGS
Il y en a probablement quelques uns qui trainent...
Par exemple, rien n'est encore prévu pour l'EBCDIC (Flo?).
Mais bon, au lieu de raler, il faut signaler les problêmes à l'auteur.
Toutes les idées d'amélioration sont les bienvenues.
De bonnes bouteilles aussi.
Bières anglo/saxonnes (Guinness roulaize) ou vins languedociens.
.SH SORRY
I have to rewrite this man page in english, but my english is very poor.
.SH LICENSE
Ce logiciel est distribué sous la bienveillante protection de la
GNU GENERAL PUBLIC LICENSE, version 2. J'en profite pour remercier
.B RMS
sans qui rien de tout ça ne serait arrivé.
.SH AUTHOR
Thierry Boudet (oulala@chez.com) depuis Juillet 1999.
Pour en savoir plus: http://krabulator.free.fr/devel/ ou
http://tboudet.free.fr/
.SH DEDICACE
Euh, donc ce logiciel est dédié à Jennifer Mack, dont je suis un fervent
admirateur depuis très longtemps. Merci également à Joshua, qui m'a fait
découvrir que tout cela n'est qu'un jeu.