get_nth_bh(9)

🎀 get_nth_bh(9) — Kernel API Manual 🎀

okay so bestie, we’re in the Kernel API Manual and this page is all about get_nth_bh(9). it’s giving “buffer meet buffer, but make it a count” energy, and honestly? iconic. 💅

---

✨ NAME ✨

get_nth_bh — Get a reference on the n'th buffer after this one. 🫶

---

🌸 SYNOPSIS 🌸

struct buffer_head * get_nth_bh (struct buffer_head *bh , unsigned int
       count );

---

💖 ARGUMENTS 💖

• bh — The buffer to start counting from. like, your starting point, bestie. 🎀
• count — How many buffers to skip. the “how many” number. ⭐

---

🦋 DESCRIPTION 🦋

This is primarily useful for finding the nth buffer in a folio. in that case you pass the head buffer and the byte offset in the folio divided by the block size. no cap, that’s the main character use case. 👑

It can be used for other purposes, but it will wrap at the end of the folio rather than returning NULL or proceeding to the next folio for you. so yeah — it’s not gonna hand you NULL, and it’s not gonna skip to the next folio on your behalf. it wraps. periodt. 💀

---

🔥 RETURN 🔥

The requested buffer, with an elevated refcount. that’s it, that’s the tea. 🍓

---

🌈 SEE ALSO 🌈

• Kernel file ./include/linux/buffer_head.h
• brelse(9)
• bforget(9)
• __bread(9)

---

okay bye bestie — source/version: ./include/linux, dated October 2026 💖✨