Provided by:
man-db_2.6.0.2-2_i386 
NOM
mandb - cree ou met a jour les bases de donn'ees d'indexation des pages
de manuel.
SYNOPSIS
mandb [-dqsucpt|-h|-V] [-C fichier] [chemin_vers_man]
mandb [-dqsut] [-C fichier] -f nom_de_fichier ...
DESCRIPTION
mandb est employe pour initialiser ou mettre a jour manuellement les
bases de donn'ees d'indexation qui sont habituellement exploitees par
man. Ces bases de donnees forment un << cache >> du systeme de fichiers
qui contient les pages de manuel. Elles contiennent l'etat actuel du
systeme de pages de manuel ainsi que les informations qui y sont
stockees. Elles sont exploitees par les utilitaires de man-db pour
accroitre leur vitesse et leurs fonctionnalites.
Lors de la creation ou de la mise a jour d'une base de donn'ees
d'indexation, mandb avertira des mauvaises requetes ROFF .so, des noms
de fichier errones et des pages de manuel depuis lesquelles la partie
whatis ne peut pas etre analysee.
On peut preciser a mandb une liste de structures hierarchiques de pages
de manuel. Les elements de la liste sont delimites par << : >>. Cette
liste remplacera celle du systeme, determinee a partir des informations
trouvees dans le fichier de configuration de man-db.
BASE DE DONN'EES D'INDEXATION
mandb peut etre compile pour gerer un des types suivants de bases de
donnees.
Nom Type Async Nom de fichier
------------------------------------------------------------
Berkeley db Arbre Binaire Oui index.bt
GNU gdbm v >= 1.6 Hachage Oui index.db
GNU gdbm v < 1.6 Hachage Non index.db
UNIX ndbm Hachage Non index.(dir|pag)
Les moteurs de bases de donnees qui gerent les mises a jour asynchrones
accroissent la vitesse au prix d'un risque de corruption en cas d'arret
anormal. Dans le cas, peu probable, ou cela se produirait, il serait
necessaire de reexecuter mandb avec l'option -c pour recreer les bases
de donnees a partir de zero.
OPTIONS
-d, --debug
Affiche les informations de mise au point.
-q, --quiet
Ne cree pas d'avertissement.
-s, --no-straycats
Evite de perdre du temps a rechercher ou a ajouter, aux bases de
donnees, des informations concernant les fichiers << cat >>
parasites.
-p, --no-purge
Evite de perdre du temps a verifier les pages de manuel
supprimees et a les purger des bases de donnees.
-c, --create
Par defaut, mandb essaiera de mettre a jour les bases de donnees
precedemment creees. Si une base de donnees n'existe pas, elle
sera creee. Cette option force mandb a supprimer les bases de
donnees existantes et a les recreer a partir de zero. Cette
option entraine l'option --no-purge. Cela peut etre necessaire
si une base de donnees est corrompue ou si un nouveau systeme de
gestion de base de donnees est implante a l'avenir.
-u, --user-db
Cree seulement des bases de donnees << utilisateur >>, meme si
on possede les permissions d'ecriture necessaires pour creer des
bases de donnees << systeme >>.
-t, --test
Execute les controles de validite des pages de manuel de la
liste des structures hierarchiques du chemin de recherche. Avec
cette option, mandb ne modifie pas les bases de donnees
existantes.
-f, --filename
Met a jour seulement les entrees correspondant au nom du fichier
donne. Cette option n'est pas d'un usage courant. Elle est
utilisee par man, lorsqu'il a ete compilee avec l'option
MAN_DB_UPDATES, et qu'il constate qu'une page n'est pas a jour.
Cette option induit l'option -p et annule les options -c et -s.
-C fichier, --config-file=fichier
Utilise le fichier de configuration indique au lieu du fichier
~/.manpath par defaut.
-h, --help
Affiche un mode d'emploi puis s'arrete.
-V, --version
Affiche la version puis s'arrete.
CODE DE RETOUR
0 Programme execute sans erreur.
1 Erreur d'utilisation, de syntaxe ou de fichier de configuration
2 Erreur d'execution.
3 Un processus fils a echoue.
DIAGNOSTICS
Les messages d'avertissement suivants peuvent etre generes pendant la
construction de la base de donnees.
<nom_de_fichier>: la recherche de whatis sur page(sec) a 'echou'e
L'extraction de la ou des lignes de whatis a partir du
<nom_de_fichier> indique a echoue. Ceci est habituellement du a
une page de manuel mal ecrite, mais si beaucoup de messages de
ce type sont emis, il est probable que le systeme contienne des
pages de manuel non standard, incompatibles avec l'analyseur de
whatis de man-db. Consultez la section ANALYSE WHATIS de
lexgrog(1) pour plus d'informations.
<nom_de_fichier>: est un lien symbolique flottant
<nom_de_fichier> n'existe pas mais est pointe par un lien
symbolique. Des informations complementaires sont habituellement
emises pour identifier le <nom_de_fichier> du lien << en
l'air >>.
<nom_de_fichier>: lien symbolique ou directive ROFF .so incorrect
<nom_de_fichier> est un lien symbolique, ou contient une requete
ROFF, vers un fichier inexistant.
<nom_de_fichier>: nom de fichier erron'e, ignor'e
Le <nom_de_fichier> peut etre ou non une page de manuel
correcte, mais son nom est invalide. Cela est habituellement du
a une page de manuel appartenant a une section <x> stockee dans
la section <y> des pages de manuel.
<nom_de_fichier_g'en'erique>: extentions en conflit
Le <nom_de_fichier_generique> n'a pas de correspondance unique.
Ceci est habituellement provoque par l'existence d'une version
compressee et d'une version non compressee de la meme page de
manuel. Seul le plus recent des fichiers correspondant au
<nom_de_fichier_generique> sera exploite.
FICHIERS
/etc/manpath.config
Fichier de configuration de man-db.
/var/cache/man/index.(bt|db|dir|pag)
Base de donn'ees d'indexation globale, conforme a FHS.
Anciens emplacements du cache de la base de donnees :
/usr/man/index.(bt|db|dir|pag)
Base de donn'ees d'indexation globale habituelle.
/var/catman/index.(bt|db|dir|pag)
Base de donn'ees d'indexation globale de remplacement ou conforme
a FSSTND.
VOIR AUSSI
man(1), lexgrog(1), manpath(5), catman(8).
La section ANALYSE WHATIS autrefois incluse dans cette page de manuel
est maintenant incorporee a lexgrog(1).
AUTEUR
Wilf. (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Colin Watson (cjwatson@debian.org).
TRADUCTION
Cette traduction est maintenue a l'aide de l'outil po4a
<URL:http://po4a.alioth.debian.org/> par l'equipe francophone de
traduction de Debian.
Valery Perrin <valery.perrin.debian@free.fr> le 2 janvier 2006. David
Prevot <david@tilapin.org> et l'equipe francophone de traduction de
Debian (2010).
Veuillez signaler toute erreur de traduction en ecrivant a
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet man-db.
Vous pouvez toujours avoir acces a la version anglaise de ce document
en utilisant la commande << man -L C <section> <page_de_man> >>.