i686-w64-mingw32-pkg-config: en línea en la nube

PROGRAMA:

NOMBRE

pkg-config - Devuelve metainformación sobre las bibliotecas instaladas

SINOPSIS

paquete-config [--modversion] [--version] [--help] [--al menos-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 = VARIABLENAME] [--define-
variable = VARIABLENAME = VARIABLEVALUE] [--print-variables] [--uninstalled] [--exists]
[--al menos-versión = VERSION] [--exact-version = VERSION] [--max-version = VERSION] [--validate]
[--list-all] [--print-provide] [--print-requiere] [--print-requiere-privado]
[BIBLIOTECAS ...]

DESCRIPCIÓN

El paquete-config El programa se utiliza para recuperar información sobre las bibliotecas instaladas en el
sistema. Por lo general, se usa para compilar y vincular una o más bibliotecas. Aquí está
un escenario de uso típico en un Makefile:

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

paquete-config recupera información sobre paquetes de archivos de metadatos especiales. Estos archivos
llevan el nombre del paquete y tienen un .ordenador personal extensión. En la mayoría de los sistemas, paquete-config miradas
in / usr / lib / pkgconfig, / usr / share / pkgconfig, / usr / local / lib / pkgconfig y
/ usr / local / share / pkgconfig para estos archivos. Además, buscará en los dos puntos.
lista separada (en Windows, separada por punto y coma) de directorios especificados por
Variable de entorno PKG_CONFIG_PATH.

El nombre del paquete especificado en el paquete-config La línea de comando se define como el nombre del
archivo de metadatos, menos el .ordenador personal extensión. Si una biblioteca puede instalar varias versiones
simultáneamente, debe dar a cada versión su propio nombre (por ejemplo, GTK 1.2 podría tener
el nombre del paquete "gtk +" mientras que GTK 2.0 tiene "gtk + -2.0").

Además de especificar un nombre de paquete en la línea de comando, la ruta completa a un determinado .ordenador personal
en su lugar, se puede proporcionar un archivo. Esto permite a un usuario consultar directamente un .ordenador personal archivo.

CAMPUS

Se admiten las siguientes opciones:

--modversión
Solicita que la información de la versión de las bibliotecas especificadas en el comando
se mostrará la línea. Si paquete-config puede encontrar todas las bibliotecas en la línea de comandos,
la cadena de versión de cada biblioteca se imprime en stdout, una versión por línea. En esto
case paquete-config sale con éxito. Si se desconoce una o más bibliotecas, paquete-config
sale con un código distinto de cero y el contenido de stdout no está definido.

--versión
Muestra la versión de paquete-config y termina.

--al menos-pkgconfig-version = VERSION
Requiere al menos la versión dada de pkg-config.

--ayuda Muestra un mensaje de ayuda y finaliza.

- errores de impresión
Si uno o más de los módulos en la línea de comando, o sus dependencias, no están
encontrado, o si se produce un error al analizar un .ordenador personal archivo, entonces esta opción causará
Errores que explican el problema que se va a imprimir. Con opciones de "predicado" como
"--existe" paquete-config se ejecuta silenciosamente de forma predeterminada, porque generalmente se usa en
scripts que quieren controlar la salida. Esta opción se puede utilizar sola (solo para
errores de impresión encontrados al ubicar módulos en la línea de comando) o con otros
opciones. La variable de entorno PKG_CONFIG_DEBUG_SPEW anula esta opción.

- errores cortos
Imprima mensajes de error breves.

- errores de silencio
Si uno o más de los módulos en la línea de comando, o sus dependencias, no están
encontrado, o si se produce un error al analizar aa .ordenador personal archivo, esta opción mantendrá
errores que explican el problema de la impresión. Con opciones de "predicado" como
"--existe" paquete-config se ejecuta silenciosamente de forma predeterminada, porque generalmente se usa en
scripts que quieren controlar la salida. Entonces esta opción solo es útil con
opciones como "--cflags" o "--modversion" que imprimen errores por defecto. los
La variable de entorno PKG_CONFIG_DEBUG_SPEW anula esta opción.

