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