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.0, 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 (.tar.gz). You can download the latest version from http://ftp.gnu.org, ftp://ftp.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.2.tar.gz file, unpack it using the following command:

% tar zxf cgicc-3.2.2.tar.gz

This will create the directory cgicc-3.2.2/. Installation intructions are in the file INSTALL located in the cgicc-3.2.2/ directory.

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.2/doc/html/ subdirectory of the distribution.

You can also browse the library documentation online.

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

% cvs -z3 -d :pserver:anoncvs@subversions.gnu.org:/cvsroot/cgicc login
Password: [hit enter]
% cvs -z3 -d :pserver:anoncvs@subversions.gnu.org:/cvsroot/cgicc co cgicc

% cvs update

If you prefer, you can extract the tree using rsync.

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-cgiccATgnu.org>, <info-cgiccATgnu.org>, and <bug-cgiccATgnu.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-cgiccATgnu.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.2/ directory with the following commands:

% support/config.guess > out
% ./configure >> out
% mail -s "cgicc bug?" bug-cgiccATgnu.org < out

If you think you have tracked down the source of the bug, please also send a patch made with diff -u5 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.