"Fossies" - the Fresh Open Source Software Archive

Member "libressl-2.9.2/man/EVP_PKEY_cmp.3" (4 Dec 2018, 5018 Bytes) of package /linux/misc/libressl-2.9.2.tar.gz:


Caution: As a special service "Fossies" has tried to format the requested manual source page into HTML format but links to other man pages may be missing or even errorneous. Alternatively you can here view or download the uninterpreted manual source code. A member file download can also be achieved by clicking within a package contents listing on the according byte size field.

EVP_PKEY_CMP(3) BSD Library Functions Manual EVP_PKEY_CMP(3)

NAME

EVP_PKEY_missing_parameters, EVP_PKEY_copy_parameters, EVP_PKEY_cmp_parameters, EVP_PKEY_cmp — public key parameter and comparison functions

SYNOPSIS

#include <openssl/evp.h>

int

EVP_PKEY_missing_parameters(const EVP_PKEY *pkey);

int

EVP_PKEY_copy_parameters(EVP_PKEY *to, const EVP_PKEY *from);

int

EVP_PKEY_cmp_parameters(const EVP_PKEY *a, const EVP_PKEY *b);

int

EVP_PKEY_cmp(const EVP_PKEY *a, const EVP_PKEY *b);

DESCRIPTION

The function EVP_PKEY_missing_parameters() returns 1 if the public key parameters of pkey are missing and 0 if they are present or the algorithm doesn’t use parameters.

The function EVP_PKEY_copy_parameters() copies the parameters from key from to key to. An error is returned if the parameters are missing in from.

The function EVP_PKEY_cmp_parameters() compares the parameters of keys a and b.

The function EVP_PKEY_cmp() compares the public key components and parameters (if present) of keys a and b.

The main purpose of the functions EVP_PKEY_missing_parameters() and EVP_PKEY_copy_parameters() is to handle public keys in certificates where the parameters are sometimes omitted from a public key if they are inherited from the CA that signed it.

Since OpenSSL private keys contain public key components too, the function EVP_PKEY_cmp() can also be used to determine if a private key matches a public key.

RETURN VALUES

The function EVP_PKEY_missing_parameters() returns 1 if the public key parameters of pkey are missing and 0 if they are present or the algorithm doesn’t use parameters.

The function EVP_PKEY_copy_parameters() returns 1 for success and 0 for failure.

The functions EVP_PKEY_cmp_parameters() and EVP_PKEY_cmp() return 1 if the keys match, 0 if they don’t match, -1 if the key types are different and -2 if the operation is not supported.

SEE ALSO

EVP_PKEY_asn1_set_public(3), EVP_PKEY_CTX_new(3), EVP_PKEY_keygen(3)

HISTORY

EVP_PKEY_missing_parameters() and EVP_PKEY_copy_parameters() first appeared in SSLeay 0.8.0. EVP_PKEY_cmp_parameters() first appeared in SSLeay 0.9.0. These functions have been available since OpenBSD 2.4.

EVP_PKEY_cmp() first appeared in OpenSSL 0.9.8 and has been available since OpenBSD 4.5.

BSD March 27, 2018 BSD