Linux Certif

Toute la documentation sur la certification Linux LPI

mandb

NAZWA

mandb - tworzy lub aktualizuje bufory indeksowe stron man.

SK£ADNIA

mandb [-dqsuc|-h|-V] [manpath]

OPIS

mandb s³u¿y do inicjowania lub rêcznej aktualizacji indeksowych buforów baz danych (index database caches), zwykle obs³ugiwanych przez man. Bufory zawieraj± informacjê zwi±zan± z aktualnym stanem systemu stron man. Informacja w nich przechowywana u¿ywana jest przez narzêdzia man-db do poprawy ich szybko¶ci i funkcjonalno¶ci dzia³ania.

Podczas tworzenia b±d¼ aktualizacji indeksu, mandb ostrzega o z³ych ¿±daniach .so ROFF, niepoprawnych nazwach plików stron man oraz stronach, z których nie mo¿na utworzyæ zapisu dla whatis.

Wywo³anie mandb z opcjonaln± ¶cie¿k± rozdzielonych dwukropkami hierarchii katalogów uniewa¿ni wewnêtrzn± globaln± ¶cie¿kê przeszukiwañ, okre¶lan± na podstawie informacji znalezionej w pliku konfiguracyjnym man-db.

BUFORY BAZY DANYCH

mandb mo¿e zostaæ skompilowane z obs³ug± jednego z nastêpuj±cych typów baz.

Nazwa	Typ	Async	Nazwa pliku
Berkeley db	Binary tree	Tak	index.bt
GNU gdbm v >= 1.6	Hashed	Tak	index.db
GNU gdbm v < 1.6	Hashed	Nie	index.db
UNIX ndbm	Hashed	Nie	index.(dir|pag)

Typy baz danych obs³uguj±ce aktualizacje asynchroniczne zapewniaj± lepsz± szybko¶æ kosztem mo¿liwego uszkodzenia w przypadku nienormalnego przerwania pracy. W niezbyt czêstym przypadku takiego przerwania, mo¿e byæ niezbêdne ponowne uruchomienie mandb z opcj± -c do odbudowania bazy danych od zera.

OPCJE

-d, --debug

Tworzy informacjê diagnostyczn± (debug).

-q, --quiet

Nie generuje ostrze¿eñ.

-s, --no-straycats

Nie traci czasu na poszukiwanie lub dodawanie do bazy informacji dotycz±cej zab³±kanych stron cat. [t³um: stray cats - równie¿ "zab³±kane koty" :)].

-p, --no-purge

Nie traci czasu na poszukiwanie usuniêtych stron podrêcznika i usuwanie ich z bazy danych.

-c, --create

Domy¶lnie mandb próbuje zaktualizowaæ uprzednio utworzone bazy. Je¶li baza nie istnieje, to j± utworzy. Niniejsza opcja wymusza na mandb usuniêcie poprzednich baz i utworzenie ich od zera i automatycznie w³±cza --no-purge. Mo¿e to byæ niezbêdne, je¶li baza zosta³a uszkodzona lub je¶li wprowadza siê nowy uk³ad przechowywania baz.

-u, --user-db

Twórz wy³±cznie bazy danych u¿ytkownika, nawet przy prawach zapisu niezbêdnych do utworzenia baz systemowych.

-t, --test

Sprawdza poprawno¶æ stron podrêcznika znajduj±ych siê w ¶cie¿ce poszukiwañ. Je¿eli podano tê opcjê, to mandb w ¿aden sposób nie zmieni istniej±cej bazy danych.

-h, --help

Wy¶wietla komunikaty o zastosowaniu i koñczy pracê.

-V, --version

Wy¶wietla numer wersji i koñczy pracê.

KOD WYJ¦CIA

0

Pomy¶lne wykonanie programu.

1

B³±d u¿ycia, sk³adni lub w pliku konfiguracyjnym.

2

B³±d wykonywania programu.

3

B³±d procesu potomnego.

DIAGNOSTYKA

Podczas tworzenia bazy danych mog± byæ pomijane nastêpuj±ce komunikaty ostrzegawcze:

<plik>: whatis parse for page(sec) failed

Nieudana próba uzyskania wiersza(y) whatis z zadanego <pliku>. Zwykle spowodowana kiepsko napisan± stron± man, ale je¶li wysy³anych jest wiele takich komunikatów, to prawdopodobnie system zawiera niestandardowe strony man, niezgodne z analizatorem sk³adni whatis wbudowanym w man-db. Wiêcej informacji mo¿na znale¼æ w sekcji PARSOWANIE WHATIS na stronie lexgrog(1).

<plik>: is a dangling symlink

<plik> o podanej nazwie nie istnieje, ale jest wskazywany przez dowi±zanie symboliczne (symbolic link). Zwykle generowane jest dodatkowa informacja diagnostyczna dla identyfikacji <pliku> z b³êdnego dowi±zania.

<plik>: bad symlink or ROFF `.so' request

<plik> jest albo dowi±zaniem symbolicznym do nieistniej±cego pliku, albo zawiera ¿±danie w³±czenia ROFF (include) nieistniej±cego pliku.

<plik>: ignoring bogus filename

<plik> byæ mo¿e byæ lub nie byæ poprawn± stron± man, ale jego nazwa jest niepoprawna. Spowodowane zwykle przez stronê man z rozszerzeniem sekcji <x> umieszczon± w sekcji stron <y>.

<maska_pliku>: competing extensions

Wzorzec nazwy <maska_pliku> nie daje unikalnego wyniku. Zwykle spowodowane istnieniem zarówno skompresowanej jak i niekompresowanej wersji tej samej strony man. Ignorowane wszystkie z wyj±tkiem ostatniej [najnowszej?].

PLIKI

/etc/man_db.config

Plik konfiguracyjny man-db.

/usr/man/index.(bt|db|dir|pag)

Tradycyjny globalny indeks bazy danych.

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

Alternatywny lub zgodny z FSSTND globalny indeks bazy danych.

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

Zgodny z FHS globalny indeks bazy danych.

ZOBACZ TAK¯E

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

Sekcja PARSOWANIE WHATIS, bêd±ca poprzednio w tej stronie podrêcznika, zosta³a przeniesiona do lexgrog(1).

AUTOR

Wilf. (G.Wilford@ee.surrey.ac.uk).

Fabrizio Polacco (fpolacco@debian.org).

Colin Watson (cjwatson@debian.org).