mongo-c-driver 2.1.2

Announcing 2.1.2 of libbson and libmongoc, the libraries constituting the MongoDB C Driver.

libbson

No changes since 2.1.1. Version incremented to match the libmongoc version.

libmongoc

Fixes

• Fix write command options handling.

Links:

• All the issues resolved in 2.1.2
• Documentation

Thanks to everyone who contributed to this release.

• Ezra Chung
• Kevin Albertson

mongo-c-driver 1.30.6

Announcing 1.30.6 of libbson and libmongoc, the libraries constituting the MongoDB C Driver.

libbson

No changes since 1.30.5. Version incremented to match the libmongoc version.

libmongoc

Fixes:

• Fix write command options handling.

Links:

• All the issues resolved in 1.30.6
• Documentation

Thanks to everyone who contributed to this release.

• Ezra Chung
• Kevin Albertson

mongo-c-driver 2.1.1

Announcing 2.1.1 of libbson and libmongoc, the libraries constituting the MongoDB C Driver.

libbson

No changes since 2.1.0. Version incremented to match the libmongoc version.

libmongoc

Fixes

• Do not propagate -fPIC in CMake targets.
• Apply write command behavior to mongoc_collection_create_indexes_with_opts.
• Omit saslSupportedMechs in single-threaded monitoring commands.

Links:

• All the issues resolved in 2.1.1
• Documentation

Thanks to everyone who contributed to this release.

• Julia Garland
• Roberto C. Sánchez

mongo-c-driver 2.1.0

Announcing 2.1.0 of libbson and libmongoc, the libraries constituting the MongoDB C Driver.

libbson

Fixes

• The uninstall script for Windows is fixed so it no longer "succeeds" with a non-zero %ERRORLABEL% value.
• The uninstall script for non-Windows environments now calls find "$dir" -maxdepth 1 instead of ls --almost-all "$dir" when detecting non-empty directories to fix macOS compatibility.

Changed

• The CMake project now sets a CMake policy max version of 4.0 (previously unset).

Removed

• Support for Debian 9 and Debian 10.

libmongoc

Fixes

• Windows Secure Channel is fixed to support newer signatures to verify client certificates.
• Replace use of rand() with thread-safe alternatives.
• The uninstall script for Windows is fixed so it no longer "succeeds" with a non-zero %ERRORLABEL% value.
• The uninstall script for non-Windows environments now calls find "$dir" -maxdepth 1 instead of ls --almost-all "$dir" when detecting non-empty directories to fix macOS compatibility.

Improvements

• Remove unhelpful long-lived buffers to reduce memory usage.
• Improve error messages produced by Windows APIs.

Notes

• The minimum supported MongoDB Server version is raised from 4.0 to 4.2. This is in accordance with MongoDB Software Lifecycle Schedules.

Changes

• The CMake project now sets a CMake policy max version of 4.0 (previously unset).

Removed

• Support for Debian 9 and Debian 10.

Links:

• All the issues resolved in 2.1.0
• Documentation

Thanks to everyone who contributed to this release.

• Kevin Albertson
• Ezra Chung
• Colby Pike
• Adrian Dole
• Azat Khuzhin
• Jeroen Ooms
• Roberto C. Sánchez
• Micah Scott

mongo-c-driver 2.0.2

Announcing 2.0.2 of libbson and libmongoc, the libraries constituting the MongoDB C Driver.

libbson

Fixes:

• Various fixes have been applied to the bson_validate family of functions,
  with some minor behavioral changes.
  • Previously accepted invalid UTF-8 will be rejected when BSON_VALIDATE_UTF8
    is specified.
  • The scope document in a deprecated "code with scope" element is now
    validated with a fixed set of rules and is treated as an opaque JavaScript
    object.
  • A document nesting limit is now enforced during validation.

libmongoc

Fixes:

• Fix message of bson_strerror_r on Windows.
• Fix memory leaks with Windows Secure Channel.
• Fix loading PKCS#8 RSA keys with Windows Secure Channel.

Links:

• All the issues resolved in 2.0.2
• Documentation

Thanks to everyone who contributed to this release.

• Kevin Albertson
• Colby Pike

mongo-c-driver 1.30.5

Announcing 1.30.5 of libbson and libmongoc, the libraries constituting the MongoDB C Driver.

libbson

Fixes:

