mandb Man page

MANDB(8) Utilitaires de l’afficheur des pages de manuel MANDB(8)

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 sto‐
cké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 » para‐
sites.

-p, –no-purge
Évite de perdre du temps à vérifier les pages de manuel suppri‐
mé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 exis‐
tantes.

-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 uti‐
lisé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.

: la recherche de whatis sur page(sec) a échoué
L’extraction de la ou des lignes de whatis à partir du
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 lex‐
grog pour plus d’informations.

: est un lien symbolique flottant
n’existe pas mais est pointé par un lien symbo‐
lique. Des informations complémentaires sont habituellement
émises pour identifier le du lien « en l’air ».

: lien symbolique ou directive ROFF .so incorrect
est un lien symbolique, ou contient une requête
ROFF, vers un fichier inexistant.

: nom de fichier erroné, ignoré
Le peut être ou non une page de manuel cor‐
recte, mais son nom est invalide. Cela est habituellement dû à
une page de manuel appartenant à une section stockée dans la
section des pages de manuel.

: extentions en conflit
Le 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
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, man, manpath(5), catman(8)

La section ANALYSE WHATIS autrefois incluse dans cette page de manuel
est maintenant incorporée à lexgrog.

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
par l’équipe francophone de tra‐
duction de Debian.

Valéry Perrin le 2 janvier 2006. David
Prévot et l’équipe francophone de traduction de
Debian (2010).

Veuillez signaler toute erreur de traduction en écrivant à
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

».

2.7.5 2015-11-06 MANDB(8)