xref: /openssl/doc/man3/SSL_get0_group_name.pod (revision 0f77b6f1)
1=pod
2
3=head1 NAME
4
5SSL_get0_group_name - get name of the group that was used for the key
6agreement of the current TLS session establishment
7
8=head1 SYNOPSIS
9
10 #include <openssl/ssl.h>
11
12 const char *SSL_get0_group_name(SSL *s);
13
14=head1 DESCRIPTION
15
16SSL_get0_group_name() returns the name of the group that was used for
17the key agreement of the current TLS session establishment.
18
19=head1 RETURN VALUES
20
21If non-NULL, SSL_get0_group_name() returns the name of the group that was used for
22the key agreement of the current TLS session establishment.
23If SSL_get0_group_name() returns NULL, an error occurred; possibly no TLS session
24has been established.
25
26Note that the return value is valid only during the lifetime of the
27SSL object I<ssl>.
28
29=head1 SEE ALSO
30
31L<ssl(7)>
32
33=head1 HISTORY
34
35This function was added in OpenSSL 3.2.
36
37=head1 COPYRIGHT
38
39Copyright 2023-2024 The OpenSSL Project Authors. All Rights Reserved.
40
41Licensed under the Apache License 2.0 (the "License").  You may not use
42this file except in compliance with the License.  You can obtain a copy
43in the file LICENSE in the source distribution or at
44L<https://www.openssl.org/source/license.html>.
45
46=cut
47