• Various fixes have been applied to the bson_validate family of functions,
  with some minor behavioral changes.
  • Previously accepted invalid UTF-8 will be rejected when BSON_VALIDATE_UTF8
    is specified.
  • The scope document in a deprecated "code with scope" element is now
    validated with a fixed set of rules and is treated as an opaque JavaScript
    object.
  • A document nesting limit is now enforced during validation.

libmongoc

Fixes:

• Fix message of bson_strerror_r on Windows.
• Fix memory leaks with Windows Secure Channel.
• Fix loading PKCS#8 RSA keys with Windows Secure Channel.

Links:

• All the issues resolved in 1.30.5
• Documentation

Thanks to everyone who contributed to this release.

• Kevin Albertson
• Colby Pike

mongo-c-driver 2.0.1

Announcing 2.0.1 of libbson and libmongoc, the libraries constituting the MongoDB C Driver.

libbson

Fixes:

• Fix CMake configure error on macOS with CMake 4.

libmongoc

Fixes:

• Fix username handling for MONGODB-X509 authentication when C driver is configured to use Secure Transport (CMake option ENABLE_SSL=DARWIN) or Secure Channel (CMake option ENABLE_SSL=WINDOWS).
• Do not set empty partial result on client error for mongoc_bulkwrite_execute.

Links:

• All the issues resolved in 2.0.1
• Documentation

Thanks to everyone who contributed to this release.

• Kevin Albertson

mongo-c-driver 1.30.4

Announcing 1.30.4 of libbson and libmongoc, the libraries constituting the MongoDB C Driver.

libbson

No changes since 1.30.3. Version incremented to match the libmongoc version.

libmongoc

Fixes:

• Fix username handling for MONGODB-X509 authentication when C driver is configured to use Secure Transport (CMake option ENABLE_SSL=DARWIN) or Secure Channel (CMake option ENABLE_SSL=WINDOWS).
• Do not set empty partial result on client error for mongoc_bulkwrite_execute.

Links:

• All the issues resolved in 1.30.4
• Documentation

Thanks to everyone who contributed to this release.

• Kevin Albertson

mongo-c-driver 1.30.3

Announcing 1.30.3 of libbson and libmongoc, the libraries constituting the MongoDB C Driver.

libbson

Fixes:

• Fix CMake configure error on macOS with CMake 4.

New Features:

• In anticipation of the 2.0 release of mongo-c-driver, new CMake packages and
  imported targets have been defined (for both bson and mongoc). To import
  bson with the new names, call find_package for the bson package. The new
  imported targets are named bson::static, bson::shared, and bson::bson
  (which points to either the static or the shared library, depending on an
  import-time configuration option).

  The new package and target names will remain unchanged when upgrading to the
  2.0 release, allowing consumers to support both major versions without
  modifying their CMake project. The current imported target names will be
  removed from the 2.0 release, and should not be used for
  forward-compatibility.

libmongoc

New Features:

• In anticipation of the 2.0 release of mongo-c-driver, new CMake packages and
  imported targets have been defined (for both bson and mongoc). To import
  mongoc with the new names, call find_package for the mongoc package. The
  new imported targets are named mongoc::static, mongoc::shared, and
  mongoc::mongoc (which points to either the static or the shared library,
  depending on an import-time configuration option).

  The new package and target names will remain unchanged when upgrading to the
  2.0 release, allowing consumers to support both major versions without
  modifying their CMake project. The current imported target names will be
  removed from the 2.0 release, and should not be used for
  forward-compatibility.

  Programs that link to BSON libraries directly should also use the new target
  names bson::static, bson::shared, or bson::bson.

Links:

• All the issues resolved in 1.30.3
• Documentation

Thanks to everyone who contributed to this release.

• Kevin Albertson
• Ezra Chung
• Colby Pike

mongo-c-driver 2.0.0

Announcing 2.0.0 of libbson and libmongoc, the libraries constituting the MongoDB C Driver.

libbson

New Features

• Add support for BSON Binary Vector.

Changes

• BSON_ERROR_BUFFER_SIZE is reduced from 504 to 503 to reserve the final byte for internal use.
  • The data layout of bson_error_t remains otherwise unchanged: the size is still 512 bytes and the offset of the .code, .domain, and .message data members remain unchanged.
• The pkg-config files libbson-1.0 and libbson-static-1.0 have been renamed to bson2, and bson2-static, respectively.

CMake Packages and Imported Targets

The bson-1.0 CMake package has been removed. Instead, use or bson, and
specify a version or version range to be imported:

