codekingpro/portable-devtools
115k
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>