1*f6217f89SApple OSS Distributions /* Copyright (c) 2020 Apple Computer, Inc. All rights reserved. */
2*f6217f89SApple OSS Distributions
3*f6217f89SApple OSS Distributions #include <CoreSymbolication/CoreSymbolication.h>
4*f6217f89SApple OSS Distributions #include <CoreSymbolication/CoreSymbolicationPrivate.h>
5*f6217f89SApple OSS Distributions #include <darwintest.h>
6*f6217f89SApple OSS Distributions #include <dispatch/dispatch.h>
7*f6217f89SApple OSS Distributions
8*f6217f89SApple OSS Distributions #include <mach-o/loader.h>
9*f6217f89SApple OSS Distributions
10*f6217f89SApple OSS Distributions #include <sys/kas_info.h>
11*f6217f89SApple OSS Distributions
12*f6217f89SApple OSS Distributions #include <sys/mman.h>
13*f6217f89SApple OSS Distributions #include <sys/stat.h>
14*f6217f89SApple OSS Distributions #include <sys/sysctl.h>
15*f6217f89SApple OSS Distributions #include <sys/types.h>
16*f6217f89SApple OSS Distributions
17*f6217f89SApple OSS Distributions #include <fcntl.h>
18*f6217f89SApple OSS Distributions
19*f6217f89SApple OSS Distributions #include <stdint.h>
20*f6217f89SApple OSS Distributions
21*f6217f89SApple OSS Distributions T_GLOBAL_META(
22*f6217f89SApple OSS Distributions T_META_NAMESPACE("xnu.kas_info"),
23*f6217f89SApple OSS Distributions T_META_CHECK_LEAKS(false),
24*f6217f89SApple OSS Distributions T_META_ASROOT(true));
25*f6217f89SApple OSS Distributions
26*f6217f89SApple OSS Distributions static bool
slide_enabled(void)27*f6217f89SApple OSS Distributions slide_enabled(void)
28*f6217f89SApple OSS Distributions {
29*f6217f89SApple OSS Distributions int slide_enabled, err;
30*f6217f89SApple OSS Distributions size_t size = sizeof(slide_enabled);
31*f6217f89SApple OSS Distributions err = sysctlbyname("kern.slide", &slide_enabled, &size, NULL, 0);
32*f6217f89SApple OSS Distributions T_ASSERT_POSIX_SUCCESS(err, "sysctl(\"kern.slide\");");
33*f6217f89SApple OSS Distributions return slide_enabled != 0;
34*f6217f89SApple OSS Distributions }
35*f6217f89SApple OSS Distributions
36*f6217f89SApple OSS Distributions static uint64_t
kernel_slide(int selector)37*f6217f89SApple OSS Distributions kernel_slide(int selector)
38*f6217f89SApple OSS Distributions {
39*f6217f89SApple OSS Distributions uint64_t slide;
40*f6217f89SApple OSS Distributions size_t size = sizeof(slide);
41*f6217f89SApple OSS Distributions int err = kas_info(selector, &slide, &size);
42*f6217f89SApple OSS Distributions if (err && errno == ENOTSUP) {
43*f6217f89SApple OSS Distributions T_SKIP("Running on kernel without kas_info");
44*f6217f89SApple OSS Distributions }
45*f6217f89SApple OSS Distributions
46*f6217f89SApple OSS Distributions T_ASSERT_POSIX_SUCCESS(errno, "kas_info with selector %d", selector);
47*f6217f89SApple OSS Distributions T_ASSERT_EQ(size, sizeof(slide), "returned size is valid");
48*f6217f89SApple OSS Distributions
49*f6217f89SApple OSS Distributions return slide;
50*f6217f89SApple OSS Distributions }
51*f6217f89SApple OSS Distributions
52*f6217f89SApple OSS Distributions T_DECL(kernel_text_slide,
53*f6217f89SApple OSS Distributions "ensures that kas_info can return the kernel text slide", T_META_TAG_VM_NOT_ELIGIBLE)
54*f6217f89SApple OSS Distributions {
55*f6217f89SApple OSS Distributions if (!slide_enabled()) {
56*f6217f89SApple OSS Distributions T_SKIP("KASLR is not enabled");
57*f6217f89SApple OSS Distributions __builtin_unreachable();
58*f6217f89SApple OSS Distributions }
59*f6217f89SApple OSS Distributions
60*f6217f89SApple OSS Distributions uint64_t slide = kernel_slide(KAS_INFO_KERNEL_TEXT_SLIDE_SELECTOR);
61*f6217f89SApple OSS Distributions
62*f6217f89SApple OSS Distributions T_ASSERT_GT_ULLONG(slide, 0ULL, "kernel slide is non-zero");
63*f6217f89SApple OSS Distributions }
64*f6217f89SApple OSS Distributions
65*f6217f89SApple OSS Distributions static void
test_kas_info_invalid_args(int selector)66*f6217f89SApple OSS Distributions test_kas_info_invalid_args(int selector)
67*f6217f89SApple OSS Distributions {
68*f6217f89SApple OSS Distributions uint64_t slide;
69*f6217f89SApple OSS Distributions size_t size = 0;
70*f6217f89SApple OSS Distributions int err;
71*f6217f89SApple OSS Distributions
72*f6217f89SApple OSS Distributions err = kas_info(selector, &slide, NULL);
73*f6217f89SApple OSS Distributions if (errno == ENOTSUP) {
74*f6217f89SApple OSS Distributions T_SKIP("Running on kernel without kas_info %d", selector);
75*f6217f89SApple OSS Distributions }
76*f6217f89SApple OSS Distributions T_ASSERT_POSIX_FAILURE(err, EFAULT, "kas_info %d with NULL size", selector);
77*f6217f89SApple OSS Distributions
78*f6217f89SApple OSS Distributions size = sizeof(uint64_t);
79*f6217f89SApple OSS Distributions err = kas_info(selector, NULL, &size);
80*f6217f89SApple OSS Distributions T_ASSERT_POSIX_FAILURE(err, EFAULT, "kas_info %d with NULL slide", selector);
81*f6217f89SApple OSS Distributions
82*f6217f89SApple OSS Distributions size = sizeof(uint32_t);
83*f6217f89SApple OSS Distributions err = kas_info(selector, &slide, &size);
84*f6217f89SApple OSS Distributions T_ASSERT_POSIX_FAILURE(err, EINVAL, "kas_info %d with invalid size", selector);
85*f6217f89SApple OSS Distributions }
86*f6217f89SApple OSS Distributions
87*f6217f89SApple OSS Distributions T_DECL(kernel_text_slide_invalid,
88*f6217f89SApple OSS Distributions "ensures that kas_info handles invalid input to KERNEL_TEXT_SLIDE_SELECTOR", T_META_TAG_VM_NOT_ELIGIBLE)
89*f6217f89SApple OSS Distributions {
90*f6217f89SApple OSS Distributions test_kas_info_invalid_args(KAS_INFO_KERNEL_TEXT_SLIDE_SELECTOR);
91*f6217f89SApple OSS Distributions }
92*f6217f89SApple OSS Distributions
93*f6217f89SApple OSS Distributions static bool
sptm_enabled(void)94*f6217f89SApple OSS Distributions sptm_enabled(void)
95*f6217f89SApple OSS Distributions {
96*f6217f89SApple OSS Distributions int page_protection_type, err;
97*f6217f89SApple OSS Distributions size_t size = sizeof(page_protection_type);
98*f6217f89SApple OSS Distributions err = sysctlbyname("kern.page_protection_type", &page_protection_type, &size, NULL, 0);
99*f6217f89SApple OSS Distributions T_ASSERT_POSIX_SUCCESS(err, "sysctl(\"kern.page_protection_type\");");
100*f6217f89SApple OSS Distributions return page_protection_type == 2;
101*f6217f89SApple OSS Distributions }
102*f6217f89SApple OSS Distributions
103*f6217f89SApple OSS Distributions T_DECL(sptm_txm_text_slide,
104*f6217f89SApple OSS Distributions "ensures that kas_info can return the SPTM/TXM text slides", T_META_TAG_VM_NOT_ELIGIBLE)
105*f6217f89SApple OSS Distributions {
106*f6217f89SApple OSS Distributions const uint64_t sptm_slide = kernel_slide(KAS_INFO_SPTM_TEXT_SLIDE_SELECTOR);
107*f6217f89SApple OSS Distributions const uint64_t txm_slide = kernel_slide(KAS_INFO_TXM_TEXT_SLIDE_SELECTOR);
108*f6217f89SApple OSS Distributions
109*f6217f89SApple OSS Distributions if (sptm_enabled()) {
110*f6217f89SApple OSS Distributions T_ASSERT_GT_ULLONG(sptm_slide, 0ULL, "Ensure the SPTM slide is non-zero on an SPTM-enabled system");
111*f6217f89SApple OSS Distributions T_ASSERT_GT_ULLONG(txm_slide, 0ULL, "Ensure the TXM slide is non-zero on an SPTM-enabled system");
112*f6217f89SApple OSS Distributions } else {
113*f6217f89SApple OSS Distributions /* When not running on an SPTM-enabled system, this selector should return zero. */
114*f6217f89SApple OSS Distributions T_ASSERT_EQ(sptm_slide, 0ULL, "Ensure the SPTM slide is zero on a non-SPTM system");
115*f6217f89SApple OSS Distributions T_ASSERT_EQ(txm_slide, 0ULL, "Ensure the TXM slide is zero on a non-SPTM system");
116*f6217f89SApple OSS Distributions }
117*f6217f89SApple OSS Distributions }
118*f6217f89SApple OSS Distributions
119*f6217f89SApple OSS Distributions T_DECL(sptm_txm_text_slide_invalid,
120*f6217f89SApple OSS Distributions "ensures that kas_info handles invalid input to [SPTM|TXM]_TEXT_SLIDE_SELECTOR", T_META_TAG_VM_NOT_ELIGIBLE)
121*f6217f89SApple OSS Distributions {
122*f6217f89SApple OSS Distributions test_kas_info_invalid_args(KAS_INFO_SPTM_TEXT_SLIDE_SELECTOR);
123*f6217f89SApple OSS Distributions test_kas_info_invalid_args(KAS_INFO_TXM_TEXT_SLIDE_SELECTOR);
124*f6217f89SApple OSS Distributions }
125*f6217f89SApple OSS Distributions
126*f6217f89SApple OSS Distributions static char const*
kernel_path(void)127*f6217f89SApple OSS Distributions kernel_path(void)
128*f6217f89SApple OSS Distributions {
129*f6217f89SApple OSS Distributions static CSSymbolicatorRef symbolicator;
130*f6217f89SApple OSS Distributions static char const* path;
131*f6217f89SApple OSS Distributions static dispatch_once_t once;
132*f6217f89SApple OSS Distributions dispatch_once(&once, ^{
133*f6217f89SApple OSS Distributions uint32_t flags = kCSSymbolicatorDefaultCreateFlags;
134*f6217f89SApple OSS Distributions symbolicator = CSSymbolicatorCreateWithMachKernelFlagsAndNotification(flags, NULL);
135*f6217f89SApple OSS Distributions T_QUIET; T_ASSERT_TRUE(!CSIsNull(symbolicator), "CSSymbolicatorCreateWithMachKernelFlagsAndNotification");
136*f6217f89SApple OSS Distributions path = CSSymbolOwnerGetPath(CSSymbolicatorGetAOutSymbolOwner(symbolicator));
137*f6217f89SApple OSS Distributions if (!path) {
138*f6217f89SApple OSS Distributions path = CSSymbolOwnerGetPath(CSSymbolicatorGetSymbolOwner(symbolicator));
139*f6217f89SApple OSS Distributions }
140*f6217f89SApple OSS Distributions T_QUIET; T_ASSERT_NOTNULL(path, "CSSymbolOwnerGetPath/CSSymbolicatorGetSymbolOwner");
141*f6217f89SApple OSS Distributions });
142*f6217f89SApple OSS Distributions return path;
143*f6217f89SApple OSS Distributions }
144*f6217f89SApple OSS Distributions
145*f6217f89SApple OSS Distributions static void
disk_kernel_segments(uint64_t ** segs_out,size_t * nsegs_out)146*f6217f89SApple OSS Distributions disk_kernel_segments(uint64_t **segs_out, size_t *nsegs_out)
147*f6217f89SApple OSS Distributions {
148*f6217f89SApple OSS Distributions char const* path = kernel_path();
149*f6217f89SApple OSS Distributions int fd = open(path, O_RDONLY);
150*f6217f89SApple OSS Distributions int err;
151*f6217f89SApple OSS Distributions struct stat sb;
152*f6217f89SApple OSS Distributions size_t nsegs = 0;
153*f6217f89SApple OSS Distributions uint64_t *segs = NULL;
154*f6217f89SApple OSS Distributions void *data;
155*f6217f89SApple OSS Distributions
156*f6217f89SApple OSS Distributions T_LOG("Kernel file is %s", path);
157*f6217f89SApple OSS Distributions T_QUIET; T_ASSERT_POSIX_SUCCESS(fd, "open kernel file");
158*f6217f89SApple OSS Distributions
159*f6217f89SApple OSS Distributions err = fstat(fd, &sb);
160*f6217f89SApple OSS Distributions T_ASSERT_POSIX_SUCCESS(err, "fstat kernel file");
161*f6217f89SApple OSS Distributions
162*f6217f89SApple OSS Distributions data = mmap(NULL, (size_t)sb.st_size, PROT_READ, MAP_SHARED, fd, 0);
163*f6217f89SApple OSS Distributions T_ASSERT_NE(data, MAP_FAILED, "mmap kernel file");
164*f6217f89SApple OSS Distributions
165*f6217f89SApple OSS Distributions /*
166*f6217f89SApple OSS Distributions * TODO: If we bring back FAT kernel binaries
167*f6217f89SApple OSS Distributions * this will need to be fixed to handle them properly
168*f6217f89SApple OSS Distributions */
169*f6217f89SApple OSS Distributions uint32_t magic = *(uint32_t*)data;
170*f6217f89SApple OSS Distributions struct load_command *cmd = NULL;
171*f6217f89SApple OSS Distributions
172*f6217f89SApple OSS Distributions switch (magic) {
173*f6217f89SApple OSS Distributions case MH_MAGIC: OS_FALLTHROUGH;
174*f6217f89SApple OSS Distributions case MH_CIGAM: {
175*f6217f89SApple OSS Distributions struct mach_header *mh = (struct mach_header *)data;
176*f6217f89SApple OSS Distributions cmd = (struct load_command *)(&(mh[1]));
177*f6217f89SApple OSS Distributions nsegs = mh->ncmds;
178*f6217f89SApple OSS Distributions }
179*f6217f89SApple OSS Distributions break;
180*f6217f89SApple OSS Distributions case MH_MAGIC_64: OS_FALLTHROUGH;
181*f6217f89SApple OSS Distributions case MH_CIGAM_64: {
182*f6217f89SApple OSS Distributions struct mach_header_64 *mh = (struct mach_header_64 *)data;
183*f6217f89SApple OSS Distributions cmd = (struct load_command *)(&(mh[1]));
184*f6217f89SApple OSS Distributions nsegs = mh->ncmds;
185*f6217f89SApple OSS Distributions }
186*f6217f89SApple OSS Distributions break;
187*f6217f89SApple OSS Distributions default:
188*f6217f89SApple OSS Distributions T_FAIL("kernel file is not a Mach-O file, magic is %x", magic);
189*f6217f89SApple OSS Distributions }
190*f6217f89SApple OSS Distributions
191*f6217f89SApple OSS Distributions /* Adjust for the LC_UUID && LC_BUILD_VERSION commands in front of
192*f6217f89SApple OSS Distributions * load commands for dSYMs
193*f6217f89SApple OSS Distributions */
194*f6217f89SApple OSS Distributions while (cmd->cmd != LC_SEGMENT && cmd->cmd != LC_SEGMENT_64) {
195*f6217f89SApple OSS Distributions cmd = (struct load_command *) ((uintptr_t) cmd + cmd->cmdsize);
196*f6217f89SApple OSS Distributions nsegs--;
197*f6217f89SApple OSS Distributions }
198*f6217f89SApple OSS Distributions
199*f6217f89SApple OSS Distributions segs = calloc(nsegs, sizeof(*segs));
200*f6217f89SApple OSS Distributions T_ASSERT_NOTNULL(segs, "calloc disk segment array");
201*f6217f89SApple OSS Distributions
202*f6217f89SApple OSS Distributions for (uint8_t i = 0; i < nsegs; i++) {
203*f6217f89SApple OSS Distributions if (cmd->cmd == LC_SEGMENT) {
204*f6217f89SApple OSS Distributions struct segment_command *sg = (struct segment_command *) cmd;
205*f6217f89SApple OSS Distributions if (sg->vmsize > 0) {
206*f6217f89SApple OSS Distributions segs[i] = sg->vmaddr;
207*f6217f89SApple OSS Distributions }
208*f6217f89SApple OSS Distributions } else if (cmd->cmd == LC_SEGMENT_64) {
209*f6217f89SApple OSS Distributions struct segment_command_64 *sg = (struct segment_command_64 *) cmd;
210*f6217f89SApple OSS Distributions if (sg->vmsize > 0) {
211*f6217f89SApple OSS Distributions segs[i] = sg->vmaddr;
212*f6217f89SApple OSS Distributions }
213*f6217f89SApple OSS Distributions }
214*f6217f89SApple OSS Distributions cmd = (struct load_command *) ((uintptr_t) cmd + cmd->cmdsize);
215*f6217f89SApple OSS Distributions }
216*f6217f89SApple OSS Distributions
217*f6217f89SApple OSS Distributions *segs_out = segs;
218*f6217f89SApple OSS Distributions *nsegs_out = nsegs;
219*f6217f89SApple OSS Distributions
220*f6217f89SApple OSS Distributions err = munmap(data, (size_t)sb.st_size);
221*f6217f89SApple OSS Distributions
222*f6217f89SApple OSS Distributions err = close(fd);
223*f6217f89SApple OSS Distributions T_ASSERT_POSIX_SUCCESS(err, "close kernel fd");
224*f6217f89SApple OSS Distributions }
225*f6217f89SApple OSS Distributions
226*f6217f89SApple OSS Distributions static bool
is_fileset_kc(void)227*f6217f89SApple OSS Distributions is_fileset_kc(void)
228*f6217f89SApple OSS Distributions {
229*f6217f89SApple OSS Distributions char uuid[1024];
230*f6217f89SApple OSS Distributions int err;
231*f6217f89SApple OSS Distributions size_t size = sizeof(uuid);
232*f6217f89SApple OSS Distributions err = sysctlbyname("kern.filesetuuid", uuid, &size, NULL, 0);
233*f6217f89SApple OSS Distributions return err == 0;
234*f6217f89SApple OSS Distributions }
235*f6217f89SApple OSS Distributions
236*f6217f89SApple OSS Distributions #define KAS_INFO_KERNEL_SEGMENT_LOCATION_SELECTOR 1
237*f6217f89SApple OSS Distributions
238*f6217f89SApple OSS Distributions T_DECL(kernel_segment_location,
239*f6217f89SApple OSS Distributions "ensures that KAS_INFO_KERNEL_SEGMENT_LOCATION returns correct segment locations", T_META_TAG_VM_NOT_ELIGIBLE)
240*f6217f89SApple OSS Distributions {
241*f6217f89SApple OSS Distributions int err;
242*f6217f89SApple OSS Distributions
243*f6217f89SApple OSS Distributions if (!slide_enabled()) {
244*f6217f89SApple OSS Distributions T_SKIP("KASLR is not enabled");
245*f6217f89SApple OSS Distributions __builtin_unreachable();
246*f6217f89SApple OSS Distributions }
247*f6217f89SApple OSS Distributions
248*f6217f89SApple OSS Distributions uint64_t *disk_segs;
249*f6217f89SApple OSS Distributions size_t disk_nsegs;
250*f6217f89SApple OSS Distributions disk_kernel_segments(&disk_segs, &disk_nsegs);
251*f6217f89SApple OSS Distributions
252*f6217f89SApple OSS Distributions size_t size = 0;
253*f6217f89SApple OSS Distributions
254*f6217f89SApple OSS Distributions err = kas_info(KAS_INFO_KERNEL_SEGMENT_VMADDR_SELECTOR, NULL, &size);
255*f6217f89SApple OSS Distributions if (errno == ENOTSUP) {
256*f6217f89SApple OSS Distributions T_SKIP("KAS_INFO_KERNEL_SEGMENT_VMADDR_SELECTOR not supported");
257*f6217f89SApple OSS Distributions }
258*f6217f89SApple OSS Distributions T_ASSERT_POSIX_SUCCESS(err, "kas_info KAS_INFO_KERNEL_SEGMENT_VMADDR_SELECTOR for size");
259*f6217f89SApple OSS Distributions
260*f6217f89SApple OSS Distributions uint64_t mem_nsegs = size / sizeof(uint64_t);
261*f6217f89SApple OSS Distributions uint64_t *mem_segs = calloc(mem_nsegs, sizeof(*disk_segs));
262*f6217f89SApple OSS Distributions
263*f6217f89SApple OSS Distributions err = kas_info(KAS_INFO_KERNEL_SEGMENT_VMADDR_SELECTOR, mem_segs, &size);
264*f6217f89SApple OSS Distributions if (errno == ENOTSUP) {
265*f6217f89SApple OSS Distributions T_SKIP("KAS_INFO_KERNEL_SEGMENT_VMADDR_SELECTOR not supported");
266*f6217f89SApple OSS Distributions }
267*f6217f89SApple OSS Distributions
268*f6217f89SApple OSS Distributions T_ASSERT_POSIX_SUCCESS(err, "kas_info KAS_INFO_KERNEL_SEGMENT_VMADDR_SELECTOR for data");
269*f6217f89SApple OSS Distributions
270*f6217f89SApple OSS Distributions T_LOG("Kernel has %zu segments on disk, %zu in memory:", disk_nsegs, mem_nsegs);
271*f6217f89SApple OSS Distributions for (size_t i = 0; i < disk_nsegs; i++) {
272*f6217f89SApple OSS Distributions T_LOG("%zu %llx %llx", i, disk_segs[i], mem_segs[i]);
273*f6217f89SApple OSS Distributions }
274*f6217f89SApple OSS Distributions
275*f6217f89SApple OSS Distributions /*
276*f6217f89SApple OSS Distributions * If the kernel is not a fileset, verify that all
277*f6217f89SApple OSS Distributions * the segments in memory are the segment on disk
278*f6217f89SApple OSS Distributions * + the kaslr slide
279*f6217f89SApple OSS Distributions */
280*f6217f89SApple OSS Distributions if (!is_fileset_kc()) {
281*f6217f89SApple OSS Distributions T_LOG("Kernelcache is not a fileset kernelcache");
282*f6217f89SApple OSS Distributions
283*f6217f89SApple OSS Distributions uint64_t slide = kernel_slide(KAS_INFO_KERNEL_TEXT_SLIDE_SELECTOR);
284*f6217f89SApple OSS Distributions for (size_t i = 0; i < disk_nsegs; i++) {
285*f6217f89SApple OSS Distributions if (disk_segs[i] == 0 || mem_segs[i] == 0) {
286*f6217f89SApple OSS Distributions continue;
287*f6217f89SApple OSS Distributions }
288*f6217f89SApple OSS Distributions T_ASSERT_EQ(disk_segs[i] + slide, mem_segs[i], "segment %zu is slid", i);
289*f6217f89SApple OSS Distributions }
290*f6217f89SApple OSS Distributions }
291*f6217f89SApple OSS Distributions
292*f6217f89SApple OSS Distributions free(disk_segs);
293*f6217f89SApple OSS Distributions free(mem_segs);
294*f6217f89SApple OSS Distributions }
295