From 665d6213724f122f7eec314ec4088e617aca1ec2 Mon Sep 17 00:00:00 2001 From: Joe Bowbeer Date: Tue, 5 Nov 2024 15:14:15 -0800 Subject: [PATCH] doc: update `--max-semi-space-size` description PR-URL: https://github.com/nodejs/node/pull/55495 Fixes: https://github.com/nodejs/node/issues/55487 Reviewed-By: Luigi Pinca Reviewed-By: Trivikram Kamat --- doc/api/cli.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/doc/api/cli.md b/doc/api/cli.md index 6adc8ac5f97a54..d174063f9c04bd 100644 --- a/doc/api/cli.md +++ b/doc/api/cli.md @@ -3565,8 +3565,12 @@ an increase of 1 MiB to semi-space applies to each of the three individual semi-spaces and causes the heap size to increase by 3 MiB. The throughput improvement depends on your workload (see [#42511][]). -The default value is 16 MiB for 64-bit systems and 8 MiB for 32-bit systems. To -get the best configuration for your application, you should try different +The default value depends on the memory limit. For example, on 64-bit systems +with a memory limit of 512 MiB, the max size of a semi-space defaults to 1 MiB. +On 64-bit systems with a memory limit of 2 GiB, the max size of a semi-space +defaults to 16 MiB. + +To get the best configuration for your application, you should try different max-semi-space-size values when running benchmarks for your application. For example, benchmark on a 64-bit systems: