STORE(9)

💾 STORE(9) 💾

okay bestie, welcome to the Kernel Developer's Manual entry for STORE(9) — this is literally the group chat where we store data to user-space 💅✨

✨ NAME ✨

store, subyte, suword — store data to user-space 🫶

🌈 SYNOPSIS 🌈

#include <sys/types.h>
#include <sys/time.h>
#include <sys/systm.h>

int
subyte(volatile void *base, int byte);

int
suword(volatile void *base, long word);

int
suword16(volatile void *base, int word);

int
suword32(volatile void *base, int32_t word);

int
suword64(volatile void *base, int64_t word);

🎀 DESCRIPTION 🎀

The store functions are designed to copy small amounts of data to user-space. If the user address is naturally aligned, then the operation will be performed atomically. Otherwise it may fail or be performed non-atomically, depending on the platform.

⚠️ alignment vibe check: naturally aligned = atomic slay; otherwise it may fail or be performed non-atomically, depending on the platform. not me warning you twice, it's literally in the paragraph above 😭

The store routines provide the following functionality:

• subyte() — stores a byte of data to the user-space address base. 🍓
• suword() — stores a word of data to the user-space address base. 💖
• suword16() — stores 16 bits of data to the user-space address base. ✨
• suword32() — stores 32 bits of data to the user-space address base. 🔥
• suword64() — stores 64 bits of data to the user-space address base. 👑

💖 RETURN VALUES 💖

The store functions return 0 on success or -1 on failure. That's it. no notes. 😌

🦋 SEE ALSO 🦋

copy(9), fetch(9) — go read those too bestie, iykyk 📚

okay that's the whole page! mwah 💋 — Debian, July 22, 2021, STORE(9) 🎀🫶