System i: Programming Secure Sockets APIs - IBM

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 */
};
Note: A full explanation of each of the members of the above structure are defined in the SSL_Handshake()
API description.
The SSLHandle structure returned will be initialized to hexadecimal zeros with the exception of the fd
field, which will be initialized to the socket_descriptor input parameter and the createFlags field, which will
be initialized to the flags input parameter.
Error Conditions
When the SSL_Create() API fails, errno can be set to:
[EALREADY]
[EBADF]
[EFAULT]
[EINVAL]
[EIO]
[ENOBUFS]
[ENOTSOCK]
[EPIPE]
[EUNATCH]
Operation already in progress.
Descriptor not valid.
Bad address.
Parameter not valid.
This error code indicates one of the following:
v The socket_descriptor type is not SOCK_STREAM or address family is not AF_INET or
AF_INET6.
v One of the parameters passed is not valid or is NULL.
Input/output error.
There is not enough buffer space for the requested operation.
The specified descriptor does not reference a socket.
Broken pipe.
70 System i: Programming Secure Sockets APIs