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