Nobanner README ($Revision: 1.1.1.1 $)
----------------------------

Copyright Notice
----------------

Copyright (C) 2002, David Bélanger

This software is licensed under the GPL.  See COPYING for details.


Description
-----------

Nobanner is a dummy web server that always return a 2x2 "invisible"
gif image.  It is to be used in conjunction with a proxy configuration
file.  The same functionnality could be achieved by installing and
configuring Apache (www.apache.org).  However, for non-sysadmins,
Apache takes a lot of disk space and is somewhat too powerful when we
simply want to remove the banners.  Please refer to my website
(http://www.cs.mcgill.ca/~dbelan2/nobanner/nobanner.html) for details
on the proxy configuration file.


Files
-----
README     - This file
COPYING    - License
Makefile   - Simple Makefile
nobanner.c - The program


Requirements
------------
It has been tested and it runs on the Linux platform.  It should work
on most Un*x systems.

This program is useless if you cannot set up a proxy configuration
file for your browser.  It works fine with Mozilla.  It could work
with other popular browsers.


Compiling
---------
To compile (see also Options):

(with debugging output on)
make

(without debugging output)
make nodebug

To compile on Mac OS X:
make debugosx


Options
-------
Some options:
If DEBUG is defined, print debug/verbose info
If TEXTREPLY is defined, it will return a Bad Request error message to
the browser.
If MACOSX is defined, it will make a few change in order to get compiled on Mac OS X.  So far, the only change is to define socklen_t.


ex:
To enable debugging output:
  gcc -o nobanner -DDEBUG nobanner.c



To Use
------
Let nobanner run when you are browsing.  You may want to write a small
script that runs it when you start your browser and stops it when you
are done.  Alternatively, you could set up your simple to run it at
startup.


Usage: nobanner [-v | port]
         port     server will listen on port specified.
                  (default: 61111)
         -v       prints the version info



Comments
--------
Send comments/suggestions/feedback to dbelan2@cs.mcgill.ca.


To do list
----------
- Make debug/verbose more flexible (option to disable it even if
compiled with it, levels).
- Add a logging feature: log all requests to some file
- and -h option to display the usage


Changes
-------
Release 0.2.0 - Ported to Mac OS X
Release 0.1.0 - Initial release



=== end-of-file ===