diff options
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 39 |
1 files changed, 24 insertions, 15 deletions
@@ -1,12 +1,11 @@ -rust-rocksdb -============ -![RocksDB build](https://github.com/rust-rocksdb/rust-rocksdb/workflows/RocksDB%20build/badge.svg?branch=master) +# rust-rocksdb + +[![RocksDB build](https://github.com/rust-rocksdb/rust-rocksdb/actions/workflows/rust.yml/badge.svg?branch=master)](https://github.com/rust-rocksdb/rust-rocksdb/actions/workflows/rust.yml) [![crates.io](https://img.shields.io/crates/v/rocksdb.svg)](https://crates.io/crates/rocksdb) [![documentation](https://docs.rs/rocksdb/badge.svg)](https://docs.rs/rocksdb) [![license](https://img.shields.io/crates/l/rocksdb.svg)](https://github.com/rust-rocksdb/rust-rocksdb/blob/master/LICENSE) -[![Gitter chat](https://badges.gitter.im/rust-rocksdb/gitter.png)](https://gitter.im/rust-rocksdb/lobby) -![rust 1.66.0 required](https://img.shields.io/badge/rust-1.66.0-blue.svg?label=MSRV) - +[![Gitter chat](https://badges.gitter.im/rust-rocksdb/gitter.svg)](https://gitter.im/rust-rocksdb/lobby) +![rust 1.70.0 required](https://img.shields.io/badge/rust-1.70.0-blue.svg?label=MSRV) ![GitHub commits (since latest release)](https://img.shields.io/github/commits-since/rust-rocksdb/rust-rocksdb/latest.svg) @@ -16,7 +15,7 @@ rust-rocksdb ## Contributing -Feedback and pull requests welcome! If a particular feature of RocksDB is +Feedback and pull requests welcome! If a particular feature of RocksDB is important to you, please let me know by opening an issue, and I'll prioritize it. @@ -26,18 +25,21 @@ This binding is statically linked with a specific version of RocksDB. If you want to build it yourself, make sure you've also cloned the RocksDB and compression submodules: - git submodule update --init --recursive +```shell +git submodule update --init --recursive +``` ## Compression Support -By default, support for the [Snappy](https://github.com/google/snappy), + +By default, support for [Snappy](https://github.com/google/snappy), [LZ4](https://github.com/lz4/lz4), [Zstd](https://github.com/facebook/zstd), [Zlib](https://zlib.net), and [Bzip2](http://www.bzip.org) compression -is enabled through crate features. If support for all of these compression +is enabled through crate features. If support for all of these compression algorithms is not needed, default features can be disabled and specific compression algorithms can be enabled. For example, to enable only LZ4 compression support, make these changes to your Cargo.toml: -``` +```toml [dependencies.rocksdb] default-features = false features = ["lz4"] @@ -45,9 +47,16 @@ features = ["lz4"] ## Multithreaded ColumnFamily alternation -The underlying RocksDB does allow column families to be created and dropped -from multiple threads concurrently. But this crate doesn't allow it by default +RocksDB allows column families to be created and dropped +from multiple threads concurrently, but this crate doesn't allow it by default for compatibility. If you need to modify column families concurrently, enable -crate feature called `multi-threaded-cf`, which makes this binding's -data structures to use RwLock by default. Alternatively, you can directly create +the crate feature `multi-threaded-cf`, which makes this binding's +data structures use `RwLock` by default. Alternatively, you can directly create `DBWithThreadMode<MultiThreaded>` without enabling the crate feature. + +## Switch between /MT or /MD run time library (Only for Windows) + +The feature `mt_static` will request the library to be built with [/MT](https://learn.microsoft.com/en-us/cpp/build/reference/md-mt-ld-use-run-time-library?view=msvc-170) +flag, which results in library using the static version of the run-time library. +*This can be useful in case there's a conflict in the dependecy tree between different +run-time versions.* |