thread_safety.html.en revision 5effc8b39fae5cd169d17f342bfc265705840014
59879db9d12c2ea10f77b2c44d6d3aba89bb9cb3slive<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
59879db9d12c2ea10f77b2c44d6d3aba89bb9cb3slive<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
59879db9d12c2ea10f77b2c44d6d3aba89bb9cb3slive XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
59879db9d12c2ea10f77b2c44d6d3aba89bb9cb3slive This file is generated from xml source: DO NOT EDIT
59879db9d12c2ea10f77b2c44d6d3aba89bb9cb3slive XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
5a58787efeb02a1c3f06569d019ad81fd2efa06end<title>Apache 2.0 Thread Safety Issues - Apache HTTP Server</title>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
5a58787efeb02a1c3f06569d019ad81fd2efa06end<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
5a58787efeb02a1c3f06569d019ad81fd2efa06end<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
5a58787efeb02a1c3f06569d019ad81fd2efa06end<link href="/images/favicon.ico" rel="shortcut icon" /></head>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.5</a> > <a href="./">Developer Documentation</a></div><div id="page-content"><div id="preamble"><h1>Apache 2.0 Thread Safety Issues</h1>
5652dbe450e4fcfdf36d4cfb42d7f2345ded29a4maczniak<p><span>Available Languages: </span><a href="/en/developer/thread_safety.html" title="English"> en </a></p>
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd <p>When using any of the threaded mpms in Apache 2.0 it is important
59879db9d12c2ea10f77b2c44d6d3aba89bb9cb3slive that every function called from Apache be thread safe. When linking in 3rd
59879db9d12c2ea10f77b2c44d6d3aba89bb9cb3slive party extensions it can be difficult to determine whether the resulting
59879db9d12c2ea10f77b2c44d6d3aba89bb9cb3slive server will be thread safe. Casual testing generally won't tell you this
59879db9d12c2ea10f77b2c44d6d3aba89bb9cb3slive either as thread safety problems can lead to subtle race conditons that
7449c2bb2dd95f8d0dd1b3ede8b56a0e26cc0fa6nd may only show up in certain conditions under heavy load.</p>
7449c2bb2dd95f8d0dd1b3ede8b56a0e26cc0fa6nd<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#variables">Global and static variables</a></li>
7449c2bb2dd95f8d0dd1b3ede8b56a0e26cc0fa6nd<li><img alt="" src="/images/down.gif" /> <a href="#errno">errno</a></li>
7449c2bb2dd95f8d0dd1b3ede8b56a0e26cc0fa6nd<li><img alt="" src="/images/down.gif" /> <a href="#functions">Common standard troublesome functions</a></li>
7449c2bb2dd95f8d0dd1b3ede8b56a0e26cc0fa6nd<li><img alt="" src="/images/down.gif" /> <a href="#commonlibs">Common 3rd Party Libraries</a></li>
7449c2bb2dd95f8d0dd1b3ede8b56a0e26cc0fa6nd<li><img alt="" src="/images/down.gif" /> <a href="#liblist">Library List</a></li>
59879db9d12c2ea10f77b2c44d6d3aba89bb9cb3slive<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
59879db9d12c2ea10f77b2c44d6d3aba89bb9cb3slive<h2><a name="variables" id="variables">Global and static variables</a></h2>
59879db9d12c2ea10f77b2c44d6d3aba89bb9cb3slive <p>When writing your module or when trying to determine if a module or
59879db9d12c2ea10f77b2c44d6d3aba89bb9cb3slive 3rd party library is thread safe there are some common things to keep in
59879db9d12c2ea10f77b2c44d6d3aba89bb9cb3slive <p>First, you need to recognize that in a threaded model each individual
59879db9d12c2ea10f77b2c44d6d3aba89bb9cb3slive thread has its own program counter, stack and registers. Local variables
59879db9d12c2ea10f77b2c44d6d3aba89bb9cb3slive live on the stack, so those are fine. You need to watch out for any
59879db9d12c2ea10f77b2c44d6d3aba89bb9cb3slive static or global variables. This doesn't mean that you are absolutely not
59879db9d12c2ea10f77b2c44d6d3aba89bb9cb3slive allowed to use static or global variables. There are times when you
59879db9d12c2ea10f77b2c44d6d3aba89bb9cb3slive actually want something to affect all threads, but generally you need to
59879db9d12c2ea10f77b2c44d6d3aba89bb9cb3slive avoid using them if you want your code to be thread safe.</p>
59879db9d12c2ea10f77b2c44d6d3aba89bb9cb3slive <p>In the case where you have a global variable that needs to be global and
0a5e1567f7fa7f5706c68d09f744673c6cb99b33nd accessed by all threads, be very careful when you update it. If, for
0a5e1567f7fa7f5706c68d09f744673c6cb99b33nd example, it is an incrementing counter, you need to atomically increment
ae08254467d40ebbf0830ca618b06d51330556f9jsl it to avoid race conditions with other threads. You do this using a mutex
0a5e1567f7fa7f5706c68d09f744673c6cb99b33nd (mutual exclusion). Lock the mutex, read the current value, increment it
0a5e1567f7fa7f5706c68d09f744673c6cb99b33nd and write it back and then unlock the mutex. Any other thread that wants
0a5e1567f7fa7f5706c68d09f744673c6cb99b33nd to modify the value has to first check the mutex and block until it is
0a5e1567f7fa7f5706c68d09f744673c6cb99b33nd cleared.</p>
0a5e1567f7fa7f5706c68d09f744673c6cb99b33nd <p>If you are using <a href="http://apr.apache.org/">APR</a>, have a look
0a5e1567f7fa7f5706c68d09f744673c6cb99b33nd at the <code>apr_atomic_<var>*</var></code> functions and the
ae08254467d40ebbf0830ca618b06d51330556f9jsl <code>apr_thread_mutex_<var>*</var></code> functions.</p>
ae08254467d40ebbf0830ca618b06d51330556f9jsl</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
ae08254467d40ebbf0830ca618b06d51330556f9jsl <p>This is a common global variable that holds the error number of the
ae08254467d40ebbf0830ca618b06d51330556f9jsl last error that occurred. If one thread calls a low-level function that
59879db9d12c2ea10f77b2c44d6d3aba89bb9cb3slive sets errno and then another thread checks it, we are bleeding error
59879db9d12c2ea10f77b2c44d6d3aba89bb9cb3slive numbers from one thread into another. To solve this, make sure your
5a58787efeb02a1c3f06569d019ad81fd2efa06end module or library defines <code>_REENTRANT</code> or is compiled with
5a58787efeb02a1c3f06569d019ad81fd2efa06end <code>-D_REENTRANT</code>. This will make errno a per-thread variable
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd and should hopefully be transparent to the code. It does this by doing
5652dbe450e4fcfdf36d4cfb42d7f2345ded29a4maczniak something like this:</p>
35714556a25fceb7c9bf9c4e01791b2e2a4c27c3nd #define errno (*(__errno_location()))
the tokenizing state. If you are using <a href="http://apr.apache.org/">APR</a> you can use <code>apr_strtok()</code>.</p>
<p>Please drop a note to <a href="http://httpd.apache.org/lists.html#http-dev">dev@httpd.apache.org</a>
<table class="bordered"><tr class="header"><th>Library</th><th>Version</th><th>Thread Safe?</th><th>Notes</th></tr>
<td>ImageMagick docs claim it is thread safe since version 5.2.2 (see <a href="http://www.imagemagick.com/www/changelog.html">Change log</a>).
<tr class="odd"><td><a href="http://www.enlightenment.org/p.php?p=about/efl&l=en">Imlib2</a></td>
more information, please read <a href="http://dev.mysql.com/doc/mysql/en/Threaded_clients.html">http://dev.mysql.com/doc/mysql/en/Threaded_clients.html</a>.</td></tr>
has been partially thread-safe since V1.91: <a href="http://www.pdflib.com/products/pdflib-family/pdflib/">http://www.pdflib.com/products/pdflib-family/pdflib/</a>.</td></tr>
<tr><td><a href="http://www.postgresql.org/docs/8.4/static/libpq-threading.html">libpq (PostgreSQL)</a></td>
<p><span>Available Languages: </span><a href="/en/developer/thread_safety.html" title="English"> en </a></p>
<p class="apache">Copyright 2012 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p></div>