# iOS 27 OSEligibility changes

This repository documents the embedded `OSEligibility` changes between:

- iOS 26.6.2, build `23G90`, for `iPhone18,1`
- iOS 27.0 RC, build `24A435`, for `iPhone18,1`
- iOS 27.0 final, build `24A437`, for `iPhone18,1`

For background on the subsystem and its API, see the
[XFrameworks eligibility project](https://github.com/XFrameworks/eligibility),
an independent open-source reimplementation.

## Headline result

iOS 27 RC adds exactly **50 eligibility domains**, numbered **168–217**. All
50 use insect-genus codenames. Forty-nine are disabled placeholders whose
embedded answer is `not-yet-available`. The only enabled addition is domain
171, `BEMBIDION`, which evaluates the existing `ChinaPolicy`. A firmware
call-site trace identifies it as Apple Intelligence/Greymatter “China privacy”
eligibility used by `OnBoardingKit`.

No domain was removed or renamed between these builds. Domains 218–220 are not
iOS 27 additions: they are already present in iOS 26.6.2.

The final public build `24A437` was checked separately after release. It has
the same 221-entry enum, byte-identical embedded fallback configuration, and
the same resolved direct-consumer set as RC `24A435`. It therefore provides no
additional attribution for the 49 disabled insect domains.

## New domains

“Purpose unknown” means that the domain's feature consumer has not been
attributed. An insect name alone is not evidence of a feature association.

| ID | Domain | Embedded state | What it does | Region |
|---:|---|---|---|---|
| 168 | `CARABUS` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 169 | `CICINDELA` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 170 | `PTEROSTICHUS` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 171 | `BEMBIDION` | Enabled; default `not-eligible` | Apple Intelligence/Greymatter China-privacy eligibility in `OnBoardingKit` | China |
| 172 | `HARPALUS` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 173 | `SCAPHINOTUS` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 174 | `CALOSOMA` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 175 | `LEBIA` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 176 | `AGONUM` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 177 | `AMARA` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 178 | `CHLAENIUS` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 179 | `ELAPHRUS` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 180 | `NOTIOPHILUS` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 181 | `TACHYS` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 182 | `TRECHUS` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 183 | `MONOCHAMUS` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 184 | `ERGATES` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 185 | `PRIONUS` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 186 | `XYLOTRECHUS` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 187 | `BUPRESTIS` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 188 | `MELANOPHILA` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 189 | `DICERCA` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 190 | `AGRILUS` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 191 | `CHRYSOBOTHRIS` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 192 | `ELATER` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 193 | `AGRIOTES` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 194 | `CTENICERA` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 195 | `MELANOTUS` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 196 | `LIMONIUS` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 197 | `COCCINELLA` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 198 | `PSYLLOBORA` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 199 | `ADALIA` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 200 | `ANATIS` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 201 | `CALVIA` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 202 | `CURCULIO` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 203 | `OTIORHYNCHUS` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 204 | `LISTRONOTUS` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 205 | `HYLOBIUS` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 206 | `PISSODES` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 207 | `SITONA` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 208 | `PAPILIO` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 209 | `PARNASSIUS` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 210 | `NEOPHASIA` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 211 | `COLIAS` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 212 | `EUCHLOE` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 213 | `ANTHOCHARIS` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 214 | `LYCAENA` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 215 | `PLEBEJUS` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 216 | `GLAUCOPSYCHE` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |
| 217 | `CELASTRINA` | Disabled; `not-yet-available` | Purpose unknown; no fallback policy | None specified |

The full table is also available as [CSV](data/new-domains.csv).

### Attribution status

| Domain(s) | Result | Confidence | Basis |
|---|---|---|---|
| `BEMBIDION` (171) | Apple Intelligence/Greymatter China-privacy eligibility | Confirmed | A direct constant-ID call in a semantically named `OnBoardingKit` method, corroborated by its error string and embedded `ChinaPolicy` |
| Other 49 additions | No feature consumer attributed | Unknown, not “unused” | Disabled placeholder configuration; no direct constant-ID consumer and no consumer-side feature label found in the searches described below |

The machine-readable attribution record is in
[consumer-attributions.csv](data/consumer-attributions.csv). “Confirmed” here
applies to the capability association, not to the exact user-interface screen
that ultimately consumes it.

### What `ChinaPolicy` means here

In the iOS 27 RC embedded fallback, `ChinaPolicy` succeeds when either:

1. the Apple device region code is `CH`; or
2. the billing country is `CN` **and** the located-country set contains `CN`.

Consequently, the fallback makes `BEMBIDION` eligible under that China rule.
The direct caller is:

```text
-[OBCapabilities eligibilityForGreymatterHasCountryPolicyChina]
```

The method begins at shared-cache address `0x1c65890c0`; its call at
`0x1c6589124` passes the literal domain value `171` (`0xab`) to
`os_eligibility_get_domain_answer`. Its error log calls the check “Bembidion
(China privacy) eligibility.” This establishes that the domain represents a
China-specific Apple Intelligence/Greymatter privacy capability in
`OnBoardingKit`. The exact screen or disclosure ultimately selected by this
boolean has not yet been traced.

### Consumer-search result

Both iOS 27 shared caches were split into 4,696 images. In each build,
sixty-seven client images
contain the direct `os_eligibility_get_domain_answer` import; constant
propagation over their ARM64 call sites found `BEMBIDION` as the only query for
IDs 168–217.
Each build also contains the same 25 distinct standalone filesystem clients of
the C API; none queried an insect domain with a constant ID.

A separate exact-token search covered the mounted iOS root filesystem and all
4,696 split shared-cache images. It searched all 50 insect names as well as the
BEMBIDION selector and its “China privacy” wording. Outside the eligibility
providers and `OnBoardingKit`, the apparent insect-name hits were unrelated
natural-language or taxonomy data—for example Photos scene-taxonomy labels and
ContextKit's search index—not eligibility references. No second feature
association resulted from this scan.

This is strong negative evidence for the other 49 domains, consistent with
their disabled placeholder configuration, but it is not proof that no dormant
consumer exists. Some clients use the Swift `OSEligibilityResult.result(for:)`
wrapper and pass the domain through helper functions; that interprocedural
call graph has not been exhaustively resolved.

### RC-to-final verification

| Measurement | RC `24A435` | Final `24A437` |
|---|---:|---:|
| Enum entries | 221 (`0–220`) | 221 (`0–220`) |
| Configured domains | 220 | 220 |
| New insect domains | 50 (`168–217`) | Same 50 |
| Enabled insect domains | 1 (`BEMBIDION`) | Same 1 |
| Direct shared-cache calls | 87 | 87 |
| Constant-resolved shared-cache calls | 70 | 70 |
| Direct new-domain calls | 1 (`BEMBIDION`) | Same 1 |
| Direct standalone calls | 40 | 40 |
| Constant-resolved standalone calls | 28 | 28 |
| Standalone new-domain calls | 0 | 0 |

`eligibilityd` is byte-identical between RC and final. `OSEligibility` is also
byte-identical when reconstructed with identical options. Although other parts
of the final shared cache changed, normalizing the resolved eligibility calls
by image, function, and domain produces the same result. The comparison is
available as [CSV](data/release-comparison.csv).

## Other endpoint changes

The comparison also found changes to domains that already existed in iOS
26.6.2:

- 27 element-codename domains become enabled: `THALLIUM`, `LEAD`, `FRANCIUM`,
  `PROTACTINIUM`, `URANIUM`, `NEPTUNIUM`, and `AMERICIUM` through `MOSCOVIUM`
  except `PLUTONIUM`.
- `GOLD` and `MERCURY` change from default not eligible to unconditionally
  eligible.
- Seventeen age-assurance domains expand to Australia and/or Brazil.
- `SIRI_MODE` changes from an outside-EU gate to a compound device, language,
  boot-state, EU, and China policy.
- Twelve named policies are added. No named policy is removed or modified in
  place.
- The `Iodine Countries` data set adds `AL`, `CL`, `CO`, `DO`, `KZ`, `MX`,
  `NO`, `RS`, `SG`, `TH`, `TW`, and `ZA`. The feature consuming `IODINE`
  remains unattributed.

## Method and scope

The enum was recovered from `libsystem_eligibility.dylib`. The embedded
fallback configuration was decoded from the `NSConstantDictionary` object
graph in `/usr/libexec/eligibilityd`, then compared structurally by domain ID.
Consumer attribution was performed separately by locating C and Swift
eligibility clients, disassembling their ARM64 call sites, and propagating
constant domain arguments into the eligibility query.

This repository reports the embedded fallback shipped in these two builds. It
does not establish:

- what feature consumes an unattributed codename;
- whether a disabled or enabled domain is reachable on a particular device;
- whether Apple supplies a different configuration through
  `com.apple.MobileAsset.OSEligibility`;
- when a change first appeared during the iOS 27 beta cycle.

No Apple binaries or IPSW contents are included.

## Reproducibility

| Artifact | SHA-256 |
|---|---|
| iOS 26.6.2 `iPhone18,1_26.6.2_23G90_Restore.ipsw` | `0ca5a8e383df508b464951410e9e8d627ead8454e47b57c21d06a27d0d04598c` |
| iOS 26.6.2 `eligibilityd` | `780538c250007ff9643150ef31c98541161ef9e1aabf5631a59f71aaee64fcc7` |
| iOS 26.6.2 `libsystem_eligibility.dylib` | `b9a4c4093ac9944d4714f58f2edb8c513a1a0e7fdce7d6387c442ef2025e09f6` |
| iOS 27 RC `iPhone18,1_27.0_24A435_Restore.ipsw` | `9dda196f4233232a84ba3d8367c3f521fe536c287af097a74b1622e1e990c20d` |
| iOS 27 RC `eligibilityd` | `6d1bea2804ab0d8fd09fc6e415228d3e50150f29967878d5b3dfcfd6bcb1b474` |
| iOS 27 RC `libsystem_eligibility.dylib` | `da7af94ee54071f3c9d05530c1a96b6531c17d23a78714df33e8a23dcda8bfae` |
| iOS 27 final `iPhone18,1_27.0_24A437_Restore.ipsw` | `ef506a8d5a39a258b6b7494c2982ed918c6dc4a609bf8bf4b43bb8ab4357f090` |
| iOS 27 final `eligibilityd` | `6d1bea2804ab0d8fd09fc6e415228d3e50150f29967878d5b3dfcfd6bcb1b474` |

## License

The original research and documentation in this repository are released under
the [MIT License](LICENSE). Apple product names and identifiers remain the
property of their respective owners.