find_package(bson 1.30...2.0)

The new package imports different target names:

• mongo::bson_static → bson::static
• mongo::bson_shared → bson::shared
• The target bson::bson is a shim target that points to either the shared library or the static library.

Removals

• bson_as_json and bson_array_as_json are removed due to producing non-portable Legacy Extended JSON. Prefer Canonical Extended JSON or Relaxed Extended JSON for portability. To continue using Legacy Extended JSON, use bson_as_legacy_extended_json and bson_array_as_legacy_extended_json.
• Compiling with BSON_MEMCHECK defined now has no effect.
• Remove deprecated integral comparison interfaces: bson_in_range_* and bson_cmp_*.
• Remove deprecated atomic and threading interfaces: bson_atomic_* and bson_thrd_yield.
• The deprecated ENABLE_EXTRA_ALIGNMENT CMake option is removed.
  • bson_t and bson_iter_t are now aligned to the size of a pointer instead of 128.
  • bson_error_t, bson_value_t, and bson_visitor_t are now aligned to the size of a pointer instead of 8.
  • BSON_ALIGNED_BEGIN and BSON_ALIGNED_END now unconditionally apply their requested alignment.
• Remove deprecated bson_copy_to_excluding. Use bson_copy_to_excluding_noinit instead.

libmongoc

New Features

• Support aggregate operations with $lookup stage for In-Use Encryption.

Notes

• In a future minor release the minimum supported MongoDB Server version will be raised from 4.0 to 4.2. This is in accordance with MongoDB Software Lifecycle Schedules.
• Raise required version of libmongocrypt to 1.13.0 to support In-Use Encryption (corresponds to the CMake option: ENABLE_CLIENT_SIDE_ENCRYPTION).

Changes

• Passing batchSize:0 as an option to mongoc_client_watch, mongoc_database_watch, or mongoc_collection_watch
  now applies batchSize:0 to the aggregate command. Useful to request an immediate cursor. Previously the value
  was ignored.
• bson_oid_init_sequence is removed. Use bson_oid_init instead.
• mongoc_server_description_host changes the return type from mongoc_host_list_t * to const mongoc_host_list_t *.
• URI authentication credentials validation (only applicable during creation of a new mongoc_uri_t object from a connection string):
  • The requirement that a username is non-empty when specified is now enforced regardless of authentication mechanism.
  • Username and password specification requirements are now validated and returns a client error for the specified authentication mechanism.
    • e.g. it is a client error to not specify a username or a password for SCRAM-SHA-1, SCRAM-SHA-256, and PLAIN.
    • e.g. it is a client error to specify a password for MONGODB-X509.
    • e.g. it is a client error to specify a username or a password without the other for MONGODB-AWS.
  • authSource is now correctly defaulted to "$external" for MONGODB-AWS (instead of the database name or "admin").
  • authMechanism is now validated and returns a client error for invalid or unsupported values.
  • authMechanismProperties is now validated and returns a client error for invalid or unsupported properties for the specified authentication mechanism.
  • authMechanismProperties now correctly supports ':' within property values.
    • Old behavior: authMechanismProperties=A:B,C:D:E,F:G is parsed as {'A': 'B', 'C': 'D:E,F:G'}.
    • New behavior: authMechanismProperties=A:B,C:D:E,F:G is parsed as {'A': 'B': 'C': 'D:E', 'F': 'G'}.
• Calling mongoc_bulk_operation_execute on the same mongoc_bulk_operation_t repeatedly is an error. Previously this was only discouraged in documentation.
• Consistently apply __cdecl calling convention to function declarations in public API. Intended to support consumers building their code using a different default calling convention with MSVC. The mongoc and bson libraries only support being built with the __cdecl default calling convention.
• mongoc_client_set_ssl_opts now ignores a pooled mongoc_client_t and logs an error. Use mongoc_client_pool_set_ssl_opts to set TLS options on a mongoc_client_pool_t before popping any clients.
• mongoc_client_set_ssl_stream_initiator now ignores a pooled mongoc_client_t and logs an error.
• The pkg-config files libmongoc-1.0, libmongoc-static-1.0, libbson-1.0, and libbson-static-1.0 have been renamed to mongoc2, mongoc2-static, bson2, and bson2-static, respectively.

CMake Packages and Imported Targets

The mongoc-1.0 (and bson-1.0) CMake packages have been removed. Instead, use
mongoc or bson, and specify a version or version range to be imported:

