You can not select more than 25 topics Topics must start with a chinese character,a letter or number, can include dashes ('-') and can be up to 35 characters long.

ChangeLog 18 kB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427
  1. Next version, 0.14
  2. ==================
  3. Deprecated and removed features:
  4. --------------------------------
  5. * bits.h has been removed
  6. * lh_abort() has been removed
  7. * lh_table_lookup() has been removed, use lh_table_lookup_ex() instead.
  8. * Remove TRUE and FALSE defines, use 1 and 0 instead.
  9. Build changes:
  10. --------------
  11. Contributors to this release
  12. ----------------------------
  13. * Alexander Dahl <post@lespocky.de>
  14. * andy5995 <andy400-dev@yahoo.com>
  15. * Björn Esser <besser82@fedoraproject.org>
  16. * changyong guo <guo1487@163.com>
  17. * chenguoping <chenguopingdota@163.com>
  18. * Christopher Head <chead@chead.ca>
  19. * Chris Wolfe <chriswwolfe@gmail.com>
  20. * Darjan Krijan <darjan_krijan@gmx.de>
  21. * Eric Hawicz <erh+git@nimenees.com>
  22. * grdowns <grdowns@microsoft.com>
  23. * Ivan Romanov <drizt@land.ru>
  24. * Jaap Keuter <jaap.keuter@xs4all.nl>
  25. * janczer <menshikov.ivn@gmail.com>
  26. * Jehan <jehan@girinstud.io>
  27. * Jonathan Wiens <j.wiens@teles.com>
  28. * Jose Bollo <jose.bollo@iot.bzh>
  29. * Keith Holman <keith.holman@windriver.com>
  30. * Liang, Gao <liang.gao@intel.com>
  31. * max <mpano91@gmail.com>
  32. * myd7349 <myd7349@gmail.com>
  33. * Pierce Lopez <pierce.lopez@gmail.com>
  34. * Po-Chuan Hsieh <sunpoet@sunpoet.net>
  35. * Ramiro Polla <ramiro.polla@gmail.com>
  36. * Rikard Falkeborn <rikard.falkeborn@gmail.com>
  37. * Robert <roby_p97@yahoo.com>
  38. * Rubasri Kalidas <rubasri.kalidas@intel.com>
  39. * Unmanned Player <36690541+unmanned-player@users.noreply.github.com>
  40. 0.13.1 (up to commit 0f814e5, 2018/03/04)
  41. =========================================
  42. * Bump the major version of the .so library generated up to 4.0 to avoid
  43. conflicts because some downstream packagers of json-c had already done
  44. their own bump to ".so.3" for a much older 0.12 release.
  45. * Add const size_t json_c_object_sizeof()
  46. * Avoid invalid free (and thus a segfault) when ref_count gets < 0
  47. * PR#394: fix handling of custom double formats that include a ".0"
  48. * Avoid uninitialized variable warnings in json_object_object_foreach
  49. * Issue #396: fix build for certain uClibc based systems.
  50. * Add a top level fuzz directory for fuzzers run by OSS-Fuzz
  51. 0.13 (up to commit 5dae561, 2017/11/29)
  52. =================================
  53. This release, being three and a half years after the 0.12 branch (f84d9c),
  54. has quite a number of changes included. The following is a sampling of
  55. the most significant ones.
  56. Since the 0.12 release, 250 issues and pull requests have been closed.
  57. See issues_closed_for_0.13.md for a complete list.
  58. Deprecated and removed features:
  59. --------------------------------
  60. * All internal use of bits.h has been eliminated. The file will be removed.
  61. Do not use: hexdigit(), error_ptr(), error_descrition() and it_error()
  62. * lh_abort() is deprecated. It will be removed.
  63. Behavior changes:
  64. -----------------
  65. * Tighten the number parsing algorithm to raise errors instead of truncating
  66. the results. For example 12.3.4 or 2015-01-15, which now return null.
  67. See commit 99d8fc
  68. * Use size_t for array length and size. Platforms where sizeof(size_t) != sizeof(int) may not be backwards compatible
  69. See commits 45c56b, 92e9a5 and others.
  70. * Check for failue when allocating memory, returning NULL and errno=ENOMEM.
  71. See commit 2149a04.
  72. * Change json_object_object_add() return type from void to int, and will return -1 on failures, instead of exiting. (Note: this is not an ABI change)
  73. New features:
  74. -------------
  75. * We're aiming to follow RFC 7159 now.
  76. * Add a couple of additional option to json_object_to_json_string_ext:
  77. JSON_C_TO_STRING_PRETTY_TAB
  78. JSON_C_TO_STRING_NOSLASHESCAPE
  79. * Add a json_object_object_add_ex() function to allow for performance
  80. improvements when certain constraints are known to be true.
  81. * Make serialization format of doubles configurable, in two different ways:
  82. Call json_object_set_serializer with json_object_double_to_json_string and a custom
  83. format on each double object, or
  84. Call json_c_set_serialization_double_format() to set a global or thread-wide format.
  85. * Add utility function for comparing json_objects - json_object_equal()
  86. * Add a way to copy entire object trees: json_object_deep_copy()
  87. * Add json_object_set_<type> function to modify the value of existing json_object's
  88. without the need to recreate them. Also add a json_object_int_inc function to
  89. adjust an int's value.
  90. * Add support for JSON pointer, RFC 6901. See json_pointer.h
  91. * Add a json_util_get_last_err() function to retrieve the string describing the
  92. cause of errors, instead of printing to stderr.
  93. * Add perllike hash function for strings, and json_global_set_string_hash() 8f8d03d
  94. * Add a json_c_visit() function to provide a way to iterate over a tree of json-c objects.
  95. Notable bug fixes and other improvements:
  96. -----------------------------------------
  97. * Make reference increment and decrement atomic to allow passing json objects between threads.
  98. * Fix json_object_object_foreach to avoid uninitialized variable warnings.
  99. * Improve performance by removing unneeded data items from hashtable code and reducing duplicate hash computation.
  100. * Improve performance by storing small strings inside json_object
  101. * Improve performance of json_object_to_json_string by removing variadic printf. commit 9ff0f49
  102. * Issue #371: fix parsing of "-Infinity", and avoid needlessly copying the input when doing so.
  103. * Fix stack buffer overflow in json_object_double_to_json_string_format() - commit 2c2deb87
  104. * Fix various potential null ptr deref and int32 overflows
  105. * Issue #332: fix a long-standing bug in array_list_put_idx() where it would attempt to free previously free'd entries due to not checking the current array length.
  106. * Issue #195: use uselocale() instead of setlocale() in json_tokener to behave better in threaded environments.
  107. * Issue #275: fix out of bounds read when handling unicode surrogate pairs.
  108. * Ensure doubles that happen to be a whole number are emitted with ".0" - commit ca7a19
  109. * PR#331: for Visual Studio, use a snprintf/vsnprintf wrapper that ensures the string is terminated.
  110. * Fix double to int cast overflow in json_object_get_int64.
  111. * Clamp double to int32 when narrowing in json_object_get_int.
  112. * Use strtoll() to parse ints - instead of sscanf
  113. * Miscellaneous smaller changes, including removing unused variables, fixing warning
  114. about uninitialized variables adding const qualifiers, reformatting code, etc...
  115. Build changes:
  116. --------------
  117. * Add Appveyor and Travis build support
  118. * Switch to using CMake when building on Windows with Visual Studio.
  119. A dynamic .dll is generated instead of a .lib
  120. config.h is now generated, config.h.win32 should no longer be manually copied
  121. * Add support for MacOS through CMake too.
  122. * Enable silent build by default
  123. * Link against libm when needed
  124. * Add support for building with AddressSanitizer
  125. * Add support for building with Clang
  126. * Add a --enable-threading configure option, and only use the (slower) __sync_add_and_fetch()/__sync_sub_and_fetch() function when it is specified.
  127. List of new functions added:
  128. ----------------------------
  129. ### json_object.h
  130. * array_list_bsearch()
  131. * array_list_del_idx()
  132. * json_object_to_json_string_length()
  133. * json_object_get_userdata()
  134. * json_object_set_userdata()
  135. * json_object_object_add_ex()
  136. * json_object_array_bsearch()
  137. * json_object_array_del_idx()
  138. * json_object_set_boolean()
  139. * json_object_set_int()
  140. * json_object_int_inc()
  141. * json_object_set_int64()
  142. * json_c_set_serialization_double_format()
  143. * json_object_double_to_json_string()
  144. * json_object_set_double()
  145. * json_object_set_string()
  146. * json_object_set_string_len()
  147. * json_object_equal()
  148. * json_object_deep_copy()
  149. ### json_pointer.h
  150. * json_pointer_get()
  151. * json_pointer_getf()
  152. * json_pointer_set()
  153. * json_pointer_setf()
  154. ### json_util.h
  155. * json_object_from_fd()
  156. * json_object_to_fd()
  157. * json_util_get_last_err()
  158. ### json_visit.h
  159. * json_c_visit()
  160. ### linkhash.h
  161. * json_global_set_string_hash()
  162. * lh_table_resize()
  163. ### printbuf.h
  164. * printbuf_strappend()
  165. 0.12.1
  166. ======
  167. * Minimal changes to address compile issues.
  168. 0.12
  169. ====
  170. * Address security issues:
  171. * CVE-2013-6371: hash collision denial of service
  172. * CVE-2013-6370: buffer overflow if size_t is larger than int
  173. * Avoid potential overflow in json_object_get_double
  174. * Eliminate the mc_abort() function and MC_ABORT macro.
  175. * Make the json_tokener_errors array local. It has been deprecated for
  176. a while, and json_tokener_error_desc() should be used instead.
  177. * change the floating point output format to %.17g so values with
  178. more than 6 digits show up in the output.
  179. * Remove the old libjson.so name compatibility support. The library is
  180. only created as libjson-c.so now and headers are only installed
  181. into the ${prefix}/json-c directory.
  182. * When supported by the linker, add the -Bsymbolic-functions flag.
  183. * Various changes to fix the build on MSVC.
  184. * Make strict mode more strict:
  185. * number must not start with 0
  186. * no single-quote strings
  187. * no comments
  188. * trailing char not allowed
  189. * only allow lowercase literals
  190. * Added a json_object_new_double_s() convenience function to allow
  191. an exact string representation of a double to be specified when
  192. creating the object and use it in json_tokener_parse_ex() so
  193. a re-serialized object more exactly matches the input.
  194. * Add support NaN and Infinity
  195. 0.11
  196. ====
  197. * IMPORTANT: the name of the library has changed to libjson-c.so and
  198. the header files are now in include/json-c.
  199. The pkgconfig name has also changed from json to json-c.
  200. You should change your build to use appropriate -I and -l options.
  201. A compatibility shim is in place so builds using the old name will
  202. continue to work, but that will be removed in the next release.
  203. * Maximum recursion depth is now a runtime option.
  204. json_tokener_new() is provided for compatibility.
  205. json_tokener_new_ex(depth)
  206. * Include json_object_iterator.h in the installed headers.
  207. * Add support for building on Android.
  208. * Rewrite json_object_object_add to replace just the value if the key already exists so keys remain valid.
  209. * Make it safe to delete keys while iterating with the json_object_object_foreach macro.
  210. * Add a json_set_serializer() function to allow the string output of a json_object to be customized.
  211. * Make float parsing locale independent.
  212. * Add a json_tokener_set_flags() function and a JSON_TOKENER_STRICT flag.
  213. * Enable -Werror when building.
  214. * speed improvements to parsing 64-bit integers on systems with working sscanf
  215. * Add a json_object_object_length function.
  216. * Fix a bug (buffer overrun) when expanding arrays to more than 64 entries.
  217. 0.10
  218. ====
  219. * Add a json_object_to_json_string_ext() function to allow output to be
  220. formatted in a more human readable form.
  221. * Add json_object_object_get_ex(), a NULL-safe get object method, to be able
  222. to distinguish between a key not present and the value being NULL.
  223. * Add an alternative iterator implementation, see json_object_iterator.h
  224. * Make json_object_iter public to enable external use of the
  225. json_object_object_foreachC macro.
  226. * Add a printbuf_memset() function to provide an effecient way to set and
  227. append things like whitespace indentation.
  228. * Adjust json_object_is_type and json_object_get_type so they return
  229. json_type_null for NULL objects and handle NULL passed to
  230. json_objct_object_get().
  231. * Rename boolean type to json_bool.
  232. * Fix various compile issues for Visual Studio and MinGW.
  233. * Allow json_tokener_parse_ex() to be re-used to parse multiple object.
  234. Also, fix some parsing issues with capitalized hexadecimal numbers and
  235. number in E notation.
  236. * Add json_tokener_get_error() and json_tokener_error_desc() to better
  237. encapsulate the process of retrieving errors while parsing.
  238. * Various improvements to the documentation of many functions.
  239. * Add new json_object_array_sort() function.
  240. * Fix a bug in json_object_get_int(), which would incorrectly return 0
  241. when called on a string type object.
  242. Eric Haszlakiewicz
  243. * Add a json_type_to_name() function.
  244. Eric Haszlakiewicz
  245. * Add a json_tokener_parse_verbose() function.
  246. Jehiah Czebotar
  247. * Improve support for null bytes within JSON strings.
  248. Jehiah Czebotar
  249. * Fix file descriptor leak if memory allocation fails in json_util
  250. Zachary Blair, zack_blair at hotmail dot com
  251. * Add int64 support. Two new functions json_object_net_int64 and
  252. json_object_get_int64. Binary compatibility preserved.
  253. Eric Haszlakiewicz, EHASZLA at transunion com
  254. Rui Miguel Silva Seabra, rms at 1407 dot org
  255. * Fix subtle bug in linkhash where lookup could hang after all slots
  256. were filled then successively freed.
  257. Spotted by Jean-Marc Naud, j dash m at newtraxtech dot com
  258. * Make json_object_from_file take const char *filename
  259. Spotted by Vikram Raj V, vsagar at attinteractive dot com
  260. * Add handling of surrogate pairs (json_tokener.c, test4.c, Makefile.am)
  261. Brent Miller, bdmiller at yahoo dash inc dot com
  262. * Correction to comment describing printbuf_memappend in printbuf.h
  263. Brent Miller, bdmiller at yahoo dash inc dot com
  264. 0.9
  265. ===
  266. * Add README.html README-WIN32.html config.h.win32 to Makefile.am
  267. Michael Clark, <michael@metaparadigm.com>
  268. * Add const qualifier to the json_tokener_parse functions
  269. Eric Haszlakiewicz, EHASZLA at transunion dot com
  270. * Rename min and max so we can never clash with C or C++ std library
  271. Ian Atha, thatha at yahoo dash inc dot com
  272. * Fix any noticeable spelling or grammar errors.
  273. * Make sure every va_start has a va_end.
  274. * Check all pointers for validity.
  275. Erik Hovland, erik at hovland dot org
  276. * Fix json_object_get_boolean to return false for empty string
  277. Spotted by Vitaly Kruglikov, Vitaly dot Kruglikov at palm dot com
  278. * optimizations to json_tokener_parse_ex(), printbuf_memappend()
  279. Brent Miller, bdmiller at yahoo dash inc dot com
  280. * Disable REFCOUNT_DEBUG by default in json_object.c
  281. * Don't use this as a variable, so we can compile with a C++ compiler
  282. * Add casts from void* to type of assignment when using malloc
  283. * Add #ifdef __cplusplus guards to all of the headers
  284. * Add typedefs for json_object, json_tokener, array_list, printbuf, lh_table
  285. Michael Clark, <michael@metaparadigm.com>
  286. * Null pointer dereference fix. Fix json_object_get_boolean strlen test
  287. to not return TRUE for zero length string. Remove redundant includes.
  288. Erik Hovland, erik at hovland dot org
  289. * Fixed warning reported by adding -Wstrict-prototypes
  290. -Wold-style-definition to the compilatin flags.
  291. Dotan Barak, dotanba at gmail dot com
  292. * Add const correctness to public interfaces
  293. Gerard Krol, g dot c dot krol at student dot tudelft dot nl
  294. 0.8
  295. ===
  296. * Add va_end for every va_start
  297. Dotan Barak, dotanba at gmail dot com
  298. * Add macros to enable compiling out debug code
  299. Geoffrey Young, geoff at modperlcookbook dot org
  300. * Fix bug with use of capital E in numbers with exponents
  301. Mateusz Loskot, mateusz at loskot dot net
  302. * Add stddef.h include
  303. * Patch allows for json-c compile with -Werror and not fail due to
  304. -Wmissing-prototypes -Wstrict-prototypes -Wmissing-declarations
  305. Geoffrey Young, geoff at modperlcookbook dot org
  306. 0.7
  307. ===
  308. * Add escaping of backslash to json output
  309. * Add escaping of foward slash on tokenizing and output
  310. * Changes to internal tokenizer from using recursion to
  311. using a depth state structure to allow incremental parsing
  312. 0.6
  313. ===
  314. * Fix bug in escaping of control characters
  315. Johan Björklund, johbjo09 at kth dot se
  316. * Remove include "config.h" from headers (should only
  317. be included from .c files)
  318. Michael Clark <michael@metaparadigm.com>
  319. 0.5
  320. ===
  321. * Make headers C++ compatible by change *this to *obj
  322. * Add ifdef C++ extern "C" to headers
  323. * Use simpler definition of min and max in bits.h
  324. Larry Lansing, llansing at fuzzynerd dot com
  325. * Remove automake 1.6 requirement
  326. * Move autogen commands into autogen.sh. Update README
  327. * Remove error pointer special case for Windows
  328. * Change license from LGPL to MIT
  329. Michael Clark <michael@metaparadigm.com>
  330. 0.4
  331. ===
  332. * Fix additional error case in object parsing
  333. * Add back sign reversal in nested object parse as error pointer
  334. value is negative, while error value is positive.
  335. Michael Clark <michael@metaparadigm.com>
  336. 0.3
  337. ===
  338. * fix pointer arithmetic bug for error pointer check in is_error() macro
  339. * fix type passed to printbuf_memappend in json_tokener
  340. * update autotools bootstrap instructions in README
  341. Michael Clark <michael@metaparadigm.com>
  342. 0.2
  343. ===
  344. * printbuf.c - C. Watford (christopher.watford@gmail.com)
  345. Added a Win32/Win64 compliant implementation of vasprintf
  346. * debug.c - C. Watford (christopher.watford@gmail.com)
  347. Removed usage of vsyslog on Win32/Win64 systems, needs to be handled
  348. by a configure script
  349. * json_object.c - C. Watford (christopher.watford@gmail.com)
  350. Added scope operator to wrap usage of json_object_object_foreach, this
  351. needs to be rethought to be more ANSI C friendly
  352. * json_object.h - C. Watford (christopher.watford@gmail.com)
  353. Added Microsoft C friendly version of json_object_object_foreach
  354. * json_tokener.c - C. Watford (christopher.watford@gmail.com)
  355. Added a Win32/Win64 compliant implementation of strndup
  356. * json_util.c - C. Watford (christopher.watford@gmail.com)
  357. Added cast and mask to suffice size_t v. unsigned int conversion
  358. correctness
  359. * json_tokener.c - sign reversal issue on error info for nested object parse
  360. spotted by Johan Björklund (johbjo09 at kth.se)
  361. * json_object.c - escape " in json_escape_str
  362. * Change to automake and libtool to build shared and static library
  363. Michael Clark <michael@metaparadigm.com>
  364. 0.1
  365. ===
  366. * initial release