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