BUF_TIMELOCK(9)

✨ BUF_TIMELOCK(9) ✨

okay bestie, welcome to the Kernel Developer's Manual 💅 this one's called BUF_TIMELOCK, and it lives in section 9 (kernel land, iykyk) — she locks a buffer, but make it timeout energy ⏰🦋

🌸 NAME 🌸

BUF_TIMELOCK — locks a buffer 🎀

🧚 SYNOPSIS 🧚

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

int
BUF_TIMELOCK(struct buf *bp, int locktype, char *wmesg, int catch,
    int timo);

like. look at her. five args, one int, zero chill 💖

💜 DESCRIPTION 💜

So the way that BUF_TIMELOCK() works is: it locks the buffer you hand it, and it puts a cap on how long it's allowed to sleep — that cap is timo. It also OR's catch into the sleep's priority. and wmesg is the wmesg used in the sleep. no notes, that's just the vibe 🌈

Her arguments, one by one, no gatekeeping:

• bp — the buffer to lock. this is the main character of the whole operation 👑
• locktype — flags that control the type of lock. for the details, go read lockmgr(9), she has the lore 📖
• wmesg — the wmesg used in any sleeps while acquiring the lock 😴
• catch — priority that gets OR'd into the sleep's priority 🔀
• timo — the timeout for any sleeps encountered during the lock. so if she's sleeping too long, that's the cutoff ⏳

🔥 RETURN VALUES 🔥

A value of 0 is returned on success. slay. ✅

For details on what the non-zero return values mean, see lockmgr(9) — she's got the receipts 🧾

👀 SEE ALSO 👀

• buf(9)
• BUF_LOCK(9)
• BUF_UNLOCK(9)
• lockmgr(9)

go read them, bestie, it's giving ✨well-rounded kernel dev✨

🫶 AUTHORS 🫶

This manual page was written by Chad David <davidc@acns.ab.ca>. ty for your service, king 💐

💖 lowkey reminder: every flag, every argument, every default up there is doing real work — don't skip the locktype details, lockmgr(9) is right there.

Debian · July 9, 2001 · BUF_TIMELOCK(9) — ok that's the whole page, mwah, go lock some buffers responsibly 💅🎀✨