--errores a salida estándar
Si imprime errores, imprímalos en stdout en lugar del stderr predeterminado

--depurar
Imprime información de depuración. Esto es ligeramente diferente al
Variable de entorno PKG_CONFIG_DEBUG_SPEW, que también habilita "--print-errors".

Las siguientes opciones se utilizan para compilar y vincular programas:

--cflags
Esto imprime los indicadores de preprocesador y compilación necesarios para compilar los paquetes en el
línea de comandos, incluidas las banderas para todas sus dependencias. Las banderas están "comprimidas", por lo que
que cada bandera idéntica aparece solo una vez. paquete-config sale con un código distinto de cero si
no puede encontrar metadatos para uno o más de los paquetes en la línea de comando.

--cflags-solo-yo
Esto imprime la parte -I de "--cflags". Es decir, define la ruta de búsqueda del encabezado.
pero no especifica nada más.

--cflags-solo-otros
Esto imprime partes de "--cflags" no cubiertas por "--cflags-only-I".

--libras Esta opción es idéntica a "--cflags", solo que imprime las banderas del enlace. Al igual que con
"--cflags", los indicadores duplicados se fusionan (manteniendo el orden adecuado) y los indicadores para
las dependencias se incluyen en la salida.

--libs-solo-L
Esto imprime la parte -L / -R de "--libs". Es decir, define la ruta de búsqueda de la biblioteca.
pero no especifica con qué bibliotecas enlazar.

--libs-solo-l
Esto imprime la parte -l de "--libs" para las bibliotecas especificadas en el comando
línea. Tenga en cuenta que la unión de "--libs-only-l" y "--libs-only-L" puede ser menor
que "--libs", debido a banderas como -rdynamic.

--libs-solo-otros
Esto imprime las partes de "--libs" no cubiertas por "--libs-only-L" y "--libs-only-
l ", como" --pthread ".

--variable = VARIABLENAME
Esto devuelve el valor de una variable definida en el paquete .ordenador personal expediente. La mayoría de los paquetes
defina la variable "prefijo", por ejemplo, para que pueda decir:
$ pkg-config --variable = prefijo glib-2.0
/ usr /

--define-variable = VARIABLENAME = VARIABLEVALUE
Esto establece un valor global para una variable, anulando el valor en cualquier .ordenador personal archivos.
La mayoría de los paquetes definen la variable "prefijo", por ejemplo, para que pueda decir:
$ pkg-config --print-errors --define-variable = prefix = / foo \
--variable = prefijo glib-2.0
/ foo

--imprimir-variables
Devuelve una lista de todas las variables definidas en el paquete.

