Struct Job 

pub struct Job<'a> {
    pub device: Option<Rc<RefCell<Device>>>,
    pub cache: &'a mut VtpmCache<'a>,
    pub auth_list: &'a [Auth],
    pub writer: &'a mut dyn Write,
}

Fields

device: Option<Rc<RefCell<Device>>>

cache: &'a mut VtpmCache<'a>

auth_list: &'a [Auth]

writer: &'a mut dyn Write

Implementations

impl<'a> Job<'a>

pub fn new( device: Option<Rc<RefCell<Device>>>, cache: &'a mut VtpmCache<'a>, auth_list: &'a [Auth], writer: &'a mut dyn Write, ) -> Self

Creates a new Job.

pub fn load_context( &mut self, device: &mut Device, target: &Handle, ) -> Result<TpmHandle, JobError>

Loads a TPM context from a handle, recursively loading its ancestors first.

Errors

Returns HandleNotFound when the target handle or any parent handle cannot be found, or if the chain is empty. Returns ParentNotFound when a necessary parent handle isn’t found in cache or persistent storage. Returns Device or TpmProtocol when TPM commands fail. Returns Vtpm when tracking the loaded handle fails. Returns InvalidParent if a loaded key’s parent does not match the expected parent in the chain.

pub fn execute<C: TpmCommandObject>( &mut self, device: &mut Device, command: &C, handles: &[u32], auth_list: &[Auth], ) -> Result<(TpmResponseBody, TpmAuthResponses), JobError>

Executes a TPM command with full authorization session handling.

This function encapsulates the prepare, build, execute, and teardown sequence for authorized commands.

Errors

Returns JobError if any stage of the session management or command execution fails. This includes errors from prepare_sessions, build_auth_area, device.execute, or teardown_sessions.

pub fn evict_control( &mut self, auth_handle: TpmHandle, object_to_evict: TpmHandle, persistent_handle: TpmHandle, auths: &[Auth], ) -> Result<(), JobError>

Evicts a persistent object or makes a transient object persistent using Job::execute.

Errors

Returns Device when the underlying with_device fails. Returns ResponseMismatch when the TPM command returns an unexpected response type. Returns JobError from the underlying execute call on failure.

pub fn import_key( &mut self, device: &mut Device, parent_handle: TpmHandle, input_bytes: &[u8], auths: &[Auth], ) -> Result<TpmKey, JobError>

Imports an external key under a TPM parent, creating a new TpmKey.

Errors

Returns InvalidFormat when the input bytes represent a TPM key, not an external key. Returns Key when converting the external key or building the TPM key fails. Returns JobError from the underlying TpmKey::from_external_key call on failure.

pub fn read_certificate( &mut self, device: &mut Device, auths: &[Auth], handle: u32, max_read_size: usize, ) -> Result<Option<Vec<u8>>, JobError>

Reads a certificate from a given NV index.

Errors

Returns ResponseMismatch when TPM commands return unexpected response types. Returns IntDecode when converting chunk size or offset fails. Returns JobError from the underlying execute calls on failure.

Trait Implementations

impl Drop for Job<'_>

fn drop(&mut self)

Executes the destructor for this type.