fw_csr_string(9)

💖 fw_csr_string(9) 💖

okay so bestie, welcome to the Kernel API Manual — yes that's the manual name, we're in the big leagues now — and today's main character is fw_csr_string, the little function that goes digging in the configuration ROM and comes back with a string. it's giving treasure hunt but make it FireWire 🦋

---

✨ NAME ✨

fw_csr_string — reads a string out of the configuration ROM. that's it, that's the whole job, and she does it slayfully 💅

---

🌸 SYNOPSIS 🌸

int fw_csr_string (const u32 *directory , int key , char *buf , size_t
size );

---

🎀 ARGUMENTS 🎀

• directory — the directory you wanna look in, like the root directory or the unit directory. pick your adventure, bestie 🗺️
• key — the key of the preceding directory entry. lowkey the compass that points at the right entry 👑
• buf — where the string goes to live. that's her home now 🏠
• size — the size of buf, in bytes. keep it honest, no cap 📏

---

🔥 DESCRIPTION 🔥

so here's the vibe: the string gets taken from a minimal ASCII text descriptor leaf that sits just after the entry with the key. like, immediately after. they're neighbors, they're besties, they're linked 🫶

the string is zero-terminated. periodt.

and here's the spicy part — if the string is overlong, it gets silently truncated such that it and the zero byte both fit into size. like, no warning, no drama, she just quietly makes it fit. 💀 so like, highkey watch out for that if you were expecting your whole string back.

it returns strlen(buf) or a negative error code. so if the number is negative, that's your sign something went sideways 😭

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/firewire/core-device.c — go read the source, iykyk 📖

---

hiii bestie just a lil reminder: the truncation is silent, so if your string comes back shorter than you expected, that's not a bug, that's just her fitting into the size you gave her 💅

---

mwah 💋 that's the whole page! sourced from ./drivers/firewire, dated October 2026 — so like, stay tuned for the future, and go write some iconic FireWire code, queen 👑✨🎀