Update manual for opt.retain (new default on Windows).

This commit is contained in:
Qi Wang 2019-07-25 13:43:59 -07:00 committed by Qi Wang
parent 10fcff6c38
commit 9f6a9f4c1f

View File

@ -963,17 +963,17 @@ mallctl("arena." STRINGIFY(MALLCTL_ARENAS_ALL) ".decay",
linkend="stats.retained">stats.retained</link> for related details). linkend="stats.retained">stats.retained</link> for related details).
It also makes jemalloc use <citerefentry> It also makes jemalloc use <citerefentry>
<refentrytitle>mmap</refentrytitle><manvolnum>2</manvolnum> <refentrytitle>mmap</refentrytitle><manvolnum>2</manvolnum>
</citerefentry> in a more greedy way, mapping larger chunks in one go. </citerefentry> or equivalent in a more greedy way, mapping larger
This option is disabled by default unless discarding virtual memory is chunks in one go. This option is disabled by default unless discarding
known to trigger virtual memory is known to trigger platform-specific performance
platform-specific performance problems, e.g. for [64-bit] Linux, which problems, namely 1) for [64-bit] Linux, which has a quirk in its virtual
has a quirk in its virtual memory allocation algorithm that causes memory allocation algorithm that causes semi-permanent VM map holes
semi-permanent VM map holes under normal jemalloc operation. Although under normal jemalloc operation; and 2) for [64-bit] Windows, which
<citerefentry><refentrytitle>munmap</refentrytitle> disallows split / merged regions with
<manvolnum>2</manvolnum></citerefentry> causes issues on 32-bit Linux as <parameter><constant>MEM_RELEASE</constant></parameter>. Although the
well, retaining virtual memory for 32-bit Linux is disabled by default same issues may present on 32-bit platforms as well, retaining virtual
due to the practical possibility of address space exhaustion. memory for 32-bit Linux and Windows is disabled by default due to the
</para></listitem> practical possibility of address space exhaustion. </para></listitem>
</varlistentry> </varlistentry>
<varlistentry id="opt.dss"> <varlistentry id="opt.dss">