'\" t
.\" Man page for mandb
.\"
.\" Copyright (C) 1994, 1995, Graeme W. Wilford. (Wilf.)
.\" Copyright (C) 2001-2019 Colin Watson.
.\"
.\" You may distribute under the terms of the GNU General Public
.\" License as specified in the file COPYING that comes with the
.\" man-db distribution.
.\"
.\" Tue Apr 26 12:56:44 BST 1994  Wilf. (G.Wilford@ee.surrey.ac.uk)
.\"
.pc ""
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH MANDB 8 2020-06-22 2.9.3 "Utilidades del paginador del manual"
.SH NOMBRE
mandb \- crea o actualiza las cachés de índicies de páginas de manual
.SH SINOPSIS
\fBmandb\fP [\|\fB\-dqsucpt?V\fP\|] [\|\fB\-C\fP \fIfichero\fP\|] [\|\fImanpath\fP\|]
.br
\fBmandb\fP [\|\fB\-dqsut\fP\|] [\|\fB\-C\fP \fIfichero\fP\|] \fB\-f\fP \fInombrefichero\fP\ \&.\|.\|.
.SH DESCRIPCIÓN
\fBmandb\fP se utiliza para inicializar o actualizar manualmente las cachés
de base de datos de \fBíndices\fP.  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 \fBíndice\fP, \fBmandb\fP advierte de peticiones
\&.so ROFF incorrectas, nombres falsos de ficheros de páginas de manual y
páginas de manual desde las que \fBwhatis\fP no puede analizar.

Suministrar a \fBmandb\fP 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.
.SH "CACHÉS DE BASE DE DATOS"
\fBmandb\fP puede compilarse para admitir cualquiera de los siguientes tipos
de base de datos.

.TS
tab (@);
l lw(20m) l l.
Nombre@Tipo@Asíncrono@Nombre del fichero
_
Berkeley db@T{
Árbol binario
T}@Sí@\fIindex.bt\fP
GNU gdbm@T{
Firmado Hash
T}@Sí@\fIindex.db\fP
UNIX ndbm@T{
Firmado Hash
T}@No@\fIindex.(dir|pág)\fP
.TE

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 \fB%nandb%\fP con la opción \fB\-c\fP para recrear las bases
de datos de cero.
.SH OPCIONES
.TP 
.if  !'po4a'hide' .BR \-d ", " \-\-debug
Escribe información de depuración.
.TP 
.if  !'po4a'hide' .BR \-q ", " \-\-quiet
No genera ninguna advertencia.
.TP 
.if  !'po4a'hide' .BR \-s ", " \-\-no-straycats
No pierde tiempo buscando o añadiendo información a las bases de datos en
relación con ficheros cat extraviados.
.TP 
.if  !'po4a'hide' .BR \-p ", " \-\-no-purge
No pierde tiempo comprobando páginas de manual borradas y purgándolas desde
las bases de datos.
.TP 
.if  !'po4a'hide' .BR \-c ", " \-\-create
Por defecto, \fBmandb\fP intenta actualizar cualquier base de datos
anteriormente creada.  Si una base de datos no existe, la crea.  Esta opción
obliga a \fBmandb\fP a borrar bases de datos anteriores y re\-crearlas desde
cero, e implica \fB\-\-no\-purge.\fP. 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.
.TP 
.if  !'po4a'hide' .BR \-u ", " \-\-user-db
Crea solamente bases de datos de usuario, incluso con los permisos de
escritura necesarios para crear bases de datos del sistema.
.TP 
.if  !'po4a'hide' .BR \-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, \fBmandb\fP no altera las
bases de datos existentes.
.TP 
.if  !'po4a'hide' .BR \-f ", " \-\-filename
Actualiza solo las entradas para el nombre de fichero dado.  Esta opción no
es para uso general; la utiliza \fBman\fP internamente cuando se ha compilado
con la opción \fBMAN_DB_UPDATES\fP y descubre que una página está
desactualizada.  Implica \fB\-p\fP y desactiva \fB\-c\fP y \fB\-s\fP.
.TP 
\fB\-C\ \fP\fIfichero\fP,\ \fB\-\-config\-file=\fP\fIfichero\fP
Utilice este fichero de configuracion de usuario en lugar del predeterminado
según \fI~/.manpath\fP.
.TP 
.if  !'po4a'hide' .BR \-? ", " \-\-help
Muestra el mensaje de modo de empleo; después finaliza.
.TP 
.if  !'po4a'hide' .B \-\-usage
Escribe mensaje breve sobre uso del programa y termina.
.TP 
.if  !'po4a'hide' .BR \-V ", " \-\-version
Muestra la versión; después finaliza.
.SH "ESTADO DE SALIDA"
.TP 
.if  !'po4a'hide' .B 0
Ejecución del programa correcta.
.TP 
.if  !'po4a'hide' .B 1
Error en el modo de empleo, de sintaxis o en el fichero de configuración.
.TP 
.if  !'po4a'hide' .B 2
Error operacional.
.TP 
.if  !'po4a'hide' .B 3
Falló un subproceso.
.SH DIAGNÓSTICO
Los siguientes mensajes de advertencia pueden ser emitidon durante la
construcción de base de datos.
.TP 
\fB<nombre de fichero>: fallo de whatis al analizar página(sec)\fP
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 \fBANÁLISIS WHATIS\fP
en \fBlexgrog\fP(1)  para más información.
.TP 
\fB<nombre de fichero>: es un enlace simbólico\fP
<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.
.TP 
\fB<nombre de fichero>: enlace simbólico o solicitud ROFF `.so' incorrectos\fP
<nombre de fichero> es un enlace simbólico, o contiene una solicitud
de inclusión ROFF, a un fichero que no existe.
.TP 
\fB<nombre fichero>: se hace caso omiso del nombre de fichero falso\fP
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>.
.TP 
\fB<máscara_nombrefichero>: extensiones compitiendo\fP
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.
.SH FICHEROS
.TP 
.if  !'po4a'hide' .I /etc/man_db.conf
fichero de configuración de man\-db.
.TP 
.if  !'po4a'hide' .I /var/cache/man/index.(bt|db|dir|pag)
Una caché de BD \fIindexado\fP compatible con FHS.
.PP
Se incluyen ubicaciones más antiguas de la caché de la base de datos:
.TP 
.if  !'po4a'hide' .I /usr/man/index.(bt|db|dir|pag)
Una caché de BD \fIindexada\fP global tradicional.
.TP 
.if  !'po4a'hide' .I /var/catman/index.(bt|db|dir|pag)
Un caché de base de datos de \fIíndices\fP global alternativa o compatible
FSSTND.
.SH "VÉASE TAMBIÉN"
.if  !'po4a'hide' .BR lexgrog (1),
.if  !'po4a'hide' .BR man (1),
.if  !'po4a'hide' .BR manpath (5),
.if  !'po4a'hide' .BR catman (8)
.PP
La sección \fBANÁLISIS\fP anteriormente en esta página de manual ahora es parte
de \fBlexgrog\fP(1).
.SH AUTOR
.nf
.if  !'po4a'hide' Wilf.\& (G.Wilford@ee.surrey.ac.uk).
.if  !'po4a'hide' Fabrizio Polacco (fpolacco@debian.org).
.if  !'po4a'hide' Colin Watson (cjwatson@debian.org).
.fi
.SH DEFECTOS
.if  !'po4a'hide' https://savannah.nongnu.org/bugs/?group=man-db
