Updated: 2022/Sep/29

Please read Privacy Policy. It's for your privacy.

EVP_PKEY_CTX_get0_pkey(3)           OpenSSL          EVP_PKEY_CTX_get0_pkey(3)



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

LIBRARY
       libcrypto, -lcrypto

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>.



3.0.12                            2023-05-07         EVP_PKEY_CTX_get0_pkey(3)