VOP_ADVLOCK(9)

💅 VOP_ADVLOCK(9) — Kernel Developer's Manual, but make it bestie-core ✨

✨ NAME ✨

VOP_ADVLOCK — advisory record locking, and honestly it’s giving kernel-lock main character energy 💖

---

🎀 SYNOPSIS 🎀

Okay so first you gotta include these, no skipping, bestie:

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

Then the function signature, literally:

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

---

🦋 DESCRIPTION 🦋

This entry point manipulates advisory record locks on the file. Most file systems delegate the work for this call to lf_advlock(). That’s the tea — simple on the surface, with a whole delegation situation underneath 👑

Here’s what the arguments are giving:

• vp — the vnode being manipulated. Main character of this call, honestly.
• id — the id token which is changing the lock. It’s the little name tag on the lock-changing situation.
• op — the operation to perform (see fcntl(2)). Yes, go look at fcntl(2) for the op lore.
• fl — the description of the lock. The lock’s whole look, described.
• flags — one or more of the following, bestie:
  • F_WAIT — Wait until lock is granted.
  • F_FLOCK — Use flock(2) semantics for lock.
  • F_POSIX — Use POSIX semantics for lock.
  • F_REMOTE — Lock owner is remote NFS client.
  • F_NOINTR — Mask signals while waiting for the lock.

---

🌈 RETURN VALUES 🌈

Zero is returned on success, otherwise an error is returned. That’s it. Zero = slay, error = not the vibe periodt 💀

---

🐚 SEE ALSO 🐚

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

---

🫶 AUTHORS 🫶

This manual page was written by Doug Rabson. Author icon behavior, we stan 🫶✨

🎀 Signed, sealed, delivered: Debian, February 10, 2021, VOP_ADVLOCK(9) — that’s the manual, bestie. 💅