Attached is the doc patch for the recent DTrace changes
http://archives.postgresql.org/pgsql-committers/2008-03/msg00316.php
Regards,
-Robert
Index: doc/src/sgml/installation.sgml
===
RCS file: /projects/cvsroot/pgsql/doc/src/sgml/installation.sgml,v
retrieving revision 1.304
diff -u -3 -p -r1.304 installation.sgml
--- doc/src/sgml/installation.sgml 10 Mar 2008 20:06:27 - 1.304
+++ doc/src/sgml/installation.sgml 25 Mar 2008 20:25:37 -
@@ -1192,9 +1192,9 @@ su - postgres
indexterm
primaryDTrace/primary
/indexterm
- Compiles with support for the dynamic tracing tool DTrace.
- Operating system support for DTrace is currently only
- available in Solaris.
+ Compiles with support for the dynamic tracing tool called DTrace.
+ Operating system support for DTrace is currently
+ available in Solaris and Mac OS X Leopard.
/para
para
Index: doc/src/sgml/monitoring.sgml
===
RCS file: /projects/cvsroot/pgsql/doc/src/sgml/monitoring.sgml,v
retrieving revision 1.55
diff -u -3 -p -r1.55 monitoring.sgml
--- doc/src/sgml/monitoring.sgml 28 Nov 2007 15:42:31 - 1.55
+++ doc/src/sgml/monitoring.sgml 25 Mar 2008 20:25:38 -
@@ -947,26 +947,26 @@ SELECT pg_stat_get_backend_pid(s.backend
/para
para
- A number of trace points, often called probes, are already inserted
- into the source code. By default these probes are disabled, and
- the user needs to explicitly tell the configure script to make the
- probes available in productnamePostgreSQL/productname.
+ A number of probes or trace points are already inserted
+ into the source code. By default these probes are not compiled into the
+ binary, and the user needs to explicitly tell the configure script to make
+ the probes available in productnamePostgreSQL/productname.
/para
para
- Currently, only the DTrace utility is supported, which is only available
- on Solaris Express and Solaris 10+. It is expected that DTrace will
- be available in the future on FreeBSD and Mac OS X.
+ Currently, only the DTrace utility is supported, which is available
+ on Solaris Express, Solaris 10, and Mac OS X Leopard. It is expected that
+ DTrace will be available in the future on FreeBSD.
Supporting other dynamic tracing utilities is theoretically possible by
- changing the definitions for the literalPG_TRACE/ macros in
- filenamesrc/include/pg_trace.h/.
+ changing the definitions for the macros in
+ filenamesrc/include/utils/probes.h/.
/para
sect2 id=compiling-for-trace
titleCompiling for Dynamic Tracing/title
para
- By default, trace points are disabled, so you will need to
+ By default, probes are not available, so you will need to
explicitly tell the configure script to make the probes available
in productnamePostgreSQL/productname. To include DTrace support
specify option--enable-dtrace/ to configure. See xref
@@ -975,16 +975,16 @@ SELECT pg_stat_get_backend_pid(s.backend
/sect2
sect2 id=trace-points
- titleBuilt-in Trace Points/title
+ titleBuilt-in Probes/title
para
- A few standard trace points are provided in the source code
+ A few standard probes are provided in the source code
(of course, more can be added as needed for a particular problem).
These are shown in xref linkend=trace-point-table.
/para
table id=trace-point-table
- titleBuilt-in Trace Points/title
+ titleBuilt-in Probes/title
tgroup cols=3
thead
row
@@ -996,67 +996,67 @@ SELECT pg_stat_get_backend_pid(s.backend
tbody
row
- entrytransaction__start/entry
+ entrytransaction-start/entry
entry(int transactionId)/entry
entryThe start of a new transaction./entry
/row
row
- entrytransaction__commit/entry
+ entrytransaction-commit/entry
entry(int transactionId)/entry
entryThe successful completion of a transaction./entry
/row
row
- entrytransaction__abort/entry
+ entrytransaction-abort/entry
entry(int transactionId)/entry
entryThe unsuccessful completion of a transaction./entry
/row
row
- entrylwlock__acquire/entry
+ entrylwlock-acquire/entry
entry(int lockid, int mode)/entry
entryAn LWLock has been acquired./entry
/row
row
- entrylwlock__release/entry
+ entrylwlock-release/entry
entry(int lockid, int mode)/entry
entryAn LWLock has been released./entry
/row
row
- entrylwlock__startwait/entry
+ entrylwlock-startwait/entry
entry(int lockid, int mode)/entry
entryAn LWLock was not immediately available and a backend
has begun to wait for the lock to become available.
/entry
/row
row
- entrylwlock__endwait/entry
+