From 9a207cd3a940c4b9b8700ed67369d67c6f4eb1ca Mon Sep 17 00:00:00 2001 From: Fabian Keil Date: Sun, 6 Jan 2013 18:51:53 +0000 Subject: [PATCH] Regenerate the HTML version of the man page for 3.0.20 beta There are a bunch of white-space changes because apparently this is the first time the generated mess has been filtered with the current tidy settings. --- doc/webserver/man-page/privoxy-man-page.html | 407 ++++++++++++------- 1 file changed, 258 insertions(+), 149 deletions(-) diff --git a/doc/webserver/man-page/privoxy-man-page.html b/doc/webserver/man-page/privoxy-man-page.html index 58e137d3..dd70bfe5 100644 --- a/doc/webserver/man-page/privoxy-man-page.html +++ b/doc/webserver/man-page/privoxy-man-page.html @@ -1,213 +1,322 @@ - + - - - Privoxy Man page - + Man page of PRIVOXY + -

NAME

-
-
+  

PRIVOXY

Section: (1)
+ Updated: 06 Januar 2013
+ Index +
+   -
+

NAME

privoxy - Privacy Enhancing Proxy  

SYNOPSIS

-
-       privoxy   [--help   ]  [--version   ]  [--no-daemon  ] [--pidfile pidfile ]
-       [--user user[.group] ] [--chroot    ]  [--pre-chroot-nslookup  hostname  ]
-       [configfile ]
 
+  

privoxy [--chroot ] [--config-test ] [--help + ] [--no-daemon ] [--pidfile pidfile ] + [--pre-chroot-nslookup hostname ] [--user + user[.group] ] [--version ] [configfile ]

- -
+

 

OPTIONS

-
-       Privoxy may be invoked with the following command line options:
 
-       --help Print brief usage  info and exit.
+  

Privoxy may be invoked with the following command line + options:

- --version - Print version info and exit. +
+
--chroot
- --no-daemon - Don't become a daemon, i.e. don't fork and become process - group leader, don't detach from controlling tty, and do all log- - ging there. +
Before changing to the user ID given in the --user option, chroot to + that user's home directory, i.e. make the kernel pretend to the + Privoxy process that the directory tree starts there. If set up + carefully, this can limit the impact of possible vulnerabilities in + Privoxy to the files contained in that hierarchy.
- --pidfile pidfile - On startup, write the process ID to pidfile. Delete the pidfile - on exit. Failure to create or delete the pidfile is non-fatal. - If no --pidfile option is given, no PID file will be used. +
--config-test
- --user user[.group] - After (optionally) writing the PID file, assume the user ID of - user and the GID of group, or, if the optional group was not - given, the default group of user. Exit if the privileges are not - sufficient to do so. +
+ Exit after loading the configuration files before binding to the listen + address. The exit code signals whether or not the configuration files + have been successfully loaded. - --chroot - Before changing to the user ID given in the --user option, - chroot to that user's home directory, i.e. make the kernel pre- - tend to the Privoxy process that the directory tree starts - there. If set up carefully, this can limit the impact of possi- - ble vulnerabilities in Privoxy to the files contained in that - hierarchy. +

If the exit code is 1, at least one of the configuration files is + invalid, if it is 0, all the configuration files have been successfully + loaded (but may still contain errors that can currently only be + detected at run time).

- --pre-chroot-nslookup hostname - Initialize the resolver library using hostname before - chroot'ing. On some systems this reduces the number of files - that must be copied into the chroot tree. +

This option doesn't affect the log setting, combination with + "--no-daemon" is recommended if a configured log file shouldn't be + used.

+
- If the configfile is not specified on the command line, Privoxy - will look for a file named config in the current directory. If no con- - figfile is found, Privoxy will fail to start. +
--help
+
Print brief usage info and exit.
-
+
--no-daemon
+ +
Don't become a daemon, i.e. don't fork and become process group + leader, don't detach from controlling tty, and do all logging there.
+ +
--pidfile pidfile
+ +
On startup, write the process ID to pidfile. Delete the + pidfile on exit. Failure to create or delete the pidfile is + non-fatal. If no --pidfile option is given, no PID file will be + used.
+ +
--pre-chroot-nslookup hostname
+ +
Initialize the resolver library using hostname before + chroot'ing. On some systems this reduces the number of files that must be + copied into the chroot tree.
+ +
--user user[.group]
+ +
After (optionally) writing the PID file, assume the user ID of + user and the GID of group, or, if the optional group + was not given, the default group of user. Exit if the privileges + are not sufficient to do so.
+ +
--version
+ +
Print version info and exit.
+ + +

If the configfile is not specified on the command line, + Privoxy will look for a file named config in the current + directory. If no configfile is found, Privoxy will fail to + start.  

DESCRIPTION

-
-       Privoxy is a non-caching web proxy with advanced filtering capabilities
-       for enhancing privacy, modifying web page data and HTTP  headers,  con-
-       trolling  access,  and  removing ads and other obnoxious Internet junk.
-       Privoxy has a flexible configuration and  can  be  customized  to  suit
 
