From 284506d407eb8e90a85efe40c90c1f57f96c3754 Mon Sep 17 00:00:00 2001
From: Acelogic <7362641+Acelogic@users.noreply.github.com>
Date: Fri, 23 Oct 2026 20:59:47 -0400
Subject: [PATCH] tools: say what keeps a desktop AuxKC from reproducing byte
 for byte

The previous commit said a rebuilt collection differs from a deployed
one only in UUID-derived bytes. It also differs in each kext's
_PrelinkBundlePath: build-auxkc-user.py stages the kexts in a randomly
named temporary folder and kmutil records that path in the prelink
info. Comparing bd057773 and 43bed810 with collections rebuilt from
the profiles commit, the differing bytes are exactly: the collection
UUID, both kexts' LC_UUID, the receipt's digests, the OSBundleUUID and
_PrelinkKCID strings, and the two staging paths. Document this in the
script header. Comment only.
---
 tools/build-auxkc-desktop.sh | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/tools/build-auxkc-desktop.sh b/tools/build-auxkc-desktop.sh
index 7e6b992..11ce806 100755
--- a/tools/build-auxkc-desktop.sh
+++ b/tools/build-auxkc-desktop.sh
@@ -17,6 +17,12 @@
 #     ZERO_AR_DATE  exported as 1 unless set: object times in the kexts' debug maps are zeroed, so two builds in the
 #                   same checkout produce the same kext bytes
 #
+# The collection's bytes are not reproducible even from identical kexts: its prelink info records each kext's
+# _PrelinkBundlePath in build-auxkc-user.py's temporary staging folder, whose name is random. Against a deployed
+# collection, expect differences only there and in what the kexts' UUIDs determine (each kext's LC_UUID and
+# OSBundleUUID, the collection's UUID and _PrelinkKCID, the receipt's per-kext digests); compare the kexts with
+# REFERENCE for the substance.
+#
 # Local inputs, never committed: gpu/adreno-kext/kext/include/*26A428.h (AGENTS.md, "Rebuilding What Is Not
 # Distributed"), downloads/extracted/j700ap (the J700 restore-image kernelcache), the KDK at
 # /Library/Developer/KDKs/KDK_27.0_26A428.kdk, and GNU tar at /opt/homebrew/bin/gtar (build-auxkc-user.py runs it