trusty (8) mandb.8.gz

Provided by: man-db_2.6.7.1-1ubuntu1_amd64 bug

NOM

       mandb - Créer ou mettre à jour les bases de données d'indexation des pages de manuel

SYNOPSIS

       mandb [-dqsucpt?V] [-C fichier] [chemin_vers_man]
       mandb [-dqsut] [-C fichier] -f nom_de_fichier ...

DESCRIPTION

       mandb  est  employé  pour  initialiser  ou mettre à jour manuellement les bases de données
       d'indexation qui sont habituellement exploitées par man. Ces bases de données  forment  un
       « cache »  du  système  de  fichiers  qui  contient les pages de manuel. Elles contiennent
       l'état actuel du système de pages  de  manuel  ainsi  que  les  informations  qui  y  sont
       stockées.  Elles sont exploitées par les utilitaires de man-db pour accroître leur vitesse
       et leurs fonctionnalités.

       Lors de la création ou de la mise  à  jour  d'une  base  de  données  d'indexation,  mandb
       avertira  des  mauvaises  requêtes  ROFF  .so, des noms de fichier erronés et des pages de
       manuel depuis lesquelles la partie whatis ne peut pas être analysée.

       On peut préciser à mandb une liste de structures hiérarchiques de  pages  de  manuel.  Les
       éléments  de  la  liste sont délimités par « : ». Cette liste remplacera celle du système,
       déterminée à partir des informations trouvées dans le fichier de configuration de man-db.

BASE DE DONNÉES D'INDEXATION

       mandb peut être compilé pour gérer un des types suivants de bases de données.

       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 données qui gèrent les mises à  jour  asynchrones  accroissent  la
       vitesse  au  prix  d'un  risque  de  corruption  en  cas d'arrêt anormal. Dans le cas, peu
       probable, où cela se produirait, il serait nécessaire de réexécuter mandb avec l'option -c
       pour recréer les bases de données à partir de zéro.

OPTIONS

       -d, --debug
              Affiche les informations de mise au point.

       -q, --quiet
              Ne crée pas d'avertissement.

       -s, --no-straycats
              Évite  de  perdre  du  temps  à  rechercher ou à ajouter, aux bases de données, des
              informations concernant les fichiers « cat » parasites.

       -p, --no-purge
              Évite de perdre du temps à vérifier les pages de manuel supprimées et à les  purger
              des bases de données.

       -c, --create
              Par  défaut,  mandb  essaiera  de  mettre  à jour les bases de données précédemment
              créées. Si une base de données n'existe pas, elle sera créée.  Cette  option  force
              mandb  à  supprimer  les  bases  de données existantes et à les recréer à partir de
              zéro. Cette option entraîne l'option --no-purge. Cela peut être nécessaire  si  une
              base  de  données  est  corrompue  ou  si  un nouveau système de gestion de base de
              données est implanté à l'avenir.

       -u, --user-db
              Crée seulement des bases  de  données  « utilisateur »,  même  si  on  possède  les
              permissions d'écriture nécessaires pour créer des bases de données « système ».

       -t, --test
              Exécute  les  contrôles  de validité des pages de manuel de la liste des structures
              hiérarchiques du chemin de recherche. Avec cette option, mandb ne modifie  pas  les
              bases de données existantes.

       -f, --filename
              Met  à  jour  seulement  les  entrées  correspondant au nom du fichier donné. Cette
              option n'est pas d'un usage courant. Elle est utilisée par  man,  lorsqu'il  a  été
              compilée  avec  l'option  MAN_DB_UPDATES, et qu'il constate qu'une page n'est pas à
              jour. Cette option induit l'option -p et annule les options -c et -s.

       -C fichier, --config-file=fichier
              Utilise le fichier de configuration indiqué  au  lieu  du  fichier  ~/.manpath  par
              défaut.

       -?, --help
              Affiche un mode d'emploi puis s'arrête.

       --usage
              Affiche un court mode d'emploi et s'arrête.

       -V, --version
              Affiche la version puis s'arrête.

CODE DE RETOUR

       0      Programme exécuté sans erreur.

       1      Erreur d'utilisation, de syntaxe ou de fichier de configuration

       2      Erreur d'exécution.

       3      Un processus fils a échoué.

DIAGNOSTICS

       Les  messages  d'avertissement suivants peuvent être générés pendant la construction de la
       base de données.

       <nom_de_fichier>: la recherche de whatis sur page(sec) a échoué
              L'extraction de la ou des lignes de whatis à partir du <nom_de_fichier>  indiqué  a
              échoué.  Ceci  est  habituellement  dû  à  une  page  de manuel mal écrite, mais si
              beaucoup de messages de ce type sont émis, il est probable que le système 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  pointé  par  un  lien  symbolique.  Des
              informations   complémentaires   sont  habituellement  émises  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  requête  ROFF,  vers  un
              fichier inexistant.

       <nom_de_fichier>: nom de fichier erroné, ignoré
              Le  <nom_de_fichier> peut être ou non une page de manuel correcte, mais son nom est
              invalide. Cela est habituellement dû à une page de manuel appartenant à une section
              <x> stockée dans la section <y> des pages de manuel.

       <nom_de_fichier_générique>: extentions en conflit
              Le   <nom_de_fichier_générique>   n'a   pas  de  correspondance  unique.  Ceci  est
              habituellement provoqué par l'existence d'une version compressée et  d'une  version
              non  compressée  de  la  même  page  de  manuel.  Seul  le plus récent des fichiers
              correspondant au <nom_de_fichier_générique> sera exploité.

FICHIERS

       /etc/manpath.config
              Fichier de configuration de man-db.

       /var/cache/man/index.(bt|db|dir|pag)
              Base de données d'indexation globale, conforme à FHS.

       Anciens emplacements du cache de la base de données :

       /usr/man/index.(bt|db|dir|pag)
              Base de données d'indexation globale habituelle.

       /var/catman/index.(bt|db|dir|pag)
              Base de données d'indexation globale de remplacement ou conforme à FSSTND.

VOIR AUSSI

       lexgrog(1), man(1), manpath(5), catman(8)

       La section ANALYSE WHATIS autrefois incluse dans  cette  page  de  manuel  est  maintenant
       incorporée à 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     à     l'aide     de     l'outil     po4a
       <URL:http://po4a.alioth.debian.org/> par l'équipe francophone de traduction de Debian.

       Valéry  Perrin  <valery.perrin.debian@free.fr>   le   2   janvier   2006.   David   Prévot
       <david@tilapin.org> et l'équipe francophone de traduction de Debian (2010).

       Veuillez     signaler     toute     erreur     de     traduction     en     écrivant     à
       <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le paquet man-db.

       Vous pouvez toujours avoir accès à la version anglaise de  ce  document  en  utilisant  la
       commande « man -L C <section> <page_de_man> ».