Provided by:
man-db_2.6.1-2_i386 
NAZWA
mandb - tworzy lub aktualizuje bufory indeksowe stron podrcznika
ekranowego
SK/LADNIA
mandb [-dqsucpt|-h|-V] [-C plik] [manpath]
mandb [-dqsut] [-C plik] -f nazwa_pliku ...
OPIS
mandb sluy do inicjowania lub rcznej aktualizacji indeksowych buforow
baz danych (index database caches), zwykle obslugiwanych przez man.
Bufory zawieraj informacj zwizan z aktualnym stanem systemu stron man.
Informacja w nich przechowywana uywana jest przez narzdzia man-db do
poprawy ich szybkoci i funkcjonalnoci dzialania.
Podczas tworzenia bd aktualizacji indeksu, mandb ostrzega o zlych
daniach .so ROFF, niepoprawnych nazwach plikow stron podrcznika oraz
stronach, z ktorych nie mona utworzy zapisu dla whatis.
Wywolanie mandb z opcjonaln ciek rozdzielonych dwukropkami hierarchii
katalogow uniewani wewntrzn globaln ciek przeszukiwa, okrelan na
podstawie informacji znalezionej w pliku konfiguracyjnym man-db.
BUFORY BAZY DANYCH
mandb moe zosta skompilowane z obslug jednego z nastpujcych typow baz.
Nazwa Typ Asynchroniczna Nazwa pliku
----------------------------------------------------------------------
Berkeley db Drzewo binarne Tak index.bt
GNU gdbm v >= 1.6 Funkcja Tak index.db
mieszajca
GNU gdbm v < 1.6 Funkcja Nie index.db
mieszajca
UNIX ndbm Funkcja Nie index.(dir|pag)
mieszajca
Typy baz danych obslugujce aktualizacje asynchroniczne zapewniaj lepsz
szybko kosztem moliwego uszkodzenia w przypadku nienormalnego
przerwania pracy. W niezbyt czstym przypadku takiego przerwania, moe by
niezbdne ponowne uruchomienie mandb z opcj -c do odbudowania bazy
danych od zera.
OPCJE
-d, --debug
Wywietla informacj diagnostyczn (debug).
-q, --quiet
Nie generuje ostrzee.
-s, --no-straycats
Nie traci czasu na poszukiwanie lub dodawanie do bazy informacji
dotyczcej zablkanych stron cat. [tlum: stray cats - rownie
"zablkane koty" :)].
-p, --no-purge
Nie traci czasu na poszukiwanie usunitych stron podrcznika i
usuwanie ich z bazy danych.
-c, --create
Domylnie mandb probuje zaktualizowa uprzednio utworzone bazy.
Jeli baza nie istnieje, to j utworzy. Niniejsza opcja wymusza na
mandb usunicie poprzednich baz i utworzenie ich od zera, wlcza
te automatycznie opcj --no-purge. Moe to by niezbdne, jeli baza
zostala uszkodzona lub jeli wprowadza si nowy uklad
przechowywania baz.
-u, --user-db
Tworz wylcznie bazy danych uytkownika, nawet przy prawach zapisu
niezbdnych do utworzenia baz systemowych.
-t, --test
Sprawdza poprawno stron podrcznika znajdujcych si w ciece
poszukiwa. Jeeli podano t opcj, to mandb w aden sposob nie
zmieni istniejcej bazy danych.
-f, --filename
Aktualizuje tylko wpisy dotyczce danego pliku. Nie jest to opcja
przeznaczona dla ogolu, jest uywana wewntrznie przez man, jeeli
zostal skompilowany z wlczon opcj MAN_DB_UPDATES, a podana
strona podrcznika jest przestarzala. Wlcza -p i deaktywuje -c i
-s.
-C plik, --config-file=plik
Uywa podanego pliku konfiguracyjnego uytkownika zamiast
domylnego ~/.manpath.
-h, --help
Wywietla komunikaty o zastosowaniu i koczy prac.
-V, --version
Wywietla numer wersji i koczy prac.
KOD ZAKOCZENIA
0 Program zakoczony bez adnych bldow.
1 Bld uycia, skladni lub w pliku konfiguracyjnym.
2 Bld dzialania.
3 Bld dzialania procesu potomnego.
DIAGNOSTYKA
Podczas tworzenia bazy danych mog by wywietlane nastpujce ostrzeenia:
<plik>: przetwarzanie whatis strona(sekcja) si nie powiod/lo
Nie udala si proba uzyskania wiersza(y) whatis z zadanego
<pliku>. Zwykle jest to spowodowane przez kiepsko napisan stron
man, ale jeli wywietlanych jest wiele takich komunikatow, to
prawdopodobnie system zawiera niestandardowe strony man,
niezgodne z analizatorem skladni whatis wbudowanym w man-db.
Wicej informacji mona znale w sekcji PRZETWARZANIE WHATIS na
stronie lexgrog(1).
<plik>: jest wiszcym dowizaniem symbolicznym
<plik> o podanej nazwie nie istnieje, ale jest wskazywany przez
dowizanie symboliczne (symbolic link). Zwykle generowane jest
dodatkowa informacja diagnostyczna dla identyfikacji <pliku> z
bldnego dowizania.
<plik>: z/le dowizanie symboliczne lub b/ldne danie "so" ROFF
<plik> jest albo dowizaniem symbolicznym do nieistniejcego
pliku, albo zawiera danie wlczenia ROFF (include) nieistniejcego
pliku.
<plik>: ignorowanie niepoprawnej nazwy pliku
<plik> by moe 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>: konkurujce rozszerzenia
Wzorzec nazwy <maska_pliku> nie daje unikatowego wyniku. Zwykle
spowodowane istnieniem zarowno skompresowanej jak i
nieskompresowanej wersji tej samej strony man. Ignorowane s
wszystkie oprocz najnowszej.
PLIKI
/etc/manpath.config
Plik konfiguracyjny man-db.
/var/cache/man/index.(bt|db|dir|pag)
Zgodny z FHS globalny indeks bazy danych.
Poprzednie lokalizacje bufora bazy danych obejmowaly midzy 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 TAKE
lexgrog(1), man(1), manpath(5), catman(8)
Sekcja PRZETWARZANIE WHATIS, bdca poprzednio w tej stronie podrcznika,
zostala przeniesiona do lexgrog(1).
AUTOR
Wilf. (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Colin Watson (cjwatson@debian.org).
T/LUMACZENIE
Wojciech Kotwica w 1999 roku przetlumaczyl cz stron podrcznika pakietu
man-db i udostpnil je w ramach Projektu Tlumaczenia Manuali.
Robert Luberda tlumaczenie zaktualizowal i uzupelnil w roku 2008.