]> git.siccegge.de Git - forks/vmdebootstrap.git/commitdiff
update README for UEFI addition
authorNeil Williams <codehelp@debian.org>
Sun, 16 Aug 2015 12:01:39 +0000 (14:01 +0200)
committerNeil Williams <codehelp@debian.org>
Sun, 16 Aug 2015 12:01:39 +0000 (14:01 +0200)
.gitignore
README

index 8c7565310b395dd010cb0173f809e8d22fd22db5..3f54e8c626bec66cdda857c0db535d1d5f11d866 100644 (file)
@@ -1,3 +1,5 @@
 *.img
 *.log
 *.tar.gz
+*.pyc
+*.egg-info
diff --git a/README b/README
index b454865d498da1ea174e8df60c3b22af447dfba4..2b58ccfc75576e39f9b8f9a527c2e65f4e94bde9 100644 (file)
--- 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=<img>,format=raw which is needed for newer
+versions of QEMU.
+
 The vmextract helper
 --------------------