Man Linux: Main Page and Category List

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