Rebuild documentation
[privoxy.git] / doc / webserver / faq / trouble.html
index 569c6b0..28949ef 100644 (file)
@@ -382,44 +382,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&si=Ua
     </div>
 
     <div class="SECT2">
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="BLANKPAGE" id="BLANKPAGE">5.11. I get a
-      completely blank page at one site. <span class="QUOTE">"View
-      Source"</span> shows only: <span class=
-      "MARKUP">&lt;html&gt;&lt;body&gt;&lt;/body&gt;&lt;/html&gt;</span>.
-      Without Privoxy the page loads fine.</a></h3>
-
-      <p>Chances are that the site suffers from a bug in <a href=
-      "http://www.php.net/" target="_top"><span class=
-      "APPLICATION">PHP</span></a>, which results in empty pages being sent
-      if the client explicitly requests an uncompressed page, like
-      <span class="APPLICATION">Privoxy</span> does. This bug has been fixed
-      in PHP 4.2.3.</p>
-
-      <p>To find out if this is in fact the source of the problem, try adding
-      the site to a <tt class="LITERAL">-prevent-compression</tt> section in
-      <tt class="FILENAME">user.action</tt>:</p>
-
-      <table border="0" bgcolor="#E0E0E0" width="100%">
-        <tr>
-          <td>
-            <pre class="SCREEN">
-   # Make exceptions for ill-behaved sites:
-   #
-   {-prevent-compression}
-    .example.com
-</pre>
-          </td>
-        </tr>
-      </table>
-
-      <p>If that works, you may also want to report the problem to the site's
-      webmasters, telling them to use zlib.output_compression instead of
-      ob_gzhandler in their PHP applications (workaround) or upgrade to PHP
-      4.2.3 or later (fix).</p>
-    </div>
-
-    <div class="SECT2">
-      <h3 class="SECT2"><a name="NOHOSTNAME" id="NOHOSTNAME">5.12. My logs
+      <h3 class="SECT2"><a name="NOHOSTNAME" id="NOHOSTNAME">5.11. My logs
       show many <span class="QUOTE">"Unable to get my own hostname"</span>
       lines. Why?</a></h3>
 
       show many <span class="QUOTE">"Unable to get my own hostname"</span>
       lines. Why?</a></h3>
 
@@ -448,7 +411,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
     </div>
 
     <div class="SECT2">
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="INUSE" id="INUSE">5.13. When I try to launch
+      <h3 class="SECT2"><a name="INUSE" id="INUSE">5.12. When I try to launch
       Privoxy, I get an error message <span class="QUOTE">"port 8118 is
       already in use"</span> (or similar wording). Why?</a></h3>
 
       Privoxy, I get an error message <span class="QUOTE">"port 8118 is
       already in use"</span> (or similar wording). Why?</a></h3>
 
@@ -464,7 +427,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
     </div>
 
     <div class="SECT2">
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="DEMORONIZER" id="DEMORONIZER">5.14. Pages
+      <h3 class="SECT2"><a name="DEMORONIZER" id="DEMORONIZER">5.13. Pages
       with UTF-8 fonts are garbled.</a></h3>
 
       <p>This may be the result of an overly aggressive filter. The filters
       with UTF-8 fonts are garbled.</a></h3>
 
       <p>This may be the result of an overly aggressive filter. The filters
@@ -489,7 +452,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
     </div>
 
     <div class="SECT2">
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="DEMORONIZER2" id="DEMORONIZER2">5.15. Why
+      <h3 class="SECT2"><a name="DEMORONIZER2" id="DEMORONIZER2">5.14. Why
       are binary files (such as images) corrupted when Privoxy is
       used?</a></h3>
 
       are binary files (such as images) corrupted when Privoxy is
       used?</a></h3>
 
@@ -502,7 +465,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
     </div>
 
     <div class="SECT2">
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="DEMORONIZER3" id="DEMORONIZER3">5.16. What
+      <h3 class="SECT2"><a name="DEMORONIZER3" id="DEMORONIZER3">5.15. What
       is the <span class="QUOTE">"demoronizer"</span> and why is it
       there?</a></h3>
 
       is the <span class="QUOTE">"demoronizer"</span> and why is it
       there?</a></h3>
 
@@ -530,7 +493,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
     </div>
 
     <div class="SECT2">
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="WINDOWOPEN" id="WINDOWOPEN">5.17. Why do I
+      <h3 class="SECT2"><a name="WINDOWOPEN" id="WINDOWOPEN">5.16. Why do I
       keep seeing <span class="QUOTE">"PrivoxyWindowOpen()"</span> in raw
       source code?</a></h3>
 
       keep seeing <span class="QUOTE">"PrivoxyWindowOpen()"</span> in raw
       source code?</a></h3>
 
@@ -551,7 +514,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
     </div>
 
     <div class="SECT2">
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="DNSERRORS" id="DNSERRORS">5.18. I am getting
+      <h3 class="SECT2"><a name="DNSERRORS" id="DNSERRORS">5.17. I am getting
       too many DNS errors like <span class="QUOTE">"404 No Such
       Domain"</span>. Why can't Privoxy do this better?</a></h3>
 
       too many DNS errors like <span class="QUOTE">"404 No Such
       Domain"</span>. Why can't Privoxy do this better?</a></h3>
 
