pub unsafe extern "C" fn mongocrypt_setopt_append_crypt_shared_lib_search_path(
crypt: *mut mongocrypt_t,
path: *const c_char,
)Expand description
@brief Append an additional search directory to the search 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 the search path. 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. If the path string is literal “$SYSTEM”, then libmongocrypt will defer to the system’s library resolution mechanism to find the crypt_shared library.
@note If no crypt_shared dynamic library is found in any of the directories specified by the search paths loaded here, @ref mongocrypt_init() will still succeed and continue to operate without crypt_shared.
@note The search paths are searched in the order that they are appended. This allows one to provide a precedence in how the library will be discovered. For example, appending known directories before appending “$SYSTEM” will allow one to supersede the system’s installed library, but still fall-back to it if the library wasn’t found otherwise. If one does not ever append “$SYSTEM”, then the system’s library-search mechanism will never be consulted.
@note If an absolute path to the library is specified using @ref mongocrypt_setopt_set_crypt_shared_lib_path_override, then paths appended here will have no effect.