SSL_get0_peer_scts.pod 1.2 KB

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