NEWS

   1 GNU Libtasn1 NEWS                                     -*- outline -*-
   2
   3 * Noteworthy changes in release 3.4 (unreleased) [stable]
   4 - Added asn1_delete_structure2() which allows zeroizing the contents
   5   of all values in the structure prior to deinitialization.
   6
   7 * Noteworthy changes in release 3.3 (released 2013-03-23) [stable]
   8 - More precise overflow checks using gnulib's intprops module.
   9 - Updates to compile in Android systems.
  10
  11 * Noteworthy changes in release 3.2 (released 2012-11-30) [stable]
  12 - Corrected buffer overflow in the error reporting of the parser (reported
  13 by Andreas Metzler).
  14
  15 * Noteworthy changes in release 3.1 (released 2012-11-24) [stable]
  16 - Completed rename of types:
  17   ASN1_ARRAY_TYPE -> asn1_static_node (was asn1_static_node_t)
  18 - Added new types: VisibleString, NumericString, IA5String, TeletexString,
  19   PrintableString, UniversalString, BMPString, UTF8String. When re-defined
  20   a warning is being print instead of failing.
  21 - Parser outputs more detailed syntax error messages.
  22 - Added asn1_decode_simple_der() and asn1_encode_simple_der().
  23 - Added asn1_read_value_type() to return value and type.
  24 - Introduced ASN1_ETYPE_UTC_TIME and ASN1_ETYPE_GENERALIZED_TIME
  25
  26 * Noteworthy changes in release 3.0 (2012-10-28) [stable]
  27 - Added tool in tests/ to benchmark X.509 structure decoding.
  28 - Added asn1_read_node_value() to obtain a node's value.
  29 - Optimizations in internal tree allocation.
  30 - Optimizations in tree search.
  31 - libtasn1.h no longer exports internal structures.
  32 - Types were renamed for consistency:
  33   ASN1_DATA_NODE -> asn1_data_node_st
  34   ASN1_ARRAY_TYPE -> asn1_static_node
  35   ASN1_TYPE -> asn1_node
  36   ASN1_TYPE_EMPTY -> NULL
  37   static_struct_asn -> asn1_static_node_st
  38   node_asn_struct -> asn1_node_st
  39   node_asn -> asn1_node_st
  40   (the old types are still available as definitions)
  41
  42 * Noteworthy changes in release 2.13 (2012-05-31) [stable]
  43 - Updated fix for DER decoding issue to not depend on specific compilers.
  44 - Updated DER decoding check to apply to short form integers as well.
  45
  46 * Noteworthy changes in release 2.12 (2012-03-19) [stable]
  47 - Cleanup license headers.
  48 - build: Update gnulib files.
  49 - Corrected DER decoding issue (reported by Matthew Hall).
  50   Added self check to detect the problem, see tests/Test_overflow.c.
  51   This problem can lead to at least remotely triggered crashes, see
  52   further analysis on the libtasn1 mailing list.
  53
  54 * Noteworthy changes in release 2.11 (2011-11-25) [stable]
  55 - qa: Now builds without compiler warnings with Solaris CC.
  56 - qa: Added clang analysis.  Fixed cyclomatic complexity output.
  57 - tests: Added self-test of bit string functions.
  58 - build: Added windows/libtasn14win.mk rules to produce Windows binaries.
  59 - build: Don't hard code path to perl in doc/gdoc.
  60 - Various minor fixes.
  61
  62 * Noteworthy changes in release 2.10 (2011-10-25) [stable]
  63 - lib: Small optimization, possibly working around gcc/valgrind issue.
  64 - build: Update gnulib files.
  65 - asn1Coding: actually implement the -c parameter.
  66 - asn1Decoding: the -c parameter serves no purpose, remove it.
  67 - doc: Add examples to asn1Coding and asn1Decoding description.
  68
  69 * Noteworthy changes in release 2.9 (2010-12-06) [stable]
  70 - tests: Link to gnulib to avoid build error related to 'rpl_ftello' on Solaris.
  71   Reported by Dagobert Michelsen.
  72 - doc: Fix bug reporting address to point at help-libtasn1@gnu.org.
  73 - doc: Fix Returns: documentation in Texinfo.  Reported by Jeffrey Walton.
  74 - build: Update gnulib files.
  75
  76 * Noteworthy changes in release 2.8 (2010-09-25) [stable]
  77 - Update gnulib files.
  78 - Use Libtool 2.2.10 to ease MinGW64 builds.
  79
  80 * Noteworthy changes in release 2.7 (2010-05-20) [stable]
  81 - Doc: Build a PDF manual using GTK-DOC.
  82 - Doc: Fix of asn1_check_version, documentation was missing from last release.
  83 - Build: Avoid warnings about ignored visibility attributes on Windows.
  84
  85 * Noteworthy changes in release 2.6 (2010-04-20) [stable]
  86 - Fix build failure on platforms without support for GNU LD version scripts.
  87 - libtasn1: Simplified implementation of asn1_check_version.
  88 - tests: Improved self-checks.
  89 - Update gnulib files, fix many syntax-check nits, indent code,
  90   fix license templates.
  91
  92 * Noteworthy changes in release 2.5 (2010-03-15) [stable]
  93 - doc: Improve GTK-DOC comments.
  94 - misc: Updated gnulib files.
  95
  96 * Noteworthy changes in release 2.4 (2010-01-18) [stable]
  97 - Doc fixes.
  98 - Updated gnulib files.
  99 - Clean up copyright notices.
 100
 101 * Noteworthy changes in release 2.3 (2009-07-29) [stable]
 102 - Libtasn1 is now an official GNU project.
 103 - Solve build problem on Tru64 related to TRUE/FALSE.
 104 - More careful decoding of OIDs.
 105 - Fixed warning in ASN1.y.
 106 - Use "Software libraries" info dircategory.
 107 - Drop GPL/LGPL copies from the manual (not needed there).
 108 - New configure parameters to set packaging specific information.
 109   The parameters are --with-packager, --with-packager-version, and
 110   --with-packager-bug-reports.  See
 111   <http://article.gmane.org/gmane.comp.lib.gnulib.bugs/17791> for more
 112   details.
 113
 114 * Noteworthy changes in release 2.2 (2009-05-20) [stable]
 115 - Change how the ASN1_API decorator is used in libtasn1.h, for GTK-DOC.
 116 - Changed license of libtasn1.pc from GPLv3+ to LGPLv2.1+.
 117   Reported by Jeff Cai <Jeff.Cai@Sun.COM>.
 118 - Building with many warning flags now requires --enable-gcc-warnings.
 119 - Some warnings fixed.
 120
 121 * Noteworthy changes in release 2.1 (2009-04-17) [stable]
 122 - Fix compilation failure on platforms that can't generate empty archives,
 123   e.g., Mac OS X.  Reported by David Reiser <dbreiser@gmail.com>.
 124
 125 * Noteworthy changes in release 2.0 (2009-04-13) [stable]
 126 - Optimized tree generation.
 127 - ASN1 parser code re-generated using Bison 2.4.1.
 128 - Build with more warning flags.  Many compiler warnings fixed.
 129 - Compiled with -fvisibility=hidden by default if supported.
 130   See http://gcc.gnu.org/wiki/Visibility
 131 - The libtasn1-config tool has been removed.
 132   For application developers, please stop using libtasn1-config for
 133   finding libtasn1, use proper autoconf checks or pkg-config instead.
 134   For users that need a libtasn1 that provides a libtasn1-config
 135   script (for use with older applications), use libtasn1 v1.x instead.
 136   Version 1.x is still supported.
 137
 138 * Noteworthy changes in release 1.8 (2009-01-16) [stable]
 139 - Fix crlf self-test under Mingw+Wine.
 140 - Fix build problems on platforms that lack stdint.h.
 141   Reported by Dagobert Michelsen <dam@opencsw.org> in
 142   <http://thread.gmane.org/gmane.comp.encryption.gpg.gnutls.devel/3377>.
 143
 144 * Noteworthy changes in release 1.7 (2008-11-17) [stable]
 145 - Add libtasn1-config for compatibility.
 146   Please stop use it as it will disappear in v2.0!
 147   Use standard AC_CHECK_FUNCS autoconf tests or pkg-config instead.
 148 - Read PKCS#12 blob as binary file, fixes self-tests under Mingw.
 149 - Fix use of __attribute__ ((deprecated)) to work on non-GCC (#106548).
 150
 151 * Noteworthy changes in release 1.6 (2008-11-10) [stable]
 152 - Fixed namespace violation for MAX_NAME_SIZE and MAX_ERROR_DESCRIPTION_SIZE.
 153   The new names are ASN1_MAX_NAME_SIZE and ASN1_MAX_ERROR_DESCRIPTION_SIZE.
 154 - Fixed namespace violation for libtasn1_perror and libtasn1_strerror.
 155   The new names are asn1_perror and asn1_strerror.
 156 - Fix namespace violation for LIBASN1_VERSION.
 157   The new name is ASN1_VERSION.
 158 - Decoder can now decode BER encoded octet strings.
 159 - doc: Change license on the manual to GFDLv1.3+.
 160 - doc: Sync gdoc script with GnuTLS, changes license on man-pages to GAP.
 161 - doc: Improve gtk-doc manual.
 162 - Assumes system has strdup and string.h.
 163 - Remove libtasn1-config and libtasn1.m4,
 164   use standard AC_CHECK_FUNCS autoconf tests or pkg-config instead.
 165 - Change detection of when to use a linker version script,
 166   use --enable-ld-version-script or --disable-ld-version-script to
 167   override auto-detection logic.
 168 - API and ABI changes since last version:
 169   asn1_get_length_ber: New function.
 170   ASN1_VERSION: New symbol, replaces LIBTASN1_VERSION.
 171   asn1_strerror: New function, replaces libtasn1_strerror.
 172   asn1_perror: New function, replaces libtasn1_perror.
 173   libtasn1_strerror: Marked as deprecated.
 174   libtasn1_perror: Marked as deprecated.
 175   LIBTASN1_VERSION: Deprecated.
 176
 177 * Noteworthy changes in release 1.5 (2008-07-29) [stable]
 178 - Update gnulib files.
 179 - Fix memory leaks, from Christian Grothoff <christian@grothoff.org>.
 180
 181 * Noteworthy changes in release 1.4 (2008-04-21) [stable]
 182 - Update gnulib files.
 183 - Replace uses of alloca with malloc.
 184
 185 * Noteworthy changes in release 1.3 (2008-02-01) [stable]
 186 - Handle 'INTEGER { ... } (a..b)' regression.
 187   Revert parts of earlier fix.  asn1Parser can now again parse src/pkix.asn1.
 188   The ASN1.c file was generated using Bison 2.3.
 189 - Move examples from src/ to new directory examples/.
 190 - Duplicate copy of divergated pkix.asn removed.
 191 - Merge unnecessary lib/defines.h into lib/int.h.
 192 - Configure no longer tries to use gcc -pipe.
 193 - Update gnulib files.
 194 - Fix mem leak in self-test.
 195
 196 * Noteworthy changes in release 1.2 (2007-12-10) [stable]
 197 - Update gnulib files.
 198
 199 * Noteworthy changes in release 1.1 (2007-08-31) [stable]
 200 - Fix bug that made asn1_check_version believe that 1.0 is older than 0.3.10.
 201
 202 * Noteworthy changes in release 1.0 (2007-08-31) [stable]
 203 - The self-tests, command line tools and build infrastructure have
 204   been re-licensed from GPLv2 to GPLv3.
 205 - Doc fixes.
 206 - Update gnulib files.
 207
 208 * Noteworthy changes in release 0.3.10 (2007-05-25)
 209 - Update gnulib files.
 210
 211 * Noteworthy changes in release 0.3.9 (2007-03-02)
 212 - In generated code, config.h is pulled in if HAVE_CONFIG_H.
 213 - Development changes: changed from CVS to GIT as an experiment.
 214   I push my changes to <http://repo.or.cz/w/libtasn1.git>.
 215 - Autoconf 2.61 and automake 1.10 is required.
 216
 217 * Noteworthy changes in release 0.3.8 (2006-11-16)
 218 - Fix reading of binary files in asn1Decoding, for Windows.
 219
 220 * Noteworthy changes in release 0.3.7 (2006-10-19)
 221 - When asn1_der_coding encoded a TYPE_NULL and the output buffer is
 222   NULL, it would not increment the counter properly, so the size of
 223   the required buffer would be off by one.  Fixed.  Reported by
 224   Stephen Wrobleski <steve@localtoast.org>.
 225 - Fix configure to respect user-definable flags.  Reported by "Diego
 226   'Flameeyes' Pettenò" <flameeyes@gentoo.org>.
 227 - The --help and --version outputs from the tools have been improved.
 228
 229 * Noteworthy changes in release 0.3.6 (2006-08-13)
 230 - Fix man pages to use \- instead of - for negative signs (as in "-1").
 231 - Add -I's when building in src/, so that unistd.h etc is found on
 232   systems that doesn't have them.
 233 - Valgrind isn't used for cross-compilation by default, and there is
 234   also --disable-valgrind-tests to unconditionally disable it.
 235 - Valgrind is invoked without parameters, put things you like into
 236   ~/.valgrindrc instead.
 237
 238 * Noteworthy changes in release 0.3.5 (2006-06-27)
 239 - Fix asn1_octet_der to handle writes of zero-length buffers, before
 240   it did not write the ASN.1 length for a zero-length buffer.  This caused
 241   ASN.1 encodings to be incorrect on 64-bit platforms.
 242 - Add self test that attempt to trigger the above bug.
 243 - Fix test of -Wno-pointer-sign.
 244 - Improve cross-compilation to MinGW by using AC_LIBTOOL_WIN32_DLL.
 245
 246 * Noteworthy changes in release 0.3.4 (2006-05-10)
 247 - Really fix encodings.
 248 - Add new self test, tests/Test_encoding.c.
 249 - Self tests are ran under valgrind, if it is available.
 250 - We test for the -Wno-pointer-sign parameter before using it.
 251
 252 * Noteworthy changes in release 0.3.3 (2006-05-07)
 253 - Add some 'const' to prototypes.
 254 - Remove some 'unsigned' keywords.
 255 - Corrected asn1_der_coding() bug introduced when it became reentrant.
 256   Now it produces correct encodings.
 257
 258 * Noteworthy changes in release 0.3.2
 259 - Corrected bug in asn1_der_coding() which overwrited some
 260   data in the original structure.
 261 - The asn1Parser, asn1Coding and asn1Decoding programs are now installed.
 262
 263 * Noteworthy changes in release 0.3.1
 264 - Support constant size bit strings, as in 'BIT STRING (SIZE(42))'.
 265   Reported by Cyril Holweck <cyril.holweck@q-free.com>.
 266 - Add two more APIs required by GnuTLS.
 267 - New public APIs:
 268   asn1_find_node function
 269   asn1_copy_node
 270
 271 * Noteworthy changes in release 0.3.0
 272 - Export DER utility functions, mostly so that GnuTLS can avoid using
 273   libtasn1 internals.
 274 - The _asn1* symbols are not exported in the shared library file (when
 275   using GNU ld).
 276 - The library can now be built using Visual Studio, and the project
 277   files are included in windows/.
 278 - New public APIs:
 279   asn1_get_tag_der
 280   asn1_octet_der
 281   asn1_get_octet_der
 282   asn1_bit_der
 283   asn1_get_bit_der
 284   asn1_get_length_der
 285   asn1_length_der
 286
 287 * Noteworthy changes in release 0.2.18
 288 - Fix out-of-bounds access in DER decoding, reported by Evgeny Legerov.
 289 - Add 'const' keyword to some prototypes, thanks to Frediano ZIGLIO.
 290 - Fixed typo in src/Makefile.am to make it build with objdir != srcdir,
 291   thanks to Bernard Leak.
 292 - Update of gnulib files.
 293 - Typo fixes in comments, e.g. finish libasn1 to libtasn1 renaming,
 294   use LGPL boiler plate on some files in lib/.
 295
 296 * Noteworthy changes in release 0.2.17
 297 - Fixed typo to make it build.
 298
 299 * Noteworthy changes in release 0.2.16
 300 - * Noteworthy changes in release script added again.
 301
 302 * Noteworthy changes in release 0.2.15
 303 - Gnulib is used to implement memmove if your system does not have it.
 304 - Simplified assert/error handling slightly.
 305
 306 * Noteworthy changes in release 0.2.14
 307 - Some build fixes.
 308 - Pkg-config script 'libtasn1.pc' added.
 309 - Postal address to FSF in license updated.
 310
 311 * Noteworthy changes in release 0.2.13
 312 - * Noteworthy changes in release number in libtasn1.h updated properly.
 313
 314 * Noteworthy changes in release 0.2.12
 315 - Manual converted to Texinfo format.
 316 - Manual in GTK-DOC and DevHelp formats added.
 317 - Man pages for all functions added.
 318 - Various internal cleanups.
 319
 320 * Noteworthy changes in release 0.2.11
 321 - Added the self test with "make check" target
 322 - Added management of ANY type with null length
 323 - Corrected some writes to invalid data.
 324
 325 * Noteworthy changes in release 0.2.10
 326 - Added scripts to assist in libtasn1 version detection
 327   from configure scripts.
 328 - Corrected a DER decoding bug which was reported
 329   by Max Vozeler <max@hinterhof.net>.
 330
 331 * Noteworthy changes in release 0.2.9
 332 - Accept negative numbers as range in INTEGER declarations
 333
 334 * Noteworthy changes in release 0.2.8
 335 - Add asn1_delete_element function
 336
 337 * Noteworthy changes in release 0.2.7
 338 - Added versioned symbols.
 339
 340 * Noteworthy changes in release 0.2.6
 341 - ASN.1 parser accepts these kinds of integer definitions:
 342   "INTEGER (5 | 10)" and
 343   "INTEGER (5)"
 344 - Comments start at "--" and finish at the "end of line" or
 345   with another "--".
 346
 347 * Noteworthy changes in release 0.2.5
 348 - Bug fix in ordering procedure for SET OF and SEQUENCE OF
 349   types coding.
 350 - Manage structured format (BER encoding) in
 351   asn1_der_decoding, asn1_decoding_element and
 352   asn1_der_decoding_startEnd for OCTET STRING type.
 353 - Manage SEQUENCE and SET empty structure.
 354 - Manage "indefinite length method" in asn1_der_decoding,
 355   asn1_decoding_element and asn1_der_decoding_startEnd
 356   for the following types:
 357   SEQUENCE, SEQUENCE OF, SET, and SET OF.
 358 - Bug fix in asn1_read_value with NULL parameter in case
 359   of BIT STRING
 360
 361 * Noteworthy changes in release 0.2.4
 362 - Bug fix in asn1_der_coding with NULL parameter
 363 - Manage DEFAULT option with OBJECT IDENTIFIER
 364
 365 * Noteworthy changes in release 0.2.3
 366 - Chenge asn1_find_structure_from_oid prototype
 367 - Chenge asn1_find_structure_from_oid prototype
 368 - Add ASN1_MEM_ALLOC_ERROR return value
 369
 370 * Noteworthy changes in release 0.2.2
 371 - Add vector length check in asn1_der_coding function
 372 - Add vector length check in asn1_der_coding function
 373 - Add vector length check in asn1_read_value function
 374 - Add asn1_check_version function
 375
 376 * Noteworthy changes in release 0.2.1
 377 - Add asn1_find_structure_from_oid function
 378 - Add asn1_read_tag function
 379
 380 * Noteworthy changes in release 0.2.0
 381 - Support for other platforms
 382 - Change asn1_create_element function interface (dest_name not needed any more)
 383 - Change OBJECT IDENTIFIER syntax: numbers must be separated by dot in
 384   asn1_write_element and asn1_read_element functions (e.g. "1.2.3.4")
 385
 386 * Noteworthy changes in release 0.1.2
 387 - Added GeneralString type
 388 - Fixed a DER encoding bug when nested tags are used
 389
 390 * Noteworthy changes in release 0.1.1
 391 - Renamed to libtasn1
 392 - Functions which return a string for error description
 393   now accept a NULL argument.
 394 - License is now GNU Lesser GPL
 395
 396 * Noteworthy changes in release 0.1.0
 397 - Initial release
 398
 399 ----------------------------------------------------------------------
 400 Copyright (C) 2002-2013 Free Software Foundation, Inc.
 401 Copying and distribution of this file, with or without modification,
 402 are permitted in any medium without royalty provided the copyright
 403 notice and this notice are preserved.