Sync with recent changes.
[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="MACOSXIE"
512 >5.7. In Mac OS X, 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="MACOSXUNINSTALL"
537 >5.8. In Mac OS X, 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 > Note: This ONLY applies to privoxy 3.0.6 and earlier.
543  </P
544 ><P
545 >  Just dragging the <SPAN
546 CLASS="APPLICATION"
547 >Privoxy</SPAN
548 > folder to the trash is
549   not enough to delete it. <SPAN
550 CLASS="APPLICATION"
551 >Privoxy</SPAN
552 > supplies an
553   <SPAN
554 CLASS="APPLICATION"
555 >uninstall.command</SPAN
556 > file that takes care of
557   these details. Open the trash, drag the <SPAN
558 CLASS="APPLICATION"
559 >uninstall.command</SPAN
560 >
561   file out of the trash and double-click on it. You will be prompted for
562   confirmation and the administration password.
563  </P
564 ><P
565 >  The trash may still appear full after this command; emptying the trash 
566   from the desktop should make it appear empty again.
567  </P
568 ></DIV
569 ><DIV
570 CLASS="SECT2"
571 ><H3
572 CLASS="SECT2"
573 ><A
574 NAME="MACOSXIMAGES"
575 >5.9. In Mac OS X Panther (10.3), images often fail to load and/or I
576  experience random delays in page loading. I'm using
577  <TT
578 CLASS="LITERAL"
579 >localhost</TT
580 > as my browser's proxy setting.</A
581 ></H3
582 ><P
583 >  We believe this is due to an IPv6-related bug in Mac OS X, but don't fully
584   understand the issue yet. In any case, changing the proxy setting to 
585   <TT
586 CLASS="LITERAL"
587 >127.0.0.1</TT
588 > instead of <TT
589 CLASS="LITERAL"
590 >localhost</TT
591 >
592   works around the problem.
593  </P
594 ></DIV
595 ><DIV
596 CLASS="SECT2"
597 ><H3
598 CLASS="SECT2"
599 ><A
600 NAME="BLANKPAGE"
601 >5.10. I get a completely blank page at one site. <SPAN
602 CLASS="QUOTE"
603 >"View Source"</SPAN
604 >
605  shows only: <SPAN
606 CLASS="MARKUP"
607 >&#60;html&#62;&#60;body&#62;&#60;/body&#62;&#60;/html&#62;</SPAN
608 >. Without
609  Privoxy the page loads fine.</A
610 ></H3
611 ><P
612 >  Chances are that the site suffers from a bug in
613   <A
614 HREF="http://www.php.net/"
615 TARGET="_top"
616 ><SPAN
617 CLASS="APPLICATION"
618 >PHP</SPAN
619 ></A
620 >,
621   which results in empty pages being sent if the client explicitly requests
622   an uncompressed page, like <SPAN
623 CLASS="APPLICATION"
624 >Privoxy</SPAN
625 > does.
626   This bug has been fixed in PHP 4.2.3.
627  </P
628 ><P
629 >  To find out if this is in fact the source of the problem, try adding
630   the site to a <TT
631 CLASS="LITERAL"
632 >-prevent-compression</TT
633 > section in
634   <TT
635 CLASS="FILENAME"
636 >user.action</TT
637 >:
638  </P
639 ><TABLE
640 BORDER="0"
641 BGCOLOR="#E0E0E0"
642 WIDTH="100%"
643 ><TR
644 ><TD
645 ><PRE
646 CLASS="SCREEN"
647 >   # Make exceptions for ill-behaved sites:                                     
648    #                                                                    
649    {-prevent-compression}                                               
650     .example.com</PRE
651 ></TD
652 ></TR
653 ></TABLE
654 ><P
655 >  If that works, you may also want to report the problem to the
656   site's webmasters, telling them to use zlib.output_compression
657   instead of ob_gzhandler in their PHP applications (workaround)
658   or upgrade to PHP 4.2.3 or later (fix).
659  </P
660 ></DIV
661 ><DIV
662 CLASS="SECT2"
663 ><H3
664 CLASS="SECT2"
665 ><A
666 NAME="NOHOSTNAME"
667 >5.11. My logs show many <SPAN
668 CLASS="QUOTE"
669 >"Unable to get my own hostname"</SPAN
670 > lines.
671 Why?</A
672 ></H3
673 ><P
674 > <SPAN
675 CLASS="APPLICATION"
676 >Privoxy</SPAN
677 > tries to get the hostname of the system
678  its running on from the IP address of the system interface it is bound to
679  (from the <TT
680 CLASS="FILENAME"
681 >config</TT
682 > file
683  <SPAN
684 CLASS="emphasis"
685 ><I
686 CLASS="EMPHASIS"
687 >listen-address</I
688 ></SPAN
689 > setting). If the system cannot supply
690  this information, <SPAN
691 CLASS="APPLICATION"
692 >Privoxy</SPAN
693 > logs this condition. </P
694 ><P
695 > Typically, this would be considered a minor system configuration error. It is
696  not a fatal error to <SPAN
697 CLASS="APPLICATION"
698 >Privoxy</SPAN
699 > however, but may
700  result in a much slower response from <SPAN
701 CLASS="APPLICATION"
702 >Privoxy</SPAN
703 > on
704  some platforms due to DNS timeouts.</P
705 ><P
706 > This can be caused by a problem with the local <TT
707 CLASS="FILENAME"
708 >HOSTS</TT
709 >
710  file. If this file has been changed from the original, try reverting it to
711  see if that helps. Make sure whatever name(s) are used for the local system,
712  that they resolve both ways.</P
713 ><P
714 > You should also be able to work around the problem with the
715  <A
716 HREF="../user-manual/config.html#HOSTNAME"
717 TARGET="_top"
718 >hostname option</A
719 >.</P
720 ></DIV
721 ><DIV
722 CLASS="SECT2"
723 ><H3
724 CLASS="SECT2"
725 ><A
726 NAME="INUSE"
727 >5.12. When I try to launch Privoxy, I get an 
728 error message <SPAN
729 CLASS="QUOTE"
730 >"port 8118 is already in use"</SPAN
731 > (or similar wording).
732 Why?</A
733 ></H3
734 ><P
735 > Port 8118 is <SPAN
736 CLASS="APPLICATION"
737 >Privoxy's</SPAN
738 > default TCP 
739  <SPAN
740 CLASS="QUOTE"
741 >"listening"</SPAN
742 > port. Typically this message would mean that there
743  is already one instance of <SPAN
744 CLASS="APPLICATION"
745 >Privoxy</SPAN
746 > running, and
747  your system is actually trying to start a second
748  <SPAN
749 CLASS="APPLICATION"
750 >Privoxy</SPAN
751 > on the same port, which will not work.
752  (You can have multiple instances but they must be assigned different ports.)
753  How and why this might happen varies from platform to platform, but you need
754  to check your installation and start-up procedures.</P
755 ></DIV
756 ><DIV
757 CLASS="SECT2"
758 ><H3
759 CLASS="SECT2"
760 ><A
761 NAME="DEMORONIZER"
762 >5.13. Pages with UTF-8 fonts are garbled.</A
763 ></H3
764 ><P
765 > This is caused by the <SPAN
766 CLASS="QUOTE"
767 >"demoronizer"</SPAN
768 > filter. You should either
769  upgrade <SPAN
770 CLASS="APPLICATION"
771 >Privoxy</SPAN
772 >, or at least upgrade to the most
773  recent <TT
774 CLASS="FILENAME"
775 >default.action</TT
776 > file available from <A
777 HREF="http://sourceforge.net/project/showfiles.php?group_id=11118"
778 TARGET="_top"
779 >SourceForge</A
780 >.
781  Or you can simply disable the demoronizer filter.</P
782 ></DIV
783 ><DIV
784 CLASS="SECT2"
785 ><H3
786 CLASS="SECT2"
787 ><A
788 NAME="DEMORONIZER2"
789 >5.14. Why are binary files (such as images) corrupted when Privoxy
790  is used?</A
791 ></H3
792 ><P
793 > This may also be caused by the <SPAN
794 CLASS="QUOTE"
795 >"demoronizer"</SPAN
796 > filter, 
797  in conjunction with a web server that is misreporting the content type. Binary 
798  files are exempted from <SPAN
799 CLASS="APPLICATION"
800 >Privoxy's</SPAN
801 > filtering
802  (unless the web server by mistake says the file is something else). Either
803  upgrade <SPAN
804 CLASS="APPLICATION"
805 >Privoxy</SPAN
806 >, or go to the most recent
807  <TT
808 CLASS="FILENAME"
809 >default.action</TT
810 > file available from <A
811 HREF="http://sourceforge.net/project/showfiles.php?group_id=11118"
812 TARGET="_top"
813 >SourceForge</A
814 >.</P
815 ></DIV
816 ><DIV
817 CLASS="SECT2"
818 ><H3
819 CLASS="SECT2"
820 ><A
821 NAME="DEMORONIZER3"
822 >5.15. What is the <SPAN
823 CLASS="QUOTE"
824 >"demoronizer"</SPAN
825 > and why is it there?</A
826 ></H3
827 ><P
828 > The original demoronizer was a Perl script that cleaned up HTML pages which 
829  were created with certain Microsoft products. MS has used proprietary extensions 
830  to standardized font encodings (ISO 8859-1), which has caused problems for pages
831  that are viewed with non-Microsoft products (and are expecting to see a
832  standard set of fonts). The demoronizer corrected these errors so the pages
833  displayed correctly. <SPAN
834 CLASS="APPLICATION"
835 >Privoxy</SPAN
836 > borrowed from this
837  script, introducing a filter based on the original demoronizer, which in turn could
838  correct these errors on the fly. </P
839 ><P
840 > But this is only needed in some situations, and will cause serious problems in some 
841  other situations.</P
842 ><P
843 > If you are using Microsoft products, you do not need it. If you need to view 
844  pages with UTF-8 characters (such as Cyrillic or Chinese), then it will 
845  cause corruption of the fonts, and thus <SPAN
846 CLASS="emphasis"
847 ><I
848 CLASS="EMPHASIS"
849 >should not be on</I
850 ></SPAN
851 >.</P
852 ><P
853 > On the other hand, if you use non-Microsoft products, and you occasionally 
854  notice weird characters on pages, you might want to try it.</P
855 ></DIV
856 ><DIV
857 CLASS="SECT2"
858 ><H3
859 CLASS="SECT2"
860 ><A
861 NAME="WINDOWOPEN"
862 >5.16. Why do I keep seeing <SPAN
863 CLASS="QUOTE"
864 >"PrivoxyWindowOpen()"</SPAN
865 > in raw source code?</A
866 ></H3
867 ><P
868 > <SPAN
869 CLASS="APPLICATION"
870 >Privoxy</SPAN
871 > is attempting to disable malicious 
872   <A
873 HREF="http://en.wikipedia.org/wiki/Javascript"
874 TARGET="_top"
875 >Javascript</A
876
877   in this case, with the <TT
878 CLASS="LITERAL"
879 >unsolicited-popups</TT
880 >
881  filter. <SPAN
882 CLASS="APPLICATION"
883 >Privoxy</SPAN
884 > cannot tell very well 
885  <SPAN
886 CLASS="QUOTE"
887 >"good"</SPAN
888 > code snippets from <SPAN
889 CLASS="QUOTE"
890 >"bad"</SPAN
891 > code snippets.</P
892 ><P
893 > If you see this in HTML source, and the page displays without problems, then 
894  this is good, and likely some pop-up window was disabled. If you see this 
895  where it is causing a problem, such as a downloaded program source code file, 
896  then you should set an exception for this site or page such that the
897  integrity of the page stays in tact by disabling all filtering.</P
898 ></DIV
899 ><DIV
900 CLASS="SECT2"
901 ><H3
902 CLASS="SECT2"
903 ><A
904 NAME="DNSERRORS"
905 >5.17. I am getting too many DNS errors like <SPAN
906 CLASS="QUOTE"
907 >"404 No Such Domain"</SPAN
908 >. Why
909  can't Privoxy do this better?</A
910 ></H3
911 ><P
912 > There are potentially several factors here. First of all, the DNS resolution
913  is done by the underlying operating system -- not
914  <SPAN
915 CLASS="APPLICATION"
916 >Privoxy</SPAN
917 > itself. <SPAN
918 CLASS="APPLICATION"
919 >Privoxy</SPAN
920 >
921  merely initiates the process and hands it off, and then later reports
922  whatever the outcome was and tries to give a coherent message if there seems
923  to be a problem. In some cases, this might otherwise be mitigated by the
924  browser itself which might try some work-arounds and alternate approaches (e.g
925  adding <SPAN
926 CLASS="QUOTE"
927 >"www."</SPAN
928 > to the URL).</P
929 ><P
930 > In other cases, if <SPAN
931 CLASS="APPLICATION"
932 >Privoxy</SPAN
933 > is being chained
934  with another proxy, this could complicate the issue, and cause undue
935  delays and timeouts. In the case of a <SPAN
936 CLASS="QUOTE"
937 >"socks4a"</SPAN
938 > proxy, the socks
939  server handles all the DNS.  <SPAN
940 CLASS="APPLICATION"
941 >Privoxy</SPAN
942 > would just be
943  the <SPAN
944 CLASS="QUOTE"
945 >"messenger"</SPAN
946 > which is reporting whatever problem occurred
947  downstream, and not the root cause of the error.</P
948 ><P
949 > In any case, versions newer than 3.0.3 include various improvements to help
950  <SPAN
951 CLASS="APPLICATION"
952 >Privoxy</SPAN
953 > better handle these cases.</P
954 ></DIV
955 ><DIV
956 CLASS="SECT2"
957 ><H3
958 CLASS="SECT2"
959 ><A
960 NAME="ALLCPU"
961 >5.18. At one site Privoxy just hangs, and starts taking 
962  all CPU. Why is this?</A
963 ></H3
964 ><P
965 > This is probably a manifestation of the <SPAN
966 CLASS="QUOTE"
967 >"100% cpu"</SPAN
968 > problem that
969  occurs on pages containing many (thousands upon thousands) of blank lines. The blank lines 
970  are in the raw HTML source of the page, and the browser just ignores them. But the 
971  pattern matching in <SPAN
972 CLASS="APPLICATION"
973 >Privoxy's</SPAN
974 > page filtering
975  mechanism is trying to match against absurdly long strings and this becomes
976  very CPU-intensive, taking a long, long time to complete.</P
977 ><P
978 > Until a better solution comes along, disable filtering on these pages,
979  particularly the <TT
980 CLASS="LITERAL"
981 >js-annoyances</TT
982 > and
983  <TT
984 CLASS="LITERAL"
985 >unsolicited-popups</TT
986 > filters. If you run into this problem
987  with a recent <SPAN
988 CLASS="APPLICATION"
989 >Privoxy</SPAN
990 > version, please send a problem report.</P
991 ></DIV
992 ><DIV
993 CLASS="SECT2"
994 ><H3
995 CLASS="SECT2"
996 ><A
997 NAME="SLOWCRAWL"
998 >5.19. I just installed Privoxy, and all my
999 browsing has slowed to a crawl. What gives?</A
1000 ></H3
1001 ><P
1002 > This should not happen, and for the overwhelming number of users world-wide,
1003  it does not happen. I would suspect some inadvertent interaction of software
1004  components such as anti-virus software, spyware protectors, personal
1005  firewalls or similar components. Try disabling (or uninstalling) these one
1006  at a time and see if that helps. Either way, if you are using a
1007  recent <SPAN
1008 CLASS="APPLICATION"
1009 >Privoxy</SPAN
1010 > version, please report the problem.</P
1011 ></DIV
1012 ><DIV
1013 CLASS="SECT2"
1014 ><H3
1015 CLASS="SECT2"
1016 ><A
1017 NAME="PREVENTCOMP"
1018 >5.20. Why do my filters work on some sites but not on others?</A
1019 ></H3
1020 ><P
1021 > It's probably due to compression. It is a common practice for web servers to
1022  send their content <SPAN
1023 CLASS="QUOTE"
1024 >"compressed"</SPAN
1025 > in order to speed things up, and
1026  then let the browser <SPAN
1027 CLASS="QUOTE"
1028 >"uncompress"</SPAN
1029 > them. When compiled with zlib support
1030  <SPAN
1031 CLASS="APPLICATION"
1032 >Privoxy</SPAN
1033 > can decompress content before filtering, otherwise you may want to enable
1034 <A
1035 HREF="../user-manual/actions-file.html#PREVENT-COMPRESSION"
1036 TARGET="_top"
1037 >prevent-compression</A
1038 >.</P
1039 ></DIV
1040 ></DIV
1041 ><DIV
1042 CLASS="NAVFOOTER"
1043 ><HR
1044 ALIGN="LEFT"
1045 WIDTH="100%"><TABLE
1046 SUMMARY="Footer navigation table"
1047 WIDTH="100%"
1048 BORDER="0"
1049 CELLPADDING="0"
1050 CELLSPACING="0"
1051 ><TR
1052 ><TD
1053 WIDTH="33%"
1054 ALIGN="left"
1055 VALIGN="top"
1056 ><A
1057 HREF="misc.html"
1058 ACCESSKEY="P"
1059 >Prev</A
1060 ></TD
1061 ><TD
1062 WIDTH="34%"
1063 ALIGN="center"
1064 VALIGN="top"
1065 ><A
1066 HREF="index.html"
1067 ACCESSKEY="H"
1068 >Home</A
1069 ></TD
1070 ><TD
1071 WIDTH="33%"
1072 ALIGN="right"
1073 VALIGN="top"
1074 ><A
1075 HREF="contact.html"
1076 ACCESSKEY="N"
1077 >Next</A
1078 ></TD
1079 ></TR
1080 ><TR
1081 ><TD
1082 WIDTH="33%"
1083 ALIGN="left"
1084 VALIGN="top"
1085 >Miscellaneous</TD
1086 ><TD
1087 WIDTH="34%"
1088 ALIGN="center"
1089 VALIGN="top"
1090 >&nbsp;</TD
1091 ><TD
1092 WIDTH="33%"
1093 ALIGN="right"
1094 VALIGN="top"
1095 >Contacting the developers, Bug Reporting and Feature Requests</TD
1096 ></TR
1097 ></TABLE
1098 ></DIV
1099 ></BODY
1100 ></HTML
1101 >