MANDB
Section: Utilitários de paginação de manual (8)
Updated: 2023-01-08
Index
Return to Main Contents
NOME
mandb - cria ou atualiza os caches de índices de página de manual
SINOPSE
mandb [-dqsucpt?V] [-C arquivo] [caminho man]
mandb [-dqsut] [-C arquivo] -f arquivo ...
DESCRIÇÃO
mandb é usado para inicializar ou atualizar manualmente os caches de
banco de dados index. 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.
Ao criar ou atualizar um index, mandb 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 whatis.
Fornecer mandb 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.
CACHES DE BANCO DE DADOS
mandb pode ser compilado com suporte para qualquer um dos tipos de
banco de dados a seguir.
Nome | Assíncrono | Nome de arquivo
|
|
Berkeley DB | Sim | índice.bt
|
GNU gdbm | Sim | índice.db
|
UNIX ndbm | Não | índice.(dir|pag)
|
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 mandb com a opção -c para recriar os
bancos de dados do zero.
OPÇÕES
- -d, --debug
-
Emite mensagens de depuração.
- -q, --quiet
-
Produz nenhum aviso.
- -s, --no-straycats
-
Não gasta tempo procurando por ou adicionando informações para os bancos de
dados referente a cats errantes.
- -p, --no-purge
-
Não gasta tempo verificando páginas de manuais excluídas e apagando-as dos
bancos de dados.
- -c, --create
-
Por padrão, mandb tentará atualizar quaisquer bancos de dados
previamente criados. Se um banco de dados não existe, ele o criará. Essa
opção força mandb a excluir bancos de dados anteriores e recriá-lo do
zero, e resulta em --no-purge. 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.
- -u, --user-db
-
Cria apenas bancos de dados de usuário, mesmo com as permissões de escrita
necessárias para criar bancos de dados do sistema.
- -t, --test
-
Realiza verificações corretivas em páginas de manual no caminho de pesquisa
hierárquico. Com essa opção, mandb não alterará bancos de dados
existentes.
- -f, --filename
-
Atualiza apenas as entradas para o arquivo fornecido. Essa opção não é para
uso geral; é usada internalmente pelo man quando compilado com a opção
MAN_DB_UPDATES e descobre que uma página está desatualizada. Ele resulta
em -p e desabilita -c e -s.
- -C arquivo, --config-file=arquivo
-
Usa esse arquivo de configuração de usuário em vez do padrão ~/.manpath.
- -?, --help
-
Mostra a mensagem de uso e, então, sai.
- --usage
-
Imprime uma mensagem curta e sai.
- -V, --version
-
Mostra a versão e, então, sai.
STATUS DE SAÍDA
- 0
-
Execução com sucesso do programa.
- 1
-
Erro de uso, sintaxe ou arquivo de configuração.
- 2
-
Erro operacional.
- 3
-
Um processo filho falhou.
DIAGNÓSTICOS
As mensagens de aviso a seguir podem ser emitidas durante a construção do
banco de dados.
- <arquivo>: análise por whatis para página(seção) falhou
-
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 ANÁLISE COM WHATIS no
lexgrog(1) para mais informações.
- <arquivo>: é um link simbólico perdido
-
<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.
- <arquivo>: link simbólico ruim ou requisição ".so" ROFF
-
<arquivo> é um link simbólico para, ou contém um ROFF inclui
requisição para, um arquivo não existente.
- <arquivo>: ignorando nome de arquivo inválido
-
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.
- <máscara_arquivo>: extensões conflitantes
-
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.
ARQUIVOS
- /etc/manpath.config
-
O arquivo de configuração do man-db.
- /var/cache/man/index.(bt|db|dir|pag)
-
Um cache global de banco de dados index compatível com FHS.
Localizações mais antigas para cache de banco de dados incluíam:
- /usr/man/index.(bt|db|dir|pag)
-
Um cache global de banco de dados index tradicional.
- /var/catman/index.(bt|db|dir|pag)
-
Um cache global de banco de dados index alternativo ou compatível com
FSSTND.
VEJA TAMBÉM
lexgrog(1),
man(1),
manpath(5),
catman(8)
A seção ANÁLISE COM WHATIS, anteriormente desta página de manual, agora é
parte do lexgrog(1).
AUTOR
Wilf. (G.Wilford@ee.surrey.ac.uk).Fabrizio Polacco (fpolacco@debian.org).Colin Watson (cjwatson@debian.org).
PROBLEMAS
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db
Index
- NOME
-
- SINOPSE
-
- DESCRIÇÃO
-
- CACHES DE BANCO DE DADOS
-
- OPÇÕES
-
- STATUS DE SAÍDA
-
- DIAGNÓSTICOS
-
- ARQUIVOS
-
- VEJA TAMBÉM
-
- AUTOR
-
- PROBLEMAS
-
This document was created by
man2html,
using the manual pages.
Time: 07:11:25 GMT, May 24, 2024