Functions
amqp_socket_t *	amqp_ssl_socket_new (amqp_connection_state_t state)
	Create a new SSL/TLS socket object. More...

int	amqp_ssl_socket_set_cacert (amqp_socket_t self, const char cacert)
	Set the CA certificate. More...

int	amqp_ssl_socket_set_key (amqp_socket_t self, const char cert, const char *key)
	Set the client key. More...

int	amqp_ssl_socket_set_key_buffer (amqp_socket_t self, const char cert, const void *key, size_t n)
	Set the client key from a buffer. More...

void	amqp_ssl_socket_set_verify (amqp_socket_t *self, amqp_boolean_t verify)
	Enable or disable peer verification. More...

void	amqp_set_initialize_ssl_library (amqp_boolean_t do_initialize)
	Sets whether rabbitmq-c initializes the underlying SSL library. More...

Function Documentation

void amqp_set_initialize_ssl_library ( amqp_boolean_t do_initialize)

Sets whether rabbitmq-c initializes the underlying SSL library.

For SSL libraries that require a one-time initialization across a whole program (e.g., OpenSSL) this sets whether or not rabbitmq-c will initialize the SSL library when the first call to amqp_open_socket() is made. You should call this function with do_init = 0 if the underlying SSL library is initialized somewhere else the program.

Failing to initialize or double initialization of the SSL library will result in undefined behavior

By default rabbitmq-c will initialize the underlying SSL library

NOTE: calling this function after the first socket has been opened with amqp_open_socket() will not have any effect.

Parameters

[in] do_initalize If 0 rabbitmq-c will not initialize the SSL library, otherwise rabbitmq-c will initialize the SSL library

Since: v0.4.0

amqp_socket_t* amqp_ssl_socket_new ( amqp_connection_state_t state)

Create a new SSL/TLS socket object.

The returned socket object is owned by the amqp_connection_state_t object and will be destroyed when the state object is destroyed or a new socket object is created.

If the socket object creation fails, the amqp_connection_state_t object will not be changed.

The object returned by this function can be retrieved from the amqp_connection_state_t object later using the amqp_get_socket() function.

Calling this function may result in the underlying SSL library being initialized.

See Also: amqp_set_initialize_ssl_library()

Parameters

[in,out] state The connection object that owns the SSL/TLS socket

Returns: A new socket object or NULL if an error occurred.

Since: v0.4.0

int amqp_ssl_socket_set_cacert	(	amqp_socket_t *	self,
		const char *	cacert
	)

Set the CA certificate.

Parameters

[in,out]	self	An SSL/TLS socket object.
[in]	cacert	Path to the CA cert file in PEM format.

Returns: AMQP_STATUS_OK on success an enum

Since: v0.4.0

int amqp_ssl_socket_set_key	(	amqp_socket_t *	self,
		const char *	cert,
		const char *	key
	)

Set the client key.

Parameters

[in,out]	self	An SSL/TLS socket object.
[in]	cert	Path to the client certificate in PEM foramt.
[in]	key	Path to the client key in PEM format.

Returns: Zero if successful, -1 otherwise.

Since: v0.4.0

int amqp_ssl_socket_set_key_buffer	(	amqp_socket_t *	self,
		const char *	cert,
		const void *	key,
		size_t	n
	)

Set the client key from a buffer.

Parameters

[in,out]	self	An SSL/TLS socket object.
[in]	cert	Path to the client certificate in PEM foramt.
[in]	key	A buffer containing client key in PEM format.
[in]	n	The length of the buffer.

Returns: Zero if successful, -1 otherwise.

Since: v0.4.0

void amqp_ssl_socket_set_verify	(	amqp_socket_t *	self,
		amqp_boolean_t	verify
	)

Enable or disable peer verification.

If peer verification is enabled then the common name in the server certificate must match the server name. Peer verification is enabled by default.

Parameters

[in,out]	self	An SSL/TLS socket object.
[in]	verify	Enable or disable peer verification.

Since: v0.4.0

Functions

Function Documentation