"Fossies" - the Fresh Open Source Software Archive

Member "libgcgi.a-0.9.5/README" (22 Jun 2002, 2533 Bytes) of package /linux/www/old/gcgi-0.9.5.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 GNU CGI Library in C, v0.9.5
    2 =========================
    3 
    4 See ChangeLog for the list of the recent changes and NEWS for highlights.
    5 
    6 Copyright (C) 2001-2002 Julian Catchen
    7 See 'COPYING' for licence information.
    8 
    9 
   10 Authors:
   11 -------
   12         Julian Catchen <topeka@catchen.org>
   13 
   14 
   15 Website:
   16 -------
   17         http://www.catchen.org/gcgi/
   18 
   19 
   20 Description:
   21 -----------
   22 	GCGI is a library that implements NCSA's common gateway interface (CGI) 
   23 as well as extensions to that interface as defined in RFC2388.
   24 
   25 Installation:
   26 ------------
   27 	Unpack the gcgi-0.9.5.tar.gz:
   28 	
   29 	$ tar xvfz gcgi-0.9.5.tar.gz
   30 	$ cd gcgi-0.9.5
   31 
   32 	Configure the gcgi library:
   33 
   34 	$ ./configure
   35 
   36 	To build GCGI with encryption support, run configure like this:
   37 
   38 	$ ./configure --with-openssl
   39 
   40 	Build the gcgi library:
   41 
   42 	$ make
   43 
   44 	This should create the static library file, libgcgi.a in the src directory.
   45 
   46 	If you want to make the library available to the rest of the system:
   47 
   48 	$ su
   49 	# make install
   50 	
   51 	Otherwise, copy the library (src/libgcgi.a) and the gcgi.h header file somewhere convienent.  
   52 	For the following example, the library and header were copied into the same 
   53 	directory as the program being built against it.
   54 	First compile your program and then link against GCGI like this:
   55 
   56 	$ gcc -g -Wall -c example-prog.c
   57 	$ gcc -g -Wall -o example-prog -L. example-prog.o -lgcgi -lm
   58 
   59 	and if you built with OpenSSL, link like this:
   60 
   61 	$ gcc -g -Wall -o example-prog -L. example-prog.o -lgcgi -lm -lssl -lcrypto
   62 
   63 	A set of example programs will also be built in the examples/ directory.
   64 	There are example HTML forms in the examples subdirectory to use with the example programs.  
   65 	These should give you a good idea how to use GCGI's funtions. The examples do the following:
   66 
   67 		gcgiFormTest -- An example of a vanilla CGI program that fetches data from an HTML
   68 		 		form. Use this program with the formexample.html file.
   69 
   70 		gcgiFileUploadTest -- An example of how to upload files with GCGI.  Use this program
   71 				      with the fileupload.html file.
   72 
   73 		gcgiCookieTest -- An example of how to use regular and encrypted cookies with GCGI.
   74 				  Use this program with the cookietest.html file.
   75 
   76 		gcgiGetInput -- A small utility program that will capture the input to a CGI program.
   77 				This is useful when debugging with GCGI. Use this program to capture
   78 				the incoming POST data and use it along with the gcgiDebug() method in GCGI
   79 				to run a program in a debugger or from the command line. It was used to 
   80 				capture the POST data files included in the examples directory.