#use wml::openssl-macros area=docs page=SSL_get_psk_identity

<title>Documents, SSL_get_psk_identity(3)</title>

<h1>SSL_get_psk_identity(3)</h1>

#use wml::imp::generic

{:
## What's this? [[s|(<STRONG>[^<].+?)</A>(</STRONG><DD>)|$1$2|sg]]
[[s|<P>\s+<P>|<P>|sg]]
[[s|<P>\s+</|</|sg]]
[[s|<DD>\s*<DT>|<DD>&nbsp;<DT>|sg]]
[[s|<DD>\s*</DL>|<DD>&nbsp;</DL>|sg]]
[[s|\[|&#91;|sg]]
[[s|\]|&#93;|sg]]

<!-- INDEX BEGIN -->

<UL>

	<LI><A HREF="#NAME">NAME</A>
	<LI><A HREF="#SYNOPSIS">SYNOPSIS</A>
	<LI><A HREF="#DESCRIPTION">DESCRIPTION</A>
	<LI><A HREF="#RETURN_VALUES">RETURN VALUES</A>
</UL>
<!-- INDEX END -->

<HR>
<P>
<HR>
<H1><A NAME="NAME">NAME</A></H1>
<P>
SSL_get_psk_identity, SSL_get_psk_identity_hint - get PSK client identity
and hint

</P>
<P>
<HR>
<H1><A NAME="SYNOPSIS">SYNOPSIS</A></H1>
<PRE> #include &lt;openssl/ssl.h&gt;
</PRE>
<PRE> const char *SSL_get_psk_identity_hint(const SSL *ssl);
 const char *SSL_get_psk_identity(const SSL *ssl);
</PRE>
<P>
<HR>
<H1><A NAME="DESCRIPTION">DESCRIPTION</A></H1>
<P>
<CODE>SSL_get_psk_identity_hint()</CODE> is used to retrieve the PSK
identity hint used during the connection setup related to SSL object
<STRONG>ssl</STRONG>. Similarly, <CODE>SSL_get_psk_identity()</CODE> is used to retrieve the
PSK identity used during the connection setup.

</P>
<P>
<HR>
<H1><A NAME="RETURN_VALUES">RETURN VALUES</A></H1>
<P>
If non-<STRONG>NULL</STRONG>, <CODE>SSL_get_psk_identity_hint()</CODE> returns the PSK identity hint
and <CODE>SSL_get_psk_identity()</CODE> returns the PSK identity. Both are
<STRONG>NULL</STRONG>-terminated. <CODE>SSL_get_psk_identity_hint()</CODE> may return <STRONG>NULL</STRONG> if no PSK identity hint was used during the connection setup.

</P>
<P>
Note that the return value is valid only during the lifetime of the SSL
object <STRONG>ssl</STRONG>.

</P>
:}