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 sprintf(buf, "%s.DRV", dll_name); // KAA: allow loading of drivers (like winspool.drv)
1070 instance = LoadLibrary(buf);
1071 if (instance == NULL) {
1074 /* LoadLibrary failed; return a ptr to the error msg. */
1075 return "addDLL: unknown error";
1080 /* Add this DLL to the list of DLLs in which to search for symbols. */
1081 o_dll = stgMallocBytes( sizeof(OpenedDLL), "addDLL" );
1082 o_dll->name = stgMallocBytes(1+strlen(dll_name), "addDLL");
1083 strcpy(o_dll->name, dll_name);
1084 o_dll->instance = instance;
1085 o_dll->next = opened_dlls;
1086 opened_dlls = o_dll;
1090 barf("addDLL: not implemented on this platform");
1094 /* -----------------------------------------------------------------------------
1095 * insert a stable symbol in the hash table
1099 insertStableSymbol(char* obj_name, char* key, StgPtr p)
1101 ghciInsertStrHashTable(obj_name, stablehash, key, getStablePtr(p));
1105 /* -----------------------------------------------------------------------------
1106 * insert a symbol in the hash table
1109 insertSymbol(char* obj_name, char* key, void* data)
1111 ghciInsertStrHashTable(obj_name, symhash, key, data);
1114 /* -----------------------------------------------------------------------------
1115 * lookup a symbol in the hash table
1118 lookupSymbol( char *lbl )
1122 ASSERT(symhash != NULL);
1123 val = lookupStrHashTable(symhash, lbl);
1126 # if defined(OBJFORMAT_ELF)
1127 return dlsym(dl_prog_handle, lbl);
1128 # elif defined(OBJFORMAT_MACHO)
1130 /* On OS X 10.3 and later, we use dlsym instead of the old legacy
1133 HACK: On OS X, global symbols are prefixed with an underscore.
1134 However, dlsym wants us to omit the leading underscore from the
1135 symbol name. For now, we simply strip it off here (and ONLY
1138 ASSERT(lbl[0] == '_');
1139 return dlsym(dl_prog_handle, lbl+1);
1141 if(NSIsSymbolNameDefined(lbl)) {
1142 NSSymbol symbol = NSLookupAndBindSymbol(lbl);
1143 return NSAddressOfSymbol(symbol);
1147 # endif /* HAVE_DLFCN_H */
1148 # elif defined(OBJFORMAT_PEi386)
1151 for (o_dll = opened_dlls; o_dll != NULL; o_dll = o_dll->next) {
1152 /* debugBelch("look in %s for %s\n", o_dll->name, lbl); */
1153 if (lbl[0] == '_') {
1154 /* HACK: if the name has an initial underscore, try stripping
1155 it off & look that up first. I've yet to verify whether there's
1156 a Rule that governs whether an initial '_' *should always* be
1157 stripped off when mapping from import lib name to the DLL name.
1159 sym = GetProcAddress(o_dll->instance, (lbl+1));
1161 /*debugBelch("found %s in %s\n", lbl+1,o_dll->name);*/
1165 sym = GetProcAddress(o_dll->instance, lbl);
1167 /*debugBelch("found %s in %s\n", lbl,o_dll->name);*/
1182 __attribute((unused))
1184 lookupLocalSymbol( ObjectCode* oc, char *lbl )
1188 val = lookupStrHashTable(oc->lochash, lbl);
1198 /* -----------------------------------------------------------------------------
1199 * Debugging aid: look in GHCi's object symbol tables for symbols
1200 * within DELTA bytes of the specified address, and show their names.
1203 void ghci_enquire ( char* addr );
1205 void ghci_enquire ( char* addr )
1210 const int DELTA = 64;
1215 for (oc = objects; oc; oc = oc->next) {
1216 for (i = 0; i < oc->n_symbols; i++) {
1217 sym = oc->symbols[i];
1218 if (sym == NULL) continue;
1219 // debugBelch("enquire %p %p\n", sym, oc->lochash);
1221 if (oc->lochash != NULL) {
1222 a = lookupStrHashTable(oc->lochash, sym);
1225 a = lookupStrHashTable(symhash, sym);
1228 // debugBelch("ghci_enquire: can't find %s\n", sym);
1230 else if (addr-DELTA <= a && a <= addr+DELTA) {
1231 debugBelch("%p + %3d == `%s'\n", addr, (int)(a - addr), sym);
1238 #ifdef ia64_HOST_ARCH
1239 static unsigned int PLTSize(void);
1242 /* -----------------------------------------------------------------------------
1243 * Load an obj (populate the global symbol table, but don't resolve yet)
1245 * Returns: 1 if ok, 0 on error.
1248 loadObj( char *path )
1255 void *map_addr = NULL;
1261 /* debugBelch("loadObj %s\n", path ); */
1263 /* Check that we haven't already loaded this object.
1264 Ignore requests to load multiple times */
1268 for (o = objects; o; o = o->next) {
1269 if (0 == strcmp(o->fileName, path)) {
1271 break; /* don't need to search further */
1275 IF_DEBUG(linker, debugBelch(
1276 "GHCi runtime linker: warning: looks like you're trying to load the\n"
1277 "same object file twice:\n"
1279 "GHCi will ignore this, but be warned.\n"
1281 return 1; /* success */
1285 oc = stgMallocBytes(sizeof(ObjectCode), "loadObj(oc)");
1287 # if defined(OBJFORMAT_ELF)
1288 oc->formatName = "ELF";
1289 # elif defined(OBJFORMAT_PEi386)
1290 oc->formatName = "PEi386";
1291 # elif defined(OBJFORMAT_MACHO)
1292 oc->formatName = "Mach-O";
1295 barf("loadObj: not implemented on this platform");
1298 r = stat(path, &st);
1299 if (r == -1) { return 0; }
1301 /* sigh, strdup() isn't a POSIX function, so do it the long way */
1302 oc->fileName = stgMallocBytes( strlen(path)+1, "loadObj" );
1303 strcpy(oc->fileName, path);
1305 oc->fileSize = st.st_size;
1307 oc->sections = NULL;
1308 oc->lochash = allocStrHashTable();
1309 oc->proddables = NULL;
1311 /* chain it onto the list of objects */
1316 #define ROUND_UP(x,size) ((x + size - 1) & ~(size - 1))
1318 /* On many architectures malloc'd memory isn't executable, so we need to use mmap. */
1320 #if defined(openbsd_HOST_OS)
1321 fd = open(path, O_RDONLY, S_IRUSR);
1323 fd = open(path, O_RDONLY);
1326 barf("loadObj: can't open `%s'", path);
1328 pagesize = getpagesize();
1330 #ifdef ia64_HOST_ARCH
1331 /* The PLT needs to be right before the object */
1332 n = ROUND_UP(PLTSize(), pagesize);
1333 oc->plt = mmap(NULL, n, PROT_EXEC|PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0);
1334 if (oc->plt == MAP_FAILED)
1335 barf("loadObj: can't allocate PLT");
1338 map_addr = oc->plt + n;
1341 n = ROUND_UP(oc->fileSize, pagesize);
1343 /* Link objects into the lower 2Gb on x86_64. GHC assumes the
1344 * small memory model on this architecture (see gcc docs,
1347 * MAP_32BIT not available on OpenBSD/amd64
1349 #if defined(x86_64_HOST_ARCH) && defined(MAP_32BIT)
1350 #define EXTRA_MAP_FLAGS MAP_32BIT
1352 #define EXTRA_MAP_FLAGS 0
1355 /* MAP_ANONYMOUS is MAP_ANON on some systems, e.g. OpenBSD */
1356 #if !defined(MAP_ANONYMOUS) && defined(MAP_ANON)
1357 #define MAP_ANONYMOUS MAP_ANON
1360 oc->image = mmap(map_addr, n, PROT_EXEC|PROT_READ|PROT_WRITE,
1361 MAP_PRIVATE|EXTRA_MAP_FLAGS, fd, 0);
1362 if (oc->image == MAP_FAILED)
1363 barf("loadObj: can't map `%s'", path);
1367 #else /* !USE_MMAP */
1369 /* load the image into memory */
1370 f = fopen(path, "rb");
1372 barf("loadObj: can't read `%s'", path);
1374 # if defined(mingw32_HOST_OS)
1375 // TODO: We would like to use allocateExec here, but allocateExec
1376 // cannot currently allocate blocks large enough.
1377 oc->image = VirtualAlloc(NULL, oc->fileSize, MEM_RESERVE | MEM_COMMIT,
1378 PAGE_EXECUTE_READWRITE);
1379 # elif defined(darwin_HOST_OS)
1380 // In a Mach-O .o file, all sections can and will be misaligned
1381 // if the total size of the headers is not a multiple of the
1382 // desired alignment. This is fine for .o files that only serve
1383 // as input for the static linker, but it's not fine for us,
1384 // as SSE (used by gcc for floating point) and Altivec require
1385 // 16-byte alignment.
1386 // We calculate the correct alignment from the header before
1387 // reading the file, and then we misalign oc->image on purpose so
1388 // that the actual sections end up aligned again.
1389 oc->misalignment = machoGetMisalignment(f);
1390 oc->image = stgMallocBytes(oc->fileSize + oc->misalignment, "loadObj(image)");
1391 oc->image += oc->misalignment;
1393 oc->image = stgMallocBytes(oc->fileSize, "loadObj(image)");
1396 n = fread ( oc->image, 1, oc->fileSize, f );
1397 if (n != oc->fileSize)
1398 barf("loadObj: error whilst reading `%s'", path);
1401 #endif /* USE_MMAP */
1403 # if defined(OBJFORMAT_MACHO) && (defined(powerpc_HOST_ARCH) || defined(x86_64_HOST_ARCH))
1404 r = ocAllocateSymbolExtras_MachO ( oc );
1405 if (!r) { return r; }
1406 # elif defined(OBJFORMAT_ELF) && (defined(powerpc_HOST_ARCH) || defined(x86_64_HOST_ARCH))
1407 r = ocAllocateSymbolExtras_ELF ( oc );
1408 if (!r) { return r; }
1411 /* verify the in-memory image */
1412 # if defined(OBJFORMAT_ELF)
1413 r = ocVerifyImage_ELF ( oc );
1414 # elif defined(OBJFORMAT_PEi386)
1415 r = ocVerifyImage_PEi386 ( oc );
1416 # elif defined(OBJFORMAT_MACHO)
1417 r = ocVerifyImage_MachO ( oc );
1419 barf("loadObj: no verify method");
1421 if (!r) { return r; }
1423 /* build the symbol list for this image */
1424 # if defined(OBJFORMAT_ELF)
1425 r = ocGetNames_ELF ( oc );
1426 # elif defined(OBJFORMAT_PEi386)
1427 r = ocGetNames_PEi386 ( oc );
1428 # elif defined(OBJFORMAT_MACHO)
1429 r = ocGetNames_MachO ( oc );
1431 barf("loadObj: no getNames method");
1433 if (!r) { return r; }
1435 /* loaded, but not resolved yet */
1436 oc->status = OBJECT_LOADED;
1441 /* -----------------------------------------------------------------------------
1442 * resolve all the currently unlinked objects in memory
1444 * Returns: 1 if ok, 0 on error.
1454 for (oc = objects; oc; oc = oc->next) {
1455 if (oc->status != OBJECT_RESOLVED) {
1456 # if defined(OBJFORMAT_ELF)
1457 r = ocResolve_ELF ( oc );
1458 # elif defined(OBJFORMAT_PEi386)
1459 r = ocResolve_PEi386 ( oc );
1460 # elif defined(OBJFORMAT_MACHO)
1461 r = ocResolve_MachO ( oc );
1463 barf("resolveObjs: not implemented on this platform");
1465 if (!r) { return r; }
1466 oc->status = OBJECT_RESOLVED;
1472 /* -----------------------------------------------------------------------------
1473 * delete an object from the pool
1476 unloadObj( char *path )
1478 ObjectCode *oc, *prev;
1480 ASSERT(symhash != NULL);
1481 ASSERT(objects != NULL);
1486 for (oc = objects; oc; prev = oc, oc = oc->next) {
1487 if (!strcmp(oc->fileName,path)) {
1489 /* Remove all the mappings for the symbols within this
1494 for (i = 0; i < oc->n_symbols; i++) {
1495 if (oc->symbols[i] != NULL) {
1496 removeStrHashTable(symhash, oc->symbols[i], NULL);
1504 prev->next = oc->next;
1507 // We're going to leave this in place, in case there are
1508 // any pointers from the heap into it:
1509 // #ifdef mingw32_HOST_OS
1510 // VirtualFree(oc->image);
1512 // stgFree(oc->image);
1514 stgFree(oc->fileName);
1515 stgFree(oc->symbols);
1516 stgFree(oc->sections);
1517 /* The local hash table should have been freed at the end
1518 of the ocResolve_ call on it. */
1519 ASSERT(oc->lochash == NULL);
1525 errorBelch("unloadObj: can't find `%s' to unload", path);
1529 /* -----------------------------------------------------------------------------
1530 * Sanity checking. For each ObjectCode, maintain a list of address ranges
1531 * which may be prodded during relocation, and abort if we try and write
1532 * outside any of these.
1534 static void addProddableBlock ( ObjectCode* oc, void* start, int size )
1537 = stgMallocBytes(sizeof(ProddableBlock), "addProddableBlock");
1538 /* debugBelch("aPB %p %p %d\n", oc, start, size); */
1542 pb->next = oc->proddables;
1543 oc->proddables = pb;
1546 static void checkProddableBlock ( ObjectCode* oc, void* addr )
1549 for (pb = oc->proddables; pb != NULL; pb = pb->next) {
1550 char* s = (char*)(pb->start);
1551 char* e = s + pb->size - 1;
1552 char* a = (char*)addr;
1553 /* Assumes that the biggest fixup involves a 4-byte write. This
1554 probably needs to be changed to 8 (ie, +7) on 64-bit
1556 if (a >= s && (a+3) <= e) return;
1558 barf("checkProddableBlock: invalid fixup in runtime linker");
1561 /* -----------------------------------------------------------------------------
1562 * Section management.
1564 static void addSection ( ObjectCode* oc, SectionKind kind,
1565 void* start, void* end )
1567 Section* s = stgMallocBytes(sizeof(Section), "addSection");
1571 s->next = oc->sections;
1574 debugBelch("addSection: %p-%p (size %d), kind %d\n",
1575 start, ((char*)end)-1, end - start + 1, kind );
1580 /* --------------------------------------------------------------------------
1582 * This is about allocating a small chunk of memory for every symbol in the
1583 * object file. We make sure that the SymboLExtras are always "in range" of
1584 * limited-range PC-relative instructions on various platforms by allocating
1585 * them right next to the object code itself.
1588 #if defined(powerpc_HOST_ARCH) || defined(x86_64_HOST_ARCH)
1591 ocAllocateSymbolExtras
1593 Allocate additional space at the end of the object file image to make room
1594 for jump islands (powerpc, x86_64) and GOT entries (x86_64).
1596 PowerPC relative branch instructions have a 24 bit displacement field.
1597 As PPC code is always 4-byte-aligned, this yields a +-32MB range.
1598 If a particular imported symbol is outside this range, we have to redirect
1599 the jump to a short piece of new code that just loads the 32bit absolute
1600 address and jumps there.
1601 On x86_64, PC-relative jumps and PC-relative accesses to the GOT are limited
1604 This function just allocates space for one SymbolExtra for every
1605 undefined symbol in the object file. The code for the jump islands is
1606 filled in by makeSymbolExtra below.
1609 static int ocAllocateSymbolExtras( ObjectCode* oc, int count, int first )
1616 int misalignment = 0;
1617 #ifdef darwin_HOST_OS
1618 misalignment = oc->misalignment;
1624 // round up to the nearest 4
1625 aligned = (oc->fileSize + 3) & ~3;
1628 #ifndef linux_HOST_OS /* mremap is a linux extension */
1629 #error ocAllocateSymbolExtras doesnt want USE_MMAP to be defined
1632 pagesize = getpagesize();
1633 n = ROUND_UP( oc->fileSize, pagesize );
1634 m = ROUND_UP( aligned + sizeof (SymbolExtra) * count, pagesize );
1636 /* If we have a half-page-size file and map one page of it then
1637 * the part of the page after the size of the file remains accessible.
1638 * If, however, we map in 2 pages, the 2nd page is not accessible
1639 * and will give a "Bus Error" on access. To get around this, we check
1640 * if we need any extra pages for the jump islands and map them in
1641 * anonymously. We must check that we actually require extra pages
1642 * otherwise the attempt to mmap 0 pages of anonymous memory will
1648 /* The effect of this mremap() call is only the ensure that we have
1649 * a sufficient number of virtually contiguous pages. As returned from
1650 * mremap, the pages past the end of the file are not backed. We give
1651 * them a backing by using MAP_FIXED to map in anonymous pages.
1653 oc->image = mremap( oc->image, n, m, MREMAP_MAYMOVE );
1655 if( oc->image == MAP_FAILED )
1657 errorBelch( "Unable to mremap for Jump Islands\n" );
1661 if( mmap( oc->image + n, m - n, PROT_READ | PROT_WRITE | PROT_EXEC,
1662 MAP_PRIVATE | MAP_ANONYMOUS | MAP_FIXED, 0, 0 ) == MAP_FAILED )
1664 errorBelch( "Unable to mmap( MAP_FIXED ) for Jump Islands\n" );
1670 oc->image -= misalignment;
1671 oc->image = stgReallocBytes( oc->image,
1673 aligned + sizeof (SymbolExtra) * count,
1674 "ocAllocateSymbolExtras" );
1675 oc->image += misalignment;
1676 #endif /* USE_MMAP */
1678 oc->symbol_extras = (SymbolExtra *) (oc->image + aligned);
1679 memset( oc->symbol_extras, 0, sizeof (SymbolExtra) * count );
1682 oc->symbol_extras = NULL;
1684 oc->first_symbol_extra = first;
1685 oc->n_symbol_extras = count;
1690 static SymbolExtra* makeSymbolExtra( ObjectCode* oc,
1691 unsigned long symbolNumber,
1692 unsigned long target )
1696 ASSERT( symbolNumber >= oc->first_symbol_extra
1697 && symbolNumber - oc->first_symbol_extra < oc->n_symbol_extras);
1699 extra = &oc->symbol_extras[symbolNumber - oc->first_symbol_extra];
1701 #ifdef powerpc_HOST_ARCH
1702 // lis r12, hi16(target)
1703 extra->jumpIsland.lis_r12 = 0x3d80;
1704 extra->jumpIsland.hi_addr = target >> 16;
1706 // ori r12, r12, lo16(target)
1707 extra->jumpIsland.ori_r12_r12 = 0x618c;
1708 extra->jumpIsland.lo_addr = target & 0xffff;
1711 extra->jumpIsland.mtctr_r12 = 0x7d8903a6;
1714 extra->jumpIsland.bctr = 0x4e800420;
1716 #ifdef x86_64_HOST_ARCH
1718 static uint8_t jmp[] = { 0xFF, 0x25, 0xF2, 0xFF, 0xFF, 0xFF };
1719 extra->addr = target;
1720 memcpy(extra->jumpIsland, jmp, 6);
1728 /* --------------------------------------------------------------------------
1729 * PowerPC specifics (instruction cache flushing)
1730 * ------------------------------------------------------------------------*/
1732 #ifdef powerpc_TARGET_ARCH
1734 ocFlushInstructionCache
1736 Flush the data & instruction caches.
1737 Because the PPC has split data/instruction caches, we have to
1738 do that whenever we modify code at runtime.
1741 static void ocFlushInstructionCache( ObjectCode *oc )
1743 int n = (oc->fileSize + sizeof( SymbolExtra ) * oc->n_symbol_extras + 3) / 4;
1744 unsigned long *p = (unsigned long *) oc->image;
1748 __asm__ volatile ( "dcbf 0,%0\n\t"
1756 __asm__ volatile ( "sync\n\t"
1762 /* --------------------------------------------------------------------------
1763 * PEi386 specifics (Win32 targets)
1764 * ------------------------------------------------------------------------*/
1766 /* The information for this linker comes from
1767 Microsoft Portable Executable
1768 and Common Object File Format Specification
1769 revision 5.1 January 1998
1770 which SimonM says comes from the MS Developer Network CDs.
1772 It can be found there (on older CDs), but can also be found
1775 http://www.microsoft.com/hwdev/hardware/PECOFF.asp
1777 (this is Rev 6.0 from February 1999).
1779 Things move, so if that fails, try searching for it via
1781 http://www.google.com/search?q=PE+COFF+specification
1783 The ultimate reference for the PE format is the Winnt.h
1784 header file that comes with the Platform SDKs; as always,
1785 implementations will drift wrt their documentation.
1787 A good background article on the PE format is Matt Pietrek's
1788 March 1994 article in Microsoft System Journal (MSJ)
1789 (Vol.9, No. 3): "Peering Inside the PE: A Tour of the
1790 Win32 Portable Executable File Format." The info in there
1791 has recently been updated in a two part article in
1792 MSDN magazine, issues Feb and March 2002,
1793 "Inside Windows: An In-Depth Look into the Win32 Portable
1794 Executable File Format"
1796 John Levine's book "Linkers and Loaders" contains useful
1801 #if defined(OBJFORMAT_PEi386)
1805 typedef unsigned char UChar;
1806 typedef unsigned short UInt16;
1807 typedef unsigned int UInt32;
1814 UInt16 NumberOfSections;
1815 UInt32 TimeDateStamp;
1816 UInt32 PointerToSymbolTable;
1817 UInt32 NumberOfSymbols;
1818 UInt16 SizeOfOptionalHeader;
1819 UInt16 Characteristics;
1823 #define sizeof_COFF_header 20
1830 UInt32 VirtualAddress;
1831 UInt32 SizeOfRawData;
1832 UInt32 PointerToRawData;
1833 UInt32 PointerToRelocations;
1834 UInt32 PointerToLinenumbers;
1835 UInt16 NumberOfRelocations;
1836 UInt16 NumberOfLineNumbers;
1837 UInt32 Characteristics;
1841 #define sizeof_COFF_section 40
1848 UInt16 SectionNumber;
1851 UChar NumberOfAuxSymbols;
1855 #define sizeof_COFF_symbol 18
1860 UInt32 VirtualAddress;
1861 UInt32 SymbolTableIndex;
1866 #define sizeof_COFF_reloc 10
1869 /* From PE spec doc, section 3.3.2 */
1870 /* Note use of MYIMAGE_* since IMAGE_* are already defined in
1871 windows.h -- for the same purpose, but I want to know what I'm
1873 #define MYIMAGE_FILE_RELOCS_STRIPPED 0x0001
1874 #define MYIMAGE_FILE_EXECUTABLE_IMAGE 0x0002
1875 #define MYIMAGE_FILE_DLL 0x2000
1876 #define MYIMAGE_FILE_SYSTEM 0x1000
1877 #define MYIMAGE_FILE_BYTES_REVERSED_HI 0x8000
1878 #define MYIMAGE_FILE_BYTES_REVERSED_LO 0x0080
1879 #define MYIMAGE_FILE_32BIT_MACHINE 0x0100
1881 /* From PE spec doc, section 5.4.2 and 5.4.4 */
1882 #define MYIMAGE_SYM_CLASS_EXTERNAL 2
1883 #define MYIMAGE_SYM_CLASS_STATIC 3
1884 #define MYIMAGE_SYM_UNDEFINED 0
1886 /* From PE spec doc, section 4.1 */
1887 #define MYIMAGE_SCN_CNT_CODE 0x00000020
1888 #define MYIMAGE_SCN_CNT_INITIALIZED_DATA 0x00000040
1889 #define MYIMAGE_SCN_LNK_NRELOC_OVFL 0x01000000
1891 /* From PE spec doc, section 5.2.1 */
1892 #define MYIMAGE_REL_I386_DIR32 0x0006
1893 #define MYIMAGE_REL_I386_REL32 0x0014
1896 /* We use myindex to calculate array addresses, rather than
1897 simply doing the normal subscript thing. That's because
1898 some of the above structs have sizes which are not
1899 a whole number of words. GCC rounds their sizes up to a
1900 whole number of words, which means that the address calcs
1901 arising from using normal C indexing or pointer arithmetic
1902 are just plain wrong. Sigh.
1905 myindex ( int scale, void* base, int index )
1908 ((UChar*)base) + scale * index;
1913 printName ( UChar* name, UChar* strtab )
1915 if (name[0]==0 && name[1]==0 && name[2]==0 && name[3]==0) {
1916 UInt32 strtab_offset = * (UInt32*)(name+4);
1917 debugBelch("%s", strtab + strtab_offset );
1920 for (i = 0; i < 8; i++) {
1921 if (name[i] == 0) break;
1922 debugBelch("%c", name[i] );
1929 copyName ( UChar* name, UChar* strtab, UChar* dst, int dstSize )
1931 if (name[0]==0 && name[1]==0 && name[2]==0 && name[3]==0) {
1932 UInt32 strtab_offset = * (UInt32*)(name+4);
1933 strncpy ( dst, strtab+strtab_offset, dstSize );
1939 if (name[i] == 0) break;
1949 cstring_from_COFF_symbol_name ( UChar* name, UChar* strtab )
1952 /* If the string is longer than 8 bytes, look in the
1953 string table for it -- this will be correctly zero terminated.
1955 if (name[0]==0 && name[1]==0 && name[2]==0 && name[3]==0) {
1956 UInt32 strtab_offset = * (UInt32*)(name+4);
1957 return ((UChar*)strtab) + strtab_offset;
1959 /* Otherwise, if shorter than 8 bytes, return the original,
1960 which by defn is correctly terminated.
1962 if (name[7]==0) return name;
1963 /* The annoying case: 8 bytes. Copy into a temporary
1964 (which is never freed ...)
1966 newstr = stgMallocBytes(9, "cstring_from_COFF_symbol_name");
1968 strncpy(newstr,name,8);
1974 /* Just compares the short names (first 8 chars) */
1975 static COFF_section *
1976 findPEi386SectionCalled ( ObjectCode* oc, char* name )
1980 = (COFF_header*)(oc->image);
1981 COFF_section* sectab
1983 ((UChar*)(oc->image))
1984 + sizeof_COFF_header + hdr->SizeOfOptionalHeader
1986 for (i = 0; i < hdr->NumberOfSections; i++) {
1989 COFF_section* section_i
1991 myindex ( sizeof_COFF_section, sectab, i );
1992 n1 = (UChar*) &(section_i->Name);
1994 if (n1[0]==n2[0] && n1[1]==n2[1] && n1[2]==n2[2] &&
1995 n1[3]==n2[3] && n1[4]==n2[4] && n1[5]==n2[5] &&
1996 n1[6]==n2[6] && n1[7]==n2[7])
2005 zapTrailingAtSign ( UChar* sym )
2007 # define my_isdigit(c) ((c) >= '0' && (c) <= '9')
2009 if (sym[0] == 0) return;
2011 while (sym[i] != 0) i++;
2014 while (j > 0 && my_isdigit(sym[j])) j--;
2015 if (j > 0 && sym[j] == '@' && j != i) sym[j] = 0;
2021 ocVerifyImage_PEi386 ( ObjectCode* oc )
2026 COFF_section* sectab;
2027 COFF_symbol* symtab;
2029 /* debugBelch("\nLOADING %s\n", oc->fileName); */
2030 hdr = (COFF_header*)(oc->image);
2031 sectab = (COFF_section*) (
2032 ((UChar*)(oc->image))
2033 + sizeof_COFF_header + hdr->SizeOfOptionalHeader
2035 symtab = (COFF_symbol*) (
2036 ((UChar*)(oc->image))
2037 + hdr->PointerToSymbolTable
2039 strtab = ((UChar*)symtab)
2040 + hdr->NumberOfSymbols * sizeof_COFF_symbol;
2042 if (hdr->Machine != 0x14c) {
2043 errorBelch("%s: Not x86 PEi386", oc->fileName);
2046 if (hdr->SizeOfOptionalHeader != 0) {
2047 errorBelch("%s: PEi386 with nonempty optional header", oc->fileName);
2050 if ( /* (hdr->Characteristics & MYIMAGE_FILE_RELOCS_STRIPPED) || */
2051 (hdr->Characteristics & MYIMAGE_FILE_EXECUTABLE_IMAGE) ||
2052 (hdr->Characteristics & MYIMAGE_FILE_DLL) ||
2053 (hdr->Characteristics & MYIMAGE_FILE_SYSTEM) ) {
2054 errorBelch("%s: Not a PEi386 object file", oc->fileName);
2057 if ( (hdr->Characteristics & MYIMAGE_FILE_BYTES_REVERSED_HI)
2058 /* || !(hdr->Characteristics & MYIMAGE_FILE_32BIT_MACHINE) */ ) {
2059 errorBelch("%s: Invalid PEi386 word size or endiannness: %d",
2061 (int)(hdr->Characteristics));
2064 /* If the string table size is way crazy, this might indicate that
2065 there are more than 64k relocations, despite claims to the
2066 contrary. Hence this test. */
2067 /* debugBelch("strtab size %d\n", * (UInt32*)strtab); */
2069 if ( (*(UInt32*)strtab) > 600000 ) {
2070 /* Note that 600k has no special significance other than being
2071 big enough to handle the almost-2MB-sized lumps that
2072 constitute HSwin32*.o. */
2073 debugBelch("PEi386 object has suspiciously large string table; > 64k relocs?");
2078 /* No further verification after this point; only debug printing. */
2080 IF_DEBUG(linker, i=1);
2081 if (i == 0) return 1;
2083 debugBelch( "sectab offset = %d\n", ((UChar*)sectab) - ((UChar*)hdr) );
2084 debugBelch( "symtab offset = %d\n", ((UChar*)symtab) - ((UChar*)hdr) );
2085 debugBelch( "strtab offset = %d\n", ((UChar*)strtab) - ((UChar*)hdr) );
2088 debugBelch( "Machine: 0x%x\n", (UInt32)(hdr->Machine) );
2089 debugBelch( "# sections: %d\n", (UInt32)(hdr->NumberOfSections) );
2090 debugBelch( "time/date: 0x%x\n", (UInt32)(hdr->TimeDateStamp) );
2091 debugBelch( "symtab offset: %d\n", (UInt32)(hdr->PointerToSymbolTable) );
2092 debugBelch( "# symbols: %d\n", (UInt32)(hdr->NumberOfSymbols) );
2093 debugBelch( "sz of opt hdr: %d\n", (UInt32)(hdr->SizeOfOptionalHeader) );
2094 debugBelch( "characteristics: 0x%x\n", (UInt32)(hdr->Characteristics) );
2096 /* Print the section table. */
2098 for (i = 0; i < hdr->NumberOfSections; i++) {
2100 COFF_section* sectab_i
2102 myindex ( sizeof_COFF_section, sectab, i );
2109 printName ( sectab_i->Name, strtab );
2119 sectab_i->VirtualSize,
2120 sectab_i->VirtualAddress,
2121 sectab_i->SizeOfRawData,
2122 sectab_i->PointerToRawData,
2123 sectab_i->NumberOfRelocations,
2124 sectab_i->PointerToRelocations,
2125 sectab_i->PointerToRawData
2127 reltab = (COFF_reloc*) (
2128 ((UChar*)(oc->image)) + sectab_i->PointerToRelocations
2131 if ( sectab_i->Characteristics & MYIMAGE_SCN_LNK_NRELOC_OVFL ) {
2132 /* If the relocation field (a short) has overflowed, the
2133 * real count can be found in the first reloc entry.
2135 * See Section 4.1 (last para) of the PE spec (rev6.0).
2137 COFF_reloc* rel = (COFF_reloc*)
2138 myindex ( sizeof_COFF_reloc, reltab, 0 );
2139 noRelocs = rel->VirtualAddress;
2142 noRelocs = sectab_i->NumberOfRelocations;
2146 for (; j < noRelocs; j++) {
2148 COFF_reloc* rel = (COFF_reloc*)
2149 myindex ( sizeof_COFF_reloc, reltab, j );
2151 " type 0x%-4x vaddr 0x%-8x name `",
2153 rel->VirtualAddress );
2154 sym = (COFF_symbol*)
2155 myindex ( sizeof_COFF_symbol, symtab, rel->SymbolTableIndex );
2156 /* Hmm..mysterious looking offset - what's it for? SOF */
2157 printName ( sym->Name, strtab -10 );
2164 debugBelch("string table has size 0x%x\n", * (UInt32*)strtab );
2165 debugBelch("---START of string table---\n");
2166 for (i = 4; i < *(Int32*)strtab; i++) {
2168 debugBelch("\n"); else
2169 debugBelch("%c", strtab[i] );
2171 debugBelch("--- END of string table---\n");
2176 COFF_symbol* symtab_i;
2177 if (i >= (Int32)(hdr->NumberOfSymbols)) break;
2178 symtab_i = (COFF_symbol*)
2179 myindex ( sizeof_COFF_symbol, symtab, i );
2185 printName ( symtab_i->Name, strtab );
2194 (Int32)(symtab_i->SectionNumber),
2195 (UInt32)symtab_i->Type,
2196 (UInt32)symtab_i->StorageClass,
2197 (UInt32)symtab_i->NumberOfAuxSymbols
2199 i += symtab_i->NumberOfAuxSymbols;
2209 ocGetNames_PEi386 ( ObjectCode* oc )
2212 COFF_section* sectab;
2213 COFF_symbol* symtab;
2220 hdr = (COFF_header*)(oc->image);
2221 sectab = (COFF_section*) (
2222 ((UChar*)(oc->image))
2223 + sizeof_COFF_header + hdr->SizeOfOptionalHeader
2225 symtab = (COFF_symbol*) (
2226 ((UChar*)(oc->image))
2227 + hdr->PointerToSymbolTable
2229 strtab = ((UChar*)(oc->image))
2230 + hdr->PointerToSymbolTable
2231 + hdr->NumberOfSymbols * sizeof_COFF_symbol;
2233 /* Allocate space for any (local, anonymous) .bss sections. */
2235 for (i = 0; i < hdr->NumberOfSections; i++) {
2238 COFF_section* sectab_i
2240 myindex ( sizeof_COFF_section, sectab, i );
2241 if (0 != strcmp(sectab_i->Name, ".bss")) continue;
2242 /* sof 10/05: the PE spec text isn't too clear regarding what
2243 * the SizeOfRawData field is supposed to hold for object
2244 * file sections containing just uninitialized data -- for executables,
2245 * it is supposed to be zero; unclear what it's supposed to be
2246 * for object files. However, VirtualSize is guaranteed to be
2247 * zero for object files, which definitely suggests that SizeOfRawData
2248 * will be non-zero (where else would the size of this .bss section be
2249 * stored?) Looking at the COFF_section info for incoming object files,
2250 * this certainly appears to be the case.
2252 * => I suspect we've been incorrectly handling .bss sections in (relocatable)
2253 * object files up until now. This turned out to bite us with ghc-6.4.1's use
2254 * of gcc-3.4.x, which has started to emit initially-zeroed-out local 'static'
2255 * variable decls into to the .bss section. (The specific function in Q which
2256 * triggered this is libraries/base/cbits/dirUtils.c:__hscore_getFolderPath())
2258 if (sectab_i->VirtualSize == 0 && sectab_i->SizeOfRawData == 0) continue;
2259 /* This is a non-empty .bss section. Allocate zeroed space for
2260 it, and set its PointerToRawData field such that oc->image +
2261 PointerToRawData == addr_of_zeroed_space. */
2262 bss_sz = sectab_i->VirtualSize;
2263 if ( bss_sz < sectab_i->SizeOfRawData) { bss_sz = sectab_i->SizeOfRawData; }
2264 zspace = stgCallocBytes(1, bss_sz, "ocGetNames_PEi386(anonymous bss)");
2265 sectab_i->PointerToRawData = ((UChar*)zspace) - ((UChar*)(oc->image));
2266 addProddableBlock(oc, zspace, bss_sz);
2267 /* debugBelch("BSS anon section at 0x%x\n", zspace); */
2270 /* Copy section information into the ObjectCode. */
2272 for (i = 0; i < hdr->NumberOfSections; i++) {
2278 = SECTIONKIND_OTHER;
2279 COFF_section* sectab_i
2281 myindex ( sizeof_COFF_section, sectab, i );
2282 IF_DEBUG(linker, debugBelch("section name = %s\n", sectab_i->Name ));
2285 /* I'm sure this is the Right Way to do it. However, the
2286 alternative of testing the sectab_i->Name field seems to
2287 work ok with Cygwin.
2289 if (sectab_i->Characteristics & MYIMAGE_SCN_CNT_CODE ||
2290 sectab_i->Characteristics & MYIMAGE_SCN_CNT_INITIALIZED_DATA)
2291 kind = SECTIONKIND_CODE_OR_RODATA;
2294 if (0==strcmp(".text",sectab_i->Name) ||
2295 0==strcmp(".rdata",sectab_i->Name)||
2296 0==strcmp(".rodata",sectab_i->Name))
2297 kind = SECTIONKIND_CODE_OR_RODATA;
2298 if (0==strcmp(".data",sectab_i->Name) ||
2299 0==strcmp(".bss",sectab_i->Name))
2300 kind = SECTIONKIND_RWDATA;
2302 ASSERT(sectab_i->SizeOfRawData == 0 || sectab_i->VirtualSize == 0);
2303 sz = sectab_i->SizeOfRawData;
2304 if (sz < sectab_i->VirtualSize) sz = sectab_i->VirtualSize;
2306 start = ((UChar*)(oc->image)) + sectab_i->PointerToRawData;
2307 end = start + sz - 1;
2309 if (kind == SECTIONKIND_OTHER
2310 /* Ignore sections called which contain stabs debugging
2312 && 0 != strcmp(".stab", sectab_i->Name)
2313 && 0 != strcmp(".stabstr", sectab_i->Name)
2314 /* ignore constructor section for now */
2315 && 0 != strcmp(".ctors", sectab_i->Name)
2316 /* ignore section generated from .ident */
2317 && 0!= strcmp("/4", sectab_i->Name)
2318 /* ignore unknown section that appeared in gcc 3.4.5(?) */
2319 && 0!= strcmp(".reloc", sectab_i->Name)
2321 errorBelch("Unknown PEi386 section name `%s' (while processing: %s)", sectab_i->Name, oc->fileName);
2325 if (kind != SECTIONKIND_OTHER && end >= start) {
2326 addSection(oc, kind, start, end);
2327 addProddableBlock(oc, start, end - start + 1);
2331 /* Copy exported symbols into the ObjectCode. */
2333 oc->n_symbols = hdr->NumberOfSymbols;
2334 oc->symbols = stgMallocBytes(oc->n_symbols * sizeof(char*),
2335 "ocGetNames_PEi386(oc->symbols)");
2336 /* Call me paranoid; I don't care. */
2337 for (i = 0; i < oc->n_symbols; i++)
2338 oc->symbols[i] = NULL;
2342 COFF_symbol* symtab_i;
2343 if (i >= (Int32)(hdr->NumberOfSymbols)) break;
2344 symtab_i = (COFF_symbol*)
2345 myindex ( sizeof_COFF_symbol, symtab, i );
2349 if (symtab_i->StorageClass == MYIMAGE_SYM_CLASS_EXTERNAL
2350 && symtab_i->SectionNumber != MYIMAGE_SYM_UNDEFINED) {
2351 /* This symbol is global and defined, viz, exported */
2352 /* for MYIMAGE_SYMCLASS_EXTERNAL
2353 && !MYIMAGE_SYM_UNDEFINED,
2354 the address of the symbol is:
2355 address of relevant section + offset in section
2357 COFF_section* sectabent
2358 = (COFF_section*) myindex ( sizeof_COFF_section,
2360 symtab_i->SectionNumber-1 );
2361 addr = ((UChar*)(oc->image))
2362 + (sectabent->PointerToRawData
2366 if (symtab_i->SectionNumber == MYIMAGE_SYM_UNDEFINED
2367 && symtab_i->Value > 0) {
2368 /* This symbol isn't in any section at all, ie, global bss.
2369 Allocate zeroed space for it. */
2370 addr = stgCallocBytes(1, symtab_i->Value,
2371 "ocGetNames_PEi386(non-anonymous bss)");
2372 addSection(oc, SECTIONKIND_RWDATA, addr,
2373 ((UChar*)addr) + symtab_i->Value - 1);
2374 addProddableBlock(oc, addr, symtab_i->Value);
2375 /* debugBelch("BSS section at 0x%x\n", addr); */
2378 if (addr != NULL ) {
2379 sname = cstring_from_COFF_symbol_name ( symtab_i->Name, strtab );
2380 /* debugBelch("addSymbol %p `%s \n", addr,sname); */
2381 IF_DEBUG(linker, debugBelch("addSymbol %p `%s'\n", addr,sname);)
2382 ASSERT(i >= 0 && i < oc->n_symbols);
2383 /* cstring_from_COFF_symbol_name always succeeds. */
2384 oc->symbols[i] = sname;
2385 ghciInsertStrHashTable(oc->fileName, symhash, sname, addr);
2389 "IGNORING symbol %d\n"
2393 printName ( symtab_i->Name, strtab );
2402 (Int32)(symtab_i->SectionNumber),
2403 (UInt32)symtab_i->Type,
2404 (UInt32)symtab_i->StorageClass,
2405 (UInt32)symtab_i->NumberOfAuxSymbols
2410 i += symtab_i->NumberOfAuxSymbols;
2419 ocResolve_PEi386 ( ObjectCode* oc )
2422 COFF_section* sectab;
2423 COFF_symbol* symtab;
2433 /* ToDo: should be variable-sized? But is at least safe in the
2434 sense of buffer-overrun-proof. */
2436 /* debugBelch("resolving for %s\n", oc->fileName); */
2438 hdr = (COFF_header*)(oc->image);
2439 sectab = (COFF_section*) (
2440 ((UChar*)(oc->image))
2441 + sizeof_COFF_header + hdr->SizeOfOptionalHeader
2443 symtab = (COFF_symbol*) (
2444 ((UChar*)(oc->image))
2445 + hdr->PointerToSymbolTable
2447 strtab = ((UChar*)(oc->image))
2448 + hdr->PointerToSymbolTable
2449 + hdr->NumberOfSymbols * sizeof_COFF_symbol;
2451 for (i = 0; i < hdr->NumberOfSections; i++) {
2452 COFF_section* sectab_i
2454 myindex ( sizeof_COFF_section, sectab, i );
2457 ((UChar*)(oc->image)) + sectab_i->PointerToRelocations
2460 /* Ignore sections called which contain stabs debugging
2462 if (0 == strcmp(".stab", sectab_i->Name)
2463 || 0 == strcmp(".stabstr", sectab_i->Name)
2464 || 0 == strcmp(".ctors", sectab_i->Name))
2467 if ( sectab_i->Characteristics & MYIMAGE_SCN_LNK_NRELOC_OVFL ) {
2468 /* If the relocation field (a short) has overflowed, the
2469 * real count can be found in the first reloc entry.
2471 * See Section 4.1 (last para) of the PE spec (rev6.0).
2473 * Nov2003 update: the GNU linker still doesn't correctly
2474 * handle the generation of relocatable object files with
2475 * overflown relocations. Hence the output to warn of potential
2478 COFF_reloc* rel = (COFF_reloc*)
2479 myindex ( sizeof_COFF_reloc, reltab, 0 );
2480 noRelocs = rel->VirtualAddress;
2482 /* 10/05: we now assume (and check for) a GNU ld that is capable
2483 * of handling object files with (>2^16) of relocs.
2486 debugBelch("WARNING: Overflown relocation field (# relocs found: %u)\n",
2491 noRelocs = sectab_i->NumberOfRelocations;
2496 for (; j < noRelocs; j++) {
2498 COFF_reloc* reltab_j
2500 myindex ( sizeof_COFF_reloc, reltab, j );
2502 /* the location to patch */
2504 ((UChar*)(oc->image))
2505 + (sectab_i->PointerToRawData
2506 + reltab_j->VirtualAddress
2507 - sectab_i->VirtualAddress )
2509 /* the existing contents of pP */
2511 /* the symbol to connect to */
2512 sym = (COFF_symbol*)
2513 myindex ( sizeof_COFF_symbol,
2514 symtab, reltab_j->SymbolTableIndex );
2517 "reloc sec %2d num %3d: type 0x%-4x "
2518 "vaddr 0x%-8x name `",
2520 (UInt32)reltab_j->Type,
2521 reltab_j->VirtualAddress );
2522 printName ( sym->Name, strtab );
2523 debugBelch("'\n" ));
2525 if (sym->StorageClass == MYIMAGE_SYM_CLASS_STATIC) {
2526 COFF_section* section_sym
2527 = findPEi386SectionCalled ( oc, sym->Name );
2529 errorBelch("%s: can't find section `%s'", oc->fileName, sym->Name);
2532 S = ((UInt32)(oc->image))
2533 + (section_sym->PointerToRawData
2536 copyName ( sym->Name, strtab, symbol, 1000-1 );
2537 S = (UInt32) lookupLocalSymbol( oc, symbol );
2538 if ((void*)S != NULL) goto foundit;
2539 S = (UInt32) lookupSymbol( symbol );
2540 if ((void*)S != NULL) goto foundit;
2541 zapTrailingAtSign ( symbol );
2542 S = (UInt32) lookupLocalSymbol( oc, symbol );
2543 if ((void*)S != NULL) goto foundit;
2544 S = (UInt32) lookupSymbol( symbol );
2545 if ((void*)S != NULL) goto foundit;
2546 /* Newline first because the interactive linker has printed "linking..." */
2547 errorBelch("\n%s: unknown symbol `%s'", oc->fileName, symbol);
2551 checkProddableBlock(oc, pP);
2552 switch (reltab_j->Type) {
2553 case MYIMAGE_REL_I386_DIR32:
2556 case MYIMAGE_REL_I386_REL32:
2557 /* Tricky. We have to insert a displacement at
2558 pP which, when added to the PC for the _next_
2559 insn, gives the address of the target (S).
2560 Problem is to know the address of the next insn
2561 when we only know pP. We assume that this
2562 literal field is always the last in the insn,
2563 so that the address of the next insn is pP+4
2564 -- hence the constant 4.
2565 Also I don't know if A should be added, but so
2566 far it has always been zero.
2568 SOF 05/2005: 'A' (old contents of *pP) have been observed
2569 to contain values other than zero (the 'wx' object file
2570 that came with wxhaskell-0.9.4; dunno how it was compiled..).
2571 So, add displacement to old value instead of asserting
2572 A to be zero. Fixes wxhaskell-related crashes, and no other
2573 ill effects have been observed.
2575 Update: the reason why we're seeing these more elaborate
2576 relocations is due to a switch in how the NCG compiles SRTs
2577 and offsets to them from info tables. SRTs live in .(ro)data,
2578 while info tables live in .text, causing GAS to emit REL32/DISP32
2579 relocations with non-zero values. Adding the displacement is
2580 the right thing to do.
2582 *pP = S - ((UInt32)pP) - 4 + A;
2585 debugBelch("%s: unhandled PEi386 relocation type %d",
2586 oc->fileName, reltab_j->Type);
2593 IF_DEBUG(linker, debugBelch("completed %s", oc->fileName));
2597 #endif /* defined(OBJFORMAT_PEi386) */
2600 /* --------------------------------------------------------------------------
2602 * ------------------------------------------------------------------------*/
2604 #if defined(OBJFORMAT_ELF)
2609 #if defined(sparc_HOST_ARCH)
2610 # define ELF_TARGET_SPARC /* Used inside <elf.h> */
2611 #elif defined(i386_HOST_ARCH)
2612 # define ELF_TARGET_386 /* Used inside <elf.h> */
2613 #elif defined(x86_64_HOST_ARCH)
2614 # define ELF_TARGET_X64_64
2616 #elif defined (ia64_HOST_ARCH)
2617 # define ELF_TARGET_IA64 /* Used inside <elf.h> */
2619 # define ELF_FUNCTION_DESC /* calling convention uses function descriptors */
2620 # define ELF_NEED_GOT /* needs Global Offset Table */
2621 # define ELF_NEED_PLT /* needs Procedure Linkage Tables */
2624 #if !defined(openbsd_HOST_OS)
2627 /* openbsd elf has things in different places, with diff names */
2628 # include <elf_abi.h>
2629 # include <machine/reloc.h>
2630 # define R_386_32 RELOC_32
2631 # define R_386_PC32 RELOC_PC32
2634 /* If elf.h doesn't define it */
2635 # ifndef R_X86_64_PC64
2636 # define R_X86_64_PC64 24
2640 * Define a set of types which can be used for both ELF32 and ELF64
2644 #define ELFCLASS ELFCLASS64
2645 #define Elf_Addr Elf64_Addr
2646 #define Elf_Word Elf64_Word
2647 #define Elf_Sword Elf64_Sword
2648 #define Elf_Ehdr Elf64_Ehdr
2649 #define Elf_Phdr Elf64_Phdr
2650 #define Elf_Shdr Elf64_Shdr
2651 #define Elf_Sym Elf64_Sym
2652 #define Elf_Rel Elf64_Rel
2653 #define Elf_Rela Elf64_Rela
2654 #define ELF_ST_TYPE ELF64_ST_TYPE
2655 #define ELF_ST_BIND ELF64_ST_BIND
2656 #define ELF_R_TYPE ELF64_R_TYPE
2657 #define ELF_R_SYM ELF64_R_SYM
2659 #define ELFCLASS ELFCLASS32
2660 #define Elf_Addr Elf32_Addr
2661 #define Elf_Word Elf32_Word
2662 #define Elf_Sword Elf32_Sword
2663 #define Elf_Ehdr Elf32_Ehdr
2664 #define Elf_Phdr Elf32_Phdr
2665 #define Elf_Shdr Elf32_Shdr
2666 #define Elf_Sym Elf32_Sym
2667 #define Elf_Rel Elf32_Rel
2668 #define Elf_Rela Elf32_Rela
2670 #define ELF_ST_TYPE ELF32_ST_TYPE
2673 #define ELF_ST_BIND ELF32_ST_BIND
2676 #define ELF_R_TYPE ELF32_R_TYPE
2679 #define ELF_R_SYM ELF32_R_SYM
2685 * Functions to allocate entries in dynamic sections. Currently we simply
2686 * preallocate a large number, and we don't check if a entry for the given
2687 * target already exists (a linear search is too slow). Ideally these
2688 * entries would be associated with symbols.
2691 /* These sizes sufficient to load HSbase + HShaskell98 + a few modules */
2692 #define GOT_SIZE 0x20000
2693 #define FUNCTION_TABLE_SIZE 0x10000
2694 #define PLT_SIZE 0x08000
2697 static Elf_Addr got[GOT_SIZE];
2698 static unsigned int gotIndex;
2699 static Elf_Addr gp_val = (Elf_Addr)got;
2702 allocateGOTEntry(Elf_Addr target)
2706 if (gotIndex >= GOT_SIZE)
2707 barf("Global offset table overflow");
2709 entry = &got[gotIndex++];
2711 return (Elf_Addr)entry;
2715 #ifdef ELF_FUNCTION_DESC
2721 static FunctionDesc functionTable[FUNCTION_TABLE_SIZE];
2722 static unsigned int functionTableIndex;
2725 allocateFunctionDesc(Elf_Addr target)
2727 FunctionDesc *entry;
2729 if (functionTableIndex >= FUNCTION_TABLE_SIZE)
2730 barf("Function table overflow");
2732 entry = &functionTable[functionTableIndex++];
2734 entry->gp = (Elf_Addr)gp_val;
2735 return (Elf_Addr)entry;
2739 copyFunctionDesc(Elf_Addr target)
2741 FunctionDesc *olddesc = (FunctionDesc *)target;
2742 FunctionDesc *newdesc;
2744 newdesc = (FunctionDesc *)allocateFunctionDesc(olddesc->ip);
2745 newdesc->gp = olddesc->gp;
2746 return (Elf_Addr)newdesc;
2751 #ifdef ia64_HOST_ARCH
2752 static void ia64_reloc_gprel22(Elf_Addr target, Elf_Addr value);
2753 static void ia64_reloc_pcrel21(Elf_Addr target, Elf_Addr value, ObjectCode *oc);
2755 static unsigned char plt_code[] =
2757 /* taken from binutils bfd/elfxx-ia64.c */
2758 0x0b, 0x78, 0x00, 0x02, 0x00, 0x24, /* [MMI] addl r15=0,r1;; */
2759 0x00, 0x41, 0x3c, 0x30, 0x28, 0xc0, /* ld8 r16=[r15],8 */
2760 0x01, 0x08, 0x00, 0x84, /* mov r14=r1;; */
2761 0x11, 0x08, 0x00, 0x1e, 0x18, 0x10, /* [MIB] ld8 r1=[r15] */
2762 0x60, 0x80, 0x04, 0x80, 0x03, 0x00, /* mov b6=r16 */
2763 0x60, 0x00, 0x80, 0x00 /* br.few b6;; */
2766 /* If we can't get to the function descriptor via gp, take a local copy of it */
2767 #define PLT_RELOC(code, target) { \
2768 Elf64_Sxword rel_value = target - gp_val; \
2769 if ((rel_value > 0x1fffff) || (rel_value < -0x1fffff)) \
2770 ia64_reloc_gprel22((Elf_Addr)code, copyFunctionDesc(target)); \
2772 ia64_reloc_gprel22((Elf_Addr)code, target); \
2777 unsigned char code[sizeof(plt_code)];
2781 allocatePLTEntry(Elf_Addr target, ObjectCode *oc)
2783 PLTEntry *plt = (PLTEntry *)oc->plt;
2786 if (oc->pltIndex >= PLT_SIZE)
2787 barf("Procedure table overflow");
2789 entry = &plt[oc->pltIndex++];
2790 memcpy(entry->code, plt_code, sizeof(entry->code));
2791 PLT_RELOC(entry->code, target);
2792 return (Elf_Addr)entry;
2798 return (PLT_SIZE * sizeof(PLTEntry));
2804 * Generic ELF functions
2808 findElfSection ( void* objImage, Elf_Word sh_type )
2810 char* ehdrC = (char*)objImage;
2811 Elf_Ehdr* ehdr = (Elf_Ehdr*)ehdrC;
2812 Elf_Shdr* shdr = (Elf_Shdr*)(ehdrC + ehdr->e_shoff);
2813 char* sh_strtab = ehdrC + shdr[ehdr->e_shstrndx].sh_offset;
2817 for (i = 0; i < ehdr->e_shnum; i++) {
2818 if (shdr[i].sh_type == sh_type
2819 /* Ignore the section header's string table. */
2820 && i != ehdr->e_shstrndx
2821 /* Ignore string tables named .stabstr, as they contain
2823 && 0 != memcmp(".stabstr", sh_strtab + shdr[i].sh_name, 8)
2825 ptr = ehdrC + shdr[i].sh_offset;
2832 #if defined(ia64_HOST_ARCH)
2834 findElfSegment ( void* objImage, Elf_Addr vaddr )
2836 char* ehdrC = (char*)objImage;
2837 Elf_Ehdr* ehdr = (Elf_Ehdr*)ehdrC;
2838 Elf_Phdr* phdr = (Elf_Phdr*)(ehdrC + ehdr->e_phoff);
2839 Elf_Addr segaddr = 0;
2842 for (i = 0; i < ehdr->e_phnum; i++) {
2843 segaddr = phdr[i].p_vaddr;
2844 if ((vaddr >= segaddr) && (vaddr < segaddr + phdr[i].p_memsz))
2852 ocVerifyImage_ELF ( ObjectCode* oc )
2856 int i, j, nent, nstrtab, nsymtabs;
2860 char* ehdrC = (char*)(oc->image);
2861 Elf_Ehdr* ehdr = (Elf_Ehdr*)ehdrC;
2863 if (ehdr->e_ident[EI_MAG0] != ELFMAG0 ||
2864 ehdr->e_ident[EI_MAG1] != ELFMAG1 ||
2865 ehdr->e_ident[EI_MAG2] != ELFMAG2 ||
2866 ehdr->e_ident[EI_MAG3] != ELFMAG3) {
2867 errorBelch("%s: not an ELF object", oc->fileName);
2871 if (ehdr->e_ident[EI_CLASS] != ELFCLASS) {
2872 errorBelch("%s: unsupported ELF format", oc->fileName);
2876 if (ehdr->e_ident[EI_DATA] == ELFDATA2LSB) {
2877 IF_DEBUG(linker,debugBelch( "Is little-endian\n" ));
2879 if (ehdr->e_ident[EI_DATA] == ELFDATA2MSB) {
2880 IF_DEBUG(linker,debugBelch( "Is big-endian\n" ));
2882 errorBelch("%s: unknown endiannness", oc->fileName);
2886 if (ehdr->e_type != ET_REL) {
2887 errorBelch("%s: not a relocatable object (.o) file", oc->fileName);
2890 IF_DEBUG(linker, debugBelch( "Is a relocatable object (.o) file\n" ));
2892 IF_DEBUG(linker,debugBelch( "Architecture is " ));
2893 switch (ehdr->e_machine) {
2894 case EM_386: IF_DEBUG(linker,debugBelch( "x86" )); break;
2895 #ifdef EM_SPARC32PLUS
2896 case EM_SPARC32PLUS:
2898 case EM_SPARC: IF_DEBUG(linker,debugBelch( "sparc" )); break;
2900 case EM_IA_64: IF_DEBUG(linker,debugBelch( "ia64" )); break;
2902 case EM_PPC: IF_DEBUG(linker,debugBelch( "powerpc32" )); break;
2904 case EM_X86_64: IF_DEBUG(linker,debugBelch( "x86_64" )); break;
2905 #elif defined(EM_AMD64)
2906 case EM_AMD64: IF_DEBUG(linker,debugBelch( "amd64" )); break;
2908 default: IF_DEBUG(linker,debugBelch( "unknown" ));
2909 errorBelch("%s: unknown architecture (e_machine == %d)"
2910 , oc->fileName, ehdr->e_machine);
2914 IF_DEBUG(linker,debugBelch(
2915 "\nSection header table: start %ld, n_entries %d, ent_size %d\n",
2916 (long)ehdr->e_shoff, ehdr->e_shnum, ehdr->e_shentsize ));
2918 ASSERT (ehdr->e_shentsize == sizeof(Elf_Shdr));
2920 shdr = (Elf_Shdr*) (ehdrC + ehdr->e_shoff);
2922 if (ehdr->e_shstrndx == SHN_UNDEF) {
2923 errorBelch("%s: no section header string table", oc->fileName);
2926 IF_DEBUG(linker,debugBelch( "Section header string table is section %d\n",
2928 sh_strtab = ehdrC + shdr[ehdr->e_shstrndx].sh_offset;
2931 for (i = 0; i < ehdr->e_shnum; i++) {
2932 IF_DEBUG(linker,debugBelch("%2d: ", i ));
2933 IF_DEBUG(linker,debugBelch("type=%2d ", (int)shdr[i].sh_type ));
2934 IF_DEBUG(linker,debugBelch("size=%4d ", (int)shdr[i].sh_size ));
2935 IF_DEBUG(linker,debugBelch("offs=%4d ", (int)shdr[i].sh_offset ));
2936 IF_DEBUG(linker,debugBelch(" (%p .. %p) ",
2937 ehdrC + shdr[i].sh_offset,
2938 ehdrC + shdr[i].sh_offset + shdr[i].sh_size - 1));
2940 if (shdr[i].sh_type == SHT_REL) {
2941 IF_DEBUG(linker,debugBelch("Rel " ));
2942 } else if (shdr[i].sh_type == SHT_RELA) {
2943 IF_DEBUG(linker,debugBelch("RelA " ));
2945 IF_DEBUG(linker,debugBelch(" "));
2948 IF_DEBUG(linker,debugBelch("sname=%s\n", sh_strtab + shdr[i].sh_name ));
2952 IF_DEBUG(linker,debugBelch( "\nString tables" ));
2955 for (i = 0; i < ehdr->e_shnum; i++) {
2956 if (shdr[i].sh_type == SHT_STRTAB
2957 /* Ignore the section header's string table. */
2958 && i != ehdr->e_shstrndx
2959 /* Ignore string tables named .stabstr, as they contain
2961 && 0 != memcmp(".stabstr", sh_strtab + shdr[i].sh_name, 8)
2963 IF_DEBUG(linker,debugBelch(" section %d is a normal string table", i ));
2964 strtab = ehdrC + shdr[i].sh_offset;
2969 errorBelch("%s: no string tables, or too many", oc->fileName);
2974 IF_DEBUG(linker,debugBelch( "\nSymbol tables" ));
2975 for (i = 0; i < ehdr->e_shnum; i++) {
2976 if (shdr[i].sh_type != SHT_SYMTAB) continue;
2977 IF_DEBUG(linker,debugBelch( "section %d is a symbol table\n", i ));
2979 stab = (Elf_Sym*) (ehdrC + shdr[i].sh_offset);
2980 nent = shdr[i].sh_size / sizeof(Elf_Sym);
2981 IF_DEBUG(linker,debugBelch( " number of entries is apparently %d (%ld rem)\n",
2983 (long)shdr[i].sh_size % sizeof(Elf_Sym)
2985 if (0 != shdr[i].sh_size % sizeof(Elf_Sym)) {
2986 errorBelch("%s: non-integral number of symbol table entries", oc->fileName);
2989 for (j = 0; j < nent; j++) {
2990 IF_DEBUG(linker,debugBelch(" %2d ", j ));
2991 IF_DEBUG(linker,debugBelch(" sec=%-5d size=%-3d val=%5p ",
2992 (int)stab[j].st_shndx,
2993 (int)stab[j].st_size,
2994 (char*)stab[j].st_value ));
2996 IF_DEBUG(linker,debugBelch("type=" ));
2997 switch (ELF_ST_TYPE(stab[j].st_info)) {
2998 case STT_NOTYPE: IF_DEBUG(linker,debugBelch("notype " )); break;
2999 case STT_OBJECT: IF_DEBUG(linker,debugBelch("object " )); break;
3000 case STT_FUNC : IF_DEBUG(linker,debugBelch("func " )); break;
3001 case STT_SECTION: IF_DEBUG(linker,debugBelch("section" )); break;
3002 case STT_FILE: IF_DEBUG(linker,debugBelch("file " )); break;
3003 default: IF_DEBUG(linker,debugBelch("? " )); break;
3005 IF_DEBUG(linker,debugBelch(" " ));
3007 IF_DEBUG(linker,debugBelch("bind=" ));
3008 switch (ELF_ST_BIND(stab[j].st_info)) {
3009 case STB_LOCAL : IF_DEBUG(linker,debugBelch("local " )); break;
3010 case STB_GLOBAL: IF_DEBUG(linker,debugBelch("global" )); break;
3011 case STB_WEAK : IF_DEBUG(linker,debugBelch("weak " )); break;
3012 default: IF_DEBUG(linker,debugBelch("? " )); break;
3014 IF_DEBUG(linker,debugBelch(" " ));
3016 IF_DEBUG(linker,debugBelch("name=%s\n", strtab + stab[j].st_name ));
3020 if (nsymtabs == 0) {
3021 errorBelch("%s: didn't find any symbol tables", oc->fileName);
3028 static int getSectionKind_ELF( Elf_Shdr *hdr, int *is_bss )
3032 if (hdr->sh_type == SHT_PROGBITS
3033 && (hdr->sh_flags & SHF_ALLOC) && (hdr->sh_flags & SHF_EXECINSTR)) {
3034 /* .text-style section */
3035 return SECTIONKIND_CODE_OR_RODATA;
3038 if (hdr->sh_type == SHT_PROGBITS
3039 && (hdr->sh_flags & SHF_ALLOC) && (hdr->sh_flags & SHF_WRITE)) {
3040 /* .data-style section */
3041 return SECTIONKIND_RWDATA;
3044 if (hdr->sh_type == SHT_PROGBITS
3045 && (hdr->sh_flags & SHF_ALLOC) && !(hdr->sh_flags & SHF_WRITE)) {
3046 /* .rodata-style section */
3047 return SECTIONKIND_CODE_OR_RODATA;
3050 if (hdr->sh_type == SHT_NOBITS
3051 && (hdr->sh_flags & SHF_ALLOC) && (hdr->sh_flags & SHF_WRITE)) {
3052 /* .bss-style section */
3054 return SECTIONKIND_RWDATA;
3057 return SECTIONKIND_OTHER;
3062 ocGetNames_ELF ( ObjectCode* oc )
3067 char* ehdrC = (char*)(oc->image);
3068 Elf_Ehdr* ehdr = (Elf_Ehdr*)ehdrC;
3069 char* strtab = findElfSection ( ehdrC, SHT_STRTAB );
3070 Elf_Shdr* shdr = (Elf_Shdr*) (ehdrC + ehdr->e_shoff);
3072 ASSERT(symhash != NULL);
3075 errorBelch("%s: no strtab", oc->fileName);
3080 for (i = 0; i < ehdr->e_shnum; i++) {
3081 /* Figure out what kind of section it is. Logic derived from
3082 Figure 1.14 ("Special Sections") of the ELF document
3083 ("Portable Formats Specification, Version 1.1"). */
3085 SectionKind kind = getSectionKind_ELF(&shdr[i], &is_bss);
3087 if (is_bss && shdr[i].sh_size > 0) {
3088 /* This is a non-empty .bss section. Allocate zeroed space for
3089 it, and set its .sh_offset field such that
3090 ehdrC + .sh_offset == addr_of_zeroed_space. */
3091 char* zspace = stgCallocBytes(1, shdr[i].sh_size,
3092 "ocGetNames_ELF(BSS)");
3093 shdr[i].sh_offset = ((char*)zspace) - ((char*)ehdrC);
3095 debugBelch("BSS section at 0x%x, size %d\n",
3096 zspace, shdr[i].sh_size);
3100 /* fill in the section info */
3101 if (kind != SECTIONKIND_OTHER && shdr[i].sh_size > 0) {
3102 addProddableBlock(oc, ehdrC + shdr[i].sh_offset, shdr[i].sh_size);
3103 addSection(oc, kind, ehdrC + shdr[i].sh_offset,
3104 ehdrC + shdr[i].sh_offset + shdr[i].sh_size - 1);
3107 if (shdr[i].sh_type != SHT_SYMTAB) continue;
3109 /* copy stuff into this module's object symbol table */
3110 stab = (Elf_Sym*) (ehdrC + shdr[i].sh_offset);
3111 nent = shdr[i].sh_size / sizeof(Elf_Sym);
3113 oc->n_symbols = nent;
3114 oc->symbols = stgMallocBytes(oc->n_symbols * sizeof(char*),
3115 "ocGetNames_ELF(oc->symbols)");
3117 for (j = 0; j < nent; j++) {
3119 char isLocal = FALSE; /* avoids uninit-var warning */
3121 char* nm = strtab + stab[j].st_name;
3122 int secno = stab[j].st_shndx;
3124 /* Figure out if we want to add it; if so, set ad to its
3125 address. Otherwise leave ad == NULL. */
3127 if (secno == SHN_COMMON) {
3129 ad = stgCallocBytes(1, stab[j].st_size, "ocGetNames_ELF(COMMON)");
3131 debugBelch("COMMON symbol, size %d name %s\n",
3132 stab[j].st_size, nm);
3134 /* Pointless to do addProddableBlock() for this area,
3135 since the linker should never poke around in it. */
3138 if ( ( ELF_ST_BIND(stab[j].st_info)==STB_GLOBAL
3139 || ELF_ST_BIND(stab[j].st_info)==STB_LOCAL
3141 /* and not an undefined symbol */
3142 && stab[j].st_shndx != SHN_UNDEF
3143 /* and not in a "special section" */
3144 && stab[j].st_shndx < SHN_LORESERVE
3146 /* and it's a not a section or string table or anything silly */
3147 ( ELF_ST_TYPE(stab[j].st_info)==STT_FUNC ||
3148 ELF_ST_TYPE(stab[j].st_info)==STT_OBJECT ||
3149 ELF_ST_TYPE(stab[j].st_info)==STT_NOTYPE
3152 /* Section 0 is the undefined section, hence > and not >=. */
3153 ASSERT(secno > 0 && secno < ehdr->e_shnum);
3155 if (shdr[secno].sh_type == SHT_NOBITS) {
3156 debugBelch(" BSS symbol, size %d off %d name %s\n",
3157 stab[j].st_size, stab[j].st_value, nm);
3160 ad = ehdrC + shdr[ secno ].sh_offset + stab[j].st_value;
3161 if (ELF_ST_BIND(stab[j].st_info)==STB_LOCAL) {
3164 #ifdef ELF_FUNCTION_DESC
3165 /* dlsym() and the initialisation table both give us function
3166 * descriptors, so to be consistent we store function descriptors
3167 * in the symbol table */
3168 if (ELF_ST_TYPE(stab[j].st_info) == STT_FUNC)
3169 ad = (char *)allocateFunctionDesc((Elf_Addr)ad);
3171 IF_DEBUG(linker,debugBelch( "addOTabName(GLOB): %10p %s %s\n",
3172 ad, oc->fileName, nm ));
3177 /* And the decision is ... */
3181 oc->symbols[j] = nm;
3184 /* Ignore entirely. */
3186 ghciInsertStrHashTable(oc->fileName, symhash, nm, ad);
3190 IF_DEBUG(linker,debugBelch( "skipping `%s'\n",
3191 strtab + stab[j].st_name ));
3194 "skipping bind = %d, type = %d, shndx = %d `%s'\n",
3195 (int)ELF_ST_BIND(stab[j].st_info),
3196 (int)ELF_ST_TYPE(stab[j].st_info),
3197 (int)stab[j].st_shndx,
3198 strtab + stab[j].st_name
3201 oc->symbols[j] = NULL;
3210 /* Do ELF relocations which lack an explicit addend. All x86-linux
3211 relocations appear to be of this form. */
3213 do_Elf_Rel_relocations ( ObjectCode* oc, char* ehdrC,
3214 Elf_Shdr* shdr, int shnum,
3215 Elf_Sym* stab, char* strtab )
3220 Elf_Rel* rtab = (Elf_Rel*) (ehdrC + shdr[shnum].sh_offset);
3221 int nent = shdr[shnum].sh_size / sizeof(Elf_Rel);
3222 int target_shndx = shdr[shnum].sh_info;
3223 int symtab_shndx = shdr[shnum].sh_link;
3225 stab = (Elf_Sym*) (ehdrC + shdr[ symtab_shndx ].sh_offset);
3226 targ = (Elf_Word*)(ehdrC + shdr[ target_shndx ].sh_offset);
3227 IF_DEBUG(linker,debugBelch( "relocations for section %d using symtab %d\n",
3228 target_shndx, symtab_shndx ));
3230 /* Skip sections that we're not interested in. */
3233 SectionKind kind = getSectionKind_ELF(&shdr[target_shndx], &is_bss);
3234 if (kind == SECTIONKIND_OTHER) {
3235 IF_DEBUG(linker,debugBelch( "skipping (target section not loaded)"));
3240 for (j = 0; j < nent; j++) {
3241 Elf_Addr offset = rtab[j].r_offset;
3242 Elf_Addr info = rtab[j].r_info;
3244 Elf_Addr P = ((Elf_Addr)targ) + offset;
3245 Elf_Word* pP = (Elf_Word*)P;
3250 StgStablePtr stablePtr;
3253 IF_DEBUG(linker,debugBelch( "Rel entry %3d is raw(%6p %6p)",
3254 j, (void*)offset, (void*)info ));
3256 IF_DEBUG(linker,debugBelch( " ZERO" ));
3259 Elf_Sym sym = stab[ELF_R_SYM(info)];
3260 /* First see if it is a local symbol. */
3261 if (ELF_ST_BIND(sym.st_info) == STB_LOCAL) {
3262 /* Yes, so we can get the address directly from the ELF symbol
3264 symbol = sym.st_name==0 ? "(noname)" : strtab+sym.st_name;
3266 (ehdrC + shdr[ sym.st_shndx ].sh_offset
3267 + stab[ELF_R_SYM(info)].st_value);
3270 symbol = strtab + sym.st_name;
3271 stablePtr = (StgStablePtr)lookupHashTable(stablehash, (StgWord)symbol);
3272 if (NULL == stablePtr) {
3273 /* No, so look up the name in our global table. */
3274 S_tmp = lookupSymbol( symbol );
3275 S = (Elf_Addr)S_tmp;
3277 stableVal = deRefStablePtr( stablePtr );
3279 S = (Elf_Addr)S_tmp;
3283 errorBelch("%s: unknown symbol `%s'", oc->fileName, symbol);
3286 IF_DEBUG(linker,debugBelch( "`%s' resolves to %p\n", symbol, (void*)S ));
3289 IF_DEBUG(linker,debugBelch( "Reloc: P = %p S = %p A = %p\n",
3290 (void*)P, (void*)S, (void*)A ));
3291 checkProddableBlock ( oc, pP );
3295 switch (ELF_R_TYPE(info)) {
3296 # ifdef i386_HOST_ARCH
3297 case R_386_32: *pP = value; break;
3298 case R_386_PC32: *pP = value - P; break;
3301 errorBelch("%s: unhandled ELF relocation(Rel) type %lu\n",
3302 oc->fileName, (lnat)ELF_R_TYPE(info));
3310 /* Do ELF relocations for which explicit addends are supplied.
3311 sparc-solaris relocations appear to be of this form. */
3313 do_Elf_Rela_relocations ( ObjectCode* oc, char* ehdrC,
3314 Elf_Shdr* shdr, int shnum,
3315 Elf_Sym* stab, char* strtab )
3318 char *symbol = NULL;
3320 Elf_Rela* rtab = (Elf_Rela*) (ehdrC + shdr[shnum].sh_offset);
3321 int nent = shdr[shnum].sh_size / sizeof(Elf_Rela);
3322 int target_shndx = shdr[shnum].sh_info;
3323 int symtab_shndx = shdr[shnum].sh_link;
3325 stab = (Elf_Sym*) (ehdrC + shdr[ symtab_shndx ].sh_offset);
3326 targ = (Elf_Addr) (ehdrC + shdr[ target_shndx ].sh_offset);
3327 IF_DEBUG(linker,debugBelch( "relocations for section %d using symtab %d\n",
3328 target_shndx, symtab_shndx ));
3330 for (j = 0; j < nent; j++) {
3331 #if defined(DEBUG) || defined(sparc_HOST_ARCH) || defined(ia64_HOST_ARCH) || defined(powerpc_HOST_ARCH) || defined(x86_64_HOST_ARCH)
3332 /* This #ifdef only serves to avoid unused-var warnings. */
3333 Elf_Addr offset = rtab[j].r_offset;
3334 Elf_Addr P = targ + offset;
3336 Elf_Addr info = rtab[j].r_info;
3337 Elf_Addr A = rtab[j].r_addend;
3341 # if defined(sparc_HOST_ARCH)
3342 Elf_Word* pP = (Elf_Word*)P;
3344 # elif defined(ia64_HOST_ARCH)
3345 Elf64_Xword *pP = (Elf64_Xword *)P;
3347 # elif defined(powerpc_HOST_ARCH)
3351 IF_DEBUG(linker,debugBelch( "Rel entry %3d is raw(%6p %6p %6p) ",
3352 j, (void*)offset, (void*)info,
3355 IF_DEBUG(linker,debugBelch( " ZERO" ));
3358 Elf_Sym sym = stab[ELF_R_SYM(info)];
3359 /* First see if it is a local symbol. */
3360 if (ELF_ST_BIND(sym.st_info) == STB_LOCAL) {
3361 /* Yes, so we can get the address directly from the ELF symbol
3363 symbol = sym.st_name==0 ? "(noname)" : strtab+sym.st_name;
3365 (ehdrC + shdr[ sym.st_shndx ].sh_offset
3366 + stab[ELF_R_SYM(info)].st_value);
3367 #ifdef ELF_FUNCTION_DESC
3368 /* Make a function descriptor for this function */
3369 if (S && ELF_ST_TYPE(sym.st_info) == STT_FUNC) {
3370 S = allocateFunctionDesc(S + A);
3375 /* No, so look up the name in our global table. */
3376 symbol = strtab + sym.st_name;
3377 S_tmp = lookupSymbol( symbol );
3378 S = (Elf_Addr)S_tmp;
3380 #ifdef ELF_FUNCTION_DESC
3381 /* If a function, already a function descriptor - we would
3382 have to copy it to add an offset. */
3383 if (S && (ELF_ST_TYPE(sym.st_info) == STT_FUNC) && (A != 0))
3384 errorBelch("%s: function %s with addend %p", oc->fileName, symbol, (void *)A);
3388 errorBelch("%s: unknown symbol `%s'", oc->fileName, symbol);
3391 IF_DEBUG(linker,debugBelch( "`%s' resolves to %p", symbol, (void*)S ));
3394 IF_DEBUG(linker,debugBelch("Reloc: P = %p S = %p A = %p\n",
3395 (void*)P, (void*)S, (void*)A ));
3396 /* checkProddableBlock ( oc, (void*)P ); */
3400 switch (ELF_R_TYPE(info)) {
3401 # if defined(sparc_HOST_ARCH)
3402 case R_SPARC_WDISP30:
3403 w1 = *pP & 0xC0000000;
3404 w2 = (Elf_Word)((value - P) >> 2);
3405 ASSERT((w2 & 0xC0000000) == 0);
3410 w1 = *pP & 0xFFC00000;
3411 w2 = (Elf_Word)(value >> 10);
3412 ASSERT((w2 & 0xFFC00000) == 0);
3418 w2 = (Elf_Word)(value & 0x3FF);
3419 ASSERT((w2 & ~0x3FF) == 0);
3423 /* According to the Sun documentation:
3425 This relocation type resembles R_SPARC_32, except it refers to an
3426 unaligned word. That is, the word to be relocated must be treated
3427 as four separate bytes with arbitrary alignment, not as a word
3428 aligned according to the architecture requirements.
3430 (JRS: which means that freeloading on the R_SPARC_32 case
3431 is probably wrong, but hey ...)
3435 w2 = (Elf_Word)value;
3438 # elif defined(ia64_HOST_ARCH)
3439 case R_IA64_DIR64LSB:
3440 case R_IA64_FPTR64LSB:
3443 case R_IA64_PCREL64LSB:
3446 case R_IA64_SEGREL64LSB:
3447 addr = findElfSegment(ehdrC, value);
3450 case R_IA64_GPREL22:
3451 ia64_reloc_gprel22(P, value);
3453 case R_IA64_LTOFF22:
3454 case R_IA64_LTOFF22X:
3455 case R_IA64_LTOFF_FPTR22:
3456 addr = allocateGOTEntry(value);
3457 ia64_reloc_gprel22(P, addr);
3459 case R_IA64_PCREL21B:
3460 ia64_reloc_pcrel21(P, S, oc);
3463 /* This goes with R_IA64_LTOFF22X and points to the load to
3464 * convert into a move. We don't implement relaxation. */
3466 # elif defined(powerpc_HOST_ARCH)
3467 case R_PPC_ADDR16_LO:
3468 *(Elf32_Half*) P = value;
3471 case R_PPC_ADDR16_HI:
3472 *(Elf32_Half*) P = value >> 16;
3475 case R_PPC_ADDR16_HA:
3476 *(Elf32_Half*) P = (value + 0x8000) >> 16;
3480 *(Elf32_Word *) P = value;
3484 *(Elf32_Word *) P = value - P;
3490 if( delta << 6 >> 6 != delta )
3492 value = (Elf_Addr) (&makeSymbolExtra( oc, ELF_R_SYM(info), value )
3496 if( value == 0 || delta << 6 >> 6 != delta )
3498 barf( "Unable to make SymbolExtra for #%d",
3504 *(Elf_Word *) P = (*(Elf_Word *) P & 0xfc000003)
3505 | (delta & 0x3fffffc);
3509 #if x86_64_HOST_ARCH
3511 *(Elf64_Xword *)P = value;
3516 StgInt64 off = value - P;
3517 if (off >= 0x7fffffffL || off < -0x80000000L) {
3518 #if X86_64_ELF_NONPIC_HACK
3519 StgInt64 pltAddress = (StgInt64) &makeSymbolExtra(oc, ELF_R_SYM(info), S)
3521 off = pltAddress + A - P;
3523 barf("R_X86_64_PC32 relocation out of range: %s = %p\nRecompile %s with -fPIC.",
3524 symbol, off, oc->fileName );
3527 *(Elf64_Word *)P = (Elf64_Word)off;
3533 StgInt64 off = value - P;
3534 *(Elf64_Word *)P = (Elf64_Word)off;
3539 if (value >= 0x7fffffffL) {
3540 #if X86_64_ELF_NONPIC_HACK
3541 StgInt64 pltAddress = (StgInt64) &makeSymbolExtra(oc, ELF_R_SYM(info), S)
3543 value = pltAddress + A;
3545 barf("R_X86_64_32 relocation out of range: %s = %p\nRecompile %s with -fPIC.",
3546 symbol, value, oc->fileName );
3549 *(Elf64_Word *)P = (Elf64_Word)value;
3553 if ((StgInt64)value > 0x7fffffffL || (StgInt64)value < -0x80000000L) {
3554 #if X86_64_ELF_NONPIC_HACK
3555 StgInt64 pltAddress = (StgInt64) &makeSymbolExtra(oc, ELF_R_SYM(info), S)
3557 value = pltAddress + A;
3559 barf("R_X86_64_32S relocation out of range: %s = %p\nRecompile %s with -fPIC.",
3560 symbol, value, oc->fileName );
3563 *(Elf64_Sword *)P = (Elf64_Sword)value;
3566 case R_X86_64_GOTPCREL:
3568 StgInt64 gotAddress = (StgInt64) &makeSymbolExtra(oc, ELF_R_SYM(info), S)->addr;
3569 StgInt64 off = gotAddress + A - P;
3570 *(Elf64_Word *)P = (Elf64_Word)off;
3574 case R_X86_64_PLT32:
3576 StgInt64 off = value - P;
3577 if (off >= 0x7fffffffL || off < -0x80000000L) {
3578 StgInt64 pltAddress = (StgInt64) &makeSymbolExtra(oc, ELF_R_SYM(info), S)
3580 off = pltAddress + A - P;
3582 *(Elf64_Word *)P = (Elf64_Word)off;
3588 errorBelch("%s: unhandled ELF relocation(RelA) type %lu\n",
3589 oc->fileName, (lnat)ELF_R_TYPE(info));
3598 ocResolve_ELF ( ObjectCode* oc )
3602 Elf_Sym* stab = NULL;
3603 char* ehdrC = (char*)(oc->image);
3604 Elf_Ehdr* ehdr = (Elf_Ehdr*) ehdrC;
3605 Elf_Shdr* shdr = (Elf_Shdr*) (ehdrC + ehdr->e_shoff);
3607 /* first find "the" symbol table */
3608 stab = (Elf_Sym*) findElfSection ( ehdrC, SHT_SYMTAB );
3610 /* also go find the string table */
3611 strtab = findElfSection ( ehdrC, SHT_STRTAB );
3613 if (stab == NULL || strtab == NULL) {
3614 errorBelch("%s: can't find string or symbol table", oc->fileName);
3618 /* Process the relocation sections. */
3619 for (shnum = 0; shnum < ehdr->e_shnum; shnum++) {
3620 if (shdr[shnum].sh_type == SHT_REL) {
3621 ok = do_Elf_Rel_relocations ( oc, ehdrC, shdr,
3622 shnum, stab, strtab );
3626 if (shdr[shnum].sh_type == SHT_RELA) {
3627 ok = do_Elf_Rela_relocations ( oc, ehdrC, shdr,
3628 shnum, stab, strtab );
3633 /* Free the local symbol table; we won't need it again. */
3634 freeHashTable(oc->lochash, NULL);
3637 #if defined(powerpc_HOST_ARCH)
3638 ocFlushInstructionCache( oc );
3646 * Instructions are 41 bits long, packed into 128 bit bundles with a 5-bit template
3647 * at the front. The following utility functions pack and unpack instructions, and
3648 * take care of the most common relocations.
3651 #ifdef ia64_HOST_ARCH
3654 ia64_extract_instruction(Elf64_Xword *target)
3657 int slot = (Elf_Addr)target & 3;
3658 target = (Elf_Addr)target & ~3;
3666 return ((w1 >> 5) & 0x1ffffffffff);
3668 return (w1 >> 46) | ((w2 & 0x7fffff) << 18);
3672 barf("ia64_extract_instruction: invalid slot %p", target);
3677 ia64_deposit_instruction(Elf64_Xword *target, Elf64_Xword value)
3679 int slot = (Elf_Addr)target & 3;
3680 target = (Elf_Addr)target & ~3;
3685 *target |= value << 5;
3688 *target |= value << 46;
3689 *(target+1) |= value >> 18;
3692 *(target+1) |= value << 23;
3698 ia64_reloc_gprel22(Elf_Addr target, Elf_Addr value)
3700 Elf64_Xword instruction;
3701 Elf64_Sxword rel_value;
3703 rel_value = value - gp_val;
3704 if ((rel_value > 0x1fffff) || (rel_value < -0x1fffff))
3705 barf("GP-relative data out of range (address = 0x%lx, gp = 0x%lx)", value, gp_val);
3707 instruction = ia64_extract_instruction((Elf64_Xword *)target);
3708 instruction |= (((rel_value >> 0) & 0x07f) << 13) /* imm7b */
3709 | (((rel_value >> 7) & 0x1ff) << 27) /* imm9d */
3710 | (((rel_value >> 16) & 0x01f) << 22) /* imm5c */
3711 | ((Elf64_Xword)(rel_value < 0) << 36); /* s */
3712 ia64_deposit_instruction((Elf64_Xword *)target, instruction);
3716 ia64_reloc_pcrel21(Elf_Addr target, Elf_Addr value, ObjectCode *oc)
3718 Elf64_Xword instruction;
3719 Elf64_Sxword rel_value;
3722 entry = allocatePLTEntry(value, oc);
3724 rel_value = (entry >> 4) - (target >> 4);
3725 if ((rel_value > 0xfffff) || (rel_value < -0xfffff))
3726 barf("PLT entry too far away (entry = 0x%lx, target = 0x%lx)", entry, target);
3728 instruction = ia64_extract_instruction((Elf64_Xword *)target);
3729 instruction |= ((rel_value & 0xfffff) << 13) /* imm20b */
3730 | ((Elf64_Xword)(rel_value < 0) << 36); /* s */
3731 ia64_deposit_instruction((Elf64_Xword *)target, instruction);
3737 * PowerPC & X86_64 ELF specifics
3740 #if defined(powerpc_HOST_ARCH) || defined(x86_64_HOST_ARCH)
3742 static int ocAllocateSymbolExtras_ELF( ObjectCode *oc )
3748 ehdr = (Elf_Ehdr *) oc->image;
3749 shdr = (Elf_Shdr *) ( ((char *)oc->image) + ehdr->e_shoff );
3751 for( i = 0; i < ehdr->e_shnum; i++ )
3752 if( shdr[i].sh_type == SHT_SYMTAB )
3755 if( i == ehdr->e_shnum )
3757 errorBelch( "This ELF file contains no symtab" );
3761 if( shdr[i].sh_entsize != sizeof( Elf_Sym ) )
3763 errorBelch( "The entry size (%d) of the symtab isn't %d\n",
3764 (int) shdr[i].sh_entsize, (int) sizeof( Elf_Sym ) );
3769 return ocAllocateSymbolExtras( oc, shdr[i].sh_size / sizeof( Elf_Sym ), 0 );
3772 #endif /* powerpc */
3776 /* --------------------------------------------------------------------------
3778 * ------------------------------------------------------------------------*/
3780 #if defined(OBJFORMAT_MACHO)
3783 Support for MachO linking on Darwin/MacOS X
3784 by Wolfgang Thaller (wolfgang.thaller@gmx.net)
3786 I hereby formally apologize for the hackish nature of this code.
3787 Things that need to be done:
3788 *) implement ocVerifyImage_MachO
3789 *) add still more sanity checks.
3792 #if x86_64_HOST_ARCH || powerpc64_HOST_ARCH
3793 #define mach_header mach_header_64
3794 #define segment_command segment_command_64
3795 #define section section_64
3796 #define nlist nlist_64
3799 #ifdef powerpc_HOST_ARCH
3800 static int ocAllocateSymbolExtras_MachO(ObjectCode* oc)
3802 struct mach_header *header = (struct mach_header *) oc->image;
3803 struct load_command *lc = (struct load_command *) (header + 1);
3806 for( i = 0; i < header->ncmds; i++ )
3808 if( lc->cmd == LC_SYMTAB )
3810 // Find out the first and last undefined external
3811 // symbol, so we don't have to allocate too many
3813 struct symtab_command *symLC = (struct symtab_command *) lc;
3814 unsigned min = symLC->nsyms, max = 0;
3815 struct nlist *nlist =
3816 symLC ? (struct nlist*) ((char*) oc->image + symLC->symoff)
3818 for(i=0;i<symLC->nsyms;i++)
3820 if(nlist[i].n_type & N_STAB)
3822 else if(nlist[i].n_type & N_EXT)
3824 if((nlist[i].n_type & N_TYPE) == N_UNDF
3825 && (nlist[i].n_value == 0))
3835 return ocAllocateSymbolExtras(oc, max - min + 1, min);
3840 lc = (struct load_command *) ( ((char *)lc) + lc->cmdsize );
3842 return ocAllocateSymbolExtras(oc,0,0);
3845 #ifdef x86_64_HOST_ARCH
3846 static int ocAllocateSymbolExtras_MachO(ObjectCode* oc)
3848 struct mach_header *header = (struct mach_header *) oc->image;
3849 struct load_command *lc = (struct load_command *) (header + 1);
3852 for( i = 0; i < header->ncmds; i++ )
3854 if( lc->cmd == LC_SYMTAB )
3856 // Just allocate one entry for every symbol
3857 struct symtab_command *symLC = (struct symtab_command *) lc;
3859 return ocAllocateSymbolExtras(oc, symLC->nsyms, 0);
3862 lc = (struct load_command *) ( ((char *)lc) + lc->cmdsize );
3864 return ocAllocateSymbolExtras(oc,0,0);
3868 static int ocVerifyImage_MachO(ObjectCode* oc)
3870 char *image = (char*) oc->image;
3871 struct mach_header *header = (struct mach_header*) image;
3873 #if x86_64_TARGET_ARCH || powerpc64_TARGET_ARCH
3874 if(header->magic != MH_MAGIC_64)
3877 if(header->magic != MH_MAGIC)
3880 // FIXME: do some more verifying here
3884 static int resolveImports(
3887 struct symtab_command *symLC,
3888 struct section *sect, // ptr to lazy or non-lazy symbol pointer section
3889 unsigned long *indirectSyms,
3890 struct nlist *nlist)
3893 size_t itemSize = 4;
3896 int isJumpTable = 0;
3897 if(!strcmp(sect->sectname,"__jump_table"))
3901 ASSERT(sect->reserved2 == itemSize);
3905 for(i=0; i*itemSize < sect->size;i++)
3907 // according to otool, reserved1 contains the first index into the indirect symbol table
3908 struct nlist *symbol = &nlist[indirectSyms[sect->reserved1+i]];
3909 char *nm = image + symLC->stroff + symbol->n_un.n_strx;
3912 if((symbol->n_type & N_TYPE) == N_UNDF
3913 && (symbol->n_type & N_EXT) && (symbol->n_value != 0))
3914 addr = (void*) (symbol->n_value);
3915 else if((addr = lookupLocalSymbol(oc,nm)) != NULL)
3918 addr = lookupSymbol(nm);
3921 errorBelch("\n%s: unknown symbol `%s'", oc->fileName, nm);
3929 checkProddableBlock(oc,image + sect->offset + i*itemSize);
3930 *(image + sect->offset + i*itemSize) = 0xe9; // jmp
3931 *(unsigned*)(image + sect->offset + i*itemSize + 1)
3932 = (char*)addr - (image + sect->offset + i*itemSize + 5);
3937 checkProddableBlock(oc,((void**)(image + sect->offset)) + i);
3938 ((void**)(image + sect->offset))[i] = addr;
3945 static unsigned long relocateAddress(
3948 struct section* sections,
3949 unsigned long address)
3952 for(i = 0; i < nSections; i++)
3954 if(sections[i].addr <= address
3955 && address < sections[i].addr + sections[i].size)
3957 return (unsigned long)oc->image
3958 + sections[i].offset + address - sections[i].addr;
3961 barf("Invalid Mach-O file:"
3962 "Address out of bounds while relocating object file");
3966 static int relocateSection(
3969 struct symtab_command *symLC, struct nlist *nlist,
3970 int nSections, struct section* sections, struct section *sect)
3972 struct relocation_info *relocs;
3975 if(!strcmp(sect->sectname,"__la_symbol_ptr"))
3977 else if(!strcmp(sect->sectname,"__nl_symbol_ptr"))
3979 else if(!strcmp(sect->sectname,"__la_sym_ptr2"))
3981 else if(!strcmp(sect->sectname,"__la_sym_ptr3"))
3985 relocs = (struct relocation_info*) (image + sect->reloff);
3989 #ifdef x86_64_HOST_ARCH
3990 struct relocation_info *reloc = &relocs[i];
3992 char *thingPtr = image + sect->offset + reloc->r_address;
3996 int type = reloc->r_type;
3998 checkProddableBlock(oc,thingPtr);
3999 switch(reloc->r_length)
4002 thing = *(uint8_t*)thingPtr;
4003 baseValue = (uint64_t)thingPtr + 1;
4006 thing = *(uint16_t*)thingPtr;
4007 baseValue = (uint64_t)thingPtr + 2;
4010 thing = *(uint32_t*)thingPtr;
4011 baseValue = (uint64_t)thingPtr + 4;
4014 thing = *(uint64_t*)thingPtr;
4015 baseValue = (uint64_t)thingPtr + 8;
4018 barf("Unknown size.");
4021 if(type == X86_64_RELOC_GOT
4022 || type == X86_64_RELOC_GOT_LOAD)
4024 ASSERT(reloc->r_extern);
4025 value = (uint64_t) &makeSymbolExtra(oc, reloc->r_symbolnum, value)->addr;
4027 type = X86_64_RELOC_SIGNED;
4029 else if(reloc->r_extern)
4031 struct nlist *symbol = &nlist[reloc->r_symbolnum];
4032 char *nm = image + symLC->stroff + symbol->n_un.n_strx;
4033 if(symbol->n_value == 0)
4034 value = (uint64_t) lookupSymbol(nm);
4036 value = relocateAddress(oc, nSections, sections,
4041 value = sections[reloc->r_symbolnum-1].offset
4042 - sections[reloc->r_symbolnum-1].addr
4046 if(type == X86_64_RELOC_BRANCH)
4048 if((int32_t)(value - baseValue) != (int64_t)(value - baseValue))
4050 ASSERT(reloc->r_extern);
4051 value = (uint64_t) &makeSymbolExtra(oc, reloc->r_symbolnum, value)
4054 ASSERT((int32_t)(value - baseValue) == (int64_t)(value - baseValue));
4055 type = X86_64_RELOC_SIGNED;
4060 case X86_64_RELOC_UNSIGNED:
4061 ASSERT(!reloc->r_pcrel);
4064 case X86_64_RELOC_SIGNED:
4065 ASSERT(reloc->r_pcrel);
4066 thing += value - baseValue;
4068 case X86_64_RELOC_SUBTRACTOR:
4069 ASSERT(!reloc->r_pcrel);
4073 barf("unkown relocation");
4076 switch(reloc->r_length)
4079 *(uint8_t*)thingPtr = thing;
4082 *(uint16_t*)thingPtr = thing;
4085 *(uint32_t*)thingPtr = thing;
4088 *(uint64_t*)thingPtr = thing;
4092 if(relocs[i].r_address & R_SCATTERED)
4094 struct scattered_relocation_info *scat =
4095 (struct scattered_relocation_info*) &relocs[i];
4099 if(scat->r_length == 2)
4101 unsigned long word = 0;
4102 unsigned long* wordPtr = (unsigned long*) (image + sect->offset + scat->r_address);
4103 checkProddableBlock(oc,wordPtr);
4105 // Note on relocation types:
4106 // i386 uses the GENERIC_RELOC_* types,
4107 // while ppc uses special PPC_RELOC_* types.
4108 // *_RELOC_VANILLA and *_RELOC_PAIR have the same value
4109 // in both cases, all others are different.
4110 // Therefore, we use GENERIC_RELOC_VANILLA
4111 // and GENERIC_RELOC_PAIR instead of the PPC variants,
4112 // and use #ifdefs for the other types.
4114 // Step 1: Figure out what the relocated value should be
4115 if(scat->r_type == GENERIC_RELOC_VANILLA)
4117 word = *wordPtr + (unsigned long) relocateAddress(
4124 #ifdef powerpc_HOST_ARCH
4125 else if(scat->r_type == PPC_RELOC_SECTDIFF
4126 || scat->r_type == PPC_RELOC_LO16_SECTDIFF
4127 || scat->r_type == PPC_RELOC_HI16_SECTDIFF
4128 || scat->r_type == PPC_RELOC_HA16_SECTDIFF)
4130 else if(scat->r_type == GENERIC_RELOC_SECTDIFF)
4133 struct scattered_relocation_info *pair =
4134 (struct scattered_relocation_info*) &relocs[i+1];
4136 if(!pair->r_scattered || pair->r_type != GENERIC_RELOC_PAIR)
4137 barf("Invalid Mach-O file: "
4138 "RELOC_*_SECTDIFF not followed by RELOC_PAIR");
4140 word = (unsigned long)
4141 (relocateAddress(oc, nSections, sections, scat->r_value)
4142 - relocateAddress(oc, nSections, sections, pair->r_value));
4145 #ifdef powerpc_HOST_ARCH
4146 else if(scat->r_type == PPC_RELOC_HI16
4147 || scat->r_type == PPC_RELOC_LO16
4148 || scat->r_type == PPC_RELOC_HA16
4149 || scat->r_type == PPC_RELOC_LO14)
4150 { // these are generated by label+offset things
4151 struct relocation_info *pair = &relocs[i+1];
4152 if((pair->r_address & R_SCATTERED) || pair->r_type != PPC_RELOC_PAIR)
4153 barf("Invalid Mach-O file: "
4154 "PPC_RELOC_* not followed by PPC_RELOC_PAIR");
4156 if(scat->r_type == PPC_RELOC_LO16)
4158 word = ((unsigned short*) wordPtr)[1];
4159 word |= ((unsigned long) relocs[i+1].r_address & 0xFFFF) << 16;
4161 else if(scat->r_type == PPC_RELOC_LO14)
4163 barf("Unsupported Relocation: PPC_RELOC_LO14");
4164 word = ((unsigned short*) wordPtr)[1] & 0xFFFC;
4165 word |= ((unsigned long) relocs[i+1].r_address & 0xFFFF) << 16;
4167 else if(scat->r_type == PPC_RELOC_HI16)
4169 word = ((unsigned short*) wordPtr)[1] << 16;
4170 word |= ((unsigned long) relocs[i+1].r_address & 0xFFFF);
4172 else if(scat->r_type == PPC_RELOC_HA16)
4174 word = ((unsigned short*) wordPtr)[1] << 16;
4175 word += ((short)relocs[i+1].r_address & (short)0xFFFF);
4179 word += (unsigned long) relocateAddress(oc, nSections, sections, scat->r_value)
4186 continue; // ignore the others
4188 #ifdef powerpc_HOST_ARCH
4189 if(scat->r_type == GENERIC_RELOC_VANILLA
4190 || scat->r_type == PPC_RELOC_SECTDIFF)
4192 if(scat->r_type == GENERIC_RELOC_VANILLA
4193 || scat->r_type == GENERIC_RELOC_SECTDIFF)
4198 #ifdef powerpc_HOST_ARCH
4199 else if(scat->r_type == PPC_RELOC_LO16_SECTDIFF || scat->r_type == PPC_RELOC_LO16)
4201 ((unsigned short*) wordPtr)[1] = word & 0xFFFF;
4203 else if(scat->r_type == PPC_RELOC_HI16_SECTDIFF || scat->r_type == PPC_RELOC_HI16)
4205 ((unsigned short*) wordPtr)[1] = (word >> 16) & 0xFFFF;
4207 else if(scat->r_type == PPC_RELOC_HA16_SECTDIFF || scat->r_type == PPC_RELOC_HA16)
4209 ((unsigned short*) wordPtr)[1] = ((word >> 16) & 0xFFFF)
4210 + ((word & (1<<15)) ? 1 : 0);
4216 continue; // FIXME: I hope it's OK to ignore all the others.
4220 struct relocation_info *reloc = &relocs[i];
4221 if(reloc->r_pcrel && !reloc->r_extern)
4224 if(reloc->r_length == 2)
4226 unsigned long word = 0;
4227 #ifdef powerpc_HOST_ARCH
4228 unsigned long jumpIsland = 0;
4229 long offsetToJumpIsland = 0xBADBAD42; // initialise to bad value
4230 // to avoid warning and to catch
4234 unsigned long* wordPtr = (unsigned long*) (image + sect->offset + reloc->r_address);
4235 checkProddableBlock(oc,wordPtr);
4237 if(reloc->r_type == GENERIC_RELOC_VANILLA)
4241 #ifdef powerpc_HOST_ARCH
4242 else if(reloc->r_type == PPC_RELOC_LO16)
4244 word = ((unsigned short*) wordPtr)[1];
4245 word |= ((unsigned long) relocs[i+1].r_address & 0xFFFF) << 16;
4247 else if(reloc->r_type == PPC_RELOC_HI16)
4249 word = ((unsigned short*) wordPtr)[1] << 16;
4250 word |= ((unsigned long) relocs[i+1].r_address & 0xFFFF);
4252 else if(reloc->r_type == PPC_RELOC_HA16)
4254 word = ((unsigned short*) wordPtr)[1] << 16;
4255 word += ((short)relocs[i+1].r_address & (short)0xFFFF);
4257 else if(reloc->r_type == PPC_RELOC_BR24)
4260 word = (word & 0x03FFFFFC) | ((word & 0x02000000) ? 0xFC000000 : 0);
4264 if(!reloc->r_extern)
4267 sections[reloc->r_symbolnum-1].offset
4268 - sections[reloc->r_symbolnum-1].addr
4275 struct nlist *symbol = &nlist[reloc->r_symbolnum];
4276 char *nm = image + symLC->stroff + symbol->n_un.n_strx;
4277 void *symbolAddress = lookupSymbol(nm);
4280 errorBelch("\nunknown symbol `%s'", nm);
4286 #ifdef powerpc_HOST_ARCH
4287 // In the .o file, this should be a relative jump to NULL
4288 // and we'll change it to a relative jump to the symbol
4289 ASSERT(word + reloc->r_address == 0);
4290 jumpIsland = (unsigned long)
4291 &makeSymbolExtra(oc,
4293 (unsigned long) symbolAddress)
4297 offsetToJumpIsland = word + jumpIsland
4298 - (((long)image) + sect->offset - sect->addr);
4301 word += (unsigned long) symbolAddress
4302 - (((long)image) + sect->offset - sect->addr);
4306 word += (unsigned long) symbolAddress;
4310 if(reloc->r_type == GENERIC_RELOC_VANILLA)
4315 #ifdef powerpc_HOST_ARCH
4316 else if(reloc->r_type == PPC_RELOC_LO16)
4318 ((unsigned short*) wordPtr)[1] = word & 0xFFFF;
4321 else if(reloc->r_type == PPC_RELOC_HI16)
4323 ((unsigned short*) wordPtr)[1] = (word >> 16) & 0xFFFF;
4326 else if(reloc->r_type == PPC_RELOC_HA16)
4328 ((unsigned short*) wordPtr)[1] = ((word >> 16) & 0xFFFF)
4329 + ((word & (1<<15)) ? 1 : 0);
4332 else if(reloc->r_type == PPC_RELOC_BR24)
4334 if((long)word > (long)0x01FFFFFF || (long)word < (long)0xFFE00000)
4336 // The branch offset is too large.
4337 // Therefore, we try to use a jump island.
4340 barf("unconditional relative branch out of range: "
4341 "no jump island available");
4344 word = offsetToJumpIsland;
4345 if((long)word > (long)0x01FFFFFF || (long)word < (long)0xFFE00000)
4346 barf("unconditional relative branch out of range: "
4347 "jump island out of range");
4349 *wordPtr = (*wordPtr & 0xFC000003) | (word & 0x03FFFFFC);
4354 barf("\nunknown relocation %d",reloc->r_type);
4362 static int ocGetNames_MachO(ObjectCode* oc)
4364 char *image = (char*) oc->image;
4365 struct mach_header *header = (struct mach_header*) image;
4366 struct load_command *lc = (struct load_command*) (image + sizeof(struct mach_header));
4367 unsigned i,curSymbol = 0;
4368 struct segment_command *segLC = NULL;
4369 struct section *sections;
4370 struct symtab_command *symLC = NULL;
4371 struct nlist *nlist;
4372 unsigned long commonSize = 0;
4373 char *commonStorage = NULL;
4374 unsigned long commonCounter;
4376 for(i=0;i<header->ncmds;i++)
4378 if(lc->cmd == LC_SEGMENT || lc->cmd == LC_SEGMENT_64)
4379 segLC = (struct segment_command*) lc;
4380 else if(lc->cmd == LC_SYMTAB)
4381 symLC = (struct symtab_command*) lc;
4382 lc = (struct load_command *) ( ((char*)lc) + lc->cmdsize );
4385 sections = (struct section*) (segLC+1);
4386 nlist = symLC ? (struct nlist*) (image + symLC->symoff)
4390 barf("ocGetNames_MachO: no segment load command");
4392 for(i=0;i<segLC->nsects;i++)
4394 if(sections[i].size == 0)
4397 if((sections[i].flags & SECTION_TYPE) == S_ZEROFILL)
4399 char * zeroFillArea = stgCallocBytes(1,sections[i].size,
4400 "ocGetNames_MachO(common symbols)");
4401 sections[i].offset = zeroFillArea - image;
4404 if(!strcmp(sections[i].sectname,"__text"))
4405 addSection(oc, SECTIONKIND_CODE_OR_RODATA,
4406 (void*) (image + sections[i].offset),
4407 (void*) (image + sections[i].offset + sections[i].size));
4408 else if(!strcmp(sections[i].sectname,"__const"))
4409 addSection(oc, SECTIONKIND_RWDATA,
4410 (void*) (image + sections[i].offset),
4411 (void*) (image + sections[i].offset + sections[i].size));
4412 else if(!strcmp(sections[i].sectname,"__data"))
4413 addSection(oc, SECTIONKIND_RWDATA,
4414 (void*) (image + sections[i].offset),
4415 (void*) (image + sections[i].offset + sections[i].size));
4416 else if(!strcmp(sections[i].sectname,"__bss")
4417 || !strcmp(sections[i].sectname,"__common"))
4418 addSection(oc, SECTIONKIND_RWDATA,
4419 (void*) (image + sections[i].offset),
4420 (void*) (image + sections[i].offset + sections[i].size));
4422 addProddableBlock(oc, (void*) (image + sections[i].offset),
4426 // count external symbols defined here
4430 for(i=0;i<symLC->nsyms;i++)
4432 if(nlist[i].n_type & N_STAB)
4434 else if(nlist[i].n_type & N_EXT)
4436 if((nlist[i].n_type & N_TYPE) == N_UNDF
4437 && (nlist[i].n_value != 0))
4439 commonSize += nlist[i].n_value;
4442 else if((nlist[i].n_type & N_TYPE) == N_SECT)
4447 oc->symbols = stgMallocBytes(oc->n_symbols * sizeof(char*),
4448 "ocGetNames_MachO(oc->symbols)");
4452 for(i=0;i<symLC->nsyms;i++)
4454 if(nlist[i].n_type & N_STAB)
4456 else if((nlist[i].n_type & N_TYPE) == N_SECT)
4458 if(nlist[i].n_type & N_EXT)
4460 char *nm = image + symLC->stroff + nlist[i].n_un.n_strx;
4461 if((nlist[i].n_desc & N_WEAK_DEF) && lookupSymbol(nm))
4462 ; // weak definition, and we already have a definition
4465 ghciInsertStrHashTable(oc->fileName, symhash, nm,
4467 + sections[nlist[i].n_sect-1].offset
4468 - sections[nlist[i].n_sect-1].addr
4469 + nlist[i].n_value);
4470 oc->symbols[curSymbol++] = nm;
4477 commonStorage = stgCallocBytes(1,commonSize,"ocGetNames_MachO(common symbols)");
4478 commonCounter = (unsigned long)commonStorage;
4481 for(i=0;i<symLC->nsyms;i++)
4483 if((nlist[i].n_type & N_TYPE) == N_UNDF
4484 && (nlist[i].n_type & N_EXT) && (nlist[i].n_value != 0))
4486 char *nm = image + symLC->stroff + nlist[i].n_un.n_strx;
4487 unsigned long sz = nlist[i].n_value;
4489 nlist[i].n_value = commonCounter;
4491 ghciInsertStrHashTable(oc->fileName, symhash, nm,
4492 (void*)commonCounter);
4493 oc->symbols[curSymbol++] = nm;
4495 commonCounter += sz;
4502 static int ocResolve_MachO(ObjectCode* oc)
4504 char *image = (char*) oc->image;
4505 struct mach_header *header = (struct mach_header*) image;
4506 struct load_command *lc = (struct load_command*) (image + sizeof(struct mach_header));
4508 struct segment_command *segLC = NULL;
4509 struct section *sections;
4510 struct symtab_command *symLC = NULL;
4511 struct dysymtab_command *dsymLC = NULL;
4512 struct nlist *nlist;
4514 for(i=0;i<header->ncmds;i++)
4516 if(lc->cmd == LC_SEGMENT || lc->cmd == LC_SEGMENT_64)
4517 segLC = (struct segment_command*) lc;
4518 else if(lc->cmd == LC_SYMTAB)
4519 symLC = (struct symtab_command*) lc;
4520 else if(lc->cmd == LC_DYSYMTAB)
4521 dsymLC = (struct dysymtab_command*) lc;
4522 lc = (struct load_command *) ( ((char*)lc) + lc->cmdsize );
4525 sections = (struct section*) (segLC+1);
4526 nlist = symLC ? (struct nlist*) (image + symLC->symoff)
4531 unsigned long *indirectSyms
4532 = (unsigned long*) (image + dsymLC->indirectsymoff);
4534 for(i=0;i<segLC->nsects;i++)
4536 if( !strcmp(sections[i].sectname,"__la_symbol_ptr")
4537 || !strcmp(sections[i].sectname,"__la_sym_ptr2")
4538 || !strcmp(sections[i].sectname,"__la_sym_ptr3"))
4540 if(!resolveImports(oc,image,symLC,§ions[i],indirectSyms,nlist))
4543 else if(!strcmp(sections[i].sectname,"__nl_symbol_ptr")
4544 || !strcmp(sections[i].sectname,"__pointers"))
4546 if(!resolveImports(oc,image,symLC,§ions[i],indirectSyms,nlist))
4549 else if(!strcmp(sections[i].sectname,"__jump_table"))
4551 if(!resolveImports(oc,image,symLC,§ions[i],indirectSyms,nlist))
4557 for(i=0;i<segLC->nsects;i++)
4559 if(!relocateSection(oc,image,symLC,nlist,segLC->nsects,sections,§ions[i]))
4563 /* Free the local symbol table; we won't need it again. */
4564 freeHashTable(oc->lochash, NULL);
4567 #if defined (powerpc_HOST_ARCH)
4568 ocFlushInstructionCache( oc );
4574 #ifdef powerpc_HOST_ARCH
4576 * The Mach-O object format uses leading underscores. But not everywhere.
4577 * There is a small number of runtime support functions defined in
4578 * libcc_dynamic.a whose name does not have a leading underscore.
4579 * As a consequence, we can't get their address from C code.
4580 * We have to use inline assembler just to take the address of a function.
4584 static void machoInitSymbolsWithoutUnderscore()
4586 extern void* symbolsWithoutUnderscore[];
4587 void **p = symbolsWithoutUnderscore;
4588 __asm__ volatile(".globl _symbolsWithoutUnderscore\n.data\n_symbolsWithoutUnderscore:");
4592 __asm__ volatile(".long " # x);
4594 RTS_MACHO_NOUNDERLINE_SYMBOLS
4596 __asm__ volatile(".text");
4600 ghciInsertStrHashTable("(GHCi built-in symbols)", symhash, #x, *p++);
4602 RTS_MACHO_NOUNDERLINE_SYMBOLS
4609 * Figure out by how much to shift the entire Mach-O file in memory
4610 * when loading so that its single segment ends up 16-byte-aligned
4612 static int machoGetMisalignment( FILE * f )
4614 struct mach_header header;
4617 fread(&header, sizeof(header), 1, f);
4620 #if x86_64_TARGET_ARCH || powerpc64_TARGET_ARCH
4621 if(header.magic != MH_MAGIC_64)
4624 if(header.magic != MH_MAGIC)
4628 misalignment = (header.sizeofcmds + sizeof(header))
4631 return misalignment ? (16 - misalignment) : 0;