mongo-c-driver 1.4.0-beta1

It is my pleasure to announce the beta release of mongo-c-driver 1.4.0.

TLS

The driver can now use the native TLS and crypto functions included in Mac OS X
and Windows. OpenSSL is no longer required for TLS or authentication on Mac or
Windows. By default, OpenSSL is used if available, the default will switch in
version 2.0 to prefer native TLS.

For native TLS on Mac:

./configure --enable-ssl=darwin

For Windows:

cmake "-DENABLE_SSL=WINDOWS" -G "Visual Studio 10 Win64" "-DCMAKE_INSTALL_PREFIX=C:\mongo-c-driver"

All of the TLS implementations now load the native default certificate store,
with OpenSSL on Windows falling back on the Windows native certificate store if
no other can be found.

The "ca_dir" field on mongoc_ssl_opt_t is only supported by OpenSSL. All other
fields, including "pem_file", are supported by all implementations.

A new field, "allow_invalid_hostname", has been added to mongoc_ssl_opt_t and is
preferred over the existing "allow_invalid_certificate" to disable hostname
verification.

The driver now supports the latest OpenSSL 1.1 in addition to past versions.

Application Performance Monitoring

The driver implements the MongoDB Command Monitoring Spec. Applications can
record the duration and other details of every operation the driver performs on
the server. See "Introduction to Application Performance Monitoring" in the
docs.

Error API

New functions mongoc_client_set_error_api and mongoc_client_pool_set_error_api
allow applications to distinguish client and server errors. See the "Error
Reporting" doc.

Unacknowledged Write Results

Unacknowledged writes (writes whose mongoc_write_concern_t "w" value is zero)
now reply with an empty document instead of one with nInserted: 0, nUpdated: 0,
and so on.

Command functions now ignore the read preferences set on a client, database,
or collection. Instead, they use the mongoc_read_prefs_t passed in explicitly,
or default to "primary". This change was made to bring them in line with the
Server Selection Spec. These are the affected functions:

• mongoc_client_command
• mongoc_client_command_simple
• mongoc_database_command
• mongoc_database_command_simple
• mongoc_collection_command
• mongoc_collection_command_simple

On the other hand, the following command-specific helper functions now use the
collection's read preference:

• mongoc_collection_count
• mongoc_collection_stats

New functions to send maxTimeMS or any arbitrary options with findAndModify:

• mongoc_find_and_modify_opts_set_max_time_ms
• mongoc_find_and_modify_opts_append

New function to include a write concern with a generic command function
like mongoc_client_command_simple:

• mongoc_write_concern_append

Public API For Higher-Level Drivers

New functions support language drivers (specifically the PHP and HHVM drivers)
using only the libmongoc public API:

• mongoc_bulk_operation_get_hint
• mongoc_client_command_simple_with_server_id
• mongoc_client_get_server_description
• mongoc_client_get_server_description_by_id
• mongoc_client_get_server_descriptions
• mongoc_client_select_server
• mongoc_cursor_get_limit
• mongoc_cursor_new_from_command_reply
• mongoc_cursor_set_hint
• mongoc_cursor_set_limit
• mongoc_log_trace_disable
• mongoc_log_trace_enable
• mongoc_server_description_ismaster
• mongoc_server_description_round_trip_time
• mongoc_server_description_type
• mongoc_server_descriptions_destroy_all
• mongoc_uri_get_option_as_bool
• mongoc_uri_get_option_as_int32
• mongoc_uri_get_option_as_utf8
• mongoc_uri_option_is_bool
• mongoc_uri_option_is_int32
• mongoc_uri_option_is_utf8
• mongoc_uri_set_auth_source
• mongoc_uri_set_database
• mongoc_uri_set_option_as_bool
• mongoc_uri_set_option_as_int32
• mongoc_uri_set_option_as_utf8
• mongoc_uri_set_password
• mongoc_uri_set_read_concern
• mongoc_uri_set_read_prefs_t
• mongoc_uri_set_username
• mongoc_uri_set_write_concern
• mongoc_write_concern_is_acknowledged
• mongoc_write_concern_is_valid
• mongoc_write_concern_journal_is_set

