NAME

       EVP_PKEY_CTX_get0_pkey, EVP_PKEY_CTX_get0_peerkey - functions for accessing the EVP_PKEY
       associated with an EVP_PKEY_CTX

SYNOPSIS

        #include <openssl/evp.h>

        EVP_PKEY *EVP_PKEY_CTX_get0_pkey(EVP_PKEY_CTX *ctx);
        EVP_PKEY *EVP_PKEY_CTX_get0_peerkey(EVP_PKEY_CTX *ctx);

DESCRIPTION

       EVP_PKEY_CTX_get0_pkey() is used to access the EVP_PKEY associated with the given
       EVP_PKEY_CTX ctx.  The EVP_PKEY obtained is the one used for creating the EVP_PKEY_CTX
       using either EVP_PKEY_CTX_new(3) or EVP_PKEY_CTX_new_from_pkey(3).

       EVP_PKEY_CTX_get0_peerkey() is used to access the peer EVP_PKEY associated with the given
       EVP_PKEY_CTX ctx.  The peer EVP_PKEY obtained is the one set using either
       EVP_PKEY_derive_set_peer(3) or EVP_PKEY_derive_set_peer_ex(3).

RETURN VALUES

       EVP_PKEY_CTX_get0_pkey() returns the EVP_PKEY associated with the EVP_PKEY_CTX or NULL if
       it is not set.

       EVP_PKEY_CTX_get0_peerkey() returns the peer EVP_PKEY associated with the EVP_PKEY_CTX or
       NULL if it is not set.

       The returned EVP_PKEY objects are owned by the EVP_PKEY_CTX, and therefore should not
       explicitly be freed by the caller.

       These functions do not affect the EVP_PKEY reference count.  They merely act as getter
       functions, and should be treated as such.

SEE ALSO

       EVP_PKEY_CTX_new(3), EVP_PKEY_CTX_new_from_pkey(3), EVP_PKEY_derive_set_peer(3),
       EVP_PKEY_derive_set_peer_ex(3)

COPYRIGHT

       Copyright 2022-2023 The OpenSSL Project Authors. All Rights Reserved.

       Licensed under the Apache License 2.0 (the "License").  You may not use this file except
       in compliance with the License.  You can obtain a copy in the file LICENSE in the source
       distribution or at <https://www.openssl.org/source/license.html>.