Gecko [ c.stage.kornherr.net ]

Name	Size	Permission	Date
crypto	[ DIR ]	drwxr-xr-x	2024-07-10 10:55
permission	[ DIR ]	drwxr-xr-x	2024-07-10 10:55
tracing	[ DIR ]	drwxr-xr-x	2024-07-10 10:55
acorn_version.h	209 B	-rw-r--r--	2024-04-18 19:08
aliased_buffer-inl.h	7.44 KB	-rw-r--r--	2024-02-13 21:40
aliased_buffer.h	6.05 KB	-rw-r--r--	2024-02-13 21:40
aliased_struct-inl.h	1.32 KB	-rw-r--r--	2024-02-13 21:40
aliased_struct.h	1.44 KB	-rw-r--r--	2024-02-13 21:40
async_wrap-inl.h	2.68 KB	-rw-r--r--	2024-02-13 21:40
async_wrap.h	11.32 KB	-rw-r--r--	2024-02-13 21:40
base64-inl.h	5.76 KB	-rw-r--r--	2024-02-13 21:40
base64.h	1.43 KB	-rw-r--r--	2024-02-13 21:40
base64_version.h	227 B	-rw-r--r--	2024-02-13 21:40
base_object-inl.h	8.94 KB	-rw-r--r--	2024-02-13 21:40
base_object.h	13.3 KB	-rw-r--r--	2024-02-13 21:40
base_object_types.h	3.28 KB	-rw-r--r--	2024-02-13 21:40
blob_serializer_deserializer-inl.h	10.54 KB	-rw-r--r--	2024-02-13 21:40
blob_serializer_deserializer.h	3.56 KB	-rw-r--r--	2024-02-13 21:40
callback_queue-inl.h	2.59 KB	-rw-r--r--	2024-02-13 21:40
callback_queue.h	1.96 KB	-rw-r--r--	2024-02-13 21:40
cares_wrap.h	14.37 KB	-rw-r--r--	2024-04-18 19:08
cjs_module_lexer_version.h	277 B	-rw-r--r--	2024-04-18 19:08
cleanup_queue-inl.h	1.58 KB	-rw-r--r--	2024-02-13 21:40
cleanup_queue.h	2.19 KB	-rw-r--r--	2024-02-13 21:40
connect_wrap.h	584 B	-rw-r--r--	2024-02-13 21:40
connection_wrap.h	686 B	-rw-r--r--	2024-02-13 21:40
debug_utils-inl.h	7.42 KB	-rw-r--r--	2024-02-13 21:40
debug_utils.h	6.77 KB	-rw-r--r--	2024-02-13 21:40
diagnosticfilename-inl.h	768 B	-rw-r--r--	2024-02-13 21:40
env-inl.h	25.59 KB	-rw-r--r--	2024-02-13 21:40
env.h	38.85 KB	-rw-r--r--	2024-02-13 21:40
env_properties.h	33.32 KB	-rw-r--r--	2024-02-13 21:40
handle_wrap.h	4.16 KB	-rw-r--r--	2024-02-13 21:40
histogram-inl.h	2.39 KB	-rw-r--r--	2024-02-13 21:40
histogram.h	7.89 KB	-rw-r--r--	2024-02-13 21:40
inspector_agent.h	4.69 KB	-rw-r--r--	2024-02-13 21:40
inspector_io.h	2.19 KB	-rw-r--r--	2024-02-13 21:40
inspector_profiler.h	4.53 KB	-rw-r--r--	2024-02-13 21:40
inspector_socket.h	1.53 KB	-rw-r--r--	2024-02-13 21:40
inspector_socket_server.h	3.5 KB	-rw-r--r--	2024-02-13 21:40
js_native_api.h	31.22 KB	-rw-r--r--	2024-02-13 21:40
js_native_api_types.h	4.44 KB	-rw-r--r--	2024-02-13 21:40
js_native_api_v8.h	16.83 KB	-rw-r--r--	2024-02-13 21:40
js_native_api_v8_internals.h	1.56 KB	-rw-r--r--	2024-02-13 21:40
js_stream.h	1.35 KB	-rw-r--r--	2024-02-13 21:40
json_utils.h	3.8 KB	-rw-r--r--	2024-02-13 21:40
memory_tracker-inl.h	12.01 KB	-rw-r--r--	2024-02-13 21:40
memory_tracker.h	11.55 KB	-rw-r--r--	2024-02-13 21:40
module_wrap.h	3.72 KB	-rw-r--r--	2024-02-13 21:40
node.h	56.44 KB	-rw-r--r--	2024-02-13 21:40
node_api.h	9.96 KB	-rw-r--r--	2024-02-13 21:40
node_api_internals.h	1.24 KB	-rw-r--r--	2024-02-13 21:40
node_api_types.h	1.57 KB	-rw-r--r--	2024-02-13 21:40
node_binding.h	4.19 KB	-rw-r--r--	2024-02-13 21:40
node_blob.h	5.04 KB	-rw-r--r--	2024-02-13 21:40
node_bob-inl.h	657 B	-rw-r--r--	2024-02-13 21:40
node_bob.h	2.82 KB	-rw-r--r--	2024-02-13 21:40
node_buffer.h	3.6 KB	-rw-r--r--	2024-02-13 21:40
node_builtins.h	5.63 KB	-rw-r--r--	2024-02-13 21:40
node_constants.h	3.67 KB	-rw-r--r--	2024-02-13 21:40
node_context_data.h	2.94 KB	-rw-r--r--	2024-02-13 21:40
node_contextify.h	7.63 KB	-rw-r--r--	2024-02-13 21:40
node_crypto.h	2.27 KB	-rw-r--r--	2024-02-13 21:40
node_dir.h	1.31 KB	-rw-r--r--	2024-02-13 21:40
node_dtrace.h	2.89 KB	-rw-r--r--	2024-02-13 21:40
node_errors.h	16.86 KB	-rw-r--r--	2024-02-13 21:40
node_external_reference.h	7.86 KB	-rw-r--r--	2024-02-13 21:40
node_file-inl.h	12.45 KB	-rw-r--r--	2024-02-13 21:40
node_file.h	14.7 KB	-rw-r--r--	2024-02-13 21:40
node_http2.h	38.61 KB	-rw-r--r--	2024-02-13 21:40
node_http2_state.h	4.76 KB	-rw-r--r--	2024-02-13 21:40
node_http_common-inl.h	5.46 KB	-rw-r--r--	2024-02-13 21:40
node_http_common.h	24.56 KB	-rw-r--r--	2024-02-13 21:40
node_i18n.h	4.34 KB	-rw-r--r--	2024-02-13 21:40
node_internals.h	15.03 KB	-rw-r--r--	2024-02-13 21:40
node_main_instance.h	2.96 KB	-rw-r--r--	2024-02-13 21:40
node_mem-inl.h	3.6 KB	-rw-r--r--	2024-02-13 21:40
node_mem.h	1.27 KB	-rw-r--r--	2024-02-13 21:40
node_messaging.h	14.3 KB	-rw-r--r--	2024-02-13 21:40
node_metadata.h	4.37 KB	-rw-r--r--	2024-02-13 21:40
node_mutex.h	7.78 KB	-rw-r--r--	2024-02-13 21:40
node_object_wrap.h	3.78 KB	-rw-r--r--	2024-02-13 21:40
node_options-inl.h	15.86 KB	-rw-r--r--	2024-02-13 21:40
node_options.h	17.57 KB	-rw-r--r--	2024-02-13 21:40
node_perf.h	4.76 KB	-rw-r--r--	2024-02-13 21:40
node_perf_common.h	2.88 KB	-rw-r--r--	2024-02-13 21:40
node_platform.h	6.19 KB	-rw-r--r--	2024-02-13 21:40
node_process-inl.h	737 B	-rw-r--r--	2024-02-13 21:40
node_process.h	3.36 KB	-rw-r--r--	2024-02-13 21:40
node_realm-inl.h	4.59 KB	-rw-r--r--	2024-02-13 21:40
node_realm.h	5.38 KB	-rw-r--r--	2024-02-13 21:40
node_report.h	994 B	-rw-r--r--	2024-02-13 21:40
node_revert.h	2.09 KB	-rw-r--r--	2024-02-13 21:40
node_root_certs.h	231.49 KB	-rw-r--r--	2024-02-13 21:40
node_sea.h	517 B	-rw-r--r--	2024-02-13 21:40
node_shadow_realm.h	449 B	-rw-r--r--	2024-02-13 21:40
node_snapshot_builder.h	1.21 KB	-rw-r--r--	2024-02-13 21:40
node_snapshotable.h	4.82 KB	-rw-r--r--	2024-02-13 21:40
node_sockaddr-inl.h	7.28 KB	-rw-r--r--	2024-02-13 21:40
node_sockaddr.h	12.91 KB	-rw-r--r--	2024-02-13 21:40
node_stat_watcher.h	2.36 KB	-rw-r--r--	2024-02-13 21:40
node_threadsafe_cow-inl.h	1.28 KB	-rw-r--r--	2024-02-13 21:40
node_threadsafe_cow.h	2.78 KB	-rw-r--r--	2024-02-13 21:40
node_union_bytes.h	1.66 KB	-rw-r--r--	2024-02-13 21:40
node_url.h	2.13 KB	-rw-r--r--	2024-02-13 21:40
node_util.h	1.39 KB	-rw-r--r--	2024-02-13 21:40
node_v8.h	1.67 KB	-rw-r--r--	2024-02-13 21:40
node_v8_platform-inl.h	6.63 KB	-rw-r--r--	2024-02-13 21:40
node_version.h	3.85 KB	-rw-r--r--	2024-04-18 19:08
node_wasi.h	5.21 KB	-rw-r--r--	2024-02-13 21:40
node_wasm_web_api.h	1.78 KB	-rw-r--r--	2024-02-13 21:40
node_watchdog.h	4.32 KB	-rw-r--r--	2024-02-13 21:40
node_win32_etw_provider-inl.h	11.53 KB	-rw-r--r--	2024-02-13 21:40
node_win32_etw_provider.h	3.67 KB	-rw-r--r--	2024-02-13 21:40
node_worker.h	4.92 KB	-rw-r--r--	2024-02-13 21:40
pipe_wrap.h	2.78 KB	-rw-r--r--	2024-02-13 21:40
req_wrap-inl.h	5.43 KB	-rw-r--r--	2024-02-13 21:40
req_wrap.h	2.23 KB	-rw-r--r--	2024-02-13 21:40
spawn_sync.h	6.87 KB	-rw-r--r--	2024-02-13 21:40
stream_base-inl.h	4.93 KB	-rw-r--r--	2024-02-13 21:40
stream_base.h	17.44 KB	-rw-r--r--	2024-02-13 21:40
stream_pipe.h	2.39 KB	-rw-r--r--	2024-02-13 21:40
stream_wrap.h	4.15 KB	-rw-r--r--	2024-02-13 21:40
string_bytes.h	4.69 KB	-rw-r--r--	2024-02-13 21:40
string_decoder-inl.h	858 B	-rw-r--r--	2024-02-13 21:40
string_decoder.h	1.5 KB	-rw-r--r--	2024-02-13 21:40
string_search.h	20.94 KB	-rw-r--r--	2024-02-13 21:40
tcp_wrap.h	3.9 KB	-rw-r--r--	2024-02-13 21:40
threadpoolwork-inl.h	2.58 KB	-rw-r--r--	2024-02-13 21:40
timer_wrap-inl.h	755 B	-rw-r--r--	2024-02-13 21:40
timer_wrap.h	1.79 KB	-rw-r--r--	2024-02-13 21:40
tty_wrap.h	2.27 KB	-rw-r--r--	2024-02-13 21:40
udp_wrap.h	8.5 KB	-rw-r--r--	2024-02-13 21:40
undici_version.h	215 B	-rw-r--r--	2024-04-18 19:08
util-inl.h	19.56 KB	-rw-r--r--	2024-02-13 21:40
util.h	31.46 KB	-rw-r--r--	2024-02-13 21:40
v8abbr.h	5.05 KB	-rw-r--r--	2024-02-13 21:40

