1=pod 2 3=head1 NAME 4 5EVP_KEM-ML-KEM-512, EVP_KEM-ML-KEM-768, EVP_KEM-ML-KEM-1024, EVP_KEM-ML-KEM 6- EVP_KEM ML-KEM keytype and algorithm support 7 8=head1 DESCRIPTION 9 10The B<ML-KEM> keytypes and parameters are described in L<EVP_PKEY-ML-KEM(7)>. 11See L<EVP_PKEY_encapsulate(3)> and L<EVP_PKEY_decapsulate(3)> for more details 12about basic KEM operations. 13 14=head2 ML-KEM KEM parameters 15 16=over 4 17 18=item "ikme" (B<OSSL_KEM_PARAM_IKME>) <octet string> 19 20The OpenSSL ML-KEM encapsulation mechanism can only be modified by 21setting randomness during encapsulation, this enables testing, as per 22FIPS 203, section 6.2, algorithm 17. 23 24This parameter should not be used for purposes other than testing. 25 26When this parameter is not set, encapsulation proceeds as per FIPS 203, 27section 7.2 28 29This parameter is only settable. 30 31=back 32 33This can be set when using EVP_PKEY_encapsulate_init(). 34 35=head1 CONFORMING TO 36 37=over 4 38 39=item FIPS203 40 41=back 42 43=head1 SEE ALSO 44 45L<EVP_PKEY_encapsulate(3)>, 46L<EVP_PKEY_decapsulate(3)>, 47L<EVP_KEYMGMT(3)>, 48L<EVP_PKEY(3)>, 49L<provider-keymgmt(7)> 50 51=head1 HISTORY 52 53This functionality was added in OpenSSL 3.5. 54 55=head1 COPYRIGHT 56 57Copyright 2024-2025 The OpenSSL Project Authors. All Rights Reserved. 58 59Licensed under the Apache License 2.0 (the "License"). You may not use 60this file except in compliance with the License. You can obtain a copy 61in the file LICENSE in the source distribution or at 62L<https://www.openssl.org/source/license.html>. 63 64=cut 65