1238384Sjkim=pod
2238384Sjkim
3238384Sjkim=begin comment
4238384Sjkim
5238384SjkimCopyright 2005 Nokia. All rights reserved.
6238384Sjkim
7238384SjkimThe portions of the attached software ("Contribution") is developed by
8238384SjkimNokia Corporation and is licensed pursuant to the OpenSSL open source
9238384Sjkimlicense.
10238384Sjkim
11238384SjkimThe Contribution, originally written by Mika Kousa and Pasi Eronen of
12238384SjkimNokia Corporation, consists of the "PSK" (Pre-Shared Key) ciphersuites
13238384Sjkimsupport (see RFC 4279) to OpenSSL.
14238384Sjkim
15238384SjkimNo patent licenses or other rights except those expressly stated in
16238384Sjkimthe OpenSSL open source license shall be deemed granted or received
17238384Sjkimexpressly, by implication, estoppel, or otherwise.
18238384Sjkim
19238384SjkimNo assurances are provided by Nokia that the Contribution does not
20238384Sjkiminfringe the patent or other intellectual property rights of any third
21238384Sjkimparty or that the license provides you with all the necessary rights
22238384Sjkimto make use of the Contribution.
23238384Sjkim
24238384SjkimTHE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IN
25238384SjkimADDITION TO THE DISCLAIMERS INCLUDED IN THE LICENSE, NOKIA
26238384SjkimSPECIFICALLY DISCLAIMS ANY LIABILITY FOR CLAIMS BROUGHT BY YOU OR ANY
27238384SjkimOTHER ENTITY BASED ON INFRINGEMENT OF INTELLECTUAL PROPERTY RIGHTS OR
28238384SjkimOTHERWISE.
29238384Sjkim
30238384Sjkim=end comment
31238384Sjkim
32238384Sjkim=head1 NAME
33238384Sjkim
34238384SjkimSSL_get_psk_identity, SSL_get_psk_identity_hint - get PSK client identity and hint
35238384Sjkim
36238384Sjkim
37238384Sjkim=head1 SYNOPSIS
38238384Sjkim
39238384Sjkim #include <openssl/ssl.h>
40238384Sjkim
41238384Sjkim const char *SSL_get_psk_identity_hint(const SSL *ssl);
42238384Sjkim const char *SSL_get_psk_identity(const SSL *ssl);
43238384Sjkim
44238384Sjkim
45238384Sjkim=head1 DESCRIPTION
46238384Sjkim
47238384SjkimSSL_get_psk_identity_hint() is used to retrieve the PSK identity hint
48238384Sjkimused during the connection setup related to SSL object
49238384SjkimB<ssl>. Similarly, SSL_get_psk_identity() is used to retrieve the PSK
50238384Sjkimidentity used during the connection setup.
51238384Sjkim
52238384Sjkim
53238384Sjkim=head1 RETURN VALUES
54238384Sjkim
55238384SjkimIf non-B<NULL>, SSL_get_psk_identity_hint() returns the PSK identity
56238384Sjkimhint and SSL_get_psk_identity() returns the PSK identity. Both are
57238384SjkimB<NULL>-terminated. SSL_get_psk_identity_hint() may return B<NULL> if
58238384Sjkimno PSK identity hint was used during the connection setup.
59238384Sjkim
60238384SjkimNote that the return value is valid only during the lifetime of the
61238384SjkimSSL object B<ssl>.
62238384Sjkim
63238384Sjkim=cut
64