LibELF: Support relocating weak symbols against global libraries

A strong symbol anywhere in an executable must override any
weak symbol used in any library. This means that the weak symbol
must be overridden by a strong symbol even if the strong symbol
is in a dependent library. This means we need to perform relocations
twice, and resolve weak symbols globally before attempting to resolve
them locally. Consequentially we need to defer performing any
initialisations until after we have performed the second round of
relocations.

Libraries/LibELF/DynamicLinker.cpp

@@ -207,9 +207,25 @@ static void load_elf(const String& name)
     g_global_objects.append(*dynamic_object);
 
     VERBOSE("load_elf: done %s\n", name.characters());
-    if (name == "libc.so") {
-        initialize_libc(*dynamic_object);
+}
+
+static NonnullRefPtr<DynamicLoader> commit_elf(const String& name)
+{
+    auto loader = g_loaders.get(name).value();
+    for (const auto& needed_name : get_dependencies(name)) {
+        String library_name = get_library_name(needed_name);
+        if (g_loaders.contains(library_name)) {
+            commit_elf(library_name);
         }
+    }
+
+    auto object = loader->load_stage_3(RTLD_GLOBAL | RTLD_LAZY, g_total_tls_size);
+    ASSERT(object);
+    if (name == "libc.so") {
+        initialize_libc(*object);
+    }
+    g_loaders.remove(name);
+    return loader;
 }
 
 void ELF::DynamicLinker::linker_main(String&& main_program_name, int main_program_fd, int argc, char** argv, char** envp)
@@ -226,7 +242,7 @@ void ELF::DynamicLinker::linker_main(String&& main_program_name, int main_progra
     allocate_tls();
 
     load_elf(main_program_name);
-    auto main_program_lib = g_loaders.get(main_program_name).value();
+    auto main_program_lib = commit_elf(main_program_name);
 
     FlatPtr entry_point = reinterpret_cast<FlatPtr>(main_program_lib->image().entry().as_ptr());
     if (main_program_lib->is_dynamic())

Libraries/LibELF/DynamicLoader.cpp

@@ -196,9 +196,34 @@ bool DynamicLoader::load_stage_2(unsigned flags, size_t total_tls_size)
             return false;
         }
     }
+    do_main_relocations(total_tls_size);
+    return true;
+}
 
-    do_relocations(total_tls_size);
+void DynamicLoader::do_main_relocations(size_t total_tls_size)
+{
+    auto do_single_relocation = [&](ELF::DynamicObject::Relocation relocation) {
+        switch (do_relocation(total_tls_size, relocation)) {
+        case RelocationResult::Failed:
+            dbgln("Loader.so: {} unresolved symbol '{}'", m_filename, relocation.symbol().name());
+            ASSERT_NOT_REACHED();
+            break;
+        case RelocationResult::ResolveLater:
+            m_unresolved_relocations.append(relocation);
+            break;
+        case RelocationResult::Success:
+            break;
+        }
+        return IterationDecision::Continue;
+    };
+    m_dynamic_object->relocation_section().for_each_relocation(do_single_relocation);
+    m_dynamic_object->plt_relocation_section().for_each_relocation(do_single_relocation);
+}
 
+RefPtr<DynamicObject> DynamicLoader::load_stage_3(unsigned flags, size_t total_tls_size)
+{
+
+    do_lazy_relocations(total_tls_size);
     if (flags & RTLD_LAZY) {
         setup_plt_trampoline();
     }
@@ -207,14 +232,24 @@ bool DynamicLoader::load_stage_2(unsigned flags, size_t total_tls_size)
     if (m_dynamic_object->has_text_relocations()) {
         if (0 > mprotect(m_text_segment_load_address.as_ptr(), m_text_segment_size, PROT_READ | PROT_EXEC)) {
             perror("mprotect .text: PROT_READ | PROT_EXEC"); // FIXME: dlerror?
-            return false;
+            return nullptr;
         }
     }
 
     call_object_init_functions();
 
     VERBOSE("Loaded %s\n", m_filename.characters());
-    return true;
+    return m_dynamic_object;
+}
+
+void DynamicLoader::do_lazy_relocations(size_t total_tls_size)
+{
+    for (const auto& relocation : m_unresolved_relocations) {
+        if (auto res = do_relocation(total_tls_size, relocation); res != RelocationResult::Success) {
+            dbgln("Loader.so: {} unresolved symbol '{}'", m_filename, relocation.symbol().name());
+            ASSERT_NOT_REACHED();
+        }
+    }
 }
 
 void DynamicLoader::load_program_headers()
