cgigetcookies(3) [debian man page]

cgiGetCookies(3)						Programmer's Manual						  cgiGetCookies(3)

NAME

       cgiGetCookies - Returns a list of cookies

SYNOPSYS

       #include <cgi.h>

       char **cgiGetCookies (s_cgi *parms);

DESCRIPTION

       This  routine returns a NULL terminated array of names of cookies that were transmitted by the client.  To get the value of a cookie you'll
       have to use cgiGetCookie(3).  To free the memory allocated for the array, use cgiFreeList(3).

RETURN VALUE

       On success a NULL terminated array of strings is returned.  The last element is set to NULL.  If an error occurred or if  no  cookies  were
       available 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

       cgiGetValue(3), cgiGetVariables(3), cgiGetCookie(3), cgiFreeList(3), cgiDebug(3), cgiHeader(3), cgiInit(3).

CGI Library							   6 April 2008 						  cgiGetCookies(3)

cgiGetCookie(3) 						Programmer's Manual						   cgiGetCookie(3)

NAME

       cgiGetCookie - Return a cookie

SYNOPSYS

       #include <cgi.h>

       s_cookie *cgiGetCookie (s_cgi *parms, const char *name);

DESCRIPTION

       This routine returns a pointer to a s_cookie structure that contains all values for the cookie as referenced by name.  The pointer must not
       be freed.

       The s_cookie structure is declared as follows:

	      typedef struct cookie_s {
		  char	   *version,
			   *name,
			   *value,
			   *path,
			   *domain;
	      } s_cookie;

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

       To set a cookie in your program you'll need to manually add additional header lines.  Please take a look at cgitest.c.	Basically,  you'll
       need to add the following code:

	  cgiSetHeader ("Set-Cookie", "Version=1; name=value; Path=/");
	  cgiHeader();

       Please read the included file cookies.txt as well.

RETURN VALUE

       On success a pointer to a s_cookie structure is returned.  If no cookie was set or no cookie with a given name exists 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

       cgiGetValue(3), cgiGetVariables(3), cgiGetCookies(3), cgiDebug(3), cgiHeader(3), cgiInit(3), cgiFree(3).

CGI Library							   6 April 2008 						   cgiGetCookie(3)