Clarify huge arena and tcache documentation

Updated documentation for the huge arena option to clarify its behavior with transparent huge pages and madvise. Modified the description of the tcache settings input format from colon-separated to pipe-separated.
This commit is contained in:
lexprfuncall 2026-03-30 13:03:06 -07:00 committed by GitHub
parent 3767355d26
commit 242672427e
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -1393,9 +1393,10 @@ malloc_conf = "xmalloc:true";]]></programlisting>
(<type>bool</type>)
<literal>r-</literal>
</term>
<listitem><para>Controls whether the oversize arena uses transparent huge
pages (THP) for oversize allocations. This option is disabled by
default.</para></listitem>
<listitem><para>Controls whether the huge (oversized) arena's backing
memory is promoted to transparent huge pages via madvise. Only effective
when the system THP mode is madvise, opt.thp is left at its default, and
opt.metadata_thp is enabled.</para></listitem>
</varlistentry>
<varlistentry id="opt.thp">
@ -1896,7 +1897,7 @@ malloc_conf = "xmalloc:true";]]></programlisting>
</term>
<listitem><para>Set the maximum number of cached objects
(<varname>ncached_max</varname>) for size classes in the calling
thread's tcache. The input is a string of colon-separated settings,
thread's tcache. The input is a string of pipe-separated settings,
where each setting specifies a size range and a count, in the same
format as the <mallctl>opt.tcache_ncached_max</mallctl> runtime
option.</para></listitem>