i686-w64-mingw32-pkg-config - Интернет в облаке

ПРОГРАММА:

ИМЯ

pkg-config - возвращает метаинформацию об установленных библиотеках

СИНТАКСИС

pkg-конфигурация [--modversion] [--version] [--help] [--atleast-pkgconfig-version = ВЕРСИЯ]
[--print-errors] [--short-errors] [--silence-errors] [--errors-to-stdout] [--debug]
[--cflags] [--libs] [--libs-only-L] [--libs-only-l] [--cflags-only-I] [--libs-only-other]
[--cflags-only-other] [--variable = VARIABLENAME] [--define-
переменная = VARIABLENAME = VARIABLEVALUE] [--print-variables] [--uninstalled] [--exists]
[--atleast-version = ВЕРСИЯ] [--exact-version = ВЕРСИЯ] [--max-version = ВЕРСИЯ] [--validate]
[--list-all] [--print-provides] [--print-requires] [--print-requires-private]
[БИБЛИОТЕКИ ...]

ОПИСАНИЕ

Ассоциация pkg-конфигурация программа используется для получения информации об установленных библиотеках в
система. Обычно он используется для компиляции и компоновки с одной или несколькими библиотеками. Вот это
типичный сценарий использования в Makefile:

программа: program.c
cc program.c $ (pkg-config --cflags --libs gnomeui)

pkg-конфигурация извлекает информацию о пакетах из специальных файлов метаданных. Эти файлы
названы в честь пакета и имеют .ПК расширение. В большинстве систем pkg-конфигурация внешность
in / usr / lib / pkgconfig, / USR / доля / pkgconfig, / usr / местные / библиотека / pkgconfig и
/ USR / местные / доля / pkgconfig для этих файлов. Это дополнительно будет смотреться в двоеточии-
разделенный (в Windows, через точку с запятой) список каталогов, указанных
Переменная окружения PKG_CONFIG_PATH.

Имя пакета, указанное в pkg-конфигурация командная строка определяется как имя
файл метаданных, за вычетом .ПК расширение. Если в библиотеке можно установить несколько версий
одновременно он должен дать каждой версии собственное имя (например, GTK 1.2 может иметь
имя пакета «gtk +», а в GTK 2.0 - «gtk + -2.0»).

Помимо указания имени пакета в командной строке, полный путь к заданному .ПК
файл может быть предоставлен вместо него. Это позволяет пользователю напрямую запрашивать конкретный .ПК .

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

Поддерживаются следующие варианты:

--modversion
Запрашивает, чтобы информация о версиях библиотек, указанных в команде
строка будет отображаться. Если pkg-конфигурация можно найти все библиотеки в командной строке,
строка версии каждой библиотеки выводится на стандартный вывод, по одной версии в строке. В этом
случаев pkg-конфигурация успешно выходит. Если одна или несколько библиотек неизвестны, pkg-конфигурация
завершается с ненулевым кодом, а содержимое stdout не определено.

--версия
Отображает версию pkg-конфигурация и заканчивается.

--atleast-pkgconfig-version = ВЕРСИЯ
Требуется как минимум указанная версия pkg-config.

--Помогите Отображает справочное сообщение и завершается.

--print-ошибки
Если один или несколько модулей в командной строке или их зависимости не
найден, или если при разборе .ПК файл, то эта опция вызовет
ошибки, объясняющие проблему, которую нужно распечатать. С опциями «предиката», такими как
"--существуют" pkg-конфигурация по умолчанию работает тихо, потому что обычно используется в
скрипты, которые хотят контролировать то, что выводится. Эту опцию можно использовать отдельно (чтобы просто
ошибки печати, обнаруженные при размещении модулей в командной строке) или с другими
параметры. Переменная среды PKG_CONFIG_DEBUG_SPEW переопределяет этот параметр.

--short-ошибки
Распечатайте короткие сообщения об ошибках.

