---
name: "corosync-qdevice-tool"
section: "8"
platform: "linux"
package: "corosync-qdevice"
version: "3.0.3-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/corosync-qdevice-tool"
---

# corosync-qdevice-tool(8)

corosync-qdevice control interface.

## NAME

corosync-qdevice-tool - corosync-qdevice control interface.

## SYNOPSIS

**corosync-qdevice-tool \[-Hhsv\] \[-p qdevice\_ipc\_socket\_path\]**

## DESCRIPTION

**corosync-qdevice-tool** is a frontend to the internal corosync-qdevice IPC. Its main purpose is to show important information about the current internal state of **corosync-qdevice.**

## OPTIONS

- **-H**

  Properly shutdown the **corosync-qdevice** process

- **-h**

  Display a short usage text

- **-s**

  Display the status of the **corosync-qdevice** process. The output is described in its own section below.

- **-v**

  Display more verbose output for the **-s** option.

- **-p**

  Path to the **corosync-qdevice** communication socket.

## STATUS COMMAND OUTPUT

```
Qdevice information
-------------------
Model:                  Net
Node ID:                1
HB interval:            10000ms
Sync HB interval:       30000ms
Configured node list:
    0   Node ID = 1
Heuristics:             Enabled
Ring ID:                1.a00000000021b48
Membership node list:   1
Quorate:                Yes
Quorum node list:
    0   Node ID = 1, State = member
Expected votes:         2
Last poll call:         2016-06-24T17:05:20 (cast vote)
Qdevice-net information
----------------------
Cluster name:           Cluster
QNetd host:             localhost:5403
Connect timeout:        8000ms
HB interval:            8000ms
VQ vote timer interval: 5000ms
TLS:                    Supported
Algorithm:              Fifty-Fifty split
Tie-breaker:            Node with lowest node ID
KAP Tie-breaker:        Enabled
Poll timer running:     Yes (cast vote)
State:                  Connected
Heuristics result:      Pass (regular: Pass, membership: Fail, connect: Fail)
TLS active:             Yes (client certificate sent)
Connected since:        2016-06-24T17:02:35
Echo reply received:    2016-06-24T17:05:15
```

The output is split into a generic qdevice section and a model specific section. Most of the items are just taken from corosync.conf file. It's helpful to note that the *Membership node list* is the membership list of the current node and should match the quorum node list. *Last poll call* is the timestamp (in iso format) of the last call to the votequorum\_qdevice\_poll function.

For model net, it's good to check the *Poll timer running* state. Internally, model net supports 3 states. Not voting (when *Poll timer running* is No, which means **corosync-qdevice** is waiting for **corosync-qnetd** to reply), voting (without cast vote, it means that the **corosync-qnetd** algorithm decides that the current node shouldn't get a vote) and voting (with cast vote).

## SEE ALSO

[**corosync-qnetd**(8)](/corosync-qnetd/8.md) [**corosync-qdevice**(8)](/corosync-qdevice/8.md)

## AUTHOR

Jan Friesse