MANDB

NAZWA
SKÅADNIA
OPIS
BUFORY BAZY DANYCH
OPCJE
KOD ZAKOÅCZENIA
DIAGNOSTYKA
PLIKI
ZOBACZ TAKŻE
AUTOR
BÅÄDY
TÅUMACZENIE

---

NAZWA

mandb − tworzy lub aktualizuje bufory indeksowe stron podrÄcznika ekranowego

SKÅADNIA

mandb [−dqsucpt?V] [−C plik] [manpath]
mandb [−dqsut] [−C plik] −f nazwa_pliku …

OPIS

mandb is used to initialise or manually update index database caches. The caches contain information relevant to the current state of the manual page system and the information stored within them is used by the man−db utilities to enhance their speed and functionality.

Podczas tworzenia bÄdź aktualizacji indeksu, mandb ostrzega o zÅych żÄdaniach .so ROFF, niepoprawnych nazwach plików stron podrÄcznika 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.

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

WyÅwietla 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, wÅÄcza też automatycznie opcjÄ −−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Äcych siÄ w Åcieżce poszukiwaÅ. Jeżeli podano tÄ opcjÄ, to mandb w żaden sposób nie zmieni istniejÄcej bazy danych.

−f, −−filename

Aktualizuje tylko wpisy dotyczÄce danego pliku. Nie jest to opcja przeznaczona dla ogóÅu, jest używana wewnÄtrznie przez man, jeżeli zostaÅ skompilowany z wÅÄczonÄ opcjÄ MAN_DB_UPDATES, a podana strona podrÄcznika jest przestarzaÅa. WÅÄcza −p i deaktywuje −c i −s.

−C plik, −−config−file=plik

Używa podanego pliku konfiguracyjnego użytkownika zamiast domyÅlnego ~/.manpath.

−?, −−help

WyÅwietla komunikaty o zastosowaniu i koÅczy pracÄ.

−−usage

WyÅwietla krótki opis użycia programu i koÅczy pracÄ.

−V, −−version

WyÅwietla numer wersji i koÅczy pracÄ.

KOD ZAKOÅCZENIA

	0		Program zakoÅczony bez żadnych bÅÄdów.
	1		BÅÄd użycia, skÅadni lub w pliku konfiguracyjnym.
	2		BÅÄd dziaÅania.
	3		BÅÄd dziaÅania procesu potomnego.

DIAGNOSTYKA

Podczas tworzenia bazy danych mogÄ byÄ wyÅwietlane nastÄpujÄce ostrzeżenia: : przetwarzanie whatis strona(sekcja) siÄ nie powiodÅo

Nie udaÅa siÄ próba uzyskania wiersza(y) whatis z zadanego . Zwykle jest to spowodowane przez kiepsko napisanÄ stronÄ man, ale jeÅli wyÅwietlanych 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 PRZETWARZANIE WHATIS na stronie lexgrog(1).

: jest wiszÄcym dowiÄzaniem symbolicznym

o podanej nazwie nie istnieje, ale jest wskazywany przez dowiÄzanie symboliczne (symbolic link). Zwykle generowane jest dodatkowa informacja diagnostyczna dla identyfikacji z bÅÄdnego dowiÄzania.

: zÅe dowiÄzanie symboliczne lub bÅÄdne żÄdanie “so” ROFF

jest albo dowiÄzaniem symbolicznym do nieistniejÄcego pliku, albo zawiera żÄdanie wÅÄczenia ROFF (include) nieistniejÄcego pliku.

: ignorowanie niepoprawnej nazwy pliku

byÄ może byÄ lub nie byÄ poprawnÄ stronÄ man, ale jego nazwa jest niepoprawna. Spowodowane zwykle przez stronÄ man z rozszerzeniem sekcji umieszczonÄ w sekcji stron .

: konkurujÄce rozszerzenia

Wzorzec nazwy nie daje unikatowego wyniku. Zwykle spowodowane istnieniem zarówno skompresowanej jak i nieskompresowanej wersji tej samej strony man. Ignorowane sÄ wszystkie oprócz najnowszej.

PLIKI

/etc/man_db.conf

Plik konfiguracyjny man−db.

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

Zgodny z FHS globalny indeks bazy danych.

Poprzednie lokalizacje bufora bazy danych obejmowaÅy miÄdzy innymi:
/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.

ZOBACZ TAKŻE

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

Sekcja PRZETWARZANIE 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).

BÅÄDY

https://savannah.nongnu.org/bugs/?group=man-db

TÅUMACZENIE

Wojciech Kotwica w 1999 roku przetÅumaczyÅ czÄÅÄ stron podrÄcznika pakietu man-db i udostÄpniÅ je w ramach Projektu TÅumaczenia Manuali.
Robert Luberda tÅumaczenie zaktualizowaÅ i uzupeÅniÅ w roku 2008.

---