Rebuild HTML docs for 3.0.24
[privoxy.git] / doc / webserver / faq / trouble.html
index b08bc2b..cab801a 100644 (file)
   "contact.html">
   <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
   <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
-  <style type="text/css">
-body {
-  background-color: #EEEEEE;
-  color: #000000;
-  }
-  :link { color: #0000FF }
-  :visited { color: #840084 }
-  :active { color: #0000FF }
-  span.c3 {font-style: italic}
-  table.c2 {background-color: #E0E0E0}
-  hr.c1 {text-align: left}
-  </style>
 </head>
 
-<body class="SECT1">
+<body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
+"#840084" alink="#0000FF">
   <div class="NAVHEADER">
     <table summary="Header navigation table" width="100%" border="0"
     cellpadding="0" cellspacing="0">
@@ -47,7 +36,7 @@ body {
         accesskey="N">Next</a></td>
       </tr>
     </table>
-    <hr class="c1" width="100%">
+    <hr align="left" width="100%">
   </div>
 
   <div class="SECT1">
@@ -55,7 +44,7 @@ body {
     Troubleshooting</a></h1>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="AEN1100" id="AEN1100">5.1. I cannot connect
+      <h3 class="SECT2"><a name="AEN1090" id="AEN1090">5.1. I cannot connect
       to any websites. Or, I am getting <span class="QUOTE">"connection
       refused"</span> message with every web page. Why?</a></h3>
 
@@ -105,7 +94,7 @@ body {
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="AEN1123" id="AEN1123">5.3. I just added a
+      <h3 class="SECT2"><a name="AEN1113" id="AEN1113">5.3. I just added a
       new rule, but the steenkin ad is still getting through. How?</a></h3>
 
       <p>If the ad had been displayed before you added its URL, it will
@@ -144,7 +133,7 @@ body {
       (meaning caught and BLOCKED) quite a few items in this example, but
       perhaps missed a few as well.</p>
 
-      <table class="c2" border="0" width="100%">
+      <table border="0" bgcolor="#E0E0E0" width="100%">
         <tr>
           <td>
             <pre class="SCREEN">
@@ -215,9 +204,9 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
       need to be enabled in the main config file). Many sites are complex and
       require a number of related pages to help present their content. Look
       at what else might be used by the page in question, and what of that
-      might be <span class="emphasis EMPHASIS c3">required</span>. Now, armed
-      with this information, go to <a href=
-      "http://config.privoxy.org/show-status" target=
+      might be <span class="emphasis"><i class=
+      "EMPHASIS">required</i></span>. Now, armed with this information, go to
+      <a href="http://config.privoxy.org/show-status" target=
       "_top">http://config.privoxy.org/show-status</a> and select the
       appropriate actions files for editing.</p>
 
@@ -255,7 +244,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
       <h3 class="SECT2"><a name="DUN" id="DUN">5.5. After installing Privoxy,
       I have to log in every time I start IE. What gives?</a></h3>
 
-      <p>This is a quirk that effects the installation of <span class=
+      <p>This is a quirk that affects the installation of <span class=
       "APPLICATION">Privoxy</span>, in conjunction with Internet Explorer and
       Internet Connection Sharing on Windows 2000 and Windows XP. The
       symptoms may appear to be corrupted or invalid DUN settings, or
@@ -299,8 +288,8 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
       <p><span class="APPLICATION">Privoxy</span> cannot act as a proxy for
       FTP traffic, so do not configure your browser to use <span class=
       "APPLICATION">Privoxy</span> as an FTP proxy. The same is true for
-      <span class="emphasis EMPHASIS c3">any protocol other than HTTP or
-      HTTPS (SSL)</span>.</p>
+      <span class="emphasis"><i class="EMPHASIS">any protocol other than HTTP
+      or HTTPS (SSL)</i></span>.</p>
 
       <p>Most browsers understand FTP as well as HTTP. If you connect to a
       site, with a URL like <tt class="LITERAL">ftp://ftp.example.com</tt>,
@@ -311,9 +300,9 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
 
       <p>To complicate matters, some systems may have a generic <span class=
       "QUOTE">"proxy"</span> setting, which will enable various protocols,
-      including <span class="emphasis EMPHASIS c3">both</span> HTTP and FTP
-      proxying! So it is possible to accidentally enable FTP proxying in
-      these cases. And of course, if this happens, <span class=
+      including <span class="emphasis"><i class="EMPHASIS">both</i></span>
+      HTTP and FTP proxying! So it is possible to accidentally enable FTP
+      proxying in these cases. And of course, if this happens, <span class=
       "APPLICATION">Privoxy</span> will indeed cause problems since it does
       not know FTP. Newer version will give a sane error message if a FTP
       connection is attempted. Just disable the FTP setting and all will be
@@ -372,7 +361,28 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="BLANKPAGE" id="BLANKPAGE">5.10. I get a
+      <h3 class="SECT2"><a name="MACOSXACCOUNTDELETION" id=
+      "MACOSXACCOUNTDELETION">5.10. I just upgraded to Mac OS X 10.9
+      (Mavericks) and now <span class="APPLICATION">Privoxy</span> has
+      stopped working.</a></h3>
+
+      <p>The upgrade process to Mac OS X Mavericks (10.9) from an earlier
+      version of OS X deletes all user accounts that are either not part of
+      OS X itself or are not interactive user accounts (ones you log in
+      with). Since, for the sake of security, <span class=
+      "APPLICATION">Privoxy</span> runs as a non-privileged user that is
+      created by its installer (_privoxy), it can no longer start up once
+      that account gets deleted. The solution is to perform a complete
+      uninstall using the supplied <span class=
+      "APPLICATION">uninstall.command</span> script (either back up your
+      configuration files or select to not have the uninstaller remove them
+      when it prompts you) and then reinstall <span class=
+      "APPLICATION">Privoxy</span> using the installer package and merge in
+      your configuration.</p>
+    </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>.
@@ -389,7 +399,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
       the site to a <tt class="LITERAL">-prevent-compression</tt> section in
       <tt class="FILENAME">user.action</tt>:</p>
 
-      <table class="c2" border="0" width="100%">
+      <table border="0" bgcolor="#E0E0E0" width="100%">
         <tr>
           <td>
             <pre class="SCREEN">
@@ -409,16 +419,17 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="NOHOSTNAME" id="NOHOSTNAME">5.11. My logs
+      <h3 class="SECT2"><a name="NOHOSTNAME" id="NOHOSTNAME">5.12. My logs
       show many <span class="QUOTE">"Unable to get my own hostname"</span>
       lines. Why?</a></h3>
 
       <p><span class="APPLICATION">Privoxy</span> tries to get the hostname
       of the system its running on from the IP address of the system
       interface it is bound to (from the <tt class="FILENAME">config</tt>
-      file <span class="emphasis EMPHASIS c3">listen-address</span> setting).
-      If the system cannot supply this information, <span class=
-      "APPLICATION">Privoxy</span> logs this condition.</p>
+      file <span class="emphasis"><i class=
+      "EMPHASIS">listen-address</i></span> setting). If the system cannot
+      supply this information, <span class="APPLICATION">Privoxy</span> logs
+      this condition.</p>
 
       <p>Typically, this would be considered a minor system configuration
       error. It is not a fatal error to <span class=
@@ -437,7 +448,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="INUSE" id="INUSE">5.12. When I try to launch
+      <h3 class="SECT2"><a name="INUSE" id="INUSE">5.13. 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>
 
@@ -453,36 +464,45 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="DEMORONIZER" id="DEMORONIZER">5.13. Pages
+      <h3 class="SECT2"><a name="DEMORONIZER" id="DEMORONIZER">5.14. Pages
       with UTF-8 fonts are garbled.</a></h3>
 
-      <p>This is caused by the <span class="QUOTE">"demoronizer"</span>
-      filter. You should either upgrade <span class=
-      "APPLICATION">Privoxy</span>, or at least upgrade to the most recent
-      <tt class="FILENAME">default.action</tt> file available from <a href=
+      <p>This may be the result of an overly aggressive filter. The filters
+      that are enabled in the default configuration aren't expected to cause
+      problems like this. If you enabled the <span class=
+      "QUOTE">"demoronizer"</span> filter, please try temporarily disabling
+      it.</p>
+
+      <p>If that doesn't help, temporarily disable all filters to see if
+      another filter could be the culprit. If the problem disappears, enable
+      the filters one by one, until the problem reappears and the offending
+      filter is found.</p>
+
+      <p>Once the problem-causing filter is known, it can be fixed or
+      disabled.</p>
+
+      <p>Upgrading <span class="APPLICATION">Privoxy</span>, or going to the
+      most recent <tt class="FILENAME">default.action</tt> file available
+      from <a href=
       "http://sourceforge.net/project/showfiles.php?group_id=11118" target=
-      "_top">SourceForge</a>. Or you can simply disable the demoronizer
-      filter.</p>
+      "_top">SourceForge</a> might be worth a try, too.</p>
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="DEMORONIZER2" id="DEMORONIZER2">5.14. Why
+      <h3 class="SECT2"><a name="DEMORONIZER2" id="DEMORONIZER2">5.15. Why
       are binary files (such as images) corrupted when Privoxy is
       used?</a></h3>
 
-      <p>This may also be caused by the <span class=
-      "QUOTE">"demoronizer"</span> filter, in conjunction with a web server
-      that is misreporting the content type. Binary files are exempted from
-      <span class="APPLICATION">Privoxy's</span> filtering (unless the web
-      server by mistake says the file is something else). Either upgrade
-      <span class="APPLICATION">Privoxy</span>, or go to the most recent
-      <tt class="FILENAME">default.action</tt> file available from <a href=
-      "http://sourceforge.net/project/showfiles.php?group_id=11118" target=
-      "_top">SourceForge</a>.</p>
+      <p>This may also be caused by an (<a href=
+      "trouble.html#DEMORONIZER">overly aggressive filter</a> in conjunction
+      with a web server that is misreporting the content type. By default
+      binary files are exempted from <span class=
+      "APPLICATION">Privoxy's</span> filtering (unless the web server by
+      mistake says the file is something else).</p>
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="DEMORONIZER3" id="DEMORONIZER3">5.15. What
+      <h3 class="SECT2"><a name="DEMORONIZER3" id="DEMORONIZER3">5.16. What
       is the <span class="QUOTE">"demoronizer"</span> and why is it
       there?</a></h3>
 
@@ -502,7 +522,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
       <p>If you are using Microsoft products, you do not need it. If you need
       to view pages with UTF-8 characters (such as Cyrillic or Chinese), then
       it will cause corruption of the fonts, and thus <span class=
-      "emphasis EMPHASIS c3">should not be on</span>.</p>
+      "emphasis"><i class="EMPHASIS">should not be on</i></span>.</p>
 
       <p>On the other hand, if you use non-Microsoft products, and you
       occasionally notice weird characters on pages, you might want to try
@@ -510,7 +530,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="WINDOWOPEN" id="WINDOWOPEN">5.16. Why do I
+      <h3 class="SECT2"><a name="WINDOWOPEN" id="WINDOWOPEN">5.17. Why do I
       keep seeing <span class="QUOTE">"PrivoxyWindowOpen()"</span> in raw
       source code?</a></h3>
 
@@ -531,7 +551,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="DNSERRORS" id="DNSERRORS">5.17. I am getting
+      <h3 class="SECT2"><a name="DNSERRORS" id="DNSERRORS">5.18. 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>
 
@@ -559,7 +579,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="ALLCPU" id="ALLCPU">5.18. At one site
+      <h3 class="SECT2"><a name="ALLCPU" id="ALLCPU">5.19. 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%
@@ -578,7 +598,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="SLOWCRAWL" id="SLOWCRAWL">5.19. I just
+      <h3 class="SECT2"><a name="SLOWCRAWL" id="SLOWCRAWL">5.20. I just
       installed Privoxy, and all my browsing has slowed to a crawl. What
       gives?</a></h3>
 
@@ -592,7 +612,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="PREVENTCOMP" id="PREVENTCOMP">5.20. Why do
+      <h3 class="SECT2"><a name="PREVENTCOMP" id="PREVENTCOMP">5.21. 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
@@ -609,7 +629,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="SSL-WARNINGS" id="SSL-WARNINGS">5.21. On
+      <h3 class="SECT2"><a name="SSL-WARNINGS" id="SSL-WARNINGS">5.22. 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>
@@ -630,7 +650,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
       by <span class="APPLICATION">Privoxy</span> and add the hosts (no path
       patterns) to a section like this:</p>
 
-      <table class="c2" border="0" width="100%">
+      <table border="0" bgcolor="#E0E0E0" width="100%">
         <tr>
           <td>
             <pre class="SCREEN">
@@ -655,7 +675,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="SE-LINUX" id="SE-LINUX">5.22. I get selinux
+      <h3 class="SECT2"><a name="SE-LINUX" id="SE-LINUX">5.23. I get selinux
       error messages. How can I fix this?</a></h3>
 
       <p>Please report the problem to the creator of your selinux
@@ -680,7 +700,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
     </div>
 
     <div class="SECT2">
-      <h3 class="SECT2"><a name="GENTOO-RICERS" id="GENTOO-RICERS">5.23. I
+      <h3 class="SECT2"><a name="GENTOO-RICERS" id="GENTOO-RICERS">5.24. I
       compiled <span class="APPLICATION">Privoxy</span> with Gentoo's portage
       and it appears to be very slow. Why?</a></h3>
 
@@ -704,7 +724,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
   </div>
 
   <div class="NAVFOOTER">
-    <hr class="c1" width="100%">
+    <hr align="left" width="100%">
 
     <table summary="Footer navigation table" width="100%" border="0"
     cellpadding="0" cellspacing="0">