Add NEWS and CHANGES entries about OSSL_SERIALIZER

Reviewed-by: Matt Caswell <matt@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/10394)

diff --git a/CHANGES b/CHANGES
index fd1173919312247aef268207d67c2af7d776d2f1..208780e9c951b19e843f88e3c4305a1bbf541dc8 100644 (file)
--- a/CHANGES
+++ b/CHANGES
@@ -9,6 +9,24 @@
 
  Changes between 1.1.1 and 3.0.0 [xx XXX xxxx]
 
 
  Changes between 1.1.1 and 3.0.0 [xx XXX xxxx]
 

+  *) Introduced a new method type and API, OSSL_SERIALIZER, to
+     represent generic serializers.  An implementation is expected to
+     be able to serialize an object associated with a given name (such
+     as an algorithm name for an asymmetric key) into forms given by
+     implementation properties.
+
+     Serializers are primarily used from inside libcrypto, through
+     calls to functions like EVP_PKEY_print_private(),
+     PEM_write_bio_PrivateKey() and similar.
+
+     Serializers are specified in such a way that they can be made to
+     directly handle the provider side portion of an object, if this
+     provider side part comes from the same provider as the serializer
+     itself, but can also be made to handle objects in parametrized
+     form (as an OSSL_PARAM array of data).  This allows a provider to
+     offer generic serializers as a service for any other provider.
+     [Richard Levitte]
+

   *) Added a .pragma directive to the syntax of configuration files, to
      allow varying behavior in a supported and predictable manner.
      Currently added pragma:
   *) Added a .pragma directive to the syntax of configuration files, to
      allow varying behavior in a supported and predictable manner.
      Currently added pragma:

diff --git a/NEWS b/NEWS
index 0463af6e25f8fc4050f711cfa77177c4eda0d4fe..7c11f61db7756ca3557fe7e0d3a5bd969731b0c9 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -7,6 +7,7 @@
 
   Major changes between OpenSSL 1.1.1 and OpenSSL 3.0.0 [under development]
 
 
   Major changes between OpenSSL 1.1.1 and OpenSSL 3.0.0 [under development]
 

+      o Added OSSL_SERIALIZER, a generic serializer API.

       o Added error raising macros, ERR_raise() and ERR_raise_data().
       o Deprecated ERR_put_error().
       o Added OSSL_PROVIDER_available(), to check provider availibility.
       o Added error raising macros, ERR_raise() and ERR_raise_data().
       o Deprecated ERR_put_error().
       o Added OSSL_PROVIDER_available(), to check provider availibility.