Skip to content

Commit

Permalink
Merge branch 'master' into arm64
Browse files Browse the repository at this point in the history
  • Loading branch information
XECDesign committed Feb 23, 2022
2 parents 733513a + c5a906b commit a0ba64e
Show file tree
Hide file tree
Showing 2 changed files with 26 additions and 4 deletions.
28 changes: 25 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ Getting started is as simple as cloning this repository on your build machine. Y
can do so with:

```bash
git clone -depth 1 https://github.com/RPI-Distro/pi-gen.git
git clone --depth 1 https://github.com/RPI-Distro/pi-gen.git
```

Using `--depth 1` with `git clone` will create a shallow clone, only containing
Expand Down Expand Up @@ -454,7 +454,22 @@ Now you should be able to start a new build without running into troubles again.
# 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
Please note there is currently an issue when compiling with a 64 Bit OS. See
https://github.com/RPi-Distro/pi-gen/issues/271

A 64 bit image can be generated from the `arm64` branch in this repository. Just
replace the command from [this section](#getting-started-with-building-your-images)
by the one below, and follow the rest of the documentation:
```bash
git clone --depth 1 --branch arm64 https://github.com/RPI-Distro/pi-gen.git
```

If you want to generate a 64 bits image from a Raspberry Pi running a 32 bits
version, you need to add `arm_64bit=1` to your `config.txt` file and reboot your
machine. This will restart your machine with a 64 bits kernel. This will only
work from a Raspberry Pi with a 64-bit capable processor (i.e. Raspberry Pi Zero
2, Raspberry Pi 3 or Raspberry Pi 4).


## `binfmt_misc`

Expand All @@ -463,11 +478,16 @@ possible to make use of `pi-gen` on an x86_64 system, even though it will be run
ARM binaries. This requires support from the [`binfmt_misc`](https://en.wikipedia.org/wiki/Binfmt_misc)
kernel module.

You may see the following error:
You may see one of the following errors:

```
update-binfmts: warning: Couldn't load the binfmt_misc module.
```
```
W: Failure trying to run: chroot "/pi-gen/work/test/stage0/rootfs" /bin/true
and/or
chroot: failed to run command '/bin/true': Exec format error
```

To resolve this, ensure that the following files are available (install them if necessary):

Expand All @@ -477,3 +497,5 @@ To resolve this, ensure that the following files are available (install them if
```

You may also need to load the module by hand - run `modprobe binfmt_misc`.

If you are using WSL to build you may have to enable the service `sudo update-binfmts --enable`
2 changes: 1 addition & 1 deletion stage1/01-sys-tweaks/files/fstab
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
proc /proc proc defaults 0 0
BOOTDEV /boot vfat defaults 0 2
BOOTDEV /boot vfat defaults.flush 0 2
ROOTDEV / ext4 defaults,noatime 0 1

0 comments on commit a0ba64e

Please sign in to comment.