i686-w64-mingw32-pkg-config - онлайн у хмарі

ПРОГРАМА:

ІМ'Я

pkg-config - Повернути метаінформацію про встановлені бібліотеки

СИНТАКСИС

pkg-config [--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-
змінна=ІЗВА ЗМІННА=ЗНАЧЕННЯ ЗМІННИХ] [--змінні друку] [--видалено] [--існує]
[--atleast-version=ВЕРСІЯ] [--exact-version=ВЕРСІЯ] [--max-version=ВЕРСІЯ] [--validate]
[--list-all] [--print-provides] [--print-requires] [--print-requires-private]
[БІБЛІОТЕКИ...]

ОПИС

Команда pkg-config Програма використовується для отримання інформації про встановлені бібліотеки в
системи. Зазвичай він використовується для компіляції та зв'язування з однією або кількома бібліотеками. Ось
типовий сценарій використання у Makefile:

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

pkg-config отримує інформацію про пакети зі спеціальних файлів метаданих. Ці файли
названі на честь пакета та мають a .pc розширення. На більшості систем, pkg-config виглядає
in /usr/lib/pkgconfig, /usr/share/pkgconfig, /usr/local/lib/pkgconfig та
/usr/local/share/pkgconfig для цих файлів. Це додатково буде виглядати в товстій кишці-
розділений (у Windows, розділений крапкою з комою) список каталогів, визначених
Змінна середовища PKG_CONFIG_PATH.

Назва пакета, зазначена на pkg-config командний рядок визначається як ім’я
файл метаданих, мінус .pc розширення. Якщо бібліотека може встановити кілька версій
одночасно він повинен дати кожній версії власну назву (наприклад, GTK 1.2 може мати
назва пакета "gtk+", тоді як GTK 2.0 має "gtk+-2.0").

На додаток до вказівки імені пакета в командному рядку, повний шлях до заданого .pc
Замість цього можна надати файл. Це дозволяє користувачеві безпосередньо запитувати певний .pc файлу.

ВАРІАНТИ

Підтримуються такі параметри:

--модверсія
Запитує інформацію про версії бібліотек, зазначених у команді
відображатиметься рядок. Якщо pkg-config можна знайти всі бібліотеки в командному рядку,
рядок версії кожної бібліотеки друкується на стандартний вихід, по одній версії на рядок. У цьому
випадок pkg-config успішно виходить. Якщо одна або кілька бібліотек невідомі, pkg-config
виходить з ненульовим кодом, а вміст стандартного виведення не визначено.

-- версія
Відображає версію pkg-config і припиняється.

--atleast-pkgconfig-version=ВЕРСІЯ
Потрібна принаймні дана версія pkg-config.

--допомога Відображає довідкове повідомлення та завершує роботу.

-- помилки друку
Якщо один або кілька модулів у командному рядку або їх залежності не є
знайдено, або якщо під час розбору a .pc файл, то ця опція спричинить
помилки, що пояснюють проблему, яку потрібно надрукувати. З «присудковими» варіантами, наприклад
"--існує" pkg-config за замовчуванням працює без звуку, оскільки зазвичай використовується в
скрипти, які хочуть контролювати те, що виводиться. Цей параметр можна використовувати окремо (для просто
помилки друку, які виникли під час пошуку модулів у командному рядку) або з іншими
варіанти. Змінна середовища PKG_CONFIG_DEBUG_SPEW замінює цей параметр.

--короткі помилки
Друк коротких повідомлень про помилки.

--мовчання-помилки
Якщо один або кілька модулів у командному рядку або їх залежності не є
знайдено, або якщо під час розбору aa сталася помилка .pc файл, то цей параметр буде збережено
помилки, що пояснюють проблему, від друку. З «присудковими» варіантами, наприклад
"--існує" pkg-config за замовчуванням працює без звуку, оскільки зазвичай використовується в
скрипти, які хочуть контролювати те, що виводиться. Тому ця опція корисна лише з
такі параметри, як "--cflags" або "--modversion", які друкують помилки за замовчуванням. The
Змінна середовища PKG_CONFIG_DEBUG_SPEW замінює цей параметр.

--errors-to-stdout
Якщо друкуються помилки, друкуйте їх у стандартному виводі, а не стандартному stderr

--відлагоджувати
Роздрукувати інформацію про налагодження. Це трохи відрізняється від
Змінна середовища PKG_CONFIG_DEBUG_SPEW, яка також вмикає "--print-errors".

