
    Ciphergram Solver for unix/httpd v1.0
    Copyright (C) 1997  K. L. Dunn

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

    Author: K. L. Dunn    email: k.l.dunn@ieee.org

Ciphergram Solution Assistant -- A Cryptoquote Solver

Building:

You will need the GNU C compiler system, v2.6.x or later, to compile
spook.c.  There is no makefile.  On most platforms, this should work:

   gcc -O2 spook spook.c

Installing:

You need a Unix server with httpd that supports CGI.  The archive contains
these files:

-rw----r-- kdunn/swgroup 1319497 Mar 21 08:20 2000 cgi-bin/nlist
-rwx------ kdunn/swgroup   26631 Aug 15 14:38 2000 cgi-bin/spook.c
-rwx---r-x kdunn/swgroup    6571 Aug 16 08:23 2000 cgi-bin/csa.cgi
-rw----r-- kdunn/swgroup    4224 Aug 16 08:27 2000 csa.htm
-rw----r-- kdunn/swgroup    1852 Aug 14 20:41 2000 csaerr.htm
-rw-r--r-- kdunn/swgroup    2548 Aug 16 08:28 2000 install.txt
-rw-r--r-- kdunn/swgroup   18347 Aug 15 14:19 2000 license.txt

It should suffice to unpack the archive into the document root for the
httpd, and move the cgi-bin files into the httpd's cgi-bin directory.
You might have to set different permissions and ownerships; consult
the httpd documentation.  Build spook as above, in the cgi-bin directory.
Create a directory off cgi-bin with the name x and permissions such that
the perl script can read/write/exec; the script creates a link to spook
in that directory.

You will have to edit the -.cgi script and the two htm files if you
want to serve the solver to anything other than the local host.  You
should be able to test it as is by invoking the csa.htm page like this:

  http://localhost/csa.htm

The perl script (csa.cgi) should be taken as a starting point.  It
is not very secure as shown.  The script that the home site at

  http://home.hiwaay.net/~kdunn/problems/ciphform.shtml

uses is much more complex, and provides more security for the server.


Running:

User instructions are in the htm pages.



Author:

  K. L. Dunn   k.l.dunn@ieee.org
