MANDB(8) Narzedzia przegladarki stron podrecznika ekranowego MANDB(8) NAZWA mandb - tworzy lub aktualizuje bufory indeksowe stron podrecznika ekranowego SKLADNIA 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 badz aktualizacji indeksu, mandb ostrzega o zlych zadaniach .so ROFF, niepoprawnych nazwach plikow stron podrecznika oraz stronach, z ktorych nie mozna utworzyc zapisu dla whatis. Wywolanie mandb z opcjonalna sciezka rozdzielonych dwukropkami hierarchii katalogow uniewazni wewnetrzna globalna sciezke przeszukiwan, okreslana na podstawie informacji znalezionej w pliku konfiguracyjnym man-db. BUFORY BAZY DANYCH mandb moze zostac skompilowane z obsluga jednego z nastepujacych typow baz. Nazwa Asynchroniczna Nazwa pliku ----------------------------------------------- Berkeley db Tak index.bt GNU gdbm Tak index.db UNIX ndbm Nie index.(dir|pag) Typy baz danych obslugujace aktualizacje asynchroniczne zapewniaja lepsza szybkosc kosztem mozliwego uszkodzenia w przypadku nienormalnego przerwania pracy. W niezbyt czestym przypadku takiego przerwania, moze byc niezbedne ponowne uruchomienie mandb z opcja -c do odbudowania bazy danych od zera. OPCJE -d, --debug Wyswietla informacje diagnostyczna (debug). -q, --quiet Nie generuje ostrzezen. -s, --no-straycats Nie traci czasu na poszukiwanie lub dodawanie do bazy informacji dotyczacej zablakanych stron cat. [tlum: stray cats - rowniez "zablakane koty" :)]. -p, --no-purge Nie traci czasu na poszukiwanie usunietych stron podrecznika i usuwanie ich z bazy danych. -c, --create Domyslnie mandb probuje zaktualizowac uprzednio utworzone bazy. Jesli baza nie istnieje, to ja utworzy. Niniejsza opcja wymusza na mandb usuniecie poprzednich baz i utworzenie ich od zera, wlacza tez automatycznie opcje --no-purge. Moze to byc niezbedne, jesli baza zostala uszkodzona lub jesli wprowadza sie nowy uklad przechowywania baz. -u, --user-db Tworz wylacznie bazy danych uzytkownika, nawet przy prawach zapisu niezbednych do utworzenia baz systemowych. -t, --test Sprawdza poprawnosc stron podrecznika znajdujacych sie w sciezce poszukiwan. Jezeli podano te opcje, to mandb w zaden sposob nie zmieni istniejacej bazy danych. -f, --filename Aktualizuje tylko wpisy dotyczace danego pliku. Nie jest to opcja przeznaczona dla ogolu, jest uzywana wewnetrznie przez man, jezeli zostal skompilowany z wlaczona opcja MAN_DB_UPDATES, a podana strona podrecznika jest przestarzala. Wlacza -p i deaktywuje -c i -s. -C plik, --config-file=plik Use this user configuration file rather than the default of ~/.manpath. -?, --help Wyswietla komunikaty o zastosowaniu i konczy prace. --usage Wyswietla krotki opis uzycia programu i konczy prace. -V, --version Wyswietla numer wersji i konczy prace. KOD ZAKONCZENIA 0 Program zakonczony bez zadnych bledow. 1 Blad uzycia, skladni lub w pliku konfiguracyjnym. 2 Blad dzialania. 3 Blad dzialania procesu potomnego. DIAGNOSTYKA Podczas tworzenia bazy danych moga byc wyswietlane nastepujace ostrzezenia: : przetwarzanie whatis strona(sekcja) sie nie powiodlo Nie udala sie proba uzyskania wiersza(y) whatis z zadanego . Zwykle jest to spowodowane przez kiepsko napisana strone man, ale jesli wyswietlanych jest wiele takich komunikatow, to prawdopodobnie system zawiera niestandardowe strony man, niezgodne z analizatorem skladni whatis wbudowanym w man-db. Wiecej informacji mozna znalezc w sekcji PRZETWARZANIE WHATIS na stronie lexgrog(1). : jest wiszacym dowiazaniem symbolicznym o podanej nazwie nie istnieje, ale jest wskazywany przez dowiazanie symboliczne (symbolic link). Zwykle generowane jest dodatkowa informacja diagnostyczna dla identyfikacji z blednego dowiazania. : zle dowiazanie symboliczne lub bledne zadanie "so" ROFF jest albo dowiazaniem symbolicznym do nieistniejacego pliku, albo zawiera zadanie wlaczenia ROFF (include) nieistniejacego pliku. : ignorowanie niepoprawnej nazwy pliku byc moze byc lub nie byc poprawna strona man, ale jego nazwa jest niepoprawna. Spowodowane zwykle przez strone man z rozszerzeniem sekcji umieszczona w sekcji stron . : konkurujace rozszerzenia Wzorzec nazwy nie daje unikatowego wyniku. Zwykle spowodowane istnieniem zarowno skompresowanej jak i nieskompresowanej wersji tej samej strony man. Ignorowane sa wszystkie oprocz 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 obejmowaly miedzy 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 TAKZE lexgrog(1), man(1), manpath(5), catman(8) Sekcja PRZETWARZANIE WHATIS, bedaca poprzednio w tej stronie podrecznika, zostala przeniesiona do lexgrog(1). AUTOR Wilf. (G.Wilford@ee.surrey.ac.uk). Fabrizio Polacco (fpolacco@debian.org). Colin Watson (cjwatson@debian.org). BLEDY https://gitlab.com/man-db/man-db/-/issues https://savannah.nongnu.org/bugs/?group=man-db TLUMACZENIE Wojciech Kotwica w 1999 roku przetlumaczyl czesc stron podrecznika pakietu man-db i udostepnil je w ramach Projektu Tlumaczenia Manuali. Robert Luberda tlumaczenie zaktualizowal i uzupelnil w roku 2008. 2.12.1 2024-04-05 MANDB(8)