---
name: "ocfs2_hb_ctl"
section: "8"
platform: "linux"
package: "ocfs2-tools"
version: "1.8.8-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/ocfs2_hb_ctl"
---

# ocfs2\_hb\_ctl(8)

Starts and stops the O2CB local heartbeat on a given device.

## NAME

ocfs2\_hb\_ctl - Starts and stops the *O2CB* **local** heartbeat on a given device.

## 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**\

## DESCRIPTION

**ocfs2\_hb\_ctl** starts and stops **local** heartbeat on a *OCFS2* device. **Users are strongly urged not to use this tool directly**. It is automatically invoked by **[mount.ocfs2(8)](/mount.ocfs2/8.md)** and other tools that require heartbeat notifications.

This utility only operates in the **local** heartbeat mode. It fails silently when run in **global** heartbeat mode. More information on the heartbeat modes can be found in **[o2cb(7)](/o2cb/7.md)**.

The tools accepts devices to be specified by its name or its uuid. Service denotes the application that is requesting the heartbeat notification.

## OPTIONS

- **-S**

  Starts the heartbeat.

- **-K**

  Stops the heartbeat.

- **-I**

  Prints the heartbeat reference counts for that heartbeat region.

- **-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 scheduling class data as provided. This option is usable only with the **O2CB** cluster stack.

- **-h**

  Displays help and exit.

## SEE ALSO

**[mount.ocfs2(8)](/mount.ocfs2/8.md)** **[o2cb(7)](/o2cb/7.md)** **[o2cb(8)](/o2cb/8.md)** **[o2cb.sysconfig(5)](/o2cb.sysconfig/5.md)** **[ocfs2.cluster.conf(5)](/ocfs2.cluster.conf/5.md)** **[o2cluster(8)](/o2cluster/8.md)**

## AUTHORS

Oracle Corporation

## COPYRIGHT

Copyright © 2004, 2012 Oracle. All rights reserved.