home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / squid23s.zip / readme.os2 < prev    next >
Text File  |  2000-05-19  |  6KB  |  168 lines
  1. This is the port for OS/2 platform of the Squid version 2.3.STABLE3
  2. HTTP caching proxy server.
  3.  
  4. The first port was made by Peter Meerwald (pmeerw@cosy.sbg.ac.at,
  5. seawood@very.priv.at) for versions 1.1.0 and 1.1.15.
  6.  
  7. All information about Squid is available on 
  8. http://squid-cache.org/.
  9.  
  10. System requirements:
  11. OS/2 Warp 3.0 with FP18, Warp 4.0 or Warp 4.5.
  12. TCP/IP v.4.0 or higher.
  13. HPFS or JFS partition.
  14. EMX 0.9d fix01 (or higher) runtime.
  15.         ───────
  16.  
  17. 32Mb or more of RAM, SCSI hard disk are highly recommended.
  18.  
  19. Installation of binaries: 
  20. Unzip the archive.
  21. Place GNUREGEX.DLL in any directory from LIBPATH.
  22. To simplify some manipulations with Squid edit squid.cmd and place 
  23. it in any directory from PATH. To change the language for error 
  24. messages, copy the contents of /language directory in 
  25. etc/errors/errors.zip archive to etc/errors.
  26.  
  27. Before starting it's necessary to customize the etc/squid.conf file.
  28. For brief information see QUICKSTART. OS/2 version understands 
  29. SQUID_DIRECTORY environment variable as the default root of
  30. Squid tree. For example, place
  31. SET SQUID_DIRECTORY=d:\servers\squid
  32. in CONFIG.SYS or in the CMD file starting Squid and all default
  33. file names will be referred to this directory. Otherwise,
  34. start Squid with -f option for pointing to the actual squid.conf
  35. name.
  36.  
  37. Other useful options:
  38. squid -h        Print help message.
  39. squid -s        Enable logging to syslog.
  40. The ported syslogd daemon is required.
  41.  
  42. -k options are used to send a signal to the running process:
  43.  
  44. squid -k shutdown  |    
  45. squid -k interrupt |    Stop Squid.
  46. squid -k kill      |
  47. squid -k reconfigure    Restart with new configuration.
  48. squid -k rotate        Close and rename log files.
  49.  
  50. Squid -N option is ignoring because it is specific for UNIX.
  51. Under OS/2 you can use DETACH command for starting Squid in
  52. "daemon" mode.
  53. The binaries where compiled with -O3 -mpentium optimization
  54. and include only the standard features of Squid. To get more
  55. (not fully tested for OS/2) features (ICMP, SNMP, HTCP, Cache
  56. Digests et al) it's necessary to compile Squid from sources
  57. with last versions of gcc or pgcc after defining
  58. desirable options in include/autoconf.h. Also, recompilation 
  59. is required for increasing of the open file descriptors limit
  60. from default (256) value (see 
  61. http://squid-cache.org/Squid/FAQ/FAQ-11.html#filedescriptors).
  62. Both SQUID_MAXFD in include/autoconf.h and EMXOPT in src/Makefile
  63. must be changed. For recompilation it's sufficiently to start
  64. configos2.cmd without parameters and run make from lib and src
  65. directories.
  66.  
  67. Cache Manager (cachemgr.exe) is the powerful tool for control Squid.
  68. This CGI-script must be placed in CGI-BIN directory of HTTP server.
  69. To start it go to http://localhost/cgi-bin/cachemgr.exe. 
  70. The ACL for cache_object protocol must be properly defined in
  71. squid.conf.
  72.  
  73. client.exe is the text mode client program that may be useful
  74. for testing purposes.
  75.  
  76. dnsserver.exe (in old versions), unlinkd.exe and pinger.exe
  77. (for ICMP support) are the child processes of Squid using
  78. for time-consuming operations.
  79.  
  80. ---------
  81.  
  82. Known problems.
  83.  
  84. 1. Squid uses the internal implementation for domain names
  85.    resolving. The valid list of domain names server must be presented
  86.    in %ETC%\resolv2 or in squid.conf.
  87. 2. For using Cache Manager with Lotus Domino Go web server,
  88.    it's necessary to rename cachemgr.exe to nph-cachemgr.exe.
  89. 3. Netscape for OS/2 (2.02 and 4.04) sends the buggy request 
  90.    to Squid when trying to upload a file to ftp server. 
  91.    The full local file name is moving up to URL and request
  92.    looks like
  93.    PUT ftp://ftp.server.name/incoming/E:\LOCAL\PATH\FILENAME.ZIP.
  94.    This problem is fixed in Netscape 4.61.
  95. 4. Some of default values in squid.conf are not optimal and must
  96.    be changed.
  97.    cache_dir Directory-Name Mbytes Level-1 Level-2
  98.    To avoid the existence of thousands empty directories,
  99.    Level-1 can be calculated as (Mbytes/200+1) instead of
  100.    default value (16). For example:
  101.    cache_dir d:/squid/cache 100 1 256
  102.    These values are using as default when SQUID_DIRECTORY is defined.
  103.  
  104. ---------
  105.  
  106. History.
  107.  
  108. v. 2.3.stable3
  109.  
  110. v. 2.3.stable2
  111.  
  112. v. 2.3.stable1
  113.  
  114. - Compiled with enabled HEAP_REPLACEMENT feature (see
  115.   "replacement_policy" tag in squid.conf).
  116. - Fixed the bug (not my!), that caused "dirty" rebuilding
  117.   after normal shutdown.
  118. - Improved ICMP support.
  119. - Reduced CPU usage in idle state.
  120.  
  121.  
  122. v. 2.2.stable5
  123.  
  124. v. 2.2.stable4
  125.  
  126. v. 2.2.stable3
  127.  
  128. - Removed all patches around sscanf() problem, that's fixed in
  129.   EMX 0.9d fix 01.
  130. - Included executable for NCSA authenticator.
  131.  
  132. v. 2.2.stable1
  133.  
  134. - Fixed the bug in SQUID_DIRECTORY implementation.
  135. - client -P option works now.
  136. - Some improvements in ICMP support.
  137. - Correct CPU time measurment (thanks to authors of OS2UNDOC info).
  138. - Child processes don't require the special initialization, so even
  139.   REXX and Perl scripts can be used as redirectors and authenticators.
  140. - Some unofficial patches from http://hem.passagen.se/hno/squid/
  141.   were included.
  142.  
  143.  
  144. v. 2.1.patch2
  145.  
  146. My first port for Squid 2.*
  147.  
  148. ---------
  149.  
  150. Credits.
  151.  
  152. GNUregex.dll and GNUregex.def were taken from ported version of
  153. GNU grep.
  154. ftp.leo.org/pub/comp/os/os2/leo/gnu/sysutils/gnugrep.zip
  155.  
  156. syslog.c, syslog.h and sys/syslog.h were taken from ported
  157. version of syslogd daemon.
  158. ftp.leo.org/pub/comp/os/os2/leo/tcpip/systools/syslog3.zip
  159. All copyright information contains in these files.
  160.  
  161. ---------
  162.  
  163. Alexey Leko
  164. alex@wgc.chem.pu.ru
  165. SPb State University
  166. St-Petersburg
  167. Russia
  168.