aboutsummaryrefslogtreecommitdiff
path: root/doc/src
diff options
context:
space:
mode:
authorPeter Eisentraut <peter_e@gmx.net>2006-08-17 17:25:43 +0000
committerPeter Eisentraut <peter_e@gmx.net>2006-08-17 17:25:43 +0000
commitbb764e94ce98c01924879288bd14e76e7c913128 (patch)
treecd3011a3550c7fbe60e5f12983732bbcc0bbbe49 /doc/src
parent92c651f8b3e8972a0f203dbdcbffaddf342fc5df (diff)
downloadpostgresql-bb764e94ce98c01924879288bd14e76e7c913128.tar.gz
postgresql-bb764e94ce98c01924879288bd14e76e7c913128.zip
Produce a clean failure in configure when dtrace is selected but cannot be
found. Besides stopping those early who have no dtrace installed whatsoever, this will also alert those who have dtrace in /usr/sbin, which might not be in the path, which would produce confusing failures much later in the build process. Add documentation about pointing configure to find dtrace.
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/sgml/installation.sgml35
1 files changed, 34 insertions, 1 deletions
diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml
index e7ed9b4d5ca..0769901f248 100644
--- a/doc/src/sgml/installation.sgml
+++ b/doc/src/sgml/installation.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/installation.sgml,v 1.259 2006/07/24 16:32:44 petere Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/installation.sgml,v 1.260 2006/08/17 17:25:43 petere Exp $ -->
<chapter id="installation">
<title><![%standalone-include[<productname>PostgreSQL</>]]>
@@ -1011,10 +1011,24 @@ su - postgres
<term><option>--enable-dtrace</option></term>
<listitem>
<para>
+ <indexterm>
+ <primary>DTrace</primary>
+ </indexterm>
Compiles with support for the dynamic tracing tool DTrace.
Operating system support for DTrace is currently only
available in Solaris.
</para>
+
+ <para>
+ To point to the <command>dtrace</command> program, the
+ environment variable <envar>DTRACE</envar> can be set. This
+ will often be necessary because <command>dtrace</command> is
+ typically installed under <filename>/usr/sbin</filename>,
+ which might not be in the path. Additional command-line
+ options for the <command>dtrace</command> program can be
+ specified in the environment variable
+ <envar>DTRACEFLAGS</envar>.
+ </para>
</listitem>
</varlistentry>
@@ -1114,6 +1128,25 @@ su - postgres
</varlistentry>
<varlistentry>
+ <term><option>DTRACE=<replaceable>/path/to/dtrace</></option></term>
+ <listitem>
+ <para>
+ Specifies the location of the <command>dtrace</command> program.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>DTRACEFLAGS=<replaceable>FLAGS</></option></term>
+ <listitem>
+ <para>
+ <replaceable>FLAGS</> is the a list of flags to pass to the
+ <command>dtrace</command> program.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>JADE</option></term>
<listitem>
<para>