table of contents
APT-CACHE(8) | APT | APT-CACHE(8) |
NAZWA¶
apt-cache - odpytanie bufora APTSTRESZCZENIE¶
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 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 albo --help. gencachesgencaches tworzy bufor (cache) APT
pakietów. Wywoływane jest automatycznie przez wszystkie polecenia
potrzebujące bufora, jeśli nie istnieje lub jest
przestarzały.
showpkg pakiet...
showpkg wyświetla informacje na temat
pakietów podanych w linii poleceń. Pozostałymi 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:
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
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:
stats wyświetla statystyki dotyczące
bufora pakietów. Nie wymaga żadnych argumentów. Wypisywane
są następujące statystyki:
showsrc pakiet...
•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 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 "X11-text-viewer" jest pakietem
wirtualnym, ale tylko jeden pakiet, mianowicie "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
"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" lub
"Breaks".
•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 ze "stable", jak i z
"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, których podana nazwa odpowiada nazwie pakietu
binarnego.
dump
dump pokazuje krótką listę
wszystkich pakietów w buforze. Jest używany głównie w celu
odpluskwiania.
dumpavail
dumpavail wypisuje na standardowe wyjście
(stdout) listę dostępnych pakietów. Jest to polecenie
odpowiednie do użycia z programem dpkg(1) i jest używane w
metodzie dselect(1) tego programu.
unmet
unmet pokazuje podsumowanie wszystkich
niespełnionych zależności w buforze pakietów
show pakiet...
show spełnia funkcje podobne do dpkg
--print-avail; pokazuje szczegółowe informacje o podanych
pakietach.
search wyr_regularne...
search wykonuje pełne wyszukiwanie
podanego wzorca będącego wyrażeniem regularnym POSIX (patrz
regex(7)) we wszystkich dostępnych listach pakietów.
Przeszukuje nazwy pakietów (w tym pakietów wirtualnych) i ich
szczegółowe (długie) opisy, szukają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 polecenie show. Jeżeli podano opcję --names-only, to
są przeszukiwane tylko nazwy pakietów, bez ich długich
opisów.
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 pakiet...
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 pakiet...
rdepends pokazuje listę wszystkich
odwrotnych zależności danego pakietu.
pkgnames [prefiks]
To polecenie wyświetla nazwy wszystkich
pakietów znanych systemowi APT. 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
i jest wypisywany bardzo szybko. Tego polecenia najlepiej używać z
opcją --generate.
Proszę zauważyć, że to, iż pakiet jest znany systemowi
APT, niekoniecznie oznacza, że jest dostępny do pobrania i
zainstalowania albo zainstalowany. Może być np. pakietem wirtualnym,
które także są wypisane w wygenerowanej liście.
dotty pakiet...
dotty bierze jako argument listę
pakietów i generuje wyjście odpowiednie dla programu dotty z pakietu
GraphViz[1]. 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 rekurencji
(liście), niebieskie linie to pre-zależności, linie zielone to
konflikty.
Uwaga: dotty nie potrafi narysować większego zbioru
pakietów.
xvcg pakiet...
Robi to samo, co dotty, tylko dla xvcg z
narzędzia VCG[2].
policy [pakiet...]
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.
madison pakiet...
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. -p, --pkg-cachePodaje nazwę pliku to przechowywania
bufora pakietów, który jest podstawowym buforem używanym we
wszystkich operacjach. Pozycja w pliku konfiguracyjnym:
Dir::Cache::pkgcache.
-s, --src-cache
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.
-q, --quiet
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.
-i, --important
Wyświetla tylko ważne
zależności; do używania z akcjami unmet o depends. Powoduje
wypisanie tylko zależności 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
Domyślnie depends i rdepends
wypisują wszystkie zależności. Można to zmienić,
używając tych flag, które spowodują pominięcie
podanych typów zależności. Pozycja w pliku konfiguracyjnym:
APT::Cache::Show TypZależności, na przykład
APT::Cache::ShowRecommends.
-f, --full
Podczas szukania wypisuj pełną
informację o pakiecie. Pozycja w pliku konfiguracyjnym:
APT::Cache::ShowFull.
-a, --all-versions
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.
-g, --generate
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.
--names-only, -n
Przeszukaj tylko nazwy pakietów,
pomijając szczegółowe opisy. Pozycja w pliku konfiguracyjnym:
APT::Cache::NamesOnly.
--all-names
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.
--recurse
Powoduje, że zależności w
poleceniach depends i rdepends będą zależnościami
rekurencyjnymi, tak że wszystkie wymienione pakiety zostaną wypisane
tylko raz. Pozycja w pliku konfiguracyjnym: APT::Cache::RecurseDepends.
--installed
Ogranicza wyjście poleceń depends i
rdepends tylko do pakietów, które są obecnie zainstalowane.
Pozycja w pliku konfiguracyjnym: APT::Cache::Installed.
-h, --help
Wyświetla krótkie informacje o
użyciu.
-v, --version
Wyświetla wersję programu.
-c, --config-file
Plik konfiguracyjny. Podaje plik
konfiguracyjny do użycia. Program najpierw przeczyta swój
domyślny plik konfiguracyjny, a następnie plik podany jako argument
tej opcji. Jeśli jest potrzeba ustawienia opcji konfiguracji zanim
domyślny plik konfiguracyjny zostanie przetworzony, należy
podać plik do użycia w zmiennej środowiskowej
APT_CONFIG. Informacje o składni pliku można
znaleźć w apt.conf(5).
-o, --option
Ustawia opcję konfiguracji. Pozwala
ustawić dowolną opcję konfiguracji. Składnia jest
następująca: -o Foo::Bar=bar. -o i --option
można podać wielokrotnie - do ustawiania różnych
opcji.
PLIKI¶
/etc/apt/sources.listLokalizacje, z których będą
ściągane pakiety. Pozycja w pliku konfiguracyjnym:
Dir::Etc::SourceList.
/etc/apt/sources.list.d/
Części pliku zawierającego
lokalizacje, z której są pobierane pakiety. Pozycja w pliku
konfiguracyjnym: Dir::Etc::SourceParts.
/var/lib/apt/lists/
Składnica zawierająca informacje o
każdym zasobie pakietów podanym w sources.list(5) Pozycja w
pliku konfiguracyjnym: Dir::State::Lists.
/var/lib/apt/lists/partial/
Składnica obecnie pobieranych informacji
o stanie pakietów. Pozycja w pliku konfiguracyjnym: Dir::State::Lists
(partial zostanie dodane automatycznie)
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.BUGS¶
Strona błędów APT[3]. Aby zgłosić błąd w APT, proszę przeczytać /usr/share/doc/debian/bug-reporting.txt lub opis polecenia reportbug(1).TŁUMACZENIE¶
Tłumaczenie stron podręcznika: Robert Luberda <robert@debian.org>, 2000-2012. Tłumaczenie przewodnika offline: Krzysztof Fiertek <akfedux@megapolis.pl>, 2004 Proszę zauważyć, że przetłumaczony dokument może zawierać fragmenty nieprzetłumaczone. Ma to na celu uniknięcie utracenia istotnych informacji, w przypadkach gdy oryginał zostanie zaktualizowany, a tłumaczenie - nie.AUTORZY¶
Jason Gunthorpe zespół APTPRZYPISY¶
- 1.
- GraphViz
- 2.
- narzędzia VCG
- 3.
- Strona błędów APT
09 czerwiec 2012 | APT 0.9.7.9 |