From 7515b05e88b8401dc40b5505f97c80bb835efa65 Mon Sep 17 00:00:00 2001
From: John Wilkins <john.wilkins@inktank.com>
Date: Thu, 14 Jun 2012 14:18:53 -0700
Subject: [PATCH] doc: added qemu-img documentation for rbd.

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
---
 doc/rbd/qemu-rbd.rst | 66 ++++++++++++++++++++++++++++++++++++++++++++
 doc/rbd/rbd.rst      |  1 +
 2 files changed, 67 insertions(+)
 create mode 100644 doc/rbd/qemu-rbd.rst

diff --git a/doc/rbd/qemu-rbd.rst b/doc/rbd/qemu-rbd.rst
new file mode 100644
index 0000000000000..64f725486f647
--- /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 b1ad272a46ea2..cb6e43e5da6cb 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>
 	
 	
 	
-- 
2.39.5