22.10.2013 Views

System i: Programming Secure Sockets APIs - IBM

System i: Programming Secure Sockets APIs - IBM

System i: Programming Secure Sockets APIs - IBM

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

Parameters<br />

int sslreturnvalue (Input)<br />

The Return Value received from a SSL API.<br />

char* string (Input)<br />

The string to be printed prior to the message associated with the sslreturnvalue. If no preceding<br />

message is desired, NULL must be entered.<br />

Authorities<br />

No authorization is required.<br />

Return Value<br />

There is no return value.<br />

Error Conditions<br />

This API calls the Retrieve SSL Runtime Error Message (SSL_Strerror) API in order to perform its task. It<br />

inherits all error conditions from this function. If the sslreturnvalue is unrecognized or if unable to<br />

retrieve the message corresponding to sslreturnvalue, then an Unknown error message will be printed<br />

following the string. Also, the message associated with the value found in the thread’s errno is printed.<br />

Note: the value of errno may be updated by SSL_Perror() in some error conditions.<br />

Error Messages<br />

See Error Conditions.<br />

Related Information<br />

v “SSL_Strerror()—Retrieve SSL Runtime Error Message” on page 95—Retrieve SSL Runtime Error<br />

Message<br />

v “SSL_Create()—Enable SSL Support for the Specified Socket Descriptor” on page 69—Enable SSL<br />

Support for the Specified Socket Descriptor<br />

v “SSL_Destroy()—End SSL Support for the Specified SSL Session” on page 71—End SSL Support for the<br />

Specified SSL Session<br />

v “SSL_Handshake()—Initiate the SSL Handshake Protocol” on page 74—Initiate the SSL Handshake<br />

Protocol<br />

v “SSL_Init()—Initialize the Current Job for SSL” on page 80—Initialize the Current Job for SSL<br />

v “SSL_Init_Application()—Initialize the Current Job for SSL Processing Based on the Application<br />

Identifier” on page 84—Initialize the Current Job for SSL Processing Based on the Application Identifier<br />

v “SSL_Read()—Receive Data from an SSL-Enabled Socket Descriptor” on page 91—Receive Data from<br />

an SSL-Enabled Socket Descriptor<br />

v “SSL_Write()—Write Data to an SSL-Enabled Socket Descriptor” on page 97—Write Data to an<br />

SSL-Enabled Socket Descriptor<br />

Example<br />

The following example shows how SSL_Perror() is used.<br />

Note: By using the code examples, you agree to the terms of the “Code license and disclaimer<br />

information” on page 111.<br />

#include <br />

#include <br />

#include <br />

#include <br />

#include <br />

90 <strong>System</strong> i: <strong>Programming</strong> <strong>Secure</strong> <strong>Sockets</strong> <strong>APIs</strong>

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!