diff options
author | Dana Robinson <43805+derobins@users.noreply.github.com> | 2021-03-23 11:19:53 (GMT) |
---|---|---|
committer | GitHub <noreply@github.com> | 2021-03-23 11:19:53 (GMT) |
commit | 69f3cde9365a1190f624586e7e9736b7b4df55f1 (patch) | |
tree | 319fe29f6b453cbae2f5a5c9aa0b3782885d6959 /release_docs | |
parent | 99c0f504a27164d74b2c8e2d4d6afa597ba5ca7b (diff) | |
download | hdf5-69f3cde9365a1190f624586e7e9736b7b4df55f1.zip hdf5-69f3cde9365a1190f624586e7e9736b7b4df55f1.tar.gz hdf5-69f3cde9365a1190f624586e7e9736b7b4df55f1.tar.bz2 |
Updates HSYS_GOTO_ERROR to emit GetLastError() values on Win32 (#492)
* Committing clang-format changes
* Updates H5SYS_GOTO_ERROR to emit Win32's GetLastError()
* Committing clang-format changes
* Format source changes
Co-authored-by: github-actions <41898282+github-actions[bot]@users.noreply.github.com>
Diffstat (limited to 'release_docs')
-rw-r--r-- | release_docs/RELEASE.txt | 28 |
1 files changed, 27 insertions, 1 deletions
diff --git a/release_docs/RELEASE.txt b/release_docs/RELEASE.txt index 848c712..2af0273 100644 --- a/release_docs/RELEASE.txt +++ b/release_docs/RELEASE.txt @@ -384,6 +384,33 @@ New Features Library: -------- + - HSYS_GOTO_ERROR now emits the results of GetLastError() on Windows + + HSYS_GOTO_ERROR is an internal macro that is used to produce error + messages when system calls fail. These strings include errno and the + the associated strerror() value, which are not particularly useful + when a Win32 API call fails. + + On Windows, this macro has been updated to include the result of + GetLastError(). When a system call fails on Windows, usually only + one of errno and GetLastError() will be useful, however we emit both + for the user to parse. The Windows error message is not emitted as + it would be awkward to free the FormatMessage() buffer given the + existing HDF5 error framework. Users will have to look up the error + codes in MSDN. + + The format string on Windows has been changed from: + + "%s, errno = %d, error message = '%s'" + + to: + + "%s, errno = %d, error message = '%s', Win32 GetLastError() = %"PRIu32"" + + for those inclined to parse it for error values. + + (DER - 2021/03/21) + - File locking now works on Windows Since version 1.10.0, the HDF5 library has used a file locking scheme @@ -400,7 +427,6 @@ New Features (DER - 2021/03/19, HDFFV-10191) - - H5Epush_ret() now requires a trailing semicolon H5Epush_ret() is a function-like macro that has been changed to |