Provided by: apt_0.8.16~exp12ubuntu10_i386 bug

NAME

       apt-cache - query the APT cache

SYNOPSIS

       apt-cache [-hvsn] [-o=config string] [-c=file] {[gencaches] |
                 [showpkg pkg...] | [showsrc pkg...] | [stats] | [dump] |
                 [dumpavail] | [unmet] | [search regex] | [show pkg...] |
                 [depends pkg...] | [rdepends pkg...] | [pkgnames prefix] |
                 [dotty pkg...] | [xvcg pkg...] | [policy pkgs...] |
                 [madison pkgs...]}

OPIS

       apt-cache wykonuje ronorodne operacje na buforze (cache) pakietow
       programu APT.  apt-cache nie zmienia stanu systemu, ale dostarcza
       mechanizmow przeszukiwania metadanych pakietow i generowania
       interesujcego wyjcia.

       Jedno z poniszych polece musi by uyte, chyba e zostala podana opcja -h
       albo --help.

       gencaches
           gencaches wykonuje te same operacje, co apt-get check. Buduje bufor
           pakietow oraz rodel pakietow na podstawie rodel wymienionych w
           sources.list(5) oraz pliku /var/lib/dpkg/status.

       showpkg pakiet(y)
           showpkg wywietla informacje na temat pakietow podanych w linii
           polece. Pozostalymi argumentami s nazwy pakietow. Wywietlane s
           dostpne wersje oraz odwrotne zalenoci kadego z podanych pakietow,
           jak rownie zwykle zalenoci dla kadej z wersji Normalne (zwykle)
           zalenoci to s pakiety, od ktorych dany pakiet zaley, odwrotne
           zalenoci stanowi te pakiety, ktore zale od danego pakietu. Tak wic,
           pakiet musi spelnia normalne zalenoci, ale odwrotnych zalenoci -
           nie musi. Na przyklad, apt-cache showpkg libreadline2 wypisze
           wyjcie podobne do poniszego:

               Package: libreadline2
               Versions: 2.1-12(/var/state/apt/lists/foo_Packages),
               Reverse Depends:
                 libreadlineg2,libreadline2
                 libreadline2-altdev,libreadline2
               Dependencies:
               2.1-12 - libc5 (2 5.4.0-0) ncurses3.0 (0 (null))
               Provides:
               2.1-12 -
               Reverse Provides:
           Jak wida libreadline2 w wersji 2.1-12 zaley od libc5 i ncurses3.0,
           ktore musz by zainstalowane, aby libreadline2 dzialala. Z kolei
           libreadlineg2 i libreadline2-altdev zale od libreadline2. Jeeli
           libreadline2 jest zainstalowany, to libc5 i ncurses3.0 (i ldso)
           musz by take zainstalowane; natomiast libreadlineg2 oraz
           libreadline2-altdev nie musz by zainstalowane. W celu zrozumienia,
           co oznaczaj pozostale linie, najlepiej przejrze kod rodlowy
           programu apt.

       stats
           stats wywietla statystyki dotyczce bufora pakietow. Nie wymaga
           adnych argumentow. Wypisywane s nastpujce statystyki:

           o   Calkowita liczba nazw pakietow (Total package names) - liczba
               nazw pakietow znajdujcych si w buforze.

           o   Zwykle pakiety (Normal packages) jest to liczba zwyklych,
               regularnych nazw pakietow; s to pakiety, dla ktorych istnieje
               relacja "jeden do jednego" midzy ich nazwami a nazwami uywanymi
               przez inne pakiety jako zalenoci. Wikszo pakietow naley do tej
               kategorii.

           o   Czyste pakiety wirtualne (Pure virtual packages) okrela liczb
               pakietow, ktore istniej tylko jako nazwa pakietu wirtualnego;
               to jest pewne pakiety "dostarczaj" tej nazwy wirtualnej, ale
               aden pakiet nie uywa tej nazwy. Na przyklad
               "mail-transport-agent" w systemie Debian GNU/Linux jest czystym
               pakietem wirtualnym; kilka pakietow dostarcza
               "mail-transport-agenta", ale aden pakiet nie nazywa si
               "mail-transport-agent".

           o   Pojedyncze pakiety wirtualne (Single virtual packages) - liczba
               pakietow, dla ktorych istnieje tylko jeden pakiet, ktory
               dostarcza danego pakietu wirtualnego. Na przyklad, w systemie
               Debian GNU/Linux "X11-text-viewer" jest pakietem wirtualnym,
               ale tylko jeden pakiet - xless - dostarcza "X11-text-viewer".

           o   Mieszane pakiety wirtualne (Mixed virtual packages) - liczba
               pakietow, ktore albo dostarczaj poszczegolnych pakietow
               wirtualnych, albo nazywaj si tak, jak nazwa pakietu
               wirtualnego. Na przyklad w systemie Debian GNU/Linux "debconf"
               jest zarowno zwyklym pakietem, jak i jest pakietem dostarczanym
               przez pakiet debconf-tiny.

           o   Brakujce (Missing) jest liczb nazw pakietow, do ktorych odnosz
               si jakie zalenoci, ale ktore nie s spelnione przez aden z
               dostpnych pakietow. Brakujce pakiety mog by dowodem, e nie ma
               dostpu do calej dystrybucji albo e pakiet (rzeczywisty lub
               wirtualny) zostal usunity z dystrybucji. Zazwyczaj odniesienia
               takie znajduj si w zalenociach typu "Conflicts" lub "Breaks".

           o   Calkowita liczba ronych wersji (Total distinct versions) jest
               to liczba wersji pakietow znajdujcych si w buforze, tak wic ta
               warto jest co najmniej rowna liczbie wszystkich nazw pakietow.
               Jeeli pobierane s pakiety z wicej ni jednej dystrybucji (na
               przyklad zarowno "stable", jak i "unstable"), warto ta moe by
               znacznie wiksza ni liczba wszystkich nazw pakietow.

           o   Calkowite zalenoci (Total dependencies) to liczba wizow
               zalenoci wymaganych przez wszystkie pakiety w buforze.

       showsrc pakiet(y)
           showsrc wywietla wszystkie pakiety rodlowe, ktore odpowiadaj
           podanym nazwom pakietow. Wywietlone zostan wszystkie wersje tych
           pakietow oraz pakiety binarne, ktore s z tych pakietow budowane.

       dump
           dump pokazuje krotk list wszystkich pakietow w buforze. Jest uywany
           glownie w celu odpluskwiania.

       dumpavail
           dumpavail wypisuje na standardowe wyjcie (stdout) list dostpnych
           pakietow. Jest to polecenie odpowiednie do uycia z programem
           dpkg(1) i jest uywane w metodzie dselect(1) tego programu.

       unmet
           unmet pokazuje podsumowanie wszystkich niespelnionych zalenoci w
           buforze pakietow

       show pakiet(y)
           show spelnia funkcje podobne do dpkg --print-avail; pokazuje
           szczegolowe informacje o podanych pakietach.

       search wyraenie regularne [ wyraenie regularne ... ]
           search wykonuje pelne wyszukiwanie podanego wzorca bdcego wyraeniem
           regularnym POSIX (patrz regex(7)) we wszystkich dostpnych listach
           pakietow. Przeszukuje nazwy pakietow (w tym pakietow wirtualnych) i
           ich szczegolowe (dlugie) opisy, szukajc w nich podanego wyraenia
           regularnego i wypisuje nazw pakietu i jego krotki opis. Jeeli
           podana jest opcja --full, to wtedy dla kadego znalezionego pakietu
           informacje na wyjciu s podobne do tego, co pokazuje akcja show.
           Jeeli podano opcj --names-only, to s przeszukiwane tylko nazwy
           pakietow, bez ich dlugich opisow.

           Oddzielne argumenty mog by uywane do podania kilku wzorcow, ktore
           bd traktowane jakby byly polczone spojnikiem logicznym "i".

       depends pakiet(y)
           depends wywietla list wszystkich zalenoci danego pakietu i
           wszystkie moliwe pakiety, ktore mog spelni te zalenoci.

       rdepends pakiet(y)
           rdepends pokazuje list wszystkich odwrotnych zalenoci danego
           pakietu.

       pkgnames [ prefiks ]
           To polecenie wywietla nazwy wszystkich pakietow znanych systemowi
           APT. Opcjonalnym argumentem jest przedrostek nazwy pakietow. Wynik
           jest odpowiedni do uycia z funkcj powloki (shella) uzupelniania
           nazw za pomoc klawisza tabulacji i jest wypisywany bardzo szybko.
           Tego polecenia najlepiej uywa z opcj --generate.

           Prosz zauway, e to, i pakiet jest znany systemowi APT,
           niekoniecznie oznacza, e jest dostpny do pobrania i zainstalowania
           albo zainstalowany. Moe by np. pakietem wirtualnym, ktore take s
           wypisane w wygenerowanej licie.

       dotty pakiet(y)
           dotty bierze jako argument list pakietow i generuje wyjcie
           odpowiednie dla programu dotty z pakietu GraphViz[1]. Wynikiem
           bdzie zbior wierzcholkow i krawdzi reprezentujcych powizania midzy
           pakietami. Domylnie podane pakiety wyledz wszystkie pakiety zalene.
           Moe to spowodowa wypisanie bardzo duego grafu. Aby wypisa powizania
           tylko pomidzy pakietami podanymi w linii polece, naley uy opcji
           APT::Cache::GivenOnly.

           Wynikowe wierzcholki bd mialy ronorakie ksztalty: zwykle pakiety s
           prostoktami, czyste pakiety wirtualne to trojkty, mieszane pakiety
           wirtualne s rombami, szeciokty oznaczaj brakujce pakiety .
           Pomaraczowe prostokty oznaczaj koniec rekurencji (licie),
           niebieskie linie to pre-zalenoci, linie zielone to konflikty.

           Uwaga: dotty nie potrafi narysowa wikszego zbioru pakietow.

       xvcg pakiet(y)
           Robi to samo, co dotty, tylko dla xvcg z narzdzia VCG[2].

       policy [ pakiet(y) ]
           policy jest pomylane w celu debugowania zagadnie zwizanych z
           plikiem preferencji. Jeeli nie podano adnych opcji, wypisane zostan
           informacje o priorytecie kadego rodla. W przeciwnym wypadku,
           wypisuje szczegolowe informacje o priorytecie danego pakietu.

       madison [ pakiet(y) ]
           polecenie madison z apt-cache probuje naladowa format wyjcia i cz
           funkcjonalnoci programu madison - narzdzia zarzdzania archiwum
           Debiana. Wywietla dostpne wersje pakietow w formacie tabeli. W
           przeciwiestwie do oryginalu, moe wywietli informacje tylko dla tych
           architektur, dla ktorych APT pobralo listy pakietow
           (APT::Architecture).

