i686-w64-mingw32-pkg-config - En ligne dans le cloud

PROGRAMME:

Nom

pkg-config - Renvoie des méta-informations sur les bibliothèques installées

SYNOPSIS

pkg-config [--modversion] [--version] [--help] [--atleast-pkgconfig-version=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=NOMVARIABLE] [--define-
variable=NOMVARIABLE=VALEURVARIABLE] [--print-variables] [--uninstalled] [--exists]
[--atleast-version=VERSION] [--exact-version=VERSION] [--max-version=VERSION] [--validate]
[--list-all] [--print-provides] [--print-requires] [--print-requires-private]
[BIBLIOTHÈQUES...]

DESCRIPTION

La pkg-config est utilisé pour récupérer des informations sur les bibliothèques installées dans le
système. Il est généralement utilisé pour compiler et lier une ou plusieurs bibliothèques. Voici
un scénario d'utilisation typique dans un Makefile :

programme : programme.c
programme cc.c $(pkg-config --cflags --libs gnomeui)

pkg-config récupère des informations sur les packages à partir de fichiers de métadonnées spéciaux. Ces fichiers
sont nommés d'après le paquet et ont un .pc extension. Sur la plupart des systèmes, pkg-config regards
in /usr/lib/pkgconfig, /usr/share/pkgconfig, /usr/local/lib/pkgconfig ainsi que
/usr/local/share/pkgconfig pour ces fichiers. Il regardera en outre dans le côlon-
liste de répertoires séparés (sous Windows, séparés par des points-virgules) spécifiés par le
Variable d'environnement PKG_CONFIG_PATH.

Le nom du package spécifié sur le pkg-config la ligne de commande est définie comme étant le nom du
fichier de métadonnées, moins le .pc extension. Si une bibliothèque peut installer plusieurs versions
simultanément, il doit donner à chaque version son propre nom (par exemple, GTK 1.2 peut avoir
le nom du package "gtk+" tandis que GTK 2.0 a "gtk+-2.0").

En plus de spécifier un nom de package sur la ligne de commande, le chemin complet vers un .pc
fichier peut être donné à la place. Cela permet à un utilisateur d'interroger directement un .pc fichier.

OPTIONS

Les options suivantes sont prises en charge :

--modversion
Demande que les informations de version des bibliothèques spécifiées sur la commande
ligne s'affiche. Si pkg-config peut trouver toutes les bibliothèques sur la ligne de commande,
la chaîne de version de chaque bibliothèque est imprimée sur stdout, une version par ligne. Dans ce
maisons pkg-config sort avec succès. Si une ou plusieurs bibliothèques sont inconnues, pkg-config
se termine avec un code différent de zéro et le contenu de stdout n'est pas défini.

--version
Affiche la version de pkg-config et se termine.

--atleast-pkgconfig-version=VERSION
Nécessite au moins la version donnée de pkg-config.

--Aidez-moi Affiche un message d'aide et se termine.

