NAME¶
cgiSetHeader - Specify an additional HTTP header
SYNOPSYS¶
#include <cgi.h>
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
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.org>. If you
have additions or improvements please get in touch with him.
SEE ALSO¶
cgiHeader(3),
cgiGetCookies(3),
cgiGetCookie(3),
cgiInit(3).