274 lines
8.8 KiB
HTML
274 lines
8.8 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of MANDB</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>MANDB</H1>
|
|
Section: Utilidades del paginador del manual (8)<BR>Updated: 2020-02-25<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NOMBRE</H2>
|
|
|
|
mandb - crea o actualiza las cachés de índicies de páginas de manual
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SINOPSIS</H2>
|
|
|
|
<B>mandb</B> [<B>-dqsucpt?V</B>] [<B>-C</B> <I>fichero</I>] [<I>manpath</I>]
|
|
<BR>
|
|
|
|
<B>mandb</B> [<B>-dqsut</B>] [<B>-C</B> <I>fichero</I>] <B>-f</B> <I>nombrefichero</I> ...
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPCIÓN</H2>
|
|
|
|
<B>mandb</B> se utiliza para inicializar o actualizar manualmente las cachés
|
|
de base de datos de <B>índices</B>. 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.
|
|
<P>
|
|
Cuando se crea o actualiza un <B>índice</B>, <B>mandb</B> advierte de peticiones
|
|
.so ROFF incorrectas, nombres falsos de ficheros de páginas de manual y
|
|
páginas de manual desde las que <B>whatis</B> no puede analizar.
|
|
<P>
|
|
Suministrar a <B>mandb</B> 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.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>CACHÉS DE BASE DE DATOS</H2>
|
|
|
|
<B>mandb</B> puede compilarse para admitir cualquiera de los siguientes tipos
|
|
de base de datos.
|
|
<P>
|
|
<TABLE>
|
|
<TR VALIGN=top><TD>Nombre</TD><TD>Tipo</TD><TD>Asíncrono</TD><TD>Nombre del fichero<BR></TD></TR>
|
|
<TR VALIGN=top><TD COLSPAN=4><HR></TD></TR>
|
|
<TR VALIGN=top><TD>Berkeley db</TD><TD>
|
|
Árbol binario
|
|
</TD><TD>Sí</TD><TD><I>index.bt</I><BR></TD></TR>
|
|
<TR VALIGN=top><TD>GNU gdbm</TD><TD>
|
|
Firmado Hash
|
|
</TD><TD>Sí</TD><TD><I>index.db</I><BR></TD></TR>
|
|
<TR VALIGN=top><TD>UNIX ndbm</TD><TD>
|
|
Firmado Hash
|
|
</TD><TD>No</TD><TD><I>index.(dir|pág)</I><BR></TD></TR>
|
|
</TABLE>
|
|
|
|
<P>
|
|
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 <B>%nandb%</B> con la opción <B>-c</B> para recrear las bases
|
|
de datos de cero.
|
|
<A NAME="lbAF"> </A>
|
|
<H2>OPCIONES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-d</B>, <B>--debug</B>
|
|
|
|
|
|
<DD>
|
|
Escribe información de depuración.
|
|
<DT id="2"><B>-q</B>, <B>--quiet</B>
|
|
|
|
|
|
<DD>
|
|
No genera ninguna advertencia.
|
|
<DT id="3"><B>-s</B>, <B>--no-straycats</B>
|
|
|
|
|
|
<DD>
|
|
No pierde tiempo buscando o añadiendo información a las bases de datos en
|
|
relación con ficheros cat extraviados.
|
|
<DT id="4"><B>-p</B>, <B>--no-purge</B>
|
|
|
|
|
|
<DD>
|
|
No pierde tiempo comprobando páginas de manual borradas y purgándolas desde
|
|
las bases de datos.
|
|
<DT id="5"><B>-c</B>, <B>--create</B>
|
|
|
|
|
|
<DD>
|
|
Por defecto, <B>mandb</B> intenta actualizar cualquier base de datos
|
|
anteriormente creada. Si una base de datos no existe, la crea. Esta opción
|
|
obliga a <B>mandb</B> a borrar bases de datos anteriores y re-crearlas desde
|
|
cero, e implica <B>--no-purge.</B>. 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.
|
|
<DT id="6"><B>-u</B>, <B>--user-db</B>
|
|
|
|
|
|
<DD>
|
|
Crea solamente bases de datos de usuario, incluso con los permisos de
|
|
escritura necesarios para crear bases de datos del sistema.
|
|
<DT id="7"><B>-t</B>, <B>--test</B>
|
|
|
|
|
|
<DD>
|
|
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, <B>mandb</B> no altera las
|
|
bases de datos existentes.
|
|
<DT id="8"><B>-f</B>, <B>--filename</B>
|
|
|
|
|
|
<DD>
|
|
Actualiza solo las entradas para el nombre de fichero dado. Esta opción no
|
|
es para uso general; la utiliza <B>man</B> internamente cuando se ha compilado
|
|
con la opción <B>MAN_DB_UPDATES</B> y descubre que una página está
|
|
desactualizada. Implica <B>-p</B> y desactiva <B>-c</B> y <B>-s</B>.
|
|
<DT id="9"><B>-C </B><I>fichero</I>, <B>--config-file=</B><I>fichero</I><DD>
|
|
Utilice este fichero de configuracion de usuario en lugar del predeterminado
|
|
según <I>~/.manpath</I>.
|
|
<DT id="10"><B>-?</B>, <B>--help</B>
|
|
|
|
|
|
<DD>
|
|
Muestra el mensaje de modo de empleo; después finaliza.
|
|
<DT id="11"><B>--usage</B>
|
|
|
|
|
|
<DD>
|
|
Escribe mensaje breve sobre uso del programa y termina.
|
|
<DT id="12"><B>-V</B>, <B>--version</B>
|
|
|
|
|
|
<DD>
|
|
Muestra la versión; después finaliza.
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>ESTADO DE SALIDA</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="13"><B>0</B>
|
|
|
|
|
|
<DD>
|
|
Ejecución del programa correcta.
|
|
<DT id="14"><B>1</B>
|
|
|
|
|
|
<DD>
|
|
Error en el modo de empleo, de sintaxis o en el fichero de configuración.
|
|
<DT id="15"><B>2</B>
|
|
|
|
|
|
<DD>
|
|
Error operacional.
|
|
<DT id="16"><B>3</B>
|
|
|
|
|
|
<DD>
|
|
Falló un subproceso.
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>DIAGNÓSTICO</H2>
|
|
|
|
Los siguientes mensajes de advertencia pueden ser emitidon durante la
|
|
construcción de base de datos.
|
|
<DL COMPACT>
|
|
<DT id="17"><B><nombre de fichero>: fallo de whatis al analizar página(sec)</B><DD>
|
|
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 <B>ANÁLISIS WHATIS</B>
|
|
en <B><A HREF="/cgi-bin/man/man2html?1+lexgrog">lexgrog</A></B>(1) para más información.
|
|
<DT id="18"><B><nombre de fichero>: es un enlace simbólico</B><DD>
|
|
<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.
|
|
<DT id="19"><B><nombre de fichero>: enlace simbólico o solicitud ROFF `.so' incorrectos</B><DD>
|
|
<nombre de fichero> es un enlace simbólico, o contiene una solicitud
|
|
de inclusión ROFF, a un fichero que no existe.
|
|
<DT id="20"><B><nombre fichero>: se hace caso omiso del nombre de fichero falso</B><DD>
|
|
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>.
|
|
<DT id="21"><B><máscara_nombrefichero>: extensiones compitiendo</B><DD>
|
|
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.
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>FICHEROS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="22"><I>/etc/manpath.config</I>
|
|
|
|
|
|
<DD>
|
|
fichero de configuración de man-db.
|
|
<DT id="23"><I>/var/cache/man/index.(bt|db|dir|pag)</I>
|
|
|
|
|
|
<DD>
|
|
Una caché de BD <I>indexado</I> compatible con FHS.
|
|
</DL>
|
|
<P>
|
|
|
|
Se incluyen ubicaciones más antiguas de la caché de la base de datos:
|
|
<DL COMPACT>
|
|
<DT id="24"><I>/usr/man/index.(bt|db|dir|pag)</I>
|
|
|
|
|
|
<DD>
|
|
Una caché de BD <I>indexada</I> global tradicional.
|
|
<DT id="25"><I>/var/catman/index.(bt|db|dir|pag)</I>
|
|
|
|
|
|
<DD>
|
|
Un caché de base de datos de <I>índices</I> global alternativa o compatible
|
|
FSSTND.
|
|
</DL>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>VÉASE TAMBIÉN</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+lexgrog">lexgrog</A></B>(1),
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+man">man</A></B>(1),
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+manpath">manpath</A></B>(5),
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+catman">catman</A></B>(8)
|
|
|
|
|
|
<P>
|
|
|
|
La sección <B>ANÁLISIS</B> anteriormente en esta página de manual ahora es parte
|
|
de <B><A HREF="/cgi-bin/man/man2html?1+lexgrog">lexgrog</A></B>(1).
|
|
<A NAME="lbAK"> </A>
|
|
<H2>AUTOR</H2>
|
|
|
|
<PRE>
|
|
Wilf. (<A HREF="mailto:G.Wilford@ee.surrey.ac.uk">G.Wilford@ee.surrey.ac.uk</A>).Fabrizio Polacco (<A HREF="mailto:fpolacco@debian.org">fpolacco@debian.org</A>).Colin Watson (<A HREF="mailto:cjwatson@debian.org">cjwatson@debian.org</A>).</PRE>
|
|
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="26"><A HREF="#lbAB">NOMBRE</A><DD>
|
|
<DT id="27"><A HREF="#lbAC">SINOPSIS</A><DD>
|
|
<DT id="28"><A HREF="#lbAD">DESCRIPCIÓN</A><DD>
|
|
<DT id="29"><A HREF="#lbAE">CACHÉS DE BASE DE DATOS</A><DD>
|
|
<DT id="30"><A HREF="#lbAF">OPCIONES</A><DD>
|
|
<DT id="31"><A HREF="#lbAG">ESTADO DE SALIDA</A><DD>
|
|
<DT id="32"><A HREF="#lbAH">DIAGNÓSTICO</A><DD>
|
|
<DT id="33"><A HREF="#lbAI">FICHEROS</A><DD>
|
|
<DT id="34"><A HREF="#lbAJ">VÉASE TAMBIÉN</A><DD>
|
|
<DT id="35"><A HREF="#lbAK">AUTOR</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:00 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|