doc/webserver/user-manual/config.html

   1 <HTML
   2 ><HEAD
   3 ><TITLE
   4 >The Main Configuration File</TITLE
   5 ><META
   6 NAME="GENERATOR"
   7 CONTENT="Modular DocBook HTML Stylesheet Version 1.64
   8 "><LINK
   9 REL="HOME"
  10 TITLE="Privoxy User Manual"
  11 HREF="index.html"><LINK
  12 REL="PREVIOUS"
  13 TITLE="Privoxy Configuration"
  14 HREF="configuration.html"><LINK
  15 REL="NEXT"
  16 TITLE="Actions Files"
  17 HREF="actions-file.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 WIDTH="100%"
  32 BORDER="0"
  33 CELLPADDING="0"
  34 CELLSPACING="0"
  35 ><TR
  36 ><TH
  37 COLSPAN="3"
  38 ALIGN="center"
  39 >Privoxy User Manual</TH
  40 ></TR
  41 ><TR
  42 ><TD
  43 WIDTH="10%"
  44 ALIGN="left"
  45 VALIGN="bottom"
  46 ><A
  47 HREF="configuration.html"
  48 >Prev</A
  49 ></TD
  50 ><TD
  51 WIDTH="80%"
  52 ALIGN="center"
  53 VALIGN="bottom"
  54 ></TD
  55 ><TD
  56 WIDTH="10%"
  57 ALIGN="right"
  58 VALIGN="bottom"
  59 ><A
  60 HREF="actions-file.html"
  61 >Next</A
  62 ></TD
  63 ></TR
  64 ></TABLE
  65 ><HR
  66 ALIGN="LEFT"
  67 WIDTH="100%"></DIV
  68 ><DIV
  69 CLASS="SECT1"
  70 ><H1
  71 CLASS="SECT1"
  72 ><A
  73 NAME="CONFIG"
  74 >7. The Main Configuration File</A
  75 ></H1
  76 ><P
  77 > Again, the main configuration file is named <TT
  78 CLASS="FILENAME"
  79 >config</TT
  80 > on
  81  Linux/Unix/BSD and OS/2, and <TT
  82 CLASS="FILENAME"
  83 >config.txt</TT
  84 > on Windows.
  85  Configuration lines consist of an initial keyword followed by a list of
  86  values, all separated by whitespace (any number of spaces or tabs). For
  87  example:</P
  88 ><P
  89 > <TT
  90 CLASS="LITERAL"
  91 >  <P
  92 CLASS="LITERALLAYOUT"
  93 >&nbsp;&nbsp;<I
  94 CLASS="EMPHASIS"
  95 >confdir /etc/privoxy</I
  96 ></P
  97 >
  98  </TT
  99 > </P
 100 ><P
 101 > Assigns the value <TT
 102 CLASS="LITERAL"
 103 >/etc/privoxy</TT
 104 > to the option
 105  <TT
 106 CLASS="LITERAL"
 107 >confdir</TT
 108 > and thus indicates that the configuration
 109  directory is named <SPAN
 110 CLASS="QUOTE"
 111 >"/etc/privoxy/"</SPAN
 112 >.</P
 113 ><P
 114 > All options in the config file except for <TT
 115 CLASS="LITERAL"
 116 >confdir</TT
 117 > and
 118  <TT
 119 CLASS="LITERAL"
 120 >logdir</TT
 121 > are optional. Watch out in the below description
 122  for what happens if you leave them unset.</P
 123 ><P
 124 > The main config file controls all aspects of <SPAN
 125 CLASS="APPLICATION"
 126 >Privoxy</SPAN
 127 >'s
 128  operation that are not location dependent (i.e. they apply universally, no matter
 129  where you may be surfing).</P
 130 ><DIV
 131 CLASS="SECT2"
 132 ><H2
 133 CLASS="SECT2"
 134 ><A
 135 NAME="CONF-LOG-LOC"
 136 >7.1. Configuration and Log File Locations</A
 137 ></H2
 138 ><P
 139 > <SPAN
 140 CLASS="APPLICATION"
 141 >Privoxy</SPAN
 142 > can (and normally does) use a number of
 143  other files for additional configuration, help and logging.
 144  This section of the configuration file tells <SPAN
 145 CLASS="APPLICATION"
 146 >Privoxy</SPAN
 147 >
 148  where to find those other files. </P
 149 ><P
 150 > The user running Privoxy, must have read permission for all
 151  configuration files, and write permission to any files that would
 152  be modified, such as log files.</P
 153 ><DIV
 154 CLASS="SECT3"
 155 ><H4
 156 CLASS="SECT3"
 157 ><A
 158 NAME="CONFDIR"
 159 >7.1.1. confdir</A
 160 ></H4
 161 ><P
 162 ></P
 163 ><DIV
 164 CLASS="VARIABLELIST"
 165 ><DL
 166 ><DT
 167 >Specifies:</DT
 168 ><DD
 169 ><P
 170 >The directory where the other configuration files are located</P
 171 ></DD
 172 ><DT
 173 >Type of value:</DT
 174 ><DD
 175 ><P
 176 >Path name</P
 177 ></DD
 178 ><DT
 179 >Default value:</DT
 180 ><DD
 181 ><P
 182 >/etc/privoxy (Unix) <I
 183 CLASS="EMPHASIS"
 184 >or</I
 185 > <SPAN
 186 CLASS="APPLICATION"
 187 >Privoxy</SPAN
 188 > installation dir (Windows) </P
 189 ></DD
 190 ><DT
 191 >Effect if unset:</DT
 192 ><DD
 193 ><P
 194 ><I
 195 CLASS="EMPHASIS"
 196 >Mandatory</I
 197 ></P
 198 ></DD
 199 ><DT
 200 >Notes:</DT
 201 ><DD
 202 ><P
 203 >    No trailing <SPAN
 204 CLASS="QUOTE"
 205 >"<TT
 206 CLASS="LITERAL"
 207 >/</TT
 208 >"</SPAN
 209 >, please
 210    </P
 211 ><P
 212 >    When development goes modular and multi-user, the blocker, filter, and
 213     per-user config will be stored in subdirectories of <SPAN
 214 CLASS="QUOTE"
 215 >"confdir"</SPAN
 216 >.
 217     For now, the configuration directory structure is flat, except for
 218     <TT
 219 CLASS="FILENAME"
 220 >confdir/templates</TT
 221 >, where the HTML templates for CGI
 222     output reside (e.g. <SPAN
 223 CLASS="APPLICATION"
 224 >Privoxy's</SPAN
 225 > 404 error page).
 226    </P
 227 ></DD
 228 ></DL
 229 ></DIV
 230 ></DIV
 231 ><DIV
 232 CLASS="SECT3"
 233 ><H4
 234 CLASS="SECT3"
 235 ><A
 236 NAME="LOGDIR"
 237 >7.1.2. logdir</A
 238 ></H4
 239 ><P
 240 ></P
 241 ><DIV
 242 CLASS="VARIABLELIST"
 243 ><DL
 244 ><DT
 245 >Specifies:</DT
 246 ><DD
 247 ><P
 248 >    The directory where all logging takes place (i.e. where <TT
 249 CLASS="FILENAME"
 250 >logfile</TT
 251 > and
 252     <TT
 253 CLASS="FILENAME"
 254 >jarfile</TT
 255 > are located)
 256    </P
 257 ></DD
 258 ><DT
 259 >Type of value:</DT
 260 ><DD
 261 ><P
 262 >Path name</P
 263 ></DD
 264 ><DT
 265 >Default value:</DT
 266 ><DD
 267 ><P
 268 >/var/log/privoxy (Unix) <I
 269 CLASS="EMPHASIS"
 270 >or</I
 271 > <SPAN
 272 CLASS="APPLICATION"
 273 >Privoxy</SPAN
 274 > installation dir (Windows) </P
 275 ></DD
 276 ><DT
 277 >Effect if unset:</DT
 278 ><DD
 279 ><P
 280 ><I
 281 CLASS="EMPHASIS"
 282 >Mandatory</I
 283 ></P
 284 ></DD
 285 ><DT
 286 >Notes:</DT
 287 ><DD
 288 ><P
 289 >    No trailing <SPAN
 290 CLASS="QUOTE"
 291 >"<TT
 292 CLASS="LITERAL"
 293 >/</TT
 294 >"</SPAN
 295 >, please
 296    </P
 297 ></DD
 298 ></DL
 299 ></DIV
 300 ></DIV
 301 ><DIV
 302 CLASS="SECT3"
 303 ><H4
 304 CLASS="SECT3"
 305 ><A
 306 NAME="ACTIONSFILE"
 307 >7.1.3. actionsfile</A
 308 ></H4
 309 ><A
 310 NAME="DEFAULT.ACTION"
 311 ></A
 312 ><A
 313 NAME="STANDARD.ACTION"
 314 ></A
 315 ><A
 316 NAME="USER.ACTION"
 317 ></A
 318 ><P
 319 ></P
 320 ><DIV
 321 CLASS="VARIABLELIST"
 322 ><DL
 323 ><DT
 324 >Specifies:</DT
 325 ><DD
 326 ><P
 327 >    The <A
 328 HREF="actions-file.html"
 329 >actions file(s)</A
 330 > to use
 331    </P
 332 ></DD
 333 ><DT
 334 >Type of value:</DT
 335 ><DD
 336 ><P
 337 >File name, relative to <TT
 338 CLASS="LITERAL"
 339 >confdir</TT
 340 >, without the <TT
 341 CLASS="LITERAL"
 342 >.action</TT
 343 > suffix</P
 344 ></DD
 345 ><DT
 346 >Default value:</DT
 347 ><DD
 348 ><P
 349 ></P
 350 ><TABLE
 351 BORDER="0"
 352 ><TBODY
 353 ><TR
 354 ><TD
 355 >     <P
 356 CLASS="LITERALLAYOUT"
 357 >&nbsp;&nbsp;standard&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;Internal&nbsp;purposes,&nbsp;no&nbsp;editing&nbsp;recommended</P
 358 >
 359     </TD
 360 ></TR
 361 ><TR
 362 ><TD
 363 >     <P
 364 CLASS="LITERALLAYOUT"
 365 >&nbsp;&nbsp;default&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;Main&nbsp;actions&nbsp;file</P
 366 >
 367     </TD
 368 ></TR
 369 ><TR
 370 ><TD
 371 >     <P
 372 CLASS="LITERALLAYOUT"
 373 >&nbsp;&nbsp;user&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;User&nbsp;customizations</P
 374 >
 375     </TD
 376 ></TR
 377 ></TBODY
 378 ></TABLE
 379 ><P
 380 ></P
 381 ></DD
 382 ><DT
 383 >Effect if unset:</DT
 384 ><DD
 385 ><P
 386 >    No actions are taken at all. Simple neutral proxying.
 387    </P
 388 ></DD
 389 ><DT
 390 >Notes:</DT
 391 ><DD
 392 ><P
 393 >    Multiple <TT
 394 CLASS="LITERAL"
 395 >actionsfile</TT
 396 > lines are permitted, and are in fact recommended!
 397    </P
 398 ><P
 399 >
 400     The default values include standard.action, which is used for internal
 401     purposes and should be loaded, default.action, which is the
 402     <SPAN
 403 CLASS="QUOTE"
 404 >"main"</SPAN
 405 > actions file maintained by the developers, and
 406     <TT
 407 CLASS="FILENAME"
 408 >user.action</TT
 409 >, where you can make your personal additions.
 410    </P
 411 ><P
 412 >
 413     Actions files are where all the per site and per URL configuration is done for
 414     ad blocking, cookie management, privacy considerations, etc.
 415     There is no point in using <SPAN
 416 CLASS="APPLICATION"
 417 >Privoxy</SPAN
 418 > without at
 419     least one actions file.
 420    </P
 421 ></DD
 422 ></DL
 423 ></DIV
 424 ></DIV
 425 ><DIV
 426 CLASS="SECT3"
 427 ><H4
 428 CLASS="SECT3"
 429 ><A
 430 NAME="FILTERFILE"
 431 >7.1.4. filterfile</A
 432 ></H4
 433 ><A
 434 NAME="DEFAULT.FILTER"
 435 ></A
 436 ><P
 437 ></P
 438 ><DIV
 439 CLASS="VARIABLELIST"
 440 ><DL
 441 ><DT
 442 >Specifies:</DT
 443 ><DD
 444 ><P
 445 >    The <A
 446 HREF="actions-file.html#FILTER"
 447 >filter</A
 448 > file to use
 449    </P
 450 ></DD
 451 ><DT
 452 >Type of value:</DT
 453 ><DD
 454 ><P
 455 >File name, relative to <TT
 456 CLASS="LITERAL"
 457 >confdir</TT
 458 ></P
 459 ></DD
 460 ><DT
 461 >Default value:</DT
 462 ><DD
 463 ><P
 464 >default.filter (Unix) <I
 465 CLASS="EMPHASIS"
 466 >or</I
 467 > default.filter.txt (Windows)</P
 468 ></DD
 469 ><DT
 470 >Effect if unset:</DT
 471 ><DD
 472 ><P
 473 >    No textual content filtering takes place, i.e. all
 474     <TT
 475 CLASS="LITERAL"
 476 >+filter{<TT
 477 CLASS="REPLACEABLE"
 478 ><I
 479 >name</I
 480 ></TT
 481 >}</TT
 482 >
 483     actions in the actions files are turned neutral.
 484    </P
 485 ></DD
 486 ><DT
 487 >Notes:</DT
 488 ><DD
 489 ><P
 490 >    The <SPAN
 491 CLASS="QUOTE"
 492 >"default.filter"</SPAN
 493 > file contains content modification rules
 494     that use <SPAN
 495 CLASS="QUOTE"
 496 >"regular expressions"</SPAN
 497 >. These rules permit powerful
 498     changes on the content of Web pages, e.g., you could disable your favorite
 499     JavaScript annoyances, re-write the actual displayed text, or just have some
 500     fun replacing <SPAN
 501 CLASS="QUOTE"
 502 >"Microsoft"</SPAN
 503 > with <SPAN
 504 CLASS="QUOTE"
 505 >"MicroSuck"</SPAN
 506 > wherever
 507     it appears on a Web page.
 508    </P
 509 ></DD
 510 ></DL
 511 ></DIV
 512 ></DIV
 513 ><DIV
 514 CLASS="SECT3"
 515 ><H4
 516 CLASS="SECT3"
 517 ><A
 518 NAME="LOGFILE"
 519 >7.1.5. logfile</A
 520 ></H4
 521 ><P
 522 ></P
 523 ><DIV
 524 CLASS="VARIABLELIST"
 525 ><DL
 526 ><DT
 527 >Specifies:</DT
 528 ><DD
 529 ><P
 530 >    The log file to use
 531    </P
 532 ></DD
 533 ><DT
 534 >Type of value:</DT
 535 ><DD
 536 ><P
 537 >File name, relative to <TT
 538 CLASS="LITERAL"
 539 >logdir</TT
 540 ></P
 541 ></DD
 542 ><DT
 543 >Default value:</DT
 544 ><DD
 545 ><P
 546 >logfile (Unix) <I
 547 CLASS="EMPHASIS"
 548 >or</I
 549 > privoxy.log (Windows)</P
 550 ></DD
 551 ><DT
 552 >Effect if unset:</DT
 553 ><DD
 554 ><P
 555 >    No log file is used, all log messages go to the console (<TT
 556 CLASS="LITERAL"
 557 >stderr</TT
 558 >).
 559    </P
 560 ></DD
 561 ><DT
 562 >Notes:</DT
 563 ><DD
 564 ><P
 565 >    The windows version will additionally log to the console.
 566    </P
 567 ><P
 568 >    The logfile is where all logging and error messages are written. The level
 569     of detail and number of messages are set with the <TT
 570 CLASS="LITERAL"
 571 >debug</TT
 572 >
 573     option (see below). The logfile can be useful for tracking down a problem with
 574     <SPAN
 575 CLASS="APPLICATION"
 576 >Privoxy</SPAN
 577 > (e.g., it's not blocking an ad you
 578     think it should block) but in most cases you probably will never look at it.
 579    </P
 580 ><P
 581 >    Your logfile will grow indefinitely, and you will probably want to
 582     periodically remove it.  On Unix systems, you can do this with a cron job
 583     (see <SPAN
 584 CLASS="QUOTE"
 585 >"man cron"</SPAN
 586 >). For Red Hat, a <B
 587 CLASS="COMMAND"
 588 >logrotate</B
 589 >
 590     script has been included.
 591    </P
 592 ><P
 593 >    On SuSE Linux systems, you can place a line like <SPAN
 594 CLASS="QUOTE"
 595 >"/var/log/privoxy.*
 596     +1024k 644 nobody.nogroup"</SPAN
 597 > in <TT
 598 CLASS="FILENAME"
 599 >/etc/logfiles</TT
 600 >, with
 601     the effect that cron.daily will automatically archive, gzip, and empty the
 602     log, when it exceeds 1M size.
 603    </P
 604 ><P
 605 >    Any log files must be writable by whatever user <SPAN
 606 CLASS="APPLICATION"
 607 >Privoxy</SPAN
 608 >
 609     is being run as (default on UNIX, user id is <SPAN
 610 CLASS="QUOTE"
 611 >"privoxy"</SPAN
 612 >).
 613    </P
 614 ></DD
 615 ></DL
 616 ></DIV
 617 ></DIV
 618 ><DIV
 619 CLASS="SECT3"
 620 ><H4
 621 CLASS="SECT3"
 622 ><A
 623 NAME="JARFILE"
 624 >7.1.6. jarfile</A
 625 ></H4
 626 ><P
 627 ></P
 628 ><DIV
 629 CLASS="VARIABLELIST"
 630 ><DL
 631 ><DT
 632 >Specifies:</DT
 633 ><DD
 634 ><P
 635 >    The file to store intercepted cookies in
 636    </P
 637 ></DD
 638 ><DT
 639 >Type of value:</DT
 640 ><DD
 641 ><P
 642 >File name, relative to <TT
 643 CLASS="LITERAL"
 644 >logdir</TT
 645 ></P
 646 ></DD
 647 ><DT
 648 >Default value:</DT
 649 ><DD
 650 ><P
 651 >jarfile (Unix) <I
 652 CLASS="EMPHASIS"
 653 >or</I
 654 > privoxy.jar (Windows)</P
 655 ></DD
 656 ><DT
 657 >Effect if unset:</DT
 658 ><DD
 659 ><P
 660 >    Intercepted cookies are not stored at all.
 661    </P
 662 ></DD
 663 ><DT
 664 >Notes:</DT
 665 ><DD
 666 ><P
 667 >    The jarfile may grow to ridiculous sizes over time.
 668    </P
 669 ></DD
 670 ></DL
 671 ></DIV
 672 ></DIV
 673 ><DIV
 674 CLASS="SECT3"
 675 ><H4
 676 CLASS="SECT3"
 677 ><A
 678 NAME="TRUSTFILE"
 679 >7.1.7. trustfile</A
 680 ></H4
 681 ><P
 682 ></P
 683 ><DIV
 684 CLASS="VARIABLELIST"
 685 ><DL
 686 ><DT
 687 >Specifies:</DT
 688 ><DD
 689 ><P
 690 >    The trust file to use
 691    </P
 692 ></DD
 693 ><DT
 694 >Type of value:</DT
 695 ><DD
 696 ><P
 697 >File name, relative to <TT
 698 CLASS="LITERAL"
 699 >confdir</TT
 700 ></P
 701 ></DD
 702 ><DT
 703 >Default value:</DT
 704 ><DD
 705 ><P
 706 ><I
 707 CLASS="EMPHASIS"
 708 >Unset (commented out)</I
 709 >. When activated: trust (Unix) <I
 710 CLASS="EMPHASIS"
 711 >or</I
 712 > trust.txt (Windows)</P
 713 ></DD
 714 ><DT
 715 >Effect if unset:</DT
 716 ><DD
 717 ><P
 718 >    The whole trust mechanism is turned off.
 719    </P
 720 ></DD
 721 ><DT
 722 >Notes:</DT
 723 ><DD
 724 ><P
 725 >    The trust mechanism is an experimental feature for building white-lists and should
 726     be used with care. It is <I
 727 CLASS="EMPHASIS"
 728 >NOT</I
 729 > recommended for the casual user.
 730    </P
 731 ><P
 732 >    If you specify a trust file, <SPAN
 733 CLASS="APPLICATION"
 734 >Privoxy</SPAN
 735 > will only allow
 736     access to sites that are named in the trustfile.
 737     You can also mark sites as trusted referrers (with <TT
 738 CLASS="LITERAL"
 739 >+</TT
 740 >), with
 741     the effect that access to untrusted sites will be granted, if a link from a
 742     trusted referrer was used.
 743     The link target will then be added to the <SPAN
 744 CLASS="QUOTE"
 745 >"trustfile"</SPAN
 746 >.
 747     Possible applications include limiting Internet access for children.
 748    </P
 749 ><P
 750 >    If you use <TT
 751 CLASS="LITERAL"
 752 >+</TT
 753 > operator in the trust file, it may grow considerably over time.
 754    </P
 755 ></DD
 756 ></DL
 757 ></DIV
 758 ></DIV
 759 ></DIV
 760 ><DIV
 761 CLASS="SECT2"
 762 ><H2
 763 CLASS="SECT2"
 764 ><A
 765 NAME="LOCAL-SET-UP"
 766 >7.2. Local Set-up Documentation</A
 767 ></H2
 768 ><P
 769 >    If you intend to operate <SPAN
 770 CLASS="APPLICATION"
 771 >Privoxy</SPAN
 772 > for more users
 773     that just yourself, it might be a good idea to let them know how to reach
 774     you, what you block and why you do that, your policies etc.
 775    </P
 776 ><DIV
 777 CLASS="SECT3"
 778 ><H4
 779 CLASS="SECT3"
 780 ><A
 781 NAME="USER-MANUAL"
 782 >7.2.1. user-manual</A
 783 ></H4
 784 ><P
 785 ></P
 786 ><DIV
 787 CLASS="VARIABLELIST"
 788 ><DL
 789 ><DT
 790 >Specifies:</DT
 791 ><DD
 792 ><P
 793 >    Location of the <SPAN
 794 CLASS="APPLICATION"
 795 >Privoxy</SPAN
 796 > User Manual.
 797    </P
 798 ></DD
 799 ><DT
 800 >Type of value:</DT
 801 ><DD
 802 ><P
 803 >A fully qualified URI</P
 804 ></DD
 805 ><DT
 806 >Default value:</DT
 807 ><DD
 808 ><P
 809 ><I
 810 CLASS="EMPHASIS"
 811 >Unset</I
 812 ></P
 813 ></DD
 814 ><DT
 815 >Effect if unset:</DT
 816 ><DD
 817 ><P
 818 >    <A
 819 HREF="http://www.privoxy.org/user-manual/"
 820 TARGET="_top"
 821 >http://www.privoxy.org/<TT
 822 CLASS="REPLACEABLE"
 823 ><I
 824 >version</I
 825 ></TT
 826 >/user-manual/</A
 827 >
 828     will be used, where <TT
 829 CLASS="REPLACEABLE"
 830 ><I
 831 >version</I
 832 ></TT
 833 > is the <SPAN
 834 CLASS="APPLICATION"
 835 >Privoxy</SPAN
 836 > version.
 837    </P
 838 ></DD
 839 ><DT
 840 >Notes:</DT
 841 ><DD
 842 ><P
 843 >    The User Manual URI is used for help links from some of the internal CGI pages.
 844     The manual itself is normally packaged with the binary distributions, so you propably want
 845     to set this to a locally installed copy. For multi-user setups, you could provide a copy on
 846     a local webserver for all your users and use the corresponding URL here.
 847    </P
 848 ><P
 849 >    Examples:
 850    </P
 851 ><P
 852 >   Unix, in local filesystem:
 853   </P
 854 ><P
 855 >   <TABLE
 856 BORDER="0"
 857 BGCOLOR="#E0E0E0"
 858 WIDTH="90%"
 859 ><TR
 860 ><TD
 861 ><PRE
 862 CLASS="SCREEN"
 863 >user-manual  file:///usr/share/doc/privoxy-2.9.15/user-manual/</PRE
 864 ></TD
 865 ></TR
 866 ></TABLE
 867 >
 868   </P
 869 ><P
 870 >   Any platform, on local webserver (called <SPAN
 871 CLASS="QUOTE"
 872 >"local-webserver"</SPAN
 873 >):
 874   </P
 875 ><P
 876 >   <TABLE
 877 BORDER="0"
 878 BGCOLOR="#E0E0E0"
 879 WIDTH="90%"
 880 ><TR
 881 ><TD
 882 ><PRE
 883 CLASS="SCREEN"
 884 >user-manual  http://local-webserver/privoxy-user-manual/</PRE
 885 ></TD
 886 ></TR
 887 ></TABLE
 888 >
 889   </P
 890 ><DIV
 891 CLASS="WARNING"
 892 ><P
 893 ></P
 894 ><TABLE
 895 CLASS="WARNING"
 896 BORDER="1"
 897 WIDTH="90%"
 898 ><TR
 899 ><TD
 900 ALIGN="CENTER"
 901 ><B
 902 >Warning</B
 903 ></TD
 904 ></TR
 905 ><TR
 906 ><TD
 907 ALIGN="LEFT"
 908 ><P
 909 >     If set, this option should be <I
 910 CLASS="EMPHASIS"
 911 >the first option in the config file</I
 912 >, because
 913      it is used while the config file is being read.
 914    </P
 915 ></TD
 916 ></TR
 917 ></TABLE
 918 ></DIV
 919 ></DD
 920 ></DL
 921 ></DIV
 922 ></DIV
 923 ><DIV
 924 CLASS="SECT3"
 925 ><H4
 926 CLASS="SECT3"
 927 ><A
 928 NAME="TRUST-INFO-URL"
 929 >7.2.2. trust-info-url</A
 930 ></H4
 931 ><P
 932 ></P
 933 ><DIV
 934 CLASS="VARIABLELIST"
 935 ><DL
 936 ><DT
 937 >Specifies:</DT
 938 ><DD
 939 ><P
 940 >    A URL to be displayed in the error page that users will see if access to an untrusted page is denied.
 941    </P
 942 ></DD
 943 ><DT
 944 >Type of value:</DT
 945 ><DD
 946 ><P
 947 >URL</P
 948 ></DD
 949 ><DT
 950 >Default value:</DT
 951 ><DD
 952 ><P
 953 >Two example URL are provided</P
 954 ></DD
 955 ><DT
 956 >Effect if unset:</DT
 957 ><DD
 958 ><P
 959 >    No links are displayed on the "untrusted" error page.
 960    </P
 961 ></DD
 962 ><DT
 963 >Notes:</DT
 964 ><DD
 965 ><P
 966 >    The value of this option only matters if the experimental trust mechanism has been
 967     activated. (See <TT
 968 CLASS="LITERAL"
 969 >trustfile</TT
 970 > above.)
 971    </P
 972 ><P
 973 >    If you use the trust mechanism, it is a good idea to write up some on-line
 974     documentation about your trust policy and to specify the URL(s) here.
 975     Use multiple times for multiple URLs.
 976    </P
 977 ><P
 978 >    The URL(s) should be added to the trustfile as well, so users don't end up
 979     locked out from the information on why they were locked out in the first place!
 980    </P
 981 ></DD
 982 ></DL
 983 ></DIV
 984 ></DIV
 985 ><DIV
 986 CLASS="SECT3"
 987 ><H4
 988 CLASS="SECT3"
 989 ><A
 990 NAME="ADMIN-ADDRESS"
 991 >7.2.3. admin-address</A
 992 ></H4
 993 ><P
 994 ></P
 995 ><DIV
 996 CLASS="VARIABLELIST"
 997 ><DL
 998 ><DT
 999 >Specifies:</DT
