Provided by: man-db_2.6.7.1-1ubuntu1_amd64 
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> ».