Ubuntu Manpage: apt-cache - odpytanie bufora APT

nazwa
streszczenie
opis
opcje
pliki
zobacz także
diagnostyka
bugs
tłumaczenie
autorzy
przypisy

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.

--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 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
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 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), apt-patterns(7)

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
           https://graphviz.org/

        2. narzędzia VCG
           https://www.rw.cdl.uni-saarland.de/people/sander/private/html/gsvcg1.html

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