PLOCKSTAT(1)

💖 NAME 💖

okay so this is plockstat(1), and yes bestie, it's lowkey from the General Commands Manual — we're tracing pthread locks today and it's giving main character energy 💅

plockstat — Trace pthread lock statistics using DTrace ✨

---

🦋 SYNOPSIS 🦋

plockstat [-vACHV] [-n count] [-s depth] [-e secs] [-x opt=val] command
          [arg...]
plockstat [-vACHV] [-n count] [-s depth] [-e secs] [-x opt=val] -p pid

---

🌸 DESCRIPTION 🌸

The plockstat utility traces pthread locks — that's mutexes and rwlocks, bestie — and prints statistics about them. You can use plockstat to investigate bottlenecks in your software. Literally so useful for finding out where your code is being slow and dramatic 😭

The following options are available:

• -v — Be verbose. Spill the tea, queen 💬
• -A — Print all statistics. All of them. No crumbs 🙈
• -C — Print commulative statistics (the default). Yes, that's the spelling in the original — we keep it, periodt 💅
• -H — Print a histogram. It's giving data visualization slay 📊
• -V — Print the DTrace script about to be used to stderr. Peek behind the curtain, iykyk 🎀
• -n count — Set the aggregation count for the data set. Numbers, but make it cute 🔢
• -s depth — Set the ustack (userland stack) caller depth. Get that stack depth, bestie 🧚
• -e secs — Does nothing at the moment. She's just vibing 😭
• -x opt=val — Specify DTrace options. See the dtrace(1) man page for more details 👑

---

⭐ EXIT STATUS ⭐

The plockstat utility exits 0 on success, and >0 if an error occurs. So 0 is the slay outcome, and anything above is the "not me, not today" outcome 💀

---

🌈 SEE ALSO 🌈

• dtrace(1)
• pthread(3)

---

👑 HISTORY 👑

The plockstat utility comes from OpenSolaris and was first imported into FreeBSD 9.0 — a whole origin story, honestly 🫶

---

This page is from Debian, dated September 13, 2010 — mwah, periodt 💋💖