1SSL_GET_PEER_TMP_KEY(3ossl) OpenSSL SSL_GET_PEER_TMP_KEY(3ossl)
2
3
4
6 SSL_get_peer_tmp_key, SSL_get_server_tmp_key, SSL_get_tmp_key - get
7 information about temporary keys used during a handshake
8
10 #include <openssl/ssl.h>
11
12 long SSL_get_peer_tmp_key(SSL *ssl, EVP_PKEY **key);
13 long SSL_get_server_tmp_key(SSL *ssl, EVP_PKEY **key);
14 long SSL_get_tmp_key(SSL *ssl, EVP_PKEY **key);
15
17 SSL_get_peer_tmp_key() returns the temporary key provided by the peer
18 and used during key exchange. For example, if ECDHE is in use, then
19 this represents the peer's public ECDHE key. On success a pointer to
20 the key is stored in *key. It is the caller's responsibility to free
21 this key after use using EVP_PKEY_free(3).
22
23 SSL_get_server_tmp_key() is a backwards compatibility alias for
24 SSL_get_peer_tmp_key(). Under that name it worked just on the client
25 side of the connection, its behaviour on the server end is release-
26 dependent.
27
28 SSL_get_tmp_key() returns the equivalent information for the local end
29 of the connection.
30
32 All these functions return 1 on success and 0 otherwise.
33
35 This function is implemented as a macro.
36
38 ssl(7), EVP_PKEY_free(3)
39
41 Copyright 2017-2018 The OpenSSL Project Authors. All Rights Reserved.
42
43 Licensed under the Apache License 2.0 (the "License"). You may not use
44 this file except in compliance with the License. You can obtain a copy
45 in the file LICENSE in the source distribution or at
46 <https://www.openssl.org/source/license.html>.
47
48
49
503.0.9 2023-07-27 SSL_GET_PEER_TMP_KEY(3ossl)