]>
Commit | Line | Data |
---|---|---|
508fafd8 MC |
1 | =pod |
2 | ||
3 | =head1 NAME | |
4 | ||
a51c9f63 VD |
5 | SSL_get_peer_tmp_key, SSL_get_server_tmp_key, SSL_get_tmp_key - get information |
6 | about temporary keys used during a handshake | |
508fafd8 MC |
7 | |
8 | =head1 SYNOPSIS | |
9 | ||
10 | #include <openssl/ssl.h> | |
11 | ||
a51c9f63 | 12 | long SSL_get_peer_tmp_key(SSL *ssl, EVP_PKEY **key); |
508fafd8 | 13 | long SSL_get_server_tmp_key(SSL *ssl, EVP_PKEY **key); |
a51c9f63 | 14 | long SSL_get_tmp_key(SSL *ssl, EVP_PKEY **key); |
508fafd8 MC |
15 | |
16 | =head1 DESCRIPTION | |
17 | ||
a51c9f63 | 18 | SSL_get_peer_tmp_key() returns the temporary key provided by the peer and |
508fafd8 | 19 | used during key exchange. For example, if ECDHE is in use, then this represents |
a51c9f63 | 20 | the peer's public ECDHE key. On success a pointer to the key is stored in |
508fafd8 | 21 | B<*key>. It is the caller's responsibility to free this key after use using |
a51c9f63 VD |
22 | L<EVP_PKEY_free(3)>. |
23 | ||
24 | SSL_get_server_tmp_key() is a backwards compatibility alias for | |
25 | SSL_get_peer_tmp_key(). | |
26 | Under that name it worked just on the client side of the connection, its | |
27 | behaviour on the server end is release-dependent. | |
28 | ||
29 | SSL_get_tmp_key() returns the equivalent information for the local | |
30 | end of the connection. | |
508fafd8 MC |
31 | |
32 | =head1 RETURN VALUES | |
33 | ||
a51c9f63 | 34 | All these functions return 1 on success and 0 otherwise. |
508fafd8 MC |
35 | |
36 | =head1 NOTES | |
37 | ||
38 | This function is implemented as a macro. | |
39 | ||
40 | =head1 SEE ALSO | |
41 | ||
42 | L<ssl(7)>, L<EVP_PKEY_free(3)> | |
43 | ||
44 | =head1 COPYRIGHT | |
45 | ||
c486283c | 46 | Copyright 2017-2018 The OpenSSL Project Authors. All Rights Reserved. |
508fafd8 | 47 | |
4746f25a | 48 | Licensed under the Apache License 2.0 (the "License"). You may not use |
508fafd8 MC |
49 | this file except in compliance with the License. You can obtain a copy |
50 | in the file LICENSE in the source distribution or at | |
51 | L<https://www.openssl.org/source/license.html>. | |
52 | ||
53 | =cut |