Для компіляції та зв’язування програм використовуються наступні параметри:

--cflags
Це друкує прапори попереднього процесора та компіляції, необхідні для компіляції пакетів на
командний рядок, включаючи прапори для всіх їх залежностей. Прапори «стислюються» так
що кожен ідентичний прапор з’являється лише один раз. pkg-config виходить з ненульовим кодом if
він не може знайти метадані для одного або кількох пакетів у командному рядку.

--cflags-only-I
Це друкує частину -I "--cflags". Тобто він визначає шлях пошуку заголовка
але нічого іншого не вказує.

--cflags-only-інше
Це друкує частини "--cflags", не охоплені "--cflags-only-I".

--libs Цей параметр ідентичний "--cflags", тільки він друкує прапорці посилання. Як і в разі
"--cflags", повторювані прапорці об'єднуються (з підтримкою належного порядку), а прапори для
залежності включені у вихідні дані.

--libs-only-L
Це друкує частину -L/-R "--libs". Тобто він визначає шлях пошуку бібліотеки
але не вказує, з якими бібліотеками зв’язуватися.

--libs-only-l
Це друкує частину -l "--libs" для бібліотек, зазначених у команді
лінія. Зауважте, що об’єднання «--libs-only-l» і «--libs-only-L» може бути меншим
ніж "--libs", завдяки таким прапорам, як -rdynamic.

--libs-libs-інше
Це друкує частини "--libs", не охоплені "--libs-only-L" і "--libs-only-
l", наприклад "--pthread".

--variable=ІМЯ ЗМІННОЇ
Це повертає значення змінної, визначеної в пакеті .pc файл. Більшість пакетів
визначте змінну "prefix", наприклад, щоб ви могли сказати:
$ pkg-config --variable=префікс glib-2.0
/usr/

--define-variable=VARIABLENAME=VARIABLEVALUE
Це встановлює глобальне значення для змінної, перевизначаючи значення в будь-якому .pc файли.
Більшість пакетів визначають змінну "prefix", наприклад, тому ви можете сказати:
$ pkg-config --print-errors --define-variable=prefix=/foo \
--змінна=префікс glib-2.0
/foo

--змінні друку
Повертає список усіх змінних, визначених у пакеті.

