279 lines
9.0 KiB
HTML
279 lines
9.0 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of MANDB</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>MANDB</H1>
|
|
Section: Narzędzia przeglądarki stron podręcznika ekranowego (8)<BR>Updated: 2020-02-25<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAZWA</H2>
|
|
|
|
mandb - tworzy lub aktualizuje bufory indeksowe stron podręcznika
|
|
ekranowego
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SKŁADNIA</H2>
|
|
|
|
<B>mandb</B> [<B>-dqsucpt?V</B>] [<B>-C</B> <I>plik</I>] [<I>manpath</I>]
|
|
<BR>
|
|
|
|
<B>mandb</B> [<B>-dqsut</B>] [<B>-C</B> <I>plik</I>] <B>-f</B> <I>nazwa_pliku</I> ...
|
|
<A NAME="lbAD"> </A>
|
|
<H2>OPIS</H2>
|
|
|
|
<B>mandb</B> is used to initialise or manually update <B>index</B> 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.
|
|
<P>
|
|
Podczas tworzenia bądź aktualizacji <B>indeksu</B>, <B>mandb</B> 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 <B>whatis</B>.
|
|
<P>
|
|
Wywołanie <B>mandb</B> 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.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>BUFORY BAZY DANYCH</H2>
|
|
|
|
<B>mandb</B> może zostać skompilowane z obsługą jednego z następujących typów
|
|
baz.
|
|
<P>
|
|
<TABLE>
|
|
<TR VALIGN=top><TD>Nazwa</TD><TD>Typ</TD><TD>Asynchroniczna</TD><TD>Nazwa pliku<BR></TD></TR>
|
|
<TR VALIGN=top><TD COLSPAN=4><HR></TD></TR>
|
|
<TR VALIGN=top><TD>Berkeley db</TD><TD>
|
|
Drzewo binarne
|
|
</TD><TD>Tak</TD><TD><I>index.bt</I><BR></TD></TR>
|
|
<TR VALIGN=top><TD>GNU gdbm</TD><TD>
|
|
Funkcja mieszająca
|
|
</TD><TD>Tak</TD><TD><I>index.db</I><BR></TD></TR>
|
|
<TR VALIGN=top><TD>UNIX ndbm</TD><TD>
|
|
Funkcja mieszająca
|
|
</TD><TD>Nie</TD><TD><I>index.(dir|pag)</I><BR></TD></TR>
|
|
</TABLE>
|
|
|
|
<P>
|
|
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 <B>mandb</B> z opcją <B>-c</B> do odbudowania bazy danych od
|
|
zera.
|
|
<A NAME="lbAF"> </A>
|
|
<H2>OPCJE</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-d</B>, <B>--debug</B>
|
|
|
|
|
|
<DD>
|
|
Wyświetla informację diagnostyczną (debug).
|
|
<DT id="2"><B>-q</B>, <B>--quiet</B>
|
|
|
|
|
|
<DD>
|
|
Nie generuje ostrzeżeń.
|
|
<DT id="3"><B>-s</B>, <B>--no-straycats</B>
|
|
|
|
|
|
<DD>
|
|
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" :)].
|
|
<DT id="4"><B>-p</B>, <B>--no-purge</B>
|
|
|
|
|
|
<DD>
|
|
Nie traci czasu na poszukiwanie usuniętych stron podręcznika i usuwanie ich
|
|
z bazy danych.
|
|
<DT id="5"><B>-c</B>, <B>--create</B>
|
|
|
|
|
|
<DD>
|
|
Domyślnie <B>mandb</B> próbuje zaktualizować uprzednio utworzone bazy. Jeśli
|
|
baza nie istnieje, to ją utworzy. Niniejsza opcja wymusza na <B>mandb</B>
|
|
usunięcie poprzednich baz i utworzenie ich od zera, włącza też automatycznie
|
|
opcję <B>--no-purge.</B> Może to być niezbędne, jeśli baza została uszkodzona
|
|
lub jeśli wprowadza się nowy układ przechowywania baz.
|
|
<DT id="6"><B>-u</B>, <B>--user-db</B>
|
|
|
|
|
|
<DD>
|
|
Twórz wyłącznie bazy danych użytkownika, nawet przy prawach zapisu
|
|
niezbędnych do utworzenia baz systemowych.
|
|
<DT id="7"><B>-t</B>, <B>--test</B>
|
|
|
|
|
|
<DD>
|
|
Sprawdza poprawność stron podręcznika znajdujących się w ścieżce
|
|
poszukiwań. Jeżeli podano tę opcję, to <B>mandb</B> w żaden sposób nie zmieni
|
|
istniejącej bazy danych.
|
|
<DT id="8"><B>-f</B>, <B>--filename</B>
|
|
|
|
|
|
<DD>
|
|
Aktualizuje tylko wpisy dotyczące danego pliku. Nie jest to opcja
|
|
przeznaczona dla ogółu, jest używana wewnętrznie przez <B>man</B>, jeżeli
|
|
został skompilowany z włączoną opcją <B>MAN_DB_UPDATES</B>, a podana strona
|
|
podręcznika jest przestarzała. Włącza <B>-p</B> i deaktywuje <B>-c</B> i <B>-s</B>.
|
|
<DT id="9"><B>-C </B><I>plik</I>, <B>--config-file=</B><I>plik</I><DD>
|
|
Używa podanego pliku konfiguracyjnego użytkownika zamiast domyślnego
|
|
<I>~/.manpath</I>.
|
|
<DT id="10"><B>-?</B>, <B>--help</B>
|
|
|
|
|
|
<DD>
|
|
Wyświetla komunikaty o zastosowaniu i kończy pracę.
|
|
<DT id="11"><B>--usage</B>
|
|
|
|
|
|
<DD>
|
|
Wyświetla krótki opis użycia programu i kończy pracę.
|
|
<DT id="12"><B>-V</B>, <B>--version</B>
|
|
|
|
|
|
<DD>
|
|
Wyświetla numer wersji i kończy pracę.
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>KOD ZAKOŃCZENIA</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="13"><B>0</B>
|
|
|
|
|
|
<DD>
|
|
Program zakończony bez żadnych błędów.
|
|
<DT id="14"><B>1</B>
|
|
|
|
|
|
<DD>
|
|
Błąd użycia, składni lub w pliku konfiguracyjnym.
|
|
<DT id="15"><B>2</B>
|
|
|
|
|
|
<DD>
|
|
Błąd działania.
|
|
<DT id="16"><B>3</B>
|
|
|
|
|
|
<DD>
|
|
Błąd działania procesu potomnego.
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>DIAGNOSTYKA</H2>
|
|
|
|
Podczas tworzenia bazy danych mogą być wyświetlane następujące ostrzeżenia:
|
|
<DL COMPACT>
|
|
<DT id="17"><B><plik>: przetwarzanie whatis strona(sekcja) się nie powiodło</B><DD>
|
|
Nie udała się próba uzyskania wiersza(y) whatis z zadanego
|
|
<pliku>. 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 <B>PRZETWARZANIE WHATIS</B> na stronie <B><A HREF="/cgi-bin/man/man2html?1+lexgrog">lexgrog</A></B>(1).
|
|
<DT id="18"><B><plik>: jest wiszącym dowiązaniem symbolicznym</B><DD>
|
|
<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.
|
|
<DT id="19"><B><plik>: złe dowiązanie symboliczne lub błędne żądanie "so" ROFF</B><DD>
|
|
<plik> jest albo dowiązaniem symbolicznym do nieistniejącego pliku,
|
|
albo zawiera żądanie włączenia ROFF (include) nieistniejącego pliku.
|
|
<DT id="20"><B><plik>: ignorowanie niepoprawnej nazwy pliku</B><DD>
|
|
<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>.
|
|
<DT id="21"><B><maska_pliku>: konkurujące rozszerzenia</B><DD>
|
|
Wzorzec nazwy <maska_pliku> nie daje unikatowego wyniku. Zwykle
|
|
spowodowane istnieniem zarówno skompresowanej jak i nieskompresowanej wersji
|
|
tej samej strony man. Ignorowane są wszystkie oprócz najnowszej.
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>PLIKI</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="22"><I>/etc/manpath.config</I>
|
|
|
|
|
|
<DD>
|
|
Plik konfiguracyjny man-db.
|
|
<DT id="23"><I>/var/cache/man/index.(bt|db|dir|pag)</I>
|
|
|
|
|
|
<DD>
|
|
Zgodny z FHS globalny <I>indeks</I> bazy danych.
|
|
</DL>
|
|
<P>
|
|
|
|
Poprzednie lokalizacje bufora bazy danych obejmowały między innymi:
|
|
<DL COMPACT>
|
|
<DT id="24"><I>/usr/man/index.(bt|db|dir|pag)</I>
|
|
|
|
|
|
<DD>
|
|
Tradycyjny globalny <I>indeks</I> bazy danych.
|
|
<DT id="25"><I>/var/catman/index.(bt|db|dir|pag)</I>
|
|
|
|
|
|
<DD>
|
|
Alternatywny lub zgodny z FSSTND globalny <I>indeks</I> bazy danych.
|
|
</DL>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>ZOBACZ TAKŻE</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+lexgrog">lexgrog</A></B>(1),
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+man">man</A></B>(1),
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+manpath">manpath</A></B>(5),
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+catman">catman</A></B>(8)
|
|
|
|
|
|
<P>
|
|
|
|
Sekcja <B>PRZETWARZANIE WHATIS</B>, będąca poprzednio w tej stronie podręcznika,
|
|
została przeniesiona do <B><A HREF="/cgi-bin/man/man2html?1+lexgrog">lexgrog</A></B>(1).
|
|
<A NAME="lbAK"> </A>
|
|
<H2>AUTOR</H2>
|
|
|
|
<PRE>
|
|
Wilf. (<A HREF="mailto:G.Wilford@ee.surrey.ac.uk">G.Wilford@ee.surrey.ac.uk</A>).Fabrizio Polacco (<A HREF="mailto:fpolacco@debian.org">fpolacco@debian.org</A>).Colin Watson (<A HREF="mailto:cjwatson@debian.org">cjwatson@debian.org</A>).</PRE>
|
|
|
|
<A NAME="lbAL"> </A>
|
|
<H2>TŁUMACZENIE</H2>
|
|
|
|
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.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="26"><A HREF="#lbAB">NAZWA</A><DD>
|
|
<DT id="27"><A HREF="#lbAC">SKŁADNIA</A><DD>
|
|
<DT id="28"><A HREF="#lbAD">OPIS</A><DD>
|
|
<DT id="29"><A HREF="#lbAE">BUFORY BAZY DANYCH</A><DD>
|
|
<DT id="30"><A HREF="#lbAF">OPCJE</A><DD>
|
|
<DT id="31"><A HREF="#lbAG">KOD ZAKOŃCZENIA</A><DD>
|
|
<DT id="32"><A HREF="#lbAH">DIAGNOSTYKA</A><DD>
|
|
<DT id="33"><A HREF="#lbAI">PLIKI</A><DD>
|
|
<DT id="34"><A HREF="#lbAJ">ZOBACZ TAKŻE</A><DD>
|
|
<DT id="35"><A HREF="#lbAK">AUTOR</A><DD>
|
|
<DT id="36"><A HREF="#lbAL">TŁUMACZENIE</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:20 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|