rdma_read_gid_l2_fields(9)

💅 NAME 💅

okay bestie, welcome to the rdma_read_gid_l2_fields(9) page in the Kernel API Manual 💖 this one is literally here to read the vlan ID and source MAC address of a GID entry. iconic, no cap ✨

---

🌸 SYNOPSIS 🌸

here's the signature, character-for-character, don't come for me 🫶

int rdma_read_gid_l2_fields (const struct ib_gid_attr *attr , u16 *vlan_id , u8 *smac );

---

🎀 ARGUMENTS 🎀

• attr — GID attribute pointer whose L2 fields to be read 👑
• vlan_id — pointer to vlan id to fill up if the GID entry has vlan id. It is optional 🦋
• smac — pointer to smac to fill up for a GID entry. It is optional 🍓

both vlan_id and smac are optional, so breathe — no pressure, bestie 🫶

---

🦋 DESCRIPTION 🦋

rdma_read_gid_l2_fields returns 0 on success, and returns vlan id (if gid entry has vlan) and source MAC, or returns error.

that's the whole vibe: success means 0, plus the vlan id when the GID entry has one, plus the source MAC — or you get an error back instead 😭 periodt.

---

🌈 SEE ALSO 🌈

Kernel file ./drivers/infiniband/core/cache.c is in the mix, plus these besties:

• free_gid_work(9)
• del_gid(9)
• add_modify_gid(9)
• rdma_find_gid_by_port(9)
• rdma_find_gid_by_filter(9)
• rdma_query_gid(9)
• rdma_read_gid_hw_context(9)
• rdma_find_gid(9)
• rdma_get_gid_attr(9)
• rdma_query_gid_table(9)
• rdma_put_gid_attr(9)
• rdma_hold_gid_attr(9)
• rdma_read_gid_attr_ndev_rcu(9)
• ib_dispatch_event(9)

---

mwah 💋 — this page ships from ./drivers/infiniband/core, October 2026 edition, and that's the footer vibe 🫶✨