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

NAME

6       tcmu-runner
7

DESCRIPTION

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

USAGE

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

OPTIONS

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

CONFIGURING HANDLERS

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

SEE ALSO

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

AUTHOR

61       Andy Grover <agrover@redhat.com>
62

REPORTING BUGS

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