#include <db.h> int DB_ENV->rep_sync(DB_ENV *env, u_int32_t flags);
The DB_ENV->rep_sync() method forces master synchronization to begin
for this client. This method is the other half of setting the
DB_REP_CONF_DELAYCLIENT
flag via the
DB_ENV->rep_set_config()
method.
If an application has configured delayed master synchronization, the
application must synchronize explicitly (otherwise the client will
remain out-of-date and will ignore all database changes forwarded from
the replication group master). The DB_ENV->rep_sync() method may be
called any time after the client application learns that the new
master has been established (by receiving a
DB_EVENT_REP_NEWMASTER
event notification).
Before calling this method, the enclosing database environment must already have been opened by calling the DB_ENV->open() method and must already have been configured to send replication messages by calling the DB_ENV->rep_set_transport() method.
The DB_ENV->rep_sync()
method returns a non-zero error value on failure and 0 on success.
The DB_ENV->rep_sync()
method may fail and return one of the following non-zero errors:
If master synchronization requires an internal initialization but automatic
internal initializations have been disabled by setting the
DB_REP_CONF_AUTOINIT
flag to 0.
If the database environment was not already configured to communicate with a replication group by a call to DB_ENV->rep_set_transport() ; the database environment was not already opened; or if an invalid flag value or parameter was specified.