OPCJE

       Wszystkie opcje linii polece mog by ustawione w pliku konfiguracyjnym.
       Ponisze opisy wskazuj, ktor opcj w pliku konfiguracyjnym naley ustawi.
       W przypadku opcji logicznych, mona uniewani ustawienia pliku
       konfiguracyjnego, uywajc -f-, --no-f, -f=no albo czego podobnego.

       -p, --pkg-cache
           Podaje nazw pliku to przechowywania bufora pakietow, ktory jest
           podstawowym buforem uywanym we wszystkich operacjach. Pozycja w
           pliku konfiguracyjnym: Dir::Cache::pkgcache.

       -s, --src-cache
           Podaje nazw pliku to przechowywania bufora rodel. Jest uywany tylko
           przez akcj gencaches i przechowuje sparsowan wersj informacji o
           pakietach pobran ze zdalnych rodel. Podczas budowania bufora
           pakietow, bufor rodel jest uywany w celu uniknicia ponownego
           parsowania wszystkich plikow pakietow. Pozycja w pliku
           konfiguracyjnym: Dir::Cache::srcpkgcache.

       -q, --quiet
           Cichy; wypisuje tylko informacje potrzebne do logowania, opuszczajc
           wskaniki postpu. Wicej znakow q spowoduje jeszcze bardziej ciche
           wyjcie, maksimum jest 2. Mona take ustawi poziom cichoci za pomoc
           -q=#,nadpisujc tym samym opcj z pliku konfiguracyjnego. Pozycja w
           pliku konfiguracyjnym: quiet.

       -i, --important
           Wywietla tylko wane zalenoci; do uywania z akcj unmet. Powoduje
           wypisanie tylko zalenoci typu Depends i Pre-Depends. Pozycja w
           pliku konfiguracyjnym: APT::Cache::Important.

       --no-pre-depends, --no-depends, --no-recommends, --no-suggests,
       --no-conflicts, --no-breaks, --no-replaces, --no-enhances
           Per default the depends and rdepends print all dependencies. This
           can be tweaked with these flags which will omit the specified
           dependency type. Configuration Item: APT::Cache::ShowDependencyType
           e.g.  APT::Cache::ShowRecommends.

       -f, --full
           Podczas szukania wypisuj peln informacj o pakiecie. Pozycja w pliku
           konfiguracyjnym: APT::Cache::ShowFull.

       -a, --all-versions
           Akcja show wypisuje wszystkie rekordy dla wszystkich dostpnych
           wersji. Jest to opcja domylna, aby j wylczy, prosz uy
           --no-all-versions. Jeeli podano --no-all-versions, to bdzie
           wywietlana tylko wersja-kandydat (czyli ta, ktora bylaby wybrana do
           instalacji). Ta opcja ma znaczenie tylko dla polecenia show.
           Pozycja w pliku konfiguracyjnym: APT::Cache::AllVersions.

       -g, --generate
           Automatycznie odbudowuje bufor pakietow, zamiast uywa istniejcego
           bufora. Ta opcja jest domylnie wlczona, aby j wylczy, naley uy
           --no-generate. Pozycja w pliku konfiguracyjnym:
           APT::Cache::Generate.

       --names-only, -n
           Przeszukaj tylko nazwy pakietow, pomijajc szczegolowe opisy.
           Pozycja w pliku konfiguracyjnym: APT::Cache::NamesOnly.

       --all-names
           Powoduje, e akcja pkgnames wypisze nazwy wszystkich pakietow,
           lcznie z pakietami wirtualnymi oraz pakietami majcymi brakujce
           zalenoci. Pozycja w pliku konfiguracyjnym: APT::Cache::AllNames.

       --recurse
           Powoduje, e zalenoci w poleceniach depends i rdepends bd
           zalenociami rekurencyjnymi, tak e wszystkie wymienione pakiety
           zostan wypisane tylko raz. Pozycja w pliku konfiguracyjnym:
           APT::Cache::RecurseDepends.

       --installed
           Ogranicza wyjcie polece depends i rdepends tylko do pakietow, ktore
           s obecnie zainstalowane. Pozycja w pliku konfiguracyjnym:
           APT::Cache::Installed.

       -h, --help
           Wywietla krotkie informacje o uyciu.

       -v, --version
           Wywietla wersj programu.

       -c, --config-file
           Configuration File; Specify a configuration file to use. The
           program will read the default configuration file and then this
           configuration file. If configuration settings need to be set before
           the default configuration files are parsed specify a file with the
           APT_CONFIG environment variable. See apt.conf(5) for syntax
           information.

       -o, --option
           Ustawia opcj konfiguracji. Pozwala ustawi dowoln opcj konfiguracji.
           Skladnia jest nastpujca: -o Foo::Bar=bar.  -o i --option mona poda
           wielokrotnie - do ustawiania ronych opcji.

