xref: /xnu-8792.41.9/bsd/sys/csr.h (revision 5c2921b07a2480ab43ec66f5b9e41cb872bc554f)
1*5c2921b0SApple OSS Distributions /*
2*5c2921b0SApple OSS Distributions  * Copyright (c) 2014 Apple Inc. All rights reserved.
3*5c2921b0SApple OSS Distributions  *
4*5c2921b0SApple OSS Distributions  * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
5*5c2921b0SApple OSS Distributions  *
6*5c2921b0SApple OSS Distributions  * This file contains Original Code and/or Modifications of Original Code
7*5c2921b0SApple OSS Distributions  * as defined in and that are subject to the Apple Public Source License
8*5c2921b0SApple OSS Distributions  * Version 2.0 (the 'License'). You may not use this file except in
9*5c2921b0SApple OSS Distributions  * compliance with the License. The rights granted to you under the License
10*5c2921b0SApple OSS Distributions  * may not be used to create, or enable the creation or redistribution of,
11*5c2921b0SApple OSS Distributions  * unlawful or unlicensed copies of an Apple operating system, or to
12*5c2921b0SApple OSS Distributions  * circumvent, violate, or enable the circumvention or violation of, any
13*5c2921b0SApple OSS Distributions  * terms of an Apple operating system software license agreement.
14*5c2921b0SApple OSS Distributions  *
15*5c2921b0SApple OSS Distributions  * Please obtain a copy of the License at
16*5c2921b0SApple OSS Distributions  * http://www.opensource.apple.com/apsl/ and read it before using this file.
17*5c2921b0SApple OSS Distributions  *
18*5c2921b0SApple OSS Distributions  * The Original Code and all software distributed under the License are
19*5c2921b0SApple OSS Distributions  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20*5c2921b0SApple OSS Distributions  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21*5c2921b0SApple OSS Distributions  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22*5c2921b0SApple OSS Distributions  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23*5c2921b0SApple OSS Distributions  * Please see the License for the specific language governing rights and
24*5c2921b0SApple OSS Distributions  * limitations under the License.
25*5c2921b0SApple OSS Distributions  *
26*5c2921b0SApple OSS Distributions  * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
27*5c2921b0SApple OSS Distributions  */
28*5c2921b0SApple OSS Distributions 
29*5c2921b0SApple OSS Distributions #ifndef _SYS_CSR_H_
30*5c2921b0SApple OSS Distributions #define _SYS_CSR_H_
31*5c2921b0SApple OSS Distributions 
32*5c2921b0SApple OSS Distributions #include <stdint.h>
33*5c2921b0SApple OSS Distributions #include <sys/appleapiopts.h>
34*5c2921b0SApple OSS Distributions #include <sys/cdefs.h>
35*5c2921b0SApple OSS Distributions 
36*5c2921b0SApple OSS Distributions #ifdef __APPLE_API_PRIVATE
37*5c2921b0SApple OSS Distributions 
38*5c2921b0SApple OSS Distributions typedef uint32_t csr_config_t;
39*5c2921b0SApple OSS Distributions typedef uint32_t csr_op_t;
40*5c2921b0SApple OSS Distributions 
41*5c2921b0SApple OSS Distributions /* CSR configuration flags */
42*5c2921b0SApple OSS Distributions #define CSR_ALLOW_UNTRUSTED_KEXTS               (1 << 0)
43*5c2921b0SApple OSS Distributions #define CSR_ALLOW_UNRESTRICTED_FS               (1 << 1)
44*5c2921b0SApple OSS Distributions #define CSR_ALLOW_TASK_FOR_PID                  (1 << 2)
45*5c2921b0SApple OSS Distributions #define CSR_ALLOW_KERNEL_DEBUGGER               (1 << 3)
46*5c2921b0SApple OSS Distributions #define CSR_ALLOW_APPLE_INTERNAL                (1 << 4)
47*5c2921b0SApple OSS Distributions #define CSR_ALLOW_DESTRUCTIVE_DTRACE                    (1 << 5) /* name deprecated */
48*5c2921b0SApple OSS Distributions #define CSR_ALLOW_UNRESTRICTED_DTRACE                   (1 << 5)
49*5c2921b0SApple OSS Distributions #define CSR_ALLOW_UNRESTRICTED_NVRAM                    (1 << 6)
50*5c2921b0SApple OSS Distributions #define CSR_ALLOW_DEVICE_CONFIGURATION                  (1 << 7)
51*5c2921b0SApple OSS Distributions #define CSR_ALLOW_ANY_RECOVERY_OS                       (1 << 8)
52*5c2921b0SApple OSS Distributions #define CSR_ALLOW_UNAPPROVED_KEXTS                      (1 << 9)
53*5c2921b0SApple OSS Distributions #define CSR_ALLOW_EXECUTABLE_POLICY_OVERRIDE    (1 << 10)
54*5c2921b0SApple OSS Distributions #define CSR_ALLOW_UNAUTHENTICATED_ROOT                  (1 << 11)
55*5c2921b0SApple OSS Distributions 
56*5c2921b0SApple OSS Distributions #define CSR_VALID_FLAGS (CSR_ALLOW_UNTRUSTED_KEXTS | \
57*5c2921b0SApple OSS Distributions 	                         CSR_ALLOW_UNRESTRICTED_FS | \
58*5c2921b0SApple OSS Distributions 	                         CSR_ALLOW_TASK_FOR_PID | \
59*5c2921b0SApple OSS Distributions 	                         CSR_ALLOW_KERNEL_DEBUGGER | \
60*5c2921b0SApple OSS Distributions 	                         CSR_ALLOW_APPLE_INTERNAL | \
61*5c2921b0SApple OSS Distributions 	                         CSR_ALLOW_UNRESTRICTED_DTRACE | \
62*5c2921b0SApple OSS Distributions 	                         CSR_ALLOW_UNRESTRICTED_NVRAM | \
63*5c2921b0SApple OSS Distributions 	                         CSR_ALLOW_DEVICE_CONFIGURATION | \
64*5c2921b0SApple OSS Distributions 	                         CSR_ALLOW_ANY_RECOVERY_OS | \
65*5c2921b0SApple OSS Distributions 	                         CSR_ALLOW_UNAPPROVED_KEXTS | \
66*5c2921b0SApple OSS Distributions 	                         CSR_ALLOW_EXECUTABLE_POLICY_OVERRIDE | \
67*5c2921b0SApple OSS Distributions 	                         CSR_ALLOW_UNAUTHENTICATED_ROOT)
68*5c2921b0SApple OSS Distributions 
69*5c2921b0SApple OSS Distributions #define CSR_ALWAYS_ENFORCED_FLAGS (CSR_ALLOW_DEVICE_CONFIGURATION | CSR_ALLOW_ANY_RECOVERY_OS)
70*5c2921b0SApple OSS Distributions 
71*5c2921b0SApple OSS Distributions /* Flags set by `csrutil disable`. */
72*5c2921b0SApple OSS Distributions #define CSR_DISABLE_FLAGS (CSR_ALLOW_UNTRUSTED_KEXTS | \
73*5c2921b0SApple OSS Distributions 	                   CSR_ALLOW_UNRESTRICTED_FS | \
74*5c2921b0SApple OSS Distributions 	                   CSR_ALLOW_TASK_FOR_PID | \
75*5c2921b0SApple OSS Distributions 	                   CSR_ALLOW_KERNEL_DEBUGGER | \
76*5c2921b0SApple OSS Distributions 	                   CSR_ALLOW_APPLE_INTERNAL | \
77*5c2921b0SApple OSS Distributions 	                   CSR_ALLOW_UNRESTRICTED_DTRACE | \
78*5c2921b0SApple OSS Distributions 	                   CSR_ALLOW_UNRESTRICTED_NVRAM)
79*5c2921b0SApple OSS Distributions 
80*5c2921b0SApple OSS Distributions /* CSR capabilities that a booter can give to the system */
81*5c2921b0SApple OSS Distributions #define CSR_CAPABILITY_UNLIMITED                        (1 << 0)
82*5c2921b0SApple OSS Distributions #define CSR_CAPABILITY_CONFIG                           (1 << 1)
83*5c2921b0SApple OSS Distributions #define CSR_CAPABILITY_APPLE_INTERNAL                   (1 << 2)
84*5c2921b0SApple OSS Distributions 
85*5c2921b0SApple OSS Distributions #define CSR_VALID_CAPABILITIES (CSR_CAPABILITY_UNLIMITED | CSR_CAPABILITY_CONFIG | CSR_CAPABILITY_APPLE_INTERNAL)
86*5c2921b0SApple OSS Distributions 
87*5c2921b0SApple OSS Distributions #ifdef PRIVATE
88*5c2921b0SApple OSS Distributions /* Private system call interface between Libsyscall and xnu */
89*5c2921b0SApple OSS Distributions 
90*5c2921b0SApple OSS Distributions /* Syscall flavors */
91*5c2921b0SApple OSS Distributions enum csr_syscalls {
92*5c2921b0SApple OSS Distributions 	CSR_SYSCALL_CHECK,
93*5c2921b0SApple OSS Distributions 	CSR_SYSCALL_GET_ACTIVE_CONFIG,
94*5c2921b0SApple OSS Distributions };
95*5c2921b0SApple OSS Distributions 
96*5c2921b0SApple OSS Distributions #endif /* PRIVATE */
97*5c2921b0SApple OSS Distributions 
98*5c2921b0SApple OSS Distributions __BEGIN_DECLS
99*5c2921b0SApple OSS Distributions 
100*5c2921b0SApple OSS Distributions /* Syscalls */
101*5c2921b0SApple OSS Distributions int csr_check(csr_config_t mask);
102*5c2921b0SApple OSS Distributions int csr_get_active_config(csr_config_t *config);
103*5c2921b0SApple OSS Distributions 
104*5c2921b0SApple OSS Distributions __END_DECLS
105*5c2921b0SApple OSS Distributions 
106*5c2921b0SApple OSS Distributions #endif /* __APPLE_API_PRIVATE */
107*5c2921b0SApple OSS Distributions 
108*5c2921b0SApple OSS Distributions #endif /* _SYS_CSR_H_ */
109