Scroll to navigation

MANDB(8) Utilitários de paginação de manual MANDB(8)

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

Emite mensagens de depuração.
Produz nenhum aviso.
Não gasta tempo procurando por ou adicionando informações para os bancos de dados referente a cats errantes.
Não gasta tempo verificando páginas de manuais excluídas e apagando-as dos bancos de dados.
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.
Cria apenas bancos de dados de usuário, mesmo com as permissões de escrita necessárias para criar bancos de dados do sistema.
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.
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.
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.
Imprime uma mensagem curta e sai.
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/cjwatson/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db

2022-03-17 2.10.2