extern struct diagnostic* tls_privatize

(struct BP_CONNECTION* bp,
  char* serverName)

Tune using TLS, and update the connection's configuration structure accordingly.

Documentation

Tune using TLS, and update the connection's configuration structure accordingly.

On success, transport privacy is in effect and no user channels are open.

Parameters:

bp - A pointer to the connection structure.

Input Keys:

TLS_CERTFILE

The name of the file containing the public key certificate.

TLS_KEYFILE

The name of the file containing the private key.

Output Keys:

PRIVACY_REMOTE_SUBJECTNAME

The subject name from the peer's certificate.

PRIVACY_CIPHER_NAME

The name of the cipher in use.

PRIVACY_CIPHER_PROTOCOL

The name of the privacy protocol in use.

PRIVACY_CIPHER_SBITS

The number of bits in the secret key in use.

PRIVACY_CIPHER_ABITS

The number of bits in the algorithm in use.

serverName - The value to use for the serverName attribute of the <start> element, or NULL.

Returns:

On failure, a pointer to a diagnostic structure explaining the reason (which should subsequently be destroyed by calling bp_diagnostic_destroy).

Home Alphabetic index