BK-LOCK(1)

💅 bk lock(none) — BitKeeper User's Manual, bestie edition 🎀

okay so real talk, this page is from the BitKeeper User's Manual and it's all about bk lock, which is genuinely one of those commands that sounds scary but is actually so simple. let's get into it ✨

---

🌸 NAME 🌸

bk lock — lock a repository, or just peek at who's holding the lock (the lockers, if you will 👀)

---

✨ SYNOPSIS ✨

bk lock [−l|r|w|L|U] [−q] [directory]

that's it. that's the whole vibe check. 💅

---

🦋 DESCRIPTION 🦋

so bk lock does two iconic things: it can lock an entire repository, or it can list the lockers of a repository. like, "who's got it rn" energy.

if you pass a directory, the operation applies to the repository rooted at that directory. simple as that, no cap.

and here's the part you need to know, bestie — a lock is only valid as long as the locking process exists 😭. so when you're placing a lock, bk lock does not exit. it goes to sleep and waits for a signal. it's literally just vibing there, holding the lock down, main character energy fr fr.

🫶 don't be weirded out when it doesn't return to your prompt. it's supposed to do that. that IS the feature.

---

💖 OPTIONS 💖

• -l — list the lockers of a repository. the "who's here" option 👑
• -q — quiet mode: exit status only, no chatter. just the receipts 🤫
• -r — add a read lock (non-exclusive) and sleep until interrupted 😴
• -w — add a write lock (exclusive) and sleep until interrupted 😴🔥
• -L — wait for the repository to become locked (primarily used for testing) 🧪
• -U — wait for the repository to become unlocked (primarily used for testing) 🧪

---

🌈 EXIT STATUS 🌈

okay so the exit status depends on how you called it. pay attention, this part's important 🎀

if you called it with no options, or with the -l option, bk lock returns:

• 0 — if the repository has no locks 🎉
• 1 — if the repository has locks 🔒
• 2 — if run outside of a repository 🙈 (oops)

if you called it with either -r or -w, bk lock returns exit status 1 if it's unable to lock the repository 💀

---

⭐ SEE ALSO ⭐

bk‐unlock — the other half of the lock/unlock duo, go read it 🫶

---

💜 CATEGORY 💜

Repository 🗂️✨

---

and that's the whole page, bestie! this one's from BitKeeper Inc, version 1E1, manual page bk lock(none) — go lock something (responsibly) and remember: sleep is a feature, not a bug 😴💅 slay 🌈