--тишина-ошибки
Если один или несколько модулей в командной строке или их зависимости не
найдено, или если при разборе aa произошла ошибка .ПК файл, то эта опция сохранит
ошибки, объясняющие проблему при печати. С опциями «предиката», такими как
"--существуют" pkg-конфигурация по умолчанию работает тихо, потому что обычно используется в
скрипты, которые хотят контролировать то, что выводится. Так что эта опция полезна только с
такие параметры, как --cflags или --modversion, по умолчанию выводят ошибки. В
Переменная среды PKG_CONFIG_DEBUG_SPEW переопределяет этот параметр.

--errors-to-stdout
В случае ошибок печати выводите их на стандартный вывод, а не на стандартный стандартный поток вывода.

--отлаживать
Распечатать отладочную информацию. Это немного отличается от
Переменная среды PKG_CONFIG_DEBUG_SPEW, которая также включает "--print-errors".

Следующие параметры используются для компиляции и компоновки программ:

--cflags
Это печатает препроцессор и флаги компиляции, необходимые для компиляции пакетов на
командная строка, включая флаги для всех их зависимостей. Флаги "сжаты", поэтому
что каждый идентичный флаг появляется только один раз. pkg-конфигурация выходит с ненулевым кодом, если
он не может найти метаданные для одного или нескольких пакетов в командной строке.

--cflags-only-I
Это напечатает часть -I "--cflags". То есть он определяет путь поиска заголовка
но ничего другого не указывает.

--cflags-только-другое
Это печатает части «--cflags», не охваченные «--cflags-only-I».

--libs Эта опция идентична "--cflags", только выводит флаги ссылок. Как и в случае с
"--cflags", дублирующиеся флаги объединяются (с соблюдением правильного порядка), а флаги для
зависимости включены в вывод.

--libs-только-L
Это напечатает часть -L / -R "--libs". То есть он определяет путь поиска библиотеки
но не указывает, с какими библиотеками связываться.

--libs-только-l
Это напечатает -l часть "--libs" для библиотек, указанных в команде.
линия. Обратите внимание, что объединение «--libs-only-l» и «--libs-only-L» может быть меньше
чем "--libs" из-за таких флагов, как -rdynamic.

--libs-только-другое
Это печатает части «--libs», не охваченные «--libs-only-L» и «--libs-only-»
l ", например" --pthread ".

--variable = ИМЯ ПЕРЕМЕННОЙ
Это возвращает значение переменной, определенной в пакете .ПК файл. Большинство пакетов
определите переменную prefix, например, чтобы вы могли сказать:
$ pkg-config --variable = префикс glib-2.0
/ usr /

--define-variable = ИМЯ ПЕРЕМЕННОЙ = ЗНАЧЕНИЕ ПЕРЕМЕННОЙ
Это устанавливает глобальное значение для переменной, переопределяя значение в любом .ПК файлы.
Большинство пакетов определяют переменную «префикс», например, поэтому вы можете сказать:
$ pkg-config --print-errors --define-variable = prefix = / foo \
--variable = префикс glib-2.0
/ foo

--print-переменные
Возвращает список всех переменных, определенных в пакете.

