pg_config

pg_config
Anterior	Acima	Aplicações cliente do PostgreSQL	Principal	Próxima

pg_config — recupera informações sobre a versão instalada do PostgreSQL

Sinopse

pg_config [opção...]

Descrição

O utilitário pg_config mostra os parâmetros de configuração da versão instalada do PostgreSQL. Destina-se, por exemplo, a ser usado por pacotes de software que desejam fazer interface com o PostgreSQL, para facilitar a localização dos arquivos de cabeçalho e bibliotecas necessários.

Opções

Para usar o utilitário pg_config, deve ser fornecida uma ou mais das seguintes opções:

--bindir: Mostra a localização dos executáveis do usuário. Deve ser usado, por exemplo, para localizar o programa psql. Normalmente, este também é o local onde o programa pg_config reside.
--docdir: Mostra a localização dos arquivos de documentação.
--htmldir: Mostra a localização dos arquivos de documentação HTML.
--includedir: Mostra a localização dos arquivos de cabeçalho C das interfaces cliente.
--pkgincludedir: Mostra a localização de outros arquivos de cabeçalho C.
--includedir-server: Mostra a localização dos arquivos de cabeçalho C para programação do servidor.
--libdir: Mostra a localização das bibliotecas de código objeto.
--pkglibdir: Mostra a localização dos módulos carregáveis dinamicamente, ou onde o servidor os procuraria. (Outros arquivos de dados dependentes da arquitetura também podem estar instalados neste diretório.) (O subdiretório tutorial contém os scripts SQL do tutorial. – N. do T.)
--localedir: Mostra a localização dos arquivos de suporte a localidade. (Será uma cadeia de caracteres vazia, se o suporte a localidade não foi configurado quando o PostgreSQL foi construído.)
--mandir: Mostra a localização das páginas de manual.
--sharedir: Mostra a localização dos arquivos de suporte independentes de arquitetura.
--sysconfdir: Mostra a localização dos arquivos de configuração de todo o sistema.
--pgxs: Mostra a localização dos arquivos Makefile de extensão.
--configure: Mostra as opções dadas ao script configure quando o PostgreSQL foi configurado para construção. Pode ser usado para reproduzir uma configuração idêntica, ou para descobrir com quais opções o pacote binário foi construído. (Note, no entanto, que os pacotes binários geralmente contêm correções (patches) personalizadas específicas do fornecedor.) Veja também o exemplo abaixo.
--cc: Mostra o valor da variável CC usada para construir o PostgreSQL. Esta opção mostra o compilador C usado.
--cppflags: Mostra o valor da variável CPPFLAGS usada para construir o PostgreSQL. Esta opção mostra as opções do compilador C necessárias no tempo de pré-processamento (normalmente, as chaves -I).
--cflags: Mostra o valor da variável CFLAGS usada para construir o PostgreSQL. Esta opção mostra as opções do compilador C.
--cflags_sl: Mostra o valor da variável CFLAGS_SL usada para construir o PostgreSQL. Esta opção mostra as opções extras do compilador C usadas para construir as bibliotecas compartilhadas.
--ldflags: Mostra o valor da variável LDFLAGS usada para construir o PostgreSQL. Esta opção mostra as opções do vinculador (linker).
--ldflags_ex: Mostra o valor da variável LDFLAGS_EX usada para construir o PostgreSQL. Esta opção mostra as opções do vinculador usadas apenas para construir executáveis.
--ldflags_sl: Mostra o valor da variável LDFLAGS_SL usada para construir o PostgreSQL. Esta opção mostra as chaves do vinculador usadas apenas para construir bibliotecas compartilhadas.
--libs: Mostra o valor da variável LIBS usada para construir o PostgreSQL. Esta opção normalmente contém as chaves -l para as bibliotecas externas vinculadas ao PostgreSQL.
--version: Mostra a versão do PostgreSQL.
-? --help: Mostra a ajuda sobre os argumentos da linha de comando do pg_config, e termina.

Se for fornecida mais de uma opção, as informações serão mostradas nesta ordem, um item por linha. Se não for fornecida nenhuma opção, todas as informações disponíveis serão mostradas, com rótulos.

Notas

As opções --docdir, --pkgincludedir, --localedir, --mandir, --sharedir, --sysconfdir, --cc, --cppflags, --cflags, --cflags_sl, --ldflags, --ldflags_sl, e --libs foram adicionadas no PostgreSQL 8.1. A opção --htmldir foi adicionada no PostgreSQL 8.4. A opção --ldflags_ex foi adicionada no PostgreSQL 9.0.

Exemplo

Para reproduzir a configuração de construção da instalação corrente do PostgreSQL, deve ser executado o seguinte comando:

eval ./configure `pg_config --configure`

A saída de pg_config --configure contém delimitadores do interpretador de comandos para que os argumentos com espaços sejam representados corretamente. Portanto, é necessário usar eval para obter os resultados adequados.

Exemplo 156. Exemplo do tradutor

Separação das opções para facilitar a leitura

Este exemplo usa o programa tr (translate) do Linux para formatar a saída da execução de pg_config --configure transformando os caracteres de espaço em caractere de nova-linha:

pg_config --configure | tr ' ' '\n'

'--build=x86_64-linux-gnu'
'--prefix=/usr'
'--includedir=${prefix}/include'
'--mandir=${prefix}/share/man'
'--infodir=${prefix}/share/info'
'--sysconfdir=/etc'
'--localstatedir=/var'
'--disable-option-checking'
'--disable-silent-rules'
'--libdir=${prefix}/lib/x86_64-linux-gnu'
...
'CXXFLAGS=-g
-O2
-fstack-protector-strong
-Wformat
-Werror=format-security'

Nesta saída uma opção pode ocupar mais de uma linha, mas será sempre delimitada por apóstrofos.