mandb - criar ou atualizar os caches de índice da página do manual
SINTAXE
mandb [-dqsucpt?V] [-C arquivo] [caminho_man]
mandb [-dqsut] [-C arquivo] -f nome_arquivo ...
DESCRIÇÃO
mandb é usado para inicializar ou atualizar manualmente os caches do banco de dados de índice. Os caches contêm informações relevantes para o estado atual do sistema de página de manual e as informações armazenadas neles são usadas pelos utilitários man-db para aprimorar sua velocidade e funcionalidade.
Ao criar ou atualizar um índice, mandb avisará sobre solicitações ROFF .so incorretas, nomes de arquivo de página de manual inválidos e páginas de manual das quais o whatis não pode ser analisado.
Fornecer a mandb um caminho delimitado por dois pontos opcional substituirá o caminho de hierarquia do manual do sistema interno, determinado pelas informações encontradas no arquivo de configuração do man-db.
CACHES DE BANCO DE DADOS
mandb pode ser compilado com suporte para qualquer um dos seguintes tipos de banco de dados.
Nome Assíncrono Nome do arquivo
Berkeley db Sim index.bt
GNU gdbm Sim index.db
UNIX ndbm Não index.(dir|pag)
Os tipos de banco de dados que suportam atualizações assíncronas fornecem velocidade aprimorada à custa de possível corrupção no caso de terminação incomum. Em um caso incomum em que isso ocorreu, pode ser necessário executar mandb com a opção -c para recriar os bancos de dados do zero.
OPÇÕES
-d, --debug
Imprime informações de depuração.
-q, --quiet
Não produz avisos.
-s, --no-straycats
Não gaste tempo procurando ou adicionando informações aos bancos de dados sobre gatos perdidos.
-p, --no-purge
Não gaste tempo verificando se há páginas de manual excluídas e removendo-as dos bancos de dados.
-c, --create
Por padrão, mandb tentará atualizar quaisquer bancos de dados criados anteriormente. Se um banco de dados não existir, ele o criará. Esta opção força mandb a excluir bancos de dados anteriores e recriá-los do zero e implica --no-purge. Isso pode ser necessário se um banco de dados se corromper ou se um novo esquema de armazenamento de banco de dados for introduzido no futuro.
-u, --user-db
Crie apenas bancos de dados de usuário, mesmo com permissões de gravação necessárias para criar bancos de dados do sistema.
-t, --test
Realiza verificações de correção em páginas de manual no caminho de pesquisa de hierarquia. Com esta opção, mandb não alterará os bancos de dados existentes.
-f, --filename
Atualize apenas as entradas para o nome do arquivo fornecido. Esta opção não é para uso geral; é usado internamente por man quando foi compilado com a opção MAN_DB_UPDATES e encontra que uma página está desatualizada. Implica -p e desativa -c e -s.
-C arquivo, --config-file=arquivo
Use este arquivo de configuração de usuário em vez do padrão de \~/.manpath.
-?, --help
Mostra a mensagem de uso e sai.
--usage
Imprime uma mensagem de uso curta e sai.
-V, --version
Mostra a versão e sai.
STATUS DE SAÍDA
0 Execução bem-sucedida do programa.
1 Erro de uso, sintaxe ou arquivo de configuração.
2 Erro operacional.
3 Um processo filho falhou.
DIAGNÓSTICOS
As seguintes mensagens de aviso podem ser emitidas durante a construção do banco de dados.
<nome_arquivo>: a análise whatis para página(sec) falhou
Uma tentativa de extrair linhas whatis do <nome_arquivo> fornecido falhou. Isso geralmente ocorre devido a uma página de manual mal escrita, mas se muitas mensagens desse tipo forem emitidas, é provável que o sistema contenha páginas de manual não padronizadas que são incompatíveis com o analisador whatis do man-db. Consulte a seção WHATIS PARSING em lexgrog(1) para obter mais informações.
<nome_arquivo>: é um link simbólico pendente
<nome_arquivo> não existe, mas é referenciado por um link simbólico. Geralmente, diagnósticos adicionais são emitidos para identificar o <nome_arquivo> do link ofensivo.
<nome_arquivo>: link simbólico ou solicitação ROFF `.so` inválida
<nome_arquivo> é um link simbólico para ou contém uma solicitação de inclusão ROFF para um arquivo inexistente.
<nome_arquivo>: ignorando nome de arquivo inválido
O <nome_arquivo> pode ou não ser uma página de manual válida, mas seu nome é inválido. Isso geralmente ocorre devido a uma página de manual com extensão de seção <x> sendo colocada na seção de página de manual <y>.
<máscara_nome_arquivo>: extensões concorrentes
O curinga <máscara_nome_arquivo> não é exclusivo. Isso geralmente é causado pela existência de uma versão compactada e não compactada da mesma página de manual. Todas, exceto a mais recente, são ignoradas.
ARQUIVOS
/etc/manpath.config
arquivo de configuração man-db.
/var/cache/man/index.(bt|db|dir|pag)
Um cache de banco de dados de índice global compatível com FHS.
Locais mais antigos para o cache do banco de dados incluíam:
/usr/man/index.(bt|db|dir|pag)
Um cache de banco de dados de índice global tradicional.
/var/catman/index.(bt|db|dir|pag)
Um cache de banco de dados de índice global alternativo ou compatível com FSSTND.
VEJA TAMBÉM
lexgrog(1), man(1), manpath(5), catman(8)
A seção WHATIS PARSING, anteriormente nesta página de manual, agora faz parte de lexgrog(1).
AUTOR
Wilf. (_)
Fabrizio Polacco (_).
Colin Watson (_).
ERROS
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db