stmmac_hw_init(9)
π stmmac_hw_init(9) β like, the Kernel API Manual, but make it make sense π
okay so bestie, we're in the Kernel API Manual today and the main character is stmmac_hw_init(9). yes it's a mouthful. no you don't have to pronounce it. let's go π
β¨ NAME β¨
stmmac_hw_init β Init the MAC device. that's it, that's the whole thing. it inits. the MAC. device. slay π
πΈ SYNOPSIS πΈ
int stmmac_hw_init (struct stmmac_priv *priv );
like, it takes one thing and gives you back an int. no cap.
π¦ ARGUMENTS π¦
privβ the driver private structure. the little bag of everything the driver knows about itself. you bring it, the function does stuff to it, everyone moves on π«Ά
π DESCRIPTION π
so here's the vibe: this function configures the MAC device according to some platform parameters or the HW capability register. either the platform tells it how to be, or it reads the HW capability register and finds out for itself. main character energy honestly π
and what's it doing with all that info? it prepares the driver to use either ring or chain modes, and to set up either enhanced or normal descriptors. that's the whole assignment. no extra credit, no side quests. literally just getting the driver dressed and ready before the real work starts β¨
π₯ SEE ALSO π₯
first up, the source of truth, the origin story, the place where all of this actually lives:
- Kernel file
./drivers/net/ethernet/stmicro/stmmac/stmmac_main.c
and now the extended universe, the whole friend group, fr fr π β every single one of these, no skips:
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_tx_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_dvr_probe(9)stmmac_dvr_remove(9)stmmac_suspend(9)stmmac_reset_queues_param(9)stmmac_resume(9)
no cap, that's genuinely the entire page π there's no OPTIONS section, no EXIT STATUS, no BUGS, no hidden lore. this one's short and sweet and honestly? we love a low-maintenance manpage π
okay bestie, signing off π§ this lil masterpiece came from ./drivers/net/ethernet/stmicro... (the truncated path, she's mysterious like that πΈ) and it's dated October 2026 β yeah, from the future, iconic behavior β and the whole thing is filed under stmmac_hw_init(9). mwah, bye ππβ¨
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms