Переводы страниц руководства

Новости   Список переводов по пакетам   Все переводы   Репозиторий Debian   Как нам помочь   Участники проекта   Словарь терминов

Страницы руководства  - APT-CACHE (8)


НАЗВАНИЕ

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 выведет нечто похожее на следующее:
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:

Здесь можно увидеть, что пакет libreadline2, версия 2.1-12, зависит от libc5 и ncurses3.0; они должны быть установлены, чтобы libreadline2 заработал. Далее libreadlineg2 и libreadline2-altdev зависят от libreadline2. Если пакет libreadline2 устанавлен, то и пакеты libc5, ncurses3.0 и ldso также должны быть установлены, а libreadlineg2 и libreadline2-altdev могут и не быть установлены. Для того, чтобы понять остальную информацию лучше всего посмотреть исходные тексты apt.

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
Перейти в начало страницы |  Раздел 8 |  Главный указатель.
Сгенерировано manServer 1.07 из /home/stupin/man/man8/apt-cache.8.gz с использованием макросов man.