a0c3797461
TBR=bmeurer@chromium.org,leszeks@chromium.org Bug: v8:9247 Change-Id: I8d14d0192ea8c705f8274e8e61a162531826edb6 Reviewed-on: https://chromium-review.googlesource.com/c/v8/v8/+/1624220 Reviewed-by: Yang Guo <yangguo@chromium.org> Reviewed-by: Hannes Payer <hpayer@chromium.org> Reviewed-by: Andreas Haas <ahaas@chromium.org> Cr-Commit-Position: refs/heads/master@{#61769}
126 lines
4.7 KiB
C++
126 lines
4.7 KiB
C++
// Copyright 2016 the V8 project authors. All rights reserved.
|
|
// Use of this source code is governed by a BSD-style license that can be
|
|
// found in the LICENSE file.
|
|
|
|
#ifndef V8_WASM_MODULE_RUNNER_H_
|
|
#define V8_WASM_MODULE_RUNNER_H_
|
|
|
|
#include "src/execution/isolate.h"
|
|
#include "src/objects/objects.h"
|
|
#include "src/wasm/wasm-interpreter.h"
|
|
#include "src/wasm/wasm-module.h"
|
|
#include "src/wasm/wasm-objects.h"
|
|
#include "src/wasm/wasm-result.h"
|
|
#include "src/zone/zone.h"
|
|
|
|
namespace v8 {
|
|
namespace internal {
|
|
|
|
template <typename T>
|
|
class Handle;
|
|
|
|
template <typename T>
|
|
class MaybeHandle;
|
|
|
|
namespace wasm {
|
|
namespace testing {
|
|
|
|
// Decodes the given encoded module.
|
|
std::shared_ptr<WasmModule> DecodeWasmModuleForTesting(
|
|
Isolate* isolate, ErrorThrower* thrower, const byte* module_start,
|
|
const byte* module_end, ModuleOrigin origin, bool verify_functions = false);
|
|
|
|
// Returns a MaybeHandle to the JsToWasm wrapper of the wasm function exported
|
|
// with the given name by the provided instance.
|
|
MaybeHandle<WasmExportedFunction> GetExportedFunction(
|
|
Isolate* isolate, Handle<WasmInstanceObject> instance, const char* name);
|
|
|
|
// Call an exported wasm function by name. Returns -1 if the export does not
|
|
// exist or throws an error. Errors are cleared from the isolate before
|
|
// returning.
|
|
int32_t CallWasmFunctionForTesting(Isolate* isolate,
|
|
Handle<WasmInstanceObject> instance,
|
|
ErrorThrower* thrower, const char* name,
|
|
int argc, Handle<Object> argv[]);
|
|
|
|
// Interprets an exported wasm function by name. Returns false if it was not
|
|
// possible to execute the function (e.g. because it does not exist), or if the
|
|
// interpretation does not finish after kMaxNumSteps. Otherwise returns true.
|
|
// The arguments array is extended with default values if necessary.
|
|
bool InterpretWasmModuleForTesting(Isolate* isolate,
|
|
Handle<WasmInstanceObject> instance,
|
|
const char* name, size_t argc,
|
|
WasmValue* args);
|
|
|
|
// Decode, verify, and run the function labeled "main" in the
|
|
// given encoded module. The module should have no imports.
|
|
int32_t CompileAndRunWasmModule(Isolate* isolate, const byte* module_start,
|
|
const byte* module_end);
|
|
|
|
// Decode and compile the given module with no imports.
|
|
MaybeHandle<WasmModuleObject> CompileForTesting(Isolate* isolate,
|
|
ErrorThrower* thrower,
|
|
const ModuleWireBytes& bytes);
|
|
|
|
// Decode, compile, and instantiate the given module with no imports.
|
|
MaybeHandle<WasmInstanceObject> CompileAndInstantiateForTesting(
|
|
Isolate* isolate, ErrorThrower* thrower, const ModuleWireBytes& bytes);
|
|
|
|
class WasmInterpretationResult {
|
|
public:
|
|
static WasmInterpretationResult Stopped() { return {kStopped, 0, false}; }
|
|
static WasmInterpretationResult Trapped(bool possible_nondeterminism) {
|
|
return {kTrapped, 0, possible_nondeterminism};
|
|
}
|
|
static WasmInterpretationResult Finished(int32_t result,
|
|
bool possible_nondeterminism) {
|
|
return {kFinished, result, possible_nondeterminism};
|
|
}
|
|
|
|
bool stopped() const { return status_ == kStopped; }
|
|
bool trapped() const { return status_ == kTrapped; }
|
|
bool finished() const { return status_ == kFinished; }
|
|
|
|
int32_t result() const {
|
|
DCHECK_EQ(status_, kFinished);
|
|
return result_;
|
|
}
|
|
|
|
bool possible_nondeterminism() const { return possible_nondeterminism_; }
|
|
|
|
private:
|
|
enum Status { kFinished, kTrapped, kStopped };
|
|
|
|
const Status status_;
|
|
const int32_t result_;
|
|
const bool possible_nondeterminism_;
|
|
|
|
WasmInterpretationResult(Status status, int32_t result,
|
|
bool possible_nondeterminism)
|
|
: status_(status),
|
|
result_(result),
|
|
possible_nondeterminism_(possible_nondeterminism) {}
|
|
};
|
|
|
|
// Interprets the given module, starting at the function specified by
|
|
// {function_index}. The return type of the function has to be int32. The module
|
|
// should not have any imports or exports
|
|
WasmInterpretationResult InterpretWasmModule(
|
|
Isolate* isolate, Handle<WasmInstanceObject> instance,
|
|
int32_t function_index, WasmValue* args);
|
|
|
|
// Runs the module instance with arguments.
|
|
int32_t RunWasmModuleForTesting(Isolate* isolate,
|
|
Handle<WasmInstanceObject> instance, int argc,
|
|
Handle<Object> argv[]);
|
|
|
|
// Install function map, module symbol for testing
|
|
void SetupIsolateForWasmModule(Isolate* isolate);
|
|
|
|
} // namespace testing
|
|
} // namespace wasm
|
|
} // namespace internal
|
|
} // namespace v8
|
|
|
|
#endif // V8_WASM_MODULE_RUNNER_H_
|