1 /* 2 * Copyright (c) 2017 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 #ifndef _KERN_WORK_INTERVAL_H_ 30 #define _KERN_WORK_INTERVAL_H_ 31 32 #include <sys/cdefs.h> 33 34 #include <stdint.h> 35 #include <kern/kern_types.h> 36 37 #include <kern/thread_group.h> 38 39 __BEGIN_DECLS 40 41 struct work_interval; 42 43 struct kern_work_interval_args { 44 uint64_t work_interval_id; 45 uint64_t start; 46 uint64_t finish; 47 uint64_t deadline; 48 uint64_t next_start; 49 uint32_t notify_flags; 50 uint32_t create_flags; 51 uint16_t urgency; 52 }; 53 54 struct kern_work_interval_create_args { 55 uint64_t wica_id; /* out param */ 56 mach_port_name_t wica_port; /* out param */ 57 uint32_t wica_create_flags; 58 }; 59 60 struct kern_work_interval_workload_id_args { 61 uint32_t wlida_flags; /* in/out param */ 62 uint32_t wlida_wicreate_flags; /* in/out param */ 63 char * wlida_name; /* in param */ 64 uint64_t wlida_syscall_mask[2]; /* out param */ 65 }; 66 67 /* 68 * Allocate/assign a single work interval ID for a thread, 69 * and support deallocating it. 70 */ 71 extern kern_return_t 72 kern_work_interval_create(thread_t thread, struct kern_work_interval_create_args *create_params); 73 74 extern kern_return_t 75 kern_work_interval_get_flags_from_port(mach_port_name_t port_name, uint32_t*flags); 76 77 extern kern_return_t 78 kern_work_interval_destroy(thread_t thread, uint64_t work_interval_id); 79 extern kern_return_t 80 kern_work_interval_join(thread_t thread, mach_port_name_t port_name); 81 82 extern kern_return_t 83 kern_work_interval_notify(thread_t thread, struct kern_work_interval_args* kwi_args); 84 extern kern_return_t 85 kern_work_interval_set_name(mach_port_name_t port_name, char *name, size_t len); 86 extern kern_return_t 87 kern_work_interval_set_workload_id(mach_port_name_t port_name, 88 struct kern_work_interval_workload_id_args *workload_id_args); 89 90 #ifdef MACH_KERNEL_PRIVATE 91 92 bool work_interval_port_type_render_server(mach_port_name_t port_name); 93 94 #if CONFIG_SCHED_AUTO_JOIN 95 bool work_interval_should_propagate(thread_t cthread, thread_t thread); 96 void work_interval_auto_join_propagate(thread_t from, thread_t to); 97 void work_interval_auto_join_unwind(thread_t thread); 98 void work_interval_auto_join_demote(thread_t thread); 99 #endif /* CONFIG_SCHED_AUTO_JOIN */ 100 101 extern kern_return_t work_interval_thread_terminate(thread_t thread); 102 extern int work_interval_get_priority(thread_t thread); 103 104 #endif /* MACH_KERNEL_PRIVATE */ 105 106 #ifdef KERNEL_PRIVATE 107 108 __enum_closed_decl(wi_class_t, uint8_t, { 109 WI_CLASS_NONE = 0, 110 WI_CLASS_DISCRETIONARY = 1, 111 WI_CLASS_BEST_EFFORT = 2, 112 WI_CLASS_APPLICATION = 3, 113 WI_CLASS_SYSTEM = 4, 114 WI_CLASS_SYSTEM_CRITICAL = 5, 115 WI_CLASS_REALTIME = 6, 116 WI_CLASS_REALTIME_CRITICAL = 7, 117 118 WI_CLASS_COUNT 119 }); 120 121 #endif 122 123 __END_DECLS 124 125 #endif /* !defined(_KERN_WORK_INTERVAL_H_) */ 126