Skip to content

Commit bf0d323

Browse files
committed
Fix bare links
Signed-off-by: Davide Cavalca <davide@cavalca.name>
1 parent 5f4582e commit bf0d323

11 files changed

+57
-57
lines changed

docs/Accelerator-Engines.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
The SoC has several onboard accelerator units, this is a useful list of the names and what they refer to. Most of the accelerators run firmware that can be found in the pre-boot partition `/System/Volumes/Preboot/[UUID]/restore/Firmware`, packaged as im4p files which may be extracted with https://github.com/19h/ftab-dump/blob/master/rkos.py and some dd.
1+
The SoC has several onboard accelerator units, this is a useful list of the names and what they refer to. Most of the accelerators run firmware that can be found in the pre-boot partition `/System/Volumes/Preboot/[UUID]/restore/Firmware`, packaged as im4p files which may be extracted with <https://github.com/19h/ftab-dump/blob/master/rkos.py> and some dd.
22

33
*Update none of the ANE, AVE, ADT im4p's extract with that. I'm not sure which ones do. You are better off following the im4p extraction steps in [ADT](FW-ADT.md). Can we make a progress matrix regarding firmware?
44

docs/Broken-Software.md

Lines changed: 30 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -90,43 +90,43 @@ run). You may have varying levels of success by attempting to run your software
9090
## Broken packages
9191
| Package | Upstream report | Notes |
9292
| ------- | --------------- | ----- |
93-
| Chromium | https://issues.chromium.org/issues/378017037 | cppgc crashes on Linux w/ 16KiB pages because of hardcoded kGuardPageSize |
94-
| hardened_malloc | https://github.com/GrapheneOS/hardened_malloc/issues/183 | There are more changes necessary to hardened_malloc before 16k page support is done. It is also not a high priority at the moment as we need MTE |
95-
| jemalloc | https://github.com/jemalloc/jemalloc/issues/467 | Upstream unwilling to fix, Needs build options if compiled on a 4k page size system. Addressed in [ArchLinuxARM](https://github.com/archlinuxarm/PKGBUILDs/pull/1914). |
96-
| MEGAsync | https://github.com/meganz/MEGAsync/pull/801 |
97-
| notion-app(-enhancer) | https://github.com/notion-enhancer/notion-repackaged/issues/107 | electron + broken build flags |
98-
| Wine | https://bugs.winehq.org/show_bug.cgi?id=52715 |
99-
| Zig | https://github.com/ziglang/zig/issues/11308 |
93+
| Chromium | <https://issues.chromium.org/issues/378017037> | cppgc crashes on Linux w/ 16KiB pages because of hardcoded kGuardPageSize |
94+
| hardened_malloc | <https://github.com/GrapheneOS/hardened_malloc/issues/183> | There are more changes necessary to hardened_malloc before 16k page support is done. It is also not a high priority at the moment as we need MTE |
95+
| jemalloc | <https://github.com/jemalloc/jemalloc/issues/467> | Upstream unwilling to fix, Needs build options if compiled on a 4k page size system. Addressed in [ArchLinuxARM](https://github.com/archlinuxarm/PKGBUILDs/pull/1914). |
96+
| MEGAsync | <https://github.com/meganz/MEGAsync/pull/801> |
97+
| notion-app(-enhancer) | <https://github.com/notion-enhancer/notion-repackaged/issues/107> | electron + broken build flags |
98+
| Wine | <https://bugs.winehq.org/show_bug.cgi?id=52715> |
99+
| Zig | <https://github.com/ziglang/zig/issues/11308> |
100100

101101
\* Running x86-64 software is supported via a 4k page size microVM running FEX.
102102

