The first result of the shiny-new dok-tidy target.
[privoxy.git] / doc / webserver / man-page / privoxy-man-page.html
index 01a19d4..1bb72e2 100644 (file)
-<html><head><title>Privoxy Man page</title><link rel="stylesheet" type="text/css" href="../p_web.css"></head><body><H2>NAME</H2>
-<PRE>
+<!DOCTYPE html PUBLIC "-//IETF//DTD HTML 2.0//EN">
+<html>
+  <head>
+    <meta name="generator" content="HTML Tidy, see www.w3.org">
+    <title>
+      Privoxy Man page
+    </title>
+    <link rel="stylesheet" type="text/css" href="../p_web.css">
+  </head>
+  <body>
+    <h2>
+      NAME
+    </h2>
+<pre>
 <!-- Manpage converted by man2html 3.0.1 -->
 
-</PRE>
-<H2>SYNOPSIS</H2><PRE>
-       <B>privoxy</B>  [<B>--help</B>   ]  [<B>--version</B>   ]  [<B>--no-daemon</B>  ] [<B>--pidfile</B> <I>pidfile</I> ]
-       [<B>--user</B> <I>user[.group]</I> ] [<B>--chroot</B>   ]  [<B>--pre-chroot-nslookup</B>  <I>hostname</I>  ]
-       [<I>configfile</I> ]
-
-
-
-</PRE>
-<H2>OPTIONS</H2><PRE>
-       <B>Privoxy</B> may be invoked with the following command line options:
-
-       <B>--help</B> Print brief usage info and exit.
-
-       <B>--version</B>
-             Print version info and exit.
-
-       <B>--no-daemon</B>
-             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.
-
-       <B>--pidfile</B> <I>pidfile</I>
-             On startup, write the process ID to <I>pidfile</I>.  Delete the <I>pidfile</I>
-             on exit.  Failure to create or delete the <I>pidfile</I>  is  non-fatal.
-             If no <B>--pidfile</B> option is  given, no PID file will be used.
-
-       <B>--user</B> <I>user[.group]</I>
-             After  (optionally)  writing the PID file, assume the user ID of
-             <I>user</I> and the GID of <I>group</I>, or, if   the  optional  <I>group</I>  was  not
-             given, the default group of <I>user</I>.  Exit if the privileges are not
-             sufficient to do so.
-
-       <B>--chroot</B>
-             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 <B>Privoxy</B>  process  that  the  directory  tree   starts
-             there.  If set up carefully, this can limit the impact of possi-
-             ble vulnerabilities in <B>Privoxy</B> to  the files  contained  in  that
-             hierarchy.
-
-       <B>--pre-chroot-nslookup</B> <I>hostname</I>
-             Initialize   the   resolver   library   using   <I>hostname</I>   before
-             chroot'ing. On some systems this reduces  the  number  of  files
-             that must be copied into the chroot tree.
-
-       If  the <I>configfile</I>  is   not  specified on  the  command  line, <B>Privoxy</B>
-       will  look for a        file named <I>config</I> in the current directory. If no <I>con-</I>
-       <I>figfile</I> is found, <B>Privoxy</B> will fail to start.
-
-
-</PRE>
-<H2>DESCRIPTION</H2><PRE>
-       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
-
-
-</PRE>
-<H2>INSTALLATION AND USAGE</H2><PRE>
-       Browsers        can either be individually configured to use <B>Privoxy</B> as  a HTTP
-       proxy (recommended), or <B>Privoxy</B> can be combined with a packet filter to
-       build  an intercepting proxy (see <I>config</I>).  The default setting is  for
+</pre>
+    <h2>
+      SYNOPSIS
+    </h2>
+<pre>
+       <b>privoxy</b>   [<b>--help</b>   ]  [<b>--version</b>   ]  [<b>--no-daemon</b>  ] [<b>--pidfile</b> <i>pidfile</i> ]
+       [<b>--user</b> <i>user[.group]</i> ] [<b>--chroot</b>    ]  [<b>--pre-chroot-nslookup</b>  <i>hostname</i>  ]
+       [<i>configfile</i> ]
+
+
+
+</pre>
+    <h2>
+      OPTIONS
+    </h2>
+<pre>
+       <b>Privoxy</b> may be invoked with the following command line options:
+
+       <b>--help</b> Print brief usage  info and exit.
+
+       <b>--version</b>
+          Print version info and exit.
+
+       <b>--no-daemon</b>
+          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.
+
+       <b>--pidfile</b> <i>pidfile</i>
+          On startup, write the process ID to <i>pidfile</i>.  Delete the <i>pidfile</i>
+          on exit.  Failure to create or delete the <i>pidfile</i>  is  non-fatal.
+          If no <b>--pidfile</b> option is  given, no PID file will be used.
+
+       <b>--user</b> <i>user[.group]</i>
+          After  (optionally)  writing the PID file, assume the user ID of
+          <i>user</i> and the GID of <i>group</i>, or, if   the  optional  <i>group</i>  was  not
+          given, the default group of <i>user</i>.  Exit if the privileges are not
+          sufficient to do so.
+
+       <b>--chroot</b>
+          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 <b>Privoxy</b>  process  that  the  directory  tree   starts
+          there.  If set up carefully, this can limit the impact of possi-
+          ble vulnerabilities in <b>Privoxy</b> to  the files  contained  in  that
+          hierarchy.
+
+       <b>--pre-chroot-nslookup</b> <i>hostname</i>
+          Initialize   the   resolver   library   using   <i>hostname</i>   before
+          chroot'ing. On some systems this reduces  the  number  of  files
+          that must be copied into the chroot tree.
+
+       If  the  <i>configfile</i>  is   not  specified on  the  command  line, <b>Privoxy</b>
+       will  look for a file named <i>config</i> in the current directory. If no <i>con-</i>
+       <i>figfile</i> is found, <b>Privoxy</b> will fail to start.
+
+
+</pre>
+    <h2>
+      DESCRIPTION
+    </h2>
+<pre>
+       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
+
+
+</pre>
+    <h2>
+      INSTALLATION AND USAGE
+    </h2>
+<pre>
+       Browsers can either be individually configured to use <b>Privoxy</b> as  a HTTP
+       proxy (recommended), or <b>Privoxy</b> can be combined with a packet filter to
+       build  an intercepting proxy (see <i>config</i>).  The default setting is  for
        localhost,  on port  8118 (configurable in the main config  file).   To
