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;
1095 barf("addDLL: not implemented on this platform");
1100 sysErrorBelch(dll_name);
1102 /* LoadLibrary failed; return a ptr to the error msg. */
1103 return "addDLL: could not load DLL";
1106 /* -----------------------------------------------------------------------------
1107 * insert a stable symbol in the hash table
1111 insertStableSymbol(char* obj_name, char* key, StgPtr p)
1113 ghciInsertStrHashTable(obj_name, stablehash, key, getStablePtr(p));
1117 /* -----------------------------------------------------------------------------
1118 * insert a symbol in the hash table
1121 insertSymbol(char* obj_name, char* key, void* data)
1123 ghciInsertStrHashTable(obj_name, symhash, key, data);
1126 /* -----------------------------------------------------------------------------
1127 * lookup a symbol in the hash table
1130 lookupSymbol( char *lbl )
1134 ASSERT(symhash != NULL);
1135 val = lookupStrHashTable(symhash, lbl);
1138 # if defined(OBJFORMAT_ELF)
1139 return dlsym(dl_prog_handle, lbl);
1140 # elif defined(OBJFORMAT_MACHO)
1142 /* On OS X 10.3 and later, we use dlsym instead of the old legacy
1145 HACK: On OS X, global symbols are prefixed with an underscore.
1146 However, dlsym wants us to omit the leading underscore from the
1147 symbol name. For now, we simply strip it off here (and ONLY
1150 ASSERT(lbl[0] == '_');
1151 return dlsym(dl_prog_handle, lbl+1);
1153 if(NSIsSymbolNameDefined(lbl)) {
1154 NSSymbol symbol = NSLookupAndBindSymbol(lbl);
1155 return NSAddressOfSymbol(symbol);
1159 # endif /* HAVE_DLFCN_H */
1160 # elif defined(OBJFORMAT_PEi386)
1163 for (o_dll = opened_dlls; o_dll != NULL; o_dll = o_dll->next) {
1164 /* debugBelch("look in %s for %s\n", o_dll->name, lbl); */
1165 if (lbl[0] == '_') {
1166 /* HACK: if the name has an initial underscore, try stripping
1167 it off & look that up first. I've yet to verify whether there's
1168 a Rule that governs whether an initial '_' *should always* be
1169 stripped off when mapping from import lib name to the DLL name.
1171 sym = GetProcAddress(o_dll->instance, (lbl+1));
1173 /*debugBelch("found %s in %s\n", lbl+1,o_dll->name);*/
1177 sym = GetProcAddress(o_dll->instance, lbl);
1179 /*debugBelch("found %s in %s\n", lbl,o_dll->name);*/
1193 /* -----------------------------------------------------------------------------
1194 * Debugging aid: look in GHCi's object symbol tables for symbols
1195 * within DELTA bytes of the specified address, and show their names.
1198 void ghci_enquire ( char* addr );
1200 void ghci_enquire ( char* addr )
1205 const int DELTA = 64;
1210 for (oc = objects; oc; oc = oc->next) {
1211 for (i = 0; i < oc->n_symbols; i++) {
1212 sym = oc->symbols[i];
1213 if (sym == NULL) continue;
1216 a = lookupStrHashTable(symhash, sym);
1219 // debugBelch("ghci_enquire: can't find %s\n", sym);
1221 else if (addr-DELTA <= a && a <= addr+DELTA) {
1222 debugBelch("%p + %3d == `%s'\n", addr, (int)(a - addr), sym);
1229 #ifdef ia64_HOST_ARCH
1230 static unsigned int PLTSize(void);
1233 /* -----------------------------------------------------------------------------
1234 * Load an obj (populate the global symbol table, but don't resolve yet)
1236 * Returns: 1 if ok, 0 on error.
1239 loadObj( char *path )
1246 void *map_addr = NULL;
1252 /* debugBelch("loadObj %s\n", path ); */
1254 /* Check that we haven't already loaded this object.
1255 Ignore requests to load multiple times */
1259 for (o = objects; o; o = o->next) {
1260 if (0 == strcmp(o->fileName, path)) {
1262 break; /* don't need to search further */
1266 IF_DEBUG(linker, debugBelch(
1267 "GHCi runtime linker: warning: looks like you're trying to load the\n"
1268 "same object file twice:\n"
1270 "GHCi will ignore this, but be warned.\n"
1272 return 1; /* success */
1276 oc = stgMallocBytes(sizeof(ObjectCode), "loadObj(oc)");
1278 # if defined(OBJFORMAT_ELF)
1279 oc->formatName = "ELF";
1280 # elif defined(OBJFORMAT_PEi386)
1281 oc->formatName = "PEi386";
1282 # elif defined(OBJFORMAT_MACHO)
1283 oc->formatName = "Mach-O";
1286 barf("loadObj: not implemented on this platform");
1289 r = stat(path, &st);
1290 if (r == -1) { return 0; }
1292 /* sigh, strdup() isn't a POSIX function, so do it the long way */
1293 oc->fileName = stgMallocBytes( strlen(path)+1, "loadObj" );
1294 strcpy(oc->fileName, path);
1296 oc->fileSize = st.st_size;
1298 oc->sections = NULL;
1299 oc->proddables = NULL;
1301 /* chain it onto the list of objects */
1306 #define ROUND_UP(x,size) ((x + size - 1) & ~(size - 1))
1308 /* On many architectures malloc'd memory isn't executable, so we need to use mmap. */
1310 #if defined(openbsd_HOST_OS)
1311 fd = open(path, O_RDONLY, S_IRUSR);
1313 fd = open(path, O_RDONLY);
1316 barf("loadObj: can't open `%s'", path);
1318 pagesize = getpagesize();
1320 #ifdef ia64_HOST_ARCH
1321 /* The PLT needs to be right before the object */
1322 n = ROUND_UP(PLTSize(), pagesize);
1323 oc->plt = mmap(NULL, n, PROT_EXEC|PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0);
1324 if (oc->plt == MAP_FAILED)
1325 barf("loadObj: can't allocate PLT");
1328 map_addr = oc->plt + n;
1331 n = ROUND_UP(oc->fileSize, pagesize);
1333 /* Link objects into the lower 2Gb on x86_64. GHC assumes the
1334 * small memory model on this architecture (see gcc docs,
1337 * MAP_32BIT not available on OpenBSD/amd64
1339 #if defined(x86_64_HOST_ARCH) && defined(MAP_32BIT)
1340 #define EXTRA_MAP_FLAGS MAP_32BIT
1342 #define EXTRA_MAP_FLAGS 0
1345 /* MAP_ANONYMOUS is MAP_ANON on some systems, e.g. OpenBSD */
1346 #if !defined(MAP_ANONYMOUS) && defined(MAP_ANON)
1347 #define MAP_ANONYMOUS MAP_ANON
1350 oc->image = mmap(map_addr, n, PROT_EXEC|PROT_READ|PROT_WRITE,
1351 MAP_PRIVATE|EXTRA_MAP_FLAGS, fd, 0);
1352 if (oc->image == MAP_FAILED)
1353 barf("loadObj: can't map `%s'", path);
1357 #else /* !USE_MMAP */
1359 /* load the image into memory */
1360 f = fopen(path, "rb");
1362 barf("loadObj: can't read `%s'", path);
1364 # if defined(mingw32_HOST_OS)
1365 // TODO: We would like to use allocateExec here, but allocateExec
1366 // cannot currently allocate blocks large enough.
1367 oc->image = VirtualAlloc(NULL, oc->fileSize, MEM_RESERVE | MEM_COMMIT,
1368 PAGE_EXECUTE_READWRITE);
1369 # elif defined(darwin_HOST_OS)
1370 // In a Mach-O .o file, all sections can and will be misaligned
1371 // if the total size of the headers is not a multiple of the
1372 // desired alignment. This is fine for .o files that only serve
1373 // as input for the static linker, but it's not fine for us,
1374 // as SSE (used by gcc for floating point) and Altivec require
1375 // 16-byte alignment.
1376 // We calculate the correct alignment from the header before
1377 // reading the file, and then we misalign oc->image on purpose so
1378 // that the actual sections end up aligned again.
1379 oc->misalignment = machoGetMisalignment(f);
1380 oc->image = stgMallocBytes(oc->fileSize + oc->misalignment, "loadObj(image)");
1381 oc->image += oc->misalignment;
1383 oc->image = stgMallocBytes(oc->fileSize, "loadObj(image)");
1386 n = fread ( oc->image, 1, oc->fileSize, f );
1387 if (n != oc->fileSize)
1388 barf("loadObj: error whilst reading `%s'", path);
1391 #endif /* USE_MMAP */
1393 # if defined(OBJFORMAT_MACHO) && (defined(powerpc_HOST_ARCH) || defined(x86_64_HOST_ARCH))
1394 r = ocAllocateSymbolExtras_MachO ( oc );
1395 if (!r) { return r; }
1396 # elif defined(OBJFORMAT_ELF) && (defined(powerpc_HOST_ARCH) || defined(x86_64_HOST_ARCH))
1397 r = ocAllocateSymbolExtras_ELF ( oc );
1398 if (!r) { return r; }
1401 /* verify the in-memory image */
1402 # if defined(OBJFORMAT_ELF)
1403 r = ocVerifyImage_ELF ( oc );
1404 # elif defined(OBJFORMAT_PEi386)
1405 r = ocVerifyImage_PEi386 ( oc );
1406 # elif defined(OBJFORMAT_MACHO)
1407 r = ocVerifyImage_MachO ( oc );
1409 barf("loadObj: no verify method");
1411 if (!r) { return r; }
1413 /* build the symbol list for this image */
1414 # if defined(OBJFORMAT_ELF)
1415 r = ocGetNames_ELF ( oc );
1416 # elif defined(OBJFORMAT_PEi386)
1417 r = ocGetNames_PEi386 ( oc );
1418 # elif defined(OBJFORMAT_MACHO)
1419 r = ocGetNames_MachO ( oc );
1421 barf("loadObj: no getNames method");
1423 if (!r) { return r; }
1425 /* loaded, but not resolved yet */
1426 oc->status = OBJECT_LOADED;
1431 /* -----------------------------------------------------------------------------
1432 * resolve all the currently unlinked objects in memory
1434 * Returns: 1 if ok, 0 on error.
1444 for (oc = objects; oc; oc = oc->next) {
1445 if (oc->status != OBJECT_RESOLVED) {
1446 # if defined(OBJFORMAT_ELF)
1447 r = ocResolve_ELF ( oc );
1448 # elif defined(OBJFORMAT_PEi386)
1449 r = ocResolve_PEi386 ( oc );
1450 # elif defined(OBJFORMAT_MACHO)
1451 r = ocResolve_MachO ( oc );
1453 barf("resolveObjs: not implemented on this platform");
1455 if (!r) { return r; }
1456 oc->status = OBJECT_RESOLVED;
1462 /* -----------------------------------------------------------------------------
1463 * delete an object from the pool
1466 unloadObj( char *path )
1468 ObjectCode *oc, *prev;
1470 ASSERT(symhash != NULL);
1471 ASSERT(objects != NULL);
1476 for (oc = objects; oc; prev = oc, oc = oc->next) {
1477 if (!strcmp(oc->fileName,path)) {
1479 /* Remove all the mappings for the symbols within this
1484 for (i = 0; i < oc->n_symbols; i++) {
1485 if (oc->symbols[i] != NULL) {
1486 removeStrHashTable(symhash, oc->symbols[i], NULL);
1494 prev->next = oc->next;
1497 // We're going to leave this in place, in case there are
1498 // any pointers from the heap into it:
1499 // #ifdef mingw32_HOST_OS
1500 // VirtualFree(oc->image);
1502 // stgFree(oc->image);
1504 stgFree(oc->fileName);
1505 stgFree(oc->symbols);
1506 stgFree(oc->sections);
1512 errorBelch("unloadObj: can't find `%s' to unload", path);
1516 /* -----------------------------------------------------------------------------
1517 * Sanity checking. For each ObjectCode, maintain a list of address ranges
1518 * which may be prodded during relocation, and abort if we try and write
1519 * outside any of these.
1521 static void addProddableBlock ( ObjectCode* oc, void* start, int size )
1524 = stgMallocBytes(sizeof(ProddableBlock), "addProddableBlock");
1525 /* debugBelch("aPB %p %p %d\n", oc, start, size); */
1529 pb->next = oc->proddables;
1530 oc->proddables = pb;
1533 static void checkProddableBlock ( ObjectCode* oc, void* addr )
1536 for (pb = oc->proddables; pb != NULL; pb = pb->next) {
1537 char* s = (char*)(pb->start);
1538 char* e = s + pb->size - 1;
1539 char* a = (char*)addr;
1540 /* Assumes that the biggest fixup involves a 4-byte write. This
1541 probably needs to be changed to 8 (ie, +7) on 64-bit
1543 if (a >= s && (a+3) <= e) return;
1545 barf("checkProddableBlock: invalid fixup in runtime linker");
1548 /* -----------------------------------------------------------------------------
1549 * Section management.
1551 static void addSection ( ObjectCode* oc, SectionKind kind,
1552 void* start, void* end )
1554 Section* s = stgMallocBytes(sizeof(Section), "addSection");
1558 s->next = oc->sections;
1561 debugBelch("addSection: %p-%p (size %d), kind %d\n",
1562 start, ((char*)end)-1, end - start + 1, kind );
1567 /* --------------------------------------------------------------------------
1569 * This is about allocating a small chunk of memory for every symbol in the
1570 * object file. We make sure that the SymboLExtras are always "in range" of
1571 * limited-range PC-relative instructions on various platforms by allocating
1572 * them right next to the object code itself.
1575 #if defined(powerpc_HOST_ARCH) || defined(x86_64_HOST_ARCH)
1578 ocAllocateSymbolExtras
1580 Allocate additional space at the end of the object file image to make room
1581 for jump islands (powerpc, x86_64) and GOT entries (x86_64).
1583 PowerPC relative branch instructions have a 24 bit displacement field.
1584 As PPC code is always 4-byte-aligned, this yields a +-32MB range.
1585 If a particular imported symbol is outside this range, we have to redirect
1586 the jump to a short piece of new code that just loads the 32bit absolute
1587 address and jumps there.
1588 On x86_64, PC-relative jumps and PC-relative accesses to the GOT are limited
1591 This function just allocates space for one SymbolExtra for every
1592 undefined symbol in the object file. The code for the jump islands is
1593 filled in by makeSymbolExtra below.
1596 static int ocAllocateSymbolExtras( ObjectCode* oc, int count, int first )
1603 int misalignment = 0;
1604 #ifdef darwin_HOST_OS
1605 misalignment = oc->misalignment;
1611 // round up to the nearest 4
1612 aligned = (oc->fileSize + 3) & ~3;
1615 #ifndef linux_HOST_OS /* mremap is a linux extension */
1616 #error ocAllocateSymbolExtras doesnt want USE_MMAP to be defined
1619 pagesize = getpagesize();
1620 n = ROUND_UP( oc->fileSize, pagesize );
1621 m = ROUND_UP( aligned + sizeof (SymbolExtra) * count, pagesize );
1623 /* If we have a half-page-size file and map one page of it then
1624 * the part of the page after the size of the file remains accessible.
1625 * If, however, we map in 2 pages, the 2nd page is not accessible
1626 * and will give a "Bus Error" on access. To get around this, we check
1627 * if we need any extra pages for the jump islands and map them in
1628 * anonymously. We must check that we actually require extra pages
1629 * otherwise the attempt to mmap 0 pages of anonymous memory will
1635 /* The effect of this mremap() call is only the ensure that we have
1636 * a sufficient number of virtually contiguous pages. As returned from
1637 * mremap, the pages past the end of the file are not backed. We give
1638 * them a backing by using MAP_FIXED to map in anonymous pages.
1640 oc->image = mremap( oc->image, n, m, MREMAP_MAYMOVE );
1642 if( oc->image == MAP_FAILED )
1644 errorBelch( "Unable to mremap for Jump Islands\n" );
1648 if( mmap( oc->image + n, m - n, PROT_READ | PROT_WRITE | PROT_EXEC,
1649 MAP_PRIVATE | MAP_ANONYMOUS | MAP_FIXED, 0, 0 ) == MAP_FAILED )
1651 errorBelch( "Unable to mmap( MAP_FIXED ) for Jump Islands\n" );
1657 oc->image -= misalignment;
1658 oc->image = stgReallocBytes( oc->image,
1660 aligned + sizeof (SymbolExtra) * count,
1661 "ocAllocateSymbolExtras" );
1662 oc->image += misalignment;
1663 #endif /* USE_MMAP */
1665 oc->symbol_extras = (SymbolExtra *) (oc->image + aligned);
1666 memset( oc->symbol_extras, 0, sizeof (SymbolExtra) * count );
1669 oc->symbol_extras = NULL;
1671 oc->first_symbol_extra = first;
1672 oc->n_symbol_extras = count;
1677 static SymbolExtra* makeSymbolExtra( ObjectCode* oc,
1678 unsigned long symbolNumber,
1679 unsigned long target )
1683 ASSERT( symbolNumber >= oc->first_symbol_extra
1684 && symbolNumber - oc->first_symbol_extra < oc->n_symbol_extras);
1686 extra = &oc->symbol_extras[symbolNumber - oc->first_symbol_extra];
1688 #ifdef powerpc_HOST_ARCH
1689 // lis r12, hi16(target)
1690 extra->jumpIsland.lis_r12 = 0x3d80;
1691 extra->jumpIsland.hi_addr = target >> 16;
1693 // ori r12, r12, lo16(target)
1694 extra->jumpIsland.ori_r12_r12 = 0x618c;
1695 extra->jumpIsland.lo_addr = target & 0xffff;
1698 extra->jumpIsland.mtctr_r12 = 0x7d8903a6;
1701 extra->jumpIsland.bctr = 0x4e800420;
1703 #ifdef x86_64_HOST_ARCH
1705 static uint8_t jmp[] = { 0xFF, 0x25, 0xF2, 0xFF, 0xFF, 0xFF };
1706 extra->addr = target;
1707 memcpy(extra->jumpIsland, jmp, 6);
1715 /* --------------------------------------------------------------------------
1716 * PowerPC specifics (instruction cache flushing)
1717 * ------------------------------------------------------------------------*/
1719 #ifdef powerpc_TARGET_ARCH
1721 ocFlushInstructionCache
1723 Flush the data & instruction caches.
1724 Because the PPC has split data/instruction caches, we have to
1725 do that whenever we modify code at runtime.
1728 static void ocFlushInstructionCache( ObjectCode *oc )
1730 int n = (oc->fileSize + sizeof( SymbolExtra ) * oc->n_symbol_extras + 3) / 4;
1731 unsigned long *p = (unsigned long *) oc->image;
1735 __asm__ volatile ( "dcbf 0,%0\n\t"
1743 __asm__ volatile ( "sync\n\t"
1749 /* --------------------------------------------------------------------------
1750 * PEi386 specifics (Win32 targets)
1751 * ------------------------------------------------------------------------*/
1753 /* The information for this linker comes from
1754 Microsoft Portable Executable
1755 and Common Object File Format Specification
1756 revision 5.1 January 1998
1757 which SimonM says comes from the MS Developer Network CDs.
1759 It can be found there (on older CDs), but can also be found
1762 http://www.microsoft.com/hwdev/hardware/PECOFF.asp
1764 (this is Rev 6.0 from February 1999).
1766 Things move, so if that fails, try searching for it via
1768 http://www.google.com/search?q=PE+COFF+specification
1770 The ultimate reference for the PE format is the Winnt.h
1771 header file that comes with the Platform SDKs; as always,
1772 implementations will drift wrt their documentation.
1774 A good background article on the PE format is Matt Pietrek's
1775 March 1994 article in Microsoft System Journal (MSJ)
1776 (Vol.9, No. 3): "Peering Inside the PE: A Tour of the
1777 Win32 Portable Executable File Format." The info in there
1778 has recently been updated in a two part article in
1779 MSDN magazine, issues Feb and March 2002,
1780 "Inside Windows: An In-Depth Look into the Win32 Portable
1781 Executable File Format"
1783 John Levine's book "Linkers and Loaders" contains useful
1788 #if defined(OBJFORMAT_PEi386)
1792 typedef unsigned char UChar;
1793 typedef unsigned short UInt16;
1794 typedef unsigned int UInt32;
1801 UInt16 NumberOfSections;
1802 UInt32 TimeDateStamp;
1803 UInt32 PointerToSymbolTable;
1804 UInt32 NumberOfSymbols;
1805 UInt16 SizeOfOptionalHeader;
1806 UInt16 Characteristics;
1810 #define sizeof_COFF_header 20
1817 UInt32 VirtualAddress;
1818 UInt32 SizeOfRawData;
1819 UInt32 PointerToRawData;
1820 UInt32 PointerToRelocations;
1821 UInt32 PointerToLinenumbers;
1822 UInt16 NumberOfRelocations;
1823 UInt16 NumberOfLineNumbers;
1824 UInt32 Characteristics;
1828 #define sizeof_COFF_section 40
1835 UInt16 SectionNumber;
1838 UChar NumberOfAuxSymbols;
1842 #define sizeof_COFF_symbol 18
1847 UInt32 VirtualAddress;
1848 UInt32 SymbolTableIndex;
1853 #define sizeof_COFF_reloc 10
1856 /* From PE spec doc, section 3.3.2 */
1857 /* Note use of MYIMAGE_* since IMAGE_* are already defined in
1858 windows.h -- for the same purpose, but I want to know what I'm
1860 #define MYIMAGE_FILE_RELOCS_STRIPPED 0x0001
1861 #define MYIMAGE_FILE_EXECUTABLE_IMAGE 0x0002
1862 #define MYIMAGE_FILE_DLL 0x2000
1863 #define MYIMAGE_FILE_SYSTEM 0x1000
1864 #define MYIMAGE_FILE_BYTES_REVERSED_HI 0x8000
1865 #define MYIMAGE_FILE_BYTES_REVERSED_LO 0x0080
1866 #define MYIMAGE_FILE_32BIT_MACHINE 0x0100
1868 /* From PE spec doc, section 5.4.2 and 5.4.4 */
1869 #define MYIMAGE_SYM_CLASS_EXTERNAL 2
1870 #define MYIMAGE_SYM_CLASS_STATIC 3
1871 #define MYIMAGE_SYM_UNDEFINED 0
1873 /* From PE spec doc, section 4.1 */
1874 #define MYIMAGE_SCN_CNT_CODE 0x00000020
1875 #define MYIMAGE_SCN_CNT_INITIALIZED_DATA 0x00000040
1876 #define MYIMAGE_SCN_LNK_NRELOC_OVFL 0x01000000
1878 /* From PE spec doc, section 5.2.1 */
1879 #define MYIMAGE_REL_I386_DIR32 0x0006
1880 #define MYIMAGE_REL_I386_REL32 0x0014
1883 /* We use myindex to calculate array addresses, rather than
1884 simply doing the normal subscript thing. That's because
1885 some of the above structs have sizes which are not
1886 a whole number of words. GCC rounds their sizes up to a
1887 whole number of words, which means that the address calcs
1888 arising from using normal C indexing or pointer arithmetic
1889 are just plain wrong. Sigh.
1892 myindex ( int scale, void* base, int index )
1895 ((UChar*)base) + scale * index;
1900 printName ( UChar* name, UChar* strtab )
1902 if (name[0]==0 && name[1]==0 && name[2]==0 && name[3]==0) {
1903 UInt32 strtab_offset = * (UInt32*)(name+4);
1904 debugBelch("%s", strtab + strtab_offset );
1907 for (i = 0; i < 8; i++) {
1908 if (name[i] == 0) break;
1909 debugBelch("%c", name[i] );
1916 copyName ( UChar* name, UChar* strtab, UChar* dst, int dstSize )
1918 if (name[0]==0 && name[1]==0 && name[2]==0 && name[3]==0) {
1919 UInt32 strtab_offset = * (UInt32*)(name+4);
1920 strncpy ( dst, strtab+strtab_offset, dstSize );
1926 if (name[i] == 0) break;
1936 cstring_from_COFF_symbol_name ( UChar* name, UChar* strtab )
1939 /* If the string is longer than 8 bytes, look in the
1940 string table for it -- this will be correctly zero terminated.
1942 if (name[0]==0 && name[1]==0 && name[2]==0 && name[3]==0) {
1943 UInt32 strtab_offset = * (UInt32*)(name+4);
1944 return ((UChar*)strtab) + strtab_offset;
1946 /* Otherwise, if shorter than 8 bytes, return the original,
1947 which by defn is correctly terminated.
1949 if (name[7]==0) return name;
1950 /* The annoying case: 8 bytes. Copy into a temporary
1951 (which is never freed ...)
1953 newstr = stgMallocBytes(9, "cstring_from_COFF_symbol_name");
1955 strncpy(newstr,name,8);
1961 /* Just compares the short names (first 8 chars) */
1962 static COFF_section *
1963 findPEi386SectionCalled ( ObjectCode* oc, char* name )
1967 = (COFF_header*)(oc->image);
1968 COFF_section* sectab
1970 ((UChar*)(oc->image))
1971 + sizeof_COFF_header + hdr->SizeOfOptionalHeader
1973 for (i = 0; i < hdr->NumberOfSections; i++) {
1976 COFF_section* section_i
1978 myindex ( sizeof_COFF_section, sectab, i );
1979 n1 = (UChar*) &(section_i->Name);
1981 if (n1[0]==n2[0] && n1[1]==n2[1] && n1[2]==n2[2] &&
1982 n1[3]==n2[3] && n1[4]==n2[4] && n1[5]==n2[5] &&
1983 n1[6]==n2[6] && n1[7]==n2[7])
1992 zapTrailingAtSign ( UChar* sym )
1994 # define my_isdigit(c) ((c) >= '0' && (c) <= '9')
1996 if (sym[0] == 0) return;
1998 while (sym[i] != 0) i++;
2001 while (j > 0 && my_isdigit(sym[j])) j--;
2002 if (j > 0 && sym[j] == '@' && j != i) sym[j] = 0;
2008 ocVerifyImage_PEi386 ( ObjectCode* oc )
2013 COFF_section* sectab;
2014 COFF_symbol* symtab;
2016 /* debugBelch("\nLOADING %s\n", oc->fileName); */
2017 hdr = (COFF_header*)(oc->image);
2018 sectab = (COFF_section*) (
2019 ((UChar*)(oc->image))
2020 + sizeof_COFF_header + hdr->SizeOfOptionalHeader
2022 symtab = (COFF_symbol*) (
2023 ((UChar*)(oc->image))
2024 + hdr->PointerToSymbolTable
2026 strtab = ((UChar*)symtab)
2027 + hdr->NumberOfSymbols * sizeof_COFF_symbol;
2029 if (hdr->Machine != 0x14c) {
2030 errorBelch("%s: Not x86 PEi386", oc->fileName);
2033 if (hdr->SizeOfOptionalHeader != 0) {
2034 errorBelch("%s: PEi386 with nonempty optional header", oc->fileName);
2037 if ( /* (hdr->Characteristics & MYIMAGE_FILE_RELOCS_STRIPPED) || */
2038 (hdr->Characteristics & MYIMAGE_FILE_EXECUTABLE_IMAGE) ||
2039 (hdr->Characteristics & MYIMAGE_FILE_DLL) ||
2040 (hdr->Characteristics & MYIMAGE_FILE_SYSTEM) ) {
2041 errorBelch("%s: Not a PEi386 object file", oc->fileName);
2044 if ( (hdr->Characteristics & MYIMAGE_FILE_BYTES_REVERSED_HI)
2045 /* || !(hdr->Characteristics & MYIMAGE_FILE_32BIT_MACHINE) */ ) {
2046 errorBelch("%s: Invalid PEi386 word size or endiannness: %d",
2048 (int)(hdr->Characteristics));
2051 /* If the string table size is way crazy, this might indicate that
2052 there are more than 64k relocations, despite claims to the
2053 contrary. Hence this test. */
2054 /* debugBelch("strtab size %d\n", * (UInt32*)strtab); */
2056 if ( (*(UInt32*)strtab) > 600000 ) {
2057 /* Note that 600k has no special significance other than being
2058 big enough to handle the almost-2MB-sized lumps that
2059 constitute HSwin32*.o. */
2060 debugBelch("PEi386 object has suspiciously large string table; > 64k relocs?");
2065 /* No further verification after this point; only debug printing. */
2067 IF_DEBUG(linker, i=1);
2068 if (i == 0) return 1;
2070 debugBelch( "sectab offset = %d\n", ((UChar*)sectab) - ((UChar*)hdr) );
2071 debugBelch( "symtab offset = %d\n", ((UChar*)symtab) - ((UChar*)hdr) );
2072 debugBelch( "strtab offset = %d\n", ((UChar*)strtab) - ((UChar*)hdr) );
2075 debugBelch( "Machine: 0x%x\n", (UInt32)(hdr->Machine) );
2076 debugBelch( "# sections: %d\n", (UInt32)(hdr->NumberOfSections) );
2077 debugBelch( "time/date: 0x%x\n", (UInt32)(hdr->TimeDateStamp) );
2078 debugBelch( "symtab offset: %d\n", (UInt32)(hdr->PointerToSymbolTable) );
2079 debugBelch( "# symbols: %d\n", (UInt32)(hdr->NumberOfSymbols) );
2080 debugBelch( "sz of opt hdr: %d\n", (UInt32)(hdr->SizeOfOptionalHeader) );
2081 debugBelch( "characteristics: 0x%x\n", (UInt32)(hdr->Characteristics) );
2083 /* Print the section table. */
2085 for (i = 0; i < hdr->NumberOfSections; i++) {
2087 COFF_section* sectab_i
2089 myindex ( sizeof_COFF_section, sectab, i );
2096 printName ( sectab_i->Name, strtab );
2106 sectab_i->VirtualSize,
2107 sectab_i->VirtualAddress,
2108 sectab_i->SizeOfRawData,
2109 sectab_i->PointerToRawData,
2110 sectab_i->NumberOfRelocations,
2111 sectab_i->PointerToRelocations,
2112 sectab_i->PointerToRawData
2114 reltab = (COFF_reloc*) (
2115 ((UChar*)(oc->image)) + sectab_i->PointerToRelocations
2118 if ( sectab_i->Characteristics & MYIMAGE_SCN_LNK_NRELOC_OVFL ) {
2119 /* If the relocation field (a short) has overflowed, the
2120 * real count can be found in the first reloc entry.
2122 * See Section 4.1 (last para) of the PE spec (rev6.0).
2124 COFF_reloc* rel = (COFF_reloc*)
2125 myindex ( sizeof_COFF_reloc, reltab, 0 );
2126 noRelocs = rel->VirtualAddress;
2129 noRelocs = sectab_i->NumberOfRelocations;
2133 for (; j < noRelocs; j++) {
2135 COFF_reloc* rel = (COFF_reloc*)
2136 myindex ( sizeof_COFF_reloc, reltab, j );
2138 " type 0x%-4x vaddr 0x%-8x name `",
2140 rel->VirtualAddress );
2141 sym = (COFF_symbol*)
2142 myindex ( sizeof_COFF_symbol, symtab, rel->SymbolTableIndex );
2143 /* Hmm..mysterious looking offset - what's it for? SOF */
2144 printName ( sym->Name, strtab -10 );
2151 debugBelch("string table has size 0x%x\n", * (UInt32*)strtab );
2152 debugBelch("---START of string table---\n");
2153 for (i = 4; i < *(Int32*)strtab; i++) {
2155 debugBelch("\n"); else
2156 debugBelch("%c", strtab[i] );
2158 debugBelch("--- END of string table---\n");
2163 COFF_symbol* symtab_i;
2164 if (i >= (Int32)(hdr->NumberOfSymbols)) break;
2165 symtab_i = (COFF_symbol*)
2166 myindex ( sizeof_COFF_symbol, symtab, i );
2172 printName ( symtab_i->Name, strtab );
2181 (Int32)(symtab_i->SectionNumber),
2182 (UInt32)symtab_i->Type,
2183 (UInt32)symtab_i->StorageClass,
2184 (UInt32)symtab_i->NumberOfAuxSymbols
2186 i += symtab_i->NumberOfAuxSymbols;
2196 ocGetNames_PEi386 ( ObjectCode* oc )
2199 COFF_section* sectab;
2200 COFF_symbol* symtab;
2207 hdr = (COFF_header*)(oc->image);
2208 sectab = (COFF_section*) (
2209 ((UChar*)(oc->image))
2210 + sizeof_COFF_header + hdr->SizeOfOptionalHeader
2212 symtab = (COFF_symbol*) (
2213 ((UChar*)(oc->image))
2214 + hdr->PointerToSymbolTable
2216 strtab = ((UChar*)(oc->image))
2217 + hdr->PointerToSymbolTable
2218 + hdr->NumberOfSymbols * sizeof_COFF_symbol;
2220 /* Allocate space for any (local, anonymous) .bss sections. */
2222 for (i = 0; i < hdr->NumberOfSections; i++) {
2225 COFF_section* sectab_i
2227 myindex ( sizeof_COFF_section, sectab, i );
2228 if (0 != strcmp(sectab_i->Name, ".bss")) continue;
2229 /* sof 10/05: the PE spec text isn't too clear regarding what
2230 * the SizeOfRawData field is supposed to hold for object
2231 * file sections containing just uninitialized data -- for executables,
2232 * it is supposed to be zero; unclear what it's supposed to be
2233 * for object files. However, VirtualSize is guaranteed to be
2234 * zero for object files, which definitely suggests that SizeOfRawData
2235 * will be non-zero (where else would the size of this .bss section be
2236 * stored?) Looking at the COFF_section info for incoming object files,
2237 * this certainly appears to be the case.
2239 * => I suspect we've been incorrectly handling .bss sections in (relocatable)
2240 * object files up until now. This turned out to bite us with ghc-6.4.1's use
2241 * of gcc-3.4.x, which has started to emit initially-zeroed-out local 'static'
2242 * variable decls into to the .bss section. (The specific function in Q which
2243 * triggered this is libraries/base/cbits/dirUtils.c:__hscore_getFolderPath())
2245 if (sectab_i->VirtualSize == 0 && sectab_i->SizeOfRawData == 0) continue;
2246 /* This is a non-empty .bss section. Allocate zeroed space for
2247 it, and set its PointerToRawData field such that oc->image +
2248 PointerToRawData == addr_of_zeroed_space. */
2249 bss_sz = sectab_i->VirtualSize;
2250 if ( bss_sz < sectab_i->SizeOfRawData) { bss_sz = sectab_i->SizeOfRawData; }
2251 zspace = stgCallocBytes(1, bss_sz, "ocGetNames_PEi386(anonymous bss)");
2252 sectab_i->PointerToRawData = ((UChar*)zspace) - ((UChar*)(oc->image));
2253 addProddableBlock(oc, zspace, bss_sz);
2254 /* debugBelch("BSS anon section at 0x%x\n", zspace); */
2257 /* Copy section information into the ObjectCode. */
2259 for (i = 0; i < hdr->NumberOfSections; i++) {
2265 = SECTIONKIND_OTHER;
2266 COFF_section* sectab_i
2268 myindex ( sizeof_COFF_section, sectab, i );
2269 IF_DEBUG(linker, debugBelch("section name = %s\n", sectab_i->Name ));
2272 /* I'm sure this is the Right Way to do it. However, the
2273 alternative of testing the sectab_i->Name field seems to
2274 work ok with Cygwin.
2276 if (sectab_i->Characteristics & MYIMAGE_SCN_CNT_CODE ||
2277 sectab_i->Characteristics & MYIMAGE_SCN_CNT_INITIALIZED_DATA)
2278 kind = SECTIONKIND_CODE_OR_RODATA;
2281 if (0==strcmp(".text",sectab_i->Name) ||
2282 0==strcmp(".rdata",sectab_i->Name)||
2283 0==strcmp(".rodata",sectab_i->Name))
2284 kind = SECTIONKIND_CODE_OR_RODATA;
2285 if (0==strcmp(".data",sectab_i->Name) ||
2286 0==strcmp(".bss",sectab_i->Name))
2287 kind = SECTIONKIND_RWDATA;
2289 ASSERT(sectab_i->SizeOfRawData == 0 || sectab_i->VirtualSize == 0);
2290 sz = sectab_i->SizeOfRawData;
2291 if (sz < sectab_i->VirtualSize) sz = sectab_i->VirtualSize;
2293 start = ((UChar*)(oc->image)) + sectab_i->PointerToRawData;
2294 end = start + sz - 1;
2296 if (kind == SECTIONKIND_OTHER
2297 /* Ignore sections called which contain stabs debugging
2299 && 0 != strcmp(".stab", sectab_i->Name)
2300 && 0 != strcmp(".stabstr", sectab_i->Name)
2301 /* ignore constructor section for now */
2302 && 0 != strcmp(".ctors", sectab_i->Name)
2303 /* ignore section generated from .ident */
2304 && 0!= strcmp("/4", sectab_i->Name)
2305 /* ignore unknown section that appeared in gcc 3.4.5(?) */
2306 && 0!= strcmp(".reloc", sectab_i->Name)
2308 errorBelch("Unknown PEi386 section name `%s' (while processing: %s)", sectab_i->Name, oc->fileName);
2312 if (kind != SECTIONKIND_OTHER && end >= start) {
2313 addSection(oc, kind, start, end);
2314 addProddableBlock(oc, start, end - start + 1);
2318 /* Copy exported symbols into the ObjectCode. */
2320 oc->n_symbols = hdr->NumberOfSymbols;
2321 oc->symbols = stgMallocBytes(oc->n_symbols * sizeof(char*),
2322 "ocGetNames_PEi386(oc->symbols)");
2323 /* Call me paranoid; I don't care. */
2324 for (i = 0; i < oc->n_symbols; i++)
2325 oc->symbols[i] = NULL;
2329 COFF_symbol* symtab_i;
2330 if (i >= (Int32)(hdr->NumberOfSymbols)) break;
2331 symtab_i = (COFF_symbol*)
2332 myindex ( sizeof_COFF_symbol, symtab, i );
2336 if (symtab_i->StorageClass == MYIMAGE_SYM_CLASS_EXTERNAL
2337 && symtab_i->SectionNumber != MYIMAGE_SYM_UNDEFINED) {
2338 /* This symbol is global and defined, viz, exported */
2339 /* for MYIMAGE_SYMCLASS_EXTERNAL
2340 && !MYIMAGE_SYM_UNDEFINED,
2341 the address of the symbol is:
2342 address of relevant section + offset in section
2344 COFF_section* sectabent
2345 = (COFF_section*) myindex ( sizeof_COFF_section,
2347 symtab_i->SectionNumber-1 );
2348 addr = ((UChar*)(oc->image))
2349 + (sectabent->PointerToRawData
2353 if (symtab_i->SectionNumber == MYIMAGE_SYM_UNDEFINED
2354 && symtab_i->Value > 0) {
2355 /* This symbol isn't in any section at all, ie, global bss.
2356 Allocate zeroed space for it. */
2357 addr = stgCallocBytes(1, symtab_i->Value,
2358 "ocGetNames_PEi386(non-anonymous bss)");
2359 addSection(oc, SECTIONKIND_RWDATA, addr,
2360 ((UChar*)addr) + symtab_i->Value - 1);
2361 addProddableBlock(oc, addr, symtab_i->Value);
2362 /* debugBelch("BSS section at 0x%x\n", addr); */
2365 if (addr != NULL ) {
2366 sname = cstring_from_COFF_symbol_name ( symtab_i->Name, strtab );
2367 /* debugBelch("addSymbol %p `%s \n", addr,sname); */
2368 IF_DEBUG(linker, debugBelch("addSymbol %p `%s'\n", addr,sname);)
2369 ASSERT(i >= 0 && i < oc->n_symbols);
2370 /* cstring_from_COFF_symbol_name always succeeds. */
2371 oc->symbols[i] = sname;
2372 ghciInsertStrHashTable(oc->fileName, symhash, sname, addr);
2376 "IGNORING symbol %d\n"
2380 printName ( symtab_i->Name, strtab );
2389 (Int32)(symtab_i->SectionNumber),
2390 (UInt32)symtab_i->Type,
2391 (UInt32)symtab_i->StorageClass,
2392 (UInt32)symtab_i->NumberOfAuxSymbols
2397 i += symtab_i->NumberOfAuxSymbols;
2406 ocResolve_PEi386 ( ObjectCode* oc )
2409 COFF_section* sectab;
2410 COFF_symbol* symtab;
2420 /* ToDo: should be variable-sized? But is at least safe in the
2421 sense of buffer-overrun-proof. */
2423 /* debugBelch("resolving for %s\n", oc->fileName); */
2425 hdr = (COFF_header*)(oc->image);
2426 sectab = (COFF_section*) (
2427 ((UChar*)(oc->image))
2428 + sizeof_COFF_header + hdr->SizeOfOptionalHeader
2430 symtab = (COFF_symbol*) (
2431 ((UChar*)(oc->image))
2432 + hdr->PointerToSymbolTable
2434 strtab = ((UChar*)(oc->image))
2435 + hdr->PointerToSymbolTable
2436 + hdr->NumberOfSymbols * sizeof_COFF_symbol;
2438 for (i = 0; i < hdr->NumberOfSections; i++) {
2439 COFF_section* sectab_i
2441 myindex ( sizeof_COFF_section, sectab, i );
2444 ((UChar*)(oc->image)) + sectab_i->PointerToRelocations
2447 /* Ignore sections called which contain stabs debugging
2449 if (0 == strcmp(".stab", sectab_i->Name)
2450 || 0 == strcmp(".stabstr", sectab_i->Name)
2451 || 0 == strcmp(".ctors", sectab_i->Name))
2454 if ( sectab_i->Characteristics & MYIMAGE_SCN_LNK_NRELOC_OVFL ) {
2455 /* If the relocation field (a short) has overflowed, the
2456 * real count can be found in the first reloc entry.
2458 * See Section 4.1 (last para) of the PE spec (rev6.0).
2460 * Nov2003 update: the GNU linker still doesn't correctly
2461 * handle the generation of relocatable object files with
2462 * overflown relocations. Hence the output to warn of potential
2465 COFF_reloc* rel = (COFF_reloc*)
2466 myindex ( sizeof_COFF_reloc, reltab, 0 );
2467 noRelocs = rel->VirtualAddress;
2469 /* 10/05: we now assume (and check for) a GNU ld that is capable
2470 * of handling object files with (>2^16) of relocs.
2473 debugBelch("WARNING: Overflown relocation field (# relocs found: %u)\n",
2478 noRelocs = sectab_i->NumberOfRelocations;
2483 for (; j < noRelocs; j++) {
2485 COFF_reloc* reltab_j
2487 myindex ( sizeof_COFF_reloc, reltab, j );
2489 /* the location to patch */
2491 ((UChar*)(oc->image))
2492 + (sectab_i->PointerToRawData
2493 + reltab_j->VirtualAddress
2494 - sectab_i->VirtualAddress )
2496 /* the existing contents of pP */
2498 /* the symbol to connect to */
2499 sym = (COFF_symbol*)
2500 myindex ( sizeof_COFF_symbol,
2501 symtab, reltab_j->SymbolTableIndex );
2504 "reloc sec %2d num %3d: type 0x%-4x "
2505 "vaddr 0x%-8x name `",
2507 (UInt32)reltab_j->Type,
2508 reltab_j->VirtualAddress );
2509 printName ( sym->Name, strtab );
2510 debugBelch("'\n" ));
2512 if (sym->StorageClass == MYIMAGE_SYM_CLASS_STATIC) {
2513 COFF_section* section_sym
2514 = findPEi386SectionCalled ( oc, sym->Name );
2516 errorBelch("%s: can't find section `%s'", oc->fileName, sym->Name);
2519 S = ((UInt32)(oc->image))
2520 + (section_sym->PointerToRawData
2523 copyName ( sym->Name, strtab, symbol, 1000-1 );
2524 S = (UInt32) lookupSymbol( symbol );
2525 if ((void*)S != NULL) goto foundit;
2526 zapTrailingAtSign ( symbol );
2527 S = (UInt32) lookupSymbol( symbol );
2528 if ((void*)S != NULL) goto foundit;
2529 /* Newline first because the interactive linker has printed "linking..." */
2530 errorBelch("\n%s: unknown symbol `%s'", oc->fileName, symbol);
2534 checkProddableBlock(oc, pP);
2535 switch (reltab_j->Type) {
2536 case MYIMAGE_REL_I386_DIR32:
2539 case MYIMAGE_REL_I386_REL32:
2540 /* Tricky. We have to insert a displacement at
2541 pP which, when added to the PC for the _next_
2542 insn, gives the address of the target (S).
2543 Problem is to know the address of the next insn
2544 when we only know pP. We assume that this
2545 literal field is always the last in the insn,
2546 so that the address of the next insn is pP+4
2547 -- hence the constant 4.
2548 Also I don't know if A should be added, but so
2549 far it has always been zero.
2551 SOF 05/2005: 'A' (old contents of *pP) have been observed
2552 to contain values other than zero (the 'wx' object file
2553 that came with wxhaskell-0.9.4; dunno how it was compiled..).
2554 So, add displacement to old value instead of asserting
2555 A to be zero. Fixes wxhaskell-related crashes, and no other
2556 ill effects have been observed.
2558 Update: the reason why we're seeing these more elaborate
2559 relocations is due to a switch in how the NCG compiles SRTs
2560 and offsets to them from info tables. SRTs live in .(ro)data,
2561 while info tables live in .text, causing GAS to emit REL32/DISP32
2562 relocations with non-zero values. Adding the displacement is
2563 the right thing to do.
2565 *pP = S - ((UInt32)pP) - 4 + A;
2568 debugBelch("%s: unhandled PEi386 relocation type %d",
2569 oc->fileName, reltab_j->Type);
2576 IF_DEBUG(linker, debugBelch("completed %s", oc->fileName));
2580 #endif /* defined(OBJFORMAT_PEi386) */
2583 /* --------------------------------------------------------------------------
2585 * ------------------------------------------------------------------------*/
2587 #if defined(OBJFORMAT_ELF)
2592 #if defined(sparc_HOST_ARCH)
2593 # define ELF_TARGET_SPARC /* Used inside <elf.h> */
2594 #elif defined(i386_HOST_ARCH)
2595 # define ELF_TARGET_386 /* Used inside <elf.h> */
2596 #elif defined(x86_64_HOST_ARCH)
2597 # define ELF_TARGET_X64_64
2599 #elif defined (ia64_HOST_ARCH)
2600 # define ELF_TARGET_IA64 /* Used inside <elf.h> */
2602 # define ELF_FUNCTION_DESC /* calling convention uses function descriptors */
2603 # define ELF_NEED_GOT /* needs Global Offset Table */
2604 # define ELF_NEED_PLT /* needs Procedure Linkage Tables */
2607 #if !defined(openbsd_HOST_OS)
2610 /* openbsd elf has things in different places, with diff names */
2611 # include <elf_abi.h>
2612 # include <machine/reloc.h>
2613 # define R_386_32 RELOC_32
2614 # define R_386_PC32 RELOC_PC32
2617 /* If elf.h doesn't define it */
2618 # ifndef R_X86_64_PC64
2619 # define R_X86_64_PC64 24
2623 * Define a set of types which can be used for both ELF32 and ELF64
2627 #define ELFCLASS ELFCLASS64
2628 #define Elf_Addr Elf64_Addr
2629 #define Elf_Word Elf64_Word
2630 #define Elf_Sword Elf64_Sword
2631 #define Elf_Ehdr Elf64_Ehdr
2632 #define Elf_Phdr Elf64_Phdr
2633 #define Elf_Shdr Elf64_Shdr
2634 #define Elf_Sym Elf64_Sym
2635 #define Elf_Rel Elf64_Rel
2636 #define Elf_Rela Elf64_Rela
2637 #define ELF_ST_TYPE ELF64_ST_TYPE
2638 #define ELF_ST_BIND ELF64_ST_BIND
2639 #define ELF_R_TYPE ELF64_R_TYPE
2640 #define ELF_R_SYM ELF64_R_SYM
2642 #define ELFCLASS ELFCLASS32
2643 #define Elf_Addr Elf32_Addr
2644 #define Elf_Word Elf32_Word
2645 #define Elf_Sword Elf32_Sword
2646 #define Elf_Ehdr Elf32_Ehdr
2647 #define Elf_Phdr Elf32_Phdr
2648 #define Elf_Shdr Elf32_Shdr
2649 #define Elf_Sym Elf32_Sym
2650 #define Elf_Rel Elf32_Rel
2651 #define Elf_Rela Elf32_Rela
2653 #define ELF_ST_TYPE ELF32_ST_TYPE
2656 #define ELF_ST_BIND ELF32_ST_BIND
2659 #define ELF_R_TYPE ELF32_R_TYPE
2662 #define ELF_R_SYM ELF32_R_SYM
2668 * Functions to allocate entries in dynamic sections. Currently we simply
2669 * preallocate a large number, and we don't check if a entry for the given
2670 * target already exists (a linear search is too slow). Ideally these
2671 * entries would be associated with symbols.
2674 /* These sizes sufficient to load HSbase + HShaskell98 + a few modules */
2675 #define GOT_SIZE 0x20000
2676 #define FUNCTION_TABLE_SIZE 0x10000
2677 #define PLT_SIZE 0x08000
2680 static Elf_Addr got[GOT_SIZE];
2681 static unsigned int gotIndex;
2682 static Elf_Addr gp_val = (Elf_Addr)got;
2685 allocateGOTEntry(Elf_Addr target)
2689 if (gotIndex >= GOT_SIZE)
2690 barf("Global offset table overflow");
2692 entry = &got[gotIndex++];
2694 return (Elf_Addr)entry;
2698 #ifdef ELF_FUNCTION_DESC
2704 static FunctionDesc functionTable[FUNCTION_TABLE_SIZE];
2705 static unsigned int functionTableIndex;
2708 allocateFunctionDesc(Elf_Addr target)
2710 FunctionDesc *entry;
2712 if (functionTableIndex >= FUNCTION_TABLE_SIZE)
2713 barf("Function table overflow");
2715 entry = &functionTable[functionTableIndex++];
2717 entry->gp = (Elf_Addr)gp_val;
2718 return (Elf_Addr)entry;
2722 copyFunctionDesc(Elf_Addr target)
2724 FunctionDesc *olddesc = (FunctionDesc *)target;
2725 FunctionDesc *newdesc;
2727 newdesc = (FunctionDesc *)allocateFunctionDesc(olddesc->ip);
2728 newdesc->gp = olddesc->gp;
2729 return (Elf_Addr)newdesc;
2734 #ifdef ia64_HOST_ARCH
2735 static void ia64_reloc_gprel22(Elf_Addr target, Elf_Addr value);
2736 static void ia64_reloc_pcrel21(Elf_Addr target, Elf_Addr value, ObjectCode *oc);
2738 static unsigned char plt_code[] =
2740 /* taken from binutils bfd/elfxx-ia64.c */
2741 0x0b, 0x78, 0x00, 0x02, 0x00, 0x24, /* [MMI] addl r15=0,r1;; */
2742 0x00, 0x41, 0x3c, 0x30, 0x28, 0xc0, /* ld8 r16=[r15],8 */
2743 0x01, 0x08, 0x00, 0x84, /* mov r14=r1;; */
2744 0x11, 0x08, 0x00, 0x1e, 0x18, 0x10, /* [MIB] ld8 r1=[r15] */
2745 0x60, 0x80, 0x04, 0x80, 0x03, 0x00, /* mov b6=r16 */
2746 0x60, 0x00, 0x80, 0x00 /* br.few b6;; */
2749 /* If we can't get to the function descriptor via gp, take a local copy of it */
2750 #define PLT_RELOC(code, target) { \
2751 Elf64_Sxword rel_value = target - gp_val; \
2752 if ((rel_value > 0x1fffff) || (rel_value < -0x1fffff)) \
2753 ia64_reloc_gprel22((Elf_Addr)code, copyFunctionDesc(target)); \
2755 ia64_reloc_gprel22((Elf_Addr)code, target); \
2760 unsigned char code[sizeof(plt_code)];
2764 allocatePLTEntry(Elf_Addr target, ObjectCode *oc)
2766 PLTEntry *plt = (PLTEntry *)oc->plt;
2769 if (oc->pltIndex >= PLT_SIZE)
2770 barf("Procedure table overflow");
2772 entry = &plt[oc->pltIndex++];
2773 memcpy(entry->code, plt_code, sizeof(entry->code));
2774 PLT_RELOC(entry->code, target);
2775 return (Elf_Addr)entry;
2781 return (PLT_SIZE * sizeof(PLTEntry));
2787 * Generic ELF functions
2791 findElfSection ( void* objImage, Elf_Word sh_type )
2793 char* ehdrC = (char*)objImage;
2794 Elf_Ehdr* ehdr = (Elf_Ehdr*)ehdrC;
2795 Elf_Shdr* shdr = (Elf_Shdr*)(ehdrC + ehdr->e_shoff);
2796 char* sh_strtab = ehdrC + shdr[ehdr->e_shstrndx].sh_offset;
2800 for (i = 0; i < ehdr->e_shnum; i++) {
2801 if (shdr[i].sh_type == sh_type
2802 /* Ignore the section header's string table. */
2803 && i != ehdr->e_shstrndx
2804 /* Ignore string tables named .stabstr, as they contain
2806 && 0 != memcmp(".stabstr", sh_strtab + shdr[i].sh_name, 8)
2808 ptr = ehdrC + shdr[i].sh_offset;
2815 #if defined(ia64_HOST_ARCH)
2817 findElfSegment ( void* objImage, Elf_Addr vaddr )
2819 char* ehdrC = (char*)objImage;
2820 Elf_Ehdr* ehdr = (Elf_Ehdr*)ehdrC;
2821 Elf_Phdr* phdr = (Elf_Phdr*)(ehdrC + ehdr->e_phoff);
2822 Elf_Addr segaddr = 0;
2825 for (i = 0; i < ehdr->e_phnum; i++) {
2826 segaddr = phdr[i].p_vaddr;
2827 if ((vaddr >= segaddr) && (vaddr < segaddr + phdr[i].p_memsz))
2835 ocVerifyImage_ELF ( ObjectCode* oc )
2839 int i, j, nent, nstrtab, nsymtabs;
2843 char* ehdrC = (char*)(oc->image);
2844 Elf_Ehdr* ehdr = (Elf_Ehdr*)ehdrC;
2846 if (ehdr->e_ident[EI_MAG0] != ELFMAG0 ||
2847 ehdr->e_ident[EI_MAG1] != ELFMAG1 ||
2848 ehdr->e_ident[EI_MAG2] != ELFMAG2 ||
2849 ehdr->e_ident[EI_MAG3] != ELFMAG3) {
2850 errorBelch("%s: not an ELF object", oc->fileName);
2854 if (ehdr->e_ident[EI_CLASS] != ELFCLASS) {
2855 errorBelch("%s: unsupported ELF format", oc->fileName);
2859 if (ehdr->e_ident[EI_DATA] == ELFDATA2LSB) {
2860 IF_DEBUG(linker,debugBelch( "Is little-endian\n" ));
2862 if (ehdr->e_ident[EI_DATA] == ELFDATA2MSB) {
2863 IF_DEBUG(linker,debugBelch( "Is big-endian\n" ));
2865 errorBelch("%s: unknown endiannness", oc->fileName);
2869 if (ehdr->e_type != ET_REL) {
2870 errorBelch("%s: not a relocatable object (.o) file", oc->fileName);
2873 IF_DEBUG(linker, debugBelch( "Is a relocatable object (.o) file\n" ));
2875 IF_DEBUG(linker,debugBelch( "Architecture is " ));
2876 switch (ehdr->e_machine) {
2877 case EM_386: IF_DEBUG(linker,debugBelch( "x86" )); break;
2878 #ifdef EM_SPARC32PLUS
2879 case EM_SPARC32PLUS:
2881 case EM_SPARC: IF_DEBUG(linker,debugBelch( "sparc" )); break;
2883 case EM_IA_64: IF_DEBUG(linker,debugBelch( "ia64" )); break;
2885 case EM_PPC: IF_DEBUG(linker,debugBelch( "powerpc32" )); break;
2887 case EM_X86_64: IF_DEBUG(linker,debugBelch( "x86_64" )); break;
2888 #elif defined(EM_AMD64)
2889 case EM_AMD64: IF_DEBUG(linker,debugBelch( "amd64" )); break;
2891 default: IF_DEBUG(linker,debugBelch( "unknown" ));
2892 errorBelch("%s: unknown architecture (e_machine == %d)"
2893 , oc->fileName, ehdr->e_machine);
2897 IF_DEBUG(linker,debugBelch(
2898 "\nSection header table: start %ld, n_entries %d, ent_size %d\n",
2899 (long)ehdr->e_shoff, ehdr->e_shnum, ehdr->e_shentsize ));
2901 ASSERT (ehdr->e_shentsize == sizeof(Elf_Shdr));
2903 shdr = (Elf_Shdr*) (ehdrC + ehdr->e_shoff);
2905 if (ehdr->e_shstrndx == SHN_UNDEF) {
2906 errorBelch("%s: no section header string table", oc->fileName);
2909 IF_DEBUG(linker,debugBelch( "Section header string table is section %d\n",
2911 sh_strtab = ehdrC + shdr[ehdr->e_shstrndx].sh_offset;
2914 for (i = 0; i < ehdr->e_shnum; i++) {
2915 IF_DEBUG(linker,debugBelch("%2d: ", i ));
2916 IF_DEBUG(linker,debugBelch("type=%2d ", (int)shdr[i].sh_type ));
2917 IF_DEBUG(linker,debugBelch("size=%4d ", (int)shdr[i].sh_size ));
2918 IF_DEBUG(linker,debugBelch("offs=%4d ", (int)shdr[i].sh_offset ));
2919 IF_DEBUG(linker,debugBelch(" (%p .. %p) ",
2920 ehdrC + shdr[i].sh_offset,
2921 ehdrC + shdr[i].sh_offset + shdr[i].sh_size - 1));
2923 if (shdr[i].sh_type == SHT_REL) {
2924 IF_DEBUG(linker,debugBelch("Rel " ));
2925 } else if (shdr[i].sh_type == SHT_RELA) {
2926 IF_DEBUG(linker,debugBelch("RelA " ));
2928 IF_DEBUG(linker,debugBelch(" "));
2931 IF_DEBUG(linker,debugBelch("sname=%s\n", sh_strtab + shdr[i].sh_name ));
2935 IF_DEBUG(linker,debugBelch( "\nString tables" ));
2938 for (i = 0; i < ehdr->e_shnum; i++) {
2939 if (shdr[i].sh_type == SHT_STRTAB
2940 /* Ignore the section header's string table. */
2941 && i != ehdr->e_shstrndx
2942 /* Ignore string tables named .stabstr, as they contain
2944 && 0 != memcmp(".stabstr", sh_strtab + shdr[i].sh_name, 8)
2946 IF_DEBUG(linker,debugBelch(" section %d is a normal string table", i ));
2947 strtab = ehdrC + shdr[i].sh_offset;
2952 errorBelch("%s: no string tables, or too many", oc->fileName);
2957 IF_DEBUG(linker,debugBelch( "\nSymbol tables" ));
2958 for (i = 0; i < ehdr->e_shnum; i++) {
2959 if (shdr[i].sh_type != SHT_SYMTAB) continue;
2960 IF_DEBUG(linker,debugBelch( "section %d is a symbol table\n", i ));
2962 stab = (Elf_Sym*) (ehdrC + shdr[i].sh_offset);
2963 nent = shdr[i].sh_size / sizeof(Elf_Sym);
2964 IF_DEBUG(linker,debugBelch( " number of entries is apparently %d (%ld rem)\n",
2966 (long)shdr[i].sh_size % sizeof(Elf_Sym)
2968 if (0 != shdr[i].sh_size % sizeof(Elf_Sym)) {
2969 errorBelch("%s: non-integral number of symbol table entries", oc->fileName);
2972 for (j = 0; j < nent; j++) {
2973 IF_DEBUG(linker,debugBelch(" %2d ", j ));
2974 IF_DEBUG(linker,debugBelch(" sec=%-5d size=%-3d val=%5p ",
2975 (int)stab[j].st_shndx,
2976 (int)stab[j].st_size,
2977 (char*)stab[j].st_value ));
2979 IF_DEBUG(linker,debugBelch("type=" ));
2980 switch (ELF_ST_TYPE(stab[j].st_info)) {
2981 case STT_NOTYPE: IF_DEBUG(linker,debugBelch("notype " )); break;
2982 case STT_OBJECT: IF_DEBUG(linker,debugBelch("object " )); break;
2983 case STT_FUNC : IF_DEBUG(linker,debugBelch("func " )); break;
2984 case STT_SECTION: IF_DEBUG(linker,debugBelch("section" )); break;
2985 case STT_FILE: IF_DEBUG(linker,debugBelch("file " )); break;
2986 default: IF_DEBUG(linker,debugBelch("? " )); break;
2988 IF_DEBUG(linker,debugBelch(" " ));
2990 IF_DEBUG(linker,debugBelch("bind=" ));
2991 switch (ELF_ST_BIND(stab[j].st_info)) {
2992 case STB_LOCAL : IF_DEBUG(linker,debugBelch("local " )); break;
2993 case STB_GLOBAL: IF_DEBUG(linker,debugBelch("global" )); break;
2994 case STB_WEAK : IF_DEBUG(linker,debugBelch("weak " )); break;
2995 default: IF_DEBUG(linker,debugBelch("? " )); break;
2997 IF_DEBUG(linker,debugBelch(" " ));
2999 IF_DEBUG(linker,debugBelch("name=%s\n", strtab + stab[j].st_name ));
3003 if (nsymtabs == 0) {
3004 errorBelch("%s: didn't find any symbol tables", oc->fileName);
3011 static int getSectionKind_ELF( Elf_Shdr *hdr, int *is_bss )
3015 if (hdr->sh_type == SHT_PROGBITS
3016 && (hdr->sh_flags & SHF_ALLOC) && (hdr->sh_flags & SHF_EXECINSTR)) {
3017 /* .text-style section */
3018 return SECTIONKIND_CODE_OR_RODATA;
3021 if (hdr->sh_type == SHT_PROGBITS
3022 && (hdr->sh_flags & SHF_ALLOC) && (hdr->sh_flags & SHF_WRITE)) {
3023 /* .data-style section */
3024 return SECTIONKIND_RWDATA;
3027 if (hdr->sh_type == SHT_PROGBITS
3028 && (hdr->sh_flags & SHF_ALLOC) && !(hdr->sh_flags & SHF_WRITE)) {
3029 /* .rodata-style section */
3030 return SECTIONKIND_CODE_OR_RODATA;
3033 if (hdr->sh_type == SHT_NOBITS
3034 && (hdr->sh_flags & SHF_ALLOC) && (hdr->sh_flags & SHF_WRITE)) {
3035 /* .bss-style section */
3037 return SECTIONKIND_RWDATA;
3040 return SECTIONKIND_OTHER;
3045 ocGetNames_ELF ( ObjectCode* oc )
3050 char* ehdrC = (char*)(oc->image);
3051 Elf_Ehdr* ehdr = (Elf_Ehdr*)ehdrC;
3052 char* strtab = findElfSection ( ehdrC, SHT_STRTAB );
3053 Elf_Shdr* shdr = (Elf_Shdr*) (ehdrC + ehdr->e_shoff);
3055 ASSERT(symhash != NULL);
3058 errorBelch("%s: no strtab", oc->fileName);
3063 for (i = 0; i < ehdr->e_shnum; i++) {
3064 /* Figure out what kind of section it is. Logic derived from
3065 Figure 1.14 ("Special Sections") of the ELF document
3066 ("Portable Formats Specification, Version 1.1"). */
3068 SectionKind kind = getSectionKind_ELF(&shdr[i], &is_bss);
3070 if (is_bss && shdr[i].sh_size > 0) {
3071 /* This is a non-empty .bss section. Allocate zeroed space for
3072 it, and set its .sh_offset field such that
3073 ehdrC + .sh_offset == addr_of_zeroed_space. */
3074 char* zspace = stgCallocBytes(1, shdr[i].sh_size,
3075 "ocGetNames_ELF(BSS)");
3076 shdr[i].sh_offset = ((char*)zspace) - ((char*)ehdrC);
3078 debugBelch("BSS section at 0x%x, size %d\n",
3079 zspace, shdr[i].sh_size);
3083 /* fill in the section info */
3084 if (kind != SECTIONKIND_OTHER && shdr[i].sh_size > 0) {
3085 addProddableBlock(oc, ehdrC + shdr[i].sh_offset, shdr[i].sh_size);
3086 addSection(oc, kind, ehdrC + shdr[i].sh_offset,
3087 ehdrC + shdr[i].sh_offset + shdr[i].sh_size - 1);
3090 if (shdr[i].sh_type != SHT_SYMTAB) continue;
3092 /* copy stuff into this module's object symbol table */
3093 stab = (Elf_Sym*) (ehdrC + shdr[i].sh_offset);
3094 nent = shdr[i].sh_size / sizeof(Elf_Sym);
3096 oc->n_symbols = nent;
3097 oc->symbols = stgMallocBytes(oc->n_symbols * sizeof(char*),
3098 "ocGetNames_ELF(oc->symbols)");
3100 for (j = 0; j < nent; j++) {
3102 char isLocal = FALSE; /* avoids uninit-var warning */
3104 char* nm = strtab + stab[j].st_name;
3105 int secno = stab[j].st_shndx;
3107 /* Figure out if we want to add it; if so, set ad to its
3108 address. Otherwise leave ad == NULL. */
3110 if (secno == SHN_COMMON) {
3112 ad = stgCallocBytes(1, stab[j].st_size, "ocGetNames_ELF(COMMON)");
3114 debugBelch("COMMON symbol, size %d name %s\n",
3115 stab[j].st_size, nm);
3117 /* Pointless to do addProddableBlock() for this area,
3118 since the linker should never poke around in it. */
3121 if ( ( ELF_ST_BIND(stab[j].st_info)==STB_GLOBAL
3122 || ELF_ST_BIND(stab[j].st_info)==STB_LOCAL
3124 /* and not an undefined symbol */
3125 && stab[j].st_shndx != SHN_UNDEF
3126 /* and not in a "special section" */
3127 && stab[j].st_shndx < SHN_LORESERVE
3129 /* and it's a not a section or string table or anything silly */
3130 ( ELF_ST_TYPE(stab[j].st_info)==STT_FUNC ||
3131 ELF_ST_TYPE(stab[j].st_info)==STT_OBJECT ||
3132 ELF_ST_TYPE(stab[j].st_info)==STT_NOTYPE
3135 /* Section 0 is the undefined section, hence > and not >=. */
3136 ASSERT(secno > 0 && secno < ehdr->e_shnum);
3138 if (shdr[secno].sh_type == SHT_NOBITS) {
3139 debugBelch(" BSS symbol, size %d off %d name %s\n",
3140 stab[j].st_size, stab[j].st_value, nm);
3143 ad = ehdrC + shdr[ secno ].sh_offset + stab[j].st_value;
3144 if (ELF_ST_BIND(stab[j].st_info)==STB_LOCAL) {
3147 #ifdef ELF_FUNCTION_DESC
3148 /* dlsym() and the initialisation table both give us function
3149 * descriptors, so to be consistent we store function descriptors
3150 * in the symbol table */
3151 if (ELF_ST_TYPE(stab[j].st_info) == STT_FUNC)
3152 ad = (char *)allocateFunctionDesc((Elf_Addr)ad);
3154 IF_DEBUG(linker,debugBelch( "addOTabName(GLOB): %10p %s %s\n",
3155 ad, oc->fileName, nm ));
3160 /* And the decision is ... */
3164 oc->symbols[j] = nm;
3167 /* Ignore entirely. */
3169 ghciInsertStrHashTable(oc->fileName, symhash, nm, ad);
3173 IF_DEBUG(linker,debugBelch( "skipping `%s'\n",
3174 strtab + stab[j].st_name ));
3177 "skipping bind = %d, type = %d, shndx = %d `%s'\n",
3178 (int)ELF_ST_BIND(stab[j].st_info),
3179 (int)ELF_ST_TYPE(stab[j].st_info),
3180 (int)stab[j].st_shndx,
3181 strtab + stab[j].st_name
3184 oc->symbols[j] = NULL;
3193 /* Do ELF relocations which lack an explicit addend. All x86-linux
3194 relocations appear to be of this form. */
3196 do_Elf_Rel_relocations ( ObjectCode* oc, char* ehdrC,
3197 Elf_Shdr* shdr, int shnum,
3198 Elf_Sym* stab, char* strtab )
3203 Elf_Rel* rtab = (Elf_Rel*) (ehdrC + shdr[shnum].sh_offset);
3204 int nent = shdr[shnum].sh_size / sizeof(Elf_Rel);
3205 int target_shndx = shdr[shnum].sh_info;
3206 int symtab_shndx = shdr[shnum].sh_link;
3208 stab = (Elf_Sym*) (ehdrC + shdr[ symtab_shndx ].sh_offset);
3209 targ = (Elf_Word*)(ehdrC + shdr[ target_shndx ].sh_offset);
3210 IF_DEBUG(linker,debugBelch( "relocations for section %d using symtab %d\n",
3211 target_shndx, symtab_shndx ));
3213 /* Skip sections that we're not interested in. */
3216 SectionKind kind = getSectionKind_ELF(&shdr[target_shndx], &is_bss);
3217 if (kind == SECTIONKIND_OTHER) {
3218 IF_DEBUG(linker,debugBelch( "skipping (target section not loaded)"));
3223 for (j = 0; j < nent; j++) {
3224 Elf_Addr offset = rtab[j].r_offset;
3225 Elf_Addr info = rtab[j].r_info;
3227 Elf_Addr P = ((Elf_Addr)targ) + offset;
3228 Elf_Word* pP = (Elf_Word*)P;
3233 StgStablePtr stablePtr;
3236 IF_DEBUG(linker,debugBelch( "Rel entry %3d is raw(%6p %6p)",
3237 j, (void*)offset, (void*)info ));
3239 IF_DEBUG(linker,debugBelch( " ZERO" ));
3242 Elf_Sym sym = stab[ELF_R_SYM(info)];
3243 /* First see if it is a local symbol. */
3244 if (ELF_ST_BIND(sym.st_info) == STB_LOCAL) {
3245 /* Yes, so we can get the address directly from the ELF symbol
3247 symbol = sym.st_name==0 ? "(noname)" : strtab+sym.st_name;
3249 (ehdrC + shdr[ sym.st_shndx ].sh_offset
3250 + stab[ELF_R_SYM(info)].st_value);
3253 symbol = strtab + sym.st_name;
3254 stablePtr = (StgStablePtr)lookupHashTable(stablehash, (StgWord)symbol);
3255 if (NULL == stablePtr) {
3256 /* No, so look up the name in our global table. */
3257 S_tmp = lookupSymbol( symbol );
3258 S = (Elf_Addr)S_tmp;
3260 stableVal = deRefStablePtr( stablePtr );
3262 S = (Elf_Addr)S_tmp;
3266 errorBelch("%s: unknown symbol `%s'", oc->fileName, symbol);
3269 IF_DEBUG(linker,debugBelch( "`%s' resolves to %p\n", symbol, (void*)S ));
3272 IF_DEBUG(linker,debugBelch( "Reloc: P = %p S = %p A = %p\n",
3273 (void*)P, (void*)S, (void*)A ));
3274 checkProddableBlock ( oc, pP );
3278 switch (ELF_R_TYPE(info)) {
3279 # ifdef i386_HOST_ARCH
3280 case R_386_32: *pP = value; break;
3281 case R_386_PC32: *pP = value - P; break;
3284 errorBelch("%s: unhandled ELF relocation(Rel) type %lu\n",
3285 oc->fileName, (lnat)ELF_R_TYPE(info));
3293 /* Do ELF relocations for which explicit addends are supplied.
3294 sparc-solaris relocations appear to be of this form. */
3296 do_Elf_Rela_relocations ( ObjectCode* oc, char* ehdrC,
3297 Elf_Shdr* shdr, int shnum,
3298 Elf_Sym* stab, char* strtab )
3301 char *symbol = NULL;
3303 Elf_Rela* rtab = (Elf_Rela*) (ehdrC + shdr[shnum].sh_offset);
3304 int nent = shdr[shnum].sh_size / sizeof(Elf_Rela);
3305 int target_shndx = shdr[shnum].sh_info;
3306 int symtab_shndx = shdr[shnum].sh_link;
3308 stab = (Elf_Sym*) (ehdrC + shdr[ symtab_shndx ].sh_offset);
3309 targ = (Elf_Addr) (ehdrC + shdr[ target_shndx ].sh_offset);
3310 IF_DEBUG(linker,debugBelch( "relocations for section %d using symtab %d\n",
3311 target_shndx, symtab_shndx ));
3313 for (j = 0; j < nent; j++) {
3314 #if defined(DEBUG) || defined(sparc_HOST_ARCH) || defined(ia64_HOST_ARCH) || defined(powerpc_HOST_ARCH) || defined(x86_64_HOST_ARCH)
3315 /* This #ifdef only serves to avoid unused-var warnings. */
3316 Elf_Addr offset = rtab[j].r_offset;
3317 Elf_Addr P = targ + offset;
3319 Elf_Addr info = rtab[j].r_info;
3320 Elf_Addr A = rtab[j].r_addend;
3324 # if defined(sparc_HOST_ARCH)
3325 Elf_Word* pP = (Elf_Word*)P;
3327 # elif defined(ia64_HOST_ARCH)
3328 Elf64_Xword *pP = (Elf64_Xword *)P;
3330 # elif defined(powerpc_HOST_ARCH)
3334 IF_DEBUG(linker,debugBelch( "Rel entry %3d is raw(%6p %6p %6p) ",
3335 j, (void*)offset, (void*)info,
3338 IF_DEBUG(linker,debugBelch( " ZERO" ));
3341 Elf_Sym sym = stab[ELF_R_SYM(info)];
3342 /* First see if it is a local symbol. */
3343 if (ELF_ST_BIND(sym.st_info) == STB_LOCAL) {
3344 /* Yes, so we can get the address directly from the ELF symbol
3346 symbol = sym.st_name==0 ? "(noname)" : strtab+sym.st_name;
3348 (ehdrC + shdr[ sym.st_shndx ].sh_offset
3349 + stab[ELF_R_SYM(info)].st_value);
3350 #ifdef ELF_FUNCTION_DESC
3351 /* Make a function descriptor for this function */
3352 if (S && ELF_ST_TYPE(sym.st_info) == STT_FUNC) {
3353 S = allocateFunctionDesc(S + A);
3358 /* No, so look up the name in our global table. */
3359 symbol = strtab + sym.st_name;
3360 S_tmp = lookupSymbol( symbol );
3361 S = (Elf_Addr)S_tmp;
3363 #ifdef ELF_FUNCTION_DESC
3364 /* If a function, already a function descriptor - we would
3365 have to copy it to add an offset. */
3366 if (S && (ELF_ST_TYPE(sym.st_info) == STT_FUNC) && (A != 0))
3367 errorBelch("%s: function %s with addend %p", oc->fileName, symbol, (void *)A);
3371 errorBelch("%s: unknown symbol `%s'", oc->fileName, symbol);
3374 IF_DEBUG(linker,debugBelch( "`%s' resolves to %p", symbol, (void*)S ));
3377 IF_DEBUG(linker,debugBelch("Reloc: P = %p S = %p A = %p\n",
3378 (void*)P, (void*)S, (void*)A ));
3379 /* checkProddableBlock ( oc, (void*)P ); */
3383 switch (ELF_R_TYPE(info)) {
3384 # if defined(sparc_HOST_ARCH)
3385 case R_SPARC_WDISP30:
3386 w1 = *pP & 0xC0000000;
3387 w2 = (Elf_Word)((value - P) >> 2);
3388 ASSERT((w2 & 0xC0000000) == 0);
3393 w1 = *pP & 0xFFC00000;
3394 w2 = (Elf_Word)(value >> 10);
3395 ASSERT((w2 & 0xFFC00000) == 0);
3401 w2 = (Elf_Word)(value & 0x3FF);
3402 ASSERT((w2 & ~0x3FF) == 0);
3406 /* According to the Sun documentation:
3408 This relocation type resembles R_SPARC_32, except it refers to an
3409 unaligned word. That is, the word to be relocated must be treated
3410 as four separate bytes with arbitrary alignment, not as a word
3411 aligned according to the architecture requirements.
3413 (JRS: which means that freeloading on the R_SPARC_32 case
3414 is probably wrong, but hey ...)
3418 w2 = (Elf_Word)value;
3421 # elif defined(ia64_HOST_ARCH)
3422 case R_IA64_DIR64LSB:
3423 case R_IA64_FPTR64LSB:
3426 case R_IA64_PCREL64LSB:
3429 case R_IA64_SEGREL64LSB:
3430 addr = findElfSegment(ehdrC, value);
3433 case R_IA64_GPREL22:
3434 ia64_reloc_gprel22(P, value);
3436 case R_IA64_LTOFF22:
3437 case R_IA64_LTOFF22X:
3438 case R_IA64_LTOFF_FPTR22:
3439 addr = allocateGOTEntry(value);
3440 ia64_reloc_gprel22(P, addr);
3442 case R_IA64_PCREL21B:
3443 ia64_reloc_pcrel21(P, S, oc);
3446 /* This goes with R_IA64_LTOFF22X and points to the load to
3447 * convert into a move. We don't implement relaxation. */
3449 # elif defined(powerpc_HOST_ARCH)
3450 case R_PPC_ADDR16_LO:
3451 *(Elf32_Half*) P = value;
3454 case R_PPC_ADDR16_HI:
3455 *(Elf32_Half*) P = value >> 16;
3458 case R_PPC_ADDR16_HA:
3459 *(Elf32_Half*) P = (value + 0x8000) >> 16;
3463 *(Elf32_Word *) P = value;
3467 *(Elf32_Word *) P = value - P;
3473 if( delta << 6 >> 6 != delta )
3475 value = (Elf_Addr) (&makeSymbolExtra( oc, ELF_R_SYM(info), value )
3479 if( value == 0 || delta << 6 >> 6 != delta )
3481 barf( "Unable to make SymbolExtra for #%d",
3487 *(Elf_Word *) P = (*(Elf_Word *) P & 0xfc000003)
3488 | (delta & 0x3fffffc);
3492 #if x86_64_HOST_ARCH
3494 *(Elf64_Xword *)P = value;
3499 StgInt64 off = value - P;
3500 if (off >= 0x7fffffffL || off < -0x80000000L) {
3501 #if X86_64_ELF_NONPIC_HACK
3502 StgInt64 pltAddress = (StgInt64) &makeSymbolExtra(oc, ELF_R_SYM(info), S)
3504 off = pltAddress + A - P;
3506 barf("R_X86_64_PC32 relocation out of range: %s = %p\nRecompile %s with -fPIC.",
3507 symbol, off, oc->fileName );
3510 *(Elf64_Word *)P = (Elf64_Word)off;
3516 StgInt64 off = value - P;
3517 *(Elf64_Word *)P = (Elf64_Word)off;
3522 if (value >= 0x7fffffffL) {
3523 #if X86_64_ELF_NONPIC_HACK
3524 StgInt64 pltAddress = (StgInt64) &makeSymbolExtra(oc, ELF_R_SYM(info), S)
3526 value = pltAddress + A;
3528 barf("R_X86_64_32 relocation out of range: %s = %p\nRecompile %s with -fPIC.",
3529 symbol, value, oc->fileName );
3532 *(Elf64_Word *)P = (Elf64_Word)value;
3536 if ((StgInt64)value > 0x7fffffffL || (StgInt64)value < -0x80000000L) {
3537 #if X86_64_ELF_NONPIC_HACK
3538 StgInt64 pltAddress = (StgInt64) &makeSymbolExtra(oc, ELF_R_SYM(info), S)
3540 value = pltAddress + A;
3542 barf("R_X86_64_32S relocation out of range: %s = %p\nRecompile %s with -fPIC.",
3543 symbol, value, oc->fileName );
3546 *(Elf64_Sword *)P = (Elf64_Sword)value;
3549 case R_X86_64_GOTPCREL:
3551 StgInt64 gotAddress = (StgInt64) &makeSymbolExtra(oc, ELF_R_SYM(info), S)->addr;
3552 StgInt64 off = gotAddress + A - P;
3553 *(Elf64_Word *)P = (Elf64_Word)off;
3557 case R_X86_64_PLT32:
3559 StgInt64 off = value - P;
3560 if (off >= 0x7fffffffL || off < -0x80000000L) {
3561 StgInt64 pltAddress = (StgInt64) &makeSymbolExtra(oc, ELF_R_SYM(info), S)
3563 off = pltAddress + A - P;
3565 *(Elf64_Word *)P = (Elf64_Word)off;
3571 errorBelch("%s: unhandled ELF relocation(RelA) type %lu\n",
3572 oc->fileName, (lnat)ELF_R_TYPE(info));
3581 ocResolve_ELF ( ObjectCode* oc )
3585 Elf_Sym* stab = NULL;
3586 char* ehdrC = (char*)(oc->image);
3587 Elf_Ehdr* ehdr = (Elf_Ehdr*) ehdrC;
3588 Elf_Shdr* shdr = (Elf_Shdr*) (ehdrC + ehdr->e_shoff);
3590 /* first find "the" symbol table */
3591 stab = (Elf_Sym*) findElfSection ( ehdrC, SHT_SYMTAB );
3593 /* also go find the string table */
3594 strtab = findElfSection ( ehdrC, SHT_STRTAB );
3596 if (stab == NULL || strtab == NULL) {
3597 errorBelch("%s: can't find string or symbol table", oc->fileName);
3601 /* Process the relocation sections. */
3602 for (shnum = 0; shnum < ehdr->e_shnum; shnum++) {
3603 if (shdr[shnum].sh_type == SHT_REL) {
3604 ok = do_Elf_Rel_relocations ( oc, ehdrC, shdr,
3605 shnum, stab, strtab );
3609 if (shdr[shnum].sh_type == SHT_RELA) {
3610 ok = do_Elf_Rela_relocations ( oc, ehdrC, shdr,
3611 shnum, stab, strtab );
3616 #if defined(powerpc_HOST_ARCH)
3617 ocFlushInstructionCache( oc );
3625 * Instructions are 41 bits long, packed into 128 bit bundles with a 5-bit template
3626 * at the front. The following utility functions pack and unpack instructions, and
3627 * take care of the most common relocations.
3630 #ifdef ia64_HOST_ARCH
3633 ia64_extract_instruction(Elf64_Xword *target)
3636 int slot = (Elf_Addr)target & 3;
3637 target = (Elf_Addr)target & ~3;
3645 return ((w1 >> 5) & 0x1ffffffffff);
3647 return (w1 >> 46) | ((w2 & 0x7fffff) << 18);
3651 barf("ia64_extract_instruction: invalid slot %p", target);
3656 ia64_deposit_instruction(Elf64_Xword *target, Elf64_Xword value)
3658 int slot = (Elf_Addr)target & 3;
3659 target = (Elf_Addr)target & ~3;
3664 *target |= value << 5;
3667 *target |= value << 46;
3668 *(target+1) |= value >> 18;
3671 *(target+1) |= value << 23;
3677 ia64_reloc_gprel22(Elf_Addr target, Elf_Addr value)
3679 Elf64_Xword instruction;
3680 Elf64_Sxword rel_value;
3682 rel_value = value - gp_val;
3683 if ((rel_value > 0x1fffff) || (rel_value < -0x1fffff))
3684 barf("GP-relative data out of range (address = 0x%lx, gp = 0x%lx)", value, gp_val);
3686 instruction = ia64_extract_instruction((Elf64_Xword *)target);
3687 instruction |= (((rel_value >> 0) & 0x07f) << 13) /* imm7b */
3688 | (((rel_value >> 7) & 0x1ff) << 27) /* imm9d */
3689 | (((rel_value >> 16) & 0x01f) << 22) /* imm5c */
3690 | ((Elf64_Xword)(rel_value < 0) << 36); /* s */
3691 ia64_deposit_instruction((Elf64_Xword *)target, instruction);
3695 ia64_reloc_pcrel21(Elf_Addr target, Elf_Addr value, ObjectCode *oc)
3697 Elf64_Xword instruction;
3698 Elf64_Sxword rel_value;
3701 entry = allocatePLTEntry(value, oc);
3703 rel_value = (entry >> 4) - (target >> 4);
3704 if ((rel_value > 0xfffff) || (rel_value < -0xfffff))
3705 barf("PLT entry too far away (entry = 0x%lx, target = 0x%lx)", entry, target);
3707 instruction = ia64_extract_instruction((Elf64_Xword *)target);
3708 instruction |= ((rel_value & 0xfffff) << 13) /* imm20b */
3709 | ((Elf64_Xword)(rel_value < 0) << 36); /* s */
3710 ia64_deposit_instruction((Elf64_Xword *)target, instruction);
3716 * PowerPC & X86_64 ELF specifics
3719 #if defined(powerpc_HOST_ARCH) || defined(x86_64_HOST_ARCH)
3721 static int ocAllocateSymbolExtras_ELF( ObjectCode *oc )
3727 ehdr = (Elf_Ehdr *) oc->image;
3728 shdr = (Elf_Shdr *) ( ((char *)oc->image) + ehdr->e_shoff );
3730 for( i = 0; i < ehdr->e_shnum; i++ )
3731 if( shdr[i].sh_type == SHT_SYMTAB )
3734 if( i == ehdr->e_shnum )
3736 errorBelch( "This ELF file contains no symtab" );
3740 if( shdr[i].sh_entsize != sizeof( Elf_Sym ) )
3742 errorBelch( "The entry size (%d) of the symtab isn't %d\n",
3743 (int) shdr[i].sh_entsize, (int) sizeof( Elf_Sym ) );
3748 return ocAllocateSymbolExtras( oc, shdr[i].sh_size / sizeof( Elf_Sym ), 0 );
3751 #endif /* powerpc */
3755 /* --------------------------------------------------------------------------
3757 * ------------------------------------------------------------------------*/
3759 #if defined(OBJFORMAT_MACHO)
3762 Support for MachO linking on Darwin/MacOS X
3763 by Wolfgang Thaller (wolfgang.thaller@gmx.net)
3765 I hereby formally apologize for the hackish nature of this code.
3766 Things that need to be done:
3767 *) implement ocVerifyImage_MachO
3768 *) add still more sanity checks.
3771 #if x86_64_HOST_ARCH || powerpc64_HOST_ARCH
3772 #define mach_header mach_header_64
3773 #define segment_command segment_command_64
3774 #define section section_64
3775 #define nlist nlist_64
3778 #ifdef powerpc_HOST_ARCH
3779 static int ocAllocateSymbolExtras_MachO(ObjectCode* oc)
3781 struct mach_header *header = (struct mach_header *) oc->image;
3782 struct load_command *lc = (struct load_command *) (header + 1);
3785 for( i = 0; i < header->ncmds; i++ )
3787 if( lc->cmd == LC_SYMTAB )
3789 // Find out the first and last undefined external
3790 // symbol, so we don't have to allocate too many
3792 struct symtab_command *symLC = (struct symtab_command *) lc;
3793 unsigned min = symLC->nsyms, max = 0;
3794 struct nlist *nlist =
3795 symLC ? (struct nlist*) ((char*) oc->image + symLC->symoff)
3797 for(i=0;i<symLC->nsyms;i++)
3799 if(nlist[i].n_type & N_STAB)
3801 else if(nlist[i].n_type & N_EXT)
3803 if((nlist[i].n_type & N_TYPE) == N_UNDF
3804 && (nlist[i].n_value == 0))
3814 return ocAllocateSymbolExtras(oc, max - min + 1, min);
3819 lc = (struct load_command *) ( ((char *)lc) + lc->cmdsize );
3821 return ocAllocateSymbolExtras(oc,0,0);
3824 #ifdef x86_64_HOST_ARCH
3825 static int ocAllocateSymbolExtras_MachO(ObjectCode* oc)
3827 struct mach_header *header = (struct mach_header *) oc->image;
3828 struct load_command *lc = (struct load_command *) (header + 1);
3831 for( i = 0; i < header->ncmds; i++ )
3833 if( lc->cmd == LC_SYMTAB )
3835 // Just allocate one entry for every symbol
3836 struct symtab_command *symLC = (struct symtab_command *) lc;
3838 return ocAllocateSymbolExtras(oc, symLC->nsyms, 0);
3841 lc = (struct load_command *) ( ((char *)lc) + lc->cmdsize );
3843 return ocAllocateSymbolExtras(oc,0,0);
3847 static int ocVerifyImage_MachO(ObjectCode* oc)
3849 char *image = (char*) oc->image;
3850 struct mach_header *header = (struct mach_header*) image;
3852 #if x86_64_TARGET_ARCH || powerpc64_TARGET_ARCH
3853 if(header->magic != MH_MAGIC_64)
3856 if(header->magic != MH_MAGIC)
3859 // FIXME: do some more verifying here
3863 static int resolveImports(
3866 struct symtab_command *symLC,
3867 struct section *sect, // ptr to lazy or non-lazy symbol pointer section
3868 unsigned long *indirectSyms,
3869 struct nlist *nlist)
3872 size_t itemSize = 4;
3875 int isJumpTable = 0;
3876 if(!strcmp(sect->sectname,"__jump_table"))
3880 ASSERT(sect->reserved2 == itemSize);
3884 for(i=0; i*itemSize < sect->size;i++)
3886 // according to otool, reserved1 contains the first index into the indirect symbol table
3887 struct nlist *symbol = &nlist[indirectSyms[sect->reserved1+i]];
3888 char *nm = image + symLC->stroff + symbol->n_un.n_strx;
3891 if((symbol->n_type & N_TYPE) == N_UNDF
3892 && (symbol->n_type & N_EXT) && (symbol->n_value != 0))
3893 addr = (void*) (symbol->n_value);
3895 addr = lookupSymbol(nm);
3898 errorBelch("\n%s: unknown symbol `%s'", oc->fileName, nm);
3906 checkProddableBlock(oc,image + sect->offset + i*itemSize);
3907 *(image + sect->offset + i*itemSize) = 0xe9; // jmp
3908 *(unsigned*)(image + sect->offset + i*itemSize + 1)
3909 = (char*)addr - (image + sect->offset + i*itemSize + 5);
3914 checkProddableBlock(oc,((void**)(image + sect->offset)) + i);
3915 ((void**)(image + sect->offset))[i] = addr;
3922 static unsigned long relocateAddress(
3925 struct section* sections,
3926 unsigned long address)
3929 for(i = 0; i < nSections; i++)
3931 if(sections[i].addr <= address
3932 && address < sections[i].addr + sections[i].size)
3934 return (unsigned long)oc->image
3935 + sections[i].offset + address - sections[i].addr;
3938 barf("Invalid Mach-O file:"
3939 "Address out of bounds while relocating object file");
3943 static int relocateSection(
3946 struct symtab_command *symLC, struct nlist *nlist,
3947 int nSections, struct section* sections, struct section *sect)
3949 struct relocation_info *relocs;
3952 if(!strcmp(sect->sectname,"__la_symbol_ptr"))
3954 else if(!strcmp(sect->sectname,"__nl_symbol_ptr"))
3956 else if(!strcmp(sect->sectname,"__la_sym_ptr2"))
3958 else if(!strcmp(sect->sectname,"__la_sym_ptr3"))
3962 relocs = (struct relocation_info*) (image + sect->reloff);
3966 #ifdef x86_64_HOST_ARCH
3967 struct relocation_info *reloc = &relocs[i];
3969 char *thingPtr = image + sect->offset + reloc->r_address;
3973 int type = reloc->r_type;
3975 checkProddableBlock(oc,thingPtr);
3976 switch(reloc->r_length)
3979 thing = *(uint8_t*)thingPtr;
3980 baseValue = (uint64_t)thingPtr + 1;
3983 thing = *(uint16_t*)thingPtr;
3984 baseValue = (uint64_t)thingPtr + 2;
3987 thing = *(uint32_t*)thingPtr;
3988 baseValue = (uint64_t)thingPtr + 4;
3991 thing = *(uint64_t*)thingPtr;
3992 baseValue = (uint64_t)thingPtr + 8;
3995 barf("Unknown size.");
3998 if(type == X86_64_RELOC_GOT
3999 || type == X86_64_RELOC_GOT_LOAD)
4001 ASSERT(reloc->r_extern);
4002 value = (uint64_t) &makeSymbolExtra(oc, reloc->r_symbolnum, value)->addr;
4004 type = X86_64_RELOC_SIGNED;
4006 else if(reloc->r_extern)
4008 struct nlist *symbol = &nlist[reloc->r_symbolnum];
4009 char *nm = image + symLC->stroff + symbol->n_un.n_strx;
4010 if(symbol->n_value == 0)
4011 value = (uint64_t) lookupSymbol(nm);
4013 value = relocateAddress(oc, nSections, sections,
4018 value = sections[reloc->r_symbolnum-1].offset
4019 - sections[reloc->r_symbolnum-1].addr
4023 if(type == X86_64_RELOC_BRANCH)
4025 if((int32_t)(value - baseValue) != (int64_t)(value - baseValue))
4027 ASSERT(reloc->r_extern);
4028 value = (uint64_t) &makeSymbolExtra(oc, reloc->r_symbolnum, value)
4031 ASSERT((int32_t)(value - baseValue) == (int64_t)(value - baseValue));
4032 type = X86_64_RELOC_SIGNED;
4037 case X86_64_RELOC_UNSIGNED:
4038 ASSERT(!reloc->r_pcrel);
4041 case X86_64_RELOC_SIGNED:
4042 ASSERT(reloc->r_pcrel);
4043 thing += value - baseValue;
4045 case X86_64_RELOC_SUBTRACTOR:
4046 ASSERT(!reloc->r_pcrel);
4050 barf("unkown relocation");
4053 switch(reloc->r_length)
4056 *(uint8_t*)thingPtr = thing;
4059 *(uint16_t*)thingPtr = thing;
4062 *(uint32_t*)thingPtr = thing;
4065 *(uint64_t*)thingPtr = thing;
4069 if(relocs[i].r_address & R_SCATTERED)
4071 struct scattered_relocation_info *scat =
4072 (struct scattered_relocation_info*) &relocs[i];
4076 if(scat->r_length == 2)
4078 unsigned long word = 0;
4079 unsigned long* wordPtr = (unsigned long*) (image + sect->offset + scat->r_address);
4080 checkProddableBlock(oc,wordPtr);
4082 // Note on relocation types:
4083 // i386 uses the GENERIC_RELOC_* types,
4084 // while ppc uses special PPC_RELOC_* types.
4085 // *_RELOC_VANILLA and *_RELOC_PAIR have the same value
4086 // in both cases, all others are different.
4087 // Therefore, we use GENERIC_RELOC_VANILLA
4088 // and GENERIC_RELOC_PAIR instead of the PPC variants,
4089 // and use #ifdefs for the other types.
4091 // Step 1: Figure out what the relocated value should be
4092 if(scat->r_type == GENERIC_RELOC_VANILLA)
4094 word = *wordPtr + (unsigned long) relocateAddress(
4101 #ifdef powerpc_HOST_ARCH
4102 else if(scat->r_type == PPC_RELOC_SECTDIFF
4103 || scat->r_type == PPC_RELOC_LO16_SECTDIFF
4104 || scat->r_type == PPC_RELOC_HI16_SECTDIFF
4105 || scat->r_type == PPC_RELOC_HA16_SECTDIFF)
4107 else if(scat->r_type == GENERIC_RELOC_SECTDIFF)
4110 struct scattered_relocation_info *pair =
4111 (struct scattered_relocation_info*) &relocs[i+1];
4113 if(!pair->r_scattered || pair->r_type != GENERIC_RELOC_PAIR)
4114 barf("Invalid Mach-O file: "
4115 "RELOC_*_SECTDIFF not followed by RELOC_PAIR");
4117 word = (unsigned long)
4118 (relocateAddress(oc, nSections, sections, scat->r_value)
4119 - relocateAddress(oc, nSections, sections, pair->r_value));
4122 #ifdef powerpc_HOST_ARCH
4123 else if(scat->r_type == PPC_RELOC_HI16
4124 || scat->r_type == PPC_RELOC_LO16
4125 || scat->r_type == PPC_RELOC_HA16
4126 || scat->r_type == PPC_RELOC_LO14)
4127 { // these are generated by label+offset things
4128 struct relocation_info *pair = &relocs[i+1];
4129 if((pair->r_address & R_SCATTERED) || pair->r_type != PPC_RELOC_PAIR)
4130 barf("Invalid Mach-O file: "
4131 "PPC_RELOC_* not followed by PPC_RELOC_PAIR");
4133 if(scat->r_type == PPC_RELOC_LO16)
4135 word = ((unsigned short*) wordPtr)[1];
4136 word |= ((unsigned long) relocs[i+1].r_address & 0xFFFF) << 16;
4138 else if(scat->r_type == PPC_RELOC_LO14)
4140 barf("Unsupported Relocation: PPC_RELOC_LO14");
4141 word = ((unsigned short*) wordPtr)[1] & 0xFFFC;
4142 word |= ((unsigned long) relocs[i+1].r_address & 0xFFFF) << 16;
4144 else if(scat->r_type == PPC_RELOC_HI16)
4146 word = ((unsigned short*) wordPtr)[1] << 16;
4147 word |= ((unsigned long) relocs[i+1].r_address & 0xFFFF);
4149 else if(scat->r_type == PPC_RELOC_HA16)
4151 word = ((unsigned short*) wordPtr)[1] << 16;
4152 word += ((short)relocs[i+1].r_address & (short)0xFFFF);
4156 word += (unsigned long) relocateAddress(oc, nSections, sections, scat->r_value)
4163 continue; // ignore the others
4165 #ifdef powerpc_HOST_ARCH
4166 if(scat->r_type == GENERIC_RELOC_VANILLA
4167 || scat->r_type == PPC_RELOC_SECTDIFF)
4169 if(scat->r_type == GENERIC_RELOC_VANILLA
4170 || scat->r_type == GENERIC_RELOC_SECTDIFF)
4175 #ifdef powerpc_HOST_ARCH
4176 else if(scat->r_type == PPC_RELOC_LO16_SECTDIFF || scat->r_type == PPC_RELOC_LO16)
4178 ((unsigned short*) wordPtr)[1] = word & 0xFFFF;
4180 else if(scat->r_type == PPC_RELOC_HI16_SECTDIFF || scat->r_type == PPC_RELOC_HI16)
4182 ((unsigned short*) wordPtr)[1] = (word >> 16) & 0xFFFF;
4184 else if(scat->r_type == PPC_RELOC_HA16_SECTDIFF || scat->r_type == PPC_RELOC_HA16)
4186 ((unsigned short*) wordPtr)[1] = ((word >> 16) & 0xFFFF)
4187 + ((word & (1<<15)) ? 1 : 0);
4193 continue; // FIXME: I hope it's OK to ignore all the others.
4197 struct relocation_info *reloc = &relocs[i];
4198 if(reloc->r_pcrel && !reloc->r_extern)
4201 if(reloc->r_length == 2)
4203 unsigned long word = 0;
4204 #ifdef powerpc_HOST_ARCH
4205 unsigned long jumpIsland = 0;
4206 long offsetToJumpIsland = 0xBADBAD42; // initialise to bad value
4207 // to avoid warning and to catch
4211 unsigned long* wordPtr = (unsigned long*) (image + sect->offset + reloc->r_address);
4212 checkProddableBlock(oc,wordPtr);
4214 if(reloc->r_type == GENERIC_RELOC_VANILLA)
4218 #ifdef powerpc_HOST_ARCH
4219 else if(reloc->r_type == PPC_RELOC_LO16)
4221 word = ((unsigned short*) wordPtr)[1];
4222 word |= ((unsigned long) relocs[i+1].r_address & 0xFFFF) << 16;
4224 else if(reloc->r_type == PPC_RELOC_HI16)
4226 word = ((unsigned short*) wordPtr)[1] << 16;
4227 word |= ((unsigned long) relocs[i+1].r_address & 0xFFFF);
4229 else if(reloc->r_type == PPC_RELOC_HA16)
4231 word = ((unsigned short*) wordPtr)[1] << 16;
4232 word += ((short)relocs[i+1].r_address & (short)0xFFFF);
4234 else if(reloc->r_type == PPC_RELOC_BR24)
4237 word = (word & 0x03FFFFFC) | ((word & 0x02000000) ? 0xFC000000 : 0);
4241 if(!reloc->r_extern)
4244 sections[reloc->r_symbolnum-1].offset
4245 - sections[reloc->r_symbolnum-1].addr
4252 struct nlist *symbol = &nlist[reloc->r_symbolnum];
4253 char *nm = image + symLC->stroff + symbol->n_un.n_strx;
4254 void *symbolAddress = lookupSymbol(nm);
4257 errorBelch("\nunknown symbol `%s'", nm);
4263 #ifdef powerpc_HOST_ARCH
4264 // In the .o file, this should be a relative jump to NULL
4265 // and we'll change it to a relative jump to the symbol
4266 ASSERT(word + reloc->r_address == 0);
4267 jumpIsland = (unsigned long)
4268 &makeSymbolExtra(oc,
4270 (unsigned long) symbolAddress)
4274 offsetToJumpIsland = word + jumpIsland
4275 - (((long)image) + sect->offset - sect->addr);
4278 word += (unsigned long) symbolAddress
4279 - (((long)image) + sect->offset - sect->addr);
4283 word += (unsigned long) symbolAddress;
4287 if(reloc->r_type == GENERIC_RELOC_VANILLA)
4292 #ifdef powerpc_HOST_ARCH
4293 else if(reloc->r_type == PPC_RELOC_LO16)
4295 ((unsigned short*) wordPtr)[1] = word & 0xFFFF;
4298 else if(reloc->r_type == PPC_RELOC_HI16)
4300 ((unsigned short*) wordPtr)[1] = (word >> 16) & 0xFFFF;
4303 else if(reloc->r_type == PPC_RELOC_HA16)
4305 ((unsigned short*) wordPtr)[1] = ((word >> 16) & 0xFFFF)
4306 + ((word & (1<<15)) ? 1 : 0);
4309 else if(reloc->r_type == PPC_RELOC_BR24)
4311 if((long)word > (long)0x01FFFFFF || (long)word < (long)0xFFE00000)
4313 // The branch offset is too large.
4314 // Therefore, we try to use a jump island.
4317 barf("unconditional relative branch out of range: "
4318 "no jump island available");
4321 word = offsetToJumpIsland;
4322 if((long)word > (long)0x01FFFFFF || (long)word < (long)0xFFE00000)
4323 barf("unconditional relative branch out of range: "
4324 "jump island out of range");
4326 *wordPtr = (*wordPtr & 0xFC000003) | (word & 0x03FFFFFC);
4331 barf("\nunknown relocation %d",reloc->r_type);
4339 static int ocGetNames_MachO(ObjectCode* oc)
4341 char *image = (char*) oc->image;
4342 struct mach_header *header = (struct mach_header*) image;
4343 struct load_command *lc = (struct load_command*) (image + sizeof(struct mach_header));
4344 unsigned i,curSymbol = 0;
4345 struct segment_command *segLC = NULL;
4346 struct section *sections;
4347 struct symtab_command *symLC = NULL;
4348 struct nlist *nlist;
4349 unsigned long commonSize = 0;
4350 char *commonStorage = NULL;
4351 unsigned long commonCounter;
4353 for(i=0;i<header->ncmds;i++)
4355 if(lc->cmd == LC_SEGMENT || lc->cmd == LC_SEGMENT_64)
4356 segLC = (struct segment_command*) lc;
4357 else if(lc->cmd == LC_SYMTAB)
4358 symLC = (struct symtab_command*) lc;
4359 lc = (struct load_command *) ( ((char*)lc) + lc->cmdsize );
4362 sections = (struct section*) (segLC+1);
4363 nlist = symLC ? (struct nlist*) (image + symLC->symoff)
4367 barf("ocGetNames_MachO: no segment load command");
4369 for(i=0;i<segLC->nsects;i++)
4371 if(sections[i].size == 0)
4374 if((sections[i].flags & SECTION_TYPE) == S_ZEROFILL)
4376 char * zeroFillArea = stgCallocBytes(1,sections[i].size,
4377 "ocGetNames_MachO(common symbols)");
4378 sections[i].offset = zeroFillArea - image;
4381 if(!strcmp(sections[i].sectname,"__text"))
4382 addSection(oc, SECTIONKIND_CODE_OR_RODATA,
4383 (void*) (image + sections[i].offset),
4384 (void*) (image + sections[i].offset + sections[i].size));
4385 else if(!strcmp(sections[i].sectname,"__const"))
4386 addSection(oc, SECTIONKIND_RWDATA,
4387 (void*) (image + sections[i].offset),
4388 (void*) (image + sections[i].offset + sections[i].size));
4389 else if(!strcmp(sections[i].sectname,"__data"))
4390 addSection(oc, SECTIONKIND_RWDATA,
4391 (void*) (image + sections[i].offset),
4392 (void*) (image + sections[i].offset + sections[i].size));
4393 else if(!strcmp(sections[i].sectname,"__bss")
4394 || !strcmp(sections[i].sectname,"__common"))
4395 addSection(oc, SECTIONKIND_RWDATA,
4396 (void*) (image + sections[i].offset),
4397 (void*) (image + sections[i].offset + sections[i].size));
4399 addProddableBlock(oc, (void*) (image + sections[i].offset),
4403 // count external symbols defined here
4407 for(i=0;i<symLC->nsyms;i++)
4409 if(nlist[i].n_type & N_STAB)
4411 else if(nlist[i].n_type & N_EXT)
4413 if((nlist[i].n_type & N_TYPE) == N_UNDF
4414 && (nlist[i].n_value != 0))
4416 commonSize += nlist[i].n_value;
4419 else if((nlist[i].n_type & N_TYPE) == N_SECT)
4424 oc->symbols = stgMallocBytes(oc->n_symbols * sizeof(char*),
4425 "ocGetNames_MachO(oc->symbols)");
4429 for(i=0;i<symLC->nsyms;i++)
4431 if(nlist[i].n_type & N_STAB)
4433 else if((nlist[i].n_type & N_TYPE) == N_SECT)
4435 if(nlist[i].n_type & N_EXT)
4437 char *nm = image + symLC->stroff + nlist[i].n_un.n_strx;
4438 if((nlist[i].n_desc & N_WEAK_DEF) && lookupSymbol(nm))
4439 ; // weak definition, and we already have a definition
4442 ghciInsertStrHashTable(oc->fileName, symhash, nm,
4444 + sections[nlist[i].n_sect-1].offset
4445 - sections[nlist[i].n_sect-1].addr
4446 + nlist[i].n_value);
4447 oc->symbols[curSymbol++] = nm;
4454 commonStorage = stgCallocBytes(1,commonSize,"ocGetNames_MachO(common symbols)");
4455 commonCounter = (unsigned long)commonStorage;
4458 for(i=0;i<symLC->nsyms;i++)
4460 if((nlist[i].n_type & N_TYPE) == N_UNDF
4461 && (nlist[i].n_type & N_EXT) && (nlist[i].n_value != 0))
4463 char *nm = image + symLC->stroff + nlist[i].n_un.n_strx;
4464 unsigned long sz = nlist[i].n_value;
4466 nlist[i].n_value = commonCounter;
4468 ghciInsertStrHashTable(oc->fileName, symhash, nm,
4469 (void*)commonCounter);
4470 oc->symbols[curSymbol++] = nm;
4472 commonCounter += sz;
4479 static int ocResolve_MachO(ObjectCode* oc)
4481 char *image = (char*) oc->image;
4482 struct mach_header *header = (struct mach_header*) image;
4483 struct load_command *lc = (struct load_command*) (image + sizeof(struct mach_header));
4485 struct segment_command *segLC = NULL;
4486 struct section *sections;
4487 struct symtab_command *symLC = NULL;
4488 struct dysymtab_command *dsymLC = NULL;
4489 struct nlist *nlist;
4491 for(i=0;i<header->ncmds;i++)
4493 if(lc->cmd == LC_SEGMENT || lc->cmd == LC_SEGMENT_64)
4494 segLC = (struct segment_command*) lc;
4495 else if(lc->cmd == LC_SYMTAB)
4496 symLC = (struct symtab_command*) lc;
4497 else if(lc->cmd == LC_DYSYMTAB)
4498 dsymLC = (struct dysymtab_command*) lc;
4499 lc = (struct load_command *) ( ((char*)lc) + lc->cmdsize );
4502 sections = (struct section*) (segLC+1);
4503 nlist = symLC ? (struct nlist*) (image + symLC->symoff)
4508 unsigned long *indirectSyms
4509 = (unsigned long*) (image + dsymLC->indirectsymoff);
4511 for(i=0;i<segLC->nsects;i++)
4513 if( !strcmp(sections[i].sectname,"__la_symbol_ptr")
4514 || !strcmp(sections[i].sectname,"__la_sym_ptr2")
4515 || !strcmp(sections[i].sectname,"__la_sym_ptr3"))
4517 if(!resolveImports(oc,image,symLC,§ions[i],indirectSyms,nlist))
4520 else if(!strcmp(sections[i].sectname,"__nl_symbol_ptr")
4521 || !strcmp(sections[i].sectname,"__pointers"))
4523 if(!resolveImports(oc,image,symLC,§ions[i],indirectSyms,nlist))
4526 else if(!strcmp(sections[i].sectname,"__jump_table"))
4528 if(!resolveImports(oc,image,symLC,§ions[i],indirectSyms,nlist))
4534 for(i=0;i<segLC->nsects;i++)
4536 if(!relocateSection(oc,image,symLC,nlist,segLC->nsects,sections,§ions[i]))
4540 #if defined (powerpc_HOST_ARCH)
4541 ocFlushInstructionCache( oc );
4547 #ifdef powerpc_HOST_ARCH
4549 * The Mach-O object format uses leading underscores. But not everywhere.
4550 * There is a small number of runtime support functions defined in
4551 * libcc_dynamic.a whose name does not have a leading underscore.
4552 * As a consequence, we can't get their address from C code.
4553 * We have to use inline assembler just to take the address of a function.
4557 static void machoInitSymbolsWithoutUnderscore()
4559 extern void* symbolsWithoutUnderscore[];
4560 void **p = symbolsWithoutUnderscore;
4561 __asm__ volatile(".globl _symbolsWithoutUnderscore\n.data\n_symbolsWithoutUnderscore:");
4565 __asm__ volatile(".long " # x);
4567 RTS_MACHO_NOUNDERLINE_SYMBOLS
4569 __asm__ volatile(".text");
4573 ghciInsertStrHashTable("(GHCi built-in symbols)", symhash, #x, *p++);
4575 RTS_MACHO_NOUNDERLINE_SYMBOLS
4582 * Figure out by how much to shift the entire Mach-O file in memory
4583 * when loading so that its single segment ends up 16-byte-aligned
4585 static int machoGetMisalignment( FILE * f )
4587 struct mach_header header;
4590 fread(&header, sizeof(header), 1, f);
4593 #if x86_64_TARGET_ARCH || powerpc64_TARGET_ARCH
4594 if(header.magic != MH_MAGIC_64)
4597 if(header.magic != MH_MAGIC)
4601 misalignment = (header.sizeofcmds + sizeof(header))
4604 return misalignment ? (16 - misalignment) : 0;