xref: /freebsd/contrib/libcbor/CHANGELOG.md (revision d411c1d6)
1Template:
2- [Fix issue X in feature Y](https://github.com/PJK/libcbor/pull/XXX) (by [YYY](https://github.com/YYY))
3
4Next
5---------------------
6
70.10.2 (2023-01-31)
8---------------------
9- [Fixed minor test bug causing failures for x86 Linux](https://github.com/PJK/libcbor/pull/266) (discovered by [trofi](https://github.com/PJK/libcbor/issues/263))
10  - Actual libcbor functionality not affected, bug was in the test suite
11- [Made tests platform-independent](https://github.com/PJK/libcbor/pull/272)
12
130.10.1 (2022-12-30)
14---------------------
15- [Fix a regression in `cbor_serialize_alloc` that caused serialization of zero-length strings and bytestrings or byte/strings with zero-length chunks to fail](https://github.com/PJK/libcbor/pull/260) (discovered by [martelletto](https://github.com/martelletto))
16
170.10.0 (2022-12-29)
18---------------------
19- Make the buffer_size optional in `cbor_serialize_alloc` [[#205]](https://github.com/PJK/libcbor/pull/205) (by [hughsie](https://github.com/hughsie))
20- BREAKING: Improved half-float encoding for denormalized numbers. [[#208]](https://github.com/PJK/libcbor/pull/208) (by [ranvis](https://github.com/ranvis))
21  - Denormalized half-floats will now preserve data in the mantissa
22  - Note: Half-float NaNs still lose data (https://github.com/PJK/libcbor/issues/215)
23- BUILD BREAKING: Minimum CMake version is 3.0 [[#201]](https://github.com/PJK/libcbor/pull/201) (by [thewtex@](https://github.com/thewtex))
24  - See https://repology.org/project/cmake/versions for support; the vast majority of users should not be affected.
25- Fix a potential memory leak when the allocator fails during array or map decoding [[#224]](https://github.com/PJK/libcbor/pull/224) (by [James-ZHANG](https://github.com/James-ZHANG))
26- [Fix a memory leak when the allocator fails when adding chunks to indefinite bytestrings.](https://github.com/PJK/libcbor/pull/242) ([discovered](https://github.com/PJK/libcbor/pull/228) by [James-ZHANG](https://github.com/James-ZHANG))
27- [Fix a memory leak when the allocator fails when adding chunks to indefinite strings](https://github.com/PJK/libcbor/pull/246)
28- Potentially BUILD BREAKING: [Add nodiscard attributes to most functions](https://github.com/PJK/libcbor/pull/248)
29  - **Warning**: This may cause new build warnings and (in rare cases, depending on your configuration) errors
30- BREAKING: [Fix `cbor_copy` leaking memory and creating invalid items when the allocator fails](https://github.com/PJK/libcbor/pull/249).
31  - Previously, the failures were not handled in the interface. Now, `cbor_copy` may return `NULL` upon failure; clients should check the return value
32- [Fix `cbor_build_tag` illegal memory behavior when the allocator fails](https://github.com/PJK/libcbor/pull/249)
33- [Add a new `cbor_serialized_size` API](https://github.com/PJK/libcbor/pull/250)
34- [Reworked `cbor_serialize_alloc` to allocate the exact amount of memory necessary upfront](https://github.com/PJK/libcbor/pull/251)
35  - This should significantly speed up `cbor_serialize_alloc` for large items by avoiding multiple reallocation iterations
36  - Clients should not use the return value of `cbor_serialize_alloc`. It may be removed in the future.
37- BUILD BREAKING: [Deprecate CBOR_CUSTOM_ALLOC](https://github.com/PJK/libcbor/pull/237)
38  - `cbor_set_allocs` will always be enabled from now on
39  - Note: The flag will be kept as a no-op triggering a warning when used for one version and then removed completely
40
410.9.0 (2021-11-14)
42---------------------
43- Improved pkg-config paths handling [[#164]](https://github.com/PJK/libcbor/pull/164) (by [jtojnar@](https://github.com/jtojnar))
44- Use explicit math.h linkage [[#170]](https://github.com/PJK/libcbor/pull/170)
45- BREAKING: Fixed handling of items that exceed the host size_t range [[#186]](https://github.com/PJK/libcbor/pull/186hg)
46    - Callbacks for bytestrings, strings, arrays, and maps use uint64_t instead of size_t to allow handling of large items that exceed size_t even if size_t < uint64_t
47    - cbor_decode explicitly checks size to avoid overflows (previously broken, potentially resulting in erroneous decoding on affected systems)
48    - The change should be a noop for 64b systems
49- Added a [Bazel](https://bazel.build/) build example [[#196]](https://github.com/PJK/libcbor/pull/196) (by [andyjgf@](https://github.com/andyjgf))
50
510.8.0 (2020-09-20)
52---------------------
53- BUILD BREAKING: Use BUILD_SHARED_LIBS to determine how to build libraries (fixed Windows linkage) [[#148]](https://github.com/PJK/libcbor/pull/148) (by [intelligide@](https://github.com/intelligide))
54- BREAKING: Fix `cbor_tag_item` not increasing the reference count on the tagged item reference it returns [[Fixes #109](https://github.com/PJK/libcbor/issues/109)] (discovered bt [JohnGilmour](https://github.com/JohnGilmour))
55  - If you have previously relied on the broken behavior, you can use `cbor_move` to emulate as long as the returned handle is an "rvalue"
56- BREAKING: [`CBOR_DECODER_EBUFFER` removed from `cbor_decoder_status`](https://github.com/PJK/libcbor/pull/156)
57    - `cbor_stream_decode` will set `CBOR_DECODER_NEDATA` instead if the input buffer is empty
58- [Fix `cbor_stream_decode`](https://github.com/PJK/libcbor/pull/156) to set `cbor_decoder_result.required` to the minimum number of input bytes necessary to receive the next callback (as long as at least one byte was passed) (discovered by [woefulwabbit](https://github.com/woefulwabbit))
59- Fixed several minor manpage issues [[#159]](https://github.com/PJK/libcbor/pull/159) (discovered by [kloczek@](https://github.com/kloczek))
60
610.7.0 (2020-04-25)
62---------------------
63- Fix bad encoding of NaN half-floats [[Fixes #53]](https://github.com/PJK/libcbor/issues/53) (discovered by [BSipos-RKF](https://github.com/BSipos-RKF))
64    - **Warning**: Previous versions encoded NaNs as `0xf9e700` instead of `0xf97e00`; if you rely on the broken behavior, this will be a breaking change
65- Fix potentially bad encoding of negative half-float with exponent < -14 [[Fixes #112]](https://github.com/PJK/libcbor/issues/112) (discovered by [yami36](https://github.com/yami36))
66- BREAKING: Improved bool support [[Fixes #63]](https://github.com/PJK/libcbor/issues/63)
67    - Rename `cbor_ctrl_is_bool` to `cbor_get_bool` and fix the behavior
68    - Add `cbor_set_bool`
69- Fix memory_allocation_test breaking the build without CBOR_CUSTOM_ALLOC [[Fixes #128]](https://github.com/PJK/libcbor/issues/128) (by [panlinux](https://github.com/panlinux))
70- [Fix a potential build issue where cJSON includes may be misconfigured](https://github.com/PJK/libcbor/pull/132)
71- Breaking: [Add a limit on the size of the decoding context stack](https://github.com/PJK/libcbor/pull/138) (by [James-ZHANG](https://github.com/James-ZHANG))
72    - If your usecase requires parsing very deeply nested structures, you might need to increase the default 2k limit via `CBOR_MAX_STACK_SIZE`
73- Enable LTO/IPO based on [CheckIPOSupported](https://cmake.org/cmake/help/latest/module/CheckIPOSupported.html#module:CheckIPOSupported) [[#143]](https://github.com/PJK/libcbor/pull/143) (by [xanderlent](https://github.com/xanderlent))
74    - If you rely on LTO being enabled and use CMake version older than 3.9, you will need to re-enable it manually or upgrade your CMake
75
760.6.1 (2020-03-26)
77---------------------
78- [Fix bad shared library version number](https://github.com/PJK/libcbor/pull/131)
79    - **Warning**: Shared library built from the 0.6.0 release is erroneously marked as version "0.6.0", which makes it incompatible with future releases *including the v0.6.X line* even though they may be compatible API/ABI-wise. Refer to the documentation for the new SO versioning scheme.
80
810.6.0 (2020-03-15)
82---------------------
83- Correctly set .so version [[Fixes #52]](https://github.com/PJK/libcbor/issues/52).
84    - **Warning**: All previous releases will be identified as 0.0 by the linker.
85- Fix & prevent heap overflow error in example code [[#74]](https://github.com/PJK/libcbor/pull/74) [[#76]](https://github.com/PJK/libcbor/pull/76) (by @nevun)
86- Correctly set OSX dynamic library version [[Fixes #75]](https://github.com/PJK/libcbor/issues/75)
87- [Fix misplaced 0xFF bytes in maps possibly causing memory corruption](https://github.com/PJK/libcbor/pull/82)
88- BREAKING: Fix handling & cleanup of failed memory allocation in constructor
89  and builder helper functions [[Fixes #84]](https://github.com/PJK/libcbor/issues/84)
90  - All cbor_new_* and cbor_build_* functions will now explicitly return NULL when memory allocation fails
91  - It is up to the client to handle such cases
92- Globally enforced code style [[Fixes #83]](https://github.com/PJK/libcbor/issues/83)
93- Fix issue possible memory corruption bug on repeated
94  cbor_(byte)string_add_chunk calls with intermittently failing realloc calls
95- Fix possibly misaligned reads and writes when endian.h is uses or when
96  running on a big-endian machine [[Fixes #99](https://github.com/PJK/libcbor/issues/99), [#100](https://github.com/PJK/libcbor/issues/100)]
97- [Improved CI setup with Travis-native arm64 support](https://github.com/PJK/libcbor/pull/116)
98- [Docs migrated to Sphinx 2.4 and Python3](https://github.com/PJK/libcbor/pull/117)
99
1000.5.0 (2017-02-06)
101---------------------
102- Remove cmocka from the subtree (always rely on system or user-provided version)
103- Windows CI
104- Only build tests if explicitly enabled (`-DWITH_TESTS=ON`)
105- Fixed static header declarations (by cedric-d)
106- Improved documentation (by Michael Richardson)
107- Improved `examples/readfile.c`
108- Reworked (re)allocation to handle huge inputs and overflows in size_t [[Fixes #16]](https://github.com/PJK/libcbor/issues/16)
109- Improvements to C++ linkage (corrected `cbor_empty_callbacks`, fixed `restrict` pointers) (by Dennis Bijwaard)
110- Fixed Linux installation directory depending on architecture [[Fixes #34]](https://github.com/PJK/libcbor/issues/34) (by jvymazal)
111- Improved 32-bit support [[Fixes #35]](https://github.com/PJK/libcbor/issues/35)
112- Fixed MSVC compatibility [[Fixes #31]](https://github.com/PJK/libcbor/issues/31)
113- Fixed and improved half-float encoding [[Fixes #5](https://github.com/PJK/libcbor/issues/5), [#11](https://github.com/PJK/libcbor/issues/11)]
114
1150.4.0 (2015-12-25)
116---------------------
117Breaks build & header compatibility due to:
118
119- Improved build configuration and feature check macros
120- Endianess configuration fixes (by Erwin Kroon and David Grigsby)
121- pkg-config compatibility (by Vincent Bernat)
122- enable use of versioned SONAME (by Vincent Bernat)
123- better fuzzer (wasn't random until now, ooops)
124
1250.3.1 (2015-05-21)
126---------------------
127- documentation and comments improvements, mostly for the API reference
128
1290.3.0 (2015-05-21)
130---------------------
131
132- Fixes, polishing, niceties across the code base
133- Updated examples
134- `cbor_copy`
135- `cbor_build_negint8`, 16, 32, 64, matching asserts
136- `cbor_build_stringn`
137- `cbor_build_tag`
138- `cbor_build_float2`, ...
139
1400.2.1 (2015-05-17)
141---------------------
142- C99 support
143
1440.2.0 (2015-05-17)
145---------------------
146
147- `cbor_ctrl_bool` -> `cbor_ctrl_is_bool`
148- Added `cbor_array_allocated` & map equivalent
149- Overhauled endianess conversion - ARM now works as expected
150- 'sort.c' example added
151- Significantly improved and doxyfied documentation
152
1530.1.0 (2015-05-06)
154---------------------
155
156The initial release, yay!
157