Re: [Review] MPM docs revision

2002-12-17 Thread Brad Nicholes 
Oops, forgot about the third parameter on SecureListen.  The third parameter indicates 
wheither mutual authenication should be used.  If mutual authentication is wanted, the 
third parameter should be set to "MUTUAL", but in reality any value as the third 
parameter will enable mutual authentication.



Brad Nicholes
Senior Software Engineer
Novell, Inc., the leading provider of Net business solutions
http://www.novell.com 

>>> [EMAIL PROTECTED] Tuesday, December 17, 2002 10:06:14 AM >>>
* Brad Nicholes wrote:

>>- 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 value, if the directive is omitted.
(but we could consider to change the default in mpm_netware.c, if 2048 is 
too high in almost all cases (i.e. as a *default* value) and 250 is 
recommended.)

> 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.

ah, hmm. CGIMapExtension is currently listed there, but documented in core.

I see some ways to handle it:

- put arch-specific directives into core.xml (CGIMapExtension, 
SecureListen, ScriptInterpreterSource, BS2000Account).

- introduce docs for the architecture modules (mod_win32, mod_netware, 
mod_nw_ssl). BS2000Account would be kept in mpm_common that way (or core?).

- put all arch specific the stuff to the mpm docs

I think, I'd prefer the second.

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.

there's a third, optional parameter. What does it do?

> If you want to add this directive to the NetWare doc, I can fill in the
> details later.

ok, when we've puzzled out the above.

nd
-- 
print "Just Another Perl Hacker";

# André Malo,  #

Re: [Review] MPM docs revision

2002-12-17 Thread André Malo 
* Brad Nicholes wrote:

>>- 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 value, if the directive is omitted.
(but we could consider to change the default in mpm_netware.c, if 2048 is 
too high in almost all cases (i.e. as a *default* value) and 250 is 
recommended.)

> 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.

ah, hmm. CGIMapExtension is currently listed there, but documented in core.

I see some ways to handle it:

- put arch-specific directives into core.xml (CGIMapExtension, 
SecureListen, ScriptInterpreterSource, BS2000Account).

- introduce docs for the architecture modules (mod_win32, mod_netware, 
mod_nw_ssl). BS2000Account would be kept in mpm_common that way (or core?).

- put all arch specific the stuff to the mpm docs

I think, I'd prefer the second.

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.

there's a third, optional parameter. What does it do?

> If you want to add this directive to the NetWare doc, I can fill in the
> details later.

ok, when we've puzzled out the above.

nd
-- 
print "Just Another Perl Hacker";

# André Malo,  #

Re: [Review] MPM docs revision

2002-12-17 Thread Brad Nicholes 
>- 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 

>>> [EMAIL PROTECTED] 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^saoaaaoaaoaaaom  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;# > [EMAIL PROTECTED]

Re: [Review] MPM docs revision

2002-12-17 Thread Erik Abele 
> Von: Enrico Weigelt <[EMAIL PROTECTED]>
> Antworten an: [EMAIL PROTECTED]
> Datum: Tue, 17 Dec 2002 06:30:55 +0100
> An: [EMAIL PROTECTED]
> Betreff: Re: [Review] MPM docs revision
> 
> On Tue, Dec 17, 2002 at 03:09:58AM +0100, André Malo wrote:
> 
> 
> 
>> - added new docs for beos, leader, mpmt_os2 and threadpool.
>> The descriptions are mainly taken from the READMEs and/or code comments.
> 
> i'll post some stuff about my new mpm in some days ...
> 
> btw: are there manpages for the apache configuration ?
> 

We removed the available manpages for apachectl & httpd since there is
nobody who is able to maintain and update the nroff stuff (see
http://cvs.apache.org/viewcvs.cgi/httpd-docs-2.0/man/)

You can find the updated XML/HTML versions online at
http://httpd.apache.org/docs-2.0/programs/httpd.html
and http://httpd.apache.org/docs-2.0/programs/apachectl.html

HTH,
erik

Re: [Review] MPM docs revision

2002-12-17 Thread Enrico Weigelt 
On Tue, Dec 17, 2002 at 03:09:58AM +0100, André Malo wrote:



> - added new docs for beos, leader, mpmt_os2 and threadpool.
>   The descriptions are mainly taken from the READMEs and/or code comments.

i'll post some stuff about my new mpm in some days ...

btw: are there manpages for the apache configuration ?

~-n
-- 
-
 Enrico Weigelt==   metux ITS 
 Webhosting ab 5 EUR/Monat.  UUCP, rawIP und vieles mehr.

 phone: +49 36207 519931 www:   http://www.metux.de/ 
 fax:   +49 36207 519932 email: [EMAIL PROTECTED]
 cellphone: +49 174 7066481  smsgate:   [EMAIL PROTECTED]
-
 Diese Mail wurde mit UUCP versandt.  http://www.metux.de/uucp/

[Review] MPM docs revision

2002-12-16 Thread André Malo 
[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^saoaaaoaaoaaaom  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;# > [EMAIL PROTECTED]