tcp_pagein(3z)

💖 tcp_pagein — bestie, let's page in that ZSock data area 💖

okay so this is tcp_pagein(3z) from the z88dk Programmer's Manual, and honestly? it's giving "tiny function, huge responsibility." let me put you on. ✨

---

🌸 SYNOPSIS 🌸

#include <net/misc.h>

u8_t tcp_pagein(void);

no arguments, no drama, just vibes and a u8_t coming back at you. 💅

---

🦋 DESCRIPTION 🦋

okay so here's the tea, bestie. tcp_pagein() pages the ZSock data area into segment 1 of the z88's memory map. and when we say segment 1, we mean it's parked at addresses 16384-32767. that's the spot. that's where it lives now. periodt. 👑

who is this for, you ask? it's primarily of use to daemons — yes, actual daemons, little background guys — who use the ZSock data area for small amounts of storage. so if you're a daemon doing a lil bit of hoarding, this is your function, and it ate. 🔥

---

✨ RETURN VALUE ✨

tcp_pagein() hands you back the previous binding of segment 1. and like… don't just toss it, okay?? 😭 that return value is supposed to be used as a parameter to tcp_pageout(3z). hold onto it like it's your iced coffee. 🧊

no cap: the whole point is that you put things back the way you found them. keep that return value, you'll need it.

---

🎀 SEE ALSO 🎀

• tcp_pageout(3z)
• tcp_malloc(3z)
• tcp_calloc(3z)
• tcp_free(3z)

---

💜 AUTHOR 💜

Dominic Morris <dom@jb.man.ac.uk> — the icon who wrote this. 🫶

---

and that's the whole page, bestie!! this version was living in the z88dk Programmer's Manual, dated 18 February 2000 — a whole legend from a whole era. go page that data area in. slay. 💖✨🎀