summaryrefslogtreecommitdiffstats
path: root/doc/ssl/SSL_get0_peer_scts.pod
blob: a2a1a299064f021dffc02b5baafb07b90ca6daca (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
=pod

=head1 NAME

SSL_get0_peer_scts - get SCTs received

=head1 SYNOPSIS

 #include <openssl/ssl.h>

 const STACK_OF(SCT) *SSL_get0_peer_scts(SSL *s);

=head1 DESCRIPTION

SSL_get0_peer_scts() returns the signed certificate timestamps (SCTs) that have
been received. If this is the first time that this function has been called for
a given B<SSL> instance, it will examine the TLS extensions, OCSP response and
the peer's certificate for SCTs. Future calls will return the same SCTs.

=head1 RESTRICTIONS

If no Certificate Transparency validation callback has been set (using
B<SSL_CTX_set_ct_validation_callback> or B<SSL_set_ct_validation_callback>),
this function is not guarantee to return all of the SCTs that the peer is
capable of sending.

=head1 RETURN VALUES

SSL_get0_peer_scts() returns a list of SCTs found, or NULL if an error occurs.

=head1 SEE ALSO

L<ssl(3)>,
L<SSL_CTX_set_ct_validation_callback(3)>

=cut