--видалено
Зазвичай, якщо ви запитуєте пакет "foo" і пакет "foo-uninstalled" існує,
pkg-config віддасть перевагу варіанту "-uninstalled". Це дозволяє компіляцію/посилання
проти видалених пакетів. Якщо ви вкажете параметр "--uninstalled", pkg-config
повернеться успішно, якщо використовуються якісь "-uninstalled" пакети, і повернеться
помилка (помилка) інакше. (Середовище PKG_CONFIG_DISABLE_UNINSTALLED
змінна зберігає pkg-config від неявного вибору "-uninstalled" пакетів, тому якщо
ця змінна встановлена, вони будуть використані лише в тому випадку, якщо ви передасте ім’я на кшталт "foo-
видалено" в командному рядку явно.)

--існує

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

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

--max-version=ВЕРСІЯ
Ці параметри перевіряють, чи є пакет або список пакетів у командному рядку
відомий pkg-config, і за бажанням, чи відповідає номер версії пакета
певні обмеження. Якщо всі пакети існують і відповідають вказаній версії
обмеження, pkg-config успішно виходить. Інакше він невдало завершується. Тільки
буде враховано перший варіант порівняння VERSION. Наступні варіанти цього типу
буде проігноровано.

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

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

--msvc-синтаксис
Ця опція доступна лише в Windows. Це викликає pkg-config вивести -l і -L
прапори у формі, розпізнаній компілятором командного рядка Microsoft Visual C++, cl.
Точніше, замість -Lx:/деякий/шлях друкується /libpath:x/some/pathі замість цього
of -лфу друкується foo.lib. Зауважте, що вихід --libs складається з прапорів для
компонувальник, і його слід розмістити в командному рядку cl після перемикача /link.

--define-префікс
--dont-define-prefix
Ці параметри визначають чи pkg-config перевизначає значення змінної префікс
у кожному файлі .pc. з --define-prefix, pkg-config використовує встановлене розташування
файл .pc, щоб визначити префікс. --dont-define-prefix запобігає такій поведінці.
За замовчуванням зазвичай є --define-prefix.

Якщо цю функцію ввімкнено, і файл .pc знайдено в каталозі з ім’ям
pkgconfig, припускається, що префікс для цього пакета є бабусю чи дідусем
каталог, де було знайдено файл, і префікс для цього змінна перевизначена
файл відповідно.

Якщо значення змінної у файлі .pc починається з оригіналу, без заміни,
значення префікс змінної, потім перевизначене значення префікс використовується замість цього.
Це дозволяє функції працювати, навіть якщо змінні були розширені в
файл .pc.

--prefix-variable=PREFIX
Встановіть назву змінної, яка pkg-config замінює замість префікс При використанні
функція --define-prefix.

--статичний
Вихідні бібліотеки, придатні для статичного зв'язування. Це означає, включаючи будь-яку приватну
бібліотеки на виході. Це залежить від правильного позначення тегів у файлах .pc, інакше a
зазвичай буде виведена занадто велика кількість бібліотек.

--список-всі
Перелік усіх модулів, знайдених у pkg-config шлях

--print-надає
Перерахуйте всі модулі, які надаються даними пакетами.

--print-required
Перелік усіх модулів, які потрібні даним пакетам.

--print-requires-private
Перелік усіх модулів, які потрібні для статичного зв’язування даних пакетів (див. --static).

НАВКОЛИШНЄ СЕРЕДОВИЩЕ ЗМІННІ

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

PKG_CONFIG_DEBUG_SPEW
Якщо встановлено, причини pkg-config друкувати всі види налагоджувальної інформації та звітів
всі помилки.

PKG_CONFIG_TOP_BUILD_DIR
Значення, яке потрібно встановити для магічної змінної pc_top_builddir які можуть з'явитися в .pc
файлів. Якщо змінна середовища не встановлена, значення за замовчуванням '$(top_builddir)'
буде використано. Ця змінна має посилатися на верхній каталог збірки Makefile де
прапорці компіляції/посилання, про які повідомляється pkg-config буде використано. Це має значення лише коли
компіляція/зв'язування з пакетом, який ще не встановлено.

PKG_CONFIG_DISABLE_UNINSTALLED
Зазвичай, якщо ви запитуєте пакет "foo" і пакет "foo-uninstalled" існує,
pkg-config віддасть перевагу варіанту "-uninstalled". Це дозволяє компіляцію/посилання
проти видалених пакетів. Якщо ця змінна середовища встановлена, вона вимикається
зазначена поведінка.

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

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

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-config пошуковий каталог, як правило
/usr/lib/pkgconfig:/usr/share/pkgconfig.

PKG_CONFIG_$PACKAGE_$VARIABLE
Замінює змінну VARIABLE в пакеті PACKAGE. Змінна середовища
має містити назву пакета та змінну пакета у верхньому регістрі не буквено-цифровим
символи, перетворені на підкреслення. Наприклад, налаштування
PKG_CONFIG_GLADEUI_2_0_CATALOGDIR замінить змінну "catalogdir" у
пакет «гладеуи-2.0».

PKG-CONFIG ПОХІДНІ ЗМІННІ

pkg-config встановлює кілька змінних метаданих, які можна використовувати у файлах .pc або запитувати на
час виконання.

pc_path
Шлях пошуку за замовчуванням, який використовує pkg-config під час пошуку файлів .pc. Це може
використовуватися в запиті для pkg-config сам модуль:
$ 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-config Шлях пошуку за замовчуванням ігнорується в Windows. Натомість шлях пошуку є
створений за допомогою встановленого каталогу pkg-config а потім додавання
lib\pkgconfig та share\pkgconfig. Це можна доповнити або замінити за допомогою стандарту
змінні середовища, описані вище.

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

PKG_CHECK_MODULES(ЗМІННА-ПРЕФІКС, МОДУЛІ [,ДІЯ-ЯКЩО-ЗНАЙДЕНО [,ДІЯ-ЯКЩО-НЕ-ЗНАЙДЕНО]])

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

Це призведе до змінних заміни MYSTUFF_LIBS і MYSTUFF_CFLAGS, встановлених на
libs і cflags для даного списку модулів. Якщо модуль відсутній або є
неправильна версія, за замовчуванням configure перерве з повідомленням. Щоб замінити
дію за замовчуванням, вкажіть ACTION-IF-NOT-FOUND. PKG_CHECK_MODULES не друкуватиме
будь-які повідомлення про помилки, якщо ви вкажете власну ACTION-IF-NOT-FOUND. Однак це буде
встановіть змінну MYSTUFF_PKG_ERRORS, яку можна використовувати для відображення того, що пішло не так.

Зауважте, що якщо є можливість, перший виклик PKG_CHECK_MODULES може і не бути
Ви повинні обов’язково включити явний виклик PKG_PROG_PKG_CONFIG у
ваш configure.ac.

Також зауважте, що повторне використання VARIABLE-PREFIX не рекомендується. Після
Перше успішне використання, наступні виклики з тим же VARIABLE-PREFIX будуть просто
використовувати змінні _LIBS і _CFLAGS, встановлені з попереднього використання, без виклику
pkg-config знову.

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 як місце розташування модуля
інсталювати незалежні від arch файли pkg-config .pc. За замовчуванням каталог є
$datadir/pkgconfig, але значення за замовчуванням можна змінити, передав DIRECTORY. Користувач
можна замінити за допомогою параметра --with-noarch-pkgconfigdir.

PKG_CHECK_VAR(ЗМІННА, МОДУЛЬ, CONFIG-VARIABLE, [ДІЯ-ЯКЩО-ЗНАЙДЕНО], [ДІЯ-ЯКЩО-НЕ-ЗНАЙДЕНО])

Отримує значення змінної pkg-config CONFIG-VARIABLE з MODULE та
зберігає його в VARIABLE. Зауважте, що повторне використання VARIABLE не рекомендується, оскільки
перевірка буде пропущена, якщо змінна вже встановлена.

METADATA Фото СИНТАКС

Щоб додати бібліотеку до набору пакетів pkg-config знає про, просто встановіть a .pc файлу.
Ви повинні встановити цей файл до libdir/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-config; змінних немає, ви можете мати
будь-які змінні, які ви бажаєте (однак користувачі можуть очікувати отримати звичайний каталог
ім’я змінних).

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

ім'я: Це поле має бути зрозумілою людиною назвою пакета. Зауважте, що це не те
ім'я, передане як аргумент pkg-config.

Опис:
Це має бути короткий опис упаковки

URL: URL-адреса, за якою люди можуть отримати додаткову інформацію про пакет і завантажити його

Версія:
Це має бути найбільш специфічний рядок версії пакета.

потрібно:
Це розділений комами список пакетів, які потрібні вашому пакету. Прапори
із залежних пакетів буде об'єднано з прапорами, про які повідомляється для вашого пакета.
За бажанням можна вказати версію необхідного пакета (за допомогою
оператори =, <, >, >=, <=); вказівка ​​версії дозволяє pkg-config виконувати доп
перевірки осудності. Ви можете згадати той самий пакет лише один раз потрібно:
лінія. Якщо версія пакета не вказана, буде використовуватися будь-яка версія з номером
перевірка.

Requires.private:
Список пакетів, необхідних для цього пакета. Різниця від Вимагає в тому, що
пакети, перелічені нижче Вимагає.приватний не враховуються при прапорі
список обчислюється для динамічно зв'язаного виконуваного файлу (тобто, коли --static не було
вказано). У ситуації, коли кожен файл .pc відповідає бібліотеці,
Вимагає.приватний має використовуватися виключно для визначення залежностей між
бібліотеки.

