pub unsafe extern "C" fn mongocrypt_setopt_set_crypt_shared_lib_path_override(
crypt: *mut mongocrypt_t,
path: *const c_char,
)
Expand description
@brief Set a single override path for loading the crypt_shared dynamic library.
@param[in] crypt The @ref mongocrypt_t object to update
@param[in] path A null-terminated sequence of bytes for a path to the
crypt_shared dynamic library. On some filesystems, this may be arbitrary
bytes. On other filesystems, this may be required to be a valid UTF-8 code
unit sequence. If the leading element of the path is the literal string
$ORIGIN
, that substring will be replaced with the directory path containing
the executable libmongocrypt module.
@note This function will do no IO nor path validation. All validation will occur during the call to @ref mongocrypt_init.
@note If a crypt_shared library path override is specified here, then no paths given to @ref mongocrypt_setopt_append_crypt_shared_lib_search_path will be consulted when opening the crypt_shared library.
@note If a path is provided via this API and @ref mongocrypt_init fails to initialize a valid crypt_shared library instance for the path specified, then the initialization of mongocrypt_t will fail with an error.