MANDB(8) Utilitaires de l'afficheur des pages de manuel MANDB(8) NOM mandb - Creer ou mettre a jour les bases de donnees 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 employe pour initialiser ou mettre a jour manuellement les bases de donnees d'indexation. 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 donnees 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 DONNEES D'INDEXATION mandb peut etre compile pour gerer un des types suivants de bases de donnees. Nom Async Nom de fichier -------------------------------------- Berkeley db Oui index.bt GNU gdbm Oui index.db UNIX ndbm 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 Use this user configuration file rather than the default of ~/.manpath. -?, --help Affiche un mode d'emploi puis s'arrete. --usage Affiche un court mode d'emploi et 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. : la recherche de whatis sur page(sec) a echoue L'extraction de la ou des lignes de whatis a partir du 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. : est un lien symbolique flottant n'existe pas mais est pointe par un lien symbolique. Des informations complementaires sont habituellement emises pour identifier le du lien << en l'air >>. : lien symbolique ou directive ROFF .so incorrect est un lien symbolique, ou contient une requete ROFF, vers un fichier inexistant. : nom de fichier errone, ignore Le 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 stockee dans la section des pages de manuel. : extentions en conflit Le 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 sera exploite. FICHIERS /etc/man_db.conf Fichier de configuration de man-db. /var/cache/man/index.(bt|db|dir|pag) Base de donnees d'indexation globale, conforme a FHS. Anciens emplacements du cache de la base de donnees : /usr/man/index.(bt|db|dir|pag) Base de donnees d'indexation globale habituelle. /var/catman/index.(bt|db|dir|pag) Base de donnees d'indexation globale de remplacement ou conforme a FSSTND. VOIR AUSSI lexgrog(1), man(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). BOGUES https://gitlab.com/man-db/man-db/-/issues https://savannah.nongnu.org/bugs/?group=man-db TRADUCTION Cette traduction est maintenue a l'aide de l'outil po4a par l'equipe francophone de traduction de Debian. Valery Perrin le 2 janvier 2006. David Prevot et l'equipe francophone de traduction de Debian (2010). Veuillez signaler toute erreur de traduction en ecrivant a 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
>>. 2.12.1 2024-04-05 MANDB(8)