text: /*
   * Copyright 2013 MongoDB, Inc.
   *
   * Licensed under the Apache License, Version 2.0 (the "License");
   * you may not use this file except in compliance with the License.
   * You may obtain a copy of the License at
   *
   *   http://www.apache.org/licenses/LICENSE-2.0
   *
   * Unless required by applicable law or agreed to in writing, software
   * distributed under the License is distributed on an "AS IS" BASIS,
   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   * See the License for the specific language governing permissions and
   * limitations under the License.
   */
  
  #ifndef MONGOC_CLIENT_H
  #define MONGOC_CLIENT_H
  
  #if !defined (MONGOC_INSIDE) && !defined (MONGOC_COMPILATION)
  # error "Only <mongoc.h> can be included directly."
  #endif
  
  #include <bson.h>
  
  #include "mongoc-apm.h"
  #include "mongoc-collection.h"
  #include "mongoc-config.h"
  #include "mongoc-cursor.h"
  #include "mongoc-database.h"
  #include "mongoc-gridfs.h"
  #include "mongoc-index.h"
  #include "mongoc-read-prefs.h"
  #ifdef MONGOC_ENABLE_SSL
  # include "mongoc-ssl.h"
  #endif
  #include "mongoc-stream.h"
  #include "mongoc-uri.h"
  #include "mongoc-write-concern.h"
  #include "mongoc-read-concern.h"
  #include "mongoc-server-description.h"
  
  
  BSON_BEGIN_DECLS
  
  
  #define MONGOC_NAMESPACE_MAX 128
  
  
  #ifndef MONGOC_DEFAULT_CONNECTTIMEOUTMS
  #define MONGOC_DEFAULT_CONNECTTIMEOUTMS (10 * 1000L)
  #endif
  
  
  #ifndef MONGOC_DEFAULT_SOCKETTIMEOUTMS
  /*
   * NOTE: The default socket timeout for connections is 5 minutes. This
   *       means that if your MongoDB server dies or becomes unavailable
   *       it will take 5 minutes to detect this.
   *
   *       You can change this by providing sockettimeoutms= in your
   *       connection URI.
   */
  #define MONGOC_DEFAULT_SOCKETTIMEOUTMS (1000L * 60L * 5L)
  #endif
  
  
  /**
   * mongoc_client_t:
   *
   * The mongoc_client_t structure maintains information about a connection to
   * a MongoDB server.
   */
  typedef struct _mongoc_client_t mongoc_client_t;
  
  
  /**
   * mongoc_stream_initiator_t:
   * @uri: The uri and options for the stream.
   * @host: The host and port (or UNIX domain socket path) to connect to.
   * @user_data: The pointer passed to mongoc_client_set_stream_initiator.
   * @error: A location for an error.
   *
   * Creates a new mongoc_stream_t for the host and port. Begin a
   * non-blocking connect and return immediately.
   *
   * This can be used by language bindings to create network transports other
   * than those built into libmongoc. An example of such would be the streams
   * API provided by PHP.
   *
   * Returns: A newly allocated mongoc_stream_t or NULL on failure.
   */
  typedef mongoc_stream_t *(*mongoc_stream_initiator_t) (const mongoc_uri_t       *uri,
                                                         const mongoc_host_list_t *host,
                                                         void                     *user_data,
                                                         bson_error_t             *error);
  
  
  BSON_API
  mongoc_client_t               *mongoc_client_new                           (const char                   *uri_string);
  BSON_API
  mongoc_client_t               *mongoc_client_new_from_uri                  (const mongoc_uri_t           *uri);
  BSON_API
  const mongoc_uri_t            *mongoc_client_get_uri                       (const mongoc_client_t        *client);
  BSON_API
  void                           mongoc_client_set_stream_initiator          (mongoc_client_t              *client,
                                                                              mongoc_stream_initiator_t     initiator,
                                                                              void                         *user_data);
  BSON_API
  mongoc_cursor_t               *mongoc_client_command                       (mongoc_client_t              *client,
                                                                              const char                   *db_name,
                                                                              mongoc_query_flags_t          flags,
                                                                              uint32_t                      skip,
                                                                              uint32_t                      limit,
                                                                              uint32_t                      batch_size,
                                                                              const bson_t                 *query,
                                                                              const bson_t                 *fields,
                                                                              const mongoc_read_prefs_t    *read_prefs);
  BSON_API
  void                           mongoc_client_kill_cursor                   (mongoc_client_t *client,
                                                                              int64_t          cursor_id) BSON_GNUC_DEPRECATED;
  BSON_API
  bool                           mongoc_client_command_simple                (mongoc_client_t              *client,
                                                                              const char                   *db_name,
                                                                              const bson_t                 *command,
                                                                              const mongoc_read_prefs_t    *read_prefs,
                                                                              bson_t                       *reply,
                                                                              bson_error_t                 *error);
  BSON_API
  bool                           mongoc_client_read_command_with_opts        (mongoc_client_t              *client,
                                                                              const char                   *db_name,
                                                                              const bson_t                 *command,
                                                                              const mongoc_read_prefs_t    *read_prefs,
                                                                              const bson_t                 *opts,
                                                                              bson_t                       *reply,
                                                                              bson_error_t                 *error);
  BSON_API
  bool                           mongoc_client_write_command_with_opts       (mongoc_client_t              *client,
                                                                              const char                   *db_name,
                                                                              const bson_t                 *command,
                                                                              const bson_t                 *opts,
                                                                              bson_t                       *reply,
                                                                              bson_error_t                 *error);
  BSON_API
  bool                           mongoc_client_read_write_command_with_opts  (mongoc_client_t              *client,
                                                                              const char                   *db_name,
                                                                              const bson_t                 *command,
                                                                              const mongoc_read_prefs_t    *read_prefs,
                                                                              const bson_t                 *opts,
                                                                              bson_t                       *reply,
                                                                              bson_error_t                 *error);
  BSON_API
  bool                           mongoc_client_command_simple_with_server_id (mongoc_client_t              *client,
                                                                              const char                   *db_name,
                                                                              const bson_t                 *command,
                                                                              const mongoc_read_prefs_t    *read_prefs,
                                                                              uint32_t                      server_id,
                                                                              bson_t                       *reply,
                                                                              bson_error_t                 *error);
  BSON_API
  void                           mongoc_client_destroy                       (mongoc_client_t              *client);
  BSON_API
  mongoc_database_t             *mongoc_client_get_database                  (mongoc_client_t              *client,
                                                                              const char                   *name);
  BSON_API
  mongoc_database_t             *mongoc_client_get_default_database          (mongoc_client_t              *client);
  BSON_API
  mongoc_gridfs_t               *mongoc_client_get_gridfs                    (mongoc_client_t              *client,
                                                                              const char                   *db,
                                                                              const char                   *prefix,
                                                                              bson_error_t                 *error);
  BSON_API
  mongoc_collection_t           *mongoc_client_get_collection                (mongoc_client_t              *client,
                                                                              const char                   *db,
                                                                              const char                   *collection);
  BSON_API
  char                         **mongoc_client_get_database_names            (mongoc_client_t              *client,
                                                                              bson_error_t                 *error);
  BSON_API
  mongoc_cursor_t               *mongoc_client_find_databases                (mongoc_client_t              *client,
                                                                              bson_error_t                 *error);
  BSON_API
  bool                           mongoc_client_get_server_status             (mongoc_client_t              *client,
                                                                              mongoc_read_prefs_t          *read_prefs,
                                                                              bson_t                       *reply,
                                                                              bson_error_t                 *error);
  BSON_API
  int32_t                        mongoc_client_get_max_message_size          (mongoc_client_t              *client) BSON_GNUC_DEPRECATED;
  BSON_API
  int32_t                        mongoc_client_get_max_bson_size             (mongoc_client_t              *client) BSON_GNUC_DEPRECATED;
  BSON_API
  const mongoc_write_concern_t  *mongoc_client_get_write_concern             (const mongoc_client_t        *client);
  BSON_API
  void                           mongoc_client_set_write_concern             (mongoc_client_t              *client,
                                                                              const mongoc_write_concern_t *write_concern);
  BSON_API
  const mongoc_read_concern_t   *mongoc_client_get_read_concern              (const mongoc_client_t        *client);
  BSON_API
  void                           mongoc_client_set_read_concern              (mongoc_client_t              *client,
                                                                              const mongoc_read_concern_t  *read_concern);
  BSON_API
  const mongoc_read_prefs_t     *mongoc_client_get_read_prefs                (const mongoc_client_t        *client);
  BSON_API
  void                           mongoc_client_set_read_prefs                (mongoc_client_t              *client,
                                                                              const mongoc_read_prefs_t    *read_prefs);
  #ifdef MONGOC_ENABLE_SSL
  BSON_API
  void                           mongoc_client_set_ssl_opts                  (mongoc_client_t              *client,
                                                                              const mongoc_ssl_opt_t       *opts);
  #endif
  BSON_API
  bool                           mongoc_client_set_apm_callbacks             (mongoc_client_t              *client,
                                                                              mongoc_apm_callbacks_t       *callbacks,
                                                                              void                         *context);
  BSON_API
  mongoc_server_description_t   *mongoc_client_get_server_description        (mongoc_client_t              *client,
                                                                              uint32_t                      server_id);
  BSON_API
  mongoc_server_description_t  **mongoc_client_get_server_descriptions       (const mongoc_client_t        *client,
                                                                              size_t                       *n);
  BSON_API
  void                           mongoc_server_descriptions_destroy_all      (mongoc_server_description_t **sds,
                                                                              size_t                        n);
  BSON_API
  mongoc_server_description_t   *mongoc_client_select_server                 (mongoc_client_t              *client,
                                                                              bool                          for_writes,
                                                                              const mongoc_read_prefs_t    *prefs,
                                                                              bson_error_t                 *error);
  BSON_API
  bool                           mongoc_client_set_error_api                 (mongoc_client_t              *client,
                                                                              int32_t                       version);
  BSON_API
  bool                           mongoc_client_set_appname                   (mongoc_client_t              *client,
                                                                              const char                   *appname);
  BSON_END_DECLS
  
  
  #endif /* MONGOC_CLIENT_H */
  