1000 ><DD
1001 ><P
1002 >    An email address to reach the proxy administrator.
1003    </P
1004 ></DD
1005 ><DT
1006 >Type of value:</DT
1007 ><DD
1008 ><P
1009 >Email address</P
1010 ></DD
1011 ><DT
1012 >Default value:</DT
1013 ><DD
1014 ><P
1015 ><I
1016 CLASS="EMPHASIS"
1017 >Unset</I
1018 ></P
1019 ></DD
1020 ><DT
1021 >Effect if unset:</DT
1022 ><DD
1023 ><P
1024 >    No email address is displayed on error pages and the CGI user interface.
1025    </P
1026 ></DD
1027 ><DT
1028 >Notes:</DT
1029 ><DD
1030 ><P
1031 >    If both <TT
1032 CLASS="LITERAL"
1033 >admin-address</TT
1034 > and <TT
1035 CLASS="LITERAL"
1036 >proxy-info-url</TT
1037 >
1038     are unset, the whole "Local Privoxy Support" box on all generated pages will
1039     not be shown.
1040    </P
1041 ></DD
1042 ></DL
1043 ></DIV
1044 ></DIV
1045 ><DIV
1046 CLASS="SECT3"
1047 ><H4
1048 CLASS="SECT3"
1049 ><A
1050 NAME="PROXY-INFO-URL"
1051 >7.2.4. proxy-info-url</A
1052 ></H4
1053 ><P
1054 ></P
1055 ><DIV
1056 CLASS="VARIABLELIST"
1057 ><DL
1058 ><DT
1059 >Specifies:</DT
1060 ><DD
1061 ><P
1062 >    A URL to documentation about the local <SPAN
1063 CLASS="APPLICATION"
1064 >Privoxy</SPAN
1065 > setup,
1066     configuration or policies.
1067    </P
1068 ></DD
1069 ><DT
1070 >Type of value:</DT
1071 ><DD
1072 ><P
1073 >URL</P
1074 ></DD
1075 ><DT
1076 >Default value:</DT
1077 ><DD
1078 ><P
1079 ><I
1080 CLASS="EMPHASIS"
1081 >Unset</I
1082 ></P
1083 ></DD
1084 ><DT
1085 >Effect if unset:</DT
1086 ><DD
1087 ><P
1088 >    No link to local documentation is displayed on error pages and the CGI user interface.
1089    </P
1090 ></DD
1091 ><DT
1092 >Notes:</DT
1093 ><DD
1094 ><P
1095 >    If both <TT
1096 CLASS="LITERAL"
1097 >admin-address</TT
1098 > and <TT
1099 CLASS="LITERAL"
1100 >proxy-info-url</TT
1101 >
1102     are unset, the whole "Local Privoxy Support" box on all generated pages will
1103     not be shown.
1104    </P
1105 ><P
1106 >    This URL shouldn't be blocked ;-)
1107    </P
1108 ></DD
1109 ></DL
1110 ></DIV
1111 ></DIV
1112 ></DIV
1113 ><DIV
1114 CLASS="SECT2"
1115 ><H2
1116 CLASS="SECT2"
1117 ><A
1118 NAME="DEBUGGING"
1119 >7.3. Debugging</A
1120 ></H2
1121 ><P
1122 >  These options are mainly useful when tracing a problem.
1123   Note that you might also want to invoke
1124   <SPAN
1125 CLASS="APPLICATION"
1126 >Privoxy</SPAN
1127 > with the <TT
1128 CLASS="LITERAL"
1129 >--no-daemon</TT
1130 >
1131   command line option when debugging.
1132  </P
1133 ><DIV
1134 CLASS="SECT3"
1135 ><H4
1136 CLASS="SECT3"
1137 ><A
1138 NAME="DEBUG"
1139 >7.3.1. debug</A
1140 ></H4
1141 ><P
1142 ></P
1143 ><DIV
1144 CLASS="VARIABLELIST"
1145 ><DL
1146 ><DT
1147 >Specifies:</DT
1148 ><DD
1149 ><P
1150 >    Key values that determine what information gets logged.
1151    </P
1152 ></DD
1153 ><DT
1154 >Type of value:</DT
1155 ><DD
1156 ><P
1157 >Integer values</P
1158 ></DD
1159 ><DT
1160 >Default value:</DT
1161 ><DD
1162 ><P
1163 >12289 (i.e.: URLs plus informational and warning messages)</P
1164 ></DD
1165 ><DT
1166 >Effect if unset:</DT
1167 ><DD
1168 ><P
1169 >    Nothing gets logged.
1170    </P
1171 ></DD
1172 ><DT
1173 >Notes:</DT
1174 ><DD
1175 ><P
1176 >    The available debug levels are:
1177    </P
1178 ><P
1179 >    <TABLE
1180 BORDER="0"
1181 BGCOLOR="#E0E0E0"
1182 WIDTH="90%"
1183 ><TR
1184 ><TD
1185 ><PRE
1186 CLASS="PROGRAMLISTING"
1187 >  debug         1 # show each GET/POST/CONNECT request
1188   debug         2 # show each connection status
1189   debug         4 # show I/O status
1190   debug         8 # show header parsing
1191   debug        16 # log all data into the logfile
1192   debug        32 # debug force feature
1193   debug        64 # debug regular expression filter
1194   debug       128 # debug fast redirects
1195   debug       256 # debug GIF de-animation
1196   debug       512 # Common Log Format
1197   debug      1024 # debug kill pop-ups
1198   debug      4096 # Startup banner and warnings.
1199   debug      8192 # Non-fatal errors</PRE
1200 ></TD
1201 ></TR
1202 ></TABLE
1203 >
1204    </P
1205 ><P
1206 >    To select multiple debug levels, you can either add them or use
1207     multiple <TT
1208 CLASS="LITERAL"
1209 >debug</TT
1210 > lines.
1211    </P
1212 ><P
1213 >    A debug level of 1 is informative because it will show you each request
1214     as it happens. <I
1215 CLASS="EMPHASIS"
1216 >1, 4096 and 8192 are highly recommended</I
1217 >
1218     so that you will notice when things go wrong. The other levels are probably
1219     only of interest if you are hunting down a specific problem. They can produce
1220     a hell of an output (especially 16).
1221
1222    </P
1223 ><P
1224 >    The reporting of <I
1225 CLASS="EMPHASIS"
1226 >fatal</I
1227 > errors (i.e. ones which crash
1228     <SPAN
1229 CLASS="APPLICATION"
1230 >Privoxy</SPAN
1231 >) is always on and cannot be disabled.
1232    </P
1233 ><P
1234 >    If you want to use CLF (Common Log Format), you should set <SPAN
1235 CLASS="QUOTE"
1236 >"debug
1237     512"</SPAN
1238 > <I
1239 CLASS="EMPHASIS"
1240 >ONLY</I
1241 > and not enable anything else.
1242    </P
1243 ></DD
1244 ></DL
1245 ></DIV
1246 ></DIV
1247 ><DIV
1248 CLASS="SECT3"
1249 ><H4
1250 CLASS="SECT3"
1251 ><A
1252 NAME="SINGLE-THREADED"
1253 >7.3.2. single-threaded</A
1254 ></H4
1255 ><P
1256 ></P
1257 ><DIV
1258 CLASS="VARIABLELIST"
1259 ><DL
1260 ><DT
1261 >Specifies:</DT
1262 ><DD
1263 ><P
1264 >    Whether to run only one server thread
1265    </P
1266 ></DD
1267 ><DT
1268 >Type of value:</DT
1269 ><DD
1270 ><P
1271 ><I
1272 CLASS="EMPHASIS"
1273 >None</I
1274 ></P
1275 ></DD
1276 ><DT
1277 >Default value:</DT
1278 ><DD
1279 ><P
1280 ><I
1281 CLASS="EMPHASIS"
1282 >Unset</I
1283 ></P
1284 ></DD
1285 ><DT
1286 >Effect if unset:</DT
1287 ><DD
1288 ><P
1289 >    Multi-threaded (or, where unavailable: forked) operation, i.e. the ability to
1290     serve multiple requests simultaneously.
1291    </P
1292 ></DD
1293 ><DT
1294 >Notes:</DT
1295 ><DD
1296 ><P
1297 >    This option is only there for debug purposes and you should never
1298     need to use it. <I
1299 CLASS="EMPHASIS"
1300 >It will drastically reduce performance.</I
1301 >
1302    </P
1303 ></DD
1304 ></DL
1305 ></DIV
1306 ></DIV
1307 ></DIV
1308 ><DIV
1309 CLASS="SECT2"
1310 ><H2
1311 CLASS="SECT2"
1312 ><A
1313 NAME="ACCESS-CONTROL"
1314 >7.4. Access Control and Security</A
1315 ></H2
1316 ><P
1317 >  This section of the config file controls the security-relevant aspects
1318   of <SPAN
1319 CLASS="APPLICATION"
1320 >Privoxy</SPAN
1321 >'s configuration.
1322  </P
1323 ><DIV
1324 CLASS="SECT3"
1325 ><H4
1326 CLASS="SECT3"
1327 ><A
1328 NAME="LISTEN-ADDRESS"
1329 >7.4.1. listen-address</A
1330 ></H4
1331 ><P
1332 ></P
1333 ><DIV
1334 CLASS="VARIABLELIST"
1335 ><DL
1336 ><DT
1337 >Specifies:</DT
1338 ><DD
1339 ><P
1340 >    The IP address and TCP port on which <SPAN
1341 CLASS="APPLICATION"
1342 >Privoxy</SPAN
1343 > will
1344     listen for client requests.
1345    </P
1346 ></DD
1347 ><DT
1348 >Type of value:</DT
1349 ><DD
1350 ><P
1351 >[<TT
1352 CLASS="REPLACEABLE"
1353 ><I
1354 >IP-Address</I
1355 ></TT
1356 >]:<TT
1357 CLASS="REPLACEABLE"
1358 ><I
1359 >Port</I
1360 ></TT
1361 ></P
1362 ></DD
1363 ><DT
1364 >Default value:</DT
1365 ><DD
1366 ><P
1367 >localhost:8118</P
1368 ></DD
1369 ><DT
1370 >Effect if unset:</DT
1371 ><DD
1372 ><P
1373 >    Bind to localhost (127.0.0.1), port 8118. This is suitable and recommended for
1374     home users who run <SPAN
1375 CLASS="APPLICATION"
1376 >Privoxy</SPAN
1377 > on the same machine as
1378     their browser.
1379    </P
1380 ></DD
1381 ><DT
1382 >Notes:</DT
1383 ><DD
1384 ><P
1385 >    You will need to configure your browser(s) to this proxy address and port.
1386    </P
1387 ><P
1388 >    If you already have another service running on port 8118, or if you want to
1389     serve requests from other machines (e.g. on your local network) as well, you
1390     will need to override the default.
1391    </P
1392 ><P
1393 >    If you leave out the IP address, <SPAN
1394 CLASS="APPLICATION"
1395 >Privoxy</SPAN
1396 > will
1397     bind to all interfaces (addresses) on your machine and may become reachable
1398     from the Internet. In that case, consider using access control lists (ACL's)
1399     (see <SPAN
1400 CLASS="QUOTE"
1401 >"ACLs"</SPAN
1402 > below), or a firewall.
1403    </P
1404 ></DD
1405 ><DT
1406 >Example:</DT
1407 ><DD
1408 ><P
1409 >     Suppose you are running <SPAN
1410 CLASS="APPLICATION"
1411 >Privoxy</SPAN
1412 > on
1413      a machine which has the address 192.168.0.1 on your local private network
1414      (192.168.0.0) and has another outside connection with a different address.
1415      You want it to serve requests from inside only:
1416    </P
1417 ><P
1418 >    <TABLE
1419 BORDER="0"
1420 BGCOLOR="#E0E0E0"
1421 WIDTH="90%"
1422 ><TR
1423 ><TD
1424 ><PRE
1425 CLASS="PROGRAMLISTING"
1426 >  listen-address  192.168.0.1:8118</PRE
1427 ></TD
1428 ></TR
1429 ></TABLE
1430 >
1431    </P
1432 ></DD
1433 ></DL
1434 ></DIV
1435 ></DIV
1436 ><DIV
1437 CLASS="SECT3"
1438 ><H4
1439 CLASS="SECT3"
1440 ><A
1441 NAME="TOGGLE"
1442 >7.4.2. toggle</A
1443 ></H4
1444 ><P
1445 ></P
1446 ><DIV
1447 CLASS="VARIABLELIST"
1448 ><DL
1449 ><DT
1450 >Specifies:</DT
1451 ><DD
1452 ><P
1453 >    Initial state of "toggle" status
1454    </P
1455 ></DD
1456 ><DT
1457 >Type of value:</DT
1458 ><DD
1459 ><P
1460 >1 or 0</P
1461 ></DD
1462 ><DT
1463 >Default value:</DT
1464 ><DD
1465 ><P
1466 >1</P
1467 ></DD
1468 ><DT
1469 >Effect if unset:</DT
1470 ><DD
1471 ><P
1472 >    Act as if toggled on
1473    </P
1474 ></DD
1475 ><DT
1476 >Notes:</DT
1477 ><DD
1478 ><P
1479 >    If set to 0, <SPAN
1480 CLASS="APPLICATION"
1481 >Privoxy</SPAN
1482 > will start in
1483     <SPAN
1484 CLASS="QUOTE"
1485 >"toggled off"</SPAN
1486 > mode, i.e. behave like a normal, content-neutral
1487     proxy. See <TT
1488 CLASS="LITERAL"
1489 >enable-remote-toggle</TT
1490 >
1491     below. This is not really useful anymore, since toggling is much easier
1492     via <A
1493 HREF="http://config.privoxy.org/toggle"
1494 TARGET="_top"
1495 >the web
1496     interface</A
1497 > than via editing the <TT
1498 CLASS="FILENAME"
1499 >conf</TT
1500 > file.
1501    </P
1502 ><P
1503 >    The windows version will only display the toggle icon in the system tray
1504     if this option is present.
1505    </P
1506 ></DD
1507 ></DL
1508 ></DIV
1509 ></DIV
1510 ><DIV
1511 CLASS="SECT3"
1512 ><H4
1513 CLASS="SECT3"
1514 ><A
1515 NAME="ENABLE-REMOTE-TOGGLE"
1516 >7.4.3. enable-remote-toggle</A
1517 ></H4
1518 ><P
1519 ></P
1520 ><DIV
1521 CLASS="VARIABLELIST"
1522 ><DL
1523 ><DT
1524 >Specifies:</DT
1525 ><DD
1526 ><P
1527 >    Whether or not the <A
1528 HREF="http://config.privoxy.org/toggle"
1529 TARGET="_top"
1530 >web-based toggle
1531     feature</A
1532 > may be used
1533    </P
1534 ></DD
1535 ><DT
1536 >Type of value:</DT
1537 ><DD
1538 ><P
1539 >0 or 1</P
1540 ></DD
1541 ><DT
1542 >Default value:</DT
1543 ><DD
1544 ><P
1545 >1</P
1546 ></DD
1547 ><DT
1548 >Effect if unset:</DT
1549 ><DD
1550 ><P
1551 >    The web-based toggle feature is disabled.
1552    </P
1553 ></DD
1554 ><DT
1555 >Notes:</DT
1556 ><DD
1557 ><P
1558 >    When toggled off, <SPAN
1559 CLASS="APPLICATION"
1560 >Privoxy</SPAN
1561 > acts like a normal,
1562     content-neutral proxy, i.e. it acts as if none of the actions applied to
1563     any URL.
1564    </P
1565 ><P
1566 >    For the time being, access to the toggle feature can <I
1567 CLASS="EMPHASIS"
1568 >not</I
1569 > be
1570     controlled separately by <SPAN
1571 CLASS="QUOTE"
1572 >"ACLs"</SPAN
1573 > or HTTP authentication,
1574     so that everybody who can access <SPAN
1575 CLASS="APPLICATION"
1576 >Privoxy</SPAN
1577 > (see
1578     <SPAN
1579 CLASS="QUOTE"
1580 >"ACLs"</SPAN
1581 > and <TT
1582 CLASS="LITERAL"
1583 >listen-address</TT
1584 > above) can
1585     toggle it for all users. So this option is <I
1586 CLASS="EMPHASIS"
1587 >not recommended</I
1588 >
1589     for multi-user environments with untrusted users.
1590    </P
1591 ><P
1592 >    Note that you must have compiled <SPAN
1593 CLASS="APPLICATION"
1594 >Privoxy</SPAN
1595 > with
1596     support for this feature, otherwise this option has no effect.
1597    </P
1598 ></DD
1599 ></DL
1600 ></DIV
1601 ></DIV
1602 ><DIV
1603 CLASS="SECT3"
1604 ><H4
1605 CLASS="SECT3"
1606 ><A
1607 NAME="ENABLE-EDIT-ACTIONS"
1608 >7.4.4. enable-edit-actions</A
1609 ></H4
1610 ><P
1611 ></P
1612 ><DIV
1613 CLASS="VARIABLELIST"
1614 ><DL
1615 ><DT
1616 >Specifies:</DT
1617 ><DD
1618 ><P
1619 >    Whether or not the <A
1620 HREF="http://config.privoxy.org/show-status"
1621 TARGET="_top"
1622 >web-based actions
1623     file editor</A
1624 > may be used
1625    </P
1626 ></DD
1627 ><DT
1628 >Type of value:</DT
1629 ><DD
1630 ><P
1631 >0 or 1</P
1632 ></DD
1633 ><DT
1634 >Default value:</DT
1635 ><DD
1636 ><P
1637 >1</P
1638 ></DD
1639 ><DT
1640 >Effect if unset:</DT
1641 ><DD
1642 ><P
1643 >    The web-based actions file editor is disabled.
1644    </P
1645 ></DD
1646 ><DT
1647 >Notes:</DT
1648 ><DD
1649 ><P
1650 >    For the time being, access to the editor can <I
1651 CLASS="EMPHASIS"
1652 >not</I
1653 > be
1654     controlled separately by <SPAN
1655 CLASS="QUOTE"
1656 >"ACLs"</SPAN
1657 > or HTTP authentication,
1658     so that everybody who can access <SPAN
1659 CLASS="APPLICATION"
1660 >Privoxy</SPAN
1661 > (see
1662     <SPAN
1663 CLASS="QUOTE"
1664 >"ACLs"</SPAN
1665 > and <TT
1666 CLASS="LITERAL"
1667 >listen-address</TT
1668 > above) can
1669     modify its configuration for all users. So this option is <I
1670 CLASS="EMPHASIS"
1671 >not
1672     recommended</I
1673 > for multi-user environments with untrusted users.
1674    </P
1675 ><P
1676 >    Note that you must have compiled <SPAN
1677 CLASS="APPLICATION"
1678 >Privoxy</SPAN
1679 > with
1680     support for this feature, otherwise this option has no effect.
1681    </P
1682 ></DD
1683 ></DL
1684 ></DIV
1685 ></DIV
1686 ><DIV
1687 CLASS="SECT3"
1688 ><H4
1689 CLASS="SECT3"
1690 ><A
1691 NAME="ACLS"
1692 >7.4.5. ACLs: permit-access and deny-access</A
1693 ></H4
1694 ><A
1695 NAME="PERMIT-ACCES"
1696 ></A
1697 ><A
1698 NAME="DENY-ACCES"
1699 ></A
1700 ><P
1701 ></P
1702 ><DIV
1703 CLASS="VARIABLELIST"
1704 ><DL
1705 ><DT
1706 >Specifies:</DT
1707 ><DD
1708 ><P
1709 >    Who can access what.
1710    </P
1711 ></DD
1712 ><DT
1713 >Type of value:</DT
1714 ><DD
1715 ><P
1716 >    <TT
1717 CLASS="REPLACEABLE"
1718 ><I
1719 >src_addr</I
1720 ></TT
1721 >[/<TT
1722 CLASS="REPLACEABLE"
1723 ><I
1724 >src_masklen</I
1725 ></TT
1726 >]
1727     [<TT
1728 CLASS="REPLACEABLE"
1729 ><I
1730 >dst_addr</I
1731 ></TT
1732 >[/<TT
1733 CLASS="REPLACEABLE"
1734 ><I
1735 >dst_masklen</I
1736 ></TT
1737 >]]
1738    </P
1739 ><P
1740 >    Where <TT
1741 CLASS="REPLACEABLE"
1742 ><I
1743 >src_addr</I
1744 ></TT
1745 > and
1746    <TT
1747 CLASS="REPLACEABLE"
1748 ><I
1749 >dst_addr</I
1750 ></TT
1751 > are IP addresses in dotted decimal notation or valid
1752     DNS names, and <TT
1753 CLASS="REPLACEABLE"
1754 ><I
1755 >src_masklen</I
1756 ></TT
1757 > and
1758     <TT
1759 CLASS="REPLACEABLE"
1760 ><I
1761 >dst_masklen</I
1762 ></TT
1763 > are subnet masks in CIDR notation, i.e. integer
1764     values from 2 to 30 representing the length (in bits) of the network address. The masks and the whole
1765     destination part are optional.
1766    </P
1767 ></DD
1768 ><DT
1769 >Default value:</DT
1770 ><DD
1771 ><P
1772 ><I
1773 CLASS="EMPHASIS"
1774 >Unset</I
1775 ></P
1776 ></DD
1777 ><DT
1778 >Effect if unset:</DT
1779 ><DD
1780 ><P
1781 >    Don't restrict access further than implied by <TT
1782 CLASS="LITERAL"
1783 >listen-address</TT
1784 >
1785    </P
1786 ></DD
1787 ><DT
1788 >Notes:</DT
1789 ><DD
1790 ><P
1791 >    Access controls are included at the request of ISPs and systems
1792     administrators, and <I
1793 CLASS="EMPHASIS"
1794 >are not usually needed by individual users</I
1795 >.
1796     For a typical home user, it will normally suffice to ensure that
1797     <SPAN
1798 CLASS="APPLICATION"
1799 >Privoxy</SPAN
1800 > only listens on the localhost or internal (home)
1801     network address by means of the <TT
1802 CLASS="LITERAL"
1803 >listen-address</TT
1804 > option.
1805    </P
1806 ><P
1807 >    Please see the warnings in the FAQ that this proxy is not intended to be a substitute
1808     for a firewall or to encourage anyone to defer addressing basic security
1809     weaknesses.
1810    </P
1811 ><P
1812 >    Multiple ACL lines are OK.
1813     If any ACLs are specified, then the <SPAN
1814 CLASS="APPLICATION"
1815 >Privoxy</SPAN
1816 >
1817     talks only to IP addresses that match at least one <TT
1818 CLASS="LITERAL"
1819 >permit-access</TT
1820 > line
1821     and don't match any subsequent <TT
1822 CLASS="LITERAL"
1823 >deny-access</TT
1824 > line. In other words, the
1825     last match wins, with the default being <TT
1826 CLASS="LITERAL"
1827 >deny-access</TT
1828 >.
1829    </P
1830 ><P
1831 >    If <SPAN
1832 CLASS="APPLICATION"
1833 >Privoxy</SPAN
1834 > is using a forwarder (see <TT
1835 CLASS="LITERAL"
1836 >forward</TT
1837 > below)
1838     for a particular destination URL, the <TT
1839 CLASS="REPLACEABLE"
1840 ><I
1841 >dst_addr</I
1842 ></TT
1843 >
1844     that is examined is the address of the forwarder and <I
1845 CLASS="EMPHASIS"
1846 >NOT</I
1847 > the address
1848     of the ultimate target. This is necessary because it may be impossible for the local
1849     <SPAN
1850 CLASS="APPLICATION"
1851 >Privoxy</SPAN
1852 > to determine the IP address of the
1853     ultimate target (that's often what gateways are used for).
1854    </P
1855 ><P
1856 >    You should prefer using IP addresses over DNS names, because the address lookups take
1857     time. All DNS names must resolve! You can <I
1858 CLASS="EMPHASIS"
1859 >not</I
1860 > use domain patterns
1861     like <SPAN
1862 CLASS="QUOTE"
1863 >"*.org"</SPAN
1864 > or partial domain names. If a DNS name resolves to multiple
1865     IP addresses, only the first one is used.
1866    </P
1867 ><P
1868 >    Denying access to particular sites by ACL may have undesired side effects
1869     if the site in question is hosted on a machine which also hosts other sites.
1870    </P
1871 ></DD
1872 ><DT
1873 >Examples:</DT
1874 ><DD
1875 ><P
1876 >    Explicitly define the default behavior if no ACL and
1877     <TT
1878 CLASS="LITERAL"
1879 >listen-address</TT
1880 > are set: <SPAN
1881 CLASS="QUOTE"
1882 >"localhost"</SPAN
1883 >
1884     is OK. The absence of a <TT
1885 CLASS="REPLACEABLE"
1886 ><I
1887 >dst_addr</I
1888 ></TT
1889 > implies that
1890     <I
1891 CLASS="EMPHASIS"
1892 >all</I
1893 > destination addresses are OK:
1894    </P
1895 ><P
1896 >    <TABLE
1897 BORDER="0"
1898 BGCOLOR="#E0E0E0"
1899 WIDTH="90%"
1900 ><TR
1901 ><TD
1902 ><PRE
1903 CLASS="SCREEN"
1904 >  permit-access  localhost</PRE
1905 ></TD
1906 ></TR
1907 ></TABLE
1908 >
1909    </P
1910 ><P
1911 >    Allow any host on the same class C subnet as www.privoxy.org access to
1912     nothing but www.example.com:
1913    </P
1914 ><P
1915 >    <TABLE
1916 BORDER="0"
1917 BGCOLOR="#E0E0E0"
1918 WIDTH="90%"
1919 ><TR
1920 ><TD
1921 ><PRE
1922 CLASS="SCREEN"
1923 >  permit-access  www.privoxy.org/24 www.example.com/32</PRE
1924 ></TD
1925 ></TR
1926 ></TABLE
1927 >
1928    </P
1929 ><P
1930 >    Allow access from any host on the 26-bit subnet 192.168.45.64 to anywhere,
1931     with the exception that 192.168.45.73 may not access www.dirty-stuff.example.com:
1932    </P
1933 ><P
1934 >    <TABLE
1935 BORDER="0"
1936 BGCOLOR="#E0E0E0"
1937 WIDTH="90%"
1938 ><TR
1939 ><TD
1940 ><PRE
1941 CLASS="SCREEN"
1942 >  permit-access  192.168.45.64/26
1943   deny-access    192.168.45.73    www.dirty-stuff.example.com</PRE
1944 ></TD
1945 ></TR
1946 ></TABLE
1947 >
1948    </P
1949 ></DD
1950 ></DL
1951 ></DIV
1952 ></DIV
1953 ><DIV
1954 CLASS="SECT3"
1955 ><H4
1956 CLASS="SECT3"
1957 ><A
1958 NAME="BUFFER-LIMIT"
1959 >7.4.6. buffer-limit</A
1960 ></H4
1961 ><P
1962 ></P
1963 ><DIV
1964 CLASS="VARIABLELIST"
1965 ><DL
1966 ><DT
1967 >Specifies:</DT
1968 ><DD
1969 ><P
1970 >    Maximum size of the buffer for content filtering.
1971    </P
1972 ></DD
1973 ><DT
1974 >Type of value:</DT
1975 ><DD
1976 ><P
1977 >Size in Kbytes</P
1978 ></DD
1979 ><DT
1980 >Default value:</DT
1981 ><DD
1982 ><P
1983 >4096</P
1984 ></DD
1985 ><DT
1986 >Effect if unset:</DT
1987 ><DD
1988 ><P
1989 >    Use a 4MB (4096 KB) limit.
1990    </P
1991 ></DD
1992 ><DT
1993 >Notes:</DT
1994 ><DD
1995 ><P
1996 >    For content filtering, i.e. the <TT
1997 CLASS="LITERAL"
1998 >+filter</TT
1999 > and
2000     <TT
2001 CLASS="LITERAL"
2002 >+deanimate-gif</TT
2003 > actions, it is necessary that
2004     <SPAN
2005 CLASS="APPLICATION"
2006 >Privoxy</SPAN
2007 > buffers the entire document body.
2008     This can be potentially dangerous, since a server could just keep sending
2009     data indefinitely and wait for your RAM to exhaust -- with nasty consequences.
2010     Hence this option.
2011    </P
2012 ><P
2013 >    When a document buffer size reaches the <TT
2014 CLASS="LITERAL"
2015 >buffer-limit</TT
2016 >, it is
2017     flushed to the client unfiltered and no further attempt to
2018     filter the rest of the document is made. Remember that there may be multiple threads
2019     running, which might require up to <TT
2020 CLASS="LITERAL"
2021 >buffer-limit</TT
2022 > Kbytes
2023     <I
2024 CLASS="EMPHASIS"
2025 >each</I
2026 >, unless you have enabled <SPAN
2027 CLASS="QUOTE"
2028 >"single-threaded"</SPAN
2029 >
2030     above.
2031    </P
2032 ></DD
2033 ></DL
2034 ></DIV
2035 ></DIV
2036 ></DIV
2037 ><DIV
2038 CLASS="SECT2"
2039 ><H2
2040 CLASS="SECT2"
2041 ><A
2042 NAME="FORWARDING"
2043 >7.5. Forwarding</A
2044 ></H2
2045 ><P
2046 > This feature allows routing of HTTP requests through a chain of
2047  multiple proxies.
2048  It can be used to better protect privacy and confidentiality when
2049  accessing specific domains by routing requests to those domains
2050  through an anonymous public proxy (see e.g. <A
2051 HREF="http://www.multiproxy.org/anon_list.htm"
2052 TARGET="_top"
2053 >http://www.multiproxy.org/anon_list.htm</A
2054 >)
2055  Or to use a caching proxy to speed up browsing. Or chaining to a parent
2056  proxy may be necessary because the machine that <SPAN
2057 CLASS="APPLICATION"
2058 >Privoxy</SPAN
2059 >
2060  runs on has no direct Internet access.</P
2061 ><P
2062 > Also specified here are SOCKS proxies. <SPAN
2063 CLASS="APPLICATION"
2064 >Privoxy</SPAN
2065 >
2066  supports the SOCKS 4 and SOCKS 4A protocols.</P
2067 ><DIV
2068 CLASS="SECT3"
2069 ><H4
2070 CLASS="SECT3"
2071 ><A
2072 NAME="FORWARD"
2073 >7.5.1. forward</A
2074 ></H4
2075 ><P
2076 ></P
2077 ><DIV
2078 CLASS="VARIABLELIST"
2079 ><DL
2080 ><DT
2081 >Specifies:</DT
2082 ><DD
2083 ><P
2084 >    To which parent HTTP proxy specific requests should be routed.
2085    </P
2086 ></DD
2087 ><DT
2088 >Type of value:</DT
2089 ><DD
2090 ><P
2091 >    <TT
2092 CLASS="REPLACEABLE"
2093 ><I
2094 >target_domain</I
2095 ></TT
2096 >[:<TT
2097 CLASS="REPLACEABLE"
2098 ><I
2099 >port</I
2100 ></TT
2101 >]
2102     <TT
2103 CLASS="REPLACEABLE"
2104 ><I
2105 >http_parent</I
2106 ></TT
2107 >[/<TT
2108 CLASS="REPLACEABLE"
2109 ><I
2110 >port</I
2111 ></TT
2112 >]
2113    </P
2114 ><P
2115 >    Where <TT
2116 CLASS="REPLACEABLE"
2117 ><I
2118 >target_domain</I
2119 ></TT
2120 > is a domain name pattern (see the
2121     chapter on domain matching in the <TT
2122 CLASS="FILENAME"
2123 >default.action</TT
2124 > file),
2125     <TT
2126 CLASS="REPLACEABLE"
2127 ><I
2128 >http_parent</I
2129 ></TT
2130 > is the address of the parent HTTP proxy
2131     as an IP addresses in dotted decimal notation or as a valid DNS name (or <SPAN
2132 CLASS="QUOTE"
2133 >"."</SPAN
2134 > to denote
2135     <SPAN
2136 CLASS="QUOTE"
2137 >"no forwarding"</SPAN
2138 >, and the optional
2139     <TT
2140 CLASS="REPLACEABLE"
2141 ><I
2142 >port</I
2143 ></TT
2144 > parameters are TCP ports, i.e. integer
2145     values from 1 to 64535
2146    </P
2147 ></DD
2148 ><DT
2149 >Default value:</DT
2150 ><DD
2151 ><P
2152 ><I
2153 CLASS="EMPHASIS"
2154 >Unset</I
2155 ></P
2156 ></DD
2157 ><DT
2158 >Effect if unset:</DT
2159 ><DD
2160 ><P
2161 >    Don't use parent HTTP proxies.
2162    </P
2163 ></DD
2164 ><DT
2165 >Notes:</DT
2166 ><DD
2167 ><P
2168 >    If <TT
2169 CLASS="REPLACEABLE"
2170 ><I
2171 >http_parent</I
2172 ></TT
2173 > is <SPAN
2174 CLASS="QUOTE"
2175 >"."</SPAN
2176 >, then requests are not
2177     forwarded to another HTTP proxy but are made directly to the web servers.
2178    </P
2179 ><P
2180 >    Multiple lines are OK, they are checked in sequence, and the last match wins.
2181    </P
2182 ></DD
2183 ><DT
2184 >Examples:</DT
2185 ><DD
2186 ><P
2187 >    Everything goes to an example anonymizing proxy, except SSL on port 443 (which it doesn't handle):
2188    </P
2189 ><P
2190 >    <TABLE
2191 BORDER="0"
2192 BGCOLOR="#E0E0E0"
2193 WIDTH="90%"
2194 ><TR
2195 ><TD
2196 ><PRE
2197 CLASS="SCREEN"
2198 >  forward   .*     anon-proxy.example.org:8080
2199   forward   :443   .</PRE
2200 ></TD
2201 ></TR
2202 ></TABLE
2203 >
2204    </P
2205 ><P
2206 >    Everything goes to our example ISP's caching proxy, except for requests
2207     to that ISP's sites:
2208    </P
2209 ><P
2210 >    <TABLE
2211 BORDER="0"
2212 BGCOLOR="#E0E0E0"
2213 WIDTH="90%"
2214 ><TR
2215 ><TD
2216 ><PRE
2217 CLASS="SCREEN"
2218 >  forward   .*.                caching-proxy.example-isp.net:8000
2219   forward   .example-isp.net   .</PRE
2220 ></TD
2221 ></TR
2222 ></TABLE
2223 >
2224    </P
2225 ></DD
2226 ></DL
2227 ></DIV
2228 ></DIV
2229 ><DIV
2230 CLASS="SECT3"
2231 ><H4
2232 CLASS="SECT3"
2233 ><A
2234 NAME="SOCKS"
2235 >7.5.2. forward-socks4 and forward-socks4a</A
2236 ></H4
2237 ><A
2238 NAME="FORWARD-SOCKS4"
2239 ></A
2240 ><A
2241 NAME="FORWARD-SOCKS4A"
2242 ></A
2243 ><P
2244 ></P
2245 ><DIV
2246 CLASS="VARIABLELIST"
2247 ><DL
2248 ><DT
2249 >Specifies:</DT
2250 ><DD
2251 ><P
2252 >    Through which SOCKS proxy (and to which parent HTTP proxy) specific requests should be routed.
2253    </P
2254 ></DD
2255 ><DT
2256 >Type of value:</DT
2257 ><DD
2258 ><P
2259 >    <TT
2260 CLASS="REPLACEABLE"
2261 ><I
2262 >target_domain</I
2263 ></TT
2264 >[:<TT
2265 CLASS="REPLACEABLE"
2266 ><I
2267 >port</I
2268 ></TT
2269 >]
2270     <TT
2271 CLASS="REPLACEABLE"
2272 ><I
2273 >socks_proxy</I
2274 ></TT
2275 >[/<TT
2276 CLASS="REPLACEABLE"
2277 ><I
2278 >port</I
2279 ></TT
2280 >]
2281     <TT
2282 CLASS="REPLACEABLE"
2283 ><I
2284 >http_parent</I
2285 ></TT
2286 >[/<TT
2287 CLASS="REPLACEABLE"
2288 ><I
2289 >port</I
2290 ></TT
2291 >]
2292    </P
2293 ><P
2294 >    Where <TT
2295 CLASS="REPLACEABLE"
2296 ><I
2297 >target_domain</I
2298 ></TT
2299 > is a domain name pattern (see the
2300     chapter on domain matching in the <TT
2301 CLASS="FILENAME"
2302 >default.action</TT
2303 > file),
2304     <TT
2305 CLASS="REPLACEABLE"
2306 ><I
2307 >http_parent</I
2308 ></TT
2309 > and <TT
2310 CLASS="REPLACEABLE"
2311 ><I
2312 >socks_proxy</I
2313 ></TT
2314 >
2315     are IP addresses in dotted decimal notation or valid DNS names (<TT
2316 CLASS="REPLACEABLE"
2317 ><I
2318 >http_parent</I
2319 ></TT
2320 >
2321     may be <SPAN
2322 CLASS="QUOTE"
2323 >"."</SPAN
2324 > to denote <SPAN
2325 CLASS="QUOTE"
2326 >"no HTTP forwarding"</SPAN
2327 >), and the optional
2328     <TT
2329 CLASS="REPLACEABLE"
2330 ><I
2331 >port</I
2332 ></TT
2333 > parameters are TCP ports, i.e. integer values from 1 to 64535
2334    </P
2335 ></DD
2336 ><DT
2337 >Default value:</DT
2338 ><DD
2339 ><P
2340 ><I
2341 CLASS="EMPHASIS"
2342 >Unset</I
2343 ></P
2344 ></DD
2345 ><DT
2346 >Effect if unset:</DT
2347 ><DD
2348 ><P
2349 >    Don't use SOCKS proxies.
2350    </P
2351 ></DD
2352 ><DT
2353 >Notes:</DT
2354 ><DD
2355 ><P
2356 >    Multiple lines are OK, they are checked in sequence, and the last match wins.
2357    </P
2358 ><P
2359 >    The difference between <TT
2360 CLASS="LITERAL"
2361 >forward-socks4</TT
2362 > and <TT
2363 CLASS="LITERAL"
2364 >forward-socks4a</TT
2365 >
2366     is that in the SOCKS 4A protocol, the DNS resolution of the target hostname happens on the SOCKS
2367     server, while in SOCKS 4 it happens locally.
2368    </P
2369 ><P
2370 >    If <TT
2371 CLASS="REPLACEABLE"
2372 ><I
2373 >http_parent</I
2374 ></TT
2375 > is <SPAN
2376 CLASS="QUOTE"
2377 >"."</SPAN
2378 >, then requests are not
2379     forwarded to another HTTP proxy but are made (HTTP-wise) directly to the web servers, albeit through
2380     a SOCKS proxy.
2381    </P
2382 ></DD
2383 ><DT
2384 >Examples:</DT
2385 ><DD
2386 ><P
2387 >     From the company example.com, direct connections are made to all
2388      <SPAN
2389 CLASS="QUOTE"
2390 >"internal"</SPAN
2391 > domains, but everything outbound goes through
2392      their ISP's proxy by way of example.com's corporate SOCKS 4A gateway to
2393      the Internet.
2394    </P
2395 ><P
2396 >    <TABLE
2397 BORDER="0"
2398 BGCOLOR="#E0E0E0"
2399 WIDTH="90%"
2400 ><TR
2401 ><TD
2402 ><PRE
2403 CLASS="SCREEN"
2404 >  forward-socks4a   .*.            socks-gw.example.com:1080  www-cache.example-isp.net:8080
2405   forward           .example.com   .</PRE
2406 ></TD
2407 ></TR
2408 ></TABLE
2409 >
2410    </P
2411 ><P
2412 >    A rule that uses a SOCKS 4 gateway for all destinations but no HTTP parent looks like this:
2413    </P
2414 ><P
2415 >    <TABLE
2416 BORDER="0"
2417 BGCOLOR="#E0E0E0"
2418 WIDTH="90%"
2419 ><TR
2420 ><TD
2421 ><PRE
2422 CLASS="SCREEN"
2423 >  forward-socks4   .*.            socks-gw.example.com:1080  .</PRE
2424 ></TD
2425 ></TR
2426 ></TABLE
2427 >
2428    </P
2429 ></DD
2430 ></DL
2431 ></DIV
2432 ></DIV
2433 ><DIV
2434 CLASS="SECT3"
2435 ><H4
2436 CLASS="SECT3"
2437 ><A
2438 NAME="ADVANCED-FORWARDING-EXAMPLES"
2439 >7.5.3. Advanced Forwarding Examples</A
2440 ></H4
2441 ><P
2442 > If you have links to multiple ISPs that provide various special content
2443  only to their subscribers, you can configure multiple <SPAN
2444 CLASS="APPLICATION"
2445 >Privoxies</SPAN
2446 >
2447  which have connections to the respective ISPs to act as forwarders to each other, so that
2448  <I
2449 CLASS="EMPHASIS"
2450 >your</I
2451 > users can see the internal content of all ISPs.</P
2452 ><P
2453 > Assume that host-a has a PPP connection to isp-a.net. And host-b has a PPP connection to
2454  isp-b.net. Both run <SPAN
2455 CLASS="APPLICATION"
2456 >Privoxy</SPAN
2457 >. Their forwarding
2458  configuration can look like this:</P
2459 ><P
2460 > host-a:</P
2461 ><P
2462 > <TABLE
2463 BORDER="0"
2464 BGCOLOR="#E0E0E0"
2465 WIDTH="100%"
2466 ><TR
2467 ><TD
2468 ><PRE
2469 CLASS="SCREEN"
2470 >  forward    .*.         .
2471   forward    .isp-b.net  host-b:8118</PRE
2472 ></TD
2473 ></TR
2474 ></TABLE
2475 ></P
2476 ><P
2477 > host-b:</P
2478 ><P
2479 > <TABLE
2480 BORDER="0"
2481 BGCOLOR="#E0E0E0"
2482 WIDTH="100%"
2483 ><TR
2484 ><TD
2485 ><PRE
2486 CLASS="SCREEN"
2487 >  forward    .*.         .
2488   forward    .isp-a.net  host-a:8118</PRE
2489 ></TD
2490 ></TR
2491 ></TABLE
2492 ></P
2493 ><P
2494 > Now, your users can set their browser's proxy to use either
2495  host-a or host-b and be able to browse the internal content
2496  of both isp-a and isp-b.</P
2497 ><P
2498 > If you intend to chain <SPAN
2499 CLASS="APPLICATION"
2500 >Privoxy</SPAN
2501 > and
2502  <SPAN
2503 CLASS="APPLICATION"
2504 >squid</SPAN
2505 > locally, then chain as
2506  <TT
2507 CLASS="LITERAL"
2508 >browser -&#62; squid -&#62; privoxy</TT
2509 > is the recommended way. </P
2510 ><P
2511 > Assuming that <SPAN
2512 CLASS="APPLICATION"
2513 >Privoxy</SPAN
2514 > and <SPAN
2515 CLASS="APPLICATION"
2516 >squid</SPAN
2517 >
2518  run on the same box, your squid configuration could then look like this:</P
2519 ><P
2520 > <TABLE
2521 BORDER="0"
2522 BGCOLOR="#E0E0E0"
2523 WIDTH="100%"
2524 ><TR
2525 ><TD
2526 ><PRE
2527 CLASS="SCREEN"
2528 >  # Define Privoxy as parent proxy (without ICP)
2529   cache_peer 127.0.0.1 parent 8118 7 no-query
2530
2531   # Define ACL for protocol FTP
2532   acl ftp proto FTP
2533
2534   # Do not forward FTP requests to Privoxy
2535   always_direct allow ftp
2536
2537   # Forward all the rest to Privoxy
2538   never_direct allow all</PRE
2539 ></TD
2540 ></TR
2541 ></TABLE
2542 ></P
2543 ><P
2544 > You would then need to change your browser's proxy settings to <SPAN
2545 CLASS="APPLICATION"
2546 >squid</SPAN
2547 >'s address and port.
2548  Squid normally uses port 3128. If unsure consult <TT
2549 CLASS="LITERAL"
2550 >http_port</TT
2551 > in <TT
2552 CLASS="FILENAME"
2553 >squid.conf</TT
2554 >.</P
2555 ></DIV
2556 ></DIV
2557 ><DIV
2558 CLASS="SECT2"
2559 ><H2
2560 CLASS="SECT2"
2561 ><A
2562 NAME="WINDOWS-GUI"
2563 >7.6. Windows GUI Options</A
2564 ></H2
2565 ><P
2566 > <SPAN
2567 CLASS="APPLICATION"
2568 >Privoxy</SPAN
2569 > has a number of options specific to the
2570  Windows GUI interface:</P
2571 ><A
2572 NAME="ACTIVITY-ANIMATION"
2573 ></A
2574 ><P
2575 > If <SPAN
2576 CLASS="QUOTE"
2577 >"activity-animation"</SPAN
2578 > is set to 1, the
2579  <SPAN
2580 CLASS="APPLICATION"
2581 >Privoxy</SPAN
2582 > icon will animate when
2583  <SPAN
2584 CLASS="QUOTE"
2585 >"Privoxy"</SPAN
2586 > is active. To turn off, set to 0.</P
2587 ><P
2588 > <TT
2589 CLASS="LITERAL"
2590 >  <P
2591 CLASS="LITERALLAYOUT"
2592 >&nbsp;&nbsp;<I
2593 CLASS="EMPHASIS"
2594 >activity-animation   1</I
2595 ><br>
2596 &nbsp;&nbsp;&nbsp;</P
2597 >
2598  </TT
2599 ></P
2600 ><A
2601 NAME="LOG-MESSAGES"
2602 ></A
2603 ><P
2604 > If <SPAN
2605 CLASS="QUOTE"
2606 >"log-messages"</SPAN
2607 > is set to 1,
2608  <SPAN
2609 CLASS="APPLICATION"
2610 >Privoxy</SPAN
2611 > will log messages to the console
2612  window:</P
2613 ><P
2614 > <TT
2615 CLASS="LITERAL"
2616 >  <P
2617 CLASS="LITERALLAYOUT"
2618 >&nbsp;&nbsp;<I
2619 CLASS="EMPHASIS"
2620 >log-messages       1</I
2621 ><br>
2622 &nbsp;&nbsp;&nbsp;</P
2623 >
2624  </TT
2625 ></P
2626 ><A
2627 NAME="LOG-BUFFER-SIZE"
2628 ></A
2629 ><P
2630 >
2631  If <SPAN
2632 CLASS="QUOTE"
2633 >"log-buffer-size"</SPAN
2634 > is set to 1, the size of the log buffer,
2635  i.e. the amount of memory used for the log messages displayed in the
2636  console window, will be limited to <SPAN
2637 CLASS="QUOTE"
2638 >"log-max-lines"</SPAN
2639 > (see below).</P
2640 ><P
2641 > Warning: Setting this to 0 will result in the buffer to grow infinitely and
2642  eat up all your memory!</P
2643 ><P
2644 > <TT
2645 CLASS="LITERAL"
2646 >  <P
2647 CLASS="LITERALLAYOUT"
2648 >&nbsp;&nbsp;<I
2649 CLASS="EMPHASIS"
2650 >log-buffer-size      1</I
2651 ><br>
2652 &nbsp;&nbsp;&nbsp;</P
2653 >
2654  </TT
2655 ></P
2656 ><A
2657 NAME="LOG-MAX-LINES"
2658 ></A
2659 ><P
2660 > <SPAN
2661 CLASS="APPLICATION"
2662 >log-max-lines</SPAN
2663 > is the maximum number of lines held
2664  in the log buffer. See above.</P
2665 ><P
2666 > <TT
2667 CLASS="LITERAL"
2668 >  <P
2669 CLASS="LITERALLAYOUT"
2670 >&nbsp;&nbsp;<I
2671 CLASS="EMPHASIS"
2672 >log-max-lines      200</I
2673 ><br>
2674 &nbsp;&nbsp;&nbsp;</P
2675 >
2676  </TT
2677 ></P
2678 ><A
2679 NAME="LOG-HIGHLIGHT-MESSAGES"
2680 ></A
2681 ><P
2682 > If <SPAN
2683 CLASS="QUOTE"
2684 >"log-highlight-messages"</SPAN
2685 > is set to 1,
2686  <SPAN
2687 CLASS="APPLICATION"
2688 >Privoxy</SPAN
2689 > will highlight portions of the log
2690  messages with a bold-faced font:</P
2691 ><P
2692 > <TT
2693 CLASS="LITERAL"
2694 >  <P
2695 CLASS="LITERALLAYOUT"
2696 >&nbsp;&nbsp;<I
2697 CLASS="EMPHASIS"
2698 >log-highlight-messages   1</I
2699 ><br>
2700 &nbsp;&nbsp;&nbsp;</P
2701 >
2702  </TT
2703 ></P
2704 ><A
2705 NAME="LOG-FONT-NAME"
2706 ></A
2707 ><P
2708 > The font used in the console window:</P
2709 ><P
2710 > <TT
2711 CLASS="LITERAL"
2712 >  <P
2713 CLASS="LITERALLAYOUT"
2714 >&nbsp;&nbsp;<I
2715 CLASS="EMPHASIS"
2716 >log-font-name        Comic Sans MS</I
2717 ><br>
2718 &nbsp;&nbsp;&nbsp;</P
2719 >
2720  </TT
2721 ></P
2722 ><A
2723 NAME="LOG-FONT-SIZE"
2724 ></A
2725 ><P
2726 > Font size used in the console window:</P
2727 ><P
2728 > <TT
2729 CLASS="LITERAL"
2730 >  <P
2731 CLASS="LITERALLAYOUT"
2732 >&nbsp;&nbsp;<I
2733 CLASS="EMPHASIS"
2734 >log-font-size        8</I
2735 ><br>
2736 &nbsp;&nbsp;&nbsp;</P
2737 >
2738  </TT
2739 ></P
2740 ><A
2741 NAME="SHOW-ON-TASK-BAR"
2742 ></A
2743 ><P
2744 >
2745  <SPAN
2746 CLASS="QUOTE"
2747 >"show-on-task-bar"</SPAN
2748 > controls whether or not
2749  <SPAN
2750 CLASS="APPLICATION"
2751 >Privoxy</SPAN
2752 > will appear as a button on the Task bar
2753  when minimized:</P
2754 ><P
2755 > <TT
2756 CLASS="LITERAL"
2757 >  <P
2758 CLASS="LITERALLAYOUT"
2759 >&nbsp;&nbsp;<I
2760 CLASS="EMPHASIS"
2761 >show-on-task-bar     0</I
2762 ><br>
2763 &nbsp;&nbsp;&nbsp;</P
2764 >
2765  </TT
2766 ></P
2767 ><A
2768 NAME="CLOSE-BUTTON-MINIMIZES"
2769 ></A
2770 ><P
2771 > If <SPAN
2772 CLASS="QUOTE"
2773 >"close-button-minimizes"</SPAN
2774 > is set to 1, the Windows close
2775  button will minimize <SPAN
2776 CLASS="APPLICATION"
2777 >Privoxy</SPAN
2778 > instead of closing
2779  the program (close with the exit option on the File menu).</P
2780 ><P
2781 > <TT
2782 CLASS="LITERAL"
2783 >  <P
2784 CLASS="LITERALLAYOUT"
2785 >&nbsp;&nbsp;<I
2786 CLASS="EMPHASIS"
2787 >close-button-minimizes  1</I
2788 ><br>
2789 &nbsp;&nbsp;&nbsp;</P
2790 >
2791  </TT
2792 ></P
2793 ><A
2794 NAME="HIDE-CONSOLE"
2795 ></A
2796 ><P
2797 > The <SPAN
2798 CLASS="QUOTE"
2799 >"hide-console"</SPAN
2800 > option is specific to the MS-Win console
2801  version of <SPAN
2802 CLASS="APPLICATION"
2803 >Privoxy</SPAN
2804 >. If this option is used,
2805  <SPAN
2806 CLASS="APPLICATION"
2807 >Privoxy</SPAN
2808 > will disconnect from and hide  the
2809  command console.</P
2810 ><P
2811 > <TT
2812 CLASS="LITERAL"
2813 >  <P
2814 CLASS="LITERALLAYOUT"
2815 >&nbsp;&nbsp;#<I
2816 CLASS="EMPHASIS"
2817 >hide-console</I
2818 ><br>
2819 &nbsp;&nbsp;&nbsp;</P
2820 >
2821  </TT
2822 ></P
2823 ></DIV
2824 ></DIV
2825 ><DIV
2826 CLASS="NAVFOOTER"
2827 ><HR
2828 ALIGN="LEFT"
2829 WIDTH="100%"><TABLE
2830 WIDTH="100%"
2831 BORDER="0"
2832 CELLPADDING="0"
2833 CELLSPACING="0"
2834 ><TR
2835 ><TD
2836 WIDTH="33%"
2837 ALIGN="left"
2838 VALIGN="top"
2839 ><A
2840 HREF="configuration.html"
2841 >Prev</A
2842 ></TD
2843 ><TD
2844 WIDTH="34%"
2845 ALIGN="center"
2846 VALIGN="top"
2847 ><A
2848 HREF="index.html"
2849 >Home</A
2850 ></TD
2851 ><TD
2852 WIDTH="33%"
2853 ALIGN="right"
2854 VALIGN="top"
2855 ><A
2856 HREF="actions-file.html"
2857 >Next</A
2858 ></TD
2859 ></TR
2860 ><TR
2861 ><TD
2862 WIDTH="33%"
2863 ALIGN="left"
2864 VALIGN="top"
2865 ><SPAN
2866 CLASS="APPLICATION"
2867 >Privoxy</SPAN
2868 > Configuration</TD
2869 ><TD
2870 WIDTH="34%"
2871 ALIGN="center"
2872 VALIGN="top"
2873 >&nbsp;</TD
2874 ><TD
2875 WIDTH="33%"
2876 ALIGN="right"
2877 VALIGN="top"
2878 >Actions Files</TD
2879 ></TR
2880 ></TABLE
2881 ></DIV
2882 ></BODY
2883 ></HTML
2884 >