STRUCT ICE_ADAPTER(9)

💅 NAME 💅

ok so welcome to the Kernel API Manual, bestie — this page is all about struct ice_adapter, which is literally the PCI adapter resources that get shared across PFs. shared!! across PFs!! the way that one struct is carrying the whole squad 🫶

✨ SYNOPSIS ✨

here's the whole vibe, copy-pasted exactly because you KNOW we don't mess with code:

struct ice_adapter {
    refcount_t refcount;
    spinlock_t ptp_gltsyn_time_lock;
    spinlock_t txq_ctx_lock;
    struct mutex cpi_phy_lock[ICE_E825_MAX_PHYS];
    struct ice_pf *ctrl_pf;
    struct ice_port_list ports;
    u64 index;
 };

that's it. that's the struct. iconic behavior honestly 🎀

🦋 Members 🦋

okay now let's do a little meet-and-greet with every single field, no skipping, we don't do that here 💖

• refcount — the reference count, ngl. the struct ice_pf objects are the ones holding the references. they're the ones showing up to the party, fr fr.
• ptp_gltsyn_time_lock — a spinlock that protects access to the GLTSYN_TIME register of the PTP clock. it's giving bodyguard energy 🔥
• txq_ctx_lock — another spinlock, this one protecting access to the GLCOMM_QTX_CNTX_CTL register. yes bestie, another one. we stay protected 💅
• cpi_phy_lock — per-PHY mutex that serializes CPI REQ/ACK transactions, and it's an array of ICE_E825_MAX_PHYS of them. index 0 = PHY0, index 1 = PHY1. used on E825C devices. very demure, very per-PHY 🌸
• ctrl_pf — the control PF of the adapter. the main character, lowkey 👑
• ports — the ports list. a whole list!! of ports!!
• index — a 64-bit index that's cached for collision detection on 32bit systems. it's literally just sitting there being 64-bit so 32bit systems don't get confused 😭

🌈 SEE ALSO 🌈

if you wanna keep reading (and you should, bestie, we're obsessed with documentation):

• Kernel file ./drivers/net/ethernet/intel/ice/ice_adapter.h — and also struct ice_port_list(9), go say hi 🦋

literally go read the header file. iykyk. no cap, it's right there in the source tree ✨

and that's the whole page!! this little writeup came from ./drivers/net/ethernet/intel/ice, dated October 2026 — slay, you made it to the end, periodt 🎀💜 bye bestie!!