rvm_set_options(3)

NAME
rvm_set_options - set RVM options

SYNOPSIS

#include "rvm.h"
typedef struct
    {
    char            *log_dev;
    long            truncate;
    rvm_length_t    recovery_buf_len;
    rvm_length_t    flush_buf_len;
    rvm_length_t    max_read_len;
    rvm_length_t    flags;
    }
rvm_options_t;
rvm_return_t rvm_set_options (options)
rvm_options_t    *options;    /* pointer to a options records */

DESCRIPTION
rvm_set_options allows RVM options to be changed after initialization. Only the options permitted to be selected after initialization will be considered. Others can be present, but will be ignored. Please refer to the RVM manual for detailed descriptions of the options. If the options parameter does not point to a valid descriptor, RVM_EOPTIONS will be returned. At present, the only options that can be changed are the following: truncation threshold and transaction optimization levels. If the truncation threshold is lowered and the log filled beyond the new threshold, a truncation is initiated if one is not in progress. If a truncation must be initiated, it will run synchronously with the calling thread. Transaction optimization levels can be changed at any time, but the level in effect at the beginning of a transaction remains in effect for that transaction until it is ended.

DIAGNOSTICS

RVM_SUCCESS
    success

RVM_EOPTIONS
    invalid options record or pointer

RVM_ENO_MEMORY
    heap exhausted

RVM_ELOG
    invalid log file

RVM_EINIT
    RVM not initialized

SEE ALSO
rvm_map (3), rvm_unmap (3), and rvm_query (3)

AUTHOR
Hank Mashburn