1 /*
2 * Copyright (c) 2018 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 #include <errno.h>
30 #include <mach/host_special_ports.h>
31 #include <mach/task_special_ports.h>
32 #include <mach/thread_special_ports.h>
33 #include <mach/port_descriptions.h>
34 #include <stdlib.h>
35 #include <strings.h>
36
37 const char *
mach_host_special_port_description(int port)38 mach_host_special_port_description(int port)
39 {
40 int port_index = (int)port;
41
42 if (port_index < 0 || port_index > HOST_MAX_SPECIAL_PORT) {
43 return NULL;
44 }
45
46 static const char *hsp_descs[] = {
47 [HOST_PORT] = "host (restricted)",
48 [HOST_PRIV_PORT] = "host private (restricted)",
49 [HOST_IO_MASTER_PORT] = "I/O master (restricted)",
50
51 [HOST_DYNAMIC_PAGER_PORT] = "dynamic pager",
52 [HOST_AUDIT_CONTROL_PORT] = "audit control",
53 [HOST_USER_NOTIFICATION_PORT] = "user notification",
54 [HOST_AUTOMOUNTD_PORT] = "automounter",
55 [HOST_LOCKD_PORT] = "lockd",
56 [HOST_KTRACE_BACKGROUND_PORT] = "ktrace background notification",
57 [HOST_SEATBELT_PORT] = "seatbelt",
58 [HOST_KEXTD_PORT] = "kextd",
59 [HOST_LAUNCHCTL_PORT] = "launchctl",
60 [HOST_UNFREED_PORT] = "fairplay",
61 [HOST_AMFID_PORT] = "amfi",
62 [HOST_GSSD_PORT] = "gssd",
63 [HOST_TELEMETRY_PORT] = "telemetry",
64 [HOST_ATM_NOTIFICATION_PORT] = "atm notification",
65 [HOST_COALITION_PORT] = "coalition notification",
66 [HOST_SYSDIAGNOSE_PORT] = "sysdiagnose notification",
67 [HOST_XPC_EXCEPTION_PORT] = "XPC exception",
68 [HOST_CONTAINERD_PORT] = "container manager",
69 [HOST_NODE_PORT] = "node",
70 [HOST_RESOURCE_NOTIFY_PORT] = "resource notify",
71 [HOST_CLOSURED_PORT] = "closured",
72 [HOST_SYSPOLICYD_PORT] = "syspolicyd",
73 [HOST_FILECOORDINATIOND_PORT] = "filecoordinationd",
74 [HOST_FAIRPLAYD_PORT] = "fairplayd",
75 [HOST_IOCOMPRESSIONSTATS_PORT] = "I/O compression stats",
76 };
77 _Static_assert(HOST_IOCOMPRESSIONSTATS_PORT == HOST_MAX_SPECIAL_PORT,
78 "all host special ports must have descriptions");
79
80 return hsp_descs[port_index];
81 }
82
83 const char *
mach_task_special_port_description(int port)84 mach_task_special_port_description(int port)
85 {
86 int port_index = (int)port;
87
88 if (port_index < 0 || port_index > TASK_MAX_SPECIAL_PORT) {
89 return NULL;
90 }
91
92 static const char *tsp_descs[] = {
93 [TASK_KERNEL_PORT] = "kernel",
94 [TASK_HOST_PORT] = "host",
95 [TASK_NAME_PORT] = "name",
96 [TASK_BOOTSTRAP_PORT] = "bootstrap",
97 [TASK_INSPECT_PORT] = "inspect",
98 [TASK_READ_PORT] = "read",
99 [TASK_ACCESS_PORT] = "access",
100 [TASK_DEBUG_CONTROL_PORT] = "debug control",
101 [TASK_RESOURCE_NOTIFY_PORT] = "resource notify",
102 };
103 _Static_assert(TASK_RESOURCE_NOTIFY_PORT == TASK_MAX_SPECIAL_PORT,
104 "all task special ports must have descriptions");
105
106 return tsp_descs[port_index];
107 }
108
109 const char *
mach_thread_special_port_description(int port)110 mach_thread_special_port_description(int port)
111 {
112 int port_index = (int)port;
113
114 if (port_index < 0 || port_index > THREAD_MAX_SPECIAL_PORT) {
115 return NULL;
116 }
117
118 static const char *tsp_descs[] = {
119 [THREAD_KERNEL_PORT] = "kernel",
120 [THREAD_INSPECT_PORT] = "inspect",
121 [THREAD_READ_PORT] = "read",
122 };
123 _Static_assert(THREAD_READ_PORT == THREAD_MAX_SPECIAL_PORT,
124 "all thread special ports must have descriptions");
125
126 return tsp_descs[port_index];
127 }
128
129 static int
port_for_id_internal(const char * id,const char ** ids,int nids)130 port_for_id_internal(const char *id, const char **ids, int nids)
131 {
132 if (!id) {
133 errno = EINVAL;
134 return -1;
135 }
136
137 for (int i = 0; i < nids; i++) {
138 if (ids[i] && strcmp(ids[i], id) == 0) {
139 return i;
140 }
141 }
142
143 errno = ENOENT;
144 return -1;
145 }
146
147 int
mach_host_special_port_for_id(const char * id)148 mach_host_special_port_for_id(const char *id)
149 {
150 static const char *hsp_ids[] = {
151 #define SP_ENTRY(id) [id] = #id
152 SP_ENTRY(HOST_PORT),
153 SP_ENTRY(HOST_PRIV_PORT),
154 SP_ENTRY(HOST_IO_MASTER_PORT),
155 SP_ENTRY(HOST_DYNAMIC_PAGER_PORT),
156 SP_ENTRY(HOST_AUDIT_CONTROL_PORT),
157 SP_ENTRY(HOST_USER_NOTIFICATION_PORT),
158 SP_ENTRY(HOST_AUTOMOUNTD_PORT),
159 SP_ENTRY(HOST_LOCKD_PORT),
160 SP_ENTRY(HOST_KTRACE_BACKGROUND_PORT),
161 SP_ENTRY(HOST_SEATBELT_PORT),
162 SP_ENTRY(HOST_KEXTD_PORT),
163 SP_ENTRY(HOST_LAUNCHCTL_PORT),
164 SP_ENTRY(HOST_UNFREED_PORT),
165 SP_ENTRY(HOST_AMFID_PORT),
166 SP_ENTRY(HOST_GSSD_PORT),
167 SP_ENTRY(HOST_TELEMETRY_PORT),
168 SP_ENTRY(HOST_ATM_NOTIFICATION_PORT),
169 SP_ENTRY(HOST_COALITION_PORT),
170 SP_ENTRY(HOST_SYSDIAGNOSE_PORT),
171 SP_ENTRY(HOST_XPC_EXCEPTION_PORT),
172 SP_ENTRY(HOST_CONTAINERD_PORT),
173 SP_ENTRY(HOST_NODE_PORT),
174 SP_ENTRY(HOST_RESOURCE_NOTIFY_PORT),
175 SP_ENTRY(HOST_CLOSURED_PORT),
176 SP_ENTRY(HOST_SYSPOLICYD_PORT),
177 SP_ENTRY(HOST_FILECOORDINATIOND_PORT),
178 };
179
180 return port_for_id_internal(id, hsp_ids,
181 sizeof(hsp_ids) / sizeof(hsp_ids[0]));
182 }
183
184 int
mach_task_special_port_for_id(const char * id)185 mach_task_special_port_for_id(const char *id)
186 {
187 static const char *tsp_ids[] = {
188 SP_ENTRY(TASK_KERNEL_PORT),
189 SP_ENTRY(TASK_HOST_PORT),
190 SP_ENTRY(TASK_NAME_PORT),
191 SP_ENTRY(TASK_BOOTSTRAP_PORT),
192 SP_ENTRY(TASK_INSPECT_PORT),
193 SP_ENTRY(TASK_READ_PORT),
194 SP_ENTRY(TASK_ACCESS_PORT),
195 SP_ENTRY(TASK_DEBUG_CONTROL_PORT),
196 SP_ENTRY(TASK_RESOURCE_NOTIFY_PORT),
197 };
198
199 return port_for_id_internal(id, tsp_ids,
200 sizeof(tsp_ids) / sizeof(tsp_ids[0]));
201 }
202
203 int
mach_thread_special_port_for_id(const char * id)204 mach_thread_special_port_for_id(const char *id)
205 {
206 static const char *tsp_ids[] = {
207 SP_ENTRY(THREAD_KERNEL_PORT),
208 SP_ENTRY(THREAD_INSPECT_PORT),
209 SP_ENTRY(THREAD_READ_PORT),
210 #undef SP_ENTRY
211 };
212
213 return port_for_id_internal(id, tsp_ids,
214 sizeof(tsp_ids) / sizeof(tsp_ids[0]));
215 }
216