iwpm_add_mapping(9)

💖 iwpm_add_mapping(9) 💖

okay bestie, welcome to the Kernel API Manual ✨ today's main character is iwpm_add_mapping(9) and honestly? she's giving "quietly essential glue code" and we're obsessed 🫶

---

🌸 NAME 🌸

iwpm_add_mapping — sends a netlink add mapping request to the userspace port mapper 🎀

---

⭐ SYNOPSIS ⭐

int iwpm_add_mapping (struct iwpm_sa_data *pm_msg , u8 nl_client );

---

🦋 ARGUMENTS 🦋

• pm_msg — holds the local ip/tcp address info that we're sending out 💌 literally the payload, the whole reason we're here
• nl_client — the index of the netlink client, i.e. which client we're repping 🎫

---

💅 DESCRIPTION 💅

so the netlink attributes we're working with are, in order:

[IWPM_NLA_MANAGE_MAPPING_SEQ] [IWPM_NLA_MANAGE_ADDR] [IWPM_NLA_MANAGE_FLAGS]

✨ and here's the slay part: if the request goes through successfully, pm_msg stores the port mapper's response (that's the mapped address info, iykyk) 👑

no cap — the response lands back in pm_msg itself, so keep an eye on it 👀

---

🌈 SEE ALSO 🌈

kernel file ./drivers/infiniband/core/iwpm_msg.c, plus the whole friend group:

• iwpm_valid_pid(9)
• iwpm_register_pid(9)
• iwpm_add_and_query_mapping(9)
• iwpm_remove_mapping(9)
• iwpm_register_pid_cb(9)
• iwpm_add_mapping_cb(9)
• iwpm_add_and_query_mapping_cb(9)
• iwpm_remote_info_cb(9)
• iwpm_mapping_info_cb(9)
• iwpm_ack_mapping_info_cb(9)
• iwpm_mapping_error_cb(9)
• iwpm_hello_cb(9)

like, the entire _cb squad showed up for this one 🧚💜

---

that's the whole page, bestie — go forth and map those addresses 💖

sign-off szn: this lil number lives in ./drivers/infiniband/core, dated October 2026, and it's from the Kernel API Manual ✨ mwah, talk later 🎀