Return-Path: <cvs-return-57746-archive-asf-public=cust-asf.ponee.io@httpd.apache.org>
X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io
Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io
Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183])
	by cust-asf2.ponee.io (Postfix) with ESMTP id E758D200B14
	for <archive-asf-public-internal@cust-asf2.ponee.io>; Sat, 18 Jun 2016 12:23:20 +0200 (CEST)
Received: by cust-asf.ponee.io (Postfix)
	id E5CD6160A4E; Sat, 18 Jun 2016 10:23:20 +0000 (UTC)
Delivered-To: archive-asf-public@cust-asf.ponee.io
Received: from mail.apache.org (hermes.apache.org [140.211.11.3])
	by cust-asf.ponee.io (Postfix) with SMTP id 3813D160A26
	for <archive-asf-public@cust-asf.ponee.io>; Sat, 18 Jun 2016 12:23:20 +0200 (CEST)
Received: (qmail 97262 invoked by uid 500); 18 Jun 2016 10:23:19 -0000
Mailing-List: contact cvs-help@httpd.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@httpd.apache.org
list-help: <mailto:cvs-help@httpd.apache.org>
list-unsubscribe: <mailto:cvs-unsubscribe@httpd.apache.org>
List-Post: <mailto:cvs@httpd.apache.org>
List-Id: <cvs.httpd.apache.org>
Delivered-To: mailing list cvs@httpd.apache.org
Received: (qmail 97253 invoked by uid 99); 18 Jun 2016 10:23:19 -0000
Received: from pnap-us-west-generic-nat.apache.org (HELO spamd4-us-west.apache.org) (209.188.14.142)
    by apache.org (qpsmtpd/0.29) with ESMTP; Sat, 18 Jun 2016 10:23:19 +0000
Received: from localhost (localhost [127.0.0.1])
	by spamd4-us-west.apache.org (ASF Mail Server at spamd4-us-west.apache.org) with ESMTP id D5E43C0D9E
	for <cvs@httpd.apache.org>; Sat, 18 Jun 2016 10:23:18 +0000 (UTC)
X-Virus-Scanned: Debian amavisd-new at spamd4-us-west.apache.org
X-Spam-Flag: NO
X-Spam-Score: -0.426
X-Spam-Level: 
X-Spam-Status: No, score=-0.426 tagged_above=-999 required=6.31
	tests=[KAM_LAZY_DOMAIN_SECURITY=1, RP_MATCHES_RCVD=-1.426]
	autolearn=disabled
Received: from mx1-lw-us.apache.org ([10.40.0.8])
	by localhost (spamd4-us-west.apache.org [10.40.0.11]) (amavisd-new, port 10024)
	with ESMTP id viFI3kWTNZhK for <cvs@httpd.apache.org>;
	Sat, 18 Jun 2016 10:23:18 +0000 (UTC)
Received: from mailrelay1-us-west.apache.org (mailrelay1-us-west.apache.org [209.188.14.139])
	by mx1-lw-us.apache.org (ASF Mail Server at mx1-lw-us.apache.org) with ESMTP id A6B8F5F1E7
	for <cvs@httpd.apache.org>; Sat, 18 Jun 2016 10:23:17 +0000 (UTC)
Received: from svn01-us-west.apache.org (svn.apache.org [10.41.0.6])
	by mailrelay1-us-west.apache.org (ASF Mail Server at mailrelay1-us-west.apache.org) with ESMTP id F1A41E01D8
	for <cvs@httpd.apache.org>; Sat, 18 Jun 2016 10:23:16 +0000 (UTC)
Received: from svn01-us-west.apache.org (localhost [127.0.0.1])
	by svn01-us-west.apache.org (ASF Mail Server at svn01-us-west.apache.org) with ESMTP id EB4FE3A0024
	for <cvs@httpd.apache.org>; Sat, 18 Jun 2016 10:23:16 +0000 (UTC)
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r1748952 -
 /httpd/httpd/branches/2.4.x/docs/manual/mod/mpm_common.html.en
Date: Sat, 18 Jun 2016 10:23:16 -0000
To: cvs@httpd.apache.org
From: elukey@apache.org
X-Mailer: svnmailer-1.0.9
Message-Id: <20160618102316.EB4FE3A0024@svn01-us-west.apache.org>
archived-at: Sat, 18 Jun 2016 10:23:21 -0000

Author: elukey
Date: Sat Jun 18 10:23:16 2016
New Revision: 1748952

URL: http://svn.apache.org/viewvc?rev=1748952&view=rev
Log:
Documentation rebuild

Modified:
    httpd/httpd/branches/2.4.x/docs/manual/mod/mpm_common.html.en

Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mpm_common.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mpm_common.html.en?rev=1748952&r1=1748951&r2=1748952&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mpm_common.html.en (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mpm_common.html.en Sat Jun 18 10:23:16 2016
@@ -279,6 +279,13 @@ in *BSDs.</td></tr>
     then make each child handle a single bucket (with round-robin distribution
     of the buckets at children creation time).</p>
 
+    <div class="note"><h3>Meaning of "online" CPU core</h3>
+    <p>On Linux (and also BSD) a CPU core can be turned on/off if 
+    <a href="https://www.kernel.org/doc/Documentation/cpu-hotplug.txt">Hotplug</a> 
+    is configured, therefore <code class="directive">ListenCoresBucketsRatio</code> needs to
+    take this parameter into account while calculating the number of buckets to create.</p>
+    </div>
+
     <p><code class="directive">ListenCoresBucketsRatio</code> can improve the
     scalability when accepting new connections is/becomes the bottleneck.
     On systems with a large number of CPU cores, enabling this feature has
@@ -288,7 +295,10 @@ in *BSDs.</td></tr>
     <p>There must be at least twice the number of CPU cores than the
     configured <var>ratio</var> for this to be active. The recommended
     <var>ratio</var> is <code>8</code>, hence at least <code>16</code>
-    cores should be available at runtime when this value is used.</p>
+    cores should be available at runtime when this value is used.
+    The right <var>ratio</var> to obtain maximum performance needs to be calculated
+    for each target system, testing multiple values and observing the variations in your 
+    key performance metrics.</p>
 
 </div>
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>