NAME

cgi_cookie_set - Set a browser Cookie

SYNOPSIS

#include <cgi/cgi.h>

NEOERR *cgi_cookie_set (CGI *cgi, const char *name, const char *value, 


                        const char *path, const char *domain, 


                        const char *time_str, int persistent, int secure);

ARGUMENTS

cgi - a CGI struct
name - the name of the cookie
value - the value to set the cookie to.
path - optional path for which the cookie is valid. Default
is /
domain - optional domain for which the cookie is valid. You
can use cgi_cookie_authority to determine this
domain. Default is none, which is interpreted by
the browser as the sending domain only.
time_str - expiration time string in the following format

DESCRIPTION

cgi_cookie_set will issue a Set-Cookie header that should cause a browser to return a cookie when required. Note this function does no escaping of anything, you have to take care of that first.

HH:MM: SS GMT. Only used if persistent. Default is one year from time of call. persistent - cookie will be stored by the browser between sessions secure - cookie will only be sent over secure connections

RETURN VALUE

None

SEE ALSO

cgi_debug_init(3), cgi_parse(3), cgi_destroy(3), cgi_js_escape(3), cgi_html_escape_strfunc(3), cgi_register_strfuncs(3), cgi_output(3), parse_rfc2388(3), cgi_url_validate(3), open_upload(3), cgi_cs_init(3), cgi_url_escape_more(3), cgi_html_strip_strfunc(3), cgi_neo_error(3), cgi_redirect(3), cgi_filehandle(3), cgi_register_parse_cb(3), cgi_url_escape(3), cgi_init(3), cgi_redirect_uri(3), cgi_cookie_clear(3), cgi_url_unescape(3), cgi_vredirect(3), cgi_display(3), cgi_html_ws_strip(3), cgi_error(3), cgi_cookie_set(3), cgi_text_html_strfunc(3), cgi_cookie_authority