Team Ai
Datasetpublic

codekingpro/portable-devtools

sourceHugging Faceupdated 5mo agoView on Hugging Face
1likes15kdownloads
install-meson.html602 linesDownload Raw Back to html
1<?xml version="1.0" encoding="UTF-8" standalone="no"?>2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>17.4. Building and Installation with Meson</title><link rel="stylesheet" type="text/css" href="stylesheet.css" /><link rev="made" href="pgsql-docs@lists.postgresql.org" /><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot" /><link rel="prev" href="install-make.html" title="17.3. Building and Installation with Autoconf and Make" /><link rel="next" href="install-post.html" title="17.5. Post-Installation Setup" /></head><body id="docContent" class="container-fluid col-10"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="5" align="center">17.4. Building and Installation with Meson</th></tr><tr><td width="10%" align="left"><a accesskey="p" href="install-make.html" title="17.3. Building and Installation with Autoconf and Make">Prev</a> </td><td width="10%" align="left"><a accesskey="u" href="installation.html" title="Chapter 17. Installation from Source Code">Up</a></td><th width="60%" align="center">Chapter 17. Installation from Source Code</th><td width="10%" align="right"><a accesskey="h" href="index.html" title="PostgreSQL 16.3 Documentation">Home</a></td><td width="10%" align="right"> <a accesskey="n" href="install-post.html" title="17.5. Post-Installation Setup">Next</a></td></tr></table><hr /></div><div class="sect1" id="INSTALL-MESON"><div class="titlepage"><div><div><h2 class="title" style="clear: both">17.4. Building and Installation with Meson <a href="#INSTALL-MESON" class="id_link">#</a></h2></div></div></div><div class="toc"><dl class="toc"><dt><span class="sect2"><a href="install-meson.html#INSTALL-SHORT-MESON">17.4.1. Short Version</a></span></dt><dt><span class="sect2"><a href="install-meson.html#INSTALL-PROCEDURE-MESON">17.4.2. Installation Procedure</a></span></dt><dt><span class="sect2"><a href="install-meson.html#MESON-OPTIONS">17.4.3. <code class="literal">meson setup</code> Options</a></span></dt></dl></div><div class="sect2" id="INSTALL-SHORT-MESON"><div class="titlepage"><div><div><h3 class="title">17.4.1. Short Version <a href="#INSTALL-SHORT-MESON" class="id_link">#</a></h3></div></div></div><p>3</p><pre class="synopsis">4meson setup build --prefix=/usr/local/pgsql5cd build6ninja7su8ninja install9adduser postgres10mkdir -p /usr/local/pgsql/data11chown postgres /usr/local/pgsql/data12su - postgres13/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data14/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data -l logfile start15/usr/local/pgsql/bin/createdb test16/usr/local/pgsql/bin/psql test17</pre><p>18   The long version is the rest of this19   <span class="phrase">section</span>.20  </p></div><div class="sect2" id="INSTALL-PROCEDURE-MESON"><div class="titlepage"><div><div><h3 class="title">17.4.2. Installation Procedure <a href="#INSTALL-PROCEDURE-MESON" class="id_link">#</a></h3></div></div></div><div class="procedure"><ol class="procedure" type="1"><li class="step" id="MESON-CONFIGURE"><p class="title"><strong>Configuration</strong></p><p>21    The first step of the installation procedure is to configure the22    build tree for your system and choose the options you would like. To23    create and configure the build directory, you can start with the24    <code class="literal">meson setup</code> command.25</p><pre class="screen">26<strong class="userinput"><code>meson setup build</code></strong>27</pre><p>28    The setup command takes a <code class="literal">builddir</code> and a <code class="literal">srcdir</code>29    argument. If no <code class="literal">srcdir</code> is given, Meson will deduce the30    <code class="literal">srcdir</code> based on the current directory and the location31    of <code class="literal">meson.build</code>. The <code class="literal">builddir</code> is mandatory.32   </p><p>33    Running <code class="literal">meson setup</code> loads the build configuration file and sets up the build directory.34    Additionally, you can also pass several build options to Meson. Some commonly35    used options are mentioned in the subsequent sections. For example:36 37</p><pre class="screen">38# configure with a different installation prefix39meson setup build --prefix=/home/user/pg-install40 41# configure to generate a debug build42meson setup build --buildtype=debug43 44# configure to build with OpenSSL support45meson setup build -Dssl=openssl46</pre><p>47   </p><p>48    Setting up the build directory is a one-time step. To reconfigure before a49    new build, you can simply use the <code class="literal">meson configure</code> command50</p><pre class="screen">51meson configure -Dcassert=true52</pre><p>53    <code class="command">meson configure</code>'s commonly used command-line options54    are explained in <a class="xref" href="install-meson.html#MESON-OPTIONS" title="17.4.3. meson setup Options">Section 17.4.3</a>.55   </p></li><li class="step" id="MESON-BUILD"><p class="title"><strong>Build</strong></p><p>56    By default, <span class="productname">Meson</span> uses the <a class="ulink" href="https://ninja-build.org/" target="_top">Ninja</a> build tool.  To build57    <span class="productname">PostgreSQL</span> from source using Meson, you can58    simply use the <code class="literal">ninja</code> command in the build directory.59</p><pre class="screen">60ninja61</pre><p>62    Ninja will automatically detect the number of CPUs in your computer and63    parallelize itself accordingly. You can override the number of parallel64    processes used with the command line argument <code class="literal">-j</code>.65   </p><p>66    It should be noted that after the initial configure step,67    <code class="command">ninja</code> is the only command you ever need to type to68    compile. No matter how you alter your source tree (short of moving it to a69    completely new location), Meson will detect the changes and regenerate70    itself accordingly. This is especially handy if you have multiple build71    directories. Often one of them is used for development (the "debug" build)72    and others only every now and then (such as a "static analysis" build).73    Any configuration can be built just by cd'ing to the corresponding74    directory and running Ninja.75   </p><p>76    If you'd like to build with a backend other than ninja, you can use77    configure with the <code class="option">--backend</code> option to select the one you78    want to use and then build using <code class="literal">meson compile</code>. To79    learn more about these backends and other arguments you can provide to80    ninja, you can refer to the <a class="ulink" href="https://mesonbuild.com/Running-Meson.html#building-from-the-source" target="_top">81    Meson documentation</a>.82   </p></li><li class="step"><p class="title"><strong>Regression Tests</strong></p><a id="id-1.6.4.8.3.2.3.2" class="indexterm"></a><p>83    If you want to test the newly built server before you install it,84    you can run the regression tests at this point. The regression85    tests are a test suite to verify that <span class="productname">PostgreSQL</span>86    runs on your machine in the way the developers expected it87    to. Type:88</p><pre class="screen">89<strong class="userinput"><code>meson test</code></strong>90</pre><p>91    (This won't work as root; do it as an unprivileged user.)92    See <a class="xref" href="regress.html" title="Chapter 33. Regression Tests">Chapter 33</a> for93    detailed information about interpreting the test results. You can94    repeat this test at any later time by issuing the same command.95   </p><p>96    To run pg_regress and pg_isolation_regress tests against a running97    postgres instance, specify <strong class="userinput"><code>--setup running</code></strong> as an98    argument to <strong class="userinput"><code>meson test</code></strong>.99   </p></li><li class="step" id="MESON-INSTALL"><p class="title"><strong>Installing the Files</strong></p><div class="note"><h3 class="title">Note</h3><p>100     If you are upgrading an existing system be sure to read101     <a class="xref" href="upgrading.html" title="19.6. Upgrading a PostgreSQL Cluster">Section 19.6</a>,102     which has instructions about upgrading a103     cluster.104    </p></div><p>105    Once PostgreSQL is built, you can install it by simply running the106    <code class="literal">ninja install</code> command.107</p><pre class="screen">108ninja install109</pre><p>110   </p><p>111    This will install files into the directories that were specified112    in <a class="xref" href="install-meson.html#MESON-CONFIGURE" title="Configuration">Step 1</a>. Make sure that you have appropriate113    permissions to write into that area. You might need to do this114    step as root. Alternatively, you can create the target directories115    in advance and arrange for appropriate permissions to be granted.116    The standard installation provides all the header files needed for client117    application development as well as for server-side program118    development, such as custom functions or data types written in C.119   </p><p>120    <code class="literal">ninja install</code> should work for most cases, but if you'd121    like to use more options (such as <code class="option">--quiet</code> to suppress122    extra output), you could also use <code class="literal">meson install</code>123    instead. You can learn more about <a class="ulink" href="https://mesonbuild.com/Commands.html#install" target="_top">meson install</a>124    and its options in the Meson documentation.125   </p></li></ol></div><p><strong>Uninstallation: </strong>126    To undo the installation, you can use the <code class="command">ninja127    uninstall</code> command.128   </p><p><strong>Cleaning: </strong>129    After the installation, you can free disk space by removing the built130    files from the source tree with the <code class="command">ninja clean</code>131    command.132   </p></div><div class="sect2" id="MESON-OPTIONS"><div class="titlepage"><div><div><h3 class="title">17.4.3. <code class="literal">meson setup</code> Options <a href="#MESON-OPTIONS" class="id_link">#</a></h3></div></div></div><p>133    <code class="command">meson setup</code>'s command-line options are explained below.134    This list is not exhaustive (use <code class="literal">meson configure --help</code>135    to get one that is).  The options not covered here are meant for advanced136    use-cases, and are documented in the standard <a class="ulink" href="https://mesonbuild.com/Commands.html#configure" target="_top">Meson137    documentation</a>.  These arguments can be used with <code class="command">meson138    setup</code> as well.139   </p><div class="sect3" id="MESON-OPTIONS-LOCATIONS"><div class="titlepage"><div><div><h4 class="title">17.4.3.1. Installation Locations <a href="#MESON-OPTIONS-LOCATIONS" class="id_link">#</a></h4></div></div></div><p>140      These options control where <code class="literal">ninja install</code> (or <code class="literal">meson install</code>) will put141      the files.  The <code class="option">--prefix</code> option (example142      <a class="xref" href="install-meson.html#INSTALL-SHORT-MESON" title="17.4.1. Short Version">Section 17.4.1</a>) is sufficient for143      most cases.  If you have special needs, you can customize the144      installation subdirectories with the other options described in this145      section.  Beware however that changing the relative locations of the146      different subdirectories may render the installation non-relocatable,147      meaning you won't be able to move it after installation.148      (The <code class="literal">man</code> and <code class="literal">doc</code> locations are149      not affected by this restriction.)  For relocatable installs, you150      might want to use the <code class="literal">-Drpath=false</code> option151      described later.152     </p><div class="variablelist"><dl class="variablelist"><dt id="CONFIGURE-PREFIX-MESON"><span class="term"><code class="option">--prefix=<em class="replaceable"><code>PREFIX</code></em></code></span> <a href="#CONFIGURE-PREFIX-MESON" class="id_link">#</a></dt><dd><p>153         Install all files under the directory <em class="replaceable"><code>PREFIX</code></em>154         instead of <code class="filename">/usr/local/pgsql</code> (on Unix based systems) or155         <code class="filename"><em class="replaceable"><code>current drive letter</code></em>:/usr/local/pgsql</code> (on Windows).156         The actual files will be installed into various subdirectories; no files157         will ever be installed directly into the158         <em class="replaceable"><code>PREFIX</code></em> directory.159        </p></dd><dt id="CONFIGURE-BINDIR-MESON"><span class="term"><code class="option">--bindir=<em class="replaceable"><code>DIRECTORY</code></em></code></span> <a href="#CONFIGURE-BINDIR-MESON" class="id_link">#</a></dt><dd><p>160         Specifies the directory for executable programs. The default161         is <code class="filename"><em class="replaceable"><code>PREFIX</code></em>/bin</code>.162        </p></dd><dt id="CONFIGURE-SYSCONFDIR-MESON"><span class="term"><code class="option">--sysconfdir=<em class="replaceable"><code>DIRECTORY</code></em></code></span> <a href="#CONFIGURE-SYSCONFDIR-MESON" class="id_link">#</a></dt><dd><p>163         Sets the directory for various configuration files,164         <code class="filename"><em class="replaceable"><code>PREFIX</code></em>/etc</code> by default.165        </p></dd><dt id="CONFIGURE-LIBDIR-MESON"><span class="term"><code class="option">--libdir=<em class="replaceable"><code>DIRECTORY</code></em></code></span> <a href="#CONFIGURE-LIBDIR-MESON" class="id_link">#</a></dt><dd><p>166         Sets the location to install libraries and dynamically loadable167         modules. The default is168         <code class="filename"><em class="replaceable"><code>PREFIX</code></em>/lib</code>.169        </p></dd><dt id="CONFIGURE-INCLUDEDIR-MESON"><span class="term"><code class="option">--includedir=<em class="replaceable"><code>DIRECTORY</code></em></code></span> <a href="#CONFIGURE-INCLUDEDIR-MESON" class="id_link">#</a></dt><dd><p>170         Sets the directory for installing C and C++ header files. The171         default is <code class="filename"><em class="replaceable"><code>PREFIX</code></em>/include</code>.172        </p></dd><dt id="CONFIGURE-DATADIR-MESON"><span class="term"><code class="option">--datadir=<em class="replaceable"><code>DIRECTORY</code></em></code></span> <a href="#CONFIGURE-DATADIR-MESON" class="id_link">#</a></dt><dd><p>173         Sets the directory for read-only data files used by the174         installed programs. The default is175         <code class="filename"><em class="replaceable"><code>PREFIX</code></em>/share</code>. Note that this has176         nothing to do with where your database files will be placed.177        </p></dd><dt id="CONFIGURE-LOCALEDIR-MESON"><span class="term"><code class="option">--localedir=<em class="replaceable"><code>DIRECTORY</code></em></code></span> <a href="#CONFIGURE-LOCALEDIR-MESON" class="id_link">#</a></dt><dd><p>178         Sets the directory for installing locale data, in particular179         message translation catalog files.  The default is180         <code class="filename"><em class="replaceable"><code>DATADIR</code></em>/locale</code>.181        </p></dd><dt id="CONFIGURE-MANDIR-MESON"><span class="term"><code class="option">--mandir=<em class="replaceable"><code>DIRECTORY</code></em></code></span> <a href="#CONFIGURE-MANDIR-MESON" class="id_link">#</a></dt><dd><p>182         The man pages that come with <span class="productname">PostgreSQL</span> will be installed under183         this directory, in their respective184         <code class="filename">man<em class="replaceable"><code>x</code></em></code> subdirectories.185         The default is <code class="filename"><em class="replaceable"><code>DATADIR</code></em>/man</code>.186        </p></dd></dl></div><div class="note"><h3 class="title">Note</h3><p>187       Care has been taken to make it possible to install188       <span class="productname">PostgreSQL</span> into shared installation locations189       (such as <code class="filename">/usr/local/include</code>) without190       interfering with the namespace of the rest of the system. First,191       the string <span class="quote">“<span class="quote"><code class="literal">/postgresql</code></span>”</span> is192       automatically appended to <code class="varname">datadir</code>,193       <code class="varname">sysconfdir</code>, and <code class="varname">docdir</code>,194       unless the fully expanded directory name already contains the195       string <span class="quote">“<span class="quote"><code class="literal">postgres</code></span>”</span> or196       <span class="quote">“<span class="quote"><code class="literal">pgsql</code></span>”</span>. For example, if you choose197       <code class="filename">/usr/local</code> as prefix, the documentation will198       be installed in <code class="filename">/usr/local/doc/postgresql</code>,199       but if the prefix is <code class="filename">/opt/postgres</code>, then it200       will be in <code class="filename">/opt/postgres/doc</code>. The public C201       header files of the client interfaces are installed into202       <code class="varname">includedir</code> and are namespace-clean. The203       internal header files and the server header files are installed204       into private directories under <code class="varname">includedir</code>. See205       the documentation of each interface for information about how to206       access its header files. Finally, a private subdirectory will207       also be created, if appropriate, under <code class="varname">libdir</code>208       for dynamically loadable modules.209      </p></div></div><div class="sect3" id="MESON-OPTIONS-FEATURES"><div class="titlepage"><div><div><h4 class="title">17.4.3.2. <span class="productname">PostgreSQL</span> Features <a href="#MESON-OPTIONS-FEATURES" class="id_link">#</a></h4></div></div></div><p>210     The options described in this section enable building of211     various optional <span class="productname">PostgreSQL</span> features.212     Most of these require additional software, as described in213     <a class="xref" href="install-requirements.html" title="17.1. Requirements">Section 17.1</a>, and will be automatically enabled if the214     required software is found. You can change this behavior by manually215     setting these features to <code class="literal">enabled</code> to require them216     or <code class="literal">disabled</code> to not build with them.217    </p><p>218     To specify PostgreSQL-specific options, the name of the option219     must be prefixed by <code class="literal">-D</code>.220    </p><div class="variablelist"><dl class="variablelist"><dt id="CONFIGURE-WITH-NLS-MESON"><span class="term"><code class="option">-Dnls={ auto | enabled | disabled }</code></span> <a href="#CONFIGURE-WITH-NLS-MESON" class="id_link">#</a></dt><dd><p>221        Enables or disables Native Language Support (<acronym class="acronym">NLS</acronym>),222        that is, the ability to display a program's messages in a language223        other than English.  Defaults to auto and will be enabled224        automatically if an implementation of the <span class="application">Gettext225        API</span> is found.226       </p></dd><dt id="CONFIGURE-WITH-PLPERL-MESON"><span class="term"><code class="option">-Dplperl={ auto | enabled | disabled }</code></span> <a href="#CONFIGURE-WITH-PLPERL-MESON" class="id_link">#</a></dt><dd><p>227        Build the <span class="application">PL/Perl</span> server-side language.228        Defaults to auto.229       </p></dd><dt id="CONFIGURE-WITH-PLPYTHON-MESON"><span class="term"><code class="option">-Dplpython={ auto | enabled | disabled }</code></span> <a href="#CONFIGURE-WITH-PLPYTHON-MESON" class="id_link">#</a></dt><dd><p>230        Build the <span class="application">PL/Python</span> server-side language.231        Defaults to auto.232       </p></dd><dt id="CONFIGURE-WITH-PLTCL-MESON"><span class="term"><code class="option">-Dpltcl={ auto | enabled | disabled }</code></span> <a href="#CONFIGURE-WITH-PLTCL-MESON" class="id_link">#</a></dt><dd><p>233        Build the <span class="application">PL/Tcl</span> server-side language.234        Defaults to auto.235       </p></dd><dt id="CONFIGURE-WITH-TCL-VERSION-MESON"><span class="term"><code class="option">-Dtcl_version=<em class="replaceable"><code>TCL_VERSION</code></em></code></span> <a href="#CONFIGURE-WITH-TCL-VERSION-MESON" class="id_link">#</a></dt><dd><p>236        Specifies the Tcl version to use when building PL/Tcl.237       </p></dd><dt id="CONFIGURE-WITH-ICU-MESON"><span class="term"><code class="option">-Dicu={ auto | enabled | disabled }</code></span> <a href="#CONFIGURE-WITH-ICU-MESON" class="id_link">#</a></dt><dd><p>238        Build with support for the239        <span class="productname">ICU</span><a id="id-1.6.4.8.4.4.4.6.2.1.2" class="indexterm"></a>240        library, enabling use of ICU collation features<span class="phrase"> (see <a class="xref" href="collation.html" title="24.2. Collation Support">Section 24.2</a>)</span>.  Defaults to auto and requires the241        <span class="productname">ICU4C</span> package to be installed.  The minimum242        required version of <span class="productname">ICU4C</span> is currently 4.2.243       </p></dd><dt id="CONFIGURE-WITH-LLVM-MESON"><span class="term"><code class="option">-Dllvm={ auto | enabled | disabled }</code></span> <a href="#CONFIGURE-WITH-LLVM-MESON" class="id_link">#</a></dt><dd><p>244        Build with support for <span class="productname">LLVM</span> based245        <acronym class="acronym">JIT</acronym> compilation<span class="phrase"> (see <a class="xref" href="jit.html" title="Chapter 32. Just-in-Time Compilation (JIT)">Chapter 32</a>)</span>.246        This requires the <span class="productname">LLVM</span> library to be247        installed.  The minimum required version of248        <span class="productname">LLVM</span> is currently 3.9.  Disabled by249        default.250       </p><p>251        <code class="command">llvm-config</code><a id="id-1.6.4.8.4.4.4.7.2.2.2" class="indexterm"></a>252        will be used to find the required compilation options.253        <code class="command">llvm-config</code>, and then254        <code class="command">llvm-config-$version</code> for all supported versions,255        will be searched for in your <code class="envar">PATH</code>.  If that would not256        yield the desired program, use <code class="envar">LLVM_CONFIG</code> to specify a257        path to the correct <code class="command">llvm-config</code>.258       </p></dd><dt id="CONFIGURE-WITH-LZ4-MESON"><span class="term"><code class="option">-Dlz4={ auto | enabled | disabled }</code></span> <a href="#CONFIGURE-WITH-LZ4-MESON" class="id_link">#</a></dt><dd><p>259        Build with <span class="productname">LZ4</span> compression support.260        Defaults to auto.261       </p></dd><dt id="CONFIGURE-WITH-ZSTD-MESON"><span class="term"><code class="option">-Dzstd={ auto | enabled | disabled }</code></span> <a href="#CONFIGURE-WITH-ZSTD-MESON" class="id_link">#</a></dt><dd><p>262        Build with <span class="productname">Zstandard</span> compression support.263        Defaults to auto.264       </p></dd><dt id="CONFIGURE-WITH-SSL-MESON"><span class="term"><code class="option">-Dssl={ auto | <em class="replaceable"><code>LIBRARY</code></em> }</code>265      <a id="id-1.6.4.8.4.4.4.10.1.2" class="indexterm"></a>266      </span> <a href="#CONFIGURE-WITH-SSL-MESON" class="id_link">#</a></dt><dd><p>267        Build with support for <acronym class="acronym">SSL</acronym> (encrypted) connections.268        The only <em class="replaceable"><code>LIBRARY</code></em> supported is269        <code class="option">openssl</code>. This requires the270        <span class="productname">OpenSSL</span> package to be installed.  Building271        with this will check for the required header files and libraries to272        make sure that your <span class="productname">OpenSSL</span> installation is273        sufficient before proceeding.  The default for this option is auto.274       </p></dd><dt id="CONFIGURE-WITH-GSSAPI-MESON"><span class="term"><code class="option">-Dgssapi={ auto | enabled | disabled }</code></span> <a href="#CONFIGURE-WITH-GSSAPI-MESON" class="id_link">#</a></dt><dd><p>275        Build with support for GSSAPI authentication. MIT Kerberos is required276        to be installed for GSSAPI.  On many systems, the GSSAPI system (a part277        of the MIT Kerberos installation) is not installed in a location278        that is searched by default (e.g., <code class="filename">/usr/include</code>,279        <code class="filename">/usr/lib</code>).  In280        those cases, PostgreSQL will query <code class="command">pkg-config</code> to281        detect the required compiler and linker options.  Defaults to auto.282        <code class="filename">meson configure</code> will check for the required283        header files and libraries to make sure that your GSSAPI installation284        is sufficient before proceeding.285       </p></dd><dt id="CONFIGURE-WITH-LDAP-MESON"><span class="term"><code class="option">-Dldap={ auto | enabled | disabled }</code></span> <a href="#CONFIGURE-WITH-LDAP-MESON" class="id_link">#</a></dt><dd><p>286        Build with287        <acronym class="acronym">LDAP</acronym><a id="id-1.6.4.8.4.4.4.12.2.1.2" class="indexterm"></a>288        support for authentication and connection parameter lookup (see289        <span id="INSTALL-LDAP-LINKS-MESON" class="phrase"><a class="xref" href="libpq-ldap.html" title="34.18. LDAP Lookup of Connection Parameters">Section 34.18</a> and290        <a class="xref" href="auth-ldap.html" title="21.10. LDAP Authentication">Section 21.10</a></span> for more information).  On Unix,291        this requires the <span class="productname">OpenLDAP</span> package to be292        installed. On Windows, the default <span class="productname">WinLDAP</span>293        library is used.  Defaults to auto.  <code class="filename">meson294        configure</code> will check for the required header files and295        libraries to make sure that your <span class="productname">OpenLDAP</span>296        installation is sufficient before proceeding.297       </p></dd><dt id="CONFIGURE-WITH-PAM-MESON"><span class="term"><code class="option">-Dpam={ auto | enabled | disabled }</code></span> <a href="#CONFIGURE-WITH-PAM-MESON" class="id_link">#</a></dt><dd><p>298        Build with299        <acronym class="acronym">PAM</acronym><a id="id-1.6.4.8.4.4.4.13.2.1.2" class="indexterm"></a>300        (Pluggable Authentication Modules) support.  Defaults to auto.301       </p></dd><dt id="CONFIGURE-WITH-BSD-AUTH-MESON"><span class="term"><code class="option">-Dbsd_auth={ auto | enabled | disabled }</code></span> <a href="#CONFIGURE-WITH-BSD-AUTH-MESON" class="id_link">#</a></dt><dd><p>302        Build with BSD Authentication support.  (The BSD Authentication303        framework is currently only available on OpenBSD.)  Defaults to auto.304       </p></dd><dt id="CONFIGURE-WITH-SYSTEMD-MESON"><span class="term"><code class="option">-Dsystemd={ auto | enabled | disabled }</code></span> <a href="#CONFIGURE-WITH-SYSTEMD-MESON" class="id_link">#</a></dt><dd><p>305        Build with support for306        <span class="application">systemd</span><a id="id-1.6.4.8.4.4.4.15.2.1.2" class="indexterm"></a>307        service notifications.  This improves integration if the server is308        started under <span class="application">systemd</span> but has no impact309        otherwise<span class="phrase">; see <a class="xref" href="server-start.html" title="19.3. Starting the Database Server">Section 19.3</a> for more information</span>.  Defaults to310        auto.  <span class="application">libsystemd</span> and the associated header311        files need to be installed to use this option.312       </p></dd><dt id="CONFIGURE-WITH-BONJOUR-MESON"><span class="term"><code class="option">-Dbonjour={ auto | enabled | disabled }</code></span> <a href="#CONFIGURE-WITH-BONJOUR-MESON" class="id_link">#</a></dt><dd><p>313        Build with support for Bonjour automatic service discovery.  Defaults314        to auto and requires Bonjour support in your operating system.315        Recommended on macOS.316       </p></dd><dt id="CONFIGURE-WITH-UUID-MESON"><span class="term"><code class="option">-Duuid=<em class="replaceable"><code>LIBRARY</code></em></code></span> <a href="#CONFIGURE-WITH-UUID-MESON" class="id_link">#</a></dt><dd><p>317        Build the <a class="xref" href="uuid-ossp.html" title="F.49. uuid-ossp — a UUID generator">uuid-ossp</a> module318        (which provides functions to generate UUIDs), using the specified319        UUID library.<a id="id-1.6.4.8.4.4.4.17.2.1.2" class="indexterm"></a>320        <em class="replaceable"><code>LIBRARY</code></em> must be one of:321       </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>322          <code class="option">none</code> to not build the uuid module. This is the default.323         </p></li><li class="listitem"><p>324          <code class="option">bsd</code> to use the UUID functions found in FreeBSD,325          and some other BSD-derived systems326         </p></li><li class="listitem"><p>327          <code class="option">e2fs</code> to use the UUID library created by328          the <code class="literal">e2fsprogs</code> project; this library is present in most329          Linux systems and in macOS, and can be obtained for other330          platforms as well331         </p></li><li class="listitem"><p>332          <code class="option">ossp</code> to use the <a class="ulink" href="http://www.ossp.org/pkg/lib/uuid/" target="_top">OSSP UUID library</a>333         </p></li></ul></div></dd><dt id="CONFIGURE-WITH-LIBXML-MESON"><span class="term"><code class="option">-Dlibxml={ auto | enabled | disabled }</code></span> <a href="#CONFIGURE-WITH-LIBXML-MESON" class="id_link">#</a></dt><dd><p>334        Build with libxml2, enabling SQL/XML support.  Defaults to335        auto. Libxml2 version 2.6.23 or later is required for this feature.336       </p><p>337        To use a libxml2 installation that is in an unusual location, you338        can set <code class="command">pkg-config</code>-related environment339        variables (see its documentation).340       </p></dd><dt id="CONFIGURE-WITH-LIBXSLT-MESON"><span class="term"><code class="option">-Dlibxslt={ auto | enabled | disabled }</code></span> <a href="#CONFIGURE-WITH-LIBXSLT-MESON" class="id_link">#</a></dt><dd><p>341        Build with libxslt, enabling the342        <a class="xref" href="xml2.html" title="F.50. xml2 — XPath querying and XSLT functionality">xml2</a>343        module to perform XSL transformations of XML.344        <code class="option">-Dlibxml</code> must be specified as well.  Defaults to345        auto.346       </p></dd></dl></div></div><div class="sect3" id="MESON-OPTIONS-ANTI-FEATURES"><div class="titlepage"><div><div><h4 class="title">17.4.3.3. Anti-Features <a href="#MESON-OPTIONS-ANTI-FEATURES" class="id_link">#</a></h4></div></div></div><div class="variablelist"><dl class="variablelist"><dt id="CONFIGURE-READLINE-MESON"><span class="term"><code class="option">-Dreadline={ auto | enabled | disabled }</code></span> <a href="#CONFIGURE-READLINE-MESON" class="id_link">#</a></dt><dd><p>347        Allows use of the <span class="application">Readline</span> library (and348        <span class="application">libedit</span> as well).  This option defaults to349        auto and enables command-line editing and history in350        <span class="application">psql</span> and is strongly recommended.351       </p></dd><dt id="CONFIGURE-LIBEDIT-PREFERRED-MESON"><span class="term"><code class="option">-Dlibedit_preferred={ true | false }</code></span> <a href="#CONFIGURE-LIBEDIT-PREFERRED-MESON" class="id_link">#</a></dt><dd><p>352        Setting this to true favors the use of the BSD-licensed353        <span class="application">libedit</span> library rather than GPL-licensed354        <span class="application">Readline</span>.  This option is significant only355        if you have both libraries installed; the default is false, that is to356        use <span class="application">Readline</span>.357       </p></dd><dt id="CONFIGURE-ZLIB-MESON"><span class="term"><code class="option">-Dzlib={ auto | enabled | disabled }</code></span> <a href="#CONFIGURE-ZLIB-MESON" class="id_link">#</a></dt><dd><p>358        <a id="id-1.6.4.8.4.5.2.3.2.1.1" class="indexterm"></a>359        Enables use of the <span class="application">Zlib</span> library.360        It defaults to auto and enables361        support for compressed archives in <span class="application">pg_dump</span>,362        <span class="application">pg_restore</span> and <span class="application">pg_basebackup</span> and is recommended.363       </p></dd><dt id="CONFIGURE-SPINLOCKS-MESON"><span class="term"><code class="option">-Dspinlocks={ true | false }</code></span> <a href="#CONFIGURE-SPINLOCKS-MESON" class="id_link">#</a></dt><dd><p>364        This option is set to true by default; setting it to false will365        allow the build to succeed even if <span class="productname">PostgreSQL</span>366        has no CPU spinlock support for the platform.  The lack of367        spinlock support will result in very poor performance; therefore,368        this option should only be changed if the build aborts and369        informs you that the platform lacks spinlock support. If setting this370        option to false is required to build <span class="productname">PostgreSQL</span> on371        your platform, please report the problem to the372        <span class="productname">PostgreSQL</span> developers.373       </p></dd><dt id="CONFIGURE-ATOMICS-MESON"><span class="term"><code class="option">-Datomics={ true | false }</code></span> <a href="#CONFIGURE-ATOMICS-MESON" class="id_link">#</a></dt><dd><p>374        This option is set to true by default; setting it to false will375        disable use of CPU atomic operations.  The option does nothing on376        platforms that lack such operations.  On platforms that do have377        them, disabling atomics will result in poor performance.  Changing378        this option is only useful for debugging or making performance comparisons.379       </p></dd></dl></div></div><div class="sect3" id="MESON-OPTIONS-BUILD-PROCESS"><div class="titlepage"><div><div><h4 class="title">17.4.3.4. Build Process Details <a href="#MESON-OPTIONS-BUILD-PROCESS" class="id_link">#</a></h4></div></div></div><div class="variablelist"><dl class="variablelist"><dt id="CONFIGURE-AUTO-FEATURES-MESON"><span class="term"><code class="option">--auto_features={ auto | enabled | disabled }</code></span> <a href="#CONFIGURE-AUTO-FEATURES-MESON" class="id_link">#</a></dt><dd><p>380        Setting this option allows you to override the value of all381        <span class="quote">“<span class="quote">auto</span>”</span> features (features that are enabled automatically382        if the required software is found).  This can be useful when you want383        to disable or enable all the <span class="quote">“<span class="quote">optional</span>”</span> features at once384        without having to set each of them manually. The default value for385        this parameter is auto.386       </p></dd><dt id="CONFIGURE-BACKEND-MESON"><span class="term"><code class="option">--backend=<em class="replaceable"><code>BACKEND</code></em></code></span> <a href="#CONFIGURE-BACKEND-MESON" class="id_link">#</a></dt><dd><p>387        The default backend Meson uses is ninja and that should suffice for388        most use cases.  However, if you'd like to fully integrate with Visual389        Studio, you can set the <code class="option">BACKEND</code> to390        <code class="command">vs</code>.391       </p></dd><dt id="CONFIGURE-C-ARGS-MESON"><span class="term"><code class="option">-Dc_args=<em class="replaceable"><code>OPTIONS</code></em></code></span> <a href="#CONFIGURE-C-ARGS-MESON" class="id_link">#</a></dt><dd><p>392        This option can be used to pass extra options to the C compiler.393       </p></dd><dt id="CONFIGURE-C-LINK-ARGS-MESON"><span class="term"><code class="option">-Dc_link_args=<em class="replaceable"><code>OPTIONS</code></em></code></span> <a href="#CONFIGURE-C-LINK-ARGS-MESON" class="id_link">#</a></dt><dd><p>394        This option can be used to pass extra options to the C linker.395       </p></dd><dt id="CONFIGURE-EXTRA-INCLUDE-DIRS-MESON"><span class="term"><code class="option">-Dextra_include_dirs=<em class="replaceable"><code>DIRECTORIES</code></em></code></span> <a href="#CONFIGURE-EXTRA-INCLUDE-DIRS-MESON" class="id_link">#</a></dt><dd><p>396        <em class="replaceable"><code>DIRECTORIES</code></em> is a comma-separated list of397        directories that will be added to the list the compiler searches for398        header files. If you have optional packages (such as GNU399        <span class="application">Readline</span>) installed in a non-standard400        location, you have to use this option and probably also the401        corresponding <code class="option">-Dextra_lib_dirs</code> option.402       </p><p>403        Example: <code class="literal">-Dextra_include_dirs=/opt/gnu/include,/usr/sup/include</code>.404       </p></dd><dt id="CONFIGURE-EXTRA-LIB-DIRS-MESON"><span class="term"><code class="option">-Dextra_lib_dirs=<em class="replaceable"><code>DIRECTORIES</code></em></code></span> <a href="#CONFIGURE-EXTRA-LIB-DIRS-MESON" class="id_link">#</a></dt><dd><p>405        <em class="replaceable"><code>DIRECTORIES</code></em> is a comma-separated list of406        directories to search for libraries. You will probably have to use407        this option (and the corresponding408        <code class="option">-Dextra_include_dirs</code> option) if you have packages409        installed in non-standard locations.410       </p><p>411        Example: <code class="literal">-Dextra_lib_dirs=/opt/gnu/lib,/usr/sup/lib</code>.412       </p></dd><dt id="CONFIGURE-SYSTEM-TZDATA-MESON"><span class="term"><code class="option">-Dsystem_tzdata=<em class="replaceable"><code>DIRECTORY</code></em></code>413      <a id="id-1.6.4.8.4.6.2.7.1.2" class="indexterm"></a>414      </span> <a href="#CONFIGURE-SYSTEM-TZDATA-MESON" class="id_link">#</a></dt><dd><p>415        <span class="productname">PostgreSQL</span> includes its own time zone416        database, which it requires for date and time operations.  This time417        zone database is in fact compatible with the IANA time zone database418        provided by many operating systems such as FreeBSD, Linux, and419        Solaris, so it would be redundant to install it again.  When this420        option is used, the system-supplied time zone database in421        <em class="replaceable"><code>DIRECTORY</code></em> is used instead of the one422        included in the PostgreSQL source distribution.423        <em class="replaceable"><code>DIRECTORY</code></em> must be specified as an absolute424        path.  <code class="filename">/usr/share/zoneinfo</code> is a likely directory425        on some operating systems.  Note that the installation routine will426        not detect mismatching or erroneous time zone data.  If you use this427        option, you are advised to run the regression tests to verify that the428        time zone data you have pointed to works correctly with429        <span class="productname">PostgreSQL</span>.430       </p><a id="id-1.6.4.8.4.6.2.7.2.2" class="indexterm"></a><p>431        This option is mainly aimed at binary package distributors who know432        their target operating system well.  The main advantage of using this433        option is that the PostgreSQL package won't need to be upgraded434        whenever any of the many local daylight-saving time rules change.435        Another advantage is that PostgreSQL can be cross-compiled more436        straightforwardly if the time zone database files do not need to be437        built during the installation.438       </p></dd><dt id="CONFIGURE-EXTRA-VERSION-MESON"><span class="term"><code class="option">-Dextra_version=<em class="replaceable"><code>STRING</code></em></code></span> <a href="#CONFIGURE-EXTRA-VERSION-MESON" class="id_link">#</a></dt><dd><p>439        Append <em class="replaceable"><code>STRING</code></em> to the PostgreSQL version440        number.  You can use this, for example, to mark binaries built from441        unreleased <span class="productname">Git</span> snapshots or containing442        custom patches with an extra version string, such as a <code class="command">git443        describe</code> identifier or a distribution package release444        number.445       </p></dd><dt id="CONFIGURE-RPATH-MESON"><span class="term"><code class="option">-Drpath={ true | false }</code></span> <a href="#CONFIGURE-RPATH-MESON" class="id_link">#</a></dt><dd><p>446        This option is set to true by default.  If set to false,447        do not mark <span class="productname">PostgreSQL</span>'s executables448        to indicate that they should search for shared libraries in the449        installation's library directory (see <code class="option">--libdir</code>).450        On most platforms, this marking uses an absolute path to the451        library directory, so that it will be unhelpful if you relocate452        the installation later.  However, you will then need to provide453        some other way for the executables to find the shared libraries.454        Typically this requires configuring the operating system's455        dynamic linker to search the library directory; see456        <a class="xref" href="install-post.html#INSTALL-POST-SHLIBS" title="17.5.1. Shared Libraries">Section 17.5.1</a> for more detail.457       </p></dd><dt id="CONFIGURE-BINARY-NAME-MESON"><span class="term"><code class="option">-D<em class="replaceable"><code>BINARY_NAME</code></em>=<em class="replaceable"><code>PATH</code></em></code></span> <a href="#CONFIGURE-BINARY-NAME-MESON" class="id_link">#</a></dt><dd><p>458        If a program required to build PostgreSQL (with or without optional459        flags) is stored at a non-standard path, you can specify it manually460        to <code class="literal">meson configure</code>.  The complete list of programs461        for which this is supported can be found by running <code class="literal">meson462        configure</code>.  Example:463</p><pre class="programlisting">meson configure -DBISON=PATH_TO_BISON</pre><p>464       </p></dd></dl></div></div><div class="sect3" id="MESON-OPTIONS-DOCS"><div class="titlepage"><div><div><h4 class="title">17.4.3.5. Documentation <a href="#MESON-OPTIONS-DOCS" class="id_link">#</a></h4></div></div></div><p>465     See <a class="xref" href="docguide-toolsets.html" title="J.2. Tool Sets">Section J.2</a> for the tools needed for building466     the documentation.467    </p><div class="variablelist"><dl class="variablelist"><dt id="CONFIGURE-DOCS-MESON"><span class="term"><code class="option">-Ddocs={ auto | enabled | disabled }</code></span> <a href="#CONFIGURE-DOCS-MESON" class="id_link">#</a></dt><dd><p>468        Enables building the documentation in <acronym class="acronym">HTML</acronym> and469        <acronym class="acronym">man</acronym> format. It defaults to auto.470       </p></dd><dt id="CONFIGURE-DOCS-PDF-MESON"><span class="term"><code class="option">-Ddocs_pdf={ auto | enabled | disabled }</code></span> <a href="#CONFIGURE-DOCS-PDF-MESON" class="id_link">#</a></dt><dd><p>471        Enables building the documentation in <acronym class="acronym">PDF</acronym>472        format. It defaults to auto.473       </p></dd><dt id="CONFIGURE-DOCS-HTML-STYLE"><span class="term"><code class="option">-Ddocs_html_style={ simple | website }</code></span> <a href="#CONFIGURE-DOCS-HTML-STYLE" class="id_link">#</a></dt><dd><p>474        Controls which <acronym class="acronym">CSS</acronym> stylesheet is used.  The default475        is <code class="literal">simple</code>.  If set to <code class="literal">website</code>,476        the HTML documentation will reference the stylesheet for <a class="ulink" href="https://www.postgresql.org/docs/current/" target="_top">postgresql.org</a>.477       </p></dd></dl></div></div><div class="sect3" id="MESON-OPTIONS-MISC"><div class="titlepage"><div><div><h4 class="title">17.4.3.6. Miscellaneous <a href="#MESON-OPTIONS-MISC" class="id_link">#</a></h4></div></div></div><div class="variablelist"><dl class="variablelist"><dt id="CONFIGURE-PGPORT-MESON"><span class="term"><code class="option">-Dpgport=<em class="replaceable"><code>NUMBER</code></em></code></span> <a href="#CONFIGURE-PGPORT-MESON" class="id_link">#</a></dt><dd><p>478        Set <em class="replaceable"><code>NUMBER</code></em> as the default port number for479        server and clients. The default is 5432. The port can always480        be changed later on, but if you specify it here then both481        server and clients will have the same default compiled in,482        which can be very convenient.  Usually the only good reason483        to select a non-default value is if you intend to run multiple484        <span class="productname">PostgreSQL</span> servers on the same machine.485       </p></dd><dt id="CONFIGURE-KRB-SRVNAM-MESON"><span class="term"><code class="option">-Dkrb_srvnam=<em class="replaceable"><code>NAME</code></em></code></span> <a href="#CONFIGURE-KRB-SRVNAM-MESON" class="id_link">#</a></dt><dd><p>486        The default name of the Kerberos service principal used487        by GSSAPI.488        <code class="literal">postgres</code> is the default. There's usually no489        reason to change this unless you are building for a Windows490        environment, in which case it must be set to upper case491        <code class="literal">POSTGRES</code>.492       </p></dd><dt id="CONFIGURE-SEGSIZE-MESON"><span class="term"><code class="option">-Dsegsize=<em class="replaceable"><code>SEGSIZE</code></em></code></span> <a href="#CONFIGURE-SEGSIZE-MESON" class="id_link">#</a></dt><dd><p>493        Set the <em class="firstterm">segment size</em>, in gigabytes.  Large tables are494        divided into multiple operating-system files, each of size equal495        to the segment size.  This avoids problems with file size limits496        that exist on many platforms.  The default segment size, 1 gigabyte,497        is safe on all supported platforms.  If your operating system has498        <span class="quote">“<span class="quote">largefile</span>”</span> support (which most do, nowadays), you can use499        a larger segment size.  This can be helpful to reduce the number of500        file descriptors consumed when working with very large tables.501        But be careful not to select a value larger than is supported502        by your platform and the file systems you intend to use.  Other503        tools you might wish to use, such as <span class="application">tar</span>, could504        also set limits on the usable file size.505        It is recommended, though not absolutely required, that this value506        be a power of 2.507       </p></dd><dt id="CONFIGURE-BLOCKSIZE-MESON"><span class="term"><code class="option">-Dblocksize=<em class="replaceable"><code>BLOCKSIZE</code></em></code></span> <a href="#CONFIGURE-BLOCKSIZE-MESON" class="id_link">#</a></dt><dd><p>508        Set the <em class="firstterm">block size</em>, in kilobytes.  This is the unit509        of storage and I/O within tables.  The default, 8 kilobytes,510        is suitable for most situations; but other values may be useful511        in special cases.512        The value must be a power of 2 between 1 and 32 (kilobytes).513       </p></dd><dt id="CONFIGURE-WAL-BLOCKSIZE-MESON"><span class="term"><code class="option">-Dwal_blocksize=<em class="replaceable"><code>BLOCKSIZE</code></em></code></span> <a href="#CONFIGURE-WAL-BLOCKSIZE-MESON" class="id_link">#</a></dt><dd><p>514        Set the <em class="firstterm">WAL block size</em>, in kilobytes.  This is the unit515        of storage and I/O within the WAL log.  The default, 8 kilobytes,516        is suitable for most situations; but other values may be useful517        in special cases.518        The value must be a power of 2 between 1 and 64 (kilobytes).519       </p></dd></dl></div></div><div class="sect3" id="MESON-OPTIONS-DEVEL"><div class="titlepage"><div><div><h4 class="title">17.4.3.7. Developer Options <a href="#MESON-OPTIONS-DEVEL" class="id_link">#</a></h4></div></div></div><p>520     Most of the options in this section are only of interest for521     developing or debugging <span class="productname">PostgreSQL</span>.522     They are not recommended for production builds, except523     for <code class="option">--debug</code>, which can be useful to enable524     detailed bug reports in the unlucky event that you encounter a bug.525     On platforms supporting DTrace, <code class="option">-Ddtrace</code>526     may also be reasonable to use in production.527    </p><p>528     When building an installation that will be used to develop code inside529     the server, it is recommended to use at least the <code class="option">--buildtype=debug</code>530     and <code class="option">-Dcassert</code> options.531    </p><div class="variablelist"><dl class="variablelist"><dt id="CONFIGURE-BUILDTYPE-MESON"><span class="term"><code class="option">--buildtype=<em class="replaceable"><code>BUILDTYPE</code></em></code></span> <a href="#CONFIGURE-BUILDTYPE-MESON" class="id_link">#</a></dt><dd><p>532        This option can be used to specify the buildtype to use; defaults to533        <code class="option">debugoptimized</code>.  If you'd like finer control on the debug534        symbols and optimization levels than what this option provides, you535        can refer to the <code class="option">--debug</code> and536        <code class="option">--optimization</code> flags.537       </p><p>538        The following build types are generally used: <code class="option">plain</code>,539        <code class="option">debug</code>, <code class="option">debugoptimized</code> and540        <code class="option">release</code>.  More information about them can be found in541        the <a class="ulink" href="https://mesonbuild.com/Running-Meson.html#configuring-the-build-directory" target="_top">Meson542        documentation</a>.543       </p></dd><dt id="CONFIGURE-DEBUG-MESON"><span class="term"><code class="option">--debug</code></span> <a href="#CONFIGURE-DEBUG-MESON" class="id_link">#</a></dt><dd><p>544        Compiles all programs and libraries with debugging symbols.  This545        means that you can run the programs in a debugger to analyze546        problems. This enlarges the size of the installed executables547        considerably, and on non-GCC compilers it usually also disables548        compiler optimization, causing slowdowns. However, having the symbols549        available is extremely helpful for dealing with any problems that550        might arise.  Currently, this option is recommended for production551        installations only if you use GCC.  But you should always have it on552        if you are doing development work or running a beta version.553       </p></dd><dt id="CONFIGURE-OPTIMIZATION-MESON"><span class="term"><code class="option">--optimization</code>=<em class="replaceable"><code>LEVEL</code></em></span> <a href="#CONFIGURE-OPTIMIZATION-MESON" class="id_link">#</a></dt><dd><p>554        Specify the optimization level. <code class="option">LEVEL</code> can be set to any of {0,g,1,2,3,s}.555       </p></dd><dt id="CONFIGURE-WERROR-MESON"><span class="term"><code class="option">--werror</code></span> <a href="#CONFIGURE-WERROR-MESON" class="id_link">#</a></dt><dd><p>556        Setting this option asks the compiler to treat warnings as557        errors. This can be useful for code development.558       </p></dd><dt id="CONFIGURE-CASSERT-MESON"><span class="term"><code class="option">-Dcassert={ true | false }</code></span> <a href="#CONFIGURE-CASSERT-MESON" class="id_link">#</a></dt><dd><p>559        Enables <em class="firstterm">assertion</em> checks in the server, which560        test for many <span class="quote">“<span class="quote">cannot happen</span>”</span> conditions.  This is561        invaluable for code development purposes, but the tests slow down the562        server significantly.  Also, having the tests turned on won't563        necessarily enhance the stability of your server!  The assertion564        checks are not categorized for severity, and so what might be a565        relatively harmless bug will still lead to server restarts if it566        triggers an assertion failure.  This option is not recommended for567        production use, but you should have it on for development work or when568        running a beta version.569       </p></dd><dt id="CONFIGURE-TAP-TESTS-MESON"><span class="term"><code class="option">-Dtap_tests={ auto | enabled | disabled }</code></span> <a href="#CONFIGURE-TAP-TESTS-MESON" class="id_link">#</a></dt><dd><p>570        Enable tests using the Perl TAP tools.  Defaults to auto and requires571        a Perl installation and the Perl module <code class="literal">IPC::Run</code>.572        <span class="phrase">See <a class="xref" href="regress-tap.html" title="33.4. TAP Tests">Section 33.4</a> for more information.</span>573       </p></dd><dt id="CONFIGURE-PG-TEST-EXTRA-MESON"><span class="term"><code class="option">-DPG_TEST_EXTRA=<em class="replaceable"><code>TEST_SUITES</code></em></code></span> <a href="#CONFIGURE-PG-TEST-EXTRA-MESON" class="id_link">#</a></dt><dd><p>574        Enable test suites which require special software to run.  This option575        accepts arguments via a whitespace-separated list.  See <a class="xref" href="regress-run.html#REGRESS-ADDITIONAL" title="33.1.3. Additional Test Suites">Section 33.1.3</a> for details.576       </p></dd><dt id="CONFIGURE-B-COVERAGE-MESON"><span class="term"><code class="option">-Db_coverage={ true | false }</code></span> <a href="#CONFIGURE-B-COVERAGE-MESON" class="id_link">#</a></dt><dd><p>577        If using GCC, all programs and libraries are compiled with578        code coverage testing instrumentation.  When run, they579        generate files in the build directory with code coverage580        metrics.581        <span class="phrase">See <a class="xref" href="regress-coverage.html" title="33.5. Test Coverage Examination">Section 33.5</a>582        for more information.</span> This option is for use only with GCC583        and when doing development work.584       </p></dd><dt id="CONFIGURE-DTRACE-MESON"><span class="term"><code class="option">-Ddtrace={ auto | enabled | disabled }</code></span> <a href="#CONFIGURE-DTRACE-MESON" class="id_link">#</a></dt><dd><p>585        <a id="id-1.6.4.8.4.9.4.9.2.1.1" class="indexterm"></a>586        Enabling this compiles <span class="productname">PostgreSQL</span> with support for the587        dynamic tracing tool DTrace.588        <span class="phrase">See <a class="xref" href="dynamic-trace.html" title="28.5. Dynamic Tracing">Section 28.5</a>589        for more information.</span>590       </p><p>591        To point to the <code class="command">dtrace</code> program, the592        <code class="option">DTRACE</code> option can be set.  This593        will often be necessary because <code class="command">dtrace</code> is594        typically installed under <code class="filename">/usr/sbin</code>,595        which might not be in your <code class="envar">PATH</code>.596       </p></dd><dt id="CONFIGURE-SEGSIZE-BLOCKS-MESON"><span class="term"><code class="option">-Dsegsize_blocks=SEGSIZE_BLOCKS</code></span> <a href="#CONFIGURE-SEGSIZE-BLOCKS-MESON" class="id_link">#</a></dt><dd><p>597         Specify the relation segment size in blocks. If both598         <code class="option">-Dsegsize</code> and this option are specified, this option599         wins.600 601         This option is only for developers, to test segment related code.602        </p></dd></dl></div></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="install-make.html" title="17.3. Building and Installation with Autoconf and Make">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="installation.html" title="Chapter 17. Installation from Source Code">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="install-post.html" title="17.5. Post-Installation Setup">Next</a></td></tr><tr><td width="40%" align="left" valign="top">17.3. Building and Installation with Autoconf and Make </td><td width="20%" align="center"><a accesskey="h" href="index.html" title="PostgreSQL 16.3 Documentation">Home</a></td><td width="40%" align="right" valign="top"> 17.5. Post-Installation Setup</td></tr></table></div></body></html>
codekingpro/portable-devtools · Team Ai