DB_ENV->rep_stat API Ref

#include <db.h>

int DB_ENV->rep_stat(DB_ENV *env, DB_REP_STAT **statp, u_int32_t flags);

int DB_ENV->rep_stat_print(DB_ENV *env, u_int32_t flags);


Description: DB_ENV->rep_stat

The DB_ENV->rep_stat method returns the replication subsystem statistics.

The DB_ENV->rep_stat method creates a statistical structure of type DB_REP_STAT and copies a pointer to it into a user-specified memory location.

Statistical structures are stored in allocated memory. If application-specific allocation routines have been declared (see DB_ENV->set_alloc for more information), they are used to allocate the memory; otherwise, the standard C library malloc(3) is used. The caller is responsible for deallocating the memory. To deallocate the memory, free the memory reference; references inside the returned memory need not be individually freed.

The following DB_REP_STAT fields will be filled in:


u_int32_t st_bulk_fills; u_int32_t st_bulk_overflows; u_int32_t st_bulk_records; u_int32_t st_bulk_transfers; u_int32_t st_client_rerequests; u_int32_t st_client_svc_miss; u_int32_t st_client_svc_req; u_int32_t st_dupmasters; u_int32_t st_egen; u_int32_t st_election_cur_winner; u_int32_t st_election_gen; DB_LSN st_election_lsn; u_int32_t st_election_nsites; u_int32_t st_election_nvotes; u_int32_t st_election_priority; u_int32_t st_election_sec; u_int32_t st_election_status; u_int32_t st_election_tiebreaker; u_int32_t st_election_usec; u_int32_t st_election_votes; u_int32_t st_elections; u_int32_t st_elections_won; u_int32_t st_env_id; u_int32_t st_env_priority; u_int32_t st_gen; u_int32_t st_log_duplicated; u_int32_t st_log_queued; u_int32_t st_log_queued_max; u_int32_t st_log_queued_total; u_int32_t st_log_records; u_int32_t st_log_requested; u_int32_t st_master; u_int32_t st_master_changes; u_int32_t st_max_lease_sec; u_int32_t st_max_lease_usec; DB_LSN st_max_perm_lsn; u_int32_t st_msgs_badgen; u_int32_t st_msgs_processed; u_int32_t st_msgs_recover; u_int32_t st_msgs_send_failures; u_int32_t st_msgs_sent; u_int32_t st_newsites; DB_LSN st_next_lsn; u_int32_t st_next_pg; u_int32_t st_nsites; u_int32_t st_nthrottles; u_int32_t st_outdated; u_int32_t st_pg_duplicated; u_int32_t st_pg_records; u_int32_t st_pg_requested; u_int32_t st_startsync_delayed; u_int32_t st_startup_complete; u_int32_t st_status; u_int32_t st_txns_applied; DB_LSN st_waiting_lsn; u_int32_t st_waiting_pg;

The DB_ENV->rep_stat method may not be called before the DB_ENV->open method is called.

The DB_ENV->rep_stat method returns a non-zero error value on failure and 0 on success.

Parameters
flags statp

Errors

The DB_ENV->rep_stat method may fail and return one of the following non-zero errors:


EINVAL

Description: DB_ENV->rep_stat_print

The DB_ENV->rep_stat_print method displays the replication subsystem statistical information, as described for the DB_ENV->rep_stat method. The information is printed to a specified output channel (see the DB_ENV->set_msgfile method for more information), or passed to an application callback function (see the DB_ENV->set_msgcall method for more information).

The DB_ENV->rep_stat_print method may not be called before the DB_ENV->open method is called.

The DB_ENV->rep_stat_print method returns a non-zero error value on failure and 0 on success.

Parameters
flags


Class DB_ENV
See Also Replication and Related Methods

APIRef

Copyright (c) 1996,2008 Oracle. All rights reserved.