gin/v8_initializer.h

   1 // Copyright 2013 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef GIN_V8_INITIALIZER_H_
   6 #define GIN_V8_INITIALIZER_H_
   7
   8 #include "base/files/file.h"
   9 #include "gin/array_buffer.h"
  10 #include "gin/gin_export.h"
  11 #include "gin/public/isolate_holder.h"
  12 #include "gin/public/v8_platform.h"
  13 #include "v8/include/v8.h"
  14
  15 namespace gin {
  16
  17 class GIN_EXPORT V8Initializer {
  18  public:
  19   // This should be called by IsolateHolder::Initialize().
  20   static void Initialize(gin::IsolateHolder::ScriptMode mode);
  21
  22   // Get address and size information for currently loaded snapshot.
  23   // If no snapshot is loaded, the return values are null for addresses
  24   // and 0 for sizes.
  25   static void GetV8ExternalSnapshotData(const char** natives_data_out,
  26                                         int* natives_size_out,
  27                                         const char** snapshot_data_out,
  28                                         int* snapshot_size_out);
  29
  30 #if defined(V8_USE_EXTERNAL_STARTUP_DATA)
  31
  32   // Load V8 snapshot from user provided platform file descriptors.
  33   // The offset and size arguments, if non-zero, specify the portions
  34   // of the files to be loaded. Since the VM can boot with or without
  35   // the snapshot, this function does not return a status.
  36   static void LoadV8SnapshotFromFD(base::PlatformFile snapshot_fd,
  37                                    int64 snapshot_offset,
  38                                    int64 snapshot_size);
  39   // Similar to LoadV8SnapshotFromFD, but for the source of the natives.
  40   // Without the natives we cannot continue, so this function contains
  41   // release mode asserts and won't return if it fails.
  42   static void LoadV8NativesFromFD(base::PlatformFile natives_fd,
  43                                   int64 natives_offset,
  44                                   int64 natives_size);
  45
  46   // Load V8 snapshot from default resources, if they are available.
  47   static void LoadV8Snapshot();
  48
  49   // Load V8 natives source from default resources. Contains asserts
  50   // so that it will not return if natives cannot be loaded.
  51   static void LoadV8Natives();
  52
  53   // Opens the V8 snapshot data files and returns open file descriptors to these
  54   // files in |natives_fd_out| and |snapshot_fd_out|, which can be passed to
  55   // child processes.
  56   static bool OpenV8FilesForChildProcesses(base::PlatformFile* natives_fd_out,
  57                                            base::PlatformFile* snapshot_fd_out)
  58       WARN_UNUSED_RESULT;
  59 #endif  // V8_USE_EXTERNAL_STARTUP_DATA
  60 };
  61
  62 }  // namespace gin
  63
  64 #endif  // GIN_V8_INITIALIZER_H_