System i: Programming Secure Sockets APIs - IBM

struct SSLHandleStr { /* SSLHandleStr */
int fd; /* Socket descriptor */
int createFlags; /* SSL_Create flags value */
unsigned protocol; /* SSL protocol version */
unsigned timeout; /* Timeout value in seconds */
unsigned char cipherKind[3]; /* Current 2.0 cipher suite*/
unsigned short int cipherSuite; /* Current 3.0 cipher suite */
unsigned short int* cipherSuiteList; /* List of cipher suites */
unsigned int cipherSuiteListLen; /* Number of entries in
the cipher suites list */
unsigned char* peerCert; /* Peer certificate */
unsigned peerCertLen; /* Peer certificate length */
int peerCertValidateRc; /* Return code from
validation of certficate */
int (*exitPgm)(struct SSLHandleStr* sslh);
/* Authentication exit
program called when a
certificate is received
during SSL handshake */
};
void *buffer (input)
A pointer to the user-supplied buffer in which the data to be written is stored.
int buffer_length (input)
The length of the buffer.
Authorities
No authorization is required.
Return Value
SSL_Write() returns an integer. Possible values are:
[n]
Successful, where n is the number of bytes written.
[SSL_ERROR_BAD_STATE]
SSL detected a bad state in the SSL session.
[SSL_ERROR_CLOSED]
The SSL session ended.
[SSL_ERROR_IO]
An error occurred in SSL processing; check the errno value.
[SSL_ERROR_UNKNOWN]
An unknown or unexpected error occurred during SSL processing.
Error Conditions
When the SSL_Write() API fails with return code [SSL_ERROR_IO], errno can be set to to one of the
following:
[EBADF]
[EFAULT]
Descriptor not valid.
98 System i: Programming Secure Sockets APIs