Ubuntu Manpage: apt-cache - odpytanie bufora APT

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 poniższych poleceń musi być użyte, chyba że została podana opcja -h albo --help.

       gencaches
           gencaches 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:

               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:

           •   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".

           •   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.

           •   Całkowite zależności (Total dependencies) to liczba więzów zależności 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 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 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 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-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 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
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 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
Only search on the package and provided package names, not the long descriptions.
Configuration Item: 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.

--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
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.list
           Lokalizacje, 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ół APT

PRZYPISY

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

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

        3. Strona błędów APT
           http://bugs.debian.org/src:apt