nfp_cpp_mutex_init(9)

✨ nfp_cpp_mutex_init(9) ✨

okay bestie, welcome to the Kernel API Manual entry for nfp_cpp_mutex_init — yes that's the whole title, and yes the number 9 means it's a kernel thing, we love a section-9 moment 💅

---

🌸 NAME 🌸

nfp_cpp_mutex_init — literally just initializes a mutex location 🎀

---

🦋 SYNOPSIS 🦋

int nfp_cpp_mutex_init (struct nfp_cpp *cpp , int target , unsigned long
long address , u32 key );

yes the spacing is a little unhinged, she's doing her best, copy it exactly 😭

---

💖 ARGUMENTS 💖

• cpp — the NFP CPP handle, your main character struct 🫶
• target — the NFP CPP target ID (as in NFP_CPP_TARGET_CLS or NFP_CPP_TARGET_MU, iykyk)
• address — offset into the address space of that NFP CPP target ID ✨
• key — a unique 32-bit value for this mutex, no duplicates bestie, it's giving exclusivity 🔥

---

⭐ DESCRIPTION ⭐

So the deal is: your CPP target:address has got to point to a 64-bit aligned location, and this function will initialize 64 bits of data right there at that location. aligned only, we don't do unaligned here 🙈

This is what creates the initial mutex state — and the vibe of that state is locked by this nfp_cpp_interface 👑

⚠️ real talk: only call this when you're setting up the initial lock state upon boot-up of the system. that's it. that's the window. don't be out here calling it whenever, it is not that girl 💀

---

🌈 RETURN 🌈

0 on success, or -errno on failure — classic, iconic, we stan a predictable return value ⭐

---

🧚 SEE ALSO 🧚

• Kernel file ./drivers/net/ethernet/netronome/nfp/nfpcore/nfp_mutex.c
• nfp_cpp_mutex_alloc(9)
• nfp_cpp_mutex_free(9)
• nfp_cpp_mutex_lock(9)
• nfp_cpp_mutex_unlock(9)
• nfp_cpp_mutex_trylock(9)
• nfp_cpp_mutex_reclaim(9)

the whole mutex friend group, go read them all, they're in their linked-list era 🦋

---

mwah 💋 this page came from ./drivers/net/ethernet/netrono... and she's dated October 2026 — thanks for reading, bestie, go forth and initialize responsibly 🔥👑