X-Git-Url: https://git.siccegge.de//index.cgi?p=forks%2Fvmdebootstrap.git;a=blobdiff_plain;f=README;fp=README;h=ef9aa8b5d28529eedfa4cd84a4ec67580e35fbdd;hp=404db87512246c99dc8dbd2513d9a1fffb485e0a;hb=db25f4d3190d62798884ad80012a7b3d88fbd504;hpb=81bbe4c44f41e31fd4a8101bc1efb3a825f374b0

diff --git a/README b/README
index 404db87..ef9aa8b 100644
--- a/README
+++ b/README
@@ -59,6 +59,25 @@ In order to use vmdebootstrap, you'll need a few things:
 * kpartx
 * python-cliapp (see http://liw.fi/cliapp/)
 
+The vmextract helper
+--------------------
+
+Once the image is built, various files can be generated or modified
+during the install operations and some of these files can be useful
+when testing the image. One example is the initrd built by the process
+of installing a Debian kernel. Rather than having to mount the image
+and copy the files manually, the vmextract helper can do it for you,
+without needing root privileges.
+
+$ /usr/share/vmdebootstrap/vmextract.py --verbose \
+  --image bbb/bbb-debian-armmp.img --boot \
+  --path /boot/initrd.img-3.14-2-armmp \
+  --path /lib/arm-linux-gnueabihf/libresolv.so.2
+
+This uses python-guestfs (a Recommended package for vmdebootstrap) to
+prepare a read-only version of the image - in this case with the /boot
+partition also mounted - and copies files out into the current working
+directory.
 
 Legalese
 --------