forked from mongodb/mongo-c-driver
-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathNEWS
4034 lines (2899 loc) · 132 KB
/
NEWS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
libmongoc 1.x (Unreleased)
==========================
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`.
Unreleased (2.0.0)
==================
## 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.
## 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](https://mongoc.org/libmongoc/1.30.2/init-cleanup.html) 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](https://www.mongodb.com/docs/languages/c/c-driver/current/indexes/) 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_with_opts` instead.
* `mongoc_collection_get_last_error` is removed. To get results from write operations, instead use:
* `mongoc_collection_update_one`
* `mongoc_collection_update_many`
* `mongoc_collection_replace_one`
* `mongoc_collection_delete_one`
* `mongoc_collection_delete_many`
* `mongoc_collection_insert_one`
* `mongoc_collection_insert_many`
* `mongoc_bulkwrite_t`
* `mongoc_bulk_operation_t`
* `mongoc_bulk_operation_delete` is removed. Use `mongoc_bulk_operation_remove()` instead.
* `mongoc_bulk_operation_delete_one` is removed. Use `mongoc_bulk_operation_remove_one` instead.
* `mongoc_bulk_operation_get_hint` is removed. Use `mongoc_bulk_operation_get_server_id` instead.
* `mongoc_bulk_operation_set_hint` is removed. Use `mongoc_bulk_operation_set_server_id` instead.
* `mongoc_collection_count` and `mongoc_collection_count_with_opts` are removed. Use `mongoc_collection_count_documents` or `mongoc_collection_estimated_document_count` instead.
* `mongoc_collection_stats` is removed. Use the [$collStats aggregation pipeline stage](https://www.mongodb.com/docs/manual/reference/operator/aggregation/collStats/) with `mongoc_collection_aggregate` instead.
* `mongoc_collection_validate` is removed. Run the [validate](https://www.mongodb.com/docs/manual/reference/command/validate/) command directly with `mongoc_client_read_command_with_opts` instead.
* Deprecated API for `mongoc_database_t` is removed:
* `mongoc_database_find_collections` is removed. Use `mongoc_database_find_collections_with_opts` instead.
* `mongoc_database_get_collection_names` is removed. Use `mongoc_database_get_collection_names_with_opts` instead.
* Deprecated GridFS API has been removed:
* `mongoc_gridfs_find` is removed. Use `mongoc_gridfs_find_with_opts` instead.
* `mongoc_gridfs_find_one` is removed. Use `mongoc_gridfs_find_one_with_opts` instead.
* Deprecated TLS stream API is removed:
* `mongoc_stream_tls_do_handshake` is removed. Use `mongoc_stream_tls_handshake` instead.
* `mongoc_stream_tls_check_cert` is removed. Use `mongoc_stream_tls_handshake` instead.
* `mongoc_stream_tls_new` is removed. Use `mongoc_stream_tls_new_with_hostname` instead.
* Deprecated URI API has been removed:
* `mongoc_uri_get_service` is removed. Use `mongoc_uri_get_srv_hostname` instead.
* `mongoc_uri_get_read_prefs` is removed. Use `mongoc_uri_get_read_prefs_t` instead.
* `mongoc_uri_get_ssl` is removed. Use `mongoc_uri_get_tls` instead.
* Deprecated write concern API is removed:
* `mongoc_write_concern_get_fsync` is removed. Use `mongoc_write_concern_get_journal` instead.
* `mongoc_write_concern_set_fsync` is removed. Use `mongoc_write_concern_set_journal` instead.
### Forwarding headers (`#include <bson.h>` and `#include <mongoc.h>`)
The compatibility "forwarding" headers have been removed (previously added in 1.13.0). This means it is no longer valid to include the literal header names `mongoc.h` or `bson.h` directly:
```c
#include <bson.h> // No longer provided!
#include <mongoc.h> // No longer provided!
```
Instead, the names must be prefixed with the parent directory: `mongoc/mongoc.h` and `bson/bson.h`:
```c
#include <bson/bson.h>
#include <mongoc/mongoc.h>
```
### `mongoc_client_kill_cursor`
`mongoc_client_kill_cursor` is removed. It did not accept a server identifier. It was only reliable when connected to a single server.
Sending [killCursors](https://www.mongodb.com/docs/manual/reference/command/killCursors/) is not typically needed. `mongoc_cursor_t` manages the cursor lifetime. If needed, use a generic command helper to manually send a `killCursors` command:
```c
bson_t *cmd = BCON_NEW ("killCursors", "coll", "cursors", "[", BCON_INT64 (cursor_id), "]");
bool ok = mongoc_client_command_simple_with_server_id (client, "db", cmd, NULL, server_id, NULL, &error);
if (!ok) {
printf ("Failed to send 'killCursors': %s\n", error.message);
}
bson_destroy (cmd);
```
### `mongoc_client_get_server_status`
`mongoc_client_get_server_status` is removed. Use a command helper to run the "serverStatus" command instead:
```c
bson_t *cmd = BCON_NEW("serverStatus", BCON_INT32(1));
if (!mongoc_client_command_simple(client, "db", cmd, NULL, &reply, &error)) {
printf("Failed to send 'serverStatus': %s\n", error.message);
} else {
// TODO: use `reply`
}
bson_destroy(&reply);
bson_destroy(cmd);
```
libmongoc 1.30.2
================
Fixes:
* Fix C23 build on Windows.
Thanks to everyone who contributed to the development of this release.
* Jeroen Ooms
libmongoc 1.30.1
================
No changes since 1.30.0. Version incremented to match the libbson version.
libmongoc 1.30.0
================
Fixes:
* Additional APM events required by the SDAM specification will now be delivered:
* Servers that have seen `server_opening` will now see a `server_closed` prior to `topology_closed`.
* Before `topology_closed`, a `topology_changed` event will transition to `Unknown` topology type.
* Fix reporting insert IDs in `mongoc_bulkwrite_t` when verbose results requested.
Improvements:
* Improve performance of `mongoc_server_description_new_copy`.
New Features:
* Add support for structured logging.
* See `mongoc_client_set_structured_log_opts` and `mongoc_client_pool_set_structured_log_opts`.
* Add option to configure cache lifetime of In-Use Encryption data encryption keys.
* See `mongoc_auto_encryption_opts_set_key_expiration` and `mongoc_client_encryption_opts_set_key_expiration`.
* Support `sort` option for update and replace operations.
* Support constructing a `mongoc_bulkwrite_t` without a client.
* See `mongoc_bulkwrite_new` and `mongoc_bulkwrite_set_client`.
Deprecated:
* Support for Debian 9 and Debian 10.
Thanks to everyone who contributed to the development of this release.
* Kevin Albertson
* Micah Scott
* Jeremy Mikola
* Adrian Dole
* Ezra Chung
* Antony Polukhin
* Jeroen Ooms
libmongoc 1.29.2
================
Fixes:
* Rename `set_error` function to avoid symbol conflicts.
* Fix Windows ARM 64 build.
* Fix comparison of uninitialized bytes.
* Fix format specifier on macOS.
Notes:
* Windows ARM 64 is not-yet officially tested or supported. Support is community driven.
Thanks to everyone who contributed to the development of this release.
* Adrian Dole
* Christian Schmitz
* Antony Polukhin
* Kevin Albertson
libmongoc 1.29.1
================
Fixes:
* Assert session is consistent with client in `mongoc_bulkwrite_set_session`.
Thanks to everyone who contributed to the development of this release.
* Jeremy Mikola
* Kevin Albertson
libmongoc 1.29.0
================
Improvements:
* Retry KMS requests on transient errors.
Platform Support:
* Support for Visual Studio 2013 is dropped.
Deprecated:
* `mongoc_client_command` is deprecated and planned for removal in a future release. Use `mongoc_client_command_simple` instead.
* `mongoc_database_command` is deprecated and planned for removal in a future release. Use `mongoc_database_command_simple` instead.
* `mongoc_collection_command` is deprecated and planned for removal in a future release. Use `mongoc_collection_command_simple` instead.
Notes:
* Raise required version of libmongocrypt to 1.12.0 to support In-Use Encryption (corresponds to the CMake option: `ENABLE_CLIENT_SIDE_ENCRYPTION`).
* A future minor release will raise the minimum supported MongoDB Server version from 4.0 to 4.2. This is in accordance with [MongoDB Software Lifecycle Schedules](https://www.mongodb.com/legal/support-policy/lifecycles). **Support for MongoDB Server 4.0 will be dropped in a future release!**
Thanks to everyone who contributed to the development of this release.
* Kevin Albertson
* Ezra Chung
* Micah Scott
* Adrian Dole
* Andreas Braun
* Joshua Siegel
libmongoc 1.28.1
================
Fixes:
* Do not return result in `mongoc_bulkwritereturn_t` if there are no known successful writes.
* Validate lengths in ill-formed server responses.
* Do not override read preference when using aggregate with `$out/$merge` with unscanned servers.
* Remove unexpected warning if `authSource` in TXT record is overriden by URI option.
* Fix crash when non-existent CA file configured with OpenSSL.
libmongoc 1.28.0
================
New features:
* Support In-Use Encryption range queries.
* Include insert ID on result of `mongoc_collection_insert_one`.
* Add new bulk write API `mongoc_bulkwrite_t`. Requires MongoDB 8.0. Reduces round-trips for mixed writes.
- Add `serverMonitoringMode` URI option.
Improvements:
* Improve performance of OpenSSL connection creation.
* Improve performance when trace logging is configured (`ENABLE_TRACING=ON`) but disabled at runtime.
* Prefer FIPS compliant functions for SCRAM-SHA-256 key derivation.
* Remove required slash to delimit options in MongoDB URI (e.g. `mongodb://example.com?w=1` parses the same as `mongodb://example.com/?w=1`).
* Include topology description in server selection timeout errors.
Notes:
* Bump minimum wire protocol version from 6 (MongoDB 3.6) to 7 (MongoDB 4.0).
* Raise required version of libmongocrypt to 1.11.0 to support In-Use Encryption (corresponds to the CMake option: `ENABLE_CLIENT_SIDE_ENCRYPTION`).
Build Configuration:
* Remove automatic ccache detection and usage (CCache.cmake).
* Set [`CMAKE_<LANG>_COMPILER_LAUNCHER`](https://cmake.org/cmake/help/latest/envvar/CMAKE_LANG_COMPILER_LAUNCHER.html) to build with ccache.
* Remove `MONGO_USE_CCACHE` (no longer applicable; see above).
Changed:
* Test and example targets are excluded from the `ALL` target.
* All test targets can be built using the `mongo_c_driver_tests` target.
* All example targets can be built using the `mongo_c_driver_examples` target.
* Use `#!/usr/bin/env bash` instead of `#!/bin/sh` in uninstall script generated by `ENABLE_UNINSTALL=ON`.
Deprecated:
* Use of `*_hint` functions is deprecated in favor of more aptly named `*_server_id` functions:
* `mongoc_bulk_operation_set_hint` is deprecated for `mongoc_bulk_operation_set_server_id`
* `mongoc_bulk_operation_get_hint` is deprecated for `mongoc_bulk_operation_get_server_id`
* `mongoc_cursor_set_hint` is deprecated for `mongoc_cursor_set_server_id`
* `mongoc_cursor_get_hint` is deprecated for `mongoc_cursor_get_server_id`
* A future minor release plans to drop support for Visual Studio 2013.
* `ENABLE_SSL=LIBRESSL` is deprecated along with `mongoc_stream_tls_libressl_new`. Support for LibreSSL may be dropped in a future major release.
* `ENABLE_SASL=CYRUS` on Windows platforms is deprecated. Support for `ENABLE_SASL=CYRUS` on Windows may be dropped in a future major release.
* The associated Windows-only option `CYRUS_PLUGIN_PATH_PREFIX` is deprecated.
libmongoc 1.27.6
================
Fixes:
* Fix TSan warning.
* Fix C23 compile.
Improvements:
* Document expected behavior of command errors in a transaction.
Thanks to everyone who contributed to the development of this release.
* Adrian Dole
* Ezra Chung
* Joshua Siegel
* Kevin Albertson
libmongoc 1.27.5
================
Fixes:
* Fix possible build error in environments where `bool` or `_Bool` is a macro.
Thanks to everyone who contributed to the development of this release.
* Kevin Albertson
libmongoc 1.27.4
================
Fixes:
* Fix possible crash reading malformed wire protocol message.
* Fix build with Visual Studio 2013.
Thanks to everyone who contributed to the development of this release.
* Ezra Chung
* Kevin Albertson
libmongoc 1.27.3
================
Notes:
* This patch release introduces changes surrounding the development processes,
including new code signing and dependency tracking. There are no behavioral
or API changes.
Fixes:
* Upgraded bundled Zlib from 1.2.3 to 1.3.1
Thanks to everyone who contributed to the development of this release.
* Colby Pike
libmongoc 1.27.2
================
Fixes:
* Close leftover connections to removed servers.
New features:
* Check environment variable `MONGOC_EXPERIMENTAL_SRV_PREFER_TCP` to prefer TCP for SRV lookup.
Thanks to everyone who contributed to the development of this release.
* Kevin Albertson
libmongoc 1.27.1
================
No changes since 1.27.0. Version incremented to match the libbson version.
libmongoc 1.27.0
================
Notes:
* Raise required version of libmongocrypt to 1.10.0 to support In-Use Encryption (corresponds to the CMake option: `ENABLE_CLIENT_SIDE_ENCRYPTION`).
* A future minor release plans to raise the minimum supported MongoDB Server version from 3.6 to 4.0. This is in accordance with [MongoDB Software Lifecycle Schedules](https://www.mongodb.com/legal/support-policy/lifecycles).
Fixes:
* Fix possible crash when client is configured with empty password.
New Features:
* Add database name to command events: `mongoc_apm_command_failed_get_database_name` and `mongoc_apm_command_succeeded_get_database_name`.
* Support delegated KMIP protocol for In-Use Encryption.
* Enable setting socket timeout per client.
Thanks to everyone who contributed to the development of this release.
* Kevin Albertson
* Adrian Dole
* Ezra Chung
* Roberto C. Sánchez
* Scott Hunt
libmongoc 1.26.2
================
Cyrus SASL:
* Disable plugin loading with Cyrus SASL on Windows by default. To re-enable, set the CMake option `CYRUS_PLUGIN_PATH_PREFIX` to the absolute path prefix of the Cyrus SASL plugins.
Fixes:
* Fix possible hang if `mongoc_gridfs_file_readv` is called with a corrupt chunk with incomplete data.
* Fix assert with legacy exhaust cursor protocol when connected to server < 4.2.
Thanks to everyone who contributed to the development of this release.
* Kevin Albertson
libmongoc 1.26.1
================
Fixes:
* Fix 32-bit compile with 64-bit `time_t`
Thanks to everyone who contributed to the development of this release.
* Roberto C. Sánchez
libmongoc 1.26.0
================
New Features:
* Support named KMS providers.
* Redirect retries in sharded clusters to another mongos if possible.
Improvements:
* Add `VERSION_CURRENT` file in source to ease building.
* Consider more errors retryable.
Thanks to everyone who contributed to the development of this release.
* Kevin Albertson
* Jeremy Mikola
* Adrian Dole
* Kyle Kloberdanz
* Ezra Chung
* MongoCaleb
* Roberto C. Sánchez
* itrofimow
libmongoc 1.25.4
================
Fixes:
* Restore support for Sphinx 1.7.6 for man page build.
libmongoc 1.25.3
================
Fixes:
* Disable shared libmongoc targets if `ENABLE_SHARED=OFF`
* Fix documentation build with Python 3.9.
Thanks to everyone who contributed to the development of this release.
* Kevin Albertson
libmongoc 1.25.2
================
Fixes:
* Fix data race in `mongoc_cursor_get_host`.
* Accept discouraged timeout values for backwards compatibility.
Thanks to everyone who contributed to the development of this release.
* Kevin Albertson
* Ezra Chung
* Kyle Kloberdanz
* Roberto C. Sánchez
libmongoc 1.25.1
================
Fixes:
* Add back support for `BUILD_VERSION` CMake option. `BUILD_VERSION` was unintentionally removed in 1.25.0.
libmongoc 1.25.0
================
Fixes:
* Send `recoveryToken` in transactions when connected to a load balancer.
Improvements:
* Remove optional dependency of libicu.
* Use OP_MSG exhaust for mongod >= 4.2. Enable exhaust cursors for mongos >= 7.1.
* Share cached credentials for SCRAM authentication among all clients to improve performance.
* Use polling monitoring in FaaS environments.
Build Configuration:
* Remove `ENABLE_SRV=AUTO`. Only support boolean values for `ENABLE_SRV`.
Platform Support:
* Support for macOS 10.14 is dropped.
* Support for Ubuntu 14.04 is dropped.
* Support for Debian 8.1 is dropped.
Other:
* The constructed source-distribution archive is no longer available as a
release artifact. Please instead use the per-release repository archive
attached to a GitHub release, or clone the repository at the desired release
tag.
Thanks to everyone who contributed to the development of this release.
* Kevin Albertson
* Colby Pike
* Adrian Dole
* Roberto C. Sánchez
* Ezra Chung
* Joshua Siegel
* Kyle Kloberdanz
* Jeremy Mikola
libmongoc 1.24.4
================
Fixes:
* Fix build failure caused by missing `bson-dsl.h` install in libbson.
Thanks to everyone who contributed to the development of this release.
* Kevin Albertson
libmongoc 1.24.3
================
Fixes:
* Fix possible memory leak on SCRAM authentication failure.
* Fix possible recursive lock on network error in single-threaded client.
Thanks to everyone who contributed to the development of this release.
* Kevin Albertson
* Jeremy Mikola
* Roberto C. Sánchez
libmongoc 1.24.2
================
Fixes:
* Fix possible crash if thread creation fails.
* Fix possible assertion if `mongoc_cursor_new_from_command_reply_with_opts` is called with open cursor and no `serverId` option.
Thanks to everyone who contributed to the development of this release.
* Kevin Albertson
libmongoc 1.24.1
================
Fixes:
* Remove unnecessary assert in bulk API. May result in an abort when creating bulk operations with the `mongoc_bulk_operation_new` API intended for wrapping drivers.
Thanks to everyone who contributed to the development of this release.
* Kevin Albertson
libmongoc 1.24.0
================
New Features:
* Support MongoDB server version 7.0.
* Support updated Queryable Encryption protocol.
* Introduces backwards breaking changes to the Queryable Encryption protocol. Using Queryable Encryption now requires MongoDB server version 7.0+.
* Support new Queryable Encryption features.
* Add `mongoc_client_encryption_create_encrypted_collection` to automatically create data encryption keys when creating a new encrypted collection.
* Support new security features.
* Add ability to fetch KMS credentials automatically from Azure, GCP, and AWS environments.
* Support authentication with KMS AWS temporary credentials.
* Cache fetched AWS credentials.
* Support AWS IAM Roles for service accounts, EKS in particular.
* Retry operations if the connection handshake fails.
* Add index creation helper: `mongoc_collection_create_indexes_with_opts`.
Fixes:
* Fix default applied credentials for Kerberos with SSPI on Windows.
* Fix possible overcounting in Performance Counters used by `mongoc-stat`.
Language Standard Support:
* C89 support has been dropped. C99 is the default tested C standard.
Platform Support:
* Support for macOS 10.14 will be dropped in an upcoming release.
* Support for Ubuntu 14.04 will be dropped in an upcoming release.
* Support for Debian 8.1 will be dropped in an upcoming release.
Build Configuration:
* The `ENABLE_BSON` configure-time option has been removed. Build scripts that
used `ENABLE_BSON=SYSTEM` should be updated to use `USE_SYSTEM_LIBBSON=TRUE`.
If the build script needs to support building arbitrary versions of the C
driver, add both `ENABLE_BSON=SYSTEM` and `USE_SYSTEM_LIBBSON=TRUE`.
Thanks to everyone who contributed to the development of this release.
* Kevin Albertson
* Ezra Chung
* Colby Pike
* Gil Alon
* Kyle Kloberdanz
* Jeremy Mikola
* Andreas Braun
* Kondaiah Valagonda
* Joshua Siegel
* Roberto C. Sánchez
* Romain Geissler @ Amadeus
* bisht2050
* Adrian Dole
libmongoc 1.23.5
================
Fixes:
* Fix potential crash due to insufficient memory when allocating performance counters.
* Fix compilation error on Android platforms due to missing `aligned_alloc`.
* Return an error if `RewrapManyDataKey` is invoked without a `provider` when a `masterKey` is given.
Thanks to everyone who contributed to the development of this release.
* Kevin Albertson
* Romain Geissler @ Amadeus
libmongoc 1.23.4
================
Fixes:
* Fix possible failure to authenticate with MONGODB-X509 after network error.
Thanks to everyone who contributed to the development of this release.
* Andreas Braun
* Kevin Albertson
* Kyle Kloberdanz
libmongoc 1.23.3
================
Fixes:
* Better handle malformed `hello` responses
* Handle `connectionId` of type `double`.
Thanks to everyone who contributed to the development of this release.
* Kevin Albertson
* Gil Alon
* Kondaiah Valagonda
libmongoc 1.23.2
================
Bug fixes:
* Fix compile on M1 macOS fails due to undeclared function (getpagesize)
Thanks to everyone who contributed to the development of this release.
* Kevin Albertson
* Kyle Kloberdanz
libmongoc 1.22.2
================
* Fix connectivity to Atlas Data Lake
* Additional bugfixes from libbson 1.22.2
Thanks to everyone who contributed to the development of this release.
* Andreas Braun
* Kevin Albertson
* Roberto C. Sánchez
libmongoc 1.23.1
================
Bug fixes:
* Fix connectivity to Atlas Data Lake
* Fix crash when dropping a malformed Queryable Encryption collection.
Thanks to everyone who contributed to the development of this release.
* Andreas Braun
* Kevin Albertson
libmongoc 1.23.0
================
Features:
* Add on-demand Credentials Callback for CSFLE
* Support obtaining AWS credentials for CSFLE in the same way as for MONGODB-AWS
Improvements:
* Reducing Warnings of Misaligned Address of Over-Aligned Types
Bug fixes:
* Do not spawn mongocryptd if mongo_shared shared library is loaded.
Thanks to everyone who contributed to the development of this release.
* Ezra Chung
* Colby Pike
* Kevin Albertson
* Roberto C. Sánchez
libmongoc 1.22.1
================
Bug fixes:
* Fix documentation build when using Sphinx 5.0 or newer
* Update patch release of libmongocrypt to 1.5.2: Fix a potential data
corruption bug in RewrapManyDataKey when rotating encrypted data encryption
keys backed by GCP or Azure key services.
The following conditions will trigger this bug:
A GCP-backed or Azure-backed data encryption key being rewrapped requires
fetching an access token for decryption of the data encryption key.
The result of this bug is that the key material for all data encryption keys
being rewrapped is replaced by new randomly generated material, destroying
the original key material.
To mitigate potential data corruption, upgrade to this version or higher
before using RewrapManyDataKey to rotate Azure-backed or GCP-backed data
encryption keys. A backup of the key vault collection should always be taken
before key rotation.
Other:
* Update to Fedora 37 for RPM builds
* Dependency build of libmongocrypt re-uses the libbson of the depending
libmongoc
Thanks to everyone who contributed to the development of this release.
* Ezra Chung
* Roberto C. Sánchez
* Kevin Albertson
libmongoc 1.21.2
================
Bug Fixes:
* Address vulnerability in bundled zlib by updating to 1.1.12.
Thanks to everyone who contributed to the development of this release.
* Kevin Albertson
* Colby Pike
libmongoc 1.22.0
================
Bug fixes:
* Do not auto decrypt before emitting CommandSucceeded events.
Improvements:
* Use OP_MSG if a server API version is requested.
Features:
* Add server connectionId to command monitoring events.
* Add support for the comment field to all helpers.
* Support mongo_shared shared library.
* Support pre-point-in-time change stream events.
* Support Queryable Encryption.
* Support 'let' option for multiple CRUD commands.
* Add Key Management API functions.
Notes:
* The 5.0-compat release (1.18.0) accidentally broke estimatedDocumentCount on views by changing its implementation to use aggregate and a $collStats stage instead of the count command.
* The new release is fixing estimatedDocumentCount on views by reverting back to using count in its implementation.
* Due to an oversight, the count command was omitted from the Stable API in server versions 5.0.0 - 5.0.8 and 5.1.0 - 5.3.1, so users of the Stable API with estimatedDocumentCount are recommended to upgrade their MongoDB clusters to 5.0.9 or 5.3.2 (if on Atlas) or set apiStrict: false when constructing their MongoClients.
Thanks to everyone who contributed to the development of this release.
* Kevin Albertson
* Jeremy Mikola
* Colby Pike
* Ezra Chung
* Roberto C. Sánchez
* Jake Molnar
* Jesse Williamson
* Remi Collet
libmongoc 1.21.1
================
Bug Fixes:
* Use static decls for OpenSSL 1.1 polyfills
* Prevent possible crash in _mongoc_cursor_fetch_stream
Thanks to everyone who contributed to the development of this release.
* Jeremy Mikola
* Remi Collet
libmongoc 1.21.0
================
Bug Fixes:
* Addressed VS 2013 build failures due to missing C99 features.
Features:
* Support conditional $merge and $out aggregation on secondaries.
* Bump minimum wire protocol version from 3 (MongoDB 3.0) to 6 (MongoDB 3.6).
* Bump maximum wire protocol version from 14 (MongoDB 5.1) to 15 (MongODB 5.2).
Improvements:
* Update algorithm used for generation of OID values to reduce collisions.
Thanks to everyone who contributed to the development of this release.
* Ezra Chung
* Colby Pike
* Kevin Albertson
* Roberto C. Sánchez
* David CARLIER
* Jeremy Mikola
libmongoc 1.20.1
================
Bug fixes:
* Fix bug where first hello command on a single-threaded client may not include full handshake.
Thanks to everyone who contributed to the development of this release.
* Kevin Albertson
libmongoc 1.20.0
================
Features:
* Improve multi-threaded performance of client pool.
* Support KMIP as a provider for Client-Side Field Level Encryption (CSFLE).
Thanks to everyone who contributed to the development of this release.
* Kevin Albertson
* Ezra Chung
* Colby Pike
* Jesse Williamson
* Jeremy Mikola
* Kaitlin Mahar
mongo-c-driver 1.19.2
=====================
Announcing libmongoc 1.19.2.
Bug fixes:
* Fix assert on invalid URI options in client pools connected to load balanced clusters when a topology closed callback is registered.
Thanks to everyone who contributed to the development of this release.
--Kevin Albertson
libmongoc 1.19.1
================
It is my pleasure to announce libmongoc 1.19.1.
Bug fixes:
* Permit NULL platform argument in mongoc_handshake_data_append.
* Fix wire version check in server selection when maxStalenessSeconds is specified in read preferences.
* Fix assert on invalid URI options in client pools connected to load balanced clusters.
Thanks to everyone who contributed to the development of this release.
* Kevin Albertson