cgi 12025.03.29: an ANSI C library for CGI Programming
                                  By Stone Fox

Credits and Copying
-------------------
cgi is dedicated to the public domain by Stone Fox. Do with it what you please.

What is cgi?
------------
cgi is an ANSI C-language library for the creation of CGI-based XHTML
applications. For basic information about the CGI standard, see the CGI
documentation at NCSA.

cgi performs the following tasks:
  * Parses form data, correcting for defective and/or inconsistent
    browsers
  * Transparently accepts both GET and POST form data
  * Accepts regular form fields
  * Handles line breaks in form fields in a consistent manner
  * Provides string, integer, floating-point, and single- and
    multiple-choice functions to retrieve form data
  * Provides bounds checking for numeric fields
  * Loads CGI environment variables into C strings

cgi is compatible with any CGI-compliant server environment, and compiles
without modification in environments supported by libfndn.

History
-------
This CGI library was originally written to accept input from XHTML forms on the
Rose City Furs website. It was first published along with the rest of the
website on April 3rd, 12025.

Obtaining cgi
-------------
cgi is distributed via Gopher and HTTP as a TAR file. All modern Unix
systems come with 'tar' as standard equipment, and Tar is not difficult to find
if yours does not. Versions of these programs for other operating systems are
widely available if you do not already have it.

To compile libcgi, you will need the GNU C compiler. None of the code, including
libfndn, uses a feature specific to GCC, its just that the author has not tested
any other compiler.

Once you have the file, issue the following commands to unpack it:

  tar -xf libcgi.tar

This should produce the subdirectory 'libcgi', which will contain the complete
cgi distribution for version 12025.03.29.

This command also produces the subdirectory 'libcgi', which will contain the
complete cgi distribution, including a copy of this documentation in the file
README.

cgi is available via Gopher at gopher://stonefox.local/9/repository/libcgi.tar
and HTTP from http://www.unix.dog/~stone/repository/libcgi.tar.

Building libcgi: A Sample Application
-------------------------------------
The sample application 'cgitest.c' is provided as part of the libcgi
distribution. This CGI program displays an input form, accepts a submission,
and then displays what was submitted. In the process essentially all of
libcgi's features are tested.

You can build cgitest simply by typing or './build.sh cgitest.cgi', or if you
have Make installed, 'make cgitest.cgi'. cgi.c and cgitest.c will be compiled
and linked together to produce the cgitest application.

After compiling cgitest.cgi, you will need to place it in a location on your
server system which is configured as the appropriate location for CGI scripts.

Once you have moved cgitest.cgi to an appropriate cgi directory, use the web
browser of your choice to access the URL at which you have installed it (for
instance, www.mysite.com/cgi-bin/cgitest.cgi). Fill out the various fields in
any manner you wish, then select the SUBMIT button.

If all goes well, cgitest.cgi will respond with a page which indicates the
various settings you submitted. If not, please reread the section above
regarding the correct location in which to install your CGI program on your
web server.