@@ -579,7 +542,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
     </div>
 
     <div class="SECT2">
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="ALLCPU" id="ALLCPU">5.19. At one site
+      <h3 class="SECT2"><a name="ALLCPU" id="ALLCPU">5.18. At one site
       Privoxy just hangs, and starts taking all CPU. Why is this?</a></h3>
 
       <p>This is probably a manifestation of the <span class="QUOTE">"100%
       Privoxy just hangs, and starts taking all CPU. Why is this?</a></h3>
 
       <p>This is probably a manifestation of the <span class="QUOTE">"100%
@@ -598,7 +561,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
     </div>
 
     <div class="SECT2">
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="SLOWCRAWL" id="SLOWCRAWL">5.20. I just
+      <h3 class="SECT2"><a name="SLOWCRAWL" id="SLOWCRAWL">5.19. I just
       installed Privoxy, and all my browsing has slowed to a crawl. What
       gives?</a></h3>
 
       installed Privoxy, and all my browsing has slowed to a crawl. What
       gives?</a></h3>
 
@@ -612,7 +575,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
     </div>
 
     <div class="SECT2">
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="PREVENTCOMP" id="PREVENTCOMP">5.21. Why do
+      <h3 class="SECT2"><a name="PREVENTCOMP" id="PREVENTCOMP">5.20. Why do
       my filters work on some sites but not on others?</a></h3>
 
       <p>It's probably due to compression. It is a common practice for web
       my filters work on some sites but not on others?</a></h3>
 
       <p>It's probably due to compression. It is a common practice for web
@@ -629,7 +592,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
     </div>
 
     <div class="SECT2">
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="SSL-WARNINGS" id="SSL-WARNINGS">5.22. On
+      <h3 class="SECT2"><a name="SSL-WARNINGS" id="SSL-WARNINGS">5.21. On
       some HTTPS sites my browser warns me about unauthenticated content, the
       URL bar doesn't get highlighted and the lock symbol appears to be
       broken. What's going on?</a></h3>
       some HTTPS sites my browser warns me about unauthenticated content, the
       URL bar doesn't get highlighted and the lock symbol appears to be
       broken. What's going on?</a></h3>
@@ -675,7 +638,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
     </div>
 
     <div class="SECT2">
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="SE-LINUX" id="SE-LINUX">5.23. I get selinux
+      <h3 class="SECT2"><a name="SE-LINUX" id="SE-LINUX">5.22. I get selinux
       error messages. How can I fix this?</a></h3>
 
       <p>Please report the problem to the creator of your selinux
       error messages. How can I fix this?</a></h3>
 
       <p>Please report the problem to the creator of your selinux
@@ -700,7 +663,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
     </div>
 
     <div class="SECT2">
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="GENTOO-RICERS" id="GENTOO-RICERS">5.24. I
+      <h3 class="SECT2"><a name="GENTOO-RICERS" id="GENTOO-RICERS">5.23. I
       compiled <span class="APPLICATION">Privoxy</span> with Gentoo's portage
       and it appears to be very slow. Why?</a></h3>
 
       compiled <span class="APPLICATION">Privoxy</span> with Gentoo's portage
       and it appears to be very slow. Why?</a></h3>
 
@@ -723,7 +686,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
     </div>
 
     <div class="SECT2">
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="TAINTED-SOCKETS" id="TAINTED-SOCKETS">5.25.
+      <h3 class="SECT2"><a name="TAINTED-SOCKETS" id="TAINTED-SOCKETS">5.24.
       What are tainted sockets and how do I prevent them?</a></h3>
 
       <p><span class="APPLICATION">Privoxy</span> marks sockets as tainted
       What are tainted sockets and how do I prevent them?</a></h3>
 
       <p><span class="APPLICATION">Privoxy</span> marks sockets as tainted
@@ -756,6 +719,28 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
       problem that may be worth fixing, the problem will be explicitly logged
       as error.</p>
     </div>
       problem that may be worth fixing, the problem will be explicitly logged
       as error.</p>
     </div>
+
+    <div class="SECT2">
+      <h3 class="SECT2"><a name="PCRE-STACK-LIMIT" id=
+      "PCRE-STACK-LIMIT">5.25. After adding my custom filters, <span class=
+      "APPLICATION">Privoxy</span> crashes when visitting certain
+      websites</a></h3>
+
+      <p>This can happen if your custom filters require more memory than
+      <span class="APPLICATION">Privoxy</span> is allowed to use. Usually the
+      problem is that the operating system enforces a stack size limit that
+      isn't sufficient.</p>
+
+      <p>Unless the problem occurs with the filters available in the default
+      configuration, this is not considered a Privoxy bug.</p>
+
+      <p>To prevent the crashes you can rewrite your filter to use less
+      ressources, increase the relevant memory limit or recompile pcre to use
+      less stack space. For details please see the <a href=
+      "http://pcre.org/original/doc/html/pcrestack.html" target=
+      "_top">pcrestack man page</a> and the documentation of your operating
+      system.</p>
+    </div>
   </div>
 
   <div class="NAVFOOTER">
   </div>
 
   <div class="NAVFOOTER">