From: Neil Williams Date: Sun, 16 Aug 2015 12:01:39 +0000 (+0200) Subject: update README for UEFI addition X-Git-Url: https://git.siccegge.de//index.cgi?p=forks%2Fvmdebootstrap.git;a=commitdiff_plain;h=dfc4b416220912af7e24522d08034ce720e55d69 update README for UEFI addition --- diff --git a/.gitignore b/.gitignore index 8c75653..3f54e8c 100644 --- a/.gitignore +++ b/.gitignore @@ -1,3 +1,5 @@ *.img *.log *.tar.gz +*.pyc +*.egg-info diff --git a/README b/README index b454865..2b58ccf 100644 --- a/README +++ b/README @@ -60,6 +60,38 @@ In order to use vmdebootstrap, you'll need a few things: * python-cliapp (see http://liw.fi/cliapp/) * python-distro-info +Running vmdebootstrap from git +------------------------------ + +$ sudo PYTHONPATH=. ./bin/vmdebootstrap + +This has changed slightly with version 1.0 with the need for +PYTHONPATH to reference the module approach for support handlers. + +pylint +------ + +vmdebootstrap uses pylint and contains comments to disable certain +pylint checks in certain areas. pylint compatibility will make it +easier to accept patches, just follow the existing pattern +of pylint usage. pylint is far from perfect but can be helpful. + +Testing UEFI support +-------------------- + +There is EFI firmware available to use with QEMU when testing images +built using the UEFI support, but this software is in Debian non-free +due to patent concerns. If you choose to use it to test UEFI builds, +a secondary change is also needed to symlink the provided OVMF.fd to +the file required by QEMU: bios-256k.bin and then tell QEMU about the +location of this file with the -L option: + +$ qemu-system-x86_64 -L /usr/share/ovmf/ -machine accel=kvm \ + -m 4096 -smp 2 -drive file=amd64.img,format=raw + +Note the use of -drive file=,format=raw which is needed for newer +versions of QEMU. + The vmextract helper --------------------