summaryrefslogtreecommitdiff
path: root/doc/src
diff options
context:
space:
mode:
authorBruce Momjian2003-06-13 23:10:08 +0000
committerBruce Momjian2003-06-13 23:10:08 +0000
commit02d847fe9f86b0c6ff4658eb9d49fbb98c8fa69a (patch)
treecafe975dd792471ada4a62b2c6dfd7abcf40a69d /doc/src
parent26188e8c1751a2ef97fb6192fbc1bbc9f313a4d6 (diff)
Add --with-threads configure option to control threaded libpq.
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/sgml/installation.sgml11
-rw-r--r--doc/src/sgml/libpq.sgml29
2 files changed, 25 insertions, 15 deletions
diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml
index 16051998392..4c7a0a35176 100644
--- a/doc/src/sgml/installation.sgml
+++ b/doc/src/sgml/installation.sgml
@@ -1,4 +1,4 @@
-<!-- $Header: /cvsroot/pgsql/doc/src/sgml/installation.sgml,v 1.133 2003/06/11 06:56:06 momjian Exp $ -->
+<!-- $Header: /cvsroot/pgsql/doc/src/sgml/installation.sgml,v 1.134 2003/06/13 23:10:07 momjian Exp $ -->
<chapter id="installation">
<title><![%standalone-include[<productname>PostgreSQL</>]]>
@@ -915,6 +915,15 @@ JAVACMD=$JAVA_HOME/bin/java
</varlistentry>
<varlistentry>
+ <term><option>--with-threads</option></term>
+ <listitem>
+ <para>
+ Allow separate libpq threads to safely control their private connection handles.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>--without-zlib</option></term>
<listitem>
<para>
diff --git a/doc/src/sgml/libpq.sgml b/doc/src/sgml/libpq.sgml
index 9bbf060c76e..88217d45063 100644
--- a/doc/src/sgml/libpq.sgml
+++ b/doc/src/sgml/libpq.sgml
@@ -1,5 +1,5 @@
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/libpq.sgml,v 1.123 2003/05/14 03:25:58 tgl Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/libpq.sgml,v 1.124 2003/06/13 23:10:07 momjian Exp $
-->
<chapter id="libpq">
@@ -509,11 +509,6 @@ typedef struct
is leaked for each call to <function>PQconndefaults</function>.
</para>
- <para>
- In <productname>PostgreSQL</productname> versions before 7.0, <function>PQconndefaults</function> returned a pointer
- to a static array, rather than a dynamically allocated array. That
- was not thread-safe, so the behavior has been changed.
- </para>
</listitem>
</varlistentry>
@@ -2549,17 +2544,23 @@ If the permissions are less strict than this, the file will be ignored.
</indexterm>
<para>
-<application>libpq</application> is thread-safe as of
-<productname>PostgreSQL</productname> 7.0, so long as no two threads
-attempt to manipulate the same <structname>PGconn</> object at the same
-time. In particular, you cannot issue concurrent commands from different
-threads through the same connection object. (If you need to run
-concurrent commands, start up multiple connections.)
+<application>libpq</application> is thread-safe if the library is
+compiled using the <literal>--with-threads</>
+<filename>configure</filename> command-line option. (You might need to
+use other threading command-line options to compile your client code.)
+</para>
+
+<para>
+One restriction is that no two threads attempt to manipulate the same
+<structname>PGconn</> object at the same time. In particular, you cannot
+issue concurrent commands from different threads through the same
+connection object. (If you need to run concurrent commands, start up
+multiple connections.)
</para>
<para>
-<structname>PGresult</> objects are read-only after creation, and so can be passed around
-freely between threads.
+<structname>PGresult</> objects are read-only after creation, and so can be
+passed around freely between threads.
</para>
<para>