1. Installation

[ Next | Up to Table of Contents | Previous ]

1.1. Requirements

cgihtml was written for Unix machines in C, although it has been successfully ported to Windows 95 and NT, VMS, OS-9, and other operating systems. All you need is a C compiler, and you should be set.

By default, cgihtml assumes that the CGI source code goes in the cgi-src directory and the binaries in the cgi-bin directory.


1.2. Obtaining and unpacking the distribution

You may find cgihtml.tar.gz at ftp://hcs.harvard.edu/pub/web/tools/.

To unpack the distribution, you must first gunzip it (using the GNU gzip utility) and then untar it. Copy the distribution into your CGI source directory, and try the following commands:

     % gzip -d cgihtml.tar.gz
     % tar -xvf cgihtml.tar

cgihtml is also available in UNIX compressed (.Z) and PKZipped (.zip) format.


1.3. Compiling the library

To compile the library, examine the Makefile and make sure you are satisfied with the variables. Then type:

     % make cgihtml.a

This will produce the file cgihtml.a. To compile the library as well as all of the example programs, type:

     % make all

Configuring File Upload

By default, the file upload directory is set to /tmp. To change this value, uncomment #-DUPLOADDIR=/tmp in the Makefile and replace /tmp with the directory of your choice.


1.4. Porting

While compiling the libraries on various Unix machines, you may have trouble with the "ranlib" command. If you system doesn't seem to have this command, you most likely don't need. Set the RANLIB variable in the Makefile to "true".

If you are compiling for OS-9 or DOS/16-bit Windows, you will need to change the filenames to support your OS.


[
Next | Up to Table of Contents | Previous ]
Copyright © 1996 Eugene Eric Kim / eekim@hcs.harvard.edu
Last modified: Wed Oct 16 00:56:16 PDT 1996