[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Qemu-devel] [PATCH 01/26] qemu: Document GlusterFS block driver usage
From: |
Kevin Wolf |
Subject: |
[Qemu-devel] [PATCH 01/26] qemu: Document GlusterFS block driver usage |
Date: |
Wed, 14 Nov 2012 19:47:02 +0100 |
From: Bharata B Rao <address@hidden>
Signed-off-by: Bharata B Rao <address@hidden>
Signed-off-by: Kevin Wolf <address@hidden>
---
qemu-doc.texi | 49 +++++++++++++++++++++++++++++++++++++++++++++++++
qemu-options.hx | 17 +++++++++++++++++
2 files changed, 66 insertions(+), 0 deletions(-)
diff --git a/qemu-doc.texi b/qemu-doc.texi
index d8fb2de..6ff309d 100644
--- a/qemu-doc.texi
+++ b/qemu-doc.texi
@@ -421,6 +421,7 @@ snapshots.
* disk_images_nbd:: NBD access
* disk_images_sheepdog:: Sheepdog disk images
* disk_images_iscsi:: iSCSI LUNs
+* disk_images_gluster:: GlusterFS disk images
@end menu
@node disk_images_quickstart
@@ -814,7 +815,55 @@ qemu-system-i386 -iscsi
initiator-name=iqn.qemu.test:my-initiator \
-cdrom iscsi://127.0.0.1/iqn.qemu.test/2
@end example
address@hidden disk_images_gluster
address@hidden GlusterFS disk images
+GlusterFS is an user space distributed file system.
+
+You can boot from the GlusterFS disk image with the command:
address@hidden
+qemu-system-x86_64 -drive
address@hidden://address@hidden:@var{port}]]/@var{volname}/@var{image}[?socket=...]
address@hidden example
+
address@hidden is the protocol.
+
address@hidden specifies the transport type used to connect to gluster
+management daemon (glusterd). Valid transport types are
+tcp, unix and rdma. If a transport type isn't specified, then tcp
+type is assumed.
+
address@hidden specifies the server where the volume file specification for
+the given volume resides. This can be either hostname, ipv4 address
+or ipv6 address. ipv6 address needs to be within square brackets [ ].
+If transport type is unix, then @var{server} field should not be specifed.
+Instead @var{socket} field needs to be populated with the path to unix domain
+socket.
+
address@hidden is the port number on which glusterd is listening. This is
optional
+and if not specified, QEMU will send 0 which will make gluster to use the
+default port. If the transport type is unix, then @var{port} should not be
+specified.
+
address@hidden is the name of the gluster volume which contains the disk image.
+
address@hidden is the path to the actual disk image that resides on gluster
volume.
+
+You can create a GlusterFS disk image with the command:
address@hidden
+qemu-img create gluster://@var{server}/@var{volname}/@var{image} @var{size}
address@hidden example
+
+Examples
address@hidden
+qemu-system-x86_64 -drive file=gluster://1.2.3.4/testvol/a.img
+qemu-system-x86_64 -drive file=gluster+tcp://1.2.3.4/testvol/a.img
+qemu-system-x86_64 -drive file=gluster+tcp://1.2.3.4:24007/testvol/dir/a.img
+qemu-system-x86_64 -drive
file=gluster+tcp://[1:2:3:4:5:6:7:8]/testvol/dir/a.img
+qemu-system-x86_64 -drive
file=gluster+tcp://[1:2:3:4:5:6:7:8]:24007/testvol/dir/a.img
+qemu-system-x86_64 -drive
file=gluster+tcp://server.domain.com:24007/testvol/dir/a.img
+qemu-system-x86_64 -drive
file=gluster+unix:///testvol/dir/a.img?socket=/tmp/glusterd.socket
+qemu-system-x86_64 -drive file=gluster+rdma://1.2.3.4:24007/testvol/a.img
address@hidden example
@node pcsys_network
@section Network emulation
diff --git a/qemu-options.hx b/qemu-options.hx
index fe8f15c..06aa1ae 100644
--- a/qemu-options.hx
+++ b/qemu-options.hx
@@ -2054,6 +2054,23 @@ qemu-system-i386 --drive
file=sheepdog:192.0.2.1:30000:MyVirtualMachine
See also @url{http://http://www.osrg.net/sheepdog/}.
address@hidden GlusterFS
+GlusterFS is an user space distributed file system.
+QEMU supports the use of GlusterFS volumes for hosting VM disk images using
+TCP, Unix Domain Sockets and RDMA transport protocols.
+
+Syntax for specifying a VM disk image on GlusterFS volume is
address@hidden
+gluster[+transport]://[server[:port]]/volname/image[?socket=...]
address@hidden example
+
+
+Example
address@hidden
+qemu-system-x86_84 --drive file=gluster://192.0.2.1/testvol/a.img
address@hidden example
+
+See also @url{http://www.gluster.org}.
@end table
ETEXI
--
1.7.6.5
- [Qemu-devel] [PULL 00/26] Block patches, Kevin Wolf, 2012/11/14
- [Qemu-devel] [PATCH 01/26] qemu: Document GlusterFS block driver usage,
Kevin Wolf <=
- [Qemu-devel] [PATCH 02/26] qcow2: Fix refcount table size calculation, Kevin Wolf, 2012/11/14
- [Qemu-devel] [PATCH 03/26] qemu-iotests: qcow2: Test growing large refcount table, Kevin Wolf, 2012/11/14
- [Qemu-devel] [PATCH 04/26] MAINTAINERS: add Stefan Hajnoczi as block and virtio-blk co-maintainer, Kevin Wolf, 2012/11/14
- [Qemu-devel] [PATCH 05/26] block: Workaround for older versions of MinGW gcc, Kevin Wolf, 2012/11/14
- [Qemu-devel] [PATCH 06/26] tests: allow qemu-iotests to be run against nbd backend, Kevin Wolf, 2012/11/14
- [Qemu-devel] [PATCH 07/26] aio: switch aiocb_size type int -> size_t, Kevin Wolf, 2012/11/14
- [Qemu-devel] [PATCH 08/26] aio: use g_slice_alloc() for AIOCB pooling, Kevin Wolf, 2012/11/14
- [Qemu-devel] [PATCH 10/26] fdc: Remove status0 parameter from fdctrl_set_fifo(), Kevin Wolf, 2012/11/14
- [Qemu-devel] [PATCH 09/26] aio: rename AIOPool to AIOCBInfo, Kevin Wolf, 2012/11/14
- [Qemu-devel] [PATCH 12/26] fdc-test: insert media before fuzzing registers, Kevin Wolf, 2012/11/14