PLIKI

       /etc/apt/sources.list
           Lokalizacje, z ktorych bd cigane pakiety. Pozycja w pliku
           konfiguracyjnym: Dir::Etc::SourceList.

       /etc/apt/sources.list.d/
           Czci pliku zawierajcego lokalizacje, z ktorej s pobierane pakiety.
           Pozycja w pliku konfiguracyjnym: Dir::Etc::SourceParts.

       /var/lib/apt/lists/
           Skladnica zawierajca informacje o kadym zasobie pakietow podanym w
           sources.list(5) Pozycja w pliku konfiguracyjnym: Dir::State::Lists.

       /var/lib/apt/lists/partial/
           Skladnica obecnie pobieranych informacji o stanie pakietow. Pozycja
           w pliku konfiguracyjnym: Dir::State::Lists (implikuje partial).

ZOBACZ TAKE

       apt.conf(5), sources.list(5), apt-get(8)

DIAGNOSTYKA

       apt-cache zwraca zero, gdy zakoczylo si pomylnie, 100 - w przypadku
       bldu.

BUGS

       Strona b/ld'ow APT[3]. Aby zglosi bld w APT, prosz przeczyta
       /usr/share/doc/debian/bug-reporting.txt lub opis polecenia
       reportbug(1).

T/LUMACZENIE

       Tlumaczenie stron podrcznika: Robert Luberda <robert@debian.org>,
       2000-2010. Tlumaczenie przewodnika offline: Krzysztof Fiertek
       <akfedux@megapolis.pl>, 2004

       Prosz zauway, e przetlumaczony dokument moe zawiera fragmenty
       nieprzetlumaczone. Ma to na celu uniknicie utracenia istotnych
       informacji, w przypadkach gdy oryginal zostanie zaktualizowany, a
       tlumaczenie - nie.

AUTHORS

       Jason Gunthorpe

       zesp'o/l APT

NOTES

        1. GraphViz
           http://www.research.att.com/sw/tools/graphviz/

        2. narzdzia VCG
           http://rw4.cs.uni-sb.de/users/sander/html/gsvcg1.html

        3. Strona bldow APT
           http://bugs.debian.org/src:apt