generated files. do NOT edit.
[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.60"><LINK
8 REL="HOME"
9 TITLE="Privoxy Frequently Asked Questions"
10 HREF="index.html"><LINK
11 REL="PREVIOUS"
12 TITLE="Privoxy Frequently Asked Questions"
13 HREF="index.html"><LINK
14 REL="NEXT"
15 TITLE="Installation"
16 HREF="installation.html"><LINK
17 REL="STYLESHEET"
18 TYPE="text/css"
19 HREF="../p_doc.css"></HEAD
20 ><BODY
21 CLASS="SECT1"
22 BGCOLOR="#EEEEEE"
23 TEXT="#000000"
24 LINK="#0000FF"
25 VLINK="#840084"
26 ALINK="#0000FF"
27 ><DIV
28 CLASS="NAVHEADER"
29 ><TABLE
30 WIDTH="100%"
31 BORDER="0"
32 CELLPADDING="0"
33 CELLSPACING="0"
34 ><TR
35 ><TH
36 COLSPAN="3"
37 ALIGN="center"
38 >Privoxy Frequently Asked Questions</TH
39 ></TR
40 ><TR
41 ><TD
42 WIDTH="10%"
43 ALIGN="left"
44 VALIGN="bottom"
45 ><A
46 HREF="index.html"
47 >Prev</A
48 ></TD
49 ><TD
50 WIDTH="80%"
51 ALIGN="center"
52 VALIGN="bottom"
53 ></TD
54 ><TD
55 WIDTH="10%"
56 ALIGN="right"
57 VALIGN="bottom"
58 ><A
59 HREF="installation.html"
60 >Next</A
61 ></TD
62 ></TR
63 ></TABLE
64 ><HR
65 ALIGN="LEFT"
66 WIDTH="100%"></DIV
67 ><DIV
68 CLASS="SECT1"
69 ><H1
70 CLASS="SECT1"
71 ><A
72 NAME="GENERAL"
73 >1. General Information</A
74 ></H1
75 ><DIV
76 CLASS="SECT2"
77 ><H3
78 CLASS="SECT2"
79 ><A
80 NAME="NEWJB"
81 >1.1. What is this new version of <SPAN
82 CLASS="APPLICATION"
83 >Privoxy</SPAN
84 >?</A
85 ></H3
86 ><P
87 >  The original <SPAN
88 CLASS="APPLICATION"
89 ><SPAN
90 CLASS="TRADEMARK"
91 >Internet
92   Junkbuster</SPAN
93 >&trade;</SPAN
94 > (tm) is a copyrighted product of <A
95 HREF="http://www.junkbusters.com"
96 TARGET="_top"
97 >Junkbusters Corporation</A
98 >.
99   Development of this effort stopped some time ago as of version 2.0.2. Stefan
100   Waldherr started the ijbswa project on <A
101 HREF="http://sourceforge.net/projects/ijbswa/"
102 TARGET="_top"
103 >Sourceforge</A
104 > to
105   rekindle development. Other developers subsequently joined with Stefan, and
106   have since added many new features, refinements and enhancements. The result
107   of this effort is <SPAN
108 CLASS="APPLICATION"
109 >Privoxy</SPAN
110 >.
111  </P
112 ><P
113 >  <SPAN
114 CLASS="APPLICATION"
115 >Privoxy</SPAN
116 > has evolved from the 
117   <SPAN
118 CLASS="APPLICATION"
119 >Junkbuster 2.0.2</SPAN
120 > code base, and has advanced
121   significantly at this point. 
122  </P
123 ><P
124
125   Please see the History section for more
126   information on the history of <SPAN
127 CLASS="APPLICATION"
128 >Junkbuster</SPAN
129 > and 
130   <SPAN
131 CLASS="APPLICATION"
132 >Privoxy</SPAN
133 >.
134  </P
135 ></DIV
136 ><DIV
137 CLASS="SECT2"
138 ><H3
139 CLASS="SECT2"
140 ><A
141 NAME="AEN47"
142 >1.2. Why <SPAN
143 CLASS="QUOTE"
144 >"Privoxy"</SPAN
145 >? Why a name change at all?</A
146 ></H3
147 ><P
148 > <SPAN
149 CLASS="APPLICATION"
150 >Privoxy</SPAN
151 > is the 
152  <SPAN
153 CLASS="QUOTE"
154 >"<I
155 CLASS="EMPHASIS"
156 >Privacy Enhancing Proxy</I
157 >"</SPAN
158 >.</P
159 ><P
160 > There are potential legal complications from the continued use of the 
161  <SPAN
162 CLASS="APPLICATION"
163 >Junkbuster</SPAN
164 > name, which is a trademark of 
165  <A
166 HREF="http://junkbusters.com"
167 TARGET="_top"
168 >Junkbusters Corporation</A
169 >.
170  (There are, however, no objections from Junkbusters Corporation to the 
171  <SPAN
172 CLASS="APPLICATION"
173 >Privoxy</SPAN
174 > project itself, and they, in fact, still
175  share our ideals and goals.)</P
176 ><P
177 > The developers also believed that there are so many changes from the original 
178  code, that it was time to make a clean break from the past and make 
179  a name in their own right, especially now with the pending
180  release of version 3.0.</P
181 ></DIV
182 ><DIV
183 CLASS="SECT2"
184 ><H3
185 CLASS="SECT2"
186 ><A
187 NAME="DIFFERS"
188 >1.3. How does <SPAN
189 CLASS="APPLICATION"
190 >Privoxy</SPAN
191 > differ
192 from the old <SPAN
193 CLASS="APPLICATION"
194 >Junkbuster?</SPAN
195 ></A
196 ></H3
197 ><P
198 >  <SPAN
199 CLASS="APPLICATION"
200 >Privoxy</SPAN
201 > picks up where
202   <SPAN
203 CLASS="APPLICATION"
204 >Junkbuster</SPAN
205 > left off. All the old features remain.
206   The new <SPAN
207 CLASS="APPLICATION"
208 >Privoxy</SPAN
209 > still blocks ads and banners,
210   still manages cookies, and still helps protect your privacy. But, these are
211   all enhanced, and many new features have been added, all in the same vein.
212  </P
213 ><P
214 >  The configuration has changed significantly as well. This is something that
215   users will notice right off the bat if you are upgrading from 
216   <SPAN
217 CLASS="APPLICATION"
218 >Junkbuster</SPAN
219 > 2.0.x. The <SPAN
220 CLASS="QUOTE"
221 >"blocklist"</SPAN
222 >
223   file does not exist any more. This is replaced by <SPAN
224 CLASS="QUOTE"
225 >"actions"</SPAN
226 >
227   files, such as <TT
228 CLASS="FILENAME"
229 >default.actions</TT
230 >. This is where most of
231   the per site configuration is now.
232  </P
233 ></DIV
234 ><DIV
235 CLASS="SECT2"
236 ><H3
237 CLASS="SECT2"
238 ><A
239 NAME="FEATURES"
240 >1.4. What are some of the new features?</A
241 ></H3
242 ><P
243 > <P
244 ></P
245 ><UL
246 ><LI
247 ><P
248 >   Integrated browser based configuration and control utility (<A
249 HREF="http://p.p"
250 TARGET="_top"
251 >http://p.p</A
252 >). Browser-based tracing of rule
253    and filter effects.
254   </P
255 ></LI
256 ><LI
257 ><P
258 >    Blocking of annoying pop-up browser windows.
259   </P
260 ></LI
261 ><LI
262 ><P
263 >   HTTP/1.1 compliant (most, but not all 1.1 features are supported).
264   </P
265 ></LI
266 ><LI
267 ><P
268 >   Support for Perl Compatible Regular Expressions in the configuration files, and 
269    generally a more sophisticated and flexible configuration syntax over
270    previous versions. 
271   </P
272 ></LI
273 ><LI
274 ><P
275 >   GIF de-animation. 
276   </P
277 ></LI
278 ><LI
279 ><P
280 >   Web page content filtering (removes banners based on size,
281    invisible <SPAN
282 CLASS="QUOTE"
283 >"web-bugs"</SPAN
284 >, JavaScript, pop-ups, status bar abuse,
285    etc.)
286   </P
287 ></LI
288 ><LI
289 ><P
290 >   Bypass many click-tracking scripts (avoids script redirection).
291  
292   </P
293 ></LI
294 ><LI
295 ><P
296 >   Multi-threaded (POSIX and native threads).
297   </P
298 ></LI
299 ><LI
300 ><P
301 >   Auto-detection and re-reading of config file changes.
302   </P
303 ></LI
304 ><LI
305 ><P
306 >   User-customizable HTML templates (e.g. 404 error page).
307   </P
308 ></LI
309 ><LI
310 ><P
311 >   Improved cookie management features (e.g. session based cookies).
312   </P
313 ></LI
314 ><LI
315 ><P
316 >   Improved signal handling, and a true daemon mode (Unix).
317   </P
318 ></LI
319 ><LI
320 ><P
321 >   Builds from source on most UNIX-like systems. Packages available for: Linux
322    (RedHat, SuSE, or Debian), Windows, Sun Solaris, Mac OSX, OS/2, HP-UX 11 and AmigaOS.
323  
324   </P
325 ></LI
326 ><LI
327 ><P
328 >   In addition, the configuration is much more powerful and versatile over-all.
329   </P
330 ></LI
331 ></UL
332 ></P
333 ></DIV
334 ><DIV
335 CLASS="SECT2"
336 ><H3
337 CLASS="SECT2"
338 ><A
339 NAME="PROXYMORON"
340 >1.5. What is a <SPAN
341 CLASS="QUOTE"
342 >"proxy"</SPAN
343 >? How does
344 <SPAN
345 CLASS="APPLICATION"
346 >Privoxy</SPAN
347 > work?</A
348 ></H3
349 ><P
350 >  When you connect to a web site with <SPAN
351 CLASS="APPLICATION"
352 >Privoxy</SPAN
353 >, 
354   you are really connecting to your locally running version of 
355   <SPAN
356 CLASS="APPLICATION"
357 >Privoxy</SPAN
358 >. <SPAN
359 CLASS="APPLICATION"
360 >Privoxy</SPAN
361 >
362   intercepts your requests for the web page, and relays that to the 
363   <SPAN
364 CLASS="QUOTE"
365 >"real"</SPAN
366 > web site. The web site sends the HTTP data stream 
367   back to <SPAN
368 CLASS="APPLICATION"
369 >Privoxy</SPAN
370 >, where
371   <SPAN
372 CLASS="APPLICATION"
373 >Privoxy</SPAN
374 > can work its magic before it 
375   relays this data back to your web browser.
376  </P
377 ><P
378 >  Since <SPAN
379 CLASS="APPLICATION"
380 >Privoxy</SPAN
381 > sits between you and the 
382   WWW, it is in a position to intercept and completely manage all web traffic and 
383   HTTP content before it gets to your browser.
384   <SPAN
385 CLASS="APPLICATION"
386 >Privoxy</SPAN
387 > uses various programming methods to do
388   this, all of which is under your control via the various configuration
389   files and options.
390  </P
391 ><P
392 >  There are many kinds of proxies. <SPAN
393 CLASS="APPLICATION"
394 >Privoxy</SPAN
395 > best 
396   fits the <SPAN
397 CLASS="QUOTE"
398 >"filtering proxy"</SPAN
399 > category.
400  </P
401 ></DIV
402 ><DIV
403 CLASS="SECT2"
404 ><H3
405 CLASS="SECT2"
406 ><A
407 NAME="AEN123"
408 >1.6. How does <SPAN
409 CLASS="APPLICATION"
410 >Privoxy</SPAN
411 > know what is
412 an ad, and what is not?</A
413 ></H3
414 ><P
415 > <SPAN
416 CLASS="APPLICATION"
417 >Privoxy</SPAN
418 > processes all the raw content of every 
419  web page. So it reads everything on each page. It then compares this to the
420  rules as set up in the configuration files, and looks for any matches to
421  these rules. <SPAN
422 CLASS="APPLICATION"
423 >Privoxy</SPAN
424 > makes heavy use of
425  <SPAN
426 CLASS="QUOTE"
427 >"regular expressions"</SPAN
428 >. (If you are not familiar with regular
429  expressions, it is explained briefly in <A
430 HREF="../user-manual/appendix.html"
431 TARGET="_top"
432 >the user manual</A
433 >.) Regular
434  expressions facilitate matching of one text string against another, using
435  wildcards to build complex patterns. So <SPAN
436 CLASS="APPLICATION"
437 >Privoxy</SPAN
438 >
439  will typically look for URLs and other content that match certain key words
440  and expressions as defined in the configuration files. For instance a URL
441  that contains <SPAN
442 CLASS="QUOTE"
443 >"/banners"</SPAN
444 >, has a high probability of containing
445  ad banners, and thus would be a prime candidate to have a matching rule.</P
446 ><P
447 > So <SPAN
448 CLASS="APPLICATION"
449 >Privoxy</SPAN
450 > will look for these kinds of obvious 
451  looking culprits. And also, will use lists of known organizations that
452  specialize in ads. Again, using complex patterns to match as many potential 
453  combinations as possible since there tend to be many, many variations used by 
454  advertisers, and new ones are being introduced all the time.</P
455 ></DIV
456 ><DIV
457 CLASS="SECT2"
458 ><H3
459 CLASS="SECT2"
460 ><A
461 NAME="AEN135"
462 >1.7. Can <SPAN
463 CLASS="APPLICATION"
464 >Privoxy</SPAN
465 > make mistakes? 
466 This does not sound very scientific.</A
467 ></H3
468 ><P
469 > Actually, it's a black art ;-) And yes, it is always possible to have a broad rule
470  accidentally block something by mistake. There is a good chance you may run 
471  into such a situation at some point. It is tricky writing rules to cover
472  every conceivable possibility, and not occasionally get false positives.</P
473 ><P
474 > But this should not be a big concern since the
475  <SPAN
476 CLASS="APPLICATION"
477 >Privoxy</SPAN
478 > configuration is very flexible, and
479  includes tools to help identify these types of situations so they can be
480  addressed as needed, allowing you to customize your installation.
481  (<A
482 HREF="trouble.html#AEN645"
483 >See the Troubleshooting section below</A
484 >.)</P
485 ></DIV
486 ><DIV
487 CLASS="SECT2"
488 ><H3
489 CLASS="SECT2"
490 ><A
491 NAME="BROWSERS2"
492 >1.8. My browser does the same things as
493 <SPAN
494 CLASS="APPLICATION"
495 >Privoxy</SPAN
496 >. Why should I use
497 <SPAN
498 CLASS="APPLICATION"
499 >Privoxy</SPAN
500 > at all?</A
501 ></H3
502 ><P
503 >  Modern browsers do indeed have <I
504 CLASS="EMPHASIS"
505 >some</I
506 > of the same
507   functionality as <SPAN
508 CLASS="APPLICATION"
509 >Privoxy</SPAN
510 >. Maybe this is
511   adequate for you. But <SPAN
512 CLASS="APPLICATION"
513 >Privoxy</SPAN
514 > is much more
515   versatile and powerful, and can do a number of things that browsers just can't.
516  </P
517 ><P
518 >  In addition, a proxy is good choice if you use multiple browsers, or 
519   have a LAN with multiple computers. This way all the configuration 
520   is in one place, and you don't have to maintain a similar configuration 
521   for possibly many browsers.
522
523  </P
524 ></DIV
525 ><DIV
526 CLASS="SECT2"
527 ><H3
528 CLASS="SECT2"
529 ><A
530 NAME="LICENSE"
531 >1.9. Is there is a license or fee? What about a 
532 warranty? Registration?</A
533 ></H3
534 ><P
535 >  <SPAN
536 CLASS="APPLICATION"
537 >Privoxy</SPAN
538 > is licensed under the GNU General Public
539   License (GPL). It is free to use, copy, modify or distribute as you wish
540   under the terms of this license.  Please see the Copyright section for more
541   information on the license and copyright.
542
543   </P
544 ><P
545 >  There is no warranty of any kind, expressed, implied or otherwise. That is
546   something that would cost real money ;-) There is no registration either.
547   <SPAN
548 CLASS="APPLICATION"
549 >Privoxy</SPAN
550 > really is <I
551 CLASS="EMPHASIS"
552 >free</I
553 >
554   in every respect!
555
556  </P
557 ></DIV
558 ><DIV
559 CLASS="SECT2"
560 ><H3
561 CLASS="SECT2"
562 ><A
563 NAME="JOINTEAM"
564 >1.10. I would like to help you, what do I do?</A
565 ></H3
566 ><DIV
567 CLASS="SECT3"
568 ><H4
569 CLASS="SECT3"
570 ><A
571 NAME="JOINTEAM-MONEY"
572 >1.10.1. Money Money Money</A
573 ></H4
574 ><P
575 > We, of course, welcome donations and use the money for domain registering,
576  regular world-wide get-togethers (hahaha). Anyway, we'll soon describe the
577  process how to donate money to the team.</P
578 ></DIV
579 ><DIV
580 CLASS="SECT3"
581 ><H4
582 CLASS="SECT3"
583 ><A
584 NAME="JOINTEAM-WORK"
585 >1.10.2. You want to work with us?</A
586 ></H4
587 ><P
588 >   Well, helping the team is always a good idea. We welcome new developers,
589    RPM gurus or documentation makers. Simply get an account on sourceforge.net
590    and mail your id to the developer mailing list. Then read the
591    section Quickstart in the <A
592 HREF="../developer-manual/quickstart.html"
593 TARGET="_top"
594 >   Developer's Manual</A
595 >.</P
596 ><P
597 > Once we have added you to the team, you'll have write access to the CVS
598  repository, and together we'll find a suitable task for you.</P
599 ></DIV
600 ></DIV
601 ></DIV
602 ><DIV
603 CLASS="NAVFOOTER"
604 ><HR
605 ALIGN="LEFT"
606 WIDTH="100%"><TABLE
607 WIDTH="100%"
608 BORDER="0"
609 CELLPADDING="0"
610 CELLSPACING="0"
611 ><TR
612 ><TD
613 WIDTH="33%"
614 ALIGN="left"
615 VALIGN="top"
616 ><A
617 HREF="index.html"
618 >Prev</A
619 ></TD
620 ><TD
621 WIDTH="34%"
622 ALIGN="center"
623 VALIGN="top"
624 ><A
625 HREF="index.html"
626 >Home</A
627 ></TD
628 ><TD
629 WIDTH="33%"
630 ALIGN="right"
631 VALIGN="top"
632 ><A
633 HREF="installation.html"
634 >Next</A
635 ></TD
636 ></TR
637 ><TR
638 ><TD
639 WIDTH="33%"
640 ALIGN="left"
641 VALIGN="top"
642 >Privoxy Frequently Asked Questions</TD
643 ><TD
644 WIDTH="34%"
645 ALIGN="center"
646 VALIGN="top"
647 >&nbsp;</TD
648 ><TD
649 WIDTH="33%"
650 ALIGN="right"
651 VALIGN="top"
652 >Installation</TD
653 ></TR
654 ></TABLE
655 ></DIV
656 ></BODY
657 ></HTML
658 >