AlfaMacDriver is experimental privileged hardware software. Treat memory-safety issues, IOUserClient boundary errors, firmware-validation weaknesses, lifecycle races, and injection-policy bypasses as security issues.

Use the hosting platform's private security-reporting feature when available. Otherwise, contact the repository owner privately before publishing complete technical details.

Include, when possible:

Affected revision
macOS and Xcode major/minor versions
Architecture and a generic machine description
Adapter VID/PID
Minimal reproduction steps
Expected and actual behavior
Sanitizer or crash output
Whether real radio transmission occurred

Do not attach signing keys, provisioning profiles, account identifiers, device serial numbers, hardware UUIDs, absolute home paths, private captures, or network credentials.

The DriverKit user client uses explicit dispatch tables and rejects unexpected scalar values, asynchronous completions, and unsupported memory-descriptor forms. ExternalMethod also requires the current IOUserClientMethodArguments ABI version and requires the selector in the argument structure to match the selector used for dispatch. Variable capture output is mapped only for the validated output size before copying.

The main branch is the currently supported research line. No response time is guaranteed. Do not use the project on a production machine or on a network for which testing has not been explicitly authorized.

The repository local-build scripts do not disable SIP, change Startup Security, enable system-extension developer mode, install firmware, or activate the DriverKit extension automatically.

Local ad-hoc builds are limited to isolated development systems and must not be published as binary releases.

See Documentation/LOCAL_ADHOC_INSTALL.md for the supported security, signing, installation, verification, and removal workflow.