Skip to content
Mach trap#-27

svc · mach trap -27

thread_self_trap

Returns the send right naming the caller's own thread control port — the value behind mach_thread_self().

Prototype

kern_return_t thread_self_trap(/* 0 args */);

Returns: kern_return_t

Version history

XNU tagmacOS#
xnu-123.5macOS 10.0 Cheetah-26
xnu-201macOS 10.1 Puma-26
xnu-344macOS 10.2 Jaguar-26
xnu-517macOS 10.3 Panther-26
xnu-792macOS 10.4 Tiger-27
xnu-1228macOS 10.5 Leopard-27
xnu-1456.1.26macOS 10.6 Snow Leopard-27
xnu-1699.24.8macOS 10.7 Lion-27
xnu-2050.18.24macOS 10.8 Mountain Lion-27
xnu-2422.115.4macOS 10.9 Mavericks-27
xnu-2782.40.9macOS 10.10 Yosemite-27
xnu-3247.1.106macOS 10.11 El Capitan-27
xnu-3789.1.32macOS 10.12 Sierra-27
xnu-4570.1.46macOS 10.13 High Sierra-27
xnu-4903.221.2macOS 10.14 Mojave-27
xnu-6153.11.26macOS 10.15 Catalina-27
xnu-7195.50.7.100.1macOS 11.0 Big Sur-27
xnu-8019.41.5macOS 12.0 Monterey-27
xnu-8792.41.9macOS 13.0 Ventura-27
xnu-10002.1.13macOS 14.0 Sonoma-27
xnu-11215.1.10macOS 15.0 Sequoia-27
xnu-11417.101.15macOS 15.4 Sequoia-27
xnu-12377.1.9macOS 26.0 Tahoe-27
xnu-10002.41.9—-27
xnu-10002.61.3—-27
xnu-10002.81.5—-27
xnu-10063.101.15—-27
xnu-10063.121.3—-27
xnu-10063.141.1—-27
xnu-11215.41.3—-27
xnu-11215.61.5—-27
xnu-11215.81.4—-27
xnu-11417.121.6—-27
xnu-11417.140.69—-27
xnu-1228.0.2—-27
xnu-1228.12.14—-27
xnu-1228.15.4—-27
xnu-1228.3.13—-27
xnu-1228.5.18—-27
xnu-1228.5.20—-27
xnu-1228.7.58—-27
xnu-1228.9.59—-27
xnu-12377.101.15—-27
xnu-12377.41.6—-27
xnu-12377.61.12—-27
xnu-12377.81.4—-27
xnu-124.1—-26
xnu-124.13—-26
xnu-124.7—-26
xnu-1486.2.11—-27
xnu-1504.15.3—-27
xnu-1504.3.12—-27
xnu-1504.7.4—-27
xnu-1504.9.17—-27
xnu-1504.9.26—-27
xnu-1504.9.37—-27
xnu-1699.22.73—-27
xnu-1699.22.81—-27
xnu-1699.24.23—-27
xnu-1699.26.8—-27
xnu-1699.32.7—-27
xnu-201.14—-26
xnu-201.19—-26
xnu-201.19.3—-26
xnu-201.42.3—-26
xnu-201.5—-26
xnu-2050.22.13—-27
xnu-2050.24.15—-27
xnu-2050.48.11—-27
xnu-2050.7.9—-27
xnu-2050.9.2—-27
xnu-2422.1.72—-27
xnu-2422.100.13—-27
xnu-2422.110.17—-27
xnu-2422.90.20—-27
xnu-2782.1.97—-27
xnu-2782.10.72—-27
xnu-2782.20.48—-27
xnu-2782.30.5—-27
xnu-3247.10.11—-27
xnu-3248.20.55—-27
xnu-3248.30.4—-27
xnu-3248.40.184—-27
xnu-3248.50.21—-27
xnu-3248.60.10—-27
xnu-344.12.2—-26
xnu-344.2—-26
xnu-344.21.73—-26
xnu-344.21.74—-26
xnu-344.23—-26
xnu-344.26—-26
xnu-344.32—-26
xnu-344.34—-26
xnu-344.49—-26
xnu-3789.21.4—-27
xnu-3789.31.2—-27
xnu-3789.41.3—-27
xnu-3789.51.2—-27
xnu-3789.60.24—-27
xnu-3789.70.16—-27
xnu-4570.20.62—-27
xnu-4570.31.3—-27
xnu-4570.41.2—-27
xnu-4570.51.1—-27
xnu-4570.61.1—-27
xnu-4570.71.2—-27
xnu-4903.231.4—-27
xnu-4903.241.1—-27
xnu-4903.270.47—-27
xnu-517.11.1—-26
xnu-517.12.7—-26
xnu-517.3.15—-26
xnu-517.3.7—-26
xnu-517.7.21—-26
xnu-517.7.7—-26
xnu-517.9.4—-26
xnu-517.9.5—-26
xnu-6153.101.6—-27
xnu-6153.121.1—-27
xnu-6153.141.1—-27
xnu-6153.41.3—-27
xnu-6153.61.1—-27
xnu-6153.81.5—-27
xnu-7195.101.1—-27
xnu-7195.121.3—-27
xnu-7195.141.2—-27
xnu-7195.60.75—-27
xnu-7195.81.3—-27
xnu-792.1.5—-27
xnu-792.10.96—-27
xnu-792.12.6—-27
xnu-792.13.8—-27
xnu-792.17.14—-27
xnu-792.18.15—-27
xnu-792.2.4—-27
xnu-792.21.3—-27
xnu-792.22.5—-27
xnu-792.24.17—-27
xnu-792.25.20—-27
xnu-792.6.22—-27
xnu-792.6.56—-27
xnu-792.6.61—-27
xnu-792.6.70—-27
xnu-792.6.76—-27
xnu-8019.61.5—-27
xnu-8019.80.24—-27
xnu-8020.101.4—-27
xnu-8020.121.3—-27
xnu-8020.140.41—-27
xnu-8792.61.2—-27
xnu-8792.81.2—-27
xnu-8796.101.5—-27
xnu-8796.121.2—-27
xnu-8796.141.3—-27

Notes

Each call allocates a fresh send right ref against the thread port, so the canonical idiom is mach_thread_self() followed by mach_port_deallocate(mach_task_self(), tport) to avoid leaking refs. The thread control port grants thread_set_state, thread_suspend, thread_terminate and similar primitives, making it a high-value target for in-process exploitation and the foundation of pthread_kill and the libpthread teardown path. On modern macOS the thread port is pinned for the lifetime of the thread.

Detection

Per-thread frequency; DTrace mach_trap::thread_self_trap:entry is the observation point. Not exposed via Endpoint Security.

Related APIs

task_self_trapthread_get_special_reply_portthread_set_statethread_suspend