Skip to content

Run a virtual iPhone on an Apple Silicon Mac.

Swift
2.3 KB
Raw Blame
// PatchRecord.swift — Per-patch verification record for migration validation.

import Foundation

/// A single patch application record, used to compare Python vs Swift output.
public struct PatchRecord: Codable, Equatable, Sendable {
    /// Unique patch identifier (e.g., "kernel-boot-bsd_init_rootvp").
    public let patchID: String

    /// Component being patched (e.g., "kernelcache", "ibss", "txm").
    public let component: String

    /// File offset where the patch is applied.
    public let fileOffset: Int

    /// Virtual address (if applicable, nil for raw binaries).
    public let virtualAddress: UInt64?

    /// Original bytes before patching.
    public let originalBytes: Data

    /// Replacement bytes after patching.
    public let patchedBytes: Data

    /// Capstone disassembly of original bytes.
    public let beforeDisasm: String

    /// Capstone disassembly of patched bytes.
    public let afterDisasm: String

    /// Human-readable description of what this patch does.
    public let patchDescription: String

    public init(
        patchID: String,
        component: String,
        fileOffset: Int,
        virtualAddress: UInt64? = nil,
        originalBytes: Data,
        patchedBytes: Data,
        beforeDisasm: String = "",
        afterDisasm: String = "",
        description: String,
    ) {
        self.patchID = patchID
        self.component = component
        self.fileOffset = fileOffset
        self.virtualAddress = virtualAddress
        self.originalBytes = originalBytes
        self.patchedBytes = patchedBytes
        self.beforeDisasm = beforeDisasm
        self.afterDisasm = afterDisasm
        patchDescription = description
    }
}

extension PatchRecord: CustomStringConvertible {
    public var description: String {
        let addr = virtualAddress.map { String(format: " (VA 0x%llX)", $0) } ?? ""
        return String(
            format: "  0x%06X%@: %@ → %@  [%@]",
            fileOffset,
            addr,
            beforeDisasm.isEmpty ? originalBytes.hex : beforeDisasm,
            afterDisasm.isEmpty ? patchedBytes.hex : afterDisasm,
            patchID,
        )
    }
}

public extension Data {
    /// Lowercase hex, the spelling every patch log and record uses.
    var hex: String {
        map { String(format: "%02x", $0) }.joined()
    }
}