which is thread-safe on all platforms.
</para>
-<para>
-<application>libpq</application> must ignore <literal>SIGPIPE</> signals
-generated internally by <function>send()</> calls to backend processes.
-When <productname>PostgreSQL</> is configured without
-<literal>--enable-thread-safety</>, <application>libpq</> sets
-<literal>SIGPIPE</> to <literal>SIG_IGN</> before each
-<function>send()</> call and restores the original signal handler after
-completion. When <literal>--enable-thread-safety</> is used,
-<application>libpq</> installs its own <literal>SIGPIPE</> handler
-before the first database connection. This handler uses thread-local
-storage to determine if a <literal>SIGPIPE</> signal has been generated
-by a libpq <function>send()</>. If an application wants to install
-its own <literal>SIGPIPE</> signal handler, it should call
-<function>PQinSend()</> to determine if it should ignore the
-<literal>SIGPIPE</> signal. This function is available in both
-thread-safe and non-thread-safe versions of <application>libpq</>.
-</para>
-
<para>
If you experience problems with threaded applications, run
the program in <filename>src/tools/thread</> to see if your
static SSL_CTX *SSL_context = NULL;
#endif
-#ifdef ENABLE_THREAD_SAFETY
-static void sigpipe_handler_ignore_send(int signo);
-pthread_key_t pq_thread_in_send = 0; /* initializer needed on Darwin */
-static pqsigfunc pq_pipe_handler;
-#endif
-
/* ------------------------------------------------------------ */
/* Hardcoded values */
/* ------------------------------------------------------------ */
pqsecure_write(PGconn *conn, const void *ptr, size_t len)
{
ssize_t n;
-
+
#ifdef ENABLE_THREAD_SAFETY
- pthread_setspecific(pq_thread_in_send, "t");
+ sigset_t osigmask;
+ bool sigpipe_pending;
+
+ pq_block_sigpipe(&osigmask, &sigpipe_pending);
#else
#ifndef WIN32
pqsigfunc oldsighandler = pqsignal(SIGPIPE, SIG_IGN);
else
#endif
n = send(conn->sock, ptr, len, 0);
+ /*
+ * Possible optimization: if sigpending() turns out to be an
+ * expensive operation, we can set sigpipe_pending = 'true'
+ * here if errno != EPIPE, avoiding a sigpending call.
+ */
#ifdef ENABLE_THREAD_SAFETY
- pthread_setspecific(pq_thread_in_send, "f");
+ pq_reset_sigpipe(&osigmask, sigpipe_pending);
#else
#ifndef WIN32
pqsignal(SIGPIPE, oldsighandler);
}
#endif /* USE_SSL */
-
#ifdef ENABLE_THREAD_SAFETY
-#ifndef WIN32
/*
- * Check SIGPIPE handler and perhaps install our own.
+ * Block SIGPIPE for this thread. This prevents send()/write() from exiting
+ * the application.
*/
-void
-pq_check_sigpipe_handler(void)
-{
- pthread_key_create(&pq_thread_in_send, NULL);
-
- /*
- * Find current pipe handler and chain on to it.
- */
- pq_pipe_handler = pqsignalinquire(SIGPIPE);
- pqsignal(SIGPIPE, sigpipe_handler_ignore_send);
-}
-
-/*
- * Threaded SIGPIPE signal handler
- */
-void
-sigpipe_handler_ignore_send(int signo)
+int
+pq_block_sigpipe(sigset_t *osigset, bool *sigpipe_pending)
{
- /*
- * If we have gotten a SIGPIPE outside send(), chain or exit if we are
- * at the end of the chain. Synchronous signals are delivered to the
- * thread that caused the signal.
- */
- if (!PQinSend())
+ sigset_t sigpipe_sigset;
+ sigset_t sigset;
+ int ret;
+
+ sigemptyset(&sigpipe_sigset);
+ sigaddset(&sigpipe_sigset, SIGPIPE);
+
+ /* Block SIGPIPE and save previous mask for later reset */
+ ret = pthread_sigmask(SIG_BLOCK, &sigpipe_sigset, osigset);
+
+ /* We can have a pending SIGPIPE only if it was blocked before */
+ if (sigismember(osigset, SIGPIPE))
{
- if (pq_pipe_handler == SIG_DFL) /* not set by application */
- exit(128 + SIGPIPE); /* typical return value for SIG_DFL */
+ /* Is there a pending SIGPIPE? */
+ if (sigpending(&sigset) != 0)
+ return -1;
+
+ if (sigismember(&sigset, SIGPIPE))
+ *sigpipe_pending = true;
else
- (*pq_pipe_handler) (signo); /* call original handler */
+ *sigpipe_pending = false;
}
+ else
+ *sigpipe_pending = false;
+
+ return ret;
}
-#endif
-#endif
-
+
/*
- * Indicates whether the current thread is in send()
- * For use by SIGPIPE signal handlers; they should
- * ignore SIGPIPE when libpq is in send(). This means
- * that the backend has died unexpectedly.
+ * Discard any pending SIGPIPE and reset the signal mask.
+ * We might be discarding a blocked SIGPIPE that we didn't generate,
+ * but we document that you can't keep blocked SIGPIPE calls across
+ * libpq function calls.
*/
-pqbool
-PQinSend(void)
+int
+pq_reset_sigpipe(sigset_t *osigset, bool sigpipe_pending)
{
-#ifdef ENABLE_THREAD_SAFETY
- return (pthread_getspecific(pq_thread_in_send) /* has it been set? */ &&
- *(char *) pthread_getspecific(pq_thread_in_send) == 't') ? true : false;
-#else
+ int signo;
+ sigset_t sigset;
- /*
- * No threading: our code ignores SIGPIPE around send(). Therefore, we
- * can't be in send() if we are checking from a SIGPIPE signal
- * handler.
- */
- return false;
-#endif
+ /* Clear SIGPIPE only if none was pending */
+ if (!sigpipe_pending)
+ {
+ if (sigpending(&sigset) != 0)
+ return -1;
+
+ /*
+ * Discard pending and blocked SIGPIPE
+ */
+ if (sigismember(&sigset, SIGPIPE))
+ {
+ sigset_t sigpipe_sigset;
+
+ sigemptyset(&sigpipe_sigset);
+ sigaddset(&sigpipe_sigset, SIGPIPE);
+
+ sigwait(&sigpipe_sigset, &signo);
+ if (signo != SIGPIPE)
+ return -1;
+ }
+ }
+
+ /* Restore saved block mask */
+ return pthread_sigmask(SIG_SETMASK, osigset, NULL);
}
+#endif