i686-w64-mingw32-pkg-config - Online na nuvem

PROGRAMA:

NOME

pkg-config - Retorna metainformação sobre as bibliotecas instaladas

SINOPSE

pacote-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 = VARIABLENAME] [--define-
variável = VARIABLENAME = VARIABLEVALUE] [--print-variables] [--uninstalled] [--exists]
[--atleast-version = VERSION] [--exact-version = VERSION] [--max-version = VERSION] [--validate]
[--list-all] [--print-supplies] [--print-requires] [--print-requires-private]
[BIBLIOTECAS ...]

DESCRIÇÃO

A pacote-config programa é usado para recuperar informações sobre bibliotecas instaladas no
sistema. Normalmente é usado para compilar e vincular a uma ou mais bibliotecas. Aqui está
um cenário de uso típico em um Makefile:

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

pacote-config recupera informações sobre pacotes de arquivos de metadados especiais. Esses arquivos
têm o nome do pacote e tem um .pc extensão. Na maioria dos sistemas, pacote-config looks
in / usr / lib / pkgconfig, / usr / share / pkgconfig, / usr / local / lib / pkgconfig e
/ usr / local / share / pkgconfig para esses arquivos. Ele também vai olhar no cólon
lista separada (no Windows, separada por ponto e vírgula) de diretórios especificados pelo
Variável de ambiente PKG_CONFIG_PATH.

O nome do pacote especificado no pacote-config linha de comando é definida como o nome do
arquivo de metadados, menos o .pc extensão. Se uma biblioteca pode instalar várias versões
simultaneamente, deve dar a cada versão seu próprio nome (por exemplo, GTK 1.2 pode ter
o nome do pacote "gtk +" enquanto GTK 2.0 tem "gtk + -2.0").

Além de especificar um nome de pacote na linha de comando, o caminho completo para um determinado .pc
arquivo pode ser fornecido em seu lugar. Isso permite que um usuário consulte diretamente um determinado .pc arquivo.

OPÇÕES

As seguintes opções são suportadas:

--modversão
Solicita que as informações de versão das bibliotecas especificadas no comando
linha ser exibida. Se pacote-config pode encontrar todas as bibliotecas na linha de comando,
cada string de versão da biblioteca é impressa em stdout, uma versão por linha. Nisso
casas pacote-config sai com sucesso. Se uma ou mais bibliotecas forem desconhecidas, pacote-config
sai com um código diferente de zero e o conteúdo de stdout é indefinido.

--versão
Exibe a versão de pacote-config e termina.

--atleast-pkgconfig-version = VERSION
Requer pelo menos a versão fornecida do pkg-config.

--Socorro Exibe uma mensagem de ajuda e termina.

--print-erros
Se um ou mais dos módulos na linha de comando, ou suas dependências, não são
encontrado, ou se ocorrer um erro na análise de um .pc arquivo, então esta opção irá causar
erros que explicam o problema a ser impresso. Com opções de "predicado", como
"--existe" pacote-config é executado silenciosamente por padrão, porque geralmente é usado em
scripts que desejam controlar o que é produzido. Esta opção pode ser usada sozinha (para apenas
erros de impressão encontrados ao localizar módulos na linha de comando) ou com outro
opções. A variável de ambiente PKG_CONFIG_DEBUG_SPEW substitui esta opção.

--short-erros
Imprima mensagens de erro curtas.

--silêncio-erros
Se um ou mais dos módulos na linha de comando, ou suas dependências, não são
encontrado, ou se ocorrer um erro na análise de aa .pc arquivo, então esta opção irá manter
erros que explicam o problema de serem impressos. Com opções de "predicado", como
"--existe" pacote-config é executado silenciosamente por padrão, porque geralmente é usado em
scripts que desejam controlar o que é produzido. Portanto, esta opção só é útil com
opções como "--cflags" ou "--modversion" que imprimem erros por padrão. o
A variável de ambiente PKG_CONFIG_DEBUG_SPEW substitui esta opção.

--errors-to-stdout
Se houver erros de impressão, imprima-os no stdout em vez do stderr padrão

