Scroll to navigation

APT-CACHE(8) APT-CACHE(8)

NAZWA

apt-cache - narzędzie zarządzania pakietami APT -- manipulator bufora

SKŁADNIA

apt-cache [-hvsn] [-o=opcja-konfiguracji] [-c=plik] {add plik... | gencaches | showpkg pakiet... | showsrc pakiet... | stats | dump | dumpavail | unmet | search regex | show pakiet... | depends pakiet... | rdepends pakiet... | pkgnames prefiks | dotty pakiet... | policy pakiety... | madison pakiety...}

OPIS

apt-cache wykonuje różnorodne operacje na buforze (cache) pakietów programu APT. apt-cache nie zmienia stanu systemu, ale dostarcza mechanizmów przeszukiwania metadanych pakietów i generowania interesującego wyjścia.

Jedno z poniższych poleceń musi być użyte, chyba że została podana opcja -h lub --help:

dodaje pliki zawierające indeks nazw pakietów do bufora. Ta opcja jest przydatna głównie w celu odpluskwiania.

gencaches wykonuje te same operacje, co apt-get check. Buduje bufor pakietów oraz źródeł pakietów na podstawie źródeł wymienionych w sources.list(5) oraz pliku /var/lib/dpkg/status.

showpkg wyświetla informacje na temat pakietów podanych w linii poleceń. Wymaganymi argumentami są nazwy pakietów. Wyświetlane są dostępne wersje oraz odwrotne zależności każdego z podanych pakietów, jak również zwykłe zależności dla każdej z wersji Normalne (zwykłe) zależności to są pakiety, od których dany pakiet zależy, odwrotne zależności stanowią te pakiety, które zależą od danego pakietu. Tak więc, pakiet musi spełniać normalne zależności, ale odwrotnych zależności - nie musi. Na przykład, apt-cache showpkg libreadline2 wypisze wyjście podobne do poniższego:

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 zależy od libc5 i ncurses3.0, które muszą być zainstalowane, aby libreadline2 działała. Z kolei libreadlineg2 i libreadline2-altdev zależą od libreadline2. Jeżeli libreadline2 jest zainstalowany, to libc5 i ncurses3.0 (i ldso) muszą być także zainstalowane; natomiast libreadlineg2 oraz libreadline2-altdev nie muszą być zainstalowane. W celu zrozumienia, co oznaczają pozostałe linie, najlepiej przejrzeć kod źródłowy programu apt.

stats wyświetla statystyki dotyczące bufora pakietów. Nie wymaga żadnych argumentów. Wypisywane są następujące statystyki:

Całkowita liczba nazw pakietów (Total package names) - liczba nazw pakietów znajdujących się w buforze.
Zwykłe pakiety (Normal packages) jest to liczba zwykłych, regularnych nazw pakietów; są to pakiety, dla których istnieje relacja "jeden do jednego" między ich nazwami a nazwami używanymi przez inne pakiety jako zależności. Większość pakietów należy do tej kategorii.
Czyste pakiety wirtualne (Pure virtual packages) określa liczbę pakietów, które istnieją tylko jako nazwa pakietu wirtualnego; to jest pewne pakiety "dostarczają" tej nazwy wirtualnej, ale żaden pakiet nie używa tej nazwy. Na przykład "mail-transport-agent" w systemie Debian GNU/Linux jest czystym pakietem wirtualnym; kilka pakietów dostarcza "mail-transport-agenta", ale żaden pakiet nie nazywa się "mail-transport-agent".
Pojedyncze pakiety wirtualne (Single virtual packages) - liczba pakietów, dla których istnieje tylko jeden pakiet, który dostarcza danego pakietu wirtualnego. Na przykład, w systemie Debian GNU/Linux "X11-text-viewer" jest pakietem wirtualnym, ale tylko jeden pakiet - xless - dostarcza "X11-text-viewer".
Mieszane pakiety wirtualne (Mixed virtual packages) - liczba pakietów, które albo dostarczają poszczególnych pakietów wirtualnych, albo nazywają się tak, jak nazwa pakietu wirtualnego. Na przykład w systemie Debian GNU/Linux "debconf" jest zarówno zwykłym pakietem, jak i jest pakietem dostarczanym przez pakiet debconf-tiny.
Brakujące (Missing) jest liczbą nazw pakietów, do których odnoszą się jakieś zależności, ale które nie są spełnione przez żaden z dostępnych pakietów. Brakujące pakiety mogą być dowodem, że nie ma dostępu do całej dystrybucji albo że pakiet (rzeczywisty lub wirtualny) został usunięty z dystrybucji. Zazwyczaj odniesienia takie znajdują się w zależnościach typu "Conflicts".
Całkowita liczba różnych wersji (Total distinct versions) jest to liczba wersji pakietów znajdujących się w buforze, tak więc ta wartość jest co najmniej równa liczbie wszystkich nazw pakietów. Jeżeli pobierane są pakiety z więcej niż jednej dystrybucji (na przykład zarówno "stable", jak i "unstable"), wartość ta może być znacznie większa niż liczba wszystkich nazw pakietów.
Całkowite zależności (Total dependencies) to liczba więzów zależności wymaganych przez wszystkie pakiety w buforze.
showsrc wyświetla wszystkie pakiety źródłowe, które odpowiadają podanym nazwom pakietów. Wyświetlone zostaną wszystkie wersje tych pakietów oraz pakiety binarne, które są z tych pakietów budowane.

