hl_pci_init(9)

💅 hl_pci_init(9) — a Kernel API Manual moment

okay so bestie, welcome to hl_pci_init(9), straight out of the Kernel API Manual. this is the little function that gets your PCI situation together before anything else can happen, and honestly? she's giving setup era. main character energy fr fr 🎀

---

✨ NAME ✨

hl_pci_init — PCI initialization code. that's it, that's the whole vibe. she initializes. she's PCI. iconic. 💅

---

🌸 SYNOPSIS 🌸

int hl_pci_init (struct hl_device *hdev );

one function, one argument, returns an int. clean, minimal, no notes. ✨

---

🦋 ARGUMENTS 🦋

• hdev — Pointer to hl_device structure. yes bestie, the pointer — you're handing her the whole device struct, not a copy. lowkey important. 🫶

---

💖 DESCRIPTION 💖

okay so here's what she actually does, no cap:

• Sets the DMA masks 🎀
• Initializes the PCI controller
• Maps the PCI BARs

that's the whole list. three little jobs, all of them load-bearing. she's not doing extra credit, she's doing exactly what she said she'd do. periodt. 👑

---

⭐ RETURN ⭐

• 0 on success 🎉 (we love a zero)
• non-zero for failure 😭 (cry about it, then go debug)

---

🌈 SEE ALSO 🌈

the kernel file that lives at:

./drivers/accel/habanalabs/common/pci/pci.c

and her whole friend group, all cross-referenced and accounted for:

• hl_pci_bars_map(9)
• hl_pci_bars_unmap(9)
• hl_pci_elbi_write(9)
• hl_pci_iatu_write(9)
• hl_pci_set_inbound_region(9)
• hl_pci_set_outbound_region(9)
• hl_get_pci_memory_region(9)
• hl_pci_fini(9)

iykyk, this is the entire PCI cinematic universe and you will be reading all of them. 🍓

---

ngl, if hl_pci_init fails you should absolutely go look at hl_pci_fini(9) too — she's the cleanup queen and she knows things. 🔥

---

and that's the page!! 💜 this came from source ./drivers/accel/habanalabs/com... (yes, it's truncated in the original, don't come for me 🙈), dated October 2026, and it's all about hl_pci_init(9). go set some DMA masks bestie, you got this 🧚✨