KeyProvOperation

Enum KeyProvOperation 

Source
pub enum KeyProvOperation {
    Enroll,
    SetUserKey {
        key_type: KeyProvUserKeyType,
        key_data: Box<[u8]>,
    },
    SetKey {
        key_type: KeyProvUserKeyType,
        key_size: u32,
    },
    WriteKeyNonvolatile {
        memory_id: u32,
    },
    ReadKeyNonvolatile {
        memory_id: u32,
    },
    WriteKeyStore {
        keystore_data: Box<[u8]>,
    },
    ReadKeyStore {
        file: String,
        use_hexdump: bool,
    },
}
Expand description

Key provisioning operations for device key management.

These operations handle enrollment, key setting, and key store management for various types of encryption and authentication keys.

Variants§

§

Enroll

Enrolls key provisioning feature. No arguments are required for this operation

§

SetUserKey

Sends the user key specified by type to the bootloader.

Available KEY TYPES: 2 or ‘OTFADKEK’ OTFAD key 3 or ‘SBKEK’ SB file encryption key 7 or ‘PRINCE0’ Prince region 0 encryption key 8 or ‘PRINCE1’ Prince region 1 encryption key 9 or ‘PRINCE2’ Prince region 2 encryption key 11 or ‘USERKEK’ User/Boot-image encryption key 12 or ‘UDS’ Universal Device Secret for DICE

Fields

§key_type: KeyProvUserKeyType

Type of user key

§key_data: Box<[u8]>

Binary file containing user key plaintext

§

SetKey

Generates a key of specified size and type on the device.

Available KEY TYPES: 2 or ‘OTFADKEK’ OTFAD key 3 or ‘SBKEK’ SB file encryption key 7 or ‘PRINCE0’ Prince region 0 encryption key 8 or ‘PRINCE1’ Prince region 1 encryption key 9 or ‘PRINCE2’ Prince region 2 encryption key 11 or ‘USERKEK’ User/Boot-image encryption key 12 or ‘UDS’ Universal Device Secret for DICE

Note: The valid options of key type and corresponding size are documented in the target’s Reference Manual or User Manual. Note: Names are case insensitive

Fields

§key_type: KeyProvUserKeyType

Type of key to generate

§key_size: u32

Size of key to generate in bytes

§

WriteKeyNonvolatile

Writes data to non-volatile storage

Fields

§memory_id: u32

ID of the non-volatile memory

§

ReadKeyNonvolatile

Loads the key from nonvolatile memory to bootloader.

Fields

§memory_id: u32

ID of the non-volatile memory

§

WriteKeyStore

Write key store data to the bootloader

Fields

§keystore_data: Box<[u8]>

Binary file containing key store data

§

ReadKeyStore

Reads the key store from the bootloader to host

Fields

§file: String

Binary file to save the key store

§use_hexdump: bool

Use hexdump format

Trait Implementations§

Source§

impl Clone for KeyProvOperation

Source§

fn clone(&self) -> KeyProvOperation

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl CommandToParams for KeyProvOperation

Source§

fn to_params(&self) -> (Vec<u32>, Option<&[u8]>)

Convert key provisioning operation to command parameters.

§Returns

Tuple containing operation parameters and optional key data for data phase

Source§

impl Debug for KeyProvOperation

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl Display for KeyProvOperation

Source§

fn fmt(&self, __derive_more_f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl FromArgMatches for KeyProvOperation

Source§

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed. Read more
Source§

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed. Read more
Source§

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.
Source§

fn update_from_arg_matches_mut<'b>( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.
Source§

impl Subcommand for KeyProvOperation

Source§

fn augment_subcommands<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut Read more
Source§

fn augment_subcommands_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut Read more
Source§

fn has_subcommand(__clap_name: &str) -> bool

Test whether Self can parse a specific subcommand

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.