.\" Revised man page 10/13/01
.\" Hal Burgiss <hal@foobox.net for Junkbuster developers
.TH JUNKBUSTER 1 "v2.9.9 (alpha) Date: 2001/10/14"

.SH NAME
\fBjunkbuster\fP
- The
Internet Junkbuster
Proxy
\s-2(TM)\s+2
.SH SYNOPSIS
\fBjunkbuster\fP
\fI\&[config_file] &\fP
.br
\fBjunkbstr.exe\fP
\fI\&[config_file]\fP
(Windows)
.br
.P
If the configuration file is not specified on the command line,
\fBJunkbuster\fP will look for a file named \fIconfig\fP in the 
current directory (except on Amiga where it will look for 
\fIAmiTCP:db/junkbuster/config\fP and Win32 where it will try 
\fIjunkbstr.txt\fP).


.SH DESCRIPTION
\fBJunkbuster\fP
is an instrumentable HTTP proxy that filters the 
\s-2HTTP\s0
data stream between
web servers and browsers.
\fBJunkbuster\fP can be used to protect privacy, manage cookies, filter web
page content, manage access restrictions, and to remove such annoying Internet
junk as ads, banners, and pop-ups. Or whatever other annoyances strike your
fancy.

.SH INSTALLATION AND USE
Browsers must be configured to use 
\fBJunkbuster\fP
(the default is localhost, 
port 8000).
To set the 
\s-2HTTP\s0
proxy in Netscape and Mozilla,
go through:
\fB\&Edit\fP;
\fB\&Preferences\fP;
\fB\&Advanced\fP;
\fB\&Proxies\fP;
\fB\&Manual Proxy Configuration\fP;
\fB\&View\fP.
.P
For Internet Explorer,
go through:
\fB\&Tools\fP;
\fB\&Internet Properties\fP;
\fB\&Connections\fP;
\fB\&LAN Settings\fP.
.P
Set the HTTP proxy location for localhost, port 8000.
The
Secure (SSL) Proxy\" ijbfaq.html#security
should also be set to the same values,
otherwise
\fB\&https:\fP
\s-2URL\s0s
won't be proxied.

.SH CONFIGURATION
All \fBJunkbuster\fP configuration is done via the various configuarion 
files. The default configuration files are: \fIconfig\fP, 
\fIactionsfile\fP, and \fIre_filterfile\fP. These are well commented. 
On Unix and Unix-like systems, these are located in \fI/etc/junkbuster/\fP 
by default. On Windows and OS/2, these files are in the same directory 
as the \fBJunkbuster\fP executable. 
.P
The name and number of configuration files has changed from previous versions,
and is subject to change as development progresses. In fact, the configuration
itself is changed and much more sophisticated. See the user-manual for a brief
explanation of all configuration options.


.SH "SAMPLE CONFIGURATION"
.PP
A brief example of what an \fIactionsfile\fP configuration might look like:
.PP
.nf

# Define a few useful custom aliases for later use
{{alias}}
+no-cookies = +no-cookies-set +no-cookies-read
-no-cookies = -no-cookies-set -no-cookies-read
+imageblock = +block +image

## Default Policies (actions) ############################
{ \\
 -block \\
 -downgrade \\
 +fast-redirects \\
 +filter \\
 +no-compression \\
 +hide-forwarded \\
 +hide-from{block} \\
 +hide-referer{forge} \\
 -hide-user-agent \\
 -image \\
 +image-blocker{blank} \\
 +no-cookies-read \\
 +no-cookies-set \\
 +no-popups \\
 +vanilla-wafer \\
}
/

# Now set exceptions to the above defined policies #######

# Sites that DO need cookies
{-no-cookies}
 .redhat.com
 .sun.com
 .yahoo.com
 .msdn.microsoft.com

# This site requires cookies AND 'fast-redirects' on
{-no-cookies -fast-redirects}
 .nytimes.com

# Add custom headers, and turn off filtering of page source
{+add-header{X-Privacy: Yes please} #-add-header{*} \\
 +add-header{X-User-Tracking: No thanks!} -filter}
 privacy.net

{+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/.*/

# Block any URLs that match these patterns
{+block}
 /.*/(.*[-_.])?ads?[0-9]?(/|[-_.].*|\\.(gif|jpe?g))
 /.*/(.*[-_.])?count(er)?(\\.cgi|\\.dll|\\.exe|[?/])
 /.*/(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/
 /.*/sponsor.*\\.gif
 /.*/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

.fi
.sp
.PP
See the comments in the configuration files themselves, or the user-manual 
for explanations of the above syntax.

.SH "FILES"
\fI/usr/sbin/junkbuster\fP
.br
\fI/etc/junkbuster/config\fP
.br
\fI/etc/junkbuster/actionsfile\fP
.br
\fI/etc/junkbuster/re_filterfile\fP
.br
\fI/var/log/junkbuster/logfile\fP

.P
Various other files should be included, but may vary depending on platform.
More documentation should be included in the local documentation directory,
though is not complete at this time.

.SH NOTES
This is a development version of \fBJunkbuster\fP. All features are not 
complete.

.SH BUGS
Yes. HTTP/1.1 support is only partially implemented. See the user-manual for 
how and where to report bugs.

.SH SEE ALSO
http://ijbswa.sourceforge.net/
.br
http://sourceforge.net/projects/ijbswa
.br
http://www.waldherr.org/junkbuster/\" waldherr.org#
.br
http://www.junkbusters.com/ht/en/cookies.html\" cookies.html#
.br
http://ijbswa.sourceforge.net/config/
.br
http://privacy.net/analyze/
.br
http://www.squid-cache.org/

.SH DEVELOPMENT TEAM
.br
 Stefan Waldherr 
.br
 Andreas Oesterhelt 
.br
 Jon Foster 
.br
 Markus Breitenbach
.br
 Thomas Steudten
.br
 David Schmidt
.br
 Haroon Rafique
.br
 Jorg Strohmayer
.br
 Shamim Mohamed
.br
 Sarantis Paskalis
.br
 Gabriel L. Somlo
.br
 John Venvertloh
.br
 Hal Burgiss


.SH COPYRIGHT AND GPL
Orginally written by, and copyrighted by, the Anonymous Coders and Junkbusters
Corporation. 
.P
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
.P
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 more details.
.P
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
.P
Internet Junkbuster
Proxy
is a
trademark\" legal.html#marks
of Junkbusters Corporation.