From eca2592797d8441d6b747c7485a7eae3f9572984 Mon Sep 17 00:00:00 2001 From: ruihan Date: Fri, 30 Oct 2026 11:48:40 -0300 Subject: [PATCH] docs: record macOS 27 reports and Wi-Fi investigation steps --- README.md | 61 +++++++++++++++++++++++++++++++++++-------- lib/doctor.sh | 2 +- unleash-standalone.sh | 2 +- 3 files changed, 52 insertions(+), 13 deletions(-) diff --git a/README.md b/README.md index 075f495..cd349b6 100644 --- a/README.md +++ b/README.md @@ -283,16 +283,20 @@ Unleash blocks via `/etc/hosts`: - `acmdm.apple.com` — Apple Configurator MDM - `axm-adm-mdm.apple.com` — ACM enrollment - `albert.apple.com` — ABM device assignment -- `gdmf.apple.com` — MDM framework -- `configuration.apple.com` — config service +- `gdmf.apple.com` — software update catalog - `xp.apple.com` — device management -- `gs.apple.com` — device enrollment +- `gs.apple.com` — software updates - `tb.apple.com` — device trust - `vpp.itunes.apple.com` — volume purchase - Your org's MDM host (extracted from the DEP record) Both IPv4 (0.0.0.0) and IPv6 (::) entries are added. +Some listed hosts also serve general Apple services. Blocking the software-update +hosts can affect updates; this is distinct from a Wi-Fi radio failure. +`configuration.apple.com`, used for Rosetta 2 updates, is no longer blocked. +See [Apple's network requirements](https://support.apple.com/en-gb/101555). + ### Layer 3: Launchd daemon override macOS registers enrollment daemons that run at boot: @@ -464,17 +468,51 @@ Unleash checks for `/private/var/db/dslocal/nodes/Default` on the mounted volume ### macOS 27 and later -macOS 27 has no recorded passing hardware validation in this project yet. -Compatibility is tracked in [#22](https://github.com/mateussiqueira/unleash/issues/22). -For a compatibility or Wi-Fi report, collect the build and interface state: +[#22](https://github.com/mateussiqueira/unleash/issues/22) contains two positive +community reports for macOS 27.2: + +- The [original reporter](https://github.com/mateussiqueira/unleash/issues/22#issuecomment-6522921874) + reports Unleash 2.0.0 working on an M1 Pro after upgrading an existing Sequoia + setup. This was not a fresh installation. +- [Another user](https://github.com/mateussiqueira/unleash/issues/22#issuecomment-6520816615) + reports basic commands working on a MacBook Neo (Apple A18 Pro). + +These reports answer the original question but do not establish support for every +build, command, or Recovery/FileVault scenario. Neither includes a complete test +matrix. Shell regression tests are separate from hardware validation. + +### Wi-Fi on an external startup disk + +[#24](https://github.com/mateussiqueira/unleash/issues/24) remains under +investigation. From the affected external installation, run: ```bash ./unleash doctor --network ``` -This reads the macOS build, Wi-Fi interface, power, and link status. Include -the script commit, hardware model, and external SSD/hub connection when -reporting an external-volume problem. It does not certify compatibility. +This read-only command reports the macOS build, Wi-Fi interface, power, link, and +IPv4 category without printing SSIDs, hardware addresses, or IP addresses. +A failed query is reported separately from a successful query with no Wi-Fi port. + +- `Link status: inactive` concerns the interface link, before internet reachability. +- `Wi-Fi IPv4: link-local` indicates a 169.254 address; `none` means no nonzero IPv4 + address was reported. Neither result diagnoses IPv6 connectivity. +- `Wi-Fi IPv4: configured` does not prove DNS or internet access. + +Include the script commit, Mac model, exact OS build, SSD/cable/hub connection, +and whether Wi-Fi worked on that same external installation before running +Unleash, if known. Working Wi-Fi on the internal installation alone does not +isolate what changed on the external one. + +The `dualboot` code does not directly rewrite Wi-Fi preferences or toggle the +radio. Tests preserve simulated network preferences, but do not reproduce macOS +services reacting to account, enrollment, or boot changes. + +Apple documents [model-specific external installations](https://support.apple.com/en-eg/111336) +and possible [USB 3/Thunderbolt 3 wireless interference](https://support.apple.com/en-us/102319). +These are investigation leads, not confirmed causes of #24. If comparing startup +disk cables or hubs, shut down before changing their connections; do not unplug +the active startup disk. ### Monitor won't start Check if it's already running (`monitor-status`). Check permissions — it needs root. Check logs at `/var/log/unleash-monitor.log`. @@ -483,8 +521,9 @@ Check if it's already running (`monitor-status`). Check permissions — it needs **What macOS versions are supported?** The existing targets are macOS 12–15 and 26. Validation depends on the command, -OS build, and hardware; macOS 27 remains unverified. Shell regression tests -do not replace testing Recovery, FileVault, and networking on the target Mac. +OS build, and hardware. macOS 27.2 has the limited community reports described +above; they do not replace testing Recovery, FileVault, and networking on the +target Mac. **Do I need to disable SIP?** No. All writes target the Data volume. diff --git a/lib/doctor.sh b/lib/doctor.sh index 95e75e6..9223680 100644 --- a/lib/doctor.sh +++ b/lib/doctor.sh @@ -6,7 +6,7 @@ _network_diagnostics() { build=$(sw_vers -buildVersion 2>/dev/null) || build=unavailable fi printf 'macOS: %s (build %s)\n' "$version" "$build" - case "$version" in 27.*) warn "macOS 27 hardware compatibility remains unverified (issue #22)." ;; esac + case "$version" in 27.*) warn "macOS 27 has limited community reports; see issue #22 for their scope." ;; esac local interface ports if ! command -v networksetup >/dev/null; then warn "Wi-Fi diagnostics unavailable: networksetup is missing." diff --git a/unleash-standalone.sh b/unleash-standalone.sh index fcd94d9..e9c6613 100755 --- a/unleash-standalone.sh +++ b/unleash-standalone.sh @@ -1904,7 +1904,7 @@ _network_diagnostics() { build=$(sw_vers -buildVersion 2>/dev/null) || build=unavailable fi printf 'macOS: %s (build %s)\n' "$version" "$build" - case "$version" in 27.*) warn "macOS 27 hardware compatibility remains unverified (issue #22)." ;; esac + case "$version" in 27.*) warn "macOS 27 has limited community reports; see issue #22 for their scope." ;; esac local interface ports if ! command -v networksetup >/dev/null; then warn "Wi-Fi diagnostics unavailable: networksetup is missing."