272 lines
8.6 KiB
HTML
272 lines
8.6 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: Utilitários de paginação de 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>NOME</H2>
|
|
|
|
mandb - cria ou atualiza os caches de índices de página de manual
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SINOPSE</H2>
|
|
|
|
<B>mandb</B> [<B>-dqsucpt?V</B>] [<B>-C</B> <I>arquivo</I>] [<I>caminho man</I>]
|
|
<BR>
|
|
|
|
<B>mandb</B> [<B>-dqsut</B>] [<B>-C</B> <I>arquivo</I>] <B>-f</B> <I>arquivo</I> ...
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIÇÃO</H2>
|
|
|
|
<B>mandb</B> é usado para inicializar ou atualizar manualmente os caches de
|
|
banco de dados <B>index</B>. Os caches contêm informações relevantes para o
|
|
estado atual do sistema de página de manual e as informações armazenadas
|
|
neles pelos utilitários do man-db para melhorar sua velocidade e
|
|
funcionalidade.
|
|
<P>
|
|
Ao criar ou atualizar um <B>index</B>, <B>mandb</B> vai avisar sobre requisições
|
|
".so" inválidas de ROFF, nomes de arquivos inválidos de página de manual e
|
|
páginas de manual dos quais não é possível realizar análise com <B>whatis</B>.
|
|
<P>
|
|
Fornecer <B>mandb</B> com um caminho opcional, delimitado por caractere de
|
|
dois pontos, sobrescreverá o caminho interno de pesquisa da hierarquia de
|
|
página de manual do sistema, determinado de informações localizadas dentro
|
|
do arquivo de configuração do man-db.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>CACHES DE BANCO DE DADOS</H2>
|
|
|
|
<B>mandb</B> pode ser compilado com suporte para qualquer um dos tipos de
|
|
banco de dados a seguir.
|
|
<P>
|
|
<TABLE>
|
|
<TR VALIGN=top><TD>Nome</TD><TD>Tipo</TD><TD>Assíncrono</TD><TD>Nome de arquivo<BR></TD></TR>
|
|
<TR VALIGN=top><TD COLSPAN=4><HR></TD></TR>
|
|
<TR VALIGN=top><TD>Berkeley DB</TD><TD>
|
|
Árvore binária
|
|
</TD><TD>Sim</TD><TD><I>índice.bt</I><BR></TD></TR>
|
|
<TR VALIGN=top><TD>GNU gdbm</TD><TD>
|
|
Hash
|
|
</TD><TD>Sim</TD><TD><I>índice.db</I><BR></TD></TR>
|
|
<TR VALIGN=top><TD>UNIX ndbm</TD><TD>
|
|
Hash
|
|
</TD><TD>Não</TD><TD><I>índice.(dir|pag)</I><BR></TD></TR>
|
|
</TABLE>
|
|
|
|
<P>
|
|
Aqueles tipos de banco de dados que oferecem suporte a atualizações
|
|
assíncronas fornecem velocidade melhorada ao custo de possível corrupção no
|
|
evento de uma terminal anormal. No caso de ocorrência de terminação anormal,
|
|
pode ser necessário reexecutar <B>mandb</B> com a opção <B>-c</B> para recriar os
|
|
bancos de dados do zero.
|
|
<A NAME="lbAF"> </A>
|
|
<H2>OPÇÕES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-d</B>, <B>--debug</B>
|
|
|
|
|
|
<DD>
|
|
Emite mensagens de depuração.
|
|
<DT id="2"><B>-q</B>, <B>--quiet</B>
|
|
|
|
|
|
<DD>
|
|
Produz nenhum aviso.
|
|
<DT id="3"><B>-s</B>, <B>--no-straycats</B>
|
|
|
|
|
|
<DD>
|
|
Não gasta tempo procurando por ou adicionando informações para os bancos de
|
|
dados referente a cats errantes.
|
|
<DT id="4"><B>-p</B>, <B>--no-purge</B>
|
|
|
|
|
|
<DD>
|
|
Não gasta tempo verificando páginas de manuais excluídas e apagando-as dos
|
|
bancos de dados.
|
|
<DT id="5"><B>-c</B>, <B>--create</B>
|
|
|
|
|
|
<DD>
|
|
Por padrão, <B>mandb</B> tentará atualizar quaisquer bancos de dados
|
|
previamente criados. Se um banco de dados não existe, ele o criará. Essa
|
|
opção força <B>mandb</B> a excluir bancos de dados anteriores e recriá-lo do
|
|
zero, e resulta em <B>--no-purge</B>. Isso pode ser necessário se um banco de
|
|
dados acabar sendo corrompido ou se um novo esquema de armazenamento de
|
|
banco de dados for introduzido no futuro.
|
|
<DT id="6"><B>-u</B>, <B>--user-db</B>
|
|
|
|
|
|
<DD>
|
|
Cria apenas bancos de dados de usuário, mesmo com as permissões de escrita
|
|
necessárias para criar bancos de dados do sistema.
|
|
<DT id="7"><B>-t</B>, <B>--test</B>
|
|
|
|
|
|
<DD>
|
|
Realiza verificações corretivas em páginas de manual no caminho de pesquisa
|
|
hierárquico. Com essa opção, <B>mandb</B> não alterará bancos de dados
|
|
existentes.
|
|
<DT id="8"><B>-f</B>, <B>--filename</B>
|
|
|
|
|
|
<DD>
|
|
Atualiza apenas as entradas para o arquivo fornecido. Essa opção não é para
|
|
uso geral; é usada internalmente pelo <B>man</B> quando compilado com a opção
|
|
<B>MAN_DB_UPDATES</B> e descobre que uma página está desatualizada. Ele resulta
|
|
em <B>-p</B> e desabilita <B>-c</B> e <B>-s</B>.
|
|
<DT id="9"><B>-C </B><I>arquivo</I>, <B>--config-file=</B><I>arquivo</I><DD>
|
|
Usa esse arquivo de configuração de usuário em vez do padrão <I>~/.manpath</I>.
|
|
<DT id="10"><B>-?</B>, <B>--help</B>
|
|
|
|
|
|
<DD>
|
|
Mostra a mensagem de uso e, então, sai.
|
|
<DT id="11"><B>--usage</B>
|
|
|
|
|
|
<DD>
|
|
Imprime uma mensagem curta e sai.
|
|
<DT id="12"><B>-V</B>, <B>--version</B>
|
|
|
|
|
|
<DD>
|
|
Mostra a versão e, então, sai.
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>STATUS DE SAÍDA</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="13"><B>0</B>
|
|
|
|
|
|
<DD>
|
|
Execução com sucesso do programa.
|
|
<DT id="14"><B>1</B>
|
|
|
|
|
|
<DD>
|
|
Erro de uso, sintaxe ou arquivo de configuração.
|
|
<DT id="15"><B>2</B>
|
|
|
|
|
|
<DD>
|
|
Erro operacional.
|
|
<DT id="16"><B>3</B>
|
|
|
|
|
|
<DD>
|
|
Um processo filho falhou.
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>DIAGNÓSTICOS</H2>
|
|
|
|
As mensagens de aviso a seguir podem ser emitidas durante a construção do
|
|
banco de dados.
|
|
<DL COMPACT>
|
|
<DT id="17"><B><arquivo>: análise por whatis para página(seção) falhou</B><DD>
|
|
Uma tentativa de extrair linha(s) do whatis a partir do <arquivo>
|
|
falhou. Isso geralmente ocorre por causa de páginas de manual mal escritas,
|
|
mas se muitas dessas mensagens forem emitidas, é possível que o sistema
|
|
contenha páginas de manual que estejam fora do padrão e sejam incompatíveis
|
|
com o analisador whatis do man-db. Veja a seção <B>ANÁLISE COM WHATIS</B> no
|
|
<B><A HREF="/cgi-bin/man/man2html?1+lexgrog">lexgrog</A></B>(1) para mais informações.
|
|
<DT id="18"><B><arquivo>: é um link simbólico perdido</B><DD>
|
|
<arquivo> não existe, mas é referenciado por um link simbólico. Mais
|
|
diagnósticos geralmente são emitidos para identificar o <arquivo> do
|
|
link em questão.
|
|
<DT id="19"><B><arquivo>: link simbólico ruim ou requisição ".so" ROFF</B><DD>
|
|
<arquivo> é um link simbólico para, ou contém um ROFF inclui
|
|
requisição para, um arquivo não existente.
|
|
<DT id="20"><B><arquivo>: ignorando nome de arquivo inválido</B><DD>
|
|
O <arquivo> pode ou não ser uma página de manual válida, mas seu
|
|
nome é inválido. Isso geralmente ocorre por uma página de manual com
|
|
extensão de seção <x> ser colocada na seção <y> da página de
|
|
manual.
|
|
<DT id="21"><B><máscara_arquivo>: extensões conflitantes</B><DD>
|
|
O curinga <máscara_arquivo> não é única. Isso geralmente é causado
|
|
pela existência de ambos versões comprimidas e não comprimidas da mesma
|
|
página de manual. Todas além da mais recente são ignoradas.
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>ARQUIVOS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="22"><I>/etc/manpath.config</I>
|
|
|
|
|
|
<DD>
|
|
O arquivo de configuração do man-db.
|
|
<DT id="23"><I>/var/cache/man/index.(bt|db|dir|pag)</I>
|
|
|
|
|
|
<DD>
|
|
Um cache global de banco de dados <I>index</I> compatível com FHS.
|
|
</DL>
|
|
<P>
|
|
|
|
Localizações mais antigas para cache de banco de dados incluíam:
|
|
<DL COMPACT>
|
|
<DT id="24"><I>/usr/man/index.(bt|db|dir|pag)</I>
|
|
|
|
|
|
<DD>
|
|
Um cache global de banco de dados <I>index</I> tradicional.
|
|
<DT id="25"><I>/var/catman/index.(bt|db|dir|pag)</I>
|
|
|
|
|
|
<DD>
|
|
Um cache global de banco de dados <I>index</I> alternativo ou compatível com
|
|
FSSTND.
|
|
</DL>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>VEJA TAMBÉM</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>
|
|
|
|
A seção <B>ANÁLISE COM WHATIS</B>, anteriormente desta página de manual, agora é
|
|
parte do <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">NOME</A><DD>
|
|
<DT id="27"><A HREF="#lbAC">SINOPSE</A><DD>
|
|
<DT id="28"><A HREF="#lbAD">DESCRIÇÃO</A><DD>
|
|
<DT id="29"><A HREF="#lbAE">CACHES DE BANCO DE DADOS</A><DD>
|
|
<DT id="30"><A HREF="#lbAF">OPÇÕES</A><DD>
|
|
<DT id="31"><A HREF="#lbAG">STATUS DE SAÍDA</A><DD>
|
|
<DT id="32"><A HREF="#lbAH">DIAGNÓSTICOS</A><DD>
|
|
<DT id="33"><A HREF="#lbAI">ARQUIVOS</A><DD>
|
|
<DT id="34"><A HREF="#lbAJ">VEJA TAMBÉM</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:06:21 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|