What's New

Fixes

• No longer propagates the -fPIC flag in CMake targets

• Applies write command behavior to the mongoc_collection_create_indexes_with_opts() function

• Omits the saslSupportedMechs field in single-threaded monitoring commands

For more information about this release, see the v2.1.1 release notes.

Fixes

• For non-Windows environments, the uninstall script now calls the find "$dir" -maxdepth 1 command to detect non-empty directories instead of the ls --almost-all command, which was not supported on macOS.

• For Windows environments, the uninstall script no longer "succeeds" with an incorrect, non-zero %ERRORLABEL% value.

• Removes support for Debian 9 and Debian 10.

Improvements

• Sets CMake policy max version to 4.0. The max version was previously unset.

Fixes

• For non-Windows environments, the uninstall script now calls the find "$dir" -maxdepth 1 command to detect non-empty directories instead of the ls --almost-all command, which was not supported on macOS.

• For Windows environments, the uninstall script no longer "succeeds" with an incorrect, non-zero %ERRORLABEL% value.

• Adds Window Secure Channel support to verify client certificates with newer signatures.

• Replaces use of rand() with thread-safe alternatives.

• Removes support for Debian 9 and Debian 10.

Improvements

• Updates the minimum supported MongoDB Server version from 4.0 to 4.2.

• Sets CMake policy max version to 4.0. The max version was previously unset.

• Removes unhelpful long-lived buffers to reduce memory usage.

• Improves error messages produced by Windows APIs.

Fixes

• Fixes a message of bson_strerror_r on Windows.

• Fixes memory leaks with Windows Secure Channel.

• Fixes loading PKCS#8 RSA keys with Windows Secure Channel.

For more information about this release, see the v2.0.2 release notes.

Fixes

• Fixes a CMake 4 configuration error on macOS operating systems

Fixes

• Fixes a username handling issue for MONGODB-X509 authentication that occurred when the C driver was configured to use the Secure Transport or Secure Channel library

• No longer populates a mongoc_bulkwritereturn_t.res with a partial result when the mongoc_bulkwrite_execute() function generates a client error after the first write operation

For more information about this release, see the v2.0.1 release notes.

New Features

• Adds support for the BSON Binary Vector subtype. To learn more, see BSON Binary Vector subtype in the libbson API documentation.

New Features

• Supports aggregate operations that include $lookup stages for In-Use Encryption. To learn more, see the following references in the MongoDB Server manual:

  • $lookup and $graphLookup Behavior for CSFLE

  • $lookup and $graphLookup Behavior for QE

For more information about this release, see the v2.0 release notes.

New Features

• In anticipation of the v2.0 release, adds new CMake packages and imported targets for bson to allow you to support both major versions without modifying your CMake project.

  • To import bson with the new names, call find_package for the bson package. The new imported target names are bson::static, bson::shared, and bson::bson.

New Features

• In anticipation of the v2.0 release, adds new CMake packages and imported targets for bson and mongoc to allow you to support both major versions without modifying your CMake project.

  • To import mongoc with the new names, call find_package for the mongoc package. The new imported target names are mongoc::static, mongoc::shared, and mongoc::mongoc.

  • To import bson with the new names, call find_package for the bson package. The new imported target names are bson::static, bson::shared, and bson::bson.

For more information about this release, see the v1.30.3 release notes.

Deprecations

• Deprecates support for Debian 9 and Debian 10

Improvements

• Improves the performance of BSON to JSON serialization for nested documents

Fixes

• Updates the truncated output of the bson_as_json_with_opts() function to no longer split valid UTF-8 sequences

• Updates generated JSON text in the following ways:

  • Serializes all empty arrays and documents with one space

  • Serializes arrays that the driver omits because of the maximum recursion limit to [ ... ] instead of { ... }

  • Applies the maximum recursion limit to legacy CodeWScope documents

• Fixes an output parameter leaked after unsuccessful calls to the bson_append_array_builder_begin() function

Deprecations

• Deprecates support for Debian 9 and Debian 10

New Features

• Adds support for structured logging. To configure this feature, use the mongoc_client_set_structured_log_opts() and mongoc_client_pool_set_structured_log_opts() functions.

• Adds support for cache lifetime configuration of In-Use Encryption data encryption keys. To configure this feature, use the mongoc_auto_encryption_opts_set_key_expiration() and mongoc_client_encryption_opts_set_key_expiration() functions.

  To learn more about In-Use Encryption, see In-Use Encryption in the MongoDB Server manual.

