pg_config — récupèrer des informations sur la version installée de PostgreSQL™
pg_config [option...]
L'outil pg_config affiche les paramètres de configuration de la version installée de PostgreSQL™. Il peut, par exemple, d'être utilisé par des paquets logiciels qui souhaitent s'interfacer avec PostgreSQL™ pour faciliter la recherche des fichiers d'entêtes requis et des bibliothèques.
Pour utiliser pg_config, une ou plusieurs des options suivantes doivent être fournies :
Afficher l'emplacement des exécutables utilisateur. Par exemple, pour trouver le programme psql. C'est aussi normalement l'emplacement du programme pg_config.
Afficher l'emplacement des fichiers de documentation.
Affiche l'emplacement des fichiers de documentation HTML.
Afficher l'emplacement des fichiers d'entêtes C des interfaces clientes.
Afficher l'emplacement des autres fichiers d'entête C.
Afficher l'emplacement des fichiers d'entêtes C pour la programmation du serveur.
Afficher l'emplacement des bibliothèques.
Afficher l'emplacement des modules chargeables dynamiquement ou celui que le serveur peut parcourir pour les trouver. (D'autres fichiers de données dépendant de l'architecture peuvent aussi être installés dans ce répertoire.)
Afficher l'emplacement des fichiers de support de la locale (c'est une chaîne vide si le support de la locale n'a pas été configuré lors de la construction de PostgreSQL™).
Afficher l'emplacement des pages de manuel.
Afficher l'emplacement des fichiers de support qui ne dépendent pas de l'architecture.
Afficher l'emplacement des fichiers de configuration du système.
Afficher l'emplacement des fichiers makefile d'extensions.
Afficher les options passées au script configure lors de la configuration de PostgreSQL™ en vue de sa construction. Cela peut être utilisé pour reproduire une configuration identique ou pour trouver les options avec lesquelles un paquet binaire a été construit. (Néanmoins, les paquets binaires contiennent souvent des correctifs personnalisés par le vendeur.) Voir aussi les exemples ci-dessous.
Afficher la valeur de la macro CC utilisée lors de la construction de PostgreSQL™. Cela affiche le compilateur C utilisé.
Afficher la valeur de la macro CPPFLAGS utilisée lors de la construction de PostgreSQL™. Cela affiche les options du compilateur C nécessaires pour l'exécution du préprocesseur (typiquement, les options -I).
Afficher la valeur de la macro CFLAGS utilisée lors de la construction de PostgreSQL™. Cela affiche les options du compilateur C.
Afficher la valeur de la macro CFLAGS_SL utilisée lors de la construction de PostgreSQL™. Cela affiche les options supplémentaires du compilateur C utilisées pour construire les bibliothèques partagées.
Afficher la valeur de la macro LDFLAGS utilisée lors de la construction de PostgreSQL™. Cela affiche les options de l'éditeur de liens.
Afficher la valeur de la variable LDFLAGS_EX utilisée lors de la construction de PostgreSQL™. Cela affiche les options de l'éditeur de liens uniquement pour la construction des exécutables.
Afficher la valeur de la macro LDFLAGS_SL utilisée lors de la construction de PostgreSQL™. Cela affiche les options de l'éditeur de liens utilisées pour construire seulement les bibliothèques partagées.
Afficher la valeur de la macro LIBS utilisée lors de la construction de PostgreSQL™. Elle contient habituellement les options -l pour les bibliothèques externes auxquelles PostgreSQL™ est lié.
Afficher la version de PostgreSQL™.
Affiche de l'aide à propos des arguments en ligne de commande avec pg_config, puis quitte.
Si plusieurs options sont données, l'information est affichée dans cet ordre, un élément par ligne. Si aucune option n'est donnée, toutes les informations disponibles sont affichées avec des étiquettes.
L'option --includedir-server est apparue dans PostgreSQL™ 7.2. Dans les versions précédentes, les fichiers d'entêtes du serveur étaient installés au même endroit que les entêtes client, qui pouvaient être récupérés avec l'option --includedir. Pour que le paquet gère les deux cas, la nouvelle option est tentée en premier, et le code de sortie est testé pour savoir si la commande a réussi.
Les options --docdir, --pkgincludedir, --localedir, --mandir, --sharedir, --sysconfdir, --cc, --cppflags, --cflags, --cflags_sl, --ldflags, --ldflags_sl et --libs sont apparues avec PostgreSQL™ 8.1. L'option --htmldir n'est disponible qu'à partir de PostgreSQL™ 8.4. The option --ldflags_ex was added in PostgreSQL™ 9.0.
Dans les versions antérieures à PostgreSQL™ 7.1, avant que pg_config ne soit disponible, il n'existait aucune méthode de récupération de ces informations de configuration.
Reproduire la configuration de construction de l'installation actuelle de PostgreSQL :
eval ./configure `pg_config --configure`
La sortie de pg_config --configure contient les guillemets du shell de sorte que les arguments contenant des espaces soient représentés correctement. Du coup, il est nécessaire d'utiliser eval pour obtenir des résultats corrects.
pg_basebackup
