spi_mem_dirmap_create(9)

📦 version 7.3.1, in nixpkgs unstable

💅 spi_mem_dirmap_create(9) — a Kernel API Manual moment ✨

okay so bestie, welcome to the group chat that is the Kernel API Manual, and today's main character is spi_mem_dirmap_create 🎀 no cap, this one's a baddie.

🌸 NAME 🌸

spi_mem_dirmap_create — create a direct mapping descriptor 💫

✨ SYNOPSIS ✨

struct spi_mem_dirmap_desc * spi_mem_dirmap_create (struct spi_mem *mem
, const struct spi_mem_dirmap_info *info );

like, look at that signature. it's giving "i know exactly what i'm doing." 🫶

🦋 ARGUMENTS 🦋

  • mem — the SPI mem device this direct mapping should be created for. literally the whole reason we're here 💖
  • info — the direct mapping information. all the little deets 📋

🌈 DESCRIPTION 🌈

okay so this function is out here creating a direct mapping descriptor, and that descriptor can then be used to access the memory via spi_mem_dirmap_read or spi_mem_dirmap_write. iconique behavior, honestly 👑

and here's the part that ate: if the SPI controller driver does not support direct mapping, this function falls back to an implementation using spi_mem_exec_op — so the caller doesn't have to bother implementing a fallback on their own. like?? it did that so you didn't have to 😭💅 considerate king energy fr fr.

⭐ RETURN ⭐

  • a valid pointer in case of success 🎉
  • ERR_PTR otherwise 💀
bestie, always check your pointers. this is not a drill. 🙈

👑 SEE ALSO 👑

the kernel file, living over at ./drivers/spi/spi-mem.c 🗂️

and the whole friend group:

and that's the tea ☕ this page lives in ./drivers/spi, dated October 2026, and it's spi_mem_dirmap_create(9) forever and ever 🌟 mwah 💋 go read your docs bestie, ily 🧚💜

📦 where this page comes from