+  

Privoxy is a non-caching web proxy with advanced filtering capabilities + for enhancing privacy, modifying web page data and HTTP headers, + controlling access, and removing ads and other obnoxious Internet junk. + Privoxy has a flexible configuration and can be customized to suit + individual needs and tastes. It has application for both stand-alone + systems and multi-user networks.

-
+

Privoxy is Free Software and licensed under the GNU GPLv2.

-

INSTALLATION AND USAGE

-
-       Browsers can either be individually configured to use Privoxy as  a HTTP
-       proxy (recommended), or Privoxy can be combined with a packet filter to
-       build  an intercepting proxy (see config).  The default setting is  for
-       localhost,  on port  8118 (configurable in the main config  file).   To
-       set  the  HTTP  proxy  in Firefox, go through: Tools; Options; General;
-       Connection Settings; Manual Proxy Configuration.
+  

Privoxy is an associated project of Software in the Public Interest + (SPI).

- For Internet Explorer, go through: Tools; Internet Properties; Connec- - tions; LAN Settings. +

Helping hands and donations are welcome:

- The Secure (SSL) Proxy should also be set to the same values, otherwise - https: URLs will not be proxied. Note: Privoxy can only proxy HTTP and - HTTPS traffic. Do not try it with FTP or other protocols. HTTPS - presents some limitations, and not all features will work with HTTPS - connections. +
+
- For other browsers, check the documentation. +
http://www.privoxy.org/faq/general.html#PARTICIPATE
+
-
+
http://www.privoxy.org/faq/general.html#DONATE
+   -

CONFIGURATION

-
-       Privoxy   can  be  configured  with the various configuration files. The
-       default configuration files are: config,  default.filter,  default.action
-       and  default.action.  user.action  should  be  used for locally defined
-       exceptions to the default rules in match-all.action and default.action,
-       and  user.filter  for locally defined filters. These are well commented.
-       On Unix and Unix-like systems, these are located  in  /etc/privoxy/  by
-       default.
-
-       Privoxy   uses  the  concept  of actions in order  to manipulate the data
-       stream between the browser and remote sites.  There are various actions
-       available  with  specific  functions  for  such  things as blocking web
-       sites, managing cookies, etc. These actions can be invoked individually
-       or  combined,  and used against individual URLs, or groups of URLs that
-       can be defined using wildcards and regular expressions. The  result  is
-       that the user has greatly enhanced control and freedom.
-
-       The  actions list (ad blocks, etc) can also be configured with your web
-       browser  at  http://config.privoxy.org/  (assuming  the   configuration
-       allows it).  Privoxy's configuration parameters   can also  be viewed at
-       the same page. In addition, Privoxy can be toggled on/off.  This  is  an
-       internal page, and does not require Internet access.
-
-       See the User Manual for a detailed explanation of installation, general
-       usage, all configuration options, new features and notes on  upgrading.
+  

INSTALLATION AND USAGE

+

Browsers can either be individually configured to use Privoxy as + a HTTP proxy (recommended), or Privoxy can be combined with a packet + filter to build an intercepting proxy (see config). The default + setting is for localhost, on port 8118 (configurable in the main config + file). To set the HTTP proxy in Firefox, go through: Tools; + Options; General; Connection Settings; Manual Proxy + Configuration.

-
+

For Internet Explorer, go through: Tools; Internet + Properties; Connections; LAN Settings.

+ +

The Secure (SSL) Proxy should also be set to the same values, otherwise + https: URLs will not be proxied. Note: Privoxy can only proxy HTTP + and HTTPS traffic. Do not try it with FTP or other protocols. HTTPS + presents some limitations, and not all features will work with HTTPS + connections.

+ +

For other browsers, check the documentation.  

+ +

CONFIGURATION

+ +

Privoxy can be configured with the various configuration files. + The default configuration files are: config, default.filter, + default.action and default.action. user.action should + be used for locally defined exceptions to the default rules in + match-all.action and default.action, and user.filter + for locally defined filters. These are well commented. On Unix and + Unix-like systems, these are located in /etc/privoxy/ by + default.

+ +

Privoxy uses the concept of actions in order to manipulate + the data stream between the browser and remote sites. There are various + actions available with specific functions for such things as blocking web + sites, managing cookies, etc. These actions can be invoked individually or + combined, and used against individual URLs, or groups of URLs that can be + defined using wildcards and regular expressions. The result is that the + user has greatly enhanced control and freedom.

+ +

The actions list (ad blocks, etc) can also be configured with your web + browser at http://config.privoxy.org/ (assuming the + configuration allows it). Privoxy's configuration parameters can + also be viewed at the same page. In addition, Privoxy can be toggled + on/off. This is an internal page, and does not require Internet access.

+ +

See the User Manual for a detailed explanation of installation, + general usage, all configuration options, new features and notes on + upgrading.  

FILES

