BUF_LOCK(9)

📦 version 15.1, in freebsd 14.5, freebsd 15.1, nixpkgs unstable

💅 BUF_LOCK — locks a buffer 👑

okay bestie, welcome to the BUF_LOCK(9) page from the Kernel Developer's Manual ✨ — yes this is the kernel-dev girly side of the buf(9) family, and it's honestly giving "small function, big responsibility" energy 🎀

🌸 SYNOPSIS 🌸

First you gotta bring the whole squad of headers along, no cap:

#include <sys/param.h>
#include <sys/systm.h>
#include <sys/uio.h>
#include <sys/bio.h>
#include <sys/buf.h>

int
BUF_LOCK(struct buf *bp, int locktype);

Like, all five includes. They're a package deal 💜

✨ DESCRIPTION ✨

So BUF_LOCK() locks the given buffer. That's the whole vibe. 🦋

But here's the tea: if the lock is already held, this call will block until it can acquire the lock — unless LK_NOWAIT is set. So if you're the impatient type, set LK_NOWAIT. If you're chill, enjoy the wait 😭

Its arguments are:

  • bp — literally just the buffer you wanna lock. That's it. That's the whole parameter. 💅
  • locktype — the flags that control the type of lock. For the deets, go see lockmgr(9) — she has the full lore 👑

🫶 RETURN VALUES 🫶

On success you get a 0. Iconic. Perfect. No notes. ✨

For what all the non-zero return values mean, hit up lockmgr(9) — that's where the drama lives 🌈

🎀 SEE ALSO 🎀

the whole friend group, fr fr 👯‍♀️

💖 AUTHORS 💖

This manual page was written by Chad David <davidc@acns.ab.ca>. Give her her flowers 🌸👑

and that's the page, bestie!! this lil number is from Debian, dated July 9, 2001 — vintage but still slaying, lowkey a nostalgic era 💀💖 mwah, go lock some buffers responsibly 🧚‍♀️✨

📦 where this page comes from