VOP_ADVLOCK(9)

👑 VOP_ADVLOCK — advisory record locking 💅

okay bestie, welcome to the VOP_ADVLOCK(9) page from the Kernel Developer's Manual — yes we're in kernel land today, get comfy, it's giving ✨serious business✨ but make it cute.

🌸 SYNOPSIS 🌸

#include <sys/param.h>
#include <sys/vnode.h>
#include <sys/fcntl.h>
#include <sys/lockf.h>

int
VOP_ADVLOCK(struct vnode *vp, caddr_t id, int op, struct flock *fl,
    int flags);

💖 DESCRIPTION 💖

so basically this entry point manipulates advisory record locks on the file. no cap. and here's the tea — most file systems just delegate the whole thing to lf_advlock() and call it a day. iconic behaviour honestly 🫶

now let's meet the arguments, one by one, like a little friend group:

• vp — the vnode being manipulated. that's the main character right there 👑
• id — the id token which is changing the lock. it's the one doing the changing, okay?? let it cook.
• op — the operation to perform (peep fcntl(2) for the deets).
• fl — description of the lock. literally describing the lock. so descriptive.
• flags — one of more of the following (yes, we're listing all of them, no skips, we don't do that here):
  • F_WAIT — wait until lock is granted. patience is a virtue babe 🧘
  • F_FLOCK — use flock(2) semantics for lock.
  • F_POSIX — use POSIX semantics for lock.
  • F_REMOTE — lock owner is remote NFS client. long distance relationship vibes 💀
  • F_NOINTR — mask signals while waiting for the lock.

✨ RETURN VALUES ✨

zero on success. anything else = error, and we hate that for you 😭. literally zero is the slay, everything else is the flop.

🦋 SEE ALSO 🦋

• fcntl(2)
• flock(2)
• vnode(9)

🎀 AUTHORS 🎀

This manual page was written by Doug Rabson. thank you Doug, you ate fr fr 💅✨

and that's the whole page bestie, mwah 💋 this was Debian's drop from May 27, 2019, part of the VOP_ADVLOCK(9) saga — go forth and lock responsibly 🫶🌈