@@ -294,10 +329,8 @@ void DynamicLoader::load_program_headers()
     // FIXME: Initialize the values in the TLS section. Currently, it is zeroed.
 }
 
-void DynamicLoader::do_relocations(size_t total_tls_size)
+DynamicLoader::RelocationResult DynamicLoader::do_relocation(size_t total_tls_size, ELF::DynamicObject::Relocation relocation)
 {
-    auto main_relocation_section = m_dynamic_object->relocation_section();
-    main_relocation_section.for_each_relocation([&](ELF::DynamicObject::Relocation relocation) {
     VERBOSE("Relocation symbol: %s, type: %d\n", relocation.symbol().name(), relocation.type());
     FlatPtr* patch_ptr = nullptr;
     if (is_dynamic())
@@ -320,7 +353,10 @@ void DynamicLoader::do_relocations(size_t total_tls_size)
         VERBOSE("Absolute relocation: name: '%s', value: %p\n", symbol.name(), symbol.value());
         auto res = lookup_symbol(symbol);
         if (!res.found) {
-                dbgln("ERROR: symbol not found: {}", symbol.name());
+            if (symbol.bind() == STB_WEAK) {
+                return RelocationResult::ResolveLater;
+            }
+            dbgln("ERROR: symbol not found: {}.", symbol.name());
             ASSERT_NOT_REACHED();
         }
         u32 symbol_address = res.address;
@@ -351,30 +387,16 @@ void DynamicLoader::do_relocations(size_t total_tls_size)
                 break;
             }
 
-                // The "__do_global_dtors_aux" function in libgcc_s.so needs this symbol,
-                // but we do not use that function so we don't actually need to resolve this symbol.
-                // The reason we can't resolve it here is that the symbol is defined in libc.so,
-                // but there's a circular dependency between libgcc_s.so and libc.so,
-                // we deal with it by first loading libgcc_s and then libc.
-                // So we cannot find this symbol at this time (libc is not yet loaded).
-                if (m_filename == "libgcc_s.so" && !strcmp(symbol.name(), "__cxa_finalize")) {
-                    break;
+            if (symbol.bind() == STB_WEAK) {
+                return RelocationResult::ResolveLater;
             }
 
             // Symbol not found
-                ASSERT_NOT_REACHED();
+            return RelocationResult::Failed;
         }
         VERBOSE("was symbol found? %d, address: 0x%x\n", res.found, res.address);
         VERBOSE("object: %s\n", m_filename.characters());
 
-            if (!res.found) {
-                // TODO this is a hack
-                ASSERT(!strcmp(symbol.name(), "__deregister_frame_info") || !strcmp(symbol.name(), "_ITM_registerTMCloneTable")
-                    || !strcmp(symbol.name(), "_ITM_deregisterTMCloneTable") || !strcmp(symbol.name(), "__register_frame_info"));
-                ASSERT_NOT_REACHED();
-                return IterationDecision::Continue;
-            }
-            // ASSERT(res.found);
         u32 symbol_location = res.address;
         ASSERT(symbol_location != (FlatPtr)m_dynamic_object->base_address().as_ptr());
         *patch_ptr = symbol_location;
@@ -416,23 +438,7 @@ void DynamicLoader::do_relocations(size_t total_tls_size)
         VERBOSE("*patch ptr: %d\n", (i32)*patch_ptr);
         break;
     }
-        default:
-            // Raise the alarm! Someone needs to implement this relocation type
-            VERBOSE("Found a new exciting relocation type %d\n", relocation.type());
-            // printf("DynamicLoader: Found unknown relocation type %d\n", relocation.type());
-            ASSERT_NOT_REACHED();
-            break;
-        }
-        return IterationDecision::Continue;
-    });
-
-    VERBOSE("plt relocations: 0x%x", m_dynamic_object->plt_relocation_section().address());
-    VERBOSE("plt relocation count: 0x%x", m_dynamic_object->plt_relocation_section().address());
-    VERBOSE("plt size: %d\n", m_dynamic_object->plt_relocation_section().size());
-    VERBOSE("plt entry size: 0x%x\n", m_dynamic_object->plt_relocation_section().entry_size());
-
-    // Handle PLT Global offset table relocations.
-    m_dynamic_object->plt_relocation_section().for_each_relocation([&](const DynamicObject::Relocation& relocation) {
+    case R_386_JMP_SLOT: {
         // FIXME: Or BIND_NOW flag passed in?
         if (m_dynamic_object->must_bind_now() || s_always_bind_now) {
             // Eagerly BIND_NOW the PLT entries, doing all the symbol looking goodness
@@ -440,17 +446,21 @@ void DynamicLoader::do_relocations(size_t total_tls_size)
             VERBOSE("patching plt reloaction: 0x%x\n", relocation.offset_in_section());
             [[maybe_unused]] auto rc = m_dynamic_object->patch_plt_entry(relocation.offset_in_section());
         } else {
-            ASSERT(relocation.type() == R_386_JMP_SLOT);
-
             u8* relocation_address = relocation.address().as_ptr();
 
             if (m_elf_image.is_dynamic())
                 *(u32*)relocation_address += (FlatPtr)m_dynamic_object->base_address().as_ptr();
         }
-        return IterationDecision::Continue;
-    });
-
-    VERBOSE("Done relocating!\n");
+        break;
+    }
+    default:
+        // Raise the alarm! Someone needs to implement this relocation type
+        VERBOSE("Found a new exciting relocation type %d\n", relocation.type());
+        // printf("DynamicLoader: Found unknown relocation type %d\n", relocation.type());
+        ASSERT_NOT_REACHED();
+        break;
+    }
+    return RelocationResult::Success;
 }
 
 // Defined in <arch>/plt_trampoline.S

