APT-CACHE(8) APT APT-CACHE(8) NAZWA apt-cache - odpytanie bufora APT STRESZCZENIE apt-cache [-agipns] [-o=opcja_konfiguracji] [-c=plik_konfiguracyjny] {gencaches | showpkg pakiet... | showsrc pakiet... | stats | dump | dumpavail | unmet | search wyr_regularne... | show pakiet [{=nr_wersji_pakietu | /wydanie_docelowe}]... | depends pakiet [{=nr_wersji_pakietu | /wydanie_docelowe}]... | rdepends pakiet [{=nr_wersji_pakietu | /wydanie_docelowe}]... | pkgnames [prefiks] | dotty pakiet [{=nr_wersji_pakietu | /wydanie_docelowe}]... | xvcg pakiet [{=nr_wersji_pakietu | /wydanie_docelowe}]... | policy [pakiet...] | madison pakiet... | {-v | --version} | {-h | --help}} OPIS apt-cache performs a variety of operations on APT's package cache. apt-cache does not manipulate the state of the system but does provide operations to search and generate interesting output from the package metadata. The metadata is acquired and updated via the 'update' command of e.g. apt-get, so that it can be outdated if the last update is too long ago, but in exchange apt-cache works independently of the availability of the configured sources (e.g. offline). Jedno z ponizszych polecen musi byc uzyte, chyba ze zostala podana opcja -h albo --help. gencaches gencaches tworzy bufor (cache) APT pakietow. Wywolywane jest automatycznie przez wszystkie polecenia potrzebujace bufora, jesli nie istnieje lub jest przestarzaly. showpkg pakiet... showpkg wyswietla informacje na temat pakietow podanych w linii polecen. Pozostalymi argumentami sa nazwy pakietow. Wyswietlane sa dostepne wersje oraz odwrotne zaleznosci kazdego z podanych pakietow, jak rowniez zwykle zaleznosci dla kazdej z wersji Normalne (zwykle) zaleznosci to sa pakiety, od ktorych dany pakiet zalezy, odwrotne zaleznosci stanowia te pakiety, ktore zaleza od danego pakietu. Tak wiec, pakiet musi spelniac normalne zaleznosci, ale odwrotnych zaleznosci - nie musi. Na przyklad, apt-cache showpkg libreadline2 wypisze wyjscie podobne do ponizszego: 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 widac libreadline2 w wersji 2.1-12 zalezy od libc5 i ncurses3.0, ktore musza byc zainstalowane, aby libreadline2 dzialala. Z kolei libreadlineg2 i libreadline2-altdev zaleza od libreadline2. Jezeli libreadline2 jest zainstalowany, to libc5 i ncurses3.0 (i ldso) musza byc takze zainstalowane; natomiast libreadlineg2 oraz libreadline2-altdev nie musza byc zainstalowane. W celu zrozumienia, co oznaczaja pozostale linie, najlepiej przejrzec kod zrodlowy programu apt. stats stats wyswietla statystyki dotyczace bufora pakietow. Nie wymaga zadnych argumentow. Wypisywane sa nastepujace statystyki: o Calkowita liczba nazw pakietow (Total package names) - liczba nazw pakietow znajdujacych sie w buforze. o Zwykle pakiety (Normal packages) jest to liczba zwyklych, regularnych nazw pakietow; sa to pakiety, dla ktorych istnieje relacja "jeden do jednego" miedzy ich nazwami a nazwami uzywanymi przez inne pakiety jako zaleznosci. Wiekszosc pakietow nalezy do tej kategorii. o Czyste pakiety wirtualne (Pure virtual packages) okresla liczbe pakietow, ktore istnieja tylko jako nazwa pakietu wirtualnego; to jest pewne pakiety "dostarczaja" tej nazwy wirtualnej, ale zaden pakiet nie uzywa tej nazwy. Na przyklad "mail-transport-agent" w systemie Debian jest czystym pakietem wirtualnym; kilka pakietow dostarcza "mail-transport-agenta", ale zaden pakiet nie nazywa sie "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 "X11-text-viewer" jest pakietem wirtualnym, ale tylko jeden pakiet, mianowicie "xless",dostarcza "X11-text-viewer". o Mieszane pakiety wirtualne (Mixed virtual packages) - liczba pakietow, ktore albo dostarczaja poszczegolnych pakietow wirtualnych, albo nazywaja sie tak, jak nazwa pakietu wirtualnego. Na przyklad w systemie Debian "debconf" jest zarowno zwyklym pakietem, jak i jest pakietem dostarczanym przez pakiet "debconf-tiny". o Brakujace (Missing) jest liczba nazw pakietow, do ktorych odnosza sie jakies zaleznosci, ale ktore nie sa spelnione przez zaden z dostepnych pakietow. Brakujace pakiety moga byc dowodem, ze nie ma dostepu do calej dystrybucji albo ze pakiet (rzeczywisty lub wirtualny) zostal usuniety z dystrybucji. Zazwyczaj odniesienia takie znajduja sie w zaleznosciach typu "Conflicts" lub "Breaks". o Total distinct versions is the number of package versions found in the cache. If more than one distribution is being accessed (for instance, "stable" and "unstable"), this value can be considerably larger than the number of total package names. o Calkowite zaleznosci (Total dependencies) to liczba wiezow zaleznosci wymaganych przez wszystkie pakiety w buforze. showsrc pakiet... showsrc displays all the source package records that match the given package names. All versions are shown, as well as all records that declare the name to be a binary package. Use --only-source to display only source package names. dump dump pokazuje krotka liste wszystkich pakietow w buforze. Jest uzywany glownie w celu odpluskwiania. dumpavail dumpavail wypisuje na standardowe wyjscie (stdout) liste dostepnych pakietow. Jest to polecenie odpowiednie do uzycia z programem dpkg(1) i jest uzywane w metodzie dselect(1) tego programu. unmet unmet pokazuje podsumowanie wszystkich niespelnionych zaleznosci w buforze pakietow show pakiet... show spelnia funkcje podobne do dpkg --print-avail; pokazuje szczegolowe informacje o podanych pakietach. search wyr_regularne... search performs a full text search on all available package lists for the POSIX regex pattern given, see regex(7). It searches the package names and the descriptions for an occurrence of the regular expression and prints out the package name and the short description, including virtual package names. If --full is given then output identical to show is produced for each matched package, and if --names-only is given then the long description is not searched, only the package name and provided packages are. Oddzielne argumenty moga byc uzywane do podania kilku wzorcow, ktore beda traktowane jakby byly polaczone spojnikiem logicznym "i". depends pakiet... depends wyswietla liste wszystkich zaleznosci danego pakietu i wszystkie mozliwe pakiety, ktore moga spelnic te zaleznosci. rdepends pakiet... rdepends pokazuje liste wszystkich odwrotnych zaleznosci danego pakietu. pkgnames [prefiks] To polecenie wyswietla nazwy wszystkich pakietow znanych systemowi APT. Opcjonalnym argumentem jest przedrostek nazwy pakietow. Wynik jest odpowiedni do uzycia z funkcja powloki (shella) uzupelniania nazw za pomoca klawisza tabulacji i jest wypisywany bardzo szybko. Tego polecenia najlepiej uzywac z opcja --generate. Prosze zauwazyc, ze to, iz pakiet jest znany systemowi APT, niekoniecznie oznacza, ze jest dostepny do pobrania i zainstalowania albo zainstalowany. Moze byc np. pakietem wirtualnym, ktore takze sa wypisane w wygenerowanej liscie. dotty pakiet... dotty bierze jako argument liste pakietow i generuje wyjscie odpowiednie dla programu dotty z pakietu GraphViz[1]. Wynikiem bedzie zbior wierzcholkow i krawedzi reprezentujacych powiazania miedzy pakietami. Domyslnie podane pakiety wysledza wszystkie pakiety zalezne. Moze to spowodowac wypisanie bardzo duzego grafu. Aby wypisac powiazania tylko pomiedzy pakietami podanymi w linii polecen, nalezy uzyc opcji APT::Cache::GivenOnly. Wynikowe wierzcholki beda mialy roznorakie ksztalty: zwykle pakiety sa prostokatami, czyste pakiety wirtualne to trojkaty, mieszane pakiety wirtualne sa rombami, szesciokaty oznaczaja brakujace pakiety . Pomaranczowe prostokaty oznaczaja koniec rekurencji (liscie), niebieskie linie to pre-zaleznosci, linie zielone to konflikty. Uwaga: dotty nie potrafi narysowac wiekszego zbioru pakietow. xvcg pakiet... Robi to samo, co dotty, tylko dla xvcg z narzedzia VCG[2]. policy [pakiet...] policy jest pomyslane w celu debugowania zagadnien zwiazanych z plikiem preferencji. Jezeli nie podano zadnych opcji, wypisane zostana informacje o priorytecie kazdego zrodla. W przeciwnym wypadku, wypisuje szczegolowe informacje o priorytecie danego pakietu. madison pakiet... polecenie madison z apt-cache probuje nasladowac format wyjscia i czesc funkcjonalnosci programu madison - narzedzia zarzadzania archiwum Debiana. Wyswietla dostepne wersje pakietow w formacie tabeli. W przeciwienstwie do oryginalu, moze wyswietlic informacje tylko dla tych architektur, dla ktorych APT pobralo listy pakietow (APT::Architecture). OPCJE Wszystkie opcje linii polecen moga byc ustawione w pliku konfiguracyjnym. Ponizsze opisy wskazuja, ktora opcje w pliku konfiguracyjnym nalezy ustawic. W przypadku opcji logicznych, mozna uniewaznic ustawienia pliku konfiguracyjnego, uzywajac -f-, --no-f, -f=no albo czegos podobnego. -p, --pkg-cache Podaje nazwe pliku to przechowywania bufora pakietow, ktory jest podstawowym buforem uzywanym we wszystkich operacjach. Pozycja w pliku konfiguracyjnym: Dir::Cache::pkgcache. -s, --src-cache Podaje nazwe pliku to przechowywania bufora zrodel. Jest uzywany tylko przez akcje gencaches i przechowuje sparsowana wersje informacji o pakietach pobrana ze zdalnych zrodel. Podczas budowania bufora pakietow, bufor zrodel jest uzywany w celu unikniecia ponownego parsowania wszystkich plikow pakietow. Pozycja w pliku konfiguracyjnym: Dir::Cache::srcpkgcache. -q, --quiet Cichy; wypisuje tylko informacje potrzebne do logowania, opuszczajac wskazniki postepu. Wiecej znakow q spowoduje jeszcze bardziej ciche wyjscie, maksimum jest 2. Mozna takze ustawic poziom cichosci za pomoca -q=#,nadpisujac tym samym opcje z pliku konfiguracyjnego. Pozycja w pliku konfiguracyjnym: quiet. -i, --important Wyswietla tylko wazne zaleznosci; do uzywania z akcjami unmet o depends. Powoduje wypisanie tylko zaleznosci 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. --implicit Per default depends and rdepends print only dependencies explicitly expressed in the metadata. With this flag it will also show dependencies implicitly added based on the encountered data. A Conflicts: foo e.g. expresses implicitly that this package also conflicts with the package foo from any other architecture. Configuration Item: APT::Cache::ShowImplicit. -f, --full Podczas szukania wypisuj pelna informacje o pakiecie. Pozycja w pliku konfiguracyjnym: APT::Cache::ShowFull. -a, --all-versions Akcja show wypisuje wszystkie rekordy dla wszystkich dostepnych wersji. Jest to opcja domyslna, aby ja wylaczyc, prosze uzyc --no-all-versions. Jezeli podano --no-all-versions, to bedzie wyswietlana 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 uzywac istniejacego bufora. Ta opcja jest domyslnie wlaczona, aby ja wylaczyc, nalezy uzyc --no-generate. Pozycja w pliku konfiguracyjnym: APT::Cache::Generate. --names-only, -n Only search on the package and provided package names, not the long descriptions. Configuration Item: APT::Cache::NamesOnly. --all-names Powoduje, ze akcja pkgnames wypisze nazwy wszystkich pakietow, lacznie z pakietami wirtualnymi oraz pakietami majacymi brakujace zaleznosci. Pozycja w pliku konfiguracyjnym: APT::Cache::AllNames. --recurse Powoduje, ze zaleznosci w poleceniach depends i rdepends beda zaleznosciami rekurencyjnymi, tak ze wszystkie wymienione pakiety zostana wypisane tylko raz. Pozycja w pliku konfiguracyjnym: APT::Cache::RecurseDepends. --installed Ogranicza wyjscie polecen depends i rdepends tylko do pakietow, ktore sa obecnie zainstalowane. Pozycja w pliku konfiguracyjnym: APT::Cache::Installed. --with-source nazwa_pliku Adds the given file as a source for metadata. Can be repeated to add multiple files. Supported are currently *.deb, *.dsc, *.changes, Sources and Packages files as well as source package directories. Files are matched based on their name only, not their content! Sources and Packages can be compressed in any format apt supports as long as they have the correct extension. If you need to store multiple of these files in one directory you can prefix a name of your choice with the last character being an underscore ("_"). Example: my.example_Packages.xz Note that these sources are treated as trusted (see apt-secure(8)). Configuration Item: APT::Sources::With. -h, --help Wyswietla krotkie informacje o uzyciu. -v, --version Wyswietla wersje programu. --audit Show audit (and notice) messages. This overrides the quiet option, but only for notice messages, not progress ones. -c, --config-file Plik konfiguracyjny. Podaje plik konfiguracyjny do uzycia. Program najpierw przeczyta swoj domyslny plik konfiguracyjny, a nastepnie plik podany jako argument tej opcji. Jesli jest potrzeba ustawienia opcji konfiguracji zanim domyslny plik konfiguracyjny zostanie przetworzony, nalezy podac plik do uzycia w zmiennej srodowiskowej APT_CONFIG. Informacje o skladni pliku mozna znalezc w apt.conf(5). -o, --option Set a Configuration Option; This will set an arbitrary configuration option. The syntax is -o Foo::Bar=bar. -o and --option can be used multiple times to set different options. --no-color, --color Turn colors on or off. Colors are on by default on supported terminals for apt(8) and can also be disabled using the NO_COLOR or APT_NO_COLOR environment variables, or further configured by the APT::Color configuration option and scope, see apt.conf(5) for information on that. PLIKI /etc/apt/sources.list Lokalizacje, z ktorych beda sciagane pakiety. Pozycja w pliku konfiguracyjnym: Dir::Etc::SourceList. /etc/apt/sources.list.d/ Czesci pliku zawierajacego lokalizacje, z ktorej sa pobierane pakiety. Pozycja w pliku konfiguracyjnym: Dir::Etc::SourceParts. /var/lib/apt/lists/ Skladnica zawierajaca informacje o kazdym 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 (partial zostanie dodane automatycznie) ZOBACZ TAKZE apt.conf(5), sources.list(5), apt-get(8), apt-patterns(7) DIAGNOSTYKA apt-cache zwraca zero, gdy zakonczylo sie pomyslnie, 100 - w przypadku bledu. BUGS Strona bledow APT[3]. Aby zglosic blad w APT, prosze przeczytac /usr/share/doc/debian/bug-reporting.txt lub opis polecenia reportbug(1). TLUMACZENIE Tlumaczenie stron podrecznika: Robert Luberda , 2000-2012. Tlumaczenie przewodnika offline: Krzysztof Fiertek , 2004 Prosze zauwazyc, ze przetlumaczony dokument moze zawierac fragmenty nieprzetlumaczone. Ma to na celu unikniecie utracenia istotnych informacji, w przypadkach gdy oryginal zostanie zaktualizowany, a tlumaczenie - nie. AUTORZY Jason Gunthorpe zespol APT PRZYPISY 1. GraphViz https://graphviz.org/ 2. narzedzia VCG https://www.rw.cdl.uni- saarland.de/people/sander/private/html/gsvcg1.html 3. Strona bledow APT https://bugs.debian.org/src:apt APT 2.9.6 14 marzec 2024 APT-CACHE(8)