---
name: "tcmu-runner"
section: "8"
platform: "linux"
package: "tcmu-runner"
version: "1.5.4-9"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/tcmu-runner"
---

# tcmu-runner(8)

A daemon that handles the userspace side of the LIO TCM-User backstore

## NAME

tcmu-runner - A daemon that handles the userspace side of the LIO TCM-User backstore

## DESCRIPTION

**tcmu-runner** is a service that provides an operating environment for LIO TCM-User handlers. These currently include handlers for Gluster glfs and the qcow and qcow2 image formats.

## USAGE

While normally started automatically via D-Bus system activation, **tcmu-runner** can also be run as root directly, usually for debugging and development purposes.

## OPTIONS

- **-h, --help**

  Print usage information

- **-d, --debug**

  Enable debug messages

- **-V, --version**

  Print tcmu-runner's version

## CONFIGURING HANDLERS

TCMU-backed handlers are typically configured using normal LIO configuration tools, such as **targetcli**. Part of doing this will be entering a handler-specific configuration string.

### CONFIGURING GLUSTER HANDLER (glfs)

This handler uses the Gluster glfs API to use Gluster as a backstore for the image file.

Its configuration string is:

-

  *volume***@***hostname***/***filename*\
   volume: The volume on the Gluster server\
   hostname: The server's hostname\
   filename: The backing file

### CONFIGURING QCOW HANDLER (qcow)

This handler supports qcow, qcow2, or raw image file formats.

Its configuration string is:

-

  *path*\
   path: The full path to a file of a supported file format. The file must already have been created using **qemu-img**.

## SEE ALSO

[**qemu-img**(1)](/qemu-img/1.md), [**targetcli**(8)](/targetcli/8.md), **targetctl**(8)

## AUTHOR

Andy Grover \<agrover@redhat.com\>

## REPORTING BUGS

Report bugs via \<target-devel@vger.kernel.org\>\
 or \<https://github.com/agrover/tcmu-runner/issues\>