/
NEWS
2194 lines (1653 loc) · 73.3 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
mongo-c-driver 1.10.0
=====================
It is my pleasure to announce MongoDB C Driver 1.10.0. This version drops
support for MongoDB 2.6 and adds the following features and bugfixes:
* libbson and libmongoc are now maintained in the mongo-c-driver repository,
although they are still built as separate libraries, and libbson can still
be used without libmongoc.
* Building libbson and libmongoc now requires CMake on all platforms. The
Autotools build scripts ("configure" and related scripts) have been deleted.
See the "installing" page for updated instructions, including the new
ENABLE_MONGOC option and changes to the ENABLE_BSON option.
* IPv6 is now fully supported and conforms to RFC-6555. If a hostname has both
IPv4 and IPv6 DNS records, the driver tries connecting with IPv6 first. If a
connection can't be established after 250ms then IPv4 is tried in parallel.
Whichever succeeds connection first cancels the other. The successful DNS
result is cached for 10 minutes.
* If CMake is configured with ENABLE_SSL=AUTO (the default), libmongoc now
uses native TLS libraries on Mac and Windows, and OpenSSL everywhere else.
Before, it would search for OpenSSL on all platforms and only use native
TLS on Mac and Windows as a fallback.
* The driver now handshakes SSL connections to multiple servers in a replica
set or sharded cluster in parallel, so long as it uses OpenSSL or Windows
SChannel. (SSL handshakes with Apple's Secure Transport are still serial.)
A larger receive buffer with SChannel increases performance over slow
connections.
* All functions that accept read concern now prohibit it, if MongoDB is too
old to support it (MongoDB 3.0).
* Client sessions are now prohibited with unacknowledged writes.
* mongoc_collection_find_and_modify_with_opts now prohibits write concern if
MongoDB is too old to support it (MongoDB 3.0).
* Other helper functions for commands that write, now prohibit write concern
if MongoDB is too old to support it (pre-3.4):
mongoc_client_read_write_command_with_opts
mongoc_client_write_command_with_opts
mongoc_collection_read_write_command_with_opts
mongoc_collection_write_command_with_opts
mongoc_database_read_write_command_with_opts
mongoc_database_write_command_with_opts
mongoc_collection_aggregate with $out
mongoc_collection_drop_index_with_opts
mongoc_collection_drop_with_opts
mongoc_collection_rename_with_opts
mongoc_database_drop_with_opts
Write concern behavior is unchanged for regular CRUD functions.
* Setting a negative writeConcern level of -2 or smaller, via the "opts"
parameter to functions that accept BSON options, is now prohibited. The
special "w" values -2 through -4 are only used internally. The deprecated
"w=-1" is still allowed, as a synonym for "w=0".
* The Kerberos URI option authMechanismProperties=CANONICALIZE_HOST_NAME:true
is now implemented with the Windows Kerberos provider, SSPI.
* This repository now includes GDB and LLDB customizations for pretty-printing
bson_t structs as JSON while debugging. See the "debugging" page.
* The internal preprocessor symbol HAVE_STRINGS_H has been renamed
BSON_HAVE_STRINGS_H. If you maintain a handwritten bson-config.h you must
rename this symbol.
* The following helper functions do not work with mongoc_client_session_t,
they are deprecated in favor of running MongoDB commands directly with a
function like mongoc_client_read_command_with_opts:
mongoc_client_get_server_status
mongoc_collection_stats
mongoc_collection_validate
* mongoc_cursor_is_alive is now deprecated for mongoc_cursor_more, which is
functionally equivalent.
Thanks to everyone who contributed to the development of this release.
* A. Jesse Jiryu Davis
* Kevin Albertson
* Roberto C. Sánchez
* Jeremy Mikola
* Xiangyu Yao
* Jeroen Ooms
* Derick Rethans
* Kaitlin Mahar
* Pavithra Vetriselvan
* NotSpooky
* Iulian Rotaru
* Katherine Walker
Peace,
A. Jesse Jiryu Davis
mongo-c-driver 1.9.5
====================
It is my pleasure to announce mongo-c-driver 1.9.5. This release fixes the following bugs:
* New change streams API functions were not marked extern "C"
* mongoc_collection_watch now accepts a pipeline argument as a BSON array, in
addition to accepting a BSON document with a "pipeline" array field
* Crashes in several change stream error handling paths
* Commands could return false with an empty bson_error_t after a replica set
reconfig
* Network error messages omitted the command name when using OP_MSG
Thanks to everyone who contributed to the development of this release.
* A. Jesse Jiryu Davis
* Kevin Albertson
Peace,
A. Jesse Jiryu Davis
mongo-c-driver 1.9.4
====================
It is my pleasure to announce mongo-c-driver 1.9.4. This release offers
compatibility with Sphinx 1.7.0 and above and fixes two bugs:
* Ensure a change stream uses the proper session id while iterating
* Fix a rare crash in pooled mode when a replica set member was disconnected
Thanks to everyone who contributed to the development of this release.
* A. Jesse Jiryu Davis
* Kevin Albertson
Peace,
A. Jesse Jiryu Davis
mongo-c-driver 1.9.3
====================
It is my pleasure to announce mongo-c-driver 1.9.3. This version fixes a
session-management bug that could cause an authentication error while connected
to MongoDB 3.6+ and iterating a cursor, and it permits the $gleStats modifier
with mongoc_collection_aggregate.
Thanks to everyone who contributed to the development of this release.
* A. Jesse Jiryu Davis
* Jeremy Mikola
Peace,
A. Jesse Jiryu Davis
mongo-c-driver 1.9.2
====================
No change since 1.9.1; released to keep pace with libbson's version number.
-- A. Jesse Jiryu Davis
mongo-c-driver 1.9.1
====================
It is my pleasure to announce mongo-c-driver 1.9.1. This release fixes a bug
that caused session ID to be included in authentication and server monitoring
commands. Thanks to Jeremy Mikola for finding and fixing the issue.
Peace,
A. Jesse Jiryu Davis
mongo-c-driver 1.9.0
====================
It is my pleasure to announce mongo-c-driver 1.9.0. This version drops support
for MongoDB 2.4 and adds support for MongoDB 3.6 features:
* New struct mongoc_change_stream_t to watch a collection for changes.
* New struct mongoc_client_session_t represents a MongoDB 3.6 session,
which supports causal consistency: you are guaranteed to read your writes
and to perform monotonic reads, even when reading from secondaries or in
a sharded cluster.
* New functions that accept flexible options as a BSON document. These
accept a "sessionId" option and any future options. In addition, the
two new "update" functions accept the "arrayFilters" option that is new
in MongoDB 3.6:
mongoc_collection_insert_one
mongoc_collection_insert_many
mongoc_collection_update_one
mongoc_collection_update_many
mongoc_collection_replace_one
mongoc_collection_delete_one
mongoc_collection_delete_many
mongoc_client_command_with_opts
mongoc_database_command_with_opts
mongoc_collection_command_with_opts
mongoc_client_find_databases_with_opts
mongoc_client_get_database_names_with_opts
mongoc_collection_create_bulk_operation_with_opts
mongoc_collection_find_indexes_with_opts
mongoc_database_find_collections_with_opts
mongoc_database_get_collection_names_with_opts
* New URI option "retryWrites=true" safely and automatically retries certain
write operations if the server is a MongoDB 3.6 replica set or sharded
cluster.
* Support for MongoDB OP_MSG wire protocol.
Additional changes not specific to MongoDB 3.6:
* Support for mongodb+srv URIs to query DNS for SRV and TXT records that
configure the connection to MongoDB.
* Support LibreSSL with CMake build
* The "minPoolSize" URI option is deprecated: it's confusing and not useful.
Bug fixes:
* mongoc_bulk_operation_execute did not always initialize "reply".
* Fix C99 pedantic warnings.
Thanks to everyone who contributed to the development of this release.
* A. Jesse Jiryu Davis
* Hannes Magnusson
* Jeremy Mikola
* Kevin Albertson
* Jeroen Ooms
* Iulian Rotaru
* Derick Rethans
* Graham Whitted
* Brian Moss
* Alex Masterov
* Michael Kuhn
* Sriharsha Vardhan
Peace,
A. Jesse Jiryu Davis
mongo-c-driver 1.8.2
====================
It is my pleasure to announce mongo-c-driver 1.8.2. This release fixes the
following bugs:
* Remove option to bundle the Snappy compression library, it caused issues
for programs linking to libmongoc
* Fix pkg-config and CMake config file flags for programs that statically
link to libmongoc when libmongoc is statically linked to zLib
* The configure flag "--with-zlib=no" was ignored
Crash in authentication when username is NULL
Thanks to everyone who contributed to the development of this release.
* A. Jesse Jiryu Davis
* Derick Rethans
* Hannes Magnusson
* Jeremy Mikola
Peace,
A. Jesse Jiryu Davis
mongo-c-driver 1.8.1
====================
It is my pleasure to announce mongo-c-driver 1.8.1. This release fixes the
following bugs:
* Remove a syntax error in the configure script that affects some shells.
* The configure script respects --with-zlib=system and --with-snappy=system.
* The internal mongoc_server_description_t struct is properly reinitialized
after a network error.
* Fix the encoding of this NEWS file.
Thanks to everyone who contributed to the development of this release.
* A. Jesse Jiryu Davis
* Jeremy Mikola
Peace,
A. Jesse Jiryu Davis
mongo-c-driver 1.8.0
====================
* The zLib and Snappy compression libraries are bundled if not available.
Wire protocol compression is enabled on Windows.
* mongoc_collection_find_and_modify_with_opts now respects a "writeConcern"
field in the "extra" BSON document in its mongoc_find_and_modify_opts_t.
* The command functions mongoc_client_read_write_command_with_opts,
mongoc_database_read_write_command_with_opts, and
mongoc_collection_read_write_command_with_opts now ignore the "read_prefs"
parameter.
* mongoc_collection_create_index and mongoc_collection_create_index_with_opts
are both now deprecated. Use mongoc_database_write_command_with_opts
instead; a guide to creating an index using that function has been added.
* Use select, not WSAPoll, on Windows.
* Always mark a server "Unknown" after a network error (besides a timeout).
* mongoc_client_pool_t sends platform metadata to the server; before, only a
single mongoc_client_t did.
* New stream method mongoc_stream_timed_out.
* Wire version checks introduced in 1.8.0 will prevent the driver from
connecting to a future MongoDB server version if its wire protocol is
incompatible.
* New CMake option ENABLE_MAINTAINER_FLAGS.
Thanks to everyone who contributed to the development of this release.
* A. Jesse Jiryu Davis
* Hannes Magnusson
* Jeremy Mikola
Peace,
A. Jesse Jiryu Davis
mongo-c-driver 1.7.0
====================
It is my pleasure to announce mongo-c-driver 1.7.0.
New features and bug fixes:
* CMake build now installs .pc files for programs that link to libmongoc using
pkg-config. Both the CMake and Autotools build systems now install .cmake
files for programs that link to libmongoc using CMake. Linking to libmongoc
statically or dynamically is now much more convenient. See the new tutorial
section "Include and link libmongoc in your C program".
* New CMake option ENABLE_STATIC can be ON, OFF, or AUTO (the default)
* Minimum required CMake version has been increased to 3.1.
* CMake remains experimental on non-Windows platforms and issues a warning now
* Support for wire compression.
* Support for snappy and zlib. MongoDB 3.4 only supports snappy, while zlib
support is expected in MongoDB 3.6.
The enable, configure mongoc like so:
./configure --with-snappy --with-zlib
* New functions: mongoc_uri_get_compressors & mongoc_uri_set_compressors, to
get and set compressor configuration on mongoc_uri_t
* Added support for comma separated "compressors" connection string option (e.g.
mongodb://localhost/?compressors=snappy,zlib)
* Added support for configuring zlib compression level in the connection string
(e.g. mongodb://localhost/?compressors=zlib&zlibcompressionlevel=8)
* Now requires the use of CMake config files for libbson to build libmongoc
with CMake
* Added pkg-config support for libressl.
* New function mongoc_uri_set_auth_mechanism to update the authentication
mechanism of a mongoc_uri_t after it is created from a string.
* New function mongoc_bulk_operation_insert_with_opts provides immediate
error checking.
* New function mongoc_uri_new_with_error provides a way to parse a connection
string, and retrieve the failure reason, if any.
* Support for MongoDB Connection String specification
* All connection string options are now represented by MONGOC_URI_xxx macros
* Paths to Unix Domain Sockets must be url encoded
* Repeated options now issue warnings
* Special characters in username, password and other values must be url encoded
* Unsupported connection string options now issue warnings
* Boolean values can now be represented as true/yes/y/t/1 and false/no/n/f/0.
* Case is now preserved in Unix domain paths.
* New function mongoc_cursor_error_document provides access to server's error
reply if a query or command fails.
* New function mongoc_write_concern_is_default determines whether any write
concern options have been set, and mongoc_read_concern_is_default checks if
read concern options are set.
* mongoc_gridfs_find_one_with_opts optimized to use limit 1.
Thanks to everyone who contributed to the development of this release.
* Hannes Magnusson
* A. Jesse Jiryu Davis
* David Golden
* Jeremy Mikola
* Bernard Spil
* Aleksander Melnikov
* Adam Seering
* Remi Collet
Peace,
A. Jesse Jiryu Davis
mongo-c-driver 1.6.0
====================
It is my pleasure to announce mongo-c-driver 1.6.0.
New features and bug fixes:
* Enterprise authentication on Windows now uses the native GSSAPI library;
Cyrus SASL is no longer required for enterprise auth on Windows.
* BSON documents are more thoroughly validated before insert or update.
* New function mongoc_uri_set_mechanism_properties to replace all the
authMechanismProperties on an existing URI.
* mongoc_uri_get_mechanism_properties asserts its inputs are not NULL.
* For consistency with other MongoDB drivers, mongoc_collection_save is
deprecated in favor of mongoc_collection_insert or mongoc_collection_update.
* The driver is now built and continuously tested with MinGW-W64 on Windows.
* Experimental support for HPUX.
* The correct operation ids are now passed to Command Monitoring callbacks.
* Fix a crash if the driver couldn't connect to the server to create an index.
* The documentation is ported from Mallard XML to ReStructured Text, the
HTML documentation is restyled, and numerous man page syntax errors fixed.
* Getter functions for options in mongoc_find_and_modify_opts_t:
* mongoc_find_and_modify_opts_get_bypass_document_validation
* mongoc_find_and_modify_opts_get_fields
* mongoc_find_and_modify_opts_get_flags
* mongoc_find_and_modify_opts_get_max_time_ms
* mongoc_find_and_modify_opts_get_sort
* mongoc_find_and_modify_opts_get_update
* All public functions now have the __cdecl calling convention on Windows.
Thanks to everyone who contributed to the development of this release.
* A. Jesse Jiryu Davis
* Hannes Magnusson
* Aleksander Melnikov
* Jeroen Ooms
* Brian McCarthy
* Jonathan Wang
* Peter Beckman
* Remi Collet
* Rockford Wei
* Alexey Ponomarev
* Christopher Wang
* David Golden
* Jeremy Mikola
Peace,
A. Jesse Jiryu Davis
mongo-c-driver 1.5.5
====================
It is my pleasure to announce mongo-c-driver 1.5.5. This release fixes bugs
parsing the localThresholdMS option from the MongoDB URI, and a crash in
mongoc_cursor_destroy if "query" or "filter" are invalid. Thanks to Jeremy
Mikola.
Peace,
A. Jesse Jiryu Davis
mongo-c-driver 1.5.4
====================
It is my pleasure to announce mongo-c-driver 1.5.4. This release fixes an error
in cursor iteration when a readConcern is set. Thanks to Jeremy Mikola and
Hannes Magnusson.
Peace,
A. Jesse Jiryu Davis
mongo-c-driver 1.5.3
====================
This release fixes a bug that prevented connecting to IPv4-only MongoDB servers
by hostname.
https://jira.mongodb.org/browse/CDRIVER-1988
The driver has reverted to its 1.5.1 behavior: it connects to MongoDB over IPv6
if given an IPv6 connection string like "mongodb://[::1]", and requires an IPv4
connection when given a hostname like "mongodb://localhost".
Peace,
A. Jesse Jiryu Davis
mongo-c-driver 1.5.2
====================
It is my pleasure to announce mongo-c-driver 1.5.2.
Thanks to everyone who contributed to the development of this release.
New bug fixes:
* CDRIVER-1975 allow mixed $ and non-$ query ops.
* CDRIVER-1972 Support for ipv6 hostnames.
* CDRIVER-1971 Missing exports of mongoc_gridfs_file_set_*() functions.
* CDRIVER-1970 update define constants for "find" opts to be unique.
* CDRIVER-1964 Windows CA stores should be opened with read-only flag.
Thanks to everyone who contributed to the development of this release.
* Hannes Magnusson
* A. Jesse Jiryu Davis
* Alexey Ponomarev
* Peter Beckman
* Rockford Wei
Peace,
Hannes Magnusson
mongo-c-driver 1.5.1
====================
It is my pleasure to announce mongo-c-driver 1.5.1. This is a bugfix release:
* Fix SEGFAULT with performance counters on NUMA (thanks to Jonathan Wang).
* Prevent rare assertion error in mongoc_cluster_stream_for_server.
* Improve error messages from auth failure.
* Escape quotes when appending CFLAGS to handshake metadata.
* Fix OpenSSL header lookups in non-default paths.
* Fix build failure with LibreSSL.
Thanks to everyone who contributed to the development of this release.
* A. Jesse Jiryu Davis
* Hannes Magnusson
* Jeroen Ooms
* Jonathan Wang
Peace,
A. Jesse Jiryu Davis
mongo-c-driver 1.5.0
====================
It is my pleasure to announce mongo-c-driver 1.5.0.
New features and bug fixes:
* MongoDB 3.4 Support
* New URI and read preference option, "maxStalenessSeconds"
* MongoDB Handshake
* writeConcern and readConcern enhancements
* Collation allows users to specify language-specific rules for string
comparison when sorting documents. See the code examples for
mongoc_client_read_command_with_opts, mongoc_collection_count_with_opts,
mongoc_collection_find_with_opts, and mongoc_index_opt_t, as well as the
"Setting Collation Order" section of the "Bulk Write Operations" guide.
* mongoc_collection_count_with_opts uses the collection's read preference if
none is passed in
* Improved TLS support
* Fixed LibreSSL (libssl) support
* Added LibreSSL (libtls) support
* Fixed Secure Channel build on VS 2010
* OpenSSL now supports SNI (all others already do)
* Additional features for Application Performance Monitoring:
* mongoc_topology_description_has_writable_server
* mongoc_topology_description_has_readable_server
* New functions accept flexible options as a BSON document:
* mongoc_collection_find_with_opts
* mongoc_client_read_command_with_opts
* mongoc_client_write_command_with_opts
* mongoc_client_read_write_command_with_opts
* mongoc_database_read_command_with_opts
* mongoc_database_write_command_with_opts
* mongoc_database_read_write_command_with_opts
* mongoc_collection_read_command_with_opts
* mongoc_collection_write_command_with_opts
* mongoc_collection_read_write_command_with_opts
* mongoc_gridfs_find_with_opts
* mongoc_gridfs_find_one_with_opts
* mongoc_collection_find is now deprecated in favor of
mongoc_collection_find_with_opts.
* New helper function to include read concern in one of the above function's
options parameter: mongoc_read_concern_append.
* mongoc_client_command no longer applies the client's read preference and
read concern by default. Same change for mongoc_database_command and
mongoc_collection_command.
* mongoc_collection_count_with_opts now applies the collection's read
preference if no read preference is provided
* mongoc_collection_create_index and mongoc_collection_drop_index now apply
the collection's write concern.
* mongoc_collection_create_index_with_opts now applies the collection's
write concern if none is specified in "opts"
* connectTimeoutMS timer now begins after DNS resolution, and resets
for each interface attempted (e.g., if the driver first tries IPv6,
then IPv4).
* New error code MONGOC_ERROR_DUPLICATE_KEY.
* mongoc_collection_find no longer treats the "filter" key specially in
queries - querying for a document with a key named "filter" is the same
now as any other key.
* The server description parameter to the following functions is "const":
* mongoc_server_description_host
* mongoc_server_description_id
* mongoc_server_description_ismaster
* mongoc_server_description_round_trip_time
* mongoc_server_description_type
* Exported symbols are no longer declared in seperate export files.
This could break ABI with applications using clang, which previously
exported symbols from the internal private ABI.
* mongoc no longer crashes when multi roundtrip bulk operation fails.
* Added support for the new readConcernLevel "linearizable".
* Clients now check for misformatted "readPreferenceTags" in URI.
* New CMake option ENABLE_TRACING allows debug output, which before had only
been available with "configure --enable-tracing".
* Bugfix: "PossiblePrimary"-type replicas could be selected for reads
* Bugfixes: The random number generator used to select servers is now properly
seeded, and secondary queries are now properly distributed according to
localThresholdMS, not just to the lowest-latency secondary.
* mongoc_collection_insert, mongoc_collection_update, mongoc_collection_remove
consistently use domain MONGOC_ERROR_BSON, code MONGOC_ERROR_BSON_INVALID
if passed oversized BSON, and MONGOC_ERROR_COLLECTION for other errors.
mongoc_bulk_operation_execute continues to use MONGOC_ERROR_COMMAND for
all errors.
* If mongoc_client_pool_t fails to start its scanner thread in the background,
it logs and aborts instead of silently continuing, then failing to connect.
* The driver now updates its view of the whole topology with information from
each new connection handshake.
* mongoc_client_set_apm_callbacks can be used repeatedly to change or clear
the list of monitoring callbacks.
* Improved error reporting when the driver fails to reach the server.
Deprecations:
* mongoc_collection_find is deprecated for mongoc_collection_find_with_opts.
Removed configure flags:
* --enable-experimental has been removed. All previously experimental
features are now always on.
* The configure option "--enable-hardening" had had no effect. It is removed
in favor of system-wide compiler configuration.
Thanks to everyone who contributed to the development of this release.
* A. Jesse Jiryu Davis
* Hannes Magnusson
* Fiona Rowan
* Ian Boros
* Remi Collet
* Brian McCarthy
* Jeroen Ooms
* J. Rassi
* Christoph Schwarz
* Alexey Vorobeyev
Peace,
A. Jesse Jiryu Davis
mongo-c-driver 1.4.2
====================
It is my pleasure to announce mongo-c-driver 1.4.2. This release fixes bugs in
"minPoolSize" logic, see CDRIVER-1558 for details.
Peace,
A. Jesse Jiryu Davis
mongo-c-driver 1.4.1
====================
It is my pleasure to announce mongo-c-driver 1.4.1. This is a bugfix release:
* mongoc_client_get_server_descriptions could return a list including NULLs
* Tailable cursors on MongoDB 3.2 only worked with MONGOC_QUERY_AWAIT_DATA
* Spurious warnings with MONGOC_DISABLE_SHM
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.4.0
====================
It is my pleasure to announce the 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
-----------------
* Logic bugs using tag sets to select replica set members with complex configs
* 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.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