Skip to content
Trap Mach#-24

svc · mach trap -24

_kernelrpc_mach_port_construct_trap

Point d'entrée trap qui implémente mach_port_construct — crée atomiquement un port avec garde, limite de file et autres attributs optionnels.

Prototype

kern_return_t _kernelrpc_mach_port_construct_trap(/* 4 args */);

Retour: kern_return_t

Historique des versions

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

Notes

Là où mach_port_allocate retourne un receive right brut, mach_port_construct prend un mach_port_options_t décrivant l'appartenance à un port set, la limite de file, le contexte, l'abonnement no-senders, le comportement d'héritage d'importance et une valeur de garde optionnelle. L'atomicité est essentielle : elle supprime la fenêtre TOCTOU qui existait entre allocation et configuration et qui exposait à d'autres threads des ports à moitié configurés. libxpc, libdispatch et les services XPC modernes l'utilisent quasi exclusivement pour leurs nouveaux receive rights.

Détection

DTrace mach_trap::_kernelrpc_mach_port_construct_trap:entry est la seule sonde directe ; le trap est invisible pour Endpoint Security. Les flags MPO_CONTEXT_AS_GUARD et MPO_STRICT de la structure d'options sont des signaux utiles lors du reverse engineering de daemons durcis.

API associées

_kernelrpc_mach_port_destruct_trap_kernelrpc_mach_port_allocate_trap_kernelrpc_mach_port_guard_trapmach_port_construct