mandb - crea o actualiza las cachés de índicies de
páginas de manual
mandb [-dqsucpt?V] [-C fichero]
[manpath]
mandb [-dqsut] [-C fichero] -f
nombrefichero ...
mandb se utiliza para inicializar o actualizar manualmente
las cachés de base de datos de índices. Las
cachés contienen información relacionada con el estado actual
del sistema de páginas de manual y con la información
almacenada en ellas la utilizan las utilidades de man-db para mejorar su
velocidad y funcionalidad.
Cuando se crea o actualiza un índice, mandb
advierte de peticiones .so ROFF incorrectas, nombres falsos de ficheros de
páginas de manual y páginas de manual desde las que
whatis no puede analizar.
Suministrar a mandb una ruta opcional delimitada por dos
puntos anula la ruta de búsqueda de jerarquías de
páginas de manual del sistema interna, determinada a partir de la
información encontrada en el fichero de configuración de
man-db.
mandb puede compilarse para admitir cualquiera de los
siguientes tipos de base de datos.
Nombre |
Asíncrono |
Nombre del fichero |
Berkeley db |
Sí |
index.bt |
GNU gdbm |
Sí |
index.db |
UNIX ndbm |
No |
index.(dir|pág) |
Los tipos de base de datos que admiten actualizaciones
asíncronas ofrecen velocidad mejorada al precio de posible
corrupción en caso de finalizaciones no usuales. En un caso inusual
donde haya ocurrido esto, puede ser necesario reejecutar %nandb% con
la opción -c para recrear las bases de datos de cero.
- -d, --debug
- Escribe información de depuración.
- -q, --quiet
- No genera ninguna advertencia.
- -s,
--no-straycats
- No pierde tiempo buscando o añadiendo información a las
bases de datos en relación con ficheros cat extraviados.
- -p,
--no-purge
- No pierde tiempo comprobando páginas de manual borradas y
purgándolas desde las bases de datos.
- -c, --create
- Por defecto, mandb intenta actualizar cualquier base de datos
anteriormente creada. Si una base de datos no existe, la crea. Esta
opción obliga a mandb a borrar bases de datos anteriores y
re-crearlas desde cero, e implica --no-purge.. Esto puede ser
necesario si una 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 solamente bases de datos de usuario, incluso con los permisos de
escritura necesarios para crear bases de datos del sistema.
- -t, --test
- Realiza comprobaciones de corrección en páginas de manual
dentro de la ruta de búsqueda de la jerarquía. Con esta
opción, mandb no altera las bases de datos existentes.
- -f,
--filename
- Actualiza solo las entradas para el nombre de fichero dado. Esta
opción no es para uso general; la utiliza man internamente
cuando se ha compilado con la opción MAN_DB_UPDATES y
descubre que una página está desactualizada. Implica
-p y desactiva -c y -s.
- -C fichero, --config-file=fichero
- Utilice este fichero de configuracion de usuario en lugar del
predeterminado según ~/.manpath.
- -?, --help
- Muestra el mensaje de modo de empleo; después finaliza.
- --usage
- Escribe mensaje breve sobre uso del programa y termina.
- -V, --version
- Muestra la versión; después finaliza.
- 0
- Ejecución del programa correcta.
- 1
- Error en el modo de empleo, de sintaxis o en el fichero de
configuración.
- 2
- Error operacional.
- 3
- Falló un subproceso.
Los siguientes mensajes de advertencia pueden ser emitidon durante
la construcción de base de datos.
- <nombre de fichero>: fallo de whatis al analizar
página(sec)
- El intento de extraer línea(s) de whatis desde el <nombre de
fichero> indicado ha fallado. Suele ser debido a una página de
manual pobremente escrita, pero si se emiten muchos mensajes como este, es
probable que el sistema contenga páginas de manual no
estándar que no son compatibles con el analizador de whatis de
man-db. Véase la sección ANÁLISIS WHATIS en
lexgrog(1) para más información.
- <nombre de fichero>: es un enlace simbólico
- <nombre de fichero> no existe pero está referenciado por un
enlace simbólico. Suelen emitirse más diagnósticos
para identificar el <nombre de fichero> del enlace que está
mal.
- <nombre de fichero>: enlace simbólico o solicitud ROFF
`.so' incorrectos
- <nombre de fichero> es un enlace simbólico, o contiene una
solicitud de inclusión ROFF, a un fichero que no existe.
- <nombre fichero>: se hace caso omiso del nombre de fichero
falso
- El <nombre de fichero> puede o no ser una página de manual
válida pero su nombre no es válido. Esto suele deberse a una
página de manual con extensión seccional <x> que
está puesta en la sección de la página de manual
<y>.
- <máscara_nombrefichero>: extensiones compitiendo
- El comodín <máscara_nombrefichero> no es único.
Esto normalmente es a causa de la existencia tanto de una versión
comprimida como de una no comprimida de la misma página de manual.
Se hace caso omiso de todas excepto de la más reciente.
- /etc/manpath.config
- fichero de configuración de man-db.
- /var/cache/man/index.(bt|db|dir|pag)
- Una caché de BD indexado compatible con FHS.
Se incluyen ubicaciones más antiguas de la caché de
la base de datos:
- /usr/man/index.(bt|db|dir|pag)
- Una caché de BD indexada global tradicional.
- /var/catman/index.(bt|db|dir|pag)
- Un caché de base de datos de índices global
alternativa o compatible FSSTND.
Wilf. (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Colin Watson (cjwatson@debian.org).
https://savannah.nongnu.org/bugs/?group=man-db