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), targetcli(8), 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>

                                                                                                  tcmu-runner(8)