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 v >= 1.6   "Hashed"        Sí      index.db
       GNU gdbm v <  1.6   "Hashed"        No      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)

2.6.7.1                                            2014-04-10                                           MANDB(8)