#cryptography #nettle

sys nettle-sys

Low-level Rust bindings for the Nettle cryptographic library

14 stable releases

2.1.0 Jan 31, 2022
2.0.8 Jun 7, 2021
2.0.7 Apr 29, 2021
2.0.6 Mar 8, 2021
0.1.0 Nov 30, 2017

#157 in #cryptography

Download history 557/week @ 2022-06-04 399/week @ 2022-06-11 361/week @ 2022-06-18 482/week @ 2022-06-25 271/week @ 2022-07-02 346/week @ 2022-07-09 357/week @ 2022-07-16 440/week @ 2022-07-23 563/week @ 2022-07-30 577/week @ 2022-08-06 707/week @ 2022-08-13 388/week @ 2022-08-20 440/week @ 2022-08-27 433/week @ 2022-09-03 453/week @ 2022-09-10 580/week @ 2022-09-17

1,984 downloads per month
Used in 20 crates (2 directly)

LGPL-3.0 OR GPL-2.0 OR GPL-3.0

28KB
266 lines

nettle-sys

Low-level Rust bindings for the Nettle cryptographic library.

The documentation can be found here.

Building

To build the Nettle bindings, you need a few libraries and support packages. Notably, you need the Nettle cryptographic library version 3.4.1 or up. Some cryptographic algorithms are only available if build against newer versions of Nettle, see optional features.

Please see below for OS-specific commands to install the needed libraries.

Debian

$ sudo apt install clang llvm pkg-config nettle-dev

Arch Linux

$ sudo pacman -S clang pkg-config nettle --needed

Fedora

$ sudo dnf install clang pkg-config nettle-devel

macOS (Mojave), using MacPorts

$ sudo port install nettle pkgconfig

Windows

MSYS2

You can install the needed libraries with the following command:

$ pacboy -S clang:x nettle:x

Optional features

Some cryptographic algorithms are only available if build against newer versions of Nettle. Support for each feature is detected at build time.

In case the automatic detection does not work for some reason, the optional algorithms can be enabled or disabled by setting the given environment variable.

Setting such a variable to 1, y, yes, enable, or true enables a feature. Any other value disables it.

Feature Required Nettle version Environment variable
cv448, ed448 >= 3.6 NETTLE_DISABLE_CV448

Cross compilation

nettle-sys can be cross compiled using cross and a custom Docker container. First, build the container and install cross:

cargo install cross
docker -t nettle-sys/<toolchain>:1 docker/<toolchain>

Then, you can cross compile the project:

cross --target <toolchain> -v

The build artifacts will be placed in target/debug/<toolchain>.

Static linking

By default, nettle-sys is dynamically linked to its dependencies.

By defining the NETTLE_STATIC environment variable during the build, it can also be statically link to its dependencies:

env NETTLE_STATIC=yes cargo build

This is particularly useful to produce standalone binaries that can be easily distributed.

Pregenerate bindings.rs

By default, nettle-sys invokes bindgen to generate bindings for Nettle. In some build environments, this might not work due to bindgen depending on libllvm. In this case, the bindings.rs may be pregenerated, and used by setting:

env NETTLE_PREGENERATED_BINDINGS=/path/to/bindings.rs cargo build

Note: bindings.rs is specific to target architecture, operating system, and Nettle version.

License

This project is licensed under either of

at your option.

Dependencies

~0–1.5MB
~32K SLoC