-       set  the         HTTP  proxy  in Firefox, go through: <B>Tools</B>; <B>Options</B>; <B>General</B>;
-       <B>Connection</B> <B>Settings</B>; <B>Manual</B> <B>Proxy</B> <B>Configuration</B>.
+       set  the  HTTP  proxy  in Firefox, go through: <b>Tools</b>; <b>Options</b>; <b>General</b>;
+       <b>Connection</b> <b>Settings</b>; <b>Manual</b> <b>Proxy</b> <b>Configuration</b>.
 
-       For Internet Explorer, go through: <B>Tools</B>; <B>Internet</B> <B>Properties</B>;  <B>Connec-</B>
-       <B>tions</B>; <B>LAN</B> <B>Settings</B>.
+       For Internet Explorer, go through: <b>Tools</b>; <b>Internet</b> <b>Properties</b>;  <b>Connec-</b>
+       <b>tions</b>; <b>LAN</b> <b>Settings</b>.
 
-       The Secure (SSL)        Proxy should also be set to the same values, otherwise
-       https: URLs will        not be proxied. Note: <B>Privoxy</B> 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
+       The Secure (SSL) Proxy should also be set to the same values, otherwise
+       https: URLs will not be proxied. Note: <b>Privoxy</b> 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.
 
 
-</PRE>
-<H2>CONFIGURATION</H2><PRE>
-       <B>Privoxy</B>  can  be  configured  with the various configuration files. The
-       default configuration files are:        <I>config</I>,  <I>default.filter</I>,  <I>default.action</I>
-       and  <I>default.action</I>.  <I>user.action</I>  should  be  used for locally defined
-       exceptions to the default rules in <I>match-all.action</I> and <I>default.action</I>,
-       and  <I>user.filter</I> for locally defined filters. These are well commented.
-       On Unix and Unix-like systems, these are        located  in  <I>/etc/privoxy/</I>  by
+</pre>
+    <h2>
+      CONFIGURATION
+    </h2>
+<pre>
+       <b>Privoxy</b>   can  be  configured  with the various configuration files. The
+       default configuration files are: <i>config</i>,  <i>default.filter</i>,  <i>default.action</i>
+       and  <i>default.action</i>.  <i>user.action</i>  should  be  used for locally defined
+       exceptions to the default rules in <i>match-all.action</i> and <i>default.action</i>,
+       and  <i>user.filter</i>  for locally defined filters. These are well commented.
+       On Unix and Unix-like systems, these are located  in  <i>/etc/privoxy/</i>  by
        default.
 
-       <B>Privoxy</B>  uses  the  concept  of <B>actions</B> in order  to manipulate the data
+       <b>Privoxy</b>   uses  the  concept  of <b>actions</b> 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
+       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.
+       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).  <B>Privoxy's</B> configuration parameters  can also  be viewed at
-       the same        page. In addition, <B>Privoxy</B> can be toggled on/off.  This  is  an
-       internal        page, and does not require Internet access.
-
-       See the <I>User</I> <I>Manual</I> for a detailed explanation of installation, general
-       usage, all configuration        options, new features and notes on  upgrading.
-
-
-</PRE>
-<H2>FILES</H2><PRE>
-       <I>/usr/sbin/privoxy</I>
-       <I>/etc/privoxy/config</I>
-       <I>/etc/privoxy/match-all.action</I>
-       <I>/etc/privoxy/default.action</I>
-       <I>/etc/privoxy/user.action</I>
-       <I>/etc/privoxy/default.filter</I>
+       browser  at  http://config.privoxy.org/  (assuming  the   configuration
+       allows it).  <b>Privoxy's</b> configuration parameters   can also  be viewed at
+       the same page. In addition, <b>Privoxy</b> can be toggled on/off.  This  is  an
+       internal page, and does not require Internet access.
+
+       See the <i>User</i> <i>Manual</i> for a detailed explanation of installation, general
+       usage, all configuration options, new features and notes on  upgrading.
+
+
+</pre>
+    <h2>
+      FILES
+    </h2>
+<pre>
+    <i>/usr/sbin/privoxy</i>
+    <i>/etc/privoxy/config</i>
+    <i>/etc/privoxy/match-all.action</i>
+    <i>/etc/privoxy/default.action</i>
+    <i>/etc/privoxy/user.action</i>
+    <i>/etc/privoxy/default.filter</i>
        detect them automatically.
 
 
