---
name: "xnbd-watchdog"
section: "1"
platform: "linux"
package: "xnbd-client"
version: "0.3.0-3"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/xnbd-watchdog"
---

# xnbd-watchdog(1)

Watch a NBD device as started by xnbd-client(1)

## NAME

xnbd-watchdog - Watch a NBD device as started by [xnbd-client(1)](/xnbd-client/1.md)

## SYNOPSIS

**xnbd-watchdog** \[--timeout *SECONDS*\] \[--interval *SECONDS*\] \[--recovery-command *COMMAND*\] \[--recovery-command-reboot\] \[*NBD\_DEVICE*\]

## DESCRIPTION

With the **xnbd-watchdog**, you can monitor a running xnbd-client and trigger actions on failure.

## OPTIONS

The following options are supported:

- **--timeout** *SECONDS*

  Triggers the recovery command action if the watchdog process is unable to connect to the *NBD\_DEVICE* within the given timeout. If not given, this defaults to 10 seconds.

- **--interval** *SECONDS*

  Specifies the polling interval between probes. If not given, this defaults to 10 seconds.

- **--recovery-command** *COMMAND*

  If given, the *COMMAND* is executed if the watchdog is unable to connect the NBD device after timeout exceeded.

- **--recovery-command-reboot**

  This argument is a shortcut for **--recovery-command** "reboot now". That is, it will reboot the server upon failure.

## POSITIONAL ARGUMENTS

The following positional options are supported:

*NBD\_DEVICE*

The local nbd-device to be associated with the remote xnbd-server.

## SEE ALSO

[xnbd-server(8)](/xnbd-server/8.md)

## AUTHOR

The NBD kernel module and the NBD tools have been written by Pavel Macheck (pavel@ucw.cz) and is now maintained by Paul Clements (Paul.Clements@steeleye.com).

The xNBD userland programs have been written by Takahiro Hirofuchi (t.hirofuchi@aist.go.jp).

This manual page was written by Arno Toell (arno@debian.org) for the Debian GNU/Linux system (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, version 2, as published by the Free Software Foundation.