Provided by: man-db_2.6.0.2-2_i386 bug

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> >>.