103103
## Fixed packages
104104
| Package | Fixing commit | Notes |
105105
| ------- | ------------- | ----- |
106106
| 1Password | _proprietary_ | Fixed as of 8.8.0-119 beta. |
107-
| Android Cuttlefish | https://android-review.googlesource.com/c/device/google/cuttlefish/+/2545951 | Fixed in AOSP main branch by switching to musl. |
108-
| box64 | https://github.com/ptitSeb/box64/issues/384 | Fixed since 0.2.8 |
109-
| btrfs | https://lore.kernel.org/lkml/cover.1653327652.git.dsterba@suse.com/ | Fixed since Linux 5.19 ([caveats](https://social.treehouse.systems/@marcan/111493984306764821)) |
110-
| Chromium | https://bugs.chromium.org/p/chromium/issues/detail?id=1301788| Includes Electron apps.<br>Fixed since 102. |
111-
| Emacs | https://lists.gnu.org/archive/html/bug-gnu-emacs/2021-03/msg01260.html | Fixed since 28.0 |
112-
| f2fs | https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=d7e9a9037de27b642d5a3edef7c69e2a2b460287 | Fixed since Linux 6.7 |
113-
| fd | https://github.com/sharkdp/fd/issues/1085 | Fixed since 10.1 |
114-
| k3s-io | https://github.com/k3s-io/k3s/issues/7335 | Fixed since 1.27.2 |
115-
| KiCad | https://gitlab.com/kicad/code/kicad/-/issues/16008 | Fixed since 7.0.10 |
116-
| libglvnd | https://gitlab.freedesktop.org/glvnd/libglvnd/-/merge_requests/262 | Fixed since 1.5.0 |
117-
| libunwind | https://github.com/libunwind/libunwind/pull/330 | Fixed since 1.7.0 |
118-
| libunwind | https://github.com/libunwind/libunwind/issues/260 | Fixed since 1.8.0 |
119-
| libvirt/QEMU/KVM | https://patchew.org/QEMU/20230727073134.134102-1-akihiko.odaki@daynix.com/ | Fixed since QEMU 7.2.6 / 8.0.5 / 8.1.1 |
120-
| lvm2 | https://bugzilla.redhat.com/show_bug.cgi?id=2059734 | Fixed since 2.03.21 |
121-
| pdfium | https://bugs.chromium.org/p/pdfium/issues/detail?id=1853 | Fixed and shipped with Chromium 108 |
122-
| qt5-webengine | https://bugreports.qt.io/browse/QTBUG-105145 | chromium 87, likely won’t be fixed upstream. [Fixed in downstream ArchLinuxARM](https://github.com/archlinuxarm/PKGBUILDs/pull/1928) |
123-
| qt6-webengine | https://bugreports.qt.io/browse/QTBUG-105145 | chromium 94 for 6.3, partially fixed upstream in 6.4 for webview but not for QtPdf. [Fixed in downstream ArchLinuxARM](https://github.com/archlinuxarm/PKGBUILDs/pull/1928) |
124-
| Redis | https://bugzilla.redhat.com/show_bug.cgi?id=2240293 https://bodhi.fedoraproject.org/updates/FEDORA-2023-bdb1515542 | Fixed in fedora since redis-7.0.13-2.fc38 and redis-7.2.1-2.fc39) |
125-
| rr | https://github.com/rr-debugger/rr/pull/3146 | Fixed since 5.6.0 |
126-
| Rust | https://github.com/archlinuxarm/PKGBUILDs/commit/19a1393 | Fixed for `rust-1.62.1-1.1` in ALARM/extra |
127-
| Telegram Desktop | https://github.com/telegramdesktop/tdesktop/issues/26103 | Fixed since 4.1.1 |
128-
| Visual Studio Code | https://aur.archlinux.org/packages/visual-studio-code-bin | Fixed since 1.71.0 (uses Electron 19) |
129-
| WebKitGTK | https://github.com/WebKit/WebKit/commit/0a4a03da45f774 | Fixed since 2.34.6 |
107+
| Android Cuttlefish | <https://android-review.googlesource.com/c/device/google/cuttlefish/+/2545951> | Fixed in AOSP main branch by switching to musl. |
108+
| box64 | <https://github.com/ptitSeb/box64/issues/384> | Fixed since 0.2.8 |
109+
| btrfs | <https://lore.kernel.org/lkml/cover.1653327652.git.dsterba@suse.com/> | Fixed since Linux 5.19 ([caveats](https://social.treehouse.systems/@marcan/111493984306764821)) |
110+
| Chromium | <https://bugs.chromium.org/p/chromium/issues/detail?id=1301788> | Includes Electron apps.<br>Fixed since 102. |
111+
| Emacs | <https://lists.gnu.org/archive/html/bug-gnu-emacs/2021-03/msg01260.html> | Fixed since 28.0 |
112+
| f2fs | <https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=d7e9a9037de27b642d5a3edef7c69e2a2b460287> | Fixed since Linux 6.7 |
113+
| fd | <https://github.com/sharkdp/fd/issues/1085> | Fixed since 10.1 |
114+
| k3s-io | <https://github.com/k3s-io/k3s/issues/7335> | Fixed since 1.27.2 |
115+
| KiCad | <https://gitlab.com/kicad/code/kicad/-/issues/16008> | Fixed since 7.0.10 |
116+
| libglvnd | <https://gitlab.freedesktop.org/glvnd/libglvnd/-/merge_requests/262> | Fixed since 1.5.0 |
117+
| libunwind | <https://github.com/libunwind/libunwind/pull/330> | Fixed since 1.7.0 |
118+
| libunwind | <https://github.com/libunwind/libunwind/issues/260> | Fixed since 1.8.0 |
119+
| libvirt/QEMU/KVM | <https://patchew.org/QEMU/20230727073134.134102-1-akihiko.odaki@daynix.com/> | Fixed since QEMU 7.2.6 / 8.0.5 / 8.1.1 |
120+
| lvm2 | <https://bugzilla.redhat.com/show_bug.cgi?id=2059734> | Fixed since 2.03.21 |
121+
| pdfium | <https://bugs.chromium.org/p/pdfium/issues/detail?id=1853> | Fixed and shipped with Chromium 108 |
122+
| qt5-webengine | <https://bugreports.qt.io/browse/QTBUG-105145> | chromium 87, likely won’t be fixed upstream. [Fixed in downstream ArchLinuxARM](https://github.com/archlinuxarm/PKGBUILDs/pull/1928) |
123+
| qt6-webengine | <https://bugreports.qt.io/browse/QTBUG-105145> | chromium 94 for 6.3, partially fixed upstream in 6.4 for webview but not for QtPdf. [Fixed in downstream ArchLinuxARM](https://github.com/archlinuxarm/PKGBUILDs/pull/1928) |
124+
| Redis | <https://bugzilla.redhat.com/show_bug.cgi?id=2240293> <https://bodhi.fedoraproject.org/updates/FEDORA-2023-bdb1515542> | Fixed in fedora since redis-7.0.13-2.fc38 and redis-7.2.1-2.fc39) |
125+
| rr | <https://github.com/rr-debugger/rr/pull/3146> | Fixed since 5.6.0 |
126+
| Rust | <https://github.com/archlinuxarm/PKGBUILDs/commit/19a1393> | Fixed for `rust-1.62.1-1.1` in ALARM/extra |
127+
| Telegram Desktop | <https://github.com/telegramdesktop/tdesktop/issues/26103> | Fixed since 4.1.1 |
128+
| Visual Studio Code | <https://aur.archlinux.org/packages/visual-studio-code-bin> | Fixed since 1.71.0 (uses Electron 19) |
129+
| WebKitGTK | <https://github.com/WebKit/WebKit/commit/0a4a03da45f774> | Fixed since 2.34.6 |
130130

