PKG_INFO(1)           Справочник основных команд FreeBSD           PKG_INFO(1)

НАЗВАНИЕ
     pkg_info -- утилита, отображающая информацию о программных пакетах

СИНТАКСИС
     pkg_info [-bcdDEfgGiIjkKLmopPqQrRsvVxX] [-e пакет] [-l префикс]
              [-t шаблон] -a | имя_пакета ...
     pkg_info [-qQ] -W имя_файла
     pkg_info [-qQ] -O происхождение
     pkg_info

ОПИСАНИЕ
     Команда pkg_info используется для вывода на экран информации о пакетах,
     как упакованных в файлы при помощи команды pkg_create(1), так и уже уста-
     новленных в системе посредством команды pkg_add(1).

ОПЦИИ
     Поддерживаются следующие опции командной строки:

     имя_пакета ...
             Выводится описание указанных пакетов.  Именем пакета может быть
             имя уже установленного пакета, путь к файлу дистрибутива пакета
             или URL пакета, доступного по FTP.  Номера версий пакетов могут
             также подбираться при помощи реляционных операторов >=, <=, > и
             <.  Например,

                   pkg_info 'portupgrade>=20030723'

             выберет версии 20030723 или более поздние пакета portupgrade.

     -a      Показать все установленные на данный момент пакеты.

     -b      Использовать для вывода переменную окружения BLOCKSIZE, даже если
             указаны флаги -q или -Q.

     -v      Включить подробный вывод.

     -p      Показать установочный префикс для каждого пакета.

     -q      Вывести запрашиваемую информацию в необработанном виде, не печа-
             тать заголовков и т.п. (то есть предполагается, что информация
             будет обрабатываться программой, а не человеком).

     -Q      То же, что и -q, но предварять вывод именем пакета.

     -c      Показать (однострочное) поле комментария для каждого пакета.

     -d      Показать поле с подробным описанием пакета.

     -D      Показать для каждого пакета файл с установочными сообщениями.

     -f      Показать для каждого пакета инструкции упаковочного списка.

     -g      Показать файлы, у которых не совпадает записанная контрольная
             сумма.

     -i      Показать установочный сценарий (если он есть) для каждого пакета.

     -I      Показать строку индекса для каждого пакета.  Эта опция имеет наи-
             высший приоритет среди всех опций задания формата вывода информа-
             ции о пакете.

     -j      Показать сценарий требований (если он есть) для каждого пакета.

     -k      Показать для каждого пакета сценарий (если он есть), выполняю-
             щийся в момент удаления пакета.

     -K      Сохранять загруженные пакеты в PKGDIR, если эта переменная опре-
             делена, или (по умолчанию) в текущем каталоге.

     -r      Для каждого указанного пакета вывести список пакетов, от которых
             он зависит.

     -R      Для каждого указанного пакета вывести список установленных паке-
             тов, которым он требуется.

     -m      Показать файл mtree(8) (если он есть) для каждого пакета.

     -L      Показать файлы, входящие в состав каждого пакета.  Это отличается
             от простого просмотра упаковочного списка, поскольку генерируются
             полные пути для каждого файла.

     -s      Показать суммарный размер файлов, установленных каждым пакетом.

     -o      Показать исходный путь (``origin''), записанный при создании
             пакета.  Этот путь является именем каталога в коллекции портов
             FreeBSD, соответствующем порту, из которого был сгенерирован дан-
             ный пакет.

     -G      Не пытаться раскрывать шаблоны имён файлов командной оболочки в
             имя_пакета, когда выбираются пакеты для вывода (по умолчанию
             pkg_info автоматически раскрывает шаблоны имён файлов в
             имя_пакета).

     -W имя_файла
             Для заданного аргумента имя_файла показать, к какому пакету он
             принадлежит.  Если файл отсутствует в текущем каталоге и не ука-
             зан его абсолютный путь, тогда поиск осуществляется с использова-
             нием which(1) в каталогах, перечисленных в переменной окружения
             PATH.

     -O происхождение
             Вывести список всех пакетов, имеющих данное происхождение (ori-
             gin).

     -x      Интерпретировать имя_пакета как регулярное выражение и отображать
             информацию только для пакетов, чьи имена сопоставимы с этим регу-
             лярным выражением.  Может быть задано несколько регулярных выра-
             жений, в этом случае pkg_info отображает информацию обо всех
             пакетах, сопоставимых по крайней мере с одним регулярным выраже-
             нием из списка.

     -X      То же, что и -x, но имя_пакета интерпретируется как расширенное
             регулярное выражение.

     -e пакет
             Если пакет, идентифицируемый аргументом пакет, уже установлен,
             вернуть 0, иначе вернуть 1.  Эта опция позволяет вам легко прове-
             рять наличие другого пакета (возможно необходимого как зависи-
             мость) из сценария.

     -E      Показывать только имена подходящих пакетов.  Эта опция имеет наи-
             высший приоритет среди всех опций задания формата вывода информа-
             ции о пакете.  Если были найдены подходящие пакеты, вернуть 0,
             иначе вернуть 1.

     -l префикс
             Вывести префикс в начале каждого заголовка категории информации
             (см. -q).  Эта опция будет полезна интерфейсным программам, кото-
             рые запрашивают для пакета сразу много разных информационных
             полей, но не хотят, чтобы вывод был смешан таким образом, что они
             не смогут его упорядочить.  Эта опция позволяет вам добавить спе-
             циальный маркер в начало каждого поля.

     -t шаблон
             Использовать шаблон в качестве аргумента mktemp(3) для создания
             ``строительной площадки''.  По умолчанию это строка
             /tmp/instmp.XXXXXX, но может понадобиться подменить её в случае,
             если в вашем каталоге /tmp недостаточно свободного места.  Убеди-
             тесь, что оставляете некоторые количество символов `X', чтобы
             mktemp(3) заполнил их уникальным идентификатором.
                   Примечание: Как правило это не требуется при использовании
                   pkg_info, поскольку из каждого пакета извлекается очень
                   мало информации, и /tmp должен быть совсем маленьким, чтобы
                   его переполнить.

     -V      Показать номер ревизии формата упаковочного списка.

     -P      Показать номер ревизии пакетных инструментов.

ТЕХНИЧЕСКИЕ ДЕТАЛИ
     Информация о пакете извлекается либо из пакетных файлов, заданных в
     командной строке, либо из информации об уже установленных пакетах в
     /var/db/pkg/<имя_пакета>.

ОКРУЖЕНИЕ
     BLOCKSIZE   Если установлена переменная окружения BLOCKSIZE, счётчики
                 числа блоков будут выводиться в единицах заданного ею размера
                 блока.

     PKG_TMPDIR  Указывает на каталог, где pkg_info создаёт свои временные
                 файлы.  Если эта переменная не установлена, используется
                 TMPDIR.  Если обе переменные не установлены, используется
                 встроенное значение по умолчанию.

     PKG_DBDIR   Задаёт альтернативное расположение базы данных установленных
                 пакетов.

     PKG_PATH    Задаёт альтернативное расположение пакета, если данный пакет
                 не может быть найден.

     PKGDIR      Задаёт альтернативное расположение для сохранения загруженных
                 пакетов.

ФАЙЛЫ
     /var/tmp     Используется, если переменные окружения PKG_TMPDIR и TMPDIR
                  не установлены, или если указанные каталоги имеют недоста-
                  точно свободного места.
     /tmp         Следующий вариант, если /var/tmp не существует или имеет
                  недостаточно места.
     /usr/tmp     Последний вариант, если /tmp не подходит.
     /var/db/pkg  Стандартное расположение базы данных установленных пакетов.

СМОТРИ ТАКЖЕ
     pkg_add(1), pkg_create(1), pkg_delete(1), pkg_version(1), mktemp(3),
     mtree(8)

АВТОРЫ
     Jordan Hubbard

ПОМОЩНИКИ
     John Kohl <jtk [at] rational [dot] com>, Oliver Eikemeier <eik [at] FreeBSD [dot] org>

ПРОБЛЕМЫ
     Не без них.

FreeBSD 6.2                      9 января 2006                     FreeBSD 6.2