xref: /xnu-12377.1.9/tests/kas_info.c (revision f6217f891ac0bb64f3d375211650a4c1ff8ca1ea)
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