1 | /* |
2 | * Copyright (c) 2010-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 | * Copyright (c) 2006 nCircle Network Security, Inc. |
30 | * All rights reserved. |
31 | * |
32 | * This software was developed by Robert N. M. Watson for the TrustedBSD |
33 | * Project under contract to nCircle Network Security, Inc. |
34 | * |
35 | * Redistribution and use in source and binary forms, with or without |
36 | * modification, are permitted provided that the following conditions |
37 | * are met: |
38 | * 1. Redistributions of source code must retain the above copyright |
39 | * notice, this list of conditions and the following disclaimer. |
40 | * 2. Redistributions in binary form must reproduce the above copyright |
41 | * notice, this list of conditions and the following disclaimer in the |
42 | * documentation and/or other materials provided with the distribution. |
43 | * |
44 | * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND |
45 | * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
46 | * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE |
47 | * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR, NCIRCLE NETWORK SECURITY, |
48 | * INC., OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
49 | * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED |
50 | * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR |
51 | * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF |
52 | * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING |
53 | * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS |
54 | * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
55 | * |
56 | * $FreeBSD: src/sys/sys/priv.h,v 1.38.2.1.2.1 2009/10/25 01:10:29 kensmith Exp $ |
57 | */ |
58 | |
59 | /* |
60 | * Kernel privilege checking interface. |
61 | */ |
62 | #ifndef _SYS_PRIV_H_ |
63 | #define _SYS_PRIV_H_ |
64 | |
65 | /* |
66 | * Privilege list, sorted loosely by kernel subsystem. |
67 | * |
68 | * Think carefully before adding or reusing one of these privileges -- are |
69 | * there existing instances referring to the same privilege? Particular |
70 | * numeric privilege assignments are part of the kernel extension ABI. |
71 | */ |
72 | |
73 | /* |
74 | * The remaining privileges typically correspond to one or a small |
75 | * number of specific privilege checks, and have (relatively) precise |
76 | * meanings. They are loosely sorted into a set of base system |
77 | * privileges, such as the ability to reboot, and then loosely by |
78 | * subsystem, indicated by a subsystem name. |
79 | */ |
80 | #define PRIV_ADJTIME 1000 /* Set time adjustment. */ |
81 | #define PRIV_PROC_UUID_POLICY 1001 /* Change process uuid policy table. */ |
82 | #define PRIV_GLOBAL_PROC_INFO 1002 /* Query information for processes owned by other users */ |
83 | #define PRIV_SYSTEM_OVERRIDE 1003 /* Override global system settings for various subsystems for a limited duration/system-mode */ |
84 | #define PRIV_HW_DEBUG_DATA 1004 /* Extract hw-specific debug data (e.g. ECC data) */ |
85 | #define PRIV_SELECTIVE_FORCED_IDLE 1005 /* Configure and control Selective Forced Idle (SFI) subsystem */ |
86 | #define PRIV_PROC_TRACE_INSPECT 1006 /* Request trace memory of arbitrary process to be inspected */ |
87 | #define PRIV_DARKBOOT 1007 /* Manipulate the darkboot flag */ |
88 | #define PRIV_WORK_INTERVAL 1008 /* Express details about a work interval */ |
89 | #define PRIV_SMB_TIMEMACHINE_CONTROL 1009 /* Control Time Machine properties of an SMB share */ |
90 | #define PRIV_AUDIO_LATENCY 1010 /* set audio latency requirements for background tracing */ |
91 | #define PRIV_KTRACE_BACKGROUND 1011 /* Operate ktrace in the background */ |
92 | #define PRIV_SETPRIORITY_DARWIN_ROLE 1012 /* Allow setpriority(PRIO_DARWIN_ROLE) */ |
93 | #define PRIV_PACKAGE_EXTENSIONS 1013 /* Push package extension list used by vn_path_package_check() */ |
94 | #define PRIV_TRIM_ACTIVE_FILE 1014 /* Allow freeing space out from under an active file */ |
95 | #define PRIV_PROC_CPUMON_OVERRIDE 1015 /* Allow CPU usage monitor parameters less restrictive than default */ |
96 | #define PRIV_ENDPOINTSECURITY_CLIENT 1016 /* Allow EndpointSecurity clients to connect */ |
97 | #define PRIV_AUDIT_SESSION_PORT 1017 /* Obtain send-right for arbitrary audit session's port. */ |
98 | |
99 | /* |
100 | * Virtual memory privileges. |
101 | */ |
102 | #define PRIV_VM_PRESSURE 6000 /* Check VM pressure. */ |
103 | #define PRIV_VM_JETSAM 6001 /* Adjust jetsam configuration. */ |
104 | #define 6002 /* Adjust physical footprint limit. */ |
105 | |
106 | /* |
107 | * Network stack privileges. |
108 | */ |
109 | #define PRIV_NET_PRIVILEGED_TRAFFIC_CLASS 10000 /* Set SO_PRIVILEGED_TRAFFIC_CLASS. */ |
110 | #define PRIV_NET_PRIVILEGED_SOCKET_DELEGATE 10001 /* Set delegate on a socket */ |
111 | #define PRIV_NET_INTERFACE_CONTROL 10002 /* Enable interface debug logging. */ |
112 | #define PRIV_NET_PRIVILEGED_NETWORK_STATISTICS 10003 /* Access to all sockets */ |
113 | #define PRIV_NET_PRIVILEGED_NECP_POLICIES 10004 /* Access to privileged Network Extension policies */ |
114 | #define PRIV_NET_RESTRICTED_AWDL 10005 /* Access to restricted AWDL mode */ |
115 | #define PRIV_NET_PRIVILEGED_NECP_MATCH 10006 /* Privilege verified by Network Extension policies */ |
116 | #define PRIV_NET_QOSMARKING_POLICY_OVERRIDE 10007 /* Privilege verified by Network Extension policies */ |
117 | #define PRIV_NET_RESTRICTED_INTCOPROC 10008 /* Access to internal co-processor network interfaces */ |
118 | |
119 | /* unused 10009 */ |
120 | #define PRIV_NET_RESTRICTED_MULTIPATH_EXTENDED 10010 /* Extended multipath (more aggressive on cell) */ |
121 | #define PRIV_NET_RESTRICTED_ROUTE_NC_READ 10011 /* Enable route neighbhor cache read operations */ |
122 | |
123 | #define PRIV_NET_PRIVILEGED_CLIENT_ACCESS 10012 /* Allow client networking access on restricted platforms */ |
124 | #define PRIV_NET_PRIVILEGED_SERVER_ACCESS 10013 /* Allow server networking access on restricted platforms */ |
125 | |
126 | #define PRIV_NET_VALIDATED_RESOLVER 10014 /* Privilege to sign DNS resolver results for validation */ |
127 | |
128 | #define PRIV_NET_CUSTOM_PROTOCOL 10015 /* Privilege to use custom protocol APIs */ |
129 | #define PRIV_NET_PRIVILEGED_NECP_DROP_ALL_BYPASS 10016 /* Privilege to bypass NECP drop-all */ |
130 | #define PRIV_NET_PRIVILEGED_IPSEC_WAKE_PACKET 10017 /* Privilege to get IPsec wake packet */ |
131 | |
132 | #define PRIV_NET_RESTRICTED_MANAGEMENT_DATA 10018 /* Privilege to send/receive data over a management interface */ |
133 | |
134 | /* |
135 | * IPv4 and IPv6 privileges. |
136 | */ |
137 | #define PRIV_NETINET_RESERVEDPORT 11000 /* Bind low port number. */ |
138 | #define PRIV_NETINET_TCP_KA_OFFLOAD 11001 /* Can set TCP keep alive offload option */ |
139 | |
140 | /* |
141 | * Skywalk privileges. |
142 | */ |
143 | #define PRIV_SKYWALK_REGISTER_USER_PIPE 12000 /* Register a user pipe nexus */ |
144 | #define PRIV_SKYWALK_REGISTER_KERNEL_PIPE 12001 /* Register a kernel pipe nexus */ |
145 | #define PRIV_SKYWALK_REGISTER_NET_IF 12002 /* Register a net_if nexus */ |
146 | #define PRIV_SKYWALK_REGISTER_FLOW_SWITCH 12003 /* Register a flow switch nexus */ |
147 | #define PRIV_SKYWALK_LOW_LATENCY_CHANNEL 12004 /* open a low latency channel */ |
148 | #define PRIV_SKYWALK_OBSERVE_ALL 12010 /* Observe stats and data on channels */ |
149 | #define PRIV_SKYWALK_OBSERVE_STATS 12011 /* Observe stats only on channels */ |
150 | |
151 | /* |
152 | * VFS privileges |
153 | */ |
154 | #define PRIV_VFS_OPEN_BY_ID 14000 /* Allow calling openbyid_np() */ |
155 | #define PRIV_VFS_MOVE_DATA_EXTENTS 14001 /* Allow F_MOVEDATAEXTENTS fcntl */ |
156 | #define PRIV_VFS_SNAPSHOT 14002 /* Allow create/rename/delete of snapshots */ |
157 | #define PRIV_VFS_DATALESS_RESOLVER 14004 /* Allow registration as dataless file resolver */ |
158 | #define PRIV_VFS_SETSIZE 14006 /* Allow resizing a file without zeroing space */ |
159 | |
160 | #ifdef KERNEL |
161 | /* |
162 | * Privilege check interface. No flags are currently defined for the API. |
163 | */ |
164 | #include <sys/cdefs.h> |
165 | #include <sys/kauth.h> |
166 | |
167 | /* |
168 | * flags for priv_check_cred |
169 | */ |
170 | #define PRIVCHECK_DEFAULT_UNPRIVILEGED_FLAG (1) /* Don't grant root privilege by default */ |
171 | |
172 | __BEGIN_DECLS |
173 | int priv_check_cred(kauth_cred_t cred, int priv, int flags); |
174 | __END_DECLS |
175 | #endif |
176 | |
177 | #endif /* !_SYS_PRIV_H_ */ |
178 | |