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