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