Trap Mach#-61
svc · mach trap -61
thread_switch
Cède le reliquat de quantum à un thread désigné, éventuellement avec un délai de dépression.
Prototype
kern_return_t thread_switch(/* 3 args */);Retour: kern_return_t
Historique des versions
| XNU tag | macOS | # |
|---|---|---|
| xnu-123.5 | macOS 10.0 Cheetah | -60 |
| xnu-201 | macOS 10.1 Puma | -60 |
| xnu-344 | macOS 10.2 Jaguar | -60 |
| xnu-517 | macOS 10.3 Panther | -60 |
| xnu-792 | macOS 10.4 Tiger | -61 |
| xnu-1228 | macOS 10.5 Leopard | -61 |
| xnu-1456.1.26 | macOS 10.6 Snow Leopard | -61 |
| xnu-1699.24.8 | macOS 10.7 Lion | -61 |
| xnu-2050.18.24 | macOS 10.8 Mountain Lion | -61 |
| xnu-2422.115.4 | macOS 10.9 Mavericks | -61 |
| xnu-2782.40.9 | macOS 10.10 Yosemite | -61 |
| xnu-3247.1.106 | macOS 10.11 El Capitan | -61 |
| xnu-3789.1.32 | macOS 10.12 Sierra | -61 |
| xnu-4570.1.46 | macOS 10.13 High Sierra | -61 |
| xnu-4903.221.2 | macOS 10.14 Mojave | -61 |
| xnu-6153.11.26 | macOS 10.15 Catalina | -61 |
| xnu-7195.50.7.100.1 | macOS 11.0 Big Sur | -61 |
| xnu-8019.41.5 | macOS 12.0 Monterey | -61 |
| xnu-8792.41.9 | macOS 13.0 Ventura | -61 |
| xnu-10002.1.13 | macOS 14.0 Sonoma | -61 |
| xnu-11215.1.10 | macOS 15.0 Sequoia | -61 |
| xnu-11417.101.15 | macOS 15.4 Sequoia | -61 |
| xnu-12377.1.9 | macOS 26.0 Tahoe | -61 |
| xnu-10002.41.9 | — | -61 |
| xnu-10002.61.3 | — | -61 |
| xnu-10002.81.5 | — | -61 |
| xnu-10063.101.15 | — | -61 |
| xnu-10063.121.3 | — | -61 |
| xnu-10063.141.1 | — | -61 |
| xnu-11215.41.3 | — | -61 |
| xnu-11215.61.5 | — | -61 |
| xnu-11215.81.4 | — | -61 |
| xnu-11417.121.6 | — | -61 |
| xnu-11417.140.69 | — | -61 |
| xnu-1228.0.2 | — | -61 |
| xnu-1228.12.14 | — | -61 |
| xnu-1228.15.4 | — | -61 |
| xnu-1228.3.13 | — | -61 |
| xnu-1228.5.18 | — | -61 |
| xnu-1228.5.20 | — | -61 |
| xnu-1228.7.58 | — | -61 |
| xnu-1228.9.59 | — | -61 |
| xnu-12377.101.15 | — | -61 |
| xnu-12377.41.6 | — | -61 |
| xnu-12377.61.12 | — | -61 |
| xnu-12377.81.4 | — | -61 |
| xnu-124.1 | — | -60 |
| xnu-124.13 | — | -60 |
| xnu-124.7 | — | -60 |
| xnu-1486.2.11 | — | -61 |
| xnu-1504.15.3 | — | -61 |
| xnu-1504.3.12 | — | -61 |
| xnu-1504.7.4 | — | -61 |
| xnu-1504.9.17 | — | -61 |
| xnu-1504.9.26 | — | -61 |
| xnu-1504.9.37 | — | -61 |
| xnu-1699.22.73 | — | -61 |
| xnu-1699.22.81 | — | -61 |
| xnu-1699.24.23 | — | -61 |
| xnu-1699.26.8 | — | -61 |
| xnu-1699.32.7 | — | -61 |
| xnu-201.14 | — | -60 |
| xnu-201.19 | — | -60 |
| xnu-201.19.3 | — | -60 |
| xnu-201.42.3 | — | -60 |
| xnu-201.5 | — | -60 |
| xnu-2050.22.13 | — | -61 |
| xnu-2050.24.15 | — | -61 |
| xnu-2050.48.11 | — | -61 |
| xnu-2050.7.9 | — | -61 |
| xnu-2050.9.2 | — | -61 |
| xnu-2422.1.72 | — | -61 |
| xnu-2422.100.13 | — | -61 |
| xnu-2422.110.17 | — | -61 |
| xnu-2422.90.20 | — | -61 |
| xnu-2782.1.97 | — | -61 |
| xnu-2782.10.72 | — | -61 |
| xnu-2782.20.48 | — | -61 |
| xnu-2782.30.5 | — | -61 |
| xnu-3247.10.11 | — | -61 |
| xnu-3248.20.55 | — | -61 |
| xnu-3248.30.4 | — | -61 |
| xnu-3248.40.184 | — | -61 |
| xnu-3248.50.21 | — | -61 |
| xnu-3248.60.10 | — | -61 |
| xnu-344.12.2 | — | -60 |
| xnu-344.2 | — | -60 |
| xnu-344.21.73 | — | -60 |
| xnu-344.21.74 | — | -60 |
| xnu-344.23 | — | -60 |
| xnu-344.26 | — | -60 |
| xnu-344.32 | — | -60 |
| xnu-344.34 | — | -60 |
| xnu-344.49 | — | -60 |
| xnu-3789.21.4 | — | -61 |
| xnu-3789.31.2 | — | -61 |
| xnu-3789.41.3 | — | -61 |
| xnu-3789.51.2 | — | -61 |
| xnu-3789.60.24 | — | -61 |
| xnu-3789.70.16 | — | -61 |
| xnu-4570.20.62 | — | -61 |
| xnu-4570.31.3 | — | -61 |
| xnu-4570.41.2 | — | -61 |
| xnu-4570.51.1 | — | -61 |
| xnu-4570.61.1 | — | -61 |
| xnu-4570.71.2 | — | -61 |
| xnu-4903.231.4 | — | -61 |
| xnu-4903.241.1 | — | -61 |
| xnu-4903.270.47 | — | -61 |
| xnu-517.11.1 | — | -60 |
| xnu-517.12.7 | — | -60 |
| xnu-517.3.15 | — | -60 |
| xnu-517.3.7 | — | -60 |
| xnu-517.7.21 | — | -60 |
| xnu-517.7.7 | — | -60 |
| xnu-517.9.4 | — | -60 |
| xnu-517.9.5 | — | -60 |
| xnu-6153.101.6 | — | -61 |
| xnu-6153.121.1 | — | -61 |
| xnu-6153.141.1 | — | -61 |
| xnu-6153.41.3 | — | -61 |
| xnu-6153.61.1 | — | -61 |
| xnu-6153.81.5 | — | -61 |
| xnu-7195.101.1 | — | -61 |
| xnu-7195.121.3 | — | -61 |
| xnu-7195.141.2 | — | -61 |
| xnu-7195.60.75 | — | -61 |
| xnu-7195.81.3 | — | -61 |
| xnu-792.1.5 | — | -61 |
| xnu-792.10.96 | — | -61 |
| xnu-792.12.6 | — | -61 |
| xnu-792.13.8 | — | -61 |
| xnu-792.17.14 | — | -61 |
| xnu-792.18.15 | — | -61 |
| xnu-792.2.4 | — | -61 |
| xnu-792.21.3 | — | -61 |
| xnu-792.22.5 | — | -61 |
| xnu-792.24.17 | — | -61 |
| xnu-792.25.20 | — | -61 |
| xnu-792.6.22 | — | -61 |
| xnu-792.6.56 | — | -61 |
| xnu-792.6.61 | — | -61 |
| xnu-792.6.70 | — | -61 |
| xnu-792.6.76 | — | -61 |
| xnu-8019.61.5 | — | -61 |
| xnu-8019.80.24 | — | -61 |
| xnu-8020.101.4 | — | -61 |
| xnu-8020.121.3 | — | -61 |
| xnu-8020.140.41 | — | -61 |
| xnu-8792.61.2 | — | -61 |
| xnu-8792.81.2 | — | -61 |
| xnu-8796.101.5 | — | -61 |
| xnu-8796.121.2 | — | -61 |
| xnu-8796.141.3 | — | -61 |
Exemples
Yield with priority depression
#include <mach/thread_act.h>
#include <mach/thread_switch.h>
// Yield for up to 1ms, lowering our priority
thread_switch(THREAD_NULL, SWITCH_OPTION_DEPRESS, 1);
Notes
thread_switch permet à l'appelant d'indiquer un transfert direct vers un autre thread par nom de port, avec des options comme SWITCH_OPTION_DEPRESS (abaisse la priorité de l'appelant pendant option_time ms) ou SWITCH_OPTION_WAIT (bloque pendant le délai). C'est la base des chemins de contention des mutex pthread et du handoff de continuations de dispatch. Passer THREAD_NULL équivaut à un simple yield comme swtch.
Détection
DTrace mach_trap:::entry avec probefunc == "thread_switch" capture le port cible et les options. Aucun événement Endpoint Security n'existe.
API associées
swtchswtch_prithread_policy_setpthread_yield_npsched_yield