131131
## Bugs
132132

docs/HW-AVD.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,4 +2,4 @@ Apple Video Decoder.
22

33
Supports AVC, HEVC, AV1, VP9.
44

5-
Notes: https://eiln.net/avd-notes.html
5+
Notes: <https://web.archive.org/web/20240105073841/https://eiln.net/avd-notes.html>

docs/Kernel-config-notes-for-distros.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@ CONFIG_IIO_AOP_SENSOR_ALS=m
6262

6363
(Distros intending to support other platforms with their 16k arm64 kernel besides Apple Silicon will be inclined to build as many of these drivers as modules as they can. This is fine, though from a reliability standpoint building NVME_APPLE and SPI_HID_APPLE_OF in-kernel has worked much better for me.)
6464

65-
~~(Also note that the configuration options above do not match the standard dracut configuration provided by asahi-scripts.)~~ It looks like a recent change to asahi-scripts makes your choices of modules much less important: https://github.com/AsahiLinux/asahi-scripts/commit/4acd310cd8c394f9ec2e7e7506d89b7bb3c3ca39
65+
~~(Also note that the configuration options above do not match the standard dracut configuration provided by asahi-scripts.)~~ It looks like a recent change to asahi-scripts makes your choices of modules much less important: <https://github.com/AsahiLinux/asahi-scripts/commit/4acd310cd8c394f9ec2e7e7506d89b7bb3c3ca39>
6666

