NAME¶

SUPPORTED PLATFORMS¶

The library supports the following operating systems and CPU architectures:

•

GNU/Linux

•

Solaris 11

•

Mac OS X 10.6 and newer

•

Windows Vista, 7, and 8

•

FreeBSD

•

x86 and x86_64

•

ARM

•

PPC

•

SPARC

•

GCC 4.1 and newer

•

Clang 3.3 and newer

•

Microsoft Visual Studio 2010 and newer

•

Oracle Solaris Studio 12

•

MinGW

INSTALL WITH A PACKAGE MANAGER¶

$ apt-get install libbson-1.0

For RedHat‐like systems, use Remi Collet's well‐maintained RPMs for libbson. Commands to enable Remi's repository and install libbson depend on your exact system. For example, on CentOS 6:

$ yum install http://rpms.remirepo.net/enterprise/remi-release-6.rpm $ yum install yum-utils $ yum-config-manager --enable remi $ yum update $ yum install libbson

The Configuration Wizard for Remi's RPM Repository generates detailed instructions for your system.

INSTALLING FROM SOURCE¶

The most recent release of libbson is 1.4.2 and can be downloaded here

$ wget https://github.com/mongodb/libbson/releases/download/1.4.2/libbson-1.4.2.tar.gz $ tar -xzf libbson-1.4.2.tar.gz $ cd libbson-1.4.2/

Minimal dependencies are needed to build Libbson. On UNIX‐like systems, pthreads (the POSIX threading library) is required.

Make sure you have access to a supported toolchain such as GCC, Clang, SolarisStudio, or MinGW. Optionally, pkg-config can be used if your system supports it to simplify locating proper compiler and linker arguments when compiling your program.

The following will configure for a typical 64‐bit Linux system such as RedHat Enterprise Linux 6 or CentOS 6. Note that not all systems place 64‐bit libraries in /usr/lib64

$ ./configure --prefix=/usr --libdir=/usr/lib64

If configure completed successfully, you'll see something like the following describing your build configuration.

libbson was configured with the following options:
Build configuration:
  Enable debugging (slow)                          : no
  Enable extra alignment (required for 1.0 ABI)    : no
  Compile with debug symbols (slow)                : no
  Enable GCC build optimization                    : yes
  Enable automatic binary hardening                : yes
  Code coverage support                            : no
  Cross Compiling                                  : no
  Big endian                                       : no
  Link Time Optimization (experimental)            : no
Documentation:
  man                                              : yes
  HTML                                             : no

We can now build libbson with the venerable make program.

$ make

NOTE

To install the driver, we use make with the install target.

$ sudo make install

NOTE

BUILDING ON WINDOWS¶

Let's start by generating Visual Studio project files for libbson. The following assumes we are compiling for 64‐bit Windows using Visual Studio 2010 Express which can be freely downloaded from Microsoft.

> cd libbson-1.4.2 > cmake -G Visual Studio 14 2015 Win64 -DCMAKE_INSTALL_PREFIX=C: > msbuild.exe ALL_BUILD.vcxproj > msbuild.exe INSTALL.vcxproj

You should now see libbson installed in C: You can disable building the tests with: > cmake -G Visual Studio 14 2015 Win64 -DCMAKE_INSTALL_PREFIX=C:

COLOPHON¶