mirror of
				https://github.com/LadybirdBrowser/ladybird.git
				synced 2025-10-31 21:30:58 +00:00 
			
		
		
		
	 4d9246ac9d
			
		
	
	
		4d9246ac9d
		
	
	
	
	
		
			
			This adds very basic support for module instantiation/allocation, as well as a stub for an interpreter (and executions APIs). The 'wasm' utility is further expanded to instantiate, and attempt executing the first non-imported function in the module. Note that as the execution is a stub, the expected result is a zero. Regardless, this will allow future commits to implement the JS WebAssembly API. :^)
		
			
				
	
	
		
			295 lines
		
	
	
	
		
			12 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
			
		
		
	
	
			295 lines
		
	
	
	
		
			12 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
| /*
 | |
|  * Copyright (c) 2021, Ali Mohammad Pur <mpfard@serenityos.org>
 | |
|  *
 | |
|  * SPDX-License-Identifier: BSD-2-Clause
 | |
|  */
 | |
| 
 | |
| #include <LibWasm/AbstractMachine/AbstractMachine.h>
 | |
| #include <LibWasm/AbstractMachine/Configuration.h>
 | |
| #include <LibWasm/Types.h>
 | |
| 
 | |
| namespace Wasm {
 | |
| 
 | |
| Optional<FunctionAddress> Store::allocate(ModuleInstance& module, const Module::Function& function)
 | |
| {
 | |
|     FunctionAddress address { m_functions.size() };
 | |
|     if (function.type().value() > module.types().size())
 | |
|         return {};
 | |
| 
 | |
|     auto& type = module.types()[function.type().value()];
 | |
|     m_functions.empend(WasmFunction { type, module, function });
 | |
|     return address;
 | |
| }
 | |
| 
 | |
| Optional<FunctionAddress> Store::allocate(const HostFunction& function)
 | |
| {
 | |
|     FunctionAddress address { m_functions.size() };
 | |
|     m_functions.empend(HostFunction { function });
 | |
|     return address;
 | |
| }
 | |
| 
 | |
| Optional<TableAddress> Store::allocate(const TableType& type)
 | |
| {
 | |
|     TableAddress address { m_tables.size() };
 | |
|     Vector<Optional<Reference>> elements;
 | |
|     elements.resize(type.limits().min());
 | |
|     m_tables.empend(TableInstance { type, move(elements) });
 | |
|     return address;
 | |
| }
 | |
| 
 | |
| Optional<MemoryAddress> Store::allocate(const MemoryType& type)
 | |
| {
 | |
|     MemoryAddress address { m_memories.size() };
 | |
|     m_memories.empend(MemoryInstance { type });
 | |
|     return address;
 | |
| }
 | |
| 
 | |
| Optional<GlobalAddress> Store::allocate(const GlobalType& type, Value value)
 | |
| {
 | |
|     GlobalAddress address { m_globals.size() };
 | |
|     m_globals.append(GlobalInstance { move(value), type.is_mutable() });
 | |
|     return address;
 | |
| }
 | |
| 
 | |
| FunctionInstance* Store::get(FunctionAddress address)
 | |
| {
 | |
|     auto value = address.value();
 | |
|     if (m_functions.size() <= value)
 | |
|         return nullptr;
 | |
|     return &m_functions[value];
 | |
| }
 | |
| 
 | |
| TableInstance* Store::get(TableAddress address)
 | |
| {
 | |
|     auto value = address.value();
 | |
|     if (m_tables.size() <= value)
 | |
|         return nullptr;
 | |
|     return &m_tables[value];
 | |
| }
 | |
| 
 | |
| MemoryInstance* Store::get(MemoryAddress address)
 | |
| {
 | |
|     auto value = address.value();
 | |
|     if (m_memories.size() <= value)
 | |
|         return nullptr;
 | |
|     return &m_memories[value];
 | |
| }
 | |
| 
 | |
| GlobalInstance* Store::get(GlobalAddress address)
 | |
| {
 | |
|     auto value = address.value();
 | |
|     if (m_globals.size() <= value)
 | |
|         return nullptr;
 | |
|     return &m_globals[value];
 | |
| }
 | |
| 
 | |
| InstantiationResult AbstractMachine::instantiate(const Module& module, Vector<ExternValue> externs)
 | |
| {
 | |
|     Optional<InstantiationResult> instantiation_result;
 | |
| 
 | |
|     module.for_each_section_of_type<TypeSection>([&](const TypeSection& section) {
 | |
|         m_module_instance.types() = section.types();
 | |
|     });
 | |
| 
 | |
|     // TODO: Validate stuff
 | |
| 
 | |
|     Vector<Value> global_values;
 | |
|     ModuleInstance auxiliary_instance;
 | |
| 
 | |
|     // FIXME: Check that imports/extern match
 | |
| 
 | |
|     for (auto& entry : externs) {
 | |
|         if (auto* ptr = entry.get_pointer<GlobalAddress>())
 | |
|             auxiliary_instance.globals().append(*ptr);
 | |
|     }
 | |
| 
 | |
|     module.for_each_section_of_type<GlobalSection>([&](auto& global_section) {
 | |
|         for (auto& entry : global_section.entries()) {
 | |
|             auto frame = make<Frame>(
 | |
|                 auxiliary_instance,
 | |
|                 Vector<Value> {},
 | |
|                 entry.expression(),
 | |
|                 1);
 | |
|             Configuration config { m_store };
 | |
|             config.set_frame(move(frame));
 | |
|             auto result = config.execute();
 | |
|             // What if this traps?
 | |
|             if (result.is_trap())
 | |
|                 instantiation_result = InstantiationError { "Global value construction trapped" };
 | |
|             else
 | |
|                 global_values.append(result.values().first());
 | |
|         }
 | |
|     });
 | |
| 
 | |
|     if (auto result = allocate_all(module, externs, global_values); result.is_error()) {
 | |
|         return result.error();
 | |
|     }
 | |
| 
 | |
|     module.for_each_section_of_type<ElementSection>([&](const ElementSection& element_section) {
 | |
|         auto frame = make<Frame>(
 | |
|             m_module_instance,
 | |
|             Vector<Value> {},
 | |
|             element_section.function().offset(),
 | |
|             1);
 | |
|         Configuration config { m_store };
 | |
|         config.set_frame(move(frame));
 | |
|         auto result = config.execute();
 | |
|         // What if this traps?
 | |
|         VERIFY(!result.is_trap());
 | |
|         size_t offset = 0;
 | |
|         result.values().first().value().visit(
 | |
|             [&](const auto& value) { offset = value; },
 | |
|             [&](const FunctionAddress&) { VERIFY_NOT_REACHED(); },
 | |
|             [&](const ExternAddress&) { VERIFY_NOT_REACHED(); });
 | |
|         // FIXME: Module::get(*Index)
 | |
|         auto table_address = m_module_instance.tables().at(element_section.function().table().value());
 | |
|         if (auto table_instance = m_store.get(table_address)) {
 | |
|             auto& init = element_section.function().init();
 | |
|             for (size_t i = 0; i < init.size(); ++i)
 | |
|                 table_instance->elements()[offset + i] = Reference { Reference::Func { init[i].value() } }; // HACK!
 | |
|         }
 | |
|     });
 | |
| 
 | |
|     module.for_each_section_of_type<DataSection>([&](const DataSection& data_section) {
 | |
|         for (auto& segment : data_section.data()) {
 | |
|             segment.value().visit(
 | |
|                 [&](const DataSection::Data::Active& data) {
 | |
|                     auto frame = make<Frame>(
 | |
|                         m_module_instance,
 | |
|                         Vector<Value> {},
 | |
|                         data.offset,
 | |
|                         1);
 | |
|                     Configuration config { m_store };
 | |
|                     config.set_frame(move(frame));
 | |
|                     auto result = config.execute();
 | |
|                     size_t offset = 0;
 | |
|                     result.values().first().value().visit(
 | |
|                         [&](const auto& value) { offset = value; },
 | |
|                         [&](const FunctionAddress&) { instantiation_result = InstantiationError { "Data segment offset returned an address" }; },
 | |
|                         [&](const ExternAddress&) { instantiation_result = InstantiationError { "Data segment offset returned an address" }; });
 | |
|                     if (instantiation_result.has_value() && instantiation_result->is_error())
 | |
|                         return;
 | |
|                     if (m_module_instance.memories().size() <= data.index.value()) {
 | |
|                         instantiation_result = InstantiationError { String::formatted("Data segment referenced out-of-bounds memory ({}) of max {} entries", data.index.value(), m_module_instance.memories().size()) };
 | |
|                         return;
 | |
|                     }
 | |
|                     auto address = m_module_instance.memories()[data.index.value()];
 | |
|                     if (auto instance = m_store.get(address)) {
 | |
|                         if (instance->type().limits().max().value_or(data.init.size() + offset + 1) <= data.init.size() + offset) {
 | |
|                             instantiation_result = InstantiationError { String::formatted("Data segment attempted to write to out-of-bounds memory ({}) of max {} bytes", data.init.size() + offset, instance->type().limits().max().value()) };
 | |
|                             return;
 | |
|                         }
 | |
|                         instance->grow(data.init.size() + offset - instance->size());
 | |
|                         instance->data().overwrite(offset, data.init.data(), data.init.size());
 | |
|                     }
 | |
|                 },
 | |
|                 [&](const DataSection::Data::Passive&) {
 | |
|                     // FIXME: What do we do here?
 | |
|                 });
 | |
|         }
 | |
|     });
 | |
| 
 | |
|     module.for_each_section_of_type<StartSection>([&](auto&) {
 | |
|         instantiation_result = InstantiationError { "Start section not yet implemented" };
 | |
|         // FIXME: Invoke the start function.
 | |
|     });
 | |
| 
 | |
|     return instantiation_result.value_or({});
 | |
| }
 | |
| 
 | |
| InstantiationResult AbstractMachine::allocate_all(const Module& module, Vector<ExternValue>& externs, Vector<Value>& global_values)
 | |
| {
 | |
|     Optional<InstantiationResult> result;
 | |
| 
 | |
|     for (auto& entry : externs) {
 | |
|         entry.visit(
 | |
|             [&](const FunctionAddress& address) { m_module_instance.functions().append(address); },
 | |
|             [&](const TableAddress& address) { m_module_instance.tables().append(address); },
 | |
|             [&](const MemoryAddress& address) { m_module_instance.memories().append(address); },
 | |
|             [&](const GlobalAddress& address) { m_module_instance.globals().append(address); });
 | |
|     }
 | |
| 
 | |
|     // FIXME: What if this fails?
 | |
| 
 | |
|     for (auto& func : module.functions()) {
 | |
|         auto address = m_store.allocate(m_module_instance, func);
 | |
|         VERIFY(address.has_value());
 | |
|         m_module_instance.functions().append(*address);
 | |
|     }
 | |
| 
 | |
|     module.for_each_section_of_type<TableSection>([&](const TableSection& section) {
 | |
|         for (auto& table : section.tables()) {
 | |
|             auto table_address = m_store.allocate(table.type());
 | |
|             VERIFY(table_address.has_value());
 | |
|             m_module_instance.tables().append(*table_address);
 | |
|         }
 | |
|     });
 | |
| 
 | |
|     module.for_each_section_of_type<MemorySection>([&](const MemorySection& section) {
 | |
|         for (auto& memory : section.memories()) {
 | |
|             auto memory_address = m_store.allocate(memory.type());
 | |
|             VERIFY(memory_address.has_value());
 | |
|             m_module_instance.memories().append(*memory_address);
 | |
|         }
 | |
|     });
 | |
| 
 | |
|     module.for_each_section_of_type<GlobalSection>([&](const GlobalSection& section) {
 | |
|         size_t index = 0;
 | |
|         for (auto& entry : section.entries()) {
 | |
|             auto address = m_store.allocate(entry.type(), global_values[index]);
 | |
|             VERIFY(address.has_value());
 | |
|             m_module_instance.globals().append(*address);
 | |
|             index++;
 | |
|         }
 | |
|     });
 | |
| 
 | |
|     module.for_each_section_of_type<ExportSection>([&](const ExportSection& section) {
 | |
|         for (auto& entry : section.entries()) {
 | |
|             Variant<FunctionAddress, TableAddress, MemoryAddress, GlobalAddress, Empty> address { Empty {} };
 | |
|             entry.description().visit(
 | |
|                 [&](const FunctionIndex& index) {
 | |
|                     if (m_module_instance.functions().size() > index.value())
 | |
|                         address = FunctionAddress { m_module_instance.functions()[index.value()] };
 | |
|                     else
 | |
|                         dbgln("Failed to export '{}', the exported address ({}) was out of bounds (min: 0, max: {})", entry.name(), index.value(), m_module_instance.functions().size());
 | |
|                 },
 | |
|                 [&](const TableIndex& index) {
 | |
|                     if (m_module_instance.tables().size() > index.value())
 | |
|                         address = TableAddress { m_module_instance.tables()[index.value()] };
 | |
|                     else
 | |
|                         dbgln("Failed to export '{}', the exported address ({}) was out of bounds (min: 0, max: {})", entry.name(), index.value(), m_module_instance.tables().size());
 | |
|                 },
 | |
|                 [&](const MemoryIndex& index) {
 | |
|                     if (m_module_instance.memories().size() > index.value())
 | |
|                         address = MemoryAddress { m_module_instance.memories()[index.value()] };
 | |
|                     else
 | |
|                         dbgln("Failed to export '{}', the exported address ({}) was out of bounds (min: 0, max: {})", entry.name(), index.value(), m_module_instance.memories().size());
 | |
|                 },
 | |
|                 [&](const GlobalIndex& index) {
 | |
|                     if (m_module_instance.globals().size() > index.value())
 | |
|                         address = GlobalAddress { m_module_instance.globals()[index.value()] };
 | |
|                     else
 | |
|                         dbgln("Failed to export '{}', the exported address ({}) was out of bounds (min: 0, max: {})", entry.name(), index.value(), m_module_instance.globals().size());
 | |
|                 });
 | |
| 
 | |
|             if (address.has<Empty>()) {
 | |
|                 result = InstantiationError { "An export could not be resolved" };
 | |
|                 continue;
 | |
|             }
 | |
| 
 | |
|             m_module_instance.exports().append(ExportInstance {
 | |
|                 entry.name(),
 | |
|                 move(address).downcast<FunctionAddress, TableAddress, MemoryAddress, GlobalAddress>(),
 | |
|             });
 | |
|         }
 | |
|     });
 | |
| 
 | |
|     return result.value_or({});
 | |
| }
 | |
| 
 | |
| Result AbstractMachine::invoke(FunctionAddress address, Vector<Value> arguments)
 | |
| {
 | |
|     return Configuration { m_store }.call(address, move(arguments));
 | |
| }
 | |
| 
 | |
| }
 |