Add warning and instructions in README for i386 qemu-user-static package

pull/307/head
Hugo Hromic 2019-07-28 12:12:46 +01:00
parent 9bf908efbc
commit 4bf1ac039a
1 changed files with 17 additions and 4 deletions

View File

@ -10,7 +10,7 @@ either Debian Buster or Ubuntu Xenial and is known to have issues building on
earlier releases of these systems. On other Linux distributions it may be possible
to use the Docker build described below.
To install the required dependencies for pi-gen you should run:
To install the required dependencies for pi-gen you should run (*):
```bash
apt-get install coreutils quilt parted qemu-user-static debootstrap zerofree zip \
@ -20,6 +20,22 @@ dosfstools bsdtar libcap2-bin grep rsync xz-utils file git curl
The file `depends` contains a list of tools needed. The format of this
package is `<tool>[:<debian-package>]`.
**(*) Warning:** please note that there is currently an issue when building with the
64-bits version of the `qemu-user-static` package. As a workaround, you can use the
32-bits `qemu-user-static:i386` package instead.
To do this, first add the `i386` architecture to your Debian-based system:
```bash
dpkg --add-architecture i386
apt-get update
```
Then replace `qemu-user-static` with `qemu-user-static:i386` in the instructions above.
Also note that the included Dockerfile in pi-gen already includes this workaround.
For more info refer to: https://github.com/RPi-Distro/pi-gen/issues/271
## Config
@ -295,9 +311,6 @@ follows:
# Troubleshooting
## `64 Bit Systems`
Please note there is currently an issue when compiling with a 64 Bit OS. See https://github.com/RPi-Distro/pi-gen/issues/271
## `binfmt_misc`
Linux is able execute binaries from other architectures, meaning that it should be