Installe tous les fichier sous le répertoire PREFIX au lieu de /usr/local/pgsql (sur les systèmes basés sur Unix) ou lettre_lecteur_courant:/usr/local/pgsql (sur Windows). Les fichiers seront installés dans divers sous-répertoires ; aucun fichier ne sera directement installé dans le répertoire PREFIX.

Précise le répertoire pour des programmes exécutables. La valeur par défaut est PREFIX/bin.

Précise le répertoire pour divers fichiers de configuration, par défaut PREFIX/etc .

Précise l'emplacement d'installation des bibliothèques et modules dynamiquement chargeables. Le défaut est PREFIX/lib.

Précise le répertoire pour installer les fichiers entêtes C et C++. Le défaut est PREFIX/include.

Précise le répertoire pour les fichiers de données en lecture seule utilisés par les programmes installés. Le défaut est PREFIX/share. Notez qu'il n'a rien à voir avec l'emplacement des fichiers de base de données.

Précise le répertoire pour installer les données des locales, en particulier les fichiers du catalogue de traduction des messages. Le défaut est DATADIR/locale.

Les pages man qui viennent avec PostgreSQL seront installées dans ce répertoire, dans leur sous-répertoires manx respectifs. Le défaut est DATADIR/man.

Active ou désactive le support de language natif (Native Language Support NLS), qui est la possibilité d'afficher les messages d'un programme dans une langue autre que l'anglais. Le défaut est auto et sera activé automatiquement si une implémentation de l'API Gettext est trouvée.

Compile le langage serveur PL/Perl. Le défaut est auto.

Compile le langage serveur PL/Python. Le défaut est auto.

Compile le langage serveur PL/Tcl. Le défaut est auto.

Définit la version Tcl à utiliser lors de la compilation de PL/Tcl.

Compile le support pour la bibliothèque ICU, activant l'utilisation des fonctionnalités des collations ICU. (voir Section 24.2). Le défaut est auto et demande que le paquet ICU4C soit installé. La version minimale requise de ICU4C est actuellement 4.2.

Compile avec le support pour LLVM basé sur la compilation JIT (voir Chapitre 32). Cela nécessite d'installer la bibliothèque LLVM. La version minimale de LLVM est actuellement 3.9. Désactivé par défaut.

llvm-config sera utilisée pour trouver les options de compilations requises. llvm-config, et ensuite, pour toutes les versions supportées, llvm-config-$version seront recherchées dans votre PATH. Si cela ne donne pas le programme souahité, utilisez LLVM_CONFIG pour définir un chemin vers le llvm-config correct.

Compile avec le support de compression LZ4. Le défaut est auto.

Compile avec le support de compression Zstandard. Le défault est auto.

Compile avec le support pour les connexions (chiffrées) SSL. La seule LIBRARY supportée est openssl. Ceci nécessite que le paquet OpenSSL soit installé. Compiler avec cette option implique de vérifier les fichiers d'entête et bibliothèques requises pour être sûr que votre installation OpenSSL soit suffisante avant exécution. Le défaut pour cette option est auto.

Compile avec le support de l'authentification GSSAPI. Il est nécessaire que MIT Kerberos soit installé pour GSSAPI. Sur de nombreux systèmes, le système GSSAPI (un sous-ensemble de l'installation MIT Kerberos) n'est pas installé dans un emplacement recherché par défaut (i.e. /usr/include, /usr/lib). Dans ces cas, PostgreSQL va interroger pkg-config pour détecter le compilateur requis et les options de lien. Le défaut est auto. meson configure va vérifier pour les fichiers d'entête et bibliothèques pour être sûr que votre installation GSSAPI est suffisante avant exécution.

Compile avec le support pour l'authentification LDAP et la recherche de paramètre de connexion (voir Section 34.18 et Section 21.10 pour plus d'information). Sous Unix, ceci nécessite d'installer le paquet OpenLDAP. Sous Windows, la bibliothèque WinLDAP est utilisée par défaut. Le défaut est auto. meson configure va vérifier les fichiers d'entête et bibliothèques requises pour s'assurer que votre installation OpenLDAP est suffisante avant exécution.

Compile avec le support PAM. Le défaut est auto.

Compile avec le support de l'authentification BSD. (Le système d'authentification BSD n'est actuellement disponible que sur OpenBSD.) Le défaut est auto.

