Skip to content
Mach trap#-41

svc · mach trap -41

_kernelrpc_mach_port_guard_trap

Trap-level entry point that backs mach_port_guard — attaches a 64-bit guard value to a receive right so misuse triggers EXC_GUARD.

Prototype

kern_return_t _kernelrpc_mach_port_guard_trap(/* 4 args */);

Returns: kern_return_t

Version history

XNU tagmacOS#
xnu-2422.115.4macOS 10.9 Mavericks-41
xnu-2782.40.9macOS 10.10 Yosemite-41
xnu-3247.1.106macOS 10.11 El Capitan-41
xnu-3789.1.32macOS 10.12 Sierra-41
xnu-4570.1.46macOS 10.13 High Sierra-41
xnu-4903.221.2macOS 10.14 Mojave-41
xnu-6153.11.26macOS 10.15 Catalina-41
xnu-7195.50.7.100.1macOS 11.0 Big Sur-41
xnu-8019.41.5macOS 12.0 Monterey-41
xnu-8792.41.9macOS 13.0 Ventura-41
xnu-10002.1.13macOS 14.0 Sonoma-41
xnu-11215.1.10macOS 15.0 Sequoia-41
xnu-11417.101.15macOS 15.4 Sequoia-41
xnu-12377.1.9macOS 26.0 Tahoe-41
xnu-10002.41.9—-41
xnu-10002.61.3—-41
xnu-10002.81.5—-41
xnu-10063.101.15—-41
xnu-10063.121.3—-41
xnu-10063.141.1—-41
xnu-11215.41.3—-41
xnu-11215.61.5—-41
xnu-11215.81.4—-41
xnu-11417.121.6—-41
xnu-11417.140.69—-41
xnu-12377.101.15—-41
xnu-12377.41.6—-41
xnu-12377.61.12—-41
xnu-12377.81.4—-41
xnu-2422.1.72—-41
xnu-2422.100.13—-41
xnu-2422.110.17—-41
xnu-2422.90.20—-41
xnu-2782.1.97—-41
xnu-2782.10.72—-41
xnu-2782.20.48—-41
xnu-2782.30.5—-41
xnu-3247.10.11—-41
xnu-3248.20.55—-41
xnu-3248.30.4—-41
xnu-3248.40.184—-41
xnu-3248.50.21—-41
xnu-3248.60.10—-41
xnu-3789.21.4—-41
xnu-3789.31.2—-41
xnu-3789.41.3—-41
xnu-3789.51.2—-41
xnu-3789.60.24—-41
xnu-3789.70.16—-41
xnu-4570.20.62—-41
xnu-4570.31.3—-41
xnu-4570.41.2—-41
xnu-4570.51.1—-41
xnu-4570.61.1—-41
xnu-4570.71.2—-41
xnu-4903.231.4—-41
xnu-4903.241.1—-41
xnu-4903.270.47—-41
xnu-6153.101.6—-41
xnu-6153.121.1—-41
xnu-6153.141.1—-41
xnu-6153.41.3—-41
xnu-6153.61.1—-41
xnu-6153.81.5—-41
xnu-7195.101.1—-41
xnu-7195.121.3—-41
xnu-7195.141.2—-41
xnu-7195.60.75—-41
xnu-7195.81.3—-41
xnu-8019.61.5—-41
xnu-8019.80.24—-41
xnu-8020.101.4—-41
xnu-8020.121.3—-41
xnu-8020.140.41—-41
xnu-8792.61.2—-41
xnu-8792.81.2—-41
xnu-8796.101.5—-41
xnu-8796.121.2—-41
xnu-8796.141.3—-41

Notes

Once guarded, the receive right cannot be deallocated, destroyed, modified, or moved without the caller presenting the exact same guard token; mismatches generate a kGUARD_EXC_* exception that, in strict mode, terminates the process. libdispatch and libxpc guard their internal mach ports so application code (or an in-process attacker) cannot accidentally or maliciously yank them out from under the runtime. The MPG_STRICT flag makes the guard fatal on any violation; without it, mismatches simply return KERN_INVALID_ARGUMENT.

Detection

DTrace mach_trap probe only. EXC_GUARD crashes with port-related subtypes are the loudest detection signal — they are written to ReportCrash and forwarded via the unified log subsystem com.apple.xpc.

Related APIs

_kernelrpc_mach_port_unguard_trap_kernelrpc_mach_port_construct_trap_kernelrpc_mach_port_destruct_trapmach_port_guard