dump pokazuje krótką listę wszystkich pakietów w buforze. Jest używany głównie w celu odpluskwiania.

dumpavail wypisuje na standardowe wyjście (stdout) listę dostępnych pakietów. Jest to polecenie odpowiednie do użycia z programem dpkg(8) i jest używane w metodzie programu dselect(8)

unmet pokazuje podsumowanie wszystkich niespełnionych zależności w buforze pakietów

show spełnia funkcje podobne do dpkg --print-avail; pokazuje szczegółowe informacje o podanych pakietach.

search wykonuje pełne wyszukiwanie podanego wzorca (wyrażenia regularnego) we wszystkich dostępnych listach pakietów. Przeszukuje nazwy pakietów i ich szczegółowe (długie) opisy, szukując w nich podanego wyrażenia regularnego i wypisuje nazwę pakietu i jego krótki opis. Jeżeli podana jest opcja --full, to wtedy dla każdego znalezionego pakietu informacje na wyjściu są podobne do tego, co pokazuje akcja show. Jeżeli podano opcję --names-only, to są przeszukiwane tylko nazwy pakietów, a nie ich długie opisy.

Oddzielne argumenty mogą być używane do podania kilku wzorców, które będą traktowane jakby były połączone spójnikiem logicznym "i".

depends wyświetla listę wszystkich zależności danego pakietu i wszystkie możliwe pakiety, które mogą spełnić te zależności.

rdepends pokazuje listę wszystkich odwrotnych zależności danego pakietu.

To polecenie wyświetla nazwy wszystkich pakietów zainstalowanych w systemie. Opcjonalnym argumentem jest przedrostek nazwy pakietów. Wynik jest odpowiedni do użycia z funkcją powłoki (shella) uzupełniania nazw za pomocą klawisza tabulacji, a wynik jest wypisywany bardzo szybko. Tego polecenia najlepiej używać z opcją --generate.

dotty bierze jako argument listę pakietów i generuje wyjście odpowiednie dla programu dotty z pakietu GraphVis <URL:http://www.research.att.com/sw/tools/graphviz/> Wynikiem będzie zbiór wierzchołków i krawędzi reprezentujących powiązania między pakietami. Domyślnie podane pakiety wyśledzą wszystkie pakiety zależne. Może to spowodować wypisanie bardzo dużego grafu. Aby wypisać powiązania tylko pomiędzy pakietami podanymi w linii poleceń, należy użyć opcji APT::Cache::GivenOnly.

Wynikowe wierzchołki będą miały różnorakie kształty: zwykłe pakiety są prostokątami, czyste pakiety wirtualne to trójkąty, mieszane pakiety wirtualne są rombami, sześciokąty oznaczają brakujące pakiety . Pomarańczowe prostokąty oznaczają koniec rekursji (liście), niebieskie linie to pre-zależności, linie zielone - to konflikty.

Uwaga: dotty nie potrafi narysować większego zbioru pakietów.

policy jest pomyślane w celu debugowania zagadnień związanych z plikiem preferencji. Jeżeli nie podano żadnych opcji, wypisane zostaną informacje o priorytecie każdego źródła. W przeciwnym wypadku, wypisuje szczegółowe informacje o priorytecie danego pakietu.

polecenie madison z apt-cache próbuje naśladować format wyjścia i część funkcjonalności programu madison - narzędzia zarządzania archiwum Debiana. Wyświetla dostępne wersje pakietów w formacie tabeli. W przeciwieństwie do oryginału, może wyświetlić informacje tylko dla tych architektur, dla których APT pobrało listy pakietów (APT::Architecture).

OPCJE

Wszystkie opcje linii poleceń mogą być ustawione w pliku konfiguracyjnym. Poniższe opisy wskazują, którą opcję w pliku konfiguracyjnym należy ustawić. W przypadku opcji logicznych, można unieważnić ustawienia pliku konfiguracyjnego, używając -f-,--no-f, -f=no albo czegoś podobnego.

