MANDB(8) Utilitarios de paginacao de manual MANDB(8) NOME mandb - cria ou atualiza os caches de indices de pagina de manual SINOPSE mandb [-dqsucpt?V] [-C arquivo] [caminho man] mandb [-dqsut] [-C arquivo] -f arquivo ... DESCRICAO mandb e usado para inicializar ou atualizar manualmente os caches de banco de dados index. Os caches contem informacoes relevantes para o estado atual do sistema de pagina de manual e as informacoes armazenadas neles pelos utilitarios do man-db para melhorar sua velocidade e funcionalidade. Ao criar ou atualizar um index, mandb vai avisar sobre requisicoes ".so" invalidas de ROFF, nomes de arquivos invalidos de pagina de manual e paginas de manual dos quais nao e possivel realizar analise com whatis. Fornecer mandb com um caminho opcional, delimitado por caractere de dois pontos, sobrescrevera o caminho interno de pesquisa da hierarquia de pagina de manual do sistema, determinado de informacoes localizadas dentro do arquivo de configuracao 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 Assincrono Nome de arquivo ------------------------------------------------ Berkeley DB Sim indice.bt GNU gdbm Sim indice.db UNIX ndbm Nao indice.(dir|pag) Aqueles tipos de banco de dados que oferecem suporte a atualizacoes assincronas fornecem velocidade melhorada ao custo de possivel corrupcao no evento de uma terminal anormal. No caso de ocorrencia de terminacao anormal, pode ser necessario reexecutar mandb com a opcao -c para recriar os bancos de dados do zero. OPCOES -d, --debug Emite mensagens de depuracao. -q, --quiet Produz nenhum aviso. -s, --no-straycats Nao gasta tempo procurando por ou adicionando informacoes para os bancos de dados referente a cats errantes. -p, --no-purge Nao gasta tempo verificando paginas de manuais excluidas e apagando-as dos bancos de dados. -c, --create Por padrao, mandb tentara atualizar quaisquer bancos de dados previamente criados. Se um banco de dados nao existe, ele o criara. Essa opcao forca mandb a excluir bancos de dados anteriores e recria-lo do zero, e resulta em --no-purge. Isso pode ser necessario 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 usuario, mesmo com as permissoes de escrita necessarias para criar bancos de dados do sistema. -t, --test Realiza verificacoes corretivas em paginas de manual no caminho de pesquisa hierarquico. Com essa opcao, mandb nao alterara bancos de dados existentes. -f, --filename Atualiza apenas as entradas para o arquivo fornecido. Essa opcao nao e para uso geral; e usada internalmente pelo man quando compilado com a opcao MAN_DB_UPDATES e descobre que uma pagina esta desatualizada. Ele resulta em -p e desabilita -c e -s. -C arquivo, --config-file=arquivo Use this user configuration file rather than the default of ~/.manpath. -?, --help Mostra a mensagem de uso e, entao, sai. --usage Imprime uma mensagem curta e sai. -V, --version Mostra a versao e, entao, sai. STATUS DE SAIDA 0 Execucao com sucesso do programa. 1 Erro de uso, sintaxe ou arquivo de configuracao. 2 Erro operacional. 3 Um processo filho falhou. DIAGNOSTICOS As mensagens de aviso a seguir podem ser emitidas durante a construcao do banco de dados. : analise por whatis para pagina(secao) falhou Uma tentativa de extrair linha(s) do whatis a partir do falhou. Isso geralmente ocorre por causa de paginas de manual mal escritas, mas se muitas dessas mensagens forem emitidas, e possivel que o sistema contenha paginas de manual que estejam fora do padrao e sejam incompativeis com o analisador whatis do man-db. Veja a secao ANALISE COM WHATIS no lexgrog(1) para mais informacoes. : e um link simbolico perdido nao existe, mas e referenciado por um link simbolico. Mais diagnosticos geralmente sao emitidos para identificar o do link em questao. : link simbolico ruim ou requisicao ".so" ROFF e um link simbolico para, ou contem um ROFF inclui requisicao para, um arquivo nao existente. : ignorando nome de arquivo invalido O pode ou nao ser uma pagina de manual valida, mas seu nome e invalido. Isso geralmente ocorre por uma pagina de manual com extensao de secao ser colocada na secao da pagina de manual. : extensoes conflitantes O curinga nao e unica. Isso geralmente e causado pela existencia de ambos versoes comprimidas e nao comprimidas da mesma pagina de manual. Todas alem da mais recente sao ignoradas. ARQUIVOS /etc/man_db.conf O arquivo de configuracao do man-db. /var/cache/man/index.(bt|db|dir|pag) Um cache global de banco de dados index compativel com FHS. Localizacoes mais antigas para cache de banco de dados incluiam: /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 compativel com FSSTND. VEJA TAMBEM lexgrog(1), man(1), manpath(5), catman(8) A secao ANALISE COM WHATIS, anteriormente desta pagina de manual, agora e 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 2.12.1 2024-04-05 MANDB(8)