pg_config

Nome

pg_config -- retorna informações sobre a versão do PostgreSQL instalada

Sinopse

pg_config {--bindir | --includedir | --includedir-server | --libdir | --pkglibdir | --configure | --version}...

Descrição

O utilitário pg_config mostra os parâmetros de configuração da versão do PostgreSQL atualmente instalada. Sua finalidade é, por exemplo, ser usado por pacotes de software que querem interfacear com o PostgreSQL, para ajudar a encontrar os arquivos de cabeçalho e bibliotecas necessários.

Opções

Para usar o pg_config deve-se fornecer uma ou mais das seguintes opções:

--bindir
Mostra a localização dos executáveis do usuário. Usa-se, por exemplo, para encontrar a aplicação psql. Normalmente, este é também o local onde o pg_config reside. [1]
--includedir
Mostra a localização dos arquivos de cabeçalho da linguagem C das interfaces cliente.
--includedir-server
Mostra a localização dos arquivos de cabeçalho da linguagem 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 deve procurá-los (Também podem estar instalados neste diretório outros arquivos de dados dependentes da arquitetura).
--configure
Mostra as opções passadas para o script configure quando o PostgreSQL foi configurado para ser gerado. Pode ser utilizado para reproduzir uma configuração idêntica, ou para descobrir com quais opções o pacote binário foi construído; entretanto, deve ser observado que os pacotes binários geralmente contêm correções específicas da distribuição.
--version
Mostra a versão do PostgreSQL e termina.

Se for fornecida mais de uma opção (exceto --version), a informação é mostrada nesta ordem, um item por linha.

Observações

A opção --includedir-server começou no PostgreSQL 7.2. Nas versões anteriores, os arquivos de inclusão do servidor estavam instalados no mesmo local dos cabeçalhos dos clientes, que podia ser consultado pela opção --includedir. Para tratar os dois casos, deve-se tentar primeiro a opção mais nova, e testar o status da saída para verificar se a execução foi bem-sucedida.

Nas versões do PostgreSQL anteriores a 7.1, antes do comando pg_config existir, não existia um método equivalente para encontrar as informações de configuração.

Histórico

O pg_config apareceu pela primeira vez no PostgreSQL 7.1.

Notas

[1]

No Fedora Core 3 o utilitário psql pode ser encontrado através do comando which psql, que retorna /usr/bin/psql, mas o utilitário pg_config não é instalado pelos RPMs. (N. do T.)

SourceForge.net Logo