Struct ProviderInstance 

pub struct ProviderInstance<'a> {
    pub data: [u8; 10],
    pub name: &'a str,
    pub version: &'a str,
    /* private fields */
}

This is an abstract representation of one Provider instance. Remember that a single provider module could be loaded multiple times within the same process, either in the same OpenSSL libctx or within different libctx’s.

At the moment a single instance holds nothing of relevance, but in the future all the context which is specific to an instance should be encapsulated within it, so that different instances could have different configurations, and their own separate state.

Fields

data: [u8; 10]

name: &'a str

version: &'a str

Implementations

impl<'a> ProviderInstance<'a>

pub fn get_rng(&self) -> &'a mut dyn CryptoRngCore

impl<'a> ProviderInstance<'a>

pub fn new( handle: *const OSSL_CORE_HANDLE, core_dispatch: CoreDispatch<'a>, ) -> Self

pub fn get_provider_dispatch(&mut self) -> *const OSSL_DISPATCH

Retrieve a heap allocated OSSL_DISPATCH table associated with this provider instance.

pub fn c_prov_name(&self) -> &CStr

pub fn c_prov_version(&self) -> &CStr

pub fn c_prov_buildinfo(&self) -> &CStr

Trait Implementations

impl CoreUpcaller for ProviderInstance<'_>

fn fn_from_core_dispatch(&self, id: u32) -> Option<unsafe extern "C" fn()>

unsafe fn BIO_read_ex( &self, bio: *mut ossl_core_bio_st, ) -> Result<Box<[u8]>, Error>

Makes a BIO_read_ex() core upcall.

unsafe fn BIO_write_ex( &self, bio: *mut ossl_core_bio_st, data: &[u8], ) -> Result<usize, Error>

Makes a BIO_write_ex() core upcall.

impl CoreUpcallerWithCoreHandle for ProviderInstance<'_>

fn get_core_handle(&self) -> *const OSSL_CORE_HANDLE

fn OBJ_create(&self, oid: &CStr, sn: &CStr, ln: &CStr) -> Result<(), Error>

Makes a core_obj_create() core upcall.

fn OBJ_add_sigid( &self, sign_name: &CStr, digest_name: Option<&CStr>, pkey_name: &CStr, ) -> Result<(), Error>

Makes a core_obj_add_sigid() core upcall.

fn CORE_gettable_params(&self) -> Result<OSSLParam<'_>, Error>

See https://docs.openssl.org/3.2/man7/provider-base/#description

fn CORE_get_params(&self, params: OSSLParam<'_>) -> Result<(), Error>

See https://docs.openssl.org/3.2/man7/provider-base/#description

impl<'a> Debug for ProviderInstance<'a>

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

Formats the value using the given formatter.

impl<'a> Drop for ProviderInstance<'a>

We implement the Drop trait to make it explicit when a provider instance is dropped: this should only happen after teardown() has been called.

fn drop(&mut self)

Executes the destructor for this type.

impl<'a> TryFrom<*mut c_void> for &ProviderInstance<'a>

type Error = Error

The type returned in the event of a conversion error.

fn try_from(vctx: *mut c_void) -> Result<Self, Self::Error>

Performs the conversion.

impl<'a> TryFrom<*mut c_void> for &mut ProviderInstance<'a>

type Error = Error

The type returned in the event of a conversion error.

fn try_from(vctx: *mut c_void) -> Result<Self, Self::Error>

Performs the conversion.