doc: added qemu-img documentation for rbd.

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

diff --git a/doc/rbd/qemu-rbd.rst b/doc/rbd/qemu-rbd.rst
new file mode 100644 (file)
index 0000000..64f7254
--- /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 b1ad272a46ea262984636b7333c99363c542b1cf..cb6e43e5da6cbafc8449e4681db6a56aab1c3909 100644 (file)
--- 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>