1tcmu-runner(8)              System Manager's Manual             tcmu-runner(8)
2
3
4

NAME

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

DESCRIPTION

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

USAGE

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

OPTIONS

22       -h, --help
23              Print usage information
24
25       -d, --debug
26              Enable debug messages
27
28       -V, --version
29              Print tcmu-runner's version
30

CONFIGURING HANDLERS

32       TCMU-backed handlers are typically configured using normal LIO configu‐
33       ration tools, such as targetcli.  Part of doing this will be entering a
34       handler-specific configuration string.
35
36   CONFIGURING GLUSTER HANDLER (glfs)
37       This handler uses the Gluster glfs API to use Gluster  as  a  backstore
38       for the image file.
39
40       Its configuration string is:
41
42           volume@hostname/filename
43           volume: The volume on the Gluster server
44           hostname: The server's hostname
45           filename: The backing file
46
47   CONFIGURING QCOW HANDLER (qcow)
48       This handler supports qcow, qcow2, or raw image file formats.
49
50       Its configuration string is:
51
52           path
53           path:  The full path to a file of a supported file format. The file
54           must already have been created using qemu-img.
55
56

SEE ALSO

58       qemu-img(1), targetcli(8), targetctl(8)
59
60

AUTHOR

62       Andy Grover <agrover@redhat.com>
63

REPORTING BUGS

65       Report bugs via <target-devel@vger.kernel.org>
66       or <https://github.com/agrover/tcmu-runner/issues>
67
68
69
70                                                                tcmu-runner(8)