mongoc_client_get_server_status(3)

mongoc_client_get_server_status3

Usage

bool
mongoc_client_get_server_status (mongoc_client_t *client,
                                 mongoc_read_prefs_t *read_prefs,
                                 bson_t *reply,
                                 bson_error_t *error);

Queries the server for the current server status. The result is stored in reply.

reply is always initialized, even in the case of failure. Always call bson_destroy() to release it.

WARNING:

Deprecated since version 1.10.0: Run the serverStatus command directly with mongoc_client_read_command_with_opts() instead.

Parameters

•

client: A mongoc_client_t.

•

read_prefs: A mongoc_read_prefs_t.

•

reply: A maybe-NULL pointer to overwritable storage for a bson_t to contain the results.

•

error: An optional location for a bson_error_t or NULL.

Errors

Errors are propagated via the error parameter.

Returns

Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

Releases

5 releases since Debian 9 (Stretch); the text changed 4 times.

  1. 9
  2. 10
  3. 11
  4. 12
  5. 13

Author

MongoDB, Inc

From libmongoc-doc 1.30.4-1+deb13u3 in Debian 13 (Trixie). Parsed by carta from the page's man source.