Provides access to the DVT (DTX Instruments) services exposed by Apple's ``instruments`` daemon. The provider opens a `DTXConnection` on

Raised when the remote DTX stream violates the protocol invariants.

Raised for WebDriverAgent (WDA) errors.

Query device, process, filesystem and kernel information over the `com.apple.instruments.server.services.deviceinfo` DTX channel. Constr

Raise when a connection is terminated abruptly.

Accumulates the non-first fragments of a multi-fragment DTX message. The first fragment (index=0, count>1) declares the *total* assembled payload

A preset rule selecting backup files by `domain` and `relative_path` (e.g. SMS, contacts).

Wraps an Objective-C NSError object received from the remote DTX peer.

Manage configuration profiles and cloud (supervision) configuration. Wraps the ``com.apple.mobile.MCInstall`` lockdown service used by MDM/A

Apple File Connection (AFC) Service for iOS device file system access. This service provides full file system access to the /var/mobile/Medi

Identifies a single backup file passed to a filter callback; fields are populated according to context.

Manage crash reports stored on a device. Wraps the ``com.apple.crashreportcopymobile`` AFC service (for listing, reading, pulling and er

Client for the ``com.apple.mobile.installation_proxy`` lockdown service. Provides access to the device's application installation database:

Feature has not been implemented for OS.

Client for the `com.apple.mobilebackup2` service, the iTunes/Finder-style device backup protocol. Drives full and incremental backups, resto

Launch, terminate and observe processes on the device through the DVT ``processcontrol`` instruments service. Backed by `ProcessControlS

Client for the ``com.apple.springboardservices`` lockdown service. Exposes SpringBoard operations such as reading and writing the home scree

Drive the device's accessibility audit daemon over DTX. Provides access to accessibility capabilities and settings, on-device audits, the el

Client for the device's ``diagnostics_relay`` lockdown service. Exposes the diagnostics relay over a plist request/response channel, allowin

asyncio.Queue with shutdown support on Python versions before 3.13.

Query media-streaming capabilities (video/audio/screenshot streams).

r""" Kdebug is a kernel facility for tracing events occurring on a system. This header defines reserved debugids, which are 32-bit values that

Client for the ``com.apple.mobile.mobile_image_mounter`` lockdown service. Provides the low-level operations for mounting and unmounting dis

One on-device shape of a prefetchable peripheral's TSS state. A chip may expose more than one shape (e.g. Savage is a flat ``Savage,*`` entry on

Metadata and optional body for one DTX protocol fragment.

Post and observe Darwin notifications on the device via the notification proxy lockdown service. Allows sending notifications to the device,

A peripheral whose TSS ticket can be prefetched in the batched ``--tss-batch`` POST.

Service provider for the iOS 17+ RemoteServiceDiscovery (RSD) endpoint exposed over a tunnel. On modern devices, services are no longer star

Induce simulated device conditions (such as degraded network or thermal states) via the Instruments ConditionInducer channel. Constructe

Manage provisioning profiles installed on the device. Wraps the ``com.apple.misagent`` lockdown service to install, remove and enumerate

Mobile activation can not be done

A single decoded log line from the device's activity stream. Produced by `parse_syslog_entry` and yielded by `syslog`. Bundles the emitt

Manage applications

Read and write device configuration knobs exposed over CoreDevice: appearance (dark/light), liquid-glass opacity, and the accessibility knobs

Fully assembled DTX message ready for channel dispatch. The ``aux_data`` and ``payload_data`` fields hold the raw wire bytes. Use the :attr:`

Override the device's reported GPS location over the `com.apple.instruments.server.services.LocationSimulation` DTX channel. Constructed

Drive iOS device activation against Apple's activation servers via ``com.apple.mobileactivationd``. Orchestrates the full activation handsha

Client for the device's ``com.apple.os_trace_relay`` service. Provides API for the following operations: * List the running processes (

Inspect and drive the device's registered HID surfaces. The device exposes a small set of pre-registered surfaces (e.g. the real touchscreen

DTX transport to ``testmanagerd``. Registers the three XCTest service classes so the connection can instantiate them when either side opens a

Apple AudioToolbox AAC-ELD -> s16le 48 kHz stereo PCM converter. macOS only. Each call to :meth:`decode` consumes ONE AAC-ELD AU and emits its

Raised when NSCoding (de)serialization fails for a message payload or auxiliary arguments.

Query device information

Client for the `com.apple.dt.fetchsymbols` developer service. Lists and downloads the device's shared cache (DSC) symbol files, used by debu

Generic HID events (currently: hardware buttons).

List subclass that preserves NSMutableArray NSKeyedArchive encoding. bpylist2 normally encodes Python ``list`` as NSArray. Some private DVT

Client for the device pasteboard (``com.apple.coredevice.pasteboardservice``).

Raised when operating on a shut down DTXQueue.

Client for the `com.apple.dt.remoteFetchSymbols` RemoteXPC service (RSD/CoreDevice). Lists the device's dyld shared cache (DSC) files and do

wrapper for tcp-relay connections

Client for the `com.apple.webinspector` service (`webinspectord`). Drives Safari/WebKit remote inspection and WebDriver automation: enumerates in

Orchestrates an XCUITest run using :class:`DTXConnection`. Service name selection is handled by :class:`_TestManagerProvider` and :class:`_Dv

Need extra permissions to execute this command

Given image for mount has already been mounted in the first place

Logical DTX channel. Each channel owns an asyncio message queue and a reader task that dequeues messages and dispatches them to the appropria

Scoped context dictionary threading state through a DTX connection. Entries in a child context shadow those in the parent; missing keys fall

Mounter for the classic (pre-iOS 17) ``Developer`` Disk Image.

Claim and release exclusive use of a device via the ``com.apple.dt.devicearbitration`` service. Device arbitration lets a host check a devic

Client for the `com.apple.dt.simulatelocation` developer service. Overrides the device's reported GPS location with a fixed coordinate, or c

Filesystem control

Query and set the device's IDAM configuration via the ``com.apple.idamd`` lockdown service. Exposes reading the current IDAM configuration a

Proxy for Objective-C ``NSURL``.

Given image for umount wasn't mounted in the first place

Static information a pairable host advertises over mDNS and presents to a connecting device. ``name`` and ``model`` are what the device

Mounter for the ``Personalized`` Developer Disk Image used on iOS 17 and later.

The requested action requires an RSD object

Stream the device's live system log via the ``com.apple.syslog_relay`` service. The service name used depends on the lockdown type (legacy `

Proxy for XCTest's ``XCTCapabilities`` dictionary wrapper.

Tap the device's unified-logging / activity-trace stream over the Instruments channel. Constructed with a `DvtProvider`. It is an async-iter

Control Developer Mode on the device through the AMFI (Apple Mobile File Integrity) lockdown service. Each method opens its own connection t

Enumerate the applications installed on the device over the `com.apple.instruments.server.services.device.applictionListing` DTX channel.