You are viewing a plain text version of this content. The canonical link for it is here.
Posted to modperl-cvs@perl.apache.org by fd...@hyperreal.org on 1998/05/30 22:28:03 UTC
cvs commit: modperl-site/faq mod_perl_api.html mod_perl_cgi.html mod_perl_faq.html mod_perl_faq.tar.gz
fdc 98/05/30 13:28:03
Modified: faq mod_perl_api.html mod_perl_cgi.html
mod_perl_faq.html mod_perl_faq.tar.gz
Log:
FAQ updated to reflect new mailing list location.
New mailing list archives added.
Description of exit() and Apache::exit() brought up to date.
Mention Apache::PerlRun in the CGI pod.
Revision Changes Path
1.2 +3 -3 modperl-site/faq/mod_perl_api.html
Index: mod_perl_api.html
===================================================================
RCS file: /export/home/cvs/modperl-site/faq/mod_perl_api.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- mod_perl_api.html 1998/03/23 04:04:38 1.1
+++ mod_perl_api.html 1998/05/30 20:28:00 1.2
@@ -1,6 +1,6 @@
<HTML>
<HEAD>
- <TITLE>Mod_perl_api - accessing the Apache API via mod_perl ($Date: 1998/03/23 04:04:38 $)
+ <TITLE>Mod_perl_api - accessing the Apache API via mod_perl ($Date: 1998/05/30 20:28:00 $)
</TITLE>
</HEAD>
@@ -30,8 +30,8 @@
<H1><A NAME="NAME">NAME
</A></H1>
-Mod_perl_api - accessing the Apache API via mod_perl ($Date: 1998/02/10
-08:58:18 $)
+Mod_perl_api - accessing the Apache API via mod_perl ($Date: 1998/01/19
+12:35:51 $)
<P>
1.2 +26 -6 modperl-site/faq/mod_perl_cgi.html
Index: mod_perl_cgi.html
===================================================================
RCS file: /export/home/cvs/modperl-site/faq/mod_perl_cgi.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- mod_perl_cgi.html 1998/03/23 04:04:39 1.1
+++ mod_perl_cgi.html 1998/05/30 20:28:00 1.2
@@ -1,6 +1,6 @@
<HTML>
<HEAD>
- <TITLE>Mod_perl_cgi - running CGI scripts under mod_perl ($Date: 1998/03/23 04:04:39 $)
+ <TITLE>Mod_perl_cgi - running CGI scripts under mod_perl ($Date: 1998/05/30 20:28:00 $)
</TITLE>
</HEAD>
@@ -27,6 +27,7 @@
<LI><A HREF="#The_server_terminates_after_proc">The server terminates after processing the first request</A>
<LI><A HREF="#Variables_retain_their_value_fro">Variables retain their value from one request to the next</A>
<LI><A HREF="#Variables_B_still_retain_their_">Variables <STRONG>still</STRONG> retain their value from one request to the next</A>
+ <LI><A HREF="#Do_I_have_to_rewrite_my_legacy_c">Do I have to rewrite my legacy code for mod_perl?</A>
</UL>
<LI><A HREF="#How_can_my_script_continue_runni">How can my script continue running after sending the response?</A>
@@ -38,8 +39,8 @@
<H1><A NAME="NAME">NAME
</A></H1>
-Mod_perl_cgi - running CGI scripts under mod_perl ($Date: 1998/02/10
-08:58:18 $)
+Mod_perl_cgi - running CGI scripts under mod_perl ($Date: 1998/05/28
+21:42:40 $)
<P>
@@ -172,7 +173,7 @@
<H2><A NAME="The_server_terminates_after_proc">The server terminates after processing the first request
</A></H2>
-Your script is calling the perl <CODE>exit()</CODE> function. That is not a problem in a conventional CGI script, provided that
+Your script is calling the CORE perl <CODE>exit()</CODE> function. That is not a problem in a conventional CGI script, provided that
query processing is complete. But you almost certainly don't want to exit
in a mod_perl script. It kills the server process that handled the request,
meaning that the advantage of using mod_perl to avoid startup overhead is
@@ -192,12 +193,18 @@
<P>
-There may be exceptional circumstances in which an exit is required in a
-mod_perl script, in which case <CODE>Apache->exit()</CODE> should be used.
+See also what mod_perl_traps says about <CODE>Apache::exit()</CODE> and the way that Apache::Registry causes it to terminate the script but not
+the httpd child.
<P>
+There may be exceptional circumstances in which you explicitly want to
+terminate the httpd child at the end of the current request. In this case <CODE>Apache->exit(-2)</CODE> should be used.
+
+
+<P>
+
<P>
<HR>
<H2><A NAME="Variables_retain_their_value_fro">Variables retain their value from one request to the next
@@ -322,6 +329,19 @@
environment variable. This test can fail if <CODE>use CGI</CODE> is evaluated too early, before the environment has been set up. That can
happen if you have <CODE>use CGI</CODE> in a script and pull the script in with a <CODE>PerlRequire</CODE> directive in httpd.conf. Replacing <CODE>use CGI</CODE> with
<CODE>require CGI</CODE> will fix it.
+
+
+<P>
+
+<P>
+<HR>
+<H2><A NAME="Do_I_have_to_rewrite_my_legacy_c">Do I have to rewrite my legacy code for mod_perl?
+
+</A></H2>
+If you have CGI code that seems to be fundamentally at odds with mod_perl's
+``compile once, run many'' environment, you may be find that it will work
+if run under the module <CODE>Apache::PerlRun</CODE>. See the documentation of that module, which is included with recent
+versions of mod_perl.
<P>
1.2 +9 -5 modperl-site/faq/mod_perl_faq.html
Index: mod_perl_faq.html
===================================================================
RCS file: /export/home/cvs/modperl-site/faq/mod_perl_faq.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- mod_perl_faq.html 1998/03/23 04:04:39 1.1
+++ mod_perl_faq.html 1998/05/30 20:28:01 1.2
@@ -1,6 +1,6 @@
<HTML>
<HEAD>
- <TITLE>Mod_perl_faq - frequently asked questions about mod_perl ($Date: 1998/03/23 04:04:39 $)
+ <TITLE>Mod_perl_faq - frequently asked questions about mod_perl ($Date: 1998/05/30 20:28:01 $)
</TITLE>
</HEAD>
@@ -46,8 +46,8 @@
<H1><A NAME="NAME">NAME
</A></H1>
-Mod_perl_faq - frequently asked questions about mod_perl ($Date: 1998/02/10
-08:58:18 $)
+Mod_perl_faq - frequently asked questions about mod_perl ($Date: 1998/05/28
+21:41:19 $)
<P>
@@ -720,13 +720,17 @@
</A></H2>
There is a mailing-list dedicated to mod_perl. It is archived at <A
HREF="http://outside.organic.com/mail-archives/modperl/">http://outside.organic.com/mail-archives/modperl/</A>
+and at <A
+HREF="http://forum.swarthmore.edu/epigone/modperl">http://forum.swarthmore.edu/epigone/modperl</A>
+(which has a search engine) and also at <A
+HREF="http://www.progressive-comp.com/Lists/?l=apache-modperl&r=1#apache-modperl">http://www.progressive-comp.com/Lists/?l=apache-modperl&r=1#apache-modperl</A>
+(threaded and indexed).
-
<P>
You can subscribe to the list by sending a mail with the line <CODE>subscribe
-modperl</CODE> to <CODE>listserv@listproc.itribe.net</CODE>.
+modperl</CODE> to <CODE>majordomo@apache.org</CODE>.
<P>
1.2 +46 -44 modperl-site/faq/mod_perl_faq.tar.gz
Index: mod_perl_faq.tar.gz
===================================================================
RCS file: /export/home/cvs/modperl-site/faq/mod_perl_faq.tar.gz,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
Binary files /tmp/cvsT11073 and /tmp/cvsC11073 differ