--desinstalado
Normalmente, si solicita el paquete "foo" y el paquete "foo-uninstalled" existe,
paquete-config preferirá la variante "sin instalar". Esto permite la compilación / vinculación
contra paquetes desinstalados. Si especifica la opción "--uninstalled", paquete-config
regresará exitosamente si se está utilizando algún paquete "-desinstalado", y regresará
falla (falso) de lo contrario. (El entorno PKG_CONFIG_DISABLE_UNINSTALLED
la variable mantiene paquete-config de elegir implícitamente paquetes "-desinstalados", por lo que si
esa variable está configurada, solo se habrán utilizado si pasa un nombre como "foo-
desinstalado "en la línea de comando explícitamente).

--existe

--al menos versión = VERSIÓN

--exact-version = VERSION

--max-version = VERSION
Estas opciones prueban si el paquete o la lista de paquetes en la línea de comando son
conocido por paquete-configy, opcionalmente, si el número de versión de un paquete cumple
ciertas limitaciones. Si todos los paquetes existen y cumplen con la versión especificada
restricciones, paquete-config sale con éxito. De lo contrario, sale sin éxito. Solamente
se aceptará la primera opción de comparación de VERSIONES. Opciones posteriores de este tipo
será ignorado

En lugar de utilizar las opciones de prueba de versión, simplemente puede dar una versión
restricción después de cada nombre de paquete, por ejemplo:
$ pkg-config --exists 'glib-2.0> = 1.3.4 libxml = 1.8.3'
Recuerde usar --print-errors si desea mensajes de error. Cuando no hay opciones de salida
se suministran a paquete-config, --existe está implícito.

--validar
Comprueba la sintaxis de un paquete .ordenador personal archivo de validez. Esto es lo mismo que
: existe excepto que las dependencias no están verificadas. Esto puede ser útil para el paquete.
desarrolladores para probar sus .ordenador personal archivo antes del lanzamiento:
$ pkg-config --validate ./mi-paquete.pc

--sintaxis de msvc
Esta opción solo está disponible en Windows. Causa paquete-config para generar -l y -L
banderas en la forma reconocida por el compilador de línea de comandos de Microsoft Visual C ++, cl.
Específicamente, en lugar de -Lx: / alguna / ruta imprime / libpath: x / alguna / rutay en su lugar
of -lfoo imprime foo.lib. Tenga en cuenta que la salida de --libs consta de indicadores para
vinculador, y debe colocarse en la línea de comando cl después de un modificador / link.

--define-prefijo
--no-define-prefijo
Estas opciones controlan si paquete-config anula el valor de la variable prefijo
en cada archivo .pc. Con --define-prefix, paquete-config utiliza la ubicación instalada de
el archivo .pc para determinar el prefijo. --dont-define-prefix evita este comportamiento.
El valor predeterminado suele ser --define-prefix.

Cuando esta función está habilitada y se encuentra un archivo .pc en un directorio llamado
paqueteconfig, se supone que el prefijo de ese paquete es el abuelo del
directorio donde se encontró el archivo, y el prefijo la variable se anula por eso
archivo en consecuencia.

Si el valor de una variable en un archivo .pc comienza con el original, no reemplazado,
valor de la prefijo variable, entonces el valor anulado de prefijo se usa en su lugar.
Esto permite que la característica funcione incluso cuando las variables se han expandido en el
archivo .pc.

--prefix-variable = PREFIX
Establezca el nombre de la variable que paquete-config anula en lugar de prefijo cuando se utiliza
la función --define-prefix.

--estático
Bibliotecas de salida adecuadas para enlaces estáticos. Eso significa incluir cualquier
bibliotecas en la salida. Esto se basa en un etiquetado adecuado en los archivos .pc, de lo contrario, un
Normalmente se generará un número demasiado grande de bibliotecas.

--Listar todo
Enumere todos los módulos que se encuentran en el paquete-config camino.

--print-proporciona
Enumere todos los módulos que proporcionan los paquetes dados.

--print-requiere
Enumere todos los módulos que requieren los paquetes dados.

--print-requiere-privado
Enumere todos los módulos que los paquetes dados requieren para la vinculación estática (consulte --static).

MEDIO AMBIENTE VARIABLES

PKG_CONFIG_RUTA
Una lista de directorios separados por dos puntos (en Windows, separados por punto y coma) para buscar
para archivos .pc. El directorio predeterminado siempre se buscará después de buscar el
sendero; el valor predeterminado es libdir /paqueteconfig:directorio de datos/ pkgconfig donde libdir es el libdir
para paquete-config y directorio de datos es el datadir para paquete-config cuando fue instalado.

PKG_CONFIG_DEBUG_SPEW
Si se establece, las causas paquete-config para imprimir todo tipo de información e informes de depuración
todos los errores.

PKG_CONFIG_TOP_BUILD_DIR
Un valor para establecer para la variable mágica pc_top_builddir que puede aparecer en .ordenador personal
archivos. Si la variable de entorno no está configurada, el valor predeterminado '$ (top_builddir)'
se utilizará. Esta variable debe hacer referencia al directorio de compilación superior del Makefile donde
las banderas de compilación / enlace informadas por paquete-config se utilizará. Esto solo importa cuando
compilar / vincular con un paquete que aún no se ha instalado.

PKG_CONFIG_DISABLE_UNINSTALLED
Normalmente, si solicita el paquete "foo" y el paquete "foo-uninstalled" existe,
paquete-config preferirá la variante "sin instalar". Esto permite la compilación / vinculación
contra paquetes desinstalados. Si esta variable de entorno está configurada, deshabilita
dicho comportamiento.

PKG_CONFIG_ALLOW_SYSTEM_CFLAGS
No elimine -I / usr / include de cflags.

PKG_CONFIG_ALLOW_SYSTEM_LIBS
No elimine -L / usr / lib o -L / lib de las librerías.

PKG_CONFIG_SYSROOT_DIR
Modifique -I y -L para usar los directorios ubicados en la raíz del sistema de destino. esta opcion es
útil cuando se compilan paquetes que usan pkg-config para determinar CFLAGS y
LDFLAGS. -I y -L se modifican para apuntar a la nueva raíz del sistema. esto significa que un
-I / usr / include / libfoo se convertirá en -I / var / target / usr / include / libfoo con un
PKG_CONFIG_SYSROOT_DIR igual a / var / target (la misma regla se aplica a -L)

PKG_CONFIG_LIBDIR
Reemplaza el predeterminado paquete-config directorio de búsqueda, generalmente
/ usr / lib / pkgconfig:/ usr / share / pkgconfig.

PKG_CONFIG_ $ PACKAGE_ $ VARIABLE
Reemplaza la variable VARIABLE en el paquete PAQUETE. La variable de entorno
debe tener el nombre del paquete y la variable del paquete en mayúsculas con caracteres no alfanuméricos
caracteres convertidos en guiones bajos. Por ejemplo, establecer
PKG_CONFIG_GLADEUI_2_0_CATALOGDIR anulará la variable "catalogdir" en el
paquete "gladeui-2.0".

CONFIGURACIÓN DE PAQUETE DERIVADO VARIABLES

paquete-config establece algunas variables de metadatos que pueden usarse en archivos .pc o consultarse en
tiempo de ejecución.

ruta_pc
La ruta de búsqueda predeterminada utilizada por paquete-config al buscar archivos .pc. Esto puede
ser utilizado en una consulta para el paquete-config módulo en sí mismo:
$ paquete-config --variable pc_path pkg-config

archivopcdir
La ubicación instalada del archivo .pc. Esto se puede utilizar para consultar la ubicación de
el archivo .pc para un módulo en particular, pero también se puede usar para crear archivos .pc
reubicable. Por ejemplo:
prefijo = $ {pcfiledir}/../ ..
exec_prefix = $ {prefix}
libdir = $ {exec_prefix}/ lib
includedir = $ {prefix} / include

pc_sysrootdir
El directorio sysroot establecido por el usuario. Cuando no se ha configurado el directorio sysroot,
este valor es /. Consulte las PKG_CONFIG_SYSROOT_DIR variable de entorno para más
Detalles.

pc_top_builddir
Ubicación del directorio de compilación superior del usuario al llamar paquete-config. Esto es útil
para establecer rutas dinámicamente en archivos .pc desinstalados. Ver el PKG_CONFIG_TOP_BUILD_DIR
variable de entorno para obtener más detalles.

VENTANAS ESPECIALIDADES

El paquete-config La ruta de búsqueda predeterminada se ignora en Windows. En cambio, la ruta de búsqueda es
construido utilizando el directorio instalado de paquete-config y luego agregando
lib \ pkgconfig y compartir \ pkgconfig. Esto se puede aumentar o reemplazar usando el estándar
variables de entorno descritas anteriormente.

CONFIGURACIÓN AUTOMÁTICA MACROS

PKG_CHECK_MODULES (VARIABLE-PREFIX, MÓDULOS [, ACCIÓN-SI-ENCONTRADA [, ACCIÓN-SI-NO-ENCONTRADA]])

La macro PKG_CHECK_MODULES se puede utilizar en configurar.ac para comprobar si los módulos
existe. Un uso típico sería:
PKG_CHECK_MODULES ([MYSTUFF], [gtk + -2.0> = 1.3.5 libxml = 1.8.4])

Esto daría como resultado las variables de sustitución MYSTUFF_LIBS y MYSTUFF_CFLAGS, establecidas en
las libs y cflags para la lista de módulos dada. Si falta un módulo o tiene el
versión incorrecta, la configuración predeterminada se cancelará con un mensaje. Para reemplazar el
acción predeterminada, especifique ACTION-IF-NOT-FOUND. PKG_CHECK_MODULES no se imprimirá
cualquier mensaje de error si especifica su propio ACTION-IF-NOT-FOUND. Sin embargo,
establezca la variable MYSTUFF_PKG_ERRORS, que puede usar para mostrar lo que salió mal.

Tenga en cuenta que si existe la posibilidad de que la primera llamada a PKG_CHECK_MODULES no
suceda, debe asegurarse de incluir una llamada explícita a PKG_PROG_PKG_CONFIG en
su configure.ac.

También tenga en cuenta que no se recomienda el uso repetido de VARIABLE-PREFIX. Después de la
primer uso exitoso, las llamadas posteriores con el mismo VARIABLE-PREFIX simplemente
use las variables _LIBS y _CFLAGS establecidas del uso anterior sin llamar
paquete-config de nuevo.

PKG_PREREQ (MIN-VERSION)
Comprueba que la versión de las macros pkg-config autoconf en uso sea al menos MIN-
VERSIÓN. Esto se puede usar para asegurar que una macro pkg-config particular sea
para todos.

PKG_PROG_PKG_CONFIG ([MIN-VERSION])

Define la variable PKG_CONFIG al mejor pkg-config disponible, útil si
necesita pkg-config pero no quiere usar PKG_CHECK_MODULES.

PKG_CHECK_MODULES_STATIC (VARIABLE-PREFIX, MÓDULOS [, ACCIÓN-SI-ENCONTRADA [, ACCIÓN-SI-NO-
FUNDAR]])
Habilita la vinculación estática a través de --static antes de llamar a PKG_CHECK_MODULES.

PKG_CHECK_EXISTS (MÓDULOS, [ACCIÓN-SI-ENCONTRADA], [ACCIÓN-SI-NO-ENCONTRADA])

Verifique si existe un conjunto particular de módulos. Similar a
PKG_CHECK_MODULES (), pero no establece variables ni errores de impresión.

Similar a PKG_CHECK_MODULES, asegúrese de que la primera instancia de este o
Se llama a PKG_CHECK_MODULES, o asegúrese de llamar a PKG_CHECK_EXISTS manualmente.

PKG_INSTALLDIR (DIRECTORIO)

Sustituye la variable pkgconfigdir como la ubicación donde se debe instalar un módulo
Archivos pkg-config .pc. Por defecto, el directorio es $ libdir / pkgconfig, pero el
el valor predeterminado se puede cambiar pasando DIRECTORIO. El usuario puede anular a través del
--with-pkgconfigdir parámetro.

PKG_NOARCH_INSTALLDIR (DIRECTORIO)

Sustituye la variable noarch_pkgconfigdir como la ubicación donde un módulo debe
instalar archivos pkg-config .pc independientes de arch. Por defecto, el directorio es
$ datadir / pkgconfig, pero el valor predeterminado se puede cambiar pasando DIRECTORY. El usuario
puede anular a través del parámetro --with-noarch-pkgconfigdir.

PKG_CHECK_VAR (VARIABLE, MÓDULO, CONFIG-VARIABLE, [ACCIÓN-SI-ENCONTRADA], [ACCIÓN-SI-NO-ENCONTRADA])

Recupera el valor de la variable pkg-config CONFIG-VARIABLE de MODULE y
lo almacena en VARIABLE. Tenga en cuenta que no se recomienda el uso repetido de VARIABLE
la verificación se omitirá si la variable ya está configurada.

METADATOS ARCHIVO SINTAXIS

Para agregar una biblioteca al conjunto de paquetes paquete-config conoce, simplemente instale un .ordenador personal archivo.
Debe instalar este archivo en libdir/ pkgconfig.

Aquí hay un archivo de ejemplo:
# Esto es un comentario
prefijo = / home / hp / unst # esto define una variable
exec_prefix = $ {prefix} # definiendo otra variable en términos de la primera
libdir = $ {exec_prefix}/ lib
includedir = $ {prefix} / include

Nombre: GObject # nombre legible por humanos
Descripción: sistema de objeto / tipo para GLib # descripción legible por humanos
Version: 1.3.1
URL: http://www.gtk.org
Requiere: glib-2.0 = 1.3.1
Conflictos: foobar <= 4.5
Libs: -L $ {libdir} -lgobject-1.3
Librerías.privadas: -lm
Cflags: -I $ {includedir} /glib-2.0 -I $ {libdir} / glib / include

Normalmente, generaría el archivo usando configure, de modo que el prefijo, etc.se establezca en
los valores adecuados. El manual GNU Autoconf recomienda generar archivos como archivos .pc en
construir el tiempo en lugar de configurar el tiempo, por lo que cuando se crea el archivo .pc es una cuestión de gustos
y preferencia.

Los archivos tienen dos tipos de línea: las líneas de palabras clave comienzan con una palabra clave más dos puntos y
las definiciones de variables comienzan con una cadena alfanumérica más un signo igual. Las palabras clave son
definidas de antemano y tienen un significado especial para paquete-config; las variables no, puedes tener
cualquier variable que desee (sin embargo, los usuarios pueden esperar recuperar el directorio habitual
variables de nombre).

Tenga en cuenta que las referencias de variables se escriben "$ {foo}"; puede escapar literal "$ {" como "$$ {".

Nombre: Este campo debe ser un nombre legible por humanos para el paquete. Tenga en cuenta que no es el
nombre pasado como argumento a paquete-config.

Descripción:
Debe ser una breve descripción del paquete.

URL: Una URL donde las personas pueden obtener más información y descargar el paquete.

Versión:
Esta debe ser la cadena de versión de paquete más específica posible.

Requiere:
Esta es una lista de paquetes separados por comas que su paquete requiere. Banderas
de los paquetes dependientes se fusionarán con las banderas informadas para su paquete.
Opcionalmente, puede especificar la versión del paquete requerido (usando el
operadores =, <,>,> =, <=); especificar una versión permite paquete-config para realizar extra
controles de cordura. Solo puede mencionar el mismo paquete una vez en el Requiere:
línea. Si no se especifica la versión de un paquete, se utilizará cualquier versión sin
cheques.

Requiere.privado:
Una lista de paquetes requeridos por este paquete. La diferencia de Requiere es que
los paquetes enumerados en Requiere.privado no se tienen en cuenta cuando una bandera
La lista se calcula para ejecutables vinculados dinámicamente (es decir, cuando --static no fue
especificado). En la situación en la que cada archivo .pc corresponde a una biblioteca,
Requiere.privado se utilizará exclusivamente para especificar las dependencias entre los
bibliotecas

Conflictos:
Esta línea opcional permite paquete-config para realizar comprobaciones de cordura adicionales, principalmente
para detectar instalaciones de usuario rotas. La sintaxis es la misma que Requiere: excepto
que puede enumerar el mismo paquete más de una vez aquí, por ejemplo "foobar =
1.2.3, foobar = 1.2.5, foobar> = 1.3 ", si tiene motivos para hacerlo. Si una versión
no está especificado, entonces su paquete entra en conflicto con todas las versiones del mencionado
paquete. Si un usuario intenta usar su paquete y un paquete conflictivo al mismo
tiempo, entonces paquete-config se quejará.

libretas: Esta línea debe proporcionar los indicadores de enlace específicos de su paquete. No agregue banderas
para paquetes requeridos; paquete-config los agregará automáticamente.

Lib. Privada:
Esta línea debe enumerar las bibliotecas privadas en uso. Las bibliotecas privadas son
bibliotecas que no están expuestas a través de su biblioteca, pero son necesarias en el caso de
enlace estático. Esto difiere de Requiere.privado en que hace referencia a bibliotecas
que no tienen archivos de paquete instalados.

Banderas:
Esta línea debe enumerar los indicadores de compilación específicos de su paquete. No agregue ninguno
banderas para paquetes requeridos; paquete-config los agregará automáticamente.

Use i686-w64-mingw32-pkg-config en línea usando los servicios de onworks.net