Now that these public APIs are available, the PHP drivers no longer define the
MONGOC_I_AM_A_DRIVER preprocessor symbol to access private APIs. The symbol is
removed from C Driver headers, and libmongoc-priv.so is no longer installed.

Other Features

• New connection string option "localThresholdMS".
• zSeries and POWER8 platform support.
• Performance enhancements, reduce allocation and copying in command code.
• All man page names now begin with "mongoc_" to avoid install conflicts.
• New function mongoc_gridfs_file_set_id.

Deprecations

Automatically calling mongoc_init and mongoc_cleanup is a GCC-specific feature
that is now deprecated, and will be removed in version 2. The driver should be
built with:

./configure --disable-automatic-init-and-cleanup

Or:

cmake "-DENABLE_AUTOMATIC_INIT_AND_CLEANUP=OFF" -G "Visual Studio 10 Win64" "-DCMAKE_INSTALL_PREFIX=C:\mongo-c-driver"

In this configuration, applications must explicitly init and cleanup libmongoc.

Deprecated functions:

• mongoc_write_concern_get_fsync
• mongoc_write_concern_set_fsync

Notable Bug Fixes

• mongoc_client_get_database_names no longer filters out a replica set
  -- member's "local" database.
• mongoc_client_get_gridfs now ensures the proper indexes on the files and
  -- chunks collections.
• SecondaryPreferred fails if primary matches tags but secondaries don't.
• mongoc_collection_find_and_modify_with_opts can return true on
  -- writeConcernError.
• mongoc_collection_validate doesn't always init "reply".
• The strings referred to by mongoc_ssl_opt_t, like pem_file and ca_file, are
  -- now copied into the client or client pool by mongoc_client_set_ssl_opts or
  -- mongoc_client_pool_set_ssl_opts, and need not be kept valid afterward.
• mongoc_collection_count_with_opts ignored flags and read_prefs.
• minPoolSize of 0 should mean "no minimum".
• mongoc_database_create_collection should always use the primary.
• The GSSAPI properties SERVICE_NAME and CANONICALIZE_HOST_NAME are now
  -- properly parsed from the URI, see the "Authentication" doc for details.
• Comprehensive compatibility with various C standards and compilers.

Acknowledgments

Thanks to everyone who contributed to the development of this release.

• A. Jesse Jiryu Davis
• Hannes Magnusson
• Ian Boros
• Fiona Rowan
• Jeremy Mikola
• Christoph Schwarz
• Mike Lloyd
• Remi Collet
• Jean-Bernard Jansen
• David Hatch
• Derick Rethans
• Brian Samek

Peace,
-- A. Jesse Jiryu Davis

mongo-c-driver 1.3.5

It is my pleasure to announce mongo-c-driver 1.3.5. This release fixes a crash
in mongoc_cleanup when an allocator had been set with bson_mem_set_vtable, and
introduces a configure option MONGOC_NO_AUTOMATIC_GLOBALS which prevents code
built with GCC from automatically calling mongoc_init and mongoc_cleanup when
your code does not.

Thanks to everyone who contributed to the development of this release.

• A. Jesse Jiryu Davis
• Hannes Magnusson

Peace,
-- A. Jesse Jiryu Davis

mongo-c-driver 1.3.4

It is my pleasure to announce the MongoDB C Driver 1.3.4. This release fixes a
security vulnerability: when a mongoc_client_t uses SSL and is disconnected, it
failed to re-verify the server certificate after reconnecting. This flaw affects
single clients, not pooled ones.

Thanks to everyone who contributed to the development of this release.

• A. Jesse Jiryu Davis
• Hannes Magnusson
• Remi Collet

Peace,

-- A. Jesse Jiryu Davis

mongo-c-driver 1.2.4

It is my pleasure to announce the MongoDB C Driver 1.2.4. This release fixes a
security vulnerability: when a mongoc_client_t uses SSL and is disconnected, it
failed to re-verify the server certificate after reconnecting. This flaw affects
single clients, not pooled ones.

Thanks to everyone who contributed to the development of this release.

• A. Jesse Jiryu Davis
• Hannes Magnusson

Peace,

-- A. Jesse Jiryu Davis

mongo-c-driver 1.3.3