Podaje nazwę pliku to przechowywania bufora pakietów, który jest podstawowym buforem używanym we wszystkich operacjach. Pozycja w pliku konfiguracyjnym: Dir::Cache::pkgcache.

Podaje nazwę pliku to przechowywania bufora źródeł. Jest używany tylko przez akcję gencaches i przechowuje sparsowaną wersję informacji o pakietach pobraną ze zdalnych źródeł. Podczas budowania bufora pakietów, bufor źródeł jest używany w celu uniknięcia ponownego parsowania wszystkich plików pakietów. Pozycja w pliku konfiguracyjnym: Dir::Cache::srcpkgcache.

Cichy; wypisuje tylko informacje potrzebne do logowania, opuszczając wskaźniki postępu. Więcej znaków q spowoduje jeszcze bardziej ciche wyjście, maksimum jest 2. Można także ustawić poziom cichości za pomocą -q=#, nadpisując tym samym opcję z pliku konfiguracyjnego. Pozycja w pliku konfiguracyjnym: quiet.

Wyświetla tylko ważne zależności; do używania z akcją unmet. Powoduje wypisanie tylko zależności typu Depends i Pre-Depends. Pozycja w pliku konfiguracyjnym: APT::Cache::Important.

Podczas szukania wypisuj pełną informację o pakiecie. Pozycja w pliku konfiguracyjnym: APT::Cache::ShowFull.

Akcja show wypisuje wszystkie rekordy dla wszystkich dostępnych wersji. Jest to opcja domyślna, aby ją wyłączyć, proszę użyć --no-all-versions. Jeżeli podano --no-all-versions, to będzie wyświetlana tylko wersja-kandydat (czyli ta, która byłaby wybrana do instalacji). Ta opcja ma znaczenie tylko dla polecenia show. Pozycja w pliku konfiguracyjnym: APT::Cache::AllVersions.

Automatycznie odbudowuje bufor pakietów, zamiast używać istniejącego bufora. Ta opcja jest domyślnie włączona, aby ją wyłączyć, należy użyć --no-generate. Pozycja w pliku konfiguracyjnym: APT::Cache::Generate.

Przeszukaj tylko nazwy pakietów, pomijając szczegółowe opisy. Pozycja w pliku konfiguracyjnym: APT::Cache::NamesOnly.

Powoduje, że akcja pkgnames wypisze nazwy wszystkich pakietów, łącznie z pakietami wirtualnymi oraz pakietami mającymi brakujące zależności. Pozycja w pliku konfiguracyjnym: APT::Cache::AllNames.

Czyni zależności rekursyjnymi, tak że wszystkie wymienione pakiety będą wypisane tylko raz. Pozycja w pliku konfiguracyjnym: APT::Cache::RecurseDepends.

Ogranicza wyjście poleceń depends i rdepends tylko do pakietów, które są obecnie zainstalowane. Pozycja w pliku konfiguracyjnym: APT::Cache::Installed.

Wyświetla krótki komunikat pomocy.

Wyświetla wersję programu.

Plik konfiguracyjny. Określa plik konfiguracyjny, którego należy użyć. Program przeczyta domyślny plik konfiguracyjny, następnie plik podany jako argument tej opcji. Informacje na temat składni pliku konfiguracyjnego można znaleźć w apt.conf(5).

Ustawia opcję konfiguracyjną. Można ustawić dowolną opcję konfiguracyjną, używając składni: -o Foo::Bar=bar.

PLIKI

/etc/apt/sources.list
Lokalizacje, z których będą ściągane pakiety Pozycja w pliku konfiguracyjnym: Dir::Etc::SourceList.

/var/lib/apt/lists/
Składnica informacji o stanie każdej lokalizacji pakietów podanej w sources.list(5) Pozycja w pliku konfiguracyjnym: Dir::State::Lists.

/var/lib/apt/lists/partial/
Składnica informacji o stanie w trakcie ściągania. Pozycja w pliku konfiguracyjnym: Dir::State::Lists (implikuje partial).

ZOBACZ TAKŻE

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

DIAGNOSTYKA

apt-cache zwraca zero, gdy zakończyło się pomyślnie, 100 - w przypadku błędu.

BŁĘDY

Strona błędów APT: http://bugs.debian.org/src:apt. Aby złożyć raport o błędzie w APT, prosimy przeczytać /usr/share/doc/debian/bug-reporting.txt lub użyć polecenia reportbug(1).

AUTORZY

Jason Gunthorpe, zespół APT.

29 lutego 2004 Linux