From 330ce73491d2aa5d0ab5d9843fead3dc3025c458 Mon Sep 17 00:00:00 2001
From: Attie Grande <attie@attie.co.uk>
Date: Fri, 3 Aug 2018 09:08:25 +0100
Subject: [PATCH] added Troubleshooting section to README.md, and addressed
 binfmt_misc issues

---
 README.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/README.md b/README.md
index 25067f7..c8b9e2b 100755
--- a/README.md
+++ b/README.md
@@ -249,3 +249,26 @@ follows:
  * Once you're happy with the image you can remove the SKIP_IMAGES files and
    export your image to test
 
+# Troubleshooting
+
+## `binfmt_misc`
+
+Linux is able execute binaries from other architectures, meaning that it should be
+possible to make use of `pi-gen` on an x86_64 system, even though it will be running
+ARM binaries. This requires support from the [`binfmt_misc`](https://en.wikipedia.org/wiki/Binfmt_misc)
+kernel module.
+
+You may see the following error:
+
+```
+update-binfmts: warning: Couldn't load the binfmt_misc module.
+```
+
+To resolve this, ensure that the following files are available (install them if necessary):
+
+```
+/lib/modules/$(uname -r)/kernel/fs/binfmt_misc.ko
+/usr/bin/qemu-arm-static
+```
+
+You may also need to load the module by hand - run `modprobe binfmt_misc`.