It is my pleasure to announce MongoDB C Driver 1.3.3. This fixes a bug where
a slightly-oversized bulk write operation was not split into batches; instead,
it was sent whole to the server, which rejected it.

Peace,

A. Jesse Jiryu Davis

mongo-c-driver 1.3.2

It is my pleasure to announce MongoDB C Driver 1.3.2. This is a bugfix release:

• A socket is properly discarded after a network error from a command.
• mongoc_database_get_collection now copies the database's read preferences,
  read concern, and write concern, instead of copying the client's.
• mongoc_cursor_t's private struct now allows a negative limit.

Thanks to everyone who contributed to this release.

• A. Jesse Jiryu Davis
• Jeremy Mikola
• Hannes Magnusson

Peace,
A. Jesse Jiryu Davis

mongo-c-driver 1.3.1

It is my pleasure to announce MongoDB C Driver 1.3.1. This is a bugfix release:

• mongoc_client_get_gridfs now copies the client's read preferences, read
  concern, and write concern to the newly created mongoc_gridfs_t. Before
  this fix, GridFS operations were always executed with the default config:
  data was read from the primary, with the read concern level "local", and
  written with write concern "acknowledged". Now, if you have configured any
  of these options on the mongoc_client_t, they are respected by the
  mongoc_gridfs_t.
• CMakeLists.txt now includes and installs the pkg-config files.

Thanks to everyone who contributed to this release.

• A. Jesse Jiryu Davis
• Hannes Magnusson
• Christopher Wang
• Jean-Bernard Jansen
• Jeremy Mikola
• Jeroen Ooms

Peace,

A. Jesse Jiryu Davis

mongo-c-driver 1.3.0

It is my pleasure to announce to you the release of the MongoDB C Driver 1.3.0.

Changes since the the release candidate 1.3.0-rc0:

• Fix a cursor bug introduced on big-endian platforms in 1.3.0-beta0.
• Improve documentation for mongoc_host_list_t.
• Move private mongoc_host_list_t functions from public header.
• Refactor the build system to declare library version in one place.

All new features and changes since the previous stable release, 1.2.1:

• If the driver is compiled without SSL support but a URI with "ssl=true"
  is passed to mongoc_client_new, mongoc_client_new_from_uri, or
  mongoc_client_pool_new, the function logs an error and returns NULL. Before,
  the driver would attempt a non-SSL connection.
• mongoc_collection_find_and_modify will now apply the mongoc_collection_t's
  write_concern_t when talking to MongoDB 3.2.
• Support for MongoDB 3.2's "readConcern" feature for queries, counts, and
  aggregations. The option "readConcernLevel" is now accepted in the MongoDB
  URI. New struct mongoc_read_concern_t, and functions operating on it:
  • mongoc_client_get_read_concern
  • mongoc_client_set_read_concern
  • mongoc_database_get_read_concern
  • mongoc_database_set_read_concern
  • mongoc_collection_get_read_concern
  • mongoc_collection_set_read_concern
  • mongoc_read_concern_copy
  • mongoc_read_concern_destroy
  • mongoc_read_concern_get_level
  • mongoc_read_concern_new
  • mongoc_read_concern_set_level
  • mongoc_uri_get_read_concern
• Support for MongoDB 3.2's "bypassDocumentValidation" option for writes.
• New struct mongoc_bulk_write_flags_t and related functions:
  • mongoc_bulk_operation_set_bypass_document_validation
• New struct mongoc_find_and_modify_opts_t and related functions:
  • mongoc_find_and_modify_opts_new
  • mongoc_find_and_modify_opts_destroy
  • mongoc_find_and_modify_opts_set_sort
  • mongoc_find_and_modify_opts_set_update
  • mongoc_find_and_modify_opts_set_fields
  • mongoc_find_and_modify_opts_set_flags
  • mongoc_find_and_modify_opts_set_bypass_document_validation
  • mongoc_collection_find_and_modify_with_opts
• New functions to copy database and collection handles:
  • mongoc_collection_copy
  • mongoc_database_copy
• Support for MongoDB 3.2 wire protocol: use commands in place of OP_QUERY,
  OP_GETMORE, and OP_KILLCURSORS messages.
