Skip to content

Run a virtual iPhone on an Apple Silicon Mac.

Swift

fix: avoid locationd startup cohort races on iOS 27

Jacky1e9dc6b2f9a4
diff --git a/Research/0_binary_patch_comparison.md b/Research/0_binary_patch_comparison.md
index 6c75747c..a18cb0eb 100644
--- a/Research/0_binary_patch_comparison.md
+++ b/Research/0_binary_patch_comparison.md
@@ -1,5 +1,19 @@
# Patch Comparison: Regular / Development / Jailbreak / Experimental
+> **iOS 27 locationd startup (2026-10-08):**
+> `system-locationd-cfw-disable_auto_cohort` disables only `CLAutoCohort` in
+> `System/Library/FeatureFlags/Domain/CoreLocation.plist`. The guest system set
+> selects it for iOS 27 only; `cfw install` and environment updates back up the
+> original plist and restore it when deselected. Independent location silos
+> avoid the startup queue hangs/PAC failures seen with automatic cohorts on
+> the cloudOS 26.4 research kernel. No executable or PAC instruction is patched.
+> On `loc27-iphone` (24A435), 20 locationd restarts and 5 cold boots answered
+> before watchdog recovery; restoring the original flag brought back repeated
+> launches and a watchdog kill. A fresh iPad16,1 24A446 guest reproduced the
+> same PAC failure with stock cohorts; with this change, another 20 restarts
+> and 5 cold boots passed, with no new crash reports or watchdog actions. See
+> [evidence and verification](Guest/locationd_27_0_1_startup_race.md).
+
> **Patch sets and presets (2026-09-28):** every patch is now *declared*, and
> selection happens before any byte is written. The declarations live in nine
> bundled patch sets under `VPhoneExecutable/VPhoneCommand/FirmwarePatcher/PatchSets/`
diff --git a/Research/Guest/locationd_27_0_1_startup_race.md b/Research/Guest/locationd_27_0_1_startup_race.md
new file mode 100644
index 00000000..d367bfd9
--- /dev/null
+++ b/Research/Guest/locationd_27_0_1_startup_race.md
@@ -0,0 +1,157 @@
+# iOS 27 locationd startup crashes and cohort queues
+
+Disabling `CoreLocation/CLAutoCohort` prevents the startup PAC failures and
+queue hangs reproduced on iOS 27.0 (24A435) and iPadOS 27.0.1 (24A446) guests
+using the cloudOS 26.4 (23E5207q) research kernel. This is a compatibility
+workaround: the underlying libdispatch/kernel defect has not been established.
+The existing locationd watchdog remains as a recovery mechanism.
+
+`system-locationd-cfw-disable_auto_cohort` sets only `CLAutoCohort.Enabled`
+to `false` in `/System/Library/FeatureFlags/Domain/CoreLocation.plist`.
+The guest system patch set selects it only for an iOS 27 base. The installer
+backs up the original plist and restores it when the patch is deselected.
+Other feature flags and the plist encoding are preserved. No executable,
+PAC instruction, or kernel instruction is changed.
+
+See also [the earlier startup-deadlock investigation](locationd_startup_deadlock.md).
+
+## Evidence and fault location
+
+The supplied 24A446 crash report records locationd PID 413 launching at
+20:12:26.088 and crashing at 20:12:26.165 on October 8, 2026 (report timezone
++0900). Thread 8 is draining `Cohort:0` and terminates with
+`EXC_ARM_PAC_FAIL`. The failure occurs about 77 ms after launch.
+
+The libdispatch UUID is `8CDF4610-F6A5-39CB-94BF-687FE349A4BE`. Its base is
+`0x1aeaf1000`, and the faulting PC is `0x1aeafb6b8`, an image-relative offset
+of `0xa6b8`. The original 24A435 cache contains the same UUID at base
+`0x1aeaee000`, placing the corresponding instruction at `0x1aeaf86b8`.
+Match the image UUID and relative offset rather than assuming identical
+cache layouts.
+
+The instruction is `autda x16, x17` in `_dispatch_lane_serial_drain + 192`:
+
+```text
+ldr x28, [x25]
+cmp x28, #0x1, lsl #12
+b.lo <continuation path>
+mov x16, x28
+mov x17, x25
+movk x17, #0x6ae1, lsl #48
+autda x16, x17 // fault
+```
+
+The report has `x25 = 0x0000000dd9385fe0`, `x28 = 0x00000001e0174ac8`, and
+`x17 = 0x6ae1000dd9385fe0`. Authentication fails while interpreting the first
+word of the queue-head object, before the subsequent indirect call. This
+is distinct from the earlier report of a bad block invoke pointer. A stale
+stack continuation is a candidate explanation, not a proven origin of the
+corruption.
+
+| Evidence | Observation | Interpretation |
+| --- | --- | --- |
+| `locationd-20261008-201345-spinning.spindump.txt` | PID 533 consumes 3.202 s CPU in a 3.22 s sample. The main thread waits on CLLocationControllerSilo; another thread loops through `_dispatch_lane_drain_barrier_waiter` and `__DISPATCH_WAIT_FOR_ENQUEUER__`. | Sustained enqueuer waiting accompanies the blocked main thread. The sample does not identify the original corrupting write. |
+| `locationd-20261008-201523.spindump.txt` | Contains PIDs 671, 674 and 676; PID 671 becomes a zombie, while PID 676 again blocks the main thread. | This is a sequence of process lifetimes, not one stable process sample. |
+| `panic-vm-27.0.1.log` | `VM entry ... lock is invalid (0)` at `vm_entry_lock.c:168`; the panicked task is inspectord, PID 485. | A separate kernel panic is confirmed, but direct causation by locationd is not established. |
+
+## Configuration path
+
+Static inspection used ipsw and llvm-objdump on original firmware. locationd
+loads LocationSupport, CoreLocation and libSystem. Relevant LocationSupport
+imports include `_os_feature_enabled_impl`,
+`dispatch_queue_create_with_target$V2` and the Objective-C runtime.
+
+In 24A435 locationd, the code at `0x100420c60` reads `CLSilo.Version`.
+An older configuration version clears the saved cohort overrides; the
+built-in version is 1. The code at `0x100420ef4` reads
+`CLSilo.NameToCohortMap`, and `0x100420f9c` calls
+`+[CLSilo setGlobalConfiguration:]`. It also reads `CLSilo.SyncgetGraphFile`.
+
+LocationSupport's
+`+[CLAutoCohortUtilities enableAutoCohortingForProcessAtPath:]` queries
+`CoreLocation/CLAutoCohort` at `0x23984b1b0`. With the flag disabled, the
+silos retain independent serial queues instead of automatic cohort targets.
+Both tested builds contain the same feature dictionary, initially containing
+only `DevelopmentPhase = FeatureComplete`.
+
+A user-directory override under `/Library/Preferences/FeatureFlags/Domain`
+did not produce confirmed disablement. The successful experiment changed
+the system feature plist and rebooted. Logs explicitly reported
+`CoreLocation/CLAutoCohort=off`, and silo `CohortId` values were empty.
+An empty sync-get graph was briefly configured but never used in a completed
+controlled startup; it was removed and is not counted as a test result.
+
+## Guest validation
+
+Tests ran on October 8, 2026 with 8 vCPUs, 8 GiB RAM, the standard preset,
+cloudOS 26.4 (23E5207q), and bundle `2.7.0-local.b16edda9`.
+The configuration change was applied manually to isolate it from unrelated
+local bundle changes. PatchReceipt was not edited to claim an installer run.
+
+| Guest | Build | With automatic cohorts | With automatic cohorts disabled |
+| --- | --- | --- | --- |
+| `loc27-iphone`, iPhone17,3 | 27.0 / 24A435 | Restoring the original flag brought back missing-PID startup checks, 18 accumulated launch attempts and a watchdog kill of unresponsive PID 456. | 20/20 locationd restarts and 5/5 complete VM stop/start cycles responded in under 1 s, with unchanged PID across each probe. |
+| `loc27-24a446`, iPad16,1 | 27.0.1 / 24A446 | Fresh installation reproduced a crash loop. An 8 s probe timed out. A new crash had `Cohort:0`, `EXC_ARM_PAC_FAIL`, and `_dispatch_lane_serial_drain + 192`, matching the supplied report. | Another 20/20 restarts and 5/5 cold boots responded in under 1 s. No new crash reports or watchdog actions appeared. |
+
+For each process-restart trial, kill locationd with SIGKILL, wait 3 s, record
+its replacement PID, issue `location.current` with an 8 s host timeout, then
+check the PID again. For each cold-boot trial, stop/start the VM, wait for
+vphoned, and perform the same probe before watchdog recovery can intervene.
+A PID change or missing PID is not a successful probe.
+
+Location Services remained off throughout. The expected immediate response
+was `Location Services are turned off in the guest`; this exercises startup
+and synchronous daemon responsiveness. It does not validate Maps navigation
+or complete simulated-coordinate delivery.
+
+On 24A446, the first baseline capture contained seven new reports; outstanding
+report writes had completed by the repaired-run baseline, which contained
+13. The sorted locationd report entries, including paths and modification
+metadata, were identical before and after the repaired trials. The two
+existing watchdog log entries did not increase. A separate instrumented
+restart confirmed the disabled-feature log message. The guest ended with
+`panicked=false`.
+
+Original configuration backups were retained as `CoreLocation.plist.bak`
+and checked against the pre-change dictionary. Temporary launchd jobs were
+unloaded and removed. After reboot, `/sbin/mount` confirmed the root volume
+was `apfs, sealed, local, read-only`. Backups belong on the persistent system
+volume: `/var/tmp` was cleared during an earlier reboot, invalidating one
+attempted reverse-control setup; that attempt is excluded from the results.
+
+### Preparing the 24A446 guest
+
+The initial online restore failed before locationd could run. The guest's
+AEA key retrieval received an HTTP 301, then reported
+`No WKMS decryption key received from host` and ASR error 1106. After that
+restore exited, restarting the test guest in DFU, fetching its ticket with
+`restore --get-shsh`, and running the existing `restore --offline` path
+completed host-side AEA decryption, filesystem transfer and sealing.
+`cfw install` then completed successfully. These preparation failures are
+separate from the locationd test results.
+
+## Source and build verification
+
+The configuration and catalogue suites passed 21 tests, covering XML and
+binary format preservation, unrelated flags, dry-run, idempotence, malformed
+schema rejection, and selection for iOS 27 only (including unknown-version
+exclusion). The complete Debug VPhone bundle build and bundle admission
+passed. Its CLI also patched a copy of the original 24A446 feature plist;
+dry-run left the input unchanged, and a second real run preserved the
+first run's output byte for byte.
+
+The guest experiments establish a compatibility workaround for these two
+builds. They do not prove which underlying libdispatch or kernel operation
+causes the race, nor that other iOS 27 builds are unaffected by other faults.
+
+## Original report integrity
+
+The source reports were not modified. Hashes identify the original inputs;
+the reports themselves are not included in the repository.
+
+| File | SHA-256 |
+| --- | --- |
+| `panic-vm-27.0.1.log` | `cedfac427321fecbf28ebc2c8c4be7081f0b3e6998cde57e08551bff36185081` |
+| `locationd-20261008-201523.spindump.txt` | `3c3fc7ac15b18da40fa307b38a53359d518ef5b506f2d087b14a7e86843b2ec7` |
+| `locationd-20261008-201345-spinning.spindump.txt` | `de3c523b1d14457cacf3aa4e56af73a8147c16af8667f506f8356470ac5d9656` |
+| locationd xrashreport, October 8, 2026 at 20:12:26 | `2401fd41e798c5776ee1b1bea03c49b317430a98e0798f35857212a2f6f56075` |
diff --git a/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/CustomFirmware/CustomFirmwareLocationdCohorting.swift b/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/CustomFirmware/CustomFirmwareLocationdCohorting.swift
new file mode 100644
index 00000000..269affc7
--- /dev/null
+++ b/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/CustomFirmware/CustomFirmwareLocationdCohorting.swift
@@ -0,0 +1,39 @@
+import Foundation
+import VPhonePatchKit
+
+/// Keep iOS 27 location silos on their independent serial queues. Automatic
+/// cohort queues trigger startup PAC failures and hangs on the tested research
+/// guest. See Research/Guest/locationd_27_0_1_startup_race.md; the underlying
+/// libdispatch/kernel cause is not established by this compatibility fix.
+public enum CustomFirmwareLocationdCohorting {
+ public static let relativePath = "System/Library/FeatureFlags/Domain/CoreLocation.plist"
+ public static let feature = "CLAutoCohort"
+
+ /// The installer owns the iOS version gate, pristine backup and rollback.
+ /// Preserve every other feature and the input plist's encoding.
+ @discardableResult
+ public static func patch(at url: URL, dryRun: Bool = false) throws -> Bool {
+ let input = try Data(contentsOf: url)
+ var format = PropertyListSerialization.PropertyListFormat.xml
+ guard var root = try PropertyListSerialization.propertyList(
+ from: input, options: [], format: &format
+ ) as? [String: Any],
+ var feature = root[Self.feature] as? [String: Any]
+ else {
+ throw PatcherError.invalidFormat("Missing CLAutoCohort feature dictionary: \(url.path)")
+ }
+ if let enabled = feature["Enabled"] {
+ guard let number = enabled as? NSNumber,
+ CFGetTypeID(number) == CFBooleanGetTypeID()
+ else {
+ throw PatcherError.invalidFormat("CLAutoCohort.Enabled is not a boolean: \(url.path)")
+ }
+ if !number.boolValue { return false }
+ }
+ feature["Enabled"] = false
+ root[Self.feature] = feature
+ let output = try PropertyListSerialization.data(fromPropertyList: root, format: format, options: 0)
+ if !dryRun { try output.write(to: url, options: .atomic) }
+ return true
+ }
+}
diff --git a/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/PatchSets/FirmwareGuestSystemPatchSet.swift b/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/PatchSets/FirmwareGuestSystemPatchSet.swift
index 017c0a78..714743bd 100644
--- a/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/PatchSets/FirmwareGuestSystemPatchSet.swift
+++ b/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/PatchSets/FirmwareGuestSystemPatchSet.swift
@@ -22,6 +22,8 @@ public enum FirmwareGuestSystemPatchSet {
public static let installCoordinationPersona = "system-installcoordination_proxy-cfw-persona_lookup"
public static let installCoordinationPersonaMarker = "/usr/lib/vphone-installcoordination-persona-lookup"
+ public static let locationdCohorting = "system-locationd-cfw-disable_auto_cohort"
+
private static let ios27 = VPhonePatchApplicability(iOSBase: .major(27))
/// The bases where short-circuiting `checkTrustAndAuthorization` in the
@@ -45,6 +47,13 @@ public enum FirmwareGuestSystemPatchSet {
name: "Guest System",
summary: "Shared-cache policy gates, patched system daemons and the vphone guest payload",
patches: [
+ VPhonePatchDeclaration(
+ identifier: locationdCohorting,
+ title: "locationd startup stability",
+ summary: "Uses independent location silos to avoid iOS 27 startup crashes and queue hangs on the research guest.",
+ target: .guestFile(path: "/" + CustomFirmwareLocationdCohorting.relativePath),
+ applicability: ios27,
+ ),
// MARK: Shared Cache Policy
VPhonePatchDeclaration(
diff --git a/VPhoneExecutable/VPhoneCommand/FirmwarePatcherTests/CustomFirmware/CustomFirmwareLocationdCohortingTests.swift b/VPhoneExecutable/VPhoneCommand/FirmwarePatcherTests/CustomFirmware/CustomFirmwareLocationdCohortingTests.swift
new file mode 100644
index 00000000..4390fa69
--- /dev/null
+++ b/VPhoneExecutable/VPhoneCommand/FirmwarePatcherTests/CustomFirmware/CustomFirmwareLocationdCohortingTests.swift
@@ -0,0 +1,57 @@
+@testable import FirmwarePatcher
+import Foundation
+import Testing
+import VPhonePatchKit
+
+@Suite("Locationd cohort configuration")
+struct CustomFirmwareLocationdCohortingTests {
+ @Test
+ func selectedOnlyForIOS27() throws {
+ for base in [nil, "18.6", "26.6.2", "27.0", "27.0.1", "28.0"] as [String?] {
+ let plan = try VPhonePatchPlan.resolve(
+ preset: FirmwarePatchSetCatalog.standardPreset,
+ patchSets: FirmwarePatchSetCatalog.bundled,
+ iOSBase: base.flatMap { VPhoneVersion($0) }, cloudOS: VPhoneVersion("26.4")
+ )
+ #expect(plan.isEnabled(FirmwareGuestSystemPatchSet.locationdCohorting) == (base?.hasPrefix("27.") == true))
+ }
+ }
+
+ @Test(arguments: [PropertyListSerialization.PropertyListFormat.xml, .binary])
+ func preservesOtherFeaturesAndEncoding(format: PropertyListSerialization.PropertyListFormat) throws {
+ let url = FileManager.default.temporaryDirectory.appendingPathComponent(UUID().uuidString)
+ defer { try? FileManager.default.removeItem(at: url) }
+ let original: [String: Any] = [
+ "CLAutoCohort": ["DevelopmentPhase": "FeatureComplete", "Metadata": "retained"],
+ "OtherFeature": ["Enabled": true],
+ ]
+ let input = try PropertyListSerialization.data(fromPropertyList: original, format: format, options: 0)
+ try input.write(to: url)
+ #expect(try CustomFirmwareLocationdCohorting.patch(at: url, dryRun: true))
+ #expect(try Data(contentsOf: url) == input)
+ #expect(try CustomFirmwareLocationdCohorting.patch(at: url))
+ let output = try Data(contentsOf: url)
+ var outputFormat = PropertyListSerialization.PropertyListFormat.xml
+ let root = try #require(PropertyListSerialization.propertyList(from: output, format: &outputFormat) as? [String: Any])
+ #expect(outputFormat == format)
+ #expect((root["OtherFeature"] as? NSDictionary) == (original["OtherFeature"] as? NSDictionary))
+ let cohort = try #require(root["CLAutoCohort"] as? [String: Any])
+ #expect(cohort["Enabled"] as? Bool == false)
+ #expect(cohort["DevelopmentPhase"] as? String == "FeatureComplete")
+ #expect(cohort["Metadata"] as? String == "retained")
+ #expect(try !CustomFirmwareLocationdCohorting.patch(at: url))
+ #expect(try Data(contentsOf: url) == output)
+ }
+
+ @Test
+ func rejectsUnexpectedSchemaWithoutWriting() throws {
+ let url = FileManager.default.temporaryDirectory.appendingPathComponent(UUID().uuidString)
+ defer { try? FileManager.default.removeItem(at: url) }
+ for root: [String: Any] in [[:], ["CLAutoCohort": "invalid"], ["CLAutoCohort": ["Enabled": 0]]] {
+ let input = try PropertyListSerialization.data(fromPropertyList: root, format: .binary, options: 0)
+ try input.write(to: url)
+ #expect(throws: (any Error).self) { try CustomFirmwareLocationdCohorting.patch(at: url) }
+ #expect(try Data(contentsOf: url) == input)
+ }
+ }
+}
diff --git a/VPhoneExecutable/VPhoneCommand/VPhoneCommand/Firmware/VPhoneCustomFirmwareInstaller.swift b/VPhoneExecutable/VPhoneCommand/VPhoneCommand/Firmware/VPhoneCustomFirmwareInstaller.swift
index 43285d91..159bcbfd 100644
--- a/VPhoneExecutable/VPhoneCommand/VPhoneCommand/Firmware/VPhoneCustomFirmwareInstaller.swift
+++ b/VPhoneExecutable/VPhoneCommand/VPhoneCommand/Firmware/VPhoneCustomFirmwareInstaller.swift
@@ -1141,6 +1141,25 @@ struct VPhoneCustomFirmwareInstaller {
live: &live, failures: &failures,
)
+ // A missing legacy plan must not apply this iOS-27-only change to
+ // other bases. Turning it off restores the original feature plist.
+ let locationdID = FirmwareGuestSystemPatchSet.locationdCohorting
+ let locationdPath = CustomFirmwareLocationdCohorting.relativePath
+ isolate([locationdID]) {
+ if version.hasPrefix("27."), on(locationdID) {
+ try patchCopy(
+ of: locationdPath, in: system, work: work,
+ verb: "patch-locationd-cohorting", backupSafe: backupSafe(locationdID)
+ )
+ live.insert(locationdID)
+ } else if try revertCopy(of: locationdPath, in: system) {
+ print(" [+] \(locationdID): restored CoreLocation feature flags")
+ } else if priorGuest.contains(locationdID) {
+ print(" [!] \(locationdID): no backup to revert (not revertible)")
+ live.insert(locationdID)
+ }
+ }
+
// 3. The build-version spoof. Off by default (needs a preset parameter
// or SPOOF_BUILD). Backed up only when it was not already applied.
let buildVersion = plan?.parameters[FirmwareGuestSystemPatchSet.buildVersionParameter] ?? spoofBuild
diff --git a/VPhoneExecutable/VPhoneCommand/VPhoneCommand/Firmware/VPhoneCustomFirmwarePatchCommand.swift b/VPhoneExecutable/VPhoneCommand/VPhoneCommand/Firmware/VPhoneCustomFirmwarePatchCommand.swift
index 73fcf8cf..fa6332cc 100644
--- a/VPhoneExecutable/VPhoneCommand/VPhoneCommand/Firmware/VPhoneCustomFirmwarePatchCommand.swift
+++ b/VPhoneExecutable/VPhoneCommand/VPhoneCommand/Firmware/VPhoneCustomFirmwarePatchCommand.swift
@@ -179,6 +179,27 @@ struct VPhoneCustomFirmwareInjectDylibCommand: ParsableCommand {
}
}
+// MARK: - patch-locationd-cohorting
+
+struct VPhoneCustomFirmwarePatchLocationdCohortingCommand: ParsableCommand {
+ static let configuration = CommandConfiguration(
+ commandName: "patch-locationd-cohorting",
+ abstract: "Disable automatic CoreLocation cohort queues in a staged iOS 27 feature plist",
+ shouldDisplay: false,
+ )
+
+ @Argument(transform: URL.init(fileURLWithPath:))
+ var plist: URL
+
+ @Flag(name: .customLong("dry-run"))
+ var dryRun = false
+
+ func run() throws {
+ let changed = try CustomFirmwareLocationdCohorting.patch(at: plist, dryRun: dryRun)
+ print(" [\(changed ? "+" : ".")] CLAutoCohort.Enabled = false\(dryRun ? " (dry-run)" : "")")
+ }
+}
+
// MARK: - patch-build-version
struct VPhoneCustomFirmwarePatchBuildVersionCommand: ParsableCommand {
diff --git a/VPhoneExecutable/VPhoneCommand/VPhoneCommand/Restore/VPhoneRestoreCommand.swift b/VPhoneExecutable/VPhoneCommand/VPhoneCommand/Restore/VPhoneRestoreCommand.swift
index c87b41e5..9b5ec520 100644
--- a/VPhoneExecutable/VPhoneCommand/VPhoneCommand/Restore/VPhoneRestoreCommand.swift
+++ b/VPhoneExecutable/VPhoneCommand/VPhoneCommand/Restore/VPhoneRestoreCommand.swift
@@ -243,6 +243,7 @@ struct VPhoneCustomFirmwareCommand: ParsableCommand {
VPhoneCustomFirmwarePatchDropbearPlistCommand.self,
VPhoneCustomFirmwareInjectDylibCommand.self,
VPhoneCustomFirmwarePatchBuildVersionCommand.self,
+ VPhoneCustomFirmwarePatchLocationdCohortingCommand.self,
VPhoneCustomFirmwarePatchVirtualAudioGraphConfigurationsCommand.self,
VPhoneCustomFirmwarePatchVirtualAudioSpeakerRawCommand.self,
VPhoneCustomFirmwarePatchVirtualAudioMicrophoneChainsCommand.self,