apt-cache - низкоуровневый инструмент, используемый для управления двоичными кэш-файлами APT и поиску по ним
apt-cache [-hvsn] [-o=config string] [-c=file] {[add file...] | [gencaches] | [showpkg pkg...] | [showsrc pkg...] | [stats] | [dump] | [dumpavail] | [unmet] | [search regex] | [show pkg...] | [depends pkg...] | [rdepends pkg...] | [pkgnames prefix] | [dotty pkg...] | [xvcg pkg...] | [policy pkgs...] | [madison pkgs...]}
apt-cache выполняет ряд операций над кэшем пакетов APT. apt-cache не управляет состоянием системы, а предоставляет операции поиска и генерации информации из метаданных пакета.
Если параметр -h или --help, то далее должна присутствовать одна из команд:
add file(s)
add добавляет индексные файлы имен пакетов в кэш пакетов. Только для отладки.gencaches
gencaches выполняет такую же операцию как и apt-get check. Он создаёт кэш источников и кэш пакетов из их источников в sources.list(5) и из /var/lib/dpkg/status.showpkg pkg(s)
showpkg выводит информацию о пакетах, перечисленных в командой строке. Остальные аргументы являются именами пакетов. Перечисляются как доступные версии так и обратные зависимости каждого пакета, а также прямые зависимости для каждой версии. Прямые (обычные) зависимости - это те зависимости, от которых зависит данный пакет; обратные зависимости указывают на то, что существуют другие пакеты, которые зависят от данного пакета. Таким образом, прямые зависимости должны быть удовлетворены для установки пакета, а обратные могут и не быть удовлетворены. Для примера, apt-cache showpkg libreadline2 выведет нечто похожее на следующее:Здесь можно увидеть, что пакет libreadline2, версия 2.1-12, зависит от libc5 и ncurses3.0; они должны быть установлены, чтобы libreadline2 заработал. Далее libreadlineg2 и libreadline2-altdev зависят от libreadline2. Если пакет libreadline2 устанавлен, то и пакеты libc5, ncurses3.0 и ldso также должны быть установлены, а libreadlineg2 и libreadline2-altdev могут и не быть установлены. Для того, чтобы понять остальную информацию лучше всего посмотреть исходные тексты apt.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
stats отображает некоторую статистику кэша. Аргументы не нужны. Статистический отчет выглядит так (поля):oКоличество имен пакетов, найденных в кэше.oНормальные пакеты - это количество обычных имен пакетов; таких пакетов у которых имя пакета и имя используемое другими пакетами в зависимостях совпадают один к одному. Большинство пакетов относятся именно к этой категории.oЦеликом виртуальные пакеты - это количество пакетов, которые существуют только как виртуальные; те пакеты которые только "предоставляют" виртуальное имя пакета, за которым нет фактического пакета, использующего это имя. Например, "mail-transport-agent" в системе Debian GNU/Linux -- это чистый виртуальный пакет; несколько пакетов предоставляют "mail-transport-agent", но нет ни одного пакета с названием "mail-transport-agent.oОдиночные виртуальные пакеты - это количество пакетов, в которых только один из пакетов предоставляет соответствующих виртуальный пакет. Например, в системе Debian GNU/Linux, "X11-text-viewer" - это виртуальный пакет, но только один пакет, xless, предоставляет "X11-text-viewer.oСмешанные виртуальные пакеты - это количество пакетов, которые и предоставляют соответствующий виртуальный пакет и имеют имя виртуального пакета в качестве имени пакета. Например, в системе Debian GNU/Linux, e2fsprogs - это и реальный пакет и пакет, который предоставляет пакет e2compr.oОтсутствуют - это количество имен пакетов, на которые ссылаются в зависимостях, но которые не предоставляются ни одним из пакетов. Отсутствующие пакеты могут быть в отсутствующей части, если полный дистрибутив недоступен или если пакет (реальный или виртуальный) был удален из дистрибутива.oРазличных версий - это количество версий пакетов, найденных в кэше; данное значение по крайней мере должно быть равно общему количеству имен пакетов. Если доступен более чем один дистрибутив (например, и "stable" и "unstable"), то данное значение может быть значительно больше, чем общее количество имен пакетов.oВсего зависимостей - это количество зависимостей требуемых всеми пакетами в кэше.
showsrc pkg(s)
showsrc отображает все записи источников пакета с исходным кодом. Отображаются все версии, а также все записи, которые описывают бинарные пакеты.dump
dump показывает краткий список по каждому пакету в кэше. Команда в первую очередь нужна для отладки.dumpavail
dumpavail выдает список всех доступных пакетов. Команда полезна для использования с dpkg(1) и используется в dselect(1).unmet
unmet выдает краткую справку об неудовлетворенных зависимостях в кэше пакетов.show pkg(s)
show выполняет функцию, аналогичную dpkg --print-avail; она отображает описание пакета в виде списка.search regex [ regex ... ]
search выполняет полнотекстовый поиск по всем доступным спискам пакетов по заданному шаблону POSIX-формата, смотрите regex(7). Команда просматривает имена пакетов и описания по заданному регулярному выражению, а также выводит имя пакета и его краткое описание, включая имена виртуального пакета. Если задана опция --full то вывод будет идентичен команде show если найдутся пакеты удовлетворяющие условию, а если задана опция --names-only, то поиск в длинном описании производиться не будет, а только в именах пакетов.Некоторые аргументы могут быть использованы для поиска по нескольким шаблонам также совместно.
depends pkg(s)
depends показывает список, состоящий из всех пакетов, от которых зависит данный пакет и всех других пакетов, которые могут полностью покрывать данную зависимость.rdepends pkg(s)
rdepends показывает список каждой обратной зависимости от пакета.pkgnames [ prefix ]
Данная команда выдает имя каждого пакета в системе АРТ. Необязательный аргумент - это префикс для фильтрации списка имен. Вывод этой команды обычно используется в функциях оболочки и генерируется очень быстро. Данную команду лучше всего использовать с опцией --generate.dotty pkg(s)
dotty берет список пакетов из командной строки и генерирует вывод, удобный для использования пакетом dotty из пакета GraphViz[1]. Результатом будет список узлов и краев, который представляет собой отношения между пакетами. По умолчанию заданные пакеты будут отслеживаться на предмет всех зависимостей, что будет представлять из себя очень большую схему. Такое поведение можно отключить установкой опции APT::Cache::GivenOnly.Результирующие узлы будут выглядеть определенными фигурами, обычные пакеты как боксы, простые - представляются треугольниками, смешанные - ромбами, отсутствующие пакеты - шестиугольниками. Оранжевые боксы означают рекурсию, которая была остановлена [leaf packages], синие линии - это предварительные зависимости, зеленые - конфликты.
Внимание, dotty не может отображать большие списки пакетов
xvcg pkg(s)
То же, что и dotty, только для xvcg из VCG tool[2].policy [ pkg(s) ]
policy предназначена для отладки проблем, связанных с файлом настроек. Без аргументов он будет выводить приоритеты для каждого источника. В противном случае она выводит подробную информацию о выбранных приоритетах пакета.madison /[ pkg(s) ]
Команда madison пытается имитировать выходной формат и частично функциональность инструмента управления архивом Debian’а, madison.Она отображает доступные версии пакета в табличном формате.В отличие от оригинального Мэдисон, она может только отображать информацию для архитектуры, для которых АРТ получил списки пакетов (APT::Architecture)
Все опции командной строки могут быть заданы при помощи файла настроек, обозначив в описаниях устанавливаемые элементы настройки. Для логических опций вы можете перепереназначать в файле с настройками, используя конструкцию вида -f-,--no-f, -f=no или некоторые другие вариации.
-p, --pkg-cache
Выбрать файл для хранения кэша пакетов. Данный кэш является первичным кэшем, который используется всеми другими операциями. Элемент настройки: Dir::Cache::pkgcache.-s, --src-cache
Выбрать файл для записи источника кэша. Этот источник используется только gencaches и он хранит обработанную информации о версии пакета из внешнего источника. Когда строится кэш пакетов, источника кэша используется для предотвращения повторной обработки всех файлов пакета. Элемент настройки: Dir::Cache::srcpkgcache.-q, --quiet
Quiet; Генерируется информация, пригодная для протоколирования, в которой опускаются индикаторы хода выполнения задачи. Указание большего числа опций -q приведет к более урезанному выводу, максимально вы можете указать два раза. Вы также можете использовать конструкцию -q=# для установки нужного вам количества сообщений вывода, перекрывая файл с настройками. Элемент настройки: quiet.-i, --important
Выводить только важные зависимости; для использования с опциями unmet и depends. Будут отображены только отношения между Depends и Pre-Depends.-f, --full
Выдавать полные описания пакета во время поиска. Элемент настройки: APT::Cache::ShowFull.-a, --all-versions
Выдавать все описания для всех доступных версий. Это по умолчанию; чтобы отключить, используйте --no-all-versions. Если --no-all-versions указана, то будут показана только кандидат версия(та, которая будет выбрана для установки). Эта опция применима только к команде show. Элемент настройки: APT::Cache::AllVersions.-g, --generate
Выполнять автоматическую регенерацию кэша, использовать кэш в том виде, как есть. Это по умолчанию; чтобы отключить, используйте --no-generate. Элемент настройки: APT::Cache::Generate.--names-only, -n
Искать только имена пакетов, а не длинные описания. Элемент настройки: APT::Cache::NamesOnly.--all-names
Заставляет команду pkgnames выдавать все имена, включая имена виртуальных пакетов и отсутствующие зависимости. Элемент настройки: APT::Cache::AllNames.--recurse
Обработать рекурсивно прямые и обратные зависимости так, чтобы все упомянутые пакеты выводились один раз. Элемент настройки: APT::Cache::RecurseDepends.--installed
Ограничить вывод установленных прямых и обратных зависимостей пакетов. Элемент настройки: APT::Cache::Installed.-h, --help
Выдает краткую подсказку.-v, --version
Выдает версию программы.-c, --config-file
Файл с настройками; Задать для использования файл с настройками. Программа будет читать определенный по умолчанию и этот файл с настройками. Смотрите синтаксис apt.conf(5).-o, --option
Установить Configuration Option; Она будет установлена определенной опцией настройки. Используется следующий синтаксис: -o Foo::Bar=bar. -o и --option может быть использована множество раз, чтобы установить различные варианты.
/etc/apt/sources.list
Источники для получения пакетов. Элемент настройки: Dir::Etc::SourceList/var/lib/apt/lists/
Область хранения информации о состоянии каждого ресурса пакетов, заданного в списке источников. Элемент настройки: Dir::Etc::Lists./var/lib/apt/lists/partial/
Временная область хранения информации в процессе скачивания. Элемент настройки: Dir::State::Lists.
apt.conf(5), sources.list(5), apt-get(8)
apt-cache возвращает ноль при нормальной работе и число 100 при ошибке.
APT bug page[3]. Если вы хотите сообщить об ошибке в АРТ, смотрите /usr/share/doc/debian/bug-reporting.txt или команду reportbug(1).
Jason Gunthorpe
APT team
Автор.
Автор.
Перевод на русский язык выполнил Геннадий Курбатов <wertklop@yandex.ru>. В этом переводе были использованы фрагменты из устаревшего перевода, ранее выполненного Виктором Вислобоковым <victor_v@permonline.ru>.
1. GraphViz http://www.research.att.com/sw/tools/graphviz/ 2. VCG tool http://rw4.cs.uni-sb.de/users/sander/html/gsvcg1.html 3. APT bug page http://bugs.debian.org/src:apt
| Linux | APT-CACHE (8) | 29 февраля 2004 |