Struct rkv::EnvironmentBuilder

pub struct EnvironmentBuilder { /* fields omitted */ }

Options for opening or creating an environment.

Methods

impl EnvironmentBuilder

pub fn open(&self, path: &Path) -> Result<Environment, Error>

Open an environment.

On UNIX, the database files will be opened with 644 permissions.

The path may not contain the null character.

pub fn open_with_permissions(     &self,     path: &Path,     mode: u32 ) -> Result<Environment, Error>

Open an environment with the provided UNIX permissions.

On Windows, the permissions will be ignored.

The path may not contain the null character.

pub fn set_flags(&mut self, flags: EnvironmentFlags) -> &mut EnvironmentBuilder

pub fn set_max_readers(&mut self, max_readers: u32) -> &mut EnvironmentBuilder

Sets the maximum number of threads or reader slots for the environment.

This defines the number of slots in the lock table that is used to track readers in the the environment. The default is 126. Starting a read-only transaction normally ties a lock table slot to the current thread until the environment closes or the thread exits. If MDB_NOTLS is in use, Environment::open_txn instead ties the slot to the Transaction object until it or the Environment object is destroyed.

pub fn set_max_dbs(&mut self, max_readers: u32) -> &mut EnvironmentBuilder

Sets the maximum number of named databases for the environment.

This function is only needed if multiple databases will be used in the environment. Simpler applications that use the environment as a single unnamed database can ignore this option.

Currently a moderate number of slots are cheap but a huge number gets expensive: 7-120 words per transaction, and every Transaction::open_db does a linear search of the opened slots.

pub fn set_map_size(&mut self, map_size: usize) -> &mut EnvironmentBuilder

Sets the size of the memory map to use for the environment.

The size should be a multiple of the OS page size. The default is 10485760 bytes. The size of the memory map is also the maximum size of the database. The value should be chosen as large as possible, to accommodate future growth of the database. It may be increased at later times.

Any attempt to set a size smaller than the space already consumed by the environment will be silently changed to the current size of the used space.

Trait Implementations

impl Clone for EnvironmentBuilder

fn clone(&self) -> EnvironmentBuilder

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for EnvironmentBuilder

fn fmt(&self, f: &mut Formatter) -> Result<(), Error>

Formats the value using the given formatter.

impl Copy for EnvironmentBuilder

impl Eq for EnvironmentBuilder

impl PartialEq<EnvironmentBuilder> for EnvironmentBuilder

fn eq(&self, other: &EnvironmentBuilder) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &EnvironmentBuilder) -> bool

This method tests for !=.