1 /* 2 * Copyright (c) 2005-2021 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 _SYS_PROC_INFO_PRIVATE_H 30 #define _SYS_PROC_INFO_PRIVATE_H 31 32 #include <mach/coalition.h> 33 #include <mach/machine.h> 34 #include <mach/message.h> 35 #include <stdint.h> 36 #include <sys/cdefs.h> 37 #include <sys/event_private.h> 38 #include <sys/proc_info.h> 39 #include <sys/types.h> 40 #include <uuid/uuid.h> 41 42 __BEGIN_DECLS 43 44 45 struct proc_uniqidentifierinfo { 46 uint8_t p_uuid[16]; /* UUID of the main executable */ 47 uint64_t p_uniqueid; /* 64 bit unique identifier for process */ 48 uint64_t p_puniqueid; /* unique identifier for process's parent */ 49 int32_t p_idversion; /* pid version */ 50 int32_t p_orig_ppidversion; /* process's original parent's pid version, doesn't change if reparented */ 51 uint64_t p_reserve2; /* reserved for future use */ 52 uint64_t p_reserve3; /* reserved for future use */ 53 }; 54 /* This structure is API */ 55 _Static_assert(sizeof(struct proc_uniqidentifierinfo) == 56, "sizeof(struct proc_uniqidentifierinfo) == 56"); 56 57 58 struct proc_bsdinfowithuniqid { 59 struct proc_bsdinfo pbsd; 60 struct proc_uniqidentifierinfo p_uniqidentifier; 61 }; 62 63 struct proc_archinfo { 64 cpu_type_t p_cputype; 65 cpu_subtype_t p_cpusubtype; 66 }; 67 68 struct proc_pidcoalitioninfo { 69 uint64_t coalition_id[COALITION_NUM_TYPES]; 70 uint64_t reserved1; 71 uint64_t reserved2; 72 uint64_t reserved3; 73 }; 74 75 struct proc_originatorinfo { 76 uuid_t originator_uuid; /* UUID of the originator process */ 77 pid_t originator_pid; /* pid of the originator process */ 78 uint64_t p_reserve2; 79 uint64_t p_reserve3; 80 uint64_t p_reserve4; 81 }; 82 83 struct proc_ipctableinfo { 84 uint32_t table_size; 85 uint32_t table_free; 86 }; 87 88 struct proc_threadschedinfo { 89 uint64_t int_time_ns; /* time spent in interrupt context */ 90 }; 91 92 // See PROC_PIDTHREADCOUNTS for a description of how to use these structures. 93 94 struct proc_threadcounts_data { 95 uint64_t ptcd_instructions; 96 uint64_t ptcd_cycles; 97 uint64_t ptcd_user_time_mach; 98 uint64_t ptcd_system_time_mach; 99 uint64_t ptcd_energy_nj; 100 }; 101 102 struct proc_threadcounts { 103 uint16_t ptc_len; 104 uint16_t ptc_reserved0; 105 uint32_t ptc_reserved1; 106 struct proc_threadcounts_data ptc_counts[]; 107 }; 108 109 struct proc_delegated_signal_info { 110 audit_token_t instigator; 111 audit_token_t target; 112 }; 113 114 #define PROC_FLAG_DARWINBG 0x8000 /* process in darwin background */ 115 #define PROC_FLAG_EXT_DARWINBG 0x10000 /* process in darwin background - external enforcement */ 116 #define PROC_FLAG_IOS_APPLEDAEMON 0x20000 /* Process is apple daemon */ 117 #define PROC_FLAG_DELAYIDLESLEEP 0x40000 /* Process is marked to delay idle sleep on disk IO */ 118 #define PROC_FLAG_IOS_IMPPROMOTION 0x80000 /* Process is daemon which receives importance donation */ 119 #define PROC_FLAG_ADAPTIVE 0x100000 /* Process is adaptive */ 120 #define PROC_FLAG_ADAPTIVE_IMPORTANT 0x200000 /* Process is adaptive, and is currently important */ 121 #define PROC_FLAG_IMPORTANCE_DONOR 0x400000 /* Process is marked as an importance donor */ 122 #define PROC_FLAG_SUPPRESSED 0x800000 /* Process is suppressed */ 123 #define PROC_FLAG_APPLICATION 0x1000000 /* Process is an application */ 124 #define PROC_FLAG_IOS_APPLICATION PROC_FLAG_APPLICATION /* Process is an application */ 125 #define PROC_FLAG_ROSETTA 0x2000000 /* Process is running translated under Rosetta */ 126 127 /* 128 * Security config. 129 * These flags are currently folded inside pbi_flags, but per-feature policies should 130 * likely move elsewhere. 131 */ 132 #define PROC_FLAG_SEC_ENABLED 0x04000000 133 #define PROC_FLAG_SEC_BYPASS_ENABLED 0x08000000 134 #define PROC_FLAG_HARDENED_HEAP_ENABLED 0x10000000 135 #define PROC_FLAG_TPRO_ENABLED 0x20000000 136 137 /* keep in sync with KQ_* in sys/eventvar.h */ 138 #define PROC_KQUEUE_WORKQ 0x0040 139 #define PROC_KQUEUE_WORKLOOP 0x0080 140 141 struct kevent_extinfo { 142 struct kevent_qos_s kqext_kev; 143 uint64_t kqext_sdata; 144 int kqext_status; 145 int kqext_sfflags; 146 uint64_t kqext_reserved[2]; 147 }; 148 149 /* Flavors for proc_pidinfo() */ 150 #define PROC_PIDUNIQIDENTIFIERINFO 17 151 #define PROC_PIDUNIQIDENTIFIERINFO_SIZE \ 152 (sizeof(struct proc_uniqidentifierinfo)) 153 154 #define PROC_PIDT_BSDINFOWITHUNIQID 18 155 #define PROC_PIDT_BSDINFOWITHUNIQID_SIZE \ 156 (sizeof(struct proc_bsdinfowithuniqid)) 157 158 #define PROC_PIDARCHINFO 19 159 #define PROC_PIDARCHINFO_SIZE \ 160 (sizeof(struct proc_archinfo)) 161 162 #define PROC_PIDCOALITIONINFO 20 163 #define PROC_PIDCOALITIONINFO_SIZE (sizeof(struct proc_pidcoalitioninfo)) 164 165 #define PROC_PIDNOTEEXIT 21 166 #define PROC_PIDNOTEEXIT_SIZE (sizeof(uint32_t)) 167 168 #define PROC_PIDREGIONPATHINFO2 22 169 #define PROC_PIDREGIONPATHINFO2_SIZE (sizeof(struct proc_regionwithpathinfo)) 170 171 #define PROC_PIDREGIONPATHINFO3 23 172 #define PROC_PIDREGIONPATHINFO3_SIZE (sizeof(struct proc_regionwithpathinfo)) 173 174 #define PROC_PIDEXITREASONINFO 24 175 #define PROC_PIDEXITREASONINFO_SIZE (sizeof(struct proc_exitreasoninfo)) 176 177 #define PROC_PIDEXITREASONBASICINFO 25 178 #define PROC_PIDEXITREASONBASICINFOSIZE (sizeof(struct proc_exitreasonbasicinfo)) 179 180 #define PROC_PIDLISTUPTRS 26 181 #define PROC_PIDLISTUPTRS_SIZE (sizeof(uint64_t)) 182 183 #define PROC_PIDLISTDYNKQUEUES 27 184 #define PROC_PIDLISTDYNKQUEUES_SIZE (sizeof(kqueue_id_t)) 185 186 #define PROC_PIDLISTTHREADIDS 28 187 #define PROC_PIDLISTTHREADIDS_SIZE (2* sizeof(uint32_t)) 188 189 #define PROC_PIDVMRTFAULTINFO 29 190 #define PROC_PIDVMRTFAULTINFO_SIZE (sizeof(vm_rtfault_record_t)) 191 192 #define PROC_PIDPLATFORMINFO 30 193 #define PROC_PIDPLATFORMINFO_SIZE (sizeof(uint32_t)) 194 195 #define PROC_PIDREGIONPATH 31 196 #define PROC_PIDREGIONPATH_SIZE (sizeof(struct proc_regionpath)) 197 198 #define PROC_PIDIPCTABLEINFO 32 199 #define PROC_PIDIPCTABLEINFO_SIZE (sizeof(struct proc_ipctableinfo)) 200 201 #define PROC_PIDTHREADSCHEDINFO 33 202 #define PROC_PIDTHREADSCHEDINFO_SIZE (sizeof(struct proc_threadschedinfo)) 203 204 // PROC_PIDTHREADCOUNTS returns a list of counters for the given thread, 205 // separated out by the "perf-level" it was running on (typically either 206 // "performance" or "efficiency"). 207 // 208 // This interface works a bit differently from the other proc_info(3) flavors. 209 // It copies out a structure with a variable-length array at the end of it. 210 // The start of the `proc_threadcounts` structure contains a header indicating 211 // the length of the subsequent array of `proc_threadcounts_data` elements. 212 // 213 // To use this interface, first read the `hw.nperflevels` sysctl to find out how 214 // large to make the allocation that receives the counter data: 215 // 216 // sizeof(proc_threadcounts) + nperflevels * sizeof(proc_threadcounts_data) 217 // 218 // Use the `hw.perflevel[0-9].name` sysctl to find out which perf-level maps to 219 // each entry in the array. 220 // 221 // The complete usage would be (omitting error reporting): 222 // 223 // uint32_t len = 0; 224 // int ret = sysctlbyname("hw.nperflevels", &len, &len_sz, NULL, 0); 225 // size_t size = sizeof(struct proc_threadcounts) + 226 // len * sizeof(struct proc_threadcounts_data); 227 // struct proc_threadcounts *counts = malloc(size); 228 // // Fill this in with a thread ID, like from `PROC_PIDLISTTHREADS`. 229 // uint64_t tid = 0; 230 // int size_copied = proc_info(getpid(), PROC_PIDTHREADCOUNTS, tid, counts, 231 // size); 232 233 #define PROC_PIDTHREADCOUNTS 34 234 #define PROC_PIDTHREADCOUNTS_SIZE (sizeof(struct proc_threadcounts)) 235 236 /* Flavors for proc_pidfdinfo */ 237 238 #define PROC_PIDFDKQUEUE_EXTINFO 9 239 #define PROC_PIDFDKQUEUE_EXTINFO_SIZE (sizeof(struct kevent_extinfo)) 240 #define PROC_PIDFDKQUEUE_KNOTES_MAX (1024 * 128) 241 #define PROC_PIDDYNKQUEUES_MAX (1024 * 128) 242 243 244 /* Flavors for proc_pidoriginatorinfo */ 245 #define PROC_PIDORIGINATOR_UUID 0x1 246 #define PROC_PIDORIGINATOR_UUID_SIZE (sizeof(uuid_t)) 247 248 #define PROC_PIDORIGINATOR_BGSTATE 0x2 249 #define PROC_PIDORIGINATOR_BGSTATE_SIZE (sizeof(uint32_t)) 250 251 #define PROC_PIDORIGINATOR_PID_UUID 0x3 252 #define PROC_PIDORIGINATOR_PID_UUID_SIZE (sizeof(struct proc_originatorinfo)) 253 254 /* Flavors for proc_listcoalitions */ 255 #define LISTCOALITIONS_ALL_COALS 1 256 #define LISTCOALITIONS_ALL_COALS_SIZE (sizeof(struct procinfo_coalinfo)) 257 258 #define LISTCOALITIONS_SINGLE_TYPE 2 259 #define LISTCOALITIONS_SINGLE_TYPE_SIZE (sizeof(struct procinfo_coalinfo)) 260 261 /* reasons for proc_can_use_foreground_hw */ 262 #define PROC_FGHW_OK 0 /* pid may use foreground HW */ 263 #define PROC_FGHW_DAEMON_OK 1 264 #define PROC_FGHW_DAEMON_LEADER 10 /* pid is in a daemon coalition */ 265 #define PROC_FGHW_LEADER_NONUI 11 /* coalition leader is in a non-focal state */ 266 #define PROC_FGHW_LEADER_BACKGROUND 12 /* coalition leader is in a background state */ 267 #define PROC_FGHW_DAEMON_NO_VOUCHER 13 /* pid is a daemon with no adopted voucher */ 268 #define PROC_FGHW_NO_VOUCHER_ATTR 14 /* pid has adopted a voucher with no bank/originator attribute */ 269 #define PROC_FGHW_NO_ORIGINATOR 15 /* pid has adopted a voucher for a process that's gone away */ 270 #define PROC_FGHW_ORIGINATOR_BACKGROUND 16 /* pid has adopted a voucher for an app that's in the background */ 271 #define PROC_FGHW_VOUCHER_ERROR 98 /* error in voucher / originator callout */ 272 #define PROC_FGHW_ERROR 99 /* syscall parameter/permissions error */ 273 274 /* flavors for proc_piddynkqueueinfo */ 275 #define PROC_PIDDYNKQUEUE_INFO 0 276 #define PROC_PIDDYNKQUEUE_INFO_SIZE (sizeof(struct kqueue_dyninfo)) 277 #define PROC_PIDDYNKQUEUE_EXTINFO 1 278 #define PROC_PIDDYNKQUEUE_EXTINFO_SIZE (sizeof(struct kevent_extinfo)) 279 280 /* __proc_info() call numbers */ 281 #define PROC_INFO_CALL_LISTPIDS 0x1 282 #define PROC_INFO_CALL_PIDINFO 0x2 283 #define PROC_INFO_CALL_PIDFDINFO 0x3 284 #define PROC_INFO_CALL_KERNMSGBUF 0x4 285 #define PROC_INFO_CALL_SETCONTROL 0x5 286 #define PROC_INFO_CALL_PIDFILEPORTINFO 0x6 287 #define PROC_INFO_CALL_TERMINATE 0x7 288 #define PROC_INFO_CALL_DIRTYCONTROL 0x8 289 #define PROC_INFO_CALL_PIDRUSAGE 0x9 290 #define PROC_INFO_CALL_PIDORIGINATORINFO 0xa 291 #define PROC_INFO_CALL_LISTCOALITIONS 0xb 292 #define PROC_INFO_CALL_CANUSEFGHW 0xc 293 #define PROC_INFO_CALL_PIDDYNKQUEUEINFO 0xd 294 #define PROC_INFO_CALL_UDATA_INFO 0xe 295 #define PROC_INFO_CALL_SET_DYLD_IMAGES 0xf 296 #define PROC_INFO_CALL_TERMINATE_RSR 0x10 297 #define PROC_INFO_CALL_SIGNAL_AUDITTOKEN 0x11 298 #define PROC_INFO_CALL_TERMINATE_AUDITTOKEN 0x12 299 #define PROC_INFO_CALL_DELEGATE_SIGNAL 0x13 300 #define PROC_INFO_CALL_DELEGATE_TERMINATE 0x14 301 302 /* __proc_info_extended_id() flags */ 303 #define PIF_COMPARE_IDVERSION 0x01 304 #define PIF_COMPARE_UNIQUEID 0x02 305 306 #ifdef KERNEL_PRIVATE 307 extern int proc_fdlist(proc_t p, struct proc_fdinfo *buf, size_t *count); 308 extern int proc_pidoriginatorpid_uuid(uuid_t uuid, uint32_t buffersize, pid_t *pid); 309 #endif 310 311 #ifdef XNU_KERNEL_PRIVATE 312 #ifndef pshmnode 313 struct pshmnode; 314 #endif 315 316 #ifndef psemnode 317 struct psemnode; 318 #endif 319 320 #ifndef pipe 321 struct pipe; 322 #endif 323 324 extern int fill_socketinfo(socket_t so, struct socket_info *si); 325 extern int fill_pshminfo(struct pshmnode * pshm, struct pshm_info * pinfo); 326 extern int fill_pseminfo(struct psemnode * psem, struct psem_info * pinfo); 327 extern int fill_pipeinfo(struct pipe * cpipe, struct pipe_info * pinfo); 328 extern int fill_kqueueinfo(struct kqueue * kq, struct kqueue_info * kinfo); 329 extern int pid_kqueue_extinfo(proc_t, struct kqueue * kq, user_addr_t buffer, 330 uint32_t buffersize, int32_t * retval); 331 extern int pid_kqueue_udatainfo(proc_t p, struct kqueue *kq, uint64_t *buf, 332 uint32_t bufsize); 333 extern int pid_kqueue_listdynamickqueues(proc_t p, user_addr_t ubuf, 334 uint32_t bufsize, int32_t *retval); 335 extern int pid_dynamickqueue_extinfo(proc_t p, kqueue_id_t kq_id, 336 user_addr_t ubuf, uint32_t bufsize, int32_t *retval); 337 struct kern_channel; 338 extern int fill_channelinfo(struct kern_channel * chan, 339 struct proc_channel_info *chan_info); 340 extern int fill_procworkqueue(proc_t, struct proc_workqueueinfo *); 341 extern boolean_t workqueue_get_pwq_exceeded(void *v, boolean_t *exceeded_total, 342 boolean_t *exceeded_constrained); 343 extern uint64_t workqueue_get_task_ss_flags_from_pwq_state_kdp(void *proc); 344 345 #endif /* XNU_KERNEL_PRIVATE */ 346 347 __END_DECLS 348 349 #endif /*_SYS_PROC_INFO_PRIVATE_H */ 350