Конфлікти:
Ця додаткова лінія дозволяє pkg-config в першу чергу провести додаткову перевірку осудності
для виявлення зламаних установок користувачів. Синтаксис такий самий, як потрібно: крім
що ви можете перерахувати один і той самий пакет більше одного разу тут, наприклад "foobar =
1.2.3, foobar = 1.2.5, foobar >= 1.3", якщо у вас є підстави для цього. Якщо версія
не вказано, то ваш пакунок конфліктує з усіма версіями згаданого
пакет. Якщо користувач намагається одночасно використовувати ваш пакет і конфліктуючий пакет
час, тоді pkg-config буде скаржитися.

Очі: Цей рядок повинен містити позначки посилань, специфічні для вашого пакета. Не додавайте жодних прапорів
для необхідних пакетів; pkg-config додасть їх автоматично.

Libs.private:
У цьому рядку має бути перераховано всі приватні бібліотеки, які використовуються. Приватні бібліотеки є
бібліотеки, які не доступні через вашу бібліотеку, але необхідні у разі
статичне зв'язування. Це відрізняється від Вимагає.приватний оскільки він посилається на бібліотеки
які не мають встановлених файлів пакетів.

Cflags:
У цьому рядку має бути перераховано прапори компіляції, характерні для вашого пакета. Не додавайте жодного
прапорці для необхідних пакетів; pkg-config додасть їх автоматично.

Використовуйте i686-w64-mingw32-pkg-config онлайн за допомогою служб onworks.net