--depurar
Imprima informações de depuração. Isso é um pouco diferente do
Variável de ambiente PKG_CONFIG_DEBUG_SPEW, que também permite "--print-errors".

As seguintes opções são usadas para compilar e vincular programas:

--cflags
Isso imprime pré-processador e sinalizadores de compilação necessários para compilar os pacotes no
linha de comando, incluindo sinalizadores para todas as suas dependências. Sinalizadores são "comprimidos" então
que cada bandeira idêntica aparece apenas uma vez. pacote-config sai com um código diferente de zero se
ele não consegue encontrar metadados para um ou mais dos pacotes na linha de comando.

--cflags-only-I
Isso imprime a parte -I de "--cflags". Ou seja, define o caminho de pesquisa do cabeçalho
mas não especifica mais nada.

--cflags-somente-outro
Isso imprime partes de "--cflags" não cobertas por "--cflags-only-I".

--libs Esta opção é idêntica a "--cflags", apenas imprime os sinalizadores de link. Como com
"--cflags", sinalizadores duplicados são mesclados (mantendo a ordem adequada) e sinalizadores para
dependências são incluídas na saída.

--libs-somente-L
Isso imprime a parte -L / -R de "--libs". Ou seja, define o caminho de pesquisa da biblioteca
mas não especifica com quais bibliotecas vincular.

--libs-somente-l
Isso imprime a parte -l de "--libs" para as bibliotecas especificadas no comando
linha. Observe que a união de "--libs-only-l" e "--libs-only-L" pode ser menor
do que "--libs", devido a sinalizadores como -rdynamic.

--libs-somente-outro
Isso imprime as partes de "--libs" não cobertas por "--libs-only-L" e "--libs-only-
l ", como" --pthread ".

--variable = VARIABLENAME
Isso retorna o valor de uma variável definida em um pacote .pc Arquivo. A maioria dos pacotes
defina a variável "prefixo", por exemplo, para que possa dizer:
$ pkg-config --variable = prefixo glib-2.0
/ usr /

--define-variable = VARIABLENAME = VARIABLEVALUE
Isso define um valor global para uma variável, substituindo o valor em qualquer .pc arquivos.
A maioria dos pacotes define a variável "prefixo", por exemplo, então você pode dizer:
$ pkg-config --print-errors --define-variable = prefix = / foo \
--variable = prefixo glib-2.0
/ foo

--print-variáveis
Retorna uma lista de todas as variáveis ​​definidas no pacote.

