mandb: crea o actualiza las cachés de índice de las páginas del manual
SINOPSIS
mandb [-dqsucpt?V] [-C archivo] [ruta_man]
mandb [-dqsut] [-C archivo] -f nombre_archivo ...
DESCRIPCIÓN
mandb se utiliza para inicializar o actualizar manualmente las cachés de la base de datos de índice. Las cachés contienen información relevante para el estado actual del sistema de páginas del manual y la información almacenada en ellas se utiliza para mejorar la velocidad y la funcionalidad de las utilidades man-db.
Cuando crea o actualiza un índice, mandb advertirá sobre solicitudes ROFF .so incorrectas, nombres de archivo de página de manual incorrectos y páginas de manual desde las que no se puede analizar el comando whatis.
Proporcionar a mandb una ruta delimitada por dos puntos opcional anulará la ruta de búsqueda de la jerarquía de páginas de manual del sistema interno, determinada por la información que se encuentra en el archivo de configuración de man-db.
CACHÉS DE BASE DE DATOS
mandb se puede compilar con soporte para cualquiera de los siguientes tipos de bases de datos.
Nombre Asíncrono Nombre de archivo
Berkeley db Sí index.bt
GNU gdbm Sí index.db
UNIX ndbm No index.(dir|pag)
Los tipos de base de datos que admiten actualizaciones asíncronas proporcionan una mayor velocidad a costa de una posible corrupción en caso de una finalización inusual. En un caso inusual en el que esto haya ocurrido, puede ser necesario volver a ejecutar mandb con la opción -c para volver a crear las bases de datos desde cero.
OPCIONES
-d, --debug
Imprime información de depuración.
-q, --quiet
No genere ninguna advertencia.
-s, --no-straycats
No dedique tiempo a buscar o agregar información a las bases de datos con respecto a gatos callejeros.
-p, --no-purge
No dedique tiempo a verificar si hay páginas de manual eliminadas y eliminarlas de las bases de datos.
-c, --create
De forma predeterminada, mandb intentará actualizar cualquier base de datos creada anteriormente. Si una base de datos no existe, la creará. Esta opción obliga a mandb a eliminar las bases de datos anteriores y volver a crearlas desde cero, e implica --no-purge. Esto puede ser necesario si una base de datos se corrompe o si se introduce un nuevo esquema de almacenamiento de base de datos en el futuro.
-u, --user-db
Cree solo bases de datos de usuario, incluso si se requieren permisos de escritura para crear bases de datos del sistema.
-t, --test
Realice comprobaciones de corrección en las páginas de manual de la ruta de búsqueda de la jerarquía. Con esta opción, mandb no alterará las bases de datos existentes.
-f, --filename
Actualice solo las entradas para el nombre de archivo dado. Esta opción no es para uso general; se utiliza internamente por man cuando se ha compilado con la opción MAN_DB_UPDATES y encuentra que una página está desactualizada. Implica -p y deshabilita -c y -s.
-C archivo, --config-file=archivo
Utilice este archivo de configuración de usuario en lugar del predeterminado ~/.manpath.
-?, --help
Muestre el mensaje de uso y, a continuación, salga.
--usage
Imprima un mensaje de uso corto y salga.
-V, --version
Muestre la versión y, a continuación, salga.
ESTADO DE SALIDA
0 Ejecución exitosa del programa.
1 Error de uso, sintaxis o archivo de configuración.
2 Error operativo.
3 Un proceso secundario falló.
DIAGNÓSTICOS
Los siguientes mensajes de advertencia se pueden emitir durante la creación de la base de datos.
<nombre_archivo>: no se pudo analizar el comando whatis para la página(sec)
Se produjo un error al intentar extraer la(s) línea(s) whatis del <nombre_archivo> dado. Esto suele deberse a una página de manual mal escrita, pero si se emiten muchos de estos mensajes, es probable que el sistema contenga páginas de manual no estándar que son incompatibles con el analizador whatis de man-db. Consulte la sección WHATIS PARSING en lexgrog(1) para obtener más información.
<nombre_archivo>: es un enlace simbólico colgante
<nombre_archivo> no existe, pero se hace referencia a él mediante un enlace simbólico. Por lo general, se emiten diagnósticos adicionales para identificar el <nombre_archivo> del enlace ofensivo.
<nombre_archivo>: enlace simbólico incorrecto o solicitud ROFF `.so`
<nombre_archivo> es un enlace simbólico o contiene una solicitud de inclusión ROFF a un archivo inexistente.
<nombre_archivo>: ignorando nombre de archivo incorrecto
El <nombre_archivo> puede ser o no 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 de sección <x> que se coloca en la sección de página de manual <y>.
<máscara_nombre_archivo>: extensiones en conflicto
El comodín <máscara_nombre_archivo> no es único. Esto suele deberse a la existencia de una versión comprimida y una no comprimida de la misma página de manual. Se ignoran todas, excepto la más reciente.
ARCHIVOS
/etc/manpath.config
archivo de configuración de man-db.
/var/cache/man/index.(bt|db|dir|pag)
Una caché de base de datos de índice global compatible con FHS.
Las ubicaciones más antiguas para la caché de la base de datos incluyen:
/usr/man/index.(bt|db|dir|pag)
Una caché de base de datos de índice global tradicional.
/var/catman/index.(bt|db|dir|pag)
Una caché de base de datos de índice global alternativa o compatible con FSSTND.
VÉASE TAMBIÉN
lexgrog(1), man(1), manpath(5), catman(8)
La sección WHATIS PARSING que antes formaba parte de esta página de manual ahora forma parte de lexgrog(1).
AUTOR
Wilf. (_)
Fabrizio Polacco (_).
Colin Watson (_).
ERRORES
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db