find_package(mongoc 1.30...2.0)

The new packages import different target names:

• mongo::mongoc_static → mongoc::static
• mongo::mongoc_shared → mongoc::shared
• The target mongoc::mongoc is a shim target that points to either the shared library or the static library.

The BSON library has had similar name changes.

Removals

• The bson_md5_t struct and associated API is removed.
• The client side matching feature, mongoc_matcher_t and related functions are removed.
• mongoc_server_description_ismaster is removed. Use the equivalent mongoc_server_description_hello instead.
• MONGOC_QUERY_SLAVE_OK is removed. Use the equivalent MONGOC_QUERY_SECONDARY_OK instead.
• MONGOC_URI_SLAVEOK is removed. It was unused.
• mongoc_client_command, mongoc_database_command, and mongoc_collection_command are removed. Use mongoc_client_command_simple, mongoc_database_command_simple, and mongoc_collection_command_simple instead.
• MONGOC_URI_MAXIDLETIMEMS and MONGOC_URI_WAITQUEUEMULTIPLE are removed. They were unused.
• bson_string_t and associated functions are removed.
• Support for ENABLE_SASL=CYRUS on Windows is removed. Use ENABLE_SASL=SSPI or ENABLE_SASL=OFF instead.
  • The associated Windows-only option CYRUS_PLUGIN_PATH_PREFIX is removed.
• Support for the deprecated minPoolSize URI option is removed along with associated API: MONGOC_URI_MINPOOLSIZE and mongoc_client_pool_min_size.
• Support for LibreSSL (the CMake option ENABLE_SSL=LIBRESSL) is removed. Associated API is removed (MONGOC_ENABLE_SSL_LIBRESSL and mongoc_stream_tls_libressl_new).
• MONGOC_WRITE_CONCERN_W_ERRORS_IGNORED (value -1) is removed. Use MONGOC_WRITE_CONCERN_W_UNACKNOWLEDGED (value 0) which is handled equivalently. If specified in a URI, replace: mongodb://host/?w=-1 with mongodb://host/?w=0.
• The deprecated CMake option ENABLE_AUTOMATIC_INIT_AND_CLEANUP is removed. See Initialization and cleanup for expected use of mongoc_init() and mongoc_cleanup().
• mongoc_client_get_database_names is removed. Use mongoc_client_get_database_names_with_opts instead.
• mongoc_client_find_databases is removed. Use mongoc_client_find_databases_with_opts instead.
• mongoc_client_get_max_message_size is removed.
• mongoc_client_get_max_bson_size is removed.
• Deprecated mongoc_apm_command_*_get_server_connection_id functions are removed. Use mongoc_apm_command_*_get_server_connection_id_int64 instead.
• Deprecated index management API is removed:
  • mongoc_collection_create_index_with_opts, mongoc_collection_create_index, and mongoc_collection_ensure_index are removed. Use mongoc_collection_create_indexes_with_opts instead.
  • mongoc_index_opt_t, mongoc_index_opt_geo_t mongoc_index_opt_wt_t are removed. Pass options using bson_t to mongoc_collection_create_indexes_with_opts instead.
  • mongoc_collection_find_indexes is removed. Use mongoc_collection_find_indexes_with_opts instead.
  • See MongoDB documentation for working with indexes.
• Deprecated cursor API is removed:
  • mongoc_cursor_is_alive is removed. Use the equivalent mongoc_cursor_more instead.
  • mongoc_cursor_set_hint is removed. Use the equivalent mongoc_cursor_set_server_id instead.
  • mongoc_cursor_get_hint is removed. Use the equivalent mongoc_cursor_get_server_id instead.
  • mongoc_cursor_new_from_command_reply is removed. Use mongoc_cursor_new_from_command_reply_with_opts instead.
• Deprecated CRUD API is removed:
  • mongoc_collection_save is removed. Use mongoc_collection_insert_one or mongoc_collection_replace_one instead.
  • mongoc_collection_delete is removed. Use mongoc_collection_delete_one or mongoc_collection_delete_many instead.
  • mongoc_delete_flags_t and mongoc_reply_flags_t are removed.
  • mongoc_collection_find is removed. Use mongoc_collection_find_with_opts instead.
  • mongoc_collection_insert_bulk is removed. Use mongoc_collection_insert_many instead.
  • mongoc_collection_create_bulk_operation is removed. Use `mongoc_collection_create_bulk_operation_wi...