dougm 01/03/04 20:27:29 Modified: . 00README_FIRST Log: update notes Revision Changes Path 1.12 +28 -20 modperl-2.0/00README_FIRST Index: 00README_FIRST =================================================================== RCS file: /home/cvs/modperl-2.0/00README_FIRST,v retrieving revision 1.11 retrieving revision 1.12 diff -u -r1.11 -r1.12 --- 00README_FIRST 2001/01/02 19:03:01 1.11 +++ 00README_FIRST 2001/03/05 04:27:29 1.12 @@ -1,12 +1,7 @@ a (nearly) complete rewrite is underway for mod_perl-2.0 -the module is not usable yet, at least not the way 1.xx is +more detailed design docs, etc., see the pod/ directory -what you see here is just a start on the new build/glue infrastructure - -more detailed design docs, etc. will follow along with updates here -and on the list - if you want to try building with an interpreter pool, you'll need Perl 5.6.0 built like so: @@ -16,22 +11,40 @@ only be useful if your mpm is prefork (which is much like 1.3.x) to build mod_perl static: +NOTE: static linking untested for several months % perl Makefile.PL && make % cd ../httpd-2.0 -% ./configure --prefix=$HOME/apache-2.0 --with-mpm=mpmt_pthread +% ./configure --prefix=$HOME/apache-2.0 --with-mpm=threaded % patch -p1 < ../../modperl-2.0/patches/link-hack.pat % make to build mod_perl dynamic: -% perl Makefile.PL MP_USE_DSO=1 && make - -% cd ../httpd-2.0 -% ./configure --with-mpm=mpmt_pthread ... +build httpd with mod_so enabled: +% cd httpd-2.0 +% ./configure --with-mpm=threaded --enable-so ... % make +% make install + +build the parsed structure and function tables: + +NOTE: requires C::Scan 0.75, which at the moment is unreleased, there +is a working copy here: http://perl.apache.org/~dougm/Scan.pm + +NOTE: source_scan.pl is a HEAVY process, do not be alarmed +should be run each time you update your httpd-2.0 tree +% perl util/source_scan.pl apxs $apache_prefix/bin/apxs + +generate xs code from the tables: + +% perl util/xs_generate.pl + +#build libmodperl.so and extension .so's +% perl Makefile.PL MP_USE_DSO=1 MP_APXS=$apache_prefix/bin/apxs && make + as for httpd.conf, mine looks something like so at the moment: #if dynamic build @@ -48,14 +61,9 @@ #directive passes arbitrary command line switches to perl PerlSwitches -T /home/dougm/test/startup.pl - -it is possible to configure Perl*Handlers, but there is not yet an -interface back into Apache, e.g. - -PerlLogHandler MyLog::handler -sub MyLog::handler { - warn "hey, it works!"; -} +it is possible to configure Perl*Handlers and callback into apache, +much is the same as 1.x, but plenty is different at the moment. +there will be a compat layer in the future. ---dougm 01/02 +--dougm 03/04/01
