This library provides Rust FFI interface to the mtbl C library for dealing with SSTables (write-once sorted map files).
SSTables are basically constant on-disk maps, like those used by CDB (which also has Rust bindings, except using sorted maps instead of hashmaps. For more information, see the mtbl README.
Version 0.2.X of mtbl-sys covers the 0.8 version of the MTBL C library.
In order to use the mtbl-sys
crate, you must have a Unix system with the
libmtbl
library installed where it can be found by pkg-config
.
On Debian-based Linux distributions, install the libmtbl-dev
package:
sudo apt-get install libmtbl-dev
Add mtbl-sys
as a dependency in Cargo.toml
:
[dependencies]
mtbl-sys = "0.1.0"
Import the mtbl_sys
crate and use the functions as they're defined in the
native libmtbl
library. See the libmtbl
API documention man pages for
more usage information.
extern crate mtbl_sys as mtbl;
For documentation about each function, see MTBL's extensive man pages, e.g.
man mtbl_reader
.
Copyright 2016 Leon Barrett
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT) at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.