granicus.if.org Git - postgresql/blob - doc/src/sgml/ref/pg_config-ref.sgml

   1 <!-- doc/src/sgml/ref/pg_config-ref.sgml -->
   2
   3 <refentry id="app-pgconfig">
   4  <indexterm zone="app-pgconfig">
   5   <primary>pg_config</primary>
   6  </indexterm>
   7
   8  <refmeta>
   9   <refentrytitle>pg_config</refentrytitle>
  10   <manvolnum>1</manvolnum>
  11   <refmiscinfo>Application</refmiscinfo>
  12  </refmeta>
  13
  14  <refnamediv>
  15   <refname>pg_config</refname>
  16   <refpurpose>retrieve information about the installed version of <productname>PostgreSQL</></refpurpose>
  17  </refnamediv>
  18
  19  <refsynopsisdiv>
  20   <cmdsynopsis>
  21    <command>pg_config</command>
  22    <arg rep="repeat"><replaceable>option</replaceable></arg>
  23   </cmdsynopsis>
  24  </refsynopsisdiv>
  25
  26  <refsect1>
  27   <title>Description</>
  28   <para>
  29    The <application>pg_config</> utility prints configuration parameters
  30    of the currently installed version of <productname>PostgreSQL</>. It is
  31    intended, for example, to be used by software packages that want to interface
  32    to <productname>PostgreSQL</> to facilitate finding the required header files
  33    and libraries.
  34   </para>
  35  </refsect1>
  36
  37
  38  <refsect1>
  39   <title>Options</title>
  40
  41   <para>
  42    To use <application>pg_config</>, supply one or more of the following
  43    options:
  44    <variablelist>
  45     <varlistentry>
  46      <term><option>--bindir</option></>
  47      <listitem>
  48       <para>
  49        Print the location of user executables. Use this, for example, to find
  50        the <command>psql</> program. This is normally also the location
  51        where the <filename>pg_config</> program resides.
  52       </para>
  53      </listitem>
  54     </varlistentry>
  55
  56     <varlistentry>
  57      <term><option>--docdir</option></>
  58      <listitem>
  59       <para>
  60        Print the location of documentation files.
  61       </para>
  62      </listitem>
  63     </varlistentry>
  64
  65     <varlistentry>
  66      <term><option>--htmldir</option></>
  67      <listitem>
  68       <para>
  69        Print the location of HTML documentation files.
  70       </para>
  71      </listitem>
  72     </varlistentry>
  73
  74     <varlistentry>
  75      <term><option>--includedir</option></>
  76      <listitem>
  77       <para>
  78        Print the location of C header files of the client interfaces.
  79       </para>
  80      </listitem>
  81     </varlistentry>
  82
  83     <varlistentry>
  84      <term><option>--pkgincludedir</option></>
  85      <listitem>
  86       <para>
  87        Print the location of other C header files.
  88       </para>
  89      </listitem>
  90     </varlistentry>
  91
  92     <varlistentry>
  93      <term><option>--includedir-server</option></>
  94      <listitem>
  95       <para>
  96        Print the location of C header files for server programming.
  97       </para>
  98      </listitem>
  99     </varlistentry>
 100
 101     <varlistentry>
 102      <term><option>--libdir</option></>
 103      <listitem>
 104       <para>
 105        Print the location of object code libraries.
 106       </para>
 107      </listitem>
 108     </varlistentry>
 109
 110     <varlistentry>
 111      <term><option>--pkglibdir</option></>
 112      <listitem>
 113       <para>
 114        Print the location of dynamically loadable modules, or where
 115        the server would search for them.  (Other
 116        architecture-dependent data files might also be installed in this
 117        directory.)
 118       </para>
 119      </listitem>
 120     </varlistentry>
 121
 122     <varlistentry>
 123      <term><option>--localedir</option></>
 124      <listitem>
 125       <para>
 126        Print the location of locale support files.  (This will be an empty
 127        string if locale support was not configured when
 128        <productname>PostgreSQL</> was built.)
 129       </para>
 130      </listitem>
 131     </varlistentry>
 132
 133     <varlistentry>
 134      <term><option>--mandir</option></>
 135      <listitem>
 136       <para>
 137        Print the location of manual pages.
 138       </para>
 139      </listitem>
 140     </varlistentry>
 141
 142     <varlistentry>
 143      <term><option>--sharedir</option></>
 144      <listitem>
 145       <para>
 146        Print the location of architecture-independent support files.
 147       </para>
 148      </listitem>
 149     </varlistentry>
 150
 151     <varlistentry>
 152      <term><option>--sysconfdir</option></>
 153      <listitem>
 154       <para>
 155        Print the location of system-wide configuration files.
 156       </para>
 157      </listitem>
 158     </varlistentry>
 159
 160     <varlistentry>
 161      <term><option>--pgxs</option></>
 162      <listitem>
 163       <para>
 164        Print the location of extension makefiles.
 165      </para>
 166      </listitem>
 167     </varlistentry>
 168
 169     <varlistentry>
 170      <term><option>--configure</option></>
 171      <listitem>
 172       <para>
 173        Print the options that were given to the <filename>configure</>
 174        script when <productname>PostgreSQL</> was configured for building.
 175        This can be used to reproduce the identical configuration, or
 176        to find out with what options a binary package was built. (Note
 177        however that binary packages often contain vendor-specific custom
 178        patches.)  See also the examples below.
 179       </para>
 180      </listitem>
 181     </varlistentry>
 182
 183     <varlistentry>
 184      <term><option>--cc</option></>
 185      <listitem>
 186       <para>
 187        Print the value of the <varname>CC</varname> variable that was used for building
 188        <productname>PostgreSQL</>.  This shows the C compiler used.
 189       </para>
 190      </listitem>
 191     </varlistentry>
 192
 193     <varlistentry>
 194      <term><option>--cppflags</option></>
 195      <listitem>
 196       <para>
 197        Print the value of the <varname>CPPFLAGS</varname> variable that was used for building
 198        <productname>PostgreSQL</>.  This shows C compiler switches needed
 199        at preprocessing time (typically, <literal>-I</> switches).
 200       </para>
 201      </listitem>
 202     </varlistentry>
 203
 204     <varlistentry>
 205      <term><option>--cflags</option></>
 206      <listitem>
 207       <para>
 208        Print the value of the <varname>CFLAGS</varname> variable that was used for building
 209        <productname>PostgreSQL</>.  This shows C compiler switches.
 210       </para>
 211      </listitem>
 212     </varlistentry>
 213
 214     <varlistentry>
 215      <term><option>--cflags_sl</option></>
 216      <listitem>
 217       <para>
 218        Print the value of the <varname>CFLAGS_SL</varname> variable that was used for building
 219        <productname>PostgreSQL</>.  This shows extra C compiler switches
 220        used for building shared libraries.
 221       </para>
 222      </listitem>
 223     </varlistentry>
 224
 225     <varlistentry>
 226      <term><option>--ldflags</option></>
 227      <listitem>
 228       <para>
 229        Print the value of the <varname>LDFLAGS</varname> variable that was used for building
 230        <productname>PostgreSQL</>.  This shows linker switches.
 231       </para>
 232      </listitem>
 233     </varlistentry>
 234
 235     <varlistentry>
 236      <term><option>--ldflags_ex</option></>
 237      <listitem>
 238       <para>
 239        Print the value of the <varname>LDFLAGS_EX</varname> variable that was used for building
 240        <productname>PostgreSQL</>.  This shows linker switches
 241        used for building executables only.
 242       </para>
 243      </listitem>
 244     </varlistentry>
 245
 246     <varlistentry>
 247      <term><option>--ldflags_sl</option></>
 248      <listitem>
 249       <para>
 250        Print the value of the <varname>LDFLAGS_SL</varname> variable that was used for building
 251        <productname>PostgreSQL</>.  This shows linker switches
 252        used for building shared libraries only.
 253       </para>
 254      </listitem>
 255     </varlistentry>
 256
 257     <varlistentry>
 258      <term><option>--libs</option></>
 259      <listitem>
 260       <para>
 261        Print the value of the <varname>LIBS</varname> variable that was used for building
 262        <productname>PostgreSQL</>.  This normally contains <literal>-l</>
 263        switches for external libraries linked into <productname>PostgreSQL</>.
 264       </para>
 265      </listitem>
 266     </varlistentry>
 267
 268     <varlistentry>
 269      <term><option>--version</option></>
 270      <listitem>
 271       <para>
 272        Print the version of <productname>PostgreSQL</>.
 273       </para>
 274      </listitem>
 275     </varlistentry>
 276
 277     <varlistentry>
 278      <term><option>-?</></term>
 279      <term><option>--help</></term>
 280       <listitem>
 281        <para>
 282         Show help about <application>pg_config</application> command line
 283         arguments, and exit.
 284        </para>
 285       </listitem>
 286      </varlistentry>
 287    </variablelist>
 288
 289    If more than one option is given, the information is printed in that order,
 290    one item per line.  If no options are given, all available information
 291    is printed, with labels.
 292   </para>
 293  </refsect1>
 294
 295
 296  <refsect1>
 297   <title>Notes</title>
 298
 299   <para>
 300    The options <option>--docdir</option>, <option>--pkgincludedir</option>,
 301    <option>--localedir</option>, <option>--mandir</option>,
 302    <option>--sharedir</option>, <option>--sysconfdir</option>,
 303    <option>--cc</option>, <option>--cppflags</option>,
 304    <option>--cflags</option>, <option>--cflags_sl</option>,
 305    <option>--ldflags</option>, <option>--ldflags_sl</option>,
 306    and <option>--libs</option> were added in <productname>PostgreSQL</> 8.1.
 307    The option <option>--htmldir</option> was added in <productname>PostgreSQL</> 8.4.
 308    The option <option>--ldflags_ex</option> was added in <productname>PostgreSQL</> 9.0.
 309   </para>
 310  </refsect1>
 311
 312
 313  <refsect1>
 314   <title>Example</title>
 315
 316   <para>
 317    To reproduce the build configuration of the current PostgreSQL
 318    installation, run the following command:
 319 <programlisting>
 320 eval ./configure `pg_config --configure`
 321 </programlisting>
 322    The output of <literal>pg_config --configure</literal> contains
 323    shell quotation marks so arguments with spaces are represented
 324    correctly.  Therefore, using <literal>eval</literal> is required
 325    for proper results.
 326   </para>
 327  </refsect1>
 328
 329 </refentry>