c6a20d846be464d9313b7e19b11aed610311fb19
[libksba.git] / NEWS
1 Noteworthy changes in version 1.4.0 (unreleased) [C19/A11/R-]
2 ------------------------------------------------
3
4  * Interface changes relative to the 1.3.5 release:
5  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
6  KSBA_VERSION                     NEW.
7  KSBA_VERSION_NUMBER              NEW.
8
9
10 Noteworthy changes in version 1.3.5 (2016-08-22) [C19/A11/R6]
11 ------------------------------------------------
12
13  * Limit the allowed size of complex ASN.1 objects (e.g. certificates)
14    to 16MiB.
15
16  * Avoid read access to unitialized memory.
17
18  * Improve detection of invalid RDNs.
19
20  * Encode the OCSP nonce value as an octet string as described by
21    RFC-6960.
22
23
24 Noteworthy changes in version 1.3.4 (2016-05-03) [C19/A11/R5]
25 ------------------------------------------------
26
27  * Fixed two OOB read access bugs which could be used to force a DoS.
28
29  * Fixed a crash due to faulty curve OID lookup code.
30
31  * Synced the list of supported curves with those of Libgcrypt.
32
33  * New configure option --enable-build-timestamp; a build timestamp is
34    not anymore used by default.
35
36
37 Noteworthy changes in version 1.3.3 (2015-04-10) [C19/A11/R4]
38 ------------------------------------------------
39
40  * Fixed an integer overflow in the DN decoder.
41
42  * Now returns an error instead of terminating the process for certain
43    bad BER encodings.
44
45  * Improved the parsing of utf-8 strings in DNs.
46
47  * Allow building with newer versions of Bison.
48
49  * Improvement building on Windows with newer versions of Mingw.
50
51
52 Noteworthy changes in version 1.3.2 (2014-11-25) [C19/A11/R3]
53 ------------------------------------------------
54
55  * Fixed a buffer overflow in ksba_oid_to_str. [CVE-2014-9087]
56
57
58 Noteworthy changes in version 1.3.1 (2014-09-18)
59 ------------------------------------------------
60
61  * Fixed memory leak in CRL parsing.
62
63  * Build fixes for Windows, Android, and ppc64el.
64
65
66 Noteworthy changes in version 1.3.0 (2012-09-27)
67 ------------------------------------------------
68
69  * Changed the license of the library from GPLv3 to LGPLv3/GPLv2; see
70    the file AUTHORS for details.
71
72  * Minor bug fixes.
73
74
75 Noteworthy changes in version 1.2.0 (2011-03-01)
76 ------------------------------------------------
77
78  * New functions to allow the creation of X.509 certificates.
79
80  * Interface changes relative to the 1.1.0 release:
81  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
82  ksba_certreq_set_serial          NEW.
83  ksba_certreq_set_issuer          NEW.
84  ksba_certreq_set_validity        NEW.
85  ksba_certreq_set_siginfo         NEW.
86
87
88 Noteworthy changes in version 1.1.0 (2010-10-26)
89 ------------------------------------------------
90
91  * New functions to fix a leak in dirmngr.
92
93  * Interface changes relative to the 1.0.0 release:
94  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
95  ksba_reader_set_release_notify   NEW
96  ksba_writer_set_release_notify   NEW
97
98
99 Noteworthy changes in version 1.0.8 (2010-07-15)
100 ------------------------------------------------
101
102  * Support for WindowsCE.
103
104  * Builds cleanly from SVN even when cross-compiling.
105
106  * Fixed a CMS parsing bug exhibited by Lotus Notes.
107
108
109 Noteworthy changes in version 1.0.7 (2009-07-03)
110 ------------------------------------------------
111
112  * Detect overflow while parsing OIDs.  Map BER encoded OIDs to well
113    known names.
114
115  * Allow mixed case names in DNs.
116
117
118 Noteworthy changes in version 1.0.6 (2009-06-05)
119 ------------------------------------------------
120
121  * Support SHA-{384,512} based signature generation.
122
123  * The RSA algorithmIdentifier ASN.1 sequence is now emitted with an
124    explicit NULL parameter.  Despite the interop testing we did in the
125    past, some software still requires this and thus we better follow
126    the best current practise.
127
128
129 Noteworthy changes in version 1.0.5 (2009-01-09)
130 ------------------------------------------------
131
132  * Minor bug fixes.
133
134
135 Noteworthy changes in version 1.0.4 (2008-09-22)
136 ------------------------------------------------
137
138  * Write smimeCapabilities according to RFC3851 to help Mozilla.
139
140  * Support DSA.
141
142  * The visibility attribute is now used if supported by the toolchain.
143
144
145 Noteworthy changes in version 1.0.3 (2008-02-12)
146 ------------------------------------------------
147
148  * Minor bug fixes.
149
150  * Include the used hash algorithm in sig-val structures.
151
152  * Fix for unknown tags in issuerAltName and subjectAltName.
153
154
155 Noteworthy changes in version 1.0.2 (2007-07-04)
156 ------------------------------------------------
157
158  * Support for SHA-2.
159
160  * Fixed a couple of memory leaks.
161
162  * Experimental support for ECDSA.
163
164  * Minor portability fixes.
165
166  * Switched to GPLv3.
167
168
169 Noteworthy changes in version 1.0.1 (2006-11-29)
170 ------------------------------------------------
171
172  * Fixes for certificates lacking certain objects.
173
174  * Fixes to allow building on systems with a broken ar.
175
176
177 Noteworthy changes in version 1.0.0 (2006-08-31)
178 ------------------------------------------------
179
180  * OCSP nonces are now checked to detect replay attacks.
181
182  * OCSP extensions may no be retrieved.
183
184  * Implemented ksba_ocsp_get_responder_id which used to always return
185    an error code not_implemented.  Thus we can assume that the
186    function has never been used and we don't need to see this as an
187    API break.
188
189  * Interface changes relative to the 0.9.16 release:
190  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
191  ksba_ocsp_get_extension        NEW
192  ksba_ocsp_get_responder_id     CHANGED: No ABI break.
193
194
195 Noteworthy changes in version 0.9.16 (2006-08-01)
196 -------------------------------------------------
197
198  * Fixed a character set conversion bug in BMPStrings.
199
200  * New function for better error reporting of DNs.
201
202  * Interface changes relative to the 0.9.13 release:
203  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
204  ksba_dn_teststr                NEW
205  ksba_dn_str2der                NEW
206  ksba_dn_der2str                NEW
207
208
209 Noteworthy changes in version 0.9.15 (2006-06-20)
210 -------------------------------------------------
211
212  * Fixed BER parser which was broken in the last release.
213
214
215 Noteworthy changes in version 0.9.14 (2006-05-16)
216 -------------------------------------------------
217
218  * Fixed broken OCSP requests.
219
220  * Ignore invalid bytes appended to a certificate.
221
222
223 Noteworthy changes in version 0.9.13 (2005-11-24)
224 -------------------------------------------------
225
226  * New functions to associate user data with a certificate object.
227
228  * Interface changes relative to the 0.9.12 release:
229  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
230  ksba_cert_set_user_data        NEW
231  ksba_cert_get_user_data        NEW
232
233
234 Noteworthy changes in version 0.9.12 (2005-08-01)
235 -------------------------------------------------
236
237  * GeneralNames types dNSName and Uri are now supported.
238
239  * Minor changes to some function declarations.  This should not
240    affect any compilation.
241
242  * Interface changes relative to the 0.9.7 release:
243  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
244  ksba_certreq_add_extension     CHANGED: Argument DER is now a void*.
245  ksba_cms_set_content_enc_algo  CHANGED: Argument IV is now void*.
246  ksba_cms_get_content_enc_iv    CHANGED: Argument IV is now void*.
247  ksba_cms_set_message_digest    CHANGED: Argument DIGEST is now
248                                          unsigned char*.
249
250
251 Noteworthy changes in version 0.9.11 (2005-04-20)
252 -------------------------------------------------
253
254  * New convenience API function for the subjectKeyIdentifier.
255
256  * Implemented the keyIdentifier part for authorityKeyIdentifier of
257    CRLs and certificates.
258
259  * Reason codes for CRL items are now returned.
260
261  * Interface changes relative to the 0.9.7 release:
262 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
263 ksba_cert_get_subj_key_id            NEW.
264
265
266 Noteworthy changes in version 0.9.10 (2004-12-03)
267 -------------------------------------------------
268
269  * Fixed a CMS parsing bug.
270
271
272 Noteworthy changes in version 0.9.9 (2004-09-27)
273 ------------------------------------------------
274
275  * Fixed a couple of bugs which caused parsing errors with some
276    certificates.
277
278
279 Noteworthy changes in version 0.9.8 (2004-07-22)
280 ------------------------------------------------
281
282  * Fixed a bug in the OCSP request generation.
283
284
285 Noteworthy changes in version 0.9.7 (2004-06-08)
286 ------------------------------------------------
287
288  * New API function to add arbitrary extensions to pkcs#10 requests.
289
290  * Interface changes relative to the 0.9.6 release:
291 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
292 ksba_certreq_add_extension           NEW.
293
294
295 Noteworthy changes in version 0.9.6 (2004-04-29)
296 ------------------------------------------------
297
298  * New API functions to support v2 CRLs.
299
300  * Interface changes relative to the 0.9.5 release:
301 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
302 ksba_crl_get_extension               NEW.
303 ksba_crl_get_auth_key_id             NEW.
304 ksba_crl_get_crl_number              NEW.
305
306 Noteworthy changes in version 0.9.5 (2004-04-06)
307 ------------------------------------------------
308
309  * New APIs to get hands on some more information.
310
311  * Interface changes relative to the 0.9.4 release:
312 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
313 ksba_ocsp_get_responder_id           NEW.
314 ksba_ocsp_get_cert                   NEW.
315 ksba_cert_get_authority_info_access  NEW.
316 ksba_cert_get_subject_info_access    NEW.
317 ksba_cms_add_smime_capability        NEW.
318
319
320 Noteworthy changes in version 0.9.4 (2004-02-20)
321 ------------------------------------------------
322
323  * Support for Extended Key Usage.
324
325  * ksba_cms_identify may no return a pseudo content type for pkcs#12
326    files.
327
328  * Interface changes relative to the 0.9.3 release:
329 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
330 ksba_reader_clear             NEW.
331 ksba_cert_get_ext_key_usages  NEW.
332 KSBA_CT_PKCS12                NEW.
333
334
335 Noteworthy changes in version 0.9.3 (2004-01-30)
336 ------------------------------------------------
337
338  * Fixed a serious bug shortly after the last release :-(.
339
340
341 Noteworthy changes in version 0.9.2 (2004-01-29)
342 ------------------------------------------------
343
344  * Cleaned up the DN label table.
345
346  * Fixed a bug in creating CMS signed data.
347
348
349 Noteworthy changes in version 0.9.1 (2003-12-19)
350 ------------------------------------------------
351
352  * Support for OCSP (rfc2560).
353
354  * The new function ksba_set_hash_buffer_function may be used during
355    intialization to register a simple hash fucntion for internal use
356    by libksba.
357
358  * Changed the license of the manual to GPL.
359
360  * Interface changes relative to the 0.9.0 release:
361 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
362 ksba_status_t                 NEW.
363 ksba_ocsp_t                   NEW.
364 ksba_ocsp_response_status_t   NEW.
365 ksba_ocsp_new                 NEW.
366 void ksba_ocsp_release        NEW.
367 ksba_ocsp_set_digest_algo     NEW.
368 ksba_ocsp_set_requestor       NEW.
369 ksba_ocsp_add_target          NEW.
370 ksba_ocsp_set_nonce           NEW.
371 ksba_ocsp_prepare_request     NEW.
372 ksba_ocsp_hash_request        NEW.
373 ksba_ocsp_set_sig_val         NEW.
374 ksba_ocsp_add_cert            NEW.
375 ksba_ocsp_build_request       NEW.
376 ksba_ocsp_parse_response      NEW.
377 ksba_ocsp_get_digest_algo     NEW.
378 ksba_ocsp_hash_respons        NEW.
379 ksba_ocsp_get_sig_val         NEW.
380 ksba_ocsp_get_status          NEW.
381 ksba_set_hash_buffer_function NEW.
382
383
384 Noteworthy changes in version 0.9.0 (2003-11-17)
385 ------------------------------------------------
386
387  * The time is not any longer described by time_t but through the new
388    type ksba_isotime_t which is string of excactly 15 characters in
389    ISO 8601 format (e.g. "19611107T152010") and always stored as
390    UTC. This is to allow representation of dates beyond the year 2038.
391    Comparing is a mere strcmp.
392
393  * All type names are nom conforming to the GNU coding standards, the
394    old names are still available as aliases but flagged as deprecated.
395
396  * All error codes have been replaced by libgpg-error ones.  Libksba
397    now depends on this package.  Remember to use the gpg_err_code
398    function when testing for error values other than success.
399
400  * Interface changes relative to the 0.4.7 release:
401 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
402 ksba_cert_get_validity     CHANGED: Uses ksba_isotime_t instead of time_t.
403 ksba_crl_get_update_times  CHANGED: Uses ksba_isotime_t instead of time_t.
404 ksba_crl_get_item          CHANGED: Uses ksba_isotime_t instead of time_t.
405 ksba_cms_get_signing_time  CHANGED: Uses ksba_isotime_t instead of time_t.
406 ksba_cms_set_signing_time  CHANGED: Uses ksba_isotime_t instead of time_t.
407 ksba_cert_new              CHANGED: Returns an error code now.
408 ksba_cms_new               CHANGED: Returns an error code now.
409 ksba_name_new              CHANGED: Returns an error code now.
410 ksba_writer_new            CHANGED: Returns an error code now.
411 ksba_reader_new            CHANGED: Returns an error code now.
412 ksba_certreq_new           CHANGED: Returns an error code now.
413 ksba_crl_new               CHANGED: Returns an error code now.
414 ksba_isotime_t             NEW.
415 ksba_error_t               NEW: Should be used instead of KsbaError.
416 ksba_cert_t                NEW: Should be used instead of KsbaCert.
417 ksba_certreq_t             NEW: Should be used instead of KsbaCertreq.
418 ksba_cms_t                 NEW: Should be used instead of KsbaCMS.
419 ksba_crl_t                 NEW: Should be used instead of KsbaCRL.
420 ksba_name_t                NEW: Should be used instead of KsbaName.
421 ksba_sexp_t                NEW: Should be used instead of KsbaSexp.
422 ksba_reader_t              NEW: Should be used instead of KsbaReader.
423 ksba_writer_t              NEW: Should be used instead of KsbaWriter.
424 ksba_strerror              REMOVED: use gpg_strerror instead.
425
426 Noteworthy changes in version 0.4.7 (2003-03-17)
427 ------------------------------------------------
428
429  * Fixed type detection in creating DNs.
430
431
432 Noteworthy changes in version 0.4.6 (2002-12-04)
433 ------------------------------------------------
434
435  * DNs in pkcs#10 request are now created in reversed order as
436    specified by rfc2253.
437
438  * The content-type signed attribute is created.
439
440  * Fixed a parser bug with a id-aa-encrypKeyPref attribute.
441
442  * Interface changes relative to the 0.4.3 release:
443 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
444 ksba_cms_get_sigattr_oids        NEW
445 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
446
447 Noteworthy changes in version 0.4.5 (2002-08-23)
448 ------------------------------------------------
449
450  * Removed some debugging output.
451
452  * Added an autoconf macro.
453
454
455 Noteworthy changes in version 0.4.4 (2002-08-09)
456 ------------------------------------------------
457
458  * Multiple signatures can now be created and parsed.
459
460
461 Noteworthy changes in version 0.4.3 (2002-06-25)
462 ------------------------------------------------
463
464  * More bug fixes.
465
466  * Interface changes relative to the 0.4.2 release:
467 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
468 ksba_writer_write_octet_string   NEW
469 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
470
471 Noteworthy changes in version 0.4.2 (2002-06-04)
472 ------------------------------------------------
473
474  * Some bug fixes and a new function.
475
476  * Interface changes relative to the 0.4.1 release:
477 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
478 ksba_cms_identify       NEW
479 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
480
481 Noteworthy changes in version 0.4.1 (2002-05-03)
482 ------------------------------------------------
483
484  * Minor fixes.
485
486 Noteworthy changes in version 0.4.0 (2002-04-15)
487 ------------------------------------------------
488
489  * Nearly all stuff needed for the Aegypten project is now in place.
490
491
492  Copyright 2002, 2003, 2004, 2005, 2006, 2007, 2008,
493            2009 g10 Code GmbH
494
495  This file is free software; as a special exception the author gives
496  unlimited permission to copy and/or distribute it, with or without
497  modifications, as long as this notice is preserved.
498
499  This file is distributed in the hope that it will be useful, but
500  WITHOUT ANY WARRANTY, to the extent permitted by law; without even the
501  implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.