The `OSSL_PKEY_PARAM_BITS` is under-documented
#28.337 aberto em 25 de ago. de 2025
Métricas do repositório
- Stars
- (30.157 estrelas)
- Métricas de merge de PR
- (Nenhuma PRs mesclada em 30d)
Description
The parameter OSSL_PKEY_PARAM_BITS is under-documented. The only reference to that is in the manual page for provider-keymgmt, only saying its cryptosystem-specific:
But neither of the cryptosystems specifies this parameter in the documentation nor its explicit meaning. In case of RSA, its mostly intuitive what bits should mean and what value we should expect, but in newer cryptosystems, such as ML-DSA, this is not obvious.
From the code (with help of @beldmit to de-obfuscate the provider implementation), it looks like for the ML-DSA and SLH-DSA it also means the bit size of public key, but its not documented anywhere and it is left for the user to guess (or dig very very deep in the code).
Please, add to each of the PKEY cryptosystem documentation the meaning of this (or other missing) parameters.