MANDB(8) Utilidades do paginador do manual MANDB(8) NOME mandb - cria ou actualiza as caches de indice das paginas do manual SINOPSE mandb [-dqsucpt?V] [-C ficheiro] [manpath] mandb [-dqsut] [-C ficheiro] -f nomeficheiro ... DESCRICAO mandb e usado para inicializar ou actualizar manualmente as caches de bases de dados indice. As caches contem informacao relevante sobre o estado actual do sistema de paginas do manual e a informacao nelas armazenada e usada pelos utilitarios do man-db para melhorar a sua velocidade e funcionalidade. Ao criar ou actualizar um indice, mandb avisa sobre maus pedidos .so ROFF, nomes de ficheiro de paginas do manual ficticios e paginas do manual das quais nao consegue analisar o whatis. Fornecer a mandb um caminho opcional separado por dois-pontos sobrepoe-se ao caminho interno de procura de hierarquias de paginas do manual, determinado por informacao dentro do ficheiro de configuracao do man-db. CACHES DE BASES DE DADOS mandb pode ser compilado com suporte a qualquer um dos seguintes tipos de bases de dados. Nome Async Nome de ficheiro --------------------------------------- Berkeley db Sim index.bt GNU gdbm Sim index.db UNIX ndbm Nao index.(dir|pag) Os tipos de bases de dados que suportam actualizacoes assincronas fornecem velocidade melhorada a custo de possivel corrupcao em caso de fecho irregular. Num caso em que tal tenha ocorrido, pode ser necessario voltar a executar o mandb com a opcao -c para recriar as bases de dados de raiz. OPCOES -d, --debug imprime informacao de depuracao. -q, --quiet Nao produz avisos -s, --no-straycats Nao perde tempo a procurar ou adicionar informacao as bases de dados sobre cats perdidos. -p, --no-purge Nao perde tempo a procurar paginas do manual eliminadas e a purga-las da base de dados. -c, --create Por predefinicao, o mandb tentara actualizar quaisquer bases de dados anteriormente criadas. Se uma delas nao existir, sera criada. Esta opcao forca o mandb a eliminar bases de dados anteriores e a recria-las de raiz, o que implica --no-purge.. Pode ser necessario se uma base de dados for corrompida ou se for introduzido um novo esquema de armazenagem. -u, --user-db Criar so bases de dados do utilizador, mesmo com permissoes de escrita necessarias para criar bases de dados de sistema. -t, --test Realiza testes de correccao em paginas do manual no caminho de procura da hierarquia. Com esta opcao, mandb nao altera as bases de dados existentes. -f, --filename Actualiza so as entradas do nome de ficheiro indicado. Esta opcao nao e para uso geral; e usada internamente pelo man quando foi compilado com a opcao MAN_DB_UPDATES e descobre uma pagina desactualizada. Implica -p e desactiva -c e -s. -C ficheiro, --config-file=ficheiro Use this user configuration file rather than the default of ~/.manpath. -?, --help Mostra a mensagem de uso e sai. --usage mostra uma mensagem curta de uso e sai. -V, --version Mostra a versao e sai. ESTADO DE SAIDA 0 Execucao de programa com sucesso. 1 Erro de uso, sintaxe ou do ficheiro de configuracao. 2 Erro de operacao. 3 Falhou um processo-filho. DIAGNOSTICO As seguintes mensagens de aviso podem ser emitidas durante a construcao das bases de dados. : falha na analise do whatis para page(sec) Falhou uma tentativa de extrair linhas whatis do . Normalmente, e devido a uma escrita pobre de uma pagina do manual, mas se forem emitidas muitas destas mensagens, e provavel que o sistema contenha paginas do manual nao-padrao incompativeis com o analisador whatis do man-db. Veja a seccao ANALISE WHATIS em lexgrog(1) para mais informacao. : e uma ligacao simbolica pendente nao existe mas e referenciado por uma ligacao simbolica. Normalmente, sao emitidos mais diagnosticos para identificar o da ligacao culposa. : ma ligacao simbolica ou pedido ROFF ".so" ou e uma ligacao simblica a, ou contem um pedido ROFF include a um ficheiro nao existente. : a ignorar nomeficheiro ficticio O pode ou nao ser uma pagina de manual valida, mas o seu nome e invalido. E normalmente devido a uma pagina do manual com uma extensao seccional posta na seccao da pagina do manual. : extensoes concorrentes O caracter universal nao e unico. E normalmente causado pela co-existencia de versoes comprimida e descomprimida da mesma pagina do manual. Sao todas ignoradas menos a mais recente. FICHEIROS /etc/man_db.conf ficheiro de configuracao do man-db. /var/cache/man/index.(bt|db|dir|pag) Uma cache de base de dados de indice global de acordo com FHS. Localizacoes antigas da cache de base de dados incluiam: /usr/man/index.(bt|db|dir|pag) Uma cache de base de dados de indice global tradicional. /var/catman/index.(bt|db|dir|pag) Uma cache de base de dados indice alternativa ou respeitante FSSTND. VEJA TAMBEM lexgrog(1), man(1), manpath(5), catman(8) A seccao ANALISE WHATIS anteriormente parte desta pagina do manual e agora parte de lexgrog(1). AUTOR Wilf. (G.Wilford@ee.surrey.ac.uk). Fabrizio Polacco (fpolacco@debian.org). Colin Watson (cjwatson@debian.org). ERROS https://gitlab.com/man-db/man-db/-/issues https://savannah.nongnu.org/bugs/?group=man-db 2.12.1 2024-04-05 MANDB(8)