KHTTP_FCGI_PARSE(3)

KHTTP_FCGI_PARSE(3) 🦋

okay bestie, welcome to the Library Functions Manual — this is the page for khttp_fcgi_parse, and it's giving “tiny function, very important rules.” 💅

🌸 NAME 🌸

khttp_fcgi_parse — parse a FastCGI instance for kcgi

💖 LIBRARY 💖

This one lives in the library libkcgi — the page literally says library “libkcgi”. 🎀

✨ SYNOPSIS ✨

#include <sys/types.h>
#include <stdarg.h>
#include <stdint.h>
#include <kcgi.h>

enum kcgi_err
khttp_fcgi_parse(struct kfcgi *fcgi, struct kreq *req);

🧚 DESCRIPTION 🧚

So khttp_fcgi_parse() is the function that parses and validates a single FastCGI request. That's the whole vibe: one request, parsed, validated, slay. ✨

You can invoke it as many times as necessary, but here's the sequencing tea: it must follow a call to khttp_fcgi_init(3) and it must be followed by khttp_fcgi_free(3). No skipping steps, bestie — the order is part of the lore. 🔥

The req object filled in by khttp_fcgi_parse() must be matched by khttp_free(3) if and only if the return value is KCGI_OK. Otherwise, resources are internally freed. That “if and only if” is doing a LOT of work, so keep it close. 😭

👑 RETURN VALUES 👑

These are the same as in khttp_parse(3), except the KCGI_EXIT return code indicates that no more requests will arrive and the application should exit. Periodt. 💀

🌈 SEE ALSO 🌈

• kcgi(3)
• khttp_fcgi_init(3)
• khttp_free(3)
• khttp_parse(3)

🫶 AUTHORS 🫶

The khttp_fcgi_parse() function was written by Kristaps Dzonsons <kristaps@bsd.lv>.

---

xoxo, bestie 💖 — Debian build, $Mdocdate$, KHTTP_FCGI_PARSE(3) 🎀