Provided by: libmongoc-doc_1.21.0-1build1_all bug

NAME

       mongoc_init_cleanup - Initialization and cleanup

SYNOPSIS

       Initialize  the  MongoDB  C Driver by calling mongoc_init exactly once at the beginning of
       your program. It is responsible for initializing global state such  as  process  counters,
       SSL, and threading primitives.

       Exception to this is mongoc_log_set_handler(), which should be called before mongoc_init()
       or some log traces would not use your log handling function. See Custom Log Handlers for a
       detailed example.

       Call  mongoc_cleanup  exactly  once  at  the end of your program to release all memory and
       other resources allocated by the driver. You must not call  any  other  MongoDB  C  Driver
       functions  after  mongoc_cleanup.  Note  that mongoc_init does not reinitialize the driver
       after mongoc_cleanup.

DEPRECATED FEATURE: AUTOMATIC INITIALIZATION AND CLEANUP

       On some platforms the driver can automatically call  mongoc_init  before  main,  and  call
       mongoc_cleanup  as  the  process  exits.  This  is problematic in situations where related
       libraries also execute cleanup code on shutdown, and it creates inconsistent rules  across
       platforms.  Therefore  the automatic initialization and cleanup feature is deprecated, and
       will be dropped in version 2.0. Meanwhile, for  backward  compatibility,  the  feature  is
       enabled by default on platforms where it is available.

       For  portable, future-proof code, always call mongoc_init and mongoc_cleanup yourself, and
       configure the driver like:

          cmake -DENABLE_AUTOMATIC_INIT_AND_CLEANUP=OFF

AUTHOR

       MongoDB, Inc

COPYRIGHT

       2017-present, MongoDB, Inc