stmmac_clear_tx_descriptors(9)

💅 stmmac_clear_tx_descriptors(9)

okay so bestie, this is a page straight outta the Kernel API Manual — like, the actual kernel docs, no cap — and it's about one tiny little function that does one tiny little job. but it's important okay. squeaky clean TX descriptors = happy NIC. let's go ✨

---

🌸 NAME 🌸

stmmac_clear_tx_descriptors — clear tx descriptors 🔥

---

🎀 SYNOPSIS 🎀

void stmmac_clear_tx_descriptors (struct stmmac_priv *priv , struct
stmmac_dma_conf *dma_conf , u32 queue );

---

💖 ARGUMENTS 💖

• priv — the driver private structure, aka the whole personality of the driver. it's giving "I contain everything" 💅
• dma_conf — the structure that holds the dma data 🫶
• queue — the TX queue index. which queue, bestie. be specific. 👑

---

🦋 DESCRIPTION 🦋

so this function gets called to clear the TX descriptors — and the cute part? it works whether you're running basic descriptors or extended descriptors. both. it ate and left no crumbs. 🍓

literally that's it, that's the job. no drama, just clearing TX descriptors in both descriptor situations. iconique.

---

⭐ SEE ALSO ⭐

the source lives here, in the kernel file ./drivers/net/ethernet/stmicro/stmmac/stmmac_main.c — go say hi 💜

and honestly the whole extended friend group is in here too, so let me introduce you:

• stmmac_set_clk_tx_rate(9), stmmac_axi_blen_to_mask(9), stmmac_verify_args(9), stmmac_disable_all_queues(9), stmmac_enable_all_queues(9)
• stmmac_rx_dirty(9), stmmac_try_to_start_sw_lpi(9), stmmac_stop_sw_lpi(9), stmmac_eee_ctrl_timer(9), stmmac_hwtstamp_set(9)
• stmmac_hwtstamp_get(9), stmmac_init_tstamp_counter(9), stmmac_init_timestamping(9), stmmac_mac_flow_ctrl(9), stmmac_check_pcs_mode(9)
• stmmac_init_phy(9), stmmac_clear_rx_descriptors(9), stmmac_clear_descriptors(9), stmmac_init_rx_buffers(9), stmmac_free_rx_buffer(9)
• stmmac_free_tx_buffer(9), dma_free_rx_skbufs(9), dma_free_rx_xskbufs(9), __init_dma_rx_desc_rings(9), __init_dma_tx_desc_rings(9)
• init_dma_desc_rings(9), dma_free_tx_skbufs(9), stmmac_free_tx_skbufs(9), __free_dma_rx_desc_resources(9), __free_dma_tx_desc_resources(9)
• __alloc_dma_rx_desc_resources(9), __alloc_dma_tx_desc_resources(9), alloc_dma_desc_resources(9), free_dma_desc_resources(9), stmmac_mac_enable_rx_queues(9)
• stmmac_start_rx_dma(9), stmmac_start_tx_dma(9), stmmac_stop_rx_dma(9), stmmac_stop_tx_dma(9), stmmac_start_all_dma(9)
• stmmac_stop_all_dma(9), stmmac_dma_operation_mode(9), stmmac_tx_clean(9), stmmac_tx_err(9), stmmac_set_dma_operation_mode(9)
• stmmac_dma_interrupt(9), stmmac_mmc_setup(9), stmmac_get_hw_features(9), stmmac_check_ether_addr(9), stmmac_init_dma_engine(9)
• stmmac_tx_timer(9), stmmac_init_coalesce(9), stmmac_set_tx_queue_weight(9), stmmac_configure_cbs(9), stmmac_rx_queue_dma_chan_map(9)
• stmmac_mac_config_rx_queues_prio(9), stmmac_mac_config_tx_queues_prio(9), stmmac_mac_config_rx_queues_routing(9), stmmac_mtl_configuration(9), stmmac_hw_setup(9)
• stmmac_setup_dma_desc(9), __stmmac_open(9), stmmac_release(9), stmmac_tso_allocator(9), stmmac_tso_xmit(9)
• stmmac_has_ip_ethertype(9), stmmac_xmit(9), stmmac_rx_refill(9), stmmac_rx(9), stmmac_tx_timeout(9)
• stmmac_set_rx_mode(9), stmmac_change_mtu(9), stmmac_interrupt(9), stmmac_ioctl(9), stmmac_hw_init(9)
• stmmac_dvr_probe(9), stmmac_dvr_remove(9), stmmac_suspend(9), stmmac_reset_queues_param(9), stmmac_resume(9)

that's the whole group chat, everyone showed up, everyone's iconic 🌈

---

ngl bestie, all those (9) numbers just mean "section 9, kernel API" — it's the vibe check of the docs, iykyk 💀

---

and that's the page!! mwah 💋 — this lil writeup comes from ./drivers/net/ethernet/stmicro..., dated October 2026, and it's filed under stmmac_clear_tx_descriptors(9) in the Kernel API Manual. go clear those descriptors, main character 🧚💅