Man page - mandb(8)

Packages contains this manual

Available languages:

en fr pt_BR es it pl pt ko nl da tr sv ja uk id ru ro sr zh_CN de

Manual

MANDB

NOM
SYNOPSIS
DESCRIPTION
BASE DE DONNÉES D’INDEXATION
OPTIONS
CODE DE RETOUR
DIAGNOSTICS
FICHIERS
VOIR AUSSI
AUTEUR
BOGUES
TRADUCTION

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 . 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.

Image grohtml-3853217-1.png

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

Use this user configuration file rather than the default of ~/.manpath .

-? , --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).

BOGUES

https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db

TRADUCTION

Cette traduction est maintenue Ă  l’aide de l’outil po4a <URL:https://po4a.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> ».