Compile avec le support de service de notifications systemd. Ceci améliore l'intégration si le serveur est démarré sous systemd mais n'a aucun impact autrement ; voir Section 19.3 pour plus d'information. Le défaut est auto. libsystemd et les fichiers d'entête associés doivent être installés pour utiliser cette option.

Compile avec le support pour le service de découverte automatique Bonjour. Le défaut est auto et nécessite le support de Bonjour sur votre système d'exploitation. Recommandé sur macOS.

Compile le module uuid-ossp (qui fournit les fonctions de génération des UUID), utilisant la bibliothèque UUID spécifiée. LIBRARY peut valoir :

Compile avec libxml2, activant le support de SQL/XML. Le défaut est auto. La version 2.6.23 de libxml2 ou supérieure est nécessaire pour cette fonctionnalité.

Pour utiliser une installation libxml2 dans un emplacement inhabituel, vous pouvez définir les variables d'environnement pkg-config associées (voir sa documentation).

Compile avec lbxslt, activant le xml2module de transformation XSL du XML. L'option -Dlibxml doit aussi être définiée. Le défaut est auto.

Permet l'utilisation de la bibliothèque Readline (et aussi libedit). Le défaut de l'option est auto et active l'édition et historique de la ligne de commande avec psql et est fortement recommandée.

Mettre ces options à true favorise l'utilisation de la bibliothèque en license BSD libedit plutôt que la bibliothèque en license GPL Readline. Cette option est pertinente seulement si vous avez les deux bibliothèque installées ; le défaut est false, ce qui fait utiliser Readline.

Active l'utilisation de la bibliothèque Zlib. Le défaut est auto et active le support des archives compressées dans pg_dump, pg_restore et pg_basebackup, ce qui est recommandée.

Cette option vaut true par défaut ; l'affecter à false va permettre de compiler avec succès même si PostgreSQL n'a pas de support spinlock CPU pour la plateforme. L'absence de support spinlock va donner de mauvaises performances ; par conséquent, cette option ne devrait être changée que si la compilation échoue et vous informe que la plateforme n'a pas de support spinlock. S'il faut affecter cette option pour compiler PostgreSQL sur votre plateforme, merci d'indiquer le problème aux développeurs PostgreSQL.

Cette option est mise à true par défaut ; l'affecter à false va désactiver l'utilisation d'opérations atomiques CPU. Cette option ne fait rien sur les plateformes qui n'ont pas ce genre d'opérations. Sur les plateformes qui les ont, désactiver les opérations atomiques donnera de mauvaises performances. Modifier cette option n'est seulement utile que pour du debug ou pour faire des comparaisons de performances.

Affecter cette option permet d'écraser les valeurs de toutes les fonctionnalités « auto » (les fonctionnalités qui sont activées automatiquement si le logiciel requis est trouvé). Ceci peut être utile quand vous souhaitez désactiver ou activer les fonctionnalités « optionnelles » d'un coup sans le faire pour chacune d'elle manuellement. La valeur par défaut pour ce paramètre est auto.

L'outil que Meson utilise par défaut est ninja et il devrait suffire pour la plupart des cas. Cependant, si vous souhaitez complètement vous intégrer avec Visual Studio, vous pouvez mettre BACKEND à vs.

Cette option est utilisée pour passer des options supplémentaires pour le compilateur C.

Cette option est utilisée pour passer des options complémentaires à l'éditeur de liens C.

DIRECTORIES est une liste de répertoires séparés par des virgules qui seront ajoutés dans la liste de recherche du compilateur pour les fichiers d'entête. Si vous avez des paquets optionnels (tels que GNU Readline) installés dans des emplacements non standard, vous devez utiliser cette option et probablement aussi l'option correspondante -Dextra_lib_dirs.

Exemple : -Dextra_include_dirs=/opt/gnu/include,/usr/sup/include.

