REDROOM

Navigation

Breadcrumbs

/ / opt / cpanel / ea-nodejs20 / include / node

Create

Create File | Create Folder | Upload Files | Run Command

Preview: v8-locker.h Size: 3.86 KB

/opt/cpanel/ea-nodejs20/include/node/v8-locker.h

// Copyright 2021 the V8 project 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 INCLUDE_V8_LOCKER_H_
#define INCLUDE_V8_LOCKER_H_

#include "v8config.h"  // NOLINT(build/include_directory)

namespace v8 {

namespace internal {
class Isolate;
}  // namespace internal

class Isolate;

/**
 * Multiple threads in V8 are allowed, but only one thread at a time is allowed
 * to use any given V8 isolate, see the comments in the Isolate class. The
 * definition of 'using a V8 isolate' includes accessing handles or holding onto
 * object pointers obtained from V8 handles while in the particular V8 isolate.
 * It is up to the user of V8 to ensure, perhaps with locking, that this
 * constraint is not violated. In addition to any other synchronization
 * mechanism that may be used, the v8::Locker and v8::Unlocker classes must be
 * used to signal thread switches to V8.
 *
 * v8::Locker is a scoped lock object. While it's active, i.e. between its
 * construction and destruction, the current thread is allowed to use the locked
 * isolate. V8 guarantees that an isolate can be locked by at most one thread at
 * any time. In other words, the scope of a v8::Locker is a critical section.
 *
 * Sample usage:
 * \code
 * ...
 * {
 *   v8::Locker locker(isolate);
 *   v8::Isolate::Scope isolate_scope(isolate);
 *   ...
 *   // Code using V8 and isolate goes here.
 *   ...
 * } // Destructor called here
 * \endcode
 *
 * If you wish to stop using V8 in a thread A you can do this either by
 * destroying the v8::Locker object as above or by constructing a v8::Unlocker
 * object:
 *
 * \code
 * {
 *   isolate->Exit();
 *   v8::Unlocker unlocker(isolate);
 *   ...
 *   // Code not using V8 goes here while V8 can run in another thread.
 *   ...
 * } // Destructor called here.
 * isolate->Enter();
 * \endcode
 *
 * The Unlocker object is intended for use in a long-running callback from V8,
 * where you want to release the V8 lock for other threads to use.
 *
 * The v8::Locker is a recursive lock, i.e. you can lock more than once in a
 * given thread. This can be useful if you have code that can be called either
 * from code that holds the lock or from code that does not. The Unlocker is
 * not recursive so you can not have several Unlockers on the stack at once, and
 * you cannot use an Unlocker in a thread that is not inside a Locker's scope.
 *
 * An unlocker will unlock several lockers if it has to and reinstate the
 * correct depth of locking on its destruction, e.g.:
 *
 * \code
 * // V8 not locked.
 * {
 *   v8::Locker locker(isolate);
 *   Isolate::Scope isolate_scope(isolate);
 *   // V8 locked.
 *   {
 *     v8::Locker another_locker(isolate);
 *     // V8 still locked (2 levels).
 *     {
 *       isolate->Exit();
 *       v8::Unlocker unlocker(isolate);
 *       // V8 not locked.
 *     }
 *     isolate->Enter();
 *     // V8 locked again (2 levels).
 *   }
 *   // V8 still locked (1 level).
 * }
 * // V8 Now no longer locked.
 * \endcode
 */
class V8_EXPORT Unlocker {
 public:
  /**
   * Initialize Unlocker for a given Isolate.
   */
  V8_INLINE explicit Unlocker(Isolate* isolate) { Initialize(isolate); }

  ~Unlocker();

 private:
  void Initialize(Isolate* isolate);

  internal::Isolate* isolate_;
};

class V8_EXPORT Locker {
 public:
  /**
   * Initialize Locker for a given Isolate.
   */
  V8_INLINE explicit Locker(Isolate* isolate) { Initialize(isolate); }

  ~Locker();

  /**
   * Returns whether or not the locker for a given isolate, is locked by the
   * current thread.
   */
  static bool IsLocked(Isolate* isolate);

  // Disallow copying and assigning.
  Locker(const Locker&) = delete;
  void operator=(const Locker&) = delete;

 private:
  void Initialize(Isolate* isolate);

  bool has_lock_;
  bool top_level_;
  internal::Isolate* isolate_;
};

}  // namespace v8

#endif  // INCLUDE_V8_LOCKER_H_

Directory Contents

Dirs: 4 × Files: 63

Sort:

Enable drag-to-move

Name	Size	Perms	Modified	Actions
cppgc DIR	-	drwxr-xr-x	2026-02-03 09:33:34	Edit Download recursive recursive
libplatform DIR	-	drwxr-xr-x	2026-02-03 09:33:34	Edit Download recursive recursive
openssl DIR	-	drwxr-xr-x	2026-02-03 09:33:34	Edit Download recursive recursive
uv DIR	-	drwxr-xr-x	2026-02-03 09:33:34	Edit Download recursive recursive
common.gypi	24.67 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
config.gypi	27.42 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
js_native_api.h	31.43 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
js_native_api_types.h	6.87 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
node.h	67.17 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
node_api.h	9.96 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
node_api_types.h	1.57 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
node_buffer.h	3.60 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
node_object_wrap.h	3.78 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
node_version.h	4.08 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
uv.h	67.74 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-array-buffer.h	17.75 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-callbacks.h	15.03 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-container.h	3.40 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-context.h	16.13 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-cppgc.h	7.46 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-data.h	1.58 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-date.h	1.19 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-debug.h	5.04 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-embedder-heap.h	1.90 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-embedder-state-scope.h	1.51 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-exception.h	6.98 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-extension.h	1.83 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-external.h	924 B	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-forward.h	1.62 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-function-callback.h	15.87 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-function.h	4.24 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-initialization.h	10.23 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-internal.h	39.18 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-isolate.h	60.97 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-json.h	1.32 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-local-handle.h	14.98 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-locker.h	3.86 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-maybe.h	4.47 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-memory-span.h	1.25 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-message.h	6.29 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-microtask-queue.h	4.95 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-microtask.h	861 B	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-object.h	28.51 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-persistent-handle.h	18.70 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-platform.h	41.37 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-primitive-object.h	2.53 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-primitive.h	27.65 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-profiler.h	40.47 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-promise.h	5.17 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-proxy.h	1.23 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-regexp.h	3.10 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-script.h	28.08 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-snapshot.h	6.97 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-statistics.h	6.80 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-template.h	37.42 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-traced-handle.h	11.85 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-typed-array.h	8.06 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-unwinder.h	4.63 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-value-serializer.h	10.09 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-value.h	13.45 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-version.h	772 B	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-wasm.h	6.00 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-weak-callback-info.h	2.41 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8.h	3.69 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8config.h	31.61 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
zconf.h	16.60 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
zlib.h	95.17 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive