A high-performance MongoDB driver for C
Clone or download
ajdavis CDRIVER-2479 simpler config.yml.template
Move handwritten tests from include files into the template, generate
some auth tests from a matrix defined in Python, and format tasks with a
YAML formatter instead of a template.
Latest commit 42c9daa Sep 11, 2018
Permalink
Failed to load latest commit information.
.evergreen CDRIVER-2479 simpler config.yml.template Sep 20, 2018
.travis.scripts CDRIVER-2281 Improve travis debugging Sep 14, 2017
build CDRIVER-2479 simpler config.yml.template Sep 20, 2018
debian CDRIVER-2800 fix Debian packaging for new header install location Sep 8, 2018
generate_uninstall CDRIVER-2827 fix uninstall path for DESTDIR Sep 19, 2018
orchestration_configs CDRIVER-2788 remove extra test certificates Sep 6, 2018
src robuster test_topology_scanner_does_not_renegotiate Sep 18, 2018
.clang-format CDRIVER-1167 Add clang-format file, and remove uncrustify Dec 12, 2016
.gdbinit CDRIVER-2457 move debug scripts to mongo-c-driver Jan 31, 2018
.gitattributes CDRIVER-929 line-endings in test data files Oct 19, 2015
.gitignore CDRIVER-2662 update .gitignore Jun 7, 2018
.gitmodules CDRIVER-2416 delete libbson submodule Dec 14, 2017
.travis.yml increase travis clone depth Jun 18, 2018
CMakeLists.txt CDRIVER-2827 fix uninstall path for DESTDIR Sep 19, 2018
CONTRIBUTING.md typo in CONTRIBUTING.md Jun 22, 2018
COPYING doc: drop appendix from license. Mar 13, 2014
NEWS Revert "CDRIVER-2665 NEWS: bulk fns allow extra opts" Sep 17, 2018
README.rst CDRIVER-2505 make libmongoc a sub-project May 17, 2018
THIRD_PARTY_NOTICES CDRIVER-2711 deprecate md5 apis Jul 17, 2018
VERSION_CURRENT begin 1.13.0 development Jul 18, 2018
VERSION_RELEASED NEWS for 1.12.0 Jul 18, 2018
lldb_bson.py CDRIVER-2457 move debug scripts to mongo-c-driver Jan 31, 2018
valgrind.suppressions CDRIVER-2354 fix the uninitialized conditional jump errors found by v… Jan 24, 2018

README.rst

mongo-c-driver

About

mongo-c-driver is a project that includes two libraries:

  • libmongoc, a client library written in C for MongoDB.
  • libbson, a library providing useful routines related to building, parsing, and iterating BSON documents.

If libmongoc is not needed, it is possible to build and install only libbson.

Documentation / Support / Feedback

The documentation is available at http://mongoc.org/. For issues with, questions about, or feedback for libmongoc, please look into our support channels. Please do not email any of the libmongoc developers directly with issues or questions - you're more likely to get an answer on the mongodb-user list on Google Groups.

Bugs / Feature Requests

Think you’ve found a bug? Want to see a new feature in libmongoc? Please open a case in our issue management tool, JIRA:

Bug reports in JIRA for all driver projects (i.e. CDRIVER, CSHARP, JAVA) and the Core Server (i.e. SERVER) project are public.

How To Ask For Help

If you are having difficulty building the driver after reading the below instructions, please email the mongodb-user list to ask for help. Please include in your email all of the following information:

  • The version of the driver you are trying to build (branch or tag).
    • Examples: master branch, 1.9.5 tag
  • Host OS, version, and architecture.
    • Examples: Windows 10 64-bit x86, Ubuntu 16.04 64-bit x86, macOS 10.13
  • C Compiler and version.
    • Examples: GCC 7.3.0, Visual Studio Community 2017, clang 3.9, XCode 9.3
  • The output of cmake.
  • The text of the error you encountered.

Failure to include the relevant information will delay a useful response. Here is a made-up example of a help request that provides the relevant information:

Hello, I'm trying to build the C driver with Kerberos support, from mongo-c-driver-1.9.5.tar.gz. I'm on Ubuntu 16.04, 64-bit Intel, with gcc 5.4.0. I run CMake like:

$ cmake .
-- The C compiler identification is ;GNU 5.4.0
-- Check for working C compiler: /usr/bin/cc
-- Check for working C compiler: /usr/bin/cc -- works

... SNIPPED OUTPUT, but when you ask for help, include full output without any omissions ...

-- Searching for libsasl2
--   Not found (specify -DCMAKE_LIBRARY_PATH=/path/to/sasl/lib for SASL support)
CMake Error at CMakeLists.txt:10 (_message):
    SASL not found

Can you tell me what I need to install? Thanks!

Security Vulnerabilities

If you’ve identified a security vulnerability in a driver or any other MongoDB project, please report it according to the instructions here.

Installation

Detailed installation instructions are in the manual: http://mongoc.org/libmongoc/current/installing.html