xref: /freebsd/crypto/openssl/doc/man3/SSL_get0_peer_scts.pod (revision 2e3507c25e42292b45a5482e116d278f5515d04d)
1=pod
2
3=head1 NAME
4
5SSL_get0_peer_scts - get SCTs received
6
7=head1 SYNOPSIS
8
9 #include <openssl/ssl.h>
10
11 const STACK_OF(SCT) *SSL_get0_peer_scts(SSL *s);
12
13=head1 DESCRIPTION
14
15SSL_get0_peer_scts() returns the signed certificate timestamps (SCTs) that have
16been received. If this is the first time that this function has been called for
17a given B<SSL> instance, it will examine the TLS extensions, OCSP response and
18the peer's certificate for SCTs. Future calls will return the same SCTs.
19
20=head1 RESTRICTIONS
21
22If no Certificate Transparency validation callback has been set (using
23B<SSL_CTX_set_ct_validation_callback> or B<SSL_set_ct_validation_callback>),
24this function is not guaranteed to return all of the SCTs that the peer is
25capable of sending.
26
27=head1 RETURN VALUES
28
29SSL_get0_peer_scts() returns a list of SCTs found, or NULL if an error occurs.
30
31=head1 SEE ALSO
32
33L<ssl(7)>,
34L<SSL_CTX_set_ct_validation_callback(3)>
35
36=head1 COPYRIGHT
37
38Copyright 2016 The OpenSSL Project Authors. All Rights Reserved.
39
40Licensed under the Apache License 2.0 (the "License").  You may not use
41this file except in compliance with the License.  You can obtain a copy
42in the file LICENSE in the source distribution or at
43L<https://www.openssl.org/source/license.html>.
44
45=cut
46