1MONGOC_INSTALLING(3)               libmongoc              MONGOC_INSTALLING(3)
2
3
4

NOTE:

6          Much  of this section of documentation has been rewritten and moved:
7          Obtaining the MongoDB C Driver Libraries
8

SUPPORTED PLATFORMS

10       NOTE:
11          Moved: mongo-c-driver Platform Support
12

INSTALL LIBMONGOC WITH A PACKAGE MANAGER

14       NOTE:
15          Moved: Installing Prebuilt MongoDB C Driver Libraries
16

INSTALL LIBBSON WITH A PACKAGE MANAGER

18       NOTE:
19          Moved: Installing Prebuilt MongoDB C Driver Libraries
20

DOCKER IMAGE

22       You can find a Docker image in Docker Hub along with example  usage  of
23       using  libmongoc  to  ping a MongoDB database from within a Docker con‐
24       tainer.
25

BUILD ENVIRONMENT

27       NOTE:
28          Moved: Building the C Driver Libraries from Source
29
30   Uninstalling the installed components
31       There are two ways to uninstall  the  components  that  have  been  in‐
32       stalled.   The  first  is to invoke the uninstall program directly.  On
33       Linux/Unix:
34
35          $ sudo /usr/local/share/mongo-c-driver/uninstall.sh
36
37       On Windows:
38
39          $ C:\mongo-c-driver\share\mongo-c-driver\uninstall.bat
40
41       The second way to uninstall is from within the build directory,  assum‐
42       ing  that it is in the exact same state as when the install command was
43       invoked:
44
45          $ sudo cmake --build . --target uninstall
46
47       The second approach simply invokes the uninstall program referenced  in
48       the first approach.
49
50   Dealing with Build Failures
51       If  your attempt to build the C driver fails, please see the README for
52       instructions on requesting assistance.
53

ADDITIONAL OPTIONS FOR INTEGRATORS

55       In the event that you are building the BSON library and/or the C driver
56       to  embed with other components and you wish to avoid the potential for
57       collision with components installed from a standard  build  or  from  a
58       distribution package manager, you can make use of the BSON_OUTPUT_BASE‐
59       NAME and MONGOC_OUTPUT_BASENAME options to cmake.
60
61          $ cmake -DBSON_OUTPUT_BASENAME=custom_bson -DMONGOC_OUTPUT_BASENAME=custom_mongoc ..
62
63       The above command would produce libraries named  libcustom_bson.so  and
64       libcustom_mongoc.so  (or  with  the extension appropriate for the build
65       platform).  Those libraries could be placed in a standard system direc‐
66       tory  or  in an alternate location and could be linked to by specifying
67       something like -lcustom_mongoc -lcustom_bson on the linker command line
68       (possibly  adjusting  the  specific  flags  to  those  required by your
69       linker).
70

AUTHOR

72       MongoDB, Inc
73

75       2017-present, MongoDB, Inc
76
77
78
79
801.25.1                           Nov 08, 2023             MONGOC_INSTALLING(3)
Impressum