• To explain a query plan with MongoDB 3.2, you must now call the "explain"
  command, instead of including the "$explain" key in a mongoc_collection_find
  query. See the mongoc_collection_find documentation page for details.
• Configurable wait time on tailable cursors with MongoDB 3.2:
  • mongoc_cursor_get_max_await_time_ms
  • mongoc_cursor_set_max_await_time_ms
• Use electionId to detect a stale replica set primary during a network split.
• Disconnect from replica set members whose "me" field does not match the
  connection address.
• The client side matching feature, mongoc_matcher_t and related functions,
  are deprecated and scheduled for removal in version 2.0.
• New CMake options ENABLE_SSL, ENABLE_SASL, ENABLE_TESTS, and ENABLE_EXAMPLES.
• Use constant-time comparison when verifying credentials.
• Combine environment's CFLAGS with configure options when building.
• Improved man page output and "whatis" entries.

There are extensive bugfixes and improvements in GridFS since 1.2.1, including:

• Handle seeking, reading, and writing past the end of a GridFS file.
• If a GridFS chunk is missing, mongoc_gridfs_file_readv sets file->error to
  domain MONGOC_ERROR_GRIDFS and a new code MONGOC_ERROR_GRIDFS_CHUNK_MISSING.
• Optimization for long seeks forward with mongoc_gridfs_file_seek.

Other fixes since 1.2.1:

• Memory leaks in mongoc_database_has_collection and mongoc_cursor_next.
• Report writeConcern failures from findAndModify and from legacy writes.
• Memory leak in mongoc_database_find_collections.
• Set OP_QUERY's nToReturn from the provided limit.
• Fix compiler warnings and errors, especially with Visual Studio 2015,
  GCC 4.8, and IBM XL C.
• Bugs and typos in tutorial examples.

Thanks to everyone who contributed to this release candidate.

• A. Jesse Jiryu Davis
• Hannes Magnusson
• Kyle Suarez
• Jose Sebastian Battig
• Matt Cotter
• Claudio Canella
• alexeyvo
• Christopher Wang
• Flavio Medeiros
• Iago Rubio
• Jeremy Mikola
• Victor Leschuk
• Jason Carey

Peace,

A. Jesse Jiryu Davis

mongo-c-driver 1.2.3

This release fixes the CMake build, which I broke in the 1.2.2 release.

-- A. Jesse Jiryu Davis

mongo-c-driver 1.3.0-rc0

It is my pleasure to announce to you the first release candidate of MongoDB C
driver 1.3.0. It includes additive ABI changes and bugfixes, and support for
the upcoming MongoDB 3.2. It is compatible with MongoDB 2.4 and later.

New features and changes since 1.3.0-beta0:

• If the driver is compiled without SSL support but a URI with "ssl=true"
  is passed to mongoc_client_new, mongoc_client_new_from_uri, or
  mongoc_client_pool_new, the function logs an error and returns NULL. Before,
  the driver would attempt a non-SSL connection.
• New functions to copy database and collection handles:
  • mongoc_collection_copy
  • mongoc_database_copy
• If a GridFS chunk is missing, mongoc_gridfs_file_readv sets file->error to
  domain MONGOC_ERROR_GRIDFS and a new code MONGOC_ERROR_GRIDFS_CHUNK_MISSING.
• Use electionId to detect a stale replica set primary during a network split.
• Disconnect from replica set members whose "me" field does not match the
  connection address.
• The client side matching feature, mongoc_matcher_t and related functions,
  are deprecated and scheduled for removal in version 2.0.
• New CMake options ENABLE_SSL, ENABLE_SASL, ENABLE_TESTS, and ENABLE_EXAMPLES.
• The build system is refactored to declare the current version and latest
  release in one place.

Other fixes:

• Memory leaks in mongoc_database_has_collection and mongoc_cursor_next.
• Report writeConcern failures from findAndModify and from legacy writes.

Thanks to everyone who contributed to this release candidate.

• A. Jesse Jiryu Davis
• Hannes Magnusson
• Matt Cotter
• Claudio Canella
• Victor Leschuk
• Flavio Medeiros
• Christopher Wang

Peace,

A. Jesse Jiryu Davis