6767
You should also double-check that you have the following configuration options set:
6868

docs/Open-OS-Ecosystem-on-Apple-Silicon-Macs-historical.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -138,7 +138,7 @@ Currently, Broadcom FullMAC WiFi firmware is packaged. These blobs have also bee
138138
* AVD (Apple Video Decoder) Cortex-M3 firmware
139139
* USB xHCI firmware (only needed for iMac models with 4 USB-C ports).
140140

141-
Details on Broadcom FullMAC WiFi firmware naming: https://lore.kernel.org/all/20220104072658.69756-10-marcan@marcan.st/
141+
Details on Broadcom FullMAC WiFi firmware naming: <https://lore.kernel.org/all/20220104072658.69756-10-marcan@marcan.st/>
142142

143143
### VendorFW package
144144

docs/Open-OS-Ecosystem-on-Apple-Silicon-Macs.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -143,7 +143,7 @@ And these blobs aren't yet packaged:
143143

144144
* AVD (Apple Video Decoder) Cortex-M3 firmware
145145

146-
Details on Broadcom FullMAC WiFi firmware naming: https://lore.kernel.org/all/20220104072658.69756-10-marcan@marcan.st/
146+
Details on Broadcom FullMAC WiFi firmware naming: <https://lore.kernel.org/all/20220104072658.69756-10-marcan@marcan.st/>
147147

148148
### VendorFW package
149149

docs/Reference-Asahi-kernel-config.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
See https://github.com/zzywysm/asahi-kernel-configs
1+
See <https://github.com/zzywysm/asahi-kernel-configs>

