Synthetic commit for tag v_3_0_1
[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.</P
237 ></DIV
238 ><DIV
239 CLASS="SECT2"
240 ><H3
241 CLASS="SECT2"
242 ><A
243 NAME="DIFFERS">1.3. How does <SPAN
244 CLASS="APPLICATION"
245 >Privoxy</SPAN
246 > differ
247 from the old <SPAN
248 CLASS="APPLICATION"
249 >Junkbuster?</SPAN
250 ></H3
251 ><P
252 > <SPAN
253 CLASS="APPLICATION"
254 >Privoxy</SPAN
255 > picks up where
256  <SPAN
257 CLASS="APPLICATION"
258 >Junkbuster</SPAN
259 > left off. All the old features remain.
260  The new <SPAN
261 CLASS="APPLICATION"
262 >Privoxy</SPAN
263 > still blocks ads and banners,
264  still manages cookies, and still helps protect your privacy. But, these are
265  all enhanced, and many new features have been added, all in the same vein.
266  </P
267 ><P
268 > The configuration has changed significantly as well. This is something that
269  users will notice right off the bat if upgrading from 
270  <SPAN
271 CLASS="APPLICATION"
272 >Junkbuster</SPAN
273 > 2.0.x. The <SPAN
274 CLASS="QUOTE"
275 >"blocklist"</SPAN
276 >
277  <SPAN
278 CLASS="QUOTE"
279 >"cookielist"</SPAN
280 >, <SPAN
281 CLASS="QUOTE"
282 >"imagelist"</SPAN
283 > and much more has been
284  combined into the <SPAN
285 CLASS="QUOTE"
286 >"actions"</SPAN
287 > files, with a completely different
288  syntax. See the <A
289 HREF="../user-manual/upgradersnote.html"
290 TARGET="_top"
291 >note to
292  upgraders</A
293 > for  details.</P
294 ><P
295 > <SPAN
296 CLASS="APPLICATION"
297 >Privoxy</SPAN
298 >'s new features include:</P
299 ><P
300 > <P
301 ></P
302 ><UL
303 ><LI
304 ><P
305 >   Integrated browser based configuration and control utility at <A
306 HREF="http://config.privoxy.org/"
307 TARGET="_top"
308 >http://config.privoxy.org/</A
309 >
310    (shortcut: <A
311 HREF="http://p.p/"
312 TARGET="_top"
313 >http://p.p/</A
314 >). Browser-based
315    tracing of rule and filter effects. Remote toggling.
316   </P
317 ></LI
318 ><LI
319 ><P
320 >   Web page content filtering (removes banners based on size,
321    invisible <SPAN
322 CLASS="QUOTE"
323 >"web-bugs"</SPAN
324 >, JavaScript and HTML annoyances, pop-up windows, etc.)
325   </P
326 ></LI
327 ><LI
328 ><P
329 >   Modularized configuration that allows for standard settings and
330    user settings to reside in separate files, so that installing updated
331    actions files won't overwrite individual user settings.
332   </P
333 ></LI
334 ><LI
335 ><P
336 >   HTTP/1.1 compliant (but not all optional 1.1 features are supported).
337   </P
338 ></LI
339 ><LI
340 ><P
341 >   Support for Perl Compatible Regular Expressions in the configuration files, and 
342    generally a more sophisticated and flexible configuration syntax over
343    previous versions.
344   </P
345 ></LI
346 ><LI
347 ><P
348 >   Improved cookie management features (e.g. session based cookies).
349   </P
350 ></LI
351 ><LI
352 ><P
353 >   GIF de-animation. 
354   </P
355 ></LI
356 ><LI
357 ><P
358 >   Bypass many click-tracking scripts (avoids script redirection).
359   </P
360 ></LI
361 ><LI
362 ><P
363 >   Multi-threaded (POSIX and native threads).
364   </P
365 ></LI
366 ><LI
367 ><P
368 >   User-customizable HTML templates for all proxy-generated pages (e.g. "blocked" page).
369   </P
370 ></LI
371 ><LI
372 ><P
373 >   Auto-detection and re-reading of config file changes.
374   </P
375 ></LI
376 ><LI
377 ><P
378 >   Improved signal handling, and a true daemon mode (Unix).
379   </P
380 ></LI
381 ><LI
382 ><P
383 >   Every feature now controllable on a per-site or per-location basis, configuration
384    more powerful and versatile over-all.
385   </P
386 ></LI
387 ><LI
388 ><P
389 >   Many smaller new features added, limitations and bugs removed, and security holes fixed.
390   </P
391 ></LI
392 ></UL
393 ></P
394 ></DIV
395 ><DIV
396 CLASS="SECT2"
397 ><H3
398 CLASS="SECT2"
399 ><A
400 NAME="PROXYMORON">1.4. What is a <SPAN
401 CLASS="QUOTE"
402 >"proxy"</SPAN
403 >? How does
404 <SPAN
405 CLASS="APPLICATION"
406 >Privoxy</SPAN
407 > work?</H3
408 ><P
409 >  A web proxy is a service, based on a software such as <SPAN
410 CLASS="APPLICATION"
411 >Privoxy</SPAN
412 >,
413   that clients (i.e. browsers) can use instead of connecting directly to the web
414   servers on the Internet. The clients then ask the proxy to fetch the objects
415   they need (web pages, images, movies etc) on their behalf, and when the proxy
416   has done so, it hands the results back to the client.
417  </P
418 ><P
419 >  There are many reasons to use web proxies, such as security (firewalling),
420   efficiency (caching) and others, and there are just as many different proxies
421   to accommodate those needs.
422  </P
423 ><P
424 >  <SPAN
425 CLASS="APPLICATION"
426 >Privoxy</SPAN
427 > is a proxy that is solely focused on privacy
428   protection and junk elimination. Sitting between your browser(s) and the Internet,
429   it is in a perfect position to filter outbound personal information that your
430   browser is leaking, as well as inbound junk. It uses a variety of techniques to do
431   this, all of which are under your control via the various configuration
432   files and options.
433  </P
434 ></DIV
435 ><DIV
436 CLASS="SECT2"
437 ><H3
438 CLASS="SECT2"
439 ><A
440 NAME="WHATSANAD">1.5. How does <SPAN
441 CLASS="APPLICATION"
442 >Privoxy</SPAN
443 > know what is
444 an ad, and what is not?</H3
445 ><P
446 > <SPAN
447 CLASS="APPLICATION"
448 >Privoxy</SPAN
449 >'s approach to blocking ads is twofold:</P
450 ><P
451 > First, there are certain patterns in the <SPAN
452 CLASS="emphasis"
453 ><I
454 CLASS="EMPHASIS"
455 >locations</I
456 ></SPAN
457 > (URLs)
458  of banner images. This applies to both the path (you wouldn't guess how many
459  web sites serve their banners from a directory called <SPAN
460 CLASS="QUOTE"
461 >"banners"</SPAN
462 >!)
463  and the host (blocking the big banner hosting services like doublecklick.net
464  already helps a lot). <SPAN
465 CLASS="APPLICATION"
466 >Privoxy</SPAN
467 > takes advantage of this
468  fact by using <A
469 HREF="../user-manual/actions-file.html#AF-PATTERNS"
470 TARGET="_top"
471 >URL
472  patterns</A
473 > to sort out and block the requests for banners.</P
474 ><P
475 > Second, banners tend to come in certain <SPAN
476 CLASS="emphasis"
477 ><I
478 CLASS="EMPHASIS"
479 >sizes</I
480 ></SPAN
481 >. But you
482  can't tell the size of an image by its URL without downloading it, and if you
483  do, it's too late to save bandwidth. Therefore, <SPAN
484 CLASS="APPLICATION"
485 >Privoxy</SPAN
486 >
487  also inspects the HTML sources of web pages while they are loaded, and replaces
488  references to images with standard banner sizes by dummy references, so that
489  your browser doesn't request them anymore in the first place.</P
490 ><P
491 > Both of this involves a certain amount of guesswork and is, of course, freely
492  configurable.</P
493 ></DIV
494 ><DIV
495 CLASS="SECT2"
496 ><H3
497 CLASS="SECT2"
498 ><A
499 NAME="AEN136">1.6. Can <SPAN
500 CLASS="APPLICATION"
501 >Privoxy</SPAN
502 > make mistakes? 
503 This does not sound very scientific.</H3
504 ><P
505 > Actually, it's a black art ;-) And yes, it is always possible to have a broad
506  rule accidentally block or change something by mistake. There is a good chance
507  you may run into such a situation at some point. It is tricky writing rules to
508  cover every conceivable possibility, and not occasionally get false positives.</P
509 ><P
510 > But this should not be a big concern since the
511  <SPAN
512 CLASS="APPLICATION"
513 >Privoxy</SPAN
514 > configuration is very flexible, and
515  includes tools to help identify these types of situations so they can be
516  addressed as needed, allowing you to customize your installation.
517  (<A
518 HREF="trouble.html#BADSITE"
519 >See the Troubleshooting section below</A
520 >.)</P
521 ></DIV
522 ><DIV
523 CLASS="SECT2"
524 ><H3
525 CLASS="SECT2"
526 ><A
527 NAME="BROWSERS2">1.7. My browser does the same things as
528 <SPAN
529 CLASS="APPLICATION"
530 >Privoxy</SPAN
531 >. Why should I use
532 <SPAN
533 CLASS="APPLICATION"
534 >Privoxy</SPAN
535 > at all?</H3
536 ><P
537 >  Modern browsers do indeed have <SPAN
538 CLASS="emphasis"
539 ><I
540 CLASS="EMPHASIS"
541 >some</I
542 ></SPAN
543 > of the same
544   functionality as <SPAN
545 CLASS="APPLICATION"
546 >Privoxy</SPAN
547 >. Maybe this is
548   adequate for you. But <SPAN
549 CLASS="APPLICATION"
550 >Privoxy</SPAN
551 > is much more
552   versatile and powerful, and can do a number of things that browsers just can't.
553  </P
554 ><P
555 >  In addition, a proxy is good choice if you use multiple browsers, or 
556   have a LAN with multiple computers. This way all the configuration 
557   is in one place, and you don't have to maintain a similar configuration 
558   for possibly many browsers.
559  </P
560 ></DIV
561 ><DIV
562 CLASS="SECT2"
563 ><H3
564 CLASS="SECT2"
565 ><A
566 NAME="LICENSE">1.8. Is there is a license or fee? What about a 
567 warranty? Registration?</H3
568 ><P
569 >  <SPAN
570 CLASS="APPLICATION"
571 >Privoxy</SPAN
572 > is licensed under the <A
573 HREF="http://www.gnu.org/copyleft/gpl.html"
574 TARGET="_top"
575 >GNU General Public License (GPL)</A
576 >.
577   It is free to use, copy, modify or distribute as you wish under the terms of this
578   license.  Please see the <A
579 HREF="copyright.html"
580 >Copyright</A
581 > section for more
582   information on the license and copyright. Or the <TT
583 CLASS="FILENAME"
584 >LICENSE</TT
585 > file 
586   that should be included.
587  </P
588 ><P
589 >  There is <SPAN
590 CLASS="emphasis"
591 ><I
592 CLASS="EMPHASIS"
593 >no warranty</I
594 ></SPAN
595 > of any kind, expressed, implied or otherwise.
596   That is something that would cost real money ;-) There is no registration either.
597   <SPAN
598 CLASS="APPLICATION"
599 >Privoxy</SPAN
600 > really is <SPAN
601 CLASS="emphasis"
602 ><I
603 CLASS="EMPHASIS"
604 >free</I
605 ></SPAN
606 >
607   in every respect!
608  </P
609 ></DIV
610 ><DIV
611 CLASS="SECT2"
612 ><H3
613 CLASS="SECT2"
614 ><A
615 NAME="JOINTEAM">1.9. I would like to help you, what do I do?</H3
616 ><DIV
617 CLASS="SECT3"
618 ><H4
619 CLASS="SECT3"
620 ><A
621 NAME="JOINTEAM-MONEY">1.9.1. Money Money Money</H4
622 ><P
623 > We, of course, welcome donations and could use money for domain registering,
624  buying software to test <SPAN
625 CLASS="APPLICATION"
626 >Privoxy</SPAN
627 > with, and, of course,
628  for regular world-wide get-togethers (hahaha). If you enjoy the software and feel
629  like helping us with a donation, just <A
630 HREF="mailto:developers@privoxy.org"
631 TARGET="_top"
632 >drop us a note</A
633 >.</P
634 ></DIV
635 ><DIV
636 CLASS="SECT3"
637 ><H4
638 CLASS="SECT3"
639 ><A
640 NAME="JOINTEAM-SOFTWARE">1.9.2. Software</H4
641 ><P
642 > If you are a vendor of a web-related software like a browser, web server
643  or proxy, and would like us to ensure that <SPAN
644 CLASS="APPLICATION"
645 >Privoxy</SPAN
646 >
647  runs smoothly with your product, you might consider supplying us with a
648  copy or license. We can't, however, guarantee that we will fix all potential
649  compatibility issues as a result.</P
650 ></DIV
651 ><DIV
652 CLASS="SECT3"
653 ><H4
654 CLASS="SECT3"
655 ><A
656 NAME="JOINTEAM-WORK">1.9.3. You want to work with us?</H4
657 ><P
658 >   Well, helping the team is always a good idea. We welcome new developers,
659    packaging gurus or documentation writers. Simply <A
660 HREF="https://sourceforge.net/account/register.php"
661 TARGET="_top"
662 >get an account on SourceForge.net</A
663 >
664    and mail your id to the <A
665 HREF="mailto:developers@privoxy.org"
666 TARGET="_top"
667 >developers
668    mailing list</A
669 >. Then read the <A
670 HREF="../developer-manual/index.html"
671 TARGET="_top"
672 >Developer's Manual</A
673 >.</P
674 ><P
675 > Once we have added you to the team, you'll have write access to the <A
676 HREF="http://sourceforge.net/cvs/?group_id=11118"
677 TARGET="_top"
678 >CVS repository</A
679 >, and
680  together we'll find a suitable task for you.</P
681 ></DIV
682 ></DIV
683 ></DIV
684 ><DIV
685 CLASS="NAVFOOTER"
686 ><HR
687 ALIGN="LEFT"
688 WIDTH="100%"><TABLE
689 SUMMARY="Footer navigation table"
690 WIDTH="100%"
691 BORDER="0"
692 CELLPADDING="0"
693 CELLSPACING="0"
694 ><TR
695 ><TD
696 WIDTH="33%"
697 ALIGN="left"
698 VALIGN="top"
699 ><A
700 HREF="index.html"
701 ACCESSKEY="P"
702 >Prev</A
703 ></TD
704 ><TD
705 WIDTH="34%"
706 ALIGN="center"
707 VALIGN="top"
708 ><A
709 HREF="index.html"
710 ACCESSKEY="H"
711 >Home</A
712 ></TD
713 ><TD
714 WIDTH="33%"
715 ALIGN="right"
716 VALIGN="top"
717 ><A
718 HREF="installation.html"
719 ACCESSKEY="N"
720 >Next</A
721 ></TD
722 ></TR
723 ><TR
724 ><TD
725 WIDTH="33%"
726 ALIGN="left"
727 VALIGN="top"
728 >Privoxy Frequently Asked Questions</TD
729 ><TD
730 WIDTH="34%"
731 ALIGN="center"
732 VALIGN="top"
733 >&nbsp;</TD
734 ><TD
735 WIDTH="33%"
736 ALIGN="right"
737 VALIGN="top"
738 >Installation</TD
739 ></TR
740 ></TABLE
741 ></DIV
742 ></BODY
743 ></HTML
744 >