rust-gcrypt

Libgcrypt bindings for Rust.

Version 1.5.0 or greater of libgcrypt is required to use this wrapper. Some features may require a more recent version.

The libgcrypt-sys crate requires the libgcrypt-config binary to be executable in order to build the crate. The path to this binary can be set using the environment variable LIBGCRYPT_CONFIG. A working installation of gcc is also required.

The required libraries and binaries can be installed by running:

Debian / Ubuntu

shell $ sudo apt-get install libgcrypt11-dev or shell $ sudo apt-get install libgcrypt20-dev

RHEL / CentOS / Fedora

shell $ sudo yum install libgcrypt-devel

Mac OS X

shell $ brew install libgcrypt

Usage

Put this in your Cargo.toml:

toml [dependencies] gcrypt = "0.2"

And this in your crate root:

rust extern crate gcrypt;

The library must be initialized using gcrypt::init or gcrypt::init_fips_mode before using any other function in the library or wrapper. An example of initialization can be found in the setup function in tests/basic.rs (NB: the enable_quick_random option should not be used in most cases). More information on initialization can be found in the libgcrypt documentation.