From db25f4d3190d62798884ad80012a7b3d88fbd504 Mon Sep 17 00:00:00 2001 From: Neil Williams Date: Sat, 2 May 2015 18:57:16 +0100 Subject: Add an image extraction helper vmextract can use python-guestfs to extract files and directories from an image without needing root privileges. --- README | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) (limited to 'README') 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 -------- -- cgit v1.2.1