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