cgi_init(3)

💖 NAME 💖

cgi_init — bestie, this is the one that initializes the ClearSilver CGI environment. Like, the opening number. The main character entrance. 🎬

✨ SYNOPSIS ✨

#include <cgi/cgi.h>

NEOERR *cgi_init (CGI **cgi, HDF *hdf);

🎀 ARGUMENTS 🎀

• cgi — a pointer to a CGI pointer. yes, a pointer to a pointer. we love a double pointer moment, it's giving inception 🌀
• hdf_file — the path to an HDF data set file that will also get loaded into the dataset. heads up bestie: this will likely have to a be a full path, because the HDF search paths are not yet set up. Certain things, like

not me leaving that last sentence exactly the way I found it 💀 the original literally trails off mid-thought with "Certain things, like" and I am NOT about to invent the rest. no cap, that's just how it ends.

🦋 DESCRIPTION 🦋

okay so cgi_init initializes the ClearSilver CGI environment, and that includes creating the HDF data set. slay. ✨

then it does a whole little routine:

• it imports the standard CGI environment variables into that dataset 🌈
• it parses the QUERY_STRING into the data set 🔍
• it parses the HTTP_COOKIE into the data set 🍪

and now the spicy part 👀 note that if the var xdisplay is in the form data, cgi_init will attempt to validate the value and launch the configured debugger on the CGI program. 💅

these variables have to be specified in the hdf_file pointed to by hdf_file.

and the default settings do NOT allow debugger launching, for security reasons. that's not a vibe killer, that's just good sense. periodt. 🛡️

👑 RETURN VALUE 👑

• cgi — an allocated CGI struct, including

again. the sentence just stops. "including" and then nothing. I'm obsessed with this manpage's commitment to the cliffhanger 😭</br>

🌸 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

okay that's the whole page bestie, you ate, go initialize something ✨

this absolute icon of a manual page is brought to you by ClearSilver, dated 12 July 2007, and it's page cgi_init(3). mwah. 💋 🎀 🫶