dpni_clear_mac_filters(9)

💅 dpni_clear_mac_filters — from the Kernel API Manual (section 9)

okay bestie, so this is dpni_clear_mac_filters(9) and it does exactly what it says on the tin: it clears all your unicast and/or multicast MAC filters. that's the whole vibe. let's get into it 🎀

---

✨ NAME ✨

dpni_clear_mac_filters — clear all unicast and/or multicast MAC filters. yes, both, or just one, you choose, main character energy 🦋

---

🌸 SYNOPSIS 🌸

int dpni_clear_mac_filters (struct fsl_mc_io *mc_io , u32 cmd_flags ,
u16 token , int unicast , int multicast );

it's giving "returns an int", it's giving "takes five args", we love a straightforward signature ✨

---

🫶 ARGUMENTS 🫶

• mc_io — pointer to the MC portal's I/O object. like, your entry point to the whole thing, don't lose it 💖
• cmd_flags — command flags; one or more of MC_CMD_FLAG_ (yep, the original cuts off right there, that's the literal prefix, iykyk)
• token — the token of the DPNI object. it's how the call knows which DPNI we're talking about 👑
• unicast — set it to 1 to clear unicast addresses
• multicast — set it to 1 to clear multicast addresses

bestie the two flags are independent ints, so decide which ones you want gone before you call. 1 means "clear it", anything else means "leave it alone" — that's just what the argument descriptions say, no extra lore from me 🙈

---

💀 DESCRIPTION 💀

the primary MAC address is not cleared by this operation. that's it. that's the whole description. your primary MAC stays put, no cap, it survives the purge 🔥

so like — go ahead and nuke the unicast and multicast filter lists, but the primary one? untouched. periodt 💅

---

⭐ RETURN ⭐

the original page has literally nothing under this heading 😭 no documented return values, no error codes, nothing. so ngl, the docs are silent here — I'm not gonna make up return values for you, that would be lying and we don't do that 🎀

---

🌈 SEE ALSO 🌈

the kernel file lives at ./drivers/net/ethernet/freescale/dpaa2/dpni.c — that's the source of truth, go read it if you're curious 🧚

and here's the full friend group, all the sibling calls, copy-pasted with love:

• dpni_prepare_key_cfg(9), dpni_open(9), dpni_close(9), dpni_set_pools(9)
• dpni_enable(9), dpni_disable(9), dpni_is_enabled(9), dpni_reset(9)
• dpni_set_irq_enable(9), dpni_get_irq_enable(9), dpni_set_irq_mask(9)
• dpni_get_irq_mask(9), dpni_get_irq_status(9), dpni_clear_irq_status(9)
• dpni_get_attributes(9), dpni_set_errors_behavior(9)
• dpni_get_buffer_layout(9), dpni_set_buffer_layout(9)
• dpni_set_offload(9), dpni_get_qdid(9), dpni_get_tx_data_offset(9)
• dpni_set_link_cfg(9), dpni_get_link_cfg(9), dpni_get_link_state(9)
• dpni_set_max_frame_length(9), dpni_get_max_frame_length(9)
• dpni_set_multicast_promisc(9), dpni_get_multicast_promisc(9)
• dpni_set_unicast_promisc(9), dpni_get_unicast_promisc(9)
• dpni_set_primary_mac_addr(9), dpni_get_primary_mac_addr(9)
• dpni_get_port_mac_addr(9), dpni_enable_vlan_filter(9)
• dpni_add_vlan_id(9), dpni_remove_vlan_id(9), dpni_add_mac_addr(9)
• dpni_remove_mac_addr(9), dpni_set_rx_tc_dist(9)
• dpni_set_congestion_notification(9), dpni_set_queue(9)
• dpni_get_queue(9), dpni_get_statistics(9), dpni_set_taildrop(9)
• dpni_get_taildrop(9), dpni_get_api_version(9), dpni_set_rx_fs_dist(9)
• dpni_set_rx_hash_dist(9), dpni_add_fs_entry(9), dpni_remove_fs_entry(9)
• dpni_set_qos_table(9), dpni_add_qos_entry(9), dpni_remove_qos_entry(9)
• dpni_clear_qos_table(9), dpni_set_tx_shaping(9)
• dpni_get_single_step_cfg(9), dpni_set_single_step_cfg(9)

---

that's the page, bestie! 🍓 this one came out of the Linux kernel docs (kernel source file ./drivers/net/ethernet/freesca..., truncated in the original footer, dated October 2026, page dpni_clear_mac_filters(9)). go clear those filters, slay, and remember — primary MAC stays 💜💅