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   static const int kV8SnapshotBasePathKey;
  20   static const char kNativesFileName[];
  21   static const char kSnapshotFileName[];
  22
  23   // This should be called by IsolateHolder::Initialize().
  24   static void Initialize(gin::IsolateHolder::ScriptMode mode);
  25
  26   // Get address and size information for currently loaded snapshot.
  27   // If no snapshot is loaded, the return values are null for addresses
  28   // and 0 for sizes.
  29   static void GetV8ExternalSnapshotData(const char** natives_data_out,
  30                                         int* natives_size_out,
  31                                         const char** snapshot_data_out,
  32                                         int* snapshot_size_out);
  33
  34 #if defined(V8_USE_EXTERNAL_STARTUP_DATA)
  35
  36   // Load V8 snapshot from user provided platform file descriptors.
  37   // The offset and size arguments, if non-zero, specify the portions
  38   // of the files to be loaded. This methods returns true on success
  39   // (or if snapshot is already loaded), false otherwise.
  40   static bool LoadV8SnapshotFromFD(base::PlatformFile natives_fd,
  41                                    int64 natives_offset,
  42                                    int64 natives_size,
  43                                    base::PlatformFile snapshot_fd,
  44                                    int64 snapshot_offset,
  45                                    int64 snapshot_size);
  46
  47   // Load V8 snapshot from default resources. Returns true on success or
  48   // snapshot is already loaded, false otherwise.
  49   static bool LoadV8Snapshot();
  50
  51   // Opens the V8 snapshot data files and returns open file descriptors to these
  52   // files in |natives_fd_out| and |snapshot_fd_out|, which can be passed to
  53   // child processes.
  54   static bool OpenV8FilesForChildProcesses(base::PlatformFile* natives_fd_out,
  55                                            base::PlatformFile* snapshot_fd_out);
  56
  57 #endif  // V8_USE_EXTERNAL_STARTUP_DATA
  58 };
  59
  60 }  // namespace gin
  61
  62 #endif  // GIN_V8_INITIALIZER_H_