blob: 7d16c3eb6d940e39d2ba9ad5b1f4ba22eddb753a [file] [log] [blame]
// Copyright 2013 The Chromium 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 GIN_V8_INITIALIZER_H_
#define GIN_V8_INITIALIZER_H_
#include <stdint.h>
#include "base/files/file.h"
#include "base/files/memory_mapped_file.h"
#include "gin/array_buffer.h"
#include "gin/gin_export.h"
#include "gin/public/isolate_holder.h"
#include "gin/public/v8_platform.h"
#include "v8/include/v8.h"
namespace gin {
class GIN_EXPORT V8Initializer {
public:
// This should be called by IsolateHolder::Initialize().
static void Initialize(IsolateHolder::ScriptMode mode,
IsolateHolder::V8ExtrasMode v8_extras_mode);
// Get address and size information for currently loaded snapshot.
// If no snapshot is loaded, the return values are null for addresses
// and 0 for sizes.
static void GetV8ExternalSnapshotData(const char** natives_data_out,
int* natives_size_out,
const char** snapshot_data_out,
int* snapshot_size_out);
#if defined(V8_USE_EXTERNAL_STARTUP_DATA)
// Load V8 snapshot from user provided platform file descriptors.
// The offset and size arguments, if non-zero, specify the portions
// of the files to be loaded. Since the VM can boot with or without
// the snapshot, this function does not return a status.
static void LoadV8SnapshotFromFD(base::PlatformFile snapshot_fd,
int64_t snapshot_offset,
int64_t snapshot_size);
// Similar to LoadV8SnapshotFromFD, but for the source of the natives.
// Without the natives we cannot continue, so this function contains
// release mode asserts and won't return if it fails.
static void LoadV8NativesFromFD(base::PlatformFile natives_fd,
int64_t natives_offset,
int64_t natives_size);
// Load V8 snapshot from default resources, if they are available.
static void LoadV8Snapshot();
// Load V8 natives source from default resources. Contains asserts
// so that it will not return if natives cannot be loaded.
static void LoadV8Natives();
// Opens (unless already cached) and returns the V8 natives file.
// Use with LoadV8NativesFromFD().
// Asserts if the file does not exist.
static base::PlatformFile GetOpenNativesFileForChildProcesses(
base::MemoryMappedFile::Region* region_out);
// Opens (unless already cached) and returns the V8 snapshot file.
// Use with LoadV8SnapshotFromFD().
// Will return -1 if the file does not exist.
static base::PlatformFile GetOpenSnapshotFileForChildProcesses(
base::MemoryMappedFile::Region* region_out);
#if defined(OS_ANDROID)
static base::PlatformFile GetOpenSnapshotFileForChildProcesses(
base::MemoryMappedFile::Region* region_out,
bool abi_32_bit);
static base::FilePath GetNativesFilePath();
static base::FilePath GetSnapshotFilePath(bool abi_32_bit);
#endif
#endif // V8_USE_EXTERNAL_STARTUP_DATA
};
} // namespace gin
#endif // GIN_V8_INITIALIZER_H_