Return-Path: Delivered-To: apmail-httpd-dev-archive@httpd.apache.org Received: (qmail 58365 invoked by uid 500); 17 Dec 2002 15:42:30 -0000 Mailing-List: contact dev-help@httpd.apache.org; run by ezmlm Precedence: bulk Reply-To: dev@httpd.apache.org list-help: list-unsubscribe: list-post: Delivered-To: mailing list dev@httpd.apache.org Received: (qmail 58303 invoked from network); 17 Dec 2002 15:42:28 -0000 Message-Id: X-Mailer: Novell GroupWise Internet Agent 6.5.0 Beta Date: Tue, 17 Dec 2002 08:42:14 -0700 From: "Brad Nicholes" To: , Subject: Re: [Review] MPM docs revision Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Content-Disposition: inline X-Spam-Rating: daedalus.apache.org 1.6.2 500/1000/N >- mpm_netware: > * MaxThreads - there was a limit of 250 documented. hmm, I couldn't find > *any* reference to a value of 250, so I took the obvious from > mpm_netware: MaxThreads 2048 (as maximum and default) The default for MaxThreads in the configuration file is 250. If omitted it will default to the HARD_THREAD_LIMIT of 2048. Which one of the defaults is appropriate for the documentation? The NetWare SecureListen directive, at the very least, should be added to the Novell NetWare Platform Specific Notes (platform/netware.html). There is a section on that page for Additional NetWare specific directives. The directive is implemented through the built in module MOD_NW_SSL which is also NetWare specific. I'm not sure if there should be an additional module documentation page for this module or not. This is the module that implements SSL functionality for the NetWare platform and replaces the need to use MOD_SSL on NetWare. The SecureListen directive takes an " | " and the name of a certificate. The default in the configuration file is SecureListen 443 "SSL CertificateDNS" If you want to add this directive to the NetWare doc, I can fill in the details later. Brad Brad Nicholes Senior Software Engineer Novell, Inc., the leading provider of Net business solutions http://www.novell.com >>> nd@perlig.de Monday, December 16, 2002 7:09:58 PM >>> [xpost dev & docs] the MPM documentation is currently incomplete and partially outdated. I've tried to remove this flaw... ;-) the patch against the existing source files (xml) can be found at (~ 68K). If you want to read it as HTML, try as a starting point. However, here's a summary of the main changes: - added new docs for beos, leader, mpmt_os2 and threadpool. The descriptions are mainly taken from the READMEs and/or code comments. - mpm_common: * fixed the s in mpm_common * moved AcceptMutex to mpm_common; document the mutex mechanism "posixsem" * added BS2000Account to mpm_common (I'm not sure, whether it should appear here or elsewhere. It *seems* to be supported only by prefork and perchild (if perchild would work). The description is obtained from the 1.3 docs. * fixed several default values * moved MaxThreadsPerChild and NumServers out to perchild (btw: we could consider to rename NumServers to StartServers...) * rearranged some stuff and added several comments, that I found useful ;-) - mpm_netware: * MaxThreads - there was a limit of 250 documented. hmm, I couldn't find *any* reference to a value of 250, so I took the obvious from mpm_netware: MaxThreads 2048 (as maximum and default) - perchild: * extended the explanations about using different user ids. Hope, that's correct. * extended and adjusted the directive descriptions (remember, NumServers and MaxThreadsPerChild moved in) - prefork: * moved AcceptMutex to mpm_common (as stated already above) Please note again, that these are only the main changes. There is still one directive (except GProfDir ;-) that's not documented: SecureListen, which comes with the netware ssl module. I didn't add it, because I'm a bit unsure, where to place it. any ideas? Probably more interesting for the doccos: the growing up of the MPM section caused some style changes for better navigation etc. A diff against the style files can be found at (~ 17K). Here are the main changes: - reintroduced the sidebar for the module index page (obvious ;-) * didn't want to leave the section links so alone, thus added some s. - changed the ordering of the core/MPMs as follows: * core * mpm_common * alphabetical list of the mpms (ordered by their "natural" names). - same appeared on the sitemap () - changed

headings of the modulesynopsis files, so that they match the titles in the sitemap. This should better reflect the nature of the modules. (affects only core & MPMs) nd -- s s^saaaaaoaaaoaaaaooooaaoaaaomaaaa a alataa aaoat a a a maoaa a laoata a oia a o a m a o alaoooat aaool aaoaa matooololaaatoto aaa o a o ms;s;\s;s;g;y;s;:;s;y#mailto: # \51/\134\137| http://www.perlig.de #;print;# > nd@perlig.de