cgiGetFile (3)

#include <cgi.h>

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

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).

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.

This CGI library is written by Martin Schulze <[email protected]>. If you have additions or improvements please get in touch with him.

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