-    /usr/sbin/privoxy
-    /etc/privoxy/config
-    /etc/privoxy/match-all.action
-    /etc/privoxy/default.action
-    /etc/privoxy/user.action
-    /etc/privoxy/default.filter
-       detect them automatically.
+ /usr/sbin/privoxy
+ /etc/privoxy/config
+ /etc/privoxy/match-all.action
+ /etc/privoxy/default.action
+ /etc/privoxy/user.action
+ /etc/privoxy/default.filter
+ /etc/privoxy/user.filter
+ /etc/privoxy/trust
+ /etc/privoxy/templates/*
+ /var/log/privoxy/logfile
+
+

Various other files should be included, but may vary depending on + platform and build configuration. Additional documentation should be + included in the local documentation directory.  

- +

SIGNALS

-

NOTES

-
-       This  is  a  UNRELEASED  version  of Privoxy. Not all features are well
-       tested.
+  

Privoxy terminates on the SIGINT and SIGTERM + signals. Log rotation scripts may cause a re-opening of the logfile by + sending a SIGHUP to Privoxy. Note that unlike other daemons, + Privoxy does not need to be made aware of config file changes by + SIGHUP -- it will detect them automatically. Signals other than the + ones listed above aren't explicitly handled and result in the default + action defined by the operating system.  

- Please see the User Manual on how to contact the developers, for fea- - ture requests, reporting problems, and other questions. +

NOTES

+

This is a beta version of Privoxy. Not all features are well + tested.

-
+

Please see the User Manual on how to contact the developers, for + feature requests, reporting problems, and other questions.  

SEE ALSO

+ +

Other references and sites of interest to Privoxy users:

+ +

http://www.privoxy.org/, the + Privoxy Home page.

+ +

http://www.privoxy.org/faq/, + the Privoxy FAQ.

+ +

http://www.privoxy.org/developer-manual/, + the Privoxy developer manual.

+ +

https://sourceforge.net/projects/ijbswa/, + the Project Page for Privoxy on SourceForge.

+ +

http://config.privoxy.org/, the + web-based user interface. Privoxy must be running for this to work. + Shortcut: http://p.p/

+ +

https://sourceforge.net/tracker/?group_id=11118&atid=460288, + to submit ``misses'' and other configuration related suggestions to the + developers.  

+ +

DEVELOPMENT TEAM

-       Other references and sites of interest to Privoxy users:
+ Fabian Keil, lead developer
+ David Schmidt, developer
 
+ Hal Burgiss
+ Lee Rian
+ Roland Rosenfeld
+ Ian Silvester
+
  - http://www.privoxy.org/, the Privoxy Home page. +

COPYRIGHT AND LICENSE

  - http://www.privoxy.org/faq/, the Privoxy FAQ. +

COPYRIGHT

- http://www.privoxy.org/developer-manual/, the Privoxy developer manual. +

Copyright (C) 2001-2013 by Privoxy Developers <ijbswa-developers@lists.sourceforge.net>

- https://sourceforge.net/projects/ijbswa/, the Project Page for Privoxy - on SourceForge. +

Some source code is based on code Copyright (C) 1997 by Anonymous Coders + and Junkbusters, Inc. and licensed under the GNU General Public + License.  

- http://config.privoxy.org/, the web-based user interface. Privoxy must - be running for this to work. Shortcut: http://p.p/ +

LICENSE

- https://sourceforge.net/tracker/?group_id=11118&atid=460288, to submit - ``misses'' and other configuration related suggestions to the develop- - ers. +

Privoxy is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License, version 2, as + published by the Free Software Foundation.

+

This program is distributed in the hope that it will be useful, but + WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY + or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public + License for details.

- +

You should have received a copy of the GNU GPL along with this + program; if not, write to the Free Software Foundation, Inc. 51 Franklin + Street, Fifth Floor Boston, MA 02110-1301 USA

+
+   -

DEVELOPMENT TEAM

-
-    Fabian Keil, lead developer
-    David Schmidt, developer
+  

Index

- Hal Burgiss - Lee Rian - Roland Rosenfeld +
+
NAME
+
SYNOPSIS
-
+
OPTIONS
-

COPYRIGHT AND LICENSE

-
-   COPYRIGHT
-       Copyright  (C)  2001-2011  by   Privoxy   Developers   <ijbswa-develop-
-       ers@lists.sourceforge.net>
-
-       Some  source  code  is  based  on  code Copyright (C) 1997 by Anonymous
-       Coders and Junkbusters, Inc. and licensed under the GNU General    Public
-       License.
-
-   LICENSE
-       Privoxy   is  free  software;  you  can redistribute it and/or modify it
-       under the terms of the GNU General Public License, version 2,  as  pub-
-       lished by the Free Software Foundation.
-
+
DESCRIPTION
+ +
INSTALLATION AND USAGE
+ +
CONFIGURATION
+ +
FILES
+ +
SIGNALS
+ +
NOTES
+ +
SEE ALSO
+ +
DEVELOPMENT TEAM
+ +
COPYRIGHT AND LICENSE
+ +
+
+
COPYRIGHT
+ +
LICENSE
+
+
+ +
+ This document was created by man2html, using the manual pages.
+ Time: 18:35:36 GMT, January 06, 2013 -- 2.39.2