Jason Evans | 379f847 | 2010-10-24 16:18:29 -0700 | [diff] [blame] | 1 | Following are change highlights associated with official releases. Important |
| 2 | bug fixes are all mentioned, but internal enhancements are omitted here for |
| 3 | brevity (even though they are more fun to write about). Much more detail can be |
| 4 | found in the git revision history: |
| 5 | |
| 6 | http://www.canonware.com/cgi-bin/gitweb.cgi?p=jemalloc.git |
| 7 | git://canonware.com/jemalloc.git |
| 8 | |
Jason Evans | 9ef7f5d | 2012-04-16 18:16:48 -0700 | [diff] [blame] | 9 | * 3.0.0 (XXX not yet released) |
| 10 | |
| 11 | Although this version adds some major new features, the primary focus is on |
| 12 | internal code cleanup that facilitates maintainability and portability, most |
| 13 | of which is not reflected in the ChangeLog. This is the first release to |
| 14 | incorporate substantial contributions from numerous other developers, and the |
| 15 | result is a more broadly useful allocator (see the git revision history for |
| 16 | contribution details). Note that the license has been unified, thanks to |
| 17 | Facebook granting a license under the same terms as the other copyright |
| 18 | holders (see COPYING). |
| 19 | |
| 20 | New features: |
| 21 | - Implement Valgrind support, redzones, and quarantine. |
Jason Evans | 079687b | 2012-04-23 12:49:23 -0700 | [diff] [blame] | 22 | - Add support for additional platforms: |
Jason Evans | 9ef7f5d | 2012-04-16 18:16:48 -0700 | [diff] [blame] | 23 | + FreeBSD |
| 24 | + Mac OS X Lion |
Jason Evans | 40f514f | 2012-04-22 16:21:06 -0700 | [diff] [blame] | 25 | + MinGW |
Jason Evans | 9ef7f5d | 2012-04-16 18:16:48 -0700 | [diff] [blame] | 26 | - Add support for additional architectures: |
| 27 | + MIPS |
| 28 | + SH4 |
| 29 | + Tilera |
| 30 | - Add support for cross compiling. |
| 31 | - Add nallocm(), which rounds a request size up to the nearest size class |
| 32 | without actually allocating. |
| 33 | - Implement aligned_alloc() (blame C11). |
| 34 | - Add the --disable-munmap option, and make it the default on Linux. |
| 35 | - Add the --with-mangling option. |
| 36 | - Add the --disable-experimental option. |
| 37 | - Add the "thread.tcache.enabled" mallctl. |
Jason Evans | 0b25fe7 | 2012-04-17 16:39:33 -0700 | [diff] [blame] | 38 | - Add the "opt.prof_final" mallctl. |
Jason Evans | 25a000e | 2012-04-17 15:49:30 -0700 | [diff] [blame] | 39 | - Update pprof (from gperftools 2.0). |
Jason Evans | 9ef7f5d | 2012-04-16 18:16:48 -0700 | [diff] [blame] | 40 | |
| 41 | Incompatible changes: |
| 42 | - Enable stats by default. |
| 43 | - Enable fill by default. |
| 44 | - Disable lazy locking by default. |
| 45 | - Rename the "tcache.flush" mallctl to "thread.tcache.flush". |
| 46 | - Rename the "arenas.pagesize" mallctl to "arenas.page". |
Jason Evans | 0b25fe7 | 2012-04-17 16:39:33 -0700 | [diff] [blame] | 47 | - Change the "opt.lg_prof_sample" default from 0 to 19 (1 B to 512 KiB). |
| 48 | - Change the "opt.prof_accum" default from true to false. |
Jason Evans | 9ef7f5d | 2012-04-16 18:16:48 -0700 | [diff] [blame] | 49 | |
| 50 | Removed features: |
| 51 | - Remove the swap feature, including the "config.swap", "swap.avail", |
| 52 | "swap.prezeroed", "swap.nfds", and "swap.fds" mallctls. |
| 53 | - Remove highruns statistics, including the |
| 54 | "stats.arenas.<i>.bins.<j>.highruns" and |
| 55 | "stats.arenas.<i>.lruns.<j>.highruns" mallctls. |
| 56 | - As part of small size class refactoring, remove the "opt.lg_[qc]space_max", |
| 57 | "arenas.cacheline", "arenas.subpage", "arenas.[tqcs]space_{min,max}", and |
| 58 | "arenas.[tqcs]bins" mallctls. |
| 59 | - Remove the "arenas.chunksize" mallctl. |
| 60 | - Remove the "opt.lg_prof_tcmax" option. |
| 61 | - Remove the "opt.lg_prof_bt_max" option. |
| 62 | - Remove the "opt.lg_tcache_gc_sweep" option. |
| 63 | - Remove the --disable-tiny option, including the "config.tiny" mallctl. |
| 64 | - Remove the --enable-dynamic-page-shift configure option. |
| 65 | - Remove the --enable-sysv configure option. |
| 66 | |
| 67 | Bug fixes: |
Jason Evans | 9ef7f5d | 2012-04-16 18:16:48 -0700 | [diff] [blame] | 68 | - Fix a statistics-related bug in the "thread.arena" mallctl that could cause |
| 69 | invalid statistics and crashes. |
Jason Evans | 079687b | 2012-04-23 12:49:23 -0700 | [diff] [blame] | 70 | - Work around TLS deallocation via free() on Linux. This bug could cause |
Jason Evans | 9ef7f5d | 2012-04-16 18:16:48 -0700 | [diff] [blame] | 71 | write-after-free memory corruption. |
Jason Evans | 52386b2 | 2012-04-22 16:00:11 -0700 | [diff] [blame] | 72 | - Fix a potential deadlock that could occur during interval- and |
| 73 | growth-triggered heap profile dumps. |
Jason Evans | d8ceef6 | 2012-05-10 20:59:39 -0700 | [diff] [blame] | 74 | - Fix large calloc() zeroing bugs due to dropping chunk map unzeroed flags. |
Jason Evans | 8f0e0eb | 2012-04-21 13:33:48 -0700 | [diff] [blame] | 75 | - Fix chunk_alloc_dss() to stop claiming memory is zeroed. This bug could |
| 76 | cause memory corruption and crashes with --enable-dss specified. |
Jason Evans | 52386b2 | 2012-04-22 16:00:11 -0700 | [diff] [blame] | 77 | - Fix fork-related bugs that could cause deadlock in children between fork |
| 78 | and exec. |
Jason Evans | 9ef7f5d | 2012-04-16 18:16:48 -0700 | [diff] [blame] | 79 | - Fix malloc_stats_print() to honor 'b' and 'l' in the opts parameter. |
| 80 | - Fix realloc(p, 0) to act like free(p). |
| 81 | - Do not enforce minimum alignment in memalign(). |
| 82 | - Check for NULL pointer in malloc_usable_size(). |
Jason Evans | 52386b2 | 2012-04-22 16:00:11 -0700 | [diff] [blame] | 83 | - Fix an off-by-one heap profile statistics bug that could be observed in |
| 84 | interval- and growth-triggered heap profiles. |
Jason Evans | 6b9ed67 | 2012-04-25 13:12:46 -0700 | [diff] [blame] | 85 | - Fix the "epoch" mallctl to update cached stats even if the passed in epoch |
| 86 | is 0. |
Jason Evans | 9ef7f5d | 2012-04-16 18:16:48 -0700 | [diff] [blame] | 87 | - Fix bin->runcur management to fix a layout policy bug. This bug did not |
| 88 | affect correctness. |
| 89 | - Fix a bug in choose_arena_hard() that potentially caused more arenas to be |
| 90 | initialized than necessary. |
| 91 | - Add missing "opt.lg_tcache_max" mallctl implementation. |
| 92 | - Use glibc allocator hooks to make mixed allocator usage less likely. |
| 93 | - Fix build issues for --disable-tcache. |
Jason Evans | 918d6e2 | 2012-04-20 13:42:21 -0700 | [diff] [blame] | 94 | - Don't mangle pthread_create() when --with-private-namespace is specified. |
Jason Evans | 9ef7f5d | 2012-04-16 18:16:48 -0700 | [diff] [blame] | 95 | |
Jason Evans | b3bd885 | 2011-11-14 17:12:45 -0800 | [diff] [blame] | 96 | * 2.2.5 (November 14, 2011) |
| 97 | |
| 98 | Bug fixes: |
| 99 | - Fix huge_ralloc() race when using mremap(2). This is a serious bug that |
| 100 | could cause memory corruption and/or crashes. |
| 101 | - Fix huge_ralloc() to maintain chunk statistics. |
| 102 | - Fix malloc_stats_print(..., "a") output. |
| 103 | |
Jason Evans | ca9ee1a | 2011-11-05 21:46:23 -0700 | [diff] [blame] | 104 | * 2.2.4 (November 5, 2011) |
| 105 | |
| 106 | Bug fixes: |
| 107 | - Initialize arenas_tsd before using it. This bug existed for 2.2.[0-3], as |
| 108 | well as for --disable-tls builds in earlier releases. |
| 109 | - Do not assume a 4 KiB page size in test/rallocm.c. |
| 110 | |
Jason Evans | c67e4fd | 2011-08-31 15:19:13 -0700 | [diff] [blame] | 111 | * 2.2.3 (August 31, 2011) |
| 112 | |
| 113 | This version fixes numerous bugs related to heap profiling. |
| 114 | |
| 115 | Bug fixes: |
| 116 | - Fix a prof-related race condition. This bug could cause memory corruption, |
| 117 | but only occurred in non-default configurations (prof_accum:false). |
| 118 | - Fix off-by-one backtracing issues (make sure that prof_alloc_prep() is |
| 119 | excluded from backtraces). |
| 120 | - Fix a prof-related bug in realloc() (only triggered by OOM errors). |
| 121 | - Fix prof-related bugs in allocm() and rallocm(). |
| 122 | - Fix prof_tdata_cleanup() for --disable-tls builds. |
| 123 | - Fix a relative include path, to fix objdir builds. |
| 124 | |
Jason Evans | 4c48481 | 2011-07-30 16:59:13 -0700 | [diff] [blame] | 125 | * 2.2.2 (July 30, 2011) |
| 126 | |
| 127 | Bug fixes: |
| 128 | - Fix a build error for --disable-tcache. |
| 129 | - Fix assertions in arena_purge() (for real this time). |
| 130 | - Add the --with-private-namespace option. This is a workaround for symbol |
| 131 | conflicts that can inadvertently arise when using static libraries. |
| 132 | |
Jason Evans | 7d9ebea | 2011-03-30 15:01:08 -0700 | [diff] [blame] | 133 | * 2.2.1 (March 30, 2011) |
| 134 | |
| 135 | Bug fixes: |
| 136 | - Implement atomic operations for x86/x64. This fixes compilation failures |
| 137 | for versions of gcc that are still in wide use. |
| 138 | - Fix an assertion in arena_purge(). |
| 139 | |
Jason Evans | 4bcd987 | 2011-03-22 15:30:22 -0700 | [diff] [blame] | 140 | * 2.2.0 (March 22, 2011) |
| 141 | |
| 142 | This version incorporates several improvements to algorithms and data |
| 143 | structures that tend to reduce fragmentation and increase speed. |
| 144 | |
| 145 | New features: |
| 146 | - Add the "stats.cactive" mallctl. |
| 147 | - Update pprof (from google-perftools 1.7). |
| 148 | - Improve backtracing-related configuration logic, and add the |
| 149 | --disable-prof-libgcc option. |
| 150 | |
| 151 | Bug fixes: |
| 152 | - Change default symbol visibility from "internal", to "hidden", which |
| 153 | decreases the overhead of library-internal function calls. |
| 154 | - Fix symbol visibility so that it is also set on OS X. |
| 155 | - Fix a build dependency regression caused by the introduction of the .pic.o |
| 156 | suffix for PIC object files. |
| 157 | - Add missing checks for mutex initialization failures. |
| 158 | - Don't use libgcc-based backtracing except on x64, where it is known to work. |
| 159 | - Fix deadlocks on OS X that were due to memory allocation in |
| 160 | pthread_mutex_lock(). |
| 161 | - Heap profiling-specific fixes: |
| 162 | + Fix memory corruption due to integer overflow in small region index |
| 163 | computation, when using a small enough sample interval that profiling |
| 164 | context pointers are stored in small run headers. |
| 165 | + Fix a bootstrap ordering bug that only occurred with TLS disabled. |
| 166 | + Fix a rallocm() rsize bug. |
| 167 | + Fix error detection bugs for aligned memory allocation. |
| 168 | |
Jason Evans | 0e4d0d1 | 2011-03-14 16:41:03 -0700 | [diff] [blame] | 169 | * 2.1.3 (March 14, 2011) |
| 170 | |
| 171 | Bug fixes: |
| 172 | - Fix a cpp logic regression (due to the "thread.{de,}allocatedp" mallctl fix |
| 173 | for OS X in 2.1.2). |
| 174 | - Fix a "thread.arena" mallctl bug. |
| 175 | - Fix a thread cache stats merging bug. |
| 176 | |
je | 6e56e5e | 2011-03-02 11:23:41 -0800 | [diff] [blame] | 177 | * 2.1.2 (March 2, 2011) |
| 178 | |
| 179 | Bug fixes: |
| 180 | - Fix "thread.{de,}allocatedp" mallctl for OS X. |
| 181 | - Add missing jemalloc.a to build system. |
| 182 | |
Jason Evans | 6369286 | 2011-02-07 22:48:35 -0800 | [diff] [blame] | 183 | * 2.1.1 (January 31, 2011) |
Jason Evans | ada55b2 | 2011-01-31 20:08:56 -0800 | [diff] [blame] | 184 | |
Jason Evans | 6369286 | 2011-02-07 22:48:35 -0800 | [diff] [blame] | 185 | Bug fixes: |
Jason Evans | ada55b2 | 2011-01-31 20:08:56 -0800 | [diff] [blame] | 186 | - Fix aligned huge reallocation (affected allocm()). |
| 187 | - Fix the ALLOCM_LG_ALIGN macro definition. |
| 188 | - Fix a heap dumping deadlock. |
| 189 | - Fix a "thread.arena" mallctl bug. |
| 190 | |
Jason Evans | 6369286 | 2011-02-07 22:48:35 -0800 | [diff] [blame] | 191 | * 2.1.0 (December 3, 2010) |
Jason Evans | 0e8d3d2 | 2010-12-03 17:02:16 -0800 | [diff] [blame] | 192 | |
| 193 | This version incorporates some optimizations that can't quite be considered |
| 194 | bug fixes. |
| 195 | |
| 196 | New features: |
| 197 | - Use Linux's mremap(2) for huge object reallocation when possible. |
| 198 | - Avoid locking in mallctl*() when possible. |
| 199 | - Add the "thread.[de]allocatedp" mallctl's. |
| 200 | - Convert the manual page source from roff to DocBook, and generate both roff |
| 201 | and HTML manuals. |
| 202 | |
| 203 | Bug fixes: |
| 204 | - Fix a crash due to incorrect bootstrap ordering. This only impacted |
| 205 | --enable-debug --enable-dss configurations. |
| 206 | - Fix a minor statistics bug for mallctl("swap.avail", ...). |
| 207 | |
Jason Evans | 6369286 | 2011-02-07 22:48:35 -0800 | [diff] [blame] | 208 | * 2.0.1 (October 29, 2010) |
Jason Evans | 53806fe | 2010-10-29 20:16:39 -0700 | [diff] [blame] | 209 | |
| 210 | Bug fixes: |
| 211 | - Fix a race condition in heap profiling that could cause undefined behavior |
Jason Evans | ada55b2 | 2011-01-31 20:08:56 -0800 | [diff] [blame] | 212 | if "opt.prof_accum" were disabled. |
Jason Evans | 53806fe | 2010-10-29 20:16:39 -0700 | [diff] [blame] | 213 | - Add missing mutex unlocks for some OOM error paths in the heap profiling |
| 214 | code. |
| 215 | - Fix a compilation error for non-C99 builds. |
| 216 | |
Jason Evans | 6369286 | 2011-02-07 22:48:35 -0800 | [diff] [blame] | 217 | * 2.0.0 (October 24, 2010) |
Jason Evans | 379f847 | 2010-10-24 16:18:29 -0700 | [diff] [blame] | 218 | |
| 219 | This version focuses on the experimental *allocm() API, and on improved |
| 220 | run-time configuration/introspection. Nonetheless, numerous performance |
| 221 | improvements are also included. |
| 222 | |
| 223 | New features: |
Jason Evans | b059a53 | 2010-10-24 16:54:40 -0700 | [diff] [blame] | 224 | - Implement the experimental {,r,s,d}allocm() API, which provides a superset |
| 225 | of the functionality available via malloc(), calloc(), posix_memalign(), |
| 226 | realloc(), malloc_usable_size(), and free(). These functions can be used to |
| 227 | allocate/reallocate aligned zeroed memory, ask for optional extra memory |
| 228 | during reallocation, prevent object movement during reallocation, etc. |
| 229 | - Replace JEMALLOC_OPTIONS/JEMALLOC_PROF_PREFIX with MALLOC_CONF, which is |
| 230 | more human-readable, and more flexible. For example: |
| 231 | JEMALLOC_OPTIONS=AJP |
| 232 | is now: |
| 233 | MALLOC_CONF=abort:true,fill:true,stats_print:true |
| 234 | - Port to Apple OS X. Sponsored by Mozilla. |
| 235 | - Make it possible for the application to control thread-->arena mappings via |
| 236 | the "thread.arena" mallctl. |
| 237 | - Add compile-time support for all TLS-related functionality via pthreads TSD. |
| 238 | This is mainly of interest for OS X, which does not support TLS, but has a |
| 239 | TSD implementation with similar performance. |
| 240 | - Override memalign() and valloc() if they are provided by the system. |
| 241 | - Add the "arenas.purge" mallctl, which can be used to synchronously purge all |
| 242 | dirty unused pages. |
| 243 | - Make cumulative heap profiling data optional, so that it is possible to |
| 244 | limit the amount of memory consumed by heap profiling data structures. |
| 245 | - Add per thread allocation counters that can be accessed via the |
| 246 | "thread.allocated" and "thread.deallocated" mallctls. |
Jason Evans | 379f847 | 2010-10-24 16:18:29 -0700 | [diff] [blame] | 247 | |
| 248 | Incompatible changes: |
Jason Evans | b059a53 | 2010-10-24 16:54:40 -0700 | [diff] [blame] | 249 | - Remove JEMALLOC_OPTIONS and malloc_options (see MALLOC_CONF above). |
| 250 | - Increase default backtrace depth from 4 to 128 for heap profiling. |
| 251 | - Disable interval-based profile dumps by default. |
Jason Evans | 379f847 | 2010-10-24 16:18:29 -0700 | [diff] [blame] | 252 | |
| 253 | Bug fixes: |
| 254 | - Remove bad assertions in fork handler functions. These assertions could |
| 255 | cause aborts for some combinations of configure settings. |
| 256 | - Fix strerror_r() usage to deal with non-standard semantics in GNU libc. |
| 257 | - Fix leak context reporting. This bug tended to cause the number of contexts |
| 258 | to be underreported (though the reported number of objects and bytes were |
| 259 | correct). |
| 260 | - Fix a realloc() bug for large in-place growing reallocation. This bug could |
| 261 | cause memory corruption, but it was hard to trigger. |
| 262 | - Fix an allocation bug for small allocations that could be triggered if |
| 263 | multiple threads raced to create a new run of backing pages. |
| 264 | - Enhance the heap profiler to trigger samples based on usable size, rather |
| 265 | than request size. |
| 266 | - Fix a heap profiling bug due to sometimes losing track of requested object |
| 267 | size for sampled objects. |
| 268 | |
Jason Evans | 6369286 | 2011-02-07 22:48:35 -0800 | [diff] [blame] | 269 | * 1.0.3 (August 12, 2010) |
Jason Evans | 379f847 | 2010-10-24 16:18:29 -0700 | [diff] [blame] | 270 | |
| 271 | Bug fixes: |
| 272 | - Fix the libunwind-based implementation of stack backtracing (used for heap |
| 273 | profiling). This bug could cause zero-length backtraces to be reported. |
| 274 | - Add a missing mutex unlock in library initialization code. If multiple |
| 275 | threads raced to initialize malloc, some of them could end up permanently |
| 276 | blocked. |
| 277 | |
Jason Evans | 6369286 | 2011-02-07 22:48:35 -0800 | [diff] [blame] | 278 | * 1.0.2 (May 11, 2010) |
Jason Evans | 379f847 | 2010-10-24 16:18:29 -0700 | [diff] [blame] | 279 | |
| 280 | Bug fixes: |
| 281 | - Fix junk filling of large objects, which could cause memory corruption. |
| 282 | - Add MAP_NORESERVE support for chunk mapping, because otherwise virtual |
| 283 | memory limits could cause swap file configuration to fail. Contributed by |
| 284 | Jordan DeLong. |
| 285 | |
Jason Evans | 6369286 | 2011-02-07 22:48:35 -0800 | [diff] [blame] | 286 | * 1.0.1 (April 14, 2010) |
Jason Evans | 379f847 | 2010-10-24 16:18:29 -0700 | [diff] [blame] | 287 | |
| 288 | Bug fixes: |
| 289 | - Fix compilation when --enable-fill is specified. |
| 290 | - Fix threads-related profiling bugs that affected accuracy and caused memory |
| 291 | to be leaked during thread exit. |
| 292 | - Fix dirty page purging race conditions that could cause crashes. |
| 293 | - Fix crash in tcache flushing code during thread destruction. |
| 294 | |
Jason Evans | 6369286 | 2011-02-07 22:48:35 -0800 | [diff] [blame] | 295 | * 1.0.0 (April 11, 2010) |
Jason Evans | 379f847 | 2010-10-24 16:18:29 -0700 | [diff] [blame] | 296 | |
| 297 | This release focuses on speed and run-time introspection. Numerous |
| 298 | algorithmic improvements make this release substantially faster than its |
| 299 | predecessors. |
| 300 | |
| 301 | New features: |
| 302 | - Implement autoconf-based configuration system. |
| 303 | - Add mallctl*(), for the purposes of introspection and run-time |
| 304 | configuration. |
| 305 | - Make it possible for the application to manually flush a thread's cache, via |
| 306 | the "tcache.flush" mallctl. |
| 307 | - Base maximum dirty page count on proportion of active memory. |
| 308 | - Compute various addtional run-time statistics, including per size class |
| 309 | statistics for large objects. |
| 310 | - Expose malloc_stats_print(), which can be called repeatedly by the |
| 311 | application. |
| 312 | - Simplify the malloc_message() signature to only take one string argument, |
| 313 | and incorporate an opaque data pointer argument for use by the application |
| 314 | in combination with malloc_stats_print(). |
| 315 | - Add support for allocation backed by one or more swap files, and allow the |
| 316 | application to disable over-commit if swap files are in use. |
| 317 | - Implement allocation profiling and leak checking. |
| 318 | |
| 319 | Removed features: |
| 320 | - Remove the dynamic arena rebalancing code, since thread-specific caching |
| 321 | reduces its utility. |
| 322 | |
| 323 | Bug fixes: |
| 324 | - Modify chunk allocation to work when address space layout randomization |
| 325 | (ASLR) is in use. |
| 326 | - Fix thread cleanup bugs related to TLS destruction. |
| 327 | - Handle 0-size allocation requests in posix_memalign(). |
| 328 | - Fix a chunk leak. The leaked chunks were never touched, so this impacted |
| 329 | virtual memory usage, but not physical memory usage. |
| 330 | |
Jason Evans | 6369286 | 2011-02-07 22:48:35 -0800 | [diff] [blame] | 331 | * linux_2008082[78]a (August 27/28, 2008) |
Jason Evans | 379f847 | 2010-10-24 16:18:29 -0700 | [diff] [blame] | 332 | |
| 333 | These snapshot releases are the simple result of incorporating Linux-specific |
| 334 | support into the FreeBSD malloc sources. |
| 335 | |
| 336 | -------------------------------------------------------------------------------- |
| 337 | vim:filetype=text:textwidth=80 |