'\" t .\" Man page for mandb .\" .\" Copyright (C), 1994, 1995, Graeme W. Wilford. (Wilf.) .\" .\" You may distribute under the terms of the GNU General Public .\" License as specified in the file COPYING that comes with the .\" man-db distribution. .\" Tue Apr 26 12:56:44 BST 1994 Wilf. (G.Wilford@ee.surrey.ac.uk) .\" .pc "" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH MANDB 8 2019-01-05 2.8.5 "Narzędzia przeglądarki stron podręcznika ekranowego" .SH NAZWA mandb \- tworzy lub aktualizuje bufory indeksowe stron podręcznika ekranowego .SH SKŁADNIA \fBmandb\fP [\|\fB\-dqsucpt?V\fP\|] [\|\fB\-C\fP \fIplik\fP\|] [\|\fImanpath\fP\|] .br \fBmandb\fP [\|\fB\-dqsut\fP\|] [\|\fB\-C\fP \fIplik\fP\|] \fB\-f\fP \fInazwa_pliku\fP\ .\|.\|. .SH OPIS \fBmandb\fP służy do inicjowania lub ręcznej aktualizacji \fBindeksowych\fP buforów baz danych (index database caches), zwykle obsługiwanych przez \fBman\fP. 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 \fBindeksu\fP, \fBmandb\fP 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 \fBwhatis\fP. Wywołanie \fBmandb\fP 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. .SH "BUFORY BAZY DANYCH" \fBmandb\fP może zostać skompilowane z obsługą jednego z następujących typów baz. .TS tab (@); l lw(20m) l l. Nazwa@Typ@Asynchroniczna@Nazwa pliku _ Berkeley db@T{ Drzewo binarne T}@Tak@\fIindex.bt\fP GNU gdbm@T{ Funkcja mieszająca T}@Tak@\fIindex.db\fP UNIX ndbm@T{ Funkcja mieszająca T}@Nie@\fIindex.(dir|pag)\fP .TE 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 \fBmandb\fP z opcją \fB\-c\fP do odbudowania bazy danych od zera. .SH OPCJE .TP .if !'po4a'hide' .BR \-d ", " \-\-debug Wyświetla informację diagnostyczną (debug). .TP .if !'po4a'hide' .BR \-q ", " \-\-quiet Nie generuje ostrzeżeń. .TP .if !'po4a'hide' .BR \-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" :)]. .TP .if !'po4a'hide' .BR \-p ", " \-\-no-purge Nie traci czasu na poszukiwanie usuniętych stron podręcznika i usuwanie ich z bazy danych. .TP .if !'po4a'hide' .BR \-c ", " \-\-create Domyślnie \fBmandb\fP próbuje zaktualizować uprzednio utworzone bazy. Jeśli baza nie istnieje, to ją utworzy. Niniejsza opcja wymusza na \fBmandb\fP usunięcie poprzednich baz i utworzenie ich od zera, włącza też automatycznie opcję \fB\-\-no\-purge.\fP Może to być niezbędne, jeśli baza została uszkodzona lub jeśli wprowadza się nowy układ przechowywania baz. .TP .if !'po4a'hide' .BR \-u ", " \-\-user-db Twórz wyłącznie bazy danych użytkownika, nawet przy prawach zapisu niezbędnych do utworzenia baz systemowych. .TP .if !'po4a'hide' .BR \-t ", " \-\-test Sprawdza poprawność stron podręcznika znajdujących się w ścieżce poszukiwań. Jeżeli podano tę opcję, to \fBmandb\fP w żaden sposób nie zmieni istniejącej bazy danych. .TP .if !'po4a'hide' .BR \-f ", " \-\-filename Aktualizuje tylko wpisy dotyczące danego pliku. Nie jest to opcja przeznaczona dla ogółu, jest używana wewnętrznie przez \fBman\fP, jeżeli został skompilowany z włączoną opcją \fBMAN_DB_UPDATES\fP, a podana strona podręcznika jest przestarzała. Włącza \fB\-p\fP i deaktywuje \fB\-c\fP i \fB\-s\fP. .TP \fB\-C\ \fP\fIplik\fP,\ \fB\-\-config\-file=\fP\fIplik\fP Używa podanego pliku konfiguracyjnego użytkownika zamiast domyślnego \fI~/.manpath\fP. .TP .if !'po4a'hide' .BR \-? ", " \-\-help Wyświetla komunikaty o zastosowaniu i kończy pracę. .TP .if !'po4a'hide' .BR \-\-usage Wyświetla krótki opis użycia programu i kończy pracę. .TP .if !'po4a'hide' .BR \-V ", " \-\-version Wyświetla numer wersji i kończy pracę. .SH "KOD ZAKOŃCZENIA" .TP .if !'po4a'hide' .B 0 Program zakończony bez żadnych błędów. .TP .if !'po4a'hide' .B 1 Błąd użycia, składni lub w pliku konfiguracyjnym. .TP .if !'po4a'hide' .B 2 Błąd działania. .TP .if !'po4a'hide' .B 3 Błąd działania procesu potomnego. .SH DIAGNOSTYKA Podczas tworzenia bazy danych mogą być wyświetlane następujące ostrzeżenia: .TP \fB: przetwarzanie whatis strona(sekcja) się nie powiodło\fP 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 \fBPRZETWARZANIE WHATIS\fP na stronie \fBlexgrog\fP(1). .TP \fB: jest wiszącym dowiązaniem symbolicznym\fP 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. .TP \fB: złe dowiązanie symboliczne lub błędne żądanie "so" ROFF\fP jest albo dowiązaniem symbolicznym do nieistniejącego pliku, albo zawiera żądanie włączenia ROFF (include) nieistniejącego pliku. .TP \fB: ignorowanie niepoprawnej nazwy pliku\fP 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 . .TP \fB: konkurujące rozszerzenia\fP 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. .SH PLIKI .TP .if !'po4a'hide' .I /etc/manpath.config Plik konfiguracyjny man\-db. .TP .if !'po4a'hide' .I /var/cache/man/index.(bt|db|dir|pag) Zgodny z FHS globalny \fIindeks\fP bazy danych. .PP Poprzednie lokalizacje bufora bazy danych obejmowały między innymi: .TP .if !'po4a'hide' .I /usr/man/index.(bt|db|dir|pag) Tradycyjny globalny \fIindeks\fP bazy danych. .TP .if !'po4a'hide' .I /var/catman/index.(bt|db|dir|pag) Alternatywny lub zgodny z FSSTND globalny \fIindeks\fP bazy danych. .SH "ZOBACZ TAKŻE" .if !'po4a'hide' .BR lexgrog (1), .if !'po4a'hide' .BR man (1), .if !'po4a'hide' .BR manpath (5), .if !'po4a'hide' .BR catman (8) .PP Sekcja \fBPRZETWARZANIE WHATIS\fP, będąca poprzednio w tej stronie podręcznika, została przeniesiona do \fBlexgrog\fP(1). .SH AUTOR .nf .if !'po4a'hide' Wilf. (G.Wilford@ee.surrey.ac.uk). .if !'po4a'hide' Fabrizio Polacco (fpolacco@debian.org). .if !'po4a'hide' Colin Watson (cjwatson@debian.org). .fi .SH 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. .br Robert Luberda tłumaczenie zaktualizował i uzupełnił w roku 2008.