Internet Junkbuster
2.0.1 Released!

Gerd Flender just releases Internet Junkbuster 2.0.1 for OS/2and uploads the file (ijb201os2.zip, 306.37Kb) on Hobbes. OS/2 port of Internet Junkbuster from www.junkbuster.com, used to prevent loading of unwanted banner ads in HTML documents and to block cookies. New version has option to replace banner ads by 1x1 transparent GIF's.

Welcome to Junkbuster

This version of Junkbuster was 'ported' from the original unix version.
It wasn't really a port, because with the wonderful EMX library and the
GNU C-Compiler it was a very easy task.


What you get

After unpacking the Zip-archiv (on a HPFS-drive) you will find the following files:
bin\junkbuster.exe - The OS/2 executable version of Junkbuster
bin\ijb-gif.exe - The OS/2 executable version of GIF-Junkbuster
bin\install.cmd - OS/2 Command file to create a program object on the desktop
config\config.ijb - Sample configuration file for Junkbuster 2.0.1
config\block.ijb - Sample block file (referenced in config.ijb)
config\cookie.ijb - Sample cookie file (referenced in config.ijb)
config\forward.ijb - Sample forward file (referenced in config.ijb)
config\trust.ijb - Sample trust file (referenced in config.ijb)
config\aclfile.ijb - Sample aclfile file (referenced in config.ijb)
source\* - Source files needed to recompile Junkbuster 2.0.1
README - the original README
junkbuster.1 - the manual as a UNIX manpage
gpl.html - GNU General Public Licence
ijbfaq.html - Manual for the Internet Junkbuster, HTML format
ijbman.html - Frequently Asked Questions on the Internet Junkbuster
README.OS2 - guess, you read it
saclfile.ini - A plain access control file (block access to everyone)
sblock.ini - A plain blockfile (blocks nothing)
junkbstr.ini - A plain configuration file (nothing configured)
scookie.ini - A plain cookiefile (accepts no cookie)
sforward.ini - A plain forward file (no forwarding)
strust.ini - A plain trustfile (no trusted sites, blocks nothing)


Changes to the orginal source:

* As of version 2.0.1 no chances were necessary to compile Junkbuster for
OS/2. The compile switches for OS/2 are now part of the official
distribution.
* Additionaly I made some changes to jcc.c. This makes it possible to return
a 1x1-Gif for a blocked GIF- or JPEG-image.


General infos


The OS/2 executable versions of Junkbuster can be found in the subdirectory
'bin'. There you can also find an OS/2 command file to create a program object on your desktop. This program object invokes junkbuster with the configuration file 'config\config.ijb' found in your junkbuster directory.

As described above there is now an enhanced version available which implements the suggestions found in the file "ijbfaq.html" (the Junkbuster FAQ) under the section "Why not replace blocked banners with something invisible?". As suggested this special version returns a 1x1 transparent GIF for a blocked GIF- or JPEG-image. Please consult the above mentioned section in the FAQ to see if you should use this special version.
The enhanced version uses some ideas and code from Stefan Waldherr
<swa@cs.cmu.edu> http://www.waldherr.org/junkbuster/
 But instead of replacing every blocked URL with a 1x1 GIF this version only
replaces blocked GIF- or JPEG-images.
To install either the original or the Gif-enhanced version read the section
"How to install Junkbuster".

