270 lines
8.4 KiB
HTML
270 lines
8.4 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 do paginador do 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 actualiza as caches de índice das páginas do manual
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SINOPSE</H2>
|
|
|
|
<B>mandb</B> [<B>-dqsucpt?V</B>] [<B>-C</B> <I>ficheiro</I>] [<I>manpath</I>]
|
|
<BR>
|
|
|
|
<B>mandb</B> [<B>-dqsut</B>] [<B>-C</B> <I>ficheiro</I>] <B>-f</B> <I>nomeficheiro</I> ...
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIÇÃO</H2>
|
|
|
|
<B>mandb</B> é usado para inicializar ou actualizar manualmente as caches de
|
|
bases de dados <B>índice</B>. As caches contêm informação relevante sobre o
|
|
estado actual do sistema de páginas do manual e a informação nelas
|
|
armazenada é usada pelos utilitários do man-db para melhorar a sua
|
|
velocidade e funcionalidade.
|
|
<P>
|
|
Ao criar ou actualizar um <B>índice</B>, <B>mandb</B> avisa sobre maus pedidos .so
|
|
ROFF, nomes de ficheiro de páginas do manual fictícios e páginas do manual
|
|
das quais não consegue analisar o <B>whatis</B>.
|
|
<P>
|
|
Fornecer a <B>mandb</B> um caminho opcional separado por dois-pontos
|
|
sobrepõe-se ao caminho interno de procura de hierarquias de páginas do
|
|
manual, determinado por informação dentro do ficheiro de configuração do
|
|
man-db.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>CACHES DE BASES DE DADOS</H2>
|
|
|
|
<B>mandb</B> pode ser compilado com suporte a qualquer um dos seguintes tipos
|
|
de bases de dados.
|
|
<P>
|
|
<TABLE>
|
|
<TR VALIGN=top><TD>Nome</TD><TD>Tipo</TD><TD>Async</TD><TD>Nome de ficheiro<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>index.bt</I><BR></TD></TR>
|
|
<TR VALIGN=top><TD>GNU gdbm</TD><TD>
|
|
Hashed
|
|
</TD><TD>Sim</TD><TD><I>index.db</I><BR></TD></TR>
|
|
<TR VALIGN=top><TD>UNIX ndbm</TD><TD>
|
|
Hashed
|
|
</TD><TD>Não</TD><TD><I>index.(dir|pag)</I><BR></TD></TR>
|
|
</TABLE>
|
|
|
|
<P>
|
|
Os tipos de bases de dados que suportam actualizações assíncronas fornecem
|
|
velocidade melhorada a custo de possível corrupção em caso de fecho
|
|
irregular. Num caso em que tal tenha ocorrido, pode ser necessário voltar a
|
|
executar o <B>mandb</B> com a opção <B>-c</B> para recriar as bases de dados de
|
|
raiz.
|
|
<A NAME="lbAF"> </A>
|
|
<H2>OPÇÕES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-d</B>, <B>--debug</B>
|
|
|
|
|
|
<DD>
|
|
imprime informação de depuração.
|
|
<DT id="2"><B>-q</B>, <B>--quiet</B>
|
|
|
|
|
|
<DD>
|
|
Não produz avisos
|
|
<DT id="3"><B>-s</B>, <B>--no-straycats</B>
|
|
|
|
|
|
<DD>
|
|
Não perde tempo a procurar ou adicionar informação às bases de dados sobre
|
|
cats perdidos.
|
|
<DT id="4"><B>-p</B>, <B>--no-purge</B>
|
|
|
|
|
|
<DD>
|
|
Não perde tempo a procurar páginas do manual eliminadas e a purgá-las da
|
|
base de dados.
|
|
<DT id="5"><B>-c</B>, <B>--create</B>
|
|
|
|
|
|
<DD>
|
|
Por predefinição, o <B>mandb</B> tentará actualizar quaisquer bases de dados
|
|
anteriormente criadas. Se uma delas não existir, será criada. Esta opção
|
|
força o <B>mandb</B> a eliminar bases de dados anteriores e a recriá-las de
|
|
raiz, o que implica <B>--no-purge.</B>. Pode ser necessário se uma base de dados
|
|
for corrompida ou se for introduzido um novo esquema de armazenagem.
|
|
<DT id="6"><B>-u</B>, <B>--user-db</B>
|
|
|
|
|
|
<DD>
|
|
Criar só bases de dados do utilizador, mesmo com permissões de escrita
|
|
necessárias para criar bases de dados de sistema.
|
|
<DT id="7"><B>-t</B>, <B>--test</B>
|
|
|
|
|
|
<DD>
|
|
Realiza testes de correcção em páginas do manual no caminho de procura da
|
|
hierarquia. Com esta opção, <B>mandb</B> não altera as bases de dados
|
|
existentes.
|
|
<DT id="8"><B>-f</B>, <B>--filename</B>
|
|
|
|
|
|
<DD>
|
|
Actualiza só as entradas do nome de ficheiro indicado. Esta opção não é para
|
|
uso geral; é usada internamente pelo <B>man</B> quando foi compilado com a
|
|
opção <B>MAN_DB_UPDATES</B> e descobre uma página desactualizada. Implica <B>-p</B>
|
|
e desactiva <B>-c</B> e <B>-s</B>.
|
|
<DT id="9"><B>-C </B><I>ficheiro</I>, <B>--config-file=</B><I>ficheiro</I><DD>
|
|
usa este ficheiro do utilizador em vez do predefinido de <I>~/.manpath</I>.
|
|
<DT id="10"><B>-?</B>, <B>--help</B>
|
|
|
|
|
|
<DD>
|
|
Mostra a mensagem de uso e sai.
|
|
<DT id="11"><B>--usage</B>
|
|
|
|
|
|
<DD>
|
|
mostra uma mensagem curta de uso e sai.
|
|
<DT id="12"><B>-V</B>, <B>--version</B>
|
|
|
|
|
|
<DD>
|
|
Mostra a versão e sai.
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>ESTADO DE SAÍDA</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="13"><B>0</B>
|
|
|
|
|
|
<DD>
|
|
Execução de programa com sucesso.
|
|
<DT id="14"><B>1</B>
|
|
|
|
|
|
<DD>
|
|
Erro de uso, sintaxe ou do ficheiro de configuração.
|
|
<DT id="15"><B>2</B>
|
|
|
|
|
|
<DD>
|
|
Erro de operação.
|
|
<DT id="16"><B>3</B>
|
|
|
|
|
|
<DD>
|
|
Falhou um processo-filho.
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>DIAGNÓSTICO</H2>
|
|
|
|
As seguintes mensagens de aviso podem ser emitidas durante a construção das
|
|
bases de dados.
|
|
<DL COMPACT>
|
|
<DT id="17"><B><nomeficheiro>: falha na análise do whatis para page(sec)</B><DD>
|
|
Falhou uma tentativa de extrair linhas whatis do
|
|
<nomeficheiro>. Normalmente, é devido a uma escrita pobre de uma
|
|
página do manual, mas se forem emitidas muitas destas mensagens, é provável
|
|
que o sistema contenha páginas do manual não-padrão incompatíveis com o
|
|
analisador whatis do man-db. Veja a secção <B>ANÁLISE WHATIS</B> em
|
|
<B><A HREF="/cgi-bin/man/man2html?1+lexgrog">lexgrog</A></B>(1) para mais informação.
|
|
<DT id="18"><B><nomeficheiro>: é uma ligação simbólica pendente</B><DD>
|
|
<nomeficheiro> não existe mas é referenciado por uma ligação
|
|
simbólica. Normalmente, são emitidos mais diagnósticos para identificar o
|
|
<nomeficheiro> da ligação culposa.
|
|
<DT id="19"><B><nomeficheiro>: má ligação simbólica ou pedido ROFF ".so"</B><DD>
|
|
<nomeficheiro> ou é uma ligação simbĺica a, ou contém um pedido ROFF
|
|
include a um ficheiro não existente.
|
|
<DT id="20"><B><nomeficheiro>: a ignorar nomeficheiro fictício</B><DD>
|
|
O <nomeficheiro> pode ou não ser uma página de manual válida, mas o
|
|
seu nome é inválido. É normalmente devido a uma página do manual com uma
|
|
extensão seccional <x> posta na secção <y> da página do
|
|
manual.
|
|
<DT id="21"><B><máscara_nomeficheiro>: extensões concorrentes</B><DD>
|
|
O carácter universal <máscara_nomeficheiro> não é único. É
|
|
normalmente causado pela co-existência de versões comprimida e descomprimida
|
|
da mesma página do manual. São todas ignoradas menos a mais recente.
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>FICHEIROS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="22"><I>/etc/manpath.config</I>
|
|
|
|
|
|
<DD>
|
|
ficheiro de configuração do man-db.
|
|
<DT id="23"><I>/var/cache/man/index.(bt|db|dir|pag)</I>
|
|
|
|
|
|
<DD>
|
|
Uma cache de base de dados de <I>índice</I> global de acordo com FHS.
|
|
</DL>
|
|
<P>
|
|
|
|
Localizações antigas da cache de base de dados incluíam:
|
|
<DL COMPACT>
|
|
<DT id="24"><I>/usr/man/index.(bt|db|dir|pag)</I>
|
|
|
|
|
|
<DD>
|
|
Uma cache de base de dados de <I>índice</I> global tradicional.
|
|
<DT id="25"><I>/var/catman/index.(bt|db|dir|pag)</I>
|
|
|
|
|
|
<DD>
|
|
Uma cache de base de dados <I>índice</I> alternativa ou respeitante 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 secção <B>ANÁLISE WHATIS</B> anteriormente parte desta página do manual é
|
|
agora 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">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 BASES DE DADOS</A><DD>
|
|
<DT id="30"><A HREF="#lbAF">OPÇÕES</A><DD>
|
|
<DT id="31"><A HREF="#lbAG">ESTADO DE SAÍDA</A><DD>
|
|
<DT id="32"><A HREF="#lbAH">DIAGNÓSTICO</A><DD>
|
|
<DT id="33"><A HREF="#lbAI">FICHEIROS</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:22 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|