]> granicus.if.org Git - postgresql/commitdiff
Add some weasel wording about threaded usage of PGresults.
authorTom Lane <tgl@sss.pgh.pa.us>
Fri, 2 Dec 2011 16:33:53 +0000 (11:33 -0500)
committerTom Lane <tgl@sss.pgh.pa.us>
Fri, 2 Dec 2011 16:34:20 +0000 (11:34 -0500)
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.

doc/src/sgml/libpq.sgml

index 318cb554efe1a6cbd2622713a28897137de16784..c3a914280334cd5d3371980c071341fbd1dc7795 100644 (file)
@@ -6938,8 +6938,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>