MANDB(8) Utilidades de paginador del manual MANDB(8) NOMBRE mandb - crea o actualiza las caches de indicies de paginas de manual SINOPSIS mandb [-dqsucpt?V] [-C archivo] [manpath] mandb [-dqsut] [-C archivo] -f nombrearchivo ... DESCRIPCION mandb se utiliza para inicializar o actualizar manualmente las caches de base de datos de indices. Las caches contienen informacion relacionada con el estado actual del sistema de paginas de manual y su informacion la usan las utilidades de man-db para mejorar su velocidad y funcionalidad. Cuando se crea o actualiza un indice, mandb advierte de peticiones .so ROFF incorrectas, nombres falsos de archivos de paginas de manual y paginas de manual desde las que whatis no puede analizar. Suministrar a mandb una ruta opcional delimitada por dos puntos anula la ruta de busqueda de jerarquias de paginas de manual del sistema interna, determinada a partir de la informacion encontrada en el archivo de configuracion de man-db. CACHES DE BASE DE DATOS mandb puede compilarse para admitir cualquiera de los siguientes tipos de base de datos. Nombre Asincrono Nombre del archivo ----------------------------------------------- Berkeley db Si index.bt GNU gdbm Si index.db UNIX ndbm No index.(dir|pag) Los tipos de base de datos que admiten actualizaciones asincronas ofrecen velocidad mejorada al precio de posible corrupcion en caso de finalizaciones no usuales. En un caso inusual donde haya ocurrido esto, puede ser necesario reejecutar %nandb% con la opcion -c para recrear las bases de datos de cero. OPCIONES -d, --debug Escribe informacion de depuracion. -q, --quiet No genera ninguna advertencia. -s, --no-straycats No pierde tiempo buscando o anadiendo informacion a las bases de datos en relacion con archivos cat extraviados. -p, --no-purge No pierde tiempo comprobando paginas de manual borradas y purgandolas 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 opcion 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 correccion en paginas de manual dentro de la ruta de busqueda de la jerarquia. Con esta opcion, mandb no altera las bases de datos existentes. -f, --filename Actualiza solo las entradas para el nombre de archivo dado. Esta opcion no es para uso general; la utiliza man internamente cuando se ha compilado con la opcion MAN_DB_UPDATES y descubre que una pagina esta desactualizada. Implica -p y desactiva -c y -s. -C archivo, --config-file=archivo Use this user configuration file rather than the default of ~/.manpath. -?, --help Muestra el mensaje de modo de empleo; despues finaliza. --usage Escribe mensaje breve sobre uso del programa y termina. -V, --version Muestra la version; despues finaliza. ESTADO DE SALIDA 0 Ejecucion del programa correcta. 1 Error en el modo de empleo, de sintaxis o en el archivo de configuracion. 2 Error operacional. 3 Fallo un subproceso. DIAGNOSTICO Los siguientes mensajes de advertencia pueden ser emitidos durante la construccion de base de datos. : fallo de whatis al analizar pagina(sec) El intento de extraer linea(s) de whatis desde el indicado ha fallado. Suele ser debido a una pagina de manual pobremente escrita, pero si se emiten muchos mensajes como este, es probable que el sistema contenga paginas de manual no estandar que no son compatibles con el analizador de whatis de man-db. Vease la seccion ANALISIS WHATIS en lexgrog(1) para mas informacion. : es un enlace simbolico no existe pero esta referenciado por un enlace simbolico. Suelen emitirse mas diagnosticos para identificar el del enlace que esta mal. : enlace simbolico o solicitud ROFF `.so' incorrectos es un enlace simbolico, o contiene una solicitud de inclusion ROFF, a un archivo que no existe. : se hace caso omiso del nombre de archivo falso El puede o no ser una pagina de manual valida pero su nombre no es valido. Esto suele deberse a una pagina de manual con extension seccional que esta puesta en la seccion de la pagina de manual . : extensiones compitiendo El comodin no es unico. Esto normalmente es a causa de la existencia tanto de una version comprimida como de una no comprimida de la misma pagina de manual. Se hace caso omiso de todas excepto de la mas reciente. ARCHIVOS /etc/man_db.conf archivo de configuracion de man-db. /var/cache/man/index.(bt|db|dir|pag) Una cache de BD de indexado global compatible con FHS. Se incluyen ubicaciones mas antiguas de la cache de la base de datos: /usr/man/index.(bt|db|dir|pag) Una cache de BD de indexado global tradicional. /var/catman/index.(bt|db|dir|pag) Un cache de base de datos de indexado global alternativa o compatible con FSSTND. VEASE TAMBIEN lexgrog(1), man(1), manpath(5), catman(8) La seccion ANALISIS anteriormente en esta pagina de manual ahora es parte de lexgrog(1). AUTOR Wilf. (G.Wilford@ee.surrey.ac.uk). Fabrizio Polacco (fpolacco@debian.org). Colin Watson (cjwatson@debian.org). DEFECTOS https://gitlab.com/man-db/man-db/-/issues https://savannah.nongnu.org/bugs/?group=man-db 2.12.1 2024-04-05 MANDB(8)