Re-commit to solve various last minute issues for charsets, etc.
[privoxy.git] / doc / webserver / faq / trouble.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
2 <HTML
3 ><HEAD
4 ><TITLE
5 >Troubleshooting</TITLE
6 ><META
7 NAME="GENERATOR"
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
9 REL="HOME"
10 TITLE="Privoxy Frequently Asked Questions"
11 HREF="index.html"><LINK
12 REL="PREVIOUS"
13 TITLE="Miscellaneous"
14 HREF="misc.html"><LINK
15 REL="NEXT"
16 TITLE="Contacting the developers, Bug Reporting and Feature Requests"
17 HREF="contact.html"><LINK
18 REL="STYLESHEET"
19 TYPE="text/css"
20 HREF="../p_doc.css"><META
21 HTTP-EQUIV="Content-Type"
22 CONTENT="text/html;
23 charset=ISO-8859-1"></HEAD
24 ><BODY
25 CLASS="SECT1"
26 BGCOLOR="#EEEEEE"
27 TEXT="#000000"
28 LINK="#0000FF"
29 VLINK="#840084"
30 ALINK="#0000FF"
31 ><DIV
32 CLASS="NAVHEADER"
33 ><TABLE
34 SUMMARY="Header navigation table"
35 WIDTH="100%"
36 BORDER="0"
37 CELLPADDING="0"
38 CELLSPACING="0"
39 ><TR
40 ><TH
41 COLSPAN="3"
42 ALIGN="center"
43 >Privoxy Frequently Asked Questions</TH
44 ></TR
45 ><TR
46 ><TD
47 WIDTH="10%"
48 ALIGN="left"
49 VALIGN="bottom"
50 ><A
51 HREF="misc.html"
52 ACCESSKEY="P"
53 >Prev</A
54 ></TD
55 ><TD
56 WIDTH="80%"
57 ALIGN="center"
58 VALIGN="bottom"
59 ></TD
60 ><TD
61 WIDTH="10%"
62 ALIGN="right"
63 VALIGN="bottom"
64 ><A
65 HREF="contact.html"
66 ACCESSKEY="N"
67 >Next</A
68 ></TD
69 ></TR
70 ></TABLE
71 ><HR
72 ALIGN="LEFT"
73 WIDTH="100%"></DIV
74 ><DIV
75 CLASS="SECT1"
76 ><H1
77 CLASS="SECT1"
78 ><A
79 NAME="TROUBLE"
80 >5. Troubleshooting</A
81 ></H1
82 ><DIV
83 CLASS="SECT2"
84 ><H3
85 CLASS="SECT2"
86 ><A
87 NAME="AEN1081"
88 >5.1. I cannot connect to any websites. Or, I am getting
89 <SPAN
90 CLASS="QUOTE"
91 >"connection refused"</SPAN
92 > message with every web page. Why?</A
93 ></H3
94 ><P
95 > There are several possibilities:</P
96 ><P
97 ><P
98 ></P
99 ><UL
100 ><LI
101 ><P
102 ><SPAN
103 CLASS="APPLICATION"
104 >Privoxy</SPAN
105 > is not running. Solution: verify 
106  that <SPAN
107 CLASS="APPLICATION"
108 >Privoxy</SPAN
109 > is installed correctly, has not crashed, and is indeed running.
110  Turn on <SPAN
111 CLASS="APPLICATION"
112 >Privoxy's</SPAN
113 > logging, and look at the logs to see what they say.</P
114 ></LI
115 ><LI
116 ><P
117 >Or your browser is configured for a different port than what
118  <SPAN
119 CLASS="APPLICATION"
120 >Privoxy</SPAN
121 > is using. Solution: verify that <SPAN
122 CLASS="APPLICATION"
123 >Privoxy</SPAN
124 >
125  and your browser are set to the same port (<TT
126 CLASS="LITERAL"
127 >listen-address</TT
128 >).</P
129 ></LI
130 ><LI
131 ><P
132 >Or if using a forwarding rule, you have a configuration problem or a
133  problem with a host in the forwarding chain. Solution: temporarily alter your
134  configuration and take the forwarders out of the equation.</P
135 ></LI
136 ><LI
137 ><P
138 >  Or you have a firewall that is interfering and blocking you. Solution: 
139   try disabling or removing the firewall as a simple test.
140  </P
141 ></LI
142 ></UL
143 ></P
144 ></DIV
145 ><DIV
146 CLASS="SECT2"
147 ><H3
148 CLASS="SECT2"
149 ><A
150 NAME="ERROR503"
151 >5.2. Why am I getting a 503 Error (WSAECONNREFUSED) on every page?</A
152 ></H3
153 ><P
154 >  More than likely this is a problem with your TCP/IP networking. ZoneAlarm has
155   been reported to cause this symptom -- even if not running! The solution is
156   to either fight the ZA configuration, or uninstall ZoneAlarm, and then find
157   something better behaved in its place. Other personal firewall type products
158   may cause similar type problems if not configured correctly.
159  </P
160 ></DIV
161 ><DIV
162 CLASS="SECT2"
163 ><H3
164 CLASS="SECT2"
165 ><A
166 NAME="AEN1104"
167 >5.3. I just added a new rule, but the steenkin ad is 
168 still getting through. How?</A
169 ></H3
170 ><P
171 > If the ad had been displayed before you added its URL, it will probably be
172  held in the browser's cache for some time, so it will be displayed without
173  the need for any request to the server, and <SPAN
174 CLASS="APPLICATION"
175 >Privoxy</SPAN
176 >
177  will not be involved. Flush the browser's caches, and then try again.</P
178 ><P
179 > If this doesn't help, you probably have an error in the rule you
180  applied. Try pasting the full URL of the offending ad into <A
181 HREF="http://config.privoxy.org/show-url-info"
182 TARGET="_top"
183 >http://config.privoxy.org/show-url-info</A
184 >
185  and see if it really matches your new rule. Blocking ads is like blocking
186  spam: a lot of tinkering is required to stay ahead of the game. And 
187  remember you need to block the URL of the ad in question, which may be 
188  entirely different from the site URL itself. Most ads are hosted on different
189  servers than the main site itself. If you right-click on the ad, you should
190  be able to get all the relevant information you need. Alternately, you can 
191  find the correct URL by looking at <SPAN
192 CLASS="APPLICATION"
193 >Privoxy's</SPAN
194 > logs
195  (you may need to enable logging in the main config file if its disabled).</P
196 ><P
197 > Below is a slightly modified real-life log snippet that originates with one 
198  requested URL: <TT
199 CLASS="LITERAL"
200 >www.example.com</TT
201 > (name of site was changed
202  for this example, the number of requests is real). You can see in this the
203  complexity of what goes into making up this one <SPAN
204 CLASS="QUOTE"
205 >"page"</SPAN
206 >. There
207  are eight different domains involved here, with thirty two separate URLs
208  requested in all, making up all manner of images, Shockwave Flash,
209  JavaScript, CSS stylesheets, scripts, and other related content. Some of this
210  content is obviously <SPAN
211 CLASS="QUOTE"
212 >"good"</SPAN
213 > or <SPAN
214 CLASS="QUOTE"
215 >"bad"</SPAN
216 >, but not all.
217  Many of the more questionable looking requests, are going to outside domains
218  that seem to be identifying themselves with suspicious looking names, making
219  our job a little easier. <SPAN
220 CLASS="APPLICATION"
221 >Privoxy</SPAN
222 > has <SPAN
223 CLASS="QUOTE"
224 >"crunched"</SPAN
225 > (meaning caught 
226  and BLOCKED) quite a few items in this example, but perhaps missed a few as well. </P
227 ><P
228 ><TABLE
229 BORDER="0"
230 BGCOLOR="#E0E0E0"
231 WIDTH="100%"
232 ><TR
233 ><TD
234 ><PRE
235 CLASS="SCREEN"
236 >Request: www.example.com/
237 Request: www.example.com/favicon.ico
238 Request: img.example.com/main.css
239 Request: img.example.com/sr.js
240 Request: example.betamarker.com/example.html
241 Request: www.lik-sang.com/Banners/bestsellers/skyscraper.php?likref=BSellers
242 Request: img.example.com/pb.png
243 Request: www.google-analytics.com/urchin.js crunch! (Blocked)
244 Request: www.advertising-department.com/ats/switch.ps.php?26856 crunch! (Blocked)
245 Request: img.example.com/p.gif
246 Request: www.popuptraffic.com/assign.php?l=example&#38;mode=behind crunch! (Blocked)
247 Request: www.popuptraffic.com/scripts/popup.php?hid=5c3cf&#38;tmpl=PBa.tmpl crunch! (Blocked)
248 Request: www.popuptraffic.com/assign.php?l=example crunch! (Blocked)
249 Request: www.lik-sang.com/Banners/best_sellers/best_sellers.css
250 Request: www.adtrak.net/adx.js crunch! (Blocked)
251 Request: img.example.com/hbg.gif
252 Request: img.example.com/example.jpg
253 Request: img.example.com/mt.png
254 Request: img.example.com/mm.png
255 Request: img.example.com/mb.png
256 Request: www.popuptraffic.com/scripts/popup.php?hid=a71b91fa5&#38;tmpl=Ua.tmp crunch! (Blocked)
257 Request: www.example.com/tracker.js
258 Request: www.lik-sang.com/Banners/best_sellers/lsi_head.gif
259 Request: www.adtrak.net/adjs.php?n=020548130&#38;what=zone:61 crunch! (Blocked)
260 Request: www.adtrak.net/adjs.php?n=463594413&#38;what=zone:58&#38;source=Ua crunch! (Blocked)
261 Request: www.lik-sang.com/Banners/best_sellers/bottomani.swf
262 Request: mmm.elitemediagroup.net/install.php?allowpop=no&#38;popupmincook=0&#38;allowsp2=1 crunch! (Blocked)
263 Request: www.example.com/tracker.js?screen=1400x1050&#38;win=962x693
264 Request: www.adtrak.net/adlog.php?bannerid=1309&#38;clientid=439&#38;zoneid=61 crunch! (Blocked)
265 Request: 66.70.21.80/scripts/click.php?hid=5c3cf599a9efd0320d26&#38;si
266 Request: 66.70.21.80/img/pixel.gif
267 Request: www.adtrak.net/adlog.php?bannerid=1309&#38;clientid=439&#38;zoneid=58&#38;source=Ua&#38;block=86400 crunch! (Blocked)
268 Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&#38;si=Ua</PRE
269 ></TD
270 ></TR
271 ></TABLE
272 ></P
273 ><P
274 > Despite 12 out of 32 requests being blocked, the page looked, and seemed to
275  behave perfectly <SPAN
276 CLASS="QUOTE"
277 >"normal"</SPAN
278 > (minus some ads, of course).</P
279 ></DIV
280 ><DIV
281 CLASS="SECT2"
282 ><H3
283 CLASS="SECT2"
284 ><A
285 NAME="BADSITE"
286 >5.4. One of my favorite sites does not work with Privoxy.
287 What can I do?</A
288 ></H3
289 ><P
290 > First verify that it is indeed a <SPAN
291 CLASS="APPLICATION"
292 >Privoxy</SPAN
293 > problem, 
294  by toggling off <SPAN
295 CLASS="APPLICATION"
296 >Privoxy</SPAN
297 > through <A
298 HREF="http://config.privoxy.org/toggle"
299 TARGET="_top"
300 >http://config.privoxy.org/toggle</A
301 >
302  (the toggle feature may need to be enabled in the main
303  <TT
304 CLASS="FILENAME"
305 >config</TT
306 >),
307  and then shift-reloading the problem page (i.e. holding down the shift key
308  while clicking reload. Alternatively, flush your browser's disk and memory
309  caches).</P
310 ><P
311 > If the problem went away, we know we have a configuration related problem.
312  Now go to <A
313 HREF="http://config.privoxy.org/show-url-info"
314 TARGET="_top"
315 >http://config.privoxy.org/show-url-info</A
316 >
317  and paste the full URL of the page in question into the prompt. See which
318  actions are being applied to the URL, and which matches in which actions
319  files are responsible for that. It might be helpful also to look at your logs
320  for this site too, to see what else might be happening (note: logging may need
321  to be enabled in the main config file). Many sites are
322  complex and require a number of related pages to help present their content.
323  Look at what else might be used by the page in question, and what of that
324  might be <SPAN
325 CLASS="emphasis"
326 ><I
327 CLASS="EMPHASIS"
328 >required</I
329 ></SPAN
330 >.
331  Now, armed with this information, go to
332  <A
333 HREF="http://config.privoxy.org/show-status"
334 TARGET="_top"
335 >http://config.privoxy.org/show-status</A
336 >
337  and select the appropriate actions files for editing. </P
338 ><P
339 > You can now either look for a section which disables the actions that
340  you suspect to cause the problem and add a pattern for your site there,
341  or make up a completely new section for your site. In any case, the recommended
342  way is to disable only the prime suspect, reload the problem page, and only
343  if the problem persists, disable more and more actions until you have
344  identified the culprit. You may or may not want to turn the other actions
345  on again. Remember to flush your browser's caches in between any such changes!</P
346 ><P
347 > Alternately, if you are comfortable with a text editor, you can accomplish 
348  the same thing by editing the appropriate actions file. Probably the easiest 
349  way to deal with such problems when editing by hand is to add your
350  site to a <TT
351 CLASS="LITERAL"
352 >{ fragile }</TT
353 > section in <TT
354 CLASS="FILENAME"
355 >user.action</TT
356 >,
357  which is an alias that turns off most <SPAN
358 CLASS="QUOTE"
359 >"dangerous"</SPAN
360 >
361  actions, but is also likely to turn off more actions then needed, and thus lower
362  your privacy and protection more than necessary, </P
363 ><P
364 > Troubleshooting actions is discussed in more detail in the <A
365 HREF="../user-manual/appendix.html#ACTIONSANAT"
366 TARGET="_top"
367 >User Manual appendix,
368  Troubleshooting: the Anatomy of an Action</A
369 >.
370  There is also an <A
371 HREF="../user-manual/actions-file.html#ACT-EXAMPLES"
372 TARGET="_top"
373 >actions tutorial</A
374 >
375  with general configuration information and examples.</P
376 ><P
377 > As a last resort, you can always see if your browser has a setting that will 
378  bypass the proxy setting for selective sites. Modern browsers can do this.</P
379 ></DIV
380 ><DIV
381 CLASS="SECT2"
382 ><H3
383 CLASS="SECT2"
384 ><A
385 NAME="DUN"
386 >5.5. After installing Privoxy, I have to log in
387 every time I start IE. What gives?</A
388 ></H3
389 ><P
390 > This is a quirk that effects the installation of
391  <SPAN
392 CLASS="APPLICATION"
393 >Privoxy</SPAN
394 >, in conjunction with Internet Explorer and
395  Internet Connection Sharing on Windows 2000 and Windows XP. The symptoms may
396  appear to be corrupted or invalid DUN settings, or passwords.</P
397 ><P
398 > When setting up an NT based Windows system with
399  <SPAN
400 CLASS="APPLICATION"
401 >Privoxy</SPAN
402 > you may find that things do not seem to be
403  doing what you expect. When you set your system up you will probably have set
404  up Internet Connection Sharing (ICS) with Dial up Networking (DUN) when
405  logged in with administrator privileges. You will probably have made this DUN
406  connection available to other accounts that you may have set-up on your
407  system. E.g. Mum or Dad sets up the system and makes accounts suitably
408  configured for the kids.</P
409 ><P
410 > When setting up <SPAN
411 CLASS="APPLICATION"
412 >Privoxy</SPAN
413 > in this environment you
414  will have to alter the proxy set-up of Internet Explorer (IE) for the
415  specific DUN connection on which you wish to use
416  <SPAN
417 CLASS="APPLICATION"
418 >Privoxy</SPAN
419 >. When you do this the ICS DUN set-up
420  becomes user specific. In this instance you will see no difference if you
421  change the DUN connection under the account used to set-up the connection.
422  However when you do this from another user you will notice that the DUN
423  connection changes to make available to "Me only". You will also find that
424  you have to store the password under each different user!</P
425 ><P
426 > The reason for this is that each user's set-up for IE is user specific. Each
427  set-up DUN connection and each LAN connection in IE store the settings for
428  each user individually. As such this enforces individual configurations
429  rather than common ones. Hence the first time you use a DUN connection after
430  re-booting your system it may not perform as you expect, and prompt you for 
431  the password. Just set and save the password again and all should be OK.</P
432 ><P
433 >[Thanks to Ray Griffith for this submission.]</P
434 ></DIV
435 ><DIV
436 CLASS="SECT2"
437 ><H3
438 CLASS="SECT2"
439 ><A
440 NAME="FTP"
441 >5.6. I cannot connect to any FTP sites. Privoxy
442  is blocking me.</A
443 ></H3
444 ><P
445 >  <SPAN
446 CLASS="APPLICATION"
447 >Privoxy</SPAN
448 > cannot act as a proxy for FTP traffic, 
449   so do not configure your browser to use <SPAN
450 CLASS="APPLICATION"
451 >Privoxy</SPAN
452 >
453   as an FTP proxy. The same is true for <SPAN
454 CLASS="emphasis"
455 ><I
456 CLASS="EMPHASIS"
457 >any protocol other than HTTP
458   or HTTPS (SSL)</I
459 ></SPAN
460 >. 
461  </P
462 ><P
463 >  Most browsers understand FTP as well as HTTP. If you connect to a site, with
464   a URL like <TT
465 CLASS="LITERAL"
466 >ftp://ftp.example.com</TT
467 >, your browser is making
468   an FTP connection, and not a HTTP connection. So while your browser may 
469   speak FTP, <SPAN
470 CLASS="APPLICATION"
471 >Privoxy</SPAN
472 > does not, and cannot proxy 
473   such traffic.
474  </P
475 ><P
476 >  To complicate matters, some systems may have a generic <SPAN
477 CLASS="QUOTE"
478 >"proxy"</SPAN
479 >
480   setting, which will enable various protocols, including
481   <SPAN
482 CLASS="emphasis"
483 ><I
484 CLASS="EMPHASIS"
485 >both</I
486 ></SPAN
487 > HTTP and FTP proxying! So it is possible to
488   accidentally enable FTP proxying in these cases. And of course, if this
489   happens, <SPAN
490 CLASS="APPLICATION"
491 >Privoxy</SPAN
492 > will indeed cause problems since
493   it does not know FTP. Newer version will give a sane error
494   message if a FTP connection is attempted. Just disable the FTP setting 
495   and all will be well again.
496  </P
497 ><P
498 >  Will <SPAN
499 CLASS="APPLICATION"
500 >Privoxy</SPAN
501 > ever proxy FTP traffic? Unlikely.
502   There just is not much reason, and the work to make this happen is more than
503   it may seem.
504  </P
505 ></DIV
506 ><DIV
507 CLASS="SECT2"
508 ><H3
509 CLASS="SECT2"
510 ><A
511 NAME="OSXIE"
512 >5.7. In Mac OSX, I can't configure Microsoft Internet Explorer to use 
513  Privoxy as the HTTP proxy.</A
514 ></H3
515 ><P
516 >  Microsoft Internet Explorer (in versions like 5.1) respects system-wide
517   network settings.  In order to change the HTTP proxy, open System
518   Preferences, and click on the Network icon.  In the settings pane that
519   comes up, click on the Proxies tab.  Ensure the "Web Proxy (HTTP)" checkbox 
520   is checked and enter <TT
521 CLASS="LITERAL"
522 >127.0.0.1</TT
523 > in the entry field.  
524   Enter <TT
525 CLASS="LITERAL"
526 >8118</TT
527 > in the Port field.  The next time you start
528   IE, it should reflect these values.
529  </P
530 ></DIV
531 ><DIV
532 CLASS="SECT2"
533 ><H3
534 CLASS="SECT2"
535 ><A
536 NAME="OSXUNINSTALL"
537 >5.8. In Mac OSX, I dragged the Privoxy folder to the trash in order to 
538  uninstall it.  Now the finder tells me I don't have sufficient privileges to
539  empty the trash.</A
540 ></H3
541 ><P
542 >  Just dragging the <SPAN
543 CLASS="APPLICATION"
544 >Privoxy</SPAN
545 > folder to the trash is
546   not enough to delete it.  <SPAN
547 CLASS="APPLICATION"
548 >Privoxy</SPAN
549 > supplies an
550   <SPAN
551 CLASS="APPLICATION"
552 >uninstall.command</SPAN
553 > file that takes care of
554   these details.  Open the trash, drag the <SPAN
555 CLASS="APPLICATION"
556 >uninstall.command</SPAN
557 >
558   file out of the trash and double-click on it.  You will be prompted for
559   confirmation and the administration password.
560  </P
561 ><P
562 >  The trash may still appear full after this command; emptying the trash 
563   from the desktop should make it appear empty again.
564  </P
565 ></DIV
566 ><DIV
567 CLASS="SECT2"
568 ><H3
569 CLASS="SECT2"
570 ><A
571 NAME="OSXIMAGES"
572 >5.9. In Mac OSX Panther (10.3), images often fail to load and/or I
573  experience random delays in page loading. I'm using
574  <TT
575 CLASS="LITERAL"
576 >localhost</TT
577 > as my browser's proxy setting.</A
578 ></H3
579 ><P
580 >  We believe this is due to an IPv6-related bug in OSX, but don't fully
581   understand the issue yet. In any case, changing the proxy setting to 
582   <TT
583 CLASS="LITERAL"
584 >127.0.0.1</TT
585 > instead of <TT
586 CLASS="LITERAL"
587 >localhost</TT
588 >
589   works around the problem.
590  </P
591 ></DIV
592 ><DIV
593 CLASS="SECT2"
594 ><H3
595 CLASS="SECT2"
596 ><A
597 NAME="BLANKPAGE"
598 >5.10. I get a completely blank page at one site. <SPAN
599 CLASS="QUOTE"
600 >"View Source"</SPAN
601 >
602  shows only: <SPAN
603 CLASS="MARKUP"
604 >&#60;html&#62;&#60;body&#62;&#60;/body&#62;&#60;/html&#62;</SPAN
605 >. Without
606  Privoxy the page loads fine.</A
607 ></H3
608 ><P
609 >  Chances are that the site suffers from a bug in
610   <A
611 HREF="http://www.php.net/"
612 TARGET="_top"
613 ><SPAN
614 CLASS="APPLICATION"
615 >PHP</SPAN
616 ></A
617 >,
618   which results in empty pages being sent if the client explicitly requests
619   an uncompressed page, like <SPAN
620 CLASS="APPLICATION"
621 >Privoxy</SPAN
622 > does.
623   This bug has been fixed in PHP 4.2.3.
624  </P
625 ><P
626 >  To find out if this is in fact the source of the problem, try adding
627   the site to a <TT
628 CLASS="LITERAL"
629 >-prevent-compression</TT
630 > section in
631   <TT
632 CLASS="FILENAME"
633 >user.action</TT
634 >:
635  </P
636 ><TABLE
637 BORDER="0"
638 BGCOLOR="#E0E0E0"
639 WIDTH="100%"
640 ><TR
641 ><TD
642 ><PRE
643 CLASS="SCREEN"
644 >   # Make exceptions for ill-behaved sites:                                     
645    #                                                                    
646    {-prevent-compression}                                               
647     .example.com</PRE
648 ></TD
649 ></TR
650 ></TABLE
651 ><P
652 >  If that works, you may also want to report the problem to the
653   site's webmasters, telling them to use zlib.output_compression
654   instead of ob_gzhandler in their PHP applications (workaround)
655   or upgrade to PHP 4.2.3 or later (fix).
656  </P
657 ></DIV
658 ><DIV
659 CLASS="SECT2"
660 ><H3
661 CLASS="SECT2"
662 ><A
663 NAME="NOHOSTNAME"
664 >5.11. My logs show many <SPAN
665 CLASS="QUOTE"
666 >"Unable to get my own hostname"</SPAN
667 > lines.
668 Why?</A
669 ></H3
670 ><P
671 > <SPAN
672 CLASS="APPLICATION"
673 >Privoxy</SPAN
674 > tries to get the hostname of the system
675  its running on from the IP address of the system interface it is bound to
676  (from the <TT
677 CLASS="FILENAME"
678 >config</TT
679 > file
680  <SPAN
681 CLASS="emphasis"
682 ><I
683 CLASS="EMPHASIS"
684 >listen-address</I
685 ></SPAN
686 > setting). If the system cannot supply
687  this information, <SPAN
688 CLASS="APPLICATION"
689 >Privoxy</SPAN
690 > logs this condition. </P
691 ><P
692 > Typically, this would be considered a minor system configuration error. It is
693  not a fatal error to <SPAN
694 CLASS="APPLICATION"
695 >Privoxy</SPAN
696 > however, but may
697  result in a much slower response from <SPAN
698 CLASS="APPLICATION"
699 >Privoxy</SPAN
700 > on
701  some platforms due to DNS timeouts.</P
702 ><P
703 > This can be caused by a problem with the local <TT
704 CLASS="FILENAME"
705 >HOSTS</TT
706 >
707  file. If this file has been changed from the original, try reverting it to
708  see if that helps. Make sure whatever name(s) are used for the local system,
709  that they resolve both ways.</P
710 ></DIV
711 ><DIV
712 CLASS="SECT2"
713 ><H3
714 CLASS="SECT2"
715 ><A
716 NAME="INUSE"
717 >5.12. When I try to launch Privoxy, I get an 
718 error message <SPAN
719 CLASS="QUOTE"
720 >"port 8118 is already in use"</SPAN
721 > (or similar wording).
722 Why?</A
723 ></H3
724 ><P
725 > Port 8118 is <SPAN
726 CLASS="APPLICATION"
727 >Privoxy's</SPAN
728 > default TCP 
729  <SPAN
730 CLASS="QUOTE"
731 >"listening"</SPAN
732 > port. Typically this message would mean that there
733  is already one instance of <SPAN
734 CLASS="APPLICATION"
735 >Privoxy</SPAN
736 > running, and
737  your system is actually trying to start a second
738  <SPAN
739 CLASS="APPLICATION"
740 >Privoxy</SPAN
741 > on the same port, which will not work.
742  (You can have multiple instances but they must be assigned different ports.)
743  How and why this might happen varies from platform to platform, but you need
744  to check your installation and start-up procedures.</P
745 ></DIV
746 ><DIV
747 CLASS="SECT2"
748 ><H3
749 CLASS="SECT2"
750 ><A
751 NAME="DEMORONIZER"
752 >5.13. Pages with UTF-8 fonts are garbled.</A
753 ></H3
754 ><P
755 > This is caused by the <SPAN
756 CLASS="QUOTE"
757 >"demoronizer"</SPAN
758 > filter. You should either
759  upgrade <SPAN
760 CLASS="APPLICATION"
761 >Privoxy</SPAN
762 >, or at least upgrade to the most
763  recent <TT
764 CLASS="FILENAME"
765 >default.action</TT
766 > file available from <A
767 HREF="http://sourceforge.net/project/showfiles.php?group_id=11118"
768 TARGET="_top"
769 >SourceForge</A
770 >.
771  Or you can simply disable the demoronizer filter.</P
772 ></DIV
773 ><DIV
774 CLASS="SECT2"
775 ><H3
776 CLASS="SECT2"
777 ><A
778 NAME="DEMORONIZER2"
779 >5.14. Why are binary files (such as images) corrupted when Privoxy
780  is used?</A
781 ></H3
782 ><P
783 > This may also be caused by the <SPAN
784 CLASS="QUOTE"
785 >"demoronizer"</SPAN
786 > filter, 
787  in conjunction with a web server that is misreporting the content type. Binary 
788  files are exempted from <SPAN
789 CLASS="APPLICATION"
790 >Privoxy's</SPAN
791 > filtering
792  (unless the web server by mistake says the file is something else). Either
793  upgrade <SPAN
794 CLASS="APPLICATION"
795 >Privoxy</SPAN
796 >, or go to the most recent
797  <TT
798 CLASS="FILENAME"
799 >default.action</TT
800 > file available from <A
801 HREF="http://sourceforge.net/project/showfiles.php?group_id=11118"
802 TARGET="_top"
803 >SourceForge</A
804 >.</P
805 ></DIV
806 ><DIV
807 CLASS="SECT2"
808 ><H3
809 CLASS="SECT2"
810 ><A
811 NAME="DEMORONIZER3"
812 >5.15. What is the <SPAN
813 CLASS="QUOTE"
814 >"demoronizer"</SPAN
815 > and why is it there?</A
816 ></H3
817 ><P
818 > The original demoronizer was a Perl script that cleaned up HTML pages which 
819  were created with certain Microsoft products. MS has used proprietary extensions 
820  to standardized font encodings (ISO 8859-1), which has caused problems for pages
821  that are viewed with non-Microsoft products (and are expecting to see a
822  standard set of fonts). The demoronizer corrected these errors so the pages
823  displayed correctly. <SPAN
824 CLASS="APPLICATION"
825 >Privoxy</SPAN
826 > borrowed from this
827  script, introducing a filter based on the original demoronizer, which in turn could
828  correct these errors on the fly. </P
829 ><P
830 > But this is only needed in some situations, and will cause serious problems in some 
831  other situations.</P
832 ><P
833 > If you are using Microsoft products, you do not need it. If you need to view 
834  pages with UTF-8 characters (such as Cyrillic or Chinese), then it will 
835  cause corruption of the fonts, and thus <SPAN
836 CLASS="emphasis"
837 ><I
838 CLASS="EMPHASIS"
839 >should not be on</I
840 ></SPAN
841 >.</P
842 ><P
843 > On the other hand, if you use non-Microsoft products, and you occasionally 
844  notice weird characters on pages, you might want to try it.</P
845 ></DIV
846 ><DIV
847 CLASS="SECT2"
848 ><H3
849 CLASS="SECT2"
850 ><A
851 NAME="WINDOWOPEN"
852 >5.16. Why do I keep seeing <SPAN
853 CLASS="QUOTE"
854 >"PrivoxyWindowOpen()"</SPAN
855 > in raw source code?</A
856 ></H3
857 ><P
858 > <SPAN
859 CLASS="APPLICATION"
860 >Privoxy</SPAN
861 > is attempting to disable malicious 
862   <A
863 HREF="http://en.wikipedia.org/wiki/Javascript"
864 TARGET="_top"
865 >Javascript</A
866
867   in this case, with the <TT
868 CLASS="LITERAL"
869 >unsolicited-popups</TT
870 >
871  filter. <SPAN
872 CLASS="APPLICATION"
873 >Privoxy</SPAN
874 > cannot tell very well 
875  <SPAN
876 CLASS="QUOTE"
877 >"good"</SPAN
878 > code snippets from <SPAN
879 CLASS="QUOTE"
880 >"bad"</SPAN
881 > code snippets.</P
882 ><P
883 > If you see this in HTML source, and the page displays without problems, then 
884  this is good, and likely some pop-up window was disabled. If you see this 
885  where it is causing a problem, such as a downloaded program source code file, 
886  then you should set an exception for this site or page such that the
887  integrity of the page stays in tact by disabling all filtering.</P
888 ></DIV
889 ><DIV
890 CLASS="SECT2"
891 ><H3
892 CLASS="SECT2"
893 ><A
894 NAME="DNSERRORS"
895 >5.17. I am getting too many DNS errors like <SPAN
896 CLASS="QUOTE"
897 >"404 No Such Domain"</SPAN
898 >. Why
899  can't Privoxy do this better?</A
900 ></H3
901 ><P
902 > There are potentially several factors here. First of all, the DNS resolution
903  is done by the underlying operating system -- not
904  <SPAN
905 CLASS="APPLICATION"
906 >Privoxy</SPAN
907 > itself. <SPAN
908 CLASS="APPLICATION"
909 >Privoxy</SPAN
910 >
911  merely initiates the process and hands it off, and then later reports
912  whatever the outcome was. And tries to give a coherent message if there seems
913  to be a problem. In some cases, this might otherwise be mitigated by the
914  browser itself which might try some work-arounds and alternate approaches (e.g
915  adding <SPAN
916 CLASS="QUOTE"
917 >"www."</SPAN
918 > to the URL).</P
919 ><P
920 > In other cases, if <SPAN
921 CLASS="APPLICATION"
922 >Privoxy</SPAN
923 > is being chained
924  with another proxy, this could complicate the issue, and cause undue
925  delays and timeouts. In the case of a <SPAN
926 CLASS="QUOTE"
927 >"socks4a"</SPAN
928 > proxy, the socks
929  server handles all the DNS.  <SPAN
930 CLASS="APPLICATION"
931 >Privoxy</SPAN
932 > would just be
933  the <SPAN
934 CLASS="QUOTE"
935 >"messenger"</SPAN
936 > which is reporting whatever problem occurred
937  downstream, and not the root cause of the error.</P
938 ><P
939 > In any case, versions newer than 3.0.3 include various improvements to help
940  <SPAN
941 CLASS="APPLICATION"
942 >Privoxy</SPAN
943 > better handle these cases.</P
944 ></DIV
945 ><DIV
946 CLASS="SECT2"
947 ><H3
948 CLASS="SECT2"
949 ><A
950 NAME="ALLCPU"
951 >5.18. At one site Privoxy just hangs, and starts taking 
952  all CPU. Why is this?</A
953 ></H3
954 ><P
955 > This is probably a manifestation of the <SPAN
956 CLASS="QUOTE"
957 >"100% cpu"</SPAN
958 > problem that
959  occurs on pages containing many (thousands upon thousands) of blank lines. The blank lines 
960  are in the raw HTML source of the page, and the browser just ignores them. But the 
961  pattern matching in <SPAN
962 CLASS="APPLICATION"
963 >Privoxy's</SPAN
964 > page filtering
965  mechanism is trying to match against absurdly long strings and this becomes
966  very CPU-intensive, taking a long, long time to complete. Until a better
967  solution comes along, disable filtering on these pages, particularly the
968  <TT
969 CLASS="LITERAL"
970 >js-annoyances</TT
971 > and <TT
972 CLASS="LITERAL"
973 >unsolicited-popups</TT
974 >
975  filters.</P
976 ></DIV
977 ><DIV
978 CLASS="SECT2"
979 ><H3
980 CLASS="SECT2"
981 ><A
982 NAME="SLOWCRAWL"
983 >5.19. I just installed Privoxy, and all my
984 browsing has slowed to a crawl. What gives?</A
985 ></H3
986 ><P
987 > This should not happen, and for the overwhelming number of users world-wide,
988  it does not happen. I would suspect some inadvertent interaction of software
989  components such as anti-virus software, spyware protectors, personal
990  firewalls or similar components. Try disabling (or uninstalling) these one
991  at a time and see if that helps.</P
992 ></DIV
993 ><DIV
994 CLASS="SECT2"
995 ><H3
996 CLASS="SECT2"
997 ><A
998 NAME="PREVENTCOMP"
999 >5.20. Why do my filters work on some sites but not on others?</A
1000 ></H3
1001 ><P
1002 > It's probably due to compression. It is a common practice for web servers to
1003  send their content <SPAN
1004 CLASS="QUOTE"
1005 >"compressed"</SPAN
1006 > in order to speed things up, and
1007  then let the browser <SPAN
1008 CLASS="QUOTE"
1009 >"uncompress"</SPAN
1010 > them. When compiled with zlib support
1011  <SPAN
1012 CLASS="APPLICATION"
1013 >Privoxy</SPAN
1014 > can decompress content before filtering, otherwise you may want to enable
1015 <A
1016 HREF="../user-manual/actions-file.html#PREVENT-COMPRESSION"
1017 TARGET="_top"
1018 >prevent-compression</A
1019 >.</P
1020 ></DIV
1021 ></DIV
1022 ><DIV
1023 CLASS="NAVFOOTER"
1024 ><HR
1025 ALIGN="LEFT"
1026 WIDTH="100%"><TABLE
1027 SUMMARY="Footer navigation table"
1028 WIDTH="100%"
1029 BORDER="0"
1030 CELLPADDING="0"
1031 CELLSPACING="0"
1032 ><TR
1033 ><TD
1034 WIDTH="33%"
1035 ALIGN="left"
1036 VALIGN="top"
1037 ><A
1038 HREF="misc.html"
1039 ACCESSKEY="P"
1040 >Prev</A
1041 ></TD
1042 ><TD
1043 WIDTH="34%"
1044 ALIGN="center"
1045 VALIGN="top"
1046 ><A
1047 HREF="index.html"
1048 ACCESSKEY="H"
1049 >Home</A
1050 ></TD
1051 ><TD
1052 WIDTH="33%"
1053 ALIGN="right"
1054 VALIGN="top"
1055 ><A
1056 HREF="contact.html"
1057 ACCESSKEY="N"
1058 >Next</A
1059 ></TD
1060 ></TR
1061 ><TR
1062 ><TD
1063 WIDTH="33%"
1064 ALIGN="left"
1065 VALIGN="top"
1066 >Miscellaneous</TD
1067 ><TD
1068 WIDTH="34%"
1069 ALIGN="center"
1070 VALIGN="top"
1071 >&nbsp;</TD
1072 ><TD
1073 WIDTH="33%"
1074 ALIGN="right"
1075 VALIGN="top"
1076 >Contacting the developers, Bug Reporting and Feature Requests</TD
1077 ></TR
1078 ></TABLE
1079 ></DIV
1080 ></BODY
1081 ></HTML
1082 >