doc: added qemu-img documentation for rbd.

Signed-off-by: John Wilkins <john.wilkins@inktank.com>

2 files changed, 67 insertions, 0 deletions

diff --git a/doc/rbd/qemu-rbd.rst b/doc/rbd/qemu-rbd.rst
new file mode 100644
index 00000000000..64f725486f6
--- /dev/null
+++ b/doc/rbd/qemu-rbd.rst
@@ -0,0 +1,66 @@
+==============
+ QEMU and RBD
+==============
+
+Ceph integrates with the QEMU virtual machine. For details on QEMU, see 
+`QEMU Open Source Processor Emulator`_. For QEMU documentation, see
+`QEMU Manual`_. 
+   
+Installing QEMU on Ubuntu 12.04Precise
+--------------------------------------
+QEMU packages are incorporated into the Ubuntu 12.04 precise distribution. To 
+install QEMU on precise, execute the following:: 
+
+	sudo apt-get install qemu
+
+Installing QEMU on Earlier Versions of Ubuntu
+---------------------------------------------
+For Ubuntu distributions 11.10 oneiric and earlier, you must install 
+the 0.15 version of QEMU or later. To build QEMU from source, use the
+following procedure::
+
+	cd {your-development-directory}
+	git clone git://git.qemu.org/qemu.git
+	cd qemu
+	./configure --enable-rbd
+	make; make install
+
+Creating RBD Images with QEMU
+-----------------------------
+You can create an RBD image from QEMU. You must specify ``rbd``, 
+the pool name, and the name of the image you wish to create. You must also
+specify the size of the image. ::
+
+	qemu-img create -f rbd rbd:{pool-name}/{image-name} {size}
+
+For example::
+
+	qemu-img create -f rbd rbd:data/foo 10G
+
+Resizing RBD Images with QEMU
+-----------------------------
+You can resize an RBD image from QEMU. You must specify ``rbd``, 
+the pool name, and the name of the image you wish to resize. You must also
+specify the size of the image.
+
+	qemu-img resize -f rbd rbd:{pool-name}/{image-name} {size}
+
+For example::
+
+	qemu-img resize -f rbd rbd:data/foo 10G
+
+
+Retrieving RBD Image Information with QEMU
+------------------------------------------
+You can retrieve RBD image information from QEMU. You must 
+specify ``rbd``, the pool name, and the name of the image. ::
+
+	qemu-img info -f rbd rbd:{pool-name}/{image-name}
+
+For example::
+
+	qemu-img info -f rbd rbd:data/foo
+
+   
+.. _QEMU Open Source Processor Emulator: http://wiki.qemu.org/Main_Page
+.. _QEMU Manual: http://wiki.qemu.org/Manual
diff --git a/doc/rbd/rbd.rst b/doc/rbd/rbd.rst
index b1ad272a46e..cb6e43e5da6 100644
--- a/doc/rbd/rbd.rst
+++ b/doc/rbd/rbd.rst
@@ -25,6 +25,7 @@ the Ceph FS filesystem, and RADOS block devices simultaneously.
 
 	RADOS Commands <rados-rbd-cmds>
 	Kernel Objects <rbd-ko>
+	QEMU and RBD <qemu-rbd>