RLOCK(1)

📦
version 2.1.3 · 2 versions
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu resolute

💖 RLOCK(1) 💖

okay so this is the General Commands Manual page for rlock, section 1, and bestie you're gonna love it 💅

✨ NAME ✨

rlock — run program with a lockfile 🎀

🦋 SYNOPSIS 🦋

rlock [options] lockfile program [args]

rlock [options] lockfile -- program options [args]

🌸 DESCRIPTION 🌸

so rlock creates NFS safe lockfiles. that's the whole vibe. ✨

it can optionally run a program while holding the lock, and it makes sure the lockfile gets removed when the program exits — like it's not gonna leave a mess, it's not that kind of friend 🫶

if a program is specified to be run, rlock will spawn a background thread to keep the lockfile 'fresh' by touching it at a regular interval. the way that works?? it maintains a lease on the lockfile, so other processes trying to obtain the lock can figure out that it's already in use. no cap 🔥

see the --refresh option for how to control the touch interval 👑

and any other process trying to obtain a lock will automatically remove a stale lockfile — and a stale lockfile is one that's older than a certain age. that age can be controlled via the --max_age option ⭐

🧚 ENVIRONMENT 🧚

  • LOCKFILE_DEBUG=1 — makes the internal actions of the library show up on STDERR. literally the behind-the-scenes commentary track 🙈

💀 DIAGNOSTICS 💀

rlock attempts to exit with the status of program, except where it cannot due to exceptional conditions. so like, it tries its best, okay 😭

in addition, this message:

'RLOCK SUBCOMMAND FAILURE'

will be printed on STDERR if program exits with non-zero status. so if you see that, bestie, something went sideways 💅

👑 AUTHOR 👑

lockfile was written by Ara T. Howard <ara.t.howard@noaa.gov>.

This manual page was converted by Decklin Foster <decklin@red-bean.com> for the Debian project (but may be used by others). iconic behavior honestly 🌈

mwah that's the whole page! this one's from 2008-10-11, it's RLOCK(1) from the General Commands Manual, and yeah — that's genuinely the entire source/version/date situation. slay 💖✨🎀🦋🌸💅🫶

📦 where this page comes from