• Adds support for the sort option for update and replace operations.

• Adds support for constructing a mongoc_bulkwrite_t type without a client by using the mongoc_bulkwrite_new() and mongoc_bulkwrite_set_client() functions.

Improvements

• Improves the performance of the mongoc_server_description_new_copy() function

Fixes

• Includes the following APM event fixes required by the SDAM specification:

  • After delivering a server_opening event, the driver must deliver a corresponding server_closed event before delivering topology_closed

  • Before delivering a topology_closed event, the driver delivers a topology_changed event that has a new_description of type Unknown

• Fixes possible crashes when the driver reports the inserted document IDs in the verbose results of client bulk writes

For more information about this release, see the v1.30 release notes.

Deprecations

• Deprecates the bson_string_t and associated functions

• Deprecates compiling with BSON_MEMCHECK

• Deprecates bson_in_range_*() and bson_cmp_*() functions

• Deprecates bson_atomic_*() and bson_thrd-yield() functions

• Deprecates bson_as_json() and bson_array_as_json() functions

Deprecations

• Deprecates mongoc_client_command. Use mongoc_client_command_simple instead.

• Deprecates mongoc_database_command. Use mongoc_database_command_simple instead.

• Deprecates mongoc_collection_command. Use mongoc_collection_command_simple instead.

For more information about this release, see the v1.29 release notes.

New Features

• Adds bson_validate_with_error_and_offset() function

New Features

• Adds support for In-Use Encryption range queries

• mongoc_collection_insert_one includes the insert ID

• Adds new bulk write API mongoc_bulkwrite_t

• Adds serverMonitoringMode URI option

Deprecations

• Deprecates *_hint option. Instead, use the *_server_id option.

  • Deprecates mongoc_bulk_operation_set_hint. Instead, use mongoc_bulk_operation_set_server_id.

  • Deprecates mongoc_bulk_operation_get_hint. Instead, use mongoc_bulk_operation_get_server_id.

  • Deprecates mongoc_cursor_set_hint. Instead, use mongoc_cursor_set_server_id.

  • Deprecates mongoc_cursor_get_hint. Instead, use mongoc_cursor_get_server_id .

• Deprecates ENABLE_SSL=LIBRESSL and mongoc_stream_tls_libressl_new.

• Deprecates ENABLE_SASL=CYRUS and the CYRUS_PLUGIN_PATH_PREFIX option on Windows platforms.

For more information about this release, see the v1.28 release notes.

Fixes

• Fixes handling of malformed extended JSON for special BSON types

Fixes

• Fixes TSan warning

• Fixes C23 compile

Improvements

• Documents expected behavior of command errors in a transaction

Fixes

• Fixes large string handling in bson_append_utf8

Fixes

• Fixes possible build error in environments where bool or _Bool is a macro

Fixes

• Fixes build issues with Visual Studio 2013

Fixes

• Fixes possible crash reading malformed wired protocol message

• Fixes build issues with Visual Studio 2013

Changes

• Introduces changes surrounding the development processes, including new code signing and dependency tracking. There are no behavioral or API changes.

Fixes

• Upgrades bundled Zlib from 1.2.3 to 1.3.1

Fixes

• Fixes parsing of colon in timezone

• Fixes error on failure to initialize a subdocument in bson_iter_visit_all

Fixes

• Closes leftover connections to remote servers

New Features

• Checks environment variable MONGO_EXPERIMENTAL_SRV_PREFER_TCP to prefer TCP over SRV lookup

Fixes

• Fixes large string handling in bson_string_new and bson_string_append

Fixes

• Fixes possible crash when client is configured with an empty password

New Features

• Adds database name to command events mongoc_apm_command_failed_get_database_name and mongoc_apm_command_succeeded_get_database_name

• Supports delegated KMIP protocol for In-Use Encryption

• Enables setting socket timeout per client

Fixes

• Fixes iteration on bson_strfreev

Fixes

• Fixes possible hang if mongoc_gridfs_file_readv is called with a corrupt chunk with incomplete data

• Fixes assert with legacy exhaust cursor protocol when connected to MongoDB server versions earlier than 4.2

Fixes

• Uses aligned allocation for bson_array_builder_t

Fixes

• Fixes 32-bit compile with 64-bit time_t

New Features

• Supports named KMS providers

• Redirects retries in sharded clusters to another mongos if possible

Improvements

• Adds VERSION_CURRENT file in source to ease building

• Considers more errors retryable