Rename

#ifndef SRC_NODE_REALM_H_
#define SRC_NODE_REALM_H_

#if defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS

#include <v8.h>
#include <unordered_map>
#include "cleanup_queue.h"
#include "env_properties.h"
#include "memory_tracker.h"
#include "node_snapshotable.h"

namespace node {

struct RealmSerializeInfo {
  std::vector<std::string> builtins;
  std::vector<PropInfo> persistent_values;
  std::vector<PropInfo> native_objects;

SnapshotIndex context;
  friend std::ostream& operator<<(std::ostream& o, const RealmSerializeInfo& i);
};

using BindingDataStore = std::array<BaseObjectPtr<BaseObject>,
                     static_cast<size_t>(
                         BindingDataType::kBindingDataTypeCount)>;

/**
 * node::Realm is a container for a set of JavaScript objects and functions
 * that associated with a particular global environment.
 *
 * An ECMAScript realm (https://tc39.es/ecma262/#sec-code-realms) representing
 * a global environment in which script is run. Each ECMAScript realm comes
 * with a global object and a set of intrinsic objects. An ECMAScript realm has
 * a [[HostDefined]] field, which contains the node::Realm object.
 *
 * Realm can be a principal realm or a synthetic realm. A principal realm is
 * created with an Environment as its principal global environment to evaluate
 * scripts. A synthetic realm is created with JS APIs like ShadowRealm.
 *
 * Native bindings and builtin modules can be evaluated in either a principal
 * realm or a synthetic realm.
 */
class Realm : public MemoryRetainer {
 public:
  static inline Realm* GetCurrent(v8::Isolate* isolate);
  static inline Realm* GetCurrent(v8::Local<v8::Context> context);
  static inline Realm* GetCurrent(
      const v8::FunctionCallbackInfo<v8::Value>& info);
  template <typename T>
  static inline Realm* GetCurrent(const v8::PropertyCallbackInfo<T>& info);

Realm(Environment* env,
        v8::Local<v8::Context> context,
        const RealmSerializeInfo* realm_info);
  ~Realm();

Realm(const Realm&) = delete;
  Realm& operator=(const Realm&) = delete;
  Realm(Realm&&) = delete;
  Realm& operator=(Realm&&) = delete;

SET_MEMORY_INFO_NAME(Realm)
  SET_SELF_SIZE(Realm)
  void MemoryInfo(MemoryTracker* tracker) const override;

void CreateProperties();
  RealmSerializeInfo Serialize(v8::SnapshotCreator* creator);
  void DeserializeProperties(const RealmSerializeInfo* info);

v8::MaybeLocal<v8::Value> ExecuteBootstrapper(const char* id);
  v8::MaybeLocal<v8::Value> BootstrapNode();
  v8::MaybeLocal<v8::Value> RunBootstrapping();

inline void AddCleanupHook(CleanupQueue::Callback cb, void* arg);
  inline void RemoveCleanupHook(CleanupQueue::Callback cb, void* arg);
  inline bool HasCleanupHooks() const;
  void RunCleanup();

template <typename T>
  void ForEachBaseObject(T&& iterator) const;

void PrintInfoForSnapshot();
  void VerifyNoStrongBaseObjects();

inline IsolateData* isolate_data() const;
  inline Environment* env() const;
  inline v8::Isolate* isolate() const;
  inline v8::Local<v8::Context> context() const;
  inline bool has_run_bootstrapping_code() const;

// Methods created using SetMethod(), SetPrototypeMethod(), etc. inside
  // this scope can access the created T* object using
  // GetBindingData<T>(args) later.
  template <typename T>
  T* AddBindingData(v8::Local<v8::Context> context,
                    v8::Local<v8::Object> target);
  template <typename T, typename U>
  static inline T* GetBindingData(const v8::PropertyCallbackInfo<U>& info);
  template <typename T>
  static inline T* GetBindingData(
      const v8::FunctionCallbackInfo<v8::Value>& info);
  template <typename T>
  static inline T* GetBindingData(v8::Local<v8::Context> context);
  inline BindingDataStore* binding_data_store();

// The BaseObject count is a debugging helper that makes sure that there are
  // no memory leaks caused by BaseObjects staying alive longer than expected
  // (in particular, no circular BaseObjectPtr references).
  inline void modify_base_object_count(int64_t delta);
  inline int64_t base_object_count() const;

// Base object count created after the bootstrap of the realm.
  inline int64_t base_object_created_after_bootstrap() const;

#define V(PropertyName, TypeName)                                              \
  inline v8::Local<TypeName> PropertyName() const;                             \
  inline void set_##PropertyName(v8::Local<TypeName> value);
  PER_REALM_STRONG_PERSISTENT_VALUES(V)
#undef V

std::set<struct node_module*> internal_bindings;
  std::set<std::string> builtins_with_cache;
  std::set<std::string> builtins_without_cache;
  // This is only filled during deserialization. We use a vector since
  // it's only used for tests.
  std::vector<std::string> builtins_in_snapshot;

private:
  void InitializeContext(v8::Local<v8::Context> context,
                         const RealmSerializeInfo* realm_info);
  void DoneBootstrapping();

Environment* env_;
  // Shorthand for isolate pointer.
  v8::Isolate* isolate_;
  v8::Global<v8::Context> context_;
  bool has_run_bootstrapping_code_ = false;

int64_t base_object_count_ = 0;
  int64_t base_object_created_by_bootstrap_ = 0;

BindingDataStore binding_data_store_;

CleanupQueue cleanup_queue_;

#define V(PropertyName, TypeName) v8::Global<TypeName> PropertyName##_;
  PER_REALM_STRONG_PERSISTENT_VALUES(V)
#undef V
};

}  // namespace node

#endif  // defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS

#endif  // SRC_NODE_REALM_H_