Man page - mandb(8)

Packages contains this manual

Available languages:

en fr pt_BR es it pl pt ko nl da tr sv ja uk id ru ro sr zh_CN de

Manual

MANDB

NOME
SINOPSE
DESCRIÇÃO
CACHES DE BANCO DE DADOS
OPÇÕES
STATUS DE SAÍDA
DIAGNÓSTICOS
ARQUIVOS
VEJA TAMBÉM
AUTOR
PROBLEMAS

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.

Image grohtml-3935200-1.png

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