i686-w64-mingw32-pkg-config - Online nel cloud

PROGRAMMA:

NOME

pkg-config - Restituisce metainformazioni sulle librerie installate

SINOSSI

pkg-config [--modversion] [--version] [--help] [--atleast-pkgconfig-version=VERSIONE]
[--errori-di-stampa] [--errori-brevi] [--errori-silenzio] [--errori-a-stdout] [--debug]
[--cflags] [--libs] [--libs-only-L] [--libs-only-l] [--cflags-only-I] [--libs-only-other]
[--cflags-only-other] [--variable=NOMEVARIABILE] [--define-
variabile=NOMEVARIABILE=VALOREVARIABILE] [--print-variables] [--uninstalled] [--exists]
[--atleast-version=VERSIONE] [--exact-version=VERSIONE] [--max-version=VERSIONE] [--validate]
[--list-all] [--print-fornis] [--print-requires] [--print-requires-private]
[BIBLIOTECHE...]

DESCRIZIONE

I pkg-config viene utilizzato per recuperare informazioni sulle librerie installate nel
sistema. Viene in genere utilizzato per compilare e collegarsi a una o più librerie. Qui è
un tipico scenario di utilizzo in un Makefile:

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

pkg-config recupera le informazioni sui pacchetti da speciali file di metadati. Questi file
prendono il nome dal pacchetto e hanno un .PC estensione. Sulla maggior parte dei sistemi, pkg-config sguardi
in /usr/lib/pkgconfig, /usr/condivisione/pkgconfig, /usr/local/lib/pkgconfig ed
/usr/local/share/pkgconfig per questi file. Guarderà anche nel colon-
elenco separato (in Windows, separato da punto e virgola) di directory specificate da
Variabile di ambiente PKG_CONFIG_PATH.

Il nome del pacchetto specificato sul pkg-config la riga di comando è definita come il nome del
file di metadati, meno il .PC estensione. Se una libreria può installare più versioni
contemporaneamente, deve dare ad ogni versione il proprio nome (per esempio, GTK 1.2 potrebbe avere
il nome del pacchetto "gtk+" mentre GTK 2.0 ha "gtk+-2.0").

Oltre a specificare un nome di pacchetto sulla riga di comando, il percorso completo di un dato .PC
file può essere dato invece. Ciò consente a un utente di interrogare direttamente un particolare .PC file.

VERSIONI

Sono supportate le seguenti opzioni:

--modversione
Richiede che le informazioni sulla versione delle librerie specificate nel comando
essere visualizzata la riga. Se pkg-config può trovare tutte le librerie sulla riga di comando,
la stringa di versione di ogni libreria viene stampata su stdout, una versione per riga. In questo
Custodie pkg-config esce con successo. Se una o più librerie sono sconosciute, pkg-config
esce con un codice diverso da zero e il contenuto di stdout non è definito.

--versione
Visualizza la versione di pkg-config e termina.

--atleast-pkgconfig-version=VERSIONE
Richiede almeno la versione specificata di pkg-config.

--Aiuto Visualizza un messaggio di aiuto e termina.

--errori di stampa
Se uno o più moduli sulla riga di comando, o le loro dipendenze, non lo sono
trovato, o se si verifica un errore durante l'analisi di a .PC file, quindi questa opzione causerà
errori che spiegano il problema da stampare. Con opzioni "predicato" come
"--esiste" pkg-config funziona silenziosamente per impostazione predefinita, perché di solito è usato in
script che vogliono controllare l'output. Questa opzione può essere utilizzata da sola (solo per
errori di stampa riscontrati durante l'individuazione dei moduli sulla riga di comando) o con altri
opzioni. La variabile d'ambiente PKG_CONFIG_DEBUG_SPEW sovrascrive questa opzione.

--short-errori
Stampa brevi messaggi di errore.

--silenzio-errori
Se uno o più moduli sulla riga di comando, o le loro dipendenze, non lo sono
trovato, o se si verifica un errore durante l'analisi di aa .PC file, quindi questa opzione manterrà
errori che spiegano il problema dalla stampa. Con opzioni "predicato" come
"--esiste" pkg-config funziona silenziosamente per impostazione predefinita, perché di solito è usato in
script che vogliono controllare l'output. Quindi questa opzione è utile solo con
opzioni come "--cflags" o "--modversion" che stampano gli errori per impostazione predefinita. Il
La variabile di ambiente PKG_CONFIG_DEBUG_SPEW sovrascrive questa opzione.

