1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>Behavior in Threaded Programs</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REV="MADE"
HREF="mailto:pgsql-docs@postgresql.org"><LINK
REL="HOME"
TITLE="PostgreSQL 9.1.8 Documentation"
HREF="index.html"><LINK
REL="UP"
TITLE="libpq - C Library"
HREF="libpq.html"><LINK
REL="PREVIOUS"
TITLE="SSL Support"
HREF="libpq-ssl.html"><LINK
REL="NEXT"
TITLE="Building libpq Programs"
HREF="libpq-build.html"><LINK
REL="STYLESHEET"
TYPE="text/css"
HREF="stylesheet.css"><META
HTTP-EQUIV="Content-Type"
CONTENT="text/html; charset=ISO-8859-1"><META
NAME="creation"
CONTENT="2013-02-04T21:38:53"></HEAD
><BODY
CLASS="SECT1"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="5"
ALIGN="center"
VALIGN="bottom"
><A
HREF="index.html"
>PostgreSQL 9.1.8 Documentation</A
></TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="top"
><A
TITLE="SSL Support"
HREF="libpq-ssl.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="top"
><A
HREF="libpq.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="60%"
ALIGN="center"
VALIGN="bottom"
>Chapter 31. <SPAN
CLASS="APPLICATION"
>libpq</SPAN
> - C Library</TD
><TD
WIDTH="20%"
ALIGN="right"
VALIGN="top"
><A
TITLE="Building libpq Programs"
HREF="libpq-build.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="LIBPQ-THREADING"
>31.18. Behavior in Threaded Programs</A
></H1
><P
> <SPAN
CLASS="APPLICATION"
>libpq</SPAN
> is reentrant and thread-safe by default.
You might need to use special compiler command-line
options when you compile your application code. Refer to your
system's documentation for information about how to build
thread-enabled applications, or look in
<TT
CLASS="FILENAME"
>src/Makefile.global</TT
> for <TT
CLASS="LITERAL"
>PTHREAD_CFLAGS</TT
>
and <TT
CLASS="LITERAL"
>PTHREAD_LIBS</TT
>. This function allows the querying of
<SPAN
CLASS="APPLICATION"
>libpq</SPAN
>'s thread-safe status:
</P
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><A
NAME="LIBPQ-PQISTHREADSAFE"
></A
><CODE
CLASS="FUNCTION"
>PQisthreadsafe</CODE
>
</DT
><DD
><P
> Returns the thread safety status of the
<SPAN
CLASS="APPLICATION"
>libpq</SPAN
> library.
</P><PRE
CLASS="SYNOPSIS"
>int PQisthreadsafe();</PRE
><P>
</P
><P
> Returns 1 if the <SPAN
CLASS="APPLICATION"
>libpq</SPAN
> is thread-safe
and 0 if it is not.
</P
></DD
></DL
></DIV
><P
> One thread restriction is that no two threads attempt to manipulate
the same <TT
CLASS="STRUCTNAME"
>PGconn</TT
> 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,
use multiple connections.)
</P
><P
> <TT
CLASS="STRUCTNAME"
>PGresult</TT
> objects are normally read-only after creation,
and so can be passed around freely between threads. However, if you use
any of the <TT
CLASS="STRUCTNAME"
>PGresult</TT
>-modifying functions described in
<A
HREF="libpq-misc.html"
>Section 31.10</A
> or <A
HREF="libpq-events.html"
>Section 31.12</A
>, it's up
to you to avoid concurrent operations on the same <TT
CLASS="STRUCTNAME"
>PGresult</TT
>,
too.
</P
><P
> The deprecated functions <CODE
CLASS="FUNCTION"
>PQrequestCancel</CODE
> and
<CODE
CLASS="FUNCTION"
>PQoidStatus</CODE
> are not thread-safe and should not be
used in multithread programs. <CODE
CLASS="FUNCTION"
>PQrequestCancel</CODE
>
can be replaced by <CODE
CLASS="FUNCTION"
>PQcancel</CODE
>.
<CODE
CLASS="FUNCTION"
>PQoidStatus</CODE
> can be replaced by
<CODE
CLASS="FUNCTION"
>PQoidValue</CODE
>.
</P
><P
> If you are using Kerberos inside your application (in addition to inside
<SPAN
CLASS="APPLICATION"
>libpq</SPAN
>), you will need to do locking around
Kerberos calls because Kerberos functions are not thread-safe. See
function <CODE
CLASS="FUNCTION"
>PQregisterThreadLock</CODE
> in the
<SPAN
CLASS="APPLICATION"
>libpq</SPAN
> source code for a way to do cooperative
locking between <SPAN
CLASS="APPLICATION"
>libpq</SPAN
> and your application.
</P
><P
> If you experience problems with threaded applications, run the program
in <TT
CLASS="FILENAME"
>src/tools/thread</TT
> to see if your platform has
thread-unsafe functions. This program is run by
<TT
CLASS="FILENAME"
>configure</TT
>, but for binary distributions your
library might not match the library used to build the binaries.
</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="libpq-ssl.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="libpq-build.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>SSL Support</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="libpq.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Building <SPAN
CLASS="APPLICATION"
>libpq</SPAN
> Programs</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
|