mandb - créer ou mettre à jour les caches d'index de pages de manuel
SYNOPSIS
mandb [-dqsucpt?V] [-C fichier] [chemin_man]
mandb [-dqsut] [-C fichier] -f nom_fichier ...
DESCRIPTION
mandb est utilisé pour initialiser ou mettre à jour manuellement les caches de base de données d'index. Les caches contiennent des informations relatives à l'état actuel du système de pages de manuel et les informations stockées en leur sein sont utilisées par les utilitaires man-db pour améliorer leur vitesse et leurs fonctionnalités.
Lors de la création ou de la mise à jour d'un index, mandb avertit en cas de requêtes ROFF .so incorrectes, de noms de fichiers de pages de manuel incorrects et de pages de manuel à partir desquelles le whatis ne peut pas être analysé.
En fournissant à mandb un chemin délimité par des deux-points, vous pouvez remplacer le chemin de recherche hiérarchique interne du système de pages de manuel, déterminé à partir des informations contenues dans le fichier de configuration man-db.
CACHES DE BASE DE DONNÉES
mandb peut être compilé avec la prise en charge de l'un des types de bases de données suivants.
Nom Asynchrone Nom de fichier
Berkeley db Oui index.bt GNU gdbm Oui index.db UNIX ndbm Non index.(dir|pag)
Les types de bases de données qui prennent en charge les mises à jour asynchrones offrent une vitesse accrue au prix d'une possible corruption en cas d'arrêt inhabituel. Dans le cas rare où cela s'est produit, il peut être 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
Afficher les informations de débogage.
-q, --quiet
Ne produire aucun avertissement.
-s, --no-straycats
Ne pas prendre le temps de rechercher ou d'ajouter des informations aux bases de données concernant les chats errants.
-p, --no-purge
Ne pas prendre le temps de vérifier la présence de pages de manuel supprimées et de les supprimer des bases de données.
-c, --create
Par défaut, mandb essaie de mettre à jour les bases de données précédemment créées. Si une base de données n'existe pas, elle la crée. Cette option force mandb à supprimer les bases de données précédentes et à les recréer à partir de zéro, et implique --no-purge. Cela peut être nécessaire si une base de données devient corrompue ou si un nouveau schéma de stockage de base de données est introduit à l'avenir.
-u, --user-db
Créer uniquement les bases de données utilisateur, même si des autorisations d'écriture sont nécessaires pour créer les bases de données système.
-t, --test
Effectuer des vérifications de correction sur les pages de manuel du chemin de recherche hiérarchique. Avec cette option, mandb ne modifiera pas les bases de données existantes.
-f, --filename
Mettre à jour uniquement les entrées du nom de fichier donné. Cette option n'est pas destinée à un usage général ; elle est utilisée en interne par man lorsqu'elle a été compilée avec l'option MAN_DB_UPDATES et qu'elle trouve qu'une page est obsolète. Elle implique -p et désactive -c et -s.
-C fichier, --config-file=fichier
Utiliser ce fichier de configuration utilisateur au lieu du fichier par défaut ~/.manpath.
-?, --help
Afficher le message d'utilisation, puis quitter.
--usage
Afficher un court message d'utilisation et quitter.
-V, --version
Afficher la version, puis quitter.
STATUT DE SORTIE
0 Exécution du programme réussie.
1 Erreur d'utilisation, de syntaxe ou de fichier de configuration.
2 Erreur opérationnelle.
3 Un processus enfant a échoué.
DIAGNOSTICS
Les messages d'avertissement suivants peuvent être émis pendant la création de la base de données.
<nom_fichier> : l'analyse whatis pour la page(section) a échoué
Une tentative d'extraction des lignes whatis du <nom_fichier> donné a échoué. Cela est généralement dû à une page de manuel mal écrite, mais si de nombreux messages de ce type sont émis, il est probable que le système contienne des pages de manuel non standard incompatibles avec l'analyseur whatis de man-db. Voir la section WHATIS PARSING dans lexgrog(1) pour plus d'informations.
<nom_fichier> : est un lien symbolique en suspens
<nom_fichier> n'existe pas mais est référencé par un lien symbolique. Des diagnostics supplémentaires sont généralement émis pour identifier le <nom_fichier> du lien en infraction.
<nom_fichier> : lien symbolique ou requête ROFF .so incorrecte
<nom_fichier> est soit un lien symbolique vers, soit contient une requête d'inclusion ROFF vers un fichier inexistant.
<nom_fichier> : nom de fichier incorrect ignoré
<nom_fichier> peut ou non être une page de manuel valide, mais son nom est invalide. Cela est généralement dû à une page de manuel avec une extension de section <x> placée dans la section de page de manuel <y>.
<masque_nom_fichier> : extensions concurrentes
Le caractère générique <masque_nom_fichier> n'est pas unique. Cela est généralement dû à l'existence d'une version compressée et d'une version non compressée de la même page de manuel. Toutes, sauf la plus récente, sont ignorées.
FICHIERS
/etc/manpath.config
Fichier de configuration man-db.
/var/cache/man/index.(bt|db|dir|pag)
Cache de base de données d'index global conforme à FHS.
Les anciens emplacements pour le cache de base de données comprenaient :
/usr/man/index.(bt|db|dir|pag)
Cache de base de données d'index global traditionnel.
/var/catman/index.(bt|db|dir|pag)
Cache de base de données d'index global alternatif ou conforme à FSSTND.
VOIR AUSSI
lexgrog(1), man(1), manpath(5), catman(8)
La section WHATIS PARSING, qui figurait auparavant dans cette page de manuel, fait désormais partie de lexgrog(1).
AUTEUR
Wilf. (_)
Fabrizio Polacco (_).
Colin Watson (_).
BUGS
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db