12 releases (stable)

3.1.1 Feb 29, 2024
2.0.2 Nov 4, 2023
1.2.1 Jul 18, 2023
1.1.0 Jan 31, 2023
0.1.0 Feb 2, 2021

#30 in Unix APIs

Download history 5209/week @ 2023-12-07 4885/week @ 2023-12-14 2272/week @ 2023-12-21 2099/week @ 2023-12-28 3564/week @ 2024-01-04 4203/week @ 2024-01-11 4168/week @ 2024-01-18 3979/week @ 2024-01-25 4514/week @ 2024-02-01 4417/week @ 2024-02-08 4999/week @ 2024-02-15 4552/week @ 2024-02-22 4434/week @ 2024-02-29 5232/week @ 2024-03-07 4349/week @ 2024-03-14 1259/week @ 2024-03-21

16,070 downloads per month
Used in 8 crates (7 directly)

Apache-2.0

385KB
9K SLoC

Workflow Status Average time to resolve an issue Percentage of issues still open Maintenance

sev

The sev crate provides an implementation of the AMD Secure Encrypted Virtualization (SEV) APIs and the [SEV Secure Nested Paging Firmware (SNP)] (https://www.amd.com/content/dam/amd/en/documents/epyc-technical-docs/specifications/56860.pdf) ABIs.

SEV APIs

The Linux kernel exposes two technically distinct AMD SEV APIs:

  1. An API for managing the SEV platform itself
  2. An API for managing SEV-enabled KVM virtual machines

This crate implements both of those APIs and offers them to client. code through a flexible and type-safe high-level interface.

SNP ABIs

Like SEV, the Linux kernel exposes another two different AMD SEV-SNP ABIs:

  1. An ABI for managing the SEV-SNP platform itself
  2. An ABI for managing SEV-SNP enabled KVM virtual machines

These new ABIs work only for SEV-SNP enabled hosts and guests.

This crate implements APIs for both SEV and SEV-SNP management.

SEV and SEV-SNP enablement

By default, both the SEV and SEV-SNP libraries are compiled. Because many modules provide support to both legacy SEV and SEV-SNP, they have been split into individual sub-modules sev.rs and snp.rs, isolating generation specific behavior. If desired, you may opt to exclude either of the sub-modules by disabling its feature in your project's Cargo.toml

For example, to include the SEV APIs only: sev = { version = "1.2.1", default-features = false, features = ["sev"] }

To include the SEV-SNP APIs only: sev = { version = "1.2.1", default-features = false, features = ["snp"] }

Platform Management

Refer to the firmware module for more information.

Guest Management

Refer to the launch module for more information.

Cryptographic Verification

To enable the cryptographic verification of certificate chains and attestation reports, either the openssl or crypto_nossl feature has to be enabled manually. With openssl, OpenSSL is used for the verification. With crypto_nossl, OpenSSL is not used for the verification and instead pure-Rust libraries (e.g., p384, rsa, etc.) are used. openssl and crypto_nossl are mutually exclusive, and enabling both at the same time leads to a compiler error.

Remarks

Note that the Linux kernel provides access to these APIs through a set of ioctls that are meant to be called on device nodes (/dev/kvm and /dev/sev, to be specific). As a result, these ioctls form the substrate of the sev crate. Binaries that result from consumers of this crate are expected to run as a process with the necessary privileges to interact with the device nodes.

Using the C API

Projects in C can take advantage of the C API for the SEV launch ioctls. To install the C API, users can use cargo-c with the features they would like to produce and install a pkg-config file, a static library, a dynamic library, and a C header:

cargo cinstall --prefix=/usr --libdir=/usr/lib64

License: Apache-2.0

Dependencies

~1–13MB
~126K SLoC