Scroll to navigation

MONGOC_CLIENT_SET_SSL_OPTS(3) libmongoc MONGOC_CLIENT_SET_SSL_OPTS(3)

SYNOPSIS

#ifdef MONGOC_ENABLE_SSL
void
mongoc_client_set_ssl_opts (mongoc_client_t *client,

const mongoc_ssl_opt_t *opts); #endif


Note:

Though some API names include the term "ssl", the C driver only support TLS protocols, which supersede SSL.


Sets the TLS (SSL) options to use when connecting to TLS enabled MongoDB servers.

The mongoc_ssl_opt_t <> struct is copied by the client along with the strings it points to (pem_file, pem_pwd, ca_file, ca_dir, and crl_file) so they don't have to remain valid after the call to mongoc_client_set_ssl_opts() <>.

A call to mongoc_client_set_ssl_opts() <> overrides all TLS options set through the connection string with which the mongoc_client_t <> was constructed.

It is a programming error to call this function on a client from a mongoc_client_pool_t <>. Instead, call mongoc_client_pool_set_ssl_opts() <> on the pool before popping any clients.

Changed in version 2.0.0: This function logs an error and immediately returns if client is from a mongoc_client_pool_t <>. Previously this function unsafely applied the options to the pooled client.

PARAMETERS

  • client: A mongoc_client_t <>.
  • opts: A mongoc_ssl_opt_t <>.

AVAILABILITY

This feature requires that the MongoDB C driver was compiled with -DENABLE_SSL.

Author

MongoDB, Inc

Copyright

2009-present, MongoDB, Inc.

November 26, 2025 2.2.0