1 | /*␊ |
2 | * Copyright 2010 Evan Lojewski. All rights reserved.␊ |
3 | *␊ |
4 | */␊ |
5 | ␊ |
6 | #include "boot.h"␊ |
7 | #include "bootstruct.h"␊ |
8 | #include "multiboot.h"␊ |
9 | #include "modules.h"␊ |
10 | ␊ |
11 | #ifndef DEBUG_MODULES␊ |
12 | #define DEBUG_MODULES 0␊ |
13 | #endif␊ |
14 | ␊ |
15 | #if DEBUG_MODULES␊ |
16 | #define DBG(x...)␉printf(x)␊ |
17 | #else␊ |
18 | #define DBG(x...)␊ |
19 | #endif␊ |
20 | ␊ |
21 | // NOTE: Global so that modules can link with this␊ |
22 | unsigned long long textAddress = 0;␊ |
23 | unsigned long long textSection = 0;␊ |
24 | ␊ |
25 | moduleHook_t* moduleCallbacks = NULL;␊ |
26 | moduleList_t* loadedModules = NULL;␊ |
27 | symbolList_t* moduleSymbols = NULL;␊ |
28 | unsigned int (*lookup_symbol)(const char*) = NULL;␊ |
29 | ␊ |
30 | ␊ |
31 | ␊ |
32 | #define MOD_ERROR 0␊ |
33 | #define MOD_SUCCESS 1␊ |
34 | #define MOD_ALREADY_LOADED 2␊ |
35 | #define MOD_START_ERROR 3␊ |
36 | ␊ |
37 | #if DEBUG_MODULES␊ |
38 | void print_hook_list()␊ |
39 | {␊ |
40 | ␉moduleHook_t* hooks = moduleCallbacks;␊ |
41 | ␉printf("Hook list: \n");␊ |
42 | ␉while(hooks)␊ |
43 | ␉{␊ |
44 | ␉␉printf("* %s\n", hooks->name);␊ |
45 | ␉␉hooks = hooks->next;␊ |
46 | ␉}␊ |
47 | ␉printf("\n");␊ |
48 | }␊ |
49 | ␊ |
50 | void print_symbol_list()␊ |
51 | {␊ |
52 | ␉symbolList_t* symbol = moduleSymbols;␊ |
53 | ␉printf("Symbol list: \n");␊ |
54 | ␉while(symbol)␊ |
55 | ␉{␊ |
56 | ␉␉printf("* %s\n", symbol->symbol);␊ |
57 | ␉␉symbol = symbol->next;␊ |
58 | ␉}␊ |
59 | ␉printf("\n");␊ |
60 | }␊ |
61 | #endif␊ |
62 | ␊ |
63 | ␊ |
64 | /*␊ |
65 | * Initialize the module system by loading the Symbols.dylib module.␊ |
66 | * Once loaded, locate the _lookup_symbol function so that internal␊ |
67 | * symbols can be resolved.␊ |
68 | */␊ |
69 | int init_module_system()␊ |
70 | {␊ |
71 | ␉// Intialize module system␊ |
72 | ␉if(load_module(SYMBOLS_MODULE))␊ |
73 | ␉{␊ |
74 | ␉␉lookup_symbol = (void*)lookup_all_symbols(SYMBOL_LOOKUP_SYMBOL);␊ |
75 | ␉␉␊ |
76 | ␉␉if((UInt32)lookup_symbol != 0xFFFFFFFF)␊ |
77 | ␉␉{␊ |
78 | ␉␉␉return MOD_SUCCESS;␊ |
79 | ␉␉}␊ |
80 | ␉␉␊ |
81 | ␉}␊ |
82 | ␉␊ |
83 | ␉return MOD_ERROR;␊ |
84 | }␊ |
85 | ␊ |
86 | ␊ |
87 | /*␊ |
88 | * Load all modules in the /Extra/modules/ directory␊ |
89 | * Module depencdies will be loaded first␊ |
90 | * MOdules will only be loaded once. When loaded a module must␊ |
91 | * setup apropriete function calls and hooks as required.␊ |
92 | * NOTE: To ensure a module loads after another you may ␊ |
93 | * link one module with the other. For dyld to allow this, you must␊ |
94 | * reference at least one symbol within the module.␊ |
95 | */␊ |
96 | ␊ |
97 | void load_all_modules()␊ |
98 | {␊ |
99 | ␉char* name;␊ |
100 | ␉long flags;␊ |
101 | ␉long time;␊ |
102 | ␉struct dirstuff* moduleDir = opendir("/Extra/modules/");␊ |
103 | ␉while(readdir(moduleDir, (const char**)&name, &flags, &time) >= 0)␊ |
104 | ␉{␊ |
105 | ␉␉if(strcmp(&name[strlen(name) - sizeof("dylib")], ".dylib") == 0)␊ |
106 | ␉␉{␊ |
107 | ␉␉␉char* tmp = malloc(strlen(name) + 1);␊ |
108 | ␉␉␉strcpy(tmp, name);␊ |
109 | ␉␉␉␊ |
110 | ␉␉␉DBG("Attempting to load %s\n", tmp);␉␉␉␊ |
111 | ␉␉␉//load_module(tmp);␊ |
112 | ␉␉␉if(load_module(tmp) != MOD_SUCCESS)␊ |
113 | ␉␉␉{␊ |
114 | ␉␉␉␉// failed to load␊ |
115 | ␉␉␉␉ free(tmp);␊ |
116 | ␉␉␉}␊ |
117 | ␉␉}␊ |
118 | ␉␉else ␊ |
119 | ␉␉{␊ |
120 | ␉␉␉DBG("Ignoring %s\n", name);␊ |
121 | ␉␉}␊ |
122 | ␊ |
123 | ␉}␊ |
124 | ␉//print_symbol_list();␊ |
125 | }␊ |
126 | ␊ |
127 | /*␊ |
128 | * Load a module file in /Extra/modules␊ |
129 | * TODO: verify version number of module␊ |
130 | */␊ |
131 | int load_module(char* module)␊ |
132 | {␊ |
133 | ␉void (*module_start)(void) = NULL;␊ |
134 | ␊ |
135 | ␉␊ |
136 | ␉// Check to see if the module has already been loaded␊ |
137 | ␉if(is_module_loaded(module))␊ |
138 | ␉{␊ |
139 | ␉␉// NOTE: Symbols.dylib tries to load twice, this catches it as well␊ |
140 | ␉␉// as when a module links with an already loaded module␊ |
141 | ␉␉DBG("Module %s already loaded\n", module);␊ |
142 | ␉␉return MOD_ALREADY_LOADED;␊ |
143 | ␉}␊ |
144 | ␉␊ |
145 | ␉char modString[128];␊ |
146 | ␉int fh = -1;␊ |
147 | ␉sprintf(modString, "/Extra/modules/%s", module);␊ |
148 | ␉fh = open(modString, 0);␊ |
149 | ␉if(fh < 0)␊ |
150 | ␉{␉␉␊ |
151 | #if DEBUG_MODULES␊ |
152 | ␉␉␉printf("Unable to locate module %s\n", modString);␊ |
153 | ␉␉␉getc();␊ |
154 | #endif␊ |
155 | ␉␉␉return MOD_ERROR;␉␉␊ |
156 | ␉}␊ |
157 | ␉int ret = MOD_SUCCESS;␊ |
158 | ␉unsigned int moduleSize = file_size(fh);␊ |
159 | ␉char* module_base = (char*) malloc(moduleSize);␊ |
160 | ␉if (moduleSize && read(fh, module_base, moduleSize) == moduleSize)␊ |
161 | ␉{␊ |
162 | ␊ |
163 | ␉␉DBG("Module %s read in.\n", modString);␊ |
164 | ␊ |
165 | ␉␉// Module loaded into memory, parse it␊ |
166 | ␉␉module_start = parse_mach(module_base, &load_module, &add_symbol);␊ |
167 | ␊ |
168 | ␉␉if(module_start && module_start != (void*)0xFFFFFFFF)␊ |
169 | ␉␉{␊ |
170 | ␉␉␉// Notify the system that it was laoded␊ |
171 | ␉␉␉module_loaded(module/*moduleName, moduleVersion, moduleCompat*/);␊ |
172 | ␉␉␉(*module_start)();␉// Start the module␊ |
173 | ␉␉␉DBG("Module %s Loaded.\n", module);␊ |
174 | ␉␉}␊ |
175 | ␉␉else {␊ |
176 | ␉␉␉// The module does not have a valid start function␊ |
177 | ␉␉␉printf("Unable to start %s\n", module);␉␊ |
178 | ␉␉␉ret = MOD_START_ERROR;␊ |
179 | #if DEBUG_MODULES␉␉␉␊ |
180 | ␉␉␉getc();␊ |
181 | #endif␊ |
182 | ␉␉}␉␉␊ |
183 | ␉}␊ |
184 | ␉else␊ |
185 | ␉{␊ |
186 | ␉␉printf("Unable to read in module %s\n.", module);␊ |
187 | #if DEBUG_MODULES␉␉␊ |
188 | ␉␉getc();␊ |
189 | #endif␊ |
190 | ␉␉ret = MOD_ERROR;␊ |
191 | ␉}␊ |
192 | ␉close(fh);␊ |
193 | ␉return ret;␊ |
194 | }␊ |
195 | ␊ |
196 | moduleHook_t* get_callback(const char* name)␊ |
197 | {␊ |
198 | ␉moduleHook_t* hooks = moduleCallbacks;␊ |
199 | ␉␊ |
200 | ␉// look for a hook. If it exists, return the moduleHook_t*,␊ |
201 | ␉// If not, return NULL.␊ |
202 | ␉while(hooks)␊ |
203 | ␉{␊ |
204 | ␉␉if(strcmp(name, hooks->name) == 0)␊ |
205 | ␉␉{␊ |
206 | ␉␉␉//DBG("Located hook %s\n", name);␊ |
207 | ␉␉␉return hooks;␊ |
208 | ␉␉}␊ |
209 | ␉␉hooks = hooks->next;␊ |
210 | ␉}␊ |
211 | ␉return NULL;␊ |
212 | ␉␊ |
213 | }␊ |
214 | ␊ |
215 | /*␊ |
216 | *␉execute_hook( const char* name )␊ |
217 | *␉␉name - Name of the module hook␊ |
218 | *␉␉␉If any callbacks have been registered for this hook␊ |
219 | *␉␉␉they will be executed now in the same order that the␊ |
220 | *␉␉␉hooks were added.␊ |
221 | */␊ |
222 | int execute_hook(const char* name, void* arg1, void* arg2, void* arg3, void* arg4, void* arg5, void* arg6)␊ |
223 | {␊ |
224 | ␉DBG("Attempting to execute hook '%s'\n", name);␊ |
225 | ␉moduleHook_t* hook = get_callback(name);␊ |
226 | ␉␊ |
227 | ␉if(hook)␊ |
228 | ␉{␊ |
229 | ␉␉// Loop through all callbacks for this module␊ |
230 | ␉␉callbackList_t* callbacks = hook->callbacks;␊ |
231 | ␉␉␊ |
232 | ␉␉while(callbacks)␊ |
233 | ␉␉{␊ |
234 | ␉␉␉// Execute callback␊ |
235 | ␉␉␉callbacks->callback(arg1, arg2, arg3, arg4, arg5, arg6);␊ |
236 | ␉␉␉callbacks = callbacks->next;␊ |
237 | ␉␉}␊ |
238 | ␉␉DBG("Hook '%s' executed.\n", name); ␊ |
239 | ␉␉return MOD_SUCCESS;␊ |
240 | ␉}␊ |
241 | ␉␊ |
242 | ␉// Callback for this hook doesn't exist;␊ |
243 | ␉DBG("No callbacks for '%s' hook.\n", name);␊ |
244 | ␉return MOD_ERROR;␊ |
245 | ␉␊ |
246 | }␊ |
247 | ␊ |
248 | ␊ |
249 | ␊ |
250 | /*␊ |
251 | *␉register_hook_callback( const char* name, void(*callback)())␊ |
252 | *␉␉name - Name of the module hook to attach to.␊ |
253 | *␉␉callbacks - The funciton pointer that will be called when the␊ |
254 | *␉␉␉hook is executed. When registering a new callback name, the callback is added sorted.␊ |
255 | *␉␉␉NOTE: the hooks take four void* arguments.␊ |
256 | */␊ |
257 | void register_hook_callback(const char* name, void(*callback)(void*, void*, void*, void*, void*, void*))␊ |
258 | {␉␊ |
259 | ␉DBG("Adding callback for '%s' hook.\n", name);␊ |
260 | ␉␊ |
261 | ␉moduleHook_t* hook = get_callback(name);␊ |
262 | ␉␊ |
263 | ␉if(hook)␊ |
264 | ␉{␊ |
265 | ␉␉// append␊ |
266 | ␉␉callbackList_t* newCallback = malloc(sizeof(callbackList_t));␊ |
267 | ␉␉newCallback->next = hook->callbacks;␊ |
268 | ␉␉hook->callbacks = newCallback;␊ |
269 | ␉␉newCallback->callback = callback;␊ |
270 | ␉}␊ |
271 | ␉else␊ |
272 | ␉{␊ |
273 | ␉␉// create new hook␊ |
274 | ␉␉moduleHook_t* newHook = malloc(sizeof(moduleHook_t));␉␉␊ |
275 | ␉␉newHook->name = name;␊ |
276 | ␉␉newHook->callbacks = malloc(sizeof(callbackList_t));␊ |
277 | ␉␉newHook->callbacks->callback = callback;␊ |
278 | ␉␉newHook->callbacks->next = NULL;␊ |
279 | ␉␉␊ |
280 | ␉␉newHook->next = moduleCallbacks;␊ |
281 | ␉␉moduleCallbacks = newHook;␊ |
282 | ␉␉␊ |
283 | ␉}␊ |
284 | ␉␊ |
285 | #if DEBUG_MODULES␊ |
286 | ␉print_hook_list();␊ |
287 | ␉getc();␊ |
288 | #endif␊ |
289 | ␉␊ |
290 | }␊ |
291 | ␊ |
292 | #if DEBUG_MODULES␊ |
293 | unsigned long vmaddr;␊ |
294 | long vmsize;␊ |
295 | #endif␊ |
296 | ␊ |
297 | /*␊ |
298 | * Parse through a macho module. The module will be rebased and binded␊ |
299 | * as specified in the macho header. If the module is sucessfuly laoded␊ |
300 | * the module iinit address will be returned.␊ |
301 | * NOTE; all dependecies will be loaded before this module is started␊ |
302 | * NOTE: If the module is unable to load ot completeion, the modules␊ |
303 | * symbols will still be available (TODO: fix this). This should not␊ |
304 | * happen as all dependencies are verified before the sybols are read in.␊ |
305 | */␊ |
306 | void* parse_mach(void* binary, int(*dylib_loader)(char*), long long(*symbol_handler)(char*, long long, char))␉// TODO: add param to specify valid archs␊ |
307 | {␉␊ |
308 | ␉char is64 = false;␊ |
309 | ␉void (*module_start)(void) = NULL;␊ |
310 | ␉␊ |
311 | ␉// Module info␊ |
312 | ␉/*char* moduleName = NULL;␊ |
313 | ␉UInt32 moduleVersion = 0;␊ |
314 | ␉UInt32 moduleCompat = 0;␊ |
315 | ␉*/␊ |
316 | ␉// TODO convert all of the structs to a union␊ |
317 | ␉struct load_command *loadCommand = NULL;␊ |
318 | ␉struct dylib_command* dylibCommand = NULL;␊ |
319 | ␉struct dyld_info_command* dyldInfoCommand = NULL;␊ |
320 | ␉␊ |
321 | ␉struct symtab_command* symtabCommand = NULL;␊ |
322 | ␉struct segment_command *segCommand = NULL;␊ |
323 | ␉struct segment_command_64 *segCommand64 = NULL;␊ |
324 | ␊ |
325 | ␉//struct dysymtab_command* dysymtabCommand = NULL;␊ |
326 | ␉UInt32 binaryIndex = 0;␊ |
327 | ␉UInt16 cmd = 0;␊ |
328 | ␊ |
329 | ␉// Parse through the load commands␊ |
330 | ␉if(((struct mach_header*)binary)->magic == MH_MAGIC)␊ |
331 | ␉{␊ |
332 | ␉␉is64 = false;␊ |
333 | ␉␉binaryIndex += sizeof(struct mach_header);␊ |
334 | ␉}␊ |
335 | ␉else if(((struct mach_header_64*)binary)->magic == MH_MAGIC_64)␊ |
336 | ␉{␊ |
337 | ␉␉// NOTE: modules cannot be 64bit...␊ |
338 | ␉␉is64 = true;␊ |
339 | ␉␉binaryIndex += sizeof(struct mach_header_64);␊ |
340 | ␉}␊ |
341 | ␉else␊ |
342 | ␉{␊ |
343 | ␉␉printf("Invalid mach magic\n");␊ |
344 | ␉␉getc();␊ |
345 | ␉␉return NULL;␊ |
346 | ␉}␊ |
347 | ␊ |
348 | ␊ |
349 | ␉␊ |
350 | ␉/*if(((struct mach_header*)binary)->filetype != MH_DYLIB)␊ |
351 | ␉{␊ |
352 | ␉␉printf("Module is not a dylib. Unable to load.\n");␊ |
353 | ␉␉getc();␊ |
354 | ␉␉return NULL; // Module is in the incorrect format␊ |
355 | ␉}*/␊ |
356 | ␉␊ |
357 | ␉while(cmd < ((struct mach_header*)binary)->ncmds)␊ |
358 | ␉{␊ |
359 | ␉␉cmd++;␊ |
360 | ␉␉␊ |
361 | ␉␉loadCommand = binary + binaryIndex;␊ |
362 | ␉␉UInt32 cmdSize = loadCommand->cmdsize;␊ |
363 | ␊ |
364 | ␉␉␊ |
365 | ␉␉switch ((loadCommand->cmd & 0x7FFFFFFF))␊ |
366 | ␉␉{␊ |
367 | ␉␉␉case LC_SYMTAB:␊ |
368 | ␉␉␉␉symtabCommand = binary + binaryIndex;␊ |
369 | ␉␉␉␉break;␊ |
370 | ␉␉␉␉␊ |
371 | ␉␉␉case LC_SEGMENT: // 32bit macho␊ |
372 | ␉␉␉␉segCommand = binary + binaryIndex;␊ |
373 | ␉␉␉␉␊ |
374 | ␉␉␉␉//printf("Segment name is %s\n", segCommand->segname);␊ |
375 | ␉␉␉␉␊ |
376 | ␉␉␉␉if(strcmp("__TEXT", segCommand->segname) == 0)␊ |
377 | ␉␉␉␉{␊ |
378 | ␉␉␉␉␉UInt32 sectionIndex;␊ |
379 | ␉␉␉␉␉␊ |
380 | #if DEBUG_MODULES_r␉␉␉␊ |
381 | ␉␉␉␉␉unsigned long fileaddr;␊ |
382 | ␉␉␉␉␉long filesize;␉␉␉␉␉␊ |
383 | ␉␉␉␉␉vmaddr = (segCommand->vmaddr & 0x3fffffff);␊ |
384 | ␉␉␉␉␉vmsize = segCommand->vmsize;␉ ␊ |
385 | ␉␉␉␉␉fileaddr = ((unsigned long)(binary + binaryIndex) + segCommand->fileoff);␊ |
386 | ␉␉␉␉␉filesize = segCommand->filesize;␊ |
387 | ␉␉␉␉␉␊ |
388 | ␉␉␉␉␉printf("segname: %s, vmaddr: %x, vmsize: %x, fileoff: %x, filesize: %x, nsects: %d, flags: %x.\n",␊ |
389 | ␉␉␉␉␉␉ segCommand->segname, (unsigned)vmaddr, (unsigned)vmsize, (unsigned)fileaddr, (unsigned)filesize,␊ |
390 | ␉␉␉␉␉␉ (unsigned) segCommand->nsects, (unsigned)segCommand->flags);␊ |
391 | ␉␉␉␉␉getc();␊ |
392 | #endif␊ |
393 | ␉␉␉␉␉sectionIndex = sizeof(struct segment_command);␊ |
394 | ␉␉␉␉␉␊ |
395 | ␉␉␉␉␉struct section *sect;␊ |
396 | ␉␉␉␉␉␊ |
397 | ␉␉␉␉␉while(sectionIndex < segCommand->cmdsize)␊ |
398 | ␉␉␉␉␉{␊ |
399 | ␉␉␉␉␉␉sect = binary + binaryIndex + sectionIndex;␊ |
400 | ␉␉␉␉␉␉␊ |
401 | ␉␉␉␉␉␉sectionIndex += sizeof(struct section);␊ |
402 | ␉␉␉␉␉␉␊ |
403 | ␉␉␉␉␉␉␊ |
404 | ␉␉␉␉␉␉if(strcmp("__text", sect->sectname) == 0)␊ |
405 | ␉␉␉␉␉␉{␊ |
406 | ␉␉␉␉␉␉␉// __TEXT,__text found, save the offset and address for when looking for the calls.␊ |
407 | ␉␉␉␉␉␉␉textSection = sect->offset;␊ |
408 | ␉␉␉␉␉␉␉textAddress = sect->addr;␊ |
409 | ␉␉␉␉␉␉␉break;␊ |
410 | ␉␉␉␉␉␉}␉␉␉␉␉␊ |
411 | ␉␉␉␉␉}␊ |
412 | ␉␉␉␉}␊ |
413 | ␉␉␉␉break;␊ |
414 | ␉␉␉case LC_SEGMENT_64:␉// 64bit macho's␊ |
415 | ␉␉␉␉segCommand64 = binary + binaryIndex;␊ |
416 | ␉␉␉␉␊ |
417 | ␉␉␉␉//printf("Segment name is %s\n", segCommand->segname);␊ |
418 | ␉␉␉␉␊ |
419 | ␉␉␉␉if(strcmp("__TEXT", segCommand64->segname) == 0)␊ |
420 | ␉␉␉␉{␊ |
421 | ␉␉␉␉␉UInt32 sectionIndex;␊ |
422 | ␉␉␉␉␉␊ |
423 | #if DEBUG_MODULES_r␉␉␉␉␉␊ |
424 | ␉␉␉␉␉␊ |
425 | ␉␉␉␉␉unsigned long fileaddr;␊ |
426 | ␉␉␉␉␉long filesize;␉␉␉␉␉␊ |
427 | ␉␉␉␉␉vmaddr = (segCommand64->vmaddr & 0x3fffffff);␊ |
428 | ␉␉␉␉␉vmsize = segCommand64->vmsize;␉ ␊ |
429 | ␉␉␉␉␉fileaddr = ((unsigned long)(binary + binaryIndex) + segCommand64->fileoff);␊ |
430 | ␉␉␉␉␉filesize = segCommand64->filesize;␊ |
431 | ␉␉␉␉␉␊ |
432 | ␉␉␉␉␉printf("segname: %s, vmaddr: %x, vmsize: %x, fileoff: %x, filesize: %x, nsects: %d, flags: %x.\n",␊ |
433 | ␉␉␉␉␉␉ segCommand64->segname, (unsigned)vmaddr, (unsigned)vmsize, (unsigned)fileaddr, (unsigned)filesize,␊ |
434 | ␉␉␉␉␉␉ (unsigned) segCommand64->nsects, (unsigned)segCommand64->flags);␊ |
435 | ␉␉␉␉␉getc();␊ |
436 | #endif␊ |
437 | ␉␉␉␉␉␊ |
438 | ␉␉␉␉␉sectionIndex = sizeof(struct segment_command_64);␊ |
439 | ␉␉␉␉␉␊ |
440 | ␉␉␉␉␉struct section_64 *sect;␊ |
441 | ␉␉␉␉␉␊ |
442 | ␉␉␉␉␉while(sectionIndex < segCommand64->cmdsize)␊ |
443 | ␉␉␉␉␉{␊ |
444 | ␉␉␉␉␉␉sect = binary + binaryIndex + sectionIndex;␊ |
445 | ␉␉␉␉␉␉␊ |
446 | ␉␉␉␉␉␉sectionIndex += sizeof(struct section_64);␊ |
447 | ␉␉␉␉␉␉␊ |
448 | ␉␉␉␉␉␉␊ |
449 | ␉␉␉␉␉␉if(strcmp("__text", sect->sectname) == 0)␊ |
450 | ␉␉␉␉␉␉{␊ |
451 | ␉␉␉␉␉␉␉// __TEXT,__text found, save the offset and address for when looking for the calls.␊ |
452 | ␉␉␉␉␉␉␉textSection = sect->offset;␊ |
453 | ␉␉␉␉␉␉␉textAddress = sect->addr;␊ |
454 | ␉␉␉␉␉␉␉␊ |
455 | ␉␉␉␉␉␉␉break;␊ |
456 | ␉␉␉␉␉␉}␉␉␉␉␉␊ |
457 | ␉␉␉␉␉}␊ |
458 | ␉␉␉␉}␊ |
459 | ␉␉␉␉␊ |
460 | ␉␉␉␉break;␊ |
461 | ␉␉␉␉␊ |
462 | ␉␉␉case LC_DYSYMTAB:␊ |
463 | ␉␉␉␉break;␊ |
464 | ␉␉␉␉␊ |
465 | ␉␉␉case LC_LOAD_DYLIB:␊ |
466 | ␉␉␉case LC_LOAD_WEAK_DYLIB ^ LC_REQ_DYLD:␊ |
467 | ␉␉␉␉dylibCommand = binary + binaryIndex;␊ |
468 | ␉␉␉␉char* module = binary + binaryIndex + ((UInt32)*((UInt32*)&dylibCommand->dylib.name));␊ |
469 | ␉␉␉␉// TODO: verify version␊ |
470 | ␉␉␉␉// =␉dylibCommand->dylib.current_version;␊ |
471 | ␉␉␉␉// =␉dylibCommand->dylib.compatibility_version;␊ |
472 | ␉␉␉␉char* name = malloc(strlen(module) + strlen(".dylib") + 1);␊ |
473 | ␉␉␉␉sprintf(name, "%s.dylib", module);␉␉␉␉␊ |
474 | ␉␉␉␉if(dylib_loader)␊ |
475 | ␉␉␉␉{␊ |
476 | ␉␉␉␉␉int statue = dylib_loader(name);␊ |
477 | ␉␉␉␉␉␊ |
478 | ␉␉␉␉␉if( statue != MOD_SUCCESS)␊ |
479 | ␉␉␉␉␉{␊ |
480 | ␉␉␉␉␉␉free(name);␊ |
481 | ␉␉␉␉␉␉if (statue == MOD_ERROR) {␊ |
482 | ␉␉␉␉␉␉␉// Unable to load dependancy␊ |
483 | ␉␉␉␉␉␉␉return NULL;␊ |
484 | ␉␉␉␉␉␉}␊ |
485 | ␉␉␉␉␉␉␊ |
486 | ␉␉␉␉␉} ␊ |
487 | ␊ |
488 | ␉␉␉␉}␊ |
489 | ␉␉␉␉break;␊ |
490 | ␉␉␉␉␊ |
491 | ␉␉␉case LC_ID_DYLIB:␊ |
492 | ␉␉␉␉dylibCommand = binary + binaryIndex;␊ |
493 | ␉␉␉␉/*moduleName =␉binary + binaryIndex + ((UInt32)*((UInt32*)&dylibCommand->dylib.name));␊ |
494 | ␉␉␉␉moduleVersion =␉dylibCommand->dylib.current_version;␊ |
495 | ␉␉␉␉moduleCompat =␉dylibCommand->dylib.compatibility_version;␊ |
496 | ␉␉␉␉ */␊ |
497 | ␉␉␉␉break;␊ |
498 | ␊ |
499 | ␉␉␉case LC_DYLD_INFO:␊ |
500 | ␉␉␉␉// Bind and rebase info is stored here␊ |
501 | ␉␉␉␉dyldInfoCommand = binary + binaryIndex;␊ |
502 | ␉␉␉␉break;␊ |
503 | ␉␉␉␉␊ |
504 | ␉␉␉case LC_UUID:␊ |
505 | ␉␉␉␉break;␊ |
506 | ␉␉␉␉␊ |
507 | ␉␉␉case LC_UNIXTHREAD:␊ |
508 | ␉␉␉␉break;␊ |
509 | ␉␉␉␉␊ |
510 | ␉␉␉default:␊ |
511 | ␉␉␉␉DBG("Unhandled loadcommand 0x%X\n", loadCommand->cmd & 0x7FFFFFFF);␊ |
512 | ␉␉␉␉break;␊ |
513 | ␉␉␊ |
514 | ␉␉}␊ |
515 | ␊ |
516 | ␉␉binaryIndex += cmdSize;␊ |
517 | ␉}␊ |
518 | ␉//if(!moduleName) return NULL;␊ |
519 | ␉␉␊ |
520 | ␊ |
521 | ␉// bind_macho uses the symbols.␊ |
522 | ␉module_start = (void*)handle_symtable((UInt32)binary, symtabCommand, symbol_handler, is64);␊ |
523 | ␊ |
524 | ␉// Rebase the module before binding it.␊ |
525 | ␉if(dyldInfoCommand && dyldInfoCommand->rebase_off)␊ |
526 | ␉{␊ |
527 | ␉␉rebase_macho(binary, (char*)dyldInfoCommand->rebase_off, dyldInfoCommand->rebase_size);␊ |
528 | ␉}␊ |
529 | ␉␊ |
530 | ␉if(dyldInfoCommand && dyldInfoCommand->bind_off)␊ |
531 | ␉{␊ |
532 | ␉␉bind_macho(binary, (char*)dyldInfoCommand->bind_off, dyldInfoCommand->bind_size);␊ |
533 | ␉}␊ |
534 | ␉␊ |
535 | ␉if(dyldInfoCommand && dyldInfoCommand->weak_bind_off)␊ |
536 | ␉{␊ |
537 | ␉␉// NOTE: this currently should never happen.␊ |
538 | ␉␉bind_macho(binary, (char*)dyldInfoCommand->weak_bind_off, dyldInfoCommand->weak_bind_size);␊ |
539 | ␉}␊ |
540 | ␉␊ |
541 | ␉if(dyldInfoCommand && dyldInfoCommand->lazy_bind_off)␊ |
542 | ␉{␊ |
543 | ␉␉// NOTE: we are binding the lazy pointers as a module is laoded,␊ |
544 | ␉␉// This should be changed to bind when a symbol is referened at runtime instead.␊ |
545 | ␉␉bind_macho(binary, (char*)dyldInfoCommand->lazy_bind_off, dyldInfoCommand->lazy_bind_size);␊ |
546 | ␉}␊ |
547 | ␊ |
548 | ␉return module_start;␊ |
549 | ␉␊ |
550 | }␊ |
551 | ␊ |
552 | // Based on code from dylibinfo.cpp and ImageLoaderMachOCompressed.cpp␊ |
553 | void rebase_macho(void* base, char* rebase_stream, UInt32 size)␊ |
554 | {␊ |
555 | ␉rebase_stream += (UInt32)base;␊ |
556 | ␉␊ |
557 | ␉UInt8 immediate = 0;␊ |
558 | ␉UInt8 opcode = 0;␊ |
559 | ␉UInt8 type = 0;␊ |
560 | ␉␊ |
561 | ␉UInt32 segmentAddress = 0;␊ |
562 | ␉␊ |
563 | ␉␊ |
564 | ␉␊ |
565 | ␉UInt32 tmp = 0;␊ |
566 | ␉UInt32 tmp2 = 0;␊ |
567 | ␉UInt8 bits = 0;␊ |
568 | ␉int index = 0;␊ |
569 | ␉␊ |
570 | ␉int done = 0;␊ |
571 | ␉unsigned int i = 0;␊ |
572 | ␉␊ |
573 | ␉while(/*!done &&*/ i < size)␊ |
574 | ␉{␊ |
575 | ␉␉immediate = rebase_stream[i] & REBASE_IMMEDIATE_MASK;␊ |
576 | ␉␉opcode = rebase_stream[i] & REBASE_OPCODE_MASK;␊ |
577 | ␊ |
578 | ␉␉␊ |
579 | ␉␉switch(opcode)␊ |
580 | ␉␉{␊ |
581 | ␉␉␉case REBASE_OPCODE_DONE:␊ |
582 | ␉␉␉␉// Rebase complete.␊ |
583 | ␉␉␉␉done = 1;␊ |
584 | ␉␉␉␉break;␊ |
585 | ␉␉␉␉␊ |
586 | ␉␉␉␉␊ |
587 | ␉␉␉case REBASE_OPCODE_SET_TYPE_IMM:␊ |
588 | ␉␉␉␉// Set rebase type (pointer, absolute32, pcrel32)␊ |
589 | ␉␉␉␉//DBG("Rebase type = 0x%X\n", immediate);␊ |
590 | ␉␉␉␉type = immediate;␊ |
591 | ␉␉␉␉break;␊ |
592 | ␉␉␉␉␊ |
593 | ␉␉␉␉␊ |
594 | ␉␉␉case REBASE_OPCODE_SET_SEGMENT_AND_OFFSET_ULEB:␊ |
595 | ␉␉␉␉// Locate address to begin rebasing␊ |
596 | ␉␉␉␉segmentAddress = 0;␊ |
597 | ␊ |
598 | ␉␉␉␉struct segment_command* segCommand = NULL; // NOTE: 32bit only␊ |
599 | ␉␉␉␉␊ |
600 | ␉␉␉␉unsigned int binIndex = 0;␊ |
601 | ␉␉␉␉index = 0;␊ |
602 | ␉␉␉␉do␊ |
603 | ␉␉␉␉{␊ |
604 | ␉␉␉␉␉segCommand = base + sizeof(struct mach_header) + binIndex;␊ |
605 | ␉␉␉␉␉␊ |
606 | ␉␉␉␉␉␊ |
607 | ␉␉␉␉␉binIndex += segCommand->cmdsize;␊ |
608 | ␉␉␉␉␉index++;␊ |
609 | ␉␉␉␉}␊ |
610 | ␉␉␉␉while(index <= immediate);␊ |
611 | ␊ |
612 | ␊ |
613 | ␉␉␉␉segmentAddress = segCommand->fileoff;␊ |
614 | ␉␉␉␉␊ |
615 | ␉␉␉␉tmp = 0;␊ |
616 | ␉␉␉␉bits = 0;␊ |
617 | ␉␉␉␉do␊ |
618 | ␉␉␉␉{␊ |
619 | ␉␉␉␉␉tmp |= (rebase_stream[++i] & 0x7f) << bits;␊ |
620 | ␉␉␉␉␉bits += 7;␊ |
621 | ␉␉␉␉}␊ |
622 | ␉␉␉␉while(rebase_stream[i] & 0x80);␊ |
623 | ␉␉␉␉␊ |
624 | ␉␉␉␉segmentAddress += tmp;␊ |
625 | ␉␉␉␉break;␊ |
626 | ␉␉␉␉␊ |
627 | ␉␉␉␉␊ |
628 | ␉␉␉case REBASE_OPCODE_ADD_ADDR_ULEB:␊ |
629 | ␉␉␉␉// Add value to rebase address␊ |
630 | ␉␉␉␉tmp = 0;␊ |
631 | ␉␉␉␉bits = 0;␊ |
632 | ␉␉␉␉do␊ |
633 | ␉␉␉␉{␊ |
634 | ␉␉␉␉␉tmp <<= bits;␊ |
635 | ␉␉␉␉␉tmp |= rebase_stream[++i] & 0x7f;␊ |
636 | ␉␉␉␉␉bits += 7;␊ |
637 | ␉␉␉␉}␊ |
638 | ␉␉␉␉while(rebase_stream[i] & 0x80);␊ |
639 | ␉␉␉␉␊ |
640 | ␉␉␉␉segmentAddress +=␉tmp; ␊ |
641 | ␉␉␉␉break;␊ |
642 | ␉␉␉␉␊ |
643 | ␉␉␉case REBASE_OPCODE_ADD_ADDR_IMM_SCALED:␊ |
644 | ␉␉␉␉segmentAddress += immediate * sizeof(void*);␊ |
645 | ␉␉␉␉break;␊ |
646 | ␉␉␉␉␊ |
647 | ␉␉␉␉␊ |
648 | ␉␉␉case REBASE_OPCODE_DO_REBASE_IMM_TIMES:␊ |
649 | ␉␉␉␉index = 0;␊ |
650 | ␉␉␉␉for (index = 0; index < immediate; ++index) {␊ |
651 | ␉␉␉␉␉rebase_location(base + segmentAddress, (char*)base, type);␊ |
652 | ␉␉␉␉␉segmentAddress += sizeof(void*);␊ |
653 | ␉␉␉␉}␊ |
654 | ␉␉␉␉break;␊ |
655 | ␉␉␉␊ |
656 | ␉␉␉␉␊ |
657 | ␉␉␉case REBASE_OPCODE_DO_REBASE_ULEB_TIMES:␊ |
658 | ␉␉␉␉tmp = 0;␊ |
659 | ␉␉␉␉bits = 0;␊ |
660 | ␉␉␉␉do␊ |
661 | ␉␉␉␉{␊ |
662 | ␉␉␉␉␉tmp |= (rebase_stream[++i] & 0x7f) << bits;␊ |
663 | ␉␉␉␉␉bits += 7;␊ |
664 | ␉␉␉␉}␊ |
665 | ␉␉␉␉while(rebase_stream[i] & 0x80);␊ |
666 | ␉␉␉␉␊ |
667 | ␉␉␉␉index = 0;␊ |
668 | ␉␉␉␉for (index = 0; index < tmp; ++index) {␊ |
669 | ␉␉␉␉␉//DBG("\tRebasing 0x%X\n", segmentAddress);␊ |
670 | ␉␉␉␉␉rebase_location(base + segmentAddress, (char*)base, type);␉␉␉␉␉␊ |
671 | ␉␉␉␉␉segmentAddress += sizeof(void*);␊ |
672 | ␉␉␉␉}␊ |
673 | ␉␉␉␉break;␊ |
674 | ␉␉␉␉␊ |
675 | ␉␉␉case REBASE_OPCODE_DO_REBASE_ADD_ADDR_ULEB:␊ |
676 | ␉␉␉␉tmp = 0;␊ |
677 | ␉␉␉␉bits = 0;␊ |
678 | ␉␉␉␉do␊ |
679 | ␉␉␉␉{␊ |
680 | ␉␉␉␉␉tmp |= (rebase_stream[++i] & 0x7f) << bits;␊ |
681 | ␉␉␉␉␉bits += 7;␊ |
682 | ␉␉␉␉}␊ |
683 | ␉␉␉␉while(rebase_stream[i] & 0x80);␊ |
684 | ␉␉␉␉␊ |
685 | ␉␉␉␉rebase_location(base + segmentAddress, (char*)base, type);␊ |
686 | ␉␉␉␉␊ |
687 | ␉␉␉␉segmentAddress += tmp + sizeof(void*);␊ |
688 | ␉␉␉␉break;␊ |
689 | ␉␉␉␉␊ |
690 | ␉␉␉case REBASE_OPCODE_DO_REBASE_ULEB_TIMES_SKIPPING_ULEB:␊ |
691 | ␉␉␉␉tmp = 0;␊ |
692 | ␉␉␉␉bits = 0;␊ |
693 | ␉␉␉␉do␊ |
694 | ␉␉␉␉{␊ |
695 | ␉␉␉␉␉tmp |= (rebase_stream[++i] & 0x7f) << bits;␊ |
696 | ␉␉␉␉␉bits += 7;␊ |
697 | ␉␉␉␉}␊ |
698 | ␉␉␉␉while(rebase_stream[i] & 0x80);␊ |
699 | ␉␉␉␉␊ |
700 | ␉␉␉␉␊ |
701 | ␉␉␉␉tmp2 = 0;␊ |
702 | ␉␉␉␉bits = 0;␊ |
703 | ␉␉␉␉do␊ |
704 | ␉␉␉␉{␊ |
705 | ␉␉␉␉␉tmp2 |= (rebase_stream[++i] & 0x7f) << bits;␊ |
706 | ␉␉␉␉␉bits += 7;␊ |
707 | ␉␉␉␉}␊ |
708 | ␉␉␉␉while(rebase_stream[i] & 0x80);␊ |
709 | ␉␉␉␉␊ |
710 | ␉␉␉␉index = 0;␊ |
711 | ␉␉␉␉for (index = 0; index < tmp; ++index) {␊ |
712 | ␊ |
713 | ␉␉␉␉␉rebase_location(base + segmentAddress, (char*)base, type);␊ |
714 | ␉␉␉␉␉␊ |
715 | ␉␉␉␉␉segmentAddress += tmp2 + sizeof(void*);␊ |
716 | ␉␉␉␉}␊ |
717 | ␉␉␉␉break;␊ |
718 | ␉␉}␊ |
719 | ␉␉i++;␊ |
720 | ␉}␊ |
721 | }␊ |
722 | ␊ |
723 | // Based on code from dylibinfo.cpp and ImageLoaderMachOCompressed.cpp␊ |
724 | // NOTE: this uses 32bit values, and not 64bit values. ␊ |
725 | // There is apossibility that this could cause issues,␊ |
726 | // however the macho file is 32 bit, so it shouldn't matter too much␊ |
727 | void bind_macho(void* base, char* bind_stream, UInt32 size)␊ |
728 | {␉␊ |
729 | ␉bind_stream += (UInt32)base;␊ |
730 | ␉␊ |
731 | ␉UInt8 immediate = 0;␊ |
732 | ␉UInt8 opcode = 0;␊ |
733 | ␉UInt8 type = 0;␊ |
734 | ␉␊ |
735 | ␉UInt32 segmentAddress = 0;␊ |
736 | ␉␊ |
737 | ␉UInt32 address = 0;␊ |
738 | ␉␊ |
739 | ␉SInt32 addend = 0;␉␉␉// TODO: handle this␊ |
740 | ␉SInt32 libraryOrdinal = 0;␊ |
741 | ␊ |
742 | ␉const char* symbolName = NULL;␊ |
743 | ␉UInt8 symboFlags = 0;␊ |
744 | ␉UInt32 symbolAddr = 0xFFFFFFFF;␊ |
745 | ␉␊ |
746 | ␉// Temperary variables␊ |
747 | ␉UInt8 bits = 0;␊ |
748 | ␉UInt32 tmp = 0;␊ |
749 | ␉UInt32 tmp2 = 0;␊ |
750 | ␉␊ |
751 | ␉UInt32 index = 0;␊ |
752 | ␉int done = 0;␊ |
753 | ␉unsigned int i = 0;␊ |
754 | ␉␊ |
755 | ␉while(/*!done &&*/ i < size)␊ |
756 | ␉{␊ |
757 | ␉␉immediate = bind_stream[i] & BIND_IMMEDIATE_MASK;␊ |
758 | ␉␉opcode = bind_stream[i] & BIND_OPCODE_MASK;␊ |
759 | ␉␉␊ |
760 | ␉␉␊ |
761 | ␉␉switch(opcode)␊ |
762 | ␉␉{␊ |
763 | ␉␉␉case BIND_OPCODE_DONE:␊ |
764 | ␉␉␉␉done = 1; ␊ |
765 | ␉␉␉␉break;␊ |
766 | ␉␉␉␉␊ |
767 | ␉␉␉case BIND_OPCODE_SET_DYLIB_ORDINAL_IMM:␊ |
768 | ␉␉␉␉libraryOrdinal = immediate;␊ |
769 | ␉␉␉␉//DBG("BIND_OPCODE_SET_DYLIB_ORDINAL_IMM: %d\n", libraryOrdinal);␊ |
770 | ␉␉␉␉break;␊ |
771 | ␉␉␉␉␊ |
772 | ␉␉␉case BIND_OPCODE_SET_DYLIB_ORDINAL_ULEB:␊ |
773 | ␉␉␉␉libraryOrdinal = 0;␊ |
774 | ␉␉␉␉bits = 0;␊ |
775 | ␉␉␉␉do␊ |
776 | ␉␉␉␉{␊ |
777 | ␉␉␉␉␉libraryOrdinal |= (bind_stream[++i] & 0x7f) << bits;␊ |
778 | ␉␉␉␉␉bits += 7;␊ |
779 | ␉␉␉␉}␊ |
780 | ␉␉␉␉while(bind_stream[i] & 0x80);␊ |
781 | ␉␉␉␉␊ |
782 | ␉␉␉␉//DBG("BIND_OPCODE_SET_DYLIB_ORDINAL_ULEB: %d\n", libraryOrdinal);␊ |
783 | ␊ |
784 | ␉␉␉␉break;␊ |
785 | ␉␉␉␉␊ |
786 | ␉␉␉case BIND_OPCODE_SET_DYLIB_SPECIAL_IMM:␊ |
787 | ␉␉␉␉// NOTE: this is wrong, fortunately we don't use it␊ |
788 | ␉␉␉␉libraryOrdinal = -immediate;␊ |
789 | ␉␉␉␉//DBG("BIND_OPCODE_SET_DYLIB_SPECIAL_IMM: %d\n", libraryOrdinal);␊ |
790 | ␊ |
791 | ␉␉␉␉break;␊ |
792 | ␉␉␉␉␊ |
793 | ␉␉␉case BIND_OPCODE_SET_SYMBOL_TRAILING_FLAGS_IMM:␊ |
794 | ␉␉␉␉symboFlags = immediate;␊ |
795 | ␉␉␉␉symbolName = (char*)&bind_stream[++i];␊ |
796 | ␉␉␉␉i += strlen((char*)&bind_stream[i]);␊ |
797 | ␉␉␉␉//DBG("BIND_OPCODE_SET_SYMBOL_TRAILING_FLAGS_IMM: %s, 0x%X\n", symbolName, symboFlags);␊ |
798 | ␊ |
799 | ␉␉␉␉symbolAddr = lookup_all_symbols(symbolName);␊ |
800 | ␊ |
801 | ␉␉␉␉break;␊ |
802 | ␉␉␉␉␊ |
803 | ␉␉␉case BIND_OPCODE_SET_TYPE_IMM:␊ |
804 | ␉␉␉␉// Set bind type (pointer, absolute32, pcrel32)␊ |
805 | ␉␉␉␉type = immediate;␊ |
806 | ␉␉␉␉//DBG("BIND_OPCODE_SET_TYPE_IMM: %d\n", type);␊ |
807 | ␊ |
808 | ␉␉␉␉break;␊ |
809 | ␉␉␉␉␊ |
810 | ␉␉␉case BIND_OPCODE_SET_ADDEND_SLEB:␊ |
811 | ␉␉␉␉addend = 0;␊ |
812 | ␉␉␉␉bits = 0;␊ |
813 | ␉␉␉␉do␊ |
814 | ␉␉␉␉{␊ |
815 | ␉␉␉␉␉addend |= (bind_stream[++i] & 0x7f) << bits;␊ |
816 | ␉␉␉␉␉bits += 7;␊ |
817 | ␉␉␉␉}␊ |
818 | ␉␉␉␉while(bind_stream[i] & 0x80);␊ |
819 | ␉␉␉␉␊ |
820 | ␉␉␉␉if(!(bind_stream[i-1] & 0x40)) addend *= -1;␊ |
821 | ␉␉␉␉␊ |
822 | ␉␉␉␉//DBG("BIND_OPCODE_SET_ADDEND_SLEB: %d\n", addend);␊ |
823 | ␉␉␉␉break;␊ |
824 | ␉␉␉␉␊ |
825 | ␉␉␉case BIND_OPCODE_SET_SEGMENT_AND_OFFSET_ULEB:␊ |
826 | ␉␉␉␉segmentAddress = 0;␊ |
827 | ␊ |
828 | ␉␉␉␉// Locate address␊ |
829 | ␉␉␉␉struct segment_command* segCommand = NULL;␉// NOTE: 32bit only␊ |
830 | ␉␉␉␉␊ |
831 | ␉␉␉␉unsigned int binIndex = 0;␊ |
832 | ␉␉␉␉index = 0;␊ |
833 | ␉␉␉␉do␊ |
834 | ␉␉␉␉{␊ |
835 | ␉␉␉␉␉segCommand = base + sizeof(struct mach_header) + binIndex;␊ |
836 | ␉␉␉␉␉binIndex += segCommand->cmdsize;␊ |
837 | ␉␉␉␉␉index++;␊ |
838 | ␉␉␉␉}␊ |
839 | ␉␉␉␉while(index <= immediate);␊ |
840 | ␉␉␉␉␊ |
841 | ␉␉␉␉segmentAddress = segCommand->fileoff;␊ |
842 | ␉␉␉␉␊ |
843 | ␉␉␉␉// Read in offset␊ |
844 | ␉␉␉␉tmp = 0;␊ |
845 | ␉␉␉␉bits = 0;␊ |
846 | ␉␉␉␉do␊ |
847 | ␉␉␉␉{␊ |
848 | ␉␉␉␉␉tmp |= (bind_stream[++i] & 0x7f) << bits;␊ |
849 | ␉␉␉␉␉bits += 7;␊ |
850 | ␉␉␉␉}␊ |
851 | ␉␉␉␉while(bind_stream[i] & 0x80);␊ |
852 | ␉␉␉␉␊ |
853 | ␉␉␉␉segmentAddress += tmp;␊ |
854 | ␉␉␉␉␊ |
855 | ␉␉␉␉//DBG("BIND_OPCODE_SET_SEGMENT_AND_OFFSET_ULEB: 0x%X\n", segmentAddress);␊ |
856 | ␉␉␉␉break;␊ |
857 | ␉␉␉␉␊ |
858 | ␉␉␉case BIND_OPCODE_ADD_ADDR_ULEB:␊ |
859 | ␉␉␉␉// Read in offset␊ |
860 | ␉␉␉␉tmp = 0;␊ |
861 | ␉␉␉␉bits = 0;␊ |
862 | ␉␉␉␉do␊ |
863 | ␉␉␉␉{␊ |
864 | ␉␉␉␉␉tmp |= (bind_stream[++i] & 0x7f) << bits;␊ |
865 | ␉␉␉␉␉bits += 7;␊ |
866 | ␉␉␉␉}␊ |
867 | ␉␉␉␉while(bind_stream[i] & 0x80);␊ |
868 | ␉␉␉␉␊ |
869 | ␉␉␉␉segmentAddress += tmp;␊ |
870 | ␉␉␉␉//DBG("BIND_OPCODE_ADD_ADDR_ULEB: 0x%X\n", segmentAddress);␊ |
871 | ␉␉␉␉break;␊ |
872 | ␉␉␉␉␊ |
873 | ␉␉␉case BIND_OPCODE_DO_BIND:␊ |
874 | ␉␉␉␉//DBG("BIND_OPCODE_DO_BIND\n");␊ |
875 | ␉␉␉␉if(symbolAddr != 0xFFFFFFFF)␊ |
876 | ␉␉␉␉{␊ |
877 | ␉␉␉␉␉address = segmentAddress + (UInt32)base;␊ |
878 | ␊ |
879 | ␉␉␉␉␉bind_location((UInt32*)address, (char*)symbolAddr, addend, BIND_TYPE_POINTER);␊ |
880 | ␉␉␉␉}␊ |
881 | ␉␉␉␉else if(strcmp(symbolName, SYMBOL_DYLD_STUB_BINDER) != 0)␊ |
882 | ␉␉␉␉{␊ |
883 | ␉␉␉␉␉printf("Unable to bind symbol %s\n", symbolName);␊ |
884 | ␉␉␉␉}␊ |
885 | ␉␉␉␉␊ |
886 | ␉␉␉␉segmentAddress += sizeof(void*);␊ |
887 | ␉␉␉␉break;␊ |
888 | ␉␉␉␉␊ |
889 | ␉␉␉case BIND_OPCODE_DO_BIND_ADD_ADDR_ULEB:␊ |
890 | ␉␉␉␉//DBG("BIND_OPCODE_DO_BIND_ADD_ADDR_ULEB\n");␊ |
891 | ␉␉␉␉␊ |
892 | ␉␉␉␉␊ |
893 | ␉␉␉␉// Read in offset␊ |
894 | ␉␉␉␉tmp = 0;␊ |
895 | ␉␉␉␉bits = 0;␊ |
896 | ␉␉␉␉do␊ |
897 | ␉␉␉␉{␊ |
898 | ␉␉␉␉␉tmp |= (bind_stream[++i] & 0x7f) << bits;␊ |
899 | ␉␉␉␉␉bits += 7;␊ |
900 | ␉␉␉␉}␊ |
901 | ␉␉␉␉while(bind_stream[i] & 0x80);␊ |
902 | ␉␉␉␉␊ |
903 | ␉␉␉␉␊ |
904 | ␉␉␉␉␊ |
905 | ␉␉␉␉if(symbolAddr != 0xFFFFFFFF)␊ |
906 | ␉␉␉␉{␊ |
907 | ␉␉␉␉␉address = segmentAddress + (UInt32)base;␊ |
908 | ␊ |
909 | ␉␉␉␉␉bind_location((UInt32*)address, (char*)symbolAddr, addend, BIND_TYPE_POINTER);␊ |
910 | ␉␉␉␉}␊ |
911 | ␉␉␉␉else if(strcmp(symbolName, SYMBOL_DYLD_STUB_BINDER) != 0)␊ |
912 | ␉␉␉␉{␊ |
913 | ␉␉␉␉␉printf("Unable to bind symbol %s\n", symbolName);␊ |
914 | ␉␉␉␉}␊ |
915 | ␉␉␉␉segmentAddress += tmp + sizeof(void*);␊ |
916 | ␊ |
917 | ␉␉␉␉␊ |
918 | ␉␉␉␉break;␊ |
919 | ␉␉␉␉␊ |
920 | ␉␉␉case BIND_OPCODE_DO_BIND_ADD_ADDR_IMM_SCALED:␊ |
921 | ␉␉␉␉//DBG("BIND_OPCODE_DO_BIND_ADD_ADDR_IMM_SCALED\n");␊ |
922 | ␉␉␉␉␊ |
923 | ␉␉␉␉if(symbolAddr != 0xFFFFFFFF)␊ |
924 | ␉␉␉␉{␊ |
925 | ␉␉␉␉␉address = segmentAddress + (UInt32)base;␊ |
926 | ␊ |
927 | ␉␉␉␉␉bind_location((UInt32*)address, (char*)symbolAddr, addend, BIND_TYPE_POINTER);␊ |
928 | ␉␉␉␉}␊ |
929 | ␉␉␉␉else if(strcmp(symbolName, SYMBOL_DYLD_STUB_BINDER) != 0)␊ |
930 | ␉␉␉␉{␊ |
931 | ␉␉␉␉␉printf("Unable to bind symbol %s\n", symbolName);␊ |
932 | ␉␉␉␉}␊ |
933 | ␉␉␉␉segmentAddress += (immediate * sizeof(void*)) + sizeof(void*);␊ |
934 | ␊ |
935 | ␉␉␉␉␊ |
936 | ␉␉␉␉break;␊ |
937 | ␉␉␉␉␊ |
938 | ␉␉␉case BIND_OPCODE_DO_BIND_ULEB_TIMES_SKIPPING_ULEB:␊ |
939 | ␊ |
940 | ␉␉␉␉tmp = 0;␊ |
941 | ␉␉␉␉bits = 0;␊ |
942 | ␉␉␉␉do␊ |
943 | ␉␉␉␉{␊ |
944 | ␉␉␉␉␉tmp |= (bind_stream[++i] & 0x7f) << bits;␊ |
945 | ␉␉␉␉␉bits += 7;␊ |
946 | ␉␉␉␉}␊ |
947 | ␉␉␉␉while(bind_stream[i] & 0x80);␊ |
948 | ␊ |
949 | ␉␉␉␉␊ |
950 | ␉␉␉␉tmp2 = 0;␊ |
951 | ␉␉␉␉bits = 0;␊ |
952 | ␉␉␉␉do␊ |
953 | ␉␉␉␉{␊ |
954 | ␉␉␉␉␉tmp2 |= (bind_stream[++i] & 0x7f) << bits;␊ |
955 | ␉␉␉␉␉bits += 7;␊ |
956 | ␉␉␉␉}␊ |
957 | ␉␉␉␉while(bind_stream[i] & 0x80);␊ |
958 | ␉␉␉␉␊ |
959 | ␉␉␉␉␊ |
960 | ␉␉␉␉//DBG("BIND_OPCODE_DO_BIND_ULEB_TIMES_SKIPPING_ULEB 0x%X 0x%X\n", tmp, tmp2);␊ |
961 | ␊ |
962 | ␉␉␉␉␊ |
963 | ␉␉␉␉if(symbolAddr != 0xFFFFFFFF)␊ |
964 | ␉␉␉␉{␊ |
965 | ␉␉␉␉␉for(index = 0; index < tmp; index++)␊ |
966 | ␉␉␉␉␉{␊ |
967 | ␉␉␉␉␉␉␊ |
968 | ␉␉␉␉␉␉address = segmentAddress + (UInt32)base;␊ |
969 | ␊ |
970 | ␉␉␉␉␉␉bind_location((UInt32*)address, (char*)symbolAddr, addend, BIND_TYPE_POINTER);␊ |
971 | ␉␉␉␉␉␉␊ |
972 | ␉␉␉␉␉␉segmentAddress += tmp2 + sizeof(void*);␊ |
973 | ␉␉␉␉␉}␊ |
974 | ␉␉␉␉}␊ |
975 | ␉␉␉␉else if(strcmp(symbolName, SYMBOL_DYLD_STUB_BINDER) != 0)␊ |
976 | ␉␉␉␉{␊ |
977 | ␉␉␉␉␉printf("Unable to bind symbol %s\n", symbolName);␊ |
978 | ␉␉␉␉}␊ |
979 | ␉␉␉␉␊ |
980 | ␉␉␉␉␊ |
981 | ␉␉␉␉break;␊ |
982 | ␉␉␉␉␊ |
983 | ␉␉}␊ |
984 | ␉␉i++;␊ |
985 | ␉}␊ |
986 | }␊ |
987 | ␊ |
988 | inline void rebase_location(UInt32* location, char* base, int type)␊ |
989 | {␉␊ |
990 | ␉switch(type)␊ |
991 | ␉{␊ |
992 | ␉␉case REBASE_TYPE_POINTER:␊ |
993 | ␉␉case REBASE_TYPE_TEXT_ABSOLUTE32:␊ |
994 | ␉␉␉*location += (UInt32)base;␊ |
995 | ␉␉␉break;␊ |
996 | ␉␉␉␊ |
997 | ␉␉default:␊ |
998 | ␉␉␉break;␊ |
999 | ␉}␊ |
1000 | }␊ |
1001 | ␊ |
1002 | inline void bind_location(UInt32* location, char* value, UInt32 addend, int type)␊ |
1003 | {␉␊ |
1004 | ␉// do actual update␊ |
1005 | ␉char* newValue = value + addend;␊ |
1006 | ␊ |
1007 | ␉switch (type) {␊ |
1008 | ␉␉case BIND_TYPE_POINTER:␊ |
1009 | ␉␉case BIND_TYPE_TEXT_ABSOLUTE32:␊ |
1010 | ␉␉␉break;␊ |
1011 | ␊ |
1012 | ␉␉case BIND_TYPE_TEXT_PCREL32:␊ |
1013 | ␉␉␉newValue -= ((UInt32)location + 4);␊ |
1014 | ␊ |
1015 | ␉␉␉break;␊ |
1016 | ␉␉default:␊ |
1017 | ␉␉␉return;␊ |
1018 | ␉}␊ |
1019 | ␉*location = (UInt32)newValue;␊ |
1020 | ␉␊ |
1021 | ␊ |
1022 | }␊ |
1023 | ␊ |
1024 | //unsigned char *dappleClut8 [256];␊ |
1025 | /*␊ |
1026 | * add_symbol␊ |
1027 | * This function adds a symbol from a module to the list of known symbols ␊ |
1028 | * possibly change to a pointer and add this to the Symbol module so that it can␊ |
1029 | * adjust it's internal symbol list (sort) to optimize locating new symbols␊ |
1030 | * NOTE: returns the address if the symbol is "start", else returns 0xFFFFFFFF␊ |
1031 | */␊ |
1032 | long long add_symbol(char* symbol, long long addr, char is64)␊ |
1033 | {␊ |
1034 | ␉/*if (strcmp(symbol,"_appleClut8") == 0) {␉␉␊ |
1035 | ␉␉//dappleClut8 = (uint8_t *)(UInt32)addr;␊ |
1036 | ␉␉memcpy(dappleClut8, (uint8_t *)(UInt32)addr, 256);␊ |
1037 | ␉␉return addr;␊ |
1038 | ␉␉␊ |
1039 | ␉} else*/ ␊ |
1040 | ␉if(is64) return 0xFFFFFFFF; // Fixme␊ |
1041 | ␉␊ |
1042 | ␉// This only can handle 32bit symbols ␊ |
1043 | ␉symbolList_t* new_entry= malloc(sizeof(symbolList_t));␊ |
1044 | ␉DBG("Adding symbol %s at 0x%X\n", symbol, addr);␊ |
1045 | ␉if (new_entry) {␉␊ |
1046 | ␉␉new_entry->next = moduleSymbols;␊ |
1047 | ␉␉␊ |
1048 | ␉␉moduleSymbols = new_entry;␊ |
1049 | ␉␉␊ |
1050 | ␉␉new_entry->addr = (UInt32)addr;␊ |
1051 | ␉␉new_entry->symbol = symbol;␊ |
1052 | ␉␉return addr;␊ |
1053 | ␉}␉␊ |
1054 | ␉␊ |
1055 | ␉return 0xFFFFFFFF;␊ |
1056 | ␉␊ |
1057 | }␊ |
1058 | ␊ |
1059 | /*␊ |
1060 | * print out the information about the loaded module␊ |
1061 | */␊ |
1062 | void module_loaded(const char* name/*, UInt32 version, UInt32 compat*/)␊ |
1063 | {␊ |
1064 | ␉moduleList_t* new_entry = malloc(sizeof(moduleList_t));␊ |
1065 | ␉if (new_entry) {␉␊ |
1066 | ␉␉new_entry->next = loadedModules;␊ |
1067 | ␉␊ |
1068 | ␉␉loadedModules = new_entry;␊ |
1069 | ␉␊ |
1070 | ␉␉new_entry->module = (char*)name;␊ |
1071 | ␉␉//␉new_entry->version = version;␊ |
1072 | ␉␉//␉new_entry->compat = compat;␊ |
1073 | ␉}␊ |
1074 | }␊ |
1075 | ␊ |
1076 | int is_module_loaded(const char* name)␊ |
1077 | {␊ |
1078 | ␉moduleList_t* entry = loadedModules;␊ |
1079 | ␉while(entry)␊ |
1080 | ␉{␊ |
1081 | ␉␉DBG("Comparing %s with %s\n", name, entry->module);␊ |
1082 | ␉␉char fullname[128];␊ |
1083 | ␉␉sprintf(fullname, "%s.dylib",name);␊ |
1084 | ␉␉if((strcmp(entry->module, name) == 0) || (strcmp(entry->module, fullname) == 0))␊ |
1085 | ␉␉{␊ |
1086 | ␉␉␉DBG("Located module %s\n", name);␊ |
1087 | ␉␉␉return MOD_ALREADY_LOADED;␊ |
1088 | ␉␉}␊ |
1089 | ␉␉else␊ |
1090 | ␉␉{␊ |
1091 | ␉␉␉entry = entry->next;␊ |
1092 | ␉␉}␊ |
1093 | ␊ |
1094 | ␉}␊ |
1095 | ␉DBG("Module %s not found\n", name);␊ |
1096 | ␊ |
1097 | ␉return MOD_ERROR;␊ |
1098 | }␊ |
1099 | ␊ |
1100 | // Look for symbols using the Smbols moduel function.␊ |
1101 | // If non are found, look through the list of module symbols␊ |
1102 | unsigned int lookup_all_symbols(const char* name)␊ |
1103 | {␊ |
1104 | ␉unsigned int addr = 0xFFFFFFFF;␊ |
1105 | ␉if(lookup_symbol && (UInt32)lookup_symbol != 0xFFFFFFFF)␊ |
1106 | ␉{␊ |
1107 | ␉␉addr = lookup_symbol(name);␊ |
1108 | ␉␉if(addr != 0xFFFFFFFF)␊ |
1109 | ␉␉{␊ |
1110 | ␉␉␉DBG("Internal symbol %s located at 0x%X\n", name, addr);␊ |
1111 | ␉␉␉return addr;␊ |
1112 | ␉␉}␊ |
1113 | ␉}␊ |
1114 | ␊ |
1115 | ␉␊ |
1116 | ␉symbolList_t* entry = moduleSymbols;␊ |
1117 | ␉while(entry)␊ |
1118 | ␉{␊ |
1119 | ␉␉if(strcmp(entry->symbol, name) == 0)␊ |
1120 | ␉␉{␊ |
1121 | ␉␉␉DBG("External symbol %s located at 0x%X\n", name, entry->addr);␊ |
1122 | ␉␉␉return entry->addr;␊ |
1123 | ␉␉}␊ |
1124 | ␉␉else␊ |
1125 | ␉␉{␊ |
1126 | ␉␉␉entry = entry->next;␊ |
1127 | ␉␉}␊ |
1128 | ␊ |
1129 | ␉}␊ |
1130 | #if DEBUG_MODULES_r␊ |
1131 | ␉if(strcmp(name, SYMBOL_DYLD_STUB_BINDER) != 0)␊ |
1132 | ␉{␊ |
1133 | ␉␉verbose("Unable to locate symbol %s\n", name);␊ |
1134 | ␉␉getc();␊ |
1135 | ␉}␊ |
1136 | #endif␊ |
1137 | ␉return 0xFFFFFFFF;␊ |
1138 | }␊ |
1139 | ␊ |
1140 | ␊ |
1141 | /*␊ |
1142 | * parse the symbol table␊ |
1143 | * Lookup any undefined symbols␊ |
1144 | */␊ |
1145 | ␊ |
1146 | unsigned int handle_symtable(UInt32 base, struct symtab_command* symtabCommand, long long(*symbol_handler)(char*, long long, char), char is64)␊ |
1147 | {␉␉␊ |
1148 | ␉unsigned int module_start = 0xFFFFFFFF;␊ |
1149 | ␉␊ |
1150 | ␉UInt32 symbolIndex = 0;␊ |
1151 | ␉char* symbolString = base + (char*)symtabCommand->stroff;␊ |
1152 | ␉//char* symbolTable = base + symtabCommand->symoff;␊ |
1153 | ␉if(!is64)␊ |
1154 | ␉{␊ |
1155 | ␉␉struct nlist* symbolEntry = (void*)base + symtabCommand->symoff;␊ |
1156 | ␉␉while(symbolIndex < symtabCommand->nsyms)␊ |
1157 | ␉␉{␉␉␉␉␉␉␊ |
1158 | ␉␉␉if(symbolEntry->n_value)␊ |
1159 | ␉␉␉{␉␉␉␉␊ |
1160 | ␉␉␉␉if(strcmp(symbolString + symbolEntry->n_un.n_strx, "start") == 0) {␊ |
1161 | ␉␉␉␉␉// Module start located. 'start' is an alias so don't register it␉␉␉␉␊ |
1162 | ␉␉␉␉␉module_start = base + symbolEntry->n_value;␊ |
1163 | ␉␉␉␉␉DBG("n_value %x module_start %x\n", (unsigned)symbolEntry->n_value, (unsigned)module_start);␊ |
1164 | ␉␉␉␉} else {␊ |
1165 | ␉␉␉␉␉symbol_handler(symbolString + symbolEntry->n_un.n_strx, (long long)base + symbolEntry->n_value, is64);␊ |
1166 | ␉␉␉␉}␊ |
1167 | ␉␉␉␉␊ |
1168 | #if DEBUG_MODULES␉␊ |
1169 | ␉␉␉␉bool isTexT = (((unsigned)symbolEntry->n_value > (unsigned)vmaddr) && ((unsigned)(vmaddr + vmsize) > (unsigned)symbolEntry->n_value ));␊ |
1170 | ␉␉␉␉printf("%s %s\n", isTexT ? "__TEXT :" : "__DATA(OR ANY) :", symbolString + symbolEntry->n_un.n_strx);␊ |
1171 | ␉␉␉␉␊ |
1172 | ␉␉␉␉if(strcmp(symbolString + symbolEntry->n_un.n_strx, "_BootHelp_txt") == 0) {␊ |
1173 | ␉␉␉␉␉long long addr = (long long)base + symbolEntry->n_value;␊ |
1174 | ␉␉␉␉␉unsigned char *BootHelp = NULL;␊ |
1175 | ␉␉␉␉␉BootHelp = (unsigned char*)(UInt32)addr;␉␉␉␉␉␊ |
1176 | ␉␉␉␉␉printf("method 1: __DATA : BootHelp_txt[0] %x\n", BootHelp[0]);␊ |
1177 | ␉␉␉␉␉␊ |
1178 | ␉␉␉␉␉long long addr2 = symbolEntry->n_value;␊ |
1179 | ␉␉␉␉␉unsigned char *BootHelp2 = NULL;␊ |
1180 | ␉␉␉␉␉BootHelp2 = (unsigned char*)(UInt32)addr2;␉␉␉␉␉␊ |
1181 | ␉␉␉␉␉printf("method 2: __DATA : BootHelp_txt[0] %x\n", BootHelp2[0]);␊ |
1182 | ␉␉␉␉}␊ |
1183 | #endif␊ |
1184 | ␉␉␉}␊ |
1185 | ␉␉␉␊ |
1186 | ␉␉␉symbolEntry++;␊ |
1187 | ␉␉␉symbolIndex++;␉// TODO remove␊ |
1188 | ␉␉}␊ |
1189 | ␉}␊ |
1190 | ␉else␊ |
1191 | ␉{␊ |
1192 | ␉␉struct nlist_64* symbolEntry = (void*)base + symtabCommand->symoff;␊ |
1193 | ␉␉// NOTE First entry is *not* correct, but we can ignore it (i'm getting radar:// right now)␉␊ |
1194 | ␉␉while(symbolIndex < symtabCommand->nsyms)␊ |
1195 | ␉␉{␉␊ |
1196 | ␉␉␉␊ |
1197 | ␉␉␉if(strcmp(symbolString + symbolEntry->n_un.n_strx, "start") == 0) {␊ |
1198 | ␉␉␉␉// Module start located. 'start' is an alias so don't register it␉␉␉␉␊ |
1199 | ␉␉␉␉module_start = base + symbolEntry->n_value;␊ |
1200 | ␉␉␉} else {␊ |
1201 | ␉␉␉␉symbol_handler(symbolString + symbolEntry->n_un.n_strx, (long long)base + symbolEntry->n_value, is64);␊ |
1202 | ␉␉␉}␊ |
1203 | ␉␉␉␊ |
1204 | ␉␉␉symbolEntry++;␊ |
1205 | ␉␉␉symbolIndex++;␉// TODO remove␊ |
1206 | ␉␉}␊ |
1207 | ␉}␊ |
1208 | ␉␉␊ |
1209 | ␉return module_start;␊ |
1210 | ␉␊ |
1211 | }␊ |
1212 | ␊ |
1213 | ␊ |
1214 | /*␊ |
1215 | * Locate the symbol for an already loaded function and modify the beginning of␊ |
1216 | * the function to jump directly to the new one␊ |
1217 | * example: replace_function("_HelloWorld_start", &replacement_start);␊ |
1218 | */␊ |
1219 | int replace_function(const char* symbol, void* newAddress)␊ |
1220 | {␊ |
1221 | ␉UInt32* jumpPointer = malloc(sizeof(UInt32*));␉ ␊ |
1222 | ␉// TODO: look into using the next four bytes of the function instead␊ |
1223 | ␉// Most functions should support this, as they probably will be at ␊ |
1224 | ␉// least 10 bytes long, but you never know, this is sligtly safer as␊ |
1225 | ␉// function can be as small as 6 bytes.␊ |
1226 | ␉UInt32 addr = lookup_all_symbols(symbol);␊ |
1227 | ␉␊ |
1228 | ␉char* binary = (char*)addr;␊ |
1229 | ␉if(addr != 0xFFFFFFFF)␊ |
1230 | ␉{␊ |
1231 | ␉␉*binary++ = 0xFF;␉// Jump␊ |
1232 | ␉␉*binary++ = 0x25;␉// Long Jump␊ |
1233 | ␉␉*((UInt32*)binary) = (UInt32)jumpPointer;␊ |
1234 | ␉␉␊ |
1235 | ␉␉*jumpPointer = (UInt32)newAddress;␊ |
1236 | ␉␉␊ |
1237 | ␉␉return MOD_SUCCESS;␊ |
1238 | ␉}␊ |
1239 | ␉␊ |
1240 | ␉return MOD_ERROR;␊ |
1241 | ␊ |
1242 | }␊ |
1243 | ␊ |
1244 | ␊ |
1245 | /* Nedded to divide 64bit numbers correctly. TODO: look into why modules need this␊ |
1246 | * And why it isn't needed when compiled into boot2␊ |
1247 | */␊ |
1248 | ␊ |
1249 | uint64_t __udivdi3(uint64_t numerator, uint64_t denominator)␊ |
1250 | {␊ |
1251 | ␉uint64_t quotient = 0, qbit = 1;␊ |
1252 | ␉␊ |
1253 | ␉if (denominator)␊ |
1254 | ␉{␊ |
1255 | ␉␉while ((int64_t) denominator >= 0)␊ |
1256 | ␉␉{␊ |
1257 | ␉␉␉denominator <<= 1;␊ |
1258 | ␉␉␉qbit <<= 1;␊ |
1259 | ␉␉}␊ |
1260 | ␉␉␊ |
1261 | ␉␉while (denominator)␊ |
1262 | ␉␉{␊ |
1263 | ␉␉␉if (denominator <= numerator)␊ |
1264 | ␉␉␉{␊ |
1265 | ␉␉␉␉numerator -= denominator;␊ |
1266 | ␉␉␉␉quotient += qbit;␊ |
1267 | ␉␉␉}␊ |
1268 | ␉␉␉denominator >>= 1;␊ |
1269 | ␉␉␉qbit >>= 1;␊ |
1270 | ␉␉}␊ |
1271 | ␉␉␊ |
1272 | ␉␉return quotient;␊ |
1273 | ␉}␊ |
1274 | ␉␊ |
1275 | ␉stop("Divide by 0");␊ |
1276 | ␉return MOD_ERROR;␉␊ |
1277 | }␊ |
1278 | |