Provided by:
manpages-pl_20051117-1_all 
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:
add plik(i)
dodaje pliki zawierające indeks nazw pakietów do bufora. Ta
opcja jest przydatna głównie w celu odpluskwiania.
gencaches
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 pakiet(y)
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 stats wyświetla statystyki dotyczące bufora pakietów. Nie
wymaga żadnych argumentów. Wypisywane są następujące statystyki:
o Całkowita liczba nazw pakietów (Total package names) - liczba
nazw pakietów znajdujących się w buforze.
o 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.
o 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".
o 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".
o 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.
o 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".
o 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.
o Całkowite zależności (Total dependencies) to liczba więzów
zależności wymaganych przez wszystkie pakiety w buforze.
showsrc pakiet(y)
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 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(8) i jest używane w metodzie programu dselect(8)
unmet unmet pokazuje podsumowanie wszystkich niespełnionych zależności
w buforze pakietów
show pakiet(y)
show spełnia funkcje podobne do dpkg --print-avail; pokazuje
szczegółowe informacje o podanych pakietach.
search wyraenie regularne [ wyraenie regularne ... ]
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 pakiet(y)
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(y)
rdepends pokazuje listę wszystkich odwrotnych zależności danego
pakietu.
pkgnames [ prefiks ]
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 pakiet(y)
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 [ pakiet(y) ]
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(y) ]
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-cache
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.
-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 akcją unmet.
Powoduje wypisanie tylko zależności typu Depends i Pre-Depends.
Pozycja w pliku konfiguracyjnym: APT::Cache::Important.
-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
Czyni zależności rekursyjnymi, tak że wszystkie wymienione
pakiety będą 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ótki komunikat pomocy.
-v, --version
Wyświetla wersję programu.
-c, --config-file
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).
-o, --option
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.