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 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 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