Libraries/LibELF/DynamicLoader.h

@@ -52,11 +52,11 @@ public:
     // from the SHT_DYNAMIC in the file.
     RefPtr<DynamicObject> load_from_image(unsigned flags, size_t total_tls_size);
 
-    // Stage 2 of loading: relocations and init functions
-    // Assumes that the program headers have been loaded and that m_dynamic_object is initialized
-    // Splitting loading like this allows us to use the same code to relocate a main executable as an elf binary
+    // Stage 2 of loading: dynamic object loading and primary relocations
     bool load_stage_2(unsigned flags, size_t total_tls_size);
 
+    // Stage 3 of loading: lazy relocations and initializers
+    RefPtr<DynamicObject> load_stage_3(unsigned flags, size_t total_tls_size);
     // Intended for use by dlsym or other internal methods
     void* symbol_for_name(const char*);
 
@@ -114,11 +114,21 @@ private:
     void load_program_headers();
 
     // Stage 2
-    void do_relocations(size_t total_tls_size);
+    void do_main_relocations(size_t total_tls_size);
+
+    // Stage 3
+    void do_lazy_relocations(size_t total_tls_size);
     void setup_plt_trampoline();
     void call_object_init_functions();
 
     bool validate();
+
+    enum class RelocationResult : uint8_t {
+        Failed = 0,
+        Success = 1,
+        ResolveLater = 2,
+    };
+    RelocationResult do_relocation(size_t total_tls_size, DynamicObject::Relocation relocation);
     size_t calculate_tls_size() const;
 
     DynamicObject::SymbolLookupResult lookup_symbol(const ELF::DynamicObject::Symbol& symbol) const;
@@ -141,6 +151,8 @@ private:
 
     size_t m_tls_offset { 0 };
     size_t m_tls_size { 0 };
+
+    Vector<DynamicObject::Relocation> m_unresolved_relocations;
 };
 
 template<typename F>

Libraries/LibELF/DynamicObject.cpp

@@ -449,6 +449,9 @@ Elf32_Addr DynamicObject::patch_plt_entry(u32 relocation_offset)
 DynamicObject::SymbolLookupResult DynamicObject::lookup_symbol(const ELF::DynamicObject::Symbol& symbol) const
 {
     VERBOSE("looking up symbol: %s\n", symbol.name());
+    if (symbol.is_undefined() || symbol.bind() == STB_WEAK)
+        return DynamicLinker::lookup_global_symbol(symbol.name());
+
     if (!symbol.is_undefined()) {
         VERBOSE("symbol is defined in its object\n");
         return { true, symbol.value(), (FlatPtr)symbol.address().as_ptr(), symbol.bind(), &symbol.object() };