Adjust documentation of EVP_SKEY_import_raw_key

Fixes #29509

Reviewed-by: Tomas Mraz <tomas@openssl.org>
Reviewed-by: Eugene Syromiatnikov <esyr@openssl.org>
Reviewed-by: Paul Dale <paul.dale@oracle.com>
MergeDate: Mon Jan 19 14:12:01 2026
(Merged from https://github.com/openssl/openssl/pull/29546)

diff --git a/doc/designs/evp_skey.md b/doc/designs/evp_skey.md
index ac5e7bd125ef2b6fd6cf8903fac2d83d057b4fb7..e79874ee307fcace4277bdfc4fe2b33a9b20b8ba 100644 (file)
--- a/doc/designs/evp_skey.md
+++ b/doc/designs/evp_skey.md
@@ -102,9 +102,9 @@ EVP_SKEY *EVP_SKEY_generate(OSSL_LIB_CTX *libctx, const char *skeymgmtname,
 EVP_SKEY *EVP_SKEY_import(OSSL_LIB_CTX *libctx, const char *skeymgmtname,
                           const char *propquery,
                           int selection, const OSSL_PARAM *params);
-EVP_SKEY *EVP_SKEY_import_raw(OSSL_LIB_CTX *libctx, const char *skeymgmtname,
-                              const char *key, size_t keylen,
-                              const char *propquery);
+EVP_SKEY *EVP_SKEY_import_raw_key(OSSL_LIB_CTX *libctx, const char *skeymgmtname,
+                                  unsigned char *key, size_t keylen,
+                                  const char *propquery);
 int EVP_SKEY_up_ref(EVP_SKEY *skey);
 void EVP_SKEY_free(EVP_SKEY *skey);
 ```

diff --git a/doc/man3/EVP_SKEY.pod b/doc/man3/EVP_SKEY.pod
index 9f013cc8c73a1f4800de791f57d62998ffb13723..91875a6ce15236028da146d8ac8349c92ef1459f 100644 (file)
--- a/doc/man3/EVP_SKEY.pod
+++ b/doc/man3/EVP_SKEY.pod
@@ -20,7 +20,7 @@ EVP_SKEY_get0_provider_name, EVP_SKEY_free, EVP_SKEY_is_a, EVP_SKEY_to_provider
                            const char *propquery,
                            int selection, const OSSL_PARAM *params);
  EVP_SKEY *EVP_SKEY_import_raw_key(OSSL_LIB_CTX *libctx, const char *skeymgmtname,
-                                   unsigned char *key, size_t *len,
+                                   unsigned char *key, size_t len,
                                    const char *propquery);
  EVP_SKEY *EVP_SKEY_import_SKEYMGMT(OSSL_LIB_CTX *libctx, EVP_SKEYMGMT *skeymgmt,
                                     int selection, const OSSL_PARAM *params);
@@ -57,8 +57,10 @@ which is used by OpenSSL to store symmetric keys, assigns the
 B<EVP_SKEYMGMT> object associated with the key, and initializes the object from
 the B<params> argument.
 
-The EVP_SKEY_import_raw_key() function is a helper that creates an B<EVP_SKEY> object
-containing the raw byte representation of the symmetric keys.
+The EVP_SKEY_import_raw_key() function is a helper that creates an B<EVP_SKEY>
+object containing the raw byte representation of the symmetric keys from the
+buffer I<key> having length I<len>. The I<skeymgmtname> defines the name of the
+target B<EVP_SKEYMGMT> for the newly created key.
 
 The EVP_SKEY_import_SKEYMGMT() function is a helper that creates an B<EVP_SKEY>
 object containing the representation of the symmetric keys specific to the