home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 16 Announce / 16-Announce.zip / ctserver.txt < prev    next >
Text File  |  1996-05-28  |  8KB  |  194 lines
  1.                                 CountServer
  2.  
  3.              WWW Homepage Access Counter Server For OS/2 Warp
  4.  
  5.  
  6. CountServer is a multi-threaded OS/2 HTTP server program that serves a GIF
  7. counter image for your homepage. Being written as a standalone server
  8. program, it caches everything in RAM and takes a much smaller percentage of
  9. the CPU and disk resources on your server than CGI counter programs.
  10.  
  11. [CtServer Beta Release 1.9b01]
  12.  
  13. Release:     May 27, 1996
  14.  
  15. Expires:     Aug 1, 1996
  16.  
  17. Download:    http://www.knowledgy.com/ctserver/
  18.  
  19.  
  20. Requirements
  21.  
  22.    * OS/2 Warp Connect  or
  23.    * OS/2 Warp with TCP/IP Stack from Bonus pack or
  24.    * OS/2 Warp Server
  25.  
  26. Features
  27.  
  28.      [*] Does not require server-side includes
  29.  
  30.           Program runs with any Web server.
  31.  
  32.      [*] Manage multiple counters
  33.  
  34.           CtServer can now store and return multiple counters and their
  35.           values. Each counter is given a name and is passed in the URL.
  36.           Each counter also has the date of it's first hit stored. This
  37.           date can be returned as a GIF image.
  38.  
  39.      [*] Parameters from either parameter file for passed on URL
  40.  
  41.           Styles are created in the parameter file. Each of these styles
  42.           can specify any of the optional features. This way, you only have
  43.           to specify a counter like this:
  44.           "http://www.yourserver.com/cnt2"
  45.           Parameters can also be passed from the URL. A combination of the
  46.           two can be used, with the URL tags overriding the style tags.
  47.  
  48.      [*] 3D Frame around digit image set to any color and any width.
  49.  
  50.           This frame is optional and can be of any thickness from 5 to 50
  51.           pixels. The color of the frame can also be specified.
  52.  
  53.      [*] Set maximum number of digits to display
  54.  
  55.           The maximum number of digits is what limits the highest count. If
  56.           the maximum count is reached, a GIF message stating that the
  57.           maximum count has been reached is returned.
  58.  
  59.      [*] Optional leading-zeros
  60.  
  61.      [*] Set number of threads
  62.  
  63.           The number of threads that are service client request can be
  64.           specified.
  65.  
  66.      [*] Beep on incoming request
  67.  
  68.           This optional feature makes the server beep every time a client
  69.           request for a page arrives. This is handy for testing or for
  70.           lightly loaded servers.
  71.  
  72.      [*] Preset counter to any value
  73.  
  74.           Any counter can be preset to any value from a web browser. This
  75.           feature password authenticated.
  76.  
  77.      [*] Prevent counter from incrementing
  78.  
  79.           A counter can be advanced on a hit without displaying. This is
  80.           done by returning a 1 bit transparent GIF.
  81.  
  82.      [*] Create named styles with parameters
  83.  
  84.           Named styles can be created in the parameter file with all the
  85.           parameters needed. This means that you only have to pass the
  86.           style name to return a counter, time, date, etc.
  87.  
  88.      [*] Prevent passing of paramters on the URL
  89.  
  90.           For closed servers that need protection, only the counters and
  91.           their parameters entered in parameter file as a style will be
  92.           returned.
  93.  
  94.      [*] Store first hit date for each counter
  95.  
  96.           The first time a counter is requested from a client, the date of
  97.           that first request is stored. This date can be displayed
  98.           automatically by returning a GIF either textually (e.g. Hits
  99.           since Apr 26:), or as a numerical date (e.g. 04-26-96).
  100.  
  101.      [*] Prevent repeated counter incrementing
  102.  
  103.           One of the problems with counting every time a client request a
  104.           page from a server is what happens it the client re-loads the
  105.           page. This a give an over-inflated count. CtServer can prevent a
  106.           counter from incrementing if the same client has re-requested the
  107.           page in less than a specified time.
  108.  
  109.      [*] Return Time GIF
  110.  
  111.           The local time of the server can be returned as a GIF image in
  112.           either 12 or 24 hour time.
  113.  
  114.      [*] Return Date GIF
  115.  
  116.           The local date of the server can be returned as a GIF image. A
  117.           format string can be used which specifies the actual format to
  118.           display the date (e.g. MDY, M-D-Y, DMY, etc,).
  119.  
  120.      [*] Return random number GIF
  121.  
  122.           A random number can be automatically generated and returned as a
  123.           GIF image.
  124.  
  125.      [*] return literal number
  126.  
  127.           A literal number can be passed on a format tag and returned as a
  128.           GIF image.
  129.  
  130.      [*] Rotate image
  131.  
  132.           Any of the returned GIF images can be rotated 90,180, or 270
  133.           degrees.
  134.  
  135.      [*] Display all counter values
  136.  
  137.           An HTML page can be returned which has the count and first hit
  138.           date of each counter currently stored by the server. This command
  139.           is password authenticated.
  140.  
  141.      [*] Display all parameter file values
  142.  
  143.           An HTML page can be returned which shows all the values in the
  144.           server parameter file. The values for each style is also
  145.           displayed. This command is password authenticated.
  146.  
  147.      [*] Login and password protection
  148.  
  149.           Some of the commands to the server, such as preset counter value,
  150.           are protected by a login name and password stored in the
  151.           parameter file. When one of these commands is requested, the
  152.           standard Web authentication mechanism is used.
  153.  
  154.      [*] Multiple digit GIF images
  155.  
  156.           The server comes with a collection of digit GIF images. Each
  157.           counter can use a different digit style. These digit GIFs are
  158.           loaded at server startup or when requested. This is one of the
  159.           features that makes CtServer so fast and take very little load on
  160.           the server. Each digit style has all the digit values stored as 1
  161.           GIF for compactness and speed. CtServer comes with a utility,
  162.           DMERGE which combines digit GIFs into 1 GIF for any digit GIFs
  163.           you may have downloaded from the Web.
  164.  
  165. Copyright
  166.  
  167.      Copyright 1996 by R. Frank Mena. Permission to use this program for
  168.      any purpose is hereby granted without fee, provided that this
  169.      copyright notice appear in all copies and that both that copyright
  170.      notice and this permission notice appear in supporting documentation,
  171.      and the author's name not be used in advertising or publicity
  172.      pertaining to distribution of the software without specific written
  173.      prior permision. If the program is included in a book, publication or
  174.      software distribution media for sale, the author must be notified
  175.      about it.
  176.  
  177.      THIS PROGRAM IS PROVIDED "AS IS" WITHOUT EXPRESS OR IMPLIED WARRANTY.
  178.      THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
  179.      INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
  180.      EVENT SHALL THE AUTHOR R. Frank Mena BE LIABLE FOR ANY SPECIAL,
  181.      INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
  182.      FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
  183.      NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
  184.      WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  185.  
  186.      Note: This program was developed on my own time. My employer
  187.      Knowledgy, Inc. has nothing to do with it.
  188.  
  189. For documentation, see http://www.knowledgy.com/ctserver/
  190.  
  191.  
  192. Frank Mena
  193.  
  194.