- не установлен
Обычно, если вы запрашиваете пакет «foo», а пакет «foo-uninstalled» существует,
pkg-конфигурация предпочтет вариант "-неустановлен". Это позволяет компилировать / связывать
против неустановленных пакетов. Если вы укажете опцию "--uninstalled", pkg-конфигурация
успешно вернется, если используются какие-либо "-неустановленные" пакеты, и вернет
сбой (ложь) в противном случае. (Среда PKG_CONFIG_DISABLE_UNINSTALLED
переменная сохраняет pkg-конфигурация от неявного выбора пакетов "-uninstalled", поэтому, если
эта переменная установлена, они будут использоваться только в том случае, если вы передадите имя типа "foo-
удален "в командной строке явно.)

--существуют

--atleast-version = ВЕРСИЯ

--exact-version = ВЕРСИЯ

--max-version = ВЕРСИЯ
Эти параметры проверяют, является ли пакет или список пакетов в командной строке
Известно, что pkg-конфигурация, и, возможно, соответствует ли номер версии пакета
определенные ограничения. Если все пакеты существуют и соответствуют указанной версии
ограничения, pkg-конфигурация успешно выходит. Иначе выходит безуспешно. Только
будет учтена первая опция сравнения ВЕРСИИ. Последующие варианты этого типа
будут проигнорированы.

Вместо использования параметров проверки версии вы можете просто указать версию
ограничение после каждого имени пакета, например:
$ pkg-config --exists 'glib-2.0> = 1.3.4 libxml = 1.8.3'
Не забудьте использовать --print-errors, если вам нужны сообщения об ошибках. Когда нет параметров вывода
поставляются pkg-конфигурация, --существует.

--подтвердить
Проверяет синтаксис пакета .ПК файл для действительности. Это то же самое, что и
- существует, за исключением того, что зависимости не проверяются. Это может быть полезно для пакета
разработчиков, чтобы проверить свои .ПК файл до выпуска:
$ pkg-config --validate ./my-package.pc

--msvc-синтаксис
Эта опция доступна только в Windows. Это вызывает pkg-конфигурация для вывода -l и -L
флаги в форме, распознаваемой компилятором командной строки Microsoft Visual C ++, cl.
В частности, вместо -Lx: / некоторые / путь это печатает / libpath: x / некоторые / путь, и вместо того, чтобы
of -lfoo это печатает foo.lib. Обратите внимание, что вывод --libs состоит из флагов для
компоновщик и должен быть помещен в командную строку cl после переключателя / link.

--define-префикс
--dont-определить-префикс
Эти параметры определяют, будет ли pkg-конфигурация отменяет значение переменной префикс
в каждом файле .pc. С префиксом --define- pkg-конфигурация использует установленное местоположение
файл .pc для определения префикса. --dont-define-prefix предотвращает такое поведение.
По умолчанию обычно используется --define-prefix.

Если эта функция включена и файл .pc находится в каталоге с именем
pkgconfig, предполагается, что префикс этого пакета является прародителем пакета
каталог, в котором был найден файл, и префикс переменная переопределяется для этого
файл соответственно.

Если значение переменной в файле .pc начинается с оригинального, непереопределенного,
значение префикс переменная, затем переопределенное значение префикс используется вместо
Это позволяет функции работать, даже если переменные были развернуты в
.pc файл.

--prefix-variable = ПРЕФИКС
Задайте имя переменной, которая pkg-конфигурация отменяет вместо префикс При использовании
функция --define-prefix.

--статический
Библиотеки вывода, подходящие для статической компоновки. Это означает включение любых частных
библиотеки на выходе. Это зависит от правильной маркировки в файлах .pc, иначе
обычно выводится слишком большое количество библиотек.

--список-все
Перечислите все модули, найденные в pkg-конфигурация дорожка.

--print-предоставляет
Перечислите все модули, которые предоставляет данный пакет.

--print-требует
Перечислите все модули, которые требуются данным пакетам.

--print-требует-частный
Список всех модулей, которые требуются данным пакетам для статической компоновки (см. --Static).

ОКРУЖАЮЩАЯ СРЕДА ПЕРЕМЕННЫЕ

PKG_CONFIG_PATH
Список каталогов для поиска, разделенных двоеточиями (в Windows через точку с запятой).
для файлов .pc. Каталог по умолчанию всегда будет искать после поиска в
дорожка; по умолчанию libdir /пакет конфигурации:каталогу_данных/ pkgconfig где каталог библиотеки это libdir
для pkg-конфигурация и каталогу_данных это datadir для pkg-конфигурация когда он был установлен.

PKG_CONFIG_DEBUG_SPEW
Если установлено, причины pkg-конфигурация для печати всех видов отладочной информации и отчетов
все ошибки.

PKG_CONFIG_TOP_BUILD_DIR
Значение, устанавливаемое для магической переменной pc_top_builddir который может появиться в .ПК
файлы. Если переменная среды не установлена, значение по умолчанию '$ (top_builddir)'
будет использоваться. Эта переменная должна ссылаться на верхний каталог сборки Makefile, где
флаги компиляции / компоновки, сообщаемые pkg-конфигурация будет использоваться. Это имеет значение только тогда, когда
компиляция / связывание с пакетом, который еще не был установлен.

PKG_CONFIG_DISABLE_UNINSTALLED
Обычно, если вы запрашиваете пакет «foo», а пакет «foo-uninstalled» существует,
pkg-конфигурация предпочтет вариант "-неустановлен". Это позволяет компилировать / связывать
против неустановленных пакетов. Если эта переменная среды установлена, она отключает
указанное поведение.

PKG_CONFIG_ALLOW_SYSTEM_CFLAGS
Не удаляйте -I / usr / include из cflags.

PKG_CONFIG_ALLOW_SYSTEM_LIBS
Не удаляйте -L / usr / lib или -L / lib из библиотек.

PKG_CONFIG_SYSROOT_DIR
Измените -I и -L, чтобы использовать каталоги, расположенные в целевом системном корне. этот вариант
полезно при кросс-компиляции пакетов, которые используют pkg-config для определения CFLAGS и
LDFLAGS. -I и -L изменяются, чтобы указывать на новый системный корень. это означает, что
-I / usr / include / libfoo станет -I / var / target / usr / include / libfoo с
PKG_CONFIG_SYSROOT_DIR равно / var / target (то же правило применяется к -L)

PKG_CONFIG_LIBDIR
Заменяет значение по умолчанию pkg-конфигурация каталог поиска, обычно
/ usr / lib / pkgconfig:/ USR / доля / pkgconfig.

PKG_CONFIG_ $ PACKAGE_ $ VARIABLE
Заменяет переменную VARIABLE в пакете PACKAGE. Переменная окружения
должно иметь имя пакета и переменную пакета в верхнем регистре с не буквенно-цифровыми
символы преобразованы в подчеркивания. Например, установка
PKG_CONFIG_GLADEUI_2_0_CATALOGDIR переопределит переменную "catalogdir" в
Пакет "Гладей-2.0".

PKG-КОНФИГ ПОЛУЧЕННЫЙ ПЕРЕМЕННЫЕ

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

путь_ПК
Путь поиска по умолчанию, используемый pkg-конфигурация при поиске файлов .pc. Это может
использоваться в запросе для pkg-конфигурация сам модуль:
$ pkg-config --переменная pc_path pkg-config

pcfiledir
Установленное расположение файла .pc. Это можно использовать для запроса местоположения
файл .pc для определенного модуля, но его также можно использовать для создания файлов .pc
перемещаемый. Например:
префикс = $ {pcfiledir}/../ ..
exec_prefix = $ {префикс}
libdir = $ {exec_prefix}/ Lib
includeir = $ {prefix} / include

pc_sysrootdir
Каталог sysroot, установленный пользователем. Если каталог sysroot не установлен,
это значение /. Смотреть PKG_CONFIG_SYSROOT_DIR переменная среды для получения дополнительной информации
Детали.

pc_top_builddir
Расположение верхнего каталога сборки пользователя при вызове pkg-config. Это полезно
для динамической установки путей в неустановленных файлах .pc. Увидеть PKG_CONFIG_TOP_BUILD_DIR
переменная окружения для более подробной информации.

WINDOWS СПЕЦИАЛЬНОСТИ

Ассоциация pkg-конфигурация путь поиска по умолчанию в Windows игнорируется. Вместо этого путь поиска
построенный с использованием установленного каталога pkg-конфигурация а затем добавление
библиотека \ pkgconfig и поделиться \ pkgconfig. Его можно дополнить или заменить с помощью стандартного
переменные среды, описанные выше.

АВТОКОНФ МАКРОСЫ

PKG_CHECK_MODULES (ПЕРЕМЕННАЯ-ПРЕФИКС, МОДУЛИ [, ДЕЙСТВИЕ-ЕСЛИ-НАЙДЕНО [, ДЕЙСТВИЕ-ЕСЛИ-НЕ-НАЙДЕНО]])

Макрос PKG_CHECK_MODULES можно использовать в настроить.ac чтобы проверить, есть ли модули
существовать. Типичное использование:
PKG_CHECK_MODULES ([MYSTUFF], [gtk + -2.0> = 1.3.5 libxml = 1.8.4])

Это приведет к замене переменных MYSTUFF_LIBS и MYSTUFF_CFLAGS, установленных на
библиотеки и cflags для данного списка модулей. Если модуль отсутствует или имеет
неправильная версия, по умолчанию настройка прерывается с сообщением. Чтобы заменить
действие по умолчанию, укажите ДЕЙСТВИЕ-ЕСЛИ-НЕ-НАЙДЕНО. PKG_CHECK_MODULES не печатает
любые сообщения об ошибках, если вы укажете собственное действие ACTION-IF-NOT-FOUND. Однако это будет
установите переменную MYSTUFF_PKG_ERRORS, которую вы можете использовать для отображения того, что пошло не так.

Обратите внимание, что если есть вероятность, что первый вызов PKG_CHECK_MODULES может не
не забудьте включить явный вызов PKG_PROG_PKG_CONFIG в
ваш configure.ac.

Также обратите внимание, что повторное использование VARIABLE-PREFIX не рекомендуется. После
первое успешное использование, последующие вызовы с той же ПЕРЕМЕННОЙ-ПРЕФИКС просто
используйте переменные _LIBS и _CFLAGS, установленные из предыдущего использования, без вызова
pkg-конфигурация снова.

PKG_PREREQ (МИН. ВЕРСИЯ)
Проверяет, что версия используемых макросов autoconf pkg-config не ниже MIN-
ВЕРСИЯ. Это можно использовать, чтобы гарантировать, что конкретный макрос pkg-config будет
доступен.

PKG_PROG_PKG_CONFIG ([МИН.ВЕРСИЯ])

Определяет переменную PKG_CONFIG для наилучшего доступного pkg-config, полезно, если вы
нужен pkg-config, но не хотите использовать PKG_CHECK_MODULES.

PKG_CHECK_MODULES_STATIC (ПЕРЕМЕННАЯ-ПРЕФИКС, МОДУЛИ [, ДЕЙСТВИЕ-ЕСЛИ-НАЙДЕНО [, ДЕЙСТВИЕ-ЕСЛИ-НЕ-
НАШЕЛ]])
Включает статическое связывание с помощью --static перед вызовом PKG_CHECK_MODULES.

PKG_CHECK_EXISTS (МОДУЛИ, [ДЕЙСТВИЕ-ЕСЛИ-НАЙДЕНО], [ДЕЙСТВИЕ-ЕСЛИ-НЕ-НАЙДЕНО])

Проверьте, существует ли конкретный набор модулей. Похожий на
PKG_CHECK_MODULES (), но не устанавливает переменные или ошибки печати.

Подобно PKG_CHECK_MODULES, убедитесь, что первый экземпляр этого или
Вызывается PKG_CHECK_MODULES или обязательно вызовите PKG_CHECK_EXISTS вручную.

PKG_INSTALLDIR (КАТАЛОГ)

Подставляет переменную pkgconfigdir в качестве места, где должен быть установлен модуль
pkg-config .pc файлы. По умолчанию это каталог $ libdir / pkgconfig, но
значение по умолчанию можно изменить, передав DIRECTORY. Пользователь может переопределить через
--with-pkgconfigdir параметр.

PKG_NOARCH_INSTALLDIR (КАТАЛОГ)

Подставляет переменную noarch_pkgconfigdir как место, где модуль должен
установить независимые от архитектуры файлы pkg-config .pc. По умолчанию каталог
$ datadir / pkgconfig, но значение по умолчанию можно изменить, передав DIRECTORY. Пользователь
можно переопределить с помощью параметра --with-noarch-pkgconfigdir.

PKG_CHECK_VAR (ПЕРЕМЕННАЯ; МОДУЛЬ, КОНФИГ-ПЕРЕМЕННАЯ, [ДЕЙСТВИЕ-ЕСЛИ-НАЙДЕНО], [ДЕЙСТВИЕ-ЕСЛИ-НЕ-НАЙДЕНО])

Получает значение переменной CONFIG-VARIABLE pkg-config из MODULE и
хранит его в ПЕРЕМЕННОЙ. Обратите внимание, что повторное использование ПЕРЕМЕННОЙ не рекомендуется, поскольку
проверка будет пропущена, если переменная уже установлена.

METADATA ФАЙЛОВ СИНТАКСИС

Добавить библиотеку в набор пакетов pkg-конфигурация знает, просто установите .ПК .
Вы должны установить этот файл в каталог библиотеки/ pkgconfig.

Вот пример файла:
# Это комментарий
prefix = / home / hp / unst # определяет переменную
exec_prefix = $ {prefix} # определение другой переменной в терминах первой
libdir = $ {exec_prefix}/ Lib
includeir = $ {prefix} / include

Имя: GObject # удобочитаемое имя
Описание: Система объектов / типов для GLib # удобочитаемое описание
Версия: 1.3.1
URL: http://www.gtk.org
Требует: glib-2.0 = 1.3.1
Конфликты: foobar <= 4.5
Библиотеки: -L $ {libdir} -lgobject-1.3
Libs.private: -lm
Cflags: -I $ {includedir} /glib-2.0 -I $ {libdir} / glib / include

Обычно вы генерируете файл с помощью configure, чтобы для префикса и т. Д. Были установлены значения
правильные значения. Руководство GNU Autoconf рекомендует создавать файлы, такие как файлы .pc, по адресу
время сборки, а не время настройки, поэтому, когда вы создаете файл .pc, это дело вкуса
и предпочтения.

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

Обратите внимание, что ссылки на переменные записываются как «$ {foo}»; вы можете избежать буквального "$ {" как "$$ {".

Имя: В этом поле должно быть удобочитаемое имя пакета. Обратите внимание, что это не
имя передано как аргумент в pkg-конфигурация.

Описание:
Это должно быть краткое описание пакета

URL: URL-адрес, по которому люди могут получить дополнительную информацию о пакете и скачать его.

Версия:
Это должна быть самая конкретная строка версии пакета.

Требуется:
Это список пакетов, разделенных запятыми, которые требуются вашему пакету. Флаги
из зависимых пакетов будут объединены с флагами, указанными для вашего пакета.
При желании вы можете указать версию необходимого пакета (используя
операторы =, <,>,> =, <=); указание версии позволяет pkg-конфигурация выполнять дополнительные
проверки на вменяемость. Вы можете упомянуть один и тот же пакет только один раз в Требуется:
линия. Если версия пакета не указана, будет использоваться любая версия без
проверка.

Требуется.private:
Список пакетов, необходимых для этого пакета. Отличие от Требует является то, что
пакеты, перечисленные в Требуется.private не учитываются, когда флаг
list вычисляется для динамически связанного исполняемого файла (т.е. когда --static не был
указано). В ситуации, когда каждый файл .pc соответствует библиотеке,
Требуется.private используется исключительно для указания зависимостей между
библиотеки.

конфликты:
Эта дополнительная строка позволяет pkg-конфигурация для выполнения дополнительных проверок работоспособности, в первую очередь
для обнаружения неработающих пользовательских установок. Синтаксис такой же, как у Требуется: кроме
что вы можете указать здесь один и тот же пакет более одного раза, например "foobar =
1.2.3, foobar = 1.2.5, foobar> = 1.3 ", если у вас есть причина для этого. Если версия
не указан, то ваш пакет конфликтует со всеми версиями указанного
упаковка. Если пользователь пытается использовать ваш пакет и конфликтующий пакет одновременно
время, тогда pkg-конфигурация буду жаловаться.

Библиотеки: В этой строке должны быть указаны флаги ссылок, специфичные для вашего пакета. Не добавляйте никаких флагов
для необходимых пакетов; pkg-конфигурация добавит их автоматически.

Libs.private:
В этой строке должны быть перечислены все используемые частные библиотеки. Частные библиотеки
библиотеки, которые не доступны через вашу библиотеку, но необходимы в случае
статическое связывание. Это отличается от Требуется.private в том, что он ссылается на библиотеки
для которых не установлены файлы пакетов.

Флаги:
В этой строке должны быть перечислены флаги компиляции, специфичные для вашего пакета. Не добавляйте ничего
флаги необходимых пакетов; pkg-конфигурация добавит их автоматически.

Используйте i686-w64-mingw32-pkg-config в Интернете с помощью сервисов onworks.net