gelic_card_init_chain(9)

💖 gelic_card_init_chain(9) 💖

okay so bestie, we're in the kernel API manual today and the page is literally called gelic_card_init_chain(9) — yes that's the whole title, keep up 💅 — and it's about linking a descriptor chain. slay. let's get into it 🎀

---

✨ SYNOPSIS ✨

int gelic_card_init_chain (struct gelic_card *card , struct
gelic_descr_chain *chain , struct gelic_descr *start_descr , int no );

that's the whole signature, no cap. four args, one int coming back at you 🫶

---

🌸 ARGUMENTS 🌸

• card — the card structure. it's giving "main character" — everything else here hangs off it 👑
• chain — the address of the chain. yes, the address. we're passing a pointer to the chain, not the chain itself, iykyk ✨
• start_descr — the address of the descriptor array. this is where the descriptors actually live 🦋
• no — the number of descriptors. how many we're working with, fr fr 🔢

---

💜 DESCRIPTION 💜

okay so the vibe here: we manage a circular list that mirrors the hardware structure 🔄 — except (and this is the important bit, don't skip it) the hardware uses bus addresses. so it's a mirror, not a copy. same shape, different address situation. noted 💀

and the return? literally:

• returns 0 on success ✅
• returns <0 on failure 😭

that's it, that's the contract. no guessing, that's what the page says 🫶

bestie reminder: <0 means failure. don't just check for -1, check for anything below zero, okay? ✨

---

🦋 SEE ALSO 🦋

the whole squad, in the order the page gives them, because we do not skip people here 💅:

• Kernel file ./drivers/net/ethernet/toshiba/ps3_gelic_net.c
• gelic_descr_get_status(9)
• gelic_card_disable_txdmac(9)
• gelic_card_enable_rxdmac(9)
• gelic_card_disable_rxdmac(9)
• gelic_descr_set_status(9)
• gelic_card_reset_chain(9)
• gelic_card_free_chain(9)
• gelic_descr_prepare_rx(9)
• gelic_card_release_rx_chain(9)
• gelic_card_fill_rx_chain(9)
• gelic_card_alloc_rx_skbs(9)
• gelic_descr_release_tx(9)
• gelic_card_release_tx_chain(9)
• gelic_net_set_multi(9)
• gelic_net_stop(9)
• gelic_card_get_next_tx_descr(9)
• gelic_descr_set_tx_cmdstat(9)
• gelic_descr_prepare_tx(9)
• gelic_card_kick_txdma(9)
• gelic_net_xmit(9)
• gelic_net_pass_skb_up(9)
• gelic_card_decode_one_descr(9)
• gelic_net_poll(9)
• gelic_net_poll_controller(9)
• gelic_net_open(9)
• gelic_net_tx_timeout_task(9)
• gelic_net_tx_timeout(9)
• gelic_ether_setup_netdev_ops(9)
• gelic_net_setup_netdev(9)
• gelic_alloc_card_net(9)

like, the entire friend group showed up 🌈 love that for them.

---

and that's the page!! mwah 💋 this lil manpage lives in ./drivers/net/ethernet/toshiba, dated October 2026, and it's filed under the very iconic name gelic_card_init_chain(9) — go forth and link those chains, bestie 🧚💖