-</PRE>
-<H2>NOTES</H2><PRE>
-       This  is         a  UNRELEASED  version  of <B>Privoxy</B>. Not all features are well
+</pre>
+    <h2>
+      NOTES
+    </h2>
+<pre>
+       This  is  a  UNRELEASED  version  of <b>Privoxy</b>. Not all features are well
        tested.
 
-       Please see the <I>User</I> <I>Manual</I> on how to contact the  developers,  for  fea-
-       ture requests, reporting        problems, and other questions.
+       Please see the <i>User</i> <i>Manual</i> on how to contact the   developers,  for  fea-
+       ture requests, reporting problems, and other questions.
 
 
-</PRE>
-<H2>SEE ALSO</H2><PRE>
-       Other references        and sites of interest to <B>Privoxy</B> users:
+</pre>
+    <h2>
+      SEE ALSO
+    </h2>
+<pre>
+       Other references and sites of interest to <b>Privoxy</b> users:
 
 
-       http://www.privoxy.org/,        the <B>Privoxy</B> Home page.
+       http://www.privoxy.org/, the <b>Privoxy</b> Home page.
 
-       http://www.privoxy.org/faq/, the        <B>Privoxy</B>  FAQ.
+       http://www.privoxy.org/faq/, the <b>Privoxy</b>  FAQ.
 
-       http://www.privoxy.org/developer-manual/, the <B>Privoxy</B> developer manual.
+       http://www.privoxy.org/developer-manual/, the <b>Privoxy</b> developer manual.
 
-       https://sourceforge.net/projects/ijbswa/, the Project Page for  <B>Privoxy</B>
+       https://sourceforge.net/projects/ijbswa/, the Project Page for  <b>Privoxy</b>
        on SourceForge.
 
-       http://config.privoxy.org/,  the        web-based user interface. <B>Privoxy</B> must
+       http://config.privoxy.org/,  the web-based user interface. <b>Privoxy</b> must
        be running for this to work. Shortcut: http://p.p/
 
-       https://sourceforge.net/tracker/?group_id=11118&amp;atid=460288, to     submit
+       https://sourceforge.net/tracker/?group_id=11118&amp;atid=460288, to  submit
        ``misses''  and other configuration related suggestions to the develop-
        ers.
 
 
-</PRE>
-<H2>DEVELOPMENT TEAM</H2><PRE>
-       Fabian Keil, lead developer
-       David Schmidt, developer
-
-       Hal Burgiss
-       Mark Miller
-       Gerry Murphy
-       Lee Rian
-       Roland Rosenfeld
-
-
-</PRE>
-<H2>COPYRIGHT AND LICENSE</H2><PRE>
-   <B>COPYRIGHT</B>
-       Copyright  (C)  2001-2011  by   Privoxy  Developers   &lt;ijbswa-develop-
+</pre>
+    <h2>
+      DEVELOPMENT TEAM
+    </h2>
+<pre>
+    Fabian Keil, lead developer
+    David Schmidt, developer
+
+    Hal Burgiss
+    Mark Miller
+    Gerry Murphy
+    Lee Rian
+    Roland Rosenfeld
+
+
+</pre>
+    <h2>
+      COPYRIGHT AND LICENSE
+    </h2>
+<pre>
+   <b>COPYRIGHT</b>
+       Copyright  (C)  2001-2011  by   Privoxy   Developers   &lt;ijbswa-develop-
        ers@lists.sourceforge.net&gt;
 
        Some  source  code  is  based  on  code Copyright (C) 1997 by Anonymous
-       Coders and Junkbusters, Inc. and        licensed under the <I>GNU</I> <I>General</I>    <I>Public</I>
-       <I>License</I>.
+       Coders and Junkbusters, Inc. and licensed under the <i>GNU</i> <i>General</i>    <i>Public</i>
+       <i>License</i>.
 
-   <B>LICENSE</B>
-       <B>Privoxy</B>  is  free  software;  you  can redistribute it and/or modify it
-       under the terms of the <I>GNU</I> <I>General</I> <I>Public</I> <I>License</I>, version 2,  as  pub-
+   <b>LICENSE</b>
+       <b>Privoxy</b>   is  free  software;  you  can redistribute it and/or modify it
+       under the terms of the <i>GNU</i> <i>General</i> <i>Public</i> <i>License</i>, version 2,  as  pub-
        lished by the Free Software Foundation.
-</PRE>
-</body></html>
+</pre>
+  </body>
+</html>
+