Enum Generation 

pub enum Generation {
    Naples,
    Rome,
    Milan,
    Genoa,
    Turin,
}

A representation for EPYC generational product lines.

Implements type conversion traits to determine which generation a given SEV certificate chain corresponds to. This is helpful for automatically detecting what platform code is running on, as one can simply export the SEV certificate chain and attempt to produce a Generation from it with the TryFrom trait.

Example

// NOTE: The conversion traits require the `sev` crate to have the
// `openssl` feature enabled.

use std::convert::TryFrom;
use sev::certs::sev::Usage;
use sev::firmware::host::types::Firmware;
use sev::Generation;

let mut firmware = Firmware::open().expect("failed to open /dev/sev");

let chain = firmware.pdh_cert_export()
    .expect("unable to export SEV certificates");

let id = firmware.get_identifier().expect("error fetching identifier");

// NOTE: Requesting a signed CEK from AMD's KDS has been omitted for
// brevity.

let generation = Generation::try_from(&chain).expect("not a SEV/ES chain");
match generation {
    Generation::Naples => println!("Naples"),
    Generation::Rome => println!("Rome"),
}

Variants

Naples

First generation EPYC (SEV).

Rome

Second generation EPYC (SEV, SEV-ES).

Milan

Third generation EPYC (SEV, SEV-ES, SEV-SNP).

Genoa

Fourth generation EPYC (SEV, SEV-ES, SEV-SNP).

Turin

Fifth generation EPYC (SEV, SEV-ES, SEV-SNP).

Implementations

impl Generation

pub fn identify_cpu(family: u8, model: u8) -> Result<Self, Error>

Identify the SEV generation based on the CPU family and model.

pub fn identify_host_generation() -> Result<Self, Error>

Identify the EPYC processor generation based on the CPUID instruction.

impl Generation

pub fn titlecase(&self) -> String

Create a title-cased string identifying the SEV generation.

Trait Implementations

impl ByteParser<Generation> for SnpPlatformStatus

const EXPECTED_LEN: Option<usize>

Expected size of the byte container

type Bytes = [u8; 32]

Byte container definition Must be constructible and mutable as bytes for encoding,

fn from_bytes_with(bytes: &[u8], params: P) -> Result<Self, Error>

where Self: Sized + Decoder<P>,

Decode from an owned byte container with params.

fn to_bytes_with(&self, params: P) -> Result<Self::Bytes, Error>

where Self: Encoder<P>, Self::Bytes: TryFrom<Vec<u8>>,

Encode into an owned byte container with params.

impl ByteParser<Generation> for TcbVersion

const EXPECTED_LEN: Option<usize>

Expected size of the byte container

type Bytes = [u8; 8]

Byte container definition Must be constructible and mutable as bytes for encoding,

fn from_bytes_with(bytes: &[u8], params: P) -> Result<Self, Error>

where Self: Sized + Decoder<P>,

Decode from an owned byte container with params.

fn to_bytes_with(&self, params: P) -> Result<Self::Bytes, Error>

where Self: Encoder<P>, Self::Bytes: TryFrom<Vec<u8>>,

Encode into an owned byte container with params.

impl ByteParser<Generation> for WrappedVlekHashstick

const EXPECTED_LEN: Option<usize>

Expected size of the byte container

type Bytes = [u8; 432]

Byte container definition Must be constructible and mutable as bytes for encoding,

fn from_bytes_with(bytes: &[u8], params: P) -> Result<Self, Error>

where Self: Sized + Decoder<P>,

Decode from an owned byte container with params.

fn to_bytes_with(&self, params: P) -> Result<Self::Bytes, Error>

where Self: Encoder<P>, Self::Bytes: TryFrom<Vec<u8>>,

Encode into an owned byte container with params.

impl Clone for Generation

fn clone(&self) -> Generation

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Decoder<Generation> for SnpPlatformStatus

fn decode(reader: &mut impl Read, generation: Generation) -> Result<Self, Error>

Decodes from the reader with the given parameters.

impl Decoder<Generation> for TcbVersion

fn decode(reader: &mut impl Read, generation: Generation) -> Result<Self, Error>

Decodes from the reader with the given parameters.

impl Decoder<Generation> for WrappedVlekHashstick

fn decode(reader: &mut impl Read, generation: Generation) -> Result<Self, Error>

Decodes from the reader with the given parameters.

impl Encoder<Generation> for SnpPlatformStatus

fn encode( &self, writer: &mut impl Write, generation: Generation, ) -> Result<(), Error>

Encodes the object to raw bytes.

impl Encoder<Generation> for TcbVersion

fn encode( &self, writer: &mut impl Write, generation: Generation, ) -> Result<(), Error>

Encodes the object to raw bytes.

impl Encoder<Generation> for WrappedVlekHashstick

fn encode( &self, writer: &mut impl Write, generation: Generation, ) -> Result<(), Error>

Encodes the object to raw bytes.

impl From<Generation> for Chain

fn from(generation: Generation) -> CertSevCaChain

Converts to this type from the input type.

impl TryFrom<&[u8]> for Generation

type Error = Error

The type returned in the event of a conversion error.

fn try_from(bytes: &[u8]) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<(u8, u8)> for Generation

type Error = Error

The type returned in the event of a conversion error.

fn try_from(val: (CpuFamily, CpuModel)) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<String> for Generation

type Error = ()

The type returned in the event of a conversion error.

fn try_from(val: String) -> Result<Self, Self::Error>

Performs the conversion.

impl Copy for Generation