1/*
2 * Copyright (c) 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_RO_H_
30#define _SYS_PROC_RO_H_
31
32#include <stdint.h>
33#include <sys/_types/_pid_t.h>
34#include <sys/cdefs.h>
35#include <kern/smr_types.h>
36
37__BEGIN_DECLS __ASSUME_PTR_ABI_SINGLE_BEGIN
38#pragma GCC visibility push(hidden)
39
40struct proc;
41struct task;
42struct ucred;
43
44struct proc_platform_ro_data {
45 uint32_t p_platform;
46 uint32_t p_min_sdk;
47 uint32_t p_sdk;
48};
49
50struct task_token_ro_data {
51 security_token_t sec_token;
52 audit_token_t audit_token;
53};
54
55struct task_filter_ro_data {
56 uint8_t *__unsafe_indexable mach_trap_filter_mask; /* Mach trap filter bitmask (len: mach_trap_count bits) */
57 uint8_t *__unsafe_indexable mach_kobj_filter_mask; /* Mach kobject filter bitmask (len: mach_kobj_count bits) */
58};
59
60struct proc_ro {
61 struct proc *pr_proc;
62 struct task *pr_task;
63
64 __xnu_struct_group(proc_ro_data, proc_data, {
65 uint64_t p_uniqueid; /* process unique ID - incremented on fork/spawn/vfork, remains same across exec. */
66 int p_idversion; /* version of process identity */
67 uint32_t p_csflags;
68 SMR_POINTER(struct ucred *) p_ucred; /* Process owner's identity. (PUCL) */
69 uint8_t *__unsafe_indexable syscall_filter_mask; /* syscall filter bitmask (length: nsysent bits) */
70 struct proc_platform_ro_data p_platform_data;
71 });
72
73 __xnu_struct_group(task_ro_data, task_data, {
74 /* Task security and audit tokens */
75 struct task_token_ro_data task_tokens;
76#ifdef CONFIG_MACF
77 struct task_filter_ro_data task_filters;
78#endif
79 uint32_t t_flags_ro; /* RO-protected task flags (see osfmk/kern/task.h) */
80 uint32_t task_control_port_options;
81 });
82};
83
84typedef const struct proc_ro_data *proc_ro_data_t;
85typedef const struct task_ro_data *task_ro_data_t;
86typedef struct proc_ro *proc_ro_t;
87
88extern proc_ro_t proc_ro_alloc(struct proc *p, proc_ro_data_t p_data, struct task *t, task_ro_data_t t_data);
89extern proc_ro_t proc_ro_ref_task(proc_ro_t pr, struct task *t, task_ro_data_t t_data);
90extern void proc_ro_erase_task(proc_ro_t pr);
91
92extern proc_ro_t proc_get_ro(struct proc *p) __pure2;
93extern proc_ro_t task_get_ro(struct task *t) __pure2;
94
95extern struct task *proc_ro_task(proc_ro_t pr) __pure2;
96
97#pragma GCC visibility pop
98__ASSUME_PTR_ABI_SINGLE_END __END_DECLS
99
100#endif /* _SYS_PROC_RO_H_ */
101