--desinstalado
Normalmente, se você solicitar o pacote "foo" e o pacote "foo-desinstalado" existir,
pacote-config irá preferir a variante "-desinstalada". Isso permite a compilação / vinculação
contra pacotes desinstalados. Se você especificar a opção "--uninstalled", pacote-config
irá retornar com sucesso se algum pacote "-uninstalled" estiver sendo usado, e retornar
falha (falso) caso contrário. (O ambiente PKG_CONFIG_DISABLE_UNINSTALLED
variável mantém pacote-config de escolher implicitamente pacotes "-desinstalados", portanto, se
essa variável está definida, eles só serão usados ​​se você passar um nome como "foo-
desinstalado "na linha de comando explicitamente.)

--existe

--atleast-version = VERSION

--exact-version = VERSION

--max-version = VERSION
Estas opções testam se o pacote ou lista de pacotes na linha de comando são
conhecido por pacote-confige, opcionalmente, se o número da versão de um pacote atende
certas restrições. Se todos os pacotes existirem e atenderem à versão especificada
restrições, pacote-config sai com sucesso. Caso contrário, ele sai sem sucesso. Somente
a primeira opção de comparação de VERSÃO será considerada. Opções subsequentes deste tipo
será ignorado.

Em vez de usar as opções de teste de versão, você pode simplesmente fornecer uma versão
restrição após cada nome de pacote, por exemplo:
$ pkg-config --exists 'glib-2.0> = 1.3.4 libxml = 1.8.3'
Lembre-se de usar --print-errors se quiser mensagens de erro. Quando não há opções de saída
são fornecidos para pacote-config, --exists está implícito.

--validar
Verifica a sintaxe de um pacote .pc arquivo para validade. Este é o mesmo que
--existe exceto que as dependências não são verificadas. Isso pode ser útil para o pacote
desenvolvedores para testar seus .pc arquivo antes do lançamento:
$ pkg-config --validate ./my-package.pc

- sintaxe msvc
Esta opção está disponível apenas no Windows. Causa pacote-config para produzir -l e -L
sinalizadores na forma reconhecida pelo compilador de linha de comando do Microsoft Visual C ++, cl.
Especificamente, em vez de -Lx: / algum / caminho imprime / libpath: x / algum / caminho, e ao invés
of -lfo imprime foo.lib. Observe que a saída --libs consiste em sinalizadores para o
vinculador e deve ser colocado na linha de comando cl após uma opção / link.

--define-prefixo
--não-defina-prefixo
Essas opções controlam se pacote-config substitui o valor da variável prefixo
em cada arquivo .pc. Com --define-prefix, pacote-config usa o local instalado de
o arquivo .pc para determinar o prefixo. --dont-define-prefix evita esse comportamento.
O padrão é geralmente --define-prefix.

Quando este recurso está ativado e um arquivo .pc é encontrado em um diretório chamado
pkgconfig, o prefixo para esse pacote é considerado o avô do
diretório onde o arquivo foi encontrado, e o prefixo variável é substituída por isso
arquivo em conformidade.

Se o valor de uma variável em um arquivo .pc começa com o original, não sobrescrito,
valor do prefixo variável, então o valor substituído de prefixo é usado em seu lugar.
Isso permite que o recurso funcione mesmo quando as variáveis ​​foram expandidas no
arquivo .pc.

--prefix-variable = PREFIX
Defina o nome da variável que pacote-config substitui em vez de prefixo quando se utiliza
o recurso --define-prefix.

--estático
Bibliotecas de saída adequadas para vinculação estática. Isso significa incluir qualquer
bibliotecas na saída. Isso depende da marcação adequada nos arquivos .pc, caso contrário, um
normalmente será gerado um número muito grande de bibliotecas.

--lista-tudo
Liste todos os módulos encontrados no pacote-config caminho.

--print-fornece
Liste todos os módulos que os pacotes fornecidos fornecem.

--print-requer
Liste todos os módulos que os pacotes fornecidos requerem.

--print-requer-privado
Liste todos os módulos que os pacotes dados requerem para links estáticos (veja --static).

MEIO AMBIENTE VARIÁVEIS

PKG_CONFIG_PATH
Uma lista de diretórios separados por vírgulas (no Windows, ponto-e-vírgula) para pesquisar
para arquivos .pc. O diretório padrão sempre será pesquisado após pesquisar o
caminho; o padrão é libdir /pacoteconfig:diretório de dados/ pkgconfig onde libdir é o libdir
para pacote-config e diretório de dados é o datadir para pacote-config quando foi instalado.

PKG_CONFIG_DEBUG_SPEW
Se definido, causa pacote-config para imprimir todos os tipos de informações de depuração e relatório
todos os erros.

PKG_CONFIG_TOP_BUILD_DIR
Um valor a ser definido para a variável mágica pc_top_builddir que pode aparecer em .pc
arquivos. Se a variável de ambiente não for definida, o valor padrão '$ (top_builddir)'
será usado. Esta variável deve se referir ao builddir superior do Makefile, onde
os sinalizadores de compilação / link relatados por pacote-config será usado. Isso só importa quando
compilar / vincular a um pacote que ainda não foi instalado.

PKG_CONFIG_DISABLE_UNINSTALLED
Normalmente, se você solicitar o pacote "foo" e o pacote "foo-desinstalado" existir,
pacote-config irá preferir a variante "-desinstalada". Isso permite a compilação / vinculação
contra pacotes desinstalados. Se esta variável de ambiente for definida, ela desativa
dito comportamento.

PKG_CONFIG_ALLOW_SYSTEM_CFLAGS
Não retire -I / usr / include de cflags.

PKG_CONFIG_ALLOW_SYSTEM_LIBS
Não retire -L / usr / lib ou -L / lib das bibliotecas.

PKG_CONFIG_SYSROOT_DIR
Modifique -I e -L para usar os diretórios localizados no sysroot de destino. esta opção é
útil na compilação cruzada de pacotes que usam pkg-config para determinar CFLAGS e
LDFLAGS. -I e -L são modificados para apontar para a nova raiz do sistema. isso significa que um
-I / usr / include / libfoo se tornará -I / var / target / usr / include / libfoo com um
PKG_CONFIG_SYSROOT_DIR igual a / var / target (a mesma regra se aplica a -L)

PKG_CONFIG_LIBDIR
Substitui o padrão pacote-config diretório de pesquisa, geralmente
/ usr / lib / pkgconfig:/ usr / share / pkgconfig.

PKG_CONFIG_ $ PACKAGE_ $ VARIABLE
Substitui a variável VARIABLE no pacote PACKAGE. A variável de ambiente
deve ter o nome do pacote e a variável do pacote em letras maiúsculas com caracteres não alfanuméricos
caracteres convertidos em sublinhados. Por exemplo, definindo
PKG_CONFIG_GLADEUI_2_0_CATALOGDIR irá substituir a variável "catalogdir" no
pacote "gladeui-2.0".

PKG-CONFIG DERIVADO VARIÁVEIS

pacote-config define algumas variáveis ​​de metadados que podem ser usados ​​em arquivos .pc ou consultados em
tempo de execução.

caminho_do_pc
O caminho de pesquisa padrão usado por pacote-config ao pesquisar arquivos .pc. Isso pode
ser usado em uma consulta para o pacote-config o próprio módulo:
$ pkg-config --variável pc_path pkg-config

pcfiledir
O local de instalação do arquivo .pc. Isso pode ser usado para consultar a localização de
o arquivo .pc para um módulo específico, mas também pode ser usado para criar arquivos .pc
relocável. Por exemplo:
prefixo = $ {pcfiledir}/../ ..
exec_prefix = $ {prefix}
libdir = $ {exec_prefix}/ lib
includedir = $ {prefix} / include

pc_sysrootdir
O diretório sysroot definido pelo usuário. Quando o diretório sysroot não foi definido,
este valor é /. Veja o PKG_CONFIG_SYSROOT_DIR variável de ambiente para mais
Detalhes.

pc_top_builddir
Localização do diretório principal de compilação do usuário ao chamar pacote-config. Isso é útil
para definir caminhos dinamicamente em arquivos .pc desinstalados. Veja o PKG_CONFIG_TOP_BUILD_DIR
variável de ambiente para mais detalhes.

Windows ESPECIALIDADES

A pacote-config o caminho de pesquisa padrão é ignorado no Windows. Em vez disso, o caminho de pesquisa é
construído usando o diretório instalado de pacote-config e então anexar
lib \ pkgconfig e compartilhar \ pkgconfig. Isso pode ser aumentado ou substituído usando o padrão
variáveis ​​de ambiente descritas acima.

AUTO CONF MACROS

PKG_CHECK_MODULES (VARIABLE-PREFIX, MÓDULOS [, AÇÃO-SE-ENCONTRADA [, AÇÃO-SE-NÃO-ENCONTRADA]])

A macro PKG_CHECK_MODULES pode ser usada em configurar.ac para verificar se os módulos
existir. Um uso típico seria:
PKG_CHECK_MODULES ([MYSTUFF], [gtk + -2.0> = 1.3.5 libxml = 1.8.4])

Isso resultaria em variáveis ​​de substituição MYSTUFF_LIBS e MYSTUFF_CFLAGS, definido como
as libs e cflags para a lista de módulos fornecida. Se um módulo estiver faltando ou tiver o
versão errada, por padrão, o configure irá abortar com uma mensagem. Para substituir o
ação padrão, especifique um ACTION-IF-NOT-FOUND. PKG_CHECK_MODULES não imprimirá
quaisquer mensagens de erro se você especificar sua própria ACTION-IF-NOT-FOUND. No entanto, vai
defina a variável MYSTUFF_PKG_ERRORS, que você pode usar para exibir o que deu errado.

Observe que, se houver a possibilidade, a primeira chamada para PKG_CHECK_MODULES pode não
acontecer, você deve ter certeza de incluir uma chamada explícita para PKG_PROG_PKG_CONFIG em
seu configure.ac.

Observe também que o uso repetido de VARIABLE-PREFIX não é recomendado. Depois de
primeiro uso bem-sucedido, as chamadas subsequentes com o mesmo VARIABLE-PREFIX irão simplesmente
use as variáveis ​​_LIBS e _CFLAGS definidas a partir do uso anterior sem chamar
pacote-config novamente.

PKG_PREREQ (MIN-VERSION)
Verifica se a versão das macros autoconf do pkg-config em uso é de pelo menos MIN-
VERSÃO. Isso pode ser usado para garantir que uma macro pkg-config particular será
disponível.

PKG_PROG_PKG_CONFIG ([MIN-VERSION])

Define a variável PKG_CONFIG para o melhor pkg-config disponível, útil se você
precisa do pkg-config, mas não deseja usar PKG_CHECK_MODULES.

PKG_CHECK_MODULES_STATIC (VARIABLE-PREFIX, MÓDULOS [, AÇÃO-SE-ENCONTRADA [, AÇÃO-SE-NÃO-
ENCONTRADO]])
Ativa a vinculação estática por meio de --static antes de chamar PKG_CHECK_MODULES.

PKG_CHECK_EXISTS (MÓDULOS, [AÇÃO-SE-ENCONTRADA], [AÇÃO-SE-NÃO-ENCONTRADA])

Verifique se existe um determinado conjunto de módulos. Igual a
PKG_CHECK_MODULES (), mas não define variáveis ​​nem imprime erros.

Semelhante a PKG_CHECK_MODULES, certifique-se de que a primeira instância deste ou
PKG_CHECK_MODULES é chamado ou certifique-se de chamar PKG_CHECK_EXISTS manualmente.

PKG_INSTALLDIR (DIRETÓRIO)

Substitui a variável pkgconfigdir como o local onde um módulo deve ser instalado
Arquivos pkg-config .pc. Por padrão, o diretório é $ libdir / pkgconfig, mas o
o padrão pode ser alterado passando DIRETÓRIO. O usuário pode substituir por meio do
parâmetro --with-pkgconfigdir.

PKG_NOARCH_INSTALLDIR (DIRETÓRIO)

Substitui a variável noarch_pkgconfigdir como o local onde um módulo deve
instale arquivos pkg-config .pc independentes do arch. Por padrão, o diretório é
$ datadir / pkgconfig, mas o padrão pode ser alterado passando DIRETÓRIO. O usuário
pode sobrescrever através do parâmetro --with-noarch-pkgconfigdir.

PKG_CHECK_VAR (VARIABLE, MÓDULO, CONFIG-VARIÁVEL, [AÇÃO-SE-ENCONTRADA], [AÇÃO-SE-NÃO-ENCONTRADA])

Recupera o valor da variável pkg-config CONFIG-VARIABLE do MODULE e
armazena em VARIÁVEL. Observe que o uso repetido de VARIABLE não é recomendado como
a verificação será ignorada se a variável já estiver definida.

METADATA ARQUIVO SINTAXE

Para adicionar uma biblioteca ao conjunto de pacotes pacote-config conhece, basta instalar um .pc arquivo.
Você deve instalar este arquivo em libdir/ pkgconfig.

Aqui está um arquivo de exemplo:
# Este é um comentário
prefix = / home / hp / unst # isso define uma variável
exec_prefix = $ {prefix} # definindo outra variável em termos da primeira
libdir = $ {exec_prefix}/ lib
includedir = $ {prefix} / include

Nome: GObject # nome legível por humanos
Descrição: sistema de objeto / tipo para descrição GLib # legível por humanos
Versão: 1.3.1
URL: http://www.gtk.org
Requer: glib-2.0 = 1.3.1
Conflitos: foobar <= 4.5
Libs: -L $ {libdir} -lgobject-1.3
Libs.privado: -lm
Cflags: -I $ {includedir} /glib-2.0 -I $ {libdir} / glib / include

Você normalmente geraria o arquivo usando configure, de modo que o prefixo, etc. seja definido como
os valores adequados. O manual GNU Autoconf recomenda a geração de arquivos como arquivos .pc em
tempo de construção ao invés de tempo de configuração, então quando você construir o arquivo .pc é uma questão de gosto
e preferência.

Os arquivos têm dois tipos de linha: as linhas de palavra-chave começam com uma palavra-chave mais dois-pontos e
as definições de variáveis ​​começam com uma string alfanumérica mais um sinal de igual. Palavras-chave são
definido com antecedência e tem um significado especial para pacote-config; variáveis ​​não, você pode ter
quaisquer variáveis ​​que você deseja (no entanto, os usuários podem esperar para recuperar o diretório normal
variáveis ​​de nome).

Observe que as referências de variáveis ​​são escritas "$ {foo}"; você pode escapar literal "$ {" como "$$ {".

Nome: Este campo deve ser um nome legível para o pacote. Observe que não é o
nome passado como um argumento para pacote-config.

Descrição:
Esta deve ser uma breve descrição do pacote

URL: Um URL onde as pessoas podem obter mais informações e fazer o download do pacote

Versão:
Esta deve ser a string de versão de pacote mais específica possível.

Exige:
Esta é uma lista separada por vírgulas de pacotes exigidos pelo seu pacote. Bandeiras
de pacotes dependentes serão mesclados com os sinalizadores relatados para seu pacote.
Opcionalmente, você pode especificar a versão do pacote necessário (usando o
operadores =, <,>,> =, <=); especificar uma versão permite pacote-config para realizar extra
verificações de sanidade. Você só pode mencionar o mesmo pacote uma vez no Exige:
linha. Se a versão de um pacote não for especificada, qualquer versão será usada sem
verificação.

Requer.privado:
Uma lista de pacotes exigidos por este pacote. A diferença de Requer é a de que
os pacotes listados em Requer.privado não são levados em consideração quando uma bandeira
lista é calculada para executáveis ​​dinamicamente ligados (ou seja, quando --static não era
Especificadas). Na situação em que cada arquivo .pc corresponde a uma biblioteca,
Requer.privado deve ser usado exclusivamente para especificar as dependências entre os
bibliotecas.

Conflitos:
Esta linha opcional permite pacote-config para realizar verificações de integridade adicionais, principalmente
para detectar instalações de usuários quebradas. A sintaxe é a mesma que Exige: exceto
que você pode listar o mesmo pacote mais de uma vez aqui, por exemplo "foobar =
1.2.3, foobar = 1.2.5, foobar> = 1.3 ", se você tiver razão para fazê-lo. Se for uma versão
não for especificado, então o seu pacote entra em conflito com todas as versões do
pacote. Se um usuário tentar usar o seu pacote e um pacote conflitante ao mesmo
tempo então pacote-config vai reclamar.

Bibliotecas: Esta linha deve fornecer os sinalizadores de link específicos para seu pacote. Não adicione nenhuma bandeira
para pacotes necessários; pacote-config irá adicioná-los automaticamente.

Libs.privado:
Esta linha deve listar todas as bibliotecas privadas em uso. Bibliotecas privadas são
bibliotecas que não são expostas por meio de sua biblioteca, mas são necessárias no caso de
vinculação estática. Isso difere de Requer.privado na medida em que faz referência a bibliotecas
que não têm arquivos de pacote instalados.

C sinalizadores:
Esta linha deve listar os sinalizadores de compilação específicos para seu pacote. Não adicione nenhum
sinalizadores para pacotes necessários; pacote-config irá adicioná-los automaticamente.

Use i686-w64-mingw32-pkg-config online usando serviços onworks.net