KHTTP_FCGI_GETFD(3)

💖 KHTTP_FCGI_GETFD(3) 💖

okay bestie, this one is from the Library Functions Manual and it's giving “tiny getter function with big async energy” ✨

🌸 NAME 🌸

khttp_fcgi_getfd — get the FastCGI control socket 🫶

🎀 LIBRARY 🎀

library “libkcgi” — yes, that libkcgi 💅

✨ SYNOPSIS ✨

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

int
khttp_fcgi_getfd(const struct kfcgi *fcgi);

🦋 DESCRIPTION 🦋

okay so khttp_fcgi_getfd() gets the control socket used for handling FastCGI processes 💖. Use it for polling purposes only in asynchronous applications — that's its whole lane. If you manipulate the returned socket descriptor in any other way, the results are undefined 😭, so like... don't.

The returned descriptor is only valid after khttp_fcgi_init(3) and prior to khttp_fcgi_free(3) ⭐. That window, bestie, that's the window.

🌈 EXAMPLES 🌈

The example below starts an application in FastCGI or regular CGI mode depending upon the environment 🧚:

int
main(void)
{
  struct pollfd  pfd;
  struct kreq    req;
  struct kfcgi  *fcgi;
  enum kcgi_err  er;
  int rc;

  er = khttp_fcgi_init(&fcgi, NULL, 0, NULL, 0, 0);
  if (er != KCGI_OK)
    errx(1, "khttp_fcgi_init: %s", kcgi_strerror(er));

  pfd.events = POLLIN;
  pfd.fd = khttp_fcgi_getfd(fcgi);

  /* Poll on other sockets here... */
  while ((rc = poll(&pfd, 1, INFTIM)) != -1) {
    er = khttp_fcgi_parse(fcgi, &req);
    if (er != KCGI_OK)
      err(1, "khttp_fcgi_parse: %s", kcgi_strerror(er));
    if (KCGI_EXIT == er) {
      khttp_free(&req);
      break;
    }
    /* Do something. */
    khttp_free(&req);
  }
  khttp_fcgi_free(fcgi);
  if (rc == -1)
    err(1, "poll");
  return 0;
}

💜 SEE ALSO 💜

kcgi(3) — go read it, bestie 📚

👑 AUTHORS 👑

Written by Kristaps Dzonsons <kristaps@bsd.lv>. — iconic ✨

---

xoxo, from Debian, dated $Mdocdate$, on the KHTTP_FCGI_GETFD(3) page 💜🫶