Provided by: libmongoc-doc_1.15.0-1_all bug

NAME

       mongoc_session_opts_new - mongoc_session_opts_new()

SYNOPSIS

          mongoc_session_opt_t *
          mongoc_session_opts_new (void);

       Start  a  session  with  mongoc_client_start_session,  use  the  session for a sequence of
       operations     and     multi-document     transactions,     then     free     it      with
       mongoc_client_session_destroy().  Any  mongoc_cursor_t  or  mongoc_change_stream_t using a
       session must be destroyed before the session, and a session must be destroyed  before  the
       mongoc_client_t it came from.

       By  default,  sessions  are  causally  consistent.  To  disable causal consistency, before
       starting a session create a mongoc_session_opt_t with mongoc_session_opts_new()  and  call
       mongoc_session_opts_set_causal_consistency(),     then     free     the     struct    with
       mongoc_session_opts_destroy.

       Unacknowledged writes are prohibited with sessions.

       A mongoc_client_session_t must be used by only one  thread  at  a  time.  Due  to  session
       pooling, mongoc_client_start_session may return a session that has been idle for some time
       and is about to be closed after its idle timeout. Use the session  within  one  minute  of
       acquiring it to refresh the session and avoid a timeout.

       See the example code for mongoc_session_opts_set_causal_consistency.

AUTHOR

       MongoDB, Inc

COPYRIGHT

       2017-present, MongoDB, Inc