/mongo-c-driver

A high-performance MongoDB driver for C
  1. C 75.6%
  2. Shell 6.9%
  3. C++ 5.5%
  4. Assembly 2.4%
  5. M4 1.8%
  6. Ada 1.5%
  7. Other 6.3%
C Shell C++ Assembly M4 Ada Other

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Open in Desktop Download ZIP
Find file
Switch branches/tags
Nothing to show
Latest commit 2ba1fdb Sep 25, 2017 @kevinAlbs kevinAlbs committed with ajdavis CDRIVER-2233 add change stream tests
Permalink
Failed to load latest commit information.
.evergreen show backtrace after abort on evergreen Sep 22, 2017
.travis.scripts CDRIVER-2281 Improve travis debugging Sep 14, 2017
build CDRIVER-2233 add change stream tests Sep 27, 2017
doc CDRIVER-2233 add change stream implementation Sep 27, 2017
examples CDRIVER-2233 Add interface for change streams Sep 19, 2017
orchestration_configs CDRIVER-2116 Enable compression support by default Jun 16, 2017
src CDRIVER-2233 add change stream implementation Sep 27, 2017
tests CDRIVER-2233 add change stream tests Sep 27, 2017
.clang-format CDRIVER-1167 Add clang-format file, and remove uncrustify Dec 12, 2016
.gitattributes CDRIVER-929 line-endings in test data files Oct 19, 2015
.gitignore CDRIVER-2192 add mongoc_session_t Sep 12, 2017
.gitmodules Ignore stray files/changes in submodules Oct 6, 2015
.travis.yml CDRIVER-2281 Build on osx too Sep 14, 2017
CMakeLists.txt CDRIVER-2233 add change stream tests Sep 27, 2017
CONTRIBUTING.md update CONTRIBUTING Sep 26, 2017
COPYING doc: drop appendix from license. Mar 13, 2014
Makefile.am CDRIVER-2145 CMake option ENABLE_MAINTAINER_FLAGS Aug 7, 2017
NEWS Fix typos Sep 15, 2017
README.rst CDRIVER-1912 update installation instructions Jan 27, 2017
THIRD_PARTY_NOTICES CDRIVER-2209 Bundle snappy-1.1.3 & zlib-1.2.11 Jul 14, 2017
VERSION_CURRENT Bump current version Aug 29, 2017
VERSION_RELEASED update NEWS for 1.7.0 Aug 11, 2017
autogen.sh CDRIVER-1080: Warn when downloading non-releases from Github Apr 14, 2016
configure.ac CDRIVER-2257 util function to retrieve SRV records Sep 1, 2017
valgrind.suppressions CDRIVER-1884 leaks in mock server tests Dec 10, 2016

README.rst

mongo-c-driver

About

mongo-c-driver is a client library written in C for MongoDB.

mongo-c-driver depends on Libbson. Libbson will automatically be built if you do not have it installed on your system.

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.2.1 tag
  • Host OS, version, and architecture.
    • Examples: Windows 8 64-bit x86, Ubuntu 12.04 32-bit x86, OS X Mavericks
  • C Compiler and version.
    • Examples: GCC 4.8.2, MSVC 2013 Express, clang 3.4, XCode 5
  • The output of ./autogen.sh or ./configure (depending on whether you are building from a repository checkout or from a tarball). The output starting from "libbson was configured with the following options" is sufficient.
  • The text of the error you encountered.

Failure to include the relevant information will result in additional round-trip communications to ascertain the necessary details, delaying 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 SSL, from mongo-c-driver-1.2.1.tar.gz. I'm on Ubuntu 14.04, 64-bit Intel, with gcc 4.8.2. I run configure like:

$ ./configure --enable-sasl=yes
checking for gcc... gcc
checking whether the C compiler works... yes

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

checking for pkg-config... no
checking for SASL... no
checking for sasl_client_init in -lsasl2... no
checking for sasl_client_init in -lsasl... no
configure: error: You must install the Cyrus SASL libraries and development headers to enable SASL support.

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