dpsw_open(9)

💅 dpsw_open(9) — Kernel API Manual ✨

okay bestie, welcome to the dpsw_open page from the Kernel API Manual — it's short, it's sweet, and it's lowkey the ✨main character✨ of every DPSW session. let's get into it 🎀

---

🌸 NAME 🌸

dpsw_open — open a control session for the specified object 🫶

---

✨ SYNOPSIS ✨

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

---

🦋 ARGUMENTS 🦋

• mc_io — pointer to the MC portal's I/O object. yeah. the portal. your whole connection to the management complex, no big deal 💅
• cmd_flags — command flags; one or more of 'MC_CMD_FLAG_'. pick your flags, bestie 🚩
• dpsw_id — the DPSW unique ID. this is the object's ID, so you know exactly which one you're talking to 🌈
• token — the returned token; use it in subsequent API calls. keep this one safe, fr fr — it's coming back with you 🔑

---

💖 DESCRIPTION 💖

so this function opens a control session for an object that already exists. and like, "already exists" can mean two things: it was declared in the DPL, or somebody called the dpsw_create function. either way, it's out there living its life 🧚

what you get back is a unique authentication token. and it's not just any token — it's tied to that specific object ID and that specific MC portal. so it's giving exclusive, one-of-one, literally nobody else has this energy 👑

⚠️ real talk though: this token must be used in all subsequent commands for this specific object. forget it and you're locked out of the group chat 😭

---

💀 RETURN 💀

ngl, this page doesn't list any return stuff — the section is literally just chilling there, empty. so we're not gonna make anything up 🙈 (the signature does say int though, ikyk 👀)

---

🍓 SEE ALSO 🍓

• kernel file ./drivers/net/ethernet/freescale/dpaa2/dpsw.c
• dpsw_close(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)

the whole squad, assembled 🫶✨

---

and that's a wrap, babe 🎀 this page ships out of ./drivers/net/ethernet/freesca... with a October 2026 date stamped on it — so go forth, grab that token, and slay your control session 💜👑