1 /* 2 * Copyright (c) 2016 Apple Inc. All rights reserved. 3 * 4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@ 5 * 6 * This file contains Original Code and/or Modifications of Original Code 7 * as defined in and that are subject to the Apple Public Source License 8 * Version 2.0 (the 'License'). You may not use this file except in 9 * compliance with the License. The rights granted to you under the License 10 * may not be used to create, or enable the creation or redistribution of, 11 * unlawful or unlicensed copies of an Apple operating system, or to 12 * circumvent, violate, or enable the circumvention or violation of, any 13 * terms of an Apple operating system software license agreement. 14 * 15 * Please obtain a copy of the License at 16 * http://www.opensource.apple.com/apsl/ and read it before using this file. 17 * 18 * The Original Code and all software distributed under the License are 19 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER 20 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, 21 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, 22 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. 23 * Please see the License for the specific language governing rights and 24 * limitations under the License. 25 * 26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@ 27 */ 28 29 /* 30 * Thread group support routines. 31 */ 32 #ifndef _KERN_THREAD_GROUP_H_ 33 #define _KERN_THREAD_GROUP_H_ 34 35 struct thread_group; 36 37 #include <mach/thread_status.h> /* for proc_reg.h / CONFIG_THREAD_GROUPS */ 38 39 #ifndef CONFIG_THREAD_GROUPS 40 #error "The platform must define CONFIG_THREAD_GROUPS to 0 or 1" 41 #endif 42 43 #if CONFIG_THREAD_GROUPS 44 #include <kern/assert.h> 45 #include <kern/queue.h> 46 #include <machine/machine_routines.h> 47 48 #define THREAD_GROUP_MAX (CONFIG_TASK_MAX + 10) 49 #define THREAD_GROUP_MAXNAME (32) 50 51 #define THREAD_GROUP_SYSTEM 0 // kernel (-VM) + launchd 52 #define THREAD_GROUP_BACKGROUND 1 // background daemons 53 #define THREAD_GROUP_VM 3 // kernel VM threads 54 #define THREAD_GROUP_IO_STORAGE 4 // kernel io storage threads 55 #define THREAD_GROUP_PERF_CONTROLLER 5 // kernel CLPC threads 56 57 #define THREAD_GROUP_INVALID UINT64_MAX 58 59 /* Thread group flags */ 60 61 /* Flags in the bottom 8 bits are exclusive. */ 62 #define THREAD_GROUP_EXCLUSIVE_FLAGS_MASK 0xff 63 64 /* Exclusive flags */ 65 #define THREAD_GROUP_FLAGS_DEFAULT 0x0 66 #define THREAD_GROUP_FLAGS_EFFICIENT 0x1 67 #define THREAD_GROUP_FLAGS_APPLICATION 0x2 68 #define THREAD_GROUP_FLAGS_CRITICAL 0x4 69 #define THREAD_GROUP_FLAGS_BEST_EFFORT 0x8 70 71 /* Shared flags */ 72 #define THREAD_GROUP_FLAGS_UI_APP 0x100 73 #define THREAD_GROUP_FLAGS_MANAGED 0x200 74 75 76 #define THREAD_GROUP_FLAGS_EXCLUSIVE ( \ 77 THREAD_GROUP_FLAGS_EFFICIENT | \ 78 THREAD_GROUP_FLAGS_APPLICATION | \ 79 THREAD_GROUP_FLAGS_CRITICAL | \ 80 THREAD_GROUP_FLAGS_BEST_EFFORT) 81 82 #define THREAD_GROUP_FLAGS_ABSENT 0xffffffff 83 84 static_assert( 85 (THREAD_GROUP_FLAGS_EXCLUSIVE & ~THREAD_GROUP_EXCLUSIVE_FLAGS_MASK) == 0, 86 "valid exclusive flags"); 87 88 /* Shared flags */ 89 #define THREAD_GROUP_FLAGS_SHARED ( \ 90 THREAD_GROUP_FLAGS_UI_APP | \ 91 THREAD_GROUP_FLAGS_MANAGED) 92 93 static_assert( 94 (THREAD_GROUP_FLAGS_SHARED & THREAD_GROUP_EXCLUSIVE_FLAGS_MASK) == 0, 95 "valid shared flags"); 96 97 __BEGIN_DECLS 98 99 void thread_group_init(void); 100 void thread_group_resync(boolean_t create); 101 struct thread_group *thread_group_create_and_retain(uint32_t flags); 102 void thread_group_init_thread(thread_t t, task_t task); 103 void thread_group_set_name(struct thread_group *tg, const char *name); 104 void thread_group_flags_update_lock(void); 105 void thread_group_flags_update_unlock(void); 106 void thread_group_set_flags(struct thread_group *tg, uint32_t flags); 107 uint32_t thread_group_get_flags(struct thread_group *); 108 void thread_group_clear_flags(struct thread_group *tg, uint32_t flags); 109 void thread_group_set_flags_locked(struct thread_group *tg, uint32_t flags); 110 void thread_group_clear_flags_locked(struct thread_group *tg, uint32_t flags); 111 boolean_t thread_group_valid_flags(uint32_t flags); 112 struct thread_group *thread_group_find_by_name_and_retain(char *name); 113 struct thread_group *thread_group_find_by_id_and_retain(uint64_t id); 114 struct thread_group *thread_group_retain(struct thread_group *tg); 115 void thread_group_release(struct thread_group *tg); 116 void thread_group_release_live(struct thread_group *tg); 117 void thread_group_deallocate_safe(struct thread_group *tg); 118 struct thread_group *thread_group_get(thread_t t); 119 struct thread_group *thread_group_get_home_group(thread_t t); 120 void thread_group_set_bank(thread_t t, struct thread_group *tg); 121 uint64_t thread_group_get_id(struct thread_group *tg); 122 uint32_t thread_group_count(void); 123 const char * thread_group_get_name(struct thread_group *tg); 124 void * thread_group_get_machine_data(struct thread_group *tg); 125 uint32_t thread_group_machine_data_size(void); 126 boolean_t thread_group_uses_immediate_ipi(struct thread_group *tg); 127 cluster_type_t thread_group_recommendation(struct thread_group *tg); 128 129 typedef void (*thread_group_iterate_fn_t)(void*, int, struct thread_group *); 130 kern_return_t thread_group_iterate_stackshot(thread_group_iterate_fn_t callout, void *arg); 131 void thread_group_update_recommendation(struct thread_group *tg, cluster_type_t new_recommendation); 132 uint64_t thread_group_id(struct thread_group *tg); 133 134 void thread_set_work_interval_thread_group(thread_t t, struct thread_group *tg); 135 #if CONFIG_SCHED_AUTO_JOIN 136 void thread_set_autojoin_thread_group_locked(thread_t t, struct thread_group *tg); 137 #endif 138 #if CONFIG_PREADOPT_TG 139 void thread_set_preadopt_thread_group(thread_t t, struct thread_group *tg); 140 #endif 141 142 void thread_resolve_and_enforce_thread_group_hierarchy_if_needed(thread_t t); 143 144 #if XNU_KERNEL_PRIVATE 145 void thread_group_vm_add(void); 146 #endif 147 148 __END_DECLS 149 150 #endif /* CONFIG_THREAD_GROUPS */ 151 152 #endif // _KERN_THREAD_GROUP_H_ 153