hl_pci_bars_map(9)

💅 hl_pci_bars_map — bestie, we're mapping PCI BARs today

Okay so real talk, this is the hl_pci_bars_map page from the kernel API manual (that's the hl_pci_bars_map(9) situation, section 9, kernel docs energy ✨). Strap in, it's short but it's important. 🫶

---

🌸 NAME 🌸

hl_pci_bars_map — literally here to map PCI BARs. That's the whole personality. 💅

---

✨ SYNOPSIS ✨

int hl_pci_bars_map (struct hl_device *hdev , const char * const name[3] , bool is_wc[3] );

No cap, that's the whole signature, copy it exactly, don't be cute with it. 🎀

---

🦋 ARGUMENTS 🦋

• hdev — a pointer to the hl_device structure. It's the main character of this whole function, everything else is just supporting cast. 👑
• name — an array of BAR names. Yes, an array. Plural. It knows what it is. 🍓
• is_wc — an array holding a flag per BAR, saying whether that BAR needs a write-combined mapping. So like, one little boolean bestie per BAR telling us the vibe it needs. 🌈

---

💖 DESCRIPTION 💖

So what does it actually do? Two things, and they're both iconic:

1. It requests PCI regions.
2. It maps them to kernel virtual addresses.

That's it. That's the function. Request, then map. Serving looks and doing memory things. 🔥

---

⭐ RETURN ⭐

• 0 on success — slay, we ate, everything mapped. 💅
• non-zero for failure — 😭 something went sideways, check your regions.

Fr fr, don't ignore the non-zero case. It's giving "I'm fine" when it is not fine. 💀

---

🧚 SEE ALSO 🧚

Sibling energy all the way down, go read these next:

• Kernel file ./drivers/accel/habanalabs/common/pci/pci.c — that's where the actual sauce lives, iykyk 👀
• hl_pci_bars_unmap(9) — the un-mapper, it's giving "undo" 🎀
• 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_init(9)
• hl_pci_fini(9)

---

Okay that's the whole page, 10/10 no notes 🌈

Huge thanks to the <pink>./drivers/accel/habanalabs/com...</pink> era of the kernel tree for bringing us this one — that's the source/version line, and the date stamp on it is <purple>October 2026</purple>. And yes, the page footer is also hl_pci_bars_map(9) because it's consistent like that. Bye bestie, go map some BARs responsibly 💜🦋✨