summaryrefslogtreecommitdiff
path: root/crypto/openssl/doc/ssl/SSL_get_peer_certificate.pod
diff options
context:
space:
mode:
authorcvs2svn <cvs2svn@FreeBSD.org>2003-10-27 07:57:33 +0000
committercvs2svn <cvs2svn@FreeBSD.org>2003-10-27 07:57:33 +0000
commit90928716548537e93f54266e33cb4a3353fd3932 (patch)
tree37675d5349af34454f2e21880134fb82d6854793 /crypto/openssl/doc/ssl/SSL_get_peer_certificate.pod
parentc6085d40c17b76abbaa35c8c53f14904021df451 (diff)
Diffstat (limited to 'crypto/openssl/doc/ssl/SSL_get_peer_certificate.pod')
-rw-r--r--crypto/openssl/doc/ssl/SSL_get_peer_certificate.pod55
1 files changed, 0 insertions, 55 deletions
diff --git a/crypto/openssl/doc/ssl/SSL_get_peer_certificate.pod b/crypto/openssl/doc/ssl/SSL_get_peer_certificate.pod
deleted file mode 100644
index 60635a966000..000000000000
--- a/crypto/openssl/doc/ssl/SSL_get_peer_certificate.pod
+++ /dev/null
@@ -1,55 +0,0 @@
-=pod
-
-=head1 NAME
-
-SSL_get_peer_certificate - get the X509 certificate of the peer
-
-=head1 SYNOPSIS
-
- #include <openssl/ssl.h>
-
- X509 *SSL_get_peer_certificate(SSL *ssl);
-
-=head1 DESCRIPTION
-
-SSL_get_peer_certificate() returns a pointer to the X509 certificate the
-peer presented. If the peer did not present a certificate, NULL is returned.
-
-=head1 NOTES
-
-Due to the protocol definition, a TLS/SSL server will always send a
-certificate, if present. A client will only send a certificate when
-explicitly requested to do so by the server (see
-L<SSL_CTX_set_verify(3)|SSL_CTX_set_verify(3)>). If an anonymous cipher
-is used, no certificates are sent.
-
-That a certificate is returned does not indicate information about the
-verification state, use L<SSL_get_verify_result(3)|SSL_get_verify_result(3)>
-to check the verification state.
-
-The reference count of the X509 object is incremented by one, so that it
-will not be destroyed when the session containing the peer certificate is
-freed. The X509 object must be explicitly freed using X509_free().
-
-=head1 RETURN VALUES
-
-The following return values can occur:
-
-=over 4
-
-=item NULL
-
-No certificate was presented by the peer or no connection was established.
-
-=item Pointer to an X509 certificate
-
-The return value points to the certificate presented by the peer.
-
-=back
-
-=head1 SEE ALSO
-
-L<ssl(3)|ssl(3)>, L<SSL_get_verify_result(3)|SSL_get_verify_result(3)>,
-L<SSL_CTX_set_verify(3)|SSL_CTX_set_verify(3)>
-
-=cut