DOKK / manpages / debian 11 / tcmu-runner / tcmu-runner.8.en
tcmu-runner(8) System Manager's Manual tcmu-runner(8)

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

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.

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

Print usage information
Enable debug messages
Print tcmu-runner's version

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.

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

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.

qemu-img(1), targetcli(8), targetctl(8)

Andy Grover <agrover@redhat.com>

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