NAME

       cgiGetFile - Return information of a CGI file variable

SYNOPSYS

       #include <cgi.h>

       s_file *cgiGetFile (s_cgi *parms, const char *name);

DESCRIPTION

       This  routine returns a pointer to a datastructure associated with the value of a CGI file
       variable.  The pointer must not be freed.

       The s_file structure is declared as follows:

              typedef struct file_s {
                  char   *name,
                         *type,
                         *filename,
                         *tmpfile;
              } s_file;

       Memory allocated by this data structure is  automatically  freed  by  the  final  call  to
       cgiFree(3).

RETURN VALUE

       On  success  a  pointer  to  the s_file datastructure is returned.  If the variable wasn't
       transmitted or the through CGI or if the filename was empty NULL is returned.

AUTHOR

       This CGI library is written by Martin Schulze <joey@infodrom.org>.  If you have  additions
       or improvements please get in touch with him.

SEE ALSO

       cgiGetFiles(3), cgiGetVariables(3), cgiGetCookies(3), cgiDebug(3), cgiInit(3), cgiFree(3).