dpsw_close(9)

💅 dpsw_close(9) — like, the whole Kernel API Manual page, but make it make sense

okay so bestie, welcome to dpsw_close(9) from the Kernel API Manual 🎀 this one's short and sweet and honestly kind of iconic for how blunt it is. it's the "we're done here, bye" function for a DPSW object's control session, and yes, you're gonna understand it in like ten seconds. periodt.

---

✨ NAME ✨

dpsw_close — closes the control session of the object. that's it. that's the whole vibe check. 🦋

---

🌸 SYNOPSIS 🌸

int dpsw_close (struct fsl_mc_io *mc_io , u32 cmd_flags , u16 token );

three args, no drama, returns an int. slay. ✨

---

💖 ARGUMENTS 💖

• mc_io — pointer to the MC portal's I/O object. this is your little doorway into the Management Complex, lowkey the main character of every call here 🚪
• cmd_flags — command flags; one or more of 'MC_CMD_FLAG_' (note the quotes, that's literally how it's written, don't come for me) 🚩
• token — the token of the DPSW object. it's a u16, it's how the object knows you're you 🎫

---

🦋 DESCRIPTION 🦋

okay so here's the tea 🍓: once this function gets called, no further operations are allowed on the object without opening a new control session.

like, that's not a suggestion, that's the rule. you closed the session, bestie, the door is shut, the lights are off, the object is not taking calls. if you want back in you're gonna have to call dpsw_open(9) and start a fresh session like everyone else. no cap. 💀

so like… don't close it and then keep poking it? that's giving "texting your ex." the session is closed. 🙈

---

⭐ RETURN ⭐

the original page lists the RETURN section with nothing under it. so like… there's genuinely nothing documented here. no return values spelled out. i'm not gonna make something up because that would be lying to you and we don't do that in this group chat 🫶 (the function signature is int though, make of that what you will 👀)

---

🌈 SEE ALSO 🌈

the kernel file lives at ./drivers/net/ethernet/freescale/dpaa2/dpsw.c — that's the source of truth, go read it if you want the deep lore 📖

and here's the whole friend group, all of them, in order, no one left out because leaving people out is rude 💜

dpsw_open(9), dpsw_enable(9), dpsw_disable(9), dpsw_reset(9), dpsw_set_irq_enable(9), dpsw_set_irq_mask(9), dpsw_get_irq_status(9), dpsw_clear_irq_status(9), dpsw_get_attributes(9), dpsw_if_set_link_cfg(9), dpsw_if_get_link_state(9), dpsw_if_set_tci(9), dpsw_if_get_tci(9), dpsw_if_set_stp(9), dpsw_if_get_counter(9), dpsw_if_enable(9), dpsw_if_disable(9), dpsw_if_get_attributes(9), dpsw_if_set_max_frame_length(9), dpsw_vlan_add(9), dpsw_vlan_add_if(9), dpsw_vlan_add_if_untagged(9), dpsw_vlan_remove_if(9), dpsw_vlan_remove_if_untagged(9), dpsw_vlan_remove(9), dpsw_fdb_add(9), dpsw_fdb_remove(9), dpsw_fdb_add_unicast(9), dpsw_fdb_dump(9), dpsw_fdb_remove_unicast(9), dpsw_fdb_add_multicast(9), dpsw_fdb_remove_multicast(9), dpsw_ctrl_if_get_attributes(9), dpsw_ctrl_if_set_pools(9), dpsw_ctrl_if_set_queue(9), dpsw_get_api_version(9), dpsw_if_get_port_mac_addr(9), dpsw_ctrl_if_enable(9), dpsw_ctrl_if_disable(9), dpsw_set_egress_flood(9), dpsw_if_set_learning_mode(9), dpsw_acl_add(9), dpsw_acl_remove(9), dpsw_acl_add_if(9), dpsw_acl_remove_if(9), dpsw_acl_prepare_entry_cfg(9), dpsw_acl_add_entry(9), dpsw_acl_remove_entry(9), dpsw_set_reflection_if(9), dpsw_if_add_reflection(9), dpsw_if_remove_reflection(9), dpsw_lag_set(9), dpsw_if_set_lag_state(9)

like. that's fifty-something pages of friends. this one's just the goodbye one. 😭

---

and that's the page, bestie!! 🧚 source file hint is ./drivers/net/ethernet/freesca... (yes it's truncated in the original, i'm not gonna pretend i know the rest, that's not the move 🙈), dated October 2026, and it signs off as dpsw_close(9). now go close your sessions properly. mwah 💋👑