1 /* -----------------------------------------------------------------------------
3 * (c) The GHC Team, 2000-2004
7 * ---------------------------------------------------------------------------*/
10 #include "PosixSource.h"
13 /* Linux needs _GNU_SOURCE to get RTLD_DEFAULT from <dlfcn.h> and
14 MREMAP_MAYMOVE from <sys/mman.h>.
25 #include "LinkerInternals.h"
29 #include "RtsTypeable.h"
32 #ifdef HAVE_SYS_TYPES_H
33 #include <sys/types.h>
39 #ifdef HAVE_SYS_STAT_H
43 #if defined(HAVE_DLFCN_H)
47 #if defined(cygwin32_HOST_OS)
52 #ifdef HAVE_SYS_TIME_H
56 #include <sys/fcntl.h>
57 #include <sys/termios.h>
58 #include <sys/utime.h>
59 #include <sys/utsname.h>
63 #if defined(ia64_HOST_ARCH) || defined(linux_HOST_OS) || defined(freebsd_HOST_OS) || defined(netbsd_HOST_OS) || defined(openbsd_HOST_OS)
68 #if defined(linux_HOST_OS) || defined(freebsd_HOST_OS) || defined(netbsd_HOST_OS) || defined(openbsd_HOST_OS)
76 #if defined(linux_HOST_OS) || defined(solaris2_HOST_OS) || defined(freebsd_HOST_OS) || defined(netbsd_HOST_OS) || defined(openbsd_HOST_OS)
77 # define OBJFORMAT_ELF
78 #elif defined(cygwin32_HOST_OS) || defined (mingw32_HOST_OS)
79 # define OBJFORMAT_PEi386
82 #elif defined(darwin_HOST_OS)
83 # define OBJFORMAT_MACHO
84 # include <mach-o/loader.h>
85 # include <mach-o/nlist.h>
86 # include <mach-o/reloc.h>
87 #if !defined(HAVE_DLFCN_H)
88 # include <mach-o/dyld.h>
90 #if defined(powerpc_HOST_ARCH)
91 # include <mach-o/ppc/reloc.h>
93 #if defined(x86_64_HOST_ARCH)
94 # include <mach-o/x86_64/reloc.h>
98 /* Hash table mapping symbol names to Symbol */
99 static /*Str*/HashTable *symhash;
101 /* Hash table mapping symbol names to StgStablePtr */
102 static /*Str*/HashTable *stablehash;
104 /* List of currently loaded objects */
105 ObjectCode *objects = NULL; /* initially empty */
107 #if defined(OBJFORMAT_ELF)
108 static int ocVerifyImage_ELF ( ObjectCode* oc );
109 static int ocGetNames_ELF ( ObjectCode* oc );
110 static int ocResolve_ELF ( ObjectCode* oc );
111 #if defined(powerpc_HOST_ARCH) || defined(x86_64_HOST_ARCH)
112 static int ocAllocateSymbolExtras_ELF ( ObjectCode* oc );
114 #elif defined(OBJFORMAT_PEi386)
115 static int ocVerifyImage_PEi386 ( ObjectCode* oc );
116 static int ocGetNames_PEi386 ( ObjectCode* oc );
117 static int ocResolve_PEi386 ( ObjectCode* oc );
118 #elif defined(OBJFORMAT_MACHO)
119 static int ocVerifyImage_MachO ( ObjectCode* oc );
120 static int ocGetNames_MachO ( ObjectCode* oc );
121 static int ocResolve_MachO ( ObjectCode* oc );
123 static int machoGetMisalignment( FILE * );
124 #if defined(powerpc_HOST_ARCH) || defined(x86_64_HOST_ARCH)
125 static int ocAllocateSymbolExtras_MachO ( ObjectCode* oc );
127 #ifdef powerpc_HOST_ARCH
128 static void machoInitSymbolsWithoutUnderscore( void );
132 /* on x86_64 we have a problem with relocating symbol references in
133 * code that was compiled without -fPIC. By default, the small memory
134 * model is used, which assumes that symbol references can fit in a
135 * 32-bit slot. The system dynamic linker makes this work for
136 * references to shared libraries by either (a) allocating a jump
137 * table slot for code references, or (b) moving the symbol at load
138 * time (and copying its contents, if necessary) for data references.
140 * We unfortunately can't tell whether symbol references are to code
141 * or data. So for now we assume they are code (the vast majority
142 * are), and allocate jump-table slots. Unfortunately this will
143 * SILENTLY generate crashing code for data references. This hack is
144 * enabled by X86_64_ELF_NONPIC_HACK.
146 * One workaround is to use shared Haskell libraries. This is
147 * coming. Another workaround is to keep the static libraries but
148 * compile them with -fPIC, because that will generate PIC references
149 * to data which can be relocated. The PIC code is still too green to
150 * do this systematically, though.
153 * See thread http://www.haskell.org/pipermail/cvs-ghc/2007-September/038458.html
155 #define X86_64_ELF_NONPIC_HACK 1
157 /* -----------------------------------------------------------------------------
158 * Built-in symbols from the RTS
161 typedef struct _RtsSymbolVal {
168 #define Maybe_Stable_Names SymX(mkWeakzh_fast) \
169 SymX(makeStableNamezh_fast) \
170 SymX(finalizzeWeakzh_fast)
172 /* These are not available in GUM!!! -- HWL */
173 #define Maybe_Stable_Names
176 #if !defined (mingw32_HOST_OS)
177 #define RTS_POSIX_ONLY_SYMBOLS \
178 SymX(shutdownHaskellAndSignal) \
181 SymX(signal_handlers) \
182 SymX(stg_sig_install) \
186 #if defined (cygwin32_HOST_OS)
187 #define RTS_MINGW_ONLY_SYMBOLS /**/
188 /* Don't have the ability to read import libs / archives, so
189 * we have to stupidly list a lot of what libcygwin.a
192 #define RTS_CYGWIN_ONLY_SYMBOLS \
270 #elif !defined(mingw32_HOST_OS)
271 #define RTS_MINGW_ONLY_SYMBOLS /**/
272 #define RTS_CYGWIN_ONLY_SYMBOLS /**/
273 #else /* defined(mingw32_HOST_OS) */
274 #define RTS_POSIX_ONLY_SYMBOLS /**/
275 #define RTS_CYGWIN_ONLY_SYMBOLS /**/
277 /* Extra syms gen'ed by mingw-2's gcc-3.2: */
279 #define RTS_MINGW_EXTRA_SYMS \
280 Sym(_imp____mb_cur_max) \
283 #define RTS_MINGW_EXTRA_SYMS
286 #if HAVE_GETTIMEOFDAY
287 #define RTS_MINGW_GETTIMEOFDAY_SYM Sym(gettimeofday)
289 #define RTS_MINGW_GETTIMEOFDAY_SYM /**/
292 /* These are statically linked from the mingw libraries into the ghc
293 executable, so we have to employ this hack. */
294 #define RTS_MINGW_ONLY_SYMBOLS \
295 SymX(asyncReadzh_fast) \
296 SymX(asyncWritezh_fast) \
297 SymX(asyncDoProczh_fast) \
309 SymX(getservbyname) \
310 SymX(getservbyport) \
311 SymX(getprotobynumber) \
312 SymX(getprotobyname) \
313 SymX(gethostbyname) \
314 SymX(gethostbyaddr) \
361 SymX(rts_InstallConsoleEvent) \
362 SymX(rts_ConsoleHandlerDone) \
364 Sym(_imp___timezone) \
374 RTS_MINGW_EXTRA_SYMS \
375 RTS_MINGW_GETTIMEOFDAY_SYM \
379 #if defined(darwin_TARGET_OS) && HAVE_PRINTF_LDBLSTUB
380 #define RTS_DARWIN_ONLY_SYMBOLS \
381 Sym(asprintf$LDBLStub) \
385 Sym(fprintf$LDBLStub) \
386 Sym(fscanf$LDBLStub) \
387 Sym(fwprintf$LDBLStub) \
388 Sym(fwscanf$LDBLStub) \
389 Sym(printf$LDBLStub) \
390 Sym(scanf$LDBLStub) \
391 Sym(snprintf$LDBLStub) \
392 Sym(sprintf$LDBLStub) \
393 Sym(sscanf$LDBLStub) \
394 Sym(strtold$LDBLStub) \
395 Sym(swprintf$LDBLStub) \
396 Sym(swscanf$LDBLStub) \
397 Sym(syslog$LDBLStub) \
398 Sym(vasprintf$LDBLStub) \
400 Sym(verrc$LDBLStub) \
401 Sym(verrx$LDBLStub) \
402 Sym(vfprintf$LDBLStub) \
403 Sym(vfscanf$LDBLStub) \
404 Sym(vfwprintf$LDBLStub) \
405 Sym(vfwscanf$LDBLStub) \
406 Sym(vprintf$LDBLStub) \
407 Sym(vscanf$LDBLStub) \
408 Sym(vsnprintf$LDBLStub) \
409 Sym(vsprintf$LDBLStub) \
410 Sym(vsscanf$LDBLStub) \
411 Sym(vswprintf$LDBLStub) \
412 Sym(vswscanf$LDBLStub) \
413 Sym(vsyslog$LDBLStub) \
414 Sym(vwarn$LDBLStub) \
415 Sym(vwarnc$LDBLStub) \
416 Sym(vwarnx$LDBLStub) \
417 Sym(vwprintf$LDBLStub) \
418 Sym(vwscanf$LDBLStub) \
420 Sym(warnc$LDBLStub) \
421 Sym(warnx$LDBLStub) \
422 Sym(wcstold$LDBLStub) \
423 Sym(wprintf$LDBLStub) \
426 #define RTS_DARWIN_ONLY_SYMBOLS
430 # define MAIN_CAP_SYM SymX(MainCapability)
432 # define MAIN_CAP_SYM
435 #if !defined(mingw32_HOST_OS)
436 #define RTS_USER_SIGNALS_SYMBOLS \
437 SymX(setIOManagerPipe)
439 #define RTS_USER_SIGNALS_SYMBOLS \
440 SymX(sendIOManagerEvent) \
441 SymX(readIOManagerEvent) \
442 SymX(getIOManagerEvent) \
443 SymX(console_handler)
446 #define RTS_LIBFFI_SYMBOLS \
450 Sym(ffi_type_float) \
451 Sym(ffi_type_double) \
452 Sym(ffi_type_sint64) \
453 Sym(ffi_type_uint64) \
454 Sym(ffi_type_sint32) \
455 Sym(ffi_type_uint32) \
456 Sym(ffi_type_sint16) \
457 Sym(ffi_type_uint16) \
458 Sym(ffi_type_sint8) \
459 Sym(ffi_type_uint8) \
460 Sym(ffi_type_pointer)
462 #ifdef TABLES_NEXT_TO_CODE
463 #define RTS_RET_SYMBOLS /* nothing */
465 #define RTS_RET_SYMBOLS \
466 SymX(stg_enter_ret) \
467 SymX(stg_gc_fun_ret) \
474 SymX(stg_ap_pv_ret) \
475 SymX(stg_ap_pp_ret) \
476 SymX(stg_ap_ppv_ret) \
477 SymX(stg_ap_ppp_ret) \
478 SymX(stg_ap_pppv_ret) \
479 SymX(stg_ap_pppp_ret) \
480 SymX(stg_ap_ppppp_ret) \
481 SymX(stg_ap_pppppp_ret)
484 /* On Windows, we link libgmp.a statically into libHSrts.dll */
485 #ifdef mingw32_HOST_OS
488 SymX(__gmpz_cmp_si) \
489 SymX(__gmpz_cmp_ui) \
490 SymX(__gmpz_get_si) \
494 SymExtern(__gmpz_cmp) \
495 SymExtern(__gmpz_cmp_si) \
496 SymExtern(__gmpz_cmp_ui) \
497 SymExtern(__gmpz_get_si) \
498 SymExtern(__gmpz_get_ui)
501 #define RTS_SYMBOLS \
504 SymX(stg_enter_info) \
505 SymX(stg_gc_void_info) \
506 SymX(__stg_gc_enter_1) \
507 SymX(stg_gc_noregs) \
508 SymX(stg_gc_unpt_r1_info) \
509 SymX(stg_gc_unpt_r1) \
510 SymX(stg_gc_unbx_r1_info) \
511 SymX(stg_gc_unbx_r1) \
512 SymX(stg_gc_f1_info) \
514 SymX(stg_gc_d1_info) \
516 SymX(stg_gc_l1_info) \
519 SymX(stg_gc_fun_info) \
521 SymX(stg_gc_gen_info) \
522 SymX(stg_gc_gen_hp) \
524 SymX(stg_gen_yield) \
525 SymX(stg_yield_noregs) \
526 SymX(stg_yield_to_interpreter) \
527 SymX(stg_gen_block) \
528 SymX(stg_block_noregs) \
530 SymX(stg_block_takemvar) \
531 SymX(stg_block_putmvar) \
533 SymX(MallocFailHook) \
535 SymX(OutOfHeapHook) \
536 SymX(StackOverflowHook) \
537 SymX(__encodeDouble) \
538 SymX(__encodeFloat) \
541 SymX(__int_encodeDouble) \
542 SymX(__word_encodeDouble) \
543 SymX(__2Int_encodeDouble) \
544 SymX(__int_encodeFloat) \
545 SymX(__word_encodeFloat) \
546 SymX(andIntegerzh_fast) \
547 SymX(atomicallyzh_fast) \
551 SymX(asyncExceptionsBlockedzh_fast) \
552 SymX(blockAsyncExceptionszh_fast) \
554 SymX(catchRetryzh_fast) \
555 SymX(catchSTMzh_fast) \
557 SymX(closure_flags) \
559 SymX(cmpIntegerzh_fast) \
560 SymX(cmpIntegerIntzh_fast) \
561 SymX(complementIntegerzh_fast) \
562 SymX(createAdjustor) \
563 SymX(decodeDoublezh_fast) \
564 SymX(decodeFloatzh_fast) \
565 SymX(decodeDoublezu2Intzh_fast) \
566 SymX(decodeFloatzuIntzh_fast) \
569 SymX(deRefWeakzh_fast) \
570 SymX(deRefStablePtrzh_fast) \
571 SymX(dirty_MUT_VAR) \
572 SymX(divExactIntegerzh_fast) \
573 SymX(divModIntegerzh_fast) \
575 SymX(forkOnzh_fast) \
577 SymX(forkOS_createThread) \
578 SymX(freeHaskellFunctionPtr) \
579 SymX(freeStablePtr) \
580 SymX(getOrSetTypeableStore) \
581 SymX(gcdIntegerzh_fast) \
582 SymX(gcdIntegerIntzh_fast) \
583 SymX(gcdIntzh_fast) \
587 SymX(getFullProgArgv) \
593 SymX(hs_perform_gc) \
594 SymX(hs_free_stable_ptr) \
595 SymX(hs_free_fun_ptr) \
596 SymX(hs_hpc_rootModule) \
598 SymX(unpackClosurezh_fast) \
599 SymX(getApStackValzh_fast) \
600 SymX(int2Integerzh_fast) \
601 SymX(integer2Intzh_fast) \
602 SymX(integer2Wordzh_fast) \
603 SymX(isCurrentThreadBoundzh_fast) \
604 SymX(isDoubleDenormalized) \
605 SymX(isDoubleInfinite) \
607 SymX(isDoubleNegativeZero) \
608 SymX(isEmptyMVarzh_fast) \
609 SymX(isFloatDenormalized) \
610 SymX(isFloatInfinite) \
612 SymX(isFloatNegativeZero) \
613 SymX(killThreadzh_fast) \
615 SymX(insertStableSymbol) \
618 SymX(makeStablePtrzh_fast) \
619 SymX(minusIntegerzh_fast) \
620 SymX(mkApUpd0zh_fast) \
621 SymX(myThreadIdzh_fast) \
622 SymX(labelThreadzh_fast) \
623 SymX(newArrayzh_fast) \
624 SymX(newBCOzh_fast) \
625 SymX(newByteArrayzh_fast) \
626 SymX_redirect(newCAF, newDynCAF) \
627 SymX(newMVarzh_fast) \
628 SymX(newMutVarzh_fast) \
629 SymX(newTVarzh_fast) \
630 SymX(noDuplicatezh_fast) \
631 SymX(atomicModifyMutVarzh_fast) \
632 SymX(newPinnedByteArrayzh_fast) \
634 SymX(orIntegerzh_fast) \
636 SymX(performMajorGC) \
637 SymX(plusIntegerzh_fast) \
640 SymX(putMVarzh_fast) \
641 SymX(quotIntegerzh_fast) \
642 SymX(quotRemIntegerzh_fast) \
644 SymX(raiseIOzh_fast) \
645 SymX(readTVarzh_fast) \
646 SymX(remIntegerzh_fast) \
647 SymX(resetNonBlockingFd) \
652 SymX(rts_checkSchedStatus) \
655 SymX(rts_evalLazyIO) \
656 SymX(rts_evalStableIO) \
660 SymX(rts_getDouble) \
668 SymX(rts_getFunPtr) \
669 SymX(rts_getStablePtr) \
670 SymX(rts_getThreadId) \
673 SymX(rts_getWord16) \
674 SymX(rts_getWord32) \
675 SymX(rts_getWord64) \
688 SymX(rts_mkStablePtr) \
696 SymX(rtsSupportsBoundThreads) \
697 SymX(__hscore_get_saved_termios) \
698 SymX(__hscore_set_saved_termios) \
700 SymX(startupHaskell) \
701 SymX(shutdownHaskell) \
702 SymX(shutdownHaskellAndExit) \
703 SymX(stable_ptr_table) \
704 SymX(stackOverflow) \
705 SymX(stg_CAF_BLACKHOLE_info) \
706 SymX(awakenBlockedQueue) \
708 SymX(stg_CHARLIKE_closure) \
709 SymX(stg_MVAR_CLEAN_info) \
710 SymX(stg_MVAR_DIRTY_info) \
711 SymX(stg_IND_STATIC_info) \
712 SymX(stg_INTLIKE_closure) \
713 SymX(stg_MUT_ARR_PTRS_DIRTY_info) \
714 SymX(stg_MUT_ARR_PTRS_FROZEN_info) \
715 SymX(stg_MUT_ARR_PTRS_FROZEN0_info) \
716 SymX(stg_WEAK_info) \
717 SymX(stg_ap_v_info) \
718 SymX(stg_ap_f_info) \
719 SymX(stg_ap_d_info) \
720 SymX(stg_ap_l_info) \
721 SymX(stg_ap_n_info) \
722 SymX(stg_ap_p_info) \
723 SymX(stg_ap_pv_info) \
724 SymX(stg_ap_pp_info) \
725 SymX(stg_ap_ppv_info) \
726 SymX(stg_ap_ppp_info) \
727 SymX(stg_ap_pppv_info) \
728 SymX(stg_ap_pppp_info) \
729 SymX(stg_ap_ppppp_info) \
730 SymX(stg_ap_pppppp_info) \
731 SymX(stg_ap_0_fast) \
732 SymX(stg_ap_v_fast) \
733 SymX(stg_ap_f_fast) \
734 SymX(stg_ap_d_fast) \
735 SymX(stg_ap_l_fast) \
736 SymX(stg_ap_n_fast) \
737 SymX(stg_ap_p_fast) \
738 SymX(stg_ap_pv_fast) \
739 SymX(stg_ap_pp_fast) \
740 SymX(stg_ap_ppv_fast) \
741 SymX(stg_ap_ppp_fast) \
742 SymX(stg_ap_pppv_fast) \
743 SymX(stg_ap_pppp_fast) \
744 SymX(stg_ap_ppppp_fast) \
745 SymX(stg_ap_pppppp_fast) \
746 SymX(stg_ap_1_upd_info) \
747 SymX(stg_ap_2_upd_info) \
748 SymX(stg_ap_3_upd_info) \
749 SymX(stg_ap_4_upd_info) \
750 SymX(stg_ap_5_upd_info) \
751 SymX(stg_ap_6_upd_info) \
752 SymX(stg_ap_7_upd_info) \
754 SymX(stg_sel_0_upd_info) \
755 SymX(stg_sel_10_upd_info) \
756 SymX(stg_sel_11_upd_info) \
757 SymX(stg_sel_12_upd_info) \
758 SymX(stg_sel_13_upd_info) \
759 SymX(stg_sel_14_upd_info) \
760 SymX(stg_sel_15_upd_info) \
761 SymX(stg_sel_1_upd_info) \
762 SymX(stg_sel_2_upd_info) \
763 SymX(stg_sel_3_upd_info) \
764 SymX(stg_sel_4_upd_info) \
765 SymX(stg_sel_5_upd_info) \
766 SymX(stg_sel_6_upd_info) \
767 SymX(stg_sel_7_upd_info) \
768 SymX(stg_sel_8_upd_info) \
769 SymX(stg_sel_9_upd_info) \
770 SymX(stg_upd_frame_info) \
771 SymX(suspendThread) \
772 SymX(takeMVarzh_fast) \
773 SymX(threadStatuszh_fast) \
774 SymX(timesIntegerzh_fast) \
775 SymX(tryPutMVarzh_fast) \
776 SymX(tryTakeMVarzh_fast) \
777 SymX(unblockAsyncExceptionszh_fast) \
779 SymX(unsafeThawArrayzh_fast) \
780 SymX(waitReadzh_fast) \
781 SymX(waitWritezh_fast) \
782 SymX(word2Integerzh_fast) \
783 SymX(writeTVarzh_fast) \
784 SymX(xorIntegerzh_fast) \
786 Sym(stg_interp_constr_entry) \
789 SymX(getAllocations) \
792 Sym(rts_breakpoint_io_action) \
793 Sym(rts_stop_next_breakpoint) \
794 Sym(rts_stop_on_exception) \
796 SymX(n_capabilities) \
797 RTS_USER_SIGNALS_SYMBOLS
799 #ifdef SUPPORT_LONG_LONGS
800 #define RTS_LONG_LONG_SYMS \
801 SymX(int64ToIntegerzh_fast) \
802 SymX(word64ToIntegerzh_fast)
804 #define RTS_LONG_LONG_SYMS /* nothing */
807 // 64-bit support functions in libgcc.a
808 #if defined(__GNUC__) && SIZEOF_VOID_P <= 4
809 #define RTS_LIBGCC_SYMBOLS \
819 #elif defined(ia64_HOST_ARCH)
820 #define RTS_LIBGCC_SYMBOLS \
828 #define RTS_LIBGCC_SYMBOLS
831 #if defined(darwin_HOST_OS) && defined(powerpc_HOST_ARCH)
832 // Symbols that don't have a leading underscore
833 // on Mac OS X. They have to receive special treatment,
834 // see machoInitSymbolsWithoutUnderscore()
835 #define RTS_MACHO_NOUNDERLINE_SYMBOLS \
840 /* entirely bogus claims about types of these symbols */
841 #define Sym(vvv) extern void vvv(void);
842 #if defined(__PIC__) && defined(mingw32_TARGET_OS)
843 #define SymExtern(vvv) extern void _imp__ ## vvv (void);
845 #define SymExtern(vvv) SymX(vvv)
847 #define SymX(vvv) /**/
848 #define SymX_redirect(vvv,xxx) /**/
852 RTS_POSIX_ONLY_SYMBOLS
853 RTS_MINGW_ONLY_SYMBOLS
854 RTS_CYGWIN_ONLY_SYMBOLS
855 RTS_DARWIN_ONLY_SYMBOLS
863 #ifdef LEADING_UNDERSCORE
864 #define MAYBE_LEADING_UNDERSCORE_STR(s) ("_" s)
866 #define MAYBE_LEADING_UNDERSCORE_STR(s) (s)
869 #define Sym(vvv) { MAYBE_LEADING_UNDERSCORE_STR(#vvv), \
871 #define SymX(vvv) Sym(vvv)
872 #define SymExtern(vvv) { MAYBE_LEADING_UNDERSCORE_STR(#vvv), \
873 (void*)DLL_IMPORT_DATA_REF(vvv) },
875 // SymX_redirect allows us to redirect references to one symbol to
876 // another symbol. See newCAF/newDynCAF for an example.
877 #define SymX_redirect(vvv,xxx) \
878 { MAYBE_LEADING_UNDERSCORE_STR(#vvv), \
881 static RtsSymbolVal rtsSyms[] = {
885 RTS_POSIX_ONLY_SYMBOLS
886 RTS_MINGW_ONLY_SYMBOLS
887 RTS_CYGWIN_ONLY_SYMBOLS
888 RTS_DARWIN_ONLY_SYMBOLS
891 #if defined(darwin_HOST_OS) && defined(i386_HOST_ARCH)
892 // dyld stub code contains references to this,
893 // but it should never be called because we treat
894 // lazy pointers as nonlazy.
895 { "dyld_stub_binding_helper", (void*)0xDEADBEEF },
897 { 0, 0 } /* sentinel */
902 /* -----------------------------------------------------------------------------
903 * Insert symbols into hash tables, checking for duplicates.
906 static void ghciInsertStrHashTable ( char* obj_name,
912 if (lookupHashTable(table, (StgWord)key) == NULL)
914 insertStrHashTable(table, (StgWord)key, data);
919 "GHCi runtime linker: fatal error: I found a duplicate definition for symbol\n"
921 "whilst processing object file\n"
923 "This could be caused by:\n"
924 " * Loading two different object files which export the same symbol\n"
925 " * Specifying the same object file twice on the GHCi command line\n"
926 " * An incorrect `package.conf' entry, causing some object to be\n"
928 "GHCi cannot safely continue in this situation. Exiting now. Sorry.\n"
935 /* -----------------------------------------------------------------------------
936 * initialize the object linker
940 static int linker_init_done = 0 ;
942 #if defined(OBJFORMAT_ELF) || defined(OBJFORMAT_MACHO)
943 static void *dl_prog_handle;
951 /* Make initLinker idempotent, so we can call it
952 before evey relevant operation; that means we
953 don't need to initialise the linker separately */
954 if (linker_init_done == 1) { return; } else {
955 linker_init_done = 1;
958 stablehash = allocStrHashTable();
959 symhash = allocStrHashTable();
961 /* populate the symbol table with stuff from the RTS */
962 for (sym = rtsSyms; sym->lbl != NULL; sym++) {
963 ghciInsertStrHashTable("(GHCi built-in symbols)",
964 symhash, sym->lbl, sym->addr);
966 # if defined(OBJFORMAT_MACHO) && defined(powerpc_HOST_ARCH)
967 machoInitSymbolsWithoutUnderscore();
970 # if defined(OBJFORMAT_ELF) || defined(OBJFORMAT_MACHO)
971 # if defined(RTLD_DEFAULT)
972 dl_prog_handle = RTLD_DEFAULT;
974 dl_prog_handle = dlopen(NULL, RTLD_LAZY);
975 # endif /* RTLD_DEFAULT */
979 /* -----------------------------------------------------------------------------
980 * Loading DLL or .so dynamic libraries
981 * -----------------------------------------------------------------------------
983 * Add a DLL from which symbols may be found. In the ELF case, just
984 * do RTLD_GLOBAL-style add, so no further messing around needs to
985 * happen in order that symbols in the loaded .so are findable --
986 * lookupSymbol() will subsequently see them by dlsym on the program's
987 * dl-handle. Returns NULL if success, otherwise ptr to an err msg.
989 * In the PEi386 case, open the DLLs and put handles to them in a
990 * linked list. When looking for a symbol, try all handles in the
991 * list. This means that we need to load even DLLs that are guaranteed
992 * to be in the ghc.exe image already, just so we can get a handle
993 * to give to loadSymbol, so that we can find the symbols. For such
994 * libraries, the LoadLibrary call should be a no-op except for returning
999 #if defined(OBJFORMAT_PEi386)
1000 /* A record for storing handles into DLLs. */
1005 struct _OpenedDLL* next;
1010 /* A list thereof. */
1011 static OpenedDLL* opened_dlls = NULL;
1015 addDLL( char *dll_name )
1017 # if defined(OBJFORMAT_ELF) || defined(OBJFORMAT_MACHO)
1018 /* ------------------- ELF DLL loader ------------------- */
1024 // omitted: RTLD_NOW
1025 // see http://www.haskell.org/pipermail/cvs-ghc/2007-September/038570.html
1026 hdl= dlopen(dll_name, RTLD_LAZY | RTLD_GLOBAL);
1029 /* dlopen failed; return a ptr to the error msg. */
1031 if (errmsg == NULL) errmsg = "addDLL: unknown error";
1038 # elif defined(OBJFORMAT_PEi386)
1039 /* ------------------- Win32 DLL loader ------------------- */
1047 /* debugBelch("\naddDLL; dll_name = `%s'\n", dll_name); */
1049 /* See if we've already got it, and ignore if so. */
1050 for (o_dll = opened_dlls; o_dll != NULL; o_dll = o_dll->next) {
1051 if (0 == strcmp(o_dll->name, dll_name))
1055 /* The file name has no suffix (yet) so that we can try
1056 both foo.dll and foo.drv
1058 The documentation for LoadLibrary says:
1059 If no file name extension is specified in the lpFileName
1060 parameter, the default library extension .dll is
1061 appended. However, the file name string can include a trailing
1062 point character (.) to indicate that the module name has no
1065 buf = stgMallocBytes(strlen(dll_name) + 10, "addDLL");
1066 sprintf(buf, "%s.DLL", dll_name);
1067 instance = LoadLibrary(buf);
1068 if (instance == NULL) {
1069 if (GetLastError() != ERROR_MOD_NOT_FOUND) goto error;
1070 // KAA: allow loading of drivers (like winspool.drv)
1071 sprintf(buf, "%s.DRV", dll_name);
1072 instance = LoadLibrary(buf);
1073 if (instance == NULL) {
1074 if (GetLastError() != ERROR_MOD_NOT_FOUND) goto error;
1075 // #1883: allow loading of unix-style libfoo.dll DLLs
1076 sprintf(buf, "lib%s.DLL", dll_name);
1077 instance = LoadLibrary(buf);
1078 if (instance == NULL) {
1085 /* Add this DLL to the list of DLLs in which to search for symbols. */
1086 o_dll = stgMallocBytes( sizeof(OpenedDLL), "addDLL" );
1087 o_dll->name = stgMallocBytes(1+strlen(dll_name), "addDLL");
1088 strcpy(o_dll->name, dll_name);
1089 o_dll->instance = instance;
1090 o_dll->next = opened_dlls;
1091 opened_dlls = o_dll;
1097 sysErrorBelch(dll_name);
1099 /* LoadLibrary failed; return a ptr to the error msg. */
1100 return "addDLL: could not load DLL";
1103 barf("addDLL: not implemented on this platform");
1107 /* -----------------------------------------------------------------------------
1108 * insert a stable symbol in the hash table
1112 insertStableSymbol(char* obj_name, char* key, StgPtr p)
1114 ghciInsertStrHashTable(obj_name, stablehash, key, getStablePtr(p));
1118 /* -----------------------------------------------------------------------------
1119 * insert a symbol in the hash table
1122 insertSymbol(char* obj_name, char* key, void* data)
1124 ghciInsertStrHashTable(obj_name, symhash, key, data);
1127 /* -----------------------------------------------------------------------------
1128 * lookup a symbol in the hash table
1131 lookupSymbol( char *lbl )
1135 ASSERT(symhash != NULL);
1136 val = lookupStrHashTable(symhash, lbl);
1139 # if defined(OBJFORMAT_ELF)
1140 return dlsym(dl_prog_handle, lbl);
1141 # elif defined(OBJFORMAT_MACHO)
1143 /* On OS X 10.3 and later, we use dlsym instead of the old legacy
1146 HACK: On OS X, global symbols are prefixed with an underscore.
1147 However, dlsym wants us to omit the leading underscore from the
1148 symbol name. For now, we simply strip it off here (and ONLY
1151 ASSERT(lbl[0] == '_');
1152 return dlsym(dl_prog_handle, lbl+1);
1154 if(NSIsSymbolNameDefined(lbl)) {
1155 NSSymbol symbol = NSLookupAndBindSymbol(lbl);
1156 return NSAddressOfSymbol(symbol);
1160 # endif /* HAVE_DLFCN_H */
1161 # elif defined(OBJFORMAT_PEi386)
1164 for (o_dll = opened_dlls; o_dll != NULL; o_dll = o_dll->next) {
1165 /* debugBelch("look in %s for %s\n", o_dll->name, lbl); */
1166 if (lbl[0] == '_') {
1167 /* HACK: if the name has an initial underscore, try stripping
1168 it off & look that up first. I've yet to verify whether there's
1169 a Rule that governs whether an initial '_' *should always* be
1170 stripped off when mapping from import lib name to the DLL name.
1172 sym = GetProcAddress(o_dll->instance, (lbl+1));
1174 /*debugBelch("found %s in %s\n", lbl+1,o_dll->name);*/
1178 sym = GetProcAddress(o_dll->instance, lbl);
1180 /*debugBelch("found %s in %s\n", lbl,o_dll->name);*/
1194 /* -----------------------------------------------------------------------------
1195 * Debugging aid: look in GHCi's object symbol tables for symbols
1196 * within DELTA bytes of the specified address, and show their names.
1199 void ghci_enquire ( char* addr );
1201 void ghci_enquire ( char* addr )
1206 const int DELTA = 64;
1211 for (oc = objects; oc; oc = oc->next) {
1212 for (i = 0; i < oc->n_symbols; i++) {
1213 sym = oc->symbols[i];
1214 if (sym == NULL) continue;
1217 a = lookupStrHashTable(symhash, sym);
1220 // debugBelch("ghci_enquire: can't find %s\n", sym);
1222 else if (addr-DELTA <= a && a <= addr+DELTA) {
1223 debugBelch("%p + %3d == `%s'\n", addr, (int)(a - addr), sym);
1230 #ifdef ia64_HOST_ARCH
1231 static unsigned int PLTSize(void);
1234 /* -----------------------------------------------------------------------------
1235 * Load an obj (populate the global symbol table, but don't resolve yet)
1237 * Returns: 1 if ok, 0 on error.
1240 loadObj( char *path )
1247 void *map_addr = NULL;
1253 /* debugBelch("loadObj %s\n", path ); */
1255 /* Check that we haven't already loaded this object.
1256 Ignore requests to load multiple times */
1260 for (o = objects; o; o = o->next) {
1261 if (0 == strcmp(o->fileName, path)) {
1263 break; /* don't need to search further */
1267 IF_DEBUG(linker, debugBelch(
1268 "GHCi runtime linker: warning: looks like you're trying to load the\n"
1269 "same object file twice:\n"
1271 "GHCi will ignore this, but be warned.\n"
1273 return 1; /* success */
1277 oc = stgMallocBytes(sizeof(ObjectCode), "loadObj(oc)");
1279 # if defined(OBJFORMAT_ELF)
1280 oc->formatName = "ELF";
1281 # elif defined(OBJFORMAT_PEi386)
1282 oc->formatName = "PEi386";
1283 # elif defined(OBJFORMAT_MACHO)
1284 oc->formatName = "Mach-O";
1287 barf("loadObj: not implemented on this platform");
1290 r = stat(path, &st);
1291 if (r == -1) { return 0; }
1293 /* sigh, strdup() isn't a POSIX function, so do it the long way */
1294 oc->fileName = stgMallocBytes( strlen(path)+1, "loadObj" );
1295 strcpy(oc->fileName, path);
1297 oc->fileSize = st.st_size;
1299 oc->sections = NULL;
1300 oc->proddables = NULL;
1302 /* chain it onto the list of objects */
1307 #define ROUND_UP(x,size) ((x + size - 1) & ~(size - 1))
1309 /* On many architectures malloc'd memory isn't executable, so we need to use mmap. */
1311 #if defined(openbsd_HOST_OS)
1312 fd = open(path, O_RDONLY, S_IRUSR);
1314 fd = open(path, O_RDONLY);
1317 barf("loadObj: can't open `%s'", path);
1319 pagesize = getpagesize();
1321 #ifdef ia64_HOST_ARCH
1322 /* The PLT needs to be right before the object */
1323 n = ROUND_UP(PLTSize(), pagesize);
1324 oc->plt = mmap(NULL, n, PROT_EXEC|PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0);
1325 if (oc->plt == MAP_FAILED)
1326 barf("loadObj: can't allocate PLT");
1329 map_addr = oc->plt + n;
1332 n = ROUND_UP(oc->fileSize, pagesize);
1334 /* Link objects into the lower 2Gb on x86_64. GHC assumes the
1335 * small memory model on this architecture (see gcc docs,
1338 * MAP_32BIT not available on OpenBSD/amd64
1340 #if defined(x86_64_HOST_ARCH) && defined(MAP_32BIT)
1341 #define EXTRA_MAP_FLAGS MAP_32BIT
1343 #define EXTRA_MAP_FLAGS 0
1346 /* MAP_ANONYMOUS is MAP_ANON on some systems, e.g. OpenBSD */
1347 #if !defined(MAP_ANONYMOUS) && defined(MAP_ANON)
1348 #define MAP_ANONYMOUS MAP_ANON
1351 oc->image = mmap(map_addr, n, PROT_EXEC|PROT_READ|PROT_WRITE,
1352 MAP_PRIVATE|EXTRA_MAP_FLAGS, fd, 0);
1353 if (oc->image == MAP_FAILED)
1354 barf("loadObj: can't map `%s'", path);
1358 #else /* !USE_MMAP */
1360 /* load the image into memory */
1361 f = fopen(path, "rb");
1363 barf("loadObj: can't read `%s'", path);
1365 # if defined(mingw32_HOST_OS)
1366 // TODO: We would like to use allocateExec here, but allocateExec
1367 // cannot currently allocate blocks large enough.
1368 oc->image = VirtualAlloc(NULL, oc->fileSize, MEM_RESERVE | MEM_COMMIT,
1369 PAGE_EXECUTE_READWRITE);
1370 # elif defined(darwin_HOST_OS)
1371 // In a Mach-O .o file, all sections can and will be misaligned
1372 // if the total size of the headers is not a multiple of the
1373 // desired alignment. This is fine for .o files that only serve
1374 // as input for the static linker, but it's not fine for us,
1375 // as SSE (used by gcc for floating point) and Altivec require
1376 // 16-byte alignment.
1377 // We calculate the correct alignment from the header before
1378 // reading the file, and then we misalign oc->image on purpose so
1379 // that the actual sections end up aligned again.
1380 oc->misalignment = machoGetMisalignment(f);
1381 oc->image = stgMallocBytes(oc->fileSize + oc->misalignment, "loadObj(image)");
1382 oc->image += oc->misalignment;
1384 oc->image = stgMallocBytes(oc->fileSize, "loadObj(image)");
1387 n = fread ( oc->image, 1, oc->fileSize, f );
1388 if (n != oc->fileSize)
1389 barf("loadObj: error whilst reading `%s'", path);
1392 #endif /* USE_MMAP */
1394 # if defined(OBJFORMAT_MACHO) && (defined(powerpc_HOST_ARCH) || defined(x86_64_HOST_ARCH))
1395 r = ocAllocateSymbolExtras_MachO ( oc );
1396 if (!r) { return r; }
1397 # elif defined(OBJFORMAT_ELF) && (defined(powerpc_HOST_ARCH) || defined(x86_64_HOST_ARCH))
1398 r = ocAllocateSymbolExtras_ELF ( oc );
1399 if (!r) { return r; }
1402 /* verify the in-memory image */
1403 # if defined(OBJFORMAT_ELF)
1404 r = ocVerifyImage_ELF ( oc );
1405 # elif defined(OBJFORMAT_PEi386)
1406 r = ocVerifyImage_PEi386 ( oc );
1407 # elif defined(OBJFORMAT_MACHO)
1408 r = ocVerifyImage_MachO ( oc );
1410 barf("loadObj: no verify method");
1412 if (!r) { return r; }
1414 /* build the symbol list for this image */
1415 # if defined(OBJFORMAT_ELF)
1416 r = ocGetNames_ELF ( oc );
1417 # elif defined(OBJFORMAT_PEi386)
1418 r = ocGetNames_PEi386 ( oc );
1419 # elif defined(OBJFORMAT_MACHO)
1420 r = ocGetNames_MachO ( oc );
1422 barf("loadObj: no getNames method");
1424 if (!r) { return r; }
1426 /* loaded, but not resolved yet */
1427 oc->status = OBJECT_LOADED;
1432 /* -----------------------------------------------------------------------------
1433 * resolve all the currently unlinked objects in memory
1435 * Returns: 1 if ok, 0 on error.
1445 for (oc = objects; oc; oc = oc->next) {
1446 if (oc->status != OBJECT_RESOLVED) {
1447 # if defined(OBJFORMAT_ELF)
1448 r = ocResolve_ELF ( oc );
1449 # elif defined(OBJFORMAT_PEi386)
1450 r = ocResolve_PEi386 ( oc );
1451 # elif defined(OBJFORMAT_MACHO)
1452 r = ocResolve_MachO ( oc );
1454 barf("resolveObjs: not implemented on this platform");
1456 if (!r) { return r; }
1457 oc->status = OBJECT_RESOLVED;
1463 /* -----------------------------------------------------------------------------
1464 * delete an object from the pool
1467 unloadObj( char *path )
1469 ObjectCode *oc, *prev;
1471 ASSERT(symhash != NULL);
1472 ASSERT(objects != NULL);
1477 for (oc = objects; oc; prev = oc, oc = oc->next) {
1478 if (!strcmp(oc->fileName,path)) {
1480 /* Remove all the mappings for the symbols within this
1485 for (i = 0; i < oc->n_symbols; i++) {
1486 if (oc->symbols[i] != NULL) {
1487 removeStrHashTable(symhash, oc->symbols[i], NULL);
1495 prev->next = oc->next;
1498 // We're going to leave this in place, in case there are
1499 // any pointers from the heap into it:
1500 // #ifdef mingw32_HOST_OS
1501 // VirtualFree(oc->image);
1503 // stgFree(oc->image);
1505 stgFree(oc->fileName);
1506 stgFree(oc->symbols);
1507 stgFree(oc->sections);
1513 errorBelch("unloadObj: can't find `%s' to unload", path);
1517 /* -----------------------------------------------------------------------------
1518 * Sanity checking. For each ObjectCode, maintain a list of address ranges
1519 * which may be prodded during relocation, and abort if we try and write
1520 * outside any of these.
1522 static void addProddableBlock ( ObjectCode* oc, void* start, int size )
1525 = stgMallocBytes(sizeof(ProddableBlock), "addProddableBlock");
1526 /* debugBelch("aPB %p %p %d\n", oc, start, size); */
1530 pb->next = oc->proddables;
1531 oc->proddables = pb;
1534 static void checkProddableBlock ( ObjectCode* oc, void* addr )
1537 for (pb = oc->proddables; pb != NULL; pb = pb->next) {
1538 char* s = (char*)(pb->start);
1539 char* e = s + pb->size - 1;
1540 char* a = (char*)addr;
1541 /* Assumes that the biggest fixup involves a 4-byte write. This
1542 probably needs to be changed to 8 (ie, +7) on 64-bit
1544 if (a >= s && (a+3) <= e) return;
1546 barf("checkProddableBlock: invalid fixup in runtime linker");
1549 /* -----------------------------------------------------------------------------
1550 * Section management.
1552 static void addSection ( ObjectCode* oc, SectionKind kind,
1553 void* start, void* end )
1555 Section* s = stgMallocBytes(sizeof(Section), "addSection");
1559 s->next = oc->sections;
1562 debugBelch("addSection: %p-%p (size %d), kind %d\n",
1563 start, ((char*)end)-1, end - start + 1, kind );
1568 /* --------------------------------------------------------------------------
1570 * This is about allocating a small chunk of memory for every symbol in the
1571 * object file. We make sure that the SymboLExtras are always "in range" of
1572 * limited-range PC-relative instructions on various platforms by allocating
1573 * them right next to the object code itself.
1576 #if defined(powerpc_HOST_ARCH) || defined(x86_64_HOST_ARCH)
1579 ocAllocateSymbolExtras
1581 Allocate additional space at the end of the object file image to make room
1582 for jump islands (powerpc, x86_64) and GOT entries (x86_64).
1584 PowerPC relative branch instructions have a 24 bit displacement field.
1585 As PPC code is always 4-byte-aligned, this yields a +-32MB range.
1586 If a particular imported symbol is outside this range, we have to redirect
1587 the jump to a short piece of new code that just loads the 32bit absolute
1588 address and jumps there.
1589 On x86_64, PC-relative jumps and PC-relative accesses to the GOT are limited
1592 This function just allocates space for one SymbolExtra for every
1593 undefined symbol in the object file. The code for the jump islands is
1594 filled in by makeSymbolExtra below.
1597 static int ocAllocateSymbolExtras( ObjectCode* oc, int count, int first )
1604 int misalignment = 0;
1605 #ifdef darwin_HOST_OS
1606 misalignment = oc->misalignment;
1612 // round up to the nearest 4
1613 aligned = (oc->fileSize + 3) & ~3;
1616 pagesize = getpagesize();
1617 n = ROUND_UP( oc->fileSize, pagesize );
1618 m = ROUND_UP( aligned + sizeof (SymbolExtra) * count, pagesize );
1620 /* we try to use spare space at the end of the last page of the
1621 * image for the jump islands, but if there isn't enough space
1622 * then we have to map some (anonymously, remembering MAP_32BIT).
1624 if( m > n ) // we need to allocate more pages
1626 oc->symbol_extras = mmap (NULL, sizeof(SymbolExtra) * count,
1627 PROT_EXEC|PROT_READ|PROT_WRITE,
1628 MAP_PRIVATE|MAP_ANONYMOUS|EXTRA_MAP_FLAGS,
1630 if (oc->symbol_extras == MAP_FAILED)
1632 errorBelch( "Unable to mmap() for jump islands\n" );
1635 #ifdef x86_64_HOST_ARCH
1636 if ((StgWord)oc->symbol_extras > 0x80000000)
1638 barf("mmap() returned memory outside 2Gb");
1644 oc->symbol_extras = (SymbolExtra *) (oc->image + aligned);
1647 oc->image -= misalignment;
1648 oc->image = stgReallocBytes( oc->image,
1650 aligned + sizeof (SymbolExtra) * count,
1651 "ocAllocateSymbolExtras" );
1652 oc->image += misalignment;
1654 oc->symbol_extras = (SymbolExtra *) (oc->image + aligned);
1655 #endif /* USE_MMAP */
1657 memset( oc->symbol_extras, 0, sizeof (SymbolExtra) * count );
1660 oc->symbol_extras = NULL;
1662 oc->first_symbol_extra = first;
1663 oc->n_symbol_extras = count;
1668 static SymbolExtra* makeSymbolExtra( ObjectCode* oc,
1669 unsigned long symbolNumber,
1670 unsigned long target )
1674 ASSERT( symbolNumber >= oc->first_symbol_extra
1675 && symbolNumber - oc->first_symbol_extra < oc->n_symbol_extras);
1677 extra = &oc->symbol_extras[symbolNumber - oc->first_symbol_extra];
1679 #ifdef powerpc_HOST_ARCH
1680 // lis r12, hi16(target)
1681 extra->jumpIsland.lis_r12 = 0x3d80;
1682 extra->jumpIsland.hi_addr = target >> 16;
1684 // ori r12, r12, lo16(target)
1685 extra->jumpIsland.ori_r12_r12 = 0x618c;
1686 extra->jumpIsland.lo_addr = target & 0xffff;
1689 extra->jumpIsland.mtctr_r12 = 0x7d8903a6;
1692 extra->jumpIsland.bctr = 0x4e800420;
1694 #ifdef x86_64_HOST_ARCH
1696 static uint8_t jmp[] = { 0xFF, 0x25, 0xF2, 0xFF, 0xFF, 0xFF };
1697 extra->addr = target;
1698 memcpy(extra->jumpIsland, jmp, 6);
1706 /* --------------------------------------------------------------------------
1707 * PowerPC specifics (instruction cache flushing)
1708 * ------------------------------------------------------------------------*/
1710 #ifdef powerpc_TARGET_ARCH
1712 ocFlushInstructionCache
1714 Flush the data & instruction caches.
1715 Because the PPC has split data/instruction caches, we have to
1716 do that whenever we modify code at runtime.
1719 static void ocFlushInstructionCache( ObjectCode *oc )
1721 int n = (oc->fileSize + sizeof( SymbolExtra ) * oc->n_symbol_extras + 3) / 4;
1722 unsigned long *p = (unsigned long *) oc->image;
1726 __asm__ volatile ( "dcbf 0,%0\n\t"
1734 __asm__ volatile ( "sync\n\t"
1740 /* --------------------------------------------------------------------------
1741 * PEi386 specifics (Win32 targets)
1742 * ------------------------------------------------------------------------*/
1744 /* The information for this linker comes from
1745 Microsoft Portable Executable
1746 and Common Object File Format Specification
1747 revision 5.1 January 1998
1748 which SimonM says comes from the MS Developer Network CDs.
1750 It can be found there (on older CDs), but can also be found
1753 http://www.microsoft.com/hwdev/hardware/PECOFF.asp
1755 (this is Rev 6.0 from February 1999).
1757 Things move, so if that fails, try searching for it via
1759 http://www.google.com/search?q=PE+COFF+specification
1761 The ultimate reference for the PE format is the Winnt.h
1762 header file that comes with the Platform SDKs; as always,
1763 implementations will drift wrt their documentation.
1765 A good background article on the PE format is Matt Pietrek's
1766 March 1994 article in Microsoft System Journal (MSJ)
1767 (Vol.9, No. 3): "Peering Inside the PE: A Tour of the
1768 Win32 Portable Executable File Format." The info in there
1769 has recently been updated in a two part article in
1770 MSDN magazine, issues Feb and March 2002,
1771 "Inside Windows: An In-Depth Look into the Win32 Portable
1772 Executable File Format"
1774 John Levine's book "Linkers and Loaders" contains useful
1779 #if defined(OBJFORMAT_PEi386)
1783 typedef unsigned char UChar;
1784 typedef unsigned short UInt16;
1785 typedef unsigned int UInt32;
1792 UInt16 NumberOfSections;
1793 UInt32 TimeDateStamp;
1794 UInt32 PointerToSymbolTable;
1795 UInt32 NumberOfSymbols;
1796 UInt16 SizeOfOptionalHeader;
1797 UInt16 Characteristics;
1801 #define sizeof_COFF_header 20
1808 UInt32 VirtualAddress;
1809 UInt32 SizeOfRawData;
1810 UInt32 PointerToRawData;
1811 UInt32 PointerToRelocations;
1812 UInt32 PointerToLinenumbers;
1813 UInt16 NumberOfRelocations;
1814 UInt16 NumberOfLineNumbers;
1815 UInt32 Characteristics;
1819 #define sizeof_COFF_section 40
1826 UInt16 SectionNumber;
1829 UChar NumberOfAuxSymbols;
1833 #define sizeof_COFF_symbol 18
1838 UInt32 VirtualAddress;
1839 UInt32 SymbolTableIndex;
1844 #define sizeof_COFF_reloc 10
1847 /* From PE spec doc, section 3.3.2 */
1848 /* Note use of MYIMAGE_* since IMAGE_* are already defined in
1849 windows.h -- for the same purpose, but I want to know what I'm
1851 #define MYIMAGE_FILE_RELOCS_STRIPPED 0x0001
1852 #define MYIMAGE_FILE_EXECUTABLE_IMAGE 0x0002
1853 #define MYIMAGE_FILE_DLL 0x2000
1854 #define MYIMAGE_FILE_SYSTEM 0x1000
1855 #define MYIMAGE_FILE_BYTES_REVERSED_HI 0x8000
1856 #define MYIMAGE_FILE_BYTES_REVERSED_LO 0x0080
1857 #define MYIMAGE_FILE_32BIT_MACHINE 0x0100
1859 /* From PE spec doc, section 5.4.2 and 5.4.4 */
1860 #define MYIMAGE_SYM_CLASS_EXTERNAL 2
1861 #define MYIMAGE_SYM_CLASS_STATIC 3
1862 #define MYIMAGE_SYM_UNDEFINED 0
1864 /* From PE spec doc, section 4.1 */
1865 #define MYIMAGE_SCN_CNT_CODE 0x00000020
1866 #define MYIMAGE_SCN_CNT_INITIALIZED_DATA 0x00000040
1867 #define MYIMAGE_SCN_LNK_NRELOC_OVFL 0x01000000
1869 /* From PE spec doc, section 5.2.1 */
1870 #define MYIMAGE_REL_I386_DIR32 0x0006
1871 #define MYIMAGE_REL_I386_REL32 0x0014
1874 /* We use myindex to calculate array addresses, rather than
1875 simply doing the normal subscript thing. That's because
1876 some of the above structs have sizes which are not
1877 a whole number of words. GCC rounds their sizes up to a
1878 whole number of words, which means that the address calcs
1879 arising from using normal C indexing or pointer arithmetic
1880 are just plain wrong. Sigh.
1883 myindex ( int scale, void* base, int index )
1886 ((UChar*)base) + scale * index;
1891 printName ( UChar* name, UChar* strtab )
1893 if (name[0]==0 && name[1]==0 && name[2]==0 && name[3]==0) {
1894 UInt32 strtab_offset = * (UInt32*)(name+4);
1895 debugBelch("%s", strtab + strtab_offset );
1898 for (i = 0; i < 8; i++) {
1899 if (name[i] == 0) break;
1900 debugBelch("%c", name[i] );
1907 copyName ( UChar* name, UChar* strtab, UChar* dst, int dstSize )
1909 if (name[0]==0 && name[1]==0 && name[2]==0 && name[3]==0) {
1910 UInt32 strtab_offset = * (UInt32*)(name+4);
1911 strncpy ( dst, strtab+strtab_offset, dstSize );
1917 if (name[i] == 0) break;
1927 cstring_from_COFF_symbol_name ( UChar* name, UChar* strtab )
1930 /* If the string is longer than 8 bytes, look in the
1931 string table for it -- this will be correctly zero terminated.
1933 if (name[0]==0 && name[1]==0 && name[2]==0 && name[3]==0) {
1934 UInt32 strtab_offset = * (UInt32*)(name+4);
1935 return ((UChar*)strtab) + strtab_offset;
1937 /* Otherwise, if shorter than 8 bytes, return the original,
1938 which by defn is correctly terminated.
1940 if (name[7]==0) return name;
1941 /* The annoying case: 8 bytes. Copy into a temporary
1942 (which is never freed ...)
1944 newstr = stgMallocBytes(9, "cstring_from_COFF_symbol_name");
1946 strncpy(newstr,name,8);
1952 /* Just compares the short names (first 8 chars) */
1953 static COFF_section *
1954 findPEi386SectionCalled ( ObjectCode* oc, char* name )
1958 = (COFF_header*)(oc->image);
1959 COFF_section* sectab
1961 ((UChar*)(oc->image))
1962 + sizeof_COFF_header + hdr->SizeOfOptionalHeader
1964 for (i = 0; i < hdr->NumberOfSections; i++) {
1967 COFF_section* section_i
1969 myindex ( sizeof_COFF_section, sectab, i );
1970 n1 = (UChar*) &(section_i->Name);
1972 if (n1[0]==n2[0] && n1[1]==n2[1] && n1[2]==n2[2] &&
1973 n1[3]==n2[3] && n1[4]==n2[4] && n1[5]==n2[5] &&
1974 n1[6]==n2[6] && n1[7]==n2[7])
1983 zapTrailingAtSign ( UChar* sym )
1985 # define my_isdigit(c) ((c) >= '0' && (c) <= '9')
1987 if (sym[0] == 0) return;
1989 while (sym[i] != 0) i++;
1992 while (j > 0 && my_isdigit(sym[j])) j--;
1993 if (j > 0 && sym[j] == '@' && j != i) sym[j] = 0;
1999 ocVerifyImage_PEi386 ( ObjectCode* oc )
2004 COFF_section* sectab;
2005 COFF_symbol* symtab;
2007 /* debugBelch("\nLOADING %s\n", oc->fileName); */
2008 hdr = (COFF_header*)(oc->image);
2009 sectab = (COFF_section*) (
2010 ((UChar*)(oc->image))
2011 + sizeof_COFF_header + hdr->SizeOfOptionalHeader
2013 symtab = (COFF_symbol*) (
2014 ((UChar*)(oc->image))
2015 + hdr->PointerToSymbolTable
2017 strtab = ((UChar*)symtab)
2018 + hdr->NumberOfSymbols * sizeof_COFF_symbol;
2020 if (hdr->Machine != 0x14c) {
2021 errorBelch("%s: Not x86 PEi386", oc->fileName);
2024 if (hdr->SizeOfOptionalHeader != 0) {
2025 errorBelch("%s: PEi386 with nonempty optional header", oc->fileName);
2028 if ( /* (hdr->Characteristics & MYIMAGE_FILE_RELOCS_STRIPPED) || */
2029 (hdr->Characteristics & MYIMAGE_FILE_EXECUTABLE_IMAGE) ||
2030 (hdr->Characteristics & MYIMAGE_FILE_DLL) ||
2031 (hdr->Characteristics & MYIMAGE_FILE_SYSTEM) ) {
2032 errorBelch("%s: Not a PEi386 object file", oc->fileName);
2035 if ( (hdr->Characteristics & MYIMAGE_FILE_BYTES_REVERSED_HI)
2036 /* || !(hdr->Characteristics & MYIMAGE_FILE_32BIT_MACHINE) */ ) {
2037 errorBelch("%s: Invalid PEi386 word size or endiannness: %d",
2039 (int)(hdr->Characteristics));
2042 /* If the string table size is way crazy, this might indicate that
2043 there are more than 64k relocations, despite claims to the
2044 contrary. Hence this test. */
2045 /* debugBelch("strtab size %d\n", * (UInt32*)strtab); */
2047 if ( (*(UInt32*)strtab) > 600000 ) {
2048 /* Note that 600k has no special significance other than being
2049 big enough to handle the almost-2MB-sized lumps that
2050 constitute HSwin32*.o. */
2051 debugBelch("PEi386 object has suspiciously large string table; > 64k relocs?");
2056 /* No further verification after this point; only debug printing. */
2058 IF_DEBUG(linker, i=1);
2059 if (i == 0) return 1;
2061 debugBelch( "sectab offset = %d\n", ((UChar*)sectab) - ((UChar*)hdr) );
2062 debugBelch( "symtab offset = %d\n", ((UChar*)symtab) - ((UChar*)hdr) );
2063 debugBelch( "strtab offset = %d\n", ((UChar*)strtab) - ((UChar*)hdr) );
2066 debugBelch( "Machine: 0x%x\n", (UInt32)(hdr->Machine) );
2067 debugBelch( "# sections: %d\n", (UInt32)(hdr->NumberOfSections) );
2068 debugBelch( "time/date: 0x%x\n", (UInt32)(hdr->TimeDateStamp) );
2069 debugBelch( "symtab offset: %d\n", (UInt32)(hdr->PointerToSymbolTable) );
2070 debugBelch( "# symbols: %d\n", (UInt32)(hdr->NumberOfSymbols) );
2071 debugBelch( "sz of opt hdr: %d\n", (UInt32)(hdr->SizeOfOptionalHeader) );
2072 debugBelch( "characteristics: 0x%x\n", (UInt32)(hdr->Characteristics) );
2074 /* Print the section table. */
2076 for (i = 0; i < hdr->NumberOfSections; i++) {
2078 COFF_section* sectab_i
2080 myindex ( sizeof_COFF_section, sectab, i );
2087 printName ( sectab_i->Name, strtab );
2097 sectab_i->VirtualSize,
2098 sectab_i->VirtualAddress,
2099 sectab_i->SizeOfRawData,
2100 sectab_i->PointerToRawData,
2101 sectab_i->NumberOfRelocations,
2102 sectab_i->PointerToRelocations,
2103 sectab_i->PointerToRawData
2105 reltab = (COFF_reloc*) (
2106 ((UChar*)(oc->image)) + sectab_i->PointerToRelocations
2109 if ( sectab_i->Characteristics & MYIMAGE_SCN_LNK_NRELOC_OVFL ) {
2110 /* If the relocation field (a short) has overflowed, the
2111 * real count can be found in the first reloc entry.
2113 * See Section 4.1 (last para) of the PE spec (rev6.0).
2115 COFF_reloc* rel = (COFF_reloc*)
2116 myindex ( sizeof_COFF_reloc, reltab, 0 );
2117 noRelocs = rel->VirtualAddress;
2120 noRelocs = sectab_i->NumberOfRelocations;
2124 for (; j < noRelocs; j++) {
2126 COFF_reloc* rel = (COFF_reloc*)
2127 myindex ( sizeof_COFF_reloc, reltab, j );
2129 " type 0x%-4x vaddr 0x%-8x name `",
2131 rel->VirtualAddress );
2132 sym = (COFF_symbol*)
2133 myindex ( sizeof_COFF_symbol, symtab, rel->SymbolTableIndex );
2134 /* Hmm..mysterious looking offset - what's it for? SOF */
2135 printName ( sym->Name, strtab -10 );
2142 debugBelch("string table has size 0x%x\n", * (UInt32*)strtab );
2143 debugBelch("---START of string table---\n");
2144 for (i = 4; i < *(Int32*)strtab; i++) {
2146 debugBelch("\n"); else
2147 debugBelch("%c", strtab[i] );
2149 debugBelch("--- END of string table---\n");
2154 COFF_symbol* symtab_i;
2155 if (i >= (Int32)(hdr->NumberOfSymbols)) break;
2156 symtab_i = (COFF_symbol*)
2157 myindex ( sizeof_COFF_symbol, symtab, i );
2163 printName ( symtab_i->Name, strtab );
2172 (Int32)(symtab_i->SectionNumber),
2173 (UInt32)symtab_i->Type,
2174 (UInt32)symtab_i->StorageClass,
2175 (UInt32)symtab_i->NumberOfAuxSymbols
2177 i += symtab_i->NumberOfAuxSymbols;
2187 ocGetNames_PEi386 ( ObjectCode* oc )
2190 COFF_section* sectab;
2191 COFF_symbol* symtab;
2198 hdr = (COFF_header*)(oc->image);
2199 sectab = (COFF_section*) (
2200 ((UChar*)(oc->image))
2201 + sizeof_COFF_header + hdr->SizeOfOptionalHeader
2203 symtab = (COFF_symbol*) (
2204 ((UChar*)(oc->image))
2205 + hdr->PointerToSymbolTable
2207 strtab = ((UChar*)(oc->image))
2208 + hdr->PointerToSymbolTable
2209 + hdr->NumberOfSymbols * sizeof_COFF_symbol;
2211 /* Allocate space for any (local, anonymous) .bss sections. */
2213 for (i = 0; i < hdr->NumberOfSections; i++) {
2216 COFF_section* sectab_i
2218 myindex ( sizeof_COFF_section, sectab, i );
2219 if (0 != strcmp(sectab_i->Name, ".bss")) continue;
2220 /* sof 10/05: the PE spec text isn't too clear regarding what
2221 * the SizeOfRawData field is supposed to hold for object
2222 * file sections containing just uninitialized data -- for executables,
2223 * it is supposed to be zero; unclear what it's supposed to be
2224 * for object files. However, VirtualSize is guaranteed to be
2225 * zero for object files, which definitely suggests that SizeOfRawData
2226 * will be non-zero (where else would the size of this .bss section be
2227 * stored?) Looking at the COFF_section info for incoming object files,
2228 * this certainly appears to be the case.
2230 * => I suspect we've been incorrectly handling .bss sections in (relocatable)
2231 * object files up until now. This turned out to bite us with ghc-6.4.1's use
2232 * of gcc-3.4.x, which has started to emit initially-zeroed-out local 'static'
2233 * variable decls into to the .bss section. (The specific function in Q which
2234 * triggered this is libraries/base/cbits/dirUtils.c:__hscore_getFolderPath())
2236 if (sectab_i->VirtualSize == 0 && sectab_i->SizeOfRawData == 0) continue;
2237 /* This is a non-empty .bss section. Allocate zeroed space for
2238 it, and set its PointerToRawData field such that oc->image +
2239 PointerToRawData == addr_of_zeroed_space. */
2240 bss_sz = sectab_i->VirtualSize;
2241 if ( bss_sz < sectab_i->SizeOfRawData) { bss_sz = sectab_i->SizeOfRawData; }
2242 zspace = stgCallocBytes(1, bss_sz, "ocGetNames_PEi386(anonymous bss)");
2243 sectab_i->PointerToRawData = ((UChar*)zspace) - ((UChar*)(oc->image));
2244 addProddableBlock(oc, zspace, bss_sz);
2245 /* debugBelch("BSS anon section at 0x%x\n", zspace); */
2248 /* Copy section information into the ObjectCode. */
2250 for (i = 0; i < hdr->NumberOfSections; i++) {
2256 = SECTIONKIND_OTHER;
2257 COFF_section* sectab_i
2259 myindex ( sizeof_COFF_section, sectab, i );
2260 IF_DEBUG(linker, debugBelch("section name = %s\n", sectab_i->Name ));
2263 /* I'm sure this is the Right Way to do it. However, the
2264 alternative of testing the sectab_i->Name field seems to
2265 work ok with Cygwin.
2267 if (sectab_i->Characteristics & MYIMAGE_SCN_CNT_CODE ||
2268 sectab_i->Characteristics & MYIMAGE_SCN_CNT_INITIALIZED_DATA)
2269 kind = SECTIONKIND_CODE_OR_RODATA;
2272 if (0==strcmp(".text",sectab_i->Name) ||
2273 0==strcmp(".rdata",sectab_i->Name)||
2274 0==strcmp(".rodata",sectab_i->Name))
2275 kind = SECTIONKIND_CODE_OR_RODATA;
2276 if (0==strcmp(".data",sectab_i->Name) ||
2277 0==strcmp(".bss",sectab_i->Name))
2278 kind = SECTIONKIND_RWDATA;
2280 ASSERT(sectab_i->SizeOfRawData == 0 || sectab_i->VirtualSize == 0);
2281 sz = sectab_i->SizeOfRawData;
2282 if (sz < sectab_i->VirtualSize) sz = sectab_i->VirtualSize;
2284 start = ((UChar*)(oc->image)) + sectab_i->PointerToRawData;
2285 end = start + sz - 1;
2287 if (kind == SECTIONKIND_OTHER
2288 /* Ignore sections called which contain stabs debugging
2290 && 0 != strcmp(".stab", sectab_i->Name)
2291 && 0 != strcmp(".stabstr", sectab_i->Name)
2292 /* ignore constructor section for now */
2293 && 0 != strcmp(".ctors", sectab_i->Name)
2294 /* ignore section generated from .ident */
2295 && 0!= strcmp("/4", sectab_i->Name)
2296 /* ignore unknown section that appeared in gcc 3.4.5(?) */
2297 && 0!= strcmp(".reloc", sectab_i->Name)
2299 errorBelch("Unknown PEi386 section name `%s' (while processing: %s)", sectab_i->Name, oc->fileName);
2303 if (kind != SECTIONKIND_OTHER && end >= start) {
2304 addSection(oc, kind, start, end);
2305 addProddableBlock(oc, start, end - start + 1);
2309 /* Copy exported symbols into the ObjectCode. */
2311 oc->n_symbols = hdr->NumberOfSymbols;
2312 oc->symbols = stgMallocBytes(oc->n_symbols * sizeof(char*),
2313 "ocGetNames_PEi386(oc->symbols)");
2314 /* Call me paranoid; I don't care. */
2315 for (i = 0; i < oc->n_symbols; i++)
2316 oc->symbols[i] = NULL;
2320 COFF_symbol* symtab_i;
2321 if (i >= (Int32)(hdr->NumberOfSymbols)) break;
2322 symtab_i = (COFF_symbol*)
2323 myindex ( sizeof_COFF_symbol, symtab, i );
2327 if (symtab_i->StorageClass == MYIMAGE_SYM_CLASS_EXTERNAL
2328 && symtab_i->SectionNumber != MYIMAGE_SYM_UNDEFINED) {
2329 /* This symbol is global and defined, viz, exported */
2330 /* for MYIMAGE_SYMCLASS_EXTERNAL
2331 && !MYIMAGE_SYM_UNDEFINED,
2332 the address of the symbol is:
2333 address of relevant section + offset in section
2335 COFF_section* sectabent
2336 = (COFF_section*) myindex ( sizeof_COFF_section,
2338 symtab_i->SectionNumber-1 );
2339 addr = ((UChar*)(oc->image))
2340 + (sectabent->PointerToRawData
2344 if (symtab_i->SectionNumber == MYIMAGE_SYM_UNDEFINED
2345 && symtab_i->Value > 0) {
2346 /* This symbol isn't in any section at all, ie, global bss.
2347 Allocate zeroed space for it. */
2348 addr = stgCallocBytes(1, symtab_i->Value,
2349 "ocGetNames_PEi386(non-anonymous bss)");
2350 addSection(oc, SECTIONKIND_RWDATA, addr,
2351 ((UChar*)addr) + symtab_i->Value - 1);
2352 addProddableBlock(oc, addr, symtab_i->Value);
2353 /* debugBelch("BSS section at 0x%x\n", addr); */
2356 if (addr != NULL ) {
2357 sname = cstring_from_COFF_symbol_name ( symtab_i->Name, strtab );
2358 /* debugBelch("addSymbol %p `%s \n", addr,sname); */
2359 IF_DEBUG(linker, debugBelch("addSymbol %p `%s'\n", addr,sname);)
2360 ASSERT(i >= 0 && i < oc->n_symbols);
2361 /* cstring_from_COFF_symbol_name always succeeds. */
2362 oc->symbols[i] = sname;
2363 ghciInsertStrHashTable(oc->fileName, symhash, sname, addr);
2367 "IGNORING symbol %d\n"
2371 printName ( symtab_i->Name, strtab );
2380 (Int32)(symtab_i->SectionNumber),
2381 (UInt32)symtab_i->Type,
2382 (UInt32)symtab_i->StorageClass,
2383 (UInt32)symtab_i->NumberOfAuxSymbols
2388 i += symtab_i->NumberOfAuxSymbols;
2397 ocResolve_PEi386 ( ObjectCode* oc )
2400 COFF_section* sectab;
2401 COFF_symbol* symtab;
2411 /* ToDo: should be variable-sized? But is at least safe in the
2412 sense of buffer-overrun-proof. */
2414 /* debugBelch("resolving for %s\n", oc->fileName); */
2416 hdr = (COFF_header*)(oc->image);
2417 sectab = (COFF_section*) (
2418 ((UChar*)(oc->image))
2419 + sizeof_COFF_header + hdr->SizeOfOptionalHeader
2421 symtab = (COFF_symbol*) (
2422 ((UChar*)(oc->image))
2423 + hdr->PointerToSymbolTable
2425 strtab = ((UChar*)(oc->image))
2426 + hdr->PointerToSymbolTable
2427 + hdr->NumberOfSymbols * sizeof_COFF_symbol;
2429 for (i = 0; i < hdr->NumberOfSections; i++) {
2430 COFF_section* sectab_i
2432 myindex ( sizeof_COFF_section, sectab, i );
2435 ((UChar*)(oc->image)) + sectab_i->PointerToRelocations
2438 /* Ignore sections called which contain stabs debugging
2440 if (0 == strcmp(".stab", sectab_i->Name)
2441 || 0 == strcmp(".stabstr", sectab_i->Name)
2442 || 0 == strcmp(".ctors", sectab_i->Name))
2445 if ( sectab_i->Characteristics & MYIMAGE_SCN_LNK_NRELOC_OVFL ) {
2446 /* If the relocation field (a short) has overflowed, the
2447 * real count can be found in the first reloc entry.
2449 * See Section 4.1 (last para) of the PE spec (rev6.0).
2451 * Nov2003 update: the GNU linker still doesn't correctly
2452 * handle the generation of relocatable object files with
2453 * overflown relocations. Hence the output to warn of potential
2456 COFF_reloc* rel = (COFF_reloc*)
2457 myindex ( sizeof_COFF_reloc, reltab, 0 );
2458 noRelocs = rel->VirtualAddress;
2460 /* 10/05: we now assume (and check for) a GNU ld that is capable
2461 * of handling object files with (>2^16) of relocs.
2464 debugBelch("WARNING: Overflown relocation field (# relocs found: %u)\n",
2469 noRelocs = sectab_i->NumberOfRelocations;
2474 for (; j < noRelocs; j++) {
2476 COFF_reloc* reltab_j
2478 myindex ( sizeof_COFF_reloc, reltab, j );
2480 /* the location to patch */
2482 ((UChar*)(oc->image))
2483 + (sectab_i->PointerToRawData
2484 + reltab_j->VirtualAddress
2485 - sectab_i->VirtualAddress )
2487 /* the existing contents of pP */
2489 /* the symbol to connect to */
2490 sym = (COFF_symbol*)
2491 myindex ( sizeof_COFF_symbol,
2492 symtab, reltab_j->SymbolTableIndex );
2495 "reloc sec %2d num %3d: type 0x%-4x "
2496 "vaddr 0x%-8x name `",
2498 (UInt32)reltab_j->Type,
2499 reltab_j->VirtualAddress );
2500 printName ( sym->Name, strtab );
2501 debugBelch("'\n" ));
2503 if (sym->StorageClass == MYIMAGE_SYM_CLASS_STATIC) {
2504 COFF_section* section_sym
2505 = findPEi386SectionCalled ( oc, sym->Name );
2507 errorBelch("%s: can't find section `%s'", oc->fileName, sym->Name);
2510 S = ((UInt32)(oc->image))
2511 + (section_sym->PointerToRawData
2514 copyName ( sym->Name, strtab, symbol, 1000-1 );
2515 S = (UInt32) lookupSymbol( symbol );
2516 if ((void*)S != NULL) goto foundit;
2517 zapTrailingAtSign ( symbol );
2518 S = (UInt32) lookupSymbol( symbol );
2519 if ((void*)S != NULL) goto foundit;
2520 /* Newline first because the interactive linker has printed "linking..." */
2521 errorBelch("\n%s: unknown symbol `%s'", oc->fileName, symbol);
2525 checkProddableBlock(oc, pP);
2526 switch (reltab_j->Type) {
2527 case MYIMAGE_REL_I386_DIR32:
2530 case MYIMAGE_REL_I386_REL32:
2531 /* Tricky. We have to insert a displacement at
2532 pP which, when added to the PC for the _next_
2533 insn, gives the address of the target (S).
2534 Problem is to know the address of the next insn
2535 when we only know pP. We assume that this
2536 literal field is always the last in the insn,
2537 so that the address of the next insn is pP+4
2538 -- hence the constant 4.
2539 Also I don't know if A should be added, but so
2540 far it has always been zero.
2542 SOF 05/2005: 'A' (old contents of *pP) have been observed
2543 to contain values other than zero (the 'wx' object file
2544 that came with wxhaskell-0.9.4; dunno how it was compiled..).
2545 So, add displacement to old value instead of asserting
2546 A to be zero. Fixes wxhaskell-related crashes, and no other
2547 ill effects have been observed.
2549 Update: the reason why we're seeing these more elaborate
2550 relocations is due to a switch in how the NCG compiles SRTs
2551 and offsets to them from info tables. SRTs live in .(ro)data,
2552 while info tables live in .text, causing GAS to emit REL32/DISP32
2553 relocations with non-zero values. Adding the displacement is
2554 the right thing to do.
2556 *pP = S - ((UInt32)pP) - 4 + A;
2559 debugBelch("%s: unhandled PEi386 relocation type %d",
2560 oc->fileName, reltab_j->Type);
2567 IF_DEBUG(linker, debugBelch("completed %s", oc->fileName));
2571 #endif /* defined(OBJFORMAT_PEi386) */
2574 /* --------------------------------------------------------------------------
2576 * ------------------------------------------------------------------------*/
2578 #if defined(OBJFORMAT_ELF)
2583 #if defined(sparc_HOST_ARCH)
2584 # define ELF_TARGET_SPARC /* Used inside <elf.h> */
2585 #elif defined(i386_HOST_ARCH)
2586 # define ELF_TARGET_386 /* Used inside <elf.h> */
2587 #elif defined(x86_64_HOST_ARCH)
2588 # define ELF_TARGET_X64_64
2590 #elif defined (ia64_HOST_ARCH)
2591 # define ELF_TARGET_IA64 /* Used inside <elf.h> */
2593 # define ELF_FUNCTION_DESC /* calling convention uses function descriptors */
2594 # define ELF_NEED_GOT /* needs Global Offset Table */
2595 # define ELF_NEED_PLT /* needs Procedure Linkage Tables */
2598 #if !defined(openbsd_HOST_OS)
2601 /* openbsd elf has things in different places, with diff names */
2602 # include <elf_abi.h>
2603 # include <machine/reloc.h>
2604 # define R_386_32 RELOC_32
2605 # define R_386_PC32 RELOC_PC32
2608 /* If elf.h doesn't define it */
2609 # ifndef R_X86_64_PC64
2610 # define R_X86_64_PC64 24
2614 * Define a set of types which can be used for both ELF32 and ELF64
2618 #define ELFCLASS ELFCLASS64
2619 #define Elf_Addr Elf64_Addr
2620 #define Elf_Word Elf64_Word
2621 #define Elf_Sword Elf64_Sword
2622 #define Elf_Ehdr Elf64_Ehdr
2623 #define Elf_Phdr Elf64_Phdr
2624 #define Elf_Shdr Elf64_Shdr
2625 #define Elf_Sym Elf64_Sym
2626 #define Elf_Rel Elf64_Rel
2627 #define Elf_Rela Elf64_Rela
2628 #define ELF_ST_TYPE ELF64_ST_TYPE
2629 #define ELF_ST_BIND ELF64_ST_BIND
2630 #define ELF_R_TYPE ELF64_R_TYPE
2631 #define ELF_R_SYM ELF64_R_SYM
2633 #define ELFCLASS ELFCLASS32
2634 #define Elf_Addr Elf32_Addr
2635 #define Elf_Word Elf32_Word
2636 #define Elf_Sword Elf32_Sword
2637 #define Elf_Ehdr Elf32_Ehdr
2638 #define Elf_Phdr Elf32_Phdr
2639 #define Elf_Shdr Elf32_Shdr
2640 #define Elf_Sym Elf32_Sym
2641 #define Elf_Rel Elf32_Rel
2642 #define Elf_Rela Elf32_Rela
2644 #define ELF_ST_TYPE ELF32_ST_TYPE
2647 #define ELF_ST_BIND ELF32_ST_BIND
2650 #define ELF_R_TYPE ELF32_R_TYPE
2653 #define ELF_R_SYM ELF32_R_SYM
2659 * Functions to allocate entries in dynamic sections. Currently we simply
2660 * preallocate a large number, and we don't check if a entry for the given
2661 * target already exists (a linear search is too slow). Ideally these
2662 * entries would be associated with symbols.
2665 /* These sizes sufficient to load HSbase + HShaskell98 + a few modules */
2666 #define GOT_SIZE 0x20000
2667 #define FUNCTION_TABLE_SIZE 0x10000
2668 #define PLT_SIZE 0x08000
2671 static Elf_Addr got[GOT_SIZE];
2672 static unsigned int gotIndex;
2673 static Elf_Addr gp_val = (Elf_Addr)got;
2676 allocateGOTEntry(Elf_Addr target)
2680 if (gotIndex >= GOT_SIZE)
2681 barf("Global offset table overflow");
2683 entry = &got[gotIndex++];
2685 return (Elf_Addr)entry;
2689 #ifdef ELF_FUNCTION_DESC
2695 static FunctionDesc functionTable[FUNCTION_TABLE_SIZE];
2696 static unsigned int functionTableIndex;
2699 allocateFunctionDesc(Elf_Addr target)
2701 FunctionDesc *entry;
2703 if (functionTableIndex >= FUNCTION_TABLE_SIZE)
2704 barf("Function table overflow");
2706 entry = &functionTable[functionTableIndex++];
2708 entry->gp = (Elf_Addr)gp_val;
2709 return (Elf_Addr)entry;
2713 copyFunctionDesc(Elf_Addr target)
2715 FunctionDesc *olddesc = (FunctionDesc *)target;
2716 FunctionDesc *newdesc;
2718 newdesc = (FunctionDesc *)allocateFunctionDesc(olddesc->ip);
2719 newdesc->gp = olddesc->gp;
2720 return (Elf_Addr)newdesc;
2725 #ifdef ia64_HOST_ARCH
2726 static void ia64_reloc_gprel22(Elf_Addr target, Elf_Addr value);
2727 static void ia64_reloc_pcrel21(Elf_Addr target, Elf_Addr value, ObjectCode *oc);
2729 static unsigned char plt_code[] =
2731 /* taken from binutils bfd/elfxx-ia64.c */
2732 0x0b, 0x78, 0x00, 0x02, 0x00, 0x24, /* [MMI] addl r15=0,r1;; */
2733 0x00, 0x41, 0x3c, 0x30, 0x28, 0xc0, /* ld8 r16=[r15],8 */
2734 0x01, 0x08, 0x00, 0x84, /* mov r14=r1;; */
2735 0x11, 0x08, 0x00, 0x1e, 0x18, 0x10, /* [MIB] ld8 r1=[r15] */
2736 0x60, 0x80, 0x04, 0x80, 0x03, 0x00, /* mov b6=r16 */
2737 0x60, 0x00, 0x80, 0x00 /* br.few b6;; */
2740 /* If we can't get to the function descriptor via gp, take a local copy of it */
2741 #define PLT_RELOC(code, target) { \
2742 Elf64_Sxword rel_value = target - gp_val; \
2743 if ((rel_value > 0x1fffff) || (rel_value < -0x1fffff)) \
2744 ia64_reloc_gprel22((Elf_Addr)code, copyFunctionDesc(target)); \
2746 ia64_reloc_gprel22((Elf_Addr)code, target); \
2751 unsigned char code[sizeof(plt_code)];
2755 allocatePLTEntry(Elf_Addr target, ObjectCode *oc)
2757 PLTEntry *plt = (PLTEntry *)oc->plt;
2760 if (oc->pltIndex >= PLT_SIZE)
2761 barf("Procedure table overflow");
2763 entry = &plt[oc->pltIndex++];
2764 memcpy(entry->code, plt_code, sizeof(entry->code));
2765 PLT_RELOC(entry->code, target);
2766 return (Elf_Addr)entry;
2772 return (PLT_SIZE * sizeof(PLTEntry));
2778 * Generic ELF functions
2782 findElfSection ( void* objImage, Elf_Word sh_type )
2784 char* ehdrC = (char*)objImage;
2785 Elf_Ehdr* ehdr = (Elf_Ehdr*)ehdrC;
2786 Elf_Shdr* shdr = (Elf_Shdr*)(ehdrC + ehdr->e_shoff);
2787 char* sh_strtab = ehdrC + shdr[ehdr->e_shstrndx].sh_offset;
2791 for (i = 0; i < ehdr->e_shnum; i++) {
2792 if (shdr[i].sh_type == sh_type
2793 /* Ignore the section header's string table. */
2794 && i != ehdr->e_shstrndx
2795 /* Ignore string tables named .stabstr, as they contain
2797 && 0 != memcmp(".stabstr", sh_strtab + shdr[i].sh_name, 8)
2799 ptr = ehdrC + shdr[i].sh_offset;
2806 #if defined(ia64_HOST_ARCH)
2808 findElfSegment ( void* objImage, Elf_Addr vaddr )
2810 char* ehdrC = (char*)objImage;
2811 Elf_Ehdr* ehdr = (Elf_Ehdr*)ehdrC;
2812 Elf_Phdr* phdr = (Elf_Phdr*)(ehdrC + ehdr->e_phoff);
2813 Elf_Addr segaddr = 0;
2816 for (i = 0; i < ehdr->e_phnum; i++) {
2817 segaddr = phdr[i].p_vaddr;
2818 if ((vaddr >= segaddr) && (vaddr < segaddr + phdr[i].p_memsz))
2826 ocVerifyImage_ELF ( ObjectCode* oc )
2830 int i, j, nent, nstrtab, nsymtabs;
2834 char* ehdrC = (char*)(oc->image);
2835 Elf_Ehdr* ehdr = (Elf_Ehdr*)ehdrC;
2837 if (ehdr->e_ident[EI_MAG0] != ELFMAG0 ||
2838 ehdr->e_ident[EI_MAG1] != ELFMAG1 ||
2839 ehdr->e_ident[EI_MAG2] != ELFMAG2 ||
2840 ehdr->e_ident[EI_MAG3] != ELFMAG3) {
2841 errorBelch("%s: not an ELF object", oc->fileName);
2845 if (ehdr->e_ident[EI_CLASS] != ELFCLASS) {
2846 errorBelch("%s: unsupported ELF format", oc->fileName);
2850 if (ehdr->e_ident[EI_DATA] == ELFDATA2LSB) {
2851 IF_DEBUG(linker,debugBelch( "Is little-endian\n" ));
2853 if (ehdr->e_ident[EI_DATA] == ELFDATA2MSB) {
2854 IF_DEBUG(linker,debugBelch( "Is big-endian\n" ));
2856 errorBelch("%s: unknown endiannness", oc->fileName);
2860 if (ehdr->e_type != ET_REL) {
2861 errorBelch("%s: not a relocatable object (.o) file", oc->fileName);
2864 IF_DEBUG(linker, debugBelch( "Is a relocatable object (.o) file\n" ));
2866 IF_DEBUG(linker,debugBelch( "Architecture is " ));
2867 switch (ehdr->e_machine) {
2868 case EM_386: IF_DEBUG(linker,debugBelch( "x86" )); break;
2869 #ifdef EM_SPARC32PLUS
2870 case EM_SPARC32PLUS:
2872 case EM_SPARC: IF_DEBUG(linker,debugBelch( "sparc" )); break;
2874 case EM_IA_64: IF_DEBUG(linker,debugBelch( "ia64" )); break;
2876 case EM_PPC: IF_DEBUG(linker,debugBelch( "powerpc32" )); break;
2878 case EM_X86_64: IF_DEBUG(linker,debugBelch( "x86_64" )); break;
2879 #elif defined(EM_AMD64)
2880 case EM_AMD64: IF_DEBUG(linker,debugBelch( "amd64" )); break;
2882 default: IF_DEBUG(linker,debugBelch( "unknown" ));
2883 errorBelch("%s: unknown architecture (e_machine == %d)"
2884 , oc->fileName, ehdr->e_machine);
2888 IF_DEBUG(linker,debugBelch(
2889 "\nSection header table: start %ld, n_entries %d, ent_size %d\n",
2890 (long)ehdr->e_shoff, ehdr->e_shnum, ehdr->e_shentsize ));
2892 ASSERT (ehdr->e_shentsize == sizeof(Elf_Shdr));
2894 shdr = (Elf_Shdr*) (ehdrC + ehdr->e_shoff);
2896 if (ehdr->e_shstrndx == SHN_UNDEF) {
2897 errorBelch("%s: no section header string table", oc->fileName);
2900 IF_DEBUG(linker,debugBelch( "Section header string table is section %d\n",
2902 sh_strtab = ehdrC + shdr[ehdr->e_shstrndx].sh_offset;
2905 for (i = 0; i < ehdr->e_shnum; i++) {
2906 IF_DEBUG(linker,debugBelch("%2d: ", i ));
2907 IF_DEBUG(linker,debugBelch("type=%2d ", (int)shdr[i].sh_type ));
2908 IF_DEBUG(linker,debugBelch("size=%4d ", (int)shdr[i].sh_size ));
2909 IF_DEBUG(linker,debugBelch("offs=%4d ", (int)shdr[i].sh_offset ));
2910 IF_DEBUG(linker,debugBelch(" (%p .. %p) ",
2911 ehdrC + shdr[i].sh_offset,
2912 ehdrC + shdr[i].sh_offset + shdr[i].sh_size - 1));
2914 if (shdr[i].sh_type == SHT_REL) {
2915 IF_DEBUG(linker,debugBelch("Rel " ));
2916 } else if (shdr[i].sh_type == SHT_RELA) {
2917 IF_DEBUG(linker,debugBelch("RelA " ));
2919 IF_DEBUG(linker,debugBelch(" "));
2922 IF_DEBUG(linker,debugBelch("sname=%s\n", sh_strtab + shdr[i].sh_name ));
2926 IF_DEBUG(linker,debugBelch( "\nString tables" ));
2929 for (i = 0; i < ehdr->e_shnum; i++) {
2930 if (shdr[i].sh_type == SHT_STRTAB
2931 /* Ignore the section header's string table. */
2932 && i != ehdr->e_shstrndx
2933 /* Ignore string tables named .stabstr, as they contain
2935 && 0 != memcmp(".stabstr", sh_strtab + shdr[i].sh_name, 8)
2937 IF_DEBUG(linker,debugBelch(" section %d is a normal string table", i ));
2938 strtab = ehdrC + shdr[i].sh_offset;
2943 errorBelch("%s: no string tables, or too many", oc->fileName);
2948 IF_DEBUG(linker,debugBelch( "\nSymbol tables" ));
2949 for (i = 0; i < ehdr->e_shnum; i++) {
2950 if (shdr[i].sh_type != SHT_SYMTAB) continue;
2951 IF_DEBUG(linker,debugBelch( "section %d is a symbol table\n", i ));
2953 stab = (Elf_Sym*) (ehdrC + shdr[i].sh_offset);
2954 nent = shdr[i].sh_size / sizeof(Elf_Sym);
2955 IF_DEBUG(linker,debugBelch( " number of entries is apparently %d (%ld rem)\n",
2957 (long)shdr[i].sh_size % sizeof(Elf_Sym)
2959 if (0 != shdr[i].sh_size % sizeof(Elf_Sym)) {
2960 errorBelch("%s: non-integral number of symbol table entries", oc->fileName);
2963 for (j = 0; j < nent; j++) {
2964 IF_DEBUG(linker,debugBelch(" %2d ", j ));
2965 IF_DEBUG(linker,debugBelch(" sec=%-5d size=%-3d val=%5p ",
2966 (int)stab[j].st_shndx,
2967 (int)stab[j].st_size,
2968 (char*)stab[j].st_value ));
2970 IF_DEBUG(linker,debugBelch("type=" ));
2971 switch (ELF_ST_TYPE(stab[j].st_info)) {
2972 case STT_NOTYPE: IF_DEBUG(linker,debugBelch("notype " )); break;
2973 case STT_OBJECT: IF_DEBUG(linker,debugBelch("object " )); break;
2974 case STT_FUNC : IF_DEBUG(linker,debugBelch("func " )); break;
2975 case STT_SECTION: IF_DEBUG(linker,debugBelch("section" )); break;
2976 case STT_FILE: IF_DEBUG(linker,debugBelch("file " )); break;
2977 default: IF_DEBUG(linker,debugBelch("? " )); break;
2979 IF_DEBUG(linker,debugBelch(" " ));
2981 IF_DEBUG(linker,debugBelch("bind=" ));
2982 switch (ELF_ST_BIND(stab[j].st_info)) {
2983 case STB_LOCAL : IF_DEBUG(linker,debugBelch("local " )); break;
2984 case STB_GLOBAL: IF_DEBUG(linker,debugBelch("global" )); break;
2985 case STB_WEAK : IF_DEBUG(linker,debugBelch("weak " )); break;
2986 default: IF_DEBUG(linker,debugBelch("? " )); break;
2988 IF_DEBUG(linker,debugBelch(" " ));
2990 IF_DEBUG(linker,debugBelch("name=%s\n", strtab + stab[j].st_name ));
2994 if (nsymtabs == 0) {
2995 errorBelch("%s: didn't find any symbol tables", oc->fileName);
3002 static int getSectionKind_ELF( Elf_Shdr *hdr, int *is_bss )
3006 if (hdr->sh_type == SHT_PROGBITS
3007 && (hdr->sh_flags & SHF_ALLOC) && (hdr->sh_flags & SHF_EXECINSTR)) {
3008 /* .text-style section */
3009 return SECTIONKIND_CODE_OR_RODATA;
3012 if (hdr->sh_type == SHT_PROGBITS
3013 && (hdr->sh_flags & SHF_ALLOC) && (hdr->sh_flags & SHF_WRITE)) {
3014 /* .data-style section */
3015 return SECTIONKIND_RWDATA;
3018 if (hdr->sh_type == SHT_PROGBITS
3019 && (hdr->sh_flags & SHF_ALLOC) && !(hdr->sh_flags & SHF_WRITE)) {
3020 /* .rodata-style section */
3021 return SECTIONKIND_CODE_OR_RODATA;
3024 if (hdr->sh_type == SHT_NOBITS
3025 && (hdr->sh_flags & SHF_ALLOC) && (hdr->sh_flags & SHF_WRITE)) {
3026 /* .bss-style section */
3028 return SECTIONKIND_RWDATA;
3031 return SECTIONKIND_OTHER;
3036 ocGetNames_ELF ( ObjectCode* oc )
3041 char* ehdrC = (char*)(oc->image);
3042 Elf_Ehdr* ehdr = (Elf_Ehdr*)ehdrC;
3043 char* strtab = findElfSection ( ehdrC, SHT_STRTAB );
3044 Elf_Shdr* shdr = (Elf_Shdr*) (ehdrC + ehdr->e_shoff);
3046 ASSERT(symhash != NULL);
3049 errorBelch("%s: no strtab", oc->fileName);
3054 for (i = 0; i < ehdr->e_shnum; i++) {
3055 /* Figure out what kind of section it is. Logic derived from
3056 Figure 1.14 ("Special Sections") of the ELF document
3057 ("Portable Formats Specification, Version 1.1"). */
3059 SectionKind kind = getSectionKind_ELF(&shdr[i], &is_bss);
3061 if (is_bss && shdr[i].sh_size > 0) {
3062 /* This is a non-empty .bss section. Allocate zeroed space for
3063 it, and set its .sh_offset field such that
3064 ehdrC + .sh_offset == addr_of_zeroed_space. */
3065 char* zspace = stgCallocBytes(1, shdr[i].sh_size,
3066 "ocGetNames_ELF(BSS)");
3067 shdr[i].sh_offset = ((char*)zspace) - ((char*)ehdrC);
3069 debugBelch("BSS section at 0x%x, size %d\n",
3070 zspace, shdr[i].sh_size);
3074 /* fill in the section info */
3075 if (kind != SECTIONKIND_OTHER && shdr[i].sh_size > 0) {
3076 addProddableBlock(oc, ehdrC + shdr[i].sh_offset, shdr[i].sh_size);
3077 addSection(oc, kind, ehdrC + shdr[i].sh_offset,
3078 ehdrC + shdr[i].sh_offset + shdr[i].sh_size - 1);
3081 if (shdr[i].sh_type != SHT_SYMTAB) continue;
3083 /* copy stuff into this module's object symbol table */
3084 stab = (Elf_Sym*) (ehdrC + shdr[i].sh_offset);
3085 nent = shdr[i].sh_size / sizeof(Elf_Sym);
3087 oc->n_symbols = nent;
3088 oc->symbols = stgMallocBytes(oc->n_symbols * sizeof(char*),
3089 "ocGetNames_ELF(oc->symbols)");
3091 for (j = 0; j < nent; j++) {
3093 char isLocal = FALSE; /* avoids uninit-var warning */
3095 char* nm = strtab + stab[j].st_name;
3096 int secno = stab[j].st_shndx;
3098 /* Figure out if we want to add it; if so, set ad to its
3099 address. Otherwise leave ad == NULL. */
3101 if (secno == SHN_COMMON) {
3103 ad = stgCallocBytes(1, stab[j].st_size, "ocGetNames_ELF(COMMON)");
3105 debugBelch("COMMON symbol, size %d name %s\n",
3106 stab[j].st_size, nm);
3108 /* Pointless to do addProddableBlock() for this area,
3109 since the linker should never poke around in it. */
3112 if ( ( ELF_ST_BIND(stab[j].st_info)==STB_GLOBAL
3113 || ELF_ST_BIND(stab[j].st_info)==STB_LOCAL
3115 /* and not an undefined symbol */
3116 && stab[j].st_shndx != SHN_UNDEF
3117 /* and not in a "special section" */
3118 && stab[j].st_shndx < SHN_LORESERVE
3120 /* and it's a not a section or string table or anything silly */
3121 ( ELF_ST_TYPE(stab[j].st_info)==STT_FUNC ||
3122 ELF_ST_TYPE(stab[j].st_info)==STT_OBJECT ||
3123 ELF_ST_TYPE(stab[j].st_info)==STT_NOTYPE
3126 /* Section 0 is the undefined section, hence > and not >=. */
3127 ASSERT(secno > 0 && secno < ehdr->e_shnum);
3129 if (shdr[secno].sh_type == SHT_NOBITS) {
3130 debugBelch(" BSS symbol, size %d off %d name %s\n",
3131 stab[j].st_size, stab[j].st_value, nm);
3134 ad = ehdrC + shdr[ secno ].sh_offset + stab[j].st_value;
3135 if (ELF_ST_BIND(stab[j].st_info)==STB_LOCAL) {
3138 #ifdef ELF_FUNCTION_DESC
3139 /* dlsym() and the initialisation table both give us function
3140 * descriptors, so to be consistent we store function descriptors
3141 * in the symbol table */
3142 if (ELF_ST_TYPE(stab[j].st_info) == STT_FUNC)
3143 ad = (char *)allocateFunctionDesc((Elf_Addr)ad);
3145 IF_DEBUG(linker,debugBelch( "addOTabName(GLOB): %10p %s %s\n",
3146 ad, oc->fileName, nm ));
3151 /* And the decision is ... */
3155 oc->symbols[j] = nm;
3158 /* Ignore entirely. */
3160 ghciInsertStrHashTable(oc->fileName, symhash, nm, ad);
3164 IF_DEBUG(linker,debugBelch( "skipping `%s'\n",
3165 strtab + stab[j].st_name ));
3168 "skipping bind = %d, type = %d, shndx = %d `%s'\n",
3169 (int)ELF_ST_BIND(stab[j].st_info),
3170 (int)ELF_ST_TYPE(stab[j].st_info),
3171 (int)stab[j].st_shndx,
3172 strtab + stab[j].st_name
3175 oc->symbols[j] = NULL;
3184 /* Do ELF relocations which lack an explicit addend. All x86-linux
3185 relocations appear to be of this form. */
3187 do_Elf_Rel_relocations ( ObjectCode* oc, char* ehdrC,
3188 Elf_Shdr* shdr, int shnum,
3189 Elf_Sym* stab, char* strtab )
3194 Elf_Rel* rtab = (Elf_Rel*) (ehdrC + shdr[shnum].sh_offset);
3195 int nent = shdr[shnum].sh_size / sizeof(Elf_Rel);
3196 int target_shndx = shdr[shnum].sh_info;
3197 int symtab_shndx = shdr[shnum].sh_link;
3199 stab = (Elf_Sym*) (ehdrC + shdr[ symtab_shndx ].sh_offset);
3200 targ = (Elf_Word*)(ehdrC + shdr[ target_shndx ].sh_offset);
3201 IF_DEBUG(linker,debugBelch( "relocations for section %d using symtab %d\n",
3202 target_shndx, symtab_shndx ));
3204 /* Skip sections that we're not interested in. */
3207 SectionKind kind = getSectionKind_ELF(&shdr[target_shndx], &is_bss);
3208 if (kind == SECTIONKIND_OTHER) {
3209 IF_DEBUG(linker,debugBelch( "skipping (target section not loaded)"));
3214 for (j = 0; j < nent; j++) {
3215 Elf_Addr offset = rtab[j].r_offset;
3216 Elf_Addr info = rtab[j].r_info;
3218 Elf_Addr P = ((Elf_Addr)targ) + offset;
3219 Elf_Word* pP = (Elf_Word*)P;
3224 StgStablePtr stablePtr;
3227 IF_DEBUG(linker,debugBelch( "Rel entry %3d is raw(%6p %6p)",
3228 j, (void*)offset, (void*)info ));
3230 IF_DEBUG(linker,debugBelch( " ZERO" ));
3233 Elf_Sym sym = stab[ELF_R_SYM(info)];
3234 /* First see if it is a local symbol. */
3235 if (ELF_ST_BIND(sym.st_info) == STB_LOCAL) {
3236 /* Yes, so we can get the address directly from the ELF symbol
3238 symbol = sym.st_name==0 ? "(noname)" : strtab+sym.st_name;
3240 (ehdrC + shdr[ sym.st_shndx ].sh_offset
3241 + stab[ELF_R_SYM(info)].st_value);
3244 symbol = strtab + sym.st_name;
3245 stablePtr = (StgStablePtr)lookupHashTable(stablehash, (StgWord)symbol);
3246 if (NULL == stablePtr) {
3247 /* No, so look up the name in our global table. */
3248 S_tmp = lookupSymbol( symbol );
3249 S = (Elf_Addr)S_tmp;
3251 stableVal = deRefStablePtr( stablePtr );
3253 S = (Elf_Addr)S_tmp;
3257 errorBelch("%s: unknown symbol `%s'", oc->fileName, symbol);
3260 IF_DEBUG(linker,debugBelch( "`%s' resolves to %p\n", symbol, (void*)S ));
3263 IF_DEBUG(linker,debugBelch( "Reloc: P = %p S = %p A = %p\n",
3264 (void*)P, (void*)S, (void*)A ));
3265 checkProddableBlock ( oc, pP );
3269 switch (ELF_R_TYPE(info)) {
3270 # ifdef i386_HOST_ARCH
3271 case R_386_32: *pP = value; break;
3272 case R_386_PC32: *pP = value - P; break;
3275 errorBelch("%s: unhandled ELF relocation(Rel) type %lu\n",
3276 oc->fileName, (lnat)ELF_R_TYPE(info));
3284 /* Do ELF relocations for which explicit addends are supplied.
3285 sparc-solaris relocations appear to be of this form. */
3287 do_Elf_Rela_relocations ( ObjectCode* oc, char* ehdrC,
3288 Elf_Shdr* shdr, int shnum,
3289 Elf_Sym* stab, char* strtab )
3292 char *symbol = NULL;
3294 Elf_Rela* rtab = (Elf_Rela*) (ehdrC + shdr[shnum].sh_offset);
3295 int nent = shdr[shnum].sh_size / sizeof(Elf_Rela);
3296 int target_shndx = shdr[shnum].sh_info;
3297 int symtab_shndx = shdr[shnum].sh_link;
3299 stab = (Elf_Sym*) (ehdrC + shdr[ symtab_shndx ].sh_offset);
3300 targ = (Elf_Addr) (ehdrC + shdr[ target_shndx ].sh_offset);
3301 IF_DEBUG(linker,debugBelch( "relocations for section %d using symtab %d\n",
3302 target_shndx, symtab_shndx ));
3304 for (j = 0; j < nent; j++) {
3305 #if defined(DEBUG) || defined(sparc_HOST_ARCH) || defined(ia64_HOST_ARCH) || defined(powerpc_HOST_ARCH) || defined(x86_64_HOST_ARCH)
3306 /* This #ifdef only serves to avoid unused-var warnings. */
3307 Elf_Addr offset = rtab[j].r_offset;
3308 Elf_Addr P = targ + offset;
3310 Elf_Addr info = rtab[j].r_info;
3311 Elf_Addr A = rtab[j].r_addend;
3315 # if defined(sparc_HOST_ARCH)
3316 Elf_Word* pP = (Elf_Word*)P;
3318 # elif defined(ia64_HOST_ARCH)
3319 Elf64_Xword *pP = (Elf64_Xword *)P;
3321 # elif defined(powerpc_HOST_ARCH)
3325 IF_DEBUG(linker,debugBelch( "Rel entry %3d is raw(%6p %6p %6p) ",
3326 j, (void*)offset, (void*)info,
3329 IF_DEBUG(linker,debugBelch( " ZERO" ));
3332 Elf_Sym sym = stab[ELF_R_SYM(info)];
3333 /* First see if it is a local symbol. */
3334 if (ELF_ST_BIND(sym.st_info) == STB_LOCAL) {
3335 /* Yes, so we can get the address directly from the ELF symbol
3337 symbol = sym.st_name==0 ? "(noname)" : strtab+sym.st_name;
3339 (ehdrC + shdr[ sym.st_shndx ].sh_offset
3340 + stab[ELF_R_SYM(info)].st_value);
3341 #ifdef ELF_FUNCTION_DESC
3342 /* Make a function descriptor for this function */
3343 if (S && ELF_ST_TYPE(sym.st_info) == STT_FUNC) {
3344 S = allocateFunctionDesc(S + A);
3349 /* No, so look up the name in our global table. */
3350 symbol = strtab + sym.st_name;
3351 S_tmp = lookupSymbol( symbol );
3352 S = (Elf_Addr)S_tmp;
3354 #ifdef ELF_FUNCTION_DESC
3355 /* If a function, already a function descriptor - we would
3356 have to copy it to add an offset. */
3357 if (S && (ELF_ST_TYPE(sym.st_info) == STT_FUNC) && (A != 0))
3358 errorBelch("%s: function %s with addend %p", oc->fileName, symbol, (void *)A);
3362 errorBelch("%s: unknown symbol `%s'", oc->fileName, symbol);
3365 IF_DEBUG(linker,debugBelch( "`%s' resolves to %p", symbol, (void*)S ));
3368 IF_DEBUG(linker,debugBelch("Reloc: P = %p S = %p A = %p\n",
3369 (void*)P, (void*)S, (void*)A ));
3370 /* checkProddableBlock ( oc, (void*)P ); */
3374 switch (ELF_R_TYPE(info)) {
3375 # if defined(sparc_HOST_ARCH)
3376 case R_SPARC_WDISP30:
3377 w1 = *pP & 0xC0000000;
3378 w2 = (Elf_Word)((value - P) >> 2);
3379 ASSERT((w2 & 0xC0000000) == 0);
3384 w1 = *pP & 0xFFC00000;
3385 w2 = (Elf_Word)(value >> 10);
3386 ASSERT((w2 & 0xFFC00000) == 0);
3392 w2 = (Elf_Word)(value & 0x3FF);
3393 ASSERT((w2 & ~0x3FF) == 0);
3397 /* According to the Sun documentation:
3399 This relocation type resembles R_SPARC_32, except it refers to an
3400 unaligned word. That is, the word to be relocated must be treated
3401 as four separate bytes with arbitrary alignment, not as a word
3402 aligned according to the architecture requirements.
3404 (JRS: which means that freeloading on the R_SPARC_32 case
3405 is probably wrong, but hey ...)
3409 w2 = (Elf_Word)value;
3412 # elif defined(ia64_HOST_ARCH)
3413 case R_IA64_DIR64LSB:
3414 case R_IA64_FPTR64LSB:
3417 case R_IA64_PCREL64LSB:
3420 case R_IA64_SEGREL64LSB:
3421 addr = findElfSegment(ehdrC, value);
3424 case R_IA64_GPREL22:
3425 ia64_reloc_gprel22(P, value);
3427 case R_IA64_LTOFF22:
3428 case R_IA64_LTOFF22X:
3429 case R_IA64_LTOFF_FPTR22:
3430 addr = allocateGOTEntry(value);
3431 ia64_reloc_gprel22(P, addr);
3433 case R_IA64_PCREL21B:
3434 ia64_reloc_pcrel21(P, S, oc);
3437 /* This goes with R_IA64_LTOFF22X and points to the load to
3438 * convert into a move. We don't implement relaxation. */
3440 # elif defined(powerpc_HOST_ARCH)
3441 case R_PPC_ADDR16_LO:
3442 *(Elf32_Half*) P = value;
3445 case R_PPC_ADDR16_HI:
3446 *(Elf32_Half*) P = value >> 16;
3449 case R_PPC_ADDR16_HA:
3450 *(Elf32_Half*) P = (value + 0x8000) >> 16;
3454 *(Elf32_Word *) P = value;
3458 *(Elf32_Word *) P = value - P;
3464 if( delta << 6 >> 6 != delta )
3466 value = (Elf_Addr) (&makeSymbolExtra( oc, ELF_R_SYM(info), value )
3470 if( value == 0 || delta << 6 >> 6 != delta )
3472 barf( "Unable to make SymbolExtra for #%d",
3478 *(Elf_Word *) P = (*(Elf_Word *) P & 0xfc000003)
3479 | (delta & 0x3fffffc);
3483 #if x86_64_HOST_ARCH
3485 *(Elf64_Xword *)P = value;
3490 StgInt64 off = value - P;
3491 if (off >= 0x7fffffffL || off < -0x80000000L) {
3492 #if X86_64_ELF_NONPIC_HACK
3493 StgInt64 pltAddress = (StgInt64) &makeSymbolExtra(oc, ELF_R_SYM(info), S)
3495 off = pltAddress + A - P;
3497 barf("R_X86_64_PC32 relocation out of range: %s = %p\nRecompile %s with -fPIC.",
3498 symbol, off, oc->fileName );
3501 *(Elf64_Word *)P = (Elf64_Word)off;
3507 StgInt64 off = value - P;
3508 *(Elf64_Word *)P = (Elf64_Word)off;
3513 if (value >= 0x7fffffffL) {
3514 #if X86_64_ELF_NONPIC_HACK
3515 StgInt64 pltAddress = (StgInt64) &makeSymbolExtra(oc, ELF_R_SYM(info), S)
3517 value = pltAddress + A;
3519 barf("R_X86_64_32 relocation out of range: %s = %p\nRecompile %s with -fPIC.",
3520 symbol, value, oc->fileName );
3523 *(Elf64_Word *)P = (Elf64_Word)value;
3527 if ((StgInt64)value > 0x7fffffffL || (StgInt64)value < -0x80000000L) {
3528 #if X86_64_ELF_NONPIC_HACK
3529 StgInt64 pltAddress = (StgInt64) &makeSymbolExtra(oc, ELF_R_SYM(info), S)
3531 value = pltAddress + A;
3533 barf("R_X86_64_32S relocation out of range: %s = %p\nRecompile %s with -fPIC.",
3534 symbol, value, oc->fileName );
3537 *(Elf64_Sword *)P = (Elf64_Sword)value;
3540 case R_X86_64_GOTPCREL:
3542 StgInt64 gotAddress = (StgInt64) &makeSymbolExtra(oc, ELF_R_SYM(info), S)->addr;
3543 StgInt64 off = gotAddress + A - P;
3544 *(Elf64_Word *)P = (Elf64_Word)off;
3548 case R_X86_64_PLT32:
3550 StgInt64 off = value - P;
3551 if (off >= 0x7fffffffL || off < -0x80000000L) {
3552 StgInt64 pltAddress = (StgInt64) &makeSymbolExtra(oc, ELF_R_SYM(info), S)
3554 off = pltAddress + A - P;
3556 *(Elf64_Word *)P = (Elf64_Word)off;
3562 errorBelch("%s: unhandled ELF relocation(RelA) type %lu\n",
3563 oc->fileName, (lnat)ELF_R_TYPE(info));
3572 ocResolve_ELF ( ObjectCode* oc )
3576 Elf_Sym* stab = NULL;
3577 char* ehdrC = (char*)(oc->image);
3578 Elf_Ehdr* ehdr = (Elf_Ehdr*) ehdrC;
3579 Elf_Shdr* shdr = (Elf_Shdr*) (ehdrC + ehdr->e_shoff);
3581 /* first find "the" symbol table */
3582 stab = (Elf_Sym*) findElfSection ( ehdrC, SHT_SYMTAB );
3584 /* also go find the string table */
3585 strtab = findElfSection ( ehdrC, SHT_STRTAB );
3587 if (stab == NULL || strtab == NULL) {
3588 errorBelch("%s: can't find string or symbol table", oc->fileName);
3592 /* Process the relocation sections. */
3593 for (shnum = 0; shnum < ehdr->e_shnum; shnum++) {
3594 if (shdr[shnum].sh_type == SHT_REL) {
3595 ok = do_Elf_Rel_relocations ( oc, ehdrC, shdr,
3596 shnum, stab, strtab );
3600 if (shdr[shnum].sh_type == SHT_RELA) {
3601 ok = do_Elf_Rela_relocations ( oc, ehdrC, shdr,
3602 shnum, stab, strtab );
3607 #if defined(powerpc_HOST_ARCH)
3608 ocFlushInstructionCache( oc );
3616 * Instructions are 41 bits long, packed into 128 bit bundles with a 5-bit template
3617 * at the front. The following utility functions pack and unpack instructions, and
3618 * take care of the most common relocations.
3621 #ifdef ia64_HOST_ARCH
3624 ia64_extract_instruction(Elf64_Xword *target)
3627 int slot = (Elf_Addr)target & 3;
3628 target = (Elf_Addr)target & ~3;
3636 return ((w1 >> 5) & 0x1ffffffffff);
3638 return (w1 >> 46) | ((w2 & 0x7fffff) << 18);
3642 barf("ia64_extract_instruction: invalid slot %p", target);
3647 ia64_deposit_instruction(Elf64_Xword *target, Elf64_Xword value)
3649 int slot = (Elf_Addr)target & 3;
3650 target = (Elf_Addr)target & ~3;
3655 *target |= value << 5;
3658 *target |= value << 46;
3659 *(target+1) |= value >> 18;
3662 *(target+1) |= value << 23;
3668 ia64_reloc_gprel22(Elf_Addr target, Elf_Addr value)
3670 Elf64_Xword instruction;
3671 Elf64_Sxword rel_value;
3673 rel_value = value - gp_val;
3674 if ((rel_value > 0x1fffff) || (rel_value < -0x1fffff))
3675 barf("GP-relative data out of range (address = 0x%lx, gp = 0x%lx)", value, gp_val);
3677 instruction = ia64_extract_instruction((Elf64_Xword *)target);
3678 instruction |= (((rel_value >> 0) & 0x07f) << 13) /* imm7b */
3679 | (((rel_value >> 7) & 0x1ff) << 27) /* imm9d */
3680 | (((rel_value >> 16) & 0x01f) << 22) /* imm5c */
3681 | ((Elf64_Xword)(rel_value < 0) << 36); /* s */
3682 ia64_deposit_instruction((Elf64_Xword *)target, instruction);
3686 ia64_reloc_pcrel21(Elf_Addr target, Elf_Addr value, ObjectCode *oc)
3688 Elf64_Xword instruction;
3689 Elf64_Sxword rel_value;
3692 entry = allocatePLTEntry(value, oc);
3694 rel_value = (entry >> 4) - (target >> 4);
3695 if ((rel_value > 0xfffff) || (rel_value < -0xfffff))
3696 barf("PLT entry too far away (entry = 0x%lx, target = 0x%lx)", entry, target);
3698 instruction = ia64_extract_instruction((Elf64_Xword *)target);
3699 instruction |= ((rel_value & 0xfffff) << 13) /* imm20b */
3700 | ((Elf64_Xword)(rel_value < 0) << 36); /* s */
3701 ia64_deposit_instruction((Elf64_Xword *)target, instruction);
3707 * PowerPC & X86_64 ELF specifics
3710 #if defined(powerpc_HOST_ARCH) || defined(x86_64_HOST_ARCH)
3712 static int ocAllocateSymbolExtras_ELF( ObjectCode *oc )
3718 ehdr = (Elf_Ehdr *) oc->image;
3719 shdr = (Elf_Shdr *) ( ((char *)oc->image) + ehdr->e_shoff );
3721 for( i = 0; i < ehdr->e_shnum; i++ )
3722 if( shdr[i].sh_type == SHT_SYMTAB )
3725 if( i == ehdr->e_shnum )
3727 errorBelch( "This ELF file contains no symtab" );
3731 if( shdr[i].sh_entsize != sizeof( Elf_Sym ) )
3733 errorBelch( "The entry size (%d) of the symtab isn't %d\n",
3734 (int) shdr[i].sh_entsize, (int) sizeof( Elf_Sym ) );
3739 return ocAllocateSymbolExtras( oc, shdr[i].sh_size / sizeof( Elf_Sym ), 0 );
3742 #endif /* powerpc */
3746 /* --------------------------------------------------------------------------
3748 * ------------------------------------------------------------------------*/
3750 #if defined(OBJFORMAT_MACHO)
3753 Support for MachO linking on Darwin/MacOS X
3754 by Wolfgang Thaller (wolfgang.thaller@gmx.net)
3756 I hereby formally apologize for the hackish nature of this code.
3757 Things that need to be done:
3758 *) implement ocVerifyImage_MachO
3759 *) add still more sanity checks.
3762 #if x86_64_HOST_ARCH || powerpc64_HOST_ARCH
3763 #define mach_header mach_header_64
3764 #define segment_command segment_command_64
3765 #define section section_64
3766 #define nlist nlist_64
3769 #ifdef powerpc_HOST_ARCH
3770 static int ocAllocateSymbolExtras_MachO(ObjectCode* oc)
3772 struct mach_header *header = (struct mach_header *) oc->image;
3773 struct load_command *lc = (struct load_command *) (header + 1);
3776 for( i = 0; i < header->ncmds; i++ )
3778 if( lc->cmd == LC_SYMTAB )
3780 // Find out the first and last undefined external
3781 // symbol, so we don't have to allocate too many
3783 struct symtab_command *symLC = (struct symtab_command *) lc;
3784 unsigned min = symLC->nsyms, max = 0;
3785 struct nlist *nlist =
3786 symLC ? (struct nlist*) ((char*) oc->image + symLC->symoff)
3788 for(i=0;i<symLC->nsyms;i++)
3790 if(nlist[i].n_type & N_STAB)
3792 else if(nlist[i].n_type & N_EXT)
3794 if((nlist[i].n_type & N_TYPE) == N_UNDF
3795 && (nlist[i].n_value == 0))
3805 return ocAllocateSymbolExtras(oc, max - min + 1, min);
3810 lc = (struct load_command *) ( ((char *)lc) + lc->cmdsize );
3812 return ocAllocateSymbolExtras(oc,0,0);
3815 #ifdef x86_64_HOST_ARCH
3816 static int ocAllocateSymbolExtras_MachO(ObjectCode* oc)
3818 struct mach_header *header = (struct mach_header *) oc->image;
3819 struct load_command *lc = (struct load_command *) (header + 1);
3822 for( i = 0; i < header->ncmds; i++ )
3824 if( lc->cmd == LC_SYMTAB )
3826 // Just allocate one entry for every symbol
3827 struct symtab_command *symLC = (struct symtab_command *) lc;
3829 return ocAllocateSymbolExtras(oc, symLC->nsyms, 0);
3832 lc = (struct load_command *) ( ((char *)lc) + lc->cmdsize );
3834 return ocAllocateSymbolExtras(oc,0,0);
3838 static int ocVerifyImage_MachO(ObjectCode* oc)
3840 char *image = (char*) oc->image;
3841 struct mach_header *header = (struct mach_header*) image;
3843 #if x86_64_TARGET_ARCH || powerpc64_TARGET_ARCH
3844 if(header->magic != MH_MAGIC_64)
3847 if(header->magic != MH_MAGIC)
3850 // FIXME: do some more verifying here
3854 static int resolveImports(
3857 struct symtab_command *symLC,
3858 struct section *sect, // ptr to lazy or non-lazy symbol pointer section
3859 unsigned long *indirectSyms,
3860 struct nlist *nlist)
3863 size_t itemSize = 4;
3866 int isJumpTable = 0;
3867 if(!strcmp(sect->sectname,"__jump_table"))
3871 ASSERT(sect->reserved2 == itemSize);
3875 for(i=0; i*itemSize < sect->size;i++)
3877 // according to otool, reserved1 contains the first index into the indirect symbol table
3878 struct nlist *symbol = &nlist[indirectSyms[sect->reserved1+i]];
3879 char *nm = image + symLC->stroff + symbol->n_un.n_strx;
3882 if((symbol->n_type & N_TYPE) == N_UNDF
3883 && (symbol->n_type & N_EXT) && (symbol->n_value != 0))
3884 addr = (void*) (symbol->n_value);
3886 addr = lookupSymbol(nm);
3889 errorBelch("\n%s: unknown symbol `%s'", oc->fileName, nm);
3897 checkProddableBlock(oc,image + sect->offset + i*itemSize);
3898 *(image + sect->offset + i*itemSize) = 0xe9; // jmp
3899 *(unsigned*)(image + sect->offset + i*itemSize + 1)
3900 = (char*)addr - (image + sect->offset + i*itemSize + 5);
3905 checkProddableBlock(oc,((void**)(image + sect->offset)) + i);
3906 ((void**)(image + sect->offset))[i] = addr;
3913 static unsigned long relocateAddress(
3916 struct section* sections,
3917 unsigned long address)
3920 for(i = 0; i < nSections; i++)
3922 if(sections[i].addr <= address
3923 && address < sections[i].addr + sections[i].size)
3925 return (unsigned long)oc->image
3926 + sections[i].offset + address - sections[i].addr;
3929 barf("Invalid Mach-O file:"
3930 "Address out of bounds while relocating object file");
3934 static int relocateSection(
3937 struct symtab_command *symLC, struct nlist *nlist,
3938 int nSections, struct section* sections, struct section *sect)
3940 struct relocation_info *relocs;
3943 if(!strcmp(sect->sectname,"__la_symbol_ptr"))
3945 else if(!strcmp(sect->sectname,"__nl_symbol_ptr"))
3947 else if(!strcmp(sect->sectname,"__la_sym_ptr2"))
3949 else if(!strcmp(sect->sectname,"__la_sym_ptr3"))
3953 relocs = (struct relocation_info*) (image + sect->reloff);
3957 #ifdef x86_64_HOST_ARCH
3958 struct relocation_info *reloc = &relocs[i];
3960 char *thingPtr = image + sect->offset + reloc->r_address;
3964 int type = reloc->r_type;
3966 checkProddableBlock(oc,thingPtr);
3967 switch(reloc->r_length)
3970 thing = *(uint8_t*)thingPtr;
3971 baseValue = (uint64_t)thingPtr + 1;
3974 thing = *(uint16_t*)thingPtr;
3975 baseValue = (uint64_t)thingPtr + 2;
3978 thing = *(uint32_t*)thingPtr;
3979 baseValue = (uint64_t)thingPtr + 4;
3982 thing = *(uint64_t*)thingPtr;
3983 baseValue = (uint64_t)thingPtr + 8;
3986 barf("Unknown size.");
3989 if(type == X86_64_RELOC_GOT
3990 || type == X86_64_RELOC_GOT_LOAD)
3992 ASSERT(reloc->r_extern);
3993 value = (uint64_t) &makeSymbolExtra(oc, reloc->r_symbolnum, value)->addr;
3995 type = X86_64_RELOC_SIGNED;
3997 else if(reloc->r_extern)
3999 struct nlist *symbol = &nlist[reloc->r_symbolnum];
4000 char *nm = image + symLC->stroff + symbol->n_un.n_strx;
4001 if(symbol->n_value == 0)
4002 value = (uint64_t) lookupSymbol(nm);
4004 value = relocateAddress(oc, nSections, sections,
4009 value = sections[reloc->r_symbolnum-1].offset
4010 - sections[reloc->r_symbolnum-1].addr
4014 if(type == X86_64_RELOC_BRANCH)
4016 if((int32_t)(value - baseValue) != (int64_t)(value - baseValue))
4018 ASSERT(reloc->r_extern);
4019 value = (uint64_t) &makeSymbolExtra(oc, reloc->r_symbolnum, value)
4022 ASSERT((int32_t)(value - baseValue) == (int64_t)(value - baseValue));
4023 type = X86_64_RELOC_SIGNED;
4028 case X86_64_RELOC_UNSIGNED:
4029 ASSERT(!reloc->r_pcrel);
4032 case X86_64_RELOC_SIGNED:
4033 ASSERT(reloc->r_pcrel);
4034 thing += value - baseValue;
4036 case X86_64_RELOC_SUBTRACTOR:
4037 ASSERT(!reloc->r_pcrel);
4041 barf("unkown relocation");
4044 switch(reloc->r_length)
4047 *(uint8_t*)thingPtr = thing;
4050 *(uint16_t*)thingPtr = thing;
4053 *(uint32_t*)thingPtr = thing;
4056 *(uint64_t*)thingPtr = thing;
4060 if(relocs[i].r_address & R_SCATTERED)
4062 struct scattered_relocation_info *scat =
4063 (struct scattered_relocation_info*) &relocs[i];
4067 if(scat->r_length == 2)
4069 unsigned long word = 0;
4070 unsigned long* wordPtr = (unsigned long*) (image + sect->offset + scat->r_address);
4071 checkProddableBlock(oc,wordPtr);
4073 // Note on relocation types:
4074 // i386 uses the GENERIC_RELOC_* types,
4075 // while ppc uses special PPC_RELOC_* types.
4076 // *_RELOC_VANILLA and *_RELOC_PAIR have the same value
4077 // in both cases, all others are different.
4078 // Therefore, we use GENERIC_RELOC_VANILLA
4079 // and GENERIC_RELOC_PAIR instead of the PPC variants,
4080 // and use #ifdefs for the other types.
4082 // Step 1: Figure out what the relocated value should be
4083 if(scat->r_type == GENERIC_RELOC_VANILLA)
4085 word = *wordPtr + (unsigned long) relocateAddress(
4092 #ifdef powerpc_HOST_ARCH
4093 else if(scat->r_type == PPC_RELOC_SECTDIFF
4094 || scat->r_type == PPC_RELOC_LO16_SECTDIFF
4095 || scat->r_type == PPC_RELOC_HI16_SECTDIFF
4096 || scat->r_type == PPC_RELOC_HA16_SECTDIFF)
4098 else if(scat->r_type == GENERIC_RELOC_SECTDIFF)
4101 struct scattered_relocation_info *pair =
4102 (struct scattered_relocation_info*) &relocs[i+1];
4104 if(!pair->r_scattered || pair->r_type != GENERIC_RELOC_PAIR)
4105 barf("Invalid Mach-O file: "
4106 "RELOC_*_SECTDIFF not followed by RELOC_PAIR");
4108 word = (unsigned long)
4109 (relocateAddress(oc, nSections, sections, scat->r_value)
4110 - relocateAddress(oc, nSections, sections, pair->r_value));
4113 #ifdef powerpc_HOST_ARCH
4114 else if(scat->r_type == PPC_RELOC_HI16
4115 || scat->r_type == PPC_RELOC_LO16
4116 || scat->r_type == PPC_RELOC_HA16
4117 || scat->r_type == PPC_RELOC_LO14)
4118 { // these are generated by label+offset things
4119 struct relocation_info *pair = &relocs[i+1];
4120 if((pair->r_address & R_SCATTERED) || pair->r_type != PPC_RELOC_PAIR)
4121 barf("Invalid Mach-O file: "
4122 "PPC_RELOC_* not followed by PPC_RELOC_PAIR");
4124 if(scat->r_type == PPC_RELOC_LO16)
4126 word = ((unsigned short*) wordPtr)[1];
4127 word |= ((unsigned long) relocs[i+1].r_address & 0xFFFF) << 16;
4129 else if(scat->r_type == PPC_RELOC_LO14)
4131 barf("Unsupported Relocation: PPC_RELOC_LO14");
4132 word = ((unsigned short*) wordPtr)[1] & 0xFFFC;
4133 word |= ((unsigned long) relocs[i+1].r_address & 0xFFFF) << 16;
4135 else if(scat->r_type == PPC_RELOC_HI16)
4137 word = ((unsigned short*) wordPtr)[1] << 16;
4138 word |= ((unsigned long) relocs[i+1].r_address & 0xFFFF);
4140 else if(scat->r_type == PPC_RELOC_HA16)
4142 word = ((unsigned short*) wordPtr)[1] << 16;
4143 word += ((short)relocs[i+1].r_address & (short)0xFFFF);
4147 word += (unsigned long) relocateAddress(oc, nSections, sections, scat->r_value)
4154 continue; // ignore the others
4156 #ifdef powerpc_HOST_ARCH
4157 if(scat->r_type == GENERIC_RELOC_VANILLA
4158 || scat->r_type == PPC_RELOC_SECTDIFF)
4160 if(scat->r_type == GENERIC_RELOC_VANILLA
4161 || scat->r_type == GENERIC_RELOC_SECTDIFF)
4166 #ifdef powerpc_HOST_ARCH
4167 else if(scat->r_type == PPC_RELOC_LO16_SECTDIFF || scat->r_type == PPC_RELOC_LO16)
4169 ((unsigned short*) wordPtr)[1] = word & 0xFFFF;
4171 else if(scat->r_type == PPC_RELOC_HI16_SECTDIFF || scat->r_type == PPC_RELOC_HI16)
4173 ((unsigned short*) wordPtr)[1] = (word >> 16) & 0xFFFF;
4175 else if(scat->r_type == PPC_RELOC_HA16_SECTDIFF || scat->r_type == PPC_RELOC_HA16)
4177 ((unsigned short*) wordPtr)[1] = ((word >> 16) & 0xFFFF)
4178 + ((word & (1<<15)) ? 1 : 0);
4184 continue; // FIXME: I hope it's OK to ignore all the others.
4188 struct relocation_info *reloc = &relocs[i];
4189 if(reloc->r_pcrel && !reloc->r_extern)
4192 if(reloc->r_length == 2)
4194 unsigned long word = 0;
4195 #ifdef powerpc_HOST_ARCH
4196 unsigned long jumpIsland = 0;
4197 long offsetToJumpIsland = 0xBADBAD42; // initialise to bad value
4198 // to avoid warning and to catch
4202 unsigned long* wordPtr = (unsigned long*) (image + sect->offset + reloc->r_address);
4203 checkProddableBlock(oc,wordPtr);
4205 if(reloc->r_type == GENERIC_RELOC_VANILLA)
4209 #ifdef powerpc_HOST_ARCH
4210 else if(reloc->r_type == PPC_RELOC_LO16)
4212 word = ((unsigned short*) wordPtr)[1];
4213 word |= ((unsigned long) relocs[i+1].r_address & 0xFFFF) << 16;
4215 else if(reloc->r_type == PPC_RELOC_HI16)
4217 word = ((unsigned short*) wordPtr)[1] << 16;
4218 word |= ((unsigned long) relocs[i+1].r_address & 0xFFFF);
4220 else if(reloc->r_type == PPC_RELOC_HA16)
4222 word = ((unsigned short*) wordPtr)[1] << 16;
4223 word += ((short)relocs[i+1].r_address & (short)0xFFFF);
4225 else if(reloc->r_type == PPC_RELOC_BR24)
4228 word = (word & 0x03FFFFFC) | ((word & 0x02000000) ? 0xFC000000 : 0);
4232 if(!reloc->r_extern)
4235 sections[reloc->r_symbolnum-1].offset
4236 - sections[reloc->r_symbolnum-1].addr
4243 struct nlist *symbol = &nlist[reloc->r_symbolnum];
4244 char *nm = image + symLC->stroff + symbol->n_un.n_strx;
4245 void *symbolAddress = lookupSymbol(nm);
4248 errorBelch("\nunknown symbol `%s'", nm);
4254 #ifdef powerpc_HOST_ARCH
4255 // In the .o file, this should be a relative jump to NULL
4256 // and we'll change it to a relative jump to the symbol
4257 ASSERT(word + reloc->r_address == 0);
4258 jumpIsland = (unsigned long)
4259 &makeSymbolExtra(oc,
4261 (unsigned long) symbolAddress)
4265 offsetToJumpIsland = word + jumpIsland
4266 - (((long)image) + sect->offset - sect->addr);
4269 word += (unsigned long) symbolAddress
4270 - (((long)image) + sect->offset - sect->addr);
4274 word += (unsigned long) symbolAddress;
4278 if(reloc->r_type == GENERIC_RELOC_VANILLA)
4283 #ifdef powerpc_HOST_ARCH
4284 else if(reloc->r_type == PPC_RELOC_LO16)
4286 ((unsigned short*) wordPtr)[1] = word & 0xFFFF;
4289 else if(reloc->r_type == PPC_RELOC_HI16)
4291 ((unsigned short*) wordPtr)[1] = (word >> 16) & 0xFFFF;
4294 else if(reloc->r_type == PPC_RELOC_HA16)
4296 ((unsigned short*) wordPtr)[1] = ((word >> 16) & 0xFFFF)
4297 + ((word & (1<<15)) ? 1 : 0);
4300 else if(reloc->r_type == PPC_RELOC_BR24)
4302 if((long)word > (long)0x01FFFFFF || (long)word < (long)0xFFE00000)
4304 // The branch offset is too large.
4305 // Therefore, we try to use a jump island.
4308 barf("unconditional relative branch out of range: "
4309 "no jump island available");
4312 word = offsetToJumpIsland;
4313 if((long)word > (long)0x01FFFFFF || (long)word < (long)0xFFE00000)
4314 barf("unconditional relative branch out of range: "
4315 "jump island out of range");
4317 *wordPtr = (*wordPtr & 0xFC000003) | (word & 0x03FFFFFC);
4322 barf("\nunknown relocation %d",reloc->r_type);
4330 static int ocGetNames_MachO(ObjectCode* oc)
4332 char *image = (char*) oc->image;
4333 struct mach_header *header = (struct mach_header*) image;
4334 struct load_command *lc = (struct load_command*) (image + sizeof(struct mach_header));
4335 unsigned i,curSymbol = 0;
4336 struct segment_command *segLC = NULL;
4337 struct section *sections;
4338 struct symtab_command *symLC = NULL;
4339 struct nlist *nlist;
4340 unsigned long commonSize = 0;
4341 char *commonStorage = NULL;
4342 unsigned long commonCounter;
4344 for(i=0;i<header->ncmds;i++)
4346 if(lc->cmd == LC_SEGMENT || lc->cmd == LC_SEGMENT_64)
4347 segLC = (struct segment_command*) lc;
4348 else if(lc->cmd == LC_SYMTAB)
4349 symLC = (struct symtab_command*) lc;
4350 lc = (struct load_command *) ( ((char*)lc) + lc->cmdsize );
4353 sections = (struct section*) (segLC+1);
4354 nlist = symLC ? (struct nlist*) (image + symLC->symoff)
4358 barf("ocGetNames_MachO: no segment load command");
4360 for(i=0;i<segLC->nsects;i++)
4362 if(sections[i].size == 0)
4365 if((sections[i].flags & SECTION_TYPE) == S_ZEROFILL)
4367 char * zeroFillArea = stgCallocBytes(1,sections[i].size,
4368 "ocGetNames_MachO(common symbols)");
4369 sections[i].offset = zeroFillArea - image;
4372 if(!strcmp(sections[i].sectname,"__text"))
4373 addSection(oc, SECTIONKIND_CODE_OR_RODATA,
4374 (void*) (image + sections[i].offset),
4375 (void*) (image + sections[i].offset + sections[i].size));
4376 else if(!strcmp(sections[i].sectname,"__const"))
4377 addSection(oc, SECTIONKIND_RWDATA,
4378 (void*) (image + sections[i].offset),
4379 (void*) (image + sections[i].offset + sections[i].size));
4380 else if(!strcmp(sections[i].sectname,"__data"))
4381 addSection(oc, SECTIONKIND_RWDATA,
4382 (void*) (image + sections[i].offset),
4383 (void*) (image + sections[i].offset + sections[i].size));
4384 else if(!strcmp(sections[i].sectname,"__bss")
4385 || !strcmp(sections[i].sectname,"__common"))
4386 addSection(oc, SECTIONKIND_RWDATA,
4387 (void*) (image + sections[i].offset),
4388 (void*) (image + sections[i].offset + sections[i].size));
4390 addProddableBlock(oc, (void*) (image + sections[i].offset),
4394 // count external symbols defined here
4398 for(i=0;i<symLC->nsyms;i++)
4400 if(nlist[i].n_type & N_STAB)
4402 else if(nlist[i].n_type & N_EXT)
4404 if((nlist[i].n_type & N_TYPE) == N_UNDF
4405 && (nlist[i].n_value != 0))
4407 commonSize += nlist[i].n_value;
4410 else if((nlist[i].n_type & N_TYPE) == N_SECT)
4415 oc->symbols = stgMallocBytes(oc->n_symbols * sizeof(char*),
4416 "ocGetNames_MachO(oc->symbols)");
4420 for(i=0;i<symLC->nsyms;i++)
4422 if(nlist[i].n_type & N_STAB)
4424 else if((nlist[i].n_type & N_TYPE) == N_SECT)
4426 if(nlist[i].n_type & N_EXT)
4428 char *nm = image + symLC->stroff + nlist[i].n_un.n_strx;
4429 if((nlist[i].n_desc & N_WEAK_DEF) && lookupSymbol(nm))
4430 ; // weak definition, and we already have a definition
4433 ghciInsertStrHashTable(oc->fileName, symhash, nm,
4435 + sections[nlist[i].n_sect-1].offset
4436 - sections[nlist[i].n_sect-1].addr
4437 + nlist[i].n_value);
4438 oc->symbols[curSymbol++] = nm;
4445 commonStorage = stgCallocBytes(1,commonSize,"ocGetNames_MachO(common symbols)");
4446 commonCounter = (unsigned long)commonStorage;
4449 for(i=0;i<symLC->nsyms;i++)
4451 if((nlist[i].n_type & N_TYPE) == N_UNDF
4452 && (nlist[i].n_type & N_EXT) && (nlist[i].n_value != 0))
4454 char *nm = image + symLC->stroff + nlist[i].n_un.n_strx;
4455 unsigned long sz = nlist[i].n_value;
4457 nlist[i].n_value = commonCounter;
4459 ghciInsertStrHashTable(oc->fileName, symhash, nm,
4460 (void*)commonCounter);
4461 oc->symbols[curSymbol++] = nm;
4463 commonCounter += sz;
4470 static int ocResolve_MachO(ObjectCode* oc)
4472 char *image = (char*) oc->image;
4473 struct mach_header *header = (struct mach_header*) image;
4474 struct load_command *lc = (struct load_command*) (image + sizeof(struct mach_header));
4476 struct segment_command *segLC = NULL;
4477 struct section *sections;
4478 struct symtab_command *symLC = NULL;
4479 struct dysymtab_command *dsymLC = NULL;
4480 struct nlist *nlist;
4482 for(i=0;i<header->ncmds;i++)
4484 if(lc->cmd == LC_SEGMENT || lc->cmd == LC_SEGMENT_64)
4485 segLC = (struct segment_command*) lc;
4486 else if(lc->cmd == LC_SYMTAB)
4487 symLC = (struct symtab_command*) lc;
4488 else if(lc->cmd == LC_DYSYMTAB)
4489 dsymLC = (struct dysymtab_command*) lc;
4490 lc = (struct load_command *) ( ((char*)lc) + lc->cmdsize );
4493 sections = (struct section*) (segLC+1);
4494 nlist = symLC ? (struct nlist*) (image + symLC->symoff)
4499 unsigned long *indirectSyms
4500 = (unsigned long*) (image + dsymLC->indirectsymoff);
4502 for(i=0;i<segLC->nsects;i++)
4504 if( !strcmp(sections[i].sectname,"__la_symbol_ptr")
4505 || !strcmp(sections[i].sectname,"__la_sym_ptr2")
4506 || !strcmp(sections[i].sectname,"__la_sym_ptr3"))
4508 if(!resolveImports(oc,image,symLC,§ions[i],indirectSyms,nlist))
4511 else if(!strcmp(sections[i].sectname,"__nl_symbol_ptr")
4512 || !strcmp(sections[i].sectname,"__pointers"))
4514 if(!resolveImports(oc,image,symLC,§ions[i],indirectSyms,nlist))
4517 else if(!strcmp(sections[i].sectname,"__jump_table"))
4519 if(!resolveImports(oc,image,symLC,§ions[i],indirectSyms,nlist))
4525 for(i=0;i<segLC->nsects;i++)
4527 if(!relocateSection(oc,image,symLC,nlist,segLC->nsects,sections,§ions[i]))
4531 #if defined (powerpc_HOST_ARCH)
4532 ocFlushInstructionCache( oc );
4538 #ifdef powerpc_HOST_ARCH
4540 * The Mach-O object format uses leading underscores. But not everywhere.
4541 * There is a small number of runtime support functions defined in
4542 * libcc_dynamic.a whose name does not have a leading underscore.
4543 * As a consequence, we can't get their address from C code.
4544 * We have to use inline assembler just to take the address of a function.
4548 static void machoInitSymbolsWithoutUnderscore()
4550 extern void* symbolsWithoutUnderscore[];
4551 void **p = symbolsWithoutUnderscore;
4552 __asm__ volatile(".globl _symbolsWithoutUnderscore\n.data\n_symbolsWithoutUnderscore:");
4556 __asm__ volatile(".long " # x);
4558 RTS_MACHO_NOUNDERLINE_SYMBOLS
4560 __asm__ volatile(".text");
4564 ghciInsertStrHashTable("(GHCi built-in symbols)", symhash, #x, *p++);
4566 RTS_MACHO_NOUNDERLINE_SYMBOLS
4573 * Figure out by how much to shift the entire Mach-O file in memory
4574 * when loading so that its single segment ends up 16-byte-aligned
4576 static int machoGetMisalignment( FILE * f )
4578 struct mach_header header;
4581 fread(&header, sizeof(header), 1, f);
4584 #if x86_64_TARGET_ARCH || powerpc64_TARGET_ARCH
4585 if(header.magic != MH_MAGIC_64)
4588 if(header.magic != MH_MAGIC)
4592 misalignment = (header.sizeofcmds + sizeof(header))
4595 return misalignment ? (16 - misalignment) : 0;