home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1997 November / PCO1197.ISO / FilesBBS / OS2 / IJB20OS2.ARJ / IJB20OS2.ZIP / README.OS2 < prev    next >
Encoding:
Text File  |  1997-09-24  |  6.9 KB  |  134 lines
  1. This is the the README file for the OS/2 version of Junkbuster 2.0 
  2. For general informations about Junkbuster consult the file README.
  3.  
  4. This version of Junkbuster was 'ported' from the original unix version.
  5. It wasn't really a port, because with the wonderful EMX library and the 
  6. GNU C-Compiler it was an very easy task.
  7.  
  8. After unpacking the Zip-archiv (on a HPFS-drive) you will find the following files:
  9.   bin\junkbuster.exe - The OS/2 executable version of Junkbuster
  10.   bin\install.cmd    - OS/2 Command file to create a program object on the desktop
  11.   config\config.ijb  - Sample configuration file for Junkbuster 2.0
  12.   config\block.ijb   - Sample block file (referenced in config.ijb)
  13.   config\cookie.ijb  - Sample cookie file (referenced in confg.ijb)
  14.   config\forward.ijb - Sample forward file (referenced in config.ijb)
  15.   source\*           - Source files needed to recompile Junkbuster 2.0
  16.   README             - the original README
  17.   junkbuster.1       - the manual as a UNIX manpage
  18.   gpl.html           - GNU General Public Licence
  19.   ijbfaq.html        - Manual for the Internet Junkbuster, HTML format
  20.   ijbman.html        - Frequently Asked Questions on the Internet Junkbuster
  21.   README.OS2         - guess, you read it
  22.   saclfile.txt       - A plain access control file (block access to everyone)
  23.   sblock.txt         - A plain blockfile (blocks nothing)
  24.   sconfig.txt        - A plain configuration file (nothing configured)
  25.   scookie.txt        - A plain cookiefile (accepts no cookie)
  26.   sforward.txt       - A plain forward file (no forwarding)
  27.   strust.txt         - A plain trustfile (no trusted sites, blocks nothing)
  28.  
  29.  
  30. Changes on the orginal source:
  31.  
  32. * added compile and linker-options for OS/2 EMX to the 'Makefile'
  33.  
  34. The OS/2 executable version of Junkbuster can be found in the subdirectory 'bin'.
  35. There you can also find an OS/2 command file to create a program object on
  36. your desktop. This program object invokes junkbuster with the configuration
  37. file 'config\config.ijb' found in your junkbuster directory.
  38.  
  39.  
  40. Installation is very easy:
  41.  
  42. * Because Junkbuster was compiled using the EMX-library, you need the
  43.   runtime package of emx 0.9c fix 03 or later. You can find the package
  44.   'emxrt.zip' on several ftp-servers. For example:
  45.     ftp.leo.org:          /pub/comp/os/os2/leo/gnu/emx+gcc/
  46.     ftp-os2.cdrom.com:    /pub/os2/emx09c/
  47.     ftp-os2.nmsu.edu:     /pub/os2/dev/emx/v0.9c/
  48.   Unpack the archive and install the package to your system.
  49.  
  50. * The following is not necessary if your are connected to a LAN or you got a
  51.   permanent IP-adress from your ISP.
  52.   You have to determine whether you are already configured your system to
  53.   use the localhost under OS/2.
  54.   Issue the command:
  55.          netstat -a
  56.   in a command window. There should be 1 or more response lines. If one of the
  57.   lines shows the following 
  58.          addr 127.0.0.1 interface 0 mask ff000000 broadcast
  59.   then you are configured to use localhost.
  60.   If this line is not present you can configure TCP/IP to enable localhost.
  61.   To do this:
  62.      - Double-click on the TCP/IP icon on the OS/2 desktop or in the OS/2 
  63.        System folder.
  64.      - Double-click on the TCP/IP Configuration icon.
  65.      - If the notebook page that appears is titled
  66.           "Configure Network Interface Parameters", then
  67.      - Select "loopback interface" under "Interface to Configure"
  68.      - Check the "Enable Interface" checkbox
  69.      - Verify that the "IP Address" is 127.0.0.1
  70.      - Exit TCP/IP Configuration and TCP/IP, and restart TCP/IP using the
  71.        "tcpstart" command in an OS/2 command window
  72.    If you do not have a TCP/IP Configuration icon try to enable the localhost
  73.    interface manually. Issue the command
  74.        ifconfig  lo 127.0.0.1
  75.    in an OS/2 command window. Be advised that this is not remembered by OS/2
  76.    when you reboot. Check if you have the file '\MPTN\BIN\SETUP.CMD' on your 
  77.    system. If so, add the above line to it. If not, check for the file
  78.    'STARTUP.CMD' in the root directory of your boot drive. If it does not exists
  79.    create it. Add the above command to it.
  80.  
  81. Options; Network Preferences; Proxies; Manual Proxy Configuration
  82. * Open your Netscape Navigator and choose 'Options'; 'Network Preferences';
  83.   'Proxies'. Enter the 'Manual Proxy Configuration' and insert in the field
  84.   'HTTP-Proxy' and 'Security-Proxy': 'HTTP://127.0.0.1', field Port: '8000'.
  85.   For the IBM-WebExplorer enter in the field 'Proxy-Gateway':
  86.   'http://127.0.0.1:8000/'. 
  87.   If there is already a proxy configured, enter the values found there in the
  88.   file 'config\forward.ijb'.
  89.   If your computer is connected to a LAN or you have a permanent IP-adress for
  90.   your computer you can use this adress instead of the localhost (127.0.0.1).
  91.  
  92. * Check and adjust the following files
  93.    'config\config.ijb'  - Set parameters according to your configuration.
  94.    'config\block.ijb'   - Add URLs you want to block
  95.    'config\cookie.ijb'  - Add sites you trust to set cookies
  96.    'config\forward.ijb' - If you have already configured a proxy in your
  97.                           browser, adjust it.
  98.  
  99. * Create program object by executing the file 'install.cmd'.
  100.   For regular use you should create a shadow of this program object in your
  101.   startup folder of OS/2. 
  102.  
  103. * Start Junkbuster by double-clicking the progam object
  104.  
  105. * To test the correct installation enter in your browser the URL
  106.       'http://127.0.0.1/show-proxy-args'
  107.   Now you should see the status page of Junkbuster. If this doesn't work for 
  108.   you, check if Junkbuster is really runnning (open windowlist) and if you 
  109.   entered the correct options for the proxy. Also check the logfile
  110.   'logfile.ijb' in the config directory.
  111.  
  112. I provided the sample configuration file in the 'config' directory to give
  113. you a simple example which should cover most configurations. Only the file
  114. 'forward.ijb' needs to be adjusted if you already use a proxy. All output
  115. of junkbuster (debug mode 1 is enabled) goes to the file 'logfile.ijb' in the
  116. config-directory.
  117.  
  118. Look at the plain configuration files (*.txt) in the main directory for a short
  119. description on how to block URL's and images. Cookies are always blocked. But
  120. you can allow cookies from specific sites by adding them to 'cookie.ijb'. 
  121. For a complete description on how to configure junkbuster consult the manual
  122. 'ijbman.html'.
  123.  
  124. The port was done on 1997/09/23 by Gerd Flender.
  125. The program was tested under OS/2 Warp 4 with Netscape/2 2.02 and IBM 
  126. WebExplorer, but it should run with no problem under Warp 3 and Warp 3 Connect.
  127. If you use this program with a different configuration I would like to
  128. hear your experiences. I would also like to know if there is a need for a
  129. PM-frontend to configure Junkbuster. Maybe I find the time to write one.
  130.  
  131. For bug-reports, more informations or your comments regarding the OS/2 version
  132. of Junkbuster mail to 'plgerd@informatik.uni-siegen.de'
  133. For general informations about Junkbuster look at 'http://www.junkbuster.com'
  134.