RSP_remoteUseSSL
Name
RSP_remoteUseSSL -- Specifies that this connection should use secure SSL communication.
Synopsis
int RSP_remoteUseSSL
(RSP_parseData *pd, char* keyfile);
Description
Sets up internal data structures to use SSL when communicating
with the History Listener. This function is meant to be called
after
the server structure is created (with RSP_newParseRemote) but
before an actual connection is established.
Should this function be called in the middle of data
retrieval an error will be returned, RSP_ALREADY_CONNECTED.
The keyfile parameter is the path to the keyfile used
by SSL. This file does not have to exist; if it does not,
RSP_remoteUseSSL will create it.
Returns
This function returns 0 if no error occurred, and -1 otherwise.
Error Conditions
If an error occurs with this function, -1 is returned and
rsp_error is set appropriately. Possible error values are:
RSP_NO_SSL
RSP_SSL_CTX
RSP_SSL_KEYGEN
RSP_SSL_KEYFILE_OPEN
RSP_SSL_KEYFILE_WRITE
RSP_SSL_KEYPAIR
RSP_SSL_CERT
RSP_SSL_CERT_SIGN
RSP_SSL_PRIVATE_KEY