X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=blobdiff_plain;f=privoxy.1;h=e52f6f4864b7db006f44e14b5dcd4a8b0d01ed40;hp=354b2c1887c601321b3ef6493387881f0d2aa48d;hb=822aef930c65c18fc8b75d9d7429d54191c1f6e1;hpb=3a0a72cca85553934f356fafa115ca61ce4a8dc9
diff --git a/privoxy.1 b/privoxy.1
index 354b2c18..e52f6f48 100644
--- a/privoxy.1
+++ b/privoxy.1
@@ -3,16 +3,15 @@
.\"
.\" Please send any bug reports, improvements, comments, patches,
.\" etc. to Steve Cheng .
-.\" Modified for privoxy-developers, 04/08/02.
-.TH "PRIVOXY" "1" "08 April 2002" "Privoxy 2.9.13 beta" ""
+.TH "PRIVOXY" "1" "24 April 2002" "Privoxy 2.9.14 beta" ""
.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\fIconfigfile\fB\fR] (UNIX)
+\fBprivoxy\fR [\fB--help\fR] [\fB--version\fR] [\fB--no-daemon\fR] [\fB--pidfile \fIpidfile\fB\fR] [\fB--user \fIuser[.group]\fB\fR] [\fB\fIconfigfile\fB\fR] \fB(UNIX)\fR
-\fBprivoxy.exe\fR [\fB\fIconfigfile\fB\fR] (Windows)
+\fBprivoxy.exe\fR [\fB\fIconfigfile\fB\fR] \fB(Windows)\fR
.SH "OPTIONS"
.PP
@@ -30,10 +29,10 @@ 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
-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.
+On startup, write the process ID to \fIpidfile\fR.
+Delete the \fIpidfile\fR on exit.
+Failiure to create or delete the \fIpidfile\fR
+is non-fatal. If no \fB--pidfile\fR option is given, no PID file will be used.
.TP
\fB--user \fIuser[.group]\fB\fR
After (optionally) writing the PID file, assume the user ID of
@@ -59,16 +58,8 @@ flexible configuration and can be customized to suit individual needs and
tastes. \fBPrivoxy\fR has application for both
stand-alone systems and multi-user networks.
.PP
-\fBPrivoxy\fR is based on the code of the
-\fBInternet Junkbuster\fR (tm).
-\fBJunkbuster\fR was originally written by Junkbusters
-Corporation, and was released as free open-source software under the GNU GPL.
-Stefan Waldherr made many improvements, and started the SourceForge project
-to continue development.
-.PP
-\fBPrivoxy\fR continues the
-\fBJunkbuster\fR tradition, but adds many
-refinements, enhancements and new features.
+\fBPrivoxy\fR is based on \fBInternet
+Junkbuster\fR (tm).
.SH "INSTALLATION AND USAGE"
.PP
Browsers must be individually configured to use \fBPrivoxy\fR as
@@ -118,52 +109,68 @@ might look like:
# Define a few useful custom aliases for later use
{{alias}}
- # Don't accept cookies
- +no-cookies = +no-cookies-set +no-cookies-read
+ # Useful aliases
+ +prevent-cookies = +prevent-setting-cookies +prevent-reading-cookies
+ -prevent-cookies = -prevent-setting-cookies -prevent-reading-cookies
+ +imageblock = +block +handle-as-image
- # Do accept cookies
- -no-cookies = -no-cookies-set -no-cookies-read
+ # Fragile sites should have the minimum changes
+ fragile = -block -deanimate-gifs -fast-redirects -filter \\
+ -hide-referer -prevent-cookies -kill-popups
- # Treat these blocked URLs as images.
- +imageblock = +block +image
+ # Shops should be allowed to set persistent cookies
+ shop = -filter -prevent-cookies -prevent-keeping-cookies
- # Define page filters we want to use.
- myfilters = +filter{html-annoyances} +filter{js-annoyances}\\
- +filter{no-popups} +filter{webbugs}
+ # Your favourite blend of filters:
+ #
+ myfilters = +filter{html-annoyances} +filter{js-annoyances} \\
+ +filter{popups} +filter{webbugs} +filter{banners-by-size}
## Default Policies (actions) ############################
{ \\
- -block \\
- -downgrade \\
- +fast-redirects \\
- myfilters \\
- +no-compression \\
- +hide-forwarded \\
- +hide-from{block} \\
- +hide-referer{forge} \\
- -hide-user-agent \\
- -image \\
- +image-blocker{blank} \\
- +no-cookies-keep \\
- -no-cookies-read \\
- -no-cookies-set \\
- +no-popups \\
- -vanilla-wafer \\
- -wafer \\
+ -add-header \\
+ -block \\
+ +deanimate-gifs{last} \\
+ -downgrade-http-version \\
+ -fast-redirects \\
+ +filter{html-annoyances} \\
+ +filter{js-annoyances} \\
+ +filter{content-cookies} \\
+ -filter{popups} \\
+ +filter{webbugs} \\
+ +filter{refresh-tags} \\
+ -filter{fun} \\
+ +filter{nimda} \\
+ +filter{banners-by-size} \\
+ -filter{shockwave-flash} \\
+ -filter{crude-prental} \\
+ +hide-forwarded-for-headers \\
+ +hide-from-header{block} \\
+ +hide-referrer{forge} \\
+ -hide-user-agent \\
+ -handle-as-image \\
+ +set-image-blocker{pattern} \\
+ -limit-connect \\
+ +prevent-compression \\
+ +session-cookies-only \\
+ +prevent-reading-cookies \\
+ +prevent-setting-cookies \\
+ -kill-popups \\
+ -send-vanilla-wafer \\
+ -send-wafer \\
}
/
-
# Now set exceptions to the above defined policies #######
# Sites where we want persistant cookies
- {-no-cookies -no-cookies-keep}
+ {-prevent-reading-cookies -prevent-setting-cookies}
.redhat.com
.sun.com
.yahoo.com
.msdn.microsoft.com
# This site requires cookies AND 'fast-redirects' on
- {-no-cookies -no-cookies-keep -fast-redirects}
+ {-prevent-reading-cookies -prevent-setting-cookies -fast-redirects}
.nytimes.com
# Add custom headers, and turn off filtering of page source
@@ -173,37 +180,36 @@ might look like:
# Block, and treat these URLs as 'images'.
{+imageblock}
- .adforce.imgis.com
- .ad.preferences.com/image.*
- .ads.web.aol.com
- .ad-adex3.flycast.com
- .ad.doubleclick.net
- .ln.doubleclick.net
- .ad.de.doubleclick.net
- /.*/count\\.cgi\\?.*df=
- 194.221.183.22[1-7]
- a196.g.akamai.net/7/196/2670/000[12]/images.gmx.net/i4/images/.*/
+ ar.atwola.com
+ .ad.doubleclick.net
+ .a.yimg.com/(?:(?!/i/).)*$
+ .a[0-9].yimg.com/(?:(?!/i/).)*$
+ bs*.gsanet.com
+ bs*.einets.com
+ .qkimg.net
+ ad.*.doubleclick.net
# Block any URLs that match these patterns
{+block}
- /.*/(.*[-_.])?ads?[0-9]?(/|[-_.].*|\\.(gif|jpe?g))
- /.*/(plain|live|rotate)[-_.]?ads?/
- /.*/(sponsor)s?[0-9]?/
- /.*/ad(server|stream|juggler)\\.(cgi|pl|dll|exe)
- /.*/adbanners/
- /.*/adv((er)?ts?|ertis(ing|ements?))?/
- /.*/banners?/
- /.*/popupads/
- /.*/advert[0-9]+\\.jpg
- /ad_images/
- /.*/ads/
- /images/.*/.*_anim\\.gif
- /rotations/
- /.*(ms)?backoff(ice)?.*\\.(gif|jpe?g)
- 195.63.104.*/(inbox|log|meld|folderlu|folderru|log(in|out)[lmr]u|)
- .images.nytimes.com
- .images.yahoo.com/adv/
- /.*cnnstore\\.gif
+ ad*.
+ .*ads.
+ banner?.
+ count*.
+ /(?:.*/)?(ads(erver?|tream)?|.*?ads|adv(ert(s|enties|is(ing|e?ments)?)?)?|(ad)?[-_]?banner(s|ads?|farm)?)/
+ /.*count(er)?\\.(pl|cgi|exe|dll|asp|php[34]?)
+ /(?:.*/)?(publicite|werbung|rekla(ma|me|am)|annonse|maino(kset|nta|s)?)/
+ .hitbox.com
+
+ # Make exceptions for these harmless ones that would be
+ # caught by +block.
+ {-block}
+ include.ebay.com
+ adsl.
+ advice.
+ .edu
+ .ac.uk
+ .uni-*.de
+ .*downloads.
.fi
.PP
See the comments in the configuration files themselves, or the
@@ -217,9 +223,8 @@ configuration options.
\fI/usr/sbin/privoxy\fR
\fI/etc/privoxy/config\fR
\fI/etc/privoxy/default.action\fR
- \fI/etc/privoxy/advanced.action\fR
- \fI/etc/privoxy/basic.action\fR
- \fI/etc/privoxy/intermediate.action\fR
+ \fI/etc/privoxy/standard.action\fR
+ \fI/etc/privoxy/user.action\fR
\fI/etc/privoxy/default.filter\fR
\fI/etc/privoxy/trust\fR
\fI/etc/privoxy/templates/*\fR
@@ -263,6 +268,9 @@ http://p.p/, access
http://config.privoxy.org
may work in some situations where the first does not.
+http://p.p/
+to submit ``misses'' to the developers.
+
http://www.junkbusters.com/ht/en/cookies.html
http://www.waldherr.org/junkbuster/
@@ -273,23 +281,20 @@ http://www.squid-cache.org/
.SH "DEVELOPMENT TEAM"
.nf
- Stefan Waldherr
- Andreas Oesterhelt
Jon Foster
- Markus Breitenbach
+ Andreas Oesterhelt
+ Stefan Waldherr
Thomas Steudten
- David Schmidt (OS/2, Mac OSX ports)
- Gabriel L. Somlo
+ Rodney Stromlund
+ Rodrigo Barbosa (RPM specfiles)
Hal Burgiss (docs)
+ Alexander Lazic
+ Gábor Lipták
+ Guy
Haroon Rafique
- John Venvertloh
+ David Schmidt (OS/2, Mac OSX ports)
Joerg Strohmayer
- Rodney Stromlund
- Rodrigo Barbosa (RPM specfiles)
Sarantis Paskalis
- Shamim Mohamed
- Gábor Lipták
- Alexander Lazic
.fi
.SH "COPYRIGHT AND LICENSE"
.PP