Lines Matching +full:high +full:- +full:fidelity
1 <?xml version='1.0' encoding='UTF-8'?>
2 <?xml-stylesheet type="text/xsl"
4 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
5 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
28 <!-- Each refname causes a man page file to be created. Only if this were
48 -->
57 <para>The following configuration options are enabled in libc's built-in
58 jemalloc: <option>--enable-fill</option>,
59 <option>--enable-lazy-lock</option>, <option>--enable-stats</option>,
60 <option>--enable-utrace</option>, <option>--enable-xmalloc</option>, and
61 <option>--with-malloc-conf=abort_conf:false</option>.
62 Additionally, <option>--enable-debug</option> is enabled in development
105 <title>Non-standard API</title>
243 <title>Non-standard API</title>
289 <listitem><para>Use the thread-specific cache (tcache) specified by
300 <listitem><para>Do not use a thread-specific cache (tcache). Unless
336 allocation. If <parameter>extra</parameter> is non-zero, an attempt is
374 period-separated <parameter>name</parameter> argument specifies a
375 location in a tree-structured namespace; see the <xref
398 period-separated name components, which results in a partial MIB that can
431 statistics are presented in human-readable form unless <quote>J</quote> is
441 simultaneously. If <option>--enable-stats</option> is specified during
458 mechanism for in-place <function>realloc()</function>; rather
462 depended on, since such behavior is entirely implementation-dependent.
470 options that can be specified at compile- or run-time.</para>
472 <para>The string specified via <option>--with-malloc-conf</option>, the
481 the final value to be read by jemalloc. <option>--with-malloc-conf</option>
482 and <varname>malloc_conf</varname> are compile-time mechanisms, whereas
487 <para>An options string is a comma-separated list of option:value pairs.
516 contention for threaded programs on multi-processor systems. This works
518 a small fixed per-arena overhead, and additionally, arenas manage memory
528 thread-specific caching, in order to make it possible to completely avoid
554 multi-threaded applications. If you need to assure that allocations do not
566 <function>realloc()</function> to grow e.g. a 9-byte allocation to
567 16 bytes, or shrink a 16-byte allocation to 9 bytes. Growth and shrinkage
568 trivially succeeds in place as long as the pre-size and post-size both round
570 in-place resizing, but the current implementation also tries to resize large
571 allocations in place, as long as the pre-size and post-size are both large.
578 <para>Assuming 4 KiB pages and a 16-byte quantum on a 64-bit system, the
707 <literal>rw</literal>, <literal>r-</literal>, <literal>-w</literal>, or
708 <literal>--</literal>, and required build configuration flags follow, if
737 <literal>r-</literal>
773 selected pthread-based platforms.</para></listitem>
792 <literal>r-</literal>
794 <listitem><para><option>--enable-cache-oblivious</option> was specified
802 <literal>r-</literal>
804 <listitem><para><option>--enable-debug</option> was specified during
812 <literal>r-</literal>
814 <listitem><para><option>--enable-fill</option> was specified during
822 <literal>r-</literal>
824 <listitem><para><option>--enable-lazy-lock</option> was specified
832 <literal>r-</literal>
834 <listitem><para>Embedded configure-time-specified run-time options
835 string, empty unless <option>--with-malloc-conf</option> was specified
843 <literal>r-</literal>
845 <listitem><para><option>--enable-prof</option> was specified during
853 <literal>r-</literal>
855 <listitem><para><option>--disable-prof-libgcc</option> was not
863 <literal>r-</literal>
865 <listitem><para><option>--enable-prof-libunwind</option> was specified
873 <literal>r-</literal>
875 <listitem><para><option>--enable-stats</option> was specified during
884 <literal>r-</literal>
886 <listitem><para><option>--enable-utrace</option> was specified during
894 <literal>r-</literal>
896 <listitem><para><option>--enable-xmalloc</option> was specified during
904 <literal>r-</literal>
906 <listitem><para>Abort-on-warning enabled/disabled. If true, most
913 disabled by default unless <option>--enable-debug</option> is
922 <literal>r-</literal>
924 <listitem><para>Confirm-runtime-options-when-program-starts
926 <option>--with-malloc-conf</option>, the string pointed to by the
939 <literal>r-</literal>
941 <listitem><para>Abort-on-invalid-configuration enabled/disabled. If
945 disabled by default unless <option>--enable-debug</option> is
954 <literal>r-</literal>
956 <listitem><para>Enable / Disable cache-oblivious large allocation
958 feature is disabled, all large allocations are page-aligned as an
960 However, the cache-oblivious layout comes at the cost of one extra page
970 <literal>r-</literal>
984 <literal>r-</literal>
995 <literal>r-</literal>
1006 virtual memory is known to trigger platform-specific performance
1007 problems, namely 1) for [64-bit] Linux, which has a quirk in its virtual
1008 memory allocation algorithm that causes semi-permanent VM map holes
1009 under normal jemalloc operation; and 2) for [64-bit] Windows, which
1012 same issues may present on 32-bit platforms as well, retaining virtual
1013 memory for 32-bit Linux and Windows is disabled by default due to the
1021 <literal>r-</literal>
1043 <literal>r-</literal>
1054 <literal>r-</literal>
1072 <literal>r-</literal>
1090 <literal>r-</literal>
1105 <literal>r-</literal>
1116 <literal>r-</literal>
1128 purged immediately upon creation. A decay time of -1 disables purging.
1146 <literal>r-</literal>
1158 purged immediately upon creation. A decay time of -1 disables purging.
1170 <literal>r-</literal>
1177 (especially for non-active extents). Lower value may reduce
1186 <literal>r-</literal>
1195 <option>--enable-stats</option> is specified during configuration, this
1196 has the potential to cause deadlock for a multi-threaded process that
1213 <literal>r-</literal>
1230 <literal>r-</literal>
1239 interval-triggered stats output is disabled (encoded as
1240 -1).</para></listitem>
1247 <literal>r-</literal>
1265 <literal>r-</literal>
1266 [<option>--enable-fill</option>]
1276 unless <option>--enable-debug</option> is specified during
1285 <literal>r-</literal>
1286 [<option>--enable-fill</option>]
1302 <literal>r-</literal>
1303 [<option>--enable-utrace</option>]
1315 <literal>r-</literal>
1316 [<option>--enable-xmalloc</option>]
1318 <listitem><para>Abort-on-out-of-memory enabled/disabled. If enabled,
1335 <literal>r-</literal>
1337 <listitem><para>Thread-specific caching (tcache) enabled/disabled. When
1339 a certain size. Thread-specific caching allows many allocations to be
1351 <literal>r-</literal>
1353 <listitem><para>Maximum size class to cache in the thread-specific cache
1357 lg_tcache_max, which will be taken to be the base-2 logarithm of the
1365 <literal>r-</literal>
1387 <literal>r-</literal>
1388 [<option>--enable-prof</option>]
1393 option for on-the-fly activation/deactivation. See the <link
1399 option for information on interval-triggered profile dumping, the <link
1401 option for information on high-water-triggered profile dumping, and the
1415 <literal>r-</literal>
1416 [<option>--enable-prof</option>]
1431 <literal>r-</literal>
1432 [<option>--enable-prof</option>]
1448 <literal>r-</literal>
1449 [<option>--enable-prof</option>]
1463 <literal>r-</literal>
1464 [<option>--enable-prof</option>]
1468 sampling interval decreases profile fidelity, but also decreases the
1477 <literal>r-</literal>
1478 [<option>--enable-prof</option>]
1492 <literal>r-</literal>
1493 [<option>--enable-prof</option>]
1505 options. By default, interval-triggered profile dumping is disabled
1506 (encoded as -1).
1514 <literal>r-</literal>
1515 [<option>--enable-prof</option>]
1528 <literal>r-</literal>
1529 [<option>--enable-prof</option>]
1552 <literal>r-</literal>
1553 [<option>--enable-prof</option>]
1570 <literal>r-</literal>
1571 [<option>--enable-prof</option>]
1589 <literal>r-</literal>
1594 (and returns a non-null result except in case of resource exhaustion).
1605 continued validity of the passed-in pointer (per POSIX and C11).
1608 leak-free cannot assume either behavior, and must therefore never call
1631 <literal>r-</literal>
1632 [<option>--enable-stats</option>]
1644 <literal>r-</literal>
1645 [<option>--enable-stats</option>]
1659 <literal>r-</literal>
1660 [<option>--enable-stats</option>]
1672 <literal>r-</literal>
1673 [<option>--enable-stats</option>]
1687 <literal>r-</literal>
1688 [<option>--enable-stats</option>]
1706 <literal>--</literal>
1707 [<option>--enable-stats</option>]
1736 <literal>--</literal>
1738 <listitem><para>Flush calling thread's thread-specific cache (tcache).
1753 <literal>r-</literal> or
1754 <literal>-w</literal>
1755 [<option>--enable-prof</option>]
1761 copied for non-ephemeral uses, because multiple implementation details
1765 name string must be nil-terminated and comprised only of characters in
1778 [<option>--enable-prof</option>]
1791 <literal>--</literal>
1799 <para>This is not intended to be a general-purpose background activity
1813 <literal>r-</literal>
1815 <listitem><para>Create an explicit thread-specific cache (tcache) and
1824 <para>If the amount of space supplied for storing the thread-specific
1827 thread-specific cache will be created, no data will be written to the
1838 <literal>-w</literal>
1840 <listitem><para>Flush the specified thread-specific cache (tcache). The
1851 <literal>-w</literal>
1853 <listitem><para>Flush the specified thread-specific cache (tcache) and
1862 <literal>r-</literal>
1875 <literal>--</literal>
1877 <listitem><para>Trigger decay-based purging of unused dirty/muzzy pages
1891 <literal>--</literal>
1902 <literal>--</literal>
1917 <literal>--</literal>
1951 <listitem><para>Current per-arena approximate time in milliseconds from
1956 the decay time is set to -1 (i.e. purging disabled). See <link
1967 <listitem><para>Current per-arena approximate time in milliseconds from
1972 the decay time is set to -1 (i.e. purging disabled). See <link
2005 that all extents originate from an application-supplied extent allocator
2008 relaxed -- hooks set there may be called in a "best effort" fashion; in
2091 success. If the function returns true, this indicates opt-out from
2155 being reused. If the function returns true, this indicates opt-out from
2181 memory range will be zero-filled the next time they are accessed. If
2234 <literal>r-</literal>
2245 <listitem><para>Current default per-arena approximate time in
2261 <listitem><para>Current default per-arena approximate time in
2275 <literal>r-</literal>
2284 <literal>r-</literal>
2293 <literal>r-</literal>
2295 <listitem><para>Maximum thread-cached size class.</para></listitem>
2302 <literal>r-</literal>
2311 <literal>r-</literal>
2321 <literal>r-</literal>
2330 <literal>r-</literal>
2339 <literal>r-</literal>
2348 <literal>r-</literal>
2357 <literal>r-</literal>
2395 [<option>--enable-prof</option>]
2409 [<option>--enable-prof</option>]
2423 <literal>-w</literal>
2424 [<option>--enable-prof</option>]
2439 <literal>-w</literal>
2440 [<option>--enable-prof</option>]
2455 [<option>--enable-prof</option>]
2471 <literal>-w</literal>
2472 [<option>--enable-prof</option>]
2486 <literal>r-</literal>
2487 [<option>--enable-prof</option>]
2498 <literal>r-</literal>
2499 [<option>--enable-prof</option>]
2502 interval-based profile dumps. See the
2512 <literal>r-</literal>
2513 [<option>--enable-stats</option>]
2523 <literal>r-</literal>
2524 [<option>--enable-stats</option>]
2541 <literal>r-</literal>
2542 [<option>--enable-stats</option>]
2545 comprise base allocations used for bootstrap-sensitive allocator
2559 <literal>r-</literal>
2560 [<option>--enable-stats</option>]
2573 <literal>r-</literal>
2574 [<option>--enable-stats</option>]
2580 actually be physically resident if they correspond to demand-zeroed
2590 <literal>r-</literal>
2591 [<option>--enable-stats</option>]
2606 <literal>r-</literal>
2607 [<option>--enable-stats</option>]
2625 <literal>r-</literal>
2626 [<option>--enable-stats</option>]
2629 was called with a non-<constant>NULL</constant> pointer argument and a
2640 <literal>r-</literal>
2641 [<option>--enable-stats</option>]
2651 <literal>r-</literal>
2652 [<option>--enable-stats</option>]
2662 <literal>r-</literal>
2663 [<option>--enable-stats</option>]
2673 <literal>r-</literal>
2674 [<option>--enable-stats</option>]
2684 of times the mutex was spin-acquired. When the mutex is currently
2686 spin-retry within jemalloc will be performed. Acquired through spin
2691 times the mutex was wait-acquired, which means the mutex contention
2692 was not solved by spin-retry, and blocking operation was likely
2698 Maximum length of time in nanoseconds spent on a single wait-acquired
2700 path, this does not consider spin-acquired cases.</para>
2703 Cumulative time in nanoseconds spent on wait-acquired lock operations.
2704 Similarly, spin-acquired cases are not considered.</para>
2708 spin-acquired cases are not considered.</para>
2724 (<type>counter specific type</type>) <literal>r-</literal>
2725 [<option>--enable-stats</option>]
2738 (<type>counter specific type</type>) <literal>r-</literal>
2739 [<option>--enable-stats</option>]
2750 (<type>counter specific type</type>) <literal>r-</literal>
2751 [<option>--enable-stats</option>]
2762 (<type>counter specific type</type>) <literal>r-</literal>
2763 [<option>--enable-stats</option>]
2774 (<type>void</type>) <literal>--</literal>
2775 [<option>--enable-stats</option>]
2785 <literal>r-</literal>
2799 <literal>r-</literal>
2812 <literal>r-</literal>
2825 <literal>r-</literal>
2835 <literal>r-</literal>
2847 <literal>r-</literal>
2856 <literal>r-</literal>
2869 <literal>r-</literal>
2881 <literal>r-</literal>
2882 [<option>--enable-stats</option>]
2891 <literal>r-</literal>
2892 [<option>--enable-stats</option>]
2903 <literal>r-</literal>
2904 [<option>--enable-stats</option>]
2914 <literal>r-</literal>
2915 [<option>--enable-stats</option>]
2918 Number of bytes dedicated to bootstrap-sensitive allocator metadata
2926 <literal>r-</literal>
2927 [<option>--enable-stats</option>]
2930 Internal allocations differ from application-originated allocations in
2939 <literal>r-</literal>
2940 [<option>--enable-stats</option>]
2951 <literal>r-</literal>
2952 [<option>--enable-stats</option>]
2958 physically resident if they correspond to demand-zeroed virtual memory
2967 <literal>r-</literal>
2968 [<option>--enable-stats</option>]
2978 <literal>r-</literal>
2979 [<option>--enable-stats</option>]
2989 <literal>r-</literal>
2990 [<option>--enable-stats</option>]
2999 <literal>r-</literal>
3000 [<option>--enable-stats</option>]
3010 <literal>r-</literal>
3011 [<option>--enable-stats</option>]
3021 <literal>r-</literal>
3022 [<option>--enable-stats</option>]
3031 <literal>r-</literal>
3032 [<option>--enable-stats</option>]
3042 <literal>r-</literal>
3043 [<option>--enable-stats</option>]
3056 <literal>r-</literal>
3057 [<option>--enable-stats</option>]
3070 <literal>r-</literal>
3071 [<option>--enable-stats</option>]
3081 <literal>r-</literal>
3082 [<option>--enable-stats</option>]
3092 <literal>r-</literal>
3093 [<option>--enable-stats</option>]
3103 <literal>r-</literal>
3104 [<option>--enable-stats</option>]
3114 <literal>r-</literal>
3115 [<option>--enable-stats</option>]
3128 <literal>r-</literal>
3129 [<option>--enable-stats</option>]
3142 <literal>r-</literal>
3143 [<option>--enable-stats</option>]
3153 <literal>r-</literal>
3154 [<option>--enable-stats</option>]
3164 <literal>r-</literal>
3165 [<option>--enable-stats</option>]
3175 <literal>r-</literal>
3176 [<option>--enable-stats</option>]
3189 <literal>r-</literal>
3190 [<option>--enable-stats</option>]
3203 <literal>r-</literal>
3204 [<option>--enable-stats</option>]
3214 <literal>r-</literal>
3215 [<option>--enable-stats</option>]
3225 <literal>r-</literal>
3234 <literal>r-</literal>
3243 <literal>r-</literal>
3244 [<option>--enable-stats</option>]
3253 <literal>r-</literal>
3254 [<option>--enable-stats</option>]
3264 <literal>r-</literal>
3265 [<option>--enable-stats</option>]
3275 <literal>r-</literal>
3276 [<option>--enable-stats</option>]
3284 (<type>counter specific type</type>) <literal>r-</literal>
3285 [<option>--enable-stats</option>]
3298 <literal>r-</literal>
3299 [<option>--enable-stats</option>]
3310 <literal>r-</literal>
3311 [<option>--enable-stats</option>]
3322 <literal>r-</literal>
3323 [<option>--enable-stats</option>]
3337 <literal>r-</literal>
3338 [<option>--enable-stats</option>]
3352 <literal>r-</literal>
3353 [<option>--enable-stats</option>]
3363 <literal>r-</literal>
3364 [<option>--enable-stats</option>]
3373 (<type>counter specific type</type>) <literal>r-</literal>
3374 [<option>--enable-stats</option>]
3386 (<type>counter specific type</type>) <literal>r-</literal>
3387 [<option>--enable-stats</option>]
3399 (<type>counter specific type</type>) <literal>r-</literal>
3400 [<option>--enable-stats</option>]
3412 (<type>counter specific type</type>) <literal>r-</literal>
3413 [<option>--enable-stats</option>]
3425 (<type>counter specific type</type>) <literal>r-</literal>
3426 [<option>--enable-stats</option>]
3438 (<type>counter specific type</type>) <literal>r-</literal>
3439 [<option>--enable-stats</option>]
3451 (<type>counter specific type</type>) <literal>r-</literal>
3452 [<option>--enable-stats</option>]
3464 (<type>counter specific type</type>) <literal>r-</literal>
3465 [<option>--enable-stats</option>]
3477 (<type>counter specific type</type>) <literal>r-</literal>
3478 [<option>--enable-stats</option>]
3540 the <option>--enable-debug</option> and <option>--enable-fill</option>
3543 of run-time assertions that catch application errors such as double-free,
3544 write-after-free, etc.</para>
3648 <title>Non-standard API</title>
3698 write read-only value.</para></listitem>
3739 <screen>ln -s 'abort:true' /etc/malloc.conf</screen>
3772 to IEEE Std 1003.1-2001 (<quote>POSIX.1</quote>).</para>