Go to file
Robert James Kaes ebdec66eda Fixed Steve's email address and other "minor" cleanups. 2001-06-01 20:35:33 +00:00
doc Fixed Steve's email address and other "minor" cleanups. 2001-06-01 20:35:33 +00:00
src Formating changes. Also, explictly close the client_fd when the 2001-05-30 15:45:14 +00:00
AUTHORS Just updating the documentation. 2000-09-12 00:16:57 +00:00
COPYING This commit was generated by cvs2svn to compensate for changes in r2, 2000-02-16 17:32:49 +00:00
ChangeLog Updated ChangeLog 2001-05-27 02:40:43 +00:00
INSTALL Just updating the documentation. 2000-09-12 00:16:57 +00:00
Makefile.am New defaults, and better checking for various features needed by 2000-09-12 00:18:17 +00:00
NEWS Updated to reflect the 1.4.0 release. 2001-05-30 16:02:41 +00:00
README Fixed Steve's email address. 2001-05-30 16:01:33 +00:00
THANKS Just updating the documentation. 2000-09-12 00:16:57 +00:00
acconfig.h New defaults, and better checking for various features needed by 2000-09-12 00:18:17 +00:00
acinclude.m4 A M4 macro for finding the various types on the system (typedefs, etc.) 2000-09-12 00:20:23 +00:00
configure.in Bumped up the version number. Added a test for the ftruncate() and 2001-05-27 02:40:23 +00:00
reconf This commit was generated by cvs2svn to compensate for changes in r2, 2000-02-16 17:32:49 +00:00

README

 DESCRIPTION
 -----------

 tinyproxy is a small, efficient HTTP proxy daemon.  tinyproxy is very 
 useful in a small network setting, where a larger proxy like Squid
 would either be too resource intensive, or a security risk.  One of
 the key features of tinyproxy is the buffering connection concept.
 In effect, tinyproxy will buffer a high speed response from a server, 
 and then relay it to a client at the highest speed the client will
 accept.  This feature greatly reduces the problems with sluggishness
 on the Internet.  If you are sharing an Internet connection with a
 small network, and you only want to allow HTTP requests to be
 allowed, then tinyproxy is a great tool for the network
 administrator.


 INSTALLATION
 ------------

 To install this package under a Unix derivative, read the INSTALL
 file.  tinyproxy uses a standard GNU configure script.  There are
 additional command line arguments you can supply to configure.  They
 include:

	--enable-debug		If you would like to turn on full
				debugging support
	--enable-socks		This turns on SOCKS support for using
				tinyproxy across a fire wall.
	--enable-xtinyproxy	Compile in support for the XTinyproxy
				header, which is sent to any web
				server in your domain.
	--enable-filter		Allows tinyproxy to filter out certain
				domains and URLs.
	--enable-tunnel		Provides the option of having
				tinyproxy act as TCP tunnel, rather
				than a HTTP proxy.

     Options for file locations etc.
        --with-port=PORT        Set the port on which tinyproxy listens,
                                by default 8080.
        --with-log-file=FILE    Set the default logfile location.
        --with-user=USER        Set the default user to which tinyproxy
                                will setuid() upon startup.

 Once you have completed your installation, if you would like to
 report your success please execute the report.sh script in the doc
 directory.  This will send an email to the authors reporting your
 version, and a few bits of information concerning the memory usage of 
 tinyproxy.  Alternatively, you could just send an email stating the
 version.  Which ever you prefer.


 SUPPORT
 -------

 If you are having problems with tinyproxy, please report the problem
 to:

	Robert James Kaes	<rjkaes@flarenet.com>
	Steven Young		<sdyoung@users.sourceforge.net>

 Please recompile tinyproxy with full debug support (--enable-debug)
 and include a copy of the log file, and any assert errors reported by 
 tinyproxy.  Also, if you feel up to it, try running tinyproxy under
 your debugger and report the error your received and a context
 listing of the location.  Under gdb you would run tinyproxy like so:

	 gdb tinyproxy

	 (gdb) set args -c location_of_tinyproxy_conf -d
	 (gdb) run

 Now access the port tinyproxy is on until you receive a break in the
 gdb. You can now type:

	 (gbd) l

 to produce a context listing of the location of the error.  Send a
 copy to the authors.

 HOW TO CONTRIBUTE TO tinyproxy
 ------------------------------

 If you would like to contribute a feature, or a bug fix to the
 tinyproxy source, please send a diff (preferable a unified
 diff. i.e. "diff -u") against the latest release of tinyproxy.  Also, 
 if you could include a brief description of what your patch does.