<html>
<head>
<link rel="stylesheet" type="text/css" href="dox.css" />
<title>libapreq2-2.12: libapreq2: FAQ</title>
</head>
<body>
<div id="page-header">
<p class="menu">
<a href="http://www.apache.org/">Apache Software Foundation</a> > <a href="http://httpd.apache.org">HTTP Server Project</a> >
<a href="http://httpd.apache.org/apreq/">Request Library Subproject</a></p>
<p class="apache">Apache HTTP Server Request Library</p>
<img alt="" src="feather.gif" /></div>
<!-- Generated by Doxygen 1.5.2 -->
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="examples.html"><span>Examples</span></a></li>
</ul>
</div>
<h1><a class="anchor" name="apreq_faq">FAQ</a></h1>
<p><a name="__index__"></a></p>
<!-- INDEX BEGIN -->
<ul>
<li><a href="#issues_during_installation_">Issues during installation.</a></li>
<li><a href="#using_libapreq2_with_apache2_and_mod_perl2_">Using libapreq2 with Apache2 and mod_perl2.</a></li>
<ul>
<li><a href="#i_keep_getting_undefined_symbol_errors_whenever">I keep getting ``undefined symbol'' errors whenever </a></li>
<li><a href="#when_i_use_apache2__request_in_my_output_filter__it_seems_to_lose">When I use Apache2::Request in my output filter, it seems to lose</a></li>
<li><a href="#when_i_try_to_upload_a_file__why_do_i_get_this_error">When I try to upload a file, why do I get this error </a></li>
</ul>
<li><a href="#using_libapreq2_outside_of_apache_">Using libapreq2 outside of Apache.</a></li>
<li><a href="#contributing_to_apreq_development_">Contributing to apreq development.</a></li>
<ul>
<li><a href="#how_is_the_subversion_repository_managed">How is the subversion repository managed?</a></li>
</ul>
</ul>
<!-- INDEX END -->
<hr />
<p>
</p>
<h1><a name="issues_during_installation_">Issues during installation.</a></h1>
<p>[...]</p>
<p>
</p>
<hr />
<h1><a name="using_libapreq2_with_apache2_and_mod_perl2_">Using libapreq2 with Apache2 and mod_perl2.</a></h1>
<p>
</p>
<h2><a name="i_keep_getting_undefined_symbol_errors_whenever_i_use_apache2__request_or_apr__request__apache2_">I keep getting ``undefined symbol'' errors whenever
I use Apache2::Request or APR::Request::Apache2.</a></h2>
<p>You need to load mod_apreq2.so at server startup, which grabs
all the required symbols at server startup. Be sure your server
config contains a line like</p>
<pre>
LoadModule apreq_module modules/mod_apreq2.so</pre>
<p>
</p>
<h2><a name="when_i_use_apache2__request_in_my_output_filter__it_seems_to_lose_the_incoming_post_variables_">When I use Apache2::Request in my output filter, it seems to lose
the incoming POST variables.</a></h2>
<p>The problem is likely that the mod_apreq2 filter has not been
added to the input filter chain in time to read the POST data.</p>
<p>There are two solutions to this problem:</p>
<pre>
1) Write a filter init handler for you filter that instantiates an
Apache2::Request object.</pre>
<pre>
<a href="http://perl.apache.org/docs/2.0/api/Apache2/Filter.html#C_FilterInitHandler_">http://perl.apache.org/docs/2.0/api/Apache2/Filter.html#C_FilterInitHandler_</a></pre>
<pre>
2) Use .htaccess or your server config to ensure the apreq input filter
is active for this request with "AddInputFilter APREQ" or somesuch.</pre>
<p>We recommend using (1), and falling back to (2) until you get (1) working.</p>
<p>
</p>
<h2><a name="when_i_try_to_upload_a_file__why_do_i_get_this_error__error__can_t_locate_____apache2_request_upload_al_in__inc">When I try to upload a file, why do I get this error
``[error] Can't locate .../Apache2/Request/upload.al in @INC''?</a></h2>
<p><em>Apache2::Upload</em> is now a separate module in apreq2, so you need to
<code>use Apache2::Upload</code> to load the <code>Apache2::Request::upload</code> function.</p>
<p>This also applies to ``Can't locate auto/APR/Request/Param/slurp.al in @INC''.
This is because <em>Apache2::Upload</em> is implement by wrapping the <em>APR::Request::*</em>
packages.</p>
<p>
</p>
<hr />
<h1><a name="using_libapreq2_outside_of_apache_">Using libapreq2 outside of Apache.</a></h1>
<p>[...]</p>
<p>
</p>
<hr />
<h1><a name="contributing_to_apreq_development_">Contributing to apreq development.</a></h1>
<p>
</p>
<h2><a name="how_is_the_subversion_repository_managed">How is the subversion repository managed?</a></h2>
<p>apreq's repository is broken into three subdirectories:</p>
<pre>
/trunk - the current codebase for active development.
/tags - release snapshots.
/branches - where older releases and experimental development lines live.</pre>
<p>apreq follows a Commit-then-Review policy for its entire repository,
but being a shared library places certain restrictions on the admissible
changes for stable trees. Basically the header files cannot be modified;
only new functions and structures may be added to them. Any time that
happens, the minor-version needs to be bumped, and the patch-level gets
reset to zero. Changes that only modify the library's implementation (.c)
files require a bump to the patch-level. On stable trees, this version
tracking should happen on each commit, to make auditing easy for other
developers without resorting to a draconian Review-then-Commit policy.</p>
<div id="footer">
<p class="apache">
Copyright © 2003-2006 <a href="http://www.apache.org">The Apache Software Foundation</a>.<br/>
See <a href="apreq_license.html">LICENSE</a>.</p>
<p class="menu">
<span style="color:#aaa">page generated by <a href="http://www.doxygen.org/"><code>doxygen</code></a>
version 1.5.2 on 6 Mar 2009</span>
</p>
</div>
</body>
</html>
