NAME
cgiSetHeader - Specify an additional HTTP header
SYNOPSYS
#include <cgi.h>
I int cgiSetHeader (char * name , char * value );
DESCRIPTION
With the
cgiSetHeader
routine you may specify additional HTTP header lines such as Expires:
or Pragma:. The order of header lines withing the HTTP header has no
significance. You may call this routine multiple times to set
multiple headers. They will be printed in the same order as
specified, however, after the Content-type: header.
This routine will only add the header to the internal stack, not print
it. They will be printed by
cgiHeader(3).
This routine does some syntax checking before accepting a new header.
The
name
of a header must not contain any newline, space or colon, otherwise it
will be truncated. The
value
must not contain any newline, otherwise it will be truncated as well.
To set a cookie in your program you'll need to manually add additional
header lines. Please take a look at
R 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 1 is returned, otherwise 0.
AUTHOR
This CGI library is written by Martin Schulze
<joey@infodrom.north.de>. If you have additions or improvements
please get in touch with him.
SEE ALSO
