KMALLOC(3)

KMALLOC(3) — but make it bestie ✨

okay so this is from the Library Functions Manual and it's literally all about memory allocation for kcgi. no cap, it's giving "I handle your malloc so you don't have to" energy. 🎀

---

✨ NAME ✨

bestie, listen — these are the memory allocation functions for kcgi:

• kasprintf
• kcalloc
• kmalloc
• krealloc
• kreallocarray
• kstrdup
• kvasprintf

they're all here to keep your memory game strong 💪

---

🌈 LIBRARY 🌈

you'll find these in the library “libkcgi” — that's the one, periodt.

---

📚 SYNOPSIS 📚

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

int
kasprintf(char **p, const char *fmt, ...);

void *
kcalloc(size_t nm, size_t sz);

void *
kmalloc(size_t sz);

void *
krealloc(void *p, size_t sz);

void *
kreallocarray(void *p, size_t nm, size_t sz);

char *
kstrdup(const char *cp);

int
kvasprintf(char **p, const char *fmt, va_list ap);

like, just look at that signature glow-up ✨

---

💖 DESCRIPTION 💖

so here's the tea: these functions are basically the libc versions but with main character energy. they wrap around the regular libc allocation functions, BUT — and this is the important part — if allocation fails, they print a warning message to standard error output and then call exit(3). like, they don't just return NULL and leave you hanging. they're dramatic and they will end the whole program. 💀

⚠️ warning bestie: allocation failure means your program is done. no second chances, no "try again later." they said "exit(3)" and they meant it.

and there's more! calling kcalloc(), kmalloc(), krealloc(), or kreallocarray() with sz or nm equal to zero — or passing NULL to kstrdup() — will also print a warning message to standard error output and produce non-portable results. so like, don't do that. it's giving undefined behavior and we don't stan that here. 🙈

---

👀 SEE ALSO 👀

• kcgi(3) — go read it, iykyk 🦋

---

👑 AUTHORS 👑

these iconic functions were written by Kristaps Dzonsons <kristaps@bsd.lv>. absolute legend behavior fr fr. 🫶

---

alright bestie, that's the whole page! signing off with Debian vibes and $Mdocdate$ energy — you're gonna slay those allocations now, no cap 💅✨