Berkeley DB: DB_ENV->rep_set_config
Description: Berkeley DB: An embedded database programmatic toolkit.
Keywords: embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++

### DB_ENV->rep_set_config |

`

###

    #include <db.h>

    int
    DB_ENV->rep_set_config(DB_ENV *env, u_int32_t which, int onoff);

    int
    DB_ENV->rep_get_config(DB_ENV *dbenv, u_int32_t which, int *onoffp);

### Description: DB_ENV->rep_set_config

The DB_ENV->rep_set_config method method configures the Berkeley DB replication subsystem.

The database environment's replication subsystem may also be configured using the environment's DB_CONFIG file. The syntax of the entry in that file is a single line with the string "rep_set_config", one or more whitespace characters, and the method which parameter as a string; for example, "rep_set_config REP_CONF_NOWAIT". Because the DB_CONFIG file is read when the database environment is opened, it will silently overrule configuration done before that time.

The DB_ENV->rep_set_config method configures a database environment, not only operations performed using the specified DB_ENV handle.

The DB_ENV->rep_set_config method may be called at any time during the life of the application.

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

### Parameters

onoff
  If the onoff parameter is zero, the configuration flag is turned off. Otherwise, it is turned on.
which
  The which parameter must be set to one of the following values:
  DB_REP_CONF_BULK
    The replication master sends groups of records to the clients in a single network transfer (defaults to off).
  DB_REP_CONF_DELAYCLIENT
    The client should delay synchronizing to a newly declared master (defaults to off). Clients configured in this way will remain unsynchronized until the application calls the DB_ENV->rep_sync method.
  DB_REP_CONF_NOAUTOINIT
    The replication master will not automatically re-initialize outdated clients (defaults to off).

    The DB_REP_CONF_NOAUTOINIT flag is not supported by Replication Manager.

  DB_REP_CONF_NOWAIT
    Berkeley DB method calls that would normally block while clients are in recovery will return errors immediately (defaults to off).

### Errors

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

EINVAL
  An invalid flag value or parameter was specified.

### Description: DB_ENV->rep_get_config

The DB_ENV->rep_get_config method returns whether the specified which parameter is currently set or not.

The DB_ENV->rep_get_config method may be called at any time during the life of the application.

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

### Parameters

which
  The which parameter is the message value for which configuration is being checked.
onoffp
  The onoffp parameter references memory into which the configuration of the specified which parameter is copied. If the returned onoff value is zero, the parameter is off; otherwise on.

### Class

DB_ENV

### See Also

Replication and Related Methods`

Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.