--erreurs-d'impression
Si un ou plusieurs modules sur la ligne de commande, ou leurs dépendances, ne sont pas
trouvé, ou si une erreur se produit lors de l'analyse d'un .pc fichier, alors cette option provoquera
erreurs expliquant le problème à imprimer. Avec des options de "prédicat" telles que
"--existe" pkg-config s'exécute silencieusement par défaut, car il est généralement utilisé dans
scripts qui veulent contrôler ce qui est sorti. Cette option peut être utilisée seule (pour
erreurs d'impression rencontrées en localisant les modules sur la ligne de commande) ou avec d'autres
option. La variable d'environnement PKG_CONFIG_DEBUG_SPEW remplace cette option.

--erreurs-courtes
Imprimez des messages d'erreur courts.

--silence-erreurs
Si un ou plusieurs modules sur la ligne de commande, ou leurs dépendances, ne sont pas
trouvé, ou si une erreur se produit dans l'analyse aa .pc fichier, alors cette option gardera
erreurs expliquant le problème d'impression. Avec des options de "prédicat" telles que
"--existe" pkg-config s'exécute silencieusement par défaut, car il est généralement utilisé dans
scripts qui veulent contrôler ce qui est sorti. Cette option n'est donc utile qu'avec
des options telles que "--cflags" ou "--modversion" qui impriment les erreurs par défaut. Les
La variable d'environnement PKG_CONFIG_DEBUG_SPEW remplace cette option.

--erreurs-vers-stdout
Si des erreurs d'impression, imprimez-les sur stdout plutôt que sur stderr par défaut

--déboguer
Imprimer les informations de débogage. Ceci est légèrement différent du
Variable d'environnement PKG_CONFIG_DEBUG_SPEW, qui active également "--print-errors".

Les options suivantes sont utilisées pour compiler et lier des programmes :

--cflags
Cela imprime les indicateurs de pré-processeur et de compilation requis pour compiler les packages sur le
ligne de commande, y compris les indicateurs pour toutes leurs dépendances. Les drapeaux sont "compressés" donc
que chaque drapeau identique n'apparaît qu'une seule fois. pkg-config sort avec un code différent de zéro si
il ne peut pas trouver de métadonnées pour un ou plusieurs packages sur la ligne de commande.

--cflags-seulement-I
Cela imprime la partie -I de "--cflags". C'est-à-dire qu'il définit le chemin de recherche de l'en-tête
mais ne précise rien d'autre.

--cflags-seulement-autre
Cela imprime des parties de "--cflags" non couvertes par "--cflags-only-I".

--libs Cette option est identique à "--cflags", sauf qu'elle imprime les drapeaux de liens. Comme avec
"--cflags", les drapeaux en double sont fusionnés (en maintenant un ordre correct) et les drapeaux pour
les dépendances sont incluses dans la sortie.

--libs-only-L
Cela imprime la partie -L/-R de "--libs". C'est-à-dire qu'il définit le chemin de recherche de la bibliothèque
mais ne spécifie pas avec quelles bibliothèques se lier.

--libs-only-l
Cela imprime la partie -l de "--libs" pour les bibliothèques spécifiées dans la commande
ligne. Notez que l'union de "--libs-only-l" et "--libs-only-L" peut être plus petite
que "--libs", en raison d'indicateurs tels que -rdynamic.

--libs-only-autre
Cela imprime les parties de "--libs" non couvertes par "--libs-only-L" et "--libs-only-
l", comme "--pthread".

--variable=NOM VARIABLE
Cela renvoie la valeur d'une variable définie dans le package .pc déposer. La plupart des forfaits
définir la variable "préfixe", par exemple, ainsi vous pourrez dire :
$ pkg-config --variable=préfixe glib-2.0
/ usr /

--define-variable=NOMVARIABLE=VALEURVARIABLE
Cela définit une valeur globale pour une variable, remplaçant la valeur dans n'importe quel .pc fichiers.
La plupart des packages définissent la variable "prefix", par exemple, vous pouvez donc dire :
$ pkg-config --print-errors --define-variable=prefix=/foo \
--variable=préfixe glib-2.0
/toto

--print-variables
Renvoie une liste de toutes les variables définies dans le package.

--désinstallé
Normalement, si vous demandez le package "foo" et que le package "foo-uninstalled" existe,
pkg-config préférera la variante "-uninstalled". Cela permet la compilation/liaison
contre les packages désinstallés. Si vous spécifiez l'option "--uninstalled", pkg-config
retournera avec succès si des packages "-uninstalled" sont utilisés, et retournera
échec (faux) sinon. (L'environnement PKG_CONFIG_DISABLE_UNINSTALLED
variable conserve pkg-config de choisir implicitement les packages "-uninstalled", donc si
cette variable est définie, elles n'auront été utilisées que si vous passez un nom comme "foo-
désinstallé" sur la ligne de commande explicitement.)

--existe

--au moins-version=VERSION

--version-exacte=VERSION

--max-version=VERSION
Ces options testent si le package ou la liste de packages sur la ligne de commande sont
connu pour pkg-config, et éventuellement si le numéro de version d'un package correspond
certaines contraintes. Si tous les packages existent et correspondent à la version spécifiée
contraintes, pkg-config sort avec succès. Sinon, il sort sans succès. Seul
la première option de comparaison de VERSION sera honorée. Options suivantes de ce type
Sera ignoré.

Plutôt que d'utiliser les options de test de version, vous pouvez simplement donner une version
contrainte après chaque nom de package, par exemple :
$ pkg-config --exists 'glib-2.0 >= 1.3.4 libxml = 1.8.3'
N'oubliez pas d'utiliser --print-errors si vous voulez des messages d'erreur. Lorsqu'aucune option de sortie
sont fournis à pkg-config, --exists est implicite.

--valider
Vérifie la syntaxe d'un package .pc dossier de validité. C'est la même chose que
--existe sauf que les dépendances ne sont pas vérifiées. Cela peut être utile pour le paquet
développeurs de tester leurs .pc fichier avant la publication :
$ pkg-config --validate ./mon-paquet.pc

--msvc-syntaxe
Cette option est disponible uniquement sous Windows. Cela implique pkg-config pour afficher -l et -L
des indicateurs sous la forme reconnue par le compilateur en ligne de commande Microsoft Visual C++, cl.
Plus précisément, au lieu de -Lx:/quelque/chemin il imprime /libpath:x/some/chemin, et plutôt
of -lfo il imprime foo.lib. Notez que la sortie --libs se compose d'indicateurs pour le
éditeur de liens et doit être placé sur la ligne de commande cl après un commutateur /link.

--define-préfixe
--ne pas définir le préfixe
Ces options contrôlent si pkg-config remplace la valeur de la variable préfixe
dans chaque fichier .pc. Avec --define-prefix, pkg-config utilise l'emplacement d'installation de
le fichier .pc pour déterminer le préfixe. --dont-define-prefix empêche ce comportement.
La valeur par défaut est généralement --define-prefix.

Lorsque cette fonctionnalité est activée et qu'un fichier .pc est trouvé dans un répertoire nommé
pkgconfig, le préfixe de ce package est supposé être le grand-parent du
répertoire où le fichier a été trouvé, et le préfixe la variable est remplacée pour cela
déposer en conséquence.

Si la valeur d'une variable dans un fichier .pc commence par l'original, non remplacé,
valeur de la préfixe variable, puis la valeur remplacée de préfixe est utilisé à la place.
Cela permet à la fonctionnalité de fonctionner même lorsque les variables ont été développées dans le
fichier .pc.

--prefix-variable=PRÉFIXE
Définissez le nom de la variable qui pkg-config remplace au lieu de préfixe lors de l'utilisation
la fonctionnalité --define-prefix.

--statique
Bibliothèques de sortie adaptées à la liaison statique. Cela signifie inclure tout privé
bibliothèques dans la sortie. Cela repose sur un balisage approprié dans les fichiers .pc, sinon un
un trop grand nombre de bibliothèques sera normalement généré.

--tout lister
Répertoriez tous les modules trouvés dans le pkg-config chemin.

--print-fournit
Répertoriez tous les modules fournis par les packages donnés.

--print-requiert
Répertoriez tous les modules requis par les packages donnés.

--print-requiert-privé
Répertoriez tous les modules dont les packages donnés ont besoin pour la liaison statique (voir --static).

ENVIRONNEMENT VARIABLES

PKG_CONFIG_PATH
Une liste de répertoires séparés par deux points (sous Windows, séparés par des points-virgules) dans lesquels rechercher
pour les fichiers .pc. Le répertoire par défaut sera toujours recherché après avoir recherché le
chemin; la valeur par défaut est libdir/pkgconfig :répertoire de données/pkgconfig où libdir est la libdir
en pkg-config ainsi que répertoire de données est le datadir pour pkg-config quand il a été installé.

PKG_CONFIG_DEBUG_SPEW
Si défini, provoque pkg-config pour imprimer toutes sortes d'informations et de rapports de débogage
toutes les erreurs.

PKG_CONFIG_TOP_BUILD_DIR
Une valeur à définir pour la variable magique pc_top_builddir qui peut apparaître dans .pc
des dossiers. Si la variable d'environnement n'est pas définie, la valeur par défaut '$(top_builddir)'
sera utilisé. Cette variable doit faire référence au top builddir du Makefile où
les indicateurs de compilation/lien signalés par pkg-config sera utilisé. Cela n'a d'importance que lorsque
compiler/lier avec un paquet qui n'a pas encore été installé.

PKG_CONFIG_DISABLE_UNINSTALLED
Normalement, si vous demandez le package "foo" et que le package "foo-uninstalled" existe,
pkg-config préférera la variante "-uninstalled". Cela permet la compilation/liaison
contre les packages désinstallés. Si cette variable d'environnement est définie, elle désactive
ledit comportement.

PKG_CONFIG_ALLOW_SYSTEM_CFLAGS
Ne supprimez pas -I/usr/include de cflags.

PKG_CONFIG_ALLOW_SYSTEM_LIBS
Ne supprimez pas -L/usr/lib ou -L/lib des bibliothèques.

PKG_CONFIG_SYSROOT_DIR
Modifiez -I et -L pour utiliser les répertoires situés dans la racine système cible. cette option est
utile lors de la compilation croisée de packages qui utilisent pkg-config pour déterminer CFLAGS et
LDFLAG. -I et -L sont modifiés pour pointer vers la nouvelle racine du système. cela signifie qu'un
-I/usr/include/libfoo deviendra -I/var/target/usr/include/libfoo avec un
PKG_CONFIG_SYSROOT_DIR égal à /var/target (la même règle s'applique à -L)

PKG_CONFIG_LIBDIR
Remplace la valeur par défaut pkg-config répertoire de recherche, généralement
/usr/lib/pkgconfig:/usr/share/pkgconfig.

PKG_CONFIG_$PACKAGE_$VARIABLE
Remplace la variable VARIABLE dans le package PACKAGE. La variable d'environnement
devrait avoir le nom du package et la variable du package en majuscules avec des caractères non alphanumériques
caractères convertis en traits de soulignement. Par exemple, le réglage
PKG_CONFIG_GLADEUI_2_0_CATALOGDIR remplacera la variable "catalogdir" dans le
paquet "gladeui-2.0".

PKG-CONFIG DÉRIVÉ VARIABLES

pkg-config définit quelques variables de métadonnées qui peuvent être utilisées dans les fichiers .pc ou interrogées à
Durée.

chemin_pc
Le chemin de recherche par défaut utilisé par pkg-config lors de la recherche de fichiers .pc. Ceci peut
être utilisé dans une requête pour le pkg-config module lui-même :
$ pkg-config --variable chemin_pc pkg-config

répertoire_pc
L'emplacement d'installation du fichier .pc. Cela peut être utilisé pour interroger l'emplacement de
le fichier .pc pour un module particulier, mais il peut également être utilisé pour créer des fichiers .pc
déplaçable. Par exemple:
préfixe=${pcfiledir}/../..
exec_prefix=${préfixe}
libdir=${exec_prefix}/ lib
inclusir=${préfixe}/include

rép_racine_sys pc
Le répertoire sysroot défini par l'utilisateur. Lorsque le répertoire sysroot n'a pas été défini,
cette valeur est /. Voir l' PKG_CONFIG_SYSROOT_DIR variable d'environnement pour plus
détails.

pc_top_builddir
Emplacement du répertoire de construction supérieur de l'utilisateur lors de l'appel pkg-config. C'est utile
pour définir dynamiquement les chemins dans les fichiers .pc désinstallés. Voir le PKG_CONFIG_TOP_BUILD_DIR
variable d'environnement pour plus de détails.

FENÊTRES SPÉCIALITÉS

La pkg-config le chemin de recherche par défaut est ignoré sous Windows. Au lieu de cela, le chemin de recherche est
construit en utilisant le répertoire installé de pkg-config puis en ajoutant
lib\pkgconfig ainsi que partager\pkgconfig. Cela peut être augmenté ou remplacé en utilisant la norme
variables d'environnement décrites ci-dessus.

CONF AUTO MACRO

PKG_CHECK_MODULES(VARIABLE-PREFIX, MODULES [,ACTION-SI-TROUVE [,ACTION-SI-NON-TROUVÉ]])

La macro PKG_CHECK_MODULES peut être utilisée dans configurer.ac pour vérifier si les modules
exister. Une utilisation typique serait :
PKG_CHECK_MODULES([MYSTUFF], [gtk+-2.0 >= 1.3.5 libxml = 1.8.4])

Cela entraînerait des variables de substitution MYSTUFF_LIBS et MYSTUFF_CFLAGS, définies sur
les libs et cflags pour la liste de modules donnée. Si un module est manquant ou a le
mauvaise version, par défaut, configure abandonnera avec un message. Pour remplacer le
action par défaut, spécifiez une ACTION-IF-NOT-FOUND. PKG_CHECK_MODULES ne s'imprimera pas
tous les messages d'erreur si vous spécifiez votre propre ACTION-IF-NOT-FOUND. Cependant, il sera
définissez la variable MYSTUFF_PKG_ERRORS, que vous pouvez utiliser pour afficher ce qui s'est mal passé.

Notez que s'il existe une possibilité, le premier appel à PKG_CHECK_MODULES pourrait ne pas
arriver, vous devez être sûr d'inclure un appel explicite à PKG_PROG_PKG_CONFIG dans
votre fichier configure.ac.

Notez également que l'utilisation répétée de VARIABLE-PREFIX n'est pas recommandée. Après le
première utilisation réussie, les appels suivants avec le même VARIABLE-PREFIX seront simplement
utiliser les variables _LIBS et _CFLAGS définies à partir de l'utilisation précédente sans appeler
pkg-config nouveau.

PKG_PREEQ(MIN-VERSION)
Vérifie que la version des macros pkg-config autoconf en cours d'utilisation est au moins MIN-
VERSION. Cela peut être utilisé pour s'assurer qu'une macro pkg-config particulière sera
disponible.

PKG_PROG_PKG_CONFIG([MIN-VERSION])

Définit la variable PKG_CONFIG au meilleur pkg-config disponible, utile si vous
besoin de pkg-config mais ne veux pas utiliser PKG_CHECK_MODULES.

PKG_CHECK_MODULES_STATIC(VARIABLE-PREFIX, MODULES [,ACTION-SI-TROUVE [,ACTION-SI-NON-
TROUVÉ]])
Active la liaison statique via --static avant d'appeler PKG_CHECK_MODULES.

PKG_CHECK_EXISTS(MODULES, [ACTION-SI-TROUVÉE], [ACTION-SI-NON-TROUVÉE])

Vérifiez si un ensemble particulier de modules existe. Semblable à
PKG_CHECK_MODULES(), mais ne définit pas de variables ni d'erreurs d'impression.

Semblable à PKG_CHECK_MODULES, assurez-vous que la première instance de ceci ou
PKG_CHECK_MODULES est appelé, ou assurez-vous d'appeler PKG_CHECK_EXISTS manuellement.

PKG_INSTALLDIR(RÉPERTOIRE)

Remplace la variable pkgconfigdir comme emplacement où un module doit être installé
pkg-config fichiers .pc. Par défaut, le répertoire est $libdir/pkgconfig, mais le
par défaut peut être modifié en passant DIRECTORY. L'utilisateur peut passer outre via le
--with-pkgconfigdir paramètre.

PKG_NOARCH_INSTALLDIR(RÉPERTOIRE)

Remplace la variable noarch_pkgconfigdir comme emplacement où un module doit
installez les fichiers pkg-config .pc indépendants de l'architecture. Par défaut, le répertoire est
$datadir/pkgconfig, mais la valeur par défaut peut être modifiée en passant DIRECTORY. L'utilisateur
peut remplacer via le paramètre --with-noarch-pkgconfigdir.

PKG_CHECK_VAR(VARIABLE, MODULE, CONFIG-VARIABLE, [ACTION-SI-TROUVÉE], [ACTION-SI-NON-TROUVÉE])

Récupère la valeur de la variable pkg-config CONFIG-VARIABLE de MODULE et
le stocke dans VARIABLE. Notez que l'utilisation répétée de VARIABLE n'est pas recommandée car
la vérification sera ignorée si la variable est déjà définie.

METADATA DOSSIER SYNTAXE

Pour ajouter une bibliothèque à l'ensemble de packages pkg-config connaît, il suffit d'installer un .pc fichier.
Vous devez installer ce fichier sur libdir/pkgconfig.

Voici un exemple de fichier :
# Ceci est un commentaire
prefix=/home/hp/unst # ceci définit une variable
exec_prefix=${prefix} # définissant une autre variable en fonction de la première
libdir=${exec_prefix}/ lib
inclusir=${préfixe}/include

Nom : GObject # nom lisible par l'homme
Description : système d'objet/type pour GLib # description lisible par l'homme
Version: 1.3.1
URL: http://www.gtk.org
Nécessite : glib-2.0 = 1.3.1
Conflits : foobar <= 4.5
Bibliothèques : -L${libdir} -lgobject-1.3
Libs.private : -lm
Indicateurs : -I${includedir}/glib-2.0 -I${libdir}/glib/include

Vous généreriez normalement le fichier à l'aide de configure, de sorte que le préfixe, etc. soit défini sur
les bonnes valeurs. Le manuel GNU Autoconf recommande de générer des fichiers tels que des fichiers .pc à
le temps de construction plutôt que le temps de configuration, donc quand vous construisez le fichier .pc est une question de goût
et préférence.

Les fichiers ont deux types de lignes : les lignes de mots-clés commencent par un mot-clé plus deux points, et
les définitions de variables commencent par une chaîne alphanumérique plus un signe égal. Les mots clés sont
définis à l'avance et ont une signification particulière pour pkg-config; les variables ne le font pas, vous pouvez avoir
toutes les variables que vous souhaitez (cependant, les utilisateurs peuvent s'attendre à récupérer le répertoire habituel
variables de nom).

Notez que les références de variables sont écrites "${foo}" ; vous pouvez échapper au littéral "${" en tant que "$${".

Nom : Ce champ doit être un nom lisible par l'homme pour le package. Notez que ce n'est pas le
nom passé en argument à pkg-config.

Description:
Cela devrait être une brève description du paquet

URL: Une URL où les gens peuvent obtenir plus d'informations et télécharger le package

Version:
Il doit s'agir de la chaîne de version de package la plus spécifique possible.

Nécessite:
Il s'agit d'une liste séparée par des virgules des packages requis par votre package. Drapeaux
des packages dépendants seront fusionnés avec les indicateurs signalés pour votre package.
Facultativement, vous pouvez spécifier la version du package requis (à l'aide de la
opérateurs =, <, >, >=, <=); spécifier une version permet pkg-config faire plus
contrôles de santé mentale. Vous ne pouvez mentionner le même colis qu'une seule fois sur le Nécessite:
ligne. Si la version d'un package n'est pas spécifiée, toute version sera utilisée sans
la vérification.

Nécessite.privé :
Une liste des packages requis par ce package. La différence de Nécessite que
les paquets répertoriés sous Nécessite.privé ne sont pas pris en compte lorsqu'un drapeau
list est calculée pour l'exécutable lié dynamiquement (c'est-à-dire, quand --static n'était pas
spécifié). Dans le cas où chaque fichier .pc correspond à une bibliothèque,
Nécessite.privé doit être utilisé exclusivement pour spécifier les dépendances entre les
bibliothèques.

Conflits:
Cette ligne optionnelle permet pkg-config pour effectuer des contrôles de santé supplémentaires, principalement
pour détecter les installations utilisateur cassées. La syntaxe est la même que Nécessite: sauf
que vous pouvez répertorier le même package plusieurs fois ici, par exemple "foobar =
1.2.3, foobar = 1.2.5, foobar >= 1.3", si vous avez des raisons de le faire. Si une version
n'est pas spécifié, alors votre package est en conflit avec toutes les versions de l'élément mentionné
emballer. Si un utilisateur essaie d'utiliser votre package et un package en conflit en même temps
le temps, alors pkg-config va se plaindre.

Bibliothèques : Cette ligne doit donner les indicateurs de lien spécifiques à votre package. Ne pas ajouter de drapeaux
pour les packages requis ; pkg-config les ajoutera automatiquement.

Libs.private :
Cette ligne doit répertorier toutes les bibliothèques privées utilisées. Les bibliothèques privées sont
bibliothèques qui ne sont pas exposées via votre bibliothèque, mais qui sont nécessaires dans le cas de
liaison statique. Cela diffère de Nécessite.privé en ce qu'il référence des bibliothèques
qui n'ont pas de fichiers de package installés.

Drapeaux :
Cette ligne doit lister les indicateurs de compilation spécifiques à votre package. N'en ajoutez aucun
indicateurs pour les packages requis ; pkg-config les ajoutera automatiquement.

Utilisez i686-w64-mingw32-pkg-config en ligne à l'aide des services onworks.net