X-Git-Url: https://git.siccegge.de//index.cgi?p=forks%2Fvmdebootstrap.git;a=blobdiff_plain;f=README;h=2b58ccfc75576e39f9b8f9a527c2e65f4e94bde9;hp=ef9aa8b5d28529eedfa4cd84a4ec67580e35fbdd;hb=HEAD;hpb=db25f4d3190d62798884ad80012a7b3d88fbd504 diff --git a/README b/README index ef9aa8b..2b58ccf 100644 --- a/README +++ b/README @@ -58,6 +58,39 @@ In order to use vmdebootstrap, you'll need a few things: * mbr * kpartx * 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 --------------------