pdc_hw_init(9)
β¨ pdc_hw_init(9) β¨
okay so bestie, welcome to the Kernel API Manual β yes that's the manual, we're in the big-kid docs now π
this one's about a lil function called pdc_hw_init, and honestly? it's giving "short and sweet but lowkey important". let's get into it π«Ά
πΈ NAME πΈ
pdc_hw_init β takes the initialization parameters you hand it and uses them to initialize the state for one of the PDCs β¨
like, that's literally the whole job. you give it the params, it sets up the state for one of the PDCs. iconic behavior honestly π
π SYNOPSIS π
void pdc_hw_init (struct pdc_state *pdcs );
that's it. one arg. no return value (void, she doesn't owe you an answer π
). copy it exactly, bestie, character for character β no "fixing" the spacing, we don't do that here π
π¦ ARGUMENTS π¦
pdcsβ the state of the PDC π that's the thing you're handing over. it's astruct pdc_state *, so yes, pointer, and yes, it needs to actually be a real PDC's state. don't be weird about it π
β SEE ALSO β
okay this is the part where the manpage just dumps the whole friend group on you π but fr fr, these are all in the kernel file ./drivers/mailbox/bcm-pdc-mailbox.c, and they all get their own (9) pages β go read them, iykyk:
pdc_setup_debugfs(9)pdc_build_rxd(9)pdc_build_txd(9)pdc_receive_one(9)pdc_receive(9)pdc_tx_list_sg_add(9)pdc_tx_list_final(9)pdc_rx_list_init(9)pdc_rx_list_sg_add(9)pdc_irq_handler(9)pdc_work_cb(9)pdc_ring_init(9)pdc_desc_count(9)pdc_rings_full(9)pdc_last_tx_done(9)pdc_send_data(9)pdc_hw_disable(9)pdc_rx_buf_pool_create(9)pdc_interrupts_init(9)pdc_mb_init(9)pdc_dt_read(9)pdc_probe(9)
and the kernel file itself: ./drivers/mailbox/bcm-pdc-mailbox.c β that's the source of truth, the main character, the whole vibe π₯
that's the page, bestie β short, sweet, and every single reference intact, no cap β¨ this beauty lives under ./drivers/mailbox, from the October 2026 release of the Kernel API Manual, page pdc_hw_init(9). mwah, go init some PDC state ππ
π¦ 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