node-linux-arm64 24.11.0 → 25.1.0

package/include/node/v8-traced-handle.h

@@ -181,7 +181,7 @@ class TracedReference : public BasicTracedReference<T> {
    */
   template <class S>
   TracedReference(Isolate* isolate, Local<S> that) : BasicTracedReference<T>() {
-    static_assert(std::is_base_of<T, S>::value, "type check");
+    static_assert(std::is_base_of_v<T, S>, "type check");
     if (V8_UNLIKELY(that.IsEmpty())) {
       return;
     }
@@ -202,7 +202,7 @@ class TracedReference : public BasicTracedReference<T> {
   template <class S>
   TracedReference(Isolate* isolate, Local<S> that, IsDroppable)
       : BasicTracedReference<T>() {
-    static_assert(std::is_base_of<T, S>::value, "type check");
+    static_assert(std::is_base_of_v<T, S>, "type check");
     if (V8_UNLIKELY(that.IsEmpty())) {
       return;
     }
@@ -351,7 +351,7 @@ V8_INLINE bool operator!=(const v8::Local<U>& lhs,
 template <class T>
 template <class S>
 void TracedReference<T>::Reset(Isolate* isolate, const Local<S>& other) {
-  static_assert(std::is_base_of<T, S>::value, "type check");
+  static_assert(std::is_base_of_v<T, S>, "type check");
   this->Reset();
   if (V8_UNLIKELY(other.IsEmpty())) {
     return;
@@ -366,7 +366,7 @@ template <class T>
 template <class S>
 void TracedReference<T>::Reset(Isolate* isolate, const Local<S>& other,
                                IsDroppable) {
-  static_assert(std::is_base_of<T, S>::value, "type check");
+  static_assert(std::is_base_of_v<T, S>, "type check");
   this->Reset();
   if (V8_UNLIKELY(other.IsEmpty())) {
     return;
@@ -381,7 +381,7 @@ template <class T>
 template <class S>
 TracedReference<T>& TracedReference<T>::operator=(
     TracedReference<S>&& rhs) noexcept {
-  static_assert(std::is_base_of<T, S>::value, "type check");
+  static_assert(std::is_base_of_v<T, S>, "type check");
   *this = std::move(rhs.template As<T>());
   return *this;
 }
@@ -390,7 +390,7 @@ template <class T>
 template <class S>
 TracedReference<T>& TracedReference<T>::operator=(
     const TracedReference<S>& rhs) {
-  static_assert(std::is_base_of<T, S>::value, "type check");
+  static_assert(std::is_base_of_v<T, S>, "type check");
   *this = rhs.template As<T>();
   return *this;
 }

package/include/node/v8-unwinder.h

@@ -33,6 +33,9 @@ struct V8_EXPORT RegisterState {
 };
 
 // A StateTag represents a possible state of the VM.
+// This enum is append-only to preserve compatibility with historical logs.
+// Add new states only at the end and do not reorder or remove existing values.
+// LINT.IfChange
 enum StateTag : uint16_t {
   JS,
   GC,
@@ -44,7 +47,17 @@ enum StateTag : uint16_t {
   ATOMICS_WAIT,
   IDLE,
   LOGGING,
+  IDLE_EXTERNAL,
 };
+// LINT.ThenChange(../tools/profile.mjs, ../tools/tickprocessor.mjs)
+
+constexpr bool IsExternal(StateTag state) {
+  return state == EXTERNAL || state == IDLE_EXTERNAL;
+}
+
+constexpr bool IsIdle(StateTag state) {
+  return state == IDLE || state == IDLE_EXTERNAL;
+}
 
 // The output structure filled up by GetStackSample API function.
 struct SampleInfo {

package/include/node/v8-version.h

@@ -8,10 +8,10 @@
 // These macros define the version number for the current version.
 // NOTE these macros are used by some of the tool scripts and the build
 // system so their names cannot be changed without changing the scripts.
-#define V8_MAJOR_VERSION 13
-#define V8_MINOR_VERSION 6
-#define V8_BUILD_NUMBER 233
-#define V8_PATCH_LEVEL 10
+#define V8_MAJOR_VERSION 14
+#define V8_MINOR_VERSION 1
+#define V8_BUILD_NUMBER 146
+#define V8_PATCH_LEVEL 11
 
 // Use 1 for candidates and 0 otherwise.
 // (Boolean macro values are not supported by all preprocessors.)

package/include/node/v8config.h

@@ -85,6 +85,7 @@ path. Add it with -I<path> to the command line
 //  V8_OS_DARWIN        - Darwin (macOS, iOS)
 //  V8_OS_MACOS         - macOS
 //  V8_OS_IOS           - iOS
+//  V8_OS_TVOS          - tvOS (also sets V8_OS_IOS)
 //  V8_OS_NETBSD        - NetBSD
 //  V8_OS_OPENBSD       - OpenBSD
 //  V8_OS_POSIX         - POSIX compatible (mostly everything except Windows)
@@ -108,6 +109,9 @@ path. Add it with -I<path> to the command line
 # if defined(TARGET_OS_IPHONE) && TARGET_OS_IPHONE
 #  define V8_OS_IOS 1
 #  define V8_OS_STRING "ios"
+#  if defined(TARGET_OS_TV) && TARGET_OS_TV
+#   define V8_OS_TVOS 1
+#  endif
 # else
 #  define V8_OS_MACOS 1
 #  define V8_OS_STRING "macos"
@@ -187,6 +191,7 @@ path. Add it with -I<path> to the command line
 //  V8_TARGET_OS_ANDROID
 //  V8_TARGET_OS_FUCHSIA
 //  V8_TARGET_OS_IOS
+//  V8_TARGET_OS_TVOS (also sets V8_TARGET_OS_IOS)
 //  V8_TARGET_OS_LINUX
 //  V8_TARGET_OS_MACOS
 //  V8_TARGET_OS_WIN
@@ -200,6 +205,7 @@ path. Add it with -I<path> to the command line
 # if !defined(V8_TARGET_OS_ANDROID) \
   && !defined(V8_TARGET_OS_FUCHSIA) \
   && !defined(V8_TARGET_OS_IOS) \
+  && !defined(V8_TARGET_OS_TVOS) \
   && !defined(V8_TARGET_OS_LINUX) \
   && !defined(V8_TARGET_OS_MACOS) \
   && !defined(V8_TARGET_OS_WIN) \
@@ -212,6 +218,7 @@ path. Add it with -I<path> to the command line
 # if defined(V8_TARGET_OS_ANDROID) \
   || defined(V8_TARGET_OS_FUCHSIA) \
   || defined(V8_TARGET_OS_IOS) \
+  || defined(V8_TARGET_OS_TVOS) \
   || defined(V8_TARGET_OS_LINUX) \
   || defined(V8_TARGET_OS_MACOS) \
   || defined(V8_TARGET_OS_WIN) \
@@ -232,6 +239,10 @@ path. Add it with -I<path> to the command line
 # define V8_TARGET_OS_IOS
 #endif
 
+#ifdef V8_OS_TVOS
+# define V8_TARGET_OS_TVOS
+#endif
+
 #ifdef V8_OS_LINUX
 # define V8_TARGET_OS_LINUX
 #endif
@@ -322,6 +333,7 @@ path. Add it with -I<path> to the command line
 //  V8_HAS_CPP_ATTRIBUTE_NODISCARD      - [[nodiscard]] supported
 //  V8_HAS_CPP_ATTRIBUTE_NO_UNIQUE_ADDRESS
 //                                      - [[no_unique_address]] supported
+//  V8_HAS_CPP_ATTRIBUTE_LIFETIME_BOUND - [[clang::lifetimebound]] supported
 //  V8_HAS_BUILTIN_ADD_OVERFLOW         - __builtin_add_overflow() supported
 //  V8_HAS_BUILTIN_BIT_CAST             - __builtin_bit_cast() supported
 //  V8_HAS_BUILTIN_BSWAP16              - __builtin_bswap16() supported
@@ -401,6 +413,7 @@ path. Add it with -I<path> to the command line
 # define V8_HAS_CPP_ATTRIBUTE_NO_UNIQUE_ADDRESS \
     (V8_HAS_CPP_ATTRIBUTE(no_unique_address))
 #endif
+# define V8_HAS_CPP_ATTRIBUTE_LIFETIME_BOUND (V8_HAS_CPP_ATTRIBUTE(clang::lifetimebound))
 
 # define V8_HAS_BUILTIN_ADD_OVERFLOW (__has_builtin(__builtin_add_overflow))
 # define V8_HAS_BUILTIN_ASSUME (__has_builtin(__builtin_assume))
@@ -697,6 +710,17 @@ path. Add it with -I<path> to the command line
 #define V8_NODISCARD /* NOT SUPPORTED */
 #endif
 
+
+// Annotate a function to ensure the function is retained in the compiled binary
+// even if it appears to be unused to the compiler.
+#if V8_HAS_ATTRIBUTE_USED && V8_HAS_ATTRIBUTE_VISIBILITY
+#define V8_SYMBOL_USED \
+  __attribute__((used, visibility("default")))
+#else
+#define V8_SYMBOL_USED /* NOT SUPPORTED */
+#endif
+
+
 // The no_unique_address attribute allows tail padding in a non-static data
 // member to overlap other members of the enclosing class (and in the special
 // case when the type is empty, permits it to fully overlap other members). The
@@ -726,6 +750,41 @@ path. Add it with -I<path> to the command line
 #define V8_NO_UNIQUE_ADDRESS /* NOT SUPPORTED */
 #endif
 
+// Annotates a pointer or reference parameter or return value for a member
+// function as having lifetime intertwined with the instance on which the
+// function is called. For parameters, the function is assumed to store the
+// value into the called-on object, so if the referred-to object is later
+// destroyed, the called-on object is also considered to be dangling. For return
+// values, the value is assumed to point into the called-on object, so if that
+// object is destroyed, the returned value is also considered to be dangling.
+// Useful to diagnose some cases of lifetime errors.
+//
+// See also:
+//   https://clang.llvm.org/docs/AttributeReference.html#lifetimebound
+//
+// Usage:
+// ```
+//   struct S {
+//      S(int* p V8_LIFETIME_BOUND);
+//      int* Get() V8_LIFETIME_BOUND;
+//   };
+//   S Func1() {
+//     int i = 0;
+//     // The following return will not compile; diagnosed as returning address
+//     // of a stack object.
+//     return S(&i);
+//   }
+//   int* Func2(int* p) {
+//     // The following return will not compile; diagnosed as returning address
+//     // of a local temporary.
+//     return S(p).Get();
+//   }
+#if V8_HAS_CPP_ATTRIBUTE_LIFETIME_BOUND
+#define V8_LIFETIME_BOUND [[clang::lifetimebound]]
+#else
+#define V8_LIFETIME_BOUND /* NOT SUPPORTED */
+#endif
+
 // Marks a type as being eligible for the "trivial" ABI despite having a
 // non-trivial destructor or copy/move constructor. Such types can be relocated
 // after construction by simply copying their memory, which makes them eligible
@@ -798,7 +857,8 @@ V8 shared library set USING_V8_SHARED.
 #else  // V8_OS_WIN
 
 // Setup for Linux shared library export.
-#if V8_HAS_ATTRIBUTE_VISIBILITY && (defined(BUILDING_V8_SHARED) || USING_V8_SHARED)
+#if (V8_HAS_ATTRIBUTE_VISIBILITY && \
+     (defined(BUILDING_V8_SHARED) || USING_V8_SHARED))
 # define V8_EXPORT __attribute__((visibility("default")))
 #else
 # define V8_EXPORT
@@ -909,8 +969,6 @@ V8 shared library set USING_V8_SHARED.
 #define V8_TARGET_ARCH_32_BIT 1
 #elif V8_TARGET_ARCH_ARM64
 #define V8_TARGET_ARCH_64_BIT 1
-#elif V8_TARGET_ARCH_MIPS
-#define V8_TARGET_ARCH_32_BIT 1
 #elif V8_TARGET_ARCH_MIPS64
 #define V8_TARGET_ARCH_64_BIT 1
 #elif V8_TARGET_ARCH_LOONG64
@@ -948,8 +1006,10 @@ V8 shared library set USING_V8_SHARED.
 #if (V8_TARGET_ARCH_MIPS64 && !(V8_HOST_ARCH_X64 || V8_HOST_ARCH_MIPS64))
 #error Target architecture mips64 is only supported on mips64 and x64 host
 #endif
-#if (V8_TARGET_ARCH_RISCV64 && !(V8_HOST_ARCH_X64 || V8_HOST_ARCH_RISCV64))
-#error Target architecture riscv64 is only supported on riscv64 and x64 host
+#if (V8_TARGET_ARCH_RISCV64 && \
+     !(V8_HOST_ARCH_X64 || V8_HOST_ARCH_ARM64 || V8_HOST_ARCH_RISCV64))
+#error Target architecture riscv64 is only supported on riscv64, x64, and \
+arm64 host
 #endif
 #if (V8_TARGET_ARCH_RISCV32 && !(V8_HOST_ARCH_IA32 || V8_HOST_ARCH_RISCV32))
 #error Target architecture riscv32 is only supported on riscv32 and ia32 host

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-linux-arm64",
-  "version": "24.11.0",
+  "version": "25.1.0",
   "description": "node",
   "repository": {
     "url": "git+https://github.com/aredridel/node-bin-gen.git"

package/share/doc/node/gdbinit

@@ -14,6 +14,8 @@ end
 # Print content of V8 handles.
 python
 import gdb
+import gdb.printing
+import gdb.types
 
 class PrintV8HandleCommand(gdb.Command):
   """Print content of a V8 object, accessed through a handle."""
@@ -94,9 +96,25 @@ PrintV8LocalCommand()
 PrintV8InternalHandleCommand()
 end
 
-alias jlh = print-v8-local
-alias jl = print-v8-local
-alias jh = print-v8-internal-handle
+python
+class TryAliasCommand(gdb.Command):
+  """Create an alias, but don't error if it already exists."""
+
+  def __init__ (self):
+    super (TryAliasCommand, self).__init__ ("try-alias", gdb.COMMAND_FILES)
+
+  def invoke (self, arg, from_tty):
+    try:
+      gdb.execute('alias ' + arg)
+    except:
+      pass
+
+TryAliasCommand()
+end
+
+try-alias jlh = print-v8-local
+try-alias jl = print-v8-local
+try-alias jh = print-v8-internal-handle
 
 # Print Code objects containing given PC.
 define jco
@@ -361,7 +379,7 @@ import subprocess
 import sys
 
 compile_dirs = set()
-
+src_dir = None
 
 def get_current_debug_file_directories():
   dir = gdb.execute("show debug-file-directory", to_string=True)
@@ -380,6 +398,40 @@ def add_debug_file_directory(dir):
       "set debug-file-directory %s" % ":".join(current_dirs), to_string=True)
 
 
+def load_libcxx_pretty_printers(src_dir):
+  libcxx_pretty_printers = os.path.join(src_dir, 'third_party', 'libc++', 'src',
+                                        'utils', 'gdb', 'libcxx')
+  if not os.path.isdir(libcxx_pretty_printers):
+    return
+  sys.path.insert(1, libcxx_pretty_printers)
+  from printers import register_libcxx_printer_loader
+  register_libcxx_printer_loader()
+
+
+def set_src_dir(compile_dir):
+  global src_dir
+  git = subprocess.Popen(
+      ['git', '-C', compile_dir, 'rev-parse', '--show-toplevel'],
+      stdout=subprocess.PIPE,
+      stderr=subprocess.PIPE)
+  src_dir, _ = git.communicate()
+  if git.returncode:
+    return
+  if isinstance(src_dir, str):
+    src_dir = src_dir.rstrip()
+  else:
+    src_dir = src_dir.decode('utf-8').rstrip()
+
+  # If there's no LICENSE.v8 file in the repo root, we got the wrong git repo.
+  # The most common way to have this happen is to be in a git checkout of
+  # another project that vendors chromium in its own third_party directory. In
+  # that case, try falling back to the current working directory.
+  if not os.path.isfile(os.path.join(src_dir, 'LICENSE.v8')):
+    src_dir = os.path.abspath(os.getcwd())
+
+  load_libcxx_pretty_printers(src_dir)
+
+
 def newobj_handler(event):
   global compile_dirs
   compile_dir = os.path.dirname(event.new_objfile.filename)
@@ -396,6 +448,10 @@ def newobj_handler(event):
   # https://sourceware.org/gdb/onlinedocs/gdb/Separate-Debug-Files.html
   # https://crbug.com/603286#c35
   add_debug_file_directory(compile_dir)
+  
+  global src_dir
+  if not src_dir:
+    set_src_dir(compile_dir)
 
 # Event hook for newly loaded objfiles.
 # https://sourceware.org/gdb/onlinedocs/gdb/Events-In-Python.html
@@ -455,6 +511,7 @@ def cppgc_pretty_printers(val):
 
 
 gdb.pretty_printers.append(cppgc_pretty_printers)
+
 class TaggedPrintCommand(gdb.Command):
     """
     The equivalent of the print command that deals with tagged objects
@@ -515,4 +572,164 @@ class TaggedPrintCommand(gdb.Command):
 
 TaggedPrintCommand()
 
+
+static_roots_cache = None
+def GetStaticRoot(ptr):
+  global static_roots_cache
+  if static_roots_cache is None:
+    static_roots_cache = {}
+    try:
+      for field in gdb.lookup_type("v8::internal::StaticReadOnlyRoot").fields():
+        value = gdb.parse_and_eval("v8::internal::StaticReadOnlyRoot::"+field.name)
+        if int(value) in static_roots_cache:
+          static_roots_cache[int(value)] += "," + field.name
+        else:
+          static_roots_cache[int(value)] = field.name
+    except Exception as e:
+      print("Warning, couldn't find static roots: ", e)
+  ptr = ptr & 0xFFFFFFFF
+  return static_roots_cache.get(ptr, None)
+
+
+def InterpretTaggedPointer(pointer):
+  if (pointer & 0x1) == 0:
+    return f"Smi: {pointer >> 1}"
+  
+  static_root = GetStaticRoot(pointer)
+  if static_root is not None:
+    return f"{static_root}"
+
+  return None
+
+
+def OptimizedOutToNone(val):
+  if val is None:
+    return None
+  if val.is_optimized_out:
+    return None
+  return val
+
+
+class TaggedPrinter(object):
+  """Print Tagged<Foo> types."""
+
+  def __init__(self, val, pointee_type):
+    self.val = OptimizedOutToNone(val)
+    self.pointee_type = pointee_type.lstrip('v8::internal::')
+    self.ptr = self.val["ptr_"] if self.val is not None else None
+
+  def to_string(self):
+    if self.ptr is None:
+      return f"Tagged<{self.pointee_type}>{{<optimized out>}}"
+    pointer = int(self.ptr)
+    fmt = f"Tagged<{self.pointee_type}>{{0x{pointer:02x}}}"
+    if (label := InterpretTaggedPointer(pointer)) is not None:
+      fmt += f" ({label})"          
+    return fmt
+
+
+def tagged_pretty_printers(val):
+  # The member type might have been obscured by typedefs and template
+  # arguments. Fallback to using the underlying type.
+  real_type = val.type.strip_typedefs()
+  typename = real_type.name or real_type.tag or str(real_type)
+  regex = re.compile("^v8::internal::Tagged<(.*)>$")
+  match = regex.match(typename)
+  if match is not None:
+    return TaggedPrinter(val, pointee_type=match.group(1))
+
+  return None
+
+
+gdb.pretty_printers.append(tagged_pretty_printers)
+
+
+class HandlePrinter(object):
+  """Print Handle<Foo> types."""
+
+  def __init__(self, val, pointee_type):
+    self.val = OptimizedOutToNone(val)
+    self.pointee_type = pointee_type.lstrip('v8::internal::')
+    self.location = OptimizedOutToNone(self.val["location_"] if self.val is not None else None)
+    self.ptr = self.location.dereference() if self.location is not None else None
+
+  def to_string(self):
+    if self.location is None:
+      return f"Handle<{self.pointee_type}>{{<optimized out>}}"
+    location = int(self.location)
+    fmt = f"Handle<{self.pointee_type}>{{0x{location:02x}}}: "
+    if self.ptr is None:
+      fmt += f"<optimized out>"
+    else:
+      pointer = None
+      try:
+        pointer = int(self.ptr)
+      except Exception as e:
+        fmt += f"[{e}]"
+      else:
+        fmt += f"0x{pointer:02x}"
+        if (label := InterpretTaggedPointer(pointer)) is not None:
+          fmt += f" ({label})"
+          
+    return fmt
+
+
+def handle_pretty_printers(val):
+  # The member type might have been obscured by typedefs and template
+  # arguments. Fallback to using the underlying type.
+  real_type = val.type.strip_typedefs()
+  typename = real_type.name or real_type.tag or str(real_type)
+  regex = re.compile("^v8::internal::(?:Indirect)?Handle<(.*)>$")
+  match = regex.match(typename)
+  if match is not None:
+    return HandlePrinter(val, pointee_type=match.group(1))
+
+  return None
+
+
+gdb.pretty_printers.append(handle_pretty_printers)
+
+
+class DirectHandlePrinter(object):
+  """Print DirectHandle<Foo> types."""
+
+  def __init__(self, val, pointee_type):
+    self.val = val
+    self.pointee_type = pointee_type.lstrip('v8::internal::')
+    self.inner = None
+    if gdb.types.has_field(self.val.type, "handle_"):
+      self.inner = HandlePrinter(val['handle_'], pointee_type)
+    elif gdb.types.has_field(self.val.type, "obj_"):
+      self.inner = TaggedPrinter(val['obj_'], pointee_type)
+    else:
+      print("Warning: No recognised DirectHandle field")
+
+  def to_string(self):
+    if self.inner is not None:
+      return self.inner.to_string()
+
+
+def direct_handle_pretty_printers(val):
+  # The member type might have been obscured by typedefs and template
+  # arguments. Fallback to using the underlying type.
+  real_type = val.type.strip_typedefs()
+  typename = real_type.name or real_type.tag or str(real_type)
+  regex = re.compile("^v8::internal::DirectHandle<(.*)>$")
+  match = regex.match(typename)
+  if match is not None:
+    if gdb.types.has_field(real_type, "handle_"):
+      handle = None
+      if not val.is_optimized_out:
+        handle = val['handle_']
+      return HandlePrinter(handle, match.group(1))
+    elif gdb.types.has_field(real_type, "obj_"):
+      obj = None
+      if not val.is_optimized_out:
+        obj = val['obj_']
+      return TaggedPrinter(obj, match.group(1))
+
+  return None
+
+gdb.pretty_printers.append(direct_handle_pretty_printers)
+
 end

package/share/man/man1/node.1

@@ -85,6 +85,12 @@ Allow using native addons when using the permission model.
 .It Fl -allow-child-process
 Allow spawning process when using the permission model.
 .
+.It Fl -allow-inspector
+Allow inspector access when using the permission model.
+.
+.It Fl -allow-net
+Allow network access when using the permission model.
+.
 .It Fl -allow-wasi
 Allow execution of WASI when using the permission model.
 .
@@ -201,8 +207,8 @@ Enable experimental support for the EventSource Web API.
 .It Fl -no-experimental-websocket
 Disable experimental support for the WebSocket API.
 .
-.It Fl -experimental-webstorage
-Enable experimental support for the Web Storage API.
+.It Fl -no-webstorage
+Disable webstorage.
 .
 .It Fl -no-experimental-repl-await
 Disable top-level await keyword support in REPL.
@@ -333,7 +339,7 @@ The file used to store localStorage data.
 Specify the maximum size of HTTP headers in bytes. Defaults to 16 KiB.
 .
 .It Fl -max-old-space-size-percentage Ns = Ns Ar percentage
-Sets the max memory size of V8's old memory section as a percentage of available system memory.
+Sets the maximum memory size of V8's old memory section as a percentage of available system memory.
 This flag takes precedence over
 .Fl -max-old-space-size
 when both are specified.
@@ -341,6 +347,10 @@ The
 .Ar percentage
 parameter must be a number greater than 0 and up to 100, representing the percentage
 of available system memory to allocate to the V8 heap.
+.Pp
+Note: This flag utilizes
+.Fl -max-old-space-size ,
+which may be unreliable on 32-bit platforms due to integer overflow issues.
 .
 .It Fl -napi-modules
 This option is a no-op.
@@ -656,7 +666,7 @@ This will turn off watching of required or imported modules, even when used in c
 Customizes the signal sent to the process on watch mode restarts.
 .
 .It Fl -zero-fill-buffers
-Automatically zero-fills all newly allocated Buffer and SlowBuffer instances.
+Automatically zero-fills all newly allocated Buffer instances.
 .
 .It Fl c , Fl -check
 Check the script's syntax without executing it.
@@ -719,6 +729,13 @@ Enable the
 .Sy module compile cache
 for the Node.js instance.
 .
+.It Ev NODE_COMPILE_CACHE_PORTABLE
+When set to '1' or 'true', the
+.Sy module compile cache
+will be hit as long as the location of the modules relative to the cache directory remain
+consistent. This can be used in conjunction with .Ev NODE_COMPILE_CACHE
+to enable portable on-disk caching.
+.
 .It Ev NODE_DEBUG Ar modules...
 Comma-separated list of core modules that should print debug information.
 .