Struct PairingFile 

pub struct PairingFile {
    pub device_certificate: CertificateDer<'static>,
    pub host_private_key: Vec<u8>,
    pub host_certificate: CertificateDer<'static>,
    pub root_private_key: Vec<u8>,
    pub root_certificate: CertificateDer<'static>,
    pub system_buid: String,
    pub host_id: String,
    pub escrow_bag: Option<Vec<u8>>,
    pub wifi_mac_address: String,
    pub udid: Option<String>,
}

Represents a complete iOS device pairing record

Contains all cryptographic materials and identifiers needed for secure communication with an iOS device, including certificates, private keys, and device identifiers.

Fields

device_certificate: CertificateDer<'static>

Device’s certificate in DER format

host_private_key: Vec<u8>

Host’s private key in DER format

host_certificate: CertificateDer<'static>

Host’s certificate in DER format

root_private_key: Vec<u8>

Root CA’s private key in DER format

root_certificate: CertificateDer<'static>

Root CA’s certificate in DER format

system_buid: String

System Build Unique Identifier

host_id: String

Host identifier

escrow_bag: Option<Vec<u8>>

Escrow bag allowing for access while locked

wifi_mac_address: String

Device’s WiFi MAC address

udid: Option<String>

Device’s Unique Device Identifier (optional)

Implementations

impl PairingFile

pub fn read_from_file(path: impl AsRef<Path>) -> Result<Self, IdeviceError>

Reads a pairing file from disk

Arguments

• path - Path to the pairing file (typically a .plist file)

Returns

A parsed PairingFile on success

Errors

Returns IdeviceError if:

• The file cannot be read
• The contents are malformed
• Cryptographic materials are invalid

pub fn from_bytes(bytes: &[u8]) -> Result<Self, IdeviceError>

Parses a pairing file from raw bytes

Arguments

• bytes - Raw bytes of the pairing file (typically PLIST format)

Returns

A parsed PairingFile on success

Errors

Returns IdeviceError if:

• The data cannot be parsed as PLIST
• Required fields are missing
• Cryptographic materials are invalid

pub fn from_value(v: &Value) -> Result<Self, IdeviceError>

Creates a pairing file from a plist value

Arguments

• v - PLIST value containing pairing data

Returns

A parsed PairingFile on success

Errors

Returns IdeviceError if:

• Required fields are missing
• Cryptographic materials are invalid

pub fn serialize(self) -> Result<Vec<u8>, IdeviceError>

Serializes the pairing file to a PLIST-formatted byte vector

Returns

A byte vector containing the serialized pairing file

Errors

Returns IdeviceError if serialization fails

Trait Implementations

impl Clone for PairingFile

fn clone(&self) -> PairingFile

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PairingFile

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.