--errori-to-stdout
Se si stampano errori, stampali su stdout anziché sullo stderr predefinito

- debug
Stampa le informazioni di debug. Questo è leggermente diverso dal
PKG_CONFIG_DEBUG_SPEW variabile d'ambiente, che abilita anche "--print-errors".

Le seguenti opzioni vengono utilizzate per compilare e collegare i programmi:

--flag
Questo stampa i flag di pre-processore e di compilazione richiesti per compilare i pacchetti sul
riga di comando, inclusi i flag per tutte le loro dipendenze. I flag sono "compressi" quindi
che ogni bandiera identica appaia solo una volta. pkg-config esce con un codice diverso da zero se
non riesce a trovare i metadati per uno o più pacchetti sulla riga di comando.

--cflags-solo-I
Questo stampa la parte -I di "--cflags". Cioè, definisce il percorso di ricerca dell'intestazione
ma non specifica altro.

--cflags-solo-altro
Questo stampa parti di "--cflags" non coperte da "--cflags-only-I".

--libs Questa opzione è identica a "--cflags", solo che stampa i flag di collegamento. come con
"--cflags", i flag duplicati vengono uniti (mantenendo l'ordine corretto) e i flag per
le dipendenze sono incluse nell'output.

--libs-solo-L
Questo stampa la parte -L/-R di "--libs". Cioè, definisce il percorso di ricerca della libreria
ma non specifica a quali librerie collegarsi.

--libs-solo-l
Questo stampa la parte -l di "--libs" per le librerie specificate nel comando
linea. Nota che l'unione di "--libs-only-l" e "--libs-only-L" può essere più piccola
di "--libs", a causa di flag come -rdynamic.

--libs-solo-altro
Questo stampa le parti di "--libs" non coperte da "--libs-only-L" e "--libs-only-
l", come "--pthread".

--variable=NOMEVARIABILE
Questo restituisce il valore di una variabile definita in un pacchetto .PC file. La maggior parte dei pacchetti
definire la variabile "prefisso", ad esempio, in modo da poter dire:
$ pkg-config --variable=prefisso glib-2.0
/ usr /

--define-variable=NOMEVARIABILE=VALOREVARIABILE
Questo imposta un valore globale per una variabile, sovrascrivendo il valore in qualsiasi .PC File.
La maggior parte dei pacchetti definisce la variabile "prefisso", ad esempio, quindi puoi dire:
$ pkg-config --print-errors --define-variable=prefisso=/pippo \
--variable=prefisso glib-2.0
/pippo

--variabili di stampa
Restituisce un elenco di tutte le variabili definite nel pacchetto.

--disinstallato
Normalmente se richiedi il pacchetto "foo" ed esiste il pacchetto "foo-uninstalled",
pkg-config preferirà la variante "-uninstalled". Ciò consente la compilazione/il collegamento
contro i pacchetti disinstallati. Se specifichi l'opzione "--uninstalled", pkg-config
restituirà correttamente se vengono utilizzati pacchetti "-uninstalled" e restituirà
fallimento (falso) altrimenti. (L'ambiente PKG_CONFIG_DISABLE_UNINSTALLED
variabile mantiene pkg-config dalla scelta implicita dei pacchetti "-uninstalled", quindi se
quella variabile è impostata, saranno stati utilizzati solo se si passa un nome come "pippo-
disinstallato" sulla riga di comando in modo esplicito.)

--esiste

--atleast-version=VERSIONE

--versione-esatta=VERSIONE

--max-version=VERSIONE
Queste opzioni verificano se il pacchetto o l'elenco di pacchetti sulla riga di comando sono
conosciuto per pkg-confige, facoltativamente, se il numero di versione di un pacchetto soddisfa
determinati vincoli. Se tutti i pacchetti esistono e soddisfano la versione specificata
vincoli, pkg-config esce con successo. Altrimenti esce senza successo. Soltanto
verrà rispettata la prima opzione di confronto VERSIONE. Opzioni successive di questo tipo
verrà ignorato.

Invece di utilizzare le opzioni di test della versione, puoi semplicemente fornire una versione
vincolo dopo ogni nome di pacchetto, ad esempio:
$ pkg-config --exists 'glib-2.0 >= 1.3.4 libxml = 1.8.3'
Ricordati di usare --print-errors se vuoi messaggi di errore. Quando non ci sono opzioni di output
sono forniti a pkg-config, --exists è implicito.

--convalidare
Controlla la sintassi di un pacchetto .PC file per la validità. Questo è lo stesso di
--exists eccetto che le dipendenze non sono verificate. Questo può essere utile per il pacchetto
sviluppatori per testare il loro .PC file prima del rilascio:
$ pkg-config --validate ./mio-pacchetto.pc

--msvc-sintassi
Questa opzione è disponibile solo su Windows. Causa pkg-config in uscita -l e -L
flag nella forma riconosciuta dal compilatore della riga di comando di Microsoft Visual C++, cl.
In particolare, invece di -Lx:/qualche/percorso stampa /libpath:x/qualche/percorso, e invece
of -lfoo stampa foo.lib. Nota che l'output --libs consiste di flag per il
linker e dovrebbe essere posizionato nella riga di comando cl dopo un'opzione /link.

--define-prefisso
--non-definire-prefisso
Queste opzioni controllano se pkg-config sovrascrive il valore della variabile prefisso
in ogni file .pc. Con --define-prefix, pkg-config utilizza la posizione installata di
il file .pc per determinare il prefisso. --dont-define-prefix impedisce questo comportamento.
L'impostazione predefinita è solitamente --define-prefix.

Quando questa funzione è abilitata e viene trovato un file .pc in una directory denominata
pkgconfig, si presume che il prefisso per quel pacchetto sia il nonno del
directory in cui è stato trovato il file e il prefisso la variabile viene sovrascritta per questo
file di conseguenza.

Se il valore di una variabile in un file .pc inizia con l'originale, non sovrascritto,
valore del prefisso variabile, quindi il valore sovrascritto di prefisso viene invece utilizzato.
Ciò consente alla funzione di funzionare anche quando le variabili sono state espanse nel
file .pc.

--prefisso-variabile=PREFISSO
Imposta il nome della variabile che pkg-config sostituisce invece di prefisso quando si utilizza
la funzione --define-prefix.

--statico
Librerie di output adatte per il collegamento statico. Ciò significa includere qualsiasi privato
librerie in uscita. Questo si basa sulla corretta codifica nei file .pc, altrimenti a
in genere verrà emesso un numero troppo elevato di librerie.

--list-all
Elenca tutti i moduli trovati nel pkg-config sentiero.

--print-fornisce
Elenca tutti i moduli forniti dai pacchetti forniti.

--print-richiede
Elenca tutti i moduli richiesti dai pacchetti forniti.

--print-richiede-privato
Elenca tutti i moduli richiesti dai pacchetti forniti per il collegamento statico (vedi --static).

AMBIENTE VARIABILI

PKG_CONFIG_PATH
Un elenco di directory separate da due punti (su Windows, separate da punto e virgola) in cui cercare
per i file .pc. La ricerca nella directory predefinita verrà sempre eseguita dopo aver cercato in
il percorso; l'impostazione predefinita è libro/pkgconfig:datadir/pkgconfig dove libdir è la libdir
per pkg-config ed datadir è la directory dei dati per pkg-config quando è stato installato.

PKG_CONFIG_DEBUG_SPEW
Se impostato, causa pkg-config per stampare tutti i tipi di informazioni e report di debug
tutti gli errori.

PKG_CONFIG_TOP_BUILD_DIR
Un valore da impostare per la variabile magica pc_top_builddir che può apparire in .PC
File. Se la variabile di ambiente non è impostata, il valore predefinito '$(top_builddir)'
sarà usato. Questa variabile dovrebbe fare riferimento alla builddir superiore del Makefile dove
i flag di compilazione/collegamento segnalati da pkg-config sarà usato. Questo conta solo quando
compilazione/collegamento a un pacchetto che non è stato ancora installato.

PKG_CONFIG_DISABLE_UNINSTALLATO
Normalmente se richiedi il pacchetto "foo" ed esiste il pacchetto "foo-uninstalled",
pkg-config preferirà la variante "-uninstalled". Ciò consente la compilazione/il collegamento
contro i pacchetti disinstallati. Se questa variabile d'ambiente è impostata, si disabilita
detto comportamento.

PKG_CONFIG_ALLOW_SYSTEM_CFLAGS
Non rimuovere -I/usr/include da cflags.

PKG_CONFIG_ALLOW_SYSTEM_LIBS
Non rimuovere -L/usr/lib o -L/lib dalle librerie.

PKG_CONFIG_SYSROOT_DIR
Modificare -I e -L per utilizzare le directory situate nella sysroot di destinazione. questa opzione è
utile durante la compilazione incrociata di pacchetti che utilizzano pkg-config per determinare CFLAGS e
LDFLAG. -I e -L vengono modificati per puntare alla nuova root di sistema. questo significa che a
-I/usr/include/libfoo diventerà -I/var/target/usr/include/libfoo con un
PKG_CONFIG_SYSROOT_DIR uguale a /var/target (la stessa regola si applica a -L)

PKG_CONFIG_LIBDIR
Sostituisce l'impostazione predefinita pkg-config directory di ricerca, di solito
/usr/lib/pkgconfig:/usr/condivisione/pkgconfig.

PKG_CONFIG_$PACCHETTO_$VARIABILE
Sostituisce la variabile VARIABLE nel pacchetto PACKAGE. La variabile d'ambiente
dovrebbe avere il nome del pacchetto e la variabile del pacchetto in maiuscolo con caratteri non alfanumerici
caratteri convertiti in caratteri di sottolineatura. Ad esempio, impostazione
PKG_CONFIG_GLADEUI_2_0_CATALOGDIR sovrascriverà la variabile "catalogdir" nel
pacchetto "gladeui-2.0".

CONFIGURAZIONE PKG DERIVATO VARIABILI

pkg-config imposta alcune variabili di metadati che possono essere utilizzate nei file .pc o interrogate su
tempo di esecuzione.

pc_percorso
Il percorso di ricerca predefinito utilizzato da pkg-config durante la ricerca di file .pc. questo può
essere utilizzato in una query per il pkg-config modulo stesso:
$ pkg-config --variable pc_path pkg-config

pcfiledir
Il percorso di installazione del file .pc. Questo può essere usato per interrogare la posizione di
il file .pc per un particolare modulo, ma può anche essere usato per creare file .pc
trasferibile. Ad esempio:
prefisso=${pcfiledir}/../..
exec_prefix=${prefisso}
libdir=${prefisso_exec}/ lib
inclusoir=${prefisso}/include

pc_sysrootdir
La directory sysroot impostata dall'utente. Quando la directory sysroot non è stata impostata,
questo valore è /. Vedere il PKG_CONFIG_SYSROOT_DIR variabile d'ambiente per di più
dettagli.

pc_top_builddir
Posizione della directory di build principale dell'utente durante la chiamata pkg-config. Questo è utile
per impostare dinamicamente i percorsi nei file .pc disinstallati. Vedi il PKG_CONFIG_TOP_BUILD_DIR
variabile d'ambiente per maggiori dettagli.

FINESTRE SPECIALITA'

I pkg-config il percorso di ricerca predefinito viene ignorato su Windows. Invece, il percorso di ricerca è
costruito utilizzando la directory installata di pkg-config e poi aggiungendo
lib\pkgconfig ed condividi\pkgconfig. Questo può essere aumentato o sostituito utilizzando lo standard
variabili d'ambiente sopra descritte.

CONF.AUTO MACRO

PKG_CHECK_MODULES(PREFIX-VARIABILE, MODULI [,AZIONE-SE-TROVATA [,AZIONE-SE-NON-TROVATA]])

La macro PKG_CHECK_MODULES può essere utilizzata in configurare.ac per verificare se i moduli
esistere. Un uso tipico sarebbe:
PKG_CHECK_MODULES([MYSTUFF], [gtk+-2.0 >= 1.3.5 libxml = 1.8.4])

Ciò risulterebbe nelle variabili di sostituzione MYSTUFF_LIBS e MYSTUFF_CFLAGS, impostate su
le libs e cflags per l'elenco di moduli dato. Se manca un modulo o ha il
versione errata, per impostazione predefinita configure si interromperà con un messaggio. Per sostituire il
azione predefinita, specificare un'AZIONE-SE-NON-TROVATA. PKG_CHECK_MODULES non stampa
eventuali messaggi di errore se specifichi la tua ACTION-IF-NOT-FOUND. Tuttavia, lo farà
imposta la variabile MYSTUFF_PKG_ERRORS, che puoi usare per visualizzare cosa è andato storto.

Nota che se esiste una possibilità, la prima chiamata a PKG_CHECK_MODULES potrebbe non esserlo
succede, dovresti essere sicuro di includere una chiamata esplicita a PKG_PROG_PKG_CONFIG in
il tuo configure.ac.

Si noti inoltre che l'uso ripetuto di VARIABLE-PREFIX non è raccomandato. Dopo il
primo utilizzo riuscito, le chiamate successive con lo stesso PREFISSO VARIABILE saranno semplicemente
usa le variabili _LIBS e _CFLAGS impostate dall'utilizzo precedente senza chiamare
pkg-config nuovamente.

PKG_PREREQ(VERSIONE MIN)
Verifica che la versione delle macro autoconf pkg-config in uso sia almeno MIN-
VERSIONE. Questo può essere usato per garantire che una particolare macro pkg-config sia
a disposizione.

PKG_PROG_PKG_CONFIG([VERSIONE MIN])

Definisce la variabile PKG_CONFIG al miglior pkg-config disponibile, utile se tu
bisogno di pkg-config ma non voglio usare PKG_CHECK_MODULES.

PKG_CHECK_MODULES_STATIC(PREFIX-VARIABILE, MODULI [,AZIONE-SE-TROVATA [,AZIONE-SE-NON-
TROVATO]])
Abilita il collegamento statico tramite --static prima di chiamare PKG_CHECK_MODULES.

PKG_CHECK_EXISTS(MODULI, [AZIONE-SE-TROVATA], [AZIONE-SE-NON-TROVATA])

Verificare se esiste un particolare insieme di moduli. Simile a
PKG_CHECK_MODULES(), ma non imposta variabili o errori di stampa.

Simile a PKG_CHECK_MODULES, assicurati che la prima istanza di questo o
Viene chiamato PKG_CHECK_MODULES o assicurati di chiamare PKG_CHECK_EXISTS manualmente.

PKG_INSTALLDIR(DIRECTORY)

Sostituisce la variabile pkgconfigdir come posizione in cui installare un modulo
pkg-config file .pc. Per impostazione predefinita la directory è $libdir/pkgconfig, ma il
l'impostazione predefinita può essere modificata passando DIRECTORY. L'utente può eseguire l'override tramite il
--with-pkgconfigdir parametro.

PKG_NOARCH_INSTALLDIR(DIRECTORY)

Sostituisce la variabile noarch_pkgconfigdir come posizione in cui dovrebbe essere un modulo
installa file pkg-config .pc indipendenti dall'architettura. Per impostazione predefinita la directory è
$datadir/pkgconfig, ma il valore predefinito può essere modificato passando DIRECTORY. L'utente
può sovrascrivere tramite il parametro --with-noarch-pkgconfigdir.

PKG_CHECK_VAR(VARIABILE, MODULO, CONFIG-VARIABILE, [AZIONE-SE-TROVATA], [AZIONE-SE-NON-TROVATA])

Recupera il valore della variabile pkg-config CONFIG-VARIABLE da MODULE e
lo memorizza in VARIABILE. Si noti che l'uso ripetuto di VARIABLE non è raccomandato in quanto
il controllo verrà saltato se la variabile è già impostata.

METADATA RISORSE SINTASSI

Per aggiungere una libreria al set di pacchetti pkg-config conosce, installa semplicemente a .PC file.
Dovresti installare questo file su libdir/pkgconfig.

Ecco un file di esempio:
# Questo è un commento
prefix=/home/hp/unst # questo definisce una variabile
exec_prefix=${prefix} # definisce un'altra variabile in termini della prima
libdir=${prefisso_exec}/ lib
inclusoir=${prefisso}/include

Nome: GObject # nome leggibile dall'uomo
Descrizione: sistema oggetto/tipo per GLib # descrizione leggibile dall'uomo
Versione: 1.3.1
URL: http://www.gtk.org
Richiede: glib-2.0 = 1.3.1
Conflitti: foobar <= 4.5
Lib: -L${libdir} -lgobject-1.3
Libs.privato: -lm
Cflag: -I${includedir}/glib-2.0 -I${libdir}/glib/include

Normalmente genereresti il ​​file usando configure, in modo che il prefisso, ecc. sia impostato su
i valori adeguati. Il manuale GNU Autoconf consiglia di generare file come file .pc su
costruire il tempo piuttosto che configurare il tempo, quindi quando crei il file .pc è una questione di gusti
e preferenza.

I file hanno due tipi di riga: le righe delle parole chiave iniziano con una parola chiave più i due punti e
le definizioni delle variabili iniziano con una stringa alfanumerica più un segno di uguale. Le parole chiave sono
definiti in anticipo e hanno un significato speciale per pkg-config; le variabili no, puoi avere
qualsiasi variabile desideri (tuttavia, gli utenti possono aspettarsi di recuperare la solita directory
nome variabili).

Nota che i riferimenti alle variabili sono scritti "${foo}"; puoi eseguire l'escape letterale "${" come "$${".

Nome e Cognome: Questo campo dovrebbe essere un nome leggibile per il pacchetto. Nota che non è il
nome passato come argomento a pkg-config.

Descrizione:
Questa dovrebbe essere una breve descrizione del pacchetto

URL: Un URL in cui le persone possono ottenere maggiori informazioni e scaricare il pacchetto

Versione:
Questa dovrebbe essere la stringa di versione del pacchetto più specifica possibile.

Richiede:
Questo è un elenco separato da virgole di pacchetti richiesti dal tuo pacchetto. bandiere
dai pacchetti dipendenti verranno uniti ai flag riportati per il tuo pacchetto.
Facoltativamente, è possibile specificare la versione del pacchetto richiesto (utilizzando il pulsante
operatori =, <, >, >=, <=); specificare una versione consente pkg-config per eseguire extra
controlli di sanità mentale. Puoi menzionare lo stesso pacchetto solo una volta sul Richiede:
linea. Se la versione di un pacchetto non è specificata, verrà utilizzata qualsiasi versione senza no
il controllo.

Richiede.privato:
Un elenco di pacchetti richiesti da questo pacchetto. La differenza da Richiede è che
i pacchetti elencati sotto Richiede.privato non vengono presi in considerazione quando una bandiera
list è calcolato per eseguibili collegati dinamicamente (cioè, quando --static non lo era
specificato). Nella situazione in cui ogni file .pc corrisponde a una libreria,
Richiede.privato deve essere utilizzato esclusivamente per specificare le dipendenze tra il
librerie.

conflitti:
Questa linea opzionale consente pkg-config per eseguire ulteriori controlli di integrità, in primo luogo
per rilevare installazioni utente danneggiate. La sintassi è la stessa di Richiede: con l’esclusione di
che puoi elencare lo stesso pacchetto più di una volta qui, ad esempio "foobar =
1.2.3, foobar = 1.2.5, foobar >= 1.3", se ne hai motivo. Se una versione
non è specificato, allora il tuo pacchetto è in conflitto con tutte le versioni del menzionato
pacchetto. Se un utente tenta di utilizzare contemporaneamente il tuo pacchetto e un pacchetto in conflitto
tempo, allora pkg-config si lamenterà.

Libri: Questa riga dovrebbe fornire i flag di collegamento specifici per il tuo pacchetto. Non aggiungere bandiere
per i pacchetti richiesti; pkg-config li aggiungerà automaticamente.

Libs.privato:
Questa riga dovrebbe elencare tutte le librerie private in uso. Le biblioteche private sono
librerie che non sono esposte attraverso la tua libreria, ma sono necessarie in caso di
collegamento statico. Questo differisce da Richiede.privato in quanto fa riferimento a librerie
che non hanno file di pacchetto installati.

bandiere:
Questa riga dovrebbe elencare i flag di compilazione specifici per il tuo pacchetto. Non aggiungerne nessuno
flag per i pacchetti richiesti; pkg-config li aggiungerà automaticamente.

Usa i686-w64-mingw32-pkg-config online utilizzando i servizi onworks.net