aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTom Lane <tgl@sss.pgh.pa.us>2011-12-02 11:33:53 -0500
committerTom Lane <tgl@sss.pgh.pa.us>2011-12-02 11:33:53 -0500
commit0de93a9c69a13073ed27c8d53f8c83663d3561fd (patch)
tree49e6fefe08864770ee015f7d27eae4a8b08c882a
parent1e616f639156b2431725f7823c999486ca46c1ea (diff)
downloadpostgresql-0de93a9c69a13073ed27c8d53f8c83663d3561fd.tar.gz
postgresql-0de93a9c69a13073ed27c8d53f8c83663d3561fd.zip
Add some weasel wording about threaded usage of PGresults.
PGresults used to be read-only from the application's viewpoint, but now that we've exposed various functions that allow modification of a PGresult, that sweeping statement is no longer accurate. Noted by Dmitriy Igrishin.
-rw-r--r--doc/src/sgml/libpq.sgml8
1 files changed, 6 insertions, 2 deletions
diff --git a/doc/src/sgml/libpq.sgml b/doc/src/sgml/libpq.sgml
index 252ff8cc855..d48cafa4de6 100644
--- a/doc/src/sgml/libpq.sgml
+++ b/doc/src/sgml/libpq.sgml
@@ -7197,8 +7197,12 @@ int PQisthreadsafe();
</para>
<para>
- <structname>PGresult</> objects are read-only after creation, and so
- can be passed around freely between threads.
+ <structname>PGresult</> objects are normally read-only after creation,
+ and so can be passed around freely between threads. However, if you use
+ any of the <structname>PGresult</>-modifying functions described in
+ <xref linkend="libpq-misc"> or <xref linkend="libpq-events">, it's up
+ to you to avoid concurrent operations on the same <structname>PGresult</>,
+ too.
</para>
<para>