home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Spezial
/
SPEZIAL2_97.zip
/
SPEZIAL2_97.iso
/
ANWEND
/
ONLINE
/
IJB20OS2
/
README.OS2
< prev
next >
Wrap
Text File
|
1997-09-24
|
7KB
|
134 lines
This is the the README file for the OS/2 version of Junkbuster 2.0
For general informations about Junkbuster consult the file README.
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 an very easy task.
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\install.cmd - OS/2 Command file to create a program object on the desktop
config\config.ijb - Sample configuration file for Junkbuster 2.0
config\block.ijb - Sample block file (referenced in config.ijb)
config\cookie.ijb - Sample cookie file (referenced in confg.ijb)
config\forward.ijb - Sample forward file (referenced in config.ijb)
source\* - Source files needed to recompile Junkbuster 2.0
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.txt - A plain access control file (block access to everyone)
sblock.txt - A plain blockfile (blocks nothing)
sconfig.txt - A plain configuration file (nothing configured)
scookie.txt - A plain cookiefile (accepts no cookie)
sforward.txt - A plain forward file (no forwarding)
strust.txt - A plain trustfile (no trusted sites, blocks nothing)
Changes on the orginal source:
* added compile and linker-options for OS/2 EMX to the 'Makefile'
The OS/2 executable version 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.
Installation is very easy:
* 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.
* 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 exists
create it. Add the above command to it.
Options; Network Preferences; Proxies; Manual Proxy Configuration
* 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'.
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 progam object
* 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.
I provided the sample configuration file 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 (*.txt) 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 port was done on 1997/09/23 by Gerd Flender.
The program was tested under OS/2 Warp 4 with Netscape/2 2.02 and IBM
WebExplorer, but it should run with no problem under Warp 3 and Warp 3 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.
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.junkbuster.com'