Just regenerating to get fresh version in place of very dated versions.
[privoxy.git] / doc / webserver / faq / general.html
1 <HTML
2 ><HEAD
3 ><TITLE
4 >General Information</TITLE
5 ><META
6 NAME="GENERATOR"
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
8 "><LINK
9 REL="HOME"
10 TITLE="Privoxy Frequently Asked Questions"
11 HREF="index.html"><LINK
12 REL="PREVIOUS"
13 TITLE="Privoxy Frequently Asked Questions"
14 HREF="index.html"><LINK
15 REL="NEXT"
16 TITLE="Installation"
17 HREF="installation.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="index.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="installation.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="GENERAL">1. General Information</H1
77 ><DIV
78 CLASS="SECT2"
79 ><H3
80 CLASS="SECT2"
81 ><A
82 NAME="NEWJB">1.1. What is this new version of <SPAN
83 CLASS="APPLICATION"
84 >Privoxy</SPAN
85 >?</H3
86 ><P
87 > In the beginning, there was the
88  <A
89 HREF="http://www.junkbusters.com/ijb.html"
90 TARGET="_top"
91 ><SPAN
92 CLASS="APPLICATION"
93 >Internet Junkbuster</SPAN
94 ></A
95 >, 
96  by Anonymous Coders and <A
97 HREF="http://www.junkbusters.com/"
98 TARGET="_top"
99 >Junkbusters
100  Corporation</A
101 >. It saved many users a lot of pain in the early days of
102  web advertising and user tracking.</P
103 ><P
104 > But the web, its protocols and standards, and with it, the techniques for
105  forcing  users to consume ads, give up autonomy over their browsing, and
106  for spying on them, kept evolving. Unfortunately, the <SPAN
107 CLASS="APPLICATION"
108 >Internet
109  Junkbuster</SPAN
110 > did not. Version 2.0.2, published in 1998, was 
111  (and is) the last official
112  <A
113 HREF="http://www.junkbusters.com/ijbdist.html#release"
114 TARGET="_top"
115 >release</A
116 >
117  available from <A
118 HREF="http://www.junkbusters.com"
119 TARGET="_top"
120 >Junkbusters Corporation</A
121 >.
122  Fortunately, it had been released under the GNU
123  <A
124 HREF="http://www.gnu.org/licenses/gpl.html"
125 TARGET="_top"
126 > GPL</A
127 >, which allowed further
128  development by others.</P
129 ><P
130 > So Stefan Waldherr started maintaining an
131  <A
132 HREF="http://www.waldherr.org/junkbuster/"
133 TARGET="_top"
134 >improved version of the
135  software</A
136 >, to which eventually a number of people contributed patches.
137  It could already replace banners with a transparent image, and had a first
138  version of pop-up killing, but it was still very closely based on the
139  original, with all its limitations, such as the lack of HTTP/1.1 support,
140  flexible per-site configuration, or content modification. The last release
141  from this effort was version 2.0.2-10, published in 2000.</P
142 ><P
143 > Then, some
144  <A
145 HREF="http://www.privoxy.org/user-manual/copyright.html#AUTHORS"
146 TARGET="_top"
147 >developers</A
148 >
149  picked up the thread, and started turning the software inside out, upside down,
150  and then reassembled it, adding many
151  <A
152 HREF="http://www.privoxy.org/user-manual/introduction.html#FEATURES"
153 TARGET="_top"
154 >new
155  features</A
156 > along the way.</P
157 ><P
158 > The result of this is <SPAN
159 CLASS="APPLICATION"
160 >Privoxy</SPAN
161 >, whose first
162  stable release, 3.0, was released August, 2002. 
163  </P
164 ></DIV
165 ><DIV
166 CLASS="SECT2"
167 ><H3
168 CLASS="SECT2"
169 ><A
170 NAME="AEN45">1.2. Why <SPAN
171 CLASS="QUOTE"
172 >"Privoxy"</SPAN
173 >? Why a name change at all?</H3
174 ><P
175 > <SPAN
176 CLASS="APPLICATION"
177 >Privoxy</SPAN
178 > is the 
179  <SPAN
180 CLASS="QUOTE"
181 >"<SPAN
182 CLASS="emphasis"
183 ><I
184 CLASS="EMPHASIS"
185 >Privacy Enhancing Proxy</I
186 ></SPAN
187 >"</SPAN
188 >. Also, its content
189  modification and junk suppression allow you to browse your
190  <SPAN
191 CLASS="QUOTE"
192 >"<SPAN
193 CLASS="emphasis"
194 ><I
195 CLASS="EMPHASIS"
196 >private</I
197 ></SPAN
198 > edition"</SPAN
199 > of the web.</P
200 ><P
201 > <A
202 HREF="http://junkbusters.com/"
203 TARGET="_top"
204 >Junkbusters Corporation</A
205 >
206  continues to offer their original version of the <SPAN
207 CLASS="APPLICATION"
208 >Internet
209  Junkbuster</SPAN
210 >, so publishing our
211  <SPAN
212 CLASS="APPLICATION"
213 > Junkbuster</SPAN
214 >-derived software under the same name
215  led to confusion.</P
216 ><P
217 > There are also potential legal complications from the continued use of the 
218  <SPAN
219 CLASS="APPLICATION"
220 >Junkbuster</SPAN
221 > name, which is a registered trademark of 
222  <A
223 HREF="http://junkbusters.com/"
224 TARGET="_top"
225 >Junkbusters Corporation</A
226 >.
227  There are, however, no objections from Junkbusters Corporation to the 
228  <SPAN
229 CLASS="APPLICATION"
230 >Privoxy</SPAN
231 > project itself, and they, in fact, still
232  share our ideals and goals.</P
233 ><P
234 > The developers also believed that there are so many changes from the original 
235  code, that it was time to make a clean break from the past and make 
236  a name in their own right, especially now with the pending
237  release of version 3.0.</P
238 ></DIV
239 ><DIV
240 CLASS="SECT2"
241 ><H3
242 CLASS="SECT2"
243 ><A
244 NAME="DIFFERS">1.3. How does <SPAN
245 CLASS="APPLICATION"
246 >Privoxy</SPAN
247 > differ
248 from the old <SPAN
249 CLASS="APPLICATION"
250 >Junkbuster?</SPAN
251 ></H3
252 ><P
253 > <SPAN
254 CLASS="APPLICATION"
255 >Privoxy</SPAN
256 > picks up where
257  <SPAN
258 CLASS="APPLICATION"
259 >Junkbuster</SPAN
260 > left off. All the old features remain.
261  The new <SPAN
262 CLASS="APPLICATION"
263 >Privoxy</SPAN
264 > still blocks ads and banners,
265  still manages cookies, and still helps protect your privacy. But, these are
266  all enhanced, and many new features have been added, all in the same vein.
267  </P
268 ><P
269 > The configuration has changed significantly as well. This is something that
270  users will notice right off the bat if upgrading from 
271  <SPAN
272 CLASS="APPLICATION"
273 >Junkbuster</SPAN
274 > 2.0.x. The <SPAN
275 CLASS="QUOTE"
276 >"blocklist"</SPAN
277 >
278  <SPAN
279 CLASS="QUOTE"
280 >"cookielist"</SPAN
281 >, <SPAN
282 CLASS="QUOTE"
283 >"imagelist"</SPAN
284 > and much more has been
285  combined into the <SPAN
286 CLASS="QUOTE"
287 >"actions"</SPAN
288 > files, with a completely different
289  syntax. See the <A
290 HREF="../user-manual/upgradersnote.html"
291 TARGET="_top"
292 >note to
293  upgraders</A
294 > for  details.</P
295 ><P
296 > <SPAN
297 CLASS="APPLICATION"
298 >Privoxy</SPAN
299 >'s new features include:</P
300 ><P
301 > <P
302 ></P
303 ><UL
304 ><LI
305 ><P
306 >   Integrated browser based configuration and control utility at <A
307 HREF="http://config.privoxy.org/"
308 TARGET="_top"
309 >http://config.privoxy.org/</A
310 >
311    (shortcut: <A
312 HREF="http://p.p/"
313 TARGET="_top"
314 >http://p.p/</A
315 >). Browser-based
316    tracing of rule and filter effects. Remote toggling.
317   </P
318 ></LI
319 ><LI
320 ><P
321 >   Web page content filtering (removes banners based on size,
322    invisible <SPAN
323 CLASS="QUOTE"
324 >"web-bugs"</SPAN
325 >, JavaScript and HTML annoyances, pop-up windows, etc.)
326   </P
327 ></LI
328 ><LI
329 ><P
330 >   Modularized configuration that allows for standard settings and
331    user settings to reside in separate files, so that installing updated
332    actions files won't overwrite individual user settings.
333   </P
334 ></LI
335 ><LI
336 ><P
337 >   HTTP/1.1 compliant (but not all optional 1.1 features are supported).
338   </P
339 ></LI
340 ><LI
341 ><P
342 >   Support for Perl Compatible Regular Expressions in the configuration files, and 
343    generally a more sophisticated and flexible configuration syntax over
344    previous versions.
345   </P
346 ></LI
347 ><LI
348 ><P
349 >   Improved cookie management features (e.g. session based cookies).
350   </P
351 ></LI
352 ><LI
353 ><P
354 >   GIF de-animation. 
355   </P
356 ></LI
357 ><LI
358 ><P
359 >   Bypass many click-tracking scripts (avoids script redirection).
360   </P
361 ></LI
362 ><LI
363 ><P
364 >   Multi-threaded (POSIX and native threads).
365   </P
366 ></LI
367 ><LI
368 ><P
369 >   User-customizable HTML templates for all proxy-generated pages (e.g. "blocked" page).
370   </P
371 ></LI
372 ><LI
373 ><P
374 >   Auto-detection and re-reading of config file changes.
375   </P
376 ></LI
377 ><LI
378 ><P
379 >   Improved signal handling, and a true daemon mode (Unix).
380   </P
381 ></LI
382 ><LI
383 ><P
384 >   Every feature now controllable on a per-site or per-location basis, configuration
385    more powerful and versatile over-all.
386   </P
387 ></LI
388 ><LI
389 ><P
390 >   Many smaller new features added, limitations and bugs removed, and security holes fixed.
391   </P
392 ></LI
393 ></UL
394 ></P
395 ></DIV
396 ><DIV
397 CLASS="SECT2"
398 ><H3
399 CLASS="SECT2"
400 ><A
401 NAME="PROXYMORON">1.4. What is a <SPAN
402 CLASS="QUOTE"
403 >"proxy"</SPAN
404 >? How does
405 <SPAN
406 CLASS="APPLICATION"
407 >Privoxy</SPAN
408 > work?</H3
409 ><P
410 >  A web proxy is a service, based on a software such as <SPAN
411 CLASS="APPLICATION"
412 >Privoxy</SPAN
413 >,
414   that clients (i.e. browsers) can use instead of connecting directly to the web
415   servers on the Internet. The clients then ask the proxy to fetch the objects
416   they need (web pages, images, movies etc) on their behalf, and when the proxy
417   has done so, it hands the results back to the client.
418  </P
419 ><P
420 >  There are many reasons to use web proxies, such as security (firewalling),
421   efficiency (caching) and others, and there are just as many different proxies
422   to accommodate those needs.
423  </P
424 ><P
425 >  <SPAN
426 CLASS="APPLICATION"
427 >Privoxy</SPAN
428 > is a proxy that is solely focused on privacy
429   protection and junk elimination. Sitting between your browser(s) and the Internet,
430   it is in a perfect position to filter outbound personal information that your
431   browser is leaking, as well as inbound junk. It uses a variety of techniques to do
432   this, all of which are under your control via the various configuration
433   files and options.
434  </P
435 ></DIV
436 ><DIV
437 CLASS="SECT2"
438 ><H3
439 CLASS="SECT2"
440 ><A
441 NAME="WHATSANAD">1.5. How does <SPAN
442 CLASS="APPLICATION"
443 >Privoxy</SPAN
444 > know what is
445 an ad, and what is not?</H3
446 ><P
447 > <SPAN
448 CLASS="APPLICATION"
449 >Privoxy</SPAN
450 >'s approach to blocking ads is twofold:</P
451 ><P
452 > First, there are certain patterns in the <SPAN
453 CLASS="emphasis"
454 ><I
455 CLASS="EMPHASIS"
456 >locations</I
457 ></SPAN
458 > (URLs)
459  of banner images. This applies to both the path (you wouldn't guess how many
460  web sites serve their banners from a directory called <SPAN
461 CLASS="QUOTE"
462 >"banners"</SPAN
463 >!)
464  and the host (blocking the big banner hosting services like doublecklick.net
465  already helps a lot). <SPAN
466 CLASS="APPLICATION"
467 >Privoxy</SPAN
468 > takes advantage of this
469  fact by using <A
470 HREF="../user-manual/actions-file.html#AF-PATTERNS"
471 TARGET="_top"
472 >URL
473  patterns</A
474 > to sort out and block the requests for banners.</P
475 ><P
476 > Second, banners tend to come in certain <SPAN
477 CLASS="emphasis"
478 ><I
479 CLASS="EMPHASIS"
480 >sizes</I
481 ></SPAN
482 >. But you
483  can't tell the size of an image by its URL without downloading it, and if you
484  do, it's too late to save bandwidth. Therefore, <SPAN
485 CLASS="APPLICATION"
486 >Privoxy</SPAN
487 >
488  also inspects the HTML sources of web pages while they are loaded, and replaces
489  references to images with standard banner sizes by dummy references, so that
490  your browser doesn't request them anymore in the first place.</P
491 ><P
492 > Both of this involves a certain amount of guesswork and is, of course, freely
493  configurable.</P
494 ></DIV
495 ><DIV
496 CLASS="SECT2"
497 ><H3
498 CLASS="SECT2"
499 ><A
500 NAME="AEN136">1.6. Can <SPAN
501 CLASS="APPLICATION"
502 >Privoxy</SPAN
503 > make mistakes? 
504 This does not sound very scientific.</H3
505 ><P
506 > Actually, it's a black art ;-) And yes, it is always possible to have a broad
507  rule accidentally block or change something by mistake. There is a good chance
508  you may run into such a situation at some point. It is tricky writing rules to
509  cover every conceivable possibility, and not occasionally get false positives.</P
510 ><P
511 > But this should not be a big concern since the
512  <SPAN
513 CLASS="APPLICATION"
514 >Privoxy</SPAN
515 > configuration is very flexible, and
516  includes tools to help identify these types of situations so they can be
517  addressed as needed, allowing you to customize your installation.
518  (<A
519 HREF="trouble.html#BADSITE"
520 >See the Troubleshooting section below</A
521 >.)</P
522 ></DIV
523 ><DIV
524 CLASS="SECT2"
525 ><H3
526 CLASS="SECT2"
527 ><A
528 NAME="BROWSERS2">1.7. My browser does the same things as
529 <SPAN
530 CLASS="APPLICATION"
531 >Privoxy</SPAN
532 >. Why should I use
533 <SPAN
534 CLASS="APPLICATION"
535 >Privoxy</SPAN
536 > at all?</H3
537 ><P
538 >  Modern browsers do indeed have <SPAN
539 CLASS="emphasis"
540 ><I
541 CLASS="EMPHASIS"
542 >some</I
543 ></SPAN
544 > of the same
545   functionality as <SPAN
546 CLASS="APPLICATION"
547 >Privoxy</SPAN
548 >. Maybe this is
549   adequate for you. But <SPAN
550 CLASS="APPLICATION"
551 >Privoxy</SPAN
552 > is much more
553   versatile and powerful, and can do a number of things that browsers just can't.
554  </P
555 ><P
556 >  In addition, a proxy is good choice if you use multiple browsers, or 
557   have a LAN with multiple computers. This way all the configuration 
558   is in one place, and you don't have to maintain a similar configuration 
559   for possibly many browsers.
560  </P
561 ></DIV
562 ><DIV
563 CLASS="SECT2"
564 ><H3
565 CLASS="SECT2"
566 ><A
567 NAME="LICENSE">1.8. Is there is a license or fee? What about a 
568 warranty? Registration?</H3
569 ><P
570 >  <SPAN
571 CLASS="APPLICATION"
572 >Privoxy</SPAN
573 > is licensed under the <A
574 HREF="http://www.gnu.org/copyleft/gpl.html"
575 TARGET="_top"
576 >GNU General Public License (GPL)</A
577 >.
578   It is free to use, copy, modify or distribute as you wish under the terms of this
579   license.  Please see the <A
580 HREF="copyright.html"
581 >Copyright</A
582 > section for more
583   information on the license and copyright. Or the <TT
584 CLASS="FILENAME"
585 >LICENSE</TT
586 > file 
587   that should be included.
588  </P
589 ><P
590 >  There is <SPAN
591 CLASS="emphasis"
592 ><I
593 CLASS="EMPHASIS"
594 >no warranty</I
595 ></SPAN
596 > of any kind, expressed, implied or otherwise.
597   That is something that would cost real money ;-) There is no registration either.
598   <SPAN
599 CLASS="APPLICATION"
600 >Privoxy</SPAN
601 > really is <SPAN
602 CLASS="emphasis"
603 ><I
604 CLASS="EMPHASIS"
605 >free</I
606 ></SPAN
607 >
608   in every respect!
609  </P
610 ></DIV
611 ><DIV
612 CLASS="SECT2"
613 ><H3
614 CLASS="SECT2"
615 ><A
616 NAME="JOINTEAM">1.9. I would like to help you, what do I do?</H3
617 ><DIV
618 CLASS="SECT3"
619 ><H4
620 CLASS="SECT3"
621 ><A
622 NAME="JOINTEAM-MONEY">1.9.1. Money Money Money</H4
623 ><P
624 > We, of course, welcome donations and could use money for domain registering,
625  buying software to test <SPAN
626 CLASS="APPLICATION"
627 >Privoxy</SPAN
628 > with, and, of course,
629  for regular world-wide get-togethers (hahaha). If you enjoy the software and feel
630  like helping us with a donation, just <A
631 HREF="mailto:developers@privoxy.org"
632 TARGET="_top"
633 >drop us a note</A
634 >.</P
635 ></DIV
636 ><DIV
637 CLASS="SECT3"
638 ><H4
639 CLASS="SECT3"
640 ><A
641 NAME="JOINTEAM-SOFTWARE">1.9.2. Software</H4
642 ><P
643 > If you are a vendor of a web-related software like a browser, web server
644  or proxy, and would like us to ensure that <SPAN
645 CLASS="APPLICATION"
646 >Privoxy</SPAN
647 >
648  runs smoothly with your product, you might consider supplying us with a
649  copy or license. We can't, however, guarantee that we will fix all potential
650  compatibility issues as a result.</P
651 ></DIV
652 ><DIV
653 CLASS="SECT3"
654 ><H4
655 CLASS="SECT3"
656 ><A
657 NAME="JOINTEAM-WORK">1.9.3. You want to work with us?</H4
658 ><P
659 >   Well, helping the team is always a good idea. We welcome new developers,
660    packaging gurus or documentation writers. Simply <A
661 HREF="https://sourceforge.net/account/register.php"
662 TARGET="_top"
663 >get an account on SourceForge.net</A
664 >
665    and mail your id to the <A
666 HREF="mailto:developers@privoxy.org"
667 TARGET="_top"
668 >developers
669    mailing list</A
670 >. Then read the <A
671 HREF="../developer-manual/index.html"
672 TARGET="_top"
673 >Developer's Manual</A
674 >.</P
675 ><P
676 > Once we have added you to the team, you'll have write access to the <A
677 HREF="http://sourceforge.net/cvs/?group_id=11118"
678 TARGET="_top"
679 >CVS repository</A
680 >, and
681  together we'll find a suitable task for you.</P
682 ></DIV
683 ></DIV
684 ></DIV
685 ><DIV
686 CLASS="NAVFOOTER"
687 ><HR
688 ALIGN="LEFT"
689 WIDTH="100%"><TABLE
690 SUMMARY="Footer navigation table"
691 WIDTH="100%"
692 BORDER="0"
693 CELLPADDING="0"
694 CELLSPACING="0"
695 ><TR
696 ><TD
697 WIDTH="33%"
698 ALIGN="left"
699 VALIGN="top"
700 ><A
701 HREF="index.html"
702 ACCESSKEY="P"
703 >Prev</A
704 ></TD
705 ><TD
706 WIDTH="34%"
707 ALIGN="center"
708 VALIGN="top"
709 ><A
710 HREF="index.html"
711 ACCESSKEY="H"
712 >Home</A
713 ></TD
714 ><TD
715 WIDTH="33%"
716 ALIGN="right"
717 VALIGN="top"
718 ><A
719 HREF="installation.html"
720 ACCESSKEY="N"
721 >Next</A
722 ></TD
723 ></TR
724 ><TR
725 ><TD
726 WIDTH="33%"
727 ALIGN="left"
728 VALIGN="top"
729 >Privoxy Frequently Asked Questions</TD
730 ><TD
731 WIDTH="34%"
732 ALIGN="center"
733 VALIGN="top"
734 >&nbsp;</TD
735 ><TD
736 WIDTH="33%"
737 ALIGN="right"
738 VALIGN="top"
739 >Installation</TD
740 ></TR
741 ></TABLE
742 ></DIV
743 ></BODY
744 ></HTML
745 >