home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / tproxy12.zip / readme.txt next >
Text File  |  1997-03-12  |  6KB  |  121 lines
  1. TProxy: a *very* simple HTTP proxy server.
  2. by N.A. Krawetz
  3. Copyright 1996,1997.  All rights reserved.
  4.  
  5. Current version: 1.2
  6.  
  7. Features:
  8.   * Multithreaded
  9.   * Firewall protection
  10.   * HTTP support
  11.  
  12. Limitations (benefits?):
  13.   * No caching (Netscape bypasses caching proxies anyway!)
  14.   * Occasionally runs out of Mutex Semaphores.  This occurs when using many
  15.     threads (e.g. more than 8).  Best solution is to limit the number of
  16.     threads to 4 (default), 5, or 6.  If you must use many threads,
  17.     limit the use of other multi-threaded applications, such as
  18.     Netscape and WebExplorer, on the machine running the proxy server.
  19.   * Does not allow proxy-to-proxy forwarding.  (May be added later.)
  20.   * ONLY supports HTTP.  Does not support FTP, Telnet, or other protocols.
  21.   * Automatically closes connections after 2 minutes of inactivity.
  22.  
  23. Requires:
  24.   * EMX run-time libraries.
  25.  
  26. How to use TProxy:
  27.   There are four ways you can start TProxy:
  28.     TPROXY.EXE port
  29.     TPROXY.EXE port threads
  30.     TPROXY.EXE port address mask
  31.     TPROXY.EXE port threads address mask
  32.  
  33.   The <port> is a socket number where the HTTP proxy clients will connect.
  34.   For example: "TPROXY.EXE 8080" will start the proxy on port 8080.
  35.  
  36.   <threads> are the number of multiple connections.  The default is 4, and
  37.   the maximum is 10.  I would suggest using fewer than 6.
  38.  
  39.   Normally, TProxy will let any HTTP client connect to it.  If you want to
  40.   restrict connections (for firewalls) then you should specify the IP
  41.   address and netmask in standard dot notation.
  42.   For example: the address and mask 128.57.240.15 255.255.255.0 will only
  43.   allow clients from the 128.57.240.0 subnet access to the proxy server.
  44.  
  45. Log Mode:
  46.   A '-' before the port number starts the log mode.  For example, port
  47.   "-8080" will use port "8080" and enter log mode.
  48.   In log mode, TProxy writes each connection to a log file.  The log
  49.   files look like:
  50.     12-23-96  16:01        489           0  tp000000.log
  51.     12-23-96  16:01        386           0  tp000001.log
  52.     12-23-96  16:01        442           0  tp000002.log
  53.     12-23-96  16:01        575           0  tp000003.log
  54.   Each file contains:
  55.     1. The original query (or most of it, on line 1)
  56.     2. Client IP as well as the server's IP and port (on line 2)
  57.     3. The query determined by the proxy (or most of it, on line 3)
  58.     4. Other meta information provided by the client
  59.     5. A blank line
  60.     6. The entire response from the client.  Including html, images,
  61.     and errors.
  62.  
  63.   Log mode is not intended for long-term use.  Furthermore, most people
  64.   will probably never need, nor use, it.
  65.   Log mode does not record unauthorized connections (firewall) and does
  66.   not record proxy error messages.
  67.   Log mode has not been heavily tested under critical situations.  These
  68.   include limited disk space, security, speed-dependent applications.
  69.  
  70.  
  71. Legal stuff:
  72. TProxy is released as shareware and is not free software.  To register
  73. TProxy (and feel good about yourself), please send e-mail to:
  74.   dr.neal@worldnet.att.net
  75. and let me know what you think of TProxy.
  76.  
  77. Shareware versions of TProxy may not be distributed to remote FTP or
  78. networked sites without the explicit written permission of the Developer,
  79. Neal Krawetz.  Distributed versions of TProxy must contain the entire
  80. unmodified distribution.  The Developer is not responsible for modifications
  81. made to the distribution without the explicit written permission of the
  82. Developer.
  83.  
  84. You may not alter, merge, modify or adapt TProxy ("the Software") in any way
  85. including disassembling or decompiling.  You may not loan, rent, lease,
  86. license, or distribute the Software or any copy.
  87.  
  88. All intellectual property rights in this Software and user documentation are
  89. owned by N. A. Krawetz ("Developer") and are protected by United States
  90. copyright laws, other applicable copyright laws, and international treaty
  91. provisions.  The Developer retains all rights not expressly granted.
  92.  
  93. Except as specifically provided herein, the Developer makes no warranty or
  94. representation, promise or guarantee, either express or implied, statutory or
  95. otherwise, with respect to this Software or user documentation, including its
  96. quality, performance, merchantability, or fitness for a particular purpose.
  97.  
  98. The warranty and remedies set forth herein are exclusive and in lieu of all
  99. other, oral or written, express or implied.  No Software dealer, distributor,
  100. agent or employee is authorized to make any modifications or additions to this
  101. warranty.
  102.  
  103. Because software is inherently complex and may not be completely free of
  104. errors, you are advised to verify your work and to make backup copies of your
  105. work.  In no event will the Developer be liable for direct, indirect, special,
  106. incidental, economic, cover, or consequential damages arising out of the use
  107. of or inability to use the Software or user documentation, even if advised of
  108. the possibility of such damages.  In no case shall the Developers' liabilities
  109. exceed the total sum of the Software and licensing agreement.  Some states or
  110. provinces do not allow the exclusion or limitation of implied warranties or
  111. limitation of liability for incidental or consequential damages, so the above
  112. limitations or exclusion may not apply to you.
  113.  
  114. The Developer is not liable for the usage of the Software. The Developer is
  115. not liable or responsible for information, data, documents, or images
  116. retrieved, generated, stored, copied, or traversed that have copyright or are
  117. proprietary, pornographic, restricted and otherwise illegal.  All ownership
  118. and rights to retrieved, generated, stored, copied, and traversed materials
  119. are retained by their original owners, unless otherwise explicitly stated.
  120.  
  121.