# ijb-zlib - a compressing proxy

[Obtaining the source] [Compiling the source] [Configuration] [Licence] [Warranty] [Version History] [Health Disclaimer]

ijb-zlib is a modified version of the Internet Junkbuster Proxy v2.0.2 which can automatically compress text/html and text/plain documents for clients which support Accept-Encoding: gzip (e.g. Netscape 4.7, Internet Explorer 5, Lynx 2.8.3) to save downstream modem/network bandwidth. It uses the zlib compression library to perform on-the-fly compression of HTML documents.

The Internet Junkbuster source underwent substantial changes for portability: ANSI function prototypes were added, and there is better support for a variety of Win32 compilers, including the LCC compiler.

## Obtaining the source

- The source for the zlib compression library should be obtained from www.info-zip.org/pub/infozip/zlib/, or download zlib version 1.1.3 from f2.org/download/zlib113.tgz [145Kb]. If you use the LCC compiler under windows, download zlib-Makefile.lcc - a makefile for zlib version 1.1.3 using the LCC compiler.
- The source for ijb-zlib is available from f2.org/download/ijb-zlib-10.tgz [184Kb]. The source is a gzip-ed tar file. To unzip under Unix/Linux systems, type:

  > `tar xzvf ijb-zlib-10.tgz`

  or

  > `gunzip < ijb-zlib-10.tgz | tar xvf -`

  if you don't have a nice, clever GNU version of tar. Under windows NT, obtain an archiving program like WinZip and extract the source by right-clicking on the archive and selecting the 'extract' option.

## Compiling the source

- zlib: The zlib compression library should compile without modification. For non-Unix operating systems, a 'Makefile' should be copied from the appropriate subdirectory (amiga, msdos, nt, os2) and renamed 'Makefile'.
- ijb-zlib: After modifying the Makefile for your operating system & compiler (be sure to add include and library paths for zlib source you compiled), the source should compile without modification under the same operating systems as Internet Junkbuster Proxy v2.0.2

## Configuration

Refer to the supplied Internet Junkbuster Proxy manual (ijbman.html) and FAQ (ijbfaq.html) set up the proxy. The only additional configuration settings for ijb-zlib are:

- auto-compress
  If the auto-compress setting appears in the configuration file, proxied text/html and text/plain documents are automatically compressed if the requesting client has specified Accept-Encoding: gzip.
  If the auto-compress setting is not present in the configuration file, no compression takes place.

If you're not interested in the Internet Junkbuster cookie-filtering capabilities and just want compression, you could try using the following configuration files:

- junkbstr.ini
  ## Enable compression
  auto-compress
  ## Enable all cookies to be passed
  cookiefile scookie.ini
  ## Accept requests on port 8000 from any machine, not just localhost
  listen-address :8000
- scookie.ini
  ## Accept all cookies
  *

## Licence

- The Internet Junkbuster Proxy (and ijb-zlib) are covered under the GNU General Public Licence, which basically means everyone can "use, copy and modify the Internet Junkbuster as they wish. Companies can use it for commercial purposes, but they are not permitted to use it in products that they claim as their property without negotiating a separate agreement with [Junkbusters] beforehand."
- The zlib compression library is used freely in accordance with the zlib licence.

## Warranty:

- ijb-zlib is supplied "as-is". No warranty is given, as per the GNU General Public Licence. Use ibj-zlib at your own risk.

## Version History:

- v1.0 - 4 August 2000 - Initial release, based on Internet Junkbuster Proxy v2.0.2

## Author:

- Fred Curtis added the ANSI prototypes and compressing code - everything else is the hard work of the Internet Junkbuster Proxy authors.

## Health Disclaimer:

The recommended pronuciation of "ijb-zlib" is "eye jay bee zed lib" (or "zee lib"). Attempting to pronounce "ijb-zlib" directly as written may lead to injury of the tongue or larynx -- although the teenager in the author's household makes a very good approximation of the sound when something surprising happens in "Pacman World" on his Playstation. The phrase "ijb-zlib" may or may not be an expletive in Arabic.