pcie_device_free(9)

💖 pcie_device_free 💖

okay so bestie, welcome to pcie_device_free — it lives in section 9 of the Kernel API Manual (the kernel-functions corner of the manpage universe, iykyk) 🎀

---

✨ NAME ✨

pcie_device_free — Release the pcie device object @r - kref object 🦋

✨ SYNOPSIS ✨

void pcie_device_free (struct kref *r );

✨ ARGUMENTS ✨

• r — honestly? the original literally says -- undescribed -- 😭 so like… nobody wrote a description for this one. it's the struct kref * though, that part we do know. no cap.

✨ DESCRIPTION ✨

so what does it do? it free's the pcie device object 💅 (yes, the manpage says "free's", we're keeping it, it's iconic).

it will be called when the reference count reaches to zero. that's the whole vibe — kref hits zero, this function gets the aux, the object goes bye-bye 🫶

lowkey important: this is the destructor side of the refcount situation. don't be calling it while refs are still alive, bestie, that's not the move 💀

✨ SEE ALSO ✨

these are all hanging out in this kernel file: ./drivers/scsi/mpt3sas/mpt3sas_base.h — go say hi 🌸

• struct MPT3SAS_TARGET(9)
• struct MPT3SAS_DEVICE(9)
• struct _internal_cmd(9)
• struct _sas_device(9)
• pcie_device_get(9)
• pcie_device_put(9)
• struct _boot_device(9)
• struct _sas_port(9)
• struct _sas_phy(9)
• struct _sas_node(9)
• struct _enclosure_node(9)
• enum reset_type(9)
• struct pcie_sg_list(9)
• struct chain_tracker(9)
• struct scsiio_tracker(9)
• struct request_tracker(9)
• struct _tr_list(9)
• struct _sc_list(9)
• struct _event_ack_list(9)
• struct adapter_reply_queue(9)
• struct io_uring_poll_queue(9)
• struct virtual_phy(9)
• struct hba_port(9)
• struct htb_rel_query(9)
• struct MPT3SAS_ADAPTER(9)

like, that's the whole mpt3sas friend group right there 👑 go read pcie_device_get(9) and pcie_device_put(9) next, they're literally the refcount besties of this one 🔥

---

and that's the whole page, periodt 💜 this little gem comes to you from ./drivers/scsi/mpt3sas, dated October 2026, and it's filed under pcie_device_free(9) — mwah, go forth and manage your refcounts responsibly 🧚⭐