docs/SW-Alternative-Distros.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -2,16 +2,16 @@ The primary supported distribution is the [Fedora Asahi Remix](https://asahilinu
22

33
| Distro | Maintainer | Installation Guide |
44
|--------|------------|--------------------|
5-
| Alpine Linux | IRC: mps (https://arvanta.net/alpine) | https://arvanta.net/alpine/install-alpine-m1/ |
6-
| AOSC OS | https://github.com/AOSC-Dev | https://aosc.io/downloads/asahi |
7-
| Arch Linux ARM | https://github.com/asahi-alarm/ | https://github.com/asahi-alarm/asahi-alarm |
8-
| CentOS Stream | https://github.com/ericcurtin | https://github.com/ericcurtin/asahi-centosstream-builder |
9-
| Debian | https://thomas.glanzmann.de/ | https://git.zerfleddert.de/cgi-bin/gitweb.cgi/m1-debian/ |
10-
| deepin | https://github.com/deepin-community| https://github.com/deepin-community/deepin-m1 |
11-
| deepin | deepin M1 SIG | https://www.deepin.org/index/docs/sig/sig/deepin-m1/README |
12-
| Fedora | https://github.com/leifliddy | https://github.com/leifliddy/asahi-fedora-builder |
13-
| Gentoo<br>(LiveCD method) | IRC: chadmed (https://github.com/chadmed) | [Installing Gentoo with LiveCD](Installing-Gentoo-with-LiveCD.md) |
14-
| NixOS | IRC: tpw_rules (https://github.com/tpwrules) | https://github.com/tpwrules/nixos-apple-silicon/blob/main/docs/uefi-standalone.md |
15-
| Rocky Linux | https://github.com/leifliddy| https://github.com/leifliddy/asahi-rocky-builder |
16-
| Ubuntu | https://github.com/UbuntuAsahi | https://ubuntuasahi.org/ |
17-
| Void Linux | https://voidlinux.org/news/2025/02/new-images.html | https://docs.voidlinux.org/installation/guides/arm-devices/apple-silicon.html |
5+
| Alpine Linux | IRC: mps (<https://arvanta.net/alpine>) | <https://arvanta.net/alpine/install-alpine-m1/> |
6+
| AOSC OS | <https://github.com/AOSC-Dev> | <https://aosc.io/downloads/asahi> |
7+
| Arch Linux ARM | <https://github.com/asahi-alarm/> | <https://github.com/asahi-alarm/asahi-alarm> |
8+
| CentOS Stream | <https://github.com/ericcurtin> | <https://github.com/ericcurtin/asahi-centosstream-builder> |
9+
| Debian | <https://thomas.glanzmann.de/> | <https://git.zerfleddert.de/cgi-bin/gitweb.cgi/m1-debian/> |
10+
| deepin | <https://github.com/deepin-community> | <https://github.com/deepin-community/deepin-m1> |
11+
| deepin | deepin M1 SIG | <https://www.deepin.org/index/docs/sig/sig/deepin-m1/README> |
12+
| Fedora | <https://github.com/leifliddy> | <https://github.com/leifliddy/asahi-fedora-builder> |
13+
| Gentoo<br>(LiveCD method) | IRC: chadmed (<https://github.com/chadmed>) | [Installing Gentoo with LiveCD](Installing-Gentoo-with-LiveCD.md) |
14+
| NixOS | IRC: tpw_rules (<https://github.com/tpwrules>) | <https://github.com/tpwrules/nixos-apple-silicon/blob/main/docs/uefi-standalone.md> |
15+
| Rocky Linux | <https://github.com/leifliddy> | <https://github.com/leifliddy/asahi-rocky-builder> |
16+
| Ubuntu | <https://github.com/UbuntuAsahi> | <https://ubuntuasahi.org/> |
17+
| Void Linux | <https://voidlinux.org/news/2025/02/new-images.html> | <https://docs.voidlinux.org/installation/guides/arm-devices/apple-silicon.html> |

docs/SW-Keyboard-Layouts.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -260,7 +260,7 @@ Apple MacBook Pro (14-inch, M1 Pro, 2021)
260260
* Best XKB keyboard layout/variant: **English (US)**
261261

262262
* My original keyboard is ISO German with stickers for International English. Working correctly in Mac OS.
263-
* Looks like https://www.apple.com/uk/shop/product/MK2A3Z/A/magic-keyboard-international-english
263+
* Looks like <https://www.apple.com/uk/shop/product/MK2A3Z/A/magic-keyboard-international-english>
264264
* Preview works for "English (US)", not for any of the English international variants.
265265
* Difference 1 with English (US): Key between Shift and Z is ~` on physical keyboard but types < > in Fedora.
266266
* Difference 2 with English (US): Key in top left next to 1 is +- § on physical keyboard but types ~` in Fedora.

docs/SW-Ubuntu-Asahi-Qemu.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -145,12 +145,12 @@ https://blogs.oracle.com/virtualization/post/install-microsoft-windows-11-on-vir
145145

146146
b) Figure out UEFI and TPM and how to activate it, not tested:
147147

148-
- https://getlabsdone.com/how-to-install-windows-11-on-kvm/
149-
- https://getlabsdone.com/how-to-enable-tpm-and-secure-boot-on-kvm/
150-
- https://github.com/stefanberger/swtpm/wiki
151-
- https://www.reddit.com/r/AsahiLinux/comments/y7hplo/virtual_machines_on_asahi_linux/
152-
- https://that.guru/blog/uefi-secure-boot-in-libvirt/
153-
- https://www.reddit.com/r/AsahiLinux/comments/107m4nb/windows_vm_on_asahi_qemukvm_virtmanager/
148+
- <https://getlabsdone.com/how-to-install-windows-11-on-kvm/>
149+
- <https://getlabsdone.com/how-to-enable-tpm-and-secure-boot-on-kvm/>
150+
- <https://github.com/stefanberger/swtpm/wiki>
151+
- <https://www.reddit.com/r/AsahiLinux/comments/y7hplo/virtual_machines_on_asahi_linux/>
152+
- <https://that.guru/blog/uefi-secure-boot-in-libvirt/>
153+
- <https://www.reddit.com/r/AsahiLinux/comments/107m4nb/windows_vm_on_asahi_qemukvm_virtmanager/>
154154

155155
```
156156
sudo apt-get install dh-autoreconf libssl-dev \

0 commit comments

Comments
 (0)