From a42d626bf5c18ca195a201433599ef1a5047417d Mon Sep 17 00:00:00 2001
From: Stefan Eissing <icing@apache.org>
Date: Fri, 21 Oct 2016 09:35:18 +0000
Subject: [PATCH] update after xml change

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1765975 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/howto/http2.html.en | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/docs/manual/howto/http2.html.en b/docs/manual/howto/http2.html.en
index 9655e390a7..ac912a0299 100644
--- a/docs/manual/howto/http2.html.en
+++ b/docs/manual/howto/http2.html.en
@@ -39,6 +39,7 @@
 <li><img alt="" src="../images/down.gif" /> <a href="#implementation">HTTP/2 in Apache httpd</a></li>
 <li><img alt="" src="../images/down.gif" /> <a href="#building">Build httpd with HTTP/2 support</a></li>
 <li><img alt="" src="../images/down.gif" /> <a href="#basic-config">Basic Configuration</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#mpm-config">MPM Configuration</a></li>
 <li><img alt="" src="../images/down.gif" /> <a href="#clients">Clients</a></li>
 <li><img alt="" src="../images/down.gif" /> <a href="#tools">Useful tools to debug HTTP/2</a></li>
 <li><img alt="" src="../images/down.gif" /> <a href="#push">Server Push</a></li>
@@ -159,6 +160,25 @@
     how to manage multiple hosts with the same certificate</a>.</p>
   </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="section">
+<h2><a name="mpm-config" id="mpm-config">MPM Configuration</a></h2>
+    
+    
+    <p>HTTP/2 is supported in all multi-processing modules that come with httpd. However, if
+    you use the <code>prefork</code> mpm, there will be severe restrictions.</p>
+    <p>In <code>prefork</code> <code>mod_http2</code> will only process one request at at time
+    per connection. But clients, such as browsers, will send many requests at the same time.
+    If one of these takes long to process (or is a long polling one), the other requests will
+    stall.</p>
+    <p><code>mod_http2</code> will not work around this limit by default. The reason is that
+    <code>prefork</code> is today only chosen, if you run processing engines that re not
+    prepared for multi-threading, e.g. will crash with more than one request.</p>
+    <p>If your setup can handle it, configuring <code>event</code> mpm is nowadays
+    the best one (if supported on your platform).</p>
+    <p>If you are really stuck with <code>prefork</code> and want multiple requests,
+    you can tweak the <code class="directive"><a href="../mod/mod_http2.html#h2minworkers">H2MinWorkers</a></code> to make
+    that possible. If it breaks, however, you own both parts.</p>
+  </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
 <h2><a name="clients" id="clients">Clients</a></h2>
     
     <p>Almost all modern browsers support HTTP/2, but only over SSL connections: Firefox (v43),
-- 
2.50.1