GNU cgicc is an ANSI C++ compliant class library that greatly simplifies the creation of CGI applications for the World Wide Web. cgicc performs the following functions:

• Parses both GET and POST form data transparently.
• Provides string, integer, floating-point and single- and multiple-choice retrieval methods for form data.
• Provides methods for saving and restoring CGI environments to aid in application debugging.
• Provides full on-the-fly HTML generation capabilities, with support for cookies.
• Supports HTTP file upload.
• Compatible with FastCGI.

GNU cgicc requires an ANSI-compliant C++ compiler supporting the C++ standard template library. cgicc is primarily developed on GNU/Linux using gcc version 3.3, but it has been built using the following compilers:

• gcc versions 2.8.1 and greater
• Hewlett-Packard aCC
• Microsoft Visual C++ 6.0
• Borland C++ Builder 5.0

Project files for MSVC++ are included in the distribution.

GNU cgicc is distributed as a compressed tar file. You can download the latest version from ftp.gnu.org, ftp.cgicc.org, www.cgicc.org, or from any GNU mirror site. For other ways to obtain cgicc, please read How to get GNU Software.

Once you have the cgicc-3.2.3.tar.bz2 file, please verify the contents using gpg. To do this you must first download the KEY and asc signature file. Verify the signatures using the following commands (assuming you trust the authenticity of the key):

% gpg --import KEY
% gpg --verify cgicc-3.2.3.tar.bz2.asc

cgicc-3.2.3.tar.bz2 is signed by Stephen F. Booth E6A622D3

If you are satisfied the file is genuine, unpack it using the following command:

% bzip2 -dc cgicc-3.2.3.tar.bz2 | tar x

This will create the directory cgicc-3.2.3/. Generic installation intructions are in the INSTALL file.

GNU cgicc is documented using doxygen, to allow the documentation for the library to be in the same files as the library code itself. The doxygen-generated documentation is available in the cgicc-3.2.3/doc/html/ subdirectory of the distribution.

You can also browse the library documentation online.

The CVS repository used for cgicc is on savannah.gnu.org. You can extract the latest version of cgicc via read-only anonymous CVS over ssh. Here's how:

% export CVS_RSH="ssh"
% cvs -z3 -d:ext:anoncvs@savannah.gnu.org:/cvsroot/cgicc co cgicc

% cvs update

Finally, if you want to browse the source tree using viewcvs, go to http://savannah.gnu.org/cgi-bin/viewcvs/cgicc/.

cgicc has three mailing lists: help-cgicc@gnu.org, info-cgicc@gnu.org, and bug-cgicc@gnu.org.

• help-cgicc is the main discussion list and is used to discuss all aspects of cgicc, including development and porting.
• info-cgicc is where announcements about cgicc are made.
• bug-cgicc is a special list used for reporting bugs. For details on submitting a bug report, please see the subsection Reporting Bugs below.

All of these lists are managed by mailman, and can be subscribed to, unsubscribed to, and configured via a web interface by following the links above. Web archives are also available.

If you think you have found a bug in cgicc, then you should send as complete a report as possible to bug-cgicc@gnu.org. Ideally, you should include the text you get by running config.guess and the text you see when you run configure. This can be accomplished in the cgicc-3.2.3/ directory with the following commands:

% ./support/config.guess > out
% cat config.log >> out
% mail -s "cgicc bug?" bug-cgicc@gnu.org < out

If you think you have tracked down the source of the bug, please also send a patch made with diff -U 5 which fixes the problem.

Savannah is the GNU SourceForge clone.

cgicc's savannah page is http://savannah.gnu.org/projects/cgicc/, and has information on support, CVS access, tasks, and patches.

Free search service provided by Google.