MANDB

NOME
SINOPSE
DESCRIÃÃO
CACHES DE BASES DE DADOS
OPÃÃES
ESTADO DE SAÃDA
DIAGNÃSTICO
FICHEIROS
VEJA TAMBÃM
AUTOR
ERROS


NOME

mandb − cria ou actualiza as caches de Ãndice das páginas do manual

SINOPSE

mandb [−dqsucpt?V] [−C ficheiro] [manpath]
mandb
[−dqsut] [−C ficheiro] −f nomeficheiro 

DESCRIÃÃO

mandb é usado para inicializar ou actualizar manualmente as caches de bases de dados Ãndice. As caches contêm informação relevante sobre o estado actual do sistema de páginas do manual e a informação nelas armazenada é usada pelos utilitários do man−db para melhorar a sua velocidade e funcionalidade.

Ao criar ou actualizar um Ãndice, mandb avisa sobre maus pedidos .so ROFF, nomes de ficheiro de páginas do manual fictÃcios e páginas do manual das quais não consegue analisar o whatis.

Fornecer a mandb um caminho opcional separado por dois−pontos sobrepõe−se ao caminho interno de procura de hierarquias de páginas do manual, determinado por informação dentro do ficheiro de configuração do man−db.

CACHES DE BASES DE DADOS

mandb pode ser compilado com suporte a qualquer um dos seguintes tipos de bases de dados.

Image grohtml-1268021.png

Os tipos de bases de dados que suportam actualizações assÃncronas fornecem velocidade melhorada a custo de possÃvel corrupção em caso de fecho irregular. Num caso em que tal tenha ocorrido, pode ser necessário voltar a executar o mandb com a opção −c para recriar as bases de dados de raiz.

OPÃÃES

−d, −−debug

imprime informação de depuração.

−q, −−quiet

Não produz avisos

−s, −−no-straycats

Não perde tempo a procurar ou adicionar informação às bases de dados sobre cats perdidos.

−p, −−no-purge

Não perde tempo a procurar páginas do manual eliminadas e a purgá−las da base de dados.

−c, −−create

Por predefinição, o mandb tentará actualizar quaisquer bases de dados anteriormente criadas. Se uma delas não existir, será criada. Esta opção força o mandb a eliminar bases de dados anteriores e a recriá−las de raiz, o que implica −−no−purge.. Pode ser necessário se uma base de dados for corrompida ou se for introduzido um novo esquema de armazenagem.

−u, −−user-db

Criar só bases de dados do utilizador, mesmo com permissões de escrita necessárias para criar bases de dados de sistema.

−t, −−test

Realiza testes de correcção em páginas do manual no caminho de procura da hierarquia. Com esta opção, mandb não altera as bases de dados existentes.

−f, −−filename

Actualiza só as entradas do nome de ficheiro indicado. Esta opção não é para uso geral; é usada internamente pelo man quando foi compilado com a opção MAN_DB_UPDATES e descobre uma página desactualizada. Implica −p e desactiva −c e −s.

−C ficheiro−−config−file=ficheiro

usa este ficheiro do utilizador em vez do predefinido de ~/.manpath.

−?, −−help

Mostra a mensagem de uso e sai.

−−usage

mostra uma mensagem curta de uso e sai.

−V, −−version

Mostra a versão e sai.

ESTADO DE SAÃDA

0

Execução de programa com sucesso.

1

Erro de uso, sintaxe ou do ficheiro de configuração.

2

Erro de operação.

3

Falhou um processo−filho.

DIAGNÃSTICO

As seguintes mensagens de aviso podem ser emitidas durante a construção das bases de dados.
: falha na análise do whatis para page(sec)

Falhou uma tentativa de extrair linhas whatis do . Normalmente, é devido a uma escrita pobre de uma página do manual, mas se forem emitidas muitas destas mensagens, é provável que o sistema contenha páginas do manual não−padrão incompatÃveis com o analisador whatis do man−db. Veja a secção ANÃLISE WHATIS em lexgrog(1) para mais informação.

: é uma ligação simbólica pendente

não existe mas é referenciado por uma ligação simbólica. Normalmente, são emitidos mais diagnósticos para identificar o da ligação culposa.

: má ligação simbólica ou pedido ROFF “.so”

ou é uma ligação simbĺica a, ou contém um pedido ROFF include a um ficheiro não existente.

: a ignorar nomeficheiro fictÃcio

O pode ou não ser uma página de manual válida, mas o seu nome é inválido. à normalmente devido a uma página do manual com uma extensão seccional posta na secção da página do manual.

: extensões concorrentes

O carácter universal não é único. à normalmente causado pela co−existência de versões comprimida e descomprimida da mesma página do manual. São todas ignoradas menos a mais recente.

FICHEIROS

/etc/man_db.conf

ficheiro de configuração do man−db.

/var/cache/man/index.(bt|db|dir|pag)

Uma cache de base de dados de Ãndice global de acordo com FHS.

Localizações antigas da cache de base de dados incluÃam:
/usr/man/index.(bt|db|dir|pag)

Uma cache de base de dados de Ãndice global tradicional.

/var/catman/index.(bt|db|dir|pag)

Uma cache de base de dados Ãndice alternativa ou respeitante FSSTND.

VEJA TAMBÃM

lexgrog(1), man(1), manpath(5), catman(8)

A secção ANÃLISE WHATIS anteriormente parte desta página do manual é 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://savannah.nongnu.org/bugs/?group=man-db