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_ALIASED_BUFFER_H_
#define SRC_ALIASED_BUFFER_H_

#if defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS

#include <cinttypes>
#include "memory_tracker.h"
#include "v8.h"

namespace node {

typedef size_t AliasedBufferIndex;

/**
 * Do not use this class directly when creating instances of it - use the
 * Aliased*Array defined at the end of this file instead.
 *
 * This class encapsulates the technique of having a native buffer mapped to
 * a JS object. Writes to the native buffer can happen efficiently without
 * going through JS, and the data is then available to user's via the exposed
 * JS object.
 *
 * While this technique is computationally efficient, it is effectively a
 * write to JS program state w/out going through the standard
 * (monitored) API. Thus any VM capabilities to detect the modification are
 * circumvented.
 *
 * The encapsulation herein provides a placeholder where such writes can be
 * observed. Any notification APIs will be left as a future exercise.
 */
template <class NativeT, class V8T>
class AliasedBufferBase : public MemoryRetainer {
 public:
  static_assert(std::is_scalar<NativeT>::value);

AliasedBufferBase(v8::Isolate* isolate,
                    const size_t count,
                    const AliasedBufferIndex* index = nullptr);

/**
   * Create an AliasedBufferBase over a sub-region of another aliased buffer.
   * The two will share a v8::ArrayBuffer instance &
   * a native buffer, but will each read/write to different sections of the
   * native buffer.
   *
   *  Note that byte_offset must by aligned by sizeof(NativeT).
   */
  // TODO(refack): refactor into a non-owning `AliasedBufferBaseView`
  AliasedBufferBase(
      v8::Isolate* isolate,
      const size_t byte_offset,
      const size_t count,
      const AliasedBufferBase<uint8_t, v8::Uint8Array>& backing_buffer,
      const AliasedBufferIndex* index = nullptr);

AliasedBufferBase(const AliasedBufferBase& that);

AliasedBufferIndex Serialize(v8::Local<v8::Context> context,
                               v8::SnapshotCreator* creator);

inline void Deserialize(v8::Local<v8::Context> context);

AliasedBufferBase& operator=(AliasedBufferBase&& that) noexcept;

/**
   * Helper class that is returned from operator[] to support assignment into
   * a specified location.
   */
  class Reference {
   public:
    Reference(AliasedBufferBase<NativeT, V8T>* aliased_buffer, size_t index)
        : aliased_buffer_(aliased_buffer), index_(index) {}

Reference(const Reference& that)
        : aliased_buffer_(that.aliased_buffer_),
          index_(that.index_) {
    }

inline Reference& operator=(const NativeT& val) {
      aliased_buffer_->SetValue(index_, val);
      return *this;
    }

inline Reference& operator=(const Reference& val) {
      return *this = static_cast<NativeT>(val);
    }

operator NativeT() const {
      return aliased_buffer_->GetValue(index_);
    }

inline Reference& operator+=(const NativeT& val) {
      const NativeT current = aliased_buffer_->GetValue(index_);
      aliased_buffer_->SetValue(index_, current + val);
      return *this;
    }

inline Reference& operator+=(const Reference& val) {
      return this->operator+=(static_cast<NativeT>(val));
    }

inline Reference& operator-=(const NativeT& val) {
      const NativeT current = aliased_buffer_->GetValue(index_);
      aliased_buffer_->SetValue(index_, current - val);
      return *this;
    }

private:
    AliasedBufferBase<NativeT, V8T>* aliased_buffer_;
    size_t index_;
  };

/**
   *  Get the underlying v8 TypedArray overlayed on top of the native buffer
   */
  v8::Local<V8T> GetJSArray() const;

void Release();

/**
  *  Get the underlying v8::ArrayBuffer underlying the TypedArray and
  *  overlaying the native buffer
  */
  v8::Local<v8::ArrayBuffer> GetArrayBuffer() const;

/**
   *  Get the underlying native buffer. Note that all reads/writes should occur
   *  through the GetValue/SetValue/operator[] methods
   */
  inline const NativeT* GetNativeBuffer() const;

/**
   *  Synonym for GetBuffer()
   */
  inline const NativeT* operator*() const;

/**
   *  Set position index to given value.
   */
  inline void SetValue(const size_t index, NativeT value);

/**
   *  Get value at position index
   */
  inline const NativeT GetValue(const size_t index) const;

/**
   *  Effectively, a synonym for GetValue/SetValue
   */
  Reference operator[](size_t index);

NativeT operator[](size_t index) const;

size_t Length() const;

// Should only be used to extend the array.
  // Should only be used on an owning array, not one created as a sub array of
  // an owning `AliasedBufferBase`.
  void reserve(size_t new_capacity);

inline size_t SelfSize() const override;

inline const char* MemoryInfoName() const override;
  inline void MemoryInfo(node::MemoryTracker* tracker) const override;

private:
  v8::Isolate* isolate_ = nullptr;
  size_t count_ = 0;
  size_t byte_offset_ = 0;
  NativeT* buffer_ = nullptr;
  v8::Global<V8T> js_array_;

// Deserialize data
  const AliasedBufferIndex* index_ = nullptr;
};

#define ALIASED_BUFFER_LIST(V)                                                 \
  V(int8_t, Int8Array)                                                         \
  V(uint8_t, Uint8Array)                                                       \
  V(int16_t, Int16Array)                                                       \
  V(uint16_t, Uint16Array)                                                     \
  V(int32_t, Int32Array)                                                       \
  V(uint32_t, Uint32Array)                                                     \
  V(float, Float32Array)                                                       \
  V(double, Float64Array)                                                      \
  V(int64_t, BigInt64Array)

#define V(NativeT, V8T)                                                        \
  typedef AliasedBufferBase<NativeT, v8::V8T> Aliased##V8T;
ALIASED_BUFFER_LIST(V)
#undef V

}  // namespace node

#endif  // defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS

#endif  // SRC_ALIASED_BUFFER_H_