From bc4086867258f2956cbe0343a0f572fbbc7edf07 Mon Sep 17 00:00:00 2001
From: fengmk2 <fengmk2@gmail.com>
Date: Fri, 11 Jul 2025 10:07:44 +0800
Subject: [PATCH 1/5] doc: add rss leak note on process memoryUsage

---
 doc/api/process.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/doc/api/process.md b/doc/api/process.md
index 9182d25219c92f..e7a04cc7986e44 100644
--- a/doc/api/process.md
+++ b/doc/api/process.md
@@ -2807,6 +2807,11 @@ The `process.memoryUsage()` method iterates over each page to gather
 information about memory usage which might be slow depending on the
 program memory allocations.
 
+### A note on process memoryUsage
+
+Once you notice that the `rss` continues to rise while the `heapTotal` shows normal, and the `rss` is more than three times higher than the `heapTotal`, it is very likely that there is an issue with an external memory leak.
+Referer to the discussions in [nodejs/node#21973](https://github.com/nodejs/node/issues/21973) and [nodejs/help#1942](https://github.com/nodejs/help/issues/1942) for suggestions on switching the system's default `malloc` to `jemalloc` to try to resolve such issues.
+
 ## `process.memoryUsage.rss()`
 
 <!-- YAML

From bc0ba24975516a06f9237ecdc03b1aedd90c7d29 Mon Sep 17 00:00:00 2001
From: fengmk2 <fengmk2@gmail.com>
Date: Fri, 11 Jul 2025 10:12:48 +0800
Subject: [PATCH 2/5] Update process.md

---
 doc/api/process.md | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/doc/api/process.md b/doc/api/process.md
index e7a04cc7986e44..21a25a19d9e439 100644
--- a/doc/api/process.md
+++ b/doc/api/process.md
@@ -2809,8 +2809,11 @@ program memory allocations.
 
 ### A note on process memoryUsage
 
-Once you notice that the `rss` continues to rise while the `heapTotal` shows normal, and the `rss` is more than three times higher than the `heapTotal`, it is very likely that there is an issue with an external memory leak.
-Referer to the discussions in [nodejs/node#21973](https://github.com/nodejs/node/issues/21973) and [nodejs/help#1942](https://github.com/nodejs/help/issues/1942) for suggestions on switching the system's default `malloc` to `jemalloc` to try to resolve such issues.
+Once you notice that the `rss` continues to rise while the `heapTotal` shows normal,
+and the `rss` is more than three times higher than the `heapTotal`,
+it is very likely that there is an issue with an external memory leak.
+Referer to the discussions in [nodejs/node#21973][] and [nodejs/help#1942][] for
+suggestions on switching the system's default `malloc` to `jemalloc` to try to resolve such issues.
 
 ## `process.memoryUsage.rss()`
 
@@ -4563,3 +4566,5 @@ cases:
 [uv_rusage_t]: https://docs.libuv.org/en/v1.x/misc.html#c.uv_rusage_t
 [wikipedia_major_fault]: https://en.wikipedia.org/wiki/Page_fault#Major
 [wikipedia_minor_fault]: https://en.wikipedia.org/wiki/Page_fault#Minor
+[nodejs/node#21973]: https://github.com/nodejs/node/issues/21973
+[nodejs/help#1942]: https://github.com/nodejs/help/issues/1942

From d0c487e58ddda540ce1302f2419a7234747bad9a Mon Sep 17 00:00:00 2001
From: fengmk2 <fengmk2@gmail.com>
Date: Fri, 11 Jul 2025 10:18:26 +0800
Subject: [PATCH 3/5] Update process.md

---
 doc/api/process.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/api/process.md b/doc/api/process.md
index 21a25a19d9e439..61e1c35d9d5730 100644
--- a/doc/api/process.md
+++ b/doc/api/process.md
@@ -4555,6 +4555,8 @@ cases:
 [debugger]: debugger.md
 [deprecation code]: deprecations.md
 [loading ECMAScript modules using `require()`]: modules.md#loading-ecmascript-modules-using-require
+[nodejs/help#1942]: https://github.com/nodejs/help/issues/1942
+[nodejs/node#21973]: https://github.com/nodejs/node/issues/21973
 [note on process I/O]: #a-note-on-process-io
 [process.cpuUsage]: #processcpuusagepreviousvalue
 [process_emit_warning]: #processemitwarningwarning-type-code-ctor
@@ -4566,5 +4568,3 @@ cases:
 [uv_rusage_t]: https://docs.libuv.org/en/v1.x/misc.html#c.uv_rusage_t
 [wikipedia_major_fault]: https://en.wikipedia.org/wiki/Page_fault#Major
 [wikipedia_minor_fault]: https://en.wikipedia.org/wiki/Page_fault#Minor
-[nodejs/node#21973]: https://github.com/nodejs/node/issues/21973
-[nodejs/help#1942]: https://github.com/nodejs/help/issues/1942

From 2dbee983804b65c2d4fe77b7b7814d5f9ee2e591 Mon Sep 17 00:00:00 2001
From: fengmk2 <fengmk2@gmail.com>
Date: Fri, 11 Jul 2025 18:45:29 +0800
Subject: [PATCH 4/5] Update doc/api/process.md

Co-authored-by: Joyee Cheung <joyeec9h3@gmail.com>
---
 doc/api/process.md | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/doc/api/process.md b/doc/api/process.md
index 61e1c35d9d5730..fd2e83e73dd76b 100644
--- a/doc/api/process.md
+++ b/doc/api/process.md
@@ -2809,11 +2809,10 @@ program memory allocations.
 
 ### A note on process memoryUsage
 
-Once you notice that the `rss` continues to rise while the `heapTotal` shows normal,
-and the `rss` is more than three times higher than the `heapTotal`,
-it is very likely that there is an issue with an external memory leak.
-Referer to the discussions in [nodejs/node#21973][] and [nodejs/help#1942][] for
-suggestions on switching the system's default `malloc` to `jemalloc` to try to resolve such issues.
+On Linux or other systems where glibc is commonly used, an application may have sustained
+`rss` growth despite stable `heapTotal` due to fragmentation caused by the glibc `malloc`
+implementation. See [nodejs/node#21973][] on how to switch to an alternative `malloc`
+implementation to address the performance issue.
 
 ## `process.memoryUsage.rss()`
 

From 223213f393d6e69b35f5ca3a72b8785f62db4d2e Mon Sep 17 00:00:00 2001
From: fengmk2 <fengmk2@gmail.com>
Date: Fri, 11 Jul 2025 18:47:12 +0800
Subject: [PATCH 5/5] Update process.md

---
 doc/api/process.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/doc/api/process.md b/doc/api/process.md
index fd2e83e73dd76b..a7810e8d816707 100644
--- a/doc/api/process.md
+++ b/doc/api/process.md
@@ -4554,7 +4554,6 @@ cases:
 [debugger]: debugger.md
 [deprecation code]: deprecations.md
 [loading ECMAScript modules using `require()`]: modules.md#loading-ecmascript-modules-using-require
-[nodejs/help#1942]: https://github.com/nodejs/help/issues/1942
 [nodejs/node#21973]: https://github.com/nodejs/node/issues/21973
 [note on process I/O]: #a-note-on-process-io
 [process.cpuUsage]: #processcpuusagepreviousvalue