Commit 3f4a593350 for openssl.org
commit 3f4a593350853d91a4014de89cee85bc8c93a731
Author: Dmitry Belyavskiy <beldmit@gmail.com>
Date: Mon Jan 5 14:46:15 2026 +0100
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 ac5e7bd125..e79874ee30 100644
--- 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 9f013cc8c7..91875a6ce1 100644
--- 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