NOMBRE¶
mandb - crea o actualiza los índices temporales de páginas del
manual
SINOPSIS¶
mandb [
-dqsuc|
-h|
-V] [
rutaal
manual]
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)