svn commit: r169054 - /perl/modperl/docs/trunk/src/docs/2.0/api/APR/Status.pod
Author: randyk Date: Fri May 6 23:50:16 2005 New Revision: 169054 URL: http://svn.apache.org/viewcvs?rev=169054view=rev Log: fix examples to handle case where APR::Status::is_E* is not true. Modified: perl/modperl/docs/trunk/src/docs/2.0/api/APR/Status.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/api/APR/Status.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/APR/Status.pod?rev=169054r1=169053r2=169054view=diff == --- perl/modperl/docs/trunk/src/docs/2.0/api/APR/Status.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/APR/Status.pod Fri May 6 23:50:16 2005 @@ -124,13 +124,10 @@ eval { $obj-slurp_filename(0) }; if ($@) { - if (ref $@ eq 'APR::Error') { - return Apache2::Const::FORBIDDEN if APR::Status::is_EACCES($@); - } - else { - return Apache2::Const::SERVER_ERROR; - } - } + return Apache2::Const::FORBIDDEN + if ref $@ eq 'APR::Error' APR::Status::is_EACCES($@); + die $@; + } As discussed above with CAPR::Const::EAGAIN, the advantage of using Cis_EACCES is portability - just checking @@ -164,12 +161,9 @@ eval { $obj-slurp_filename(0) }; if ($@) { - if (ref $@ eq 'APR::Error') { - return Apache2::Const::NOT_FOUND if APR::Status::is_ENOENT($@); - } - else { - return Apache2::Const::SERVER_ERROR; - } + return Apache2::Const::NOT_FOUND + if ref $@ eq 'APR::Error' APR::Status::is_ENOENT($@); + die $@; } - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r168603 - /perl/modperl/docs/trunk/src/docs/2.0/api/APR/Status.pod
Author: randyk Date: Fri May 6 07:11:18 2005 New Revision: 168603 URL: http://svn.apache.org/viewcvs?rev=168603view=rev Log: add documentation for APR::Status::is_EACCES and APR::Status::is_ENOENT. Modified: perl/modperl/docs/trunk/src/docs/2.0/api/APR/Status.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/api/APR/Status.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/APR/Status.pod?rev=168603r1=168602r2=168603view=diff == --- perl/modperl/docs/trunk/src/docs/2.0/api/APR/Status.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/APR/Status.pod Fri May 6 07:11:18 2005 @@ -98,6 +98,80 @@ CAPR::Const::EAGAIN unless you know what you are doing. +=head2 Cis_EACCES + +Check if the error is matching CEACCES and its variants (corresponds +to the CAPR_STATUS_IS_EACCES macro). + + $status = APR::Status::is_EACCES($error_code); + +=over 4 + +=item arg1: C$error_code (integer or CLAPR::Error +object|docs::2.0::api::APR::Error ) + +The error code or to check, normally C$@ blessed into CLAPR::Error +object|docs::2.0::api::APR::Error. + +=item ret: C$status ( boolean ) + +=item since: 1.999.24 + +=back + +An example of using Cis_EACCES is when reading the contents of a +file where access may be forbidden: + + eval { $obj-slurp_filename(0) }; + if ($@) { + if (ref $@ eq 'APR::Error') { + return Apache2::Const::FORBIDDEN if APR::Status::is_EACCES($@); + } + else { + return Apache2::Const::SERVER_ERROR; + } + } + +As discussed above with CAPR::Const::EAGAIN, the advantage of +using Cis_EACCES is portability - just checking +C$@ against CAPR::Const::EACCES may work on some unices, +but could fail on other platforms. + + +=head2 Cis_ENOENT + +Check if the error is matching CENOENT and its variants (corresponds +to the CAPR_STATUS_IS_ENOENT macro). + + $status = APR::Status::is_ENOENT($error_code); + +=over 4 + +=item arg1: C$error_code (integer or CLAPR::Error +object|docs::2.0::api::APR::Error ) + +The error code or to check, normally C$@ blessed into CLAPR::Error +object|docs::2.0::api::APR::Error. + +=item ret: C$status ( boolean ) + +=item since: 1.999.24 + +=back + +An example of using Cis_ENOENT is when reading the contents of a +file which may not exist: + + eval { $obj-slurp_filename(0) }; + if ($@) { + if (ref $@ eq 'APR::Error') { + return Apache2::Const::NOT_FOUND if APR::Status::is_ENOENT($@); + } + else { + return Apache2::Const::SERVER_ERROR; + } + } + =head1 See Also - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r162015 - in perl/modperl/docs/trunk/src/docs/2.0/api: APR/Error.pod APR/Status.pod config.cfg
Author: randyk Date: Tue Apr 19 22:14:07 2005 New Revision: 162015 URL: http://svn.apache.org/viewcvs?view=revrev=162015 Log: add documentation for APR::Status. Added: perl/modperl/docs/trunk/src/docs/2.0/api/APR/Status.pod (with props) Modified: perl/modperl/docs/trunk/src/docs/2.0/api/APR/Error.pod perl/modperl/docs/trunk/src/docs/2.0/api/config.cfg Modified: perl/modperl/docs/trunk/src/docs/2.0/api/APR/Error.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/APR/Error.pod?view=diffr1=162014r2=162015 == --- perl/modperl/docs/trunk/src/docs/2.0/api/APR/Error.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/APR/Error.pod Tue Apr 19 22:14:07 2005 @@ -132,6 +132,12 @@ outside mod_perl as well, when called from CLAPR|docs::2.0::api::APR applications written in Perl. +It is worth noting that APR provides some macros in Fapr_errno.h, +CAPR_STATUS_IS_*, which are the recommended way to check for +some error conditions, especially in cases when different +circumstances can lead to the intent of a single condition. +See the LAPR::Status documentation|docs::2.0::api::APR::Status +for an interface to some of these macros. =head1 API Added: perl/modperl/docs/trunk/src/docs/2.0/api/APR/Status.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/APR/Status.pod?view=autorev=162015 == --- perl/modperl/docs/trunk/src/docs/2.0/api/APR/Status.pod (added) +++ perl/modperl/docs/trunk/src/docs/2.0/api/APR/Status.pod Tue Apr 19 22:14:07 2005 @@ -0,0 +1,78 @@ +=head1 NAME + +APR::Status - Perl Interface to the APR_STATUS_IS_* macros + + + +=head1 Synopsis + + use APR::Status (); + eval { $obj-mp_method() }; + if ($@ $ref $@ eq 'APR::Error' APR::Status::is_EAGAIN($@)) { +# APR_STATUS_IS_EAGAIN(s) of apr_errno.h is satisfied + } + + +=head1 Description + +As discussed in the +LAPR::Error documentation|docs::2.0::api::APR::Error, +it is possible to handle APR/Apache/mod_perl exceptions +in the following way: + + eval { $obj-mp_method() }; + if ($@ $ref $@ eq 'APR::Error' $@ == $some_code) + warn handled exception: $@; + } + +However, in cases where C$some_code is an +LAPR::Const constant|docs::2.0::api::APR::Const, +there may be more than one condition satisfying the +intent of this exception. For this purpose the APR C +library provides in Fapr_errno.h a series of macros, +CAPR_STATUS_IS_*, which are the recommended way to check +for such conditions. For example, the CAPR_STATUS_IS_EAGAIN +macro is defined as + + #define APR_STATUS_IS_EAGAIN(s) ((s) == APR_EAGAIN \ + || (s) == APR_OS_START_SYSERR + ERROR_NO_DATA \ + || (s) == APR_OS_START_SYSERR + SOCEWOULDBLOCK \ + || (s) == APR_OS_START_SYSERR + ERROR_LOCK_VIOLATION) + +The purpose of CAPR::Status is to provide functions corresponding +to these macros. + + +=head1 Functions + + + +=head2 Cis_EAGAIN + + use APR::Status (); + # + if ($@ $ref $@ eq 'APR::Error' APR::Status::is_EAGAIN($@)) { +# APR_STATUS_IS_EAGAIN(s) of apr_errno.h is satisfied + } + +This corresponds to the CAPR_STATUS_IS_EAGAIN macro. + + +=head1 See Also + +Lmod_perl 2.0 documentation|docs::2.0::index. + + +=head1 Copyright + +mod_perl 2.0 and its core modules are copyrighted under +The Apache Software License, Version 2.0. + + + +=head1 Authors + +LThe mod_perl development team and numerous +contributors|about::contributors::people. + +=cut Propchange: perl/modperl/docs/trunk/src/docs/2.0/api/APR/Status.pod -- svn:eol-style = native Modified: perl/modperl/docs/trunk/src/docs/2.0/api/config.cfg URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/config.cfg?view=diffr1=162014r2=162015 == --- perl/modperl/docs/trunk/src/docs/2.0/api/config.cfg (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/config.cfg Tue Apr 19 22:14:07 2005 @@ -60,6 +60,7 @@ APR/Pool.pod APR/SockAddr.pod APR/Socket.pod +APR/Status.pod APR/String.pod APR/Table.pod APR/ThreadMutex.pod - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r161008 - perl/modperl/docs/trunk/src/docs/2.0/rename.pod
Author: randyk Date: Mon Apr 11 19:41:31 2005 New Revision: 161008 URL: http://svn.apache.org/viewcvs?view=revrev=161008 Log: expand upon the removal of an existing mod_perl 2 installation with respect to the possible presence of 3rd party Apache modules. Modified: perl/modperl/docs/trunk/src/docs/2.0/rename.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/rename.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/rename.pod?view=diffr1=161007r2=161008 == --- perl/modperl/docs/trunk/src/docs/2.0/rename.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/rename.pod Mon Apr 11 19:41:31 2005 @@ -99,17 +99,22 @@ % find /usr/lib/perl5 -name 'Apache2*' -exec rm -rf {} \; where F/usr/lib/perl5 is the top-level root of your Perl tree. -Before doing this, you may want to verify that there are no -3rd-party modules within this tree that you might like to -keep: +Note that this will also remove any 3rd party Apache modules +installed under an FApache2 subdirectory. In many situations +you would want to do this, as such modules will need porting to the +new API. However, if there are modules under this location +that you want to keep, you can use % find /opt/lib/perl5 -name 'Apache2*' -exec ls -lR {} \; -will list the files under this tree. Win32 ppm users can do, -within the ppm shell, +to list the files under this tree. + +For Win32 ppm users, the command ppm remove mod_perl +within the ppm shell will remove an installed Cmod_perl +ppm package. =item * - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r161009 - perl/modperl/docs/trunk/src/docs/2.0/rename.pod
Author: randyk Date: Mon Apr 11 19:43:26 2005 New Revision: 161009 URL: http://svn.apache.org/viewcvs?view=revrev=161009 Log: s/opt/usr/ Modified: perl/modperl/docs/trunk/src/docs/2.0/rename.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/rename.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/rename.pod?view=diffr1=161008r2=161009 == --- perl/modperl/docs/trunk/src/docs/2.0/rename.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/rename.pod Mon Apr 11 19:43:26 2005 @@ -1,192 +1,192 @@ -=head1 NAME - -mod_perl 2.0 renaming - -=head1 Description - -This document discusses the effects of the decision to rename -parts of the mod_perl API. - -=head1 Synopsis - -During a sequence of release candidates leading up to -the official release of mod_perl 2, -in late December, 2004 there was considerable discussion -regarding the choice of namespaces for the 2.0 API. -The main concern expressed was that some of the -CApache::* modules used in mod_perl 2 had the same names -as those in mod_perl 1. After a lively and, at times, -heated debate, a proposal was made to rename parts of -the mod_perl 2 API - see the thread at -Lhttp://marc.theaimsgroup.com/?t=3503712r=1w=2. -This proposal was subsequently voted on and then adopted. - -=head1 Changes - -The main changes involved in this renaming are as follows. - -=over - -=item * - -Rename all CApache::* modules to CApache2::*, save for -the following exceptions: - -=over 4 - -=item * - -The CApache::Test* modules in the CApache-Test distribution -are unaffected by this rename. - -=item * - -Constants under the CApache::* namespace, -such as CApache::OK, are now called as CApache2::Const::* -(for example, CApache2::Const::OK). - -=item * - -Constants under the CAPR::* namespace, -such as CAPR::SUCCESS, are now called as CAPR::Const::* -(for example, CAPR::Const::SUCCESS). - -=back - -=item * - -CApache-Egtrequest() has been renamed to -CApache2::RequestUtil-Egtrequest(). - -=item * - -CApache-Egtserver() has been renamed to -CApache2::ServerUtil-Egtserver(). - -=item * - -Rename Cmod_perl.pm to Cmod_perl2.pm - -=item * - -Discontinue the practice of installing mod_perl in a -relative FApache2 subdirectory, so that the use -of CApache2.pm to adjust C@INC is no longer needed. - -=back - -Concurrent with these changes, a decision was also made to -refuse to install mod_perl 2 in the same Perl tree as any -installed mod_perl 2 package of version prior to 1.999_22. - -=head1 Effects - -The mod_perl developers did not take lightly the effects of -changing the API at such a late stage in the development cycle. -For most users the change to the new API should be relatively -straightforward: - -=over - -=item * - -Before installing mod_perl 2, either remove an earlier -mod_perl 2 installation (prior to 1.999022), or else choose -to install the new version in a different area. To remove -enough of a prior installation of mod_perl 2 in order to -satisfy this requirement, one can do, on Unix, - - % find /usr/lib/perl5 -name 'Apache2*' -exec rm -rf {} \; - -where F/usr/lib/perl5 is the top-level root of your Perl tree. -Note that this will also remove any 3rd party Apache modules -installed under an FApache2 subdirectory. In many situations -you would want to do this, as such modules will need porting to the -new API. However, if there are modules under this location -that you want to keep, you can use - - % find /opt/lib/perl5 -name 'Apache2*' -exec ls -lR {} \; - -to list the files under this tree. - -For Win32 ppm users, the command - - ppm remove mod_perl - -within the ppm shell will remove an installed Cmod_perl -ppm package. - -=item * - -If building mod_perl 2 from source, the CMakefile.PL argument -of CMP_INST_APACHE2 is no longer supported. - -=item * - -Replace the use of - -use Apache::SomeCoreModule; - -in a script or module by - -use Apache2::SomeCoreModule; - -Similarly, an Apache directive - -PerlModule Apache::SomeCoreModule - -in an Fhttpd.conf file should be replace by - -PerlModule Apache2::SomeCoreModule - -A similar substitution from Cmod_perl to Cmod_perl2 should -be made in similar places. - -=item * - -Replace the use of constants CApache::* by CApache2::Const::* -and CAPR::* by CAPR::Const::*. - -=item * - -Remove any occurrences of - -use Apache2; - -in a script or module, as well as - -PerlModule Apache2 - -in an Apache configuration file. - -=item * - -In a script or module, replace -CApache-Egtrequest() by CApache2::RequestUtil-Egtrequest() -and CApache-Egtserver() by CApache2::ServerUtil-Egtserver(). - -=item * - -If using CCGI.pm you will need to upgrade to version 3.08 - versions -3.07 and older do not support the new mod_perl API. you can get -CCGI.pm from Lhttp://search.cpan.org/dist/CGI.pm/. - -=back - -Beginning with mod_perl-1.999_22, an environment variable -C$ENV{MOD_PERL_API_VERSION} has
svn commit: r161010 - perl/modperl/docs/trunk/src/docs/2.0/rename.pod
Author: randyk Date: Mon Apr 11 19:55:36 2005 New Revision: 161010 URL: http://svn.apache.org/viewcvs?view=revrev=161010 Log: propset svn:eol-style native Modified: perl/modperl/docs/trunk/src/docs/2.0/rename.pod (contents, props changed) Modified: perl/modperl/docs/trunk/src/docs/2.0/rename.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/rename.pod?view=diffr1=161009r2=161010 == --- perl/modperl/docs/trunk/src/docs/2.0/rename.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/rename.pod Mon Apr 11 19:55:36 2005 @@ -1,192 +1,192 @@ -=head1 NAME - -mod_perl 2.0 renaming - -=head1 Description - -This document discusses the effects of the decision to rename -parts of the mod_perl API. - -=head1 Synopsis - -During a sequence of release candidates leading up to -the official release of mod_perl 2, -in late December, 2004 there was considerable discussion -regarding the choice of namespaces for the 2.0 API. -The main concern expressed was that some of the -CApache::* modules used in mod_perl 2 had the same names -as those in mod_perl 1. After a lively and, at times, -heated debate, a proposal was made to rename parts of -the mod_perl 2 API - see the thread at -Lhttp://marc.theaimsgroup.com/?t=3503712r=1w=2. -This proposal was subsequently voted on and then adopted. - -=head1 Changes - -The main changes involved in this renaming are as follows. - -=over - -=item * - -Rename all CApache::* modules to CApache2::*, save for -the following exceptions: - -=over 4 - -=item * - -The CApache::Test* modules in the CApache-Test distribution -are unaffected by this rename. - -=item * - -Constants under the CApache::* namespace, -such as CApache::OK, are now called as CApache2::Const::* -(for example, CApache2::Const::OK). - -=item * - -Constants under the CAPR::* namespace, -such as CAPR::SUCCESS, are now called as CAPR::Const::* -(for example, CAPR::Const::SUCCESS). - -=back - -=item * - -CApache-Egtrequest() has been renamed to -CApache2::RequestUtil-Egtrequest(). - -=item * - -CApache-Egtserver() has been renamed to -CApache2::ServerUtil-Egtserver(). - -=item * - -Rename Cmod_perl.pm to Cmod_perl2.pm - -=item * - -Discontinue the practice of installing mod_perl in a -relative FApache2 subdirectory, so that the use -of CApache2.pm to adjust C@INC is no longer needed. - -=back - -Concurrent with these changes, a decision was also made to -refuse to install mod_perl 2 in the same Perl tree as any -installed mod_perl 2 package of version prior to 1.999_22. - -=head1 Effects - -The mod_perl developers did not take lightly the effects of -changing the API at such a late stage in the development cycle. -For most users the change to the new API should be relatively -straightforward: - -=over - -=item * - -Before installing mod_perl 2, either remove an earlier -mod_perl 2 installation (prior to 1.999022), or else choose -to install the new version in a different area. To remove -enough of a prior installation of mod_perl 2 in order to -satisfy this requirement, one can do, on Unix, - - % find /usr/lib/perl5 -name 'Apache2*' -exec rm -rf {} \; - -where F/usr/lib/perl5 is the top-level root of your Perl tree. -Note that this will also remove any 3rd party Apache modules -installed under an FApache2 subdirectory. In many situations -you would want to do this, as such modules will need porting to the -new API. However, if there are modules under this location -that you want to keep, you can use - - % find /usr/lib/perl5 -name 'Apache2*' -exec ls -lR {} \; - -to list the files under this tree. - -For Win32 ppm users, the command - - ppm remove mod_perl - -within the ppm shell will remove an installed Cmod_perl -ppm package. - -=item * - -If building mod_perl 2 from source, the CMakefile.PL argument -of CMP_INST_APACHE2 is no longer supported. - -=item * - -Replace the use of - -use Apache::SomeCoreModule; - -in a script or module by - -use Apache2::SomeCoreModule; - -Similarly, an Apache directive - -PerlModule Apache::SomeCoreModule - -in an Fhttpd.conf file should be replace by - -PerlModule Apache2::SomeCoreModule - -A similar substitution from Cmod_perl to Cmod_perl2 should -be made in similar places. - -=item * - -Replace the use of constants CApache::* by CApache2::Const::* -and CAPR::* by CAPR::Const::*. - -=item * - -Remove any occurrences of - -use Apache2; - -in a script or module, as well as - -PerlModule Apache2 - -in an Apache configuration file. - -=item * - -In a script or module, replace -CApache-Egtrequest() by CApache2::RequestUtil-Egtrequest() -and CApache-Egtserver() by CApache2::ServerUtil-Egtserver(). - -=item * - -If using CCGI.pm you will need to upgrade to version 3.08 - versions -3.07 and older do not support the new mod_perl API. you can get -CCGI.pm from Lhttp://search.cpan.org/dist/CGI.pm/. - -=back - -Beginning with mod_perl-1.999_22
svn commit: r160929 - perl/modperl/docs/trunk/src/docs/2.0/rename.pod
Author: randyk Date: Mon Apr 11 10:35:20 2005 New Revision: 160929 URL: http://svn.apache.org/viewcvs?view=revrev=160929 Log: add in Stas' suggestion about how to remove a prior mod_perl-2 installation. Modified: perl/modperl/docs/trunk/src/docs/2.0/rename.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/rename.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/rename.pod?view=diffr1=160928r2=160929 == --- perl/modperl/docs/trunk/src/docs/2.0/rename.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/rename.pod Mon Apr 11 10:35:20 2005 @@ -92,7 +92,16 @@ Before installing mod_perl 2, either remove an earlier mod_perl 2 installation (prior to 1.999022), or else choose -to install the new version in a different area. +to install the new version in a different area. To remove +a prior installation of mod_perl 2, one can do, on Unix, + + % find /usr/lib/perl5 -name 'Apache2*' -exec rm -rf {} \; + +where F/usr/lib/perl5 is the top-level root of your Perl tree. +Win32 ppm users can do, within the ppm shell, + + ppm remove mod_perl + =item * - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r160938 - perl/modperl/docs/trunk/src/docs/2.0/rename.pod
Author: randyk Date: Mon Apr 11 12:19:48 2005 New Revision: 160938 URL: http://svn.apache.org/viewcvs?view=revrev=160938 Log: suggest to check for the existence of 3rd-party modules before using the suggested method to remove a prior mod_perl-2 installation. Modified: perl/modperl/docs/trunk/src/docs/2.0/rename.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/rename.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/rename.pod?view=diffr1=160937r2=160938 == --- perl/modperl/docs/trunk/src/docs/2.0/rename.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/rename.pod Mon Apr 11 12:19:48 2005 @@ -93,12 +93,20 @@ Before installing mod_perl 2, either remove an earlier mod_perl 2 installation (prior to 1.999022), or else choose to install the new version in a different area. To remove -a prior installation of mod_perl 2, one can do, on Unix, +enough of a prior installation of mod_perl 2 in order to +satisfy this requirement, one can do, on Unix, % find /usr/lib/perl5 -name 'Apache2*' -exec rm -rf {} \; where F/usr/lib/perl5 is the top-level root of your Perl tree. -Win32 ppm users can do, within the ppm shell, +Before doing this, you may want to verify that there are no +3rd-party modules within this tree that you might like to +keep: + + % find /opt/lib/perl5 -name 'Apache2*' -exec ls -lR {} \; + +will list the files under this tree. Win32 ppm users can do, +within the ppm shell, ppm remove mod_perl - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r160425 - in perl/modperl/docs/trunk/src/docs/2.0: config.cfg rename.pod
Author: randyk Date: Thu Apr 7 11:23:45 2005 New Revision: 160425 URL: http://svn.apache.org/viewcvs?view=revrev=160425 Log: Start of a document discussing the effects of the recent renaming changes. Added: perl/modperl/docs/trunk/src/docs/2.0/rename.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/config.cfg Modified: perl/modperl/docs/trunk/src/docs/2.0/config.cfg URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/config.cfg?view=diffr1=160424r2=160425 == --- perl/modperl/docs/trunk/src/docs/2.0/config.cfg (original) +++ perl/modperl/docs/trunk/src/docs/2.0/config.cfg Thu Apr 7 11:23:45 2005 @@ -14,6 +14,11 @@ abstract = EOB, A collection of the documents specific to the mod_perl 2.0 generation. EOB + +chapters = [qw( +rename.pod +)], + docsets = [qw( user os Added: perl/modperl/docs/trunk/src/docs/2.0/rename.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/rename.pod?view=autorev=160425 == --- perl/modperl/docs/trunk/src/docs/2.0/rename.pod (added) +++ perl/modperl/docs/trunk/src/docs/2.0/rename.pod Thu Apr 7 11:23:45 2005 @@ -0,0 +1,164 @@ +=head1 NAME + +mod_perl 2.0 renaming + +=head1 Description + +This document discusses the effects of the decision to rename +parts of the mod_perl API. + +=head1 Synopsis + +During a sequence of release candidates leading up to +the official release of mod_perl 2, +in late December, 2004 there was considerable discussion +regarding the choice of namespaces for the 2.0 API. +The main concern expressed was that some of the +CApache::* modules used in mod_perl 2 had the same names +as those in mod_perl 1. After a lively and, at times, +heated debate, a proposal was made to rename parts of +the mod_perl 2 API - see the thread at +Lhttp://marc.theaimsgroup.com/?t=3503712r=1w=2. +This proposal was subsequently voted on and then adopted. + +=head1 Changes + +The main changes involved in this renaming are as follows. + +=over + +=item * + +Rename all CApache::* modules to CApache2::*, save for +the following exceptions: + +=over 4 + +=item * + +The CApache::Test* modules in the CApache-Test distribution +are unaffected by this rename. + +=item * + +Constants under the CApache::* namespace, +such as CApache::OK, are now called as CApache2::Const::* +(for example, CApache2::Const::OK). + +=item * + +Constants under the CAPR::* namespace, +such as CAPR::SUCCESS, are now called as CAPR::Const::* +(for example, CAPR::Const::SUCCESS). + +=back + +=item * + +CApache-Egtrequest() has been renamed to +CApache2::RequestUtil-Egtrequest(). + +=item * + +CApache-Egtserver() has been renamed to +CApache2::ServerUtil-Egtserver(). + +=item * + +Rename Cmod_perl.pm to Cmod_perl2.pm + +=item * + +Discontinue the practice of installing mod_perl in a +relative FApache2 subdirectory, so that the use +of CApache2.pm to adjust C@INC is no longer needed. + +=back + +Concurrent with these changes, a decision was also made to +refuse to install mod_perl 2 in the same Perl tree as any +installed mod_perl 2 package of version prior to 1.999_22. + +=head1 Effects + +The mod_perl developers did not take lightly the effects of +changing the API at such a late stage in the development cycle. +For most users the change to the new API should be relatively +straightforward: + +=over + +=item * + +Before installing mod_perl 2, either remove an earlier +mod_perl 2 installation (prior to 1.999022), or else choose +to install the new version in a different area. + +=item * + +If building mod_perl 2 from source, the CMakefile.PL argument +of CMP_INST_APACHE2 is no longer supported. + +=item * + +Replace the use of + +use Apache::SomeCoreModule; + +in a script or module by + +use Apache2::SomeCoreModule; + +Similarly, an Apache directive + +PerlModule Apache::SomeCoreModule + +in an Fhttpd.conf file should be replace by + +PerlModule Apache2::SomeCoreModule + +A similar substitution from Cmod_perl to Cmod_perl2 should +be made in similar places. + +=item * + +Replace the use of constants CApache::* by CApache2::Const::* +and CAPR::* by CAPR::Const::*. + +=item * + +Remove any occurrences of + +use Apache2; + +in a script or module, as well as + +PerlModule Apache2 + +in an Apache configuration file. + +=item * + +In a script or module, replace +CApache-Egtrequest() by CApache2::RequestUtil-Egtrequest() +and CApache-Egtserver() by CApache2::ServerUtil-Egtserver(). + +=back + +Beginning with mod_perl-1.999_22, an environment variable +C$ENV{MOD_PERL_API_VERSION} has been added to specify +which mod_perl version is being used. + +=head1 See Also + +The directions for +Linstalling mod_perl 2.0 |docs::2.0::user::install::install. +Help is also available through the archives of and subscribing to +the Lmod_perl mailing list
svn commit: r159853 - perl/modperl/docs/trunk/src/docs/2.0/user/troubleshooting/troubleshooting.pod
Author: randyk Date: Sat Apr 2 16:36:31 2005 New Revision: 159853 URL: http://svn.apache.org/viewcvs?view=revrev=159853 Log: s/Apache/Apache2/ Modified: perl/modperl/docs/trunk/src/docs/2.0/user/troubleshooting/troubleshooting.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/user/troubleshooting/troubleshooting.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/user/troubleshooting/troubleshooting.pod?view=diffr1=159852r2=159853 == --- perl/modperl/docs/trunk/src/docs/2.0/user/troubleshooting/troubleshooting.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/user/troubleshooting/troubleshooting.pod Sat Apr 2 16:36:31 2005 @@ -59,7 +59,7 @@ run the mod_perl test suite, which opens a few hundreds of files, you will have a problem. e.g. the test suite may fail as: - [Wed Aug 25 09:49:40 2004] [info] 26 Apache:: modules loaded + [Wed Aug 25 09:49:40 2004] [info] 26 Apache2:: modules loaded [Wed Aug 25 09:49:40 2004] [info] 7 APR:: modules loaded [Wed Aug 25 09:49:40 2004] [info] base server + 20 vhosts ready to run tests @@ -219,7 +219,7 @@ =head2 EltPerlEgt directive missing closing 'Egt' -See the LApache::PerlSections|docs::2.0::api::Apache::PerlSections/E_lt_PerlE_gt__directive_missing_closing__E_gt__ manpage. +See the LApache2::PerlSections|docs::2.0::api::Apache2::PerlSections/E_lt_PerlE_gt__directive_missing_closing__E_gt__ manpage. =head2 'Invalid per-unknown PerlOption: ParseHeaders' on HP-UX 11 for PA-RISC @@ -689,7 +689,7 @@ in order to load the XS subroutines. For example: - % perl -MApache2 -MAPR -MAPR::UUID -le 'print APR::UUID-new-format' + % perl -MAPR -MAPR::UUID -le 'print APR::UUID-new-format' - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r159855 - in perl/modperl/docs/trunk/src/docs/2.0/user/porting: compat.pod porting.pod
Author: randyk Date: Sat Apr 2 17:04:11 2005 New Revision: 159855 URL: http://svn.apache.org/viewcvs?view=revrev=159855 Log: s/Apache/Apache2/, and also remove the discussion about this renaming. Modified: perl/modperl/docs/trunk/src/docs/2.0/user/porting/compat.pod perl/modperl/docs/trunk/src/docs/2.0/user/porting/porting.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/user/porting/compat.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/user/porting/compat.pod?view=diffr1=159854r2=159855 == --- perl/modperl/docs/trunk/src/docs/2.0/user/porting/compat.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/user/porting/compat.pod Sat Apr 2 17:04:11 2005 @@ -18,7 +18,7 @@ about Lporting XS modules|docs::2.0::devel::porting::porting). As it will be explained in details later, loading -CLApache::compat|docs::2.0::api::Apache::compat at the server +CLApache2::compat|docs::2.0::api::Apache2::compat at the server startup, should make the code running properly under 1.0 work under mod_perl 2.0. If you want to port your code to mod_perl 2.0 or writing from scratch and not concerned about backwards compatibility, this @@ -131,7 +131,7 @@ =head2 C$Apache::Server::StrictPerlSections In mod_perl 2.0, CLEltPerlEgt -sections|docs::2.0::api::Apache::PerlSections errors are now always +sections|docs::2.0::api::Apache2::PerlSections errors are now always fatal. Any error in them will cause an immediate server startup abort, dumping the error to STDERR. To avoid this, Ceval {} can be used to trap errors and ignore them. In mod_perl 1.0, Cstrict was somewhat @@ -143,8 +143,8 @@ =head2 C$Apache::Server::SaveConfig C$Apache::Server::SaveConfig has been renamed to -C$Apache::PerlSections::Save. see CLEltPerlEgt -sections|docs::2.0::api::Apache::PerlSections for more information +C$Apache2::PerlSections::Save. see CLEltPerlEgt +sections|docs::2.0::api::Apache2::PerlSections for more information on this global variable. @@ -212,7 +212,7 @@ gain a complete compatibilty with 1.0 while running under 2.0, you should load the compatibility module as early as possible: - use Apache::compat; + use Apache2::compat; at the server startup. And unless there are forgotten things or bugs, your code should work without any changes under 2.0 series. @@ -225,44 +225,6 @@ This document explains what APIs have changed and what new APIs should be used instead. -If you have mod_perl 1.0 and 2.0 installed on the same system and the -two use the same perl libraries directory (e.g. I/usr/lib/perl5), to -use mod_perl 2.0 make sure to load first the CApache2 module which -will perform the necessary adjustments to C@INC. - - use Apache2; # if you have 1.0 and 2.0 installed - use Apache::compat; - -So if before loading CApache2.pm the C@INC array consisted of: - - /home/stas/perl/ithread/lib/5.8.0/i686-linux-thread-multi - /home/stas/perl/ithread/lib/5.8.0 - /home/stas/perl/ithread/lib/site_perl/5.8.0/i686-linux-thread-multi - /home/stas/perl/ithread/lib/site_perl/5.8.0 - /home/stas/perl/ithread/lib/site_perl - . - -It will now look as: - - /home/stas/perl/ithread/lib/site_perl/5.8.0/i686-linux-thread-multi/Apache2 - /home/stas/perl/ithread/lib/5.8.0/i686-linux-thread-multi - /home/stas/perl/ithread/lib/5.8.0 - /home/stas/perl/ithread/lib/site_perl/5.8.0/i686-linux-thread-multi - /home/stas/perl/ithread/lib/site_perl/5.8.0 - /home/stas/perl/ithread/lib/site_perl - . - -Notice that a new directory was prepended to the search path, so if -for example the code attempts to load CApache::RequestRec and there -are two versions of this module undef -I/home/stas/perl/ithread/lib/site_perl/: - - 5.8.0/i686-linux-thread-multi/Apache/RequestRec.pm - 5.8.0/i686-linux-thread-multi/Apache2/Apache/RequestRec.pm - -The mod_perl 2.0 version will be loaded first, because the directory -I5.8.0/i686-linux-thread-multi/Apache2 is coming before the -directory I5.8.0/i686-linux-thread-multi in C@INC. Finally, mod_perl 2.0 has all its methods spread across many modules. In order to use these methods the modules containing them @@ -292,7 +254,7 @@ CApache::Registry, CApache::PerlRun and other modules from the registry family now live in the CModPerl:: namespace. In mod_perl 2.0 we put mod_perl specific functionality into the CModPerl:: -namespace, similar to CAPR:: and CApache:: which are used for apr +namespace, similar to CAPR:: and CApache2:: which are used for apr and apache features, respectively. At this moment @@ -385,7 +347,7 @@ =over -=item CLApache::Const|docs::2.0::api::Apache::Const +=item CLApache2::Const|docs::2.0::api::Apache2::Const Apache constants @@ -404,7 +366,7 @@ META: add the info how to perform the transition. XXX: may be write a script, which can tell you how to port the constants to 2.0? Currently -CLApache::compat|docs::2.0::api::Apache::compat
svn commit: r159856 - perl/modperl/docs/trunk/src/docs/2.0/api/Apache
Author: randyk Date: Sat Apr 2 17:05:53 2005 New Revision: 159856 URL: http://svn.apache.org/viewcvs?view=revrev=159856 Log: remove Apache directory, as all files are now under Apache2. Removed: perl/modperl/docs/trunk/src/docs/2.0/api/Apache/ - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r159887 - perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/compat.pod
Author: randyk Date: Sat Apr 2 21:06:25 2005 New Revision: 159887 URL: http://svn.apache.org/viewcvs?view=revrev=159887 Log: s/Apache/Apache2/ Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/compat.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/compat.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/compat.pod?view=diffr1=159886r2=159887 == --- perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/compat.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/compat.pod Sat Apr 2 21:06:25 2005 @@ -1,6 +1,6 @@ =head1 NAME -Apache::compat -- 1.0 backward compatibility functions deprecated in 2.0 +Apache2::compat -- 1.0 backward compatibility functions deprecated in 2.0 @@ -9,16 +9,14 @@ =head1 Synopsis # either add at the very beginning of startup.pl - use Apache2 - use Apache::compat; + use Apache2::compat; # or httpd.conf - PerlModule Apache2 - PerlModule Apache::compat + PerlModule Apache2::compat # override and restore compat functions colliding with mp2 API - Apache::compat::override_mp2_api('Apache::Connection::local_addr'); + Apache2::compat::override_mp2_api('Apache2::Connection::local_addr'); my ($local_port, $local_addr) = sockaddr_in($c-local_addr); - Apache::compat::restore_mp2_api('Apache::Connection::local_addr'); + Apache2::compat::restore_mp2_api('Apache2::Connection::local_addr'); @@ -27,7 +25,7 @@ =head1 Description -CApache::compat provides mod_perl 1.0 compatibility layer and can be +CApache2::compat provides mod_perl 1.0 compatibility layer and can be used to smooth the transition process to mod_perl 2.0. It includes functions that have changed their API or were removed in @@ -51,7 +49,7 @@ =head1 Compatibility Functions Colliding with mod_perl 2.0 API -Most of the functions provided by Apache::compat don't interfere with +Most of the functions provided by Apache2::compat don't interfere with mod_perl 2.0 API. However there are several functions which have the same name in the mod_perl 1.0 and mod_perl 2.0 API, accept the same number of arguments, but either the arguments themselves aren't the @@ -64,7 +62,7 @@ should be adjusted to be: - require Apache::Connection; + require Apache2::Connection; require APR::SockAddr; my $sockaddr = $c-local_addr; my ($local_port, $local_addr) = ($sockaddr-port, $sockaddr-ip_get); @@ -74,7 +72,7 @@ As you can see in mod_perl 1.0 API local_addr() was returning a SOCKADDR_IN object (see the Socket perl manpage), in mod_perl 2.0 API it returns an CLAPR::SockAddr|docs::2.0::api::APR::SockAddr -object, which is a totally different beast. If Apache::compat +object, which is a totally different beast. If Apache2::compat overrides the function Clocal_addr() to be back-compatible with mod_perl 1.0 API. Any code that relies on this function to work as it should under mod_perl 2.0 will be broken. Therefore the solution is @@ -92,9 +90,9 @@ you could do the following: - Apache::compat::override_mp2_api('Apache::Connection::local_addr'); + Apache2::compat::override_mp2_api('Apache2::Connection::local_addr'); my ($local_port, $local_addr) = Socket::sockaddr_in($c-local_addr); - Apache::compat::restore_mp2_api('Apache::Connection::local_addr'); + Apache2::compat::restore_mp2_api('Apache2::Connection::local_addr'); Notice that you need to restore the API as soon as possible. @@ -113,17 +111,17 @@ =over -=item * CApache::RequestRec::notes +=item * CApache2::RequestRec::notes -=item * CApache::RequestRec::filename +=item * CApache2::RequestRec::filename -=item * CApache::RequestRec::finfo +=item * CApache2::RequestRec::finfo -=item * CApache::Connection::local_addr +=item * CApache2::Connection::local_addr -=item * CApache::Connection::remote_addr +=item * CApache2::Connection::remote_addr -=item * CApache::Util::ht_time +=item * CApache2::Util::ht_time =item * CAPR::URI::unparse @@ -140,18 +138,18 @@ =head1 Use in CPAN Modules -The short answer: BDo not use CApache::compat in CPAN modules. +The short answer: BDo not use CApache2::compat in CPAN modules. The long answer: -CApache::compat is useful during the mod_perl 1.0 code +CApache2::compat is useful during the mod_perl 1.0 code porting. Though remember that it's implemented in pure Perl. In certain cases it overrides mod_perl 2.0 methods, because their API is very different and doesn't map 1:1 to mod_perl 1.0. So if anything, -not under user's control, loads CApache::compat user's code is +not under user's control, loads CApache2::compat user's code is forced to use the potentially slower method. Which is quite bad. -Some users may choose to keep using CApache::compat in production +Some users may choose to keep using CApache2::compat in production and it may perform just fine. Other users will choose not to use that module
svn commit: r159892 - perl/modperl/docs/trunk/README
Author: randyk Date: Sat Apr 2 21:46:08 2005 New Revision: 159892 URL: http://svn.apache.org/viewcvs?view=revrev=159892 Log: Update readme with information on svn access. Modified: perl/modperl/docs/trunk/README Modified: perl/modperl/docs/trunk/README URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/README?view=diffr1=159891r2=159892 == --- perl/modperl/docs/trunk/README (original) +++ perl/modperl/docs/trunk/README Sat Apr 2 21:46:08 2005 @@ -1,25 +1,35 @@ This is mod_perl 2.0 docs documentation+site project repository -The repository is called modperl-docs. The src/docs/2.0 is also checked -out into modperl-2.0 tree. +the mod_perl project at the Apache Software Foundation lives here -You can get the repository in one of these ways: + http://svn.apache.org/repos/asf/perl/ - % cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic login +and uses the following structure -password: anoncvs + modperl/trunk # equivalent to cvs HEAD - currently + # the mod_perl 2.0 development branch - % cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic co modperl-docs + modperl/tags# every official mod_perl release -The documentation CVS snapshots (rolled every 6 hours) can be -downloaded from http://cvs.apache.org/snapshots/modperl-docs/ + modperl/docs/trunk # the mod_perl documentation project + +Developers with commit access should use https:// to access +these repositories. See + + http://svnbook.red-bean.com/ + +for svn information in general, and + + http://svnbook.red-bean.com/en/1.0/apa.html + +for a discussion of svn for cvs users (including migration tools): You probably want to subscribe to these two mailing lists: [EMAIL PROTECTED] [EMAIL PROTECTED] -The first one is for cvs commits and the second is for discussions. +The first one is for commits and the second is for discussions. Then you can post to the modperl-docs discussion list. To post take the [EMAIL PROTECTED] address and remove the @@ -28,30 +38,13 @@ You can generate diffs with: -% cvs diff -u filename(s) - -Or you create: ~/.cvsrc with: -cvs -z9 -update -dP -diff -u - -(which includes other useful opts) and then you just need - -% cvs diff filename(s) +% svn diff filename(s) Send the commits aligned in the body of the message so we can comment on -them. Unless your browser mangles formatted text. - -Thanks! +them. Unless your browser mangles formatted text. Thanks! Docs Dev mainling list's archive: Epigone: http://mathforum.org/epigone/modperl-docs-dev - -There is also rsync interface for those who want to keep local mirrors -and hopefull offload the main apache.org servers: - - rsync://cvs.apache.org/modperl-docs modperl-docs CVS tree, exported (updated 4x/day) - rsync://cvs.apache.org/modperl-docs-cvs modperl-docs CVS Repository. If you are interested in helping us creating great documentation by reviewing what gets committed and submitting new docs and patches, - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r159799 - in perl/modperl/docs/trunk/src/docs/2.0/api/Apache2: ./ Access.pod
Author: randyk Date: Sat Apr 2 11:27:41 2005 New Revision: 159799 URL: http://svn.apache.org/viewcvs?view=revrev=159799 Log: s/Apache/Apache2/ Added: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/ - copied from r159778, perl/modperl/docs/trunk/src/docs/2.0/api/Apache/ Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Access.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Access.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Access.pod?view=diffr1=159778r2=159799 == --- perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Access.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Access.pod Sat Apr 2 11:27:41 2005 @@ -1,6 +1,6 @@ =head1 NAME -Apache::Access - A Perl API for Apache request object: Access, +Apache2::Access - A Perl API for Apache request object: Access, Authentication and Authorization. @@ -9,7 +9,7 @@ =head1 Synopsis - use Apache::Access (); + use Apache2::Access (); # allow only GET method $r-allow_methods(1, qw(GET)); @@ -62,8 +62,8 @@ The API provided by this module deals with access, authentication and authorization phases. -CApache::Access extends -CLApache::RequestRec|docs::2.0::api::Apache::RequestRec|/Description. +CApache2::Access extends +CLApache2::RequestRec|docs::2.0::api::Apache2::RequestRec|/Description. @@ -74,7 +74,7 @@ =head1 API -CApache::Access provides the following functions and/or methods: +CApache2::Access provides the following functions and/or methods: @@ -90,7 +90,7 @@ =over 4 =item obj: C$r -( CLApache::RequestRec object|docs::2.0::api::Apache::RequestRec ) +( CLApache2::RequestRec object|docs::2.0::api::Apache2::RequestRec ) The current request @@ -128,15 +128,15 @@ =over 4 =item obj: C$r -( CLApache::RequestRec object|docs::2.0::api::Apache::RequestRec ) +( CLApache2::RequestRec object|docs::2.0::api::Apache2::RequestRec ) The current request =item ret: C$options ( integer ) the COptions bitmask. Normally used with bitlogic operators against -CLApache::Const :options -constants|docs::2.0::api::Apache::Const/C__options_. +CLApache2::Const :options +constants|docs::2.0::api::Apache2::Const/C__options_. =item since: 1.99_12 @@ -149,10 +149,10 @@ The following applies: - use Apache::Const -compile = qw(:options); - $r-allow_options Apache::OPT_INDEXES; # TRUE - $r-allow_options Apache::OPT_SYM_LINKS; # TRUE - $r-allow_options Apache::OPT_EXECCGI; # FALSE + use Apache2::Const -compile = qw(:options); + $r-allow_options Apache2::OPT_INDEXES; # TRUE + $r-allow_options Apache2::OPT_SYM_LINKS; # TRUE + $r-allow_options Apache2::OPT_EXECCGI; # FALSE @@ -170,15 +170,15 @@ =over 4 =item obj: C$r -( CLApache::RequestRec object|docs::2.0::api::Apache::RequestRec ) +( CLApache2::RequestRec object|docs::2.0::api::Apache2::RequestRec ) The current request =item ret: C$allow_override ( integer ) the CAllowOverride bitmask. Normally used with bitlogic operators -against CLApache::Const :override -constants|docs::2.0::api::Apache::Const/C__override_. +against CLApache2::Const :override +constants|docs::2.0::api::Apache2::Const/C__override_. =item since: 1.99_12 @@ -190,9 +190,9 @@ The following applies: - use Apache::Const -compile = qw(:override); - $r-allow_overrides Apache::OR_AUTHCFG; # TRUE - $r-allow_overrides Apache::OR_LIMIT; # FALSE + use Apache2::Const -compile = qw(:override); + $r-allow_overrides Apache2::OR_AUTHCFG; # TRUE + $r-allow_overrides Apache2::OR_LIMIT; # FALSE @@ -210,7 +210,7 @@ =over 4 =item obj: C$r -( CLApache::RequestRec object|docs::2.0::api::Apache::RequestRec ) +( CLApache2::RequestRec object|docs::2.0::api::Apache2::RequestRec ) The current request @@ -255,7 +255,7 @@ =over 4 =item obj: C$r -( CLApache::RequestRec object|docs::2.0::api::Apache::RequestRec ) +( CLApache2::RequestRec object|docs::2.0::api::Apache2::RequestRec ) The current request @@ -293,20 +293,20 @@ =over 4 =item obj: C$r -( CLApache::RequestRec object|docs::2.0::api::Apache::RequestRec ) +( CLApache2::RequestRec object|docs::2.0::api::Apache2::RequestRec ) The current request =item ret1: C$rc -( CLApache::Const constant|docs::2.0::api::Apache::Const ) +( CLApache2::Const constant|docs::2.0::api::Apache2::Const ) -CApache::OK if the C$passwd value is set (and assured a correct +CApache2::OK if the C$passwd value is set (and assured a correct value in -CL$r-Egtuser|docs::2.0::api::Apache::RequestRec/C_user_); +CL$r-Egtuser|docs::2.0::api::Apache2::RequestRec/C_user_); otherwise it returns an error code, either -CApache::HTTP_INTERNAL_SERVER_ERROR if things are really confused, -CApache::HTTP_UNAUTHORIZED if no authentication at all seemed to be -in use, or CApache::DECLINED if there was authentication, but it +CApache2
svn commit: r159802 - perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Command.pod
Author: randyk Date: Sat Apr 2 11:34:09 2005 New Revision: 159802 URL: http://svn.apache.org/viewcvs?view=revrev=159802 Log: s/Apache/Apache2/ Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Command.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Command.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Command.pod?view=diffr1=159801r2=159802 == --- perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Command.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Command.pod Sat Apr 2 11:34:09 2005 @@ -1,15 +1,15 @@ =head1 NAME -Apache::Command - Perl API for accessing Apache module command information +Apache2::Command - Perl API for accessing Apache module command information =head1 Synopsis - use Apache::Module (); - use Apache::Command (); - my $module = Apache::Module::find_linked_module('mod_perl.c'); + use Apache2::Module (); + use Apache2::Command (); + my $module = Apache2::Module::find_linked_module('mod_perl.c'); for (my $cmd = $module-cmds; $cmd; $cmd = $cmd-next) { $cmd-args_how(); @@ -25,7 +25,7 @@ =head1 Description -CApache::Command provides the Perl API for accessing Apache module +CApache2::Command provides the Perl API for accessing Apache module command information @@ -35,7 +35,7 @@ =head1 API -CApache::Command provides the following functions and/or methods: +CApache2::Command provides the following functions and/or methods: @@ -51,13 +51,13 @@ =over 4 =item obj: C$cmd -( CLApache::Command object|docs::2.0::api::Apache::Command ) +( CLApache2::Command object|docs::2.0::api::Apache2::Command ) -=item ret: C$how ( CLApache::Const :cmd_how -constant|docs::2.0::api::Apache::Const/C__cmd_how_ ) +=item ret: C$how ( CLApache2::Const :cmd_how +constant|docs::2.0::api::Apache2::Const/C__cmd_how_ ) The flag value representing the type of this command -(i.e. CApache::ITERATE, CApache::TAKE2). +(i.e. CApache2::ITERATE, CApache2::TAKE2). =item since: 1.99_12 @@ -78,7 +78,7 @@ =over 4 =item obj: C$cmd -( CLApache::Command object|docs::2.0::api::Apache::Command ) +( CLApache2::Command object|docs::2.0::api::Apache2::Command ) =item ret: C$error ( string ) @@ -103,7 +103,7 @@ =over 4 =item obj: C$cmd -( CLApache::Command object|docs::2.0::api::Apache::Command ) +( CLApache2::Command object|docs::2.0::api::Apache2::Command ) =item ret: C$name ( string ) @@ -127,10 +127,10 @@ =over 4 =item obj: C$cmd -( CLApache::Command object|docs::2.0::api::Apache::Command ) +( CLApache2::Command object|docs::2.0::api::Apache2::Command ) =item ret: C$next -( CLApache::Command object|docs::2.0::api::Apache::Command ) +( CLApache2::Command object|docs::2.0::api::Apache2::Command ) Returns the next command in the chain for this module, Cundef for the last command. @@ -155,13 +155,13 @@ =over 4 =item obj: C$cmd -( CLApache::Command object|docs::2.0::api::Apache::Command ) +( CLApache2::Command object|docs::2.0::api::Apache2::Command ) -=item ret: C$override ( CLApache::Const :override -constant|docs::2.0::api::Apache::Const/C__override_ ) +=item ret: C$override ( CLApache2::Const :override +constant|docs::2.0::api::Apache2::Const/C__override_ ) The bit mask representing the overrides this command is allowed in -(i.e CApache::OR_ALL/CApache::ACCESS_CONF). +(i.e CApache2::OR_ALL/CApache2::ACCESS_CONF). =item since: 1.99_12 @@ -169,9 +169,9 @@ For example: - use Apache::Const -compile = qw(:override); - $cmd-req_override() Apache::OR_AUTHCFG; - $cmd-req_override() Apache::OR_LIMIT; + use Apache2::Const -compile = qw(:override); + $cmd-req_override() Apache2::OR_AUTHCFG; + $cmd-req_override() Apache2::OR_LIMIT; - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r159814 - perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Directive.pod
Author: randyk Date: Sat Apr 2 13:28:00 2005 New Revision: 159814 URL: http://svn.apache.org/viewcvs?view=revrev=159814 Log: s/Apache/Apache2/ Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Directive.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Directive.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Directive.pod?view=diffr1=159813r2=159814 == --- perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Directive.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Directive.pod Sat Apr 2 13:28:00 2005 @@ -1,15 +1,15 @@ =head1 NAME -Apache::Directive - Perl API for manipulating the Apache configuration tree +Apache2::Directive - Perl API for manipulating the Apache configuration tree =head1 Synopsis - use Apache::Directive (); + use Apache2::Directive (); - my $tree = Apache::Directive::conftree(); + my $tree = Apache2::Directive::conftree(); my $documentroot = $tree-lookup('DocumentRoot'); @@ -52,7 +52,7 @@ =head1 Description -CApache::Directive provides the Perl API for manipulating the Apache +CApache2::Directive provides the Perl API for manipulating the Apache configuration tree @@ -61,7 +61,7 @@ =head1 API -CApache::Directive provides the following functions and/or methods: +CApache2::Directive provides the following functions and/or methods: @@ -76,7 +76,7 @@ =over 4 =item obj: C$node -( CLApache::Directive object|docs::2.0::api::Apache::Directive ) +( CLApache2::Directive object|docs::2.0::api::Apache2::Directive ) =item ret: C$args ( string ) @@ -92,7 +92,7 @@ And later: - my $tree = Apache::Directive::conftree(); + my $tree = Apache2::Directive::conftree(); my $node = $tree-lookup('PerlSwitches'); my $args = $node-args; @@ -114,7 +114,7 @@ =over 4 =item obj: C$conftree -( CLApache::Directive object|docs::2.0::api::Apache::Directive ) +( CLApache2::Directive object|docs::2.0::api::Apache2::Directive ) The config tree to stringify @@ -133,7 +133,7 @@ And later: - my $tree = Apache::Directive::conftree(); + my $tree = Apache2::Directive::conftree(); my $node = $tree-lookup('Location', '/test/'); my $hash = $node-as_hash; @@ -160,7 +160,7 @@ =over 4 =item obj: C$node -( CLApache::Directive object|docs::2.0::api::Apache::Directive ) +( CLApache2::Directive object|docs::2.0::api::Apache2::Directive ) The config tree to stringify @@ -179,7 +179,7 @@ And later: - my $tree = Apache::Directive::conftree(); + my $tree = Apache2::Directive::conftree(); my $node = $tree-lookup('Location', '/test/'); my $string = $node-as_string; @@ -197,14 +197,14 @@ Get the root of the configuration tree: - $conftree = Apache::Directive::conftree(); + $conftree = Apache2::Directive::conftree(); =over 4 -=item obj: CApache::Directive ( class name ) +=item obj: CApache2::Directive ( class name ) =item ret: C$conftree -( CLApache::Directive object|docs::2.0::api::Apache::Directive ) +( CLApache2::Directive object|docs::2.0::api::Apache2::Directive ) =item since: 1.99_12 @@ -225,7 +225,7 @@ =over 4 =item obj: C$node -( CLApache::Directive object|docs::2.0::api::Apache::Directive ) +( CLApache2::Directive object|docs::2.0::api::Apache2::Directive ) =item ret: C$name ( string ) @@ -248,7 +248,7 @@ =over 4 =item obj: C$node -( CLApache::Directive object|docs::2.0::api::Apache::Directive ) +( CLApache2::Directive object|docs::2.0::api::Apache2::Directive ) =item ret: C$filename ( string ) @@ -258,7 +258,7 @@ For example: - my $tree = Apache::Directive::conftree(); + my $tree = Apache2::Directive::conftree(); my $node = $tree-lookup('VirtualHost', 'example.com'); my $filename = $node-filename; @@ -266,7 +266,7 @@ VirtualHost was defined in. If the directive was added with -CLadd_config()|docs::2.0::api::Apache::ServerUtil/C_add_config_, +CLadd_config()|docs::2.0::api::Apache2::ServerUtil/C_add_config_, the filename will be the path to the Fhttpd.conf that trigerred that Perl code. @@ -284,10 +284,10 @@ =over 4 =item obj: C$node -( CLApache::Directive object|docs::2.0::api::Apache::Directive ) +( CLApache2::Directive object|docs::2.0::api::Apache2::Directive ) =item ret: C$child_node -( CLApache::Directive object|docs::2.0::api::Apache::Directive ) +( CLApache2::Directive object|docs::2.0::api::Apache2::Directive ) Returns the first child node of C$node, Cundef if there is none @@ -311,7 +311,7 @@ =over 4 =item obj: C$node -( CLApache::Directive object|docs::2.0::api::Apache::Directive ) +( CLApache2::Directive object|docs::2.0::api::Apache2::Directive ) =item arg1: C$lineno (integer) @@ -336,7 +336,7 @@ =over 4 =item obj: C$conftree -( CLApache::Directive object|docs::2.0::api::Apache::Directive ) +( CLApache2::Directive object|docs::2.0::api::Apache2
svn commit: r159817 - perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/HookRun.pod
Author: randyk Date: Sat Apr 2 13:33:30 2005 New Revision: 159817 URL: http://svn.apache.org/viewcvs?view=revrev=159817 Log: s/Apache/Apache2/ Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/HookRun.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/HookRun.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/HookRun.pod?view=diffr1=159816r2=159817 == --- perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/HookRun.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/HookRun.pod Sat Apr 2 13:33:30 2005 @@ -1,6 +1,6 @@ =head1 NAME -Apache::HookRun - Perl API for Invoking Apache HTTP phases +Apache2::HookRun - Perl API for Invoking Apache HTTP phases @@ -8,74 +8,74 @@ =head1 Synopsis # httpd.conf - PerlProcessConnectionHandler MyApache::PseudoHTTP::handler + PerlProcessConnectionHandler MyApache2::PseudoHTTP::handler - #file:MyApache/PseudoHTTP.pm + #file:MyApache2/PseudoHTTP.pm #--- - package MyApache::PseudoHTTP; + package MyApache2::PseudoHTTP; - use Apache::HookRun (); - use Apache::RequestUtil (); - use Apache::RequestRec (); + use Apache2::HookRun (); + use Apache2::RequestUtil (); + use Apache2::RequestRec (); - use Apache::Const -compile = qw(OK DECLINED DONE SERVER_ERROR); + use Apache2::Const -compile = qw(OK DECLINED DONE SERVER_ERROR); # implement the HTTP protocol cycle in protocol handler sub handler { my $c = shift; - my $r = Apache::RequestRec-new($c); + my $r = Apache2::RequestRec-new($c); # register any custom callbacks here, e.g.: # $r-push_handlers(PerlAccessHandler = \my_access); $rc = $r-run_post_read_request(); - return $rc unless $rc == Apache::OK or $rc == Apache::DECLINED; + return $rc unless $rc == Apache2::OK or $rc == Apache2::DECLINED; $rc = $r-run_translate_name; - return $rc unless $rc == Apache::OK or $rc == Apache::DECLINED; + return $rc unless $rc == Apache2::OK or $rc == Apache2::DECLINED; $rc = $r-run_map_to_storage; - return $rc unless $rc == Apache::OK or $rc == Apache::DECLINED; + return $rc unless $rc == Apache2::OK or $rc == Apache2::DECLINED; # this must be run all a big havoc will happen in the following # phases $r-location_merge($path); $rc = $r-run_header_parser; - return $rc unless $rc == Apache::OK or $rc == Apache::DECLINED; + return $rc unless $rc == Apache2::OK or $rc == Apache2::DECLINED; my $args = $r-args || ''; if ($args eq 'die') { - $r-die(Apache::SERVER_ERROR); - return Apache::DONE; + $r-die(Apache2::SERVER_ERROR); + return Apache2::DONE; } $rc = $r-run_access_checker; - return $rc unless $rc == Apache::OK or $rc == Apache::DECLINED; + return $rc unless $rc == Apache2::OK or $rc == Apache2::DECLINED; $rc = $r-run_auth_checker; - return $rc unless $rc == Apache::OK or $rc == Apache::DECLINED; + return $rc unless $rc == Apache2::OK or $rc == Apache2::DECLINED; $rc = $r-run_check_user_id; - return $rc unless $rc == Apache::OK or $rc == Apache::DECLINED; + return $rc unless $rc == Apache2::OK or $rc == Apache2::DECLINED; $rc = $r-run_type_checker; - return $rc unless $rc == Apache::OK or $rc == Apache::DECLINED; + return $rc unless $rc == Apache2::OK or $rc == Apache2::DECLINED; $rc = $r-run_fixups; - return $rc unless $rc == Apache::OK or $rc == Apache::DECLINED; + return $rc unless $rc == Apache2::OK or $rc == Apache2::DECLINED; # $r-run_handler is called internally by $r-invoke_handler, # invoke_handler sets all kind of filters, and does a few other # things but it's possible to call $r-run_handler, bypassing # invoke_handler $rc = $r-invoke_handler; - return $rc unless $rc == Apache::OK or $rc == Apache::DECLINED; + return $rc unless $rc == Apache2::OK or $rc == Apache2::DECLINED; $rc = $r-run_log_transaction; - return $rc unless $rc == Apache::OK or $rc == Apache::DECLINED; + return $rc unless $rc == Apache2::OK or $rc == Apache2::DECLINED; - return Apache::OK; + return Apache2::OK; } @@ -84,7 +84,7 @@ =head1 Description -CApache::HookRun exposes parts of the Apache HTTP protocol +CApache2::HookRun exposes parts of the Apache HTTP protocol implementation, responsible for invoking callbacks for each LHTTP Request cycle phase|docs::2.0::user::handlers::http/HTTP_Request_Cycle_Phases. @@ -113,7 +113,7 @@ =head1 API -CApache::HookRun provides the following functions and/or methods: +CApache2::HookRun provides the following functions and/or methods: @@ -131,7 +131,7 @@ =over 4 =item obj: C$r -( CLApache
svn commit: r159818 - perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Log.pod
Author: randyk Date: Sat Apr 2 13:38:09 2005 New Revision: 159818 URL: http://svn.apache.org/viewcvs?view=revrev=159818 Log: s/Apache/Apache2/ Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Log.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Log.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Log.pod?view=diffr1=159817r2=159818 == --- perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Log.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Log.pod Sat Apr 2 13:38:09 2005 @@ -1,6 +1,6 @@ =head1 NAME -Apache::Log - Perl API for Apache Logging Methods +Apache2::Log - Perl API for Apache Logging Methods @@ -9,21 +9,21 @@ # in startup.pl #-- - use Apache::Log; + use Apache2::Log; - use Apache::Const -compile = qw(OK :log); + use Apache2::Const -compile = qw(OK :log); use APR::Const-compile = qw(:error SUCCESS); - my $s = Apache-server; + my $s = Apache2-server; $s-log_error(server: log_error); - $s-log_serror(__FILE__, __LINE__, Apache::LOG_ERR, + $s-log_serror(__FILE__, __LINE__, Apache2::LOG_ERR, APR::SUCCESS, log_serror logging at err level); - $s-log_serror(Apache::Log::LOG_MARK, Apache::LOG_DEBUG, + $s-log_serror(Apache2::Log::LOG_MARK, Apache2::LOG_DEBUG, APR::ENOTIME, debug print); - Apache::ServerRec-log_error(routine warning); + Apache2::ServerRec-log_error(routine warning); - Apache::ServerRec::warn(routine warning); + Apache2::ServerRec::warn(routine warning); # in a handler #- @@ -32,9 +32,9 @@ use strict; use warnings FATAL = 'all'; - use Apache::Log; + use Apache2::Log; - use Apache::Const -compile = qw(OK :log); + use Apache2::Const -compile = qw(OK :log); use APR::Const-compile = qw(:error SUCCESS); sub handler { @@ -51,33 +51,33 @@ my $s = $r-server; $s-log_error(server: log_error); - $r-log_rerror(Apache::Log::LOG_MARK, Apache::LOG_DEBUG, + $r-log_rerror(Apache2::Log::LOG_MARK, Apache2::LOG_DEBUG, APR::ENOTIME, in debug); - $s-log_serror(Apache::Log::LOG_MARK, Apache::LOG_INFO, + $s-log_serror(Apache2::Log::LOG_MARK, Apache2::LOG_INFO, APR::SUCCESS, server info); - $s-log_serror(Apache::Log::LOG_MARK, Apache::LOG_ERR, + $s-log_serror(Apache2::Log::LOG_MARK, Apache2::LOG_ERR, APR::ENOTIME, fatal error); $r-log_reason(fatal error); $r-warn('routine request warning'); $s-warn('routine server warning'); - return Apache::OK; + return Apache2::OK; } 1; # in a registry script # httpd.conf: PerlOptions +GlobalRequest - use Apache::ServerRec qw(warn); # override warn locally + use Apache2::ServerRec qw(warn); # override warn locally print Content-type: text/plain\n\n; warn my warning; =head1 Description -CApache::Log provides the Perl API for Apache logging methods. +CApache2::Log provides the Perl API for Apache logging methods. Depending on the the current CLogLevel setting, only logging with the same log level or higher will be loaded. For example if the @@ -85,28 +85,28 @@ of the level Iwarning or higher (Ierr, Icrit, Ielert and Iemerg) will be logged. Therefore this: - $r-log_rerror(Apache::Log::LOG_MARK, Apache::LOG_WARNING, + $r-log_rerror(Apache2::Log::LOG_MARK, Apache2::LOG_WARNING, APR::ENOTIME, warning!); will log the message, but this one won't: - $r-log_rerror(Apache::Log::LOG_MARK, Apache::LOG_INFO, + $r-log_rerror(Apache2::Log::LOG_MARK, Apache2::LOG_INFO, APR::ENOTIME, just an info); It will be logged only if the server log level is set to Iinfo or Idebug. CLogLevel is set in the configuration file, but can be changed using the -CL$s-Egtloglevel()|docs::2.0::api::Apache::ServerRec/C_loglevel_ +CL$s-Egtloglevel()|docs::2.0::api::Apache2::ServerRec/C_loglevel_ method. The filename and the line number of the caller are logged only if -CApache::LOG_DEBUG is used (because that's how Apache 2.0 logging +CApache2::LOG_DEBUG is used (because that's how Apache 2.0 logging mechanism works). Note: On Win32 Apache attempts to lock all writes to a file whenever it's opened for append (which is the case with logging functions), as Unix has this behavior built-in, while Win32 does not. Therefore -CApache::Log functions could be slower than Perl's print()/warn(). +CApache2::Log functions could be slower than Perl's print()/warn(). @@ -116,11 +116,11 @@ Log level constants can be compiled all at once: - use Apache::Const -compile = qw(:log); + use Apache2::Const -compile = qw(:log); or individually: - use Apache::Const -compile = qw(LOG_DEBUG LOG_INFO); + use Apache2::Const -compile = qw(LOG_DEBUG LOG_INFO
svn commit: r159819 - perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Module.pod
Author: randyk Date: Sat Apr 2 13:39:46 2005 New Revision: 159819 URL: http://svn.apache.org/viewcvs?view=revrev=159819 Log: s/Apache/Apache2/ Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Module.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Module.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Module.pod?view=diffr1=159818r2=159819 == --- perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Module.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Module.pod Sat Apr 2 13:39:46 2005 @@ -1,13 +1,13 @@ =head1 NAME -Apache::Module - Perl API for creating and working with Apache modules +Apache2::Module - Perl API for creating and working with Apache modules =head1 Synopsis - use Apache::Module (); + use Apache2::Module (); #Define a configuration directive my @directives = ( @@ -16,10 +16,10 @@ } ); - Apache::Module::add(__PACKAGE__, [EMAIL PROTECTED]); + Apache2::Module::add(__PACKAGE__, [EMAIL PROTECTED]); # iterate over the whole module list - for (my $modp = Apache::Module::top_module(); $modp; $modp = $modp-next) { + for (my $modp = Apache2::Module::top_module(); $modp; $modp = $modp-next) { my $name = $modp-name; my $index = $modp-module_index; my $ap_api_major_version = $modp-ap_api_major_version; @@ -28,7 +28,7 @@ } # find a specific module - my $module = Apache::Module::find_linked_module('mod_ssl.c'); + my $module = Apache2::Module::find_linked_module('mod_ssl.c'); # remove a specific module $module-remove_loaded_module(); @@ -36,17 +36,17 @@ # access module configuration from a directive sub MyDirective { my ($self, $parms, $args) = @_; - my $srv_cfg = Apache::Module::get_config($self, $parms-server); + my $srv_cfg = Apache2::Module::get_config($self, $parms-server); [...] } # test if an Apache module is loaded - if (Apache::Module::loaded('mod_ssl.c')) { + if (Apache2::Module::loaded('mod_ssl.c')) { [...] } # test if a Perl module is loaded - if (Apache::Module::loaded('Apache::Status')) { + if (Apache2::Module::loaded('Apache2::Status')) { [...] } @@ -58,7 +58,7 @@ =head1 Description -CApache::Module provides the Perl API for creating and working with +CApache2::Module provides the Perl API for creating and working with Apache modules See LApache Server Configuration Customization in @@ -70,7 +70,7 @@ =head1 API -CApache::Module provides the following functions and/or methods: +CApache2::Module provides the following functions and/or methods: @@ -80,7 +80,7 @@ Add a module's custom configuration directive to Apache. - Apache::Module::add($package, $cmds); + Apache2::Module::add($package, $cmds); =over 4 @@ -117,7 +117,7 @@ =over 4 =item obj: C$module -( CLApache::Module object|docs::2.0::api::Apache::Module ) +( CLApache2::Module object|docs::2.0::api::Apache2::Module ) =item ret: C$major_version ( integer ) @@ -142,7 +142,7 @@ =over 4 =item obj: C$module -( CLApache::Module object|docs::2.0::api::Apache::Module ) +( CLApache2::Module object|docs::2.0::api::Apache2::Module ) =item ret: C$minor_version ( integer ) @@ -160,7 +160,7 @@ =head2 Ccmds -Get the CLApache::Command|docs::2.0::api::Apache::Command object, +Get the CLApache2::Command|docs::2.0::api::Apache2::Command object, describing all of the directives this module defines. $command = $module-cmds(); @@ -168,10 +168,10 @@ =over 4 =item obj: C$module -( CLApache::Module object|docs::2.0::api::Apache::Module ) +( CLApache2::Module object|docs::2.0::api::Apache2::Module ) =item ret: C$command -( CLApache::Command object|docs::2.0::api::Apache::Command ) +( CLApache2::Command object|docs::2.0::api::Apache2::Command ) =item since: 1.99_12 @@ -187,33 +187,33 @@ Retrieve a module's configuration. Used by configuration directives. - $cfg = Apache::Module::get_config($class, $server, $dir_config); - $cfg = Apache::Module::get_config($class, $server); + $cfg = Apache2::Module::get_config($class, $server, $dir_config); + $cfg = Apache2::Module::get_config($class, $server); $cfg = $self-get_config($server, $dir_config); $cfg = $self-get_config($server); =over 4 =item obj: C$module -( CLApache::Module object|docs::2.0::api::Apache::Module ) +( CLApache2::Module object|docs::2.0::api::Apache2::Module ) =item arg1: C$class ( string ) The Perl package this configuration is for =item arg2: C$server -( CLApache::ServerRec object|docs::2.0::api::Apache::ServerRec ) +( CLApache2::ServerRec object|docs::2.0::api::Apache2::ServerRec ) The current server, typically -CL$r-Egtserver|docs::2.0::api::Apache::ServerUtil or -CL$parms-Egtserver|docs::2.0::api::Apache::CmdParms
svn commit: r159820 - perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/PerlSections.pod
Author: randyk Date: Sat Apr 2 13:42:07 2005 New Revision: 159820 URL: http://svn.apache.org/viewcvs?view=revrev=159820 Log: s/Apache/Apache2/ Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/PerlSections.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/PerlSections.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/PerlSections.pod?view=diffr1=159819r2=159820 == --- perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/PerlSections.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/PerlSections.pod Sat Apr 2 13:42:07 2005 @@ -1,6 +1,6 @@ =head1 NAME -Apache::PerlSections - Default Handler for Perl sections +Apache2::PerlSections - Default Handler for Perl sections @@ -73,7 +73,7 @@ or - Apache-httpd_conf(PerlPassEnv $key $val); + Apache2-httpd_conf(PerlPassEnv $key $val); These are somewhat simple examples, but they should give you the basic idea. You can mix in any Perl code you desire. See Ieg/httpd.conf.pl @@ -124,7 +124,7 @@ $PerlConfig .= Alias /foo /bar\n; See also -CL$r-Egtadd_config|docs::2.0::api::Apache::RequestUtil/C_add_config_ +CL$r-Egtadd_config|docs::2.0::api::Apache2::RequestUtil/C_add_config_ @@ -139,14 +139,14 @@ -=head2 C$Apache::PerlSections::Save +=head2 C$Apache2::PerlSections::Save Each CEltPerlEgt section is evaluated in its unique namespace, -by default residing in a sub-namespace of CApache::ReadConfig::, +by default residing in a sub-namespace of CApache2::ReadConfig::, therefore any local variables will end up in that namespace. For example if a CEltPerlEgt section happened to be in file F/tmp/httpd.conf starting on line 20, the namespace: -CApache::ReadConfig::tmp::httpd_conf::line_20 will be used. Now if +CApache2::ReadConfig::tmp::httpd_conf::line_20 will be used. Now if it had: Perl @@ -156,19 +156,19 @@ /Perl The local global variable C$foo becomes -C$Apache::ReadConfig::tmp::httpd_conf::line_20::foo, the other +C$Apache2::ReadConfig::tmp::httpd_conf::line_20::foo, the other variable remain where they are. By default, the namespace in which CEltPerlEgt sections are evaluated is cleared after each block closes. In our example nuking -C$Apache::ReadConfig::tmp::httpd_conf::line_20::foo, leaving the +C$Apache2::ReadConfig::tmp::httpd_conf::line_20::foo, leaving the rest untouched. -By setting C$Apache::PerlSections::Save to a true value, the content +By setting C$Apache2::PerlSections::Save to a true value, the content of those namespaces will be preserved and will be available for -inspection by CLApache::Status|docs::2.0::api::Apache::Status and -CLApache::PerlSections-Egtdump|/C_Apache__PerlSections_E_gt_dump_ -In our example C$Apache::ReadConfig::tmp::httpd_conf::line_20::foo +inspection by CLApache2::Status|docs::2.0::api::Apache2::Status and +CLApache2::PerlSections-Egtdump|/C_Apache2__PerlSections_E_gt_dump_ +In our example C$Apache2::ReadConfig::tmp::httpd_conf::line_20::foo will still be accessible from other perl code, after the CEltPerlEgt section was parsed. @@ -180,7 +180,7 @@ -=head2 CApache::PerlSections-Egtdump +=head2 CApache2::PerlSections-Egtdump This method will dump out all the configuration variables mod_perl will be feeding to the apache config gears. The output is suitable to @@ -190,13 +190,13 @@ Perl - $Apache::PerlSections::Save = 1; + $Apache2::PerlSections::Save = 1; $Port = 8529; $Location{/perl} = { SetHandler = perl-script, - PerlHandler = Apache::Registry, + PerlHandler = ModPerl::Registry, Options = ExecCGI, }; @@ -217,7 +217,7 @@ /Perl Perl - print Apache::PerlSections-dump; + print Apache2::PerlSections-dump; /Perl This will print something like this: @@ -230,7 +230,7 @@ ); $Location{'/perl'} = ( - PerlHandler = 'Apache::Registry', + PerlHandler = 'Apache2::Registry', SetHandler = 'perl-script', Options = 'ExecCGI' ); @@ -260,7 +260,7 @@ -=head2 CApache::PerlSections-Egtstore +=head2 CApache2::PerlSections-Egtstore This method will call the Cdump method, writing the output to a file, suitable to be pulled in via Crequire or Cdo. @@ -272,7 +272,7 @@ =head1 Advanced API mod_perl 2.0 now introduces the same general concept of handlers to -CEltPerlEgt sections. Apache::PerlSections simply being the +CEltPerlEgt sections. Apache2::PerlSections simply being the default handler for them. To specify a different handler for a given perl section, an extra @@ -301,7 +301,7 @@ self-explanatory =item arg2: C$parms -( CLApache::CmdParms|docs::2.0::api::Apache::CmdParms ) +( CLApache2::CmdParms|docs::2.0::api::Apache2::CmdParms ) C$parms is specific for the current Container, for example, you might want to call C$parms-Egtserver() to get the current server. @@ -313,7 +313,7
svn commit: r159821 - perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/porting.pod
Author: randyk Date: Sat Apr 2 13:53:01 2005 New Revision: 159821 URL: http://svn.apache.org/viewcvs?view=revrev=159821 Log: s/Apache/Apache2/ Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/porting.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/porting.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/porting.pod?view=diffr1=159820r2=159821 == --- perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/porting.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/porting.pod Sat Apr 2 13:53:01 2005 @@ -1,18 +1,16 @@ =head1 NAME -Apache::porting -- a helper module for mod_perl 1.0 to mod_perl 2.0 porting +Apache2::porting -- a helper module for mod_perl 1.0 to mod_perl 2.0 porting =head1 Synopsis # either add at the very beginning of startup.pl - use Apache2; - use Apache::porting; + use Apache2::porting; # or httpd.conf - PerlModule Apache2 - PerlModule Apache::porting + PerlModule Apache2::porting # now issue requests and look at the error_log file for hints @@ -21,7 +19,7 @@ =head1 Description -CApache::porting helps to port mod_perl 1.0 code to run under +CApache2::porting helps to port mod_perl 1.0 code to run under mod_perl 2.0. It doesn't provide any back-compatibility functionality, however it knows to trap methods calls that are no longer in the mod_perl 2.0 API and tell what should be used instead if at all. If @@ -31,10 +29,10 @@ in mod_perl 2.0 it'll also tell you what are the modules that should be used instead. -CApache::porting communicates with users via the Ierror_log +CApache2::porting communicates with users via the Ierror_log file. Everytime it traps a problem, it logs the solution (if it finds one) to the error log file. If you use this module coupled with -CLApache::Reload|docs::2.0::api::Apache::Reload you will be able +CLApache2::Reload|docs::2.0::api::Apache2::Reload you will be able to port your applications quickly without needing to restart the server on every modification. @@ -53,7 +51,7 @@ =head1 Culprits -CApache::porting uses the CUNIVERSAL::AUTOLOAD function to provide +CApache2::porting uses the CUNIVERSAL::AUTOLOAD function to provide its functionality. However it seems to be impossible to create CUNIVERSAL::AUTOLOAD at the server startup, Apache segfaults on restart. Therefore it performs the setting of CUNIVERSAL::AUTOLOAD @@ -65,7 +63,7 @@ reproduce the problem try to use an earlier phase, e.g. CPerlPostConfigHandler: - Apache-server-push_handlers(PerlPostConfigHandler = \porting_autoload); + Apache2-server-push_handlers(PerlPostConfigHandler = \porting_autoload); META: Though there is a better solution at work, which assigns AUTOLOAD for each class separately, instead of using UNIVERSAL. See - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r159822 - perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Process.pod
Author: randyk Date: Sat Apr 2 13:54:51 2005 New Revision: 159822 URL: http://svn.apache.org/viewcvs?view=revrev=159822 Log: s/Apache/Apache2/ Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Process.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Process.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Process.pod?view=diffr1=159821r2=159822 == --- perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Process.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Process.pod Sat Apr 2 13:54:51 2005 @@ -1,14 +1,14 @@ =head1 NAME -Apache::Process - Perl API for Apache process record +Apache2::Process - Perl API for Apache process record =head1 Synopsis - use Apache::Process (); - use Apache::ServerRec (); + use Apache2::Process (); + use Apache2::ServerRec (); my $proc = $s-process; # global pool cleared on exit @@ -27,11 +27,11 @@ =head1 Description -CApache::Process provides the API for the Apache process object, +CApache2::Process provides the API for the Apache process object, which you can retrieve with -CL$s-Egtprocess|docs::2.0::api::Apache::ServerRec/C_process_: +CL$s-Egtprocess|docs::2.0::api::Apache2::ServerRec/C_process_: - use Apache::ServerRec (); + use Apache2::ServerRec (); $proc = $s-process; @@ -39,7 +39,7 @@ =head1 API -CApache::Process provides the following functions and/or methods: +CApache2::Process provides the following functions and/or methods: @@ -53,7 +53,7 @@ =over 4 =item obj: C$proc -( CLApache::Process object|docs::2.0::api::Apache::Process ) +( CLApache2::Process object|docs::2.0::api::Apache2::Process ) =item ret: C$p ( CLAPR::Pool object|docs::2.0::api::APR::Pool ) @@ -79,7 +79,7 @@ =over 4 =item obj: C$proc -( CLApache::Process object|docs::2.0::api::Apache::Process ) +( CLApache2::Process object|docs::2.0::api::Apache2::Process ) =item ret: C$p ( CLAPR::Pool object|docs::2.0::api::APR::Pool ) @@ -106,7 +106,7 @@ =over 4 =item obj: C$proc -( CLApache::Process object|docs::2.0::api::Apache::Process ) +( CLApache2::Process object|docs::2.0::api::Apache2::Process ) =item ret: C$short_name (string) - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r159823 - perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Reload.pod
Author: randyk Date: Sat Apr 2 13:56:47 2005 New Revision: 159823 URL: http://svn.apache.org/viewcvs?view=revrev=159823 Log: s/Apache/Apache2/ Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Reload.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Reload.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Reload.pod?view=diffr1=159822r2=159823 == --- perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Reload.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Reload.pod Sat Apr 2 13:56:47 2005 @@ -1,50 +1,50 @@ =head1 NAME -Apache::Reload - Reload Perl Modules when Changed on Disk +Apache2::Reload - Reload Perl Modules when Changed on Disk =head1 Synopsis # Monitor and reload all modules in %INC: # httpd.conf: - PerlModule Apache::Reload - PerlInitHandler Apache::Reload + PerlModule Apache2::Reload + PerlInitHandler Apache2::Reload # when working with protocols and connection filters - # PerlPreConnectionHandler Apache::Reload + # PerlPreConnectionHandler Apache2::Reload # Reload groups of modules: # httpd.conf: - PerlModule Apache::Reload - PerlInitHandler Apache::Reload + PerlModule Apache2::Reload + PerlInitHandler Apache2::Reload PerlSetVar ReloadAll Off - PerlSetVar ReloadModules ModPerl::* Apache::* + PerlSetVar ReloadModules ModPerl::* Apache2::* #PerlSetVar ReloadDebug On # Reload a single module from within itself: - package My::Apache::Module; - use Apache::Reload; + package My::Apache2::Module; + use Apache2::Reload; sub handler { ... } 1; =head1 Description -CApache::Reload reloads modules that change on the disk. +CApache2::Reload reloads modules that change on the disk. When Perl pulls a file via Crequire, it stores the filename in the global hash C%INC. The next time Perl tries to Crequire the same file, it sees the file in C%INC and does not reload from disk. This module's handler can be configured to iterate over the modules in C%INC and reload those that have changed on disk or only specific -modules that have registered themselves with CApache::Reload. It can +modules that have registered themselves with CApache2::Reload. It can also do the check for modified modules, when a special touch-file has been modified. -Note that CApache::Reload operates on the current context of +Note that CApache2::Reload operates on the current context of C@INC. Which means, when called as a CPerl*Handler it will not -see C@INC paths added or removed by CApache::Registry scripts, as +see C@INC paths added or removed by CModPerl::Registry scripts, as the value of C@INC is saved on server startup and restored to that value after each request. In other words, if you want -CApache::Reload to work with modules that live in custom C@INC +CApache2::Reload to work with modules that live in custom C@INC paths, you should modify C@INC when the server is started. Besides, C'use lib' in the startup script, you can also set the CPERL5LIB variable in the httpd's environment to include any non-standard 'lib' @@ -64,30 +64,30 @@ request's processing, simply add the following configuration to your Ihttpd.conf: - PerlModule Apache::Reload - PerlInitHandler Apache::Reload + PerlModule Apache2::Reload + PerlInitHandler Apache2::Reload When working with connection filters and protocol modules -CApache::Reload should be invoked in the pre_connection stage: +CApache2::Reload should be invoked in the pre_connection stage: - PerlPreConnectionHandler Apache::Reload + PerlPreConnectionHandler Apache2::Reload See also the discussion on CLPerlPreConnectionHandler|docs::2.0::user::handlers::protocols/PerlPreConnectionHandler. =head2 Register Modules Implicitly -To only reload modules that have registered with CApache::Reload, +To only reload modules that have registered with CApache2::Reload, add the following to the Ihttpd.conf: - PerlModule Apache::Reload - PerlInitHandler Apache::Reload + PerlModule Apache2::Reload + PerlInitHandler Apache2::Reload PerlSetVar ReloadAll Off # ReloadAll defaults to On Then any modules with the line: - use Apache::Reload; + use Apache2::Reload; Will be reloaded when they change. @@ -96,8 +96,8 @@ You can also register modules explicitly in your Ihttpd.conf file that you want to be reloaded on change: - PerlModule Apache::Reload - PerlInitHandler Apache::Reload + PerlModule Apache2::Reload + PerlInitHandler Apache2::Reload PerlSetVar ReloadAll Off PerlSetVar ReloadModules My::Foo My::Bar Foo::Bar::Test @@ -107,31 +107,31 @@ The C* wild character can be used to register groups of files under the same namespace. For example the setting: - PerlSetVar ReloadModules ModPerl::* Apache::* + PerlSetVar ReloadModules ModPerl::* Apache2::* will monitor all modules under the namespaces CModPerl
svn commit: r159829 - perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/ServerRec.pod
Author: randyk Date: Sat Apr 2 14:07:08 2005 New Revision: 159829 URL: http://svn.apache.org/viewcvs?view=revrev=159829 Log: s/Apache/Apache2/ Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/ServerRec.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/ServerRec.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/ServerRec.pod?view=diffr1=159828r2=159829 == --- perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/ServerRec.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/ServerRec.pod Sat Apr 2 14:07:08 2005 @@ -1,13 +1,13 @@ =head1 NAME -Apache::ServerRec - Perl API for Apache server record accessors +Apache2::ServerRec - Perl API for Apache server record accessors =head1 Synopsis - use Apache::ServerRec (); + use Apache2::ServerRec (); $error_fname = $s-error_fname(); @@ -33,7 +33,7 @@ $timeout = $s-timeout(); $loglevel = $s-loglevel(); - my $server = Apache-server; + my $server = Apache2-server; my $vhosts = 0; for (my $s = $server-next; $s; $s = $s-next) { $vhosts++; @@ -49,10 +49,10 @@ =head1 Description -CApache::ServerRec provides the Perl API for Apache server_rec +CApache2::ServerRec provides the Perl API for Apache server_rec object. -CLApache::ServerUtil|docs::2.0::api::Apache::ServerUtil provides +CLApache2::ServerUtil|docs::2.0::api::Apache2::ServerUtil provides an extra functionality. @@ -61,7 +61,7 @@ =head1 API -CApache::ServerRec provides the following functions and/or methods: +CApache2::ServerRec provides the following functions and/or methods: @@ -78,7 +78,7 @@ =over 4 =item obj: C$s -( CLApache::ServerRec object|docs::2.0::api::Apache::ServerRec ) +( CLApache2::ServerRec object|docs::2.0::api::Apache2::ServerRec ) =item opt arg1: C$new_error_fname ( string ) @@ -112,7 +112,7 @@ =over 4 =item obj: C$s -( CLApache::ServerRec object|docs::2.0::api::Apache::ServerRec ) +( CLApache2::ServerRec object|docs::2.0::api::Apache2::ServerRec ) =item ret: C$is_virtual ( boolean ) @@ -146,7 +146,7 @@ =over 4 =item obj: C$s -( CLApache::ServerRec object|docs::2.0::api::Apache::ServerRec ) +( CLApache2::ServerRec object|docs::2.0::api::Apache2::ServerRec ) =item opt arg1: C$new_keep_alive ( boolean ) @@ -184,7 +184,7 @@ =over 4 =item obj: C$s -( CLApache::ServerRec object|docs::2.0::api::Apache::ServerRec ) +( CLApache2::ServerRec object|docs::2.0::api::Apache2::ServerRec ) =item opt arg1: C$new_keep_alive_max ( integer ) @@ -221,7 +221,7 @@ =over 4 =item obj: C$s -( CLApache::ServerRec object|docs::2.0::api::Apache::ServerRec ) +( CLApache2::ServerRec object|docs::2.0::api::Apache2::ServerRec ) =item opt arg1: C$new_keep_alive_timeout ( integer ) @@ -257,7 +257,7 @@ =over 4 =item obj: C$s -( CLApache::ServerRec object|docs::2.0::api::Apache::ServerRec ) +( CLApache2::ServerRec object|docs::2.0::api::Apache2::ServerRec ) =item opt arg1: C$new_limit_req_fields ( integer ) @@ -292,7 +292,7 @@ =over 4 =item obj: C$s -( CLApache::ServerRec object|docs::2.0::api::Apache::ServerRec ) +( CLApache2::ServerRec object|docs::2.0::api::Apache2::ServerRec ) =item opt arg1: C$new_limit_req_fieldsize ( integer ) @@ -326,7 +326,7 @@ =over 4 =item obj: C$s -( CLApache::ServerRec object|docs::2.0::api::Apache::ServerRec ) +( CLApache2::ServerRec object|docs::2.0::api::Apache2::ServerRec ) =item opt arg1: C$new_limit_req_line ( integer ) @@ -362,18 +362,18 @@ =over 4 =item obj: C$s -( CLApache::ServerRec object|docs::2.0::api::Apache::ServerRec ) +( CLApache2::ServerRec object|docs::2.0::api::Apache2::ServerRec ) -=item opt arg1: C$new_loglevel ( CLApache::Const :log -constant|docs::2.0::api::Apache::Const/C__log_ ) +=item opt arg1: C$new_loglevel ( CLApache2::Const :log +constant|docs::2.0::api::Apache2::Const/C__log_ ) If passed, sets a new CLogLevel value Note the Llimited functionality under threaded MPMs|/Limited_Functionality_under_Threaded_MPMs. -=item ret: C$loglevel ( CLApache::Const :log -constant|docs::2.0::api::Apache::Const/C__log_ ) +=item ret: C$loglevel ( CLApache2::Const :log +constant|docs::2.0::api::Apache2::Const/C__log_ ) Returns the CLogLevel value as a constant. @@ -385,8 +385,8 @@ For example, to set the CLogLevel value to Cinfo: - use Apache::Const -compile = qw(LOG_INFO); - $s-loglevel(Apache::LOG_INFO); + use Apache2::Const -compile = qw(LOG_INFO); + $s-loglevel(Apache2::LOG_INFO); @@ -402,10 +402,10 @@ =over 4 =item obj: C$s -( CLApache::ServerRec object|docs::2.0::api::Apache::ServerRec ) +( CLApache2::ServerRec object|docs::2.0::api::Apache2::ServerRec ) =item ret: C$s_next -( CLApache::ServerRec object|docs::2.0::api::Apache::ServerRec ) +( CLApache2::ServerRec object|docs::2.0::api::Apache2::ServerRec ) =item since: 1.99_15 @@ -415,9
svn commit: r159830 - perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/ServerUtil.pod
Author: randyk Date: Sat Apr 2 14:09:05 2005 New Revision: 159830 URL: http://svn.apache.org/viewcvs?view=revrev=159830 Log: s/Apache/Apache2/ Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/ServerUtil.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/ServerUtil.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/ServerUtil.pod?view=diffr1=159829r2=159830 == --- perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/ServerUtil.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/ServerUtil.pod Sat Apr 2 14:09:05 2005 @@ -1,14 +1,14 @@ =head1 NAME -Apache::ServerUtil - Perl API for Apache server record utils +Apache2::ServerUtil - Perl API for Apache server record utils =head1 Synopsis - use Apache::ServerUtil (); - $s = Apache-server; + use Apache2::ServerUtil (); + $s = Apache2-server; # push config $s-add_config(['ServerTokens off']); @@ -21,20 +21,20 @@ # check command line defines print this is mp2 - if Apache::ServerUtil::exists_config_define('MODPERL2'); + if Apache2::ServerUtil::exists_config_define('MODPERL2'); # get PerlChildExitHandler configured handlers @handlers = @{ $s-get_handlers('PerlChildExitHandler') || []}; # server build and version info: - $when_built = Apache::ServerUtil::get_server_built(); - $version = Apache::ServerUtil::get_server_version(); + $when_built = Apache2::ServerUtil::get_server_built(); + $version = Apache2::ServerUtil::get_server_version(); # ServerRoot value - $server_root = Apache::ServerUtil::server_root(); + $server_root = Apache2::ServerUtil::server_root(); # get 'conf/' dir path (avoid using this function!) - my $dir = Apache::ServerUtil::server_root_relative($r-pool, 'conf'); + my $dir = Apache2::ServerUtil::server_root_relative($r-pool, 'conf'); # set child_exit handlers $r-set_handlers(PerlChildExitHandler = \handler); @@ -47,10 +47,10 @@ $s-method_register('NEWGET'); # register server shutdown callback - Apache::ServerUtil::server_shutdown_register_cleanup(sub { Apache::OK }); + Apache2::ServerUtil::server_shutdown_register_cleanup(sub { Apache2::OK }); # do something only when the server restarts - my $cnt = Apache::ServerUtil::restart_count(); + my $cnt = Apache2::ServerUtil::restart_count(); do_something_once() if $cnt 1; @@ -59,15 +59,15 @@ =head1 Description -CApache::ServerUtil provides the LApache server -object|docs::2.0::api::Apache::ServerRec utilities API. +CApache2::ServerUtil provides the LApache server +object|docs::2.0::api::Apache2::ServerRec utilities API. =head1 Methods API -CApache::ServerUtil provides the following functions and/or methods: +CApache2::ServerUtil provides the following functions and/or methods: @@ -82,7 +82,7 @@ =over 4 =item obj: C$s -( CLApache::ServerRec object|docs::2.0::api::Apache::ServerRec ) +( CLApache2::ServerRec object|docs::2.0::api::Apache2::ServerRec ) =item arg1: C$lines ( ARRAY ref ) @@ -96,22 +96,22 @@ =back See also: -CL$r-Egtadd_config|docs::2.0::api::Apache::RequestUtil/C_add_config_ +CL$r-Egtadd_config|docs::2.0::api::Apache2::RequestUtil/C_add_config_ For example: Add a configuration section at the server startup (e.g. from Istartup.pl): - use Apache::ServerUtil (); + use Apache2::ServerUtil (); my $conf = 'EOC'; - PerlModule Apache::MyExample + PerlModule Apache2::MyExample Location /perl SetHandler perl-script -PerlResponseHandler Apache::MyExample +PerlResponseHandler Apache2::MyExample /Location EOC - Apache-server-add_config([split /\n/, $conf]); + Apache2-server-add_config([split /\n/, $conf]); @@ -128,7 +128,7 @@ =over 4 =item obj: C$s -( CLApache::ServerRec object|docs::2.0::api::Apache::ServerRec ) +( CLApache2::ServerRec object|docs::2.0::api::Apache2::ServerRec ) =item arg1: C$component ( string ) @@ -154,16 +154,16 @@ For example let's add a component IHikers, Inc/0.9 to the server string at the server startup: - use Apache::ServerUtil (); - use Apache::Const -compile = 'OK'; + use Apache2::ServerUtil (); + use Apache2::Const -compile = 'OK'; - Apache-server-push_handlers( + Apache2-server-push_handlers( PerlPostConfigHandler = \add_my_version); sub add_my_version { my($conf_pool, $log_pool, $temp_pool, $s) = @_; $s-add_version_component(Hikers, Inc/0.9); - return Apache::OK; + return Apache2::OK; } or of course you could register the @@ -191,7 +191,7 @@ Register server shutdown cleanup callback: - Apache::ServerUtil::server_shutdown_cleanup_register($sub); + Apache2::ServerUtil::server_shutdown_cleanup_register($sub); =over 4 @@ -214,7 +214,7 @@ run every time the server shuts down (or restarts), run the following code at the server startup
svn commit: r159832 - perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Status.pod
Author: randyk Date: Sat Apr 2 14:12:11 2005 New Revision: 159832 URL: http://svn.apache.org/viewcvs?view=revrev=159832 Log: s/Apache/Apache2/ Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Status.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Status.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Status.pod?view=diffr1=159831r2=159832 == --- perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Status.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/Status.pod Sat Apr 2 14:12:11 2005 @@ -1,6 +1,6 @@ =head1 NAME -Apache::Status - Embedded interpreter status information +Apache2::Status - Embedded interpreter status information @@ -9,7 +9,7 @@ Location /perl-status SetHandler modperl - PerlResponseHandler Apache::Status + PerlResponseHandler Apache2::Status /Location @@ -18,14 +18,14 @@ =head1 Description -The CApache::Status module provides some information +The CApache2::Status module provides some information about the status of the Perl interpreter embedded in the server. Configure like so: Location /perl-status SetHandler modperl - PerlResponseHandler Apache::Status + PerlResponseHandler Apache2::Status /Location Notice that under the @@ -34,17 +34,17 @@ under that handler. To see the environment seen by handlers running under the CLperl-script|docs::2.0::user::config::config/C_perl_script_ -core handler, configure CApache::Status as: +core handler, configure CApache2::Status as: Location /perl-status SetHandler perl-script - PerlResponseHandler Apache::Status + PerlResponseHandler Apache2::Status /Location Other modules can plugin a menu item like so: - require Apache::Module; - Apache::Status-menu_item( + require Apache2::Module; + Apache2::Status-menu_item( 'DBI' = DBI connections, #item for Apache::DBI module sub { my($r, $q) = @_; #request and CGI objects @@ -52,9 +52,9 @@ push @strings, blobs of html; return [EMAIL PROTECTED]; #return an array ref } - ) if Apache::Module::loaded('Apache::Status'); + ) if Apache2::Module::loaded('Apache2::Status'); -BWARNING: CApache::Status must be loaded before these modules via +BWARNING: CApache2::Status must be loaded before these modules via the CPerlModule or CPerlRequire directives (or from Fstartup.pl). @@ -122,7 +122,7 @@ =head2 CStatusTerseSizeMainSummary With this option COn and the CB::TerseSize module installed, a -IMemory Usage will be added to the CApache::Status main menu. +IMemory Usage will be added to the CApache2::Status main menu. This option is disabled by default, as it can be rather cpu intensive to summarize memory usage for the entire server. It is strongly suggested that this option only be used with a development server - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r159833 - perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/SubProcess.pod
Author: randyk Date: Sat Apr 2 14:12:50 2005 New Revision: 159833 URL: http://svn.apache.org/viewcvs?view=revrev=159833 Log: s/Apache/Apache2/ Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/SubProcess.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/SubProcess.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/SubProcess.pod?view=diffr1=159832r2=159833 == --- perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/SubProcess.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/SubProcess.pod Sat Apr 2 14:12:50 2005 @@ -1,6 +1,6 @@ =head1 NAME -Apache::SubProcess -- Executing SubProcesses under mod_perl +Apache2::SubProcess -- Executing SubProcesses under mod_perl @@ -8,7 +8,7 @@ =head1 Synopsis - use Apache::SubProcess (); + use Apache2::SubProcess (); use Config; use constant PERLIO_IS_ENABLED = $Config{useperlio}; @@ -52,7 +52,7 @@ =head1 Description -CApache::SubProcess provides the Perl API for running and +CApache2::SubProcess provides the Perl API for running and communicating with processes spawned from mod_perl handlers. At the moment it's possible to spawn only external program in a new @@ -81,7 +81,7 @@ =over 4 =item obj: C$r -( CLApache::RequestRec object|docs::2.0::api::Apache::RequestRec ) +( CLApache2::RequestRec object|docs::2.0::api::Apache2::RequestRec ) =item arg1: C$command ( string ) @@ -155,7 +155,7 @@ close/reopen its communication streams. For example, spawn a process as: - use Apache::SubProcess (); + use Apache2::SubProcess (); $r-spawn_proc_prog ('/path/to/detach_script.pl', $args); and the F/path/to/detach_script.pl contents are: - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r159834 - perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/SubRequest.pod
Author: randyk Date: Sat Apr 2 14:14:02 2005 New Revision: 159834 URL: http://svn.apache.org/viewcvs?view=revrev=159834 Log: s/Apache/Apache2/ Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/SubRequest.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/SubRequest.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/SubRequest.pod?view=diffr1=159833r2=159834 == --- perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/SubRequest.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/SubRequest.pod Sat Apr 2 14:14:02 2005 @@ -1,13 +1,13 @@ =head1 NAME -Apache::SubRequest - Perl API for Apache subrequests +Apache2::SubRequest - Perl API for Apache subrequests =head1 Synopsis - use Apache::SubRequest (); + use Apache2::SubRequest (); # run internal redirects at once $r-internal_redirect($new_uri); @@ -27,11 +27,11 @@ =head1 Description -CApache::SubRequest contains API for creating and running of Apache +CApache2::SubRequest contains API for creating and running of Apache sub-requests. -CApache::SubRequest is a sub-class of CLApache::RequestRec -object|docs::2.0::api::Apache::RequestRec. +CApache2::SubRequest is a sub-class of CLApache2::RequestRec +object|docs::2.0::api::Apache2::RequestRec. @@ -41,7 +41,7 @@ =head1 API -CApache::SubRequest provides the following functions and/or methods: +CApache2::SubRequest provides the following functions and/or methods: @@ -55,8 +55,8 @@ =over 4 -=item obj: C$subr ( CLApache::SubRequest -object|docs::2.0::api::Apache::SubRequest/Description ) +=item obj: C$subr ( CLApache2::SubRequest +object|docs::2.0::api::Apache2::SubRequest/Description ) The sub request to finish @@ -97,7 +97,7 @@ =over 4 =item obj: C$r -( CLApache::RequestRec object|docs::2.0::api::Apache::RequestRec ) +( CLApache2::RequestRec object|docs::2.0::api::Apache2::RequestRec ) The current request @@ -113,7 +113,7 @@ In case that you want some other request to be served as the top-level request instead of what the client requested directly, call this -method from a handler, and then immediately return CApache::OK. The +method from a handler, and then immediately return CApache2::OK. The client will be unaware the a different request was served to her behind the scenes. @@ -128,9 +128,9 @@ Identical to CLinternal_redirect|/C_internal_redirect_, plus automatically sets -CL$r-Egtcontent_type|docs::2.0::api::Apache::RequestRec/C_content_type_ +CL$r-Egtcontent_type|docs::2.0::api::Apache2::RequestRec/C_content_type_ is of the sub-request to be the same as of the main request, if -CL$r-Egthandler|docs::2.0::api::Apache::RequestRec/C_handler_ is +CL$r-Egthandler|docs::2.0::api::Apache2::RequestRec/C_handler_ is true. $r-internal_redirect_handler($new_uri); @@ -138,7 +138,7 @@ =over 4 =item obj: C$r -( CLApache::RequestRec object|docs::2.0::api::Apache::RequestRec ) +( CLApache2::RequestRec object|docs::2.0::api::Apache2::RequestRec ) The current request @@ -176,7 +176,7 @@ =over 4 =item obj: C$r -( CLApache::RequestRec object|docs::2.0::api::Apache::RequestRec ) +( CLApache2::RequestRec object|docs::2.0::api::Apache2::RequestRec ) The current request @@ -185,12 +185,12 @@ The file to lookup =item opt arg2: C$next_filter -( CLApache::Filter|docs::2.0::api::Apache::Filter ) +( CLApache2::Filter|docs::2.0::api::Apache2::Filter ) See CL$r-Egtlookup_uri|/C_lookup_uri_ for details. -=item ret: C$ret ( CLApache::SubRequest -object|docs::2.0::api::Apache::SubRequest/Description ) +=item ret: C$ret ( CLApache2::SubRequest +object|docs::2.0::api::Apache2::SubRequest/Description ) The sub request record. @@ -215,7 +215,7 @@ =over 4 =item obj: C$r -( CLApache::RequestRec object|docs::2.0::api::Apache::RequestRec ) +( CLApache2::RequestRec object|docs::2.0::api::Apache2::RequestRec ) The current request @@ -228,12 +228,12 @@ The URI to lookup =item opt arg3: C$next_filter -( CLApache::Filter object|docs::2.0::api::Apache::Filter ) +( CLApache2::Filter object|docs::2.0::api::Apache2::Filter ) See CL$r-Egtlookup_uri|/C_lookup_uri_ for details. -=item ret: C$ret ( CLApache::SubRequest -object|docs::2.0::api::Apache::SubRequest/Description ) +=item ret: C$ret ( CLApache2::SubRequest +object|docs::2.0::api::Apache2::SubRequest/Description ) The sub request record. @@ -258,7 +258,7 @@ =over 4 =item obj: C$r -( CLApache::RequestRec object|docs::2.0::api::Apache::RequestRec ) +( CLApache2::RequestRec object|docs::2.0::api::Apache2::RequestRec ) The current request @@ -267,20 +267,20 @@ The URI to lookup =item opt arg2: C$next_filter -( CLApache::Filter object|docs::2.0::api::Apache::Filter ) +( CLApache2::Filter object|docs::2.0::api::Apache2::Filter ) The first filter the subrequest should pass the data through
svn commit: r159835 - perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/URI.pod
Author: randyk Date: Sat Apr 2 14:14:56 2005 New Revision: 159835 URL: http://svn.apache.org/viewcvs?view=revrev=159835 Log: s/Apache/Apache2/ Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/URI.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/URI.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/URI.pod?view=diffr1=159834r2=159835 == --- perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/URI.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/Apache2/URI.pod Sat Apr 2 14:14:56 2005 @@ -1,13 +1,13 @@ =head1 NAME -Apache::URI - Perl API for manipulating URIs +Apache2::URI - Perl API for manipulating URIs =head1 Synopsis - use Apache::URI (); + use Apache2::URI (); $hostport = $r-construct_server(); $hostport = $r-construct_server($hostname); @@ -23,7 +23,7 @@ $parsed_uri = $r-parsed_uri(); $url = join '%20', qw(one two three); - Apache::URI::unescape_url($url); + Apache2::URI::unescape_url($url); @@ -36,7 +36,7 @@ =head1 Description While CAPR::URI provides a generic API to dissect, adjust and put -together any given URI string, CApache::URI provides an API specific +together any given URI string, CApache2::URI provides an API specific to Apache, by taking the information directly from the C$r object. Therefore when manipulating the URI of the current HTTP request usually methods from both classes are used. @@ -48,7 +48,7 @@ =head1 API -CApache::URI provides the following functions and methods: +CApache2::URI provides the following functions and methods: @@ -67,7 +67,7 @@ =over 4 =item obj: C$r -( CLApache::RequestRec object|docs::2.0::api::Apache::RequestRec ) +( CLApache2::RequestRec object|docs::2.0::api::Apache2::RequestRec ) The current request object @@ -76,7 +76,7 @@ The hostname of the server. If that argument is not passed, -CL$r-Egtget_server_name|docs::2.0::api::Apache::RequestUtil/C_get_server_name_ +CL$r-Egtget_server_name|docs::2.0::api::Apache2::RequestUtil/C_get_server_name_ is used. =item opt arg2: C$port ( string ) @@ -84,7 +84,7 @@ The port the server is running on. If that argument is not passed, -CL$r-Egtget_server_port|docs::2.0::api::Apache::RequestUtil/C_get_server_port_ +CL$r-Egtget_server_port|docs::2.0::api::Apache2::RequestUtil/C_get_server_port_ is used. =item opt arg3: C$pool @@ -93,7 +93,7 @@ The pool to allocate the string from. If that argument is not passed, -CL$r-Egtpool|docs::2.0::api::Apache::RequestRec/C_pool_ is used. +CL$r-Egtpool|docs::2.0::api::Apache2::RequestRec/C_pool_ is used. =item ret: C$hostport ( string ) @@ -151,7 +151,7 @@ =over 4 =item obj: C$r -( CLApache::RequestRec object|docs::2.0::api::Apache::RequestRec ) +( CLApache2::RequestRec object|docs::2.0::api::Apache2::RequestRec ) The current request object @@ -161,7 +161,7 @@ Ipath, Iquery and Ifragment components). If that argument is not passed, -CL$r-Egturi|docs::2.0::api::Apache::RequestRec/C_uri_ is used. +CL$r-Egturi|docs::2.0::api::Apache2::RequestRec/C_uri_ is used. =item opt arg2: C$pool ( CLAPR::Pool object|docs::2.0::api::APR::Pool ) @@ -169,7 +169,7 @@ The pool to allocate the URL from If that argument is not passed, -CL$r-Egtpool|docs::2.0::api::Apache::RequestRec/C_pool_ is used. +CL$r-Egtpool|docs::2.0::api::Apache2::RequestRec/C_pool_ is used. =item ret: C$url ( string ) @@ -234,7 +234,7 @@ =over 4 =item obj: C$r -( CLApache::RequestRec object|docs::2.0::api::Apache::RequestRec ) +( CLApache2::RequestRec object|docs::2.0::api::Apache2::RequestRec ) The current request object @@ -258,20 +258,20 @@ =item 1 -sets CL$r-Egtargs|docs::2.0::api::Apache::RequestRec/C_args_ to +sets CL$r-Egtargs|docs::2.0::api::Apache2::RequestRec/C_args_ to the rest after C'?' if such exists in the passed C$uri, otherwise sets it to Cundef. =item 2 -sets CL$r-Egturi|docs::2.0::api::Apache::RequestRec/C_uri_ to +sets CL$r-Egturi|docs::2.0::api::Apache2::RequestRec/C_uri_ to the passed C$uri without the -CL$r-Egtargs|docs::2.0::api::Apache::RequestRec/C_args_ part. +CL$r-Egtargs|docs::2.0::api::Apache2::RequestRec/C_args_ part. =item 3 sets -CL$r-Egthostname|docs::2.0::api::Apache::RequestRec/C_hostname_ +CL$r-Egthostname|docs::2.0::api::Apache2::RequestRec/C_hostname_ (if not set already) using the (Cscheme://host:port) parts of the passed C$uri. @@ -291,7 +291,7 @@ =over 4 =item obj: C$r -( CLApache::RequestRec object|docs::2.0::api::Apache::RequestRec ) +( CLApache2::RequestRec object|docs::2.0::api::Apache2::RequestRec ) The current request object @@ -317,7 +317,7 @@ Unescape URLs - Apache::URI::unescape_url($url); + Apache2::URI::unescape_url($url); =over 4 @@ -336,7 +336,7 @@ Example: my $url = join '%20', qw(one two three); - Apache::URI::unescape_url($url); + Apache2::URI
svn commit: r159838 - in perl/modperl/docs/trunk/src/docs/2.0/api/APR: Brigade.pod Bucket.pod BucketAlloc.pod Const.pod Error.pod Finfo.pod IpSubnet.pod OS.pod PerlIO.pod SockAddr.pod Socket.pod URI.pod
Author: randyk Date: Sat Apr 2 14:40:15 2005 New Revision: 159838 URL: http://svn.apache.org/viewcvs?view=revrev=159838 Log: s/Apache/Apache2/ Modified: perl/modperl/docs/trunk/src/docs/2.0/api/APR/Brigade.pod perl/modperl/docs/trunk/src/docs/2.0/api/APR/Bucket.pod perl/modperl/docs/trunk/src/docs/2.0/api/APR/BucketAlloc.pod perl/modperl/docs/trunk/src/docs/2.0/api/APR/Const.pod perl/modperl/docs/trunk/src/docs/2.0/api/APR/Error.pod perl/modperl/docs/trunk/src/docs/2.0/api/APR/Finfo.pod perl/modperl/docs/trunk/src/docs/2.0/api/APR/IpSubnet.pod perl/modperl/docs/trunk/src/docs/2.0/api/APR/OS.pod perl/modperl/docs/trunk/src/docs/2.0/api/APR/PerlIO.pod perl/modperl/docs/trunk/src/docs/2.0/api/APR/SockAddr.pod perl/modperl/docs/trunk/src/docs/2.0/api/APR/Socket.pod perl/modperl/docs/trunk/src/docs/2.0/api/APR/URI.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/api/APR/Brigade.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/APR/Brigade.pod?view=diffr1=159837r2=159838 == --- perl/modperl/docs/trunk/src/docs/2.0/api/APR/Brigade.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/APR/Brigade.pod Sat Apr 2 14:40:15 2005 @@ -381,8 +381,8 @@ Create a new bucket brigade, using the request object's pool: - use Apache::Connection (); - use Apache::RequestRec (); + use Apache2::Connection (); + use Apache2::RequestRec (); use APR::Brigade (); my $bb = APR::Brigade-new($r-pool, $r-connection-bucket_alloc); Modified: perl/modperl/docs/trunk/src/docs/2.0/api/APR/Bucket.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/APR/Bucket.pod?view=diffr1=159837r2=159838 == --- perl/modperl/docs/trunk/src/docs/2.0/api/APR/Bucket.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/APR/Bucket.pod Sat Apr 2 14:40:15 2005 @@ -185,7 +185,7 @@ Example: use APR::Bucket (); - use Apache::Connection (); + use Apache2::Connection (); my $ba = $c-bucket_alloc; my $eos_b = APR::Bucket::eos_create($ba); Modified: perl/modperl/docs/trunk/src/docs/2.0/api/APR/BucketAlloc.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/APR/BucketAlloc.pod?view=diffr1=159837r2=159838 == --- perl/modperl/docs/trunk/src/docs/2.0/api/APR/BucketAlloc.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/APR/BucketAlloc.pod Sat Apr 2 14:40:15 2005 @@ -56,7 +56,7 @@ You only need to use this method if you aren't running under httpd. If you are running under mod_perl, you already have a bucket allocation available via -CL$c-Egtbucket_alloc|docs::2.0::api::Apache::Connection/C_bucket_alloc_ +CL$c-Egtbucket_alloc|docs::2.0::api::Apache2::Connection/C_bucket_alloc_ and CL$bb-Egtbucket_alloc|docs::2.0::api::APR::Brigade/C_bucket_alloc_. Modified: perl/modperl/docs/trunk/src/docs/2.0/api/APR/Const.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/APR/Const.pod?view=diffr1=159837r2=159838 == --- perl/modperl/docs/trunk/src/docs/2.0/api/APR/Const.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/APR/Const.pod Sat Apr 2 14:40:15 2005 @@ -28,8 +28,8 @@ This package contains constants specific to CAPR features. -Refer to CLthe Apache::Const description -section|docs::2.0::api::Apache::Const/Description for more +Refer to CLthe Apache2::Const description +section|docs::2.0::api::Apache2::Const/Description for more information. Modified: perl/modperl/docs/trunk/src/docs/2.0/api/APR/Error.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/APR/Error.pod?view=diffr1=159837r2=159838 == --- perl/modperl/docs/trunk/src/docs/2.0/api/APR/Error.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/APR/Error.pod Sat Apr 2 14:40:15 2005 @@ -176,7 +176,7 @@ the code. my $rc = $c-input_filters-get_brigade($bb_in, - Apache::MODE_GETLINE); + Apache2::MODE_GETLINE); if ($rc != APR::SUCCESS $rc != APR::EOF) { my $error = APR::Error::strerror($rc); die get_brigade error: $rc: $error\n; Modified: perl/modperl/docs/trunk/src/docs/2.0/api/APR/Finfo.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/APR/Finfo.pod?view=diffr1=159837r2=159838 == --- perl/modperl/docs/trunk/src/docs/2.0/api/APR/Finfo.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/APR/Finfo.pod Sat Apr 2 14:40:15 2005 @@ -44,7 +44,7
svn commit: r159841 - in perl/modperl/docs/trunk/src/docs/2.0/devel/core: coding_style.pod explained.pod
Author: randyk Date: Sat Apr 2 14:53:42 2005 New Revision: 159841 URL: http://svn.apache.org/viewcvs?view=revrev=159841 Log: s/Apache/Apache2/ Modified: perl/modperl/docs/trunk/src/docs/2.0/devel/core/coding_style.pod perl/modperl/docs/trunk/src/docs/2.0/devel/core/explained.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/devel/core/coding_style.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/devel/core/coding_style.pod?view=diffr1=159840r2=159841 == --- perl/modperl/docs/trunk/src/docs/2.0/devel/core/coding_style.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/devel/core/coding_style.pod Sat Apr 2 14:53:42 2005 @@ -221,7 +221,7 @@ use IO::File (); -(explain how to use Apache::Status to find imported/exported +(explain how to use Apache2::Status to find imported/exported functions) =back Modified: perl/modperl/docs/trunk/src/docs/2.0/devel/core/explained.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/devel/core/explained.pod?view=diffr1=159840r2=159841 == --- perl/modperl/docs/trunk/src/docs/2.0/devel/core/explained.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/devel/core/explained.pod Sat Apr 2 14:53:42 2005 @@ -13,7 +13,7 @@ In its pristine state the project is comprised of the following directories and files residing at the root directory of the project: - Apache-Test/ - test kit for mod_perl and Apache::* modules + Apache-Test/ - test kit for mod_perl and Apache2::* modules ModPerl-Registry/ - ModPerl::Registry sub-project build/- utilities used during project build docs/ - documentation @@ -50,20 +50,20 @@ =head1 Directory xs/ - Apache/ - Apache specific XS code - APR/- APR specific XS code - ModPerl/- ModPerl specific XS code - maps/ - - tables/ - - Makefile.PL - - modperl_xs_sv_convert.h - - modperl_xs_typedefs.h - - modperl_xs_util.h - - typemap - + Apache2/ - Apache specific XS code + APR/ - APR specific XS code + ModPerl/ - ModPerl specific XS code + maps/- + tables/ - + Makefile.PL - + modperl_xs_sv_convert.h - + modperl_xs_typedefs.h- + modperl_xs_util.h- + typemap - -=head2 xs/Apache, xs/APR and xs/ModPerl +=head2 xs/Apache2, xs/APR and xs/ModPerl -The Ixs/Apache, Ixs/APR and Ixs/ModPerl directories include I.h files which +The Ixs/Apache2, Ixs/APR and Ixs/ModPerl directories include I.h files which have C and XS code in them. They all have the I.h extension because they are always C#include-d, never compiled into their own object file. and only the file that C#include-s an I.h file from these @@ -110,8 +110,8 @@ If you need to skip certain unwanted C defines from being picked by the source scanning you can add them to the array -C$Apache::ParseSource::defines_unwanted in -Ilib/Apache/ParseSource.pm. +C$Apache2::ParseSource::defines_unwanted in +Ilib/Apache2/ParseSource.pm. Notice that Isource_scan target is normally not run during the project build process, since the source scanning is not stable yet, @@ -164,15 +164,15 @@ =item * CMODULE the module name where the functions should be put. e.g. CMODULE -Apache::Connection will place the functions into -IWrapXS/Apache/Connection.{pm,xs}. +Apache2::Connection will place the functions into +IWrapXS/Apache2/Connection.{pm,xs}. =item * CPACKAGE the package name functions belong to, defaults to CMODULE. The value of Iguess indicates that package name should be guessed based on first argument found that maps to a Perl class. If the value is -not defined and the function's name starts with Iap_ the CApache +not defined and the function's name starts with Iap_ the CApache2 package will be used, if it starts with Iapr_ then the CAPR package is used. @@ -245,7 +245,7 @@ details see: C%ModPerl::MapUtil::disabled_map. The return type can be specified before the C function name. It -defaults to Ireturn_type in C{Apache,ModPerl}::FunctionTable. +defaults to Ireturn_type in C{Apache2,ModPerl}::FunctionTable. META: DEFINE nuances @@ -260,7 +260,7 @@ =item * Argspec The argspec defaults to arguments in -C{Apache,ModPerl}::FunctionTable. Argument types can be specified +C{Apache2,ModPerl}::FunctionTable. Argument types can be specified to override those in the CFunctionTable. Default values can be specified, e.g. Carg=default_value. Argspec of C... indicates Ipassthru, calling the function with C(aTHX_ I32 items, SP **sp, SV @@ -395,19 +395,19 @@ about to develop, so refer to this code to see how the functions
svn commit: r159842 - perl/modperl/docs/trunk/src/docs/2.0/devel/debug/c.pod
Author: randyk Date: Sat Apr 2 14:55:54 2005 New Revision: 159842 URL: http://svn.apache.org/viewcvs?view=revrev=159842 Log: s/Apache/Apache2/ Modified: perl/modperl/docs/trunk/src/docs/2.0/devel/debug/c.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/devel/debug/c.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/devel/debug/c.pod?view=diffr1=159841r2=159842 == --- perl/modperl/docs/trunk/src/docs/2.0/devel/debug/c.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/devel/debug/c.pod Sat Apr 2 14:55:54 2005 @@ -310,8 +310,8 @@ =item * Debugging mod_perl XS Extensions The Fcode/.debug-modperl-xs startup script breaks at the -Cmpxs_Apache__Filter_print() function implemented in -Ixs/Apache/Filter/Apache__Filter.h. This is an example of debugging +Cmpxs_Apache2__Filter_print() function implemented in +Ixs/Apache2/Filter/Apache2__Filter.h. This is an example of debugging code in XS Extensions. For this particular example the complete test case is: @@ -319,7 +319,7 @@ t/TEST -v -run -ping=block filter/api When Ifilter/api test is running it calls -mpxs_Apache__Filter_print() which is when the breakpoint is reached. +mpxs_Apache2__Filter_print() which is when the breakpoint is reached. =item * Debugging code in shared objects created by CInline.pm @@ -525,8 +525,8 @@ use strict; use warnings FATAL = 'all'; - use Apache::RequestRec (); - use Apache::RequestIO (); + use Apache2::RequestRec (); + use Apache2::RequestIO (); use Debug::DumpCore (); use Cwd; @@ -539,8 +539,8 @@ Debug::DumpCore::segv(); -In this script we load the CApache::RequestRec, -CApache::RequestIO, CDebug::DumpCore and CCwd modules, then we +In this script we load the CApache2::RequestRec, +CApache2::RequestIO, CDebug::DumpCore and CCwd modules, then we acquire the Apache request object and set the HTTP response header. Now we come to the real part -- we get the current working directory, print out the location of the Fcore file that we are - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r159843 - in perl/modperl/docs/trunk/src/docs/2.0/os/win32: config.pod install.pod
Author: randyk Date: Sat Apr 2 15:03:00 2005 New Revision: 159843 URL: http://svn.apache.org/viewcvs?view=revrev=159843 Log: s/Apache/Apache2/ Modified: perl/modperl/docs/trunk/src/docs/2.0/os/win32/config.pod perl/modperl/docs/trunk/src/docs/2.0/os/win32/install.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/os/win32/config.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/os/win32/config.pod?view=diffr1=159842r2=159843 == --- perl/modperl/docs/trunk/src/docs/2.0/os/win32/config.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/os/win32/config.pod Sat Apr 2 15:03:00 2005 @@ -31,19 +31,18 @@ where a sample start-up script FC:/Apache2/conf/extra.pl is - use Apache2 (); use ModPerl::Util (); - use Apache::RequestRec (); - use Apache::RequestIO (); - use Apache::RequestUtil (); - use Apache::ServerRec (); - use Apache::ServerUtil (); - use Apache::Connection (); - use Apache::Log (); - use Apache::Const -compile = ':common'; + use Apache2::RequestRec (); + use Apache2::RequestIO (); + use Apache2::RequestUtil (); + use Apache2::ServerRec (); + use Apache2::ServerUtil (); + use Apache2::Connection (); + use Apache2::Log (); + use Apache2::Const -compile = ':common'; use APR::Const -compile = ':common'; use APR::Table (); - use Apache::compat (); + use Apache2::compat (); use ModPerl::Registry (); use CGI (); 1; @@ -52,7 +51,7 @@ directories underneath, eg, F/Perl/site/lib/Apache2/ used when building mod_perl 2.0 with an CMP_INST_APACHE2=1 option to Cperl Makefile.PL (the CPPM packages discussed above were built this -way). CApache::compat is used to provide backwards compatibility +way). CApache2::compat is used to provide backwards compatibility with mod_perl 1.0. CModPerl::Registry, named so as not to conflict with CApache::Registry of mod_perl 1.0, is used for registry scripts. @@ -132,12 +131,12 @@ illustrates the use of mod_perl as a content handler. Create a file FHello.pm as follows: - package Apache::Hello; + package Apache2::Hello; use strict; - use Apache::RequestRec (); # for $r-content_type - use Apache::RequestIO (); # for $r-puts - use Apache::Const -compile = ':common'; + use Apache2::RequestRec (); # for $r-content_type + use Apache2::RequestIO (); # for $r-puts + use Apache2::Const -compile = ':common'; sub handler { my $r = shift; @@ -150,7 +149,7 @@ Hello from B$package/B! The time is $time. /BODY/HTML END - return Apache::OK; + return Apache2::OK; } 1; @@ -159,17 +158,17 @@ directory. Next put the following directives in FC:/Apache2/conf/httpd.conf: - PerlModule Apache::Hello + PerlModule Apache2::Hello Location /hello SetHandler modperl -PerlResponseHandler Apache::Hello +PerlResponseHandler Apache2::Hello /Location With this, calls to http://localhost/hello -will use CApache::Hello to deliver the content. +will use CApache2::Hello to deliver the content. =head1 See Also Modified: perl/modperl/docs/trunk/src/docs/2.0/os/win32/install.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/os/win32/install.pod?view=diffr1=159842r2=159843 == --- perl/modperl/docs/trunk/src/docs/2.0/os/win32/install.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/os/win32/install.pod Sat Apr 2 15:03:00 2005 @@ -106,17 +106,7 @@ will install the necessary mod_perl 2.0 files into your Perl directory tree, and also copy Fsrc/modules/perl/mod_perl.so into -your F/Path/to/Apache2/modules/ directory. If you are installing -mod_perl 2.0 on a system that also contains mod_perl 1.0, then some -mod_perl 1.0 files will be overwritten by this procedure. This can be -avoided by preparing the build as - - C:\modperl_src perl Makefile.PL MP_AP_PREFIX=\Path\to\Apache2 MP_INST_APACHE2=1 - -which will subsequently lead to the mod_perl 2.0 files being installed -under an FApache2 subdirectory in your Perl tree. You will then -have to employ either a Cuse Apache2; line in your scripts/packages -or else a CPerlModule Apache2 directive in Apache's Fhttpd.conf. +your F/Path/to/Apache2/modules/ directory. If this build fails, or you want features not present in the official releases, you may want to try the sources obtained from cvs - see the - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r159847 - perl/modperl/docs/trunk/src/docs/2.0/user/design/design.pod
Author: randyk Date: Sat Apr 2 15:15:48 2005 New Revision: 159847 URL: http://svn.apache.org/viewcvs?view=revrev=159847 Log: s/Apache/Apache2/ Modified: perl/modperl/docs/trunk/src/docs/2.0/user/design/design.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/user/design/design.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/user/design/design.pod?view=diffr1=159846r2=159847 == --- perl/modperl/docs/trunk/src/docs/2.0/user/design/design.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/user/design/design.pod Sat Apr 2 15:15:48 2005 @@ -244,8 +244,8 @@ un-useful to Perl don't get glued. The Apache header tree is parsed into Perl data structures which live -in the generated CApache::FunctionTable and -CApache::StructureTable modules. For example, the following +in the generated CApache2::FunctionTable and +CApache2::StructureTable modules. For example, the following function prototype: AP_DECLARE(int) ap_meets_conditions(request_rec *r); @@ -337,7 +337,7 @@ apr_int32_t = SvIV apr_int64_t = SvNV - server_rec = SvRV (Perl object blessed into the Apache::ServerRec class) + server_rec = SvRV (Perl object blessed into the Apache2::ServerRec class) =back @@ -438,8 +438,8 @@ =head1 Build System The biggest mess in 1.0 is mod_perl's Makefile.PL, the majority of -logic has been broken down and moved to the CApache::Build module. -The IMakefile.PL will construct an CApache::Build object which +logic has been broken down and moved to the CApache2::Build module. +The IMakefile.PL will construct an CApache2::Build object which will have all the info it needs to generate scripts and IMakefiles that apache-2.0 needs. Regardless of what that scheme may be or change to, it will be easy to adapt to with build @@ -468,7 +468,7 @@ The test framework in 1.0, like several other areas of mod_perl, was cobbled together over the years. mod_perl 2.0 provides a test framework that is usable not only for mod_perl, but for third-party -CApache::* modules and Apache itself. See +CApache2::* modules and Apache itself. See CLApache::Test|docs::general::testing::testing. =head1 CGI Emulation @@ -491,9 +491,9 @@ CModPerl::RegistryCooker makes it easy to write your own customizable registry handler. -=head1 Apache::* Library +=head1 Apache2::* Library -The majority of the standard CApache::* modules in 1.0 are supported +The majority of the standard CApache2::* modules in 1.0 are supported in 2.0. The main goal being that the non-core CGI emulation components of these modules are broken into small, re-usable pieces to subclass Apache::Registry like behavior. @@ -549,9 +549,9 @@ method look ups that are only known at runtime. To work around this, compile-time hints can be used, for example: - my Apache::Request $r = shift; + my Apache2::Request $r = shift; -Tells the Perl compiler to expect an object in the CApache::Request +Tells the Perl compiler to expect an object in the CApache2::Request class to be assigned to C$r. A patch has already been submitted to use this information so method calls can be resolved at compile time. However, the implementation does not take into account sub-classing of - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r159848 [2/2] - in perl/modperl/docs/trunk/src/docs/2.0/user/handlers: filters.pod http.pod intro.pod protocols.pod server.pod
Modified: perl/modperl/docs/trunk/src/docs/2.0/user/handlers/protocols.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/user/handlers/protocols.pod?view=diffr1=159847r2=159848 == --- perl/modperl/docs/trunk/src/docs/2.0/user/handlers/protocols.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/user/handlers/protocols.pod Sat Apr 2 15:32:19 2005 @@ -60,7 +60,7 @@ connection that is being used. mod_perl itself uses this phase to register the connection input and output filters. -In mod_perl 1.0 during code development CApache::Reload was used to +In mod_perl 1.0 during code development CApache2::Reload was used to automatically reload modified since the last request Perl modules. It was invoked during Cpost_read_request, the first HTTP request's phase. In mod_perl 2.0 Ipre_connection is the earliest phase, so if @@ -70,7 +70,7 @@ PerlInterpScope connection -and invoke the CApache::Reload handler during the Ipre_connection +and invoke the CApache2::Reload handler during the Ipre_connection phase. However this development-time advantage can become a disadvantage in production--for example if a connection, handled by HTTP protocol, is configured as CKeepAlive and there are several @@ -91,7 +91,7 @@ sub handler { my $c = shift; # ... - return Apache::OK; + return Apache2::OK; } [META: There is another argument passed (the actual client socket), but @@ -102,40 +102,40 @@ consumed. This is almost as good as a firewall blocking, as it's executed before Apache has started to do any work at all. -CMyApache::BlockIP2 retrieves client's remote IP and looks it up in +CMyApache2::BlockIP2 retrieves client's remote IP and looks it up in the black list (which should certainly live outside the code, e.g. dbm file, but a hardcoded list is good enough for our example). - #file:MyApache/BlockIP2.pm + #file:MyApache2/BlockIP2.pm #- - package MyApache::BlockIP2; + package MyApache2::BlockIP2; use strict; use warnings; - use Apache::Connection (); + use Apache2::Connection (); - use Apache::Const -compile = qw(FORBIDDEN OK); + use Apache2::Const -compile = qw(FORBIDDEN OK); my %bad_ips = map {$_ = 1} qw(127.0.0.1 10.0.0.4); sub handler { - my Apache::Connection $c = shift; + my Apache2::Connection $c = shift; my $ip = $c-remote_ip; if (exists $bad_ips{$ip}) { warn IP $ip is blocked\n; - return Apache::FORBIDDEN; + return Apache2::FORBIDDEN; } - return Apache::OK; + return Apache2::OK; } 1; This all happens during the Ipre_connection phase: - PerlPreConnectionHandler MyApache::BlockIP2 + PerlPreConnectionHandler MyApache2::BlockIP2 If a client connects from a blacklisted IP, Apache will simply abort the connection without sending any reply to the client, and move on to @@ -168,7 +168,7 @@ my $sock = $c-client_socket; $sock-opt_set(APR::SO_NONBLOCK, 0); # ... - return Apache::OK; + return Apache2::OK; } Most likely you'll need to set the socket to perform blocking IO. On @@ -189,7 +189,7 @@ =head3 Socket-based Protocol Module To demonstrate the workings of a protocol module, we'll take a look at -the CMyApache::EchoSocket module, which simply echoes the data read +the CMyApache2::EchoSocket module, which simply echoes the data read back to the client. In this module we will use the implementation that works directly with the connection socket and therefore bypasses connection filters if any. @@ -201,11 +201,11 @@ Listen 8010 VirtualHost _default_:8010 - PerlModule MyApache::EchoSocket - PerlProcessConnectionHandler MyApache::EchoSocket + PerlModule MyApache2::EchoSocket + PerlProcessConnectionHandler MyApache2::EchoSocket /VirtualHost -CMyApache::EchoSocket is then enabled when starting Apache: +CMyApache2::EchoSocket is then enabled when starting Apache: panic% httpd @@ -225,17 +225,17 @@ Here is the code: - file:MyApache/EchoSocket.pm + file:MyApache2/EchoSocket.pm --- - package MyApache::EchoSocket; + package MyApache2::EchoSocket; use strict; use warnings FATAL = 'all'; - use Apache::Connection (); + use Apache2::Connection (); use APR::Socket (); - use Apache::Const -compile = 'OK'; + use Apache2::Const -compile = 'OK'; use APR::Const-compile = 'SO_NONBLOCK'; use constant BUFF_LEN = 1024; @@ -252,7 +252,7 @@ $sock-send($buff); } - Apache::OK; + Apache2::OK; } 1; @@ -260,8 +260,8 @@ and of course, Cuse strict;. As with all CPerl*Handlers, the subroutine name defaults to Ihandler. However, in the case of a protocol handler, the first argument is not a
svn commit: r159849 - perl/modperl/docs/trunk/src/docs/2.0/user/install/install.pod
Author: randyk Date: Sat Apr 2 15:36:23 2005 New Revision: 159849 URL: http://svn.apache.org/viewcvs?view=revrev=159849 Log: s/Apache/Apache2/ Modified: perl/modperl/docs/trunk/src/docs/2.0/user/install/install.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/user/install/install.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/user/install/install.pod?view=diffr1=159848r2=159849 == --- perl/modperl/docs/trunk/src/docs/2.0/user/install/install.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/user/install/install.pod Sat Apr 2 15:36:23 2005 @@ -322,7 +322,7 @@ option, which should be set to a full path to the Capxs executable. For example: - % perl Makefile.PL MP_INST_APACHE2=1 MP_APXS=/path/to/apxs + % perl Makefile.PL MP_APXS=/path/to/apxs For example RedHat Linux system installs the Chttpd binary, the Capxs and Capr-config scripts (the latter two are needed to build @@ -340,7 +340,7 @@ directory, mod_perl 2.0's build only needs to know the path to that directory, passed via the CLMP_AP_PREFIX|/MP_AP_PREFIX option: - % perl Makefile.PL MP_INST_APACHE2=1 MP_AP_PREFIX=$HOME/httpd/prefork + % perl Makefile.PL MP_AP_PREFIX=$HOME/httpd/prefork =head3 Static mod_perl @@ -394,7 +394,7 @@ =head4 MP_STATIC_EXTS -Build CApache::*.xs as static extensions. +Build CApache2::*.xs as static extensions. =head4 MP_USE_GTOP @@ -413,7 +413,7 @@ =item * -Deprecated special variable, C$Apache::__T won't be available. Use +Deprecated special variable, C$Apache2::__T won't be available. Use C${^TAINT} instead. =item * @@ -425,10 +425,10 @@ in Ihttpd.conf or: - use Apache::ServerUtil (); + use Apache2::ServerUtil (); use File::Spec::Functins qw(catfile); - push @INC, catfile Apache::ServerUtil::server_root, ; - push @INC, catfile Apache::ServerUtil::server_root, lib/perl; + push @INC, catfile Apache2::ServerUtil::server_root, ; + push @INC, catfile Apache2::ServerUtil::server_root, lib/perl; in Istartup.pl. @@ -472,15 +472,6 @@ Enable tracing -=head4 MP_INST_APACHE2 - -Install all the I*.pm modules relative to the IApache2/ directory -in the Perl modules tree (not Apache files tree). - - - - - =head3 Non-Boolean Build Options set the non-boolen options with MP_XXX=value. @@ -614,7 +605,7 @@ run: % cd modperl-2.x.xx - % perl -MApache::Build -e rebuild + % perl -MApache2::Build -e rebuild - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r159850 - in perl/modperl/docs/trunk/src/docs/2.0/user/intro: overview.pod start_fast.pod
Author: randyk Date: Sat Apr 2 15:39:58 2005 New Revision: 159850 URL: http://svn.apache.org/viewcvs?view=revrev=159850 Log: s/Apache/Apache2/ Modified: perl/modperl/docs/trunk/src/docs/2.0/user/intro/overview.pod perl/modperl/docs/trunk/src/docs/2.0/user/intro/start_fast.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/user/intro/overview.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/user/intro/overview.pod?view=diffr1=159849r2=159850 == --- perl/modperl/docs/trunk/src/docs/2.0/user/intro/overview.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/user/intro/overview.pod Sat Apr 2 15:39:58 2005 @@ -108,7 +108,7 @@ Filtering of Perl modules output has been possible for years since tied filehandle support was added to Perl. There are several modules, -such as CApache::Filter and CApache::OutputChain which have been +such as CApache2::Filter and CApache::OutputChain which have been written to provide mechanisms for filtering the CSTDOUT stream. There are several of these modules because no one's approach has quite been able to offer the ease of use one would expect, which is due @@ -218,14 +218,14 @@ the CPerl*Handler configuration directives. By simply adding this configuration: - PerlModule Apache::Foo + PerlModule Apache2::Foo -CApache::Foo can register hooks itself at server startup: +CApache2::Foo can register hooks itself at server startup: - Apache::Hook-add(PerlAuthenHandler = \authenticate, -Apache::Hook::MIDDLE); - Apache::Hook-add(PerlLogHandler= \logger, -Apache::Hook::LAST); + Apache2::Hook-add(PerlAuthenHandler = \authenticate, +Apache2::Hook::MIDDLE); + Apache2::Hook-add(PerlLogHandler= \logger, +Apache2::Hook::LAST); META: Not implemented yet (API will change?) @@ -269,11 +269,11 @@ there are two approaches. A module can subclass directive handlers, saving a copy of the data for itself, then returning BDECLINE_CMD so the other modules are also handed the info. Or, the -C$Apache::PerlSections::Save variable can be set to save -EltPerlEgt configuration in the C%Apache::ReadConfig:: +C$Apache2::PerlSections::Save variable can be set to save +EltPerlEgt configuration in the C%Apache2::ReadConfig:: namespace. Both methods are rather kludgy, version 2.0 provides a LPerl interface to the Apache configuration -tree|docs::2.0::user::config::config/Perl_Interface_to_the_Apache_Configuration_Tree. +tree|docs::2.0::user::config::config/Perl_Interface_to_the_Apache2_Configuration_Tree. =back @@ -589,12 +589,12 @@ module|docs::2.0::user::porting::compat can be used. In mod_perl 2.0 the APR API resides in the CAPR:: namespace, and -obviously the CApache:: namespace is mapped to the Apache API. +obviously the CApache2:: namespace is mapped to the Apache API. And in the case of CAPR, it is possible to use CAPR modules outside of Apache, for example: - % perl -MApache2 -MAPR -MAPR::UUID -le 'print APR::UUID-new-format' + % perl -MAPR -MAPR::UUID -le 'print APR::UUID-new-format' b059a4b2-d11d-b211-bc23-d644b8ce0981 The mod_perl 2.0 generator is a custom suite of modules specifically @@ -720,7 +720,7 @@ =item * -Inlined CApache::*.xs calls +Inlined CApache2::*.xs calls =item * Modified: perl/modperl/docs/trunk/src/docs/2.0/user/intro/start_fast.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/user/intro/start_fast.pod?view=diffr1=159849r2=159850 == --- perl/modperl/docs/trunk/src/docs/2.0/user/intro/start_fast.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/user/intro/start_fast.pod Sat Apr 2 15:39:58 2005 @@ -57,17 +57,13 @@ LoadModule perl_module modules/mod_perl.so -Next, tell Perl where to find mod_perl2 libraries: - - PerlModule Apache2 - There are many other configuration options which you can find in the Lconfiguration manual|docs::2.0::user::config::config. If you want to run mod_perl 1.0 code on mod_perl 2.0 server enable the compatibility layer: - PerlModule Apache::compat + PerlModule Apache2::compat For more information see: LMigrating from mod_perl 1.0 to mod_perl 2.0|docs::2.0::user::porting::compat. @@ -140,17 +136,17 @@ response handler similar to the registry script from the previous section: - #file:MyApache/Rocks.pm + #file:MyApache2/Rocks.pm #-- - package MyApache::Rocks; + package MyApache2::Rocks; use strict; use warnings; - use Apache::RequestRec (); - use Apache::RequestIO (); + use Apache2::RequestRec (); + use Apache2::RequestIO (); - use Apache::Const -compile = qw(OK); + use Apache2::Const -compile = qw(OK); sub handler { my $r = shift; @@ -158,13 +154,13 @@ $r-content_type('text/plain
svn commit: r159851 - perl/modperl/docs/trunk/src/docs/2.0/user/performance/prevent.pod
Author: randyk Date: Sat Apr 2 15:41:12 2005 New Revision: 159851 URL: http://svn.apache.org/viewcvs?view=revrev=159851 Log: s/Apache/Apache2/ Modified: perl/modperl/docs/trunk/src/docs/2.0/user/performance/prevent.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/user/performance/prevent.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/user/performance/prevent.pod?view=diffr1=159850r2=159851 == --- perl/modperl/docs/trunk/src/docs/2.0/user/performance/prevent.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/user/performance/prevent.pod Sat Apr 2 15:41:12 2005 @@ -31,11 +31,11 @@ can. Never use server pools during request, when you can use a request pool. For example inside an HTTP handler, don't call: - my $dir = Apache::ServerUtil::server_root_relative($s-process-pool, 'conf'); + my $dir = Apache2::ServerUtil::server_root_relative($s-process-pool, 'conf'); when you should call: - my $dir = Apache::ServerUtil::server_root_relative($r-pool, 'conf'); + my $dir = Apache2::ServerUtil::server_root_relative($r-pool, 'conf'); Of course on special occasions, you may want to have something allocated off the server pool if you want the allocated memory to - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r159796 - in perl/modperl/docs/trunk/src/docs/2.0/api: Apache2.pod config.cfg
Author: randyk Date: Sat Apr 2 11:11:17 2005 New Revision: 159796 URL: http://svn.apache.org/viewcvs?view=revrev=159796 Log: start of s/Apache/Apache2/ rename. Added: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2.pod - copied, changed from r159778, perl/modperl/docs/trunk/src/docs/2.0/api/Apache.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/api/config.cfg Copied: perl/modperl/docs/trunk/src/docs/2.0/api/Apache2.pod (from r159778, perl/modperl/docs/trunk/src/docs/2.0/api/Apache.pod) URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/Apache2.pod?view=diffrev=159796p1=perl/modperl/docs/trunk/src/docs/2.0/api/Apache.podr1=159778p2=perl/modperl/docs/trunk/src/docs/2.0/api/Apache2.podr2=159796 == --- perl/modperl/docs/trunk/src/docs/2.0/api/Apache.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/Apache2.pod Sat Apr 2 11:11:17 2005 @@ -1,12 +1,12 @@ =head1 NAME -Apache -- A ghost mod_perl 2.0 class +Apache2 -- A ghost mod_perl 2.0 class =head1 Synopsis =head1 Description -There is no Apache class per se. +There is no Apache2 class per se. There are several modules that require the IApache class as the first argument to the class methods that they define. @@ -20,21 +20,21 @@ =head2 Cserver -CLApache::ServerUtil|docs::2.0::api::Apache::ServerUtil defines a +CLApache2::ServerUtil|docs::2.0::api::Apache2::ServerUtil defines a class method -CLApache-Egtserver|docs::2.0::api::Apache::ServerUtil/C_server_: +CLApache2-Egtserver|docs::2.0::api::Apache2::ServerUtil/C_server_: - use Apache::ServerUtil (); - my $s = Apache-server; + use Apache2::ServerUtil (); + my $s = Apache2-server; =head2 Crequest -CLApache::RequestUtil|docs::2.0::api::Apache::RequestUtil defines +CLApache2::RequestUtil|docs::2.0::api::Apache2::RequestUtil defines a class method -CLApache-Egtrequest|docs::2.0::api::Apache::RequestUtil/C_request_: +CLApache2-Egtrequest|docs::2.0::api::Apache2::RequestUtil/C_request_: - use Apache::RequestUtil (); - my $r = Apache-request; + use Apache2::RequestUtil (); + my $r = Apache2-request; Modified: perl/modperl/docs/trunk/src/docs/2.0/api/config.cfg URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/config.cfg?view=diffr1=159795r2=159796 == --- perl/modperl/docs/trunk/src/docs/2.0/api/config.cfg (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/config.cfg Sat Apr 2 11:11:17 2005 @@ -15,32 +15,32 @@ # NOTE: please keep the names sorted -group= 'Apache:: Core API', +group= 'Apache2:: Core API', chapters = [qw( -Apache.pod -Apache/Access.pod -Apache/CmdParms.pod -Apache/Command.pod -Apache/Connection.pod -Apache/Const.pod -Apache/Directive.pod -Apache/Filter.pod -Apache/FilterRec.pod -Apache/HookRun.pod -Apache/Log.pod -Apache/Module.pod -Apache/PerlSections.pod -Apache/Process.pod -Apache/RequestIO.pod -Apache/RequestRec.pod -Apache/RequestUtil.pod -Apache/Response.pod -Apache/ServerRec.pod -Apache/ServerUtil.pod -Apache/SubProcess.pod -Apache/SubRequest.pod -Apache/URI.pod -Apache/Util.pod +Apache2.pod +Apache2/Access.pod +Apache2/CmdParms.pod +Apache2/Command.pod +Apache2/Connection.pod +Apache2/Const.pod +Apache2/Directive.pod +Apache2/Filter.pod +Apache2/FilterRec.pod +Apache2/HookRun.pod +Apache2/Log.pod +Apache2/Module.pod +Apache2/PerlSections.pod +Apache2/Process.pod +Apache2/RequestIO.pod +Apache2/RequestRec.pod +Apache2/RequestUtil.pod +Apache2/Response.pod +Apache2/ServerRec.pod +Apache2/ServerUtil.pod +Apache2/SubProcess.pod +Apache2/SubRequest.pod +Apache2/URI.pod +Apache2/Util.pod )], group= 'APR:: Core API', @@ -85,12 +85,12 @@ group= 'Helper Modules / Applications', chapters = [qw( -Apache/compat.pod -Apache/porting.pod -Apache/Reload.pod -Apache/Resource.pod -Apache/Status.pod -Apache/SizeLimit.pod +Apache2/compat.pod +Apache2/porting.pod +Apache2/Reload.pod +Apache2/Resource.pod +Apache2/Status.pod +Apache2/SizeLimit.pod )], group= 'Internal Modules', - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r152368 - perl/modperl/docs/trunk/src/docs/2.0/os/win32/install.pod
Author: randyk Date: Mon Feb 7 20:45:51 2005 New Revision: 152368 URL: http://svn.apache.org/viewcvs?view=revrev=152368 Log: For Win32, describe different compile-time options that can be used when compiling Perl regarding the use of USE_IMP_SYS and PERL_MALLOC (submitted by Steve Hay). Modified: perl/modperl/docs/trunk/src/docs/2.0/os/win32/install.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/os/win32/install.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/os/win32/install.pod?view=diffr1=152367r2=152368 == --- perl/modperl/docs/trunk/src/docs/2.0/os/win32/install.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/os/win32/install.pod Mon Feb 7 20:45:51 2005 @@ -14,12 +14,13 @@ request at a time. This effectively prevents concurrent processing, which can have serious implications for busy sites. This problem is addressed in the multi-thread/multi-process approach of mod_perl -2.0/Apache 2.0. +2.0/Apache 2.0, which consequently requires a Perl built with ithreads +enabled. There are some threading issues in perl-5.6 (upon which ActivePerl builds 6xx are based) which cause problems with mod_perl 2.0 on Win32. Consequently, the minimum -required perl version is 5.8 (ActivePerl builds 8xx) +required perl version is 5.8 (upon which ActivePerl builds 8xx are based) for use with mod_perl 2.0 on Win32. Note that, at the present time, mod_perl 2 is in a development @@ -34,17 +35,28 @@ ActiveState also makes the sources available for their binary builds at Lftp://ftp.activestate.com/ActivePerl/src/, which may contain, in particular, Win32-specific fixes not in the -CPAN Perl sources. As a binary, at present, an ActivePerl-compatible -Perl, compiled with Visual C++, is the most common one used in the Win32 -mod_perl/Apache environment; you can obtain such a prebuilt Perl +CPAN Perl sources. If you are building Perl from source then you must +enable both USE_MULTI and USE_ITHREADS in the Makefile to enable +ithreads, as required for mod_perl 2.0 on Win32. ActivePerl builds also +enable USE_IMP_SYS, providing the implicit host layer which gives a +Cfork() emulation, but this is at the cost of disabling PERL_MALLOC +which may have significant performance implications since Win32's system +Cmalloc() is notably slower than Perl's in some situations. Thus, unless +you require the Cfork() emulation or specifically want an ActivePerl- +compatible build then you may want to disable USE_IMP_SYS and enable +PERL_MALLOC. (Note that you cannot currently enable PERL_MALLOC with +USE_IMP_SYS enabled as well.) As a binary, at present, an ActivePerl- +compatible Perl, compiled with Visual C++, is the most common one used in +the Win32 mod_perl/Apache environment; you can obtain such a prebuilt Perl binary from Lhttp://www.activestate.com/. The Apache sources and binaries are available at Lhttp://httpd.apache.org/. As of this writing, mod_perl 2.0 is known to compile and work -with an ActivePerl-compatible perl-5.8.0 (ActivePerl build 8xx). -See the section on Apache/mod_perl binaries +with both an ActivePerl-compatible perl-5.8 (ActivePerl build 8xx) and +with an otherwise similar Perl having USE_IMP_SYS disabled and +PERL_MALLOC enabled. See the section on Apache/mod_perl binaries below for details on a suitable repository containing mod_perl ppm packages, and also how to obtain other Win32 binary packages. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r124995 - /perl/modperl/docs/trunk/src/docs/1.0/os/win32/distinstall /perl/modperl/docs/trunk/src/docs/2.0/os/win32/distinstall
Author: randyk Date: Wed Jan 12 13:48:14 2005 New Revision: 124995 URL: http://svn.apache.org/viewcvs?view=revrev=124995 Log: Update version numbers for Perl/Apache Win32 binary Modified: perl/modperl/docs/trunk/src/docs/1.0/os/win32/distinstall perl/modperl/docs/trunk/src/docs/2.0/os/win32/distinstall Modified: perl/modperl/docs/trunk/src/docs/1.0/os/win32/distinstall Url: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/1.0/os/win32/distinstall?view=diffrev=124995p1=perl/modperl/docs/trunk/src/docs/1.0/os/win32/distinstallr1=124994p2=perl/modperl/docs/trunk/src/docs/1.0/os/win32/distinstallr2=124995 == --- perl/modperl/docs/trunk/src/docs/1.0/os/win32/distinstall (original) +++ perl/modperl/docs/trunk/src/docs/1.0/os/win32/distinstall Wed Jan 12 13:48:14 2005 @@ -40,7 +40,7 @@ Available distributions are: -1. Perl 5.8.4 / Apache 2.0.50 / mod_perl 1.99_15 (dev) +1. Perl 5.8.6 / Apache 2.0.52 / mod_perl-1.99_20 (2.0 Release Candidate) 2. Perl 5.6.1 / Apache 1.3.27 / mod_perl 1.27 It is recommended to install Perl and Apache into fresh locations, Modified: perl/modperl/docs/trunk/src/docs/2.0/os/win32/distinstall Url: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/os/win32/distinstall?view=diffrev=124995p1=perl/modperl/docs/trunk/src/docs/2.0/os/win32/distinstallr1=124994p2=perl/modperl/docs/trunk/src/docs/2.0/os/win32/distinstallr2=124995 == --- perl/modperl/docs/trunk/src/docs/2.0/os/win32/distinstall (original) +++ perl/modperl/docs/trunk/src/docs/2.0/os/win32/distinstall Wed Jan 12 13:48:14 2005 @@ -40,7 +40,7 @@ Available distributions are: -1. Perl 5.8.4 / Apache 2.0.50 / mod_perl 1.99_15 (dev) +1. Perl 5.8.6 / Apache 2.0.52 / mod_perl-1.99_20 (2.0 Release Candidate) 2. Perl 5.6.1 / Apache 1.3.27 / mod_perl 1.27 It is recommended to install Perl and Apache into fresh locations, - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r124997 - /perl/modperl/docs/trunk/src/docs/1.0/os/win32/install.pod /perl/modperl/docs/trunk/src/docs/2.0/os/win32/install.pod
Author: randyk Date: Wed Jan 12 14:17:25 2005 New Revision: 124997 URL: http://svn.apache.org/viewcvs?view=revrev=124997 Log: Mention availability of other Win32 Apache/Perl all-in-one binary packages. Modified: perl/modperl/docs/trunk/src/docs/1.0/os/win32/install.pod perl/modperl/docs/trunk/src/docs/2.0/os/win32/install.pod Modified: perl/modperl/docs/trunk/src/docs/1.0/os/win32/install.pod Url: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/1.0/os/win32/install.pod?view=diffrev=124997p1=perl/modperl/docs/trunk/src/docs/1.0/os/win32/install.podr1=124996p2=perl/modperl/docs/trunk/src/docs/1.0/os/win32/install.podr2=124997 == --- perl/modperl/docs/trunk/src/docs/1.0/os/win32/install.pod (original) +++ perl/modperl/docs/trunk/src/docs/1.0/os/win32/install.pod Wed Jan 12 14:17:25 2005 @@ -236,9 +236,29 @@ =head2 All-in-one packages -There are at least two binary packages for Win32 that contain the -necessary Perl and Apache binaries: IndigoPerl from -Lhttp://www.indigostar.com/, and the self-extracting archive +There are a number of binary packages for Win32 that contain the +necessary Perl and Apache binaries: + +=over + +=item * + +IndigoPerl from +Lhttp://www.indigostar.com/, + +=item * + +XAMPP for Windows from +Lhttp://www.apachefriends.org/en/xampp-windows.html + +=item * + +DeveloperSide.NET for Windows at +Lhttp://www.devside.net/web/server/free/software + +=back + +As well, there is a package Fperl-win32-bin.exe from Lhttp://www.apache.org/dyn/closer.cgi/perl/win32-bin/ - see the file Fperl-win32-bin.readme for a description. If you have trouble Modified: perl/modperl/docs/trunk/src/docs/2.0/os/win32/install.pod Url: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/os/win32/install.pod?view=diffrev=124997p1=perl/modperl/docs/trunk/src/docs/2.0/os/win32/install.podr1=124996p2=perl/modperl/docs/trunk/src/docs/2.0/os/win32/install.podr2=124997 == --- perl/modperl/docs/trunk/src/docs/2.0/os/win32/install.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/os/win32/install.pod Wed Jan 12 14:17:25 2005 @@ -201,12 +201,31 @@ =head2 All in one packages -Perl/Apache 2 binary packages containing mod_perl 2 are available from -Lhttp://www.indigostar.com/ and -Lhttp://www.devside.net/. As well, -at Lhttp://www.apache.org/dyn/closer.cgi/perl/win32-bin/ -there is a self-extracting -archive FPerl-5.8-win32-bin.exe containing a binary version +There are a number of binary packages for Win32 that contain the +necessary Perl and Apache binaries: + +=over + +=item * + +IndigoPerl from +Lhttp://www.indigostar.com/, + +=item * + +XAMPP for Windows from +Lhttp://www.apachefriends.org/en/xampp-windows.html + +=item * + +DeveloperSide.NET for Windows at +Lhttp://www.devside.net/web/server/free/software + +=back + +As well, at Lhttp://www.apache.org/dyn/closer.cgi/perl/win32-bin/ +there is a package +FPerl-5.8-win32-bin.exe containing a binary version of perl-5.8 (compatible with ActivePerl 8xx), together with Apache 2.0 and mod_perl 2.0. See the file FPerl-5.8-win32-bin.readme for a description. If you have trouble - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/general/os/win32 faq.pod
randyk 2004/07/24 14:25:19 Modified:src/docs/general/os/win32 faq.pod Log: add a note about using file extensions for which there may be a Windows file association present. Revision ChangesPath 1.15 +8 -1 modperl-docs/src/docs/general/os/win32/faq.pod Index: faq.pod === RCS file: /home/cvs/modperl-docs/src/docs/general/os/win32/faq.pod,v retrieving revision 1.14 retrieving revision 1.15 diff -u -r1.14 -r1.15 --- faq.pod 11 Jun 2004 03:51:55 - 1.14 +++ faq.pod 24 Jul 2004 21:25:19 - 1.15 @@ -171,7 +171,14 @@ =head2 I get a Save-As dialogue box when calling a script. -See the discussion about +If the extension of the file being called is Cpl, or some +other common extension, and if the problem happens with a +browser on Windows, it may be that there is a file association +set up within Windows for that extension. Try changing the +extension of the file to something for which a file association +is normally not present, such as Ccgi. + +If this doesn't help, see the discussion about LPerlSendHeader|docs::1.0::guide::config/My_Script_Works_under_mod_cgi__but_when_Called_via_mod_perl_I_Get_a__Save_As__Prompt; note that for mod_perl 2.0, there is a Ldifferent syntax|docs::2.0::user::porting::compat/C_PerlSendHeader_. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/os/win32 distinstall
randyk 2004/07/14 16:41:43 Modified:src/docs/1.0/os/win32 distinstall src/docs/2.0/os/win32 distinstall Log: specify the specific mod_perl-1.99 version. Revision ChangesPath 1.7 +1 -1 modperl-docs/src/docs/1.0/os/win32/distinstall Index: distinstall === RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/distinstall,v retrieving revision 1.6 retrieving revision 1.7 diff -u -r1.6 -r1.7 --- distinstall 14 Jul 2004 19:13:59 - 1.6 +++ distinstall 14 Jul 2004 23:41:43 - 1.7 @@ -40,7 +40,7 @@ Available distributions are: -1. Perl 5.8.4 / Apache 2.0.50 / mod_perl 1.99 +1. Perl 5.8.4 / Apache 2.0.50 / mod_perl 1.99_15 2. Perl 5.6.1 / Apache 1.3.27 / mod_perl 1.27 It is recommended to install Perl and Apache into fresh locations, 1.7 +1 -1 modperl-docs/src/docs/2.0/os/win32/distinstall Index: distinstall === RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/distinstall,v retrieving revision 1.6 retrieving revision 1.7 diff -u -r1.6 -r1.7 --- distinstall 14 Jul 2004 19:13:59 - 1.6 +++ distinstall 14 Jul 2004 23:41:43 - 1.7 @@ -40,7 +40,7 @@ Available distributions are: -1. Perl 5.8.4 / Apache 2.0.50 / mod_perl 1.99 +1. Perl 5.8.4 / Apache 2.0.50 / mod_perl 1.99_15 2. Perl 5.6.1 / Apache 1.3.27 / mod_perl 1.27 It is recommended to install Perl and Apache into fresh locations, - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/os/win32 distinstall
randyk 2004/07/14 18:16:22 Modified:src/docs/1.0/os/win32 distinstall src/docs/2.0/os/win32 distinstall Log: mark mod_perl-1.99_xx as a development version. Revision ChangesPath 1.8 +1 -1 modperl-docs/src/docs/1.0/os/win32/distinstall Index: distinstall === RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/distinstall,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- distinstall 14 Jul 2004 23:41:43 - 1.7 +++ distinstall 15 Jul 2004 01:16:21 - 1.8 @@ -40,7 +40,7 @@ Available distributions are: -1. Perl 5.8.4 / Apache 2.0.50 / mod_perl 1.99_15 +1. Perl 5.8.4 / Apache 2.0.50 / mod_perl 1.99_15 (dev) 2. Perl 5.6.1 / Apache 1.3.27 / mod_perl 1.27 It is recommended to install Perl and Apache into fresh locations, 1.8 +1 -1 modperl-docs/src/docs/2.0/os/win32/distinstall Index: distinstall === RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/distinstall,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- distinstall 14 Jul 2004 23:41:43 - 1.7 +++ distinstall 15 Jul 2004 01:16:21 - 1.8 @@ -40,7 +40,7 @@ Available distributions are: -1. Perl 5.8.4 / Apache 2.0.50 / mod_perl 1.99_15 +1. Perl 5.8.4 / Apache 2.0.50 / mod_perl 1.99_15 (dev) 2. Perl 5.6.1 / Apache 1.3.27 / mod_perl 1.27 It is recommended to install Perl and Apache into fresh locations, - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/os/win32 distinstall
randyk 2004/07/14 12:13:59 Modified:src/docs/1.0/os/win32 distinstall src/docs/2.0/os/win32 distinstall Log: bump up version of available Perl-5.8.x/Apache-2.0.x Win32 binary distribution. Revision ChangesPath 1.6 +1 -1 modperl-docs/src/docs/1.0/os/win32/distinstall Index: distinstall === RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/distinstall,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- distinstall 6 Jan 2004 16:09:18 - 1.5 +++ distinstall 14 Jul 2004 19:13:59 - 1.6 @@ -40,7 +40,7 @@ Available distributions are: -1. Perl 5.8.2 / Apache 2.0.48 / mod_perl 1.99 +1. Perl 5.8.4 / Apache 2.0.50 / mod_perl 1.99 2. Perl 5.6.1 / Apache 1.3.27 / mod_perl 1.27 It is recommended to install Perl and Apache into fresh locations, 1.6 +1 -1 modperl-docs/src/docs/2.0/os/win32/distinstall Index: distinstall === RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/distinstall,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- distinstall 6 Jan 2004 16:07:05 - 1.5 +++ distinstall 14 Jul 2004 19:13:59 - 1.6 @@ -40,7 +40,7 @@ Available distributions are: -1. Perl 5.8.2 / Apache 2.0.48 / mod_perl 1.99 +1. Perl 5.8.4 / Apache 2.0.50 / mod_perl 1.99 2. Perl 5.6.1 / Apache 1.3.27 / mod_perl 1.27 It is recommended to install Perl and Apache into fresh locations, - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/user/install install.pod
randyk 2004/07/04 12:18:25 Modified:src/docs/2.0/user/install install.pod Log: explain the MP_APR_LIB option used to specify the name of the static library on Win32 used to decouple APR/APR::* from mod_perl.so. Revision ChangesPath 1.56 +11 -0 modperl-docs/src/docs/2.0/user/install/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/user/install/install.pod,v retrieving revision 1.55 retrieving revision 1.56 diff -u -r1.55 -r1.56 --- install.pod 3 Jul 2004 17:44:27 - 1.55 +++ install.pod 4 Jul 2004 19:18:25 - 1.56 @@ -548,7 +548,18 @@ MP_OPTIONS_FILE=~/.my_mod_perl2_opts +=head4 MP_APR_LIB +On Win32, in order to build the APR and APR::* modules so as to +be independent of mod_perl.so, a static library is first built +containing the needed functions these modules link into. The option + + MP_APR_LIB=aprext + +specifies the name that this library has. The default used +is Caprext. This option has no effect on platforms other than +Win32, as they use a different mechanism to accomplish the +decoupling of APR and APR::* from mod_perl.so. =head3 mod_perl-specific Compiler Options - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/general/os/win32 faq.pod
randyk 2004/06/10 20:51:55 Modified:src/docs/general/os/win32 faq.pod Log: Add an item about a missing entry point in mod_perl.so when starting Apache. Revision ChangesPath 1.14 +23 -0 modperl-docs/src/docs/general/os/win32/faq.pod Index: faq.pod === RCS file: /home/cvs/modperl-docs/src/docs/general/os/win32/faq.pod,v retrieving revision 1.13 retrieving revision 1.14 diff -u -r1.13 -r1.14 --- faq.pod 3 Mar 2004 03:58:18 - 1.13 +++ faq.pod 11 Jun 2004 03:51:55 - 1.14 @@ -213,6 +213,29 @@ Laccessing mod_perl 2 modules|docs::2.0::user::config::config/Accessing_the_mod_perl_2_0_Modules. +=head2 When starting Apache, an error concerning a missing entry point in mod_perl.so appears. + +This might be due to an incompatibility between the installed mod_perl +files in the Perl tree and the mod_perl.so library within the Apache +(or Apache2) modules directory. If you're installing mod_perl via ppm, first +try removing mod_perl (or mod_perl-dev, if you're using the +development version): + + ppm remove mod_perl + +Next, remove (or move to another location) the mod_perl.so +library under the Apache (or Apache2) modules directory: + + C:\ del Apache2\modules\mod_perl.so + +(assuming FC:\Apache2 is your top-level Apache2 directory). +You may have to stop Apache to be able to do this. Then install +mod_perl via ppm: + + ppm install mod_perl + +and ensure that the post-install script successfully fetches +and installs Fmod_perl.so. =head2 I get a Can't locate object method ... error. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/outstanding sites.html
randyk 2004/06/10 21:15:12 Modified:src/outstanding sites.html Log: Update site information for a CPAN search engine. Revision ChangesPath 1.15 +8 -10 modperl-docs/src/outstanding/sites.html Index: sites.html === RCS file: /home/cvs/modperl-docs/src/outstanding/sites.html,v retrieving revision 1.14 retrieving revision 1.15 diff -u -r1.14 -r1.15 --- sites.html4 Mar 2003 22:32:38 - 1.14 +++ sites.html11 Jun 2004 04:15:12 - 1.15 @@ -167,16 +167,14 @@ /p -pmod_perl scripts which search the archives of a -href=http://theory.uwinnipeg.ca/search/cpan-search.html;CPAN/a, a -href=http://theory.uwinnipeg.ca/search/ctan-search.html;CTAN/a, A -href=http://theory.uwinnipeg.ca/search/linux-search.html;Linux/a, -a href=http://theory.uwinnipeg.ca/search/tetex.html;teTeX/a (a -Unix TeX system), and MuPAD (a symbolic math program) are available at -a href=http://theory.uwinnipeg.ca/;theory.uwinnipeg.ca/a. These -scripts query an mSQL database via various criteria, and employ the -CPAN multiplexer code to choose a nearby mirror of the archive, if -available and desired. /p +pmod_perl 2 is used to run a +a href=http://cpan.uwinnipeg.ca/htdocs/cpan-search.html; +CPAN search engine/a. Related software employed includes +a href=http://www.template-toolkit.org/; +Template Toolkit/a, the a href=http://httpd.apache.org/apreq/; +libapreq2 Apache Request Library/a, and +a href=http://www.mysql.com/;MySQL/a. +/p p The a href=http://www.athand.com/;AtHand Network Yellow pages/a serve their content thanks to mod_perl./p - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/general/os/win32 faq.pod
randyk 2004/03/02 19:58:18 Modified:src/docs/general/os/win32 faq.pod Log: add note about slowness of Apache::Log on Win32. Revision ChangesPath 1.13 +7 -0 modperl-docs/src/docs/general/os/win32/faq.pod Index: faq.pod === RCS file: /home/cvs/modperl-docs/src/docs/general/os/win32/faq.pod,v retrieving revision 1.12 retrieving revision 1.13 diff -u -r1.12 -r1.13 --- faq.pod 31 Dec 2003 19:03:07 - 1.12 +++ faq.pod 3 Mar 2004 03:58:18 - 1.13 @@ -298,6 +298,13 @@ to be used within the Apache2 sources are missing. Nevertheless, they may be useful for building and installing 3rd-party C modules. +=head2 Why is use of CApache::Log on Win32 so slow? + +On Win32 Apache attempts to lock all writes to a file whenever +it's opened for append (which is the case with logging functions), as +Unix has this behavior built-in, while Win32 does not. Therefore +CApache::Log functions could be slower than Perl's print()/warn(). + =head1 Maintainers Maintainer is the person(s) you should contact with updates, - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/os/win32 install.pod
randyk 2004/01/06 19:58:37 Modified:src/docs/2.0/os/win32 install.pod Log: - mention availability of Win32 Perl/Apache binary from www.devside.net. Revision ChangesPath 1.32 +3 -2 modperl-docs/src/docs/2.0/os/win32/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/install.pod,v retrieving revision 1.31 retrieving revision 1.32 diff -u -r1.31 -r1.32 --- install.pod 20 Nov 2003 06:44:07 - 1.31 +++ install.pod 7 Jan 2004 03:58:37 - 1.32 @@ -193,8 +193,9 @@ =head2 All in one packages -There is an IndigoPerl Perl/Apache 2 binary package available from -Lhttp://www.indigostar.com/ containing mod_perl 2. As well, +Perl/Apache 2 binary packages containing mod_perl 2 are available from +Lhttp://www.indigostar.com/ and +Lhttp://www.devside.net/. As well, at Lhttp://www.apache.org/dyn/closer.cgi/perl/win32-bin/ there is a self-extracting archive FPerl-5.8-win32-bin.exe containing a binary version - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/general/os/win32 faq.pod
randyk 2003/12/31 11:03:07 Modified:src/docs/general/os/win32 faq.pod Log: - add a link to the libapreq2 development package - add a link to using the Apache2 module Revision ChangesPath 1.12 +15 -2 modperl-docs/src/docs/general/os/win32/faq.pod Index: faq.pod === RCS file: /home/cvs/modperl-docs/src/docs/general/os/win32/faq.pod,v retrieving revision 1.11 retrieving revision 1.12 diff -u -r1.11 -r1.12 --- faq.pod 20 Aug 2003 05:57:29 - 1.11 +++ faq.pod 31 Dec 2003 19:03:07 - 1.12 @@ -204,6 +204,16 @@ Perl-5.6.1, try upgrading to LPerl-5.8.0|docs::2.0::os::win32::install. +=head2 I get a Can't find Some::Module in @INC ... error + +If this is a custom module installed outside of the system +Perl @INC directories, see Iperldoc lib. If this is +a mod_perl module, and you are using mod_perl 2, try +using the IApache2 module, as described in +Laccessing mod_perl 2 +modules|docs::2.0::user::config::config/Accessing_the_mod_perl_2_0_Modules. + + =head2 I get a Can't locate object method ... error. First off, if this is due to running some script from the @@ -268,8 +278,11 @@ described for Lmod_perl 1.0 ppm packages|docs::1.0::os::win32::install/PPM_Packages; the Ilibapreq package available in the ActiveState repository -will not work under mod_perl. Note that Ilibapreq -has not yet been ported to mod_perl 2.0. +will not work under mod_perl. A development version of Ilibapreq2, +suitable for use with mod_perl 2.0 / Apache 2.0, is available at +Lhttp://www.apache.org/~joes/, with a Win32 ppm package +available as described for Lmod_perl 2.0 ppm +packages|docs::2.0::os::win32::install/PPM_Packages. =head2 My Apache2 installation did not come with the Capxs utility. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/products apache-modules.pod
randyk 2003/12/04 14:31:47 Modified:src/products apache-modules.pod Log: add Apache::GeoIP to list of modules that are mp2 aware. Revision ChangesPath 1.16 +1 -0 modperl-docs/src/products/apache-modules.pod Index: apache-modules.pod === RCS file: /home/cvs/modperl-docs/src/products/apache-modules.pod,v retrieving revision 1.15 retrieving revision 1.16 diff -u -r1.15 -r1.16 --- apache-modules.pod4 Dec 2003 21:44:01 - 1.15 +++ apache-modules.pod4 Dec 2003 22:31:47 - 1.16 @@ -168,6 +168,7 @@ Apache::AuthzNetLDAP Apache-AuthzNetLDAP-0.07 Apache::AuthzPasswdApache-AuthzPasswd-0.11 Apache::Clean Apache-Clean-2.00_4 + Apache::GeoIP Apache-GeoIP-1.215 Apache::PARApache-PAR-0.30 Apache::Peek Apache-Peek-1.01 Apache::SessionManager Apache-SessionManager 1.00 - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/os/win32 distinstall
randyk 2003/11/23 11:07:42 Modified:src/docs/1.0/os/win32 distinstall src/docs/2.0/os/win32 distinstall Log: - bump up version for latest Perl-5.8/Apache2 binary distribution - add a warning to choose fresh installation locations, so as not to overwrite existing files and to not have old files confuse new installation Revision ChangesPath 1.4 +5 -1 modperl-docs/src/docs/1.0/os/win32/distinstall Index: distinstall === RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/distinstall,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- distinstall 1 Jun 2003 05:49:28 - 1.3 +++ distinstall 23 Nov 2003 19:07:41 - 1.4 @@ -40,8 +40,12 @@ Available distributions are: -1. Perl 5.8.0 / Apache 2.0.46 / mod_perl 1.99 +1. Perl 5.8.1 / Apache 2.0.48 / mod_perl 1.99 2. Perl 5.6.1 / Apache 1.3.27 / mod_perl 1.27 + +It is recommended to install Perl and Apache into fresh locations, +so that current files are not overwritten and that old files do +not linger which may confuse the new installation. END 1.4 +5 -1 modperl-docs/src/docs/2.0/os/win32/distinstall Index: distinstall === RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/distinstall,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- distinstall 1 Jun 2003 05:49:28 - 1.3 +++ distinstall 23 Nov 2003 19:07:42 - 1.4 @@ -40,8 +40,12 @@ Available distributions are: -1. Perl 5.8.0 / Apache 2.0.46 / mod_perl 1.99 +1. Perl 5.8.1 / Apache 2.0.48 / mod_perl 1.99 2. Perl 5.6.1 / Apache 1.3.27 / mod_perl 1.27 + +It is recommended to install Perl and Apache into fresh locations, +so that current files are not overwritten and that old files do +not linger which may confuse the new installation. END - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/os/win32 install.pod
randyk 2003/11/19 22:44:07 Modified:src/docs/2.0/os/win32 install.pod Log: specify minimum Apache2 version for mod_perl. Revision ChangesPath 1.31 +6 -2 modperl-docs/src/docs/2.0/os/win32/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/install.pod,v retrieving revision 1.30 retrieving revision 1.31 diff -u -r1.30 -r1.31 --- install.pod 12 Sep 2003 16:29:48 - 1.30 +++ install.pod 20 Nov 2003 06:44:07 - 1.31 @@ -68,7 +68,9 @@ contain at the top-level a Visual Studio project file (make sure to obtain the Iwin32-src.zip archive). Choose the CInstallBin - Win32 Release target to build and install Apache 2.0, -which by default will be placed in F/Apache2. +which by default will be placed in F/Apache2. At the present +time you must have version 2.0.47 or greater of Apache2 in +order to build mod_perl. Having built and installed Apache 2.0, next obtain the mod_perl 2.0 sources. First obtain the Lmod_perl 2.0 @@ -119,7 +121,9 @@ from Lhttp://www.activestate.com/ and a Win32 Apache 2.0 binary from Lhttp://httpd.apache.org/. In installing this, you might avoid some future problems by choosing installation directories that do -not have spaces in their names (eg, FC:/Apache2). +not have spaces in their names (eg, FC:/Apache2). At this time +you must have version 2.0.47 or greater of Apache2 in order to +install the mod_perl 2 ppm package. After installing Perl and Apache 2.0, you can then install mod_perl via the CPPM utility. ActiveState does not maintain mod_perl in - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/os/win32 install.pod
randyk 2003/10/09 06:38:55 Modified:src/docs/1.0/os/win32 install.pod Log: With the release of mod_perl-1.29, some things flagged as being only available in cvs are now available in the latest release. Revision ChangesPath 1.32 +7 -10 modperl-docs/src/docs/1.0/os/win32/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/install.pod,v retrieving revision 1.31 retrieving revision 1.32 diff -u -r1.31 -r1.32 --- install.pod 27 Sep 2003 20:18:46 - 1.31 +++ install.pod 9 Oct 2003 13:38:55 - 1.32 @@ -25,11 +25,8 @@ mod_perl 1 builds and tests successfully with either an ActivePerl Perl in the 6xx series, based on perl-5.6.1, or with an ActivePerl Perl in the 8xx series, based on perl-5.8.0 -(for the latter, at the time of writing this requires the -mod_perl cvs sources to build - see -see the discussion on the -LDevelopment Source Distribution|download::source/Development_Source_Distribution -for details on how to access this). If you are using perl-5.8, +(for the latter, this requires mod_perl-1.29 or later). +If you are using perl-5.8, you may want to consider mod_perl 2.0, which although still in a development phase offers several significant performance improvements for Win32 - see @@ -69,7 +66,7 @@ As of version 1.24_01, mod_perl will build on Win32 ActivePerls based on Perl-5.6.x (builds 6xx). For ActivePerl builds 8xx, -at the time of writing you will need the mod_perl 1 cvs sources. +you will need mod_perl-1.29 or later. For binary compatibility you should use the same compiler in building mod_perl that was used to compile your Perl binary; for ActivePerl, this means using VC++ 6. @@ -181,15 +178,15 @@ This gives the location of where to install mod_perl.so (eg, F\Apache\modules). No default is assumed - if this argument -is not given, mod_perl.so must be copied manually (in the -current cvs mod_perl 1 sources, INSTALL_DLL, if not supplied, +is not given, mod_perl.so must be copied manually (in +mod_perl-1.29 or later, INSTALL_DLL, if not supplied, will assume a default of FAPACHE_SRC/modules, if this directory exists). =item INSTALL_LIB -This option, which is presently available only in the current -mod_perl 1 cvs sources, gives the location of where to install +This option, which is available only in mod_perl-1.29 +or later, gives the location of where to install mod_perl.lib (eg, F\Apache\libexec). This library is needed for building certain 3rd party Apache modules. If this is not supplied, a default of FAPACHE_SRC/libexec will be assumed, if this directory - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/os/win32 install.pod
randyk 2003/09/27 13:18:46 Modified:src/docs/1.0/os/win32 install.pod Log: Describe the presence in the mod_perl 1 cvs sources of an INSTALL_LIB option to 'perl Makefile.PL' for Win32 to specify the location of where to install mod_perl.lib. Revision ChangesPath 1.31 +10 -1 modperl-docs/src/docs/1.0/os/win32/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/install.pod,v retrieving revision 1.30 retrieving revision 1.31 diff -u -r1.30 -r1.31 --- install.pod 12 Sep 2003 16:29:48 - 1.30 +++ install.pod 27 Sep 2003 20:18:46 - 1.31 @@ -163,7 +163,7 @@ Generating the Makefile as, for example, - C:\modperl_src perl Makefile.PL APACHE_SRC=\Apache INSTALL_DLL=\Apache\modules + C:\modperl_src perl Makefile.PL APACHE_SRC=\Apache will build mod_perl (including mod_perl.so) entirely from the command line. The arguments accepted include @@ -185,6 +185,15 @@ current cvs mod_perl 1 sources, INSTALL_DLL, if not supplied, will assume a default of FAPACHE_SRC/modules, if this directory exists). + +=item INSTALL_LIB + +This option, which is presently available only in the current +mod_perl 1 cvs sources, gives the location of where to install +mod_perl.lib (eg, F\Apache\libexec). This library is needed for +building certain 3rd party Apache modules. If this is not supplied, +a default of FAPACHE_SRC/libexec will be assumed, if this directory +exists. =item DEBUG - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/general/os/win32 faq.pod
randyk 2003/08/19 22:53:36 Modified:src/docs/general/os/win32 faq.pod Log: Mention availability of an experimental port of apxs, apr-config, and apu-config for Win32 with Apache2. Revision ChangesPath 1.10 +14 -0 modperl-docs/src/docs/general/os/win32/faq.pod Index: faq.pod === RCS file: /home/cvs/modperl-docs/src/docs/general/os/win32/faq.pod,v retrieving revision 1.9 retrieving revision 1.10 diff -u -r1.9 -r1.10 --- faq.pod 8 Jun 2003 21:22:30 - 1.9 +++ faq.pod 20 Aug 2003 05:53:36 - 1.10 @@ -271,6 +271,20 @@ will not work under mod_perl. Note that Ilibapreq has not yet been ported to mod_perl 2.0. +=head2 My Apache2 installation did not come with the Capxs utility. + +The utilities Capxs, Capr-config, and Capu-config have +not been fully ported yet to Win32 for Apache2. A development port +is available in the Fapxs_win32.tar.gz archive found under +Lhttp://perl.apache.org/dist/win32-bin/; installation +instructions are found in the accompanying FREADME file. +One can also install these utilties by running the Finstall_apxs +script under Lhttp://perl.apache.org/dist/win32-bin/. Note that +this port does not offer yet the full functionality of +the unix version - in particular, features enabling the utiltities +to be used within the Apache2 sources are missing. Nevertheless, +they may be useful for building and installing 3rd-party modules. + =head1 Maintainers Maintainer is the person(s) you should contact with updates, - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/dist KEYS
randyk 2003/08/20 08:53:02 Modified:src/dist KEYS Log: Moved my key from dist/win32-bin/KEYS into dist/KEYS. Revision ChangesPath 1.6 +26 -0 modperl-docs/src/dist/KEYS Index: KEYS === RCS file: /home/cvs/modperl-docs/src/dist/KEYS,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- KEYS 9 Jun 2003 03:26:37 - 1.5 +++ KEYS 20 Aug 2003 15:53:01 - 1.6 @@ -497,3 +497,29 @@ q9ChmcpJFZHMNtqkmfjer/kcVIhGBBgRAgAGBQI7W9wGAAoJEMsyoQeIw6WlX4MA oLJmczPbzQRPLug3YmgsbpZcapCgAJ9e7FF8u9ykFcwxwDjjc1ekNbr3kA== =b/19 +-END PGP PUBLIC KEY BLOCK- + +-BEGIN PGP PUBLIC KEY BLOCK- +Version: PGP 6.5.1i + +mQGiBD60NmoRBADlzZ8ZAvyuYLujH97qLiU50lVMKDw+1WiE1Fs7ZbCUDxrOQRP8 +cAKM1FU9vldP0DMhme+dtQoZ8so889+Dc4iUDFAHQyFWJ/hS2Gszvia8ZhrAFwEQ +tSq3X6rSA7w2EezqegZlLwTQTUaMBqFy0PRc04UGQ4EBS1reNVD6KNFhuQCg/9ZX +bmtTSd7w3wM0TgiBNW5SunED+wff2Dyu+XFg46AoV6h3vF+mp7xJDatORqYBLyLL +n7RJCVn++yq8bjG7MIWvwCa+HHTyC9O4fhk6+XwprE5rE7igLeymsqjCUBJ/8Stl +SG25mnpYtfTfBqNn5trXYWAKSp/3Oi32xK1q6o3YslNZPC0jOFU5hwzPuJWY5OKz +/aGKBACUlUF/aABz2Lkxa6x5T4DaXsde7UVHJceOCIQfQst9SCnbI/xQ9f7WVLFQ +H3HmZGNU7xX6fWyRypDdZafpUo95aiif8H4FxUbDOwTmEOM/zvljjPoYJzvrwFJc +56t+04ATAiN/+2girX/m6v/E7z/FoCSgWOXRC0shGfvK7KFSMrQnUmFuZHkgS29i +ZXMgPHJhbmR5QHRoZW9yeS51d2lubmlwZWcuY2E+iQBNBBARAgAOBQI+tDZqBAsD +AQICGQEACgkQonlva/8qk5KTnwCfYrDZfM/iRPAzitOQunSEddkYY+EAmOY+P2BA +NMKZySAOLeJS1FdQzC+5AQ0EPrQ2bxAEANMzvi92IQC+7CIGD0v95GUhvmCSbgJ4 +QrmahxLBeutC+pIbIxOTnOWiGIK1boDhret97YF1yhRi6jkWLr9rtS/rg55oAkhE +1YyowYxOjXlBbyv1Te+1j/NvJSucNI/+ko9RZGpRKn6WoNQxbQj2ysro43115aOE +3s221Q6DcxdzAAICBACn5fYzWTfPebHI5KP/P6kEokAoyyUD91CGcskgV62cFudI +gduDedRUcuONS9UCFfRChyxGp05icYVurfs/zLnBeVdi4lBoL/bz/oao738DIgw5 +SBMzZ9GsxDLFLuvluqdY6/J/LClxLcUo7EvDeiZcOD0dZAVjUD+i2lwbz65ws4kA +RgQYEQIABgUCPrQ2bwAKCRCieW9r/yqTkpxsAKCHFodCzrY7bJk5GJ5M9lYpOr/h +GgCg0XqrmN1GR3EqJRcnrG1cKOxfCDA= +=Ms5p +-END PGP PUBLIC KEY BLOCK- - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/dist/win32-bin HEADER.html README.html
randyk 2003/08/20 08:49:49 Added: src/dist/win32-bin HEADER.html README.html Log: Added in win32-bin/ HEADER and README files. Revision ChangesPath 1.1 modperl-docs/src/dist/win32-bin/HEADER.html Index: HEADER.html === center img src=../../images/logo/mod_perl_logo.jpg /center 1.1 modperl-docs/src/dist/win32-bin/README.html Index: README.html === HTML HEAD TITLEREADME/TITLE /HEAD BODY This area contains binary packages of Perl/Apache/mod_perl/mod_ssl/php for Win32. There are two main distributions. UL LIA HREF=Perl-5.8-win32-bin.exePerl-5.8-win32-bin.exe/A, consisting of Perl-5.8.0 and Apache 2.0.46. See A HREF=Perl-5.8-win32-bin.readmePerl-5.8-win32-bin.readme/A for details./LI LIA HREF=perl-win32-bin.exeperl-win32-bin.exe/A, consisting of Perl-5.6.1 and Apache 1.3.27. See A HREF=perl-win32-bin.readmeperl-win32-bin.readme/A for details./LI /UL If you have trouble downloading the complete packages due to their size, the corresponding subdirectories A HREF=Perl-5.8-win32-bin/Perl-5.8-win32-bin/A and A HREF=perl-win32-bin/perl-win32-bin/A contain these distributions split across multiple files (of around 3 MB each). See the file IREADME.join/I in these subdirectories for instructions on how to join these files. PAlso available here are repositories for some mod_perl and related ppm packages, both for Win32 ActivePerl A HREF=ppms/8xx builds/A, for perl-5.8, and for A HREF=ppmpackages/6xx builds/A, for perl-5.6.1. /P /BODY /HTML - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/dist/win32-bin - New directory
randyk 2003/08/20 08:48:36 modperl-docs/src/dist/win32-bin - New directory - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/os/win32 config.pod
randyk 2003/07/30 13:35:15 Modified:src/docs/2.0/os/win32 config.pod Log: Fix ab results for running concurrent requests, so that both mod_perl 1 and 2 use a script with sleep(10) enabled. Revision ChangesPath 1.11 +2 -13 modperl-docs/src/docs/2.0/os/win32/config.pod Index: config.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/config.pod,v retrieving revision 1.10 retrieving revision 1.11 diff -u -r1.10 -r1.11 --- config.pod6 Jan 2003 22:21:35 - 1.10 +++ config.pod30 Jul 2003 20:35:15 - 1.11 @@ -112,23 +112,12 @@ Server Software:Apache/1.3.23 Concurrency Level: 5 Time taken for tests: 50.51972 seconds - Complete requests: 5 - Failed requests:0 - Requests per second:0.10 [#/sec] (mean) - Time per request: 50.052 [ms] (mean) - Time per request: 10.010 [ms] (mean, across all concurrent requests) - Transfer rate: 0.14 [Kbytes/sec] received while for mod_perl 2.0/Apache 2.0: - Server Software:Apache/2.0.36 + Server Software:Apache/2.0.45 Concurrency Level: 5 - Time taken for tests: 1.81555 seconds - Complete requests: 5 - Requests per second:4.62 [#/sec] (mean) - Time per request: 1.082 [ms] (mean) - Time per request: 0.216 [ms] (mean, across all concurrent requests) - Transfer rate: 7.40 [Kbytes/sec] received + Time taken for tests: 13.729743 seconds The dramatic difference is due to the fact that in Apache 1.3/mod_perl 1.0 a given request has to finish (taking essentially 10 seconds, due - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/os/win32 install.pod
randyk 2003/07/30 13:35:57 Modified:src/docs/2.0/os/win32 install.pod Log: Make a note that, presently, mod_perl 2's version is 1.99_xx. Revision ChangesPath 1.25 +4 -1 modperl-docs/src/docs/2.0/os/win32/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/install.pod,v retrieving revision 1.24 retrieving revision 1.25 diff -u -r1.24 -r1.25 --- install.pod 6 Jul 2003 17:33:18 - 1.24 +++ install.pod 30 Jul 2003 20:35:57 - 1.25 @@ -16,11 +16,14 @@ addressed in the multi-thread/multi-process approach of mod_perl 2.0/Apache 2.0. -Note that there are some threading issues in perl-5.6 +There are some threading issues in perl-5.6 (upon which ActivePerl builds 6xx are based) which cause problems with mod_perl 2.0 on Win32. Consequently, the minimum required perl version is 5.8 (ActivePerl builds 8xx) for use with mod_perl 2.0 on Win32. + +Note that, at the present time, mod_perl 2 is in a development +stage, with a version number C1.99_xx. =head1 Installing - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/os/win32 mpinstall
randyk 2003/07/06 18:27:36 Modified:src/docs/1.0/os/win32 mpinstall src/docs/2.0/os/win32 mpinstall Log: some cleanup of the mpinstall script. Revision ChangesPath 1.7 +33 -33modperl-docs/src/docs/1.0/os/win32/mpinstall Index: mpinstall === RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/mpinstall,v retrieving revision 1.6 retrieving revision 1.7 diff -u -r1.6 -r1.7 --- mpinstall 6 Jul 2003 17:33:18 - 1.6 +++ mpinstall 7 Jul 2003 01:27:36 - 1.7 @@ -14,7 +14,6 @@ use Config; use Safe; use Digest::MD5; -use IO::File; require Win32; require File::Spec; @@ -118,7 +117,7 @@ # set appropriate ppd and tar.gz files if ($] 5.008) { -$checksums = $theoryx5 . '/ppmpackages/x86/' . $cs; +$checksums = $ppmpackagesx86 . $cs; if ($apache2) { die 'No mod_perl 2 package available for this perl version'; } @@ -140,7 +139,7 @@ } } else { -$checksums = $theoryx5 . '/ppms/x86/' . $cs; +$checksums = $ppmsx86 . $cs; if ($apache2) { $ppdfile = 'mod_perl.ppd'; $tgzfile = 'mod_perl.tar.gz'; @@ -186,34 +185,30 @@ print Fetching $checksums ...; getstore($checksums, $cs); print done!\n; +die Failed to fetch $checksums unless -e $cs; -# check CHECKSUMS for the tar.gz file -if (-e $cs) { -unless (verifyMD5($tgzfile)) { -die qq{CHECKSUM check for $tgzfile failed.\n}; -} -unless (verifyMD5($so_fake)) { -die qq{CHECKSUM check for $so_fake failed.\n}; -} -rename($so_fake, $so) or die Rename of $so_fake to $so failed: $!; -} -else { -die Failed to fetch $checksums - cannot verify CHECKSUMS.; -} +# check CHECKSUMS for the tar.gz and so files +my $cksum = load_cs($cs); +die Could not load $cs: $! unless $cksum; +die qq{CHECKSUM check for $tgzfile failed.\n} +unless (verifyMD5($cksum, $tgzfile)); +die qq{CHECKSUM check for $so_fake failed.\n} +unless (verifyMD5($cksum, $so_fake)); +rename($so_fake, $so) or die Rename of $so_fake to $so failed: $!; # edit the ppd file to reflect a local installation my $old = $ppdfile . '.old'; -rename $ppdfile, $old +rename ($ppdfile, $old) or die renaming $ppdfile to $old failed: $!; -open(OLD, $old) or die Cannot open $old: $!; -open(NEW, $ppdfile) or die Cannot open $ppdfile: $!; -while (OLD) { +open(my $oldfh, $old) or die Cannot open $old: $!; +open(my $newfh, $ppdfile) or die Cannot open $ppdfile: $!; +while ($oldfh) { next if /INSTALL/; s/$tgz/$tgzfile/; -print NEW $_; +print $newfh $_; } -close OLD; -close NEW; +close $oldfh; +close $newfh; # install mod_perl via ppm my $ppm = $Config{bin} . '\ppm'; @@ -281,10 +276,10 @@ # routine to verify the CHECKSUMS for a file # adapted from the MD5 check of CPAN.pm -sub verifyMD5 { -my $file = shift; -my $fh = IO::File-new; -my $cksum; + +sub load_cs { +my $cs = shift; +my ($cksum, $fh); unless (open $fh, $cs) { warn Could not open $cs: $!; return; @@ -299,18 +294,23 @@ warn $@; return; } -my ($is, $should); -unless (open(FILE, $file)) { +return $cksum; +} + +sub verifyMD5 { +my ($cksum, $file) = @_; +my ($fh, $is, $should); +unless (open($fh, $file)) { warn Cannot open $file: $!; return; } -binmode(FILE); -unless ($is = Digest::MD5-new-addfile(*FILE)-hexdigest) { +binmode($fh); +unless ($is = Digest::MD5-new-addfile($fh)-hexdigest) { warn Could not compute checksum for $file: $!; -close(FILE); +close($fh); return; } -close(FILE); +close($fh); if ($should = $cksum-{$file}-{md5}) { my $test = $is eq $should ? 1 : 0; printf qq{Checksum for $file is %s\n}, 1.7 +33 -33modperl-docs/src/docs/2.0/os/win32/mpinstall Index: mpinstall === RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/mpinstall,v retrieving revision 1.6 retrieving revision 1.7 diff -u -r1.6 -r1.7 --- mpinstall 6 Jul 2003 17:33:18 - 1.6 +++ mpinstall 7 Jul 2003 01:27:36 - 1.7 @@ -14,7 +14,6 @@ use Config; use Safe; use Digest::MD5; -use IO::File; require Win32; require File::Spec; @@ -118,7 +117,7 @@ # set appropriate ppd and tar.gz files if ($] 5.008) { -$checksums = $theoryx5 . '/ppmpackages/x86/' . $cs; +$checksums = $ppmpackagesx86 . $cs; if ($apache2) { die 'No mod_perl 2 package available for this perl version'; } @@ -140,7 +139,7
cvs commit: modperl-docs/src/docs/2.0/os/win32 install.pod mpinstall
randyk 2003/07/06 10:33:18 Modified:src/docs/1.0/os/win32 install.pod mpinstall src/docs/2.0/os/win32 install.pod mpinstall Log: For Win32, - record the fact that mod_perl 1 now compiles with ActivePerl 8xx, - give locations of where to get mod_perl 1 ppm packages for ActivePerl 8xx, - adjust the mpinstall script to offer to get mod_perl 1 for ActivePerl 8xx, if requested. Revision ChangesPath 1.25 +63 -51modperl-docs/src/docs/1.0/os/win32/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/install.pod,v retrieving revision 1.24 retrieving revision 1.25 diff -u -r1.24 -r1.25 --- install.pod 8 Jun 2003 18:01:29 - 1.24 +++ install.pod 6 Jul 2003 17:33:18 - 1.25 @@ -22,18 +22,17 @@ mod_perl/Apache environment; you can obtain such a prebuilt Perl binary from Lhttp://www.activestate.com/. -Note that, currently, mod_perl 1.0 does not work with an -ActivePerl Perl in the 8xx series (based on perl-5.8), due -to some issues with ILARGE_FILES support. You should either -then use an ActivePerl Perl in the 6xx series (based on perl-5.6.1), -or else, if you need perl-5.8, build or obtain a binary -Perl compiled without the IUSE_LARGE_FILES compile-time option -(beware that such a Perl, and XS-based extensions compiled with it, -may not be binary compatible with ActivePerl 8xx and its -XS-based extensions). Another possibility, if you desire perl-5.8, -is to consider trying mod_perl 2.0, which does work -with an ActivePerl Perl in the 8xx series (and is in fact -the minimum required Perl version) - see +mod_perl 1 builds and tests successfully with either +an ActivePerl Perl in the 6xx series, based on perl-5.6.1, +or with an ActivePerl Perl in the 8xx series, based on perl-5.8.0 +(for the latter, at the time of writing this requires the +mod_perl cvs sources to build - see +see the discussion on the +LDevelopment Source Distribution|download::source/Development_Source_Distribution +for details on how to access this). If you are using perl-5.8, +you may want to consider mod_perl 2.0, which although still +in a development phase offers several significant performance +improvements for Win32 - see Lmodperl-2 in Win32|docs::2.0::os::win32::install for details. @@ -69,9 +68,11 @@ =item * As of version 1.24_01, mod_perl will build on Win32 ActivePerls -based on Perl-5.6.x (builds 6xx). For binary compatibility you -should use the same compiler in building mod_perl that was used -to compile your Perl binary; for ActivePerl, this means using VC++ 6. +based on Perl-5.6.x (builds 6xx). For ActivePerl builds 8xx, +at the time of writing you will need the mod_perl 1 cvs sources. +For binary compatibility you should use the same compiler in +building mod_perl that was used to compile your Perl binary; +for ActivePerl, this means using VC++ 6. =back @@ -177,7 +178,10 @@ This gives the location of where to install mod_perl.so (eg, F\Apache\modules). No default is assumed - if this argument -is not given, mod_perl.so must be copied manually. +is not given, mod_perl.so must be copied manually (in the +current cvs mod_perl 1 sources, INSTALL_DLL, if not supplied, +will assume a default of FAPACHE_SRC/modules, if this directory +exists). =item DEBUG @@ -257,11 +261,8 @@ =head2 PPM Packages -For users of ActivePerl builds 6xx Ionly, obtainable from -Lhttp://www.activestate.com/, -there are also CPPM mod_perl packages available (as discussed -in the introduction, no Cppm mod_perl 1.0 ppm packages for -ActivePerl builds 8xx are presently available). For this, if you +For ActivePerl users (or compatible), there are also CPPM +mod_perl packages available. For this, if you don't already have it, get and install the latest Win32 Apache binary from Lhttp://httpd.apache.org/. @@ -288,43 +289,54 @@ C:\ ppm install http://theoryx5.uwinnipeg.ca/ppmpackages/mod_perl.ppd -Another way, which will be useful if you plan on installing additional -Apache modules, is to add the repository where the mod_perl package -is kept to the Cppm shell utility. For Cppm2 this may be -done as (the Cset repository ... command has been broken over two -lines for readability): - - C:\ ppm - PPM set repository theoryx5 - http://theoryx5.uwinnipeg.ca/cgi-bin/ppmserver?urn:/PPMServer - -while for Cppm3 the appropriate command is (again broken over -two lines for readability): - - C:\ ppm3 - PPM repository add theoryx5 - http://theoryx5.uwinnipeg.ca/cgi-bin/ppmserver?urn:/PPMServer - -After this, you can do - - PPM install mod_perl - PPM quit - C:\ +for Activeperl 6xx builds
cvs commit: modperl-docs/src/docs/2.0/os/win32 mpinstall
randyk 2003/05/30 20:04:55 Modified:src/docs/1.0/os/win32 mpinstall src/docs/2.0/os/win32 mpinstall Log: - adjust indentation style - attempt to handle stupid Win32 long filenames Revision ChangesPath 1.4 +164 -149 modperl-docs/src/docs/1.0/os/win32/mpinstall Index: mpinstall === RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/mpinstall,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- mpinstall 31 Dec 2002 23:25:01 - 1.3 +++ mpinstall 31 May 2003 03:04:55 - 1.4 @@ -1,3 +1,4 @@ +#!C:/Perl/bin # # A Perl script to fetch and install via ppm mod_perl on Win32 # Copyright 2002, by Randy Kobes. @@ -16,6 +17,7 @@ use Safe; use Digest::MD5; use IO::File; +require Win32; die This only works for Win32 unless $^O =~ /Win32/i; die No mod_perl ppm package available for this Perl if ($] 5.006001); @@ -24,124 +26,125 @@ # find a possible Apache2 directory APACHE2: { - for my $drive ('C'..'G') { -for my $p ('Apache2', 'Program files/Apache2', -'Program Files/Apache Group/Apache2') { - if (-d $drive:/$p) { - $apache2 = $drive:/$p; - last APACHE2; - } +for my $drive ('C'..'G') { +for my $p ('Apache2', 'Program files/Apache2', + 'Program Files/Apache Group/Apache2') { +if (-d $drive:/$p) { +$apache2 = $drive:/$p; +last APACHE2; +} +} } - } } if ($apache2) { - my $ans = prompt(qq{Install mod_perl-2 for $apache2?}, 'yes'); - $apache2 = undef unless ($ans =~ /^y/i); +$apache2 = fix_path($apache2); +my $ans = prompt(qq{Install mod_perl-2 for $apache2?}, 'yes'); +$apache2 = undef unless ($ans =~ /^y/i); } # if no Apache2, try to find Apache1 unless ($apache2) { - APACHE: { -for my $drive ('C'..'G') { - for my $p ('Apache', 'Program Files/Apache', - 'Program Files/Apache Group/Apache') { - if (-d $drive:/$p) { - $apache = $drive:/$p; - last APACHE; - } - } + APACHE: { +for my $drive ('C'..'G') { +for my $p ('Apache', 'Program Files/Apache', + 'Program Files/Apache Group/Apache') { +if (-d $drive:/$p) { +$apache = $drive:/$p; +last APACHE; +} +} +} } - } } if ($apache) { - my $ans = prompt(qq{Install mod_perl-1 for $apache?}, 'yes'); - $apache = undef unless ($ans =~ /^y/i); +$apache = fix_path($apache); +my $ans = prompt(qq{Install mod_perl-1 for $apache?}, 'yes'); +$apache = undef unless ($ans =~ /^y/i); } # check Apache versions if ($apache or $apache2) { - my $vers; - if ($apache) { -$vers = qx{$apache\\apache.exe -v}; -die qq{$apache does not appear to be version 1.3} - unless $vers =~ m!Apache/1.3!; - } - else { -$vers = qx{$apache2\\bin\\apache.exe -v}; -die qq{$apache2 does not appear to be version 2.0} - unless $vers =~ m!Apache/2.0!; - } +my $vers; +if ($apache) { +$vers = qx{$apache/apache.exe -v}; +die qq{$apache does not appear to be version 1.3} +unless $vers =~ m!Apache/1.3!; +} +else { +$vers = qx{$apache2/bin/apache.exe -v}; +die qq{$apache2 does not appear to be version 2.0} +unless $vers =~ m!Apache/2.0!; +} } - # prompt to get an Apache installation directory else { - my $dir = prompt(Where is your apache installation directory?, ''); - die 'Need to specify the Apache installation directory' unless $dir; - die qq{$dir does not exist} unless (-d $dir); - if ($dir =~ /Apache2/) { -my $ans = prompt(qq{Install mod_perl-2 for $dir?}, 'yes'); -$apache2 = $dir if ($ans =~ /^y/i); - } - else { -my $ans = prompt(qq{Install mod_perl-1 for $dir?}, 'yes'); -$apache = $dir if ($ans =~ /^y/i); - } - unless ($apache or $apache2) { -my $mpv = prompt('Which mod_perl version would you like [1 or 2]?', 2); -if ($mpv == 1) { - $apache = $dir; -} -elsif ($mpv == 2) { - $apache2 = $dir; +my $dir = prompt(Where is your apache installation directory?, ''); +die 'Need to specify the Apache installation directory' unless $dir; +$dir = fix_path($dir); +die qq{$dir does not exist} unless (-d $dir); +if ($dir =~ /Apache2/) { +my $ans = prompt(qq{Install mod_perl-2 for $dir?}, 'yes'); +$apache2 = $dir if ($ans =~ /^y/i); } else { - die 'Please
cvs commit: modperl-docs/src/docs/2.0/os/win32 distinstall install.pod
randyk 2003/05/03 11:10:48 Modified:src/docs/2.0/os/win32 distinstall install.pod Log: s/theoryx5.uwinnipeg.ca/perl.apache.org/ for Win32 binary locations, to help make University of Winnipeg's network administrator happier :) Revision ChangesPath 1.2 +1 -1 modperl-docs/src/docs/2.0/os/win32/distinstall Index: distinstall === RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/distinstall,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- distinstall 3 Jan 2003 16:48:43 - 1.1 +++ distinstall 3 May 2003 18:10:48 - 1.2 @@ -40,7 +40,7 @@ Available distributions are: -1. Perl 5.8.0 / Apache 2.0.43 / mod_perl 1.99_08 +1. Perl 5.8.0 / Apache 2.0.45 / mod_perl 1.99 2. Perl 5.6.1 / Apache 1.3.27 / mod_perl 1.27 END 1.21 +2 -2 modperl-docs/src/docs/2.0/os/win32/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/install.pod,v retrieving revision 1.20 retrieving revision 1.21 diff -u -r1.20 -r1.21 --- install.pod 6 Jan 2003 22:21:35 - 1.20 +++ install.pod 3 May 2003 18:10:48 - 1.21 @@ -212,13 +212,13 @@ =head2 All in one packages -At Lhttp://theoryx5.uwinnipeg.ca/pub/other/ there is a self-extracting +At Lhttp://perl.apache.org/dist/win32-bin/ there is a self-extracting archive FPerl-5.8-win32-bin.exe containing a binary version of perl-5.8 (compatible with ActivePerl 8xx), together with Apache 2.0 and mod_perl 2.0. See the file FPerl-5.8-win32-bin.readme for a description. If you have trouble fetching the whole file at once, the directory -Lhttp://theoryx5.uwinnipeg.ca/pub/other/Perl-5.8-win32-bin/ +Lhttp://perl.apache.org/dist/win32-bin/Perl-5.8-win32-bin/ contains this distribution split across multiple files - see FREADME.join for instructions on how to join them. Alternatively, if you have Perl already, you can get the script - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/general/os/win32 faq.pod
randyk 2003/01/19 15:59:57 Modified:src/docs/general/os/win32 faq.pod Log: removed a couple of non-Win32 specific issues, with links inserted to general troubleshooting docs. Revision ChangesPath 1.5 +12 -17modperl-docs/src/docs/general/os/win32/faq.pod Index: faq.pod === RCS file: /home/cvs/modperl-docs/src/docs/general/os/win32/faq.pod,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- faq.pod 19 Jan 2003 21:26:36 - 1.4 +++ faq.pod 19 Jan 2003 23:59:57 - 1.5 @@ -7,6 +7,14 @@ This document discusses some questions that arise often with mod_perl on Win32. +If you don't find a solution to your problem here, make sure to check +the general troubleshooting documents, where non-platform specific +problems are discussed. In particular, see the discussion of +Lfrequent mod_perl problems|docs::1.0::guide::frequent, +Ldebugging mod_perl|docs::1.0::guide::debug, and +a Ltroubleshooting guide for mod_perl +2.0|docs::2.0::user::troubleshooting::troubleshooting. + =head1 Obtaining mod_perl =head2 Do I need Perl to use mod_perl? @@ -187,23 +195,11 @@ you should write to STDOUT all text you want the perl application to see as a return value from your Cqx or `` (backticks) call. -=head2 My server crashes when trying to use DBI. - -Try upgrading to the newest version of DBI, and also the -appropriate DBD::* driver. If this doesn't help, it may -mean that the database driver may need some changes to work -in a multi-threaded environment. - -=head2 An error about not being able to load a file results when using DBD::mysql. - -Try putting the path to your mysql DLLs (eg, FD:\mysql\lib\opt) in -your IPATH environment variable. - -=head2 An error about not finding IApache.pm results under mod_perl -2.0 when using ICGI.pm. +=head2 An error about being unable to load a file results when using a DBD database driver. -Try upgrading CGI.pm to at least version 2.87 - earlier versions -were not mod_perl 2.0 aware. +Try putting the path to your database DLLs in +your IPATH environment variable. Also, make sure you are using the +latest versions of IDBI and your IDBD::* driver. =head2 I get an error about being unable to load IApache::Request. @@ -218,7 +214,6 @@ The discussion of Lfrequent mod_perl problems|docs::1.0::guide::frequent, -the Ltroubleshooting index|docs::1.0::guide::troubleshooting, Ldebugging mod_perl|docs::1.0::guide::debug, and a Ltroubleshooting guide for mod_perl 2.0|docs::2.0::user::troubleshooting::troubleshooting. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/general/os/win32 faq.pod
randyk 2003/01/07 19:00:45 Modified:src/docs/general/os/win32 faq.pod Log: addition of questions about DBI and DBD::* problems. Revision ChangesPath 1.2 +12 -0 modperl-docs/src/docs/general/os/win32/faq.pod Index: faq.pod === RCS file: /home/cvs/modperl-docs/src/docs/general/os/win32/faq.pod,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- faq.pod 6 Jan 2003 22:21:36 - 1.1 +++ faq.pod 8 Jan 2003 03:00:45 - 1.2 @@ -187,6 +187,18 @@ you should write to STDOUT all text you want the perl application to see as a return value from your Cqx or `` (backticks) call. +=head2 My server crashes when trying to use DBI. + +Try upgrading to the newest version of DBI, and also the +appropriate DBD::* driver. If this doesn't help, it may +mean that the database driver may need some changes to work +in a multi-threaded environment. + +=head2 An error about not being able to load a file results when using DBD::mysql. + +Try putting the path to your mysql DLLs (eg, FD:\mysql\lib\opt) in +your IPATH environment variable. + =head1 See Also The discussion of - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/general/os - New directory
randyk 2003/01/06 13:55:01 modperl-docs/src/docs/general/os - New directory - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/general/os/win32 - New directory
randyk 2003/01/06 13:55:40 modperl-docs/src/docs/general/os/win32 - New directory - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/general/os/win32 Changes.pod config.cfg faq.pod
randyk 2003/01/06 14:21:36 Modified:src/docs/1.0/os/win32 config.pod install.pod src/docs/2.0/os/win32 config.pod faq.pod install.pod src/docs/general config.cfg Added: src/docs/general/os config.cfg src/docs/general/os/win32 Changes.pod config.cfg faq.pod Log: moved bulk of Win32 mod_perl faq to general/os/win32/ Revision ChangesPath 1.7 +1 -1 modperl-docs/src/docs/1.0/os/win32/config.pod Index: config.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/config.pod,v retrieving revision 1.6 retrieving revision 1.7 diff -u -r1.6 -r1.7 --- config.pod2 Jan 2003 07:56:04 - 1.6 +++ config.pod6 Jan 2003 22:21:35 - 1.7 @@ -128,7 +128,7 @@ Win32|docs::1.0::os::win32::install, the Lmod_perl documentation|docs::index, Lhttp://take23.org/, and the -LFAQs for mod_perl on Win32|docs::2.0::os::win32::faq. +LFAQs for mod_perl on Win32|docs::general::os::win32::faq. Help is also available through the archives of and subscribing to the Lmod_perl mailing list|maillist::modperl. 1.22 +3 -3 modperl-docs/src/docs/1.0/os/win32/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/install.pod,v retrieving revision 1.21 retrieving revision 1.22 diff -u -r1.21 -r1.22 --- install.pod 3 Jan 2003 16:48:43 - 1.21 +++ install.pod 6 Jan 2003 22:21:35 - 1.22 @@ -226,10 +226,10 @@ necessary Perl and Apache binaries: IndigoPerl from Lhttp://www.indigostar.com/, and the self-extracting archive Fperl-win32-bin.exe from -Lftp://theoryx5.uwinnipeg.ca/pub/other/ - see the file +Lhttp://theoryx5.uwinnipeg.ca/pub/other/ - see the file Fperl-win32-bin.readme for a description. If you have trouble fetching the whole file at once, the directory -Lftp://theoryx5.uwinnipeg.ca/pub/other/perl-win32-bin/ +Lhttp://theoryx5.uwinnipeg.ca/pub/other/perl-win32-bin/ contains this distribution split across multiple files - see FREADME.join for instructions on how to join them. Alternatively, if you have Perl already, you can get the script @@ -344,7 +344,7 @@ Win32|docs::1.0::os::win32::config, the Lmod_perl documentation|docs::index, Lhttp://take23.org/, and the -LFAQs for mod_perl on Win32|docs::2.0::os::win32::faq. +LFAQs for mod_perl on Win32|docs::general::os::win32::faq. Help is also available through the archives of and subscribing to the Lmod_perl mailing list|maillist::modperl. 1.10 +1 -1 modperl-docs/src/docs/2.0/os/win32/config.pod Index: config.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/config.pod,v retrieving revision 1.9 retrieving revision 1.10 diff -u -r1.9 -r1.10 --- config.pod2 Jan 2003 07:56:04 - 1.9 +++ config.pod6 Jan 2003 22:21:35 - 1.10 @@ -190,7 +190,7 @@ Lhttp://take23.org/, Lhttp://httpd.apache.org/, Lhttp://www.activestate.com/, and the -LFAQs for mod_perl on Win32|docs::2.0::os::win32::faq. +LFAQs for mod_perl on Win32|docs::general::os::win32::faq. Help is also available through the archives of and subscribing to the Lmod_perl mailing list|maillist::modperl. 1.3 +3 -146modperl-docs/src/docs/2.0/os/win32/faq.pod Index: faq.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/faq.pod,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- faq.pod 3 Jan 2003 04:43:05 - 1.2 +++ faq.pod 6 Jan 2003 22:21:35 - 1.3 @@ -5,156 +5,13 @@ =head1 Description This document discusses some questions that arise often -with mod_perl on Win32. +with mod_perl 2.0 on Win32. -=head1 Obtaining mod_perl - -=head2 Do I need Perl to use mod_perl? - -Yes, Perl is required. You can obtain a Win32 Perl -binary from Lhttp://www.activestate.com/. See also -the all-in-one binary packages for both -Lmod_perl 1.0|docs::1.0::os::win32::install/All_in_one_packages -and -Lmod_perl 2.0|docs::2.0::os::win32::install/All_in_one_packages -which include Perl, Apache, and mod_perl. - -=head2 Are mod_perl ppm packages available? - -PPM packages for both -Lmod_perl 1.0|docs::1.0::os::win32::install/PPM_Packages -and -Lmod_perl 2.0|docs::2.0::os::win32::install/PPM_Packages -are available. - -=head2 Should I use mod_perl 1.0 or mod_perl 2.0? - -Lmod_perl 1.0|docs::1.0::guide::intro, for use with Apache 1.0, -is stable and well tested, while -Lmod_perl 2.0|docs::2.0::user::intro::overview, for use
cvs commit: modperl-docs/src/docs/2.0/os/win32 distinstall config.cfg install.pod get-Perl-5.8-win32-bin
randyk 2003/01/03 08:48:43 Modified:src/docs/1.0/os/win32 config.cfg install.pod src/docs/2.0/os/win32 config.cfg install.pod Added: src/docs/1.0/os/win32 distinstall src/docs/2.0/os/win32 distinstall Removed: src/docs/1.0/os/win32 get-perl-win32-bin src/docs/2.0/os/win32 get-Perl-5.8-win32-bin Log: merge all-in-one package fetching scripts into one. Revision ChangesPath 1.10 +1 -1 modperl-docs/src/docs/1.0/os/win32/config.cfg Index: config.cfg === RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/config.cfg,v retrieving revision 1.9 retrieving revision 1.10 diff -u -r1.9 -r1.10 --- config.cfg3 Jan 2003 04:43:48 - 1.9 +++ config.cfg3 Jan 2003 16:48:43 - 1.10 @@ -17,7 +17,7 @@ copy_glob = [qw( mpinstall -get-perl-win32-bin +distinstall )], changes = 'Changes.pod', 1.21 +2 -2 modperl-docs/src/docs/1.0/os/win32/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/install.pod,v retrieving revision 1.20 retrieving revision 1.21 diff -u -r1.20 -r1.21 --- install.pod 2 Jan 2003 21:56:50 - 1.20 +++ install.pod 3 Jan 2003 16:48:43 - 1.21 @@ -233,8 +233,8 @@ contains this distribution split across multiple files - see FREADME.join for instructions on how to join them. Alternatively, if you have Perl already, you can get the script -Fget-perl-win32-bin which, when invoked as -Cperl get-perl-win32-bin, will fetch and join +Fdistinstall which, when invoked as +Cperl distinstall, will fetch and join the files for you. As well as including a number of non-core modules, both of these 1.1 modperl-docs/src/docs/1.0/os/win32/distinstall Index: distinstall === # # A Perl script to retrieve and join split files # making up a Win32 Perl/Apache binary distribution # # Files created by hjsplit (http://www.freebyte.com/hjsplit/) # with the joining accomplished by hj-join # # This script is Copyright 2003, by Randy Kobes, # and may be distributed under the same terms as Perl itself. # Please report problems to Randy Kobes [EMAIL PROTECTED] # use strict; use warnings; use Net::FTP; use Safe; use Digest::MD5; use IO::File; use ExtUtils::MakeMaker; die 'This is intended for Win32' unless ($^O =~ /Win32/i); my $theoryx5 = 'theoryx5.uwinnipeg.ca'; my $bsize = 102400; my $kb = sprintf(%d, $bsize / 1024); my $cs = 'CHECKSUMS'; my $join = 'join32.exe'; print END; This script will fetch and then join the files needed for creating and installing a Perl/Apache Win32 binary distribution from ftp://$theoryx5/pub/other/. If the file transfer is interrupted before all the neccessary files are obtained, run the script again in the same directory; files successfully fetched earlier will not be downloaded again. A hash mark represents transfer of $kb kB. Available distributions are: 1. Perl 5.8.0 / Apache 2.0.43 / mod_perl 1.99_08 2. Perl 5.6.1 / Apache 1.3.27 / mod_perl 1.27 END my $dist; my $ans = prompt(Desired distribution (1, 2, or 'q' to quit)?, 1); CHECK: { ($ans =~ /^q/i) and die 'Installation aborted'; ($ans == 1) and do { $dist = 'Perl-5.8-win32-bin'; last CHECK; }; ($ans == 2) and do { $dist = 'perl-win32-bin'; last CHECK; }; die 'Please answer either 1, 2, or q'; } my $exe = $dist . '.exe'; my $ftp = Net::FTP-new($theoryx5); $ftp-login('anonymous', [EMAIL PROTECTED]) or die Cannot login to $theoryx5; $ftp-cwd(pub/other/$dist) or die Cannot cwd to pub/other/$dist; my $max; die Unable to determine number of files to get unless ($max = get_max()); my @files = (); # fetch the CHECKSUMS file print qq{Fetching $cs ...}; $ftp-ascii; $ftp-get($cs); print done!\n; die qq{Failed to fetch $cs} unless (-e $cs); push @files, $cs; # evaluate CHECKSUMS my $cksum; die qq{Cannot load $cs file} unless ($cksum = load_cs($cs) ); $ftp-binary; $ftp-hash(1, $bsize); # fetch the join program die qq{Cannot fetch $join} unless (fetch($join)); push @files, $join; # fetch the split files print \nFetching $max split files \n\n; for (1 .. $max) { my $num = $_ 10 ? 00$_ : 0$_; my $file = $dist . '.exe.' . $num; push @files, $file; die qq{Cannot fetch $file} unless (fetch($file)); } print
cvs commit: modperl-docs/src/docs/2.0/os/win32 faq.pod config.cfg config.pod install.pod
randyk 2003/01/01 23:56:04 Modified:src/docs/1.0/os/win32 config.pod install.pod src/docs/2.0/os/win32 config.cfg config.pod install.pod Added: src/docs/2.0/os/win32 faq.pod Log: added win32 faq Revision ChangesPath 1.6 +3 -1 modperl-docs/src/docs/1.0/os/win32/config.pod Index: config.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/config.pod,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- config.pod28 Dec 2002 20:35:27 - 1.5 +++ config.pod2 Jan 2003 07:56:04 - 1.6 @@ -126,7 +126,9 @@ The directions for Linstalling mod_perl 1.0 on Win32|docs::1.0::os::win32::install, the Lmod_perl -documentation|docs::index, Lhttp://take23.org/. +documentation|docs::index, Lhttp://take23.org/, +and the +LFAQs for mod_perl on Win32|docs::2.0::os::win32::faq. Help is also available through the archives of and subscribing to the Lmod_perl mailing list|maillist::modperl. 1.18 +3 -1 modperl-docs/src/docs/1.0/os/win32/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/install.pod,v retrieving revision 1.17 retrieving revision 1.18 diff -u -r1.17 -r1.18 --- install.pod 31 Dec 2002 19:24:25 - 1.17 +++ install.pod 2 Jan 2003 07:56:04 - 1.18 @@ -334,7 +334,9 @@ The directions for Lconfiguring mod_perl 1.0 on Win32|docs::1.0::os::win32::config, the Lmod_perl -documentation|docs::index, Lhttp://take23.org/. +documentation|docs::index, Lhttp://take23.org/, +and the +LFAQs for mod_perl on Win32|docs::2.0::os::win32::faq. Help is also available through the archives of and subscribing to the Lmod_perl mailing list|maillist::modperl. 1.8 +1 -0 modperl-docs/src/docs/2.0/os/win32/config.cfg Index: config.cfg === RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/config.cfg,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- config.cfg21 Dec 2002 07:26:16 - 1.7 +++ config.cfg2 Jan 2003 07:56:04 - 1.8 @@ -12,6 +12,7 @@ chapters = [qw( install.pod config.pod +faq.pod )], copy_glob = [qw( 1.9 +4 -2 modperl-docs/src/docs/2.0/os/win32/config.pod Index: config.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/config.pod,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- config.pod28 Dec 2002 20:35:28 - 1.8 +++ config.pod2 Jan 2003 07:56:04 - 1.9 @@ -187,8 +187,10 @@ The directions for Linstalling mod_perl 2.0 on Win32|docs::2.0::os::win32::install, the Lmod_perl documentation|docs::index, Lhttp://perl.apache.org/, -Lhttp://take23.org/, Lhttp://httpd.apache.org/, and -Lhttp://www.activestate.com/. +Lhttp://take23.org/, Lhttp://httpd.apache.org/, +Lhttp://www.activestate.com/, +and the +LFAQs for mod_perl on Win32|docs::2.0::os::win32::faq. Help is also available through the archives of and subscribing to the Lmod_perl mailing list|maillist::modperl. 1.16 +3 -1 modperl-docs/src/docs/2.0/os/win32/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/install.pod,v retrieving revision 1.15 retrieving revision 1.16 diff -u -r1.15 -r1.16 --- install.pod 31 Dec 2002 19:24:25 - 1.15 +++ install.pod 2 Jan 2003 07:56:04 - 1.16 @@ -223,7 +223,9 @@ The directions for Lconfiguring mod_perl 2.0 on Win32|docs::2.0::os::win32::config, the Lmod_perl documentation|docs::index, Lhttp://take23.org/, -Lhttp://httpd.apache.org/, and Lhttp://www.activestate.com/. +Lhttp://httpd.apache.org/, Lhttp://www.activestate.com/, +and the +LFAQs for mod_perl on Win32|docs::2.0::os::win32::faq. Help is also available through the archives of and subscribing to the Lmod_perl mailing list|maillist::modperl. 1.1 modperl-docs/src/docs/2.0/os/win32/faq.pod Index: faq.pod === =head1 NAME Frequently asked questions for mod_perl on Win32 =head1 Description This document discusses some questions that arise often with mod_perl on Win32. =head1 Obtaining mod_perl =head2 Do I need Perl to use mod_perl? Yes, Perl is required. You can obtain a Win32 Perl binary from Lhttp
cvs commit: modperl-docs/src/docs/2.0/os/win32 get-Perl-5.8-win32-bin config.cfg install.pod
randyk 2003/01/02 13:56:50 Modified:src/docs/1.0/os/win32 config.cfg install.pod src/docs/2.0/os/win32 config.cfg install.pod Added: src/docs/1.0/os/win32 get-perl-win32-bin src/docs/2.0/os/win32 get-Perl-5.8-win32-bin Log: added script to fetch, build, and install all-in-one packages. Revision ChangesPath 1.8 +1 -0 modperl-docs/src/docs/1.0/os/win32/config.cfg Index: config.cfg === RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/config.cfg,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- config.cfg21 Dec 2002 07:26:16 - 1.7 +++ config.cfg2 Jan 2003 21:56:50 - 1.8 @@ -17,6 +17,7 @@ copy_glob = [qw( mpinstall + get-perl-win32-bin )], changes = 'Changes.pod', 1.20 +4 -0 modperl-docs/src/docs/1.0/os/win32/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/install.pod,v retrieving revision 1.19 retrieving revision 1.20 diff -u -r1.19 -r1.20 --- install.pod 2 Jan 2003 20:51:35 - 1.19 +++ install.pod 2 Jan 2003 21:56:50 - 1.20 @@ -232,6 +232,10 @@ Lftp://theoryx5.uwinnipeg.ca/pub/other/perl-win32-bin/ contains this distribution split across multiple files - see FREADME.join for instructions on how to join them. +Alternatively, if you have Perl already, you can get the script +Fget-perl-win32-bin which, when invoked as +Cperl get-perl-win32-bin, will fetch and join +the files for you. As well as including a number of non-core modules, both of these packages contain mod_perl. See the documentation on the web sites and 1.1 modperl-docs/src/docs/1.0/os/win32/get-perl-win32-bin Index: get-perl-win32-bin === # # A Perl script to retrieve and join split files # making up a Win32 Perl/Apache binary distribution # # Files created by hjsplit (http://www.freebyte.com/hjsplit/) # with the joining accomplished by hj-join # # This script is Copyright 2003, by Randy Kobes, # and may be distributed under the same terms as Perl itself. # Please report problems to Randy Kobes [EMAIL PROTECTED] # use strict; use warnings; use LWP::Simple; use Safe; use Digest::MD5; use IO::File; use ExtUtils::MakeMaker; my $dist = 'perl-win32-bin'; my $exe = $dist . '.exe'; my $theoryx5 = 'ftp://theoryx5.uwinnipeg.ca/pub/other' . '/' . $dist; my $max = 9; print END; This script will fetch and then join the files needed for creating the Perl/Apache Win32 binary distribution $exe from $theoryx5/. If the file transfer is interrupted before all the neccessary files are joined, run the script again in the same directory; files successfully fetched earlier will not be downloaded again. END my $ans = prompt(Fetch $exe?, 'yes'); die Installation aborted unless ($ans =~ /^y/i); my $cs = 'CHECKSUMS'; my $checksums = $theoryx5 . '/' . $cs; my $join = 'join32.exe'; my $rjoin = $theoryx5 . '/' . $join; # fetch the CHECKSUMS file print Fetching $cs ...; getstore($checksums, $cs); print done!\n; die Failed to fetch $cs unless (-e $cs); # fetch the join program unless (-e $join) { print Fetching $join ...; getstore($rjoin, $join); print done!\n; die Failed to fetch $join unless (-e $join); unless (verifyMD5($join)) { print qq{CHECKSUM check for $join failed.\n}; unlink $join or warn Cannot unlink $join: $!; die; } } # fetch the split files my @files; for (1 .. $max) { my $num = $_ 10 ? 00$_ : 0$_; my $file = $dist . '.exe.' . $num; push @files, $file; if (-e $file) { print Skipping $file ...\n; next; } my $rfile = $theoryx5 . '/' . $file; print Fetching $file ...; getstore($rfile, $file); print done!\n; die Failed to fetch $file unless (-e $file); unless (verifyMD5($file)) { print qq{CHECKSUM check for $file failed.\n}; unlink $file or warn Cannot unlink $file: $!; die; } } #now join them my @args = ('join32'); system(@args); die Joining files to create $exe failed unless (-e $exe); # remove the temporary files, if desired $ans = prompt('Remove temporary files?', 'yes'); if ($ans =~ /^y/i) { unlink @files or warn Cannot unlink @files: $!; } # run the exe, if desired $ans = prompt(Run $exe now?, 'yes'); if ($ans =~ /^y/i) { @args = ($exe); system(@args); } else
cvs commit: modperl-docs/src/docs/2.0/os/win32 install.pod
randyk 2002/12/31 11:24:26 Modified:src/docs/1.0/guide getwet.pod install.pod src/docs/1.0/os/win32 install.pod multithread.pod src/docs/2.0/os/win32 install.pod Log: - avoid duplicating cvs info in win32 pages - use perl.apache.org links to source distributions - make links in guide to win32 binary distributions Revision ChangesPath 1.9 +29 -79modperl-docs/src/docs/1.0/guide/getwet.pod Index: getwet.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/getwet.pod,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- getwet.pod17 Sep 2002 17:13:23 - 1.8 +++ getwet.pod31 Dec 2002 19:24:25 - 1.9 @@ -369,18 +369,25 @@ =head1 Installing mod_perl for Windows Apache runs on many flavors of Unix and Unix-like operating systems. -Version 1.3 introduced a port to the Windows familiy of operating +Version 1.3 introduced a port to the Windows family of operating systems, often named CWin32 after the name of the common API. Because of many deep differences between Unix and Windows, the Win32 port of Apache is still branded as beta quality, because it hasn't yet reached the stability and performance of the native Unix counterpart. -Another hindrance to using mod_perl on Windows is that current +Another hindrance to using mod_perl 1.0 on Windows is that current versions of Perl are not thread-safe on Win32. As a consequence, mod_perl calls to the embedded Perl interpreter must be serialized, -i.e. executed one at a time. For these reasons, we recommend that -mod_perl on Windows be used only for testing purposes, not in -production. +i.e. executed one at a time. See the discussion on +Lmultithreading on Win32 +mod_perl 1.xx|docs::1.0::os::win32::multithread +for details. This situation changes with Apache/mod_perl 2.0, +which is based on a +multi-process/multi-thread approach using a native Win32 threads +implementation - see the Lmod_perl 2 +overview|docs::2.0::user::intro::overview for more details, +and the discussion of Lmodperl 2.0 in Win32|docs::2.0::os::win32::install +on getting modperl-2 for Win32 in particular. Building mod_perl from source on Windows is a bit of a challenge. Development tools such as a C compiler are not bundled with the @@ -388,80 +395,23 @@ as with most Windows software. Additionally, all software packages need to be built with the same compiler and compile options. This means building Perl, Apache, and mod_perl from source, quite a -daunting task. - -Fortunately, Randy Kobes maintains a Windows distribution of mod_perl -which includes all the necessary tools, including Perl, Apache, and a -host of useful CPAN modules. Using this distribution provides an -out-of-the-box Apache+mod_perl combo in minutes. - -The distribution comes with extensive documentation. Take the time to -read it, particularly if you wish to install the software in a -location different from the default. In the following installation -we'll use the default locations and options. - -=head2 Download the Windows distribution - -Download Cperl-win32-bin-x.x.exe from the Lbinary distributions -page|download::binaries. This is a self-extracting archive, yielding -four directories: - - Apache - Perl - openssl - readmes - - -=head2 Install the software - -Move the CApache and CPerl directories to CC:\. Edit -CC:\AUTOEXEC.BAT to install the Perl executable directories in your -system's search path: - - SET PATH=C:\Perl\5.6.1\bin;C:\Perl\5.6.1\bin\MSWin32-x86;%PATH% - -Then restart Windows for this change to take effect. - - -=head2 Test the Perl installation - -Open a DOS prompt window and verify that Perl is installed correctly -and learn the version number: - - C:\ perl -v - - This is perl, v5.6.1 built for MSWin32-x86 - - Copyright 1987-2000, Larry Wall - - -=head2 Start Apache - -The distribution comes with a ready-made configuration file for -mod_perl which we'll use to start Apache. From the CC:\Apache -directory, start Apache: - - C:\Apache apache.exe - -Now issuing a request for Ihttp://localhost/ displays the usual -Apache CIt Worked page. - -=head2 Test mod_perl - -The distribution comes with a pre-configured mod_perl handler and -CApache::Registry directory. We can test our mod_perl enabled server -by issuing the following requests: - - http://localhost/hello - http://localhost/mod_perl/printenv - -We now have a fully-functional mod_perl server. The example scripts -described in the rest of this chapter can be used with minor -modifications to file paths and URIs. In particular, change all -instances of I/home/stas with CC:\Apache\, and change all -instances
cvs commit: modperl-docs/src/docs/2.0/os/win32 mpinstall
randyk 2002/12/31 15:25:01 Modified:src/docs/1.0/os/win32 mpinstall src/docs/2.0/os/win32 mpinstall Log: s/warn/die/ Revision ChangesPath 1.3 +4 -4 modperl-docs/src/docs/1.0/os/win32/mpinstall Index: mpinstall === RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/mpinstall,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- mpinstall 31 Dec 2002 22:59:48 - 1.2 +++ mpinstall 31 Dec 2002 23:25:01 - 1.3 @@ -163,11 +163,11 @@ # check CHECKSUMS for the tar.gz file if (-e $cs) { unless (verifyMD5($tgzfile)) { -print qq{CHECKSUM check for $tgzfile failed.\n}; +die qq{CHECKSUM check for $tgzfile failed.\n}; } } else { - warn Failed to fetch $checksums - will not verify CHECKSUMS.; + die Failed to fetch $checksums - cannot verify CHECKSUMS.; } # edit the ppd file to reflect a local installation @@ -258,8 +258,8 @@ my $file = shift; my $fh = IO::File-new; my $cksum; - unless (open $fh, 'CHECKSUMS') { -warn Could not open CHECKSUMS: $!; + unless (open $fh, $cs) { +warn Could not open $cs: $!; return; } local($/); 1.3 +4 -4 modperl-docs/src/docs/2.0/os/win32/mpinstall Index: mpinstall === RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/mpinstall,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- mpinstall 31 Dec 2002 22:59:48 - 1.2 +++ mpinstall 31 Dec 2002 23:25:01 - 1.3 @@ -163,11 +163,11 @@ # check CHECKSUMS for the tar.gz file if (-e $cs) { unless (verifyMD5($tgzfile)) { -print qq{CHECKSUM check for $tgzfile failed.\n}; +die qq{CHECKSUM check for $tgzfile failed.\n}; } } else { - warn Failed to fetch $checksums - will not verify CHECKSUMS.; + die Failed to fetch $checksums - cannot verify CHECKSUMS.; } # edit the ppd file to reflect a local installation @@ -258,8 +258,8 @@ my $file = shift; my $fh = IO::File-new; my $cksum; - unless (open $fh, 'CHECKSUMS') { -warn Could not open CHECKSUMS: $!; + unless (open $fh, $cs) { +warn Could not open $cs: $!; return; } local($/); - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/os/win32 config.pod install.pod
randyk 2002/12/28 12:35:28 Modified:src/docs/1.0/os/win32 config.pod install.pod multithread.pod src/docs/2.0/os/win32 config.pod install.pod Log: link fixes, and pointer to new perl-5.8 Win32 binary Revision ChangesPath 1.5 +4 -2 modperl-docs/src/docs/1.0/os/win32/config.pod Index: config.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/config.pod,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- config.pod18 Nov 2002 17:35:42 - 1.4 +++ config.pod28 Dec 2002 20:35:27 - 1.5 @@ -120,13 +120,15 @@ the Bnmake utility for this, download it from http://download.microsoft.com/download/vc15/Patch/1.52/W95/EN-US/Nmake15.exe (it's a self extracting archive, so run it and then copy the files -into your FWindows directory). +to somewhere in your IPATH environment variable). =head1 See Also The directions for Linstalling mod_perl 1.0 on Win32|docs::1.0::os::win32::install, the Lmod_perl -documentation|docs::index, and http://take23.org/. +documentation|docs::index, Lhttp://take23.org/. +Help is also available through the archives of and subscribing to +the Lmod_perl mailing list|maillist::modperl. =head1 Maintainers 1.16 +35 -30modperl-docs/src/docs/1.0/os/win32/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/install.pod,v retrieving revision 1.15 retrieving revision 1.16 diff -u -r1.15 -r1.16 --- install.pod 21 Dec 2002 07:26:16 - 1.15 +++ install.pod 28 Dec 2002 20:35:27 - 1.16 @@ -6,25 +6,21 @@ This document discusses how to install mod_perl 1.0 under Win32, both in building from sources and in installing pre-compiled binary -packages. Unless you are using an all-in-one package, you should -first install Perl and Apache, either from the sources or as binaries. -The Perl sources are available from +packages. -http://www.cpan.org/src/ +=head1 Synopsis +Unless you are using an all-in-one package, you should +first install Perl and Apache, either from the sources or as binaries. +The Perl sources are available from Lhttp://www.cpan.org/src/, with directions for building contained in FREADME.win32. ActiveState also makes the sources available for their binary -builds at - -ftp://ftp.activestate.com/ActivePerl/src/ - +builds at Lftp://ftp.activestate.com/ActivePerl/src/, which may contain, in particular, Win32-specific fixes not in the CPAN Perl sources. As a binary, at present, an ActivePerl-compatible Perl, compiled with Visual C++, is the most common one used in the Win32 mod_perl/Apache environment; you can obtain such a prebuilt Perl -binary from - -http://www.activestate.com/ +binary from Lhttp://www.activestate.com/. Note that, currently, mod_perl 1.0 does not work with an ActivePerl Perl in the 8xx series (based on perl-5.8), due @@ -40,8 +36,7 @@ for details. The Apache sources and binaries are available at - - http://httpd.apache.org/ +Lhttp://httpd.apache.org/. When installing Perl or other related binaries, subtleties may arise in using path names that have spaces in them - you may, for example, @@ -78,10 +73,8 @@ =back -Obtain the mod_perl sources from CPAN: - - http://www.cpan.org/authors/id/D/DO/DOUGM/mod_perl-1.xx.tar.gz - +Obtain the mod_perl sources (Fmod_perl-1.xx.tar.gz) from CPAN +under Lhttp://www.cpan.org/authors/id/D/DO/DOUGM/. When unpacked, using Winzip or similar tools, a subdirectory Fmod_perl-1.xx will be created. @@ -210,6 +203,20 @@ Apache and mod_perl header files, which can then be accessed through the Apache::src module. +If this build fails, you may want to try the sources obtained +from cvs (you may also want to use the Apache cvs sources). +To do this, first obtain a Win32 cvs client from, for example, +Lhttp://www.cvshome.org/. The cvs sources may be obtained as + + C:\src cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic login + C:\src cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic co apache-1.3 + C:\src cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic co modperl + +The build then proceeds as above. Be aware, though, +that as well as providing bug fixes, there may be new features being +added and tested in the cvs versions, so at any given time there are +no guarantees that these packages will build and test successfully. + =head1 Binaries There are two major types of binary packages @@ -219,11 +226,11 @@ =head2 All-in-one packages There are at least two binary packages for Win32 that contain the -necessary Perl
cvs commit: modperl-docs/src/docs/2.0/os/win32 install.pod
randyk 2002/12/14 10:23:47 Modified:src/docs/2.0/os/win32 install.pod Log: recommend perl-5.8 for Win32 and mod_perl-2. Revision ChangesPath 1.12 +49 -60modperl-docs/src/docs/2.0/os/win32/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/install.pod,v retrieving revision 1.11 retrieving revision 1.12 diff -u -r1.11 -r1.12 --- install.pod 28 Nov 2002 17:08:21 - 1.11 +++ install.pod 14 Dec 2002 18:23:47 - 1.12 @@ -41,15 +41,12 @@ http://httpd.apache.org/ As of this writing, mod_perl-2 is known to compile and work -with an ActivePerl-compatable Perl (builds 6xx), based on -perl-5.6.1. It also works with perl-5.8 compiled with the default compile-time -flags in the Win32 FMakefile. Because of improved threading support, -it is expected sometime in the future that perl-5.8 will be the -recommended Perl for Win32 mod_perl-2. ActiveState currently has -a beta perl-5.8 Win32 binary ready for testing; see the section -on Apache/mod_perl binaries below for details on a suitable -repository containing mod_perl, and also how to obtain another perl-5.8 -Win32 binary package. +with an ActivePerl-compatible Perl, both for builds 6xx, based +on perl-5.6.1, and builds 8xx, based on perl-5.8.0. However, +because of improved threading support, perl-5.8 is recommended +for Win32 mod_perl-2. See the section on Apache/mod_perl binaries +below for details on a suitable repository containing mod_perl +ppm packages, and also how to obtain other Win32 binary packages. When installing Perl or other related binaries, subtleties may arise in using path names that have spaces in them - you may, for example, @@ -129,10 +126,10 @@ =item PPM The first, for ActivePerl users, is through CPPM - this assumes you -already have ActivePerl (build 6xx) from http://www.activestate.com/ -and a Win32 Apache 2.0 binary from http://httpd.apache.org/. In -installing this, you may find it convenient when transcribing any -Unix-oriented documentation to choose installation directories that do +already have ActivePerl (build 8xx is recommended) from +http://www.activestate.com/ and a Win32 Apache 2.0 binary from +http://httpd.apache.org/. In installing this, you might avoid +some future problems by choosing installation directories that do not have spaces in their names (eg, FC:/Apache2). After installing Perl and Apache 2.0, you can then install mod_perl @@ -144,21 +141,40 @@ C:\ ppm install http://theoryx5.uwinnipeg.ca/ppmpackages/mod_perl-2.ppd -Another way, which will be useful if you plan on installing additional -Apache modules, is to set the repository within the Cppm shell -utility as (broken over 2 lines for readability) +for ActivePerl 6xx builds, and - PPM set repository theoryx5 - http://theoryx5.uwinnipeg.ca/cgi-bin/ppmserver?urn:/PPMServer + C:\ ppm install + http://theoryx5.uwinnipeg.ca/ppms/mod_perl.ppd + +for ActivePerl 8xx builds (at present, this latter repository does not +contain a mod_perl-1 package). Another way, which will be useful if you +plan on installing additional Apache modules, is to set the repository +within the Cppm shell utility to + + http://theoryx5.uwinnipeg.ca/cgi-bin/ppmserver?urn:/PPMServer + +for ActivePerl 6xx builds, and to + + http://theoryx5.uwinnipeg.ca/cgi-bin/ppmserver?urn:/PPMServer58 + +for ActivePerl 8xx builds. The repository may be set using + + ppm set repository NAME LOCATION + +for Cppm2 and by -or, for Cppm3, + ppm rep add NAME LOCATION - PPM rep add theoryx5 - http://theoryx5.uwinnipeg.ca/cgi-bin/ppmserver?urn:/PPMServer +for Cppm3 - see the help utility within the Cppm shell for +details. mod_perl 2.0 can then be installed as -mod_perl 2.0 can then be installed as + ppm install mod_perl-2 - PPM install mod_perl-2 +for builds 6xx and as + + ppm install mod_perl + +for builds 8xx. This will install the necessary modules under an FApache2 subdirectory in your Perl tree, so as not to disturb an existing @@ -169,11 +185,19 @@ The mod_perl PPM package also includes the necessary Apache DLL Fmod_perl.so; a post-installation script should be run which will offer to copy this file to your Apache2 modules directory (eg, -FC:/Apache2/modules/). If this is not done, you can get the file +FC:/Apache2/modules/). If this is not done, get either Fmod_perl-2.tar.gz from -http://theoryx5.uwinnipeg.ca/ppmpackages/x86/ which, when unpacked, +http://theoryx5.uwinnipeg.ca/ppmpackages/x86/, for builds 6xx, or +Fmod_perl.tar.gz from +http://theoryx5.uwinnipeg.ca/ppms/x86/, for builds 8xx; +when unpacked, this file contains
cvs commit: modperl-docs/src/docs/2.0/os/win32 install.pod
randyk 2002/11/28 09:05:19 Modified:src/docs/1.0/os/win32 install.pod src/docs/2.0/os/win32 install.pod Log: added discussion of ActivePerl 8xx ppm respository for mod_perl-2 Revision ChangesPath 1.13 +7 -2 modperl-docs/src/docs/1.0/os/win32/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/install.pod,v retrieving revision 1.12 retrieving revision 1.13 diff -u -r1.12 -r1.13 --- install.pod 18 Nov 2002 17:35:42 - 1.12 +++ install.pod 28 Nov 2002 17:05:19 - 1.13 @@ -297,8 +297,13 @@ not be able to use an earlier Apache binary. However, in the Apache Win32 world it is particularly a good idea to use the latest version, for bug and security fixes. If you encounter problems in loading -Fmod_perl.so, ensure that the version of the mod_perl binary -matches that of Apache; if all else fails, a reboot may help. +Fmod_perl.so, ensure that the mod_perl version you are using matches +that of Apache, make certain CPerl is in your CPATH environment +variable, or try adding the Apache directive + + LoadFile C:/Path/to/your/Perl/bin/perlxx.dll + +before loading Fmod_perl.so. If all else fails, a reboot may help. =head1 See Also 1.10 +44 -3 modperl-docs/src/docs/2.0/os/win32/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/install.pod,v retrieving revision 1.9 retrieving revision 1.10 diff -u -r1.9 -r1.10 --- install.pod 18 Nov 2002 17:31:03 - 1.9 +++ install.pod 28 Nov 2002 17:05:19 - 1.10 @@ -47,7 +47,8 @@ it is expected sometime in the future that perl-5.8 will be the recommended Perl for Win32 mod_perl-2. ActiveState currently has a beta perl-5.8 Win32 binary ready for testing; see the section -on Apache/mod_perl binaries below to obtain another perl-5.8 +on Apache/mod_perl binaries below for details on a suitable +repository containing mod_perl, and also how to obtain another perl-5.8 Win32 binary package. When installing Perl or other related binaries, subtleties may arise @@ -166,7 +167,7 @@ searching for modules. The mod_perl PPM package also includes the necessary Apache DLL -Cmod_perl.so; a post-installation script should be run which will +Fmod_perl.so; a post-installation script should be run which will offer to copy this file to your Apache2 modules directory (eg, FC:/Apache2/modules/). If this is not done, you can get the file Fmod_perl-2.tar.gz from @@ -180,7 +181,47 @@ Win32 world it is particularly a good idea to use the latest version, for bug and security fixes. If you encounter problems loading Fmod_perl.so, ensure that the mod_perl version you are using matches -that of Apache; if all else fails, a reboot may help. +that of Apache, make certain CPerl is in your CPATH environment +variable, or try adding the Apache directive + + LoadFile C:/Path/to/your/Perl/bin/perlxx.dll + +before loading Fmod_perl.so. If all else fails, a reboot may help. + +For users of ActivePerl beta 8xx, based on perl-5.8, a +similar repository is available. At present this contains +mod_perl-2, which can be installed as + + C:\ ppm install + http://theoryx5.uwinnipeg.ca/ppms/mod_perl.ppd + +You can also set the repository within the Cppm shell +utility as (broken over 2 lines for readability) + + PPM rep add theoryx5 + http://theoryx5.uwinnipeg.ca/cgi-bin/ppmserver?urn:/PPMServer58 + +or, for Cppm2, + + PPM set repository theoryx5 + http://theoryx5.uwinnipeg.ca/cgi-bin/ppmserver?urn:/PPMServer58 + +mod_perl 2.0 can then be installed as + + PPM install mod_perl + +This procedure should run a post-install script to copy +Fmod_perl.so to your Apache2 modules directory (eg, +FC:/Apache2/modules/). If this is not done, you can get the file +Fmod_perl.tar.gz from +http://theoryx5.uwinnipeg.ca/ppmps/x86/ which, when unpacked, +contains Fmod_perl.so in the top-level directory. + +Currently this repository does not contain a mod_perl-1 package. +Note that, because of binary incompatibilities, one should +Inot install packages for ActivePerl 8xx from a repository +containing packages for ActivePerl 6xx, and vice-versa, particularly +if these packages contain XS-based modules. =item Apache/mod_perl binary - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/os/win32 install.pod
randyk 2002/11/28 09:08:21 Modified:src/docs/2.0/os/win32 install.pod Log: typo Revision ChangesPath 1.11 +1 -1 modperl-docs/src/docs/2.0/os/win32/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/install.pod,v retrieving revision 1.10 retrieving revision 1.11 diff -u -r1.10 -r1.11 --- install.pod 28 Nov 2002 17:05:19 - 1.10 +++ install.pod 28 Nov 2002 17:08:21 - 1.11 @@ -214,7 +214,7 @@ Fmod_perl.so to your Apache2 modules directory (eg, FC:/Apache2/modules/). If this is not done, you can get the file Fmod_perl.tar.gz from -http://theoryx5.uwinnipeg.ca/ppmps/x86/ which, when unpacked, +http://theoryx5.uwinnipeg.ca/ppms/x86/ which, when unpacked, contains Fmod_perl.so in the top-level directory. Currently this repository does not contain a mod_perl-1 package. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/os/win32 install.pod
randyk 2002/11/18 09:31:03 Modified:src/docs/1.0/os/win32 install.pod src/docs/2.0/os/win32 install.pod Log: added descriptions on setting PATH and getting a DOS prompt. Revision ChangesPath 1.11 +24 -2 modperl-docs/src/docs/1.0/os/win32/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/install.pod,v retrieving revision 1.10 retrieving revision 1.11 diff -u -r1.10 -r1.11 --- install.pod 3 Nov 2002 20:52:02 - 1.10 +++ install.pod 18 Nov 2002 17:31:03 - 1.11 @@ -6,19 +6,41 @@ This document discusses how to install mod_perl 1.0 under Win32, both in building from sources and in installing pre-compiled binary -packages. At present, an ActivePerl-compatible Perl, compiled -with Visual C++, is the most common one used in the Win32 +packages. Unless you are using an all-in-one package, you should +first install Perl and Apache, either from the sources or as binaries. +The Perl sources are available from + +http://www.cpan.org/src/ + +with directions for building contained in FREADME.win32. +ActiveState also makes the sources available for their binary +builds at + +ftp://ftp.activestate.com/ActivePerl/src/ + +which may contain, in particular, Win32-specific fixes not in the +CPAN Perl sources. As a binary, at present, an ActivePerl-compatible +Perl, compiled with Visual C++, is the most common one used in the Win32 mod_perl/Apache environment; you can obtain such a prebuilt Perl binary from http://www.activestate.com/ +The Apache sources and binaries are available at + + http://httpd.apache.org/ + When installing Perl or other related binaries, subtelties may arise in using path names that have spaces in them - you may, for example, have to specify FC:\Program Files\ by the DOS 8.3 path name FC:\Progra~1\ in certain Apache directives. If you want to avoid this, install, if possible, these packages to locations without spaces in their names (eg, FC:\Perl for Perl and FC:\Apache for Apache). + +In the following, it may be necessary to invoke certain commands +through a DOS prompt. A DOS window may be opened either through +a ICommand Prompt option of the IStart menu, or by choosing +to run, from the Start menu, Ccommand or Ccmd, as appropriate. =head1 Building from sources 1.9 +33 -14modperl-docs/src/docs/2.0/os/win32/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/install.pod,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- install.pod 3 Nov 2002 20:50:12 - 1.8 +++ install.pod 18 Nov 2002 17:31:03 - 1.9 @@ -16,32 +16,51 @@ =head1 Installing -As of this writing, mod_perl-2 is known to compile and work -with an ActivePerl-compatable Perl (builds 6xx), based on -perl-5.6.1, available from +Unless you are using an all-in-one package, you should +first install Perl and Apache, either from the sources or as binaries. +The Perl sources are available from + +http://www.cpan.org/src/ + +with directions for building contained in FREADME.win32. +ActiveState also makes the sources available for their binary +builds at + +ftp://ftp.activestate.com/ActivePerl/src/ + +which may contain, in particular, Win32-specific fixes not in the +CPAN Perl sources. As a binary, at present, an ActivePerl-compatible +Perl, compiled with Visual C++, is the most common one used in the Win32 +mod_perl/Apache environment; you can obtain such a prebuilt Perl +binary from http://www.activestate.com/ -It also works with perl-5.8 compiled with the default compile-time +The Apache sources and binaries are available at + + http://httpd.apache.org/ + +As of this writing, mod_perl-2 is known to compile and work +with an ActivePerl-compatable Perl (builds 6xx), based on +perl-5.6.1. It also works with perl-5.8 compiled with the default compile-time flags in the Win32 FMakefile. Because of improved threading support, it is expected sometime in the future that perl-5.8 will be the -recommended Perl for Win32 mod_perl-2. ActiveState expects to have -a beta perl-5.8 Win32 binary ready in late 2002; see the section +recommended Perl for Win32 mod_perl-2. ActiveState currently has +a beta perl-5.8 Win32 binary ready for testing; see the section on Apache/mod_perl binaries below to obtain another perl-5.8 Win32 binary package. -Apache 2.0 and mod_perl 2.0 can be obtained in two ways - either as -binaries, or through building from the sources. As with most packages -of a more complex nature, it is best
cvs commit: modperl-docs/src/docs/1.0/os/win32 install.pod
randyk 2002/11/03 12:52:02 Modified:src/docs/1.0/os/win32 install.pod Log: added notes about obtaining ActivePerl, and also about using path names with spaces in them (suggested by Jesse Heines [EMAIL PROTECTED]). Revision ChangesPath 1.10 +13 -1 modperl-docs/src/docs/1.0/os/win32/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/install.pod,v retrieving revision 1.9 retrieving revision 1.10 diff -u -r1.9 -r1.10 --- install.pod 4 Oct 2002 22:37:05 - 1.9 +++ install.pod 3 Nov 2002 20:52:02 - 1.10 @@ -6,7 +6,19 @@ This document discusses how to install mod_perl 1.0 under Win32, both in building from sources and in installing pre-compiled binary -packages. +packages. At present, an ActivePerl-compatible Perl, compiled +with Visual C++, is the most common one used in the Win32 +mod_perl/Apache environment; you can obtain such a prebuilt Perl +binary from + +http://www.activestate.com/ + +When installing Perl or other related binaries, subtelties may arise +in using path names that have spaces in them - you may, for example, +have to specify FC:\Program Files\ by the DOS 8.3 path name +FC:\Progra~1\ in certain Apache directives. If you want to avoid +this, install, if possible, these packages to locations without spaces +in their names (eg, FC:\Perl for Perl and FC:\Apache for Apache). =head1 Building from sources - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/os/win32 install.pod
randyk 2002/11/03 12:50:12 Modified:src/docs/2.0/os/win32 install.pod Log: added notes about using path names with spaces in them (suggested by Jesse Heines [EMAIL PROTECTED]). Revision ChangesPath 1.8 +18 -4 modperl-docs/src/docs/2.0/os/win32/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/install.pod,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- install.pod 4 Oct 2002 22:39:22 - 1.7 +++ install.pod 3 Nov 2002 20:50:12 - 1.8 @@ -18,16 +18,30 @@ As of this writing, mod_perl-2 is known to compile and work with an ActivePerl-compatable Perl (builds 6xx), based on -perl-5.6.1. It also works with perl-5.8 compiled with the -default compile-time flags in the Win32 FMakefile. Because of -improved threading support, it is expected sometime in the future -that perl-5.8 will be the recommended Perl for Win32 mod_perl-2. +perl-5.6.1, available from + +http://www.activestate.com/ + +It also works with perl-5.8 compiled with the default compile-time +flags in the Win32 FMakefile. Because of improved threading support, +it is expected sometime in the future that perl-5.8 will be the +recommended Perl for Win32 mod_perl-2. ActiveState expects to have +a beta perl-5.8 Win32 binary ready in late 2002; see the section +on Apache/mod_perl binaries below to obtain another perl-5.8 +Win32 binary package. Apache 2.0 and mod_perl 2.0 can be obtained in two ways - either as binaries, or through building from the sources. As with most packages of a more complex nature, it is best, when possible, to build things from the sources. However, this requires some experience with using Visual C++. + +When installing Perl or other related binaries, subtelties may arise +in using path names that have spaces in them - you may, for example, +have to specify FC:\Program Files\ by the DOS 8.3 path name +FC:\Progra~1\ in certain Apache directives. If you want to avoid +this, install, if possible, these packages to locations without spaces +in their names (eg, FC:\Perl for Perl and FC:\Apache2 for Apache2). =head2 Building from sources - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/os/win32 install.pod
randyk 2002/09/26 12:52:05 Modified:src/docs/1.0/os/win32 install.pod Log: added directions on setting the repository with ppm3 (suggested by Larry Leszczynski [EMAIL PROTECTED]) Revision ChangesPath 1.7 +15 -5 modperl-docs/src/docs/1.0/os/win32/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/install.pod,v retrieving revision 1.6 retrieving revision 1.7 diff -u -r1.6 -r1.7 --- install.pod 8 Jul 2002 05:59:09 - 1.6 +++ install.pod 26 Sep 2002 19:52:05 - 1.7 @@ -220,20 +220,30 @@ http://theoryx5.uwinnipeg.ca/ppmpackages/mod_perl.ppd Another way, which will be useful if you plan on installing additional -Apache modules, is to set the repository within the Cppm shell -utility as (the Cset repository ... command has been broken over two +Apache modules, is to add the repository where the mod_perl package +is kept to the Cppm shell utility. For Cppm2 this may be +done as (the Cset repository ... command has been broken over two lines for readability): C:\ ppm PPM set repository theoryx5 http://theoryx5.uwinnipeg.ca/cgi-bin/ppmserver?urn:/PPMServer + +while for Cppm3 the appropriate command is (again broken over +two lines for readability): + + C:\ ppm + PPM repository add theoryx5 + http://theoryx5.uwinnipeg.ca/cgi-bin/ppmserver?urn:/PPMServer + +After this, you can do + PPM install mod_perl - PPM set save PPM quit C:\ -The Cset save command saves the Ctheoryx5 repository to your PPM -configuration file, so that future PPM sessions will search this +For Cppm2, use the Cset save command to save the Ctheoryx5 repository +to your PPM configuration file, so that future PPM sessions will search this repository, as well as ActiveState's, for requested packages. If you are running mod_ssl under Apache, then you should obtain the Cmod_perl-eapi.ppd package instead. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/os/win32 install.pod
randyk 2002/09/26 13:12:20 Modified:src/docs/1.0/os/win32 install.pod Log: invoke ppm3 as C:\ppm3 Revision ChangesPath 1.8 +1 -1 modperl-docs/src/docs/1.0/os/win32/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/install.pod,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- install.pod 26 Sep 2002 19:52:05 - 1.7 +++ install.pod 26 Sep 2002 20:12:20 - 1.8 @@ -232,7 +232,7 @@ while for Cppm3 the appropriate command is (again broken over two lines for readability): - C:\ ppm + C:\ ppm3 PPM repository add theoryx5 http://theoryx5.uwinnipeg.ca/cgi-bin/ppmserver?urn:/PPMServer - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/os/win32 install.pod
randyk 2002/07/07 22:59:09 Modified:src/docs/1.0/os/win32 install.pod Log: added note about mod_perl-eapi ppm package and extracting mod_perl.so. Revision ChangesPath 1.6 +8 -2 modperl-docs/src/docs/1.0/os/win32/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/install.pod,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- install.pod 1 Jul 2002 04:48:22 - 1.5 +++ install.pod 8 Jul 2002 05:59:09 - 1.6 @@ -211,7 +211,7 @@ not have spaces in their names (eg, FC:\Perl and FC:\Apache). After installing Perl and Apache, you can then install mod_perl via -the PPM utility. ActiveState does not maintain mod_perl in the ppm +the PPM utility. ActiveState does not maintain mod_perl in their ppm repository, so you must get it from a different location other than ActiveState's site. One way is simply as (broken over two lines for readability) @@ -235,11 +235,17 @@ The Cset save command saves the Ctheoryx5 repository to your PPM configuration file, so that future PPM sessions will search this repository, as well as ActiveState's, for requested packages. +If you are running mod_ssl under Apache, then you should +obtain the Cmod_perl-eapi.ppd package instead. The mod_perl PPM package also includes the necessary Apache DLL Cmod_perl.so; a post-installation script should be run which will offer to copy this file to your Apache modules directory (eg, -IC:\Apache\modules). +IC:\Apache\modules). This might not occur with Cppm3, in +which case you can grab Fmod_perl.tar.gz from +http://theoryx5.uwinnipeg.ca/ppmpackages/x86/; when +unpacked, this will contain Fmod_perl.so in the top-level +directory. Note that the mod_perl package available from this site will always use the latest mod_perl sources compiled against the latest official - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/os/win32 install.pod
randyk 2002/06/30 21:48:22 Modified:src/docs/1.0/os/win32 install.pod Log: added note about defining EAPI Revision ChangesPath 1.5 +6 -1 modperl-docs/src/docs/1.0/os/win32/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/install.pod,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- install.pod 10 Jun 2002 17:40:48 - 1.4 +++ install.pod 1 Jul 2002 04:48:22 - 1.5 @@ -89,7 +89,12 @@ the size of the DLL), by setting: Project - Settings - [C/C++] - Category: [Code Generation] - - Use runtime library: [Multithreaded DLL] + Use runtime library: [Multithreaded DLL] + +As well, if you are using a mod_ssl enabled Apache, you +should add IEAPI to the list of preprocessor definitions under + + Project - Settings - [C/C++] =item Testing - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/os/win32 install.pod
randyk 2002/06/30 22:01:43 Modified:src/docs/2.0/os/win32 install.pod Log: added note about availability of perl-5.8 binary. Revision ChangesPath 1.5 +9 -0 modperl-docs/src/docs/2.0/os/win32/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/install.pod,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- install.pod 10 Jun 2002 17:40:49 - 1.4 +++ install.pod 1 Jul 2002 05:01:43 - 1.5 @@ -150,6 +150,15 @@ releases. Also for this reason, these may not be binary compatible with other versions of Apache 2.0/mod_perl 2.0. +As well, at ftp://theoryx5.uwinnipeg.ca/pub/other/ there is an +archive Fperl-5.8-win32-bin.tar.gz containing a binary version +of a release candidate of perl-5.8, together with Apache 2.0 +and mod_perl 2.0. Installation instructions are contained in +the file Fperl-5.8-win32-bin.readme. Although at this time +perl-5.8 is not yet stable, you may be interested in previewing +it, as once it is stable, this will be the recommended Perl version +for use with Win32 mod_perl 2.0. + =back =head1 See Also - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/os - New directory
randyk 02/05/29 22:42:53 modperl-docs/src/docs/1.0/os - New directory - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/os - New directory
randyk 02/05/29 22:41:46 modperl-docs/src/docs/2.0/os - New directory - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/os/win32 - New directory
randyk 02/05/29 22:42:09 modperl-docs/src/docs/2.0/os/win32 - New directory - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/win32 .cvsignore Changes.pod binaries.pod compile.pod config.cfg multithread.pod
randyk 02/05/30 12:42:41 Removed: src/docs/1.0/win32 .cvsignore Changes.pod binaries.pod compile.pod config.cfg multithread.pod Log: removing win32/ directory, in place of os/win32/ - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]