1 .\" cgiGetCookie - Return a cookie
2 .\" Copyright (c) 1998,9 by Martin Schulze <joey@infodrom.north.de>
4 .\" This program is free software; you can redistribute it and/or modify
5 .\" it under the terms of the GNU General Public License as published by
6 .\" the Free Software Foundation; either version 2 of the License, or
7 .\" (at your option) any later version.
9 .\" This program is distributed in the hope that it will be useful,
10 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
11 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 .\" GNU General Public License for more details.
14 .\" You should have received a copy of the GNU General Public License
15 .\" along with this program; if not, write to the Free Software
16 .\" Foundation, Inc.,59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
18 .TH cgiGetCookie 3 "20 August 1999" "CGI Library" "Programmer's Manual"
20 cgiGetCookie \- Return a cookie
25 .BI "s_cookie *cgiGetCookie (s_cgi *" parms ", const char *" name );
28 This routine returns a pointer to a s_cookie struct that contains all
29 values for the cookie as referenced by
32 The s_cookie structure is defined as follows:
34 typedef struct cookie_s {
43 You must NOT free this structure since it is only a pointer to
46 To set a cookie in your program you'll need to manually add additional
47 header lines. Please take a look at
49 Basically, you'll need to add the following code:
52 cgiSetHeader ("Set-Cookie", "Version=1; name=value; Path=/");
56 Please read the included file
61 On success a pointer to a s_cookie structure is returned. If no
62 cookie was set or no cookie with a given name exists NULL is returned.
65 This CGI library is written by Martin Schulze
66 <joey@infodrom.north.de>. If you have additions or improvements
67 please get in touch with him.
71 .BR cgiGetVariables (3),
72 .BR cgiGetCookies (3),