1=pod 2 3=begin comment 4 5Copyright 2005 Nokia. All rights reserved. 6 7The portions of the attached software ("Contribution") is developed by 8Nokia Corporation and is licensed pursuant to the OpenSSL open source 9license. 10 11The Contribution, originally written by Mika Kousa and Pasi Eronen of 12Nokia Corporation, consists of the "PSK" (Pre-Shared Key) ciphersuites 13support (see RFC 4279) to OpenSSL. 14 15No patent licenses or other rights except those expressly stated in 16the OpenSSL open source license shall be deemed granted or received 17expressly, by implication, estoppel, or otherwise. 18 19No assurances are provided by Nokia that the Contribution does not 20infringe the patent or other intellectual property rights of any third 21party or that the license provides you with all the necessary rights 22to make use of the Contribution. 23 24THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IN 25ADDITION TO THE DISCLAIMERS INCLUDED IN THE LICENSE, NOKIA 26SPECIFICALLY DISCLAIMS ANY LIABILITY FOR CLAIMS BROUGHT BY YOU OR ANY 27OTHER ENTITY BASED ON INFRINGEMENT OF INTELLECTUAL PROPERTY RIGHTS OR 28OTHERWISE. 29 30=end comment 31 32=head1 NAME 33 34SSL_get_psk_identity, SSL_get_psk_identity_hint - get PSK client identity and hint 35 36 37=head1 SYNOPSIS 38 39 #include <openssl/ssl.h> 40 41 const char *SSL_get_psk_identity_hint(const SSL *ssl); 42 const char *SSL_get_psk_identity(const SSL *ssl); 43 44 45=head1 DESCRIPTION 46 47SSL_get_psk_identity_hint() is used to retrieve the PSK identity hint 48used during the connection setup related to SSL object 49B<ssl>. Similarly, SSL_get_psk_identity() is used to retrieve the PSK 50identity used during the connection setup. 51 52 53=head1 RETURN VALUES 54 55If non-B<NULL>, SSL_get_psk_identity_hint() returns the PSK identity 56hint and SSL_get_psk_identity() returns the PSK identity. Both are 57B<NULL>-terminated. SSL_get_psk_identity_hint() may return B<NULL> if 58no PSK identity hint was used during the connection setup. 59 60Note that the return value is valid only during the lifetime of the 61SSL object B<ssl>. 62 63=cut 64