move manual pages from doc/ to man/ for consistency with other

libraries, in particular considering that there are unrelated
files in doc/; requested by jsing@ and beck@

1 files changed, 44 insertions, 0 deletions

diff --git a/src/lib/libssl/man/SSL_get_psk_identity.3 b/src/lib/libssl/man/SSL_get_psk_identity.3
new file mode 100644
index 0000000000..a2f91ee1c7
--- /dev/null
+++ b/src/lib/libssl/man/SSL_get_psk_identity.3
@@ -0,0 +1,44 @@
+.\"
+.\"     $OpenBSD: SSL_get_psk_identity.3,v 1.1 2016/11/05 15:32:20 schwarze Exp $
+.\"
+.Dd $Mdocdate: November 5 2016 $
+.Dt SSL_GET_PSK_IDENTITY 3
+.Os
+.Sh NAME
+.Nm SSL_get_psk_identity ,
+.Nm SSL_get_psk_identity_hint
+.Nd get PSK client identity and hint
+.Sh SYNOPSIS
+.In openssl/ssl.h
+.Ft const char *
+.Fn SSL_get_psk_identity_hint "const SSL *ssl"
+.Ft const char *
+.Fn SSL_get_psk_identity "const SSL *ssl"
+.Sh DESCRIPTION
+.Fn SSL_get_psk_identity_hint
+is used to retrieve the PSK identity hint used during the connection setup
+related to
+.Vt SSL
+object
+.Fa ssl .
+Similarly,
+.Fn SSL_get_psk_identity
+is used to retrieve the PSK identity used during the connection setup.
+.Sh RETURN VALUES
+If
+.Pf non- Dv NULL ,
+.Fn SSL_get_psk_identity_hint
+returns the PSK identity hint and
+.Fn SSL_get_psk_identity
+returns the PSK identity.
+Both are
+.Dv NULL Ns -terminated.
+.Fn SSL_get_psk_identity_hint
+may return
+.Dv NULL
+if no PSK identity hint was used during the connection setup.
+.Pp
+Note that the return value is valid only during the lifetime of the
+.Vt SSL
+object
+.Fa ssl .