summaryrefslogtreecommitdiffstats
path: root/release_docs
diff options
context:
space:
mode:
authorDana Robinson <derobins@hdfgroup.org>2015-04-01 23:29:24 (GMT)
committerDana Robinson <derobins@hdfgroup.org>2015-04-01 23:29:24 (GMT)
commit6986211d6584792ca48cb2469d0e779c445638d2 (patch)
tree6c2c9158d8c1e69d2c3e338192da0cb7c8d58182 /release_docs
parentad4154cdc89ddf15691dbfe1c609898ef484808b (diff)
downloadhdf5-6986211d6584792ca48cb2469d0e779c445638d2.zip
hdf5-6986211d6584792ca48cb2469d0e779c445638d2.tar.gz
hdf5-6986211d6584792ca48cb2469d0e779c445638d2.tar.bz2
[svn-r26703] Merge of r26392 from trunk.
Adds new memory allocation functions that use the library's memory allocator. Intended for use with third-party filter code. Tested on: h5committest, Solaris (emu), OS X (quail) Note: emu fails with the existing Inf/inf case problem in h5dump but no other tests fail.
Diffstat (limited to 'release_docs')
-rw-r--r--release_docs/RELEASE.txt27
1 files changed, 26 insertions, 1 deletions
diff --git a/release_docs/RELEASE.txt b/release_docs/RELEASE.txt
index 7b866ce..52c4ae5 100644
--- a/release_docs/RELEASE.txt
+++ b/release_docs/RELEASE.txt
@@ -185,7 +185,32 @@ New Features
Library
-------
- - None
+ - Added memory allocation functions that use the library's allocator.
+
+ HDF5 filters may need to allocate or resize the buffer that is passed
+ to them from the library. If the filter has been compiled separately
+ from the library, it and the library may use different memory
+ allocation libraries for the (re)allocation and free calls. This can
+ cause heap corruption and crashes. This is particularly a problem on
+ Windows since each C run-time library is implemented as a separate
+ shared library, but can also show up on POSIX systems when debug or
+ high-performance allocation libraries are in use.
+
+ Two new functions (H5allocate_memory() and H5resize_memory()) were
+ added to the HDF5 C library. These functions have the same semantics as
+ malloc/calloc and realloc, respectively. Their primary purpose is to
+ allow filter authors to allocate or resize memory using the same
+ memory allocation library as the HDF5 library. Filter authors are
+ highly encouraged to use these new functions in place of malloc,
+ calloc, and realloc. They should also use the H5free_memory() call when
+ freeing memory.
+
+ Note that the filters provided with the library (zlib, szip, etc.) do
+ not experience the problems that these new functions are intended to
+ fix. This work only applies to third-party filters that are compiled
+ separately from the library.
+
+ (DER - 2015-04-01, HDFFV-9100)
Parallel Library
----------------