Safe Rust bindings for LMDB with encryption at rest
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
lmdb-rs/src/lib.rs

106 lines
2.4 KiB

//! Idiomatic and safe APIs for interacting with the
//! [Lightning Memory-mapped Database (LMDB)](https://symas.com/lmdb).
#![deny(missing_docs)]
#![doc(html_root_url = "https://docs.rs/lmdb-rkv/0.12.0")]
extern crate byteorder;
extern crate libc;
extern crate lmdb_sys as ffi;
#[cfg(test)]
extern crate tempdir;
#[macro_use]
extern crate bitflags;
pub use cursor::{
Cursor,
Iter,
IterDup,
RoCursor,
RwCursor,
};
pub use database::Database;
pub use environment::{
Environment,
EnvironmentBuilder,
Info,
Stat,
};
pub use error::{
Error,
Result,
};
pub use flags::*;
pub use transaction::{
InactiveTransaction,
RoTransaction,
RwTransaction,
Transaction,
};
macro_rules! lmdb_try {
($expr:expr) => {{
match $expr {
::ffi::MDB_SUCCESS => (),
err_code => return Err(::Error::from_err_code(err_code)),
}
}};
}
macro_rules! lmdb_try_with_cleanup {
($expr:expr, $cleanup:expr) => {{
match $expr {
::ffi::MDB_SUCCESS => (),
err_code => {
let _ = $cleanup;
return Err(::Error::from_err_code(err_code));
},
}
}};
}
mod cursor;
mod database;
mod environment;
mod error;
mod flags;
mod transaction;
#[cfg(test)]
mod test_utils {
use byteorder::{
ByteOrder,
LittleEndian,
};
use tempdir::TempDir;
use super::*;
/// Regression test for https://github.com/danburkert/lmdb-rs/issues/21.
/// This test reliably segfaults when run against lmbdb compiled with opt level -O3 and newer
/// GCC compilers.
#[test]
fn issue_21_regression() {
const HEIGHT_KEY: [u8; 1] = [0];
let dir = TempDir::new("test").unwrap();
let env = {
let mut builder = Environment::new();
builder.set_max_dbs(2);
builder.set_map_size(1_000_000);
builder.open(dir.path()).expect("open lmdb env")
};
let index = env.create_db(None, DatabaseFlags::DUP_SORT).expect("open index db");
for height in 0..1000 {
let mut value = [0u8; 8];
LittleEndian::write_u64(&mut value, height);
let mut tx = env.begin_rw_txn().expect("begin_rw_txn");
tx.put(index, &HEIGHT_KEY, &value, WriteFlags::empty()).expect("tx.put");
tx.commit().expect("tx.commit")
}
}
}