The sample blockfile (block.ijb) is used with the permission of Stefan Waldherr
(<swa@cs.cmu.edu> http://www.waldherr.org/junkbuster/) who provides it with
his Junkbuster rpm-package for Linux. For more informations consult this file.


How to install Junkbuster

* Because Junkbuster was compiled using the EMX-library, you need the
runtime package of emx 0.9c fix 03 or later. You can find the package
'emxrt.zip' on several ftp-servers. For example:
ftp.leo.org: /pub/comp/os/os2/leo/gnu/emx+gcc/
ftp-os2.cdrom.com: /pub/os2/emx09c/
ftp-os2.nmsu.edu: /pub/os2/dev/emx/v0.9c/
Unpack the archive and install the package to your system.
Consult the emx package to ensure you installed it correctly!!!

* The following is not necessary if your are connected to a LAN or you got a
permanent IP-adress from your ISP.
You have to determine whether you are already configured your system to
use the localhost under OS/2.
Issue the command:
netstat -a
in a command window. There should be 1 or more response lines. If one of the lines shows the following addr 127.0.0.1 interface 0 mask ff000000 broadcast then you are configured to use localhost.
If this line is not present you can configure TCP/IP to enable localhost.
To do this:
- Double-click on the TCP/IP icon on the OS/2 desktop or in the OS/2
System folder.
- Double-click on the TCP/IP Configuration icon.
- If the notebook page that appears is titled
"Configure Network Interface Parameters", then
- Select "loopback interface" under "Interface to Configure"
- Check the "Enable Interface" checkbox
- Verify that the "IP Address" is 127.0.0.1
- Exit TCP/IP Configuration and TCP/IP, and restart TCP/IP using the
"tcpstart" command in an OS/2 command window
If you do not have a TCP/IP Configuration icon try to enable the localhost
interface manually. Issue the command
ifconfig lo 127.0.0.1
in an OS/2 command window. Be advised that this is not remembered by OS/2 when you reboot. Check if you have the file '\MPTN\BIN\SETUP.CMD' on your system. If so, add the above line to it. If not, check for the file
'STARTUP.CMD' in the root directory of your boot drive. If it does not exist
create it and add the above command to it.

* Open your Netscape Navigator and choose 'Options'; 'Network Preferences';
'Proxies'. Enter the 'Manual Proxy Configuration' and insert in the field
'HTTP-Proxy' and 'Security-Proxy': 'HTTP://127.0.0.1', field Port: '8000'.
For the IBM-WebExplorer enter in the field 'Proxy-Gateway':
'http://127.0.0.1:8000/'.
If there is already a proxy configured, enter the values found there in the
file 'config\forward.ijb'.
If your computer is connected to a LAN or you have a permanent IP-adress for your computer you can use this adress instead of the localhost (127.0.0.1).

* Check and adjust the following files
'config\config.ijb' - Set parameters according to your configuration.
'config\block.ijb' - Add URLs you want to block
'config\cookie.ijb' - Add sites you trust to set cookies
'config\forward.ijb' - If you have already configured a proxy in your
browser, adjust it.

* Create program object by executing the file 'install.cmd'. It will ask you
if you want to install the Gif-enhanced version of Junkbuster or the
original version. Please answer with Y(es) or (N)o :-)
For regular use you should create a shadow of this program object in your
startup folder of OS/2.

* Start Junkbuster by double-clicking the program object.
Only by starting Junkbuster with this program object the necessary path and
program options will be set!!!!!!!!

* To test the correct installation enter in your browser the URL
'http://127.0.0.1/show-proxy-args'
Now you should see the status page of Junkbuster. If this doesn't work for
you, check if Junkbuster is really runnning (open windowlist) and if you
entered the correct options for the proxy. Also check the logfile
'logfile.ijb' in the config directory for more informations.


Some comments
 ==============
by The Author

I provided the sample configuration files in the 'config' directory to give
you a simple example which should cover most configurations. Only the file
'forward.ijb' needs to be adjusted if you already use a proxy. All output
of junkbuster (debug mode 1 is enabled) goes to the file 'logfile.ijb' in the
config-directory.

Look at the plain configuration files (*.ini) in the main directory for a short
description on how to block URL's and images. Cookies are always blocked. But you can allow cookies from specific sites by adding them to 'cookie.ijb'.
For a complete description on how to configure junkbuster consult the manual
'ijbman.html'.

The compilation was done on 1998/07/22 by Gerd Flender.
The program was tested by me under OS/2 Warp 4 with Netscape/2 2.02 and IBM WebExplorer. Several people reported that it too runs fine under Warp 3 and Warp Connect.
If you use this program with a different configuration I would like to
hear your experiences. I would also like to know if there is a need for a
PM-frontend to configure Junkbuster. Maybe I find the time to write one.


Credits and bug reports


Many thanks to Stefan Waldherr for his ideas on how to implement the 1x1 GIF
and for his very nice blockfile.

For bug-reports, more informations or your comments regarding the OS/2 version of Junkbuster mail to 'plgerd@informatik.uni-siegen.de'
For general informations about Junkbuster look at 'http://www.junkbusters.com'


CONTACT AUTHOR:

Gerd Flender
plgerd@informatik.uni-siegen.de
@Macarlo, Inc.
@Macarlo's Shareware & Web
OS/2
Java Lobby Member
Java Site Accredited

[TOP] [HOME] [INDEX]