ocfs2_hb_ctl(8)

📦
version 1.8.9 · 3 versions
, in fedora 44, ubuntu resolute, ubuntu stonking

✨ ocfs2_hb_ctl ✨ — like, the OCFS2 manual page, bestie 💖

okay so you found yourself staring at ocfs2_hb_ctl(8), the OCFS2 manual page, and you're like "what is this, why is it yelling at me." bestie. sit down. I got you. 🫶

🌸 NAME 🌸

ocfs2_hb_ctl — starts and stops the O2CB local heartbeat on a given device. that's the whole gig. it's giving "tiny tool, big responsibility." 👑

🌈 SYNOPSIS 🌈

ocfs2_hb_ctl -S -d device service
ocfs2_hb_ctl -S -u uuid service
ocfs2_hb_ctl -K -d device service
ocfs2_hb_ctl -K -u uuid service
ocfs2_hb_ctl -I -d device
ocfs2_hb_ctl -I -u uuid
ocfs2_hb_ctl -P -d device [-n io_priority]
ocfs2_hb_ctl -P -u uuid [-n io_priority]
ocfs2_hb_ctl -h

like. look at her. nine whole ways to say hi. 💅

🦋 DESCRIPTION 🦋

ocfs2_hb_ctl</purl> starts and stops local heartbeat on a OCFS2 device. that's it, that's the job.

lowkey important: users are strongly urged not to use this tool directly. fr fr. it gets invoked automatically by mount.ocfs2(8) and the other tools that need heartbeat notifications. so like, it's not ghosting you, it's just busy. 😭

this utility only operates in local heartbeat mode. and here's the unhinged part: it fails silently when you run it in global heartbeat mode. no error, no drama, just nothing. the way that it ghosts you and doesn't even text back 💀. want the full lore on heartbeat modes? that's in o2cb(7).

the tool accepts devices specified by its name or its uuid. and service denotes the application that is requesting the heartbeat notification. so like, who's asking. we always need to know who's asking. 🙈

🎀 OPTIONS 🎀

  • -S — starts the heartbeat. go bestie go 🏃‍♀️✨
  • -K — stops the heartbeat. okay pack it up, we're done here 💤
  • -I — prints the heartbeat reference counts for that heartbeat region. receipts!! 🧾
  • -d — specify region by device name.
  • -u — specify region by device uuid.
  • -n — adjust IO priority for the heartbeat thread. this option calls the ionice tool to set its IO scheduling class to realtime with the scheduling class data as provided. heads up: this option is usable only with the O2CB cluster stack. no O2CB, no priority glow-up. 💅
  • -h — displays help and exit. the classic "just tell me what's happening" move 🫶

🔥 SEE ALSO 🔥

the whole friend group, no cap:

👑 AUTHORS 👑

Oracle Corporation. icons only, we respect it. ✨

Copyright © 2004, 2012 Oracle. All rights reserved. — periodt. 📜

and that's the whole page, bestie!! this was Version 1.8.9, dated January 2012 — oldie but a goodie, she's been iconic since way before you got here 🌈⭐ don't run it directly, let mount.ocfs2(8) do the talking, and remember: local heartbeat mode only, or it'll just silently ghost you 💀🫶 mwah, go slay your cluster 💖

📦 where this page comes from