X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=blobdiff_plain;f=privoxy.1;h=8138d9ce28ffdf05b2334019d392bc37bc7ea879;hp=0ce1b326b1b20a9c5d1d244a940c18514da3f80b;hb=1e237cbecffa4e860cab488f3bf0928b1442f500;hpb=fd9c6af4e3a9ed0ec110b266c4d02a51e18cffc3
diff --git a/privoxy.1 b/privoxy.1
index 0ce1b326..8138d9ce 100644
--- a/privoxy.1
+++ b/privoxy.1
@@ -3,35 +3,35 @@
.\"
.\" Please send any bug reports, improvements, comments, patches,
.\" etc. to Steve Cheng .
-.TH "PRIVOXY" "1" "12 November 2007" "Privoxy 3.0.7 UNRELEASED" ""
+.TH "PRIVOXY" "1" "13 January 2009" "Privoxy 3.0.11 UNRELEASED" ""
.SH NAME
privoxy \- Privacy Enhancing Proxy
.SH SYNOPSIS
-\fBprivoxy\fR [\fB--help\fR ] [\fB--version\fR ] [\fB--no-daemon\fR ] [\fB--pidfile \fIpidfile\fB\fR ] [\fB--user \fIuser[.group]\fB\fR ] [\fB--chroot\fR ] [\fB--pre-chroot-nslookup \fIhostname\fB\fR ] [\fB\fIconfigfile\fB\fR ]
+\fBprivoxy\fR [\fB\-\-help\fR ] [\fB\-\-version\fR ] [\fB\-\-no-daemon\fR ] [\fB\-\-pidfile \fIpidfile\fB\fR ] [\fB\-\-user \fIuser[.group]\fB\fR ] [\fB\-\-chroot\fR ] [\fB\-\-pre-chroot-nslookup \fIhostname\fB\fR ] [\fB\fIconfigfile\fB\fR ]
.SH "OPTIONS"
.PP
\fBPrivoxy\fR may be invoked with the following command line
options:
.TP
-\fB--help\fR
+\fB\-\-help\fR
Print brief usage info and exit.
.TP
-\fB--version\fR
+\fB\-\-version\fR
Print version info and exit.
.TP
-\fB--no-daemon\fR
+\fB\-\-no-daemon\fR
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.
.TP
-\fB--pidfile \fIpidfile\fB\fR
+\fB\-\-pidfile \fIpidfile\fB\fR
On startup, write the process ID to \fIpidfile\fR.
Delete the \fIpidfile\fR on exit.
Failure to create or delete the \fIpidfile\fR
-is non-fatal. If no \fB--pidfile\fR option is given, no PID file will be used.
+is non-fatal. If no \fB\-\-pidfile\fR option is given, no PID file will be used.
.TP
-\fB--user \fIuser[.group]\fB\fR
+\fB\-\-user \fIuser[.group]\fB\fR
After (optionally) writing the PID file, assume the user ID of
\fIuser\fR and the GID of
\fIgroup\fR, or, if the optional
@@ -39,15 +39,15 @@ After (optionally) writing the PID file, assume the user ID of
\fIuser\fR. Exit if the privileges are not
sufficient to do so.
.TP
-\fB--chroot\fR
-Before changing to the user ID given in the --user option, chroot to
+\fB\-\-chroot\fR
+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
\fBPrivoxy\fR process that the directory tree starts
there. If set up carefully, this can limit the impact of possible
vulnerabilities in \fBPrivoxy\fR to the files contained in
that hierarchy.
.TP
-\fB--pre-chroot-nslookup \fIhostname\fB\fR
+\fB\-\-pre-chroot-nslookup \fIhostname\fB\fR
Initialize the resolver library using \fIhostname\fR
before chroot'ing. On some systems this reduces the number of files
that must be copied into the chroot tree.
@@ -73,8 +73,10 @@ Privoxy is based on Internet Junkbuster (tm).
.SH "INSTALLATION AND USAGE"
.PP
Browsers can either be individually configured to use
-\fBPrivoxy\fR as a HTTP proxy, or \fBPrivoxy\fR can
-be set to act as an intercepting proxy (see \fIconfig\fR). The default setting is for
+\fBPrivoxy\fR as a HTTP proxy (recommended),
+or \fBPrivoxy\fR can be combined with a packet
+filter to build an intercepting proxy
+(see \fIconfig\fR). The default setting is for
localhost, on port 8118 (configurable in the main config file). To set the
HTTP proxy in Netscape and Mozilla, go through: \fBEdit\fR;
\fBPreferences\fR; \fBAdvanced\fR;
@@ -138,79 +140,30 @@ configuration might look like:
# Useful aliases that combine more than one action
+crunch-cookies = +crunch-incoming-cookies +crunch-outgoing-cookies
- -crunch-cookies = -crunch-incoming-cookies -crunch-outgoing-cookies
+ \-crunch-cookies = \-crunch-incoming-cookies \-crunch-outgoing-cookies
+block-as-image = +block +handle-as-image
# Fragile sites should have the minimum changes
- fragile = -block -deanimate-gifs -fast-redirects -filter \\
- -hide-referer -prevent-cookies -kill-popups
+ fragile = \-block \-deanimate-gifs \-fast-redirects \-filter \\
+ \-hide-referer \-prevent-cookies
## Turn some actions on ################################
## NOTE: Actions are off by default, unless explictily turned on
## otherwise with the '+' operator.
{ \\
--add-header \\
--block \\
--client-header-filter{hide-tor-exit-notation} \\
--content-type-overwrite \\
--crunch-client-header \\
--crunch-if-none-match \\
--crunch-outgoing-cookies \\
--crunch-incoming-cookies \\
--crunch-server-header \\
--deanimate-gifs \\
--downgrade-http-version \\
--fast-redirects \\
--filter{js-annoyances} \\
--filter{js-events} \\
--filter{html-annoyances} \\
--filter{content-cookies} \\
--filter{refresh-tags} \\
--filter{unsolicited-popups} \\
--filter{all-popups} \\
--filter{img-reorder} \\
--filter{banners-by-size} \\
--filter{banners-by-link} \\
--filter{webbugs} \\
--filter{tiny-textforms} \\
--filter{jumping-windows} \\
--filter{frameset-borders} \\
--filter{demoronizer} \\
--filter{shockwave-flash} \\
--filter{quicktime-kioskmode} \\
--filter{fun} \\
--filter{crude-parental} \\
--filter{ie-exploits} \\
--filter{site-specifics} \\
--filter{google} \\
--filter{yahoo} \\
--filter{msn} \\
--filter{blogspot} \\
--filter{no-ping} \\
--force-text-mode \\
--handle-as-empty-document \\
--handle-as-image \\
--hide-accept-language \\
--hide-content-disposition \\
--hide-if-modified-since \\
-+hide-forwarded-for-headers \\
++change-x-forwarded-for{block} \\
++deanimate-gifs{last} \\
++filter{refresh-tags} \\
++filter{img-reorder} \\
++filter{banners-by-size} \\
++filter{webbugs} \\
++filter{jumping-windows} \\
++filter{ie-exploits} \\
+hide-from-header{block} \\
--hide-referrer \\
--hide-user-agent \\
--inspect-jpegs \\
--kill-popups \\
--limit-connect \\
--overwrite-last-modified \\
--prevent-compression \\
--redirect \\
--send-vanilla-wafer \\
--send-wafer \\
--server-header-filter{xml-to-html} \\
--server-header-filter{html-to-xml} \\
--session-cookies-only \\
++hide-referrer{conditional-block} \\
++session-cookies-only \\
+set-image-blocker{pattern} \\
--treat-forbidden-connects-like-blocks \\
}
/ # '/' Match *all* URL patterns
@@ -234,7 +187,7 @@ configuration might look like:
# Make exceptions for these harmless ones that would be
# caught by our +block patterns just above.
- { -block }
+ { \-block }
adsl.
adobe.
advice.
@@ -251,12 +204,12 @@ narrowly defined exceptions:
{{alias}}
# Useful aliases
- -crunch-cookies = -crunch-incoming-cookies -crunch-outgoing-cookies
+ \-crunch-cookies = \-crunch-incoming-cookies \-crunch-outgoing-cookies
# Set personal exceptions to the policies in default.action #######
# Sites where we want persistent cookies, so allow *all* cookies
- { -crunch-cookies -session-cookies-only }
+ { \-crunch-cookies \-session-cookies-only }
.redhat.com
.sun.com
.msdn.microsoft.com
@@ -268,7 +221,7 @@ narrowly defined exceptions:
# Replace example.com's style sheet with one of my choosing
{ +redirect{http://localhost/css-replacements/example.com.css} }
- example.com/stylesheet.css
+ .example.com/stylesheet.css
.fi
.PP
See the comments in the configuration files themselves, or the
@@ -282,7 +235,6 @@ configuration options.
\fI/usr/sbin/privoxy\fR
\fI/etc/privoxy/config\fR
\fI/etc/privoxy/default.action\fR
- \fI/etc/privoxy/standard.action\fR
\fI/etc/privoxy/user.action\fR
\fI/etc/privoxy/default.filter\fR
\fI/etc/privoxy/user.filter\fR
@@ -363,12 +315,16 @@ the \fBPrivoxy\fR developer manual.
David Schmidt, developer
Hal Burgiss
+ Mark Miller
+ Gerry Murphy
+ Lee Rian
Roland Rosenfeld
+ J\[:o]rg Strohmayer
.fi
.SH "COPYRIGHT AND LICENSE"
.SS "COPYRIGHT"
.PP
-Copyright (C) 2001 - 2007 by Privoxy Developers
+Copyright (C) 2001-2008 by Privoxy Developers
.PP
Some source code is based on code Copyright (C) 1997 by Anonymous Coders
and Junkbusters, Inc. and licensed under the \fIGNU General Public
@@ -377,17 +333,14 @@ License\fR.
.PP
\fBPrivoxy\fR is free software; you can
redistribute it and/or modify it under the terms of the
-\fIGNU General Public
-License\fR, version 2, as published by the Free Software Foundation.
+\fIGNU General Public License\fR, version 2,
+as published by the Free Software Foundation.
.PP
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
-\fIGNU General Public License\fR for
-more details, which is available from the Free Software Foundation, Inc,
-51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
+FITNESS FOR A PARTICULAR PURPOSE. See the \fIGNU General Public License\fR for details.
.PP
-You should have received a copy of the \fIGNU General Public License\fR
+You should have received a copy of the \fIGNU GPL\fR
along with this program; if not, write to the Free Software
Foundation, Inc. 51 Franklin Street, Fifth Floor
Boston, MA 02110-1301