DIRECTORIES est une liste de répertoires séparés par des virgules pour rechercher les bibliothèques. Vous devrez probablement utiliser cette option (et l'option correspondante -Dextra_include_dirs) si vous avez des paquets installés dans des emplacements non standard.

Exemple : -Dextra_lib_dirs=/opt/gnu/lib,/usr/sup/lib.

PostgreSQL inclut sa propre base de données de fuseaux horaires, qui est requise pour les opérations sur les dates et heures. Cette base de données de fuseaux horaires est en fait compatible avec la base de données de fuseaux horaires IANA fournie par de nombreux systèmes d'exploitation tel que FreeBSD, Linux et Solaris. Il serait ainsi redondant de l'installer à nouveau. Quand cette option est utilisée, la base de données de fuseaux horaires fournie par le système dans DIRECTORY est utilisée au lieu de celle incluse dans la distribution source PostgreSQL. DIRECTORY doit être spécifiée sous forme de chemin absolu. /usr/share/zoneinfo est un répertoire approprié sur certains systèmes d'exploitation. Notez que la routine d'installation ne détectera pas les données de fuseaux horaires non compatibles ou erronées. Si vous utilisez cette option, soyez avisé d'exécuter des tests de régression pour vérifier que les données de fuseaux horaires que vous indiquez fonctionnent correctement avec PostgreSQL.

Cette option vise principalement les distributeurs de paquets binaires qui connaissent bien le système d'exploitation cible. Le principal avantage d'utiliser cette option est que les paquets PostgreSQL n'ont pas besoin d'être mis à jour dès qu'une des nombreuses règles locales d'heure d'été change. Un autre avantage est que PostgreSQL peut être compilé de manière croisée plus simplement si les fichiers de fuseaux horaires n'ont pas à être compilés pour l'installation.

Ajoute STRING au numéro de version PostgreSQL. Vous pouvez avec cela, par exemple, marquer les binaires compilés d'un instantané Git inédit ou contenant des patchs personnalisés avec une chaîne supplémentaire de version, telle qu'un identifiant git describe ou un numéro de livraison de paquets de distribution.

Cette option vaut true par défaut. Si mise à false, les exécutables PostgreSQL ne sont pas marqués pour indiquer qu'ils doivent chercher les bibliothèques partagées dans le répertoire de bibliothèques de l'installation (voir --libdir). Sur la plupart des plateformes, ce marquage utilise un chemin absolu vers les répertoires de bibliothèques, de sorte que cela ne sera d'aucune utilité si vous déplacez l'installation plus tard. Dans ce cas, vous devrez alors fournir une autre façon aux exécutables de trouver les bibliothèques partagées. Habituellement, cela demande de configurer l'éditeur de liens dynamique du système d'exploitation pour pointer le répertoire de bibliothèques ; voir Section 17.5.1 pour plus de détails.

Si un programme requis pour compiler PostgreSQL (avec ou sans drapeaux optionnels) est stocké sur un chemin non standard, vous pouvez le spécifier manuellement à meson configure. La liste complète des programmes pour lesquels ceci est supporté peut être trouvé en exécutant meson configure. Exemple :

meson configure -DBISON=PATH_TO_BISON

Active la compilation de la documentation en format HTML et man. Son défaut est auto.

Active la compilation de la documentation en format PDF. Son défaut est auto.

Contrôle quelle feuille de style CSS est utilisée. Le défaut est simple. Si mis à website, la documentation HTML va référencer la feuille de style pour postgresql.org.

Affecte NUMBER comme numéro de port par défaut pour le serveur et les clients. Le défaut est 5432. Le port peut toujours être changé après, mais si vous le spécifiez ici alors le serveur et les clients auront la même valeur compilée par défaut, ce qui peut être très pratique. Habituellement la seule bonne raison de choisir une valeur différente du défaut est si vous prévoyez d'exécuter plusieurs serveurs PostgreSQL sur la même machine.

Le nom par défaut du compte de service Kerberos utilisé par GSSAPI. postgres est la valeur par défaut. Il n'y a, habituellement, pas de raison de changer ceci sauf si vous compilez sur un environnement Windows, et dans ce cas, il doit être en casse haute POSTGRES.

Affecte la taille du segment en giga-octets. Les tables volumineuses sont divisées en plusieurs fichiers sur le système d'exploitation, chacune ayant la taille d'un segment. Ceci permet d'éviter des problèmes dûs aux limites de taille de fichier qui existent sur de nombreuses plateformes. La taille par défaut du segment, 1 giga-octet, est sûre sur toutes les plateformes supportées. Si votre système d'exploitation a le support « largefile » (ce qui est le cas pour la plupart, de nos jours), vous pouvez utiliser une taille de segment plus large. Ceci peut être utile pour réduire le nombre de descripteurs de fichiers utilisés lorsque vous travaillez sur des tables volumineuses. Mais soyez prudent de ne pas choisir une valeur plus large que ne peut supporter votre plateforme et le système de fichiers que vous prévoyez d'utiliser. D'autres outils que vous pourriez utiliser, tel que tar, pourrait aussi limiter la taille utilisable d'un fichier. Il est recommandé, mais pas absolument nécessaire, que cette value soit une puissance de 2.

Affecte la taille de bloc, en kilo-octets. Ceci est l'unité de stockage et d'I/O à l'intérieur des tables. Le défaut, 8 kilo-octets, est approprié pour la majorité des situations ; mais d'autres valeurs peuvent être utiles dans des cas spéciaux. Cette valeur doit être une puissance de 2 entre 1 et 32 (kilo-octets).

Affecte la taille de bloc d'un journal de transactions, en kilo-octets. C'est l'unité de stockage et d'I/O à l'intérieur des journaux WAL. Le défaut, 8 kilo-octets, est approprié pour la majorité des situations ; mais d'autres valeurs peuvent être utiles dans des cas spéciaux. Cette valeur doit être une puissance de 2 entre 1 et 64 (kilo-octets).

Cette option peut être utilisée pour indiquer le type de compilation à utiliser ; le défaut est debugoptimized. Si vous préférez un contrôle plus fin sur les symboles de debug et les niveaux d'optimisation que cette option peut fournir, vous pouvez vous référer aux drapeaux --debug et --optimization.

Les types de compilation suivants sont principalement utilisés : plain, debug, debugoptimized et release. Plus d'information à leur sujet peut être trouvé dans la documentation Meson.

Compile tous les programmes et bibliothèques avec les symboles de debug. Cela signifie que vous pouvez exécuter les programmes dans une debugger pour analyser les problèmes. Ceci augmente fortement la taille des exécutables installés, et sur les compilateurs non GCC, désactive habituellement aussi les optimisations compilateur, entrainant des ralentissements. Cependant, avoir les symboles disponibles peut s'avérer extrêmement utile pour gérer tous les problèmes qui peuvent survenir. Actuellement, cette option est recommandée sur des installations de production uniquement si vous utilisez GCC. Mais vous devrez toujours l'avoir si vous effectuez des travaux de développement ou exécutez une version bêta.

Indique le niveau d'optimisation. LEVEL peut être affecté à n'importe quelle valeur de {0,g,1,2,3,s}.

Activer cette option indique au compilateur de traiter les avertissements comme des erreurs. Cela peut être utile pour du développement.

Active les vérifications d'assertion sur le serveur, qui testent de nombreuses conditions qui « ne peuvent se produire ». Ceci est très appréciable dans le but de développer du code, mais les tests ralentissent notablement le serveur. De plus, avoir les tests activés ne va pas nécessairement améliorer la stabilité de votre serveur ! Les vérifications d'assertion ne sont pas catégorisées par sévérité, ainsi ce qui pourrait être un bug relativement inoffensif peut entrainer un redémarrage de serveur s'il déclenche un échec d'assertion. Cette option n'est pas recommandée pour une utilisation en production, mais vous pouvez l'activer lors de travaux de développement ou en testant une version bêta.

Active les tests utilisant les outils Perl TAP. Le défaut est auto et nécessite une installation de Perl et du module Perl IPC::Run. voir Section 33.4 pour plus d'information.

Active les suites de tests qui nécessitent un logiciel particulier pour s'exécuter. Cette option accepte les arguments via une liste de valeurs séparées par des espaces. Voir Section 33.1.3 pour plus de détails.

Si vous utilisez GCC, tous les programmes et bibliothèques seront compilées avec une instrumentation de test de couverture de code. Exécutés, ils généreront des fichiers dans le répertoire de debug avec des mesures de couverture de code. Voir Section 33.5 pour plus d'information. Cette option n'est utilisable qu'avec GCC et pour effectuer des travaux de développement.

Activée, cette option compile PostgreSQL avec le support pour l'outil de profilage dynamique DTrace. voir Section 28.5 pour plus d'information.

Pour pointer le programme dtrace, l'option DTRACE peut être valuée. Ceci est souvent nécessaire parce que dtrace est habituellement installé sous /usr/sbin, qui pourrait ne pas être dans votre PATH.

Cette option est destinée aux développeurs pour tester le code en lien aux segments. Indique la taille de segment d'une relation en blocs. Si l'option -Dsegsize et celle ci sont affectées, cette option l'emporte.