Regenerate HTML docs with recent changes
[privoxy.git] / doc / webserver / faq / trouble.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
2 "http://www.w3.org/TR/html4/loose.dtd">
3 <html>
4 <head>
5   <title>Troubleshooting</title>
6   <meta name="GENERATOR" content=
7   "Modular DocBook HTML Stylesheet Version 1.79">
8   <link rel="HOME" title="Privoxy Frequently Asked Questions" href=
9   "index.html">
10   <link rel="PREVIOUS" title="Miscellaneous" href="misc.html">
11   <link rel="NEXT" title=
12   "Contacting the developers, Bug Reporting and Feature Requests" href=
13   "contact.html">
14   <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
15   <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
16 </head>
17 <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
18 "#840084" alink="#0000FF">
19   <div class="NAVHEADER">
20     <table summary="Header navigation table" width="100%" border="0"
21     cellpadding="0" cellspacing="0">
22       <tr>
23         <th colspan="3" align="center">Privoxy Frequently Asked
24         Questions</th>
25       </tr>
26       <tr>
27         <td width="10%" align="left" valign="bottom"><a href="misc.html"
28         accesskey="P">Prev</a></td>
29         <td width="80%" align="center" valign="bottom"></td>
30         <td width="10%" align="right" valign="bottom"><a href="contact.html"
31         accesskey="N">Next</a></td>
32       </tr>
33     </table>
34     <hr align="left" width="100%">
35   </div>
36   <div class="SECT1">
37     <h1 class="SECT1"><a name="TROUBLE" id="TROUBLE">5.
38     Troubleshooting</a></h1>
39     <div class="SECT2">
40       <h3 class="SECT2"><a name="REFUSED" id="REFUSED">5.1. I cannot connect
41       to any websites. Or, I am getting <span class="QUOTE">"connection
42       refused"</span> message with every web page. Why?</a></h3>
43       <p>There are several possibilities:</p>
44       <ul>
45         <li>
46           <p><span class="APPLICATION">Privoxy</span> is not running.
47           Solution: verify that <span class="APPLICATION">Privoxy</span> is
48           installed correctly, has not crashed, and is indeed running. Turn
49           on <span class="APPLICATION">Privoxy's</span> logging, and look at
50           the logs to see what they say.</p>
51         </li>
52         <li>
53           <p>Or your browser is configured for a different port than what
54           <span class="APPLICATION">Privoxy</span> is using. Solution: verify
55           that <span class="APPLICATION">Privoxy</span> and your browser are
56           set to the same port (<tt class="LITERAL">listen-address</tt>).</p>
57         </li>
58         <li>
59           <p>Or if using a forwarding rule, you have a configuration problem
60           or a problem with a host in the forwarding chain. Solution:
61           temporarily alter your configuration and take the forwarders out of
62           the equation.</p>
63         </li>
64         <li>
65           <p>Or you have a firewall that is interfering and blocking you.
66           Solution: try disabling or removing the firewall as a simple
67           test.</p>
68         </li>
69       </ul>
70     </div>
71     <div class="SECT2">
72       <h3 class="SECT2"><a name="ERROR503" id="ERROR503">5.2. Why am I
73       getting a 503 Error (WSAECONNREFUSED) on every page?</a></h3>
74       <p>More than likely this is a problem with your TCP/IP networking.
75       ZoneAlarm has been reported to cause this symptom -- even if not
76       running! The solution is to either fight the ZA configuration, or
77       uninstall ZoneAlarm, and then find something better behaved in its
78       place. Other personal firewall type products may cause similar type
79       problems if not configured correctly.</p>
80     </div>
81     <div class="SECT2">
82       <h3 class="SECT2"><a name="FLUSHIT" id="FLUSHIT">5.3. I just added a
83       new rule, but the steenkin ad is still getting through. How?</a></h3>
84       <p>If the ad had been displayed before you added its URL, it will
85       probably be held in the browser's cache for some time, so it will be
86       displayed without the need for any request to the server, and
87       <span class="APPLICATION">Privoxy</span> will not be involved. Flush
88       the browser's caches, and then try again.</p>
89       <p>If this doesn't help, you probably have an error in the rule you
90       applied. Try pasting the full URL of the offending ad into <a href=
91       "http://config.privoxy.org/show-url-info" target=
92       "_top">http://config.privoxy.org/show-url-info</a> and see if it really
93       matches your new rule. Blocking ads is like blocking spam: a lot of
94       tinkering is required to stay ahead of the game. And remember you need
95       to block the URL of the ad in question, which may be entirely different
96       from the site URL itself. Most ads are hosted on different servers than
97       the main site itself. If you right-click on the ad, you should be able
98       to get all the relevant information you need. Alternately, you can find
99       the correct URL by looking at <span class=
100       "APPLICATION">Privoxy's</span> logs (you may need to enable logging in
101       the main config file if its disabled).</p>
102       <p>Below is a slightly modified real-life log snippet that originates
103       with one requested URL: <tt class="LITERAL">www.example.com</tt> (name
104       of site was changed for this example, the number of requests is real).
105       You can see in this the complexity of what goes into making up this one
106       <span class="QUOTE">"page"</span>. There are eight different domains
107       involved here, with thirty two separate URLs requested in all, making
108       up all manner of images, Shockwave Flash, JavaScript, CSS stylesheets,
109       scripts, and other related content. Some of this content is obviously
110       <span class="QUOTE">"good"</span> or <span class="QUOTE">"bad"</span>,
111       but not all. Many of the more questionable looking requests, are going
112       to outside domains that seem to be identifying themselves with
113       suspicious looking names, making our job a little easier. <span class=
114       "APPLICATION">Privoxy</span> has <span class="QUOTE">"crunched"</span>
115       (meaning caught and BLOCKED) quite a few items in this example, but
116       perhaps missed a few as well.</p>
117       <table border="0" bgcolor="#E0E0E0" width="100%">
118         <tr>
119           <td>
120             <pre class="SCREEN">Request: www.example.com/
121 Request: www.example.com/favicon.ico
122 Request: img.example.com/main.css
123 Request: img.example.com/sr.js
124 Request: example.betamarker.com/example.html
125 Request: www.lik-sang.com/Banners/bestsellers/skyscraper.php?likref=BSellers
126 Request: img.example.com/pb.png
127 Request: www.google-analytics.com/urchin.js crunch! (Blocked)
128 Request: www.advertising-department.com/ats/switch.ps.php?26856 crunch! (Blocked)
129 Request: img.example.com/p.gif
130 Request: www.popuptraffic.com/assign.php?l=example&amp;mode=behind crunch! (Blocked)
131 Request: www.popuptraffic.com/scripts/popup.php?hid=5c3cf&amp;tmpl=PBa.tmpl crunch! (Blocked)
132 Request: www.popuptraffic.com/assign.php?l=example crunch! (Blocked)
133 Request: www.lik-sang.com/Banners/best_sellers/best_sellers.css
134 Request: www.adtrak.net/adx.js crunch! (Blocked)
135 Request: img.example.com/hbg.gif
136 Request: img.example.com/example.jpg
137 Request: img.example.com/mt.png
138 Request: img.example.com/mm.png
139 Request: img.example.com/mb.png
140 Request: www.popuptraffic.com/scripts/popup.php?hid=a71b91fa5&amp;tmpl=Ua.tmp crunch! (Blocked)
141 Request: www.example.com/tracker.js
142 Request: www.lik-sang.com/Banners/best_sellers/lsi_head.gif
143 Request: www.adtrak.net/adjs.php?n=020548130&amp;what=zone:61 crunch! (Blocked)
144 Request: www.adtrak.net/adjs.php?n=463594413&amp;what=zone:58&amp;source=Ua crunch! (Blocked)
145 Request: www.lik-sang.com/Banners/best_sellers/bottomani.swf
146 Request: mmm.elitemediagroup.net/install.php?allowpop=no&amp;popupmincook=0&amp;allowsp2=1 crunch! (Blocked)
147 Request: www.example.com/tracker.js?screen=1400x1050&amp;win=962x693
148 Request: www.adtrak.net/adlog.php?bannerid=1309&amp;clientid=439&amp;zoneid=61 crunch! (Blocked)
149 Request: 66.70.21.80/scripts/click.php?hid=5c3cf599a9efd0320d26&amp;si
150 Request: 66.70.21.80/img/pixel.gif
151 Request: www.adtrak.net/adlog.php?bannerid=1309&amp;clientid=439&amp;zoneid=58&amp;source=Ua&amp;block=86400 crunch! (Blocked)
152 Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua</pre>
153           </td>
154         </tr>
155       </table>
156       <p>Despite 12 out of 32 requests being blocked, the page looked, and
157       seemed to behave perfectly <span class="QUOTE">"normal"</span> (minus
158       some ads, of course).</p>
159     </div>
160     <div class="SECT2">
161       <h3 class="SECT2"><a name="BADSITE" id="BADSITE">5.4. One of my
162       favorite sites does not work with Privoxy. What can I do?</a></h3>
163       <p>First verify that it is indeed a <span class=
164       "APPLICATION">Privoxy</span> problem, by toggling off <span class=
165       "APPLICATION">Privoxy</span> through <a href=
166       "http://config.privoxy.org/toggle" target=
167       "_top">http://config.privoxy.org/toggle</a> (the toggle feature may
168       need to be enabled in the main <tt class="FILENAME">config</tt>), and
169       then shift-reloading the problem page (i.e. holding down the shift key
170       while clicking reload. Alternatively, flush your browser's disk and
171       memory caches).</p>
172       <p>If the problem went away, we know we have a configuration related
173       problem. Now go to <a href="http://config.privoxy.org/show-url-info"
174       target="_top">http://config.privoxy.org/show-url-info</a> and paste the
175       full URL of the page in question into the prompt. See which actions are
176       being applied to the URL, and which matches in which actions files are
177       responsible for that. It might be helpful also to look at your logs for
178       this site too, to see what else might be happening (note: logging may
179       need to be enabled in the main config file). Many sites are complex and
180       require a number of related pages to help present their content. Look
181       at what else might be used by the page in question, and what of that
182       might be <span class="emphasis"><i class=
183       "EMPHASIS">required</i></span>. Now, armed with this information, go to
184       <a href="http://config.privoxy.org/show-status" target=
185       "_top">http://config.privoxy.org/show-status</a> and select the
186       appropriate actions files for editing.</p>
187       <p>You can now either look for a section which disables the actions
188       that you suspect to cause the problem and add a pattern for your site
189       there, or make up a completely new section for your site. In any case,
190       the recommended way is to disable only the prime suspect, reload the
191       problem page, and only if the problem persists, disable more and more
192       actions until you have identified the culprit. You may or may not want
193       to turn the other actions on again. Remember to flush your browser's
194       caches in between any such changes!</p>
195       <p>Alternately, if you are comfortable with a text editor, you can
196       accomplish the same thing by editing the appropriate actions file.
197       Probably the easiest way to deal with such problems when editing by
198       hand is to add your site to a <tt class="LITERAL">{ fragile }</tt>
199       section in <tt class="FILENAME">user.action</tt>, which is an alias
200       that turns off most <span class="QUOTE">"dangerous"</span> actions, but
201       is also likely to turn off more actions then needed, and thus lower
202       your privacy and protection more than necessary,</p>
203       <p>Troubleshooting actions is discussed in more detail in the <a href=
204       "../user-manual/appendix.html#ACTIONSANAT" target="_top">User Manual
205       appendix, Troubleshooting: the Anatomy of an Action</a>. There is also
206       an <a href="../user-manual/actions-file.html#ACT-EXAMPLES" target=
207       "_top">actions tutorial</a> with general configuration information and
208       examples.</p>
209       <p>As a last resort, you can always see if your browser has a setting
210       that will bypass the proxy setting for selective sites. Modern browsers
211       can do this.</p>
212     </div>
213     <div class="SECT2">
214       <h3 class="SECT2"><a name="DUN" id="DUN">5.5. After installing Privoxy,
215       I have to log in every time I start IE. What gives?</a></h3>
216       <p>This is a quirk that affects the installation of <span class=
217       "APPLICATION">Privoxy</span>, in conjunction with Internet Explorer and
218       Internet Connection Sharing on Windows 2000 and Windows XP. The
219       symptoms may appear to be corrupted or invalid DUN settings, or
220       passwords.</p>
221       <p>When setting up an NT based Windows system with <span class=
222       "APPLICATION">Privoxy</span> you may find that things do not seem to be
223       doing what you expect. When you set your system up you will probably
224       have set up Internet Connection Sharing (ICS) with Dial up Networking
225       (DUN) when logged in with administrator privileges. You will probably
226       have made this DUN connection available to other accounts that you may
227       have set-up on your system. E.g. Mum or Dad sets up the system and
228       makes accounts suitably configured for the kids.</p>
229       <p>When setting up <span class="APPLICATION">Privoxy</span> in this
230       environment you will have to alter the proxy set-up of Internet
231       Explorer (IE) for the specific DUN connection on which you wish to use
232       <span class="APPLICATION">Privoxy</span>. When you do this the ICS DUN
233       set-up becomes user specific. In this instance you will see no
234       difference if you change the DUN connection under the account used to
235       set-up the connection. However when you do this from another user you
236       will notice that the DUN connection changes to make available to "Me
237       only". You will also find that you have to store the password under
238       each different user!</p>
239       <p>The reason for this is that each user's set-up for IE is user
240       specific. Each set-up DUN connection and each LAN connection in IE
241       store the settings for each user individually. As such this enforces
242       individual configurations rather than common ones. Hence the first time
243       you use a DUN connection after re-booting your system it may not
244       perform as you expect, and prompt you for the password. Just set and
245       save the password again and all should be OK.</p>
246       <p>[Thanks to Ray Griffith for this submission.]</p>
247     </div>
248     <div class="SECT2">
249       <h3 class="SECT2"><a name="FTP" id="FTP">5.6. I cannot connect to any
250       FTP sites. Privoxy is blocking me.</a></h3>
251       <p><span class="APPLICATION">Privoxy</span> cannot act as a proxy for
252       FTP traffic, so do not configure your browser to use <span class=
253       "APPLICATION">Privoxy</span> as an FTP proxy. The same is true for
254       <span class="emphasis"><i class="EMPHASIS">any protocol other than HTTP
255       or HTTPS (SSL)</i></span>.</p>
256       <p>Most browsers understand FTP as well as HTTP. If you connect to a
257       site, with a URL like <tt class="LITERAL">ftp://ftp.example.com</tt>,
258       your browser is making an FTP connection, and not a HTTP connection. So
259       while your browser may speak FTP, <span class=
260       "APPLICATION">Privoxy</span> does not, and cannot proxy such
261       traffic.</p>
262       <p>To complicate matters, some systems may have a generic <span class=
263       "QUOTE">"proxy"</span> setting, which will enable various protocols,
264       including <span class="emphasis"><i class="EMPHASIS">both</i></span>
265       HTTP and FTP proxying! So it is possible to accidentally enable FTP
266       proxying in these cases. And of course, if this happens, <span class=
267       "APPLICATION">Privoxy</span> will indeed cause problems since it does
268       not know FTP. Newer version will give a sane error message if a FTP
269       connection is attempted. Just disable the FTP setting and all will be
270       well again.</p>
271       <p>Will <span class="APPLICATION">Privoxy</span> ever proxy FTP
272       traffic? Unlikely. There just is not much reason, and the work to make
273       this happen is more than it may seem.</p>
274     </div>
275     <div class="SECT2">
276       <h3 class="SECT2"><a name="MACOSXIE" id="MACOSXIE">5.7. In Mac OS X, I
277       can't configure Microsoft Internet Explorer to use Privoxy as the HTTP
278       proxy.</a></h3>
279       <p>Microsoft Internet Explorer (in versions like 5.1) respects
280       system-wide network settings. In order to change the HTTP proxy, open
281       System Preferences, and click on the Network icon. In the settings pane
282       that comes up, click on the Proxies tab. Ensure the "Web Proxy (HTTP)"
283       checkbox is checked and enter <tt class="LITERAL">127.0.0.1</tt> in the
284       entry field. Enter <tt class="LITERAL">8118</tt> in the Port field. The
285       next time you start IE, it should reflect these values.</p>
286     </div>
287     <div class="SECT2">
288       <h3 class="SECT2"><a name="MACOSXUNINSTALL" id="MACOSXUNINSTALL">5.8.
289       In Mac OS X, I dragged the Privoxy folder to the trash in order to
290       uninstall it. Now the finder tells me I don't have sufficient
291       privileges to empty the trash.</a></h3>
292       <p>Note: This ONLY applies to privoxy 3.0.6 and earlier.</p>
293       <p>Just dragging the <span class="APPLICATION">Privoxy</span> folder to
294       the trash is not enough to delete it. <span class=
295       "APPLICATION">Privoxy</span> supplies an <span class=
296       "APPLICATION">uninstall.command</span> file that takes care of these
297       details. Open the trash, drag the <span class=
298       "APPLICATION">uninstall.command</span> file out of the trash and
299       double-click on it. You will be prompted for confirmation and the
300       administration password.</p>
301       <p>The trash may still appear full after this command; emptying the
302       trash from the desktop should make it appear empty again.</p>
303     </div>
304     <div class="SECT2">
305       <h3 class="SECT2"><a name="MACOSXIMAGES" id="MACOSXIMAGES">5.9. In Mac
306       OS X Panther (10.3), images often fail to load and/or I experience
307       random delays in page loading. I'm using <tt class=
308       "LITERAL">localhost</tt> as my browser's proxy setting.</a></h3>
309       <p>We believe this is due to an IPv6-related bug in Mac OS X, but don't
310       fully understand the issue yet. In any case, changing the proxy setting
311       to <tt class="LITERAL">127.0.0.1</tt> instead of <tt class=
312       "LITERAL">localhost</tt> works around the problem.</p>
313     </div>
314     <div class="SECT2">
315       <h3 class="SECT2"><a name="MACOSXACCOUNTDELETION" id=
316       "MACOSXACCOUNTDELETION">5.10. I just upgraded to Mac OS X 10.9
317       (Mavericks) and now <span class="APPLICATION">Privoxy</span> has
318       stopped working.</a></h3>
319       <p>The upgrade process to Mac OS X Mavericks (10.9) from an earlier
320       version of OS X deletes all user accounts that are either not part of
321       OS X itself or are not interactive user accounts (ones you log in
322       with). Since, for the sake of security, <span class=
323       "APPLICATION">Privoxy</span> runs as a non-privileged user that is
324       created by its installer (_privoxy), it can no longer start up once
325       that account gets deleted. The solution is to perform a complete
326       uninstall using the supplied <span class=
327       "APPLICATION">uninstall.command</span> script (either back up your
328       configuration files or select to not have the uninstaller remove them
329       when it prompts you) and then reinstall <span class=
330       "APPLICATION">Privoxy</span> using the installer package and merge in
331       your configuration.</p>
332     </div>
333     <div class="SECT2">
334       <h3 class="SECT2"><a name="NOHOSTNAME" id="NOHOSTNAME">5.11. My logs
335       show many <span class="QUOTE">"Unable to get my own hostname"</span>
336       lines. Why?</a></h3>
337       <p><span class="APPLICATION">Privoxy</span> tries to get the hostname
338       of the system its running on from the IP address of the system
339       interface it is bound to (from the <tt class="FILENAME">config</tt>
340       file <span class="emphasis"><i class=
341       "EMPHASIS">listen-address</i></span> setting). If the system cannot
342       supply this information, <span class="APPLICATION">Privoxy</span> logs
343       this condition.</p>
344       <p>Typically, this would be considered a minor system configuration
345       error. It is not a fatal error to <span class=
346       "APPLICATION">Privoxy</span> however, but may result in a much slower
347       response from <span class="APPLICATION">Privoxy</span> on some
348       platforms due to DNS timeouts.</p>
349       <p>This can be caused by a problem with the local <tt class=
350       "FILENAME">hosts</tt> file. If this file has been changed from the
351       original, try reverting it to see if that helps. Make sure whatever
352       name(s) are used for the local system, that they resolve both ways.</p>
353       <p>You should also be able to work around the problem with the <a href=
354       "../user-manual/config.html#HOSTNAME" target="_top">hostname
355       option</a>.</p>
356     </div>
357     <div class="SECT2">
358       <h3 class="SECT2"><a name="INUSE" id="INUSE">5.12. When I try to launch
359       Privoxy, I get an error message <span class="QUOTE">"port 8118 is
360       already in use"</span> (or similar wording). Why?</a></h3>
361       <p>Port 8118 is <span class="APPLICATION">Privoxy's</span> default TCP
362       <span class="QUOTE">"listening"</span> port. Typically this message
363       would mean that there is already one instance of <span class=
364       "APPLICATION">Privoxy</span> running, and your system is actually
365       trying to start a second <span class="APPLICATION">Privoxy</span> on
366       the same port, which will not work. (You can have multiple instances
367       but they must be assigned different ports.) How and why this might
368       happen varies from platform to platform, but you need to check your
369       installation and start-up procedures.</p>
370     </div>
371     <div class="SECT2">
372       <h3 class="SECT2"><a name="DEMORONIZER" id="DEMORONIZER">5.13. Pages
373       with UTF-8 fonts are garbled.</a></h3>
374       <p>This may be the result of an overly aggressive filter. The filters
375       that are enabled in the default configuration aren't expected to cause
376       problems like this. If you enabled the <span class=
377       "QUOTE">"demoronizer"</span> filter, please try temporarily disabling
378       it.</p>
379       <p>If that doesn't help, temporarily disable all filters to see if
380       another filter could be the culprit. If the problem disappears, enable
381       the filters one by one, until the problem reappears and the offending
382       filter is found.</p>
383       <p>Once the problem-causing filter is known, it can be fixed or
384       disabled.</p>
385       <p>Upgrading <span class="APPLICATION">Privoxy</span>, or going to the
386       most recent <tt class="FILENAME">default.action</tt> file available
387       from <a href=
388       "https://sourceforge.net/project/showfiles.php?group_id=11118" target=
389       "_top">SourceForge</a> might be worth a try, too.</p>
390     </div>
391     <div class="SECT2">
392       <h3 class="SECT2"><a name="DEMORONIZER2" id="DEMORONIZER2">5.14. Why
393       are binary files (such as images) corrupted when Privoxy is
394       used?</a></h3>
395       <p>This may also be caused by an (<a href=
396       "trouble.html#DEMORONIZER">overly aggressive filter</a> in conjunction
397       with a web server that is misreporting the content type. By default
398       binary files are exempted from <span class=
399       "APPLICATION">Privoxy's</span> filtering (unless the web server by
400       mistake says the file is something else).</p>
401     </div>
402     <div class="SECT2">
403       <h3 class="SECT2"><a name="DEMORONIZER3" id="DEMORONIZER3">5.15. What
404       is the <span class="QUOTE">"demoronizer"</span> and why is it
405       there?</a></h3>
406       <p>The original demoronizer was a Perl script that cleaned up HTML
407       pages which were created with certain Microsoft products. MS has used
408       proprietary extensions to standardized font encodings (ISO 8859-1),
409       which has caused problems for pages that are viewed with non-Microsoft
410       products (and are expecting to see a standard set of fonts). The
411       demoronizer corrected these errors so the pages displayed correctly.
412       <span class="APPLICATION">Privoxy</span> borrowed from this script,
413       introducing a filter based on the original demoronizer, which in turn
414       could correct these errors on the fly.</p>
415       <p>But this is only needed in some situations, and will cause serious
416       problems in some other situations.</p>
417       <p>If you are using Microsoft products, you do not need it. If you need
418       to view pages with UTF-8 characters (such as Cyrillic or Chinese), then
419       it will cause corruption of the fonts, and thus <span class=
420       "emphasis"><i class="EMPHASIS">should not be on</i></span>.</p>
421       <p>On the other hand, if you use non-Microsoft products, and you
422       occasionally notice weird characters on pages, you might want to try
423       it.</p>
424     </div>
425     <div class="SECT2">
426       <h3 class="SECT2"><a name="WINDOWOPEN" id="WINDOWOPEN">5.16. Why do I
427       keep seeing <span class="QUOTE">"PrivoxyWindowOpen()"</span> in raw
428       source code?</a></h3>
429       <p><span class="APPLICATION">Privoxy</span> is attempting to disable
430       malicious <a href="http://en.wikipedia.org/wiki/Javascript" target=
431       "_top">Javascript</a> in this case, with the <tt class=
432       "LITERAL">unsolicited-popups</tt> filter. <span class=
433       "APPLICATION">Privoxy</span> cannot tell very well <span class=
434       "QUOTE">"good"</span> code snippets from <span class=
435       "QUOTE">"bad"</span> code snippets.</p>
436       <p>If you see this in HTML source, and the page displays without
437       problems, then this is good, and likely some pop-up window was
438       disabled. If you see this where it is causing a problem, such as a
439       downloaded program source code file, then you should set an exception
440       for this site or page such that the integrity of the page stays in tact
441       by disabling all filtering.</p>
442     </div>
443     <div class="SECT2">
444       <h3 class="SECT2"><a name="DNSERRORS" id="DNSERRORS">5.17. I am getting
445       too many DNS errors like <span class="QUOTE">"404 No Such
446       Domain"</span>. Why can't Privoxy do this better?</a></h3>
447       <p>There are potentially several factors here. First of all, the DNS
448       resolution is done by the underlying operating system -- not
449       <span class="APPLICATION">Privoxy</span> itself. <span class=
450       "APPLICATION">Privoxy</span> merely initiates the process and hands it
451       off, and then later reports whatever the outcome was and tries to give
452       a coherent message if there seems to be a problem. In some cases, this
453       might otherwise be mitigated by the browser itself which might try some
454       work-arounds and alternate approaches (e.g adding <span class=
455       "QUOTE">"www."</span> to the URL).</p>
456       <p>In other cases, if <span class="APPLICATION">Privoxy</span> is being
457       chained with another proxy, this could complicate the issue, and cause
458       undue delays and timeouts. In the case of a <span class=
459       "QUOTE">"socks4a"</span> proxy, the socks server handles all the DNS.
460       <span class="APPLICATION">Privoxy</span> would just be the <span class=
461       "QUOTE">"messenger"</span> which is reporting whatever problem occurred
462       downstream, and not the root cause of the error.</p>
463       <p>In any case, versions newer than 3.0.3 include various improvements
464       to help <span class="APPLICATION">Privoxy</span> better handle these
465       cases.</p>
466     </div>
467     <div class="SECT2">
468       <h3 class="SECT2"><a name="ALLCPU" id="ALLCPU">5.18. At one site
469       Privoxy just hangs, and starts taking all CPU. Why is this?</a></h3>
470       <p>This is probably a manifestation of the <span class="QUOTE">"100%
471       cpu"</span> problem that occurs on pages containing many (thousands
472       upon thousands) of blank lines. The blank lines are in the raw HTML
473       source of the page, and the browser just ignores them. But the pattern
474       matching in <span class="APPLICATION">Privoxy's</span> page filtering
475       mechanism is trying to match against absurdly long strings and this
476       becomes very CPU-intensive, taking a long, long time to complete.</p>
477       <p>Until a better solution comes along, disable filtering on these
478       pages, particularly the <tt class="LITERAL">js-annoyances</tt> and
479       <tt class="LITERAL">unsolicited-popups</tt> filters. If you run into
480       this problem with a recent <span class="APPLICATION">Privoxy</span>
481       version, please send a problem report.</p>
482     </div>
483     <div class="SECT2">
484       <h3 class="SECT2"><a name="SLOWCRAWL" id="SLOWCRAWL">5.19. I just
485       installed Privoxy, and all my browsing has slowed to a crawl. What
486       gives?</a></h3>
487       <p>This should not happen, and for the overwhelming number of users
488       world-wide, it does not happen. I would suspect some inadvertent
489       interaction of software components such as anti-virus software, spyware
490       protectors, personal firewalls or similar components. Try disabling (or
491       uninstalling) these one at a time and see if that helps. Either way, if
492       you are using a recent <span class="APPLICATION">Privoxy</span>
493       version, please report the problem.</p>
494     </div>
495     <div class="SECT2">
496       <h3 class="SECT2"><a name="PREVENTCOMP" id="PREVENTCOMP">5.20. Why do
497       my filters work on some sites but not on others?</a></h3>
498       <p>It's probably due to compression. It is a common practice for web
499       servers to send their content <span class="QUOTE">"compressed"</span>
500       in order to speed things up, and then let the browser <span class=
501       "QUOTE">"uncompress"</span> them. When compiled with zlib support
502       <span class="APPLICATION">Privoxy</span> can decompress content before
503       filtering, otherwise you may want to enable <a href=
504       "../user-manual/actions-file.html#PREVENT-COMPRESSION" target=
505       "_top">prevent-compression</a>.</p>
506       <p>As of <span class="APPLICATION">Privoxy</span> 3.0.9, zlib support
507       is enabled in the default builds.</p>
508     </div>
509     <div class="SECT2">
510       <h3 class="SECT2"><a name="SSL-WARNINGS" id="SSL-WARNINGS">5.21. On
511       some HTTPS sites my browser warns me about unauthenticated content, the
512       URL bar doesn't get highlighted and the lock symbol appears to be
513       broken. What's going on?</a></h3>
514       <p>Probably the browser is requesting ads through HTTPS and
515       <span class="APPLICATION">Privoxy</span> is blocking the requests.
516       Privoxy's error messages are delivered unencrypted and while it's
517       obvious for the browser that the HTTPS request is already blocked by
518       the proxy, some warn about unauthenticated content anyway.</p>
519       <p>To work around the problem you can redirect those requests to an
520       invalid local address instead of blocking them. While the redirects
521       aren't encrypted either, many browsers don't care. They simply follow
522       the redirect, fail to reach a server and display an error message
523       instead of the ad.</p>
524       <p>To do that, enable logging to figure out which requests get blocked
525       by <span class="APPLICATION">Privoxy</span> and add the hosts (no path
526       patterns) to a section like this:</p>
527       <table border="0" bgcolor="#E0E0E0" width="100%">
528         <tr>
529           <td>
530             <pre class="SCREEN">
531             {+redirect{http://127.0.0.1:0/} -block -limit-connect}
532 .ivwbox.de:443/</pre>
533           </td>
534         </tr>
535       </table>
536       <p>Additionally you have to configure your browser to contact
537       <span class="QUOTE">"127.0.0.1:0"</span> directly (instead of through
538       <span class="APPLICATION">Privoxy</span>).</p>
539       <p>To add a proxy exception in <span class="APPLICATION">Mozilla
540       Firefox</span> open the <span class="QUOTE">"Preferences"</span>, click
541       the <span class="QUOTE">"Settings"</span> button located on the
542       <span class="QUOTE">"Network"</span> tab in the <span class=
543       "QUOTE">"Advanced"</span> section, and add <span class=
544       "QUOTE">"127.0.0.1:0"</span> in the <span class="QUOTE">"No Proxy
545       for:"</span> field.</p>
546     </div>
547     <div class="SECT2">
548       <h3 class="SECT2"><a name="SE-LINUX" id="SE-LINUX">5.22. I get selinux
549       error messages. How can I fix this?</a></h3>
550       <p>Please report the problem to the creator of your selinux
551       policies.</p>
552       <p>The problem is that some selinux policy writers aren't familiar with
553       the application they are trying to <span class="QUOTE">"secure"</span>
554       and thus create policies that make no sense.</p>
555       <p>In <span class="APPLICATION">Privoxy's</span> case the problem
556       usually is that the policy only allows outgoing connections for certain
557       destination ports (e.g. 80 and 443). While this may cover the standard
558       ports, websites occasionally use other ports as well. This isn't a
559       security problem and therefore <span class=
560       "APPLICATION">Privoxy's</span> default configuration doesn't block
561       these requests.</p>
562       <p>If you really want to block these ports (and don't be able to load
563       websites that don't use standard ports), you should configure Privoxy
564       to block these ports as well, so it doesn't trigger the selinux
565       warnings.</p>
566     </div>
567     <div class="SECT2">
568       <h3 class="SECT2"><a name="GENTOO-RICERS" id="GENTOO-RICERS">5.23. I
569       compiled <span class="APPLICATION">Privoxy</span> with Gentoo's portage
570       and it appears to be very slow. Why?</a></h3>
571       <p>Probably you unintentionally compiled <span class=
572       "APPLICATION">Privoxy</span> without threading support in which case
573       requests have to be serialized and only one can be served at the same
574       time.</p>
575       <p>Check your <span class="QUOTE">"USE"</span> flags and make sure they
576       include <span class="QUOTE">"threads"</span>. If they don't, add the
577       flag and rebuild <span class="APPLICATION">Privoxy</span>.</p>
578       <p>If you compiled <span class="APPLICATION">Privoxy</span> with
579       threading support (on POSIX-based systems), the <span class=
580       "QUOTE">"Conditional #defines"</span> section on <a href=
581       "http://config.privoxy.org/show-status" target=
582       "_top">http://config.privoxy.org/show-status</a> will list <span class=
583       "QUOTE">"FEATURE_PTHREAD"</span> as <span class=
584       "QUOTE">"enabled"</span>.</p>
585     </div>
586     <div class="SECT2">
587       <h3 class="SECT2"><a name="TAINTED-SOCKETS" id="TAINTED-SOCKETS">5.24.
588       What are tainted sockets and how do I prevent them?</a></h3>
589       <p><span class="APPLICATION">Privoxy</span> marks sockets as tainted
590       when it can't use them to serve additional requests. This does not
591       necessarily mean that something went wrong and information about
592       tainted sockets is only logged if connection debugging is enabled
593       (debug 2).</p>
594       <p>For example server sockets that were used for CONNECT requests
595       (which are used to tunnel https:// requests) are considered tainted
596       once the client closed its connection to <span class=
597       "APPLICATION">Privoxy</span>. Technically <span class=
598       "APPLICATION">Privoxy</span> could keep the connection to the server
599       open, but the server would not accept requests that do not belong to
600       the previous TLS/SSL session (and the client may even have terminated
601       the session).</p>
602       <p>Server sockets are also marked tainted when a client requests a
603       resource, but closes the connection before <span class=
604       "APPLICATION">Privoxy</span> has completely received (and forwarded)
605       the resource to the client. In this case the server would (probably)
606       accept additional requests, but <span class=
607       "APPLICATION">Privoxy</span> could not get the response without
608       completely reading the leftovers from the previous response.</p>
609       <p>These are just two examples, there are currently a bit more than 25
610       scenarios in which a socket is considered tainted.</p>
611       <p>While sockets can also be marked tainted as a result of a technical
612       problem that may be worth fixing, the problem will be explicitly logged
613       as error.</p>
614     </div>
615     <div class="SECT2">
616       <h3 class="SECT2"><a name="PCRE-STACK-LIMIT" id=
617       "PCRE-STACK-LIMIT">5.25. After adding my custom filters, <span class=
618       "APPLICATION">Privoxy</span> crashes when visitting certain
619       websites</a></h3>
620       <p>This can happen if your custom filters require more memory than
621       <span class="APPLICATION">Privoxy</span> is allowed to use. Usually the
622       problem is that the operating system enforces a stack size limit that
623       isn't sufficient.</p>
624       <p>Unless the problem occurs with the filters available in the default
625       configuration, this is not considered a Privoxy bug.</p>
626       <p>To prevent the crashes you can rewrite your filter to use less
627       ressources, increase the relevant memory limit or recompile pcre to use
628       less stack space. For details please see the <a href=
629       "http://pcre.org/original/doc/html/pcrestack.html" target=
630       "_top">pcrestack man page</a> and the documentation of your operating
631       system.</p>
632     </div>
633   </div>
634   <div class="NAVFOOTER">
635     <hr align="left" width="100%">
636     <table summary="Footer navigation table" width="100%" border="0"
637     cellpadding="0" cellspacing="0">
638       <tr>
639         <td width="33%" align="left" valign="top"><a href="misc.html"
640         accesskey="P">Prev</a></td>
641         <td width="34%" align="center" valign="top"><a href="index.html"
642         accesskey="H">Home</a></td>
643         <td width="33%" align="right" valign="top"><a href="contact.html"
644         accesskey="N">Next</a></td>
645       </tr>
646       <tr>
647         <td width="33%" align="left" valign="top">Miscellaneous</td>
648         <td width="34%" align="center" valign="top">&nbsp;</td>
649         <td width="33%" align="right" valign="top">Contacting the developers,
650         Bug Reporting and Feature Requests</td>
651       </tr>
652     </table>
653   </div>
654 </body>
655 </html>