NOMBRE

       mandb - crea o actualiza los índices temporales de páginas del manual

SINOPSIS

       mandb [-dqsuc|-h|-V] [rutaalmanual]

DESCRIPCIÓN

       mandb  se usa para crear o actualizar manualmente la base de datos temporal de índices que
       usualmente mantiene la utilidad man.  Estos índices temporales contienen información sobre
       el  estado actual del sistema de páginas del manual, y la infomación contenida en ellos se
       usa por las utilidades man-db para mejorar su velocidad y funcionalidad.

       Cuando se crea o actualiza un índice, mandb le avisará de peticiones ROFF .so incorrectas,
       nombres  falsos  de  páginas  de  manual  y páginas cuyos whatis (descripciones cortas) no
       pudieron analizarse.

       Si se le suministra a mandb una ruta opcional, delimitada con dos puntos (:), no usará  la
       ruta de búsqueda `global' interna para la jerarquía depáginas del manual, que se determina
       a partir de la información que se encuentra en el fichero de configuración de man-db.

BASES DE DATOS TEMPORALES

       mandb puede compilarse con soporte para cualquiera de los siguientes  tipos  de  bases  de
       datos.

       Nombre        Tipo            Asinc   Nombre de fichero
       ────────────────────────────────────────────────────────
       Berkeley db   Árbol binario   Sí      index.bt
       GNU gdbm      "Hashed"        Sí      index.db
       UNIX ndbm     "Hashed"        No      index.(dir|pag)

       Los  tipos  de  base  de  datos  que  soportan  actualizaciones  asíncronas permiten mayor
       velocidad, a costa de posible corrupción en caso de una interrupción inusual.  En el  caso
       inusual  de  que esto ocurra, puede ser necesario volver a ejecutar mandb con la opción -c
       para volver a crear las bases de datos desde cero.

OPTCIONES

       -d, --debug
              Muestra información de depurado.

       -q, --quiet
              No muestra ningún aviso.

       -s, --no-straycats
              No dedica tiempo a buscar o añadir información a las bases de datos  sobre  páginas
              "cat" sin su correspondiente página fuente.

       -c, --create
              Por defecto, mandb intentará actualizar cualquier base de datos creada previamente.
              Si una base de datos no existe, la creará. Esta opción fuerza a mandb a  que  borre
              las  bases  de  datos  previas,  y  las  cree  de nuevo desde cero.  Esto puede ser
              necesario si la base de datos se corrompe o si un nuevo esquema  de  almacenamiento
              de base de datos se introduce en el futuro.

       -u, --user-db
              Crea  bases  de  datos  del  usuario  únicamente,  incluso si tiene los permisos de
              escritura necesarios para crear bases de datos `globales'.

       -h, --help
              Muestra el mensaje de uso, y termina.

       -V, --version
              Muestra la versión, y termina.

DIAGNÓSTICOS

       Los siguientes mensajes de aviso pueden omitirse durante la construcción de las  bases  de
       datos.

       <filename>: whatis parse for page(sec) failed
              (<fichero>: El análisis del "whatis" para la página(sección) falló).  El intento de
              extraer la línea o líneas de descripción breve del <fichero> dado  falló.  Esto  se
              debe  usualmente  a  que  la  página  de manual está pobremente escrita, pero si se
              emiten muchos mensajes como este, es probable que el sistema  contenga  páginas  de
              manual no estandar que sean incompatibles con el analizador de whatis de man-db.

       <filename>: is a dangling symlink
              (<fichero>:  es  un  enlace  perdido) <fichero> no existe, pero un enlace simbólico
              hace referencia a él.  Usualmente se emiten más diagnósticos  para  identificar  el
              nombre de fichero del enlace problemático.

       <filename>: bad symlink or ROFF `.so' request
              (<fichero>: enlace simbólico o petición ROFF `.so' incorrectos) <fichero> es o bien
              un enlace simbólico a, o contiene una petición ROFF para  incluir,  un  fichero  no
              existente.

       <filename>: ignoring bogus filename
              (<fichero>:  ignorando  nombre  falso)  El  <fichero>  puede o no ser una página de
              manual válida, pero su nombre no es válido. Esto se debe usualmente  a  páginas  de
              manual con la extensión de sección <x> que se han puesto en la sección <y>.

       <filename_mask>: competing extensions
              (<máscara_de_nombre_de_fichero>:    extensiones   que   compiten)   La   "wildcard"
              <máscara_de_nombre_de_fichero> no es única. Esto está  causado  usualmente  por  la
              existencia  de  ambas versiones, comprimida y no comprimida, de la misma página del
              manual. Se usará sólo la más reciente.

FICHEROS

       /etc/manpath.config
              fichero de configuración de man-db.

       /usr/man/index.(bt|db|dir|pag)
              Una base de datos temporal de índices tradicional.

       /var/catman/index.(bt|db|dir|pag)
              Una base de datos temporal de índices alternativa o conforme al FSSTND.

VÉASE TAMBIÉN

       man(1), manpath(5), catman(8).

AUTOR

       Wilf.   (G.Wilford@ee.surrey.ac.uk)